[imdreamrunner]

Reader impact

A builder who still passes experimental={{presentation: x}} to Tokenizer reads the deprecation and learns the replacement, presentation, but not that astryx upgrade makes the change for them. After this PR, the deprecation note and the reference docs also name the migration command.

Source of truth

• spec:AST-017 FR29b: "Every warning names the exact replacement, stable versioned instructions, and exact migration command when one exists."
• The migration command exists: astryx upgrade runs the staged promote-tokenizer-presentation codemod, which rewrites a static experimental={{presentation: x}} to presentation={x} (feat(Tokenizer): presentation is a stable prop, and adaptive is its default #9796).

Correction

These places named only the replacement. They now say "Use the stable presentation prop; astryx upgrade rewrites static uses.":

• the @deprecated JSDoc on TokenizerProps.experimental.presentation;
• the experimental entries in Tokenizer.doc.mjs (English, Chinese and dense).

The development warning keeps its wording, "presentation wins. Remove experimental.presentation." It fires only when both spellings are set. The codemod leaves that case for a person, so the warning names the fix and not the command.

Evidence

git diff is 4 changed lines in Tokenizer.tsx and Tokenizer.doc.mjs, plus the Changeset.

Scope

• This PR changes documentation only, or names every necessary generated artifact. api-report.md does not include JSDoc text, so it does not change.
• Runtime, API, visual, and policy changes were removed or split.
• Public text and artifacts contain no internal Meta context.

Testing

• vitest: Tokenizer, 6 files and 205 tests, pass. Before that, Tokenizer, PowerSearch and the CLI golden reads passed: 20 files and 698 tests.
• The @astryxdesign/core build passes, and tsc --noEmit passes for the package.
• check:changesets, Changeset coverage (it ships to @astryxdesign/core, which the Changeset names) and check:knowledge pass. Prettier is clean.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
astryx	Ready	Preview	Nov 3, 2026 10:55pm UTC

[astracat-bot]

AI review status for this pull request.

Review status	Updated
🟢 Reviewed (for maintainers only)	Nov 3, 2026, 10:56 PM UTC

[imdreamrunner]

/approve-spec 6440b7f

[astracat-bot]

Requesting changes. The @deprecated note and the three Tokenizer.doc.mjs entries are accurate, but the new sentence in the development warning points to a migration that does not apply where that warning fires.

• The warning at Tokenizer.tsx:835 fires only when presentation and experimental.presentation are both set, and promote-tokenizer-presentation declines exactly that case (it leaves a TODO when both are attributes, and when presentation comes from an earlier spread it moves the experimental value after the spread, where the losing value starts to win), so please restore the previous message ("presentation wins. Remove experimental.presentation.") and drop the warning from the Changeset's list.

The codemod's own test for that shape (case c in promote-tokenizer-presentation.test.mjs) shows the behavior.

[Automated review]

[astracat-bot]

This warning only fires when presentation and experimental.presentation are both set, and promote-tokenizer-presentation declines exactly that case: with both attributes it leaves a TODO (case c in its test), and with presentation from an earlier spread it moves the experimental value after the spread, so the losing value starts to win. Please keep the previous message here: `presentation` and `experimental.presentation` are both set; `presentation` wins. Remove `experimental.presentation`.

[imdreamrunner]

/approve-spec e509abe

[astracat-bot]

No changes needed. The @deprecated note on experimental.presentation and the three Tokenizer.doc.mjs entries now name astryx upgrade, which matches what the promote-tokenizer-presentation codemod does for a static experimental={{presentation: x}}. The both-set development warning keeps its earlier advice, so the concern raised on the previous revision is resolved. CI on this revision stopped because CI was at capacity rather than on a failing test, so it needs a re-run before merging.

[Automated review]

[imdreamrunner]

Closing: the experimental presentation option is being removed rather than deprecated, so there is no deprecated spelling left to point at astryx upgrade. Tokenizer's stable presentation prop is the only spelling going forward.