An open source design system that's fully customizable and agent ready
TypeScript
chore: merge v0.7.0 release outputs to main (#7404)
Cindy Zhang79292d1f6516
diff --git a/.changeset/app-theme-add-import-default.md b/.changeset/app-theme-add-import-default.mddeleted file mode 100644index e66a2a3a33..0000000000--- a/.changeset/app-theme-add-import-default.md+++ /dev/null@@ -1,11 +0,0 @@-----'@astryxdesign/cli': minor------[breaking] CLN-0005 removes the deprecated `DEP-0005` copy default from `theme add`.--The old contract copied theme source with `theme add <slug> [path] [--overwrite] [--package <package>]` and returned `theme.add` JSON. The `ThemeAddResponse` type and the `theme.add` response type are removed, with their `ThemeAddResponse.type`, `ThemeAddResponse.data`, and `ThemeAddResponse.meta` fields. The replacement imports the built theme with `theme add <slug> [--package <package>]` and returns `theme.app`; `--import` remains an accepted no-op. Plain `theme add` now returns `theme.app` with the owner `package` directly after `type`. Local themes carry no package.--A path after `theme add` now exits 1 with `ERR_INVALID_ARGUMENT`, and `--overwrite` exits 1 with `ERR_INVALID_OPTION`; neither writes files. To migrate a script that copied source, run `theme eject` with the same slug, path, `--overwrite`, and `--package` arguments. A script that already runs `theme add --import` keeps the same meaning and needs no change.--@josephfarinadiff --git a/.changeset/banner-explicit-announcements.md b/.changeset/banner-explicit-announcements.mddeleted file mode 100644index 6f234c6ab5..0000000000--- a/.changeset/banner-explicit-announcements.md+++ /dev/null@@ -1,21 +0,0 @@-----'@astryxdesign/core': minor------[breaking] Stop deriving live-region roles from `Banner.status`. Banners are non-live by default; call `useAnnounce` from the actual async transition handler, or provide an explicit `role="status"` for a persistent semantic mirror.--`role="alert"` is now opt-in rather than automatic for warning and error banners.--@cixzhang--Old usage:-`Banner` derived `role="status"` or `role="alert"` from its `status` variant.--Replacement:-The caller sets the role explicitly, or announces with `useAnnounce`.--Migration:-Call `useAnnounce` from the actual async transition handler, or provide an explicit `role="status"` for a persistent semantic mirror.--Codemod:-None — the right announcement depends on the callsite.diff --git a/.changeset/baseprops-passthrough-nonfield.md b/.changeset/baseprops-passthrough-nonfield.mddeleted file mode 100644index 7b48993060..0000000000--- a/.changeset/baseprops-passthrough-nonfield.md+++ /dev/null@@ -1,11 +0,0 @@-----'@astryxdesign/core': minor------[breaking] Layout, MetadataList, NavHeadingMenuItem and TopNavMegaMenuItem now apply the BaseProps they accept (id, role, aria-\*, data-\*, hidden, inert, dir, event handlers; TopNavMegaMenuItem also xstyle/className/style) instead of silently dropping them; NavHeadingMenu keeps arrow navigation when an item handler cancels.--Migration: remove any of those props you passed that you relied on being ignored; a TopNavMegaMenuItem styled through xstyle/className/style now shows that styling.--From #5656 by @harjothkhara.--@harjothkharadiff --git a/.changeset/bottom-sheet-default-padding.md b/.changeset/bottom-sheet-default-padding.mddeleted file mode 100644index cc3ff1544d..0000000000--- a/.changeset/bottom-sheet-default-padding.md+++ /dev/null@@ -1,11 +0,0 @@-----'@astryxdesign/core': minor------[breaking] BottomSheet pads its content by default, like Dialog. With no `padding` prop and no theme padding, the content box now pads by `--spacing-4` (it had no padding before) and publishes that inset.--A sheet whose only child is a padded `Section` or a `Layout` renders as before, because both escape the inset. Content that supplies its own inset is now padded twice: drop that inset, or pass `padding={0}` to keep the unpadded content box. `astryx upgrade` ships `preserve-bottom-sheet-content-padding`, which adds `padding={0}` where needed.--Migration: pass `padding={0}` to keep the unpadded content box, or drop your own inset to take the default; `astryx upgrade` adds `padding={0}` to every BottomSheet that sets no padding unless its only child is a padded Section or a Layout. An app whose theme already sets `bottom-sheet` padding on every edge is not affected by the new default; the codemod cannot see the theme, so remove the `padding={0}` it adds there to keep the theme inset. A sheet whose content wraps a `Layout` gets a TODO: `padding={0}` also removes the inset between that Layout's regions, which the Layout's own `padding` does not restore.--@imdreamrunnerdiff --git a/.changeset/bottom-sheet-padding-codemod.md b/.changeset/bottom-sheet-padding-codemod.mddeleted file mode 100644index 9ea764e98f..0000000000--- a/.changeset/bottom-sheet-padding-codemod.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/cli': patch------[feat] `astryx upgrade` adds `padding={0}` to BottomSheet elements that do not set `padding`, keeping their unpadded content box now that BottomSheet pads like Dialog. Sheets whose only child is a Section or a Layout are left unchanged. A sheet with a Layout anywhere in its content also gets a TODO comment, because `padding={0}` removes the inset between that Layout's regions and the Layout's own `padding` restores only its outer edges. A shadowed `BottomSheet` binding is left alone, and a second run changes nothing.--@imdreamrunnerdiff --git a/.changeset/bottom-sheet-shared-escape.md b/.changeset/bottom-sheet-shared-escape.mddeleted file mode 100644index 5a2090a7be..0000000000--- a/.changeset/bottom-sheet-shared-escape.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/core': patch------[fix] A standalone `BottomSheet` now joins the shared layer dismissal stack, so one Escape press closes only the top-most layer. A Popover, Dialog, or menu opened inside the sheet closes first, and the next press closes the sheet. `purpose="required"` still blocks Escape without letting the press close a layer behind it, a sheet that is animating out keeps the press, and the native close request answers with the same top-most and IME composition rules.--@harjothkharadiff --git a/.changeset/breaking-icon-registry-require-upload.md b/.changeset/breaking-icon-registry-require-upload.mddeleted file mode 100644index 8874c532f0..0000000000--- a/.changeset/breaking-icon-registry-require-upload.md+++ /dev/null@@ -1,18 +0,0 @@-----'@astryxdesign/core': minor------[breaking] Require `upload` on complete `IconRegistry` types-@rubyycheung @cixzhang @Geervan--Old usage:-A custom complete icon registry typed as `IconRegistry` that omitted the `upload` key.--Replacement:-`IconRegistry` now requires all semantic `IconName` keys, including `upload`.--Migration:-Add an `upload` entry drawn in your registry's icon style to complete icon registries typed as `IconRegistry`.--Codemod:-No `astryx upgrade` codemod applies (spec:AST-017 FR8) because icon artwork is bespoke design artwork tailored to each theme and cannot be automatically synthesized.diff --git a/.changeset/cli-init-remove-reports-nothing-to-remove.md b/.changeset/cli-init-remove-reports-nothing-to-remove.mddeleted file mode 100644index 68d64664e3..0000000000--- a/.changeset/cli-init-remove-reports-nothing-to-remove.md+++ /dev/null@@ -1,11 +0,0 @@-----'@astryxdesign/cli': minor------[breaking] `init --remove-agents` says when there was nothing to remove.--- incompatible-fix `IFIX-0004` / cleanup `CLN-0010`--Migration: a consumer reading `data.removed` as a boolean keeps working; a consumer that narrowed on the literal `true` sees the corrected value.--@josephfarinadiff --git a/.changeset/cli-install-command-ambiguous-package-manager.md b/.changeset/cli-install-command-ambiguous-package-manager.mddeleted file mode 100644index 5453f4dcbd..0000000000--- a/.changeset/cli-install-command-ambiguous-package-manager.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/cli': patch------[fix] `template` and `build` choose the install command's package manager as AST-048 FR17 and FR19 specify. The nearest directory from the target up to the workspace root that has a `packageManager` field or a lockfile decides. With neither, the command uses npm, whatever package manager launched the CLI. When that directory's lockfiles disagree and nothing it commits picks one, `installCommand` is `null` and the note names the missing packages, the directory, and the lockfiles that disagree, instead of guessing a command that would write a second lockfile.--@cixzhangdiff --git a/.changeset/cli-option-pair-refusals.md b/.changeset/cli-option-pair-refusals.mddeleted file mode 100644index d9531b998f..0000000000--- a/.changeset/cli-option-pair-refusals.md+++ /dev/null@@ -1,11 +0,0 @@-----'@astryxdesign/cli': minor------[breaking] Four commands refuse silently ignored option pairs.--- incompatible-fix `IFIX-0005` / cleanup `CLN-0011`--Migration: remove the option the command was ignoring.--@josephfarinadiff --git a/.changeset/cli-refuse-invalid-silent-success.md b/.changeset/cli-refuse-invalid-silent-success.mddeleted file mode 100644index 3a545c98e3..0000000000--- a/.changeset/cli-refuse-invalid-silent-success.md+++ /dev/null@@ -1,11 +0,0 @@-----'@astryxdesign/cli': minor------[breaking] Refuse invalid input that used to silently succeed.--- incompatible-fix `IFIX-0007` / cleanup `CLN-0013`--Migration: pass a valid type or package, an integer limit, or the documented arguments, and catch `ERR_AMBIGUOUS_COMPONENT` for a multi-package name.--@josephfarinadiff --git a/.changeset/cli-reject-empty-string-argument.md b/.changeset/cli-reject-empty-string-argument.mddeleted file mode 100644index 61759be5cc..0000000000--- a/.changeset/cli-reject-empty-string-argument.md+++ /dev/null@@ -1,11 +0,0 @@-----'@astryxdesign/cli': minor------[breaking] An empty-string argument no longer discards the rest of the command.--- incompatible-fix `IFIX-0003` / cleanup `CLN-0009`--Migration: remove the empty string from the invocation; the documented way to list is to omit the argument.--@josephfarinadiff --git a/.changeset/cli-validate-nothing-exits-nonzero.md b/.changeset/cli-validate-nothing-exits-nonzero.mddeleted file mode 100644index 9d78df8c02..0000000000--- a/.changeset/cli-validate-nothing-exits-nonzero.md+++ /dev/null@@ -1,13 +0,0 @@-----'@astryxdesign/cli': minor------[breaking] `doctor integration validate` exits 1 when there is no package.json.--- incompatible-fix `IFIX-0008` / cleanup `CLN-0014`--The no-package.json case now carries a `no_package` error-severity issue, so the existing exit rule (exit 1 on error-severity issues) covers it. A directory with package.json but no integration manifest stays exit 0 as published.--Migration: run the command in a directory that has a `package.json`, or handle exit 1 for that case.--@josephfarinadiff --git a/.changeset/command-palette-list-composition-docs.md b/.changeset/command-palette-list-composition-docs.mddeleted file mode 100644index e312a84946..0000000000--- a/.changeset/command-palette-list-composition-docs.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/core': patch------[docs] Describe `CommandPaletteList` as the list `CommandPalette` renders itself, and as a component to render directly only for a standalone results list.--@cixzhangdiff --git a/.changeset/context-menu-trigger-dom-props.md b/.changeset/context-menu-trigger-dom-props.mddeleted file mode 100644index 5ee3bebc9f..0000000000--- a/.changeset/context-menu-trigger-dom-props.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/core': patch------[fix] `ContextMenu` puts only its four touch handlers on the trigger element. It used to spread everything `useLongPress` returns, which since the press model includes the hook's imperative `start`, `moveTo` and `cancel`, so React warned "does not recognize the `moveTo` prop" and "Invalid values for props `start`, `cancel`" on the first ContextMenu of a page. Long-press opening is unchanged.--@vjeuxdiff --git a/.changeset/data-vars-stylex-ownership.md b/.changeset/data-vars-stylex-ownership.mddeleted file mode 100644index 513cc2f4c1..0000000000--- a/.changeset/data-vars-stylex-ownership.md+++ /dev/null@@ -1,22 +0,0 @@-----'@astryxdesign/core': minor-'@astryxdesign/cli': minor------[breaking] Move canonical data-color defaults from generated theme CSS to the public StyleX `dataVars` group.--Import `dataVars` from `@astryxdesign/core/theme/dataTokens.stylex` for CSS-capable code. Canvas and other non-CSS APIs continue to use `resolveThemeToken()` or `useTheme().token()`. Rebuild committed theme CSS with `astryx theme build`; concrete themes now emit only explicitly authored data-color overrides.--@cixzhang--Old usage:-Generated theme CSS owned the canonical `--color-data-*` root defaults.--Replacement:-The public StyleX `dataVars` group in `@astryxdesign/core/theme/dataTokens.stylex` owns the defaults; concrete themes emit only explicitly authored data-color overrides.--Migration:-Import `dataVars` from `@astryxdesign/core/theme/dataTokens.stylex` for CSS-capable code. Canvas and other non-CSS APIs continue to use `resolveThemeToken()` or `useTheme().token()`. Rebuild committed theme CSS with `astryx theme build`.--Codemod:-`astryx upgrade` runs `validate-data-token-ownership`, which rewrites nothing and reports fallback-less `var(--color-data-*)` uses (whole or embedded source strings, and stylesheets) and stale generated theme CSS for manual migration.diff --git a/.changeset/date-input-native-change-action.md b/.changeset/date-input-native-change-action.mddeleted file mode 100644index 5e2e1ad62b..0000000000--- a/.changeset/date-input-native-change-action.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/core': patch------[fix] DateInput: run changeAction with optimistic busy feedback on the native picker surface--@cixzhangdiff --git a/.changeset/dialog-pointer-focus-ring.md b/.changeset/dialog-pointer-focus-ring.mddeleted file mode 100644index 2b9010a7be..0000000000--- a/.changeset/dialog-pointer-focus-ring.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/core': patch------[fix] Dialog's initial focus and the focus it returns on close now follow the last input: the shared focus indicator is hidden after a mouse click or tap and shown after keyboard input, including focus returned after a keyboard open and a mouse close (#7306). Text fields keep their own focus treatment.--@harjothkharadiff --git a/.changeset/doctor-exit-policy.md b/.changeset/doctor-exit-policy.mddeleted file mode 100644index 5d7757cfc2..0000000000--- a/.changeset/doctor-exit-policy.md+++ /dev/null@@ -1,17 +0,0 @@-----'@astryxdesign/cli': minor------[breaking] Doctor fails when the CLI cannot load what astryx.config asks for-@josephfarina--A new `configured-integrations` check fails when an integration named in astryx.config cannot be loaded: not installed, installed without a manifest, or a manifest that throws or fails its schema. Such an integration is withdrawn whole and contributes nothing. The config check fails, instead of warning, when astryx.config imports but the CLI cannot load the project from it.--Unchanged: a problem inside one contribution kind (an invalid component doc, a missing or unreadable root, an unresolved replacement) stays a warning under `integration-issues` (spec:AST-035 FR9), and an autolinked dependency that cannot be loaded stays informational.--Classification: incompatible-fix.-Released victim: published 0.6.8 (the latest stable) exits 0 for both cases.-No codemod: nothing in a project's source changes; the fix is to install the integration, repair its manifest, or edit `integrations` in astryx.config, which only the project's owner can decide.--What counts as configured is every name astryx.config lists, read from the provider ledger: a package set aside for a provider conflict and the package being authored when its own config names it both count.-Migration: install the integration, fix its manifest, or remove it from `integrations`; fix the astryx.config field the message names.diff --git a/.changeset/dropdown-menu-header-footer.md b/.changeset/dropdown-menu-header-footer.mddeleted file mode 100644index 3f3fc55fde..0000000000--- a/.changeset/dropdown-menu-header-footer.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/core': patch------[feat] `DropdownMenu` takes `header` and `footer`: content above and below the rows that sits in the popover beside the menu, never inside it. This is the place for a filter field or a "Create" button. The menu still holds only its rows, so it stays a valid menu to a screen reader. The controls keep their own keys and presses, and Tab walks header, menu, footer. The bottom sheet shows them above and below the actions.--@cixzhangdiff --git a/.changeset/dropdown-menu-submenu-row-host-props.md b/.changeset/dropdown-menu-submenu-row-host-props.mddeleted file mode 100644index af36414f75..0000000000--- a/.changeset/dropdown-menu-submenu-row-host-props.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/core': patch------[feat] `DropdownMenuSubMenu` passes host attributes, DOM event handlers and a `ref` to its trigger row, as `DropdownMenuItem` does: a sub-menu row can carry `aria-keyshortcuts`, a `data-*` mark or an `id`, and a caller can reach the row element. The row keeps its own role, tab stop and popup state; a caller's `onClick`, `onKeyDown`, `onPointerMove`, `onMouseEnter` and `onMouseLeave` run after the row's own handling, except for an event the row consumes: the keys that open the flyout (the open arrow, Enter and Space) and a click on a disabled row. A caller's `id` names the row the flyout is labelled by.--@vjeuxdiff --git a/.changeset/dropdown-menu-trigger-back-row.md b/.changeset/dropdown-menu-trigger-back-row.mddeleted file mode 100644index f58abeb987..0000000000--- a/.changeset/dropdown-menu-trigger-back-row.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/core': patch------[fix] A DropdownMenu hung off its own control through `renderTrigger` names a drilled-in sub-menu's Back row after the menu: "Back to <the menu's aria-label>", or the name of the control it hangs off, instead of "Back to Menu".--@vjeuxdiff --git a/.changeset/field-input-styling-codemod.md b/.changeset/field-input-styling-codemod.mddeleted file mode 100644index baffdb5f0a..0000000000--- a/.changeset/field-input-styling-codemod.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/cli': patch------[feat] `astryx upgrade` runs `migrate-field-input-styling`, which renames root `xstyle`/`className`/`style` on Field-composed inputs to the part they styled before: `controlXstyle`/`controlClassName`/`controlStyle` on TextInput, TextArea, NumberInput, FileInput, DateInput, DateRangeInput, DateTimeInput, TimeInput, Selector, MultiSelector, and ComplexSelector, and `containerXstyle`/`containerClassName`/`containerStyle` on Typeahead, Tokenizer, CheckboxList, RadioList, and Slider. It rewrites JSX written directly on an Astryx import (named, aliased, or namespace). Spreads and wrappers that forward their own styling props are left for manual migration, and a callsite that already sets the target prop gets a TODO instead of a rename.--@cixzhangdiff --git a/.changeset/field-input-styling-date-time.md b/.changeset/field-input-styling-date-time.mddeleted file mode 100644index acf7dbb9b2..0000000000--- a/.changeset/field-input-styling-date-time.md+++ /dev/null@@ -1,11 +0,0 @@-----'@astryxdesign/core': minor------[breaking] DateInput, DateRangeInput, DateTimeInput, and TimeInput no longer accept root `xstyle`, `className`, or `style`. Style the field with `containerXstyle`/`containerClassName`/`containerStyle` (the Field box; no effect inside InputGroup or a `horizontal-labels` FormLayout) and the visual control box with `controlXstyle`/`controlClassName`/`controlStyle`. Base props such as `ref`, `id`, `data-*`, `aria-*`, and DOM handlers reach the field's semantic control on every surface (the date, time, or date-time input; DateRangeInput's range trigger) instead of the wrapper, TimeInput no longer drops them, and a caller `id` is now honored there. A caller `aria-describedby` is added to the component's own description ids, and a caller `aria-labelledby` is read after the field's own label (on DateRangeInput, after its label and selected range); a caller `aria-label` on DateRangeInput replaces the trigger's name.--Migration: rename root `xstyle`/`className`/`style` on these components to `controlXstyle`/`controlClassName`/`controlStyle`, which style the same element as before (for DateTimeInput, the row holding the date and time segments). Rename by hand, or run `astryx upgrade` once it includes the `migrate-field-input-styling` transform, which rewrites JSX usage; styling passed through a wrapper's own props or a spread is never rewritten and now fails type-checking at that callsite, so rename it there. Untyped callers get a development warning and the value is ignored. A DOM handler or `data-*` attribute that relied on landing on the wrapper now lands on the control; a handler still runs after the component's own and still receives events the component handled.--From #5656 by @harjothkhara.--@cixzhangdiff --git a/.changeset/field-input-styling-fieldroot.md b/.changeset/field-input-styling-fieldroot.mddeleted file mode 100644index 5f1e8a2000..0000000000--- a/.changeset/field-input-styling-fieldroot.md+++ /dev/null@@ -1,22 +0,0 @@-----'@astryxdesign/core': minor-'@astryxdesign/cli': minor------[breaking] Typeahead, Tokenizer, CheckboxList, RadioList, and Slider no longer accept root `xstyle`, `className`, or `style`. Style the field with `containerXstyle`/`containerClassName`/`containerStyle` (the Field box; no effect inside InputGroup or a `horizontal-labels` FormLayout) and the visual control box with `controlXstyle`/`controlClassName`/`controlStyle`. Base props now reach the primary semantic control: the combobox input for Typeahead and Tokenizer, the `role="group"`/`role="radiogroup"` element for CheckboxList and RadioList, and the `role="slider"` thumb for Slider (the `role="group"` control in range mode). A caller `aria-describedby` is kept alongside the field's own description and status, on these components and on TextInput, TextArea, and NumberInput, which previously dropped it. CLI templates use the new props.--Migration: rename root `xstyle`/`className`/`style` to the part they styled before: `containerXstyle`/`containerClassName`/`containerStyle` on all five components, except a Typeahead inside InputGroup, whose root styling painted the control surface and moves to `controlXstyle`/`controlClassName`/`controlStyle`. The release's `astryx upgrade` codemod, `migrate-field-input-styling`, performs these renames on JSX usage.--Not rewritten by the codemod, so update by hand:-- `ref` and `id`, plus `data-*` (except Typeahead and Tokenizer `data-testid`, which marked the control surface), `aria-*`, and DOM event handlers such as `onClick`, previously landed on the outer Field (or were dropped by RadioList and Slider). They now land on the primary semantic control. Update code that measured, queried, or listened on the outer field, and wrap the component in your own element when you need an outer boundary.-- Typeahead and Tokenizer refs are now `HTMLInputElement`.-- A consumer `onKeyDown` on Typeahead or Tokenizer still runs after the built-in key handling, cannot cancel it, and still fires for keys on the clear button and tokens; for keys on the input it now runs on the combobox input itself.-- RadioList and Slider used to drop DOM event handlers; they now run after the component's own handling, so a Slider `onPointerDown`, `onKeyDown`, `onFocus`, or `onBlur` that never fired before now fires (on the thumb, or on the group in range mode).-- Tokenizer's `onFocus`/`onBlur` keep their meaning: focus entering or leaving the field.-- Styling passed through a wrapper's own props or a spread is not rewritten and now fails type-checking at that callsite.--Untyped callers get a development warning and the value is ignored.--From #5656 by @harjothkhara.--@cixzhangdiff --git a/.changeset/field-input-styling-selectors.md b/.changeset/field-input-styling-selectors.mddeleted file mode 100644index 87ade21b40..0000000000--- a/.changeset/field-input-styling-selectors.md+++ /dev/null@@ -1,12 +0,0 @@-----'@astryxdesign/core': minor-'@astryxdesign/cli': minor------[breaking] Selector, MultiSelector, and ComplexSelector no longer accept root `xstyle`, `className`, or `style`. Style the field with `containerXstyle`/`containerClassName`/`containerStyle` (the Field box; no effect inside InputGroup, a `horizontal-labels` FormLayout, or with `renderTrigger`) and the visual control box with `controlXstyle`/`controlClassName`/`controlStyle`. Base props such as `ref`, `id`, `data-*` (including `data-testid`), `aria-*`, and DOM handlers reach the trigger button that carries the combobox role (or, with `renderTrigger`, the caller's control), and a caller `aria-describedby` is kept alongside the field's own description and status instead of being replaced. Handlers keep their existing order: a ComplexSelector `onClick` on its own trigger can still cancel opening, and newly forwarded handlers (including those reaching a `renderTrigger` control) run after the built-in toggle and keyboard handling. CLI templates use the new props.--Migration: rename root `xstyle`/`className`/`style` on these components to `controlXstyle`/`controlClassName`/`controlStyle`, which style the same element as before. Not a rename: a `data-testid` or other base prop now lands on the trigger button rather than the bordered box around it (query the box with `.closest()` if a test measured it), and with `renderTrigger` base props and `ref` now reach the caller's control. Rename JSX usage by hand, or with `astryx upgrade` once its `migrate-field-input-styling` transform is available; that transform does not follow styling passed through a wrapper's own props or a spread, which now fails type-checking at that callsite, so rename it there. Untyped callers get a development warning and the value is ignored.--From #5656 by @harjothkhara.--@cixzhangdiff --git a/.changeset/field-input-styling-text.md b/.changeset/field-input-styling-text.mddeleted file mode 100644index c6d986bf85..0000000000--- a/.changeset/field-input-styling-text.md+++ /dev/null@@ -1,12 +0,0 @@-----'@astryxdesign/core': minor-'@astryxdesign/cli': minor------[breaking] TextInput, TextArea, NumberInput, and FileInput no longer accept root `xstyle`, `className`, or `style`. Style the field with `containerXstyle`/`containerClassName`/`containerStyle` (the Field box; no effect inside InputGroup or a `horizontal-labels` FormLayout) and the visual control box with `controlXstyle`/`controlClassName`/`controlStyle`. Base props such as `ref`, `id`, `data-*`, `aria-*`, and DOM handlers reach the native control, and a caller `id` is now honored there. CLI templates use the new props.--Migration: rename root `xstyle`/`className`/`style` on these components to `controlXstyle`/`controlClassName`/`controlStyle`, which style the same element as before. `astryx upgrade` rewrites JSX usage; styling passed through a wrapper's own props or a spread is not rewritten and now fails type-checking at that callsite, so rename it there. Untyped callers get a development warning and the value is ignored. Not rewritten by the codemod: a caller `id` used to be replaced by a generated one and now reaches the native control (the label stays associated), so remove an `id` you passed but relied on being ignored. Other base props already reached the native control and are unchanged.--From #5656 by @harjothkhara.--@cixzhangdiff --git a/.changeset/first-party-theme-spacing-rem.md b/.changeset/first-party-theme-spacing-rem.mddeleted file mode 100644index 88dd4921b3..0000000000--- a/.changeset/first-party-theme-spacing-rem.md+++ /dev/null@@ -1,10 +0,0 @@-----'@astryxdesign/theme-matcha': minor-'@astryxdesign/theme-y2k': minor-'@astryxdesign/cli': minor------[breaking] matcha's and y2k's spacing steps are rem (`--spacing-2: 0.75rem`), so their gaps and padding follow the reader's root font size like the core scale. Every step is the same pixel value at the default 16px root; a reader with a larger root font size now sees proportionally larger spacing on these themes. The CLI's copies of both theme templates and the annotated theme template's spacing example change the same way.--Migration: nothing to change to take the new behaviour. To keep fixed pixel spacing on one of these themes, extend it and override the steps in px, which is honoured as written: `defineTheme({name: 'app', extends: matchaTheme, tokens: {'--spacing-2': '12px'}})`.-@cixzhangdiff --git a/.changeset/guide-theme-palette-refs.md b/.changeset/guide-theme-palette-refs.mddeleted file mode 100644index 16f781f011..0000000000--- a/.changeset/guide-theme-palette-refs.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/cli': patch------[fix] Teach generated palette references in the full custom-theme authoring guide.--@rubyycheungdiff --git a/.changeset/item-swipe-on-demand.md b/.changeset/item-swipe-on-demand.mddeleted file mode 100644index 0df4e5adb0..0000000000--- a/.changeset/item-swipe-on-demand.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/core': patch------[perf] An `Item` without `swipeActions` no longer bundles the swipe gesture. The panels and the drag that uncovers them now live in a module `Item` loads on demand the first time a row has swipe actions, so an app whose rows never swipe ships about 2.7 KB (gzip) less on its first load and a row that does swipe keeps its DOM, props and behavior; its gesture becomes live once that module has arrived, which on a first load is a moment after the row paints.--@vjeuxdiff --git a/.changeset/lightbox-zoom-reset-same-frame.md b/.changeset/lightbox-zoom-reset-same-frame.mddeleted file mode 100644index 2f4b40480e..0000000000--- a/.changeset/lightbox-zoom-reset-same-frame.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/core': patch------[fix] Lightbox shows the next or previous image unzoomed from its first frame. The zoom and pan reset when the image changes now happens in the same update, instead of painting the new image at the previous image's zoom for one frame.--@cixzhangdiff --git a/.changeset/markdown-source-lines-transform.md b/.changeset/markdown-source-lines-transform.mddeleted file mode 100644index 4c18cdf5d0..0000000000--- a/.changeset/markdown-source-lines-transform.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/core': patch------[fix] With `markdownSourceLinesPlugin` installed, a transform plugin no longer falls back to its readable fallback on documents that contain a list or a quote. Blocks nested in a list item or a quote carry lines without offsets, and the transform check now accepts those Core-assigned lines while still refusing a transform that adds, shifts, or forges them.--@cixzhangdiff --git a/.changeset/menu-pinch-zoom.md b/.changeset/menu-pinch-zoom.mddeleted file mode 100644index 5d07bb81ec..0000000000--- a/.changeset/menu-pinch-zoom.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/core': patch------[fix] A two-finger pinch over an open DropdownMenu, sub-menu flyout, ContextMenu or Selector list now zooms the page. The menus declared `touch-action: none` while their rows fit and `pan-y` once they scroll, and neither allows a pinch, so a phone could not zoom the page while a menu was open. They now declare `pinch-zoom` and `pan-y pinch-zoom`; a one-finger slide over the rows and the press model behave as before.--@vjeuxdiff --git a/.changeset/menu-rows-only.md b/.changeset/menu-rows-only.mddeleted file mode 100644index e64b4a57ce..0000000000--- a/.changeset/menu-rows-only.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/core': patch------[fix] DropdownMenu, ContextMenu and sub-menus no longer special-case text fields and buttons placed among their rows. This reverts an unreleased change. A menu holds only menu items; a control that is not a row belongs outside the menu.--@cixzhangdiff --git a/.changeset/mobile-type-pin-touch-narrow.md b/.changeset/mobile-type-pin-touch-narrow.mddeleted file mode 100644index 46d7e7f10d..0000000000--- a/.changeset/mobile-type-pin-touch-narrow.md+++ /dev/null@@ -1,15 +0,0 @@-----'@astryxdesign/theme-butter': minor-'@astryxdesign/theme-chocolate': minor-'@astryxdesign/theme-neutral': minor-'@astryxdesign/theme-stone': minor-'@astryxdesign/cli': minor------[breaking] On touch devices narrower than the `lg` breakpoint (`(width < 1024px) and (pointer: coarse)`), the 14px-base first-party themes now floor their type base to 16px and re-derive the ratio so Display 1 keeps its desktop size: neutral and chocolate (base 14, ratio 1.2 → 1.1736) and butter and stone (base 14, ratio 1.25 → 1.2225). On phones, body, label and code text rise from 14px to 16px; supporting text, the headings and Display 2 and 3 grow by 1–2px; only Display 1 holds its desktop size. Desktop sizes are unchanged. gothic, matcha and y2k already use a 16px base and need no rule. The CLI's theme templates carry the same rule, so a newly scaffolded theme gets it too.--An app theme that extends one of these four themes and sets its own `typography.scale` or type-size tokens inherits this rule, and on touch + narrow screens the rule replaces those values (a base-18 child drops to a 16px body and a 42px Display 1). Append your own rule for the same condition with the values you want; a later rule for the same condition wins.--Migration: nothing to change to take the new phone scale. To keep the previous 14px phone scale in an app, extend the theme and append a later rule for the same condition: `defineTheme({name: 'app', extends: neutralTheme, adaptations: {rules: [{when: {pointer: 'coarse', width: {below: 'lg'}}, value: {typography: {scale: {base: 14, ratio: 1.2}}}}]}})`. For butter and stone use `ratio: 1.25` and also set `tokens: {'--text-supporting-size': '12px'}` in that rule's value, because those themes pin supporting text at 12px rather than the 11px the scale alone gives. This cannot be rewritten by a codemod: whether an app wants the floor is a product choice.--@imdreamrunnerdiff --git a/.changeset/powersearch-empty-operator-single-save.md b/.changeset/powersearch-empty-operator-single-save.mddeleted file mode 100644index 2002828f29..0000000000--- a/.changeset/powersearch-empty-operator-single-save.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/core': patch------[fix] The PowerSearch filter editor saves an "empty" operator filter (such as "is empty") exactly once, from the choice that completes it. Choosing such an operator, or switching to a field whose default operator is one, now saves from that choice instead of from an effect. The filter is no longer saved again when the parent re-renders with a new `onSave`, or twice in React StrictMode. Re-choosing the current operator or field saves nothing, and focus still returns to the search input after the editor closes. Clicking an existing empty-operator token in PowerSearch commits it once without opening the built-in editor; a `components.empty.Editor` override still opens.--@cixzhangdiff --git a/.changeset/powersearch-filter-editor-no-save-on-open.md b/.changeset/powersearch-filter-editor-no-save-on-open.mddeleted file mode 100644index 0312f79801..0000000000--- a/.changeset/powersearch-filter-editor-no-save-on-open.md+++ /dev/null@@ -1,13 +0,0 @@-----'@astryxdesign/core': minor------[breaking] `PowerSearchFilterEditor` no longer calls `onSave` when it opens on an already-complete empty-operator filter (such as "is empty").--Old usage: opening a standalone `PowerSearchFilterEditor` on a complete empty-operator filter saved that filter immediately, with no Apply rendered for it, and saved it again whenever the editor remounted.--Replacement: the editor saves only from a user choice in it. Opening it saves nothing.--Migration: if you relied on that save-on-open, call your own `onSave` handler with the filter at the point where you open the editor (or skip opening the editor for empty-operator filters, as PowerSearch now does). This cannot be rewritten by a codemod, because the right place to commit depends on your code.--@cixzhangdiff --git a/.changeset/powersearch-value-save-once.md b/.changeset/powersearch-value-save-once.mddeleted file mode 100644index f227b12114..0000000000--- a/.changeset/powersearch-value-save-once.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/core': patch------[fix] The PowerSearch filter editor saves once when a value that saves on choice is picked (an enum option, a relative-date preset, a suggestion). The save no longer runs inside a React state updater, which React may call more than once, so it no longer fires twice in StrictMode.--@cixzhangdiff --git a/.changeset/release-branch-process-docs.md b/.changeset/release-branch-process-docs.mddeleted file mode 100644index 98f254b477..0000000000--- a/.changeset/release-branch-process-docs.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/cli': patch------[docs] Clarify release-branch codemod promotion and version ownership.--@cixzhangdiff --git a/.changeset/remove-astryx-env-vars.md b/.changeset/remove-astryx-env-vars.mddeleted file mode 100644index dab335d658..0000000000--- a/.changeset/remove-astryx-env-vars.md+++ /dev/null@@ -1,13 +0,0 @@-----'@astryxdesign/cli': minor------[breaking] Stop reading the Astryx-owned agent variables ASTRYX_AGENT_ID, ASTRYX_AGENT_SESSION_ID, and ASTRYX_AGENT_METADATA-@josephfarina--The CLI must not define or read an Astryx-owned environment variable (spec:AST-017 FR14). The theme-import change already stopped reading ASTRYX_THEME; these three were the last. A test now fails on any `process.env.ASTRYX_*` read in the CLI source.--Classification: incompatible-fix. IFIX-0001 / CLN-0007.-Authority: spec:AST-017 FR14 (current): "The CLI MUST NOT define or read an Astryx-owned environment variable."-Released victim: published 0.6.5 and every later release read ASTRYX_AGENT_ID, ASTRYX_AGENT_SESSION_ID, and ASTRYX_AGENT_METADATA to attribute debug events to an agent and its session.-Migration: set `AGENT` and `AGENT_SESSION_ID`, which the CLI already reads, instead of the Astryx-prefixed variants. ASTRYX_AGENT_METADATA has no replacement variable.diff --git a/.changeset/remove-deprecated-theming-compat.md b/.changeset/remove-deprecated-theming-compat.mddeleted file mode 100644index e105b6066a..0000000000--- a/.changeset/remove-deprecated-theming-compat.md+++ /dev/null@@ -1,42 +0,0 @@-----'@astryxdesign/core': minor-'@astryxdesign/cli': minor------[breaking] Remove the deprecated component-theming compatibility surface scheduled for 0.7.0. Components now emit only canonical target classes and reflected `data-*` prop/state selectors. Theme discovery and build output no longer expose deprecated targets, and `ThemePropsOptions` plus `ComponentThemingTarget.deprecatedFor` are removed. The `theme targets --json` response drops the `ThemeTargetEntry.deprecatedFor` field, because no target it lists is deprecated.--Migration: run the required codemod `migrate-deprecated-theme-surface` with `astryx upgrade --from <your 0.6 version> --apply --path .` after upgrading. There is no prior deprecation patch (`DEP-0013`/`CLN-0022` and `DEP-0014`/`CLN-0023`, no prior transition).--The codemod renames removed target keys inside theme `components` maps (an imported `defineTheme()` call, an object typed as an Astryx theme, or a theme object with a static `name`), renames target classes in CSS, and replaces target-qualified bare prop/value/state classes with reflected `data-*` selectors, using every bare class the final 0.6 release emitted. It leaves dynamic/computed theme keys, unqualified or unknown classes, and CSS embedded in JavaScript/TypeScript strings for manual review. It adds `TODO(astryx upgrade)` when old and canonical keys coexist, and when a bare class Astryx once emitted has no known meaning on the target it qualifies.--The four per-component clear-icon aliases all become the shared `input-clear-icon`, which styles every input's clear icon. In CSS the codemod keeps each rule on its component with `:where(.astryx-<component> *)`, which adds no specificity. Theme keys cannot carry that scope, so the codemod adds a TODO naming the CSS selector to use.--Code that passed `{legacyNames}` to `themeProps()` or set `deprecatedFor` in a component doc should delete that argument or field; the canonical target is unchanged.--Rename theme keys and CSS target classes with this complete mapping:--- `base-table` → `table`-- `checkbox` → `checkbox-indicator`-- `codeblock` → `code-block`-- `codeblock-copy-button` → `code-block-copy-button`-- `codeblock-header` → `code-block-header`-- `codeblock-title` → `code-block-title`-- `date-input-clear-icon` → `input-clear-icon`-- `date-range-input-clear-icon` → `input-clear-icon`-- `hovercard` → `hover-card`-- `multi-selector-clear-icon` → `input-clear-icon`-- `navicon` → `nav-icon`-- `popover-surface` → `popover`-- `progressbar` → `progress-bar`-- `progressbar-fill` → `progress-bar-fill`-- `progressbar-mark` → `progress-bar-mark`-- `progressbar-track` → `progress-bar-track`-- `radio` → `radio-indicator`-- `radio-dot` → `radio-indicator-dot`-- `selector-clear-icon` → `input-clear-icon`-- `statusdot` → `status-dot`-- `textarea` → `text-area`--For custom CSS, replace removed bare selectors with the corresponding reflected attribute on a canonical target—for example, `.astryx-button.primary.sm` becomes `.astryx-button[data-variant="primary"][data-size="sm"]`, and `.astryx-switch.checked` becomes `.astryx-switch[data-checked="checked"]`. Review unqualified classes such as `.primary` manually because they may be application-owned.--@cixzhangdiff --git a/.changeset/remove-empty-search-results-text.md b/.changeset/remove-empty-search-results-text.mddeleted file mode 100644index eb5145c0d9..0000000000--- a/.changeset/remove-empty-search-results-text.md+++ /dev/null@@ -1,20 +0,0 @@-----'@astryxdesign/core': minor------[breaking] Remove the deprecated `emptySearchResultsText` prop. Use `emptySearchText`.-@cixzhang--CLN-0001, CLN-0002, CLN-0003, and CLN-0004 complete DEP-0001 through DEP-0004 (spec:AST-056 FR7).--Old usage:-`emptySearchResultsText` on `Tokenizer`, `Typeahead`, and `BaseTypeahead`, and the `emptySearchResultsText` key on a `ChatComposerInput` trigger.--Replacement:-`emptySearchText`, shipped in 0.6.6. It takes a `ReactNode`, so every old string value stays valid. The old name is no longer in the types and is no longer read; a JavaScript caller that still passes it sees the default empty message.--Migration:-Rename `emptySearchResultsText` to `emptySearchText`. Where both are set, keep `emptySearchText` and delete the old one — unless `emptySearchText` could be `null` or `undefined`: 0.6.x then fell back to the old value, so move that value into `emptySearchText` (for example `emptySearchText={value ?? 'Old copy'}`).--Codemod:-`astryx upgrade` runs `rename-empty-search-results-text`, a straight rename at the JSX boundary: the prop on imported `Tokenizer`, `Typeahead`, and `BaseTypeahead` elements, and the key on trigger objects written inline in `ChatComposerInput`'s `triggers`, each renamed as written. Like every Astryx codemod it does not follow variables, helpers, spreads, wrappers, or types; where it cannot attribute the value — `emptySearchText` already set, any spread onto one of these elements (whether or not the element writes the old name), a `triggers` value not written inline, a trigger object with a spread or computed key (whether or not it writes the old name) — it leaves a TODO instead of choosing a winner. The type checker reports any literal `emptySearchResultsText` it did not reach; the TODOs cover the values that reach an element through a spread, which it cannot.\ No newline at end of filediff --git a/.changeset/remove-layout-command.md b/.changeset/remove-layout-command.mddeleted file mode 100644index 371d5fdefd..0000000000--- a/.changeset/remove-layout-command.md+++ /dev/null@@ -1,17 +0,0 @@-----'@astryxdesign/cli': minor------[breaking] Remove the `astryx layout` command group (CLN-0006)--Removes the deprecated `astryx layout` command group (`expand`, `check`, `grammar`),-its three response types (`layout.expand`, `layout.check`, `layout.grammar`), and-the programmatic API exports (`layoutExpand`, `layoutCheck`, `layoutGrammar`).-Completes the `CLN-0006` cleanup of `DEP-0006`.--Use `astryx build` to choose the template to start from, `astryx template` to scaffold-it, and `astryx docs layout` for layout guidance. The layout guide is unaffected. The error codes `ERR_LAYOUT_PARSE` and `ERR_LAYOUT_INVALID` are retained (append-only contract).--Removed JSON ids: `LayoutBlockReference.mode` `LayoutBlockReference.name` `LayoutCheckOptions.cwd` `LayoutCheckOptions.form` `LayoutCheckOptions.loose` `LayoutCheckResponse.data` `LayoutCheckResponse.data.compact` `LayoutCheckResponse.data.errors` `LayoutCheckResponse.data.form` `LayoutCheckResponse.data.outline` `LayoutCheckResponse.data.valid` `LayoutCheckResponse.data.warnings` `LayoutCheckResponse.type` `LayoutExpandOptions.cwd` `LayoutExpandOptions.form` `LayoutExpandOptions.loose` `LayoutExpandOptions.name` `LayoutExpandOptions.targetPath` `LayoutExpandResponse.data` `LayoutExpandResponse.data.blocksReferenced` `LayoutExpandResponse.data.code` `LayoutExpandResponse.data.componentsUsed` `LayoutExpandResponse.data.demoMediaReplaced` `LayoutExpandResponse.data.form` `LayoutExpandResponse.data.states` `LayoutExpandResponse.data.todos` `LayoutExpandResponse.data.warnings` `LayoutExpandResponse.data.written` `LayoutExpandResponse.type` `LayoutGrammarOptions.cwd` `LayoutGrammarResponse.data` `LayoutGrammarResponse.data.aliases` `LayoutGrammarResponse.data.text` `LayoutGrammarResponse.type` `LayoutIssue.col` `LayoutIssue.formatted` `LayoutIssue.line` `LayoutIssue.message` `LayoutIssue.suggestions`--@josephfarinadiff --git a/.changeset/rename-empty-search-results-text-codemod.md b/.changeset/rename-empty-search-results-text-codemod.mddeleted file mode 100644index 3d8081377f..0000000000--- a/.changeset/rename-empty-search-results-text-codemod.md+++ /dev/null@@ -1,6 +0,0 @@-----'@astryxdesign/cli': patch------[feat] `astryx upgrade` renames `emptySearchResultsText` to `emptySearchText` on `Tokenizer`, `Typeahead`, `BaseTypeahead`, and `ChatComposerInput` trigger objects, for the release that removes the old name.-@cixzhangdiff --git a/.changeset/reset-css-now-reaches-before-after-placeholder-a-kgb9.md b/.changeset/reset-css-now-reaches-before-after-placeholder-a-kgb9.mddeleted file mode 100644index 171277d7b1..0000000000--- a/.changeset/reset-css-now-reaches-before-after-placeholder-a-kgb9.md+++ /dev/null@@ -1,11 +0,0 @@-----'@astryxdesign/core': minor------[breaking] `reset.css` now reaches `::before`, `::after`, `::placeholder` and the search field's cancel button, as its comments document. Three of its rules wrote the pseudo-element inside `:where()`, where pseudo-elements are invalid, so browsers dropped those parts of the selector and the rules never applied to them. Each pseudo-element now follows the `:where()`, as in `:where(*)::before`, and the rules stay in `@layer reset`, so any later layer or unlayered style still overrides them.--What changes on a page that loads the reset: a `::before` or `::after` with padding or a border used to size as `content-box` and now sizes as `border-box`; setting only `border-width` on one used to draw nothing and now draws a solid `currentColor` border; a placeholder with no color of its own used to show the browser's grey and now shows `--color-text-secondary` (or that token's own default, `light-dark(#4E606F, #AAAFB5)`, when no Astryx CSS defines it); and a `type="search"` field no longer shows the browser's cancel button.--To keep the old result for one of your own elements, set it in your own CSS: `box-sizing: content-box` or `border-style: none` on the pseudo-element, a `color` on the `::placeholder`, or `appearance: auto` on the field's `::-webkit-search-cancel-button`. There is no codemod: whether a stylesheet relied on the old result cannot be read from its source.--@vjeuxdiff --git a/.changeset/spacing-tokens-rem.md b/.changeset/spacing-tokens-rem.mddeleted file mode 100644index 472861d6e2..0000000000--- a/.changeset/spacing-tokens-rem.md+++ /dev/null@@ -1,22 +0,0 @@-----'@astryxdesign/core': minor-'@astryxdesign/cli': minor------[breaking] Spacing tokens are rem (`--spacing-2: 0.5rem`), so gaps and padding follow the reader's root font size the way the type scale does. Every token value is unchanged at the default 16px root.--One change shows at the default root: the `useTableRowExpansion` chevron now sits centered in its fixed 40px column instead of running past its edge (its button moves from 24–48px to 8–32px of the column). Under a theme with a larger spacing scale, such as matcha, the chevron is visible again and the detail panel lines up with the first column instead of starting 20px past it.--@vjeux--Old usage:-The `--spacing-*` defaults were fixed px (`--spacing-2: 8px`), so `useTheme().token()`, `resolveThemeToken()`, `tokenDefaults` and `spacingDefaults` returned px strings, and spacing stayed the same size when a reader raised the browser font size.--Replacement:-The defaults are rem with the same value at a 16px root (`--spacing-2: 0.5rem`, `--spacing-4: 1rem`), and those readers return the rem string.--Migration:-CSS that reads `var(--spacing-*)` needs no change. Code that parses a spacing token as a px number converts the rem value with the root font size, or reads the element's computed length. A theme that wants fixed px spacing sets the tokens back, for example `defineTheme({tokens: {'--spacing-2': '8px'}})`.--Codemod:-None. A token read and parsed at runtime cannot be found and rewritten statically, and CSS uses need no rewrite.diff --git a/.changeset/stable-neutral-palette-refs.md b/.changeset/stable-neutral-palette-refs.mddeleted file mode 100644index 3f1e483dfb..0000000000--- a/.changeset/stable-neutral-palette-refs.md+++ /dev/null@@ -1,8 +0,0 @@-----'@astryxdesign/cli': patch-'@astryxdesign/theme-neutral': patch------[fix] Generate Neutral's runtime palette references from the stops its theme uses, and fail verification when the package or CLI template copy drifts.--@rubyycheungdiff --git a/.changeset/theme-build-private-vars-fail.md b/.changeset/theme-build-private-vars-fail.mddeleted file mode 100644index 1d98268c13..0000000000--- a/.changeset/theme-build-private-vars-fail.md+++ /dev/null@@ -1,11 +0,0 @@-----'@astryxdesign/cli': minor------[breaking] IFIX-0006 -> CLN-0012 makes `theme build` exit 1 when it reports private `--_*` variables.--The old contract reported private-variable errors but exited 0. The corrected contract keeps the same warnings, receipts, generated files, and `--check` output, but exits 1.--To migrate, a CI step that relied on exit 0 must fix the theme's private `--_*` inputs.--@josephfarinadiff --git a/.changeset/toast-viewport-modal-outlet.md b/.changeset/toast-viewport-modal-outlet.mddeleted file mode 100644index 31738345a1..0000000000--- a/.changeset/toast-viewport-modal-outlet.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/core': patch------[fix] Toasts stay visible and clickable while a Dialog is open. The `ToastViewport` from `LayerProvider` (or the one `useToast` mounts on its own) now moves into the open Dialog, and back when it closes. Before, a Dialog opened after the viewport mounted painted over it, and clicking a toast's close button hit the backdrop and closed the Dialog. Moving the viewport does not reset visible toasts or their timers. A viewport rendered with `isTopLayer={false}` keeps rendering in place.--@ksyingdiff --git a/.changeset/touch-datetime-no-stale-frame.md b/.changeset/touch-datetime-no-stale-frame.mddeleted file mode 100644index ffc44063f5..0000000000--- a/.changeset/touch-datetime-no-stale-frame.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/core': patch------[fix] DateTimeInput's touch picker no longer paints a stale frame. Clearing the value from outside clears the time display in the same update, instead of showing the previous time for one frame, and narrowing `max` (or raising `min`) while the sheet is open keeps the visible month in range in the same update, instead of showing the out-of-range month and then jumping.--@cixzhangdiff --git a/.changeset/vite-light-dark-targets.md b/.changeset/vite-light-dark-targets.mddeleted file mode 100644index 5bb71c70a2..0000000000--- a/.changeset/vite-light-dark-targets.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/build': patch------[fix] Preserve native `light-dark()` token values in Vite source builds by defaulting Lightning CSS to Astryx's supported browser floor.--@cixzhangdiff --git a/packages/build/CHANGELOG.md b/packages/build/CHANGELOG.mdindex a5f50be927..ccebd42000 100644--- a/packages/build/CHANGELOG.md+++ b/packages/build/CHANGELOG.md@@ -1,5 +1,19 @@# @astryxdesign/build+# 0.7.0++#### Fixes++- Preserve native `light-dark()` token values in Vite source builds by defaulting Lightning CSS to Astryx's supported browser floor. (#7330)++#### Contributors++Thanks to everyone who contributed to this release:++- @cixzhang++---+# 0.6.8---diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.mdindex 61a17d0c99..9d87ffd718 100644--- a/packages/cli/CHANGELOG.md+++ b/packages/cli/CHANGELOG.md@@ -1,5 +1,172 @@# @xds/cli+# 0.7.0++#### Breaking Changes++- `theme add` now imports built themes; use `theme eject` to copy theme source. (#7138)+ The old contract copied theme source with `theme add <slug> [path] [--overwrite] [--package <package>]` and returned `theme.add` JSON. The `ThemeAddResponse` type and the `theme.add` response type are removed, with their `ThemeAddResponse.type`, `ThemeAddResponse.data`, and `ThemeAddResponse.meta` fields. The replacement imports the built theme with `theme add <slug> [--package <package>]` and returns `theme.app`; `--import` remains an accepted no-op. Plain `theme add` now returns `theme.app` with the owner `package` directly after `type`. Local themes carry no package.++ A path after `theme add` now exits 1 with `ERR_INVALID_ARGUMENT`, and `--overwrite` exits 1 with `ERR_INVALID_OPTION`; neither writes files. To migrate a script that copied source, run `theme eject` with the same slug, path, `--overwrite`, and `--package` arguments. A script that already runs `theme add --import` keeps the same meaning and needs no change.++- `init --remove-agents` says when there was nothing to remove. (#6623)+ Migration: a consumer reading `data.removed` as a boolean keeps working; a consumer that narrowed on the literal `true` must accept the corrected value.+- Four commands refuse silently ignored option pairs. (#7132)+ Migration: remove the option the command was ignoring.+- Refuse invalid input that used to silently succeed. (#7149)+ Migration: pass a valid type or package, an integer limit, or the documented arguments, and catch `ERR_AMBIGUOUS_COMPONENT` for a multi-package name.+- An empty-string argument no longer discards the rest of the command. (#6620)+ Migration: remove the empty string from the invocation; omit the argument to list.+- `doctor integration validate` exits 1 when there is no package.json. (#7150)+ A missing package.json now produces a `no_package` error, so the existing error-severity exit rule applies. A directory with package.json but no integration manifest still exits 0.++ Migration: run the command in a directory that has a `package.json`, or handle exit 1 for that case.++- Move canonical data-color defaults from generated theme CSS to the public StyleX `dataVars` group. (#6834)+ Import `dataVars` from `@astryxdesign/core/theme/dataTokens.stylex` for CSS-capable code. Canvas and other non-CSS APIs continue to use `resolveThemeToken()` or `useTheme().token()`. Rebuild committed theme CSS with `astryx theme build`; concrete themes now emit only explicitly authored data-color overrides.++ Old usage: Generated theme CSS owned the canonical `--color-data-*` root defaults.++ Replacement: The public StyleX `dataVars` group in `@astryxdesign/core/theme/dataTokens.stylex` owns the defaults; concrete themes emit only explicitly authored data-color overrides.++ Migration: Import `dataVars` from `@astryxdesign/core/theme/dataTokens.stylex` for CSS-capable code. Canvas and other non-CSS APIs continue to use `resolveThemeToken()` or `useTheme().token()`. Rebuild committed theme CSS with `astryx theme build`.++ Codemod: `astryx upgrade` runs `validate-data-token-ownership`, which rewrites nothing and reports fallback-less `var(--color-data-*)` uses (whole or embedded source strings, and stylesheets) and stale generated theme CSS for manual migration.++- Doctor fails when the CLI cannot load what astryx.config asks for (#7130)+ A new `configured-integrations` check fails when an integration named in astryx.config cannot be loaded: not installed, installed without a manifest, or a manifest that throws or fails its schema. Such an integration is withdrawn whole and contributes nothing. The config check fails, instead of warning, when astryx.config imports but the CLI cannot load the project from it.++ Unchanged: a problem inside one contribution kind (an invalid component doc, a missing or unreadable root, or an unresolved replacement) stays a warning under `integration-issues`, and an autolinked dependency that cannot be loaded stays informational.++ No codemod applies: nothing in a project's source changes; install the integration, repair its manifest, or edit `integrations` in astryx.config.++ What counts as configured is every name astryx.config lists, including a package set aside for a provider conflict and the package being authored when its own config names it. Migration: install the integration, fix its manifest, or remove it from `integrations`; fix the astryx.config field the message names.++- Typeahead, Tokenizer, CheckboxList, RadioList, and Slider no longer accept root `xstyle`, `className`, or `style`. Style the field with `containerXstyle`/`containerClassName`/`containerStyle` (the Field box; no effect inside InputGroup or a `horizontal-labels` FormLayout) and the visual control box with `controlXstyle`/`controlClassName`/`controlStyle`. Base props now reach the primary semantic control: the combobox input for Typeahead and Tokenizer, the `role="group"`/`role="radiogroup"` element for CheckboxList and RadioList, and the `role="slider"` thumb for Slider (the `role="group"` control in range mode). A caller `aria-describedby` is kept alongside the field's own description and status, on these components and on TextInput, TextArea, and NumberInput, which previously dropped it. CLI templates use the new props. (#7339)+ Migration: rename root `xstyle`/`className`/`style` to the part they styled before: `containerXstyle`/`containerClassName`/`containerStyle` on all five components, except a Typeahead inside InputGroup, whose root styling painted the control surface and moves to `controlXstyle`/`controlClassName`/`controlStyle`. The release's `astryx upgrade` codemod, `migrate-field-input-styling`, performs these renames on JSX usage.++ Not rewritten by the codemod, so update by hand:++ - `ref` and `id`, plus `data-*` (except Typeahead and Tokenizer `data-testid`, which marked the control surface), `aria-*`, and DOM event handlers such as `onClick`, previously landed on the outer Field (or were dropped by RadioList and Slider). They now land on the primary semantic control. Update code that measured, queried, or listened on the outer field, and wrap the component in your own element when you need an outer boundary.+ - Typeahead and Tokenizer refs are now `HTMLInputElement`.+ - A consumer `onKeyDown` on Typeahead or Tokenizer still runs after the built-in key handling, cannot cancel it, and still fires for keys on the clear button and tokens; for keys on the input it now runs on the combobox input itself.+ - RadioList and Slider used to drop DOM event handlers; they now run after the component's own handling, so a Slider `onPointerDown`, `onKeyDown`, `onFocus`, or `onBlur` that never fired before now fires (on the thumb, or on the group in range mode).+ - Tokenizer's `onFocus`/`onBlur` keep their meaning: focus entering or leaving the field.+ - Styling passed through a wrapper's own props or a spread is not rewritten and now fails type-checking at that callsite.++ Untyped callers get a development warning and the value is ignored.++ From #5656 by @harjothkhara.++- Selector, MultiSelector, and ComplexSelector no longer accept root `xstyle`, `className`, or `style`. Style the field with `containerXstyle`/`containerClassName`/`containerStyle` (the Field box; no effect inside InputGroup, a `horizontal-labels` FormLayout, or with `renderTrigger`) and the visual control box with `controlXstyle`/`controlClassName`/`controlStyle`. Base props such as `ref`, `id`, `data-*` (including `data-testid`), `aria-*`, and DOM handlers reach the trigger button that carries the combobox role (or, with `renderTrigger`, the caller's control), and a caller `aria-describedby` is kept alongside the field's own description and status instead of being replaced. Handlers keep their existing order: a ComplexSelector `onClick` on its own trigger can still cancel opening, and newly forwarded handlers (including those reaching a `renderTrigger` control) run after the built-in toggle and keyboard handling. CLI templates use the new props. (#7341)+ Migration: rename root `xstyle`/`className`/`style` on these components to `controlXstyle`/`controlClassName`/`controlStyle`, which style the same element as before. Not a rename: a `data-testid` or other base prop now lands on the trigger button rather than the bordered box around it (query the box with `.closest()` if a test measured it), and with `renderTrigger` base props and `ref` now reach the caller's control. Rename JSX usage by hand, or run `astryx upgrade`; it runs `migrate-field-input-styling`, which does not follow styling passed through a wrapper's own props or a spread, which now fails type-checking at that callsite, so rename it there. Untyped callers get a development warning and the value is ignored.++ From #5656 by @harjothkhara.++- TextInput, TextArea, NumberInput, and FileInput no longer accept root `xstyle`, `className`, or `style`. Style the field with `containerXstyle`/`containerClassName`/`containerStyle` (the Field box; no effect inside InputGroup or a `horizontal-labels` FormLayout) and the visual control box with `controlXstyle`/`controlClassName`/`controlStyle`. Base props such as `ref`, `id`, `data-*`, `aria-*`, and DOM handlers reach the native control, and a caller `id` is now honored there. CLI templates use the new props. (#7336)+ Migration: rename root `xstyle`/`className`/`style` on these components to `controlXstyle`/`controlClassName`/`controlStyle`, which style the same element as before. `astryx upgrade` rewrites JSX usage; styling passed through a wrapper's own props or a spread is not rewritten and now fails type-checking at that callsite, so rename it there. Untyped callers get a development warning and the value is ignored. Not rewritten by the codemod: a caller `id` used to be replaced by a generated one and now reaches the native control (the label stays associated), so remove an `id` you passed but relied on being ignored. Other base props already reached the native control and are unchanged.++ From #5656 by @harjothkhara.++- matcha's and y2k's spacing steps are rem (`--spacing-2: 0.75rem`), so their gaps and padding follow the reader's root font size like the core scale. Every step is the same pixel value at the default 16px root; a reader with a larger root font size now sees proportionally larger spacing on these themes. The CLI's copies of both theme templates and the annotated theme template's spacing example change the same way. (#7374)+ Migration: nothing to change to take the new behaviour. To keep fixed pixel spacing on one of these themes, extend it and override the steps in px, which is honoured as written: `defineTheme({name: 'app', extends: matchaTheme, tokens: {'--spacing-2': '12px'}})`.+- On touch devices narrower than the `lg` breakpoint (`(width < 1024px) and (pointer: coarse)`), the 14px-base first-party themes now floor their type base to 16px and re-derive the ratio so Display 1 keeps its desktop size: neutral and chocolate (base 14, ratio 1.2 → 1.1736) and butter and stone (base 14, ratio 1.25 → 1.2225). On phones, body, label and code text rise from 14px to 16px; supporting text, the headings and Display 2 and 3 grow by 1–2px; only Display 1 holds its desktop size. Desktop sizes are unchanged. gothic, matcha and y2k already use a 16px base and need no rule. The CLI's theme templates carry the same rule, so a newly scaffolded theme gets it too. (#6699)+ An app theme that extends one of these four themes and sets its own `typography.scale` or type-size tokens inherits this rule, and on touch + narrow screens the rule replaces those values (a base-18 child drops to a 16px body and a 42px Display 1). Append your own rule for the same condition with the values you want; a later rule for the same condition wins.++ Migration: nothing to change to take the new phone scale. To keep the previous 14px phone scale in an app, extend the theme and append a later rule for the same condition: `defineTheme({name: 'app', extends: neutralTheme, adaptations: {rules: [{when: {pointer: 'coarse', width: {below: 'lg'}}, value: {typography: {scale: {base: 14, ratio: 1.2}}}}]}})`. For butter and stone use `ratio: 1.25` and also set `tokens: {'--text-supporting-size': '12px'}` in that rule's value, because those themes pin supporting text at 12px rather than the 11px the scale alone gives. This cannot be rewritten by a codemod: whether an app wants the floor is a product choice.++- Stop reading the Astryx-owned agent variables ASTRYX_AGENT_ID, ASTRYX_AGENT_SESSION_ID, and ASTRYX_AGENT_METADATA (#7127)+ The theme-import change already stopped reading `ASTRYX_THEME`; these three were the last Astryx-owned agent variables. A test now fails on any `process.env.ASTRYX_*` read in the CLI source.++ Migration: set `AGENT` and `AGENT_SESSION_ID`, which the CLI already reads, instead of the Astryx-prefixed variants. `ASTRYX_AGENT_METADATA` has no replacement variable.++- Remove the deprecated component-theming compatibility surface scheduled for 0.7.0. Components now emit only canonical target classes and reflected `data-*` prop/state selectors. Theme discovery and build output no longer expose deprecated targets, and `ThemePropsOptions` plus `ComponentThemingTarget.deprecatedFor` are removed. The `theme targets --json` response drops the `ThemeTargetEntry.deprecatedFor` field, because no target it lists is deprecated. (#7302)+ Migration: run the required codemod `migrate-deprecated-theme-surface` with `astryx upgrade --from <your 0.6 version> --apply --path .` after upgrading.++ The codemod renames removed target keys inside theme `components` maps (an imported `defineTheme()` call, an object typed as an Astryx theme, or a theme object with a static `name`), renames target classes in CSS, and replaces target-qualified bare prop/value/state classes with reflected `data-*` selectors, using every bare class the final 0.6 release emitted. It leaves dynamic/computed theme keys, unqualified or unknown classes, and CSS embedded in JavaScript/TypeScript strings for manual review. It adds `TODO(astryx upgrade)` when old and canonical keys coexist, and when a bare class Astryx once emitted has no known meaning on the target it qualifies.++ The four per-component clear-icon aliases all become the shared `input-clear-icon`, which styles every input's clear icon. In CSS the codemod keeps each rule on its component with `:where(.astryx-<component> *)`, which adds no specificity. Theme keys cannot carry that scope, so the codemod adds a TODO naming the CSS selector to use.++ Code that passed `{legacyNames}` to `themeProps()` or set `deprecatedFor` in a component doc should delete that argument or field; the canonical target is unchanged.++ Rename theme keys and CSS target classes with this complete mapping:++ - `base-table` → `table`+ - `checkbox` → `checkbox-indicator`+ - `codeblock` → `code-block`+ - `codeblock-copy-button` → `code-block-copy-button`+ - `codeblock-header` → `code-block-header`+ - `codeblock-title` → `code-block-title`+ - `date-input-clear-icon` → `input-clear-icon`+ - `date-range-input-clear-icon` → `input-clear-icon`+ - `hovercard` → `hover-card`+ - `multi-selector-clear-icon` → `input-clear-icon`+ - `navicon` → `nav-icon`+ - `popover-surface` → `popover`+ - `progressbar` → `progress-bar`+ - `progressbar-fill` → `progress-bar-fill`+ - `progressbar-mark` → `progress-bar-mark`+ - `progressbar-track` → `progress-bar-track`+ - `radio` → `radio-indicator`+ - `radio-dot` → `radio-indicator-dot`+ - `selector-clear-icon` → `input-clear-icon`+ - `statusdot` → `status-dot`+ - `textarea` → `text-area`++ For custom CSS, replace removed bare selectors with the corresponding reflected attribute on a canonical target—for example, `.astryx-button.primary.sm` becomes `.astryx-button[data-variant="primary"][data-size="sm"]`, and `.astryx-switch.checked` becomes `.astryx-switch[data-checked="checked"]`. Review unqualified classes such as `.primary` manually because they may be application-owned.++- Remove the `astryx layout` command group. (#7137)+ Removes the deprecated `astryx layout` command group (`expand`, `check`, `grammar`), its three response types (`layout.expand`, `layout.check`, `layout.grammar`), and the programmatic API exports (`layoutExpand`, `layoutCheck`, `layoutGrammar`).++ Use `astryx build` to choose the template to start from, `astryx template` to scaffold it, and `astryx docs layout` for layout guidance. The layout guide is unaffected. The error codes `ERR_LAYOUT_PARSE` and `ERR_LAYOUT_INVALID` are retained.++ Removed JSON ids: `LayoutBlockReference.mode` `LayoutBlockReference.name` `LayoutCheckOptions.cwd` `LayoutCheckOptions.form` `LayoutCheckOptions.loose` `LayoutCheckResponse.data` `LayoutCheckResponse.data.compact` `LayoutCheckResponse.data.errors` `LayoutCheckResponse.data.form` `LayoutCheckResponse.data.outline` `LayoutCheckResponse.data.valid` `LayoutCheckResponse.data.warnings` `LayoutCheckResponse.type` `LayoutExpandOptions.cwd` `LayoutExpandOptions.form` `LayoutExpandOptions.loose` `LayoutExpandOptions.name` `LayoutExpandOptions.targetPath` `LayoutExpandResponse.data` `LayoutExpandResponse.data.blocksReferenced` `LayoutExpandResponse.data.code` `LayoutExpandResponse.data.componentsUsed` `LayoutExpandResponse.data.demoMediaReplaced` `LayoutExpandResponse.data.form` `LayoutExpandResponse.data.states` `LayoutExpandResponse.data.todos` `LayoutExpandResponse.data.warnings` `LayoutExpandResponse.data.written` `LayoutExpandResponse.type` `LayoutGrammarOptions.cwd` `LayoutGrammarResponse.data` `LayoutGrammarResponse.data.aliases` `LayoutGrammarResponse.data.text` `LayoutGrammarResponse.type` `LayoutIssue.col` `LayoutIssue.formatted` `LayoutIssue.line` `LayoutIssue.message` `LayoutIssue.suggestions`++- Spacing tokens are rem (`--spacing-2: 0.5rem`), so gaps and padding follow the reader's root font size the way the type scale does. Every token value is unchanged at the default 16px root. (#7359)+ One change shows at the default root: the `useTableRowExpansion` chevron now sits centered in its fixed 40px column instead of running past its edge (its button moves from 24–48px to 8–32px of the column). Under a theme with a larger spacing scale, such as matcha, the chevron is visible again and the detail panel lines up with the first column instead of starting 20px past it.++ Old usage: The `--spacing-*` defaults were fixed px (`--spacing-2: 8px`), so `useTheme().token()`, `resolveThemeToken()`, `tokenDefaults` and `spacingDefaults` returned px strings, and spacing stayed the same size when a reader raised the browser font size.++ Replacement: The defaults are rem with the same value at a 16px root (`--spacing-2: 0.5rem`, `--spacing-4: 1rem`), and those readers return the rem string.++ Migration: CSS that reads `var(--spacing-*)` needs no change. Code that parses a spacing token as a px number converts the rem value with the root font size, or reads the element's computed length. A theme that wants fixed px spacing sets the tokens back, for example `defineTheme({tokens: {'--spacing-2': '8px'}})`.++ Codemod: None. A token read and parsed at runtime cannot be found and rewritten statically, and CSS uses need no rewrite.++- `theme build` exits 1 when it reports private `--_*` variables. (#6872)+ The old contract reported private-variable errors but exited 0. The corrected contract keeps the same warnings, receipts, generated files, and `--check` output, but exits 1.++ To migrate, a CI step that relied on exit 0 must fix the theme's private `--_*` inputs.++#### New Features++- `astryx upgrade` adds `padding={0}` to BottomSheet elements that do not set `padding`, keeping their unpadded content box now that BottomSheet pads like Dialog. Sheets whose only child is a Section or a Layout are left unchanged. A sheet with a Layout anywhere in its content also gets a TODO comment, because `padding={0}` removes the inset between that Layout's regions and the Layout's own `padding` restores only its outer edges. A shadowed `BottomSheet` binding is left alone, and a second run changes nothing. (#6884)+- `astryx upgrade` runs `migrate-field-input-styling`, which renames root `xstyle`/`className`/`style` on Field-composed inputs to the part they styled before: `controlXstyle`/`controlClassName`/`controlStyle` on TextInput, TextArea, NumberInput, FileInput, DateInput, DateRangeInput, DateTimeInput, TimeInput, Selector, MultiSelector, and ComplexSelector, and `containerXstyle`/`containerClassName`/`containerStyle` on Typeahead, Tokenizer, CheckboxList, RadioList, and Slider. It rewrites JSX written directly on an Astryx import (named, aliased, or namespace). Spreads and wrappers that forward their own styling props are left for manual migration, and a callsite that already sets the target prop gets a TODO instead of a rename. (#7342)+- `astryx upgrade` renames `emptySearchResultsText` to `emptySearchText` on `Tokenizer`, `Typeahead`, `BaseTypeahead`, and `ChatComposerInput` trigger objects, for the release that removes the old name. (#7289)++#### Fixes++- `template` and `build` follow the project's package manager. The nearest directory from the target up to the workspace root that has a `packageManager` field or a lockfile decides. With neither, the command uses npm, whatever package manager launched the CLI. When that directory's lockfiles disagree and nothing it commits picks one, `installCommand` is `null` and the note names the missing packages, the directory, and the lockfiles that disagree, instead of guessing a command that would write a second lockfile. (#7343)+- Teach generated palette references in the full custom-theme authoring guide. (#7268)+- Generate Neutral's runtime palette references from the stops its theme uses, and fail verification when the package or CLI template copy drifts. (#7255)++#### Documentation++- Clarify release-branch codemod promotion and version ownership. (#7293)++#### Contributors++Thanks to everyone who contributed to this release:++- @cixzhang+- @harjothkhara+- @imdreamrunner+- @josephfarina+- @rubyycheung+- @vjeux++---+# 0.6.8#### Fixesdiff --git a/packages/cli/assets/codemods/__tests__/registry.test.mjs b/packages/cli/assets/codemods/__tests__/registry.test.mjsindex d26c52d100..fb0820e6fe 100644--- a/packages/cli/assets/codemods/__tests__/registry.test.mjs+++ b/packages/cli/assets/codemods/__tests__/registry.test.mjs@@ -30,6 +30,7 @@ describe('registry', () => {'0.6.0','0.6.4','0.6.7',+ '0.7.0',]);});});diff --git a/packages/cli/assets/codemods/registry.mjs b/packages/cli/assets/codemods/registry.mjsindex 087afd6d7b..87c54768b9 100644--- a/packages/cli/assets/codemods/registry.mjs+++ b/packages/cli/assets/codemods/registry.mjs@@ -31,6 +31,7 @@ const registry = new Map([['0.6.0', () => import('./transforms/v0.6.0/index.mjs')],['0.6.4', () => import('./transforms/v0.6.4/index.mjs')],['0.6.7', () => import('./transforms/v0.6.7/index.mjs')],+ ['0.7.0', () => import('./transforms/v0.7.0/index.mjs')],]);// Re-export from the shared utility so registry callers and other consumersdiff --git a/packages/cli/assets/codemods/transforms/next/index.mjs b/packages/cli/assets/codemods/transforms/next/index.mjsindex 2accda6527..2af3bdfcf0 100644--- a/packages/cli/assets/codemods/transforms/next/index.mjs+++ b/packages/cli/assets/codemods/transforms/next/index.mjs@@ -7,46 +7,4 @@* this file into the resolved version folder.*/-import migrateDeprecatedThemeSurface, {- meta as migrateDeprecatedThemeSurfaceMeta,-} from './migrate-deprecated-theme-surface.mjs';-import migrateFieldInputStyling, {- meta as migrateFieldInputStylingMeta,-} from './migrate-field-input-styling.mjs';-import preserveBottomSheetContentPadding, {- meta as preserveBottomSheetContentPaddingMeta,-} from './preserve-bottom-sheet-content-padding.mjs';-import renameEmptySearchResultsText, {- meta as renameEmptySearchResultsTextMeta,-} from './rename-empty-search-results-text.mjs';-import validateDataTokenOwnership, {- meta as validateDataTokenOwnershipMeta,-} from './validate-data-token-ownership.mjs';--export default [- {- name: 'migrate-deprecated-theme-surface',- transform: migrateDeprecatedThemeSurface,- meta: migrateDeprecatedThemeSurfaceMeta,- },- {- name: 'validate-data-token-ownership',- transform: validateDataTokenOwnership,- meta: validateDataTokenOwnershipMeta,- },- {- name: 'migrate-field-input-styling',- transform: migrateFieldInputStyling,- meta: migrateFieldInputStylingMeta,- },- {- name: 'preserve-bottom-sheet-content-padding',- transform: preserveBottomSheetContentPadding,- meta: preserveBottomSheetContentPaddingMeta,- },- {- name: 'rename-empty-search-results-text',- transform: renameEmptySearchResultsText,- meta: renameEmptySearchResultsTextMeta,- },-];+export default [];diff --git a/packages/cli/assets/codemods/transforms/next/__tests__/migrate-deprecated-theme-surface.test.mjs b/packages/cli/assets/codemods/transforms/v0.7.0/__tests__/migrate-deprecated-theme-surface.test.mjssimilarity index 100%rename from packages/cli/assets/codemods/transforms/next/__tests__/migrate-deprecated-theme-surface.test.mjsrename to packages/cli/assets/codemods/transforms/v0.7.0/__tests__/migrate-deprecated-theme-surface.test.mjsdiff --git a/packages/cli/assets/codemods/transforms/next/__tests__/migrate-field-input-styling.test.mjs b/packages/cli/assets/codemods/transforms/v0.7.0/__tests__/migrate-field-input-styling.test.mjssimilarity index 100%rename from packages/cli/assets/codemods/transforms/next/__tests__/migrate-field-input-styling.test.mjsrename to packages/cli/assets/codemods/transforms/v0.7.0/__tests__/migrate-field-input-styling.test.mjsdiff --git a/packages/cli/assets/codemods/transforms/next/__tests__/preserve-bottom-sheet-content-padding.test.mjs b/packages/cli/assets/codemods/transforms/v0.7.0/__tests__/preserve-bottom-sheet-content-padding.test.mjssimilarity index 100%rename from packages/cli/assets/codemods/transforms/next/__tests__/preserve-bottom-sheet-content-padding.test.mjsrename to packages/cli/assets/codemods/transforms/v0.7.0/__tests__/preserve-bottom-sheet-content-padding.test.mjsdiff --git a/packages/cli/assets/codemods/transforms/next/__tests__/rename-empty-search-results-text.test.mjs b/packages/cli/assets/codemods/transforms/v0.7.0/__tests__/rename-empty-search-results-text.test.mjssimilarity index 100%rename from packages/cli/assets/codemods/transforms/next/__tests__/rename-empty-search-results-text.test.mjsrename to packages/cli/assets/codemods/transforms/v0.7.0/__tests__/rename-empty-search-results-text.test.mjsdiff --git a/packages/cli/assets/codemods/transforms/next/__tests__/validate-data-token-ownership.test.mjs b/packages/cli/assets/codemods/transforms/v0.7.0/__tests__/validate-data-token-ownership.test.mjssimilarity index 100%rename from packages/cli/assets/codemods/transforms/next/__tests__/validate-data-token-ownership.test.mjsrename to packages/cli/assets/codemods/transforms/v0.7.0/__tests__/validate-data-token-ownership.test.mjsdiff --git a/packages/cli/assets/codemods/transforms/v0.7.0/index.mjs b/packages/cli/assets/codemods/transforms/v0.7.0/index.mjsnew file mode 100644index 0000000000..2accda6527--- /dev/null+++ b/packages/cli/assets/codemods/transforms/v0.7.0/index.mjs@@ -0,0 +1,52 @@+// Copyright (c) Meta Platforms, Inc. and affiliates.++/**+ * @file next transform manifest+ *+ * Staged codemods for the next release. The Version Packages PR promotes+ * this file into the resolved version folder.+ */++import migrateDeprecatedThemeSurface, {+ meta as migrateDeprecatedThemeSurfaceMeta,+} from './migrate-deprecated-theme-surface.mjs';+import migrateFieldInputStyling, {+ meta as migrateFieldInputStylingMeta,+} from './migrate-field-input-styling.mjs';+import preserveBottomSheetContentPadding, {+ meta as preserveBottomSheetContentPaddingMeta,+} from './preserve-bottom-sheet-content-padding.mjs';+import renameEmptySearchResultsText, {+ meta as renameEmptySearchResultsTextMeta,+} from './rename-empty-search-results-text.mjs';+import validateDataTokenOwnership, {+ meta as validateDataTokenOwnershipMeta,+} from './validate-data-token-ownership.mjs';++export default [+ {+ name: 'migrate-deprecated-theme-surface',+ transform: migrateDeprecatedThemeSurface,+ meta: migrateDeprecatedThemeSurfaceMeta,+ },+ {+ name: 'validate-data-token-ownership',+ transform: validateDataTokenOwnership,+ meta: validateDataTokenOwnershipMeta,+ },+ {+ name: 'migrate-field-input-styling',+ transform: migrateFieldInputStyling,+ meta: migrateFieldInputStylingMeta,+ },+ {+ name: 'preserve-bottom-sheet-content-padding',+ transform: preserveBottomSheetContentPadding,+ meta: preserveBottomSheetContentPaddingMeta,+ },+ {+ name: 'rename-empty-search-results-text',+ transform: renameEmptySearchResultsText,+ meta: renameEmptySearchResultsTextMeta,+ },+];diff --git a/packages/cli/assets/codemods/transforms/next/migrate-deprecated-theme-surface-v0.6-data.mjs b/packages/cli/assets/codemods/transforms/v0.7.0/migrate-deprecated-theme-surface-v0.6-data.mjssimilarity index 100%rename from packages/cli/assets/codemods/transforms/next/migrate-deprecated-theme-surface-v0.6-data.mjsrename to packages/cli/assets/codemods/transforms/v0.7.0/migrate-deprecated-theme-surface-v0.6-data.mjsdiff --git a/packages/cli/assets/codemods/transforms/next/migrate-deprecated-theme-surface.mjs b/packages/cli/assets/codemods/transforms/v0.7.0/migrate-deprecated-theme-surface.mjssimilarity index 100%rename from packages/cli/assets/codemods/transforms/next/migrate-deprecated-theme-surface.mjsrename to packages/cli/assets/codemods/transforms/v0.7.0/migrate-deprecated-theme-surface.mjsdiff --git a/packages/cli/assets/codemods/transforms/next/migrate-field-input-styling.mjs b/packages/cli/assets/codemods/transforms/v0.7.0/migrate-field-input-styling.mjssimilarity index 100%rename from packages/cli/assets/codemods/transforms/next/migrate-field-input-styling.mjsrename to packages/cli/assets/codemods/transforms/v0.7.0/migrate-field-input-styling.mjsdiff --git a/packages/cli/assets/codemods/transforms/next/preserve-bottom-sheet-content-padding.mjs b/packages/cli/assets/codemods/transforms/v0.7.0/preserve-bottom-sheet-content-padding.mjssimilarity index 100%rename from packages/cli/assets/codemods/transforms/next/preserve-bottom-sheet-content-padding.mjsrename to packages/cli/assets/codemods/transforms/v0.7.0/preserve-bottom-sheet-content-padding.mjsdiff --git a/packages/cli/assets/codemods/transforms/next/rename-empty-search-results-text.mjs b/packages/cli/assets/codemods/transforms/v0.7.0/rename-empty-search-results-text.mjssimilarity index 100%rename from packages/cli/assets/codemods/transforms/next/rename-empty-search-results-text.mjsrename to packages/cli/assets/codemods/transforms/v0.7.0/rename-empty-search-results-text.mjsdiff --git a/packages/cli/assets/codemods/transforms/next/validate-data-token-ownership.mjs b/packages/cli/assets/codemods/transforms/v0.7.0/validate-data-token-ownership.mjssimilarity index 100%rename from packages/cli/assets/codemods/transforms/next/validate-data-token-ownership.mjsrename to packages/cli/assets/codemods/transforms/v0.7.0/validate-data-token-ownership.mjsdiff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.mdindex 383f77ac2e..82f2dd7cef 100644--- a/packages/core/CHANGELOG.md+++ b/packages/core/CHANGELOG.md@@ -1,5 +1,191 @@# @xds/core+# 0.7.0++#### Breaking Changes++- Stop deriving live-region roles from `Banner.status`. Banners are non-live by default; call `useAnnounce` from the actual async transition handler, or provide an explicit `role="status"` for a persistent semantic mirror. (#6630)+ `role="alert"` is now opt-in rather than automatic for warning and error banners.++ Old usage: `Banner` derived `role="status"` or `role="alert"` from its `status` variant.++ Replacement: The caller sets the role explicitly, or announces with `useAnnounce`.++ Migration: Call `useAnnounce` from the actual async transition handler, or provide an explicit `role="status"` for a persistent semantic mirror.++ Codemod: None — the right announcement depends on the callsite.++- Layout, MetadataList, NavHeadingMenuItem and TopNavMegaMenuItem now apply the BaseProps they accept (id, role, aria-\*, data-\*, hidden, inert, dir, event handlers; TopNavMegaMenuItem also xstyle/className/style) instead of silently dropping them; NavHeadingMenu keeps arrow navigation when an item handler cancels. (#7331)+ Migration: remove any of those props you passed that you relied on being ignored; a TopNavMegaMenuItem styled through xstyle/className/style now shows that styling.++ From #5656 by @harjothkhara.++- BottomSheet pads its content by default, like Dialog. With no `padding` prop and no theme padding, the content box now pads by `--spacing-4` (it had no padding before) and publishes that inset. (#6884)+ A sheet whose only child is a padded `Section` or a `Layout` renders as before, because both escape the inset. Content that supplies its own inset is now padded twice: drop that inset, or pass `padding={0}` to keep the unpadded content box. `astryx upgrade` ships `preserve-bottom-sheet-content-padding`, which adds `padding={0}` where needed.++ Migration: pass `padding={0}` to keep the unpadded content box, or drop your own inset to take the default; `astryx upgrade` adds `padding={0}` to every BottomSheet that sets no padding unless its only child is a padded Section or a Layout. An app whose theme already sets `bottom-sheet` padding on every edge is not affected by the new default; the codemod cannot see the theme, so remove the `padding={0}` it adds there to keep the theme inset. A sheet whose content wraps a `Layout` gets a TODO: `padding={0}` also removes the inset between that Layout's regions, which the Layout's own `padding` does not restore.++- Require `upload` on complete `IconRegistry` types (#7329)+ Old usage: A custom complete icon registry typed as `IconRegistry` that omitted the `upload` key.++ Replacement: `IconRegistry` now requires all semantic `IconName` keys, including `upload`.++ Migration: Add an `upload` entry drawn in your registry's icon style to complete icon registries typed as `IconRegistry`.++ Codemod: No `astryx upgrade` codemod applies because icon artwork is bespoke design artwork tailored to each theme and cannot be automatically synthesized.++- Move canonical data-color defaults from generated theme CSS to the public StyleX `dataVars` group. (#6834)+ Import `dataVars` from `@astryxdesign/core/theme/dataTokens.stylex` for CSS-capable code. Canvas and other non-CSS APIs continue to use `resolveThemeToken()` or `useTheme().token()`. Rebuild committed theme CSS with `astryx theme build`; concrete themes now emit only explicitly authored data-color overrides.++ Old usage: Generated theme CSS owned the canonical `--color-data-*` root defaults.++ Replacement: The public StyleX `dataVars` group in `@astryxdesign/core/theme/dataTokens.stylex` owns the defaults; concrete themes emit only explicitly authored data-color overrides.++ Migration: Import `dataVars` from `@astryxdesign/core/theme/dataTokens.stylex` for CSS-capable code. Canvas and other non-CSS APIs continue to use `resolveThemeToken()` or `useTheme().token()`. Rebuild committed theme CSS with `astryx theme build`.++ Codemod: `astryx upgrade` runs `validate-data-token-ownership`, which rewrites nothing and reports fallback-less `var(--color-data-*)` uses (whole or embedded source strings, and stylesheets) and stale generated theme CSS for manual migration.++- DateInput, DateRangeInput, DateTimeInput, and TimeInput no longer accept root `xstyle`, `className`, or `style`. Style the field with `containerXstyle`/`containerClassName`/`containerStyle` (the Field box; no effect inside InputGroup or a `horizontal-labels` FormLayout) and the visual control box with `controlXstyle`/`controlClassName`/`controlStyle`. Base props such as `ref`, `id`, `data-*`, `aria-*`, and DOM handlers reach the field's semantic control on every surface (the date, time, or date-time input; DateRangeInput's range trigger) instead of the wrapper, TimeInput no longer drops them, and a caller `id` is now honored there. A caller `aria-describedby` is added to the component's own description ids, and a caller `aria-labelledby` is read after the field's own label (on DateRangeInput, after its label and selected range); a caller `aria-label` on DateRangeInput replaces the trigger's name. (#7337)+ Migration: rename root `xstyle`/`className`/`style` on these components to `controlXstyle`/`controlClassName`/`controlStyle`, which style the same element as before (for DateTimeInput, the row holding the date and time segments). Rename by hand, or run `astryx upgrade`; it runs `migrate-field-input-styling`, which rewrites JSX usage; styling passed through a wrapper's own props or a spread is never rewritten and now fails type-checking at that callsite, so rename it there. Untyped callers get a development warning and the value is ignored. A DOM handler or `data-*` attribute that relied on landing on the wrapper now lands on the control; a handler still runs after the component's own and still receives events the component handled.++ From #5656 by @harjothkhara.++- Typeahead, Tokenizer, CheckboxList, RadioList, and Slider no longer accept root `xstyle`, `className`, or `style`. Style the field with `containerXstyle`/`containerClassName`/`containerStyle` (the Field box; no effect inside InputGroup or a `horizontal-labels` FormLayout) and the visual control box with `controlXstyle`/`controlClassName`/`controlStyle`. Base props now reach the primary semantic control: the combobox input for Typeahead and Tokenizer, the `role="group"`/`role="radiogroup"` element for CheckboxList and RadioList, and the `role="slider"` thumb for Slider (the `role="group"` control in range mode). A caller `aria-describedby` is kept alongside the field's own description and status, on these components and on TextInput, TextArea, and NumberInput, which previously dropped it. CLI templates use the new props. (#7339)+ Migration: rename root `xstyle`/`className`/`style` to the part they styled before: `containerXstyle`/`containerClassName`/`containerStyle` on all five components, except a Typeahead inside InputGroup, whose root styling painted the control surface and moves to `controlXstyle`/`controlClassName`/`controlStyle`. The release's `astryx upgrade` codemod, `migrate-field-input-styling`, performs these renames on JSX usage.++ Not rewritten by the codemod, so update by hand:++ - `ref` and `id`, plus `data-*` (except Typeahead and Tokenizer `data-testid`, which marked the control surface), `aria-*`, and DOM event handlers such as `onClick`, previously landed on the outer Field (or were dropped by RadioList and Slider). They now land on the primary semantic control. Update code that measured, queried, or listened on the outer field, and wrap the component in your own element when you need an outer boundary.+ - Typeahead and Tokenizer refs are now `HTMLInputElement`.+ - A consumer `onKeyDown` on Typeahead or Tokenizer still runs after the built-in key handling, cannot cancel it, and still fires for keys on the clear button and tokens; for keys on the input it now runs on the combobox input itself.+ - RadioList and Slider used to drop DOM event handlers; they now run after the component's own handling, so a Slider `onPointerDown`, `onKeyDown`, `onFocus`, or `onBlur` that never fired before now fires (on the thumb, or on the group in range mode).+ - Tokenizer's `onFocus`/`onBlur` keep their meaning: focus entering or leaving the field.+ - Styling passed through a wrapper's own props or a spread is not rewritten and now fails type-checking at that callsite.++ Untyped callers get a development warning and the value is ignored.++ From #5656 by @harjothkhara.++- Selector, MultiSelector, and ComplexSelector no longer accept root `xstyle`, `className`, or `style`. Style the field with `containerXstyle`/`containerClassName`/`containerStyle` (the Field box; no effect inside InputGroup, a `horizontal-labels` FormLayout, or with `renderTrigger`) and the visual control box with `controlXstyle`/`controlClassName`/`controlStyle`. Base props such as `ref`, `id`, `data-*` (including `data-testid`), `aria-*`, and DOM handlers reach the trigger button that carries the combobox role (or, with `renderTrigger`, the caller's control), and a caller `aria-describedby` is kept alongside the field's own description and status instead of being replaced. Handlers keep their existing order: a ComplexSelector `onClick` on its own trigger can still cancel opening, and newly forwarded handlers (including those reaching a `renderTrigger` control) run after the built-in toggle and keyboard handling. CLI templates use the new props. (#7341)+ Migration: rename root `xstyle`/`className`/`style` on these components to `controlXstyle`/`controlClassName`/`controlStyle`, which style the same element as before. Not a rename: a `data-testid` or other base prop now lands on the trigger button rather than the bordered box around it (query the box with `.closest()` if a test measured it), and with `renderTrigger` base props and `ref` now reach the caller's control. Rename JSX usage by hand, or run `astryx upgrade`; it runs `migrate-field-input-styling`, which does not follow styling passed through a wrapper's own props or a spread, which now fails type-checking at that callsite, so rename it there. Untyped callers get a development warning and the value is ignored.++ From #5656 by @harjothkhara.++- TextInput, TextArea, NumberInput, and FileInput no longer accept root `xstyle`, `className`, or `style`. Style the field with `containerXstyle`/`containerClassName`/`containerStyle` (the Field box; no effect inside InputGroup or a `horizontal-labels` FormLayout) and the visual control box with `controlXstyle`/`controlClassName`/`controlStyle`. Base props such as `ref`, `id`, `data-*`, `aria-*`, and DOM handlers reach the native control, and a caller `id` is now honored there. CLI templates use the new props. (#7336)+ Migration: rename root `xstyle`/`className`/`style` on these components to `controlXstyle`/`controlClassName`/`controlStyle`, which style the same element as before. `astryx upgrade` rewrites JSX usage; styling passed through a wrapper's own props or a spread is not rewritten and now fails type-checking at that callsite, so rename it there. Untyped callers get a development warning and the value is ignored. Not rewritten by the codemod: a caller `id` used to be replaced by a generated one and now reaches the native control (the label stays associated), so remove an `id` you passed but relied on being ignored. Other base props already reached the native control and are unchanged.++ From #5656 by @harjothkhara.++- `PowerSearchFilterEditor` no longer calls `onSave` when it opens on an already-complete empty-operator filter (such as "is empty"). (#7347)+ Old usage: opening a standalone `PowerSearchFilterEditor` on a complete empty-operator filter saved that filter immediately, with no Apply rendered for it, and saved it again whenever the editor remounted.++ Replacement: the editor saves only from a user choice in it. Opening it saves nothing.++ Migration: if you relied on that save-on-open, call your own `onSave` handler with the filter at the point where you open the editor (or skip opening the editor for empty-operator filters, as PowerSearch now does). This cannot be rewritten by a codemod, because the right place to commit depends on your code.++- Remove the deprecated component-theming compatibility surface scheduled for 0.7.0. Components now emit only canonical target classes and reflected `data-*` prop/state selectors. Theme discovery and build output no longer expose deprecated targets, and `ThemePropsOptions` plus `ComponentThemingTarget.deprecatedFor` are removed. The `theme targets --json` response drops the `ThemeTargetEntry.deprecatedFor` field, because no target it lists is deprecated. (#7302)+ Migration: run the required codemod `migrate-deprecated-theme-surface` with `astryx upgrade --from <your 0.6 version> --apply --path .` after upgrading.++ The codemod renames removed target keys inside theme `components` maps (an imported `defineTheme()` call, an object typed as an Astryx theme, or a theme object with a static `name`), renames target classes in CSS, and replaces target-qualified bare prop/value/state classes with reflected `data-*` selectors, using every bare class the final 0.6 release emitted. It leaves dynamic/computed theme keys, unqualified or unknown classes, and CSS embedded in JavaScript/TypeScript strings for manual review. It adds `TODO(astryx upgrade)` when old and canonical keys coexist, and when a bare class Astryx once emitted has no known meaning on the target it qualifies.++ The four per-component clear-icon aliases all become the shared `input-clear-icon`, which styles every input's clear icon. In CSS the codemod keeps each rule on its component with `:where(.astryx-<component> *)`, which adds no specificity. Theme keys cannot carry that scope, so the codemod adds a TODO naming the CSS selector to use.++ Code that passed `{legacyNames}` to `themeProps()` or set `deprecatedFor` in a component doc should delete that argument or field; the canonical target is unchanged.++ Rename theme keys and CSS target classes with this complete mapping:++ - `base-table` → `table`+ - `checkbox` → `checkbox-indicator`+ - `codeblock` → `code-block`+ - `codeblock-copy-button` → `code-block-copy-button`+ - `codeblock-header` → `code-block-header`+ - `codeblock-title` → `code-block-title`+ - `date-input-clear-icon` → `input-clear-icon`+ - `date-range-input-clear-icon` → `input-clear-icon`+ - `hovercard` → `hover-card`+ - `multi-selector-clear-icon` → `input-clear-icon`+ - `navicon` → `nav-icon`+ - `popover-surface` → `popover`+ - `progressbar` → `progress-bar`+ - `progressbar-fill` → `progress-bar-fill`+ - `progressbar-mark` → `progress-bar-mark`+ - `progressbar-track` → `progress-bar-track`+ - `radio` → `radio-indicator`+ - `radio-dot` → `radio-indicator-dot`+ - `selector-clear-icon` → `input-clear-icon`+ - `statusdot` → `status-dot`+ - `textarea` → `text-area`++ For custom CSS, replace removed bare selectors with the corresponding reflected attribute on a canonical target—for example, `.astryx-button.primary.sm` becomes `.astryx-button[data-variant="primary"][data-size="sm"]`, and `.astryx-switch.checked` becomes `.astryx-switch[data-checked="checked"]`. Review unqualified classes such as `.primary` manually because they may be application-owned.++- Remove the deprecated `emptySearchResultsText` prop. Use `emptySearchText`. (#7289)+ Old usage: `emptySearchResultsText` on `Tokenizer`, `Typeahead`, and `BaseTypeahead`, and the `emptySearchResultsText` key on a `ChatComposerInput` trigger.++ Replacement: `emptySearchText`, shipped in 0.6.6. It takes a `ReactNode`, so every old string value stays valid. The old name is no longer in the types and is no longer read; a JavaScript caller that still passes it sees the default empty message.++ Migration: Rename `emptySearchResultsText` to `emptySearchText`. Where both are set, keep `emptySearchText` and delete the old one — unless `emptySearchText` could be `null` or `undefined`: 0.6.x then fell back to the old value, so move that value into `emptySearchText` (for example `emptySearchText={value ?? 'Old copy'}`).++ Codemod: `astryx upgrade` runs `rename-empty-search-results-text`, a straight rename at the JSX boundary: the prop on imported `Tokenizer`, `Typeahead`, and `BaseTypeahead` elements, and the key on trigger objects written inline in `ChatComposerInput`'s `triggers`, each renamed as written. Like every Astryx codemod it does not follow variables, helpers, spreads, wrappers, or types; where it cannot attribute the value — `emptySearchText` already set, any spread onto one of these elements (whether or not the element writes the old name), a `triggers` value not written inline, a trigger object with a spread or computed key (whether or not it writes the old name) — it leaves a TODO instead of choosing a winner. The type checker reports any literal `emptySearchResultsText` it did not reach; the TODOs cover the values that reach an element through a spread, which it cannot.++- `reset.css` now reaches `::before`, `::after`, `::placeholder` and the search field's cancel button, as its comments document. Three of its rules wrote the pseudo-element inside `:where()`, where pseudo-elements are invalid, so browsers dropped those parts of the selector and the rules never applied to them. Each pseudo-element now follows the `:where()`, as in `:where(*)::before`, and the rules stay in `@layer reset`, so any later layer or unlayered style still overrides them. (#7355)+ What changes on a page that loads the reset: a `::before` or `::after` with padding or a border used to size as `content-box` and now sizes as `border-box`; setting only `border-width` on one used to draw nothing and now draws a solid `currentColor` border; a placeholder with no color of its own used to show the browser's grey and now shows `--color-text-secondary` (or that token's own default, `light-dark(#4E606F, #AAAFB5)`, when no Astryx CSS defines it); and a `type="search"` field no longer shows the browser's cancel button.++ To keep the old result for one of your own elements, set it in your own CSS: `box-sizing: content-box` or `border-style: none` on the pseudo-element, a `color` on the `::placeholder`, or `appearance: auto` on the field's `::-webkit-search-cancel-button`. There is no codemod: whether a stylesheet relied on the old result cannot be read from its source.++- Spacing tokens are rem (`--spacing-2: 0.5rem`), so gaps and padding follow the reader's root font size the way the type scale does. Every token value is unchanged at the default 16px root. (#7359)+ One change shows at the default root: the `useTableRowExpansion` chevron now sits centered in its fixed 40px column instead of running past its edge (its button moves from 24–48px to 8–32px of the column). Under a theme with a larger spacing scale, such as matcha, the chevron is visible again and the detail panel lines up with the first column instead of starting 20px past it.++ Old usage: The `--spacing-*` defaults were fixed px (`--spacing-2: 8px`), so `useTheme().token()`, `resolveThemeToken()`, `tokenDefaults` and `spacingDefaults` returned px strings, and spacing stayed the same size when a reader raised the browser font size.++ Replacement: The defaults are rem with the same value at a 16px root (`--spacing-2: 0.5rem`, `--spacing-4: 1rem`), and those readers return the rem string.++ Migration: CSS that reads `var(--spacing-*)` needs no change. Code that parses a spacing token as a px number converts the rem value with the root font size, or reads the element's computed length. A theme that wants fixed px spacing sets the tokens back, for example `defineTheme({tokens: {'--spacing-2': '8px'}})`.++ Codemod: None. A token read and parsed at runtime cannot be found and rewritten statically, and CSS uses need no rewrite.++#### New Features++- `DropdownMenu` takes `header` and `footer`: content above and below the rows that sits in the popover beside the menu, never inside it. This is the place for a filter field or a "Create" button. The menu still holds only its rows, so it stays a valid menu to a screen reader. The controls keep their own keys and presses, and Tab walks header, menu, footer. The bottom sheet shows them above and below the actions. (#7344)+- `DropdownMenuSubMenu` passes host attributes, DOM event handlers and a `ref` to its trigger row, as `DropdownMenuItem` does: a sub-menu row can carry `aria-keyshortcuts`, a `data-*` mark or an `id`, and a caller can reach the row element. The row keeps its own role, tab stop and popup state; a caller's `onClick`, `onKeyDown`, `onPointerMove`, `onMouseEnter` and `onMouseLeave` run after the row's own handling, except for an event the row consumes: the keys that open the flyout (the open arrow, Enter and Space) and a click on a disabled row. A caller's `id` names the row the flyout is labelled by. (#7318)++#### Fixes++- A standalone `BottomSheet` now joins the shared layer dismissal stack, so one Escape press closes only the top-most layer. A Popover, Dialog, or menu opened inside the sheet closes first, and the next press closes the sheet. `purpose="required"` still blocks Escape without letting the press close a layer behind it, a sheet that is animating out keeps the press, and the native close request answers with the same top-most and IME composition rules. (#7225)+- `ContextMenu` puts only its four touch handlers on the trigger element. It used to spread everything `useLongPress` returns, which since the press model includes the hook's imperative `start`, `moveTo` and `cancel`, so React warned "does not recognize the `moveTo` prop" and "Invalid values for props `start`, `cancel`" on the first ContextMenu of a page. Long-press opening is unchanged. (#7322)+- DateInput: run changeAction with optimistic busy feedback on the native picker surface (#7243)+- Dialog's initial focus and the focus it returns on close now follow the last input: the shared focus indicator is hidden after a mouse click or tap and shown after keyboard input, including focus returned after a keyboard open and a mouse close (#7306). Text fields keep their own focus treatment. (#7313)+- A DropdownMenu hung off its own control through `renderTrigger` names a drilled-in sub-menu's Back row after the menu: "Back to <the menu's aria-label>", or the name of the control it hangs off, instead of "Back to Menu". (#7304)+- Lightbox shows the next or previous image unzoomed from its first frame. The zoom and pan reset when the image changes now happens in the same update, instead of painting the new image at the previous image's zoom for one frame. (#7351)+- With `markdownSourceLinesPlugin` installed, a transform plugin no longer falls back to its readable fallback on documents that contain a list or a quote. Blocks nested in a list item or a quote carry lines without offsets, and the transform check now accepts those Core-assigned lines while still refusing a transform that adds, shifts, or forges them. (#7345)+- A two-finger pinch over an open DropdownMenu, sub-menu flyout, ContextMenu or Selector list now zooms the page. The menus declared `touch-action: none` while their rows fit and `pan-y` once they scroll, and neither allows a pinch, so a phone could not zoom the page while a menu was open. They now declare `pinch-zoom` and `pan-y pinch-zoom`; a one-finger slide over the rows and the press model behave as before. (#7201)+- DropdownMenu, ContextMenu and sub-menus no longer special-case text fields and buttons placed among their rows. This reverts an unreleased change. A menu holds only menu items; a control that is not a row belongs outside the menu. (#7338)+- The PowerSearch filter editor saves an "empty" operator filter (such as "is empty") exactly once, from the choice that completes it. Choosing such an operator, or switching to a field whose default operator is one, now saves from that choice instead of from an effect. The filter is no longer saved again when the parent re-renders with a new `onSave`, or twice in React StrictMode. Re-choosing the current operator or field saves nothing, and focus still returns to the search input after the editor closes. Clicking an existing empty-operator token in PowerSearch commits it once without opening the built-in editor; a `components.empty.Editor` override still opens. (#7347)+- The PowerSearch filter editor saves once when a value that saves on choice is picked (an enum option, a relative-date preset, a suggestion). The save no longer runs inside a React state updater, which React may call more than once, so it no longer fires twice in StrictMode. (#7350)+- Toasts stay visible and clickable while a Dialog is open. The `ToastViewport` from `LayerProvider` (or the one `useToast` mounts on its own) now moves into the open Dialog, and back when it closes. Before, a Dialog opened after the viewport mounted painted over it, and clicking a toast's close button hit the backdrop and closed the Dialog. Moving the viewport does not reset visible toasts or their timers. A viewport rendered with `isTopLayer={false}` keeps rendering in place. (#7238)+- DateTimeInput's touch picker no longer paints a stale frame. Clearing the value from outside clears the time display in the same update, instead of showing the previous time for one frame, and narrowing `max` (or raising `min`) while the sheet is open keeps the visible month in range in the same update, instead of showing the out-of-range month and then jumping. (#7349)++#### Performance++- An `Item` without `swipeActions` no longer bundles the swipe gesture. The panels and the drag that uncovers them now live in a module `Item` loads on demand the first time a row has swipe actions, so an app whose rows never swipe ships about 2.7 KB (gzip) less on its first load and a row that does swipe keeps its DOM, props and behavior; its gesture becomes live once that module has arrived, which on a first load is a moment after the row paints. (#7296)++#### Documentation++- Describe `CommandPaletteList` as the list `CommandPalette` renders itself, and as a component to render directly only for a standalone results list. (#7370)++#### Contributors++Thanks to everyone who contributed to this release:++- @cixzhang+- @Geervan+- @harjothkhara+- @imdreamrunner+- @ksying+- @rubyycheung+- @vjeux++---+# 0.6.8#### New Featuresdiff --git a/packages/themes/butter/CHANGELOG.md b/packages/themes/butter/CHANGELOG.mdindex d7a8934a66..e9c23411f8 100644--- a/packages/themes/butter/CHANGELOG.md+++ b/packages/themes/butter/CHANGELOG.md@@ -1,5 +1,22 @@# @xds/theme-butter+# 0.7.0++#### Breaking Changes++- On touch devices narrower than the `lg` breakpoint (`(width < 1024px) and (pointer: coarse)`), the 14px-base first-party themes now floor their type base to 16px and re-derive the ratio so Display 1 keeps its desktop size: neutral and chocolate (base 14, ratio 1.2 → 1.1736) and butter and stone (base 14, ratio 1.25 → 1.2225). On phones, body, label and code text rise from 14px to 16px; supporting text, the headings and Display 2 and 3 grow by 1–2px; only Display 1 holds its desktop size. Desktop sizes are unchanged. gothic, matcha and y2k already use a 16px base and need no rule. The CLI's theme templates carry the same rule, so a newly scaffolded theme gets it too. (#6699)+ An app theme that extends one of these four themes and sets its own `typography.scale` or type-size tokens inherits this rule, and on touch + narrow screens the rule replaces those values (a base-18 child drops to a 16px body and a 42px Display 1). Append your own rule for the same condition with the values you want; a later rule for the same condition wins.++ Migration: nothing to change to take the new phone scale. To keep the previous 14px phone scale in an app, extend the theme and append a later rule for the same condition: `defineTheme({name: 'app', extends: neutralTheme, adaptations: {rules: [{when: {pointer: 'coarse', width: {below: 'lg'}}, value: {typography: {scale: {base: 14, ratio: 1.2}}}}]}})`. For butter and stone use `ratio: 1.25` and also set `tokens: {'--text-supporting-size': '12px'}` in that rule's value, because those themes pin supporting text at 12px rather than the 11px the scale alone gives. This cannot be rewritten by a codemod: whether an app wants the floor is a product choice.++#### Contributors++Thanks to everyone who contributed to this release:++- @imdreamrunner++---+# 0.6.8---diff --git a/packages/themes/chocolate/CHANGELOG.md b/packages/themes/chocolate/CHANGELOG.mdindex 7ebf78b765..d85f1b52b5 100644--- a/packages/themes/chocolate/CHANGELOG.md+++ b/packages/themes/chocolate/CHANGELOG.md@@ -1,5 +1,22 @@# @xds/theme-chocolate+# 0.7.0++#### Breaking Changes++- On touch devices narrower than the `lg` breakpoint (`(width < 1024px) and (pointer: coarse)`), the 14px-base first-party themes now floor their type base to 16px and re-derive the ratio so Display 1 keeps its desktop size: neutral and chocolate (base 14, ratio 1.2 → 1.1736) and butter and stone (base 14, ratio 1.25 → 1.2225). On phones, body, label and code text rise from 14px to 16px; supporting text, the headings and Display 2 and 3 grow by 1–2px; only Display 1 holds its desktop size. Desktop sizes are unchanged. gothic, matcha and y2k already use a 16px base and need no rule. The CLI's theme templates carry the same rule, so a newly scaffolded theme gets it too. (#6699)+ An app theme that extends one of these four themes and sets its own `typography.scale` or type-size tokens inherits this rule, and on touch + narrow screens the rule replaces those values (a base-18 child drops to a 16px body and a 42px Display 1). Append your own rule for the same condition with the values you want; a later rule for the same condition wins.++ Migration: nothing to change to take the new phone scale. To keep the previous 14px phone scale in an app, extend the theme and append a later rule for the same condition: `defineTheme({name: 'app', extends: neutralTheme, adaptations: {rules: [{when: {pointer: 'coarse', width: {below: 'lg'}}, value: {typography: {scale: {base: 14, ratio: 1.2}}}}]}})`. For butter and stone use `ratio: 1.25` and also set `tokens: {'--text-supporting-size': '12px'}` in that rule's value, because those themes pin supporting text at 12px rather than the 11px the scale alone gives. This cannot be rewritten by a codemod: whether an app wants the floor is a product choice.++#### Contributors++Thanks to everyone who contributed to this release:++- @imdreamrunner++---+# 0.6.8---diff --git a/packages/themes/gothic/CHANGELOG.md b/packages/themes/gothic/CHANGELOG.mdindex 3137811efe..11cb39da19 100644--- a/packages/themes/gothic/CHANGELOG.md+++ b/packages/themes/gothic/CHANGELOG.md@@ -1,5 +1,9 @@# @xds/theme-gothic+# 0.7.0++---+# 0.6.8---diff --git a/packages/themes/matcha/CHANGELOG.md b/packages/themes/matcha/CHANGELOG.mdindex 23b33459d0..6c273589d1 100644--- a/packages/themes/matcha/CHANGELOG.md+++ b/packages/themes/matcha/CHANGELOG.md@@ -1,5 +1,20 @@# @xds/theme-matcha+# 0.7.0++#### Breaking Changes++- matcha's and y2k's spacing steps are rem (`--spacing-2: 0.75rem`), so their gaps and padding follow the reader's root font size like the core scale. Every step is the same pixel value at the default 16px root; a reader with a larger root font size now sees proportionally larger spacing on these themes. The CLI's copies of both theme templates and the annotated theme template's spacing example change the same way. (#7374)+ Migration: nothing to change to take the new behaviour. To keep fixed pixel spacing on one of these themes, extend it and override the steps in px, which is honoured as written: `defineTheme({name: 'app', extends: matchaTheme, tokens: {'--spacing-2': '12px'}})`.++#### Contributors++Thanks to everyone who contributed to this release:++- @cixzhang++---+# 0.6.8---diff --git a/packages/themes/neutral/CHANGELOG.md b/packages/themes/neutral/CHANGELOG.mdindex 325e814498..46dee4224f 100644--- a/packages/themes/neutral/CHANGELOG.md+++ b/packages/themes/neutral/CHANGELOG.md@@ -1,5 +1,27 @@# @xds/theme-neutral+# 0.7.0++#### Breaking Changes++- On touch devices narrower than the `lg` breakpoint (`(width < 1024px) and (pointer: coarse)`), the 14px-base first-party themes now floor their type base to 16px and re-derive the ratio so Display 1 keeps its desktop size: neutral and chocolate (base 14, ratio 1.2 → 1.1736) and butter and stone (base 14, ratio 1.25 → 1.2225). On phones, body, label and code text rise from 14px to 16px; supporting text, the headings and Display 2 and 3 grow by 1–2px; only Display 1 holds its desktop size. Desktop sizes are unchanged. gothic, matcha and y2k already use a 16px base and need no rule. The CLI's theme templates carry the same rule, so a newly scaffolded theme gets it too. (#6699)+ An app theme that extends one of these four themes and sets its own `typography.scale` or type-size tokens inherits this rule, and on touch + narrow screens the rule replaces those values (a base-18 child drops to a 16px body and a 42px Display 1). Append your own rule for the same condition with the values you want; a later rule for the same condition wins.++ Migration: nothing to change to take the new phone scale. To keep the previous 14px phone scale in an app, extend the theme and append a later rule for the same condition: `defineTheme({name: 'app', extends: neutralTheme, adaptations: {rules: [{when: {pointer: 'coarse', width: {below: 'lg'}}, value: {typography: {scale: {base: 14, ratio: 1.2}}}}]}})`. For butter and stone use `ratio: 1.25` and also set `tokens: {'--text-supporting-size': '12px'}` in that rule's value, because those themes pin supporting text at 12px rather than the 11px the scale alone gives. This cannot be rewritten by a codemod: whether an app wants the floor is a product choice.++#### Fixes++- Generate Neutral's runtime palette references from the stops its theme uses, and fail verification when the package or CLI template copy drifts. (#7255)++#### Contributors++Thanks to everyone who contributed to this release:++- @imdreamrunner+- @rubyycheung++---+# 0.6.8---diff --git a/packages/themes/stone/CHANGELOG.md b/packages/themes/stone/CHANGELOG.mdindex 033335de64..5d2a142ff4 100644--- a/packages/themes/stone/CHANGELOG.md+++ b/packages/themes/stone/CHANGELOG.md@@ -1,5 +1,22 @@# @xds/theme-stone+# 0.7.0++#### Breaking Changes++- On touch devices narrower than the `lg` breakpoint (`(width < 1024px) and (pointer: coarse)`), the 14px-base first-party themes now floor their type base to 16px and re-derive the ratio so Display 1 keeps its desktop size: neutral and chocolate (base 14, ratio 1.2 → 1.1736) and butter and stone (base 14, ratio 1.25 → 1.2225). On phones, body, label and code text rise from 14px to 16px; supporting text, the headings and Display 2 and 3 grow by 1–2px; only Display 1 holds its desktop size. Desktop sizes are unchanged. gothic, matcha and y2k already use a 16px base and need no rule. The CLI's theme templates carry the same rule, so a newly scaffolded theme gets it too. (#6699)+ An app theme that extends one of these four themes and sets its own `typography.scale` or type-size tokens inherits this rule, and on touch + narrow screens the rule replaces those values (a base-18 child drops to a 16px body and a 42px Display 1). Append your own rule for the same condition with the values you want; a later rule for the same condition wins.++ Migration: nothing to change to take the new phone scale. To keep the previous 14px phone scale in an app, extend the theme and append a later rule for the same condition: `defineTheme({name: 'app', extends: neutralTheme, adaptations: {rules: [{when: {pointer: 'coarse', width: {below: 'lg'}}, value: {typography: {scale: {base: 14, ratio: 1.2}}}}]}})`. For butter and stone use `ratio: 1.25` and also set `tokens: {'--text-supporting-size': '12px'}` in that rule's value, because those themes pin supporting text at 12px rather than the 11px the scale alone gives. This cannot be rewritten by a codemod: whether an app wants the floor is a product choice.++#### Contributors++Thanks to everyone who contributed to this release:++- @imdreamrunner++---+# 0.6.8---diff --git a/packages/themes/y2k/CHANGELOG.md b/packages/themes/y2k/CHANGELOG.mdindex fa30be032e..ab5a484eb7 100644--- a/packages/themes/y2k/CHANGELOG.md+++ b/packages/themes/y2k/CHANGELOG.md@@ -1,5 +1,20 @@# @xds/theme-y2k+# 0.7.0++#### Breaking Changes++- matcha's and y2k's spacing steps are rem (`--spacing-2: 0.75rem`), so their gaps and padding follow the reader's root font size like the core scale. Every step is the same pixel value at the default 16px root; a reader with a larger root font size now sees proportionally larger spacing on these themes. The CLI's copies of both theme templates and the annotated theme template's spacing example change the same way. (#7374)+ Migration: nothing to change to take the new behaviour. To keep fixed pixel spacing on one of these themes, extend it and override the steps in px, which is honoured as written: `defineTheme({name: 'app', extends: matchaTheme, tokens: {'--spacing-2': '12px'}})`.++#### Contributors++Thanks to everyone who contributed to this release:++- @cixzhang++---+# 0.6.8---