@astryxdesign/core 0.7.0-canary.fe57f54 → 0.7.0

package/dist/theme/tokens.stylex.d.ts

@@ -177,38 +177,38 @@ export declare const colorVars: stylex.VarGroup<Readonly<{
     readonly '--color-text-yellow': "light-dark(#753F07, #FBCE03)";
 }>, symbol>;
 export declare const spacingDefaults: {
-    readonly '--spacing-0': "0px";
-    readonly '--spacing-0-5': "2px";
-    readonly '--spacing-1': "4px";
-    readonly '--spacing-1-5': "6px";
-    readonly '--spacing-2': "8px";
-    readonly '--spacing-3': "12px";
-    readonly '--spacing-4': "16px";
-    readonly '--spacing-5': "20px";
-    readonly '--spacing-6': "24px";
-    readonly '--spacing-7': "28px";
-    readonly '--spacing-8': "32px";
-    readonly '--spacing-9': "36px";
-    readonly '--spacing-10': "40px";
-    readonly '--spacing-11': "44px";
-    readonly '--spacing-12': "48px";
+    readonly '--spacing-0': "0rem";
+    readonly '--spacing-0-5': "0.125rem";
+    readonly '--spacing-1': "0.25rem";
+    readonly '--spacing-1-5': "0.375rem";
+    readonly '--spacing-2': "0.5rem";
+    readonly '--spacing-3': "0.75rem";
+    readonly '--spacing-4': "1rem";
+    readonly '--spacing-5': "1.25rem";
+    readonly '--spacing-6': "1.5rem";
+    readonly '--spacing-7': "1.75rem";
+    readonly '--spacing-8': "2rem";
+    readonly '--spacing-9': "2.25rem";
+    readonly '--spacing-10': "2.5rem";
+    readonly '--spacing-11': "2.75rem";
+    readonly '--spacing-12': "3rem";
 };
 export declare const spacingVars: stylex.VarGroup<Readonly<{
-    readonly '--spacing-0': "0px";
-    readonly '--spacing-0-5': "2px";
-    readonly '--spacing-1': "4px";
-    readonly '--spacing-1-5': "6px";
-    readonly '--spacing-2': "8px";
-    readonly '--spacing-3': "12px";
-    readonly '--spacing-4': "16px";
-    readonly '--spacing-5': "20px";
-    readonly '--spacing-6': "24px";
-    readonly '--spacing-7': "28px";
-    readonly '--spacing-8': "32px";
-    readonly '--spacing-9': "36px";
-    readonly '--spacing-10': "40px";
-    readonly '--spacing-11': "44px";
-    readonly '--spacing-12': "48px";
+    readonly '--spacing-0': "0rem";
+    readonly '--spacing-0-5': "0.125rem";
+    readonly '--spacing-1': "0.25rem";
+    readonly '--spacing-1-5': "0.375rem";
+    readonly '--spacing-2': "0.5rem";
+    readonly '--spacing-3': "0.75rem";
+    readonly '--spacing-4': "1rem";
+    readonly '--spacing-5': "1.25rem";
+    readonly '--spacing-6': "1.5rem";
+    readonly '--spacing-7': "1.75rem";
+    readonly '--spacing-8': "2rem";
+    readonly '--spacing-9': "2.25rem";
+    readonly '--spacing-10': "2.5rem";
+    readonly '--spacing-11': "2.75rem";
+    readonly '--spacing-12': "3rem";
 }>, symbol>;
 export declare const sizeDefaults: {
     readonly '--size-element-sm': "28px";

package/dist/theme/tokens.stylex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.stylex.d.ts","sourceRoot":"","sources":["../../src/theme/tokens.stylex.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAM3C,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyHhB,CAAC;AAEX,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAAmC,CAAC;AAM1D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;CAgBlB,CAAC;AAEX,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;WAAqC,CAAC;AAM9D,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AAEX,eAAO,MAAM,QAAQ;;;;WAAkC,CAAC;AAMxD,eAAO,MAAM,cAAc;;CAEjB,CAAC;AAEX,eAAO,MAAM,UAAU;;WAAoC,CAAC;AAE5D,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,cAAc,CAAC;AAWxD,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AAEX,eAAO,MAAM,SAAS;;;;;WAAmC,CAAC;AAM1D,eAAO,MAAM,cAAc;;;;;;;;CAWjB,CAAC;AAEX,eAAO,MAAM,UAAU;;;;;;;;WAAoC,CAAC;AAQ5D,eAAO,MAAM,cAAc;;;;;;;;;CAejB,CAAC;AAEX,eAAO,MAAM,UAAU;;;;;;;;;WAAoC,CAAC;AAU5D,eAAO,MAAM,gBAAgB;;;;;;;;;;CAUnB,CAAC;AAEX,eAAO,MAAM,YAAY;;;;;;;;;;WAAsC,CAAC;AAEhE,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAM5D,eAAO,MAAM,YAAY;;CAEf,CAAC;AAEX,eAAO,MAAM,QAAQ;;WAAkC,CAAC;AAExD,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,YAAY,CAAC;AAKpD,eAAO,MAAM,kBAAkB;;;;CAMrB,CAAC;AAEX,eAAO,MAAM,cAAc;;;;WAAwC,CAAC;AAMpE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;CAcnB,CAAC;AAEX,eAAO,MAAM,YAAY;;;;;;;;;;;;;WAAsC,CAAC;AAMhE,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC;AAEX,eAAO,MAAM,cAAc;;;;;WAAwC,CAAC;AAMpE,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,aAAa,CAAC;AACtD,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,eAAe,CAAC;AAC1D,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,YAAY,CAAC;AACpD,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,cAAc,CAAC;AACxD,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,cAAc,CAAC;AACxD,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAChE,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAC5D,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAehE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0DpB,CAAC;AAEX,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAAuC,CAAC;AAElE,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,iBAAiB,CAAC"}
+{"version":3,"file":"tokens.stylex.d.ts","sourceRoot":"","sources":["../../src/theme/tokens.stylex.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAM3C,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyHhB,CAAC;AAEX,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAAmC,CAAC;AAS1D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;CAgBlB,CAAC;AAEX,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;WAAqC,CAAC;AAM9D,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AAEX,eAAO,MAAM,QAAQ;;;;WAAkC,CAAC;AAMxD,eAAO,MAAM,cAAc;;CAEjB,CAAC;AAEX,eAAO,MAAM,UAAU;;WAAoC,CAAC;AAE5D,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,cAAc,CAAC;AAWxD,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AAEX,eAAO,MAAM,SAAS;;;;;WAAmC,CAAC;AAM1D,eAAO,MAAM,cAAc;;;;;;;;CAWjB,CAAC;AAEX,eAAO,MAAM,UAAU;;;;;;;;WAAoC,CAAC;AAQ5D,eAAO,MAAM,cAAc;;;;;;;;;CAejB,CAAC;AAEX,eAAO,MAAM,UAAU;;;;;;;;;WAAoC,CAAC;AAU5D,eAAO,MAAM,gBAAgB;;;;;;;;;;CAUnB,CAAC;AAEX,eAAO,MAAM,YAAY;;;;;;;;;;WAAsC,CAAC;AAEhE,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAM5D,eAAO,MAAM,YAAY;;CAEf,CAAC;AAEX,eAAO,MAAM,QAAQ;;WAAkC,CAAC;AAExD,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,YAAY,CAAC;AAKpD,eAAO,MAAM,kBAAkB;;;;CAMrB,CAAC;AAEX,eAAO,MAAM,cAAc;;;;WAAwC,CAAC;AAMpE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;CAcnB,CAAC;AAEX,eAAO,MAAM,YAAY;;;;;;;;;;;;;WAAsC,CAAC;AAMhE,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC;AAEX,eAAO,MAAM,cAAc;;;;;WAAwC,CAAC;AAMpE,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,aAAa,CAAC;AACtD,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,eAAe,CAAC;AAC1D,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,YAAY,CAAC;AACpD,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,cAAc,CAAC;AACxD,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,cAAc,CAAC;AACxD,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAChE,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAC5D,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAehE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0DpB,CAAC;AAEX,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAAuC,CAAC;AAElE,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,iBAAiB,CAAC"}

package/dist/theme/tokens.stylex.js

@@ -223,22 +223,25 @@ export const colorVars = {
 // Spacing Tokens
 // =============================================================================
 
+// rem, like the type scale, so gaps and padding grow with the reader's root
+// font size instead of tightening around larger text. At the default 16px
+// root every step is still 4px × step: --spacing-2 is 8px, --spacing-4 16px.
 export const spacingDefaults = {
-  '--spacing-0': '0px',
-  '--spacing-0-5': '2px',
-  '--spacing-1': '4px',
-  '--spacing-1-5': '6px',
-  '--spacing-2': '8px',
-  '--spacing-3': '12px',
-  '--spacing-4': '16px',
-  '--spacing-5': '20px',
-  '--spacing-6': '24px',
-  '--spacing-7': '28px',
-  '--spacing-8': '32px',
-  '--spacing-9': '36px',
-  '--spacing-10': '40px',
-  '--spacing-11': '44px',
-  '--spacing-12': '48px'
+  '--spacing-0': '0rem',
+  '--spacing-0-5': '0.125rem',
+  '--spacing-1': '0.25rem',
+  '--spacing-1-5': '0.375rem',
+  '--spacing-2': '0.5rem',
+  '--spacing-3': '0.75rem',
+  '--spacing-4': '1rem',
+  '--spacing-5': '1.25rem',
+  '--spacing-6': '1.5rem',
+  '--spacing-7': '1.75rem',
+  '--spacing-8': '2rem',
+  '--spacing-9': '2.25rem',
+  '--spacing-10': '2.5rem',
+  '--spacing-11': '2.75rem',
+  '--spacing-12': '3rem'
 };
 export const spacingVars = {
   "--spacing-0": "var(--spacing-0)",

package/dist/theme/useTheme.d.ts

@@ -35,7 +35,7 @@ export interface UseThemeReturn {
      * @example
      * ```
      * const accent = token('--color-accent'); // "#0064E0" in light mode
-     * const spacing = token('--spacing-4');   // "16px"
+     * const spacing = token('--spacing-4');   // "1rem"
      * ```
      */
     token: (name: string) => string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astryxdesign/core",
-  "version": "0.7.0-canary.fe57f54",
+  "version": "0.7.0",
   "displayName": "Astryx Core",
   "description": "The component library. Accessible, themeable React components with built-in spacing, dark mode, and StyleX styling.",
   "author": "Meta Open Source",
@@ -787,8 +787,6 @@
     "react-dom": ">=19.0.0"
   },
   "devDependencies": {
-    "@astryxdesign/a11y-spec": "0.7.0-canary.fe57f54",
-    "@astryxdesign/cli": "0.7.0-canary.fe57f54",
     "@babel/cli": "^7.29.7",
     "@babel/core": "^7.29.7",
     "@babel/preset-react": "^7.29.7",
@@ -799,7 +797,9 @@
     "@testing-library/jest-dom": "^6.6.0",
     "@testing-library/react": "^16.3.2",
     "@types/babel__core": "^7.20.5",
-    "tailwindcss": "^4.3.2"
+    "tailwindcss": "^4.3.2",
+    "@astryxdesign/a11y-spec": "0.0.0",
+    "@astryxdesign/cli": "0.7.0"
   },
   "dependencies": {
     "intl-messageformat": "^11.2.9"

package/src/BottomSheet/BottomSheet.doc.mjs

@@ -19,7 +19,7 @@ const anatomy = [
     name: 'Content area',
     required: true,
     description:
-      'Scrollable container that presents the caller-provided sheet content, padded when padding or a theme sets it.',
+      'Padded, scrollable container that presents the caller-provided sheet content.',
   },
   {
     name: 'Handle',
@@ -95,7 +95,7 @@ export const docs = {
     derived: [{property: 'padding', expand: 'container'}],
   },
   description:
-    "A mobile touch sheet that rises from the bottom edge, with animated entrance and exit, a grab handle, optional drag-to-resize snap points, and purpose-controlled dismissal. Like Dialog, it is a container: set padding (or a theme's bottom-sheet padding) and a lone Section child or bleed children such as Table and Divider align against that inset. By default the content area has no padding. A standalone sheet owns a native <dialog>; inside BottomSheetSwitcher it renders a panel in the switcher's shared dialog. In both modes, ref and shared DOM props target the visual panel <div>.",
+    "A mobile touch sheet that rises from the bottom edge, with animated entrance and exit, a grab handle, optional drag-to-resize snap points, and purpose-controlled dismissal. Like Dialog, it is a padded container: content starts at the theme's bottom-sheet padding (--spacing-4 by default), and a lone Section child or bleed children such as Table and Divider align against it. A standalone sheet owns a native <dialog>; inside BottomSheetSwitcher it renders a panel in the switcher's shared dialog. In both modes, ref and shared DOM props target the visual panel <div>.",
   props: [
     {
       name: 'isOpen',
@@ -146,7 +146,7 @@ export const docs = {
       name: 'padding',
       type: '0 | 0.5 | 1 | 1.5 | 2 | 3 | 4 | 5 | 6 | 8 | 10',
       description:
-        'Internal padding of the sheet content using the spacing scale, matching Dialog. When omitted, uses the theme default for bottom sheets: no padding unless the theme sets padding on bottom-sheet. A lone Section child escapes the padding, and bleed children such as Table and Divider compensate against it.',
+        'Internal padding of the sheet content using the spacing scale, matching Dialog. When omitted, uses the theme default for bottom sheets (--spacing-4 unless the theme sets padding on bottom-sheet). A lone Section child escapes the padding, and bleed children such as Table and Divider compensate against it. Use 0 for edge-to-edge content that supplies its own inset.',
     },
     {
       name: 'height',
@@ -320,7 +320,7 @@ export const docs = {
 /** @type {import('@astryxdesign/cli/authoring').ComponentTranslationDoc} */
 export const docsDense = {
   description:
-    'mobile touch sheet rising from the bottom edge (native <dialog>): grab handle, opt-in transform-based drag-to-resize snap points (snapPoints: viewport fraction, percent or px length), scrolling area resizes to the snapped visible height on release (a peek stop, a quarter of the sheet or less, keeps the full height and slides instead), Dialog-aligned dismissal purpose (info/form/required), purpose-gated swipe-to-dismiss, fully-expanded Tall visual-viewport mobile-keyboard handling, named height scale, Dialog-like container padding (padding prop or theme bottom-sheet padding; none by default), modal (default) or non-modal (hasScrim={false}) presentation',
+    'mobile touch sheet rising from the bottom edge (native <dialog>): grab handle, opt-in transform-based drag-to-resize snap points (snapPoints: viewport fraction, percent or px length), scrolling area resizes to the snapped visible height on release (a peek stop, a quarter of the sheet or less, keeps the full height and slides instead), Dialog-aligned dismissal purpose (info/form/required), purpose-gated swipe-to-dismiss, fully-expanded Tall visual-viewport mobile-keyboard handling, named height scale, Dialog-like container padding (padding prop, theme bottom-sheet padding, default --spacing-4), modal (default) or non-modal (hasScrim={false}) presentation',
   usage: {
     anatomy,
     description:

package/src/BottomSheet/BottomSheet.tsx

@@ -146,10 +146,11 @@ interface BottomSheetSharedProps extends BaseProps<HTMLDivElement> {
   /**
    * Internal padding of the sheet content using the spacing scale, matching
    * Dialog. Accepts numeric spacing steps: 0, 0.5, 1, 1.5, 2, 3, 4, 5, 6, 8, 10.
-   * When omitted, uses the theme default for bottom sheets: no padding unless
-   * the theme sets `padding` on `bottom-sheet`. The content box is a
-   * container: a Section that is its only child escapes the padding, and bleed
-   * children such as Table and Divider compensate against it.
+   * When omitted, uses the theme default for bottom sheets (`--spacing-4`
+   * unless the theme sets `padding` on `bottom-sheet`), matching Dialog. The
+   * content box is a container: a Section that is its only child escapes the
+   * padding, and bleed children such as Table and Divider compensate against
+   * it. Pass `0` for content that supplies its own inset.
    */
   padding?: SpacingStep;
 

package/src/BottomSheet/BottomSheetPanel.test.tsx

@@ -432,7 +432,7 @@ describe('BottomSheetPanel', () => {
       return getComputedStyle(screen.getByTestId('sheet-child').parentElement!);
     }
 
-    it('keeps the released unpadded default and publishes the theme chain', () => {
+    it("pads by Dialog's default chain and publishes the inset it applies", () => {
       const computed = renderWithPadding();
       for (const [edge, property] of EDGES) {
         const published = computed
@@ -441,10 +441,8 @@ describe('BottomSheetPanel', () => {
         expect(published, edge).toContain(
           `var(--astryx-bottom-sheet-padding-${edge}`,
         );
-        // No theme padding resolves to no inset, as before the sheet was a
-        // container.
         expect(published, edge).toContain(
-          'var(--astryx-bottom-sheet-padding,0px)',
+          'var(--astryx-bottom-sheet-padding,var(--spacing-4))',
         );
         // Applied padding reads the published value, so bleed children
         // subtract exactly the inset they sit in.
@@ -452,17 +450,16 @@ describe('BottomSheetPanel', () => {
           `var(--container-padding-${edge})`,
         );
       }
-      // The Layout insets have no terminal value: unthemed, they stay invalid
-      // and a Layout inside the sheet keeps its own default padding.
       for (const name of [
         '--layout-padding-outer-x',
         '--layout-padding-outer-y',
         '--layout-padding-inner-x',
         '--layout-padding-inner-y',
       ]) {
-        const value = computed.getPropertyValue(name).replace(/\s+/g, '');
-        expect(value, name).toContain('var(--astryx-bottom-sheet-padding)');
-        expect(value, name).not.toMatch(/0px|--spacing-/);
+        expect(
+          computed.getPropertyValue(name).replace(/\s+/g, ''),
+          name,
+        ).toContain('var(--astryx-bottom-sheet-padding,var(--spacing-4))');
       }
     });
 

package/src/BottomSheet/BottomSheetPanel.tsx

@@ -256,7 +256,6 @@ const styles = stylex.create({
     // observed box grow with async content beyond a fixed-height viewport.
     // This box is also the sheet's container: it carries the padding and
     // publishes it, so a lone Section child escapes it exactly as in Dialog.
-    // Unpadded unless the prop or the theme sets padding.
     display: 'flow-root',
     boxSizing: 'border-box',
     height: '100%',
@@ -303,7 +302,7 @@ interface BottomSheetPanelProps extends BaseProps<HTMLDivElement> {
   children: ReactNode;
   /**
    * Content padding on the spacing scale. Omitted, the content box reads the
-   * theme's bottom-sheet padding, else none (the released default).
+   * theme's bottom-sheet padding, then --spacing-4 (Dialog's default).
    */
   padding?: SpacingStep;
   snapPoints?: ReadonlyArray<BottomSheetSnapPoint>;
@@ -627,7 +626,7 @@ export function BottomSheetPanel({
   }, [motion]);
 
   // Same lowering as Dialog: with no padding prop the content box reads the
-  // theme's --astryx-bottom-sheet-padding chain (no padding when unset), else
+  // theme's --astryx-bottom-sheet-padding chain (--spacing-4 when unset), else
   // the explicit step.
   const usesThemePadding = padding == null;
   const effectivePadding = padding ?? 4;

package/src/Chat/ChatComposerInput.doc.mjs

@@ -98,7 +98,7 @@ export const docs = {
       name: 'triggers',
       type: 'ChatComposerTrigger[]',
       description:
-        'Trigger definitions for typeahead menus. Each trigger specifies a character (@ or /), a search source, and an onSelect handler that returns the token to insert. Per-trigger emptySearchText (ReactNode) is the message when the query matched nothing; the older emptySearchResultsText (string) is deprecated and still works.',
+        'Trigger definitions for typeahead menus. Each trigger specifies a character (@ or /), a search source, and an onSelect handler that returns the token to insert. Per-trigger emptySearchText (ReactNode) is the message when the query matched nothing.',
     },
     {
       name: 'debounceMs',
@@ -174,7 +174,7 @@ export const docsZh = {
     placeholder: '输入为空时显示的占位文本。',
     maxRows: '滚动前的最大可见行数。紧凑布局中使用较小值。',
     triggers:
-      '菜单的触发定义。每个触发器指定字符（@ 或 /）、搜索源和返回要插入标记的 onSelect 处理器。每个触发器的 emptySearchText（ReactNode）用于查询无匹配结果时的提示；旧的 emptySearchResultsText（string）已弃用，但仍可使用。',
+      '菜单的触发定义。每个触发器指定字符（@ 或 /）、搜索源和返回要插入标记的 onSelect 处理器。每个触发器的 emptySearchText（ReactNode）用于查询无匹配结果时的提示。',
     debounceMs: '异步搜索源的去抖动延迟，避免过多网络请求。',
     hasHistory: '启用 ArrowUp/Down 回溯之前提交的消息。',
     label: '屏幕阅读器播报的无障碍标签。',
@@ -205,7 +205,7 @@ export const docsDense = {
     placeholder: 'placeholder when empty',
     maxRows: 'max visible rows before scroll; lower for compact layouts',
     triggers:
-      'typeahead trigger defs; character(@/)+searchSource+onSelect returning token; emptySearchText (ReactNode) for no matches, emptySearchResultsText deprecated',
+      'typeahead trigger defs; character(@/)+searchSource+onSelect returning token; emptySearchText (ReactNode) for no matches',
     debounceMs: 'debounce for async search to avoid excess requests',
     hasHistory: 'ArrowUp/Down to recall previous submissions',
     label: 'a11y label for screen readers',

package/src/Chat/ChatComposerInput.test.tsx

@@ -1136,7 +1136,7 @@ describe('ChatComposerInput', () => {
 
     it('supports configurable empty/loading text', () => {
       const trigger = createMentionTrigger({
-        emptySearchResultsText: 'Nobody found',
+        emptySearchText: 'Nobody found',
         loadingText: 'Looking up...',
         menuLabel: 'People',
       });
@@ -1146,7 +1146,7 @@ describe('ChatComposerInput', () => {
 
     // A trigger's `emptySearchResultsText` was renamed to `emptySearchText`
     // and widened from `string` to `ReactNode` (`spec:AST-056` FR1). The
-    // released key keeps working through the overlap (`spec:AST-017` FR28).
+    // overlap ended in a minor release (`CLN-0004`, `spec:AST-017` FR31).
     it('renders an element emptySearchText when the query matched nothing', async () => {
       const user = userEvent.setup();
       const trigger = createMentionTrigger({
@@ -1166,72 +1166,24 @@ describe('ChatComposerInput', () => {
       });
     });
 
-    it('keeps the deprecated key working, and says it is deprecated', async () => {
-      const warn = vi.spyOn(console, 'warn').mockImplementation(() => {});
-      const user = userEvent.setup();
-      const trigger = createMentionTrigger({
-        emptySearchResultsText: 'Nobody found',
-      });
-      render(<ChatComposerInput triggers={[trigger]} />);
-
-      await user.click(screen.getByRole('combobox'));
-      await user.keyboard('@zzzzz');
-
-      await waitFor(() => {
-        expect(screen.getByText('Nobody found')).toBeInTheDocument();
-      });
-      expect(warn).toHaveBeenCalledWith(
-        expect.stringContaining(
-          'ChatComposerInput: A trigger sets `emptySearchResultsText`, which is deprecated',
-        ),
-      );
-      warn.mockRestore();
-    });
-
-    it('treats an explicit null key as not given, falling through to the old one', async () => {
+    it('no longer reads the removed emptySearchResultsText key (CLN-0004)', async () => {
       const warn = vi.spyOn(console, 'warn').mockImplementation(() => {});
       const user = userEvent.setup();
       const trigger = createMentionTrigger({
+        // @ts-expect-error -- removed in the minor release (CLN-0004)
         emptySearchResultsText: 'Nobody found',
-        emptySearchText: null,
       });
       render(<ChatComposerInput triggers={[trigger]} />);
 
       await user.click(screen.getByRole('combobox'));
       await user.keyboard('@zzzzz');
 
-      // The same meaning the typeahead family gives `null`: not given, so
-      // the released key still supplies the message and no warning claims a
-      // winner the menu did not pick.
       await waitFor(() => {
-        expect(screen.getByText('Nobody found')).toBeInTheDocument();
+        expect(screen.getByText('No results')).toBeInTheDocument();
       });
+      expect(screen.queryByText('Nobody found')).not.toBeInTheDocument();
       expect(warn).not.toHaveBeenCalledWith(
-        expect.stringContaining('sets both'),
-      );
-      warn.mockRestore();
-    });
-
-    it('lets the new key win when a trigger sets both, and warns', async () => {
-      const warn = vi.spyOn(console, 'warn').mockImplementation(() => {});
-      const user = userEvent.setup();
-      const trigger = createMentionTrigger({
-        emptySearchResultsText: 'Old copy',
-        emptySearchText: 'New copy',
-      });
-      render(<ChatComposerInput triggers={[trigger]} />);
-
-      await user.click(screen.getByRole('combobox'));
-      await user.keyboard('@zzzzz');
-
-      await waitFor(() => {
-        expect(screen.getByText('New copy')).toBeInTheDocument();
-      });
-      expect(screen.queryByText('Old copy')).not.toBeInTheDocument();
-      expect(warn).toHaveBeenCalledWith(
-        expect.stringContaining(
-          'ChatComposerInput: A trigger sets both `emptySearchResultsText` and `emptySearchText`',
-        ),
+        expect.stringContaining('is deprecated'),
       );
       warn.mockRestore();
     });

package/src/Chat/ChatComposerInput.tsx

@@ -69,7 +69,6 @@ import {Badge, type BadgeProps} from '../Badge';
 import {useChatComposerContext} from './ChatContext';
 import {themeProps} from '../utils/themeProps';
 import {useTranslator} from '../i18n';
-import {useDevWarning} from '../hooks/useDevWarning';
 
 // =============================================================================
 // Types
@@ -167,17 +166,6 @@ export type ChatComposerTrigger = {
    * @default 'No results'
    */
   emptySearchText?: ReactNode;
-  /**
-   * Text shown when no results found.
-   * @default 'No results'
-   * @deprecated `DEP-0004`. Renamed to `emptySearchText`, which takes a
-   * `ReactNode` rather than a `string` — every existing value stays valid
-   * (`spec:AST-056` FR1, FR7). Still works exactly as released;
-   * `emptySearchText` wins when both are set. Removal is `CLN-0004`, in a
-   * later minor whose frozen manifest carries both ids (`spec:AST-017`
-   * FR31).
-   */
-  emptySearchResultsText?: string;
   /** Text shown during async search. @default 'Searching\u2026' */
   loadingText?: string;
   /** Accessible label for the menu. @default 'Suggestions' */
@@ -606,30 +594,6 @@ export function ChatComposerInput(props: ChatComposerInputProps) {
   insertTextRef.current = insertText;
 
   // --- Trigger menu ---
-  // Each trigger's empty-result message was renamed (`spec:AST-056` FR1); the
-  // released key keeps working through the overlap and development says which
-  // one was read (`spec:AST-017` FR28).
-  // `!= null` matches the `??` the menu resolves with, so an explicit `null`
-  // counts as "not given" on both names and the warnings cannot claim a
-  // winner the render did not pick.
-  const triggersWithDeprecatedEmptyText =
-    triggers?.filter(trigger => trigger.emptySearchResultsText != null) ?? [];
-  const triggersWithBothEmptyTexts = triggersWithDeprecatedEmptyText.filter(
-    trigger => trigger.emptySearchText != null,
-  );
-  useDevWarning(
-    'ChatComposerInput',
-    'A trigger sets `emptySearchResultsText`, which is deprecated; use ' +
-      '`emptySearchText` instead. It still works exactly as released.',
-    triggersWithDeprecatedEmptyText.length > triggersWithBothEmptyTexts.length,
-  );
-  useDevWarning(
-    'ChatComposerInput',
-    'A trigger sets both `emptySearchResultsText` and `emptySearchText`; ' +
-      '`emptySearchText` wins. `emptySearchResultsText` is deprecated — ' +
-      'drop it.',
-    triggersWithBothEmptyTexts.length > 0,
-  );
   const triggerMenu = useTriggerMenu({
     triggers,
     editableRef,

package/src/Chat/useTriggerMenu.tsx

@@ -640,10 +640,7 @@ export function useTriggerMenu(
 
   const renderMenu = useCallback((): ReactNode => {
     const trigger = state.activeTrigger;
-    const emptyText =
-      trigger?.emptySearchText ??
-      trigger?.emptySearchResultsText ??
-      'No results';
+    const emptyText = trigger?.emptySearchText ?? 'No results';
     const loadingText = trigger?.loadingText ?? 'Searching\u2026';
 
     let listContent: ReactNode;

package/src/CommandPalette/CommandPalette.spec.md

@@ -71,6 +71,8 @@ Consumer migration instructions belong in consumer docs and release notes.
   factual backfill does not invent one.
 - Shared layer hosting, positioning, or lifecycle rules beyond the current
   records linked below.
+- The List root's accessible name, list-id application, native passthrough, and
+  overflow scrolling — owned by `component:CommandPaletteList`.
 
 ## Public concepts