@astryxdesign/core 0.7.6-canary.fdabeba → 0.7.6

package/src/CommandPalette/CommandPalette.spec.md

@@ -1,278 +0,0 @@
----
-schema_version: 3
-template_version: 7
-kind: component
-id: component:CommandPalette
-authority: draft
-archive_reason: null
-superseded_by: null
-approved_by: null
-approved_at: null
-owners: [cixzhang]
-review_triggers: [behavior, theming, accessibility]
-verified_by:
-  [
-    packages/core/src/CommandPalette/CommandPalette.test.tsx,
-    packages/core/src/CommandPalette/CommandPaletteInput.test.tsx,
-    packages/core/src/CommandPalette/CommandPaletteList.test.tsx,
-    packages/core/src/CommandPalette/CommandPaletteItem.test.tsx,
-    packages/core/src/CommandPalette/CommandPaletteGroup.test.tsx,
-    packages/core/src/CommandPalette/CommandPaletteFooter.test.tsx,
-    packages/core/src/CommandPalette/__tests__/CommandPalette.a11y.chromium.spec.ts,
-    packages/core/src/CommandPalette/__tests__/CommandPaletteFooter.a11y.chromium.spec.ts,
-    packages/core/src/theme/themingTargets.test.ts,
-    scripts/check-knowledge.mjs,
-  ]
-modules: []
-families: [family:overlay-dismissal]
-design_specs: []
-architecture:
-  [
-    architecture:component-theming-surface,
-    architecture:interaction-modality,
-    architecture:public-component-api,
-  ]
-contributing: []
-system_specs: [spec:AST-056]
----
-
-# CommandPalette component contract
-
-## Contract at a glance
-
-| Area                    | Contract                                                                                                                                                                                     |
-| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Public contract         | Prop and visual APIs are unchanged. The result surface exposes listbox semantics only with selectable results; the query input has a real default name; rich Empty content remains ordinary. |
-| Behavior                | Modal Escape delegates to Dialog; query-field Home/End and IME remain native; result changes reset stale highlight; Empty announcements mirror rendered content.                             |
-| End-user impact         | Nested dismissal and native text entry are preserved; assistive technology receives the visible empty message, an independent query-field name, and only existing active options.            |
-| Builder impact          | None; no migration or new caller choice.                                                                                                                                                     |
-| Compatibility/readiness | Visual output is preserved. Empty-result ARIA, query-field accessible naming, empty-state announcement, and highlight reset behavior are corrected and verified.                             |
-| Review checks           | Reject local modal Escape handling, IME routing, Home/End result navigation, empty listboxes, stale active descendants, placeholder-only names, mismatched Empty announcements, or gaps.     |
-| Governing rules         | `family:overlay-dismissal/FR1`, `FR2`, `FR4`, `FR5`; `spec:AST-056/FR3`, `AR1`, `AR2`; existing public component and delegated-owner contracts.                                              |
-
-This table is a review projection; the body below is authoritative.
-
-## Intent
-
-CommandPalette presents searchable commands inside a Dialog. It owns search and
-selection orchestration plus the aggregate consumer anatomy while delegating its
-surface and modal dismissal ordering to Dialog.
-
-## Compatibility and migration
-
-- Released default preserved: `yes` for props and visual output
-- Compatibility class: behavioral and accessibility correction; empty states
-  conditionally omit listbox, expanded, controls, and active-descendant ARIA
-  attributes until selectable results exist; the default query accessible name
-  is independent of its placeholder; empty-search announcements mirror the
-  rendered content; public props, styling, targets, and visible defaults remain
-  unchanged
-- Controlled/uncontrolled behavior: unchanged
-- Migration decision: adopts `family:overlay-dismissal/FR1`, `FR2`, `FR4`, and
-  `FR5` through Dialog; no caller migration
-
-Consumer migration instructions belong in consumer docs and release notes.
-
-## Ownership boundary
-
-**Owns**
-
-- Search orchestration and composition of the current Input, List, Item, Group,
-  Group heading, Empty, and Footer parts and targets.
-- Composition of the native Query field rendered inside the default Input; the field's semantics and native passthrough are owned by `component:CommandPaletteInput`.
-
-**Does not own / non-goals**
-
-- Dialog's surface, Icon's glyph, Spinner's loading indicator, or Kbd's shortcut
-  badges — owned by their respective components.
-- Caller-provided replacement Input, Footer, item content, or trailing input
-  content — owned by the product callsite.
-- The Item option's passthrough, pointer, disabled, selected, highlighted, and
-  standalone-scroll semantics — owned by `component:CommandPaletteItem`.
-- A `command-palette` root target — no such current target exists, and this
-  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
-
-No new public concept is introduced. Consumer props, slots, and usage remain
-documented in `CommandPalette.doc.mjs` and its subcomponent docs.
-
-## Behavioral and layout contract
-
-| ID  | Candidate invariant                                                                                                                                                                                 | Basis                                                          | Draft review state                                                        |
-| --- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | ------------------------------------------------------------------------- |
-| FR1 | The current default render places Input and Footer around a result surface inside a delegated Dialog. That surface is a List listbox while Items exist and an ordinary Empty container otherwise.   | Current source, docs, tests, and ARIA required-child rule      | Verified current anatomy and valid rich Empty semantics                   |
-| FR2 | Input, List, Item, Group, Group heading, Empty, and Footer carry the seven current `command-palette-*` targets documented below; no `command-palette` root target exists.                           | Current source and target docs                                 | Verified current inventory and focused placement coverage                 |
-| FR3 | The default Input delegates its Search glyph to Icon and pending Loading spinner to Spinner; the default Footer delegates keyboard shortcuts to Kbd; the containing surface delegates to Dialog.    | Current source and component docs                              | Verified current composition; no ownership change                         |
-| FR4 | Query field is a distinct native text field inside Input and currently has no separate public target. The `command-palette-input` target is on the surrounding search region, not the native field. | Current source and target docs                                 | Verified current reachability; long-term theming intent remains unsettled |
-| FR5 | A modal palette leaves Escape unclaimed for Dialog's shared dismissal stack so a nested member handles the first press; inline previews close locally because they do not register as layers.       | `family:overlay-dismissal/FR1`, `FR2`, `FR4`, `FR5`            | Verified by nested and inline integration tests                           |
-| FR6 | The editable query field keeps Home and End for native caret movement, uses PageUp and PageDown for first/last result navigation, and does not route active IME composition keys to commands.       | WAI-ARIA editable combobox convention; objective IME integrity | Verified by user-event navigation and composition-key tests               |
-| FR7 | A committed result set resets highlight before exposure; the query input emits active-descendant only for an index that exists in the current selectable set.                                       | WAI-ARIA active-descendant integrity                           | Verified across populated, empty, and repopulated results                 |
-| FR8 | Empty search announcements mirror rendered `emptySearchText`, including rich caller content; the query input's default accessible name is independent of its placeholder.                           | `spec:AST-056/FR3`, `AR1`, `AR2`                               | Verified by live-region and accessible-name tests                         |
-
-### Allowed variation
-
-- **AV1 — Results.** Item count, grouping, selected content, and empty state may
-  vary without changing the aggregate anatomy.
-- **AV2 — Slots.** Caller-provided Input and Footer content may replace the
-  defaults without becoming CommandPalette-owned subparts.
-- **AV3 — Delegated rendering.** Dialog, Icon, Spinner, and Kbd may change their
-  internal element shape while preserving their own public contracts.
-
-### Representative states
-
-| State                  | Required invariant                                                            | Allowed variation                                          |
-| ---------------------- | ----------------------------------------------------------------------------- | ---------------------------------------------------------- |
-| Ungrouped results      | List contains Item instances.                                                 | Item count and caller-rendered content.                    |
-| Grouped results        | List contains Group, Group heading, and Item instances.                       | Group names, count, ordering, and item content.            |
-| Empty bootstrap/search | Empty replaces listbox semantics; search-empty text is announced as rendered. | Caller-provided rich content, including ordinary controls. |
-| Pending search         | Default Input may contain Loading spinner.                                    | Spinner is absent when no search is pending.               |
-| Default slots          | Input and Footer render their documented defaults.                            | Footer shortcut text and translated labels.                |
-| Caller-replaced slots  | The slot content replaces the corresponding default.                          | Replacement structure remains caller-owned.                |
-
-### Transformation and precedence order
-
-- No new search, selection, layout, or styling precedence rule is introduced.
-
-### Performance and resources
-
-- No new performance or resource rule is introduced.
-
-## Accessibility contract
-
-- **AR1 — Named composite.** The containing Dialog, combobox, populated listbox,
-  groups, options, busy status, empty state, and keyboard guidance preserve their
-  owned accessible names and roles. When no selectable results exist, the result
-  surface and combobox omit listbox, expanded, controls, and active-descendant
-  semantics so rich Empty content stays ordinary non-nested content.
-- **AR2 — Topmost Escape.** A modal palette delegates unclaimed Escape presses to
-  Dialog's shared dismissal stack. A nested registered surface handles the first
-  press; the host palette remains open until it becomes topmost.
-- **AR3 — Inline preview.** Documentation-only inline rendering remains outside
-  the shared layer stack and preserves its local Escape close behavior.
-- **AR4 — Editable query keys.** Home and End preserve native caret movement;
-  PageUp and PageDown navigate to the first and last results; active IME
-  composition keys remain owned by the input method.
-- **AR5 — Rendered empty message.** A search dead end announces the text rendered
-  by `emptySearchText`, including text produced by caller components and links.
-- **AR6 — Query-field name.** The default query field name is a localized
-  "Search commands" label independent of its placeholder; caller `label` and
-  native `aria-label` overrides remain supported.
-- **AR7 — Existing active option.** Result changes reset highlight, and
-  `aria-activedescendant` is present only when the indexed option exists in the
-  current selectable set.
-
-## Design relationships
-
-| Anatomy or state  | Design requirement                                                      | Representation authority       | Hierarchy role | Component contract |
-| ----------------- | ----------------------------------------------------------------------- | ------------------------------ | -------------- | ------------------ |
-| Dialog            | Presents the containing modal surface.                                  | `component:Dialog`             | Supporting     | FR1, FR3           |
-| Input             | Paints the search region around the query field and supporting visuals. | Current source and public docs | Prominent      | FR1, FR2, FR4      |
-| Search glyph      | Presents the search symbol in the default Input.                        | `component:Icon`               | Supporting     | FR3                |
-| Query field       | Accepts the native text query inside Input.                             | Current source and public docs | Prominent      | FR1, FR4           |
-| Loading spinner   | Indicates a pending search in the default Input.                        | `component:Spinner`            | Supporting     | FR3                |
-| List              | Presents the current result collection or Empty state.                  | Current source and public docs | Supporting     | FR1, FR2           |
-| Item              | Presents one selectable command result.                                 | Current source and public docs | Prominent      | FR1, FR2           |
-| Group             | Arranges related Items together.                                        | Current source and public docs | Supporting     | FR1, FR2           |
-| Group heading     | Labels one Group visually.                                              | Current source and public docs | Supporting     | FR1, FR2           |
-| Empty             | Presents the no-results or no-query message.                            | Current source and public docs | Prominent      | FR1, FR2           |
-| Footer            | Presents default guidance or caller-provided footer content.            | Current source and public docs | Supporting     | FR1, FR2           |
-| Keyboard shortcut | Presents one shortcut as painted key badges in the default Footer.      | `component:Kbd`                | Supporting     | FR3                |
-
-The native Query field is separate from the Input region that carries
-`command-palette-input`. Its current lack of a direct target is observed
-reachability, not a decision that it must remain unthemeable.
-
-### Theming anatomy
-
-<!-- anatomy-theming:v1 -->
-
-```json
-{
-  "Dialog": {
-    "delegatesTo": {"owner": "component:Dialog", "target": "dialog"}
-  },
-  "Input": {"target": "command-palette-input"},
-  "Search glyph": {
-    "delegatesTo": {"owner": "component:Icon", "target": "icon"}
-  },
-  "Query field": {
-    "none": {
-      "reason": "unsettled: No current public target is applied directly to the native query field; future exposure still needs an owner decision"
-    }
-  },
-  "Loading spinner": {
-    "delegatesTo": {"owner": "component:Spinner", "target": "spinner"}
-  },
-  "List": {"target": "command-palette-list"},
-  "Item": {"target": "command-palette-item"},
-  "Group": {"target": "command-palette-group"},
-  "Group heading": {"target": "command-palette-group-heading"},
-  "Empty": {"target": "command-palette-empty"},
-  "Footer": {"target": "command-palette-footer"},
-  "Keyboard shortcut": {
-    "delegatesTo": {"owner": "component:Kbd", "target": "kbd"}
-  }
-}
-```
-
-The seven local targets are current public seams. The delegated parts retain
-their existing component owners. The Query field `none` disposition records a
-current audit gap and does not authorize a new target.
-
-## Family and system relationships
-
-- `architecture:component-theming-surface` owns anatomy qualification, target
-  mapping, delegation, and factual `none` dispositions.
-- `architecture:public-component-api` owns the stable props and composition
-  surface; this documentation adds no API.
-- `architecture:interaction-modality/INV4` owns supported-modality path
-  reachability; the exact query-key details follow objective editable-combobox
-  and IME composition standards.
-- `spec:AST-056/FR3`, `AR1`, and `AR2` own rendered empty-search announcement
-  parity and an accessible query-field name independent of placeholder text.
-- `family:overlay-dismissal` owns topmost Escape and close-request ordering;
-  CommandPalette adopts it through Dialog while preserving local inline-preview
-  closing because inline mode does not register as a layer.
-- `architecture:layer-runtime` records that the modal path delegates Escape to
-  Dialog's shared dismissal registration while the unregistered inline preview
-  preserves local closing.
-
-## Verification map
-
-| Contract            | Verification                                                                          | Representative states                                            | Mutation or failure expectation                                                                                                                                      | Audit section                      |
-| ------------------- | ------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
-| FR1, AR1            | CommandPalette root and subcomponent suites plus exact-head Chromium evidence         | Default, grouped, empty, pending, rich Empty, and replaced slots | Exposing an empty listbox, leaving empty Input popup attributes, or nesting rich Empty controls under option semantics fails focused role and hosted axe assertions. | `audit:CommandPalette/anatomy`     |
-| FR2                 | Focused subcomponent suites and `themingTargets.test.ts`                              | Seven local targets at their owned elements                      | Removing or moving a current target fails a focused placement assertion or the global inventory.                                                                     | `audit:CommandPalette/theming`     |
-| FR3                 | `CommandPaletteInput.test.tsx`, `CommandPaletteFooter.test.tsx`, and browser evidence | Default Search glyph, pending spinner, and Footer Kbd            | Replacing or removing the delegated Icon, Spinner, or Kbd instance fails a composed-owner assertion and changes the exact-head evidence inventory.                   | `audit:CommandPalette/theming`     |
-| FR4                 | `CommandPaletteInput.test.tsx` and source inspection                                  | Native query field with idle and pending Input                   | Removing the field fails combobox tests; adding a field target requires an explicit map update.                                                                      | `audit:CommandPalette/anatomy`     |
-| FR5, AR2, AR3       | `CommandPalette.test.tsx`                                                             | Modal host with nested layer; inline preview                     | Restoring local modal Escape handling closes the host instead of the nested surface; removing the inline branch loses preview closing.                               | `audit:CommandPalette/interaction` |
-| FR6, AR4            | `CommandPalette.test.tsx` and `CommandPaletteInput.test.tsx`                          | Home, End, PageDown, Enter, and active IME composition           | Routing Home/End to results or forwarding a composing command key fails user-event and native composition assertions.                                                | `audit:CommandPalette/interaction` |
-| FR7, AR7            | `CommandPalette.test.tsx` and `CommandPaletteInput.test.tsx`                          | Populated, empty, and repopulated result sets                    | Preserving an out-of-range highlight or emitting its nonexistent active descendant fails transition and direct bounds assertions.                                    | `audit:CommandPalette/a11y`        |
-| FR8, AR5, AR6       | `CommandPalette.test.tsx`, `CommandPaletteInput.test.tsx`, and i18n checks            | Rich caller Empty content; default and caller query names        | Announcing catalog copy over rendered caller content or naming the query only through placeholder text fails live-region, name, and catalog assertions.              | `audit:CommandPalette/a11y`        |
-| Theming anatomy map | `scripts/check-knowledge.mjs` and exact-head Chromium evidence                        | Canonical anatomy and seven current local targets                | Missing, extra, prefixed, stale, alias-backed, or visually absent mappings fail repository validation or browser sensor counts.                                      | `audit:CommandPalette/theming`     |
-
-Focused target-placement assertions cover all seven local targets. The composed
-Input and Footer tests also pin the delegated Search Icon, pending Spinner, and
-four default Kbd shortcuts; exact-head browser evidence verifies the same owned
-anatomy across light, dark, LTR, RTL, and narrow rendering.
-
-## Decision log
-
-None. This draft records current facts and introduces no component-local design,
-layer, API, or theming decision.
-
-## Open questions
-
-- **OQ1 — Should Query field gain a stable public theming target?** (`human-api`)
-  Its current lack of direct reachability is an audit gap, not settled intent.
-
-## Content boundary
-
-This file does not duplicate consumer prop tables/examples, shared layer or
-modality rules, current audit results, or implementation steps. It links to
-their owners.

package/src/CommandPalette/CommandPaletteEmpty.spec.md

@@ -1,190 +0,0 @@
----
-schema_version: 3
-template_version: 7
-kind: component
-id: component:CommandPaletteEmpty
-authority: draft
-archive_reason: null
-superseded_by: null
-approved_by: null
-approved_at: null
-owners: [cixzhang]
-review_triggers: [public-api, behavior, theming, accessibility, testing]
-verified_by:
-  [
-    packages/core/src/CommandPalette/CommandPaletteEmpty.test.tsx,
-    packages/core/src/CommandPalette/CommandPalette.test.tsx,
-    packages/core/src/CommandPalette/CommandPaletteList.test.tsx,
-    packages/core/src/CommandPalette/__tests__/CommandPaletteEmptyAudit.a11y.chromium.spec.ts,
-    packages/core/src/theme/themingTargets.test.ts,
-    apps/storybook/stories/CommandPaletteEmpty.stories.tsx,
-    scripts/check-knowledge.mjs,
-  ]
-modules: []
-families: []
-design_specs: []
-architecture:
-  [
-    architecture:public-component-api,
-    architecture:component-theming-surface,
-    architecture:component-test-sufficiency,
-  ]
-contributing: []
-system_specs: [spec:AST-029, spec:AST-056]
----
-
-# CommandPaletteEmpty component contract
-
-## Contract at a glance
-
-| Area                    | Contract                                                                                                                                                                                        |
-| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Public contract         | `CommandPaletteEmpty` / `CommandPaletteEmptyProps`: required `children`, `BaseProps<HTMLDivElement>`, and a root `ref`.                                                                         |
-| Behavior                | One ordinary container centers caller content as supporting text. CommandPalette renders it for the no-query and no-results branches; it owns no role, state, announcement, or interaction.     |
-| End-user impact         | People who reach a palette dead end read the message, and any caller link stays ordinary reachable content rather than an option.                                                               |
-| Builder impact          | None. Caller content, host attributes, and styling inputs compose on the root.                                                                                                                  |
-| Compatibility/readiness | Observational patch contract. Runtime behavior, exports, and the target name are unchanged; authority stays `draft` until exact-head owner approval.                                            |
-| Review checks           | Reject a component-owned role or live region, option semantics around caller content, dropped root inputs, a target moved off the painted root, or content that overflows its host inline axis. |
-| Governing rules         | `architecture:public-component-api/INV1,INV5–INV8`; `architecture:component-theming-surface/INV2–INV6`; `spec:AST-056/FR3`, `AR1` for the parent's announcement; WCAG 2.2 SC 1.4.3 and 1.4.10.  |
-
-This table is a review projection; the body below is authoritative.
-
-## Intent
-
-CommandPaletteEmpty presents the message shown in a CommandPalette result area
-when there is nothing to choose. It owns the empty-message surface: its layout,
-supporting typography, secondary text color, root input composition, and the
-`command-palette-empty` theme target. CommandPalette decides when the message
-appears, what it says by default, and whether it is announced.
-
-Consumer syntax and examples belong in `CommandPaletteEmpty.doc.mjs`.
-
-## Compatibility and migration
-
-- Released default preserved: yes — one centered, ordinary message container.
-- Compatibility class: observational patch; no public surface changes.
-- Controlled/uncontrolled behavior: not applicable.
-- Migration decision: none.
-
-Consumer migration instructions belong in consumer docs and release notes.
-
-## Ownership boundary
-
-**Owns**
-
-- One root container and its public ref, DOM/data/ARIA, class, style, event, and
-  `xstyle` composition.
-- Centered layout, block and inline padding, supporting type size and leading,
-  body font family, and secondary text color for caller content.
-- Wrapping caller text inside the host's inline size.
-- The `command-palette-empty` target on the same painted root.
-
-**Does not own / non-goals**
-
-- When the empty branch appears, the built-in catalog messages, and the
-  empty-search announcement — owned by `component:CommandPalette`.
-- Result-surface semantics while empty, including dropping listbox semantics —
-  owned by `component:CommandPalette` and `component:CommandPaletteList`.
-- The meaning, links, or controls inside caller content — owned by the product
-  callsite.
-
-## Public concepts
-
-| Concept       | Closed values or states                       | Meaning                                                             | Availability by variant/orientation/state                        | Default  | Owner                | Stability | Invalid-value behavior                                  |
-| ------------- | --------------------------------------------- | ------------------------------------------------------------------- | ---------------------------------------------------------------- | -------- | -------------------- | --------- | ------------------------------------------------------- |
-| Empty message | caller `ReactNode`: text or elements          | The supporting message people read when there is nothing to choose. | No-query and no-results palette branches; standalone composition | required | component            | stable    | Rendered as given; React decides non-renderable values. |
-| Root surface  | ref; DOM/data/ARIA; class/style/xstyle/events | Extends the message root.                                           | Every render                                                     | omitted  | public component API | stable    | Accepted inputs compose; the component adds no role.    |
-
-## Behavioral and layout contract
-
-Draft requirements identify their basis so observed code is not mistaken for an
-intentional decision.
-
-| ID  | Candidate invariant                                                                                                                                                                 | Basis                                                                          | Draft review state |
-| --- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | ------------------ |
-| FR1 | The component MUST render its children inside one container element that centers them on both axes with centered text, supporting type, body font family, and secondary text color. | Current source, consumer docs, and focused tests                               | verify             |
-| FR2 | CommandPalette MUST render this component with `emptyBootstrapText` when there is no query and no result, and with `emptySearchText` when a query has no result.                    | Current CommandPalette source and tests                                        | verify             |
-| FR3 | The root MUST carry no component-owned role, live region, or focus stop, so caller links and controls remain ordinary content.                                                      | WAI-ARIA 1.2 listbox owned-children rule; current source and Chromium evidence | verify             |
-| FR4 | Caller text MUST wrap inside the host's inline size, including a single unbroken token, so no message forces inline scrolling or clipping at 320 CSS px.                            | WCAG 2.2 SC 1.4.10; Chromium evidence                                          | verify             |
-| FR5 | The painted root MUST carry the `command-palette-empty` target; component styles apply before caller `xstyle`.                                                                      | `architecture:component-theming-surface/INV2–INV6`; source and focused tests   | verify             |
-| FR6 | Accepted ref, DOM/data/ARIA, class, style, events, and `xstyle` MUST reach or compose on the root.                                                                                  | `architecture:public-component-api/INV5–INV8`; focused tests                   | verify             |
-
-### Allowed variation
-
-- **AV1 — Theme paint.** The target may restyle the message surface and text
-  without changing semantics or layout ownership.
-- **AV2 — Caller content.** Text length, translation, inline elements, and links
-  may vary while the root stays one ordinary container.
-
-### Representative states
-
-| State                  | Required invariant                                                            | Allowed variation                             |
-| ---------------------- | ----------------------------------------------------------------------------- | --------------------------------------------- |
-| Palette no-query empty | The bootstrap message renders in the result area; no listbox is exposed.      | Built-in catalog text or caller content.      |
-| Palette no-result      | The search message renders; CommandPalette announces the rendered text.       | Built-in catalog text or caller rich content. |
-| Standalone             | The same root renders outside a palette with caller content.                  | Host layout and caller roles.                 |
-| Long or translated     | Text wraps inside the host; no inline overflow.                               | Line count grows.                             |
-| RTL                    | Centered layout and text remain direction-neutral; inline text order mirrors. | Caller content direction.                     |
-| Narrow viewport        | The message wraps within a 320 CSS px host.                                   | Line count grows.                             |
-
-### Transformation and precedence order
-
-- **ORD1 — Root composition.** Apply the target class, component styles, then
-  caller `xstyle`; append caller `className`; apply caller `style`; spread
-  remaining host props onto the root.
-
-### Performance and resources
-
-- **PR1 — No lifecycle.** CommandPaletteEmpty uses no hook, listener, observer,
-  timer, request, state, or Effect.
-
-## Accessibility contract
-
-- **AR1 — Ordinary content.** The root exposes caller content in reading order
-  with no added role; a caller link keeps its own role and focus behavior.
-- **AR2 — Readable message.** Message text meets the WCAG 2.2 SC 1.4.3 contrast
-  minimum against its rendered surface in every supported theme and mode.
-
-## Design relationships
-
-| Anatomy or state | Design requirement                                                        | Representation authority                                          | Hierarchy role | Component contract |
-| ---------------- | ------------------------------------------------------------------------- | ----------------------------------------------------------------- | -------------- | ------------------ |
-| Empty message    | Presents the dead-end message as supporting text centered in the results. | Current source tokens; no component-local visual decision settled | supporting     | FR1, FR4, FR5      |
-
-No component-local visual decision is settled by this draft.
-
-## Family and system relationships
-
-- `architecture:public-component-api` owns exports and root input composition.
-- `architecture:component-theming-surface` owns target placement.
-- `architecture:component-test-sufficiency` owns proportionate, observable
-  evidence.
-- `spec:AST-056/FR3` and `AR1` require CommandPalette to announce the
-  empty-search message it rendered; this component supplies the rendered node.
-- CommandPalette and CommandPaletteList draft records describe the parent
-  branches and empty result surface; they are observational context, not
-  authority for this contract.
-- `spec:AST-029` keeps this observational draft separate from the audit receipt.
-
-## Verification map
-
-| Contract      | Verification                                                                           | Representative states                              | Mutation or failure expectation                                                                         | Audit section                        |
-| ------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------ |
-| FR1, FR5–FR6  | `CommandPaletteEmpty.test.tsx`; `themingTargets.test.ts`                               | text and element children; root inputs             | A dropped input, a moved target, or lost children fails the focused assertions.                         | `audit:CommandPaletteEmpty/§2,§3,§4` |
-| FR2, FR3, AR1 | `CommandPalette.test.tsx`; `CommandPaletteList.test.tsx`; exact-head Chromium receipts | bootstrap, search, rich content, modal and inline  | Exposing a listbox, adding a role, or announcing other text than the rendered message fails assertions. | `audit:CommandPaletteEmpty/§1,§4`    |
-| FR4, AR2      | Exact-head Chromium receipts and contrast pairs                                        | long and translated text; 320 px; themes and modes | Inline overflow or clipping fails the reflow sensor; ratios are recorded per frame.                     | `audit:CommandPaletteEmpty/§5,§10`   |
-| PR1           | Source review and the presentational lint rule                                         | every state                                        | A hook or lifecycle mechanism fails the lint rule.                                                      | `audit:CommandPaletteEmpty/§7`       |
-
-## Decision log
-
-None. This draft records current facts and introduces no product decision.
-
-## Open questions
-
-None.
-
-## Content boundary
-
-This file does not duplicate consumer prop tables/examples, current audit scores,
-screenshot matrices, implementation steps, or system rules. The audit pull request
-owns the closed run evidence required by `spec:AST-029/FR5`.