@astryxdesign/core 0.7.6-canary.fdabeba → 0.7.6

package/src/Chat/ChatComposer.spec.md

@@ -1,246 +0,0 @@
----
-schema_version: 3
-template_version: 7
-kind: component
-id: component:ChatComposer
-authority: current
-archive_reason: null
-superseded_by: null
-approved_by: cixzhang
-approved_at: 2026-10-31
-owners: [cixzhang]
-review_triggers: [public-api, behavior, layout, theming, accessibility]
-verified_by:
-  [
-    packages/core/src/Chat/ChatComposer.test.tsx,
-    packages/core/src/Chat/ChatComposerInput.test.tsx,
-    packages/core/src/Chat/ChatSendButton.test.tsx,
-    apps/storybook/stories/ChatComposer.stories.tsx,
-    apps/storybook/stories/ChatComposerCustomInput.stories.tsx,
-  ]
-modules: []
-families: []
-design_specs: []
-architecture:
-  [
-    architecture:component-test-sufficiency,
-    architecture:component-theming-surface,
-    architecture:public-component-api,
-    architecture:interaction-modality,
-    architecture:react-component-runtime,
-    architecture:component-style-authoring,
-    architecture:knowledge-contracts,
-  ]
-contributing: []
-system_specs:
-  [
-    spec:AST-002,
-    spec:AST-009,
-    spec:AST-017,
-    spec:AST-020,
-    spec:AST-027,
-    spec:AST-029,
-  ]
----
-
-# ChatComposer component contract
-
-## Contract at a glance
-
-| Area                    | Contract                                                                                                                                                                                                                                                                                                |
-| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Public contract         | `ChatComposer` with a controlled or uncontrolled draft (`value`, `onChange`), `onSubmit`, `placeholder`, `isDisabled`, `isStopShown`, `onStop`, `density`, `elevation`, `status`, `statusPosition`, the drawer, header, input, footer, and send slots, and BaseProps; the exported composition context. |
-| Behavior                | ChatComposer coordinates a controlled or uncontrolled draft, trims a submitted value, clears through the existing value channel, composes caller slots, and keeps the default send/stop action synchronized with context.                                                                               |
-| End-user impact         | Screen-reader users can identify the disabled editor, pointer and touch users can stop an interruptible response, and users of a custom editor send the draft that editor supplied instead of stale composer state.                                                                                     |
-| Builder impact          | None.                                                                                                                                                                                                                                                                                                   |
-| Compatibility/readiness | Records shipped behavior; no public change. Two implementation gaps are listed under Current-state impact; four owner questions stay open. Evidence still pending for parts of FR1, FR5–FR7, FR10, and PR1–PR2 (read from source; see the verification map).                                            |
-| Review checks           | Reject ignored context submission arguments, a disabled state hidden from the default textbox, an ancestor that blocks an enabled Stop action, or a change that settles an open question without its owner.                                                                                             |
-| Governing rules         | `architecture:interaction-modality/INV4, INV7, INV9`; `architecture:public-component-api/INV5–INV6, INV9, INV12`; `architecture:component-theming-surface/INV4, INV6`; `spec:AST-020/FR1`; `spec:AST-029/DEC-4`.                                                                                        |
-
-This table is a review projection; the body below is authoritative.
-
-## Intent
-
-ChatComposer is the message-entry shell for a chat surface. It coordinates the
-current draft and submission operation, lays out an optional drawer, header,
-status, footer, and send-area content around a default or caller-supplied input,
-and owns keyboard-only editor focus indication. Products own message transport,
-streaming state, validation policy, and the content placed in each slot.
-
-## Compatibility and migration
-
-- Released default preserved: `yes`
-- Compatibility class: records shipped behavior; no public change
-- Controlled/uncontrolled behavior: a successful submission clears through
-  `onChange` in controlled mode and local state otherwise
-- Migration decision: none
-
-Consumer migration instructions belong in consumer docs and release notes.
-
-## Current-state impact
-
-- **The public target does not reach the painted body.** The `chat-composer`
-  target sits on the outer frame, so a theme cannot select the body's elevation
-  and border. `architecture:component-theming-surface` INV4 puts each themable
-  part's paint on its target (FR7, OQ1).
-- **Styling inputs split across two elements.** `ref`, DOM props and events,
-  `className`, and `style` reach the outer frame while `xstyle` reaches the
-  painted body. `architecture:public-component-api` INV6 has styling inputs
-  compose on one element (FR10, OQ2).
-
-## Ownership boundary
-
-**Owns**
-
-- Coordinating a controlled or uncontrolled serialized draft value with the input and submit action.
-- Providing the default token-capable editor and send/stop action while allowing either to be replaced.
-- Laying out the drawer, header, input, footer, send, and status regions.
-- Applying composer density, elevation, disabled presentation, and keyboard-only editor focus indication.
-- Publishing the composition context used by custom inputs and send controls.
-
-**Does not own / non-goals**
-
-- Sending, retrying, cancelling, or persisting a message — owned by the product callsite.
-- Deciding when a response is streaming or whether it is interruptible — owned by the product callsite.
-- Attachment data, model selection, speech recognition, or validation policy — owned by the supplied slot components and product callsite.
-- A product's accessible conversation transcript or live response announcements — owned by the surrounding chat surface.
-
-## Public concepts
-
-| Concept                 | Closed values or states                                      | Meaning                                                                                          | Availability by variant/orientation/state        | Default                     | Owner                               | Stability | Invalid-value behavior                                                        |
-| ----------------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ | ------------------------------------------------ | --------------------------- | ----------------------------------- | --------- | ----------------------------------------------------------------------------- |
-| Draft ownership         | uncontrolled; controlled `value` + `onChange`                | Selects where the serialized input draft is stored and how clearing is reported.                 | Every ChatComposer                               | uncontrolled empty string   | `component:ChatComposer`            | stable    | Controlled `value` without an updating owner remains caller-controlled.       |
-| Submission              | input submit; default send; custom context `onSubmit(value)` | Delivers one trimmed, non-empty supplied value and clears the draft through the current channel. | Enabled composer with a non-empty supplied value | no submission               | `component:ChatComposer`            | stable    | Empty values and submissions while disabled are ignored.                      |
-| Input composition       | default ChatComposerInput; custom React node                 | Supplies the editing surface and optional registered focus control.                              | Every ChatComposer                               | ChatComposerInput           | `component:ChatComposer`            | stable    | A custom input without a registered control gets textarea focus fallback.     |
-| Editing availability    | enabled; disabled                                            | Controls whether the draft can be edited or submitted.                                           | Every ChatComposer                               | enabled                     | `component:ChatComposer`            | stable    | Disabled submission is ignored.                                               |
-| Primary action          | send; stop                                                   | Sends the current draft or requests interruption.                                                | Default ChatSendButton or a custom sendButton    | send                        | `component:ChatComposer`            | stable    | A shown Stop action without `onStop` renders but does nothing (OQ4).          |
-| Density                 | compact; balanced; spacious                                  | Selects composer spacing.                                                                        | Every ChatComposer                               | balanced                    | `component:ChatComposer`            | stable    | Unknown values are rejected by TypeScript.                                    |
-| Elevation               | low; none                                                    | Selects a raised body or a flat bordered body.                                                   | Every ChatComposer                               | low                         | `component:ChatComposer`            | stable    | Unknown values are rejected by TypeScript.                                    |
-| Status                  | absent; error; warning; top; bottom                          | Adds announced feedback before or after the body.                                                | Optional status object                           | absent; bottom when present | `component:ChatComposer`            | stable    | An omitted message renders the bar and announces nothing.                     |
-| Named composition slots | drawer; header actions/context; input; footer/send actions   | Lets callers compose supporting controls and information around the draft.                       | Optional, independently supplied                 | omitted                     | `component:ChatComposer`            | stable    | Omitted slot groups emit no empty header; footer remains for the send action. |
-| BaseProps surface       | ref; DOM props/events; className/style; xstyle               | Extends the component with DOM identity, behavior, and styling.                                  | Every ChatComposer                               | omitted                     | `architecture:public-component-api` | stable    | Split between the frame and the body (FR10, OQ2).                             |
-
-## Behavioral and layout contract
-
-| ID   | Invariant                                                                                                                                                                                                                                                                                                                                                          | Basis                                                                                                                                    |
-| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
-| FR1  | Controlled mode MUST report changes through `onChange`; uncontrolled mode MUST retain them locally. Every successful submit MUST trim and deliver the value supplied to that operation, then clear through the same value channel.                                                                                                                                 | public types and docs; `architecture:public-component-api/INV3, INV9, INV12`; focused tests                                              |
-| FR2  | The default editor MUST serialize its current text/tokens, submit Enter without Shift, preserve Shift+Enter, defer during IME composition, and allow a caller key handler to prevent the default operation.                                                                                                                                                        | implementation, docs, and focused tests                                                                                                  |
-| FR3  | `isDisabled` MUST prevent draft edits and submissions and MUST expose `aria-disabled="true"` on the default textbox; removing the prop MUST remove that state.                                                                                                                                                                                                     | `spec:AST-020/FR1` (WCAG 2.2 4.1.2); `architecture:interaction-modality/INV5`; red/green focused test                                    |
-| FR4  | When `isStopShown` is true, the default primary action MUST remain an enabled, named Stop button and call `onStop`; if editing is also disabled, ancestor styling MUST NOT block its pointer, touch, or keyboard activation.                                                                                                                                       | `architecture:interaction-modality/INV4, INV7, INV9`; red/green focused and browser-story tests                                          |
-| FR5  | Omitted header slots MUST omit the header row; the drawer precedes the body; input fills the body between header and footer; footer actions precede send actions and the primary action; status follows `statusPosition`.                                                                                                                                          | implementation, props, stories, and blocks                                                                                               |
-| FR6  | `compact` reduces body padding and gap; `balanced` and `spacious` produce the same body spacing. Whether `spacious` should differ is open (OQ3).                                                                                                                                                                                                                   | implementation and published union; no current owner selects distinct spacious geometry                                                  |
-| FR7  | `low` applies low rest and medium hover and focus-within elevation; `none` applies no shadow and a border. Implementation gap: the public target does not reach the painted body (Current-state impact; OQ1).                                                                                                                                                      | implementation; `architecture:component-theming-surface/INV4, INV6`; the `chat-composer` target sits on the frame (Current-state impact) |
-| FR8  | Keyboard focus entering the registered/default editor MUST add the shared focus indication to the body; pointer focus MUST not add that extra ring. Clicking non-interactive body space MUST focus the registered control, then a textarea fallback.                                                                                                               | implementation; `architecture:interaction-modality/INV1–INV3, INV9`; focused tests                                                       |
-| FR9  | Error status is announced assertively and warning status politely through the shared announcement channel, once per occasion: one state transition, which a rerender or an update to the same value does not repeat (`spec:AST-086` FR6); the status bar itself carries no live role. Both pair a semantic icon with color and can render above or below the body. | implementation, docs, and stories; `spec:AST-020/FR1`; `spec:AST-086/FR2, FR5, FR6`                                                      |
-| FR10 | `ref`, DOM props and events, `className`, and `style` reach the outer frame; `xstyle` reaches the painted body. Implementation gap: the styling inputs split across two elements (Current-state impact; OQ2).                                                                                                                                                      | implementation; `architecture:public-component-api/INV5–INV6, INV8`                                                                      |
-| FR11 | The exported context MUST expose the current value, change and submit operations, placeholder, disabled/stop/send state, stop callback, and mutable input focus control to custom composition.                                                                                                                                                                     | public export, types, docs, stories, and focused tests; `architecture:public-component-api/INV12`                                        |
-
-### Allowed variation
-
-- **AV1 — Slot content.** Callers may omit or replace each named slot while preserving the composer's value, submit, focus, and disabled contracts.
-- **AV2 — Product workflow.** Callers decide when to show status or Stop and what their callbacks do; ChatComposer owns only the local affordance and dispatch.
-- **AV3 — Editor implementation.** A custom input may be a textarea, contenteditable editor, or other control when it follows the exported context and focus-control contract.
-
-### Representative states
-
-| State                        | Required invariant                                                                                  | Allowed variation                                            |
-| ---------------------------- | --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
-| Empty draft                  | Default send action is disabled and submission does not fire.                                       | Placeholder and optional slots vary.                         |
-| Non-empty draft              | Enter or Send submits one trimmed value and clears through the active ownership channel.            | Serialized token representation and transport behavior vary. |
-| Controlled draft             | Caller value remains authoritative; onChange receives edits and clear requests.                     | The caller may accept or defer each update.                  |
-| Custom input                 | Context operations act on the supplied value and body click uses its registered focus control.      | DOM/editor implementation varies.                            |
-| Disabled editing             | Default textbox exposes disabled state and cannot edit or submit.                                   | Supporting content remains visible.                          |
-| Disabled, interruptible work | Stop remains named, enabled, and reachable by pointer, touch, and keyboard.                         | Product cancellation behavior varies.                        |
-| Flat elevation               | Body has no shadow and uses its bordered presentation; keyboard focus indication remains available. | Theme tokens vary.                                           |
-| Status above or below        | Announcement urgency, icon, color, and selected placement remain synchronized.                      | Message content and status type vary.                        |
-| Narrow viewport              | Composer remains within its containing inline size and the primary action remains operable.         | Available inline size and optional slot content vary.        |
-
-### Transformation and precedence order
-
-- **ORD1 — Value update.** Receive an editor value → publish through `onChange` when controlled or update local state when uncontrolled → derive current context value and send availability.
-- **ORD2 — Submission.** Receive the operation's supplied value → trim → reject empty or disabled submission → call public `onSubmit` once → request clearing through the current value channel.
-- **ORD3 — Primary action.** Resolve `isStopShown` → expose Stop and dispatch `onStop`, otherwise derive send availability from current draft and disabled state → submit the current context value.
-- **ORD4 — Composition order.** Optional top status → drawer → body header → input → footer actions → send actions → primary action → optional bottom status.
-
-### Performance and resources
-
-- **PR1 — Context stability.** The exported context value SHOULD retain referential stability while none of its public members changes.
-- **PR2 — Focus coordination.** The component adds no document listener or observer of its own for body-click focus or focus indication; it mounts the shared interaction-modality tracker, which adds document-level `pointerdown` and `keydown` listeners (`architecture:interaction-modality`).
-
-## Accessibility contract
-
-- **AR1 — Editing state.** The default contenteditable surface acts as the textbox and MUST expose disabled state through `aria-disabled` when editing is unavailable.
-- **AR2 — Native actions.** The default Send and Stop controls remain native buttons with translated accessible names; disabled Send uses native disabled behavior, while explicit Stop remains operable.
-- **AR3 — Keyboard editing.** Enter submission MUST preserve Shift+Enter newline behavior, IME composition, and caller cancellation through `preventDefault()`.
-- **AR4 — Focus indication.** Keyboard focus in the editor MUST produce the shared visible focus treatment; pointer focus does not claim keyboard modality, and focus on an internal action remains owned by that action.
-- **AR5 — Status feedback.** Error feedback is announced assertively and warning feedback politely through the shared announcement channel (`spec:AST-086` FR2, FR5); the visible status bar carries no live role and stays readable. Visible icon and color do not replace the caller's message content.
-
-## Design relationships
-
-| Anatomy or state    | Design requirement                                                  | Representation authority                                                                                   | Hierarchy role | Component contract |
-| ------------------- | ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | -------------- | ------------------ |
-| Composer frame      | Groups body and optional status into one compositional shell.       | Current source                                                                                             | container      | FR5                |
-| Composer body       | Provides the painted rounded input/action surface and elevation.    | elevation is shipped; public theme reachability is unsettled                                               | prominent      | FR7                |
-| Drawer              | Places attachment/context content before the body.                  | delegated to `component:ChatComposerDrawer`                                                                | supporting     | FR5                |
-| Header              | Places caller actions at start and caller context at end.           | Current source                                                                                             | supporting     | FR5                |
-| Input               | Owns or hosts the editing surface and its focus control.            | delegated to `component:ChatComposerInput` or caller custom input                                          | prominent      | FR1–FR3, FR8, FR11 |
-| Footer              | Places caller actions and the primary action on the final body row. | Current source                                                                                             | supporting     | FR4–FR5            |
-| Send or stop action | Presents the current primary operation.                             | delegated to `component:ChatSendButton` or caller custom send button                                       | prominent      | FR1, FR4           |
-| Status message      | Adds error or warning feedback before or after the body.            | shared-channel announcement and color are shipped; separate public theme reachability is not asserted here | supporting     | FR5, FR9, AR5      |
-
-The public `chat-composer` target sits on the frame and cannot select the body's
-elevation and border (Current-state impact). No anatomy-theming map is recorded
-yet; the block is optional during migration, so the map is deferred.
-
-## Family and system relationships
-
-- No current family or design record governs ChatComposer-specific behavior.
-- `architecture:public-component-api` owns BaseProps element ownership, callback semantics, and the exported composition context.
-- `architecture:interaction-modality` owns modality parity, focus ownership, and the requirement that enabled Stop remain reachable.
-- `architecture:component-theming-surface` owns the anatomy-to-target disposition and makes the current body reachability mismatch blocking without deciding its repair shape.
-- `architecture:component-test-sufficiency` owns public-state partitions, negative assertions, observable output, and the exact-head browser boundary.
-- `architecture:react-component-runtime` owns render-derived state and browser/server boundaries.
-- `architecture:knowledge-contracts` keeps consumer syntax in `ChatComposer.doc.mjs` and system behavior in this record.
-- `spec:AST-020/FR1` carries the current WCAG 2.2 accessibility baseline.
-- `spec:AST-029` owns the audit evidence inventory this record's verification map follows.
-
-## Verification map
-
-| Contract  | Verification                                                                                                                                                       | Representative states                                                           | Mutation or failure expectation                                                                          | Audit section                       |
-| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | ----------------------------------- |
-| FR1, FR11 | `ChatComposer.test.tsx` input composition tests                                                                                                                    | context-supplied value, custom input reading value, change, and disabled        | A context submission that ignores its argument, or a context member a custom input cannot read, fails.   | `audit:ChatComposer/api-behavior`   |
-| FR2, AR3  | `ChatComposerInput.test.tsx`                                                                                                                                       | Enter, Shift+Enter, composing, cancelled keydown                                | A key path that sends during composition or loses a newline fails.                                       | `audit:ChatComposer/input-behavior` |
-| FR3, AR1  | `ChatComposer.test.tsx` "exposes disabled state on the default textbox and clears it when enabled"                                                                 | disabled and re-enabled default textbox                                         | A textbox that loses or keeps its disabled state wrongly fails.                                          | `audit:ChatComposer/accessibility`  |
-| FR4, AR2  | `ChatComposer.test.tsx` "keeps the Stop action pointer-operable while editing is disabled"; the `DisabledStreamingNarrow` story play in `ChatComposer.stories.tsx` | disabled editing with Stop shown; a narrow viewport with no horizontal overflow | A Stop action an ancestor blocks, or one that does not call `onStop`, fails.                             | `audit:ChatComposer/modality`       |
-| FR7       | `ChatComposer.test.tsx` elevation tests                                                                                                                            | `low` default, `none`                                                           | Levels that share a body class, or a default other than `low`, fail.                                     | `audit:ChatComposer/theming`        |
-| FR8, AR4  | `ChatComposer.test.tsx` focus indication tests and custom-input focus tests                                                                                        | keyboard, pointer, programmatic after each, internal button, body click         | A ring on pointer focus, a missing ring on keyboard focus, or a body click that skips the control fails. | `audit:ChatComposer/focus`          |
-| FR9, AR5  | `ChatComposer.test.tsx` status announcement tests                                                                                                                  | error, warning, StrictMode mount, repeat after clear, no message, page load     | A live role on the bar, a repeated or missing announcement, or the wrong urgency fails.                  | `audit:ChatComposer/accessibility`  |
-
-Read from source, with no focused test yet:
-
-- FR1: controlled and uncontrolled draft storage, trimming, rejecting an empty
-  or disabled submission, and clearing through the active channel.
-- FR5: slot order, the omitted header row, and status placement above or below
-  the body.
-- FR6: the density spacing.
-- FR7: the shadow and border values for each elevation.
-- FR10: where each BaseProps input lands.
-- PR1–PR2: context stability, and no document listener or observer of the
-  component's own.
-
-## Decision log
-
-No component-local decision is recorded.
-
-## Open questions
-
-- **OQ1 — Body theming reachability.** Should a new stable body target be added, should the released `chat-composer` target move, or should elevation be projected through the existing root target by another compatible mechanism? (`human-api`)
-- **OQ2 — BaseProps owner.** Should ref, neutral DOM props/events, `className`, `style`, and `xstyle` all own the outer frame or the painted body, and what compatibility path preserves existing consumers? (`human-api`)
-- **OQ3 — Spacious density.** Should `spacious` intentionally alias `balanced`, or should it receive distinct spacing selected by design? (`human-design`)
-- **OQ4 — Stop callback invariant.** When `isStopShown` is true without `onStop`, should the component reject the combination, disable or hide Stop, or keep the currently inert action? (`human-api`)
-
-## Content boundary
-
-This file does not duplicate consumer prop tables/examples, current audit
-results, implementation steps, or shared system rules. It links to their owners.

package/src/Chat/ChatComposerDrawer.spec.md

@@ -1,267 +0,0 @@
----
-schema_version: 3
-template_version: 5
-kind: component
-id: component:ChatComposerDrawer
-authority: current
-archive_reason: null
-superseded_by: null
-approved_by: cixzhang
-approved_at: 2026-09-21
-owners: [cixzhang]
-review_triggers: [public-api, behavior, layout, theming, accessibility]
-verified_by:
-  [
-    packages/core/src/Chat/ChatComposerDrawer.test.tsx,
-    apps/storybook/stories/ChatComposerDrawer.stories.tsx,
-    apps/storybook/rtl-audit/verified-not-applicable.json,
-  ]
-modules: []
-families: []
-design_specs: []
-architecture:
-  [
-    architecture:component-theming-surface,
-    architecture:interaction-modality,
-    architecture:knowledge-contracts,
-    architecture:public-component-api,
-  ]
-contributing: [contributing:api-conventions]
-system_specs: [spec:AST-002/DEC-1, spec:AST-002/DEC-2]
----
-
-# ChatComposerDrawer component contract
-
-## Contract at a glance
-
-| Area                    | Contract                                                                                                                                                                                                                    |
-| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Public contract         | Add one optional `collapsedSummary?: ReactNode` slot, named from the canonical **Collapsed summary** anatomy part, for caller-composed visual content.                                                                      |
-| Behavior                | `count` continues to enable the disclosure. Omitting `collapsedSummary` keeps the neutral Badge count plus resolved label; providing it replaces that complete visual summary without changing collapse behavior or naming. |
-| End-user impact         | People retain the established Badge hierarchy by default. Products that need a quieter or differently composed collapsed row may provide one localized visual summary without weakening disclosure semantics.               |
-| Builder impact          | Existing callsites do not change. A builder choosing the slot owns its visual content and localization, while `label` continues to identify the controlled content for the component-owned accessible name.                 |
-| Compatibility/readiness | Additive and default-preserving. This record is current authority; the slot and its mapped implementation, consumer docs, tests, and rendered evidence have not shipped yet.                                                |
-| Review checks           | Reject a plain-text default, a second summary API, custom content that changes naming or collapse state, reachable interactive descendants inside the visual summary, or any regression to the no-slot and no-count paths.  |
-| Governing rules         | `component:ChatComposerDrawer/FR1–FR10, AR1–AR4, DEC-1–DEC-2`; `architecture:public-component-api/INV3–INV4, INV9, INV13`; `spec:AST-002/DEC-1, DEC-2`.                                                                     |
-
-This table is a review projection; the body below is authoritative.
-
-## Intent
-
-ChatComposerDrawer composes supplementary content above ChatComposer input. When
-`count` is present, builders may let people collapse that content while keeping a
-compact summary available.
-
-Two otherwise identical drawers may need different visual hierarchy in the
-collapsed state. The product builder knows whether the established count Badge or
-a quieter, product-specific summary fits that context, and ChatComposerDrawer
-cannot derive that distinction from count, content, layout, locale, or collapse
-state. The component therefore exposes one visual composition seam while retaining
-its existing default and owning all disclosure behavior.
-
-## Compatibility and migration
-
-- Released default preserved: yes. Omitting `collapsedSummary` keeps the neutral
-  count Badge followed by the resolved label.
-- Compatibility class: additive optional composition slot with no default change.
-- Controlled/uncontrolled behavior: unchanged.
-- Migration decision: none. Existing callsites require no edits.
-
-Consumer migration instructions belong in consumer docs and release notes.
-
-## Ownership boundary
-
-**Owns**
-
-- The drawer surface, optional disclosure state, disclosure association, and
-  availability of collapsed descendants.
-- Controlled and uncontrolled collapse requests.
-- The Badge-preserving default summary and the presentation-only boundary for one
-  caller-composed collapsed summary.
-- The disclosure's localized accessible name, independently of visual summary
-  content.
-
-**Does not own / non-goals**
-
-- The meaning, styling, or localization of caller-provided drawer children or custom
-  summary content.
-- Interactive behavior inside the custom summary; the summary is visual-only and
-  never creates another focus or activation target.
-- ChatComposer input, submission, status, and action behavior.
-- A presentation enum, Badge toggle, render callback, summary-specific theme target,
-  or a second accessible-name prop.
-
-## Public concepts
-
-| Concept           | Closed values or states          | Meaning                                                                                     | Availability by state               | Default                  | Owner                          | Stability           | Invalid-value behavior                                             |
-| ----------------- | -------------------------------- | ------------------------------------------------------------------------------------------- | ----------------------------------- | ------------------------ | ------------------------------ | ------------------- | ------------------------------------------------------------------ |
-| drawer content    | any React node                   | Supplementary content composed above the chat input.                                        | always                              | none                     | `component:ChatComposerDrawer` | stable              | Missing content is rejected by the required type.                  |
-| collapse support  | unavailable, expanded, collapsed | Presence of `count`, including zero, enables one disclosure and supplies its summary count. | unavailable when `count` is omitted | unavailable              | `component:ChatComposerDrawer` | stable              | Collapse inputs have no visible effect without `count`.            |
-| collapse control  | uncontrolled, controlled         | Internal state or `isCollapsed` determines the current disclosure state.                    | when collapse support is available  | uncontrolled             | `component:ChatComposerDrawer` | stable              | Controlled state wins over the initial default.                    |
-| collapsed summary | default, caller-composed         | Visual content shown for the collapsed disclosure.                                          | when collapse support is available  | neutral Badge plus label | caller choice; component seam  | accepted, unshipped | Omission uses the default; without `count`, no summary is exposed. |
-| collapse request  | next state                       | Activation asks for the opposite effective collapsed state.                                 | when collapse support is available  | none                     | `component:ChatComposerDrawer` | stable              | No request is emitted without a disclosure.                        |
-
-`collapsedSummary` is the camelCase public API projection of the canonical
-**Collapsed summary** anatomy part. It is the complete custom visual summary, not
-an addition before or after the default. The component does not parse, clone,
-decorate, or supply data to the node. Builders already own the values they pass as
-`count` and `label`; when a custom summary forms a sentence or formats a number,
-its callsite owns the complete localized message.
-
-## Behavioral and layout contract
-
-| ID   | Invariant                                                                                                                                                                                                                                                                                                                         | Basis                                                                                |
-| ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
-| FR1  | When `count` is present, including when it is `0`, the component MUST expose one named disclosure control with `aria-expanded` and a resolvable `aria-controls` relationship.                                                                                                                                                     | released API and implementation; WAI-ARIA disclosure semantics                       |
-| FR2  | Pointer activation, Enter, and Space MUST request the opposite effective collapsed state exactly once.                                                                                                                                                                                                                            | released implementation and public callback contract                                 |
-| FR3  | In controlled mode, `isCollapsed` MUST remain authoritative; in uncontrolled mode, activation MUST update internal state before the next render.                                                                                                                                                                                  | released implementation and consumer docs                                            |
-| FR4  | Collapsed drawer content MAY remain mounted for the grid transition, but its descendants MUST be absent from keyboard and assistive-technology navigation.                                                                                                                                                                        | WAI-ARIA disclosure semantics; WCAG 2.4.3 and 2.4.7                                  |
-| FR5  | Keyboard focus on the disclosure MUST remain visibly perceivable through the shared focus-indicator mechanism.                                                                                                                                                                                                                    | `architecture:interaction-modality/INV1–INV4`                                        |
-| FR6  | Omitting `count` MUST render drawer content directly, MUST NOT create a disclosure control, and MUST NOT expose `collapsedSummary`. Existing collapse inputs continue to have no visible effect in this state.                                                                                                                    | released no-count behavior and compatibility                                         |
-| FR7  | The root MUST continue forwarding its ref, BaseProps attributes, and styling seams without moving them to an internal child.                                                                                                                                                                                                      | released public surface and `architecture:public-component-api/INV5–INV6, INV8–INV9` |
-| FR8  | `collapsedSummary` MUST remain the camelCase public name of the canonical **Collapsed summary** anatomy part. When omitted, the collapsed disclosure MUST preserve the existing neutral Badge containing `count`, followed by the resolved `label`; when provided, the node MUST replace that complete anatomy part exactly once. | approved anatomy-aligned caller-composition boundary and released default            |
-| FR9  | The custom summary MUST affect visual content only. It MUST NOT change whether collapse is available, effective collapse state, toggle activation, callback values, the controlled region, or the component-owned accessible name.                                                                                                | constrained slot contract and `spec:AST-002/DEC-2`                                   |
-| FR10 | The summary subtree MUST remain presentation-only: the disclosure is the sole focus and activation target, summary descendants MUST be absent from the tab order and accessibility tree, and custom content MUST NOT add another action.                                                                                          | WAI-ARIA disclosure semantics and component-owned accessibility boundary             |
-
-### Allowed variation
-
-- **AV1 — Drawer child composition.** Builders choose the drawer content and its own
-  semantics.
-- **AV2 — Custom summary composition.** Builders may compose any visual content that
-  fits the presentation-only boundary, including localized text or existing Astryx
-  display components.
-- **AV3 — Summary lifecycle.** The component may keep the default or custom summary
-  mounted while visually expanded to preserve animation. Callers MUST NOT depend on
-  mount or unmount timing.
-- **AV4 — Custom summary styling.** Caller-composed content retains the styling and
-  theme seams of the components it uses. ChatComposerDrawer adds no summary-specific
-  target.
-
-### Representative states
-
-| State                            | Required invariant                                                                                                      | Allowed variation                                 |
-| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
-| `count` omitted                  | Content is visible; no disclosure or summary is exposed.                                                                | Child content and root styling.                   |
-| default summary, collapsed       | One disclosure shows the neutral count Badge plus resolved label.                                                       | Count value and localized label.                  |
-| custom summary, collapsed        | One disclosure shows the caller node instead of both default summary parts.                                             | Presentation-only custom content and styling.     |
-| custom summary, expanded         | The disclosure retains its state and name; the custom summary may stay mounted but is visually and semantically hidden. | Internal crossfade and mount timing.              |
-| controlled expanded or collapsed | Rendered state follows `isCollapsed`; activation reports the requested next state.                                      | Parent timing and whether it accepts the request. |
-
-### Transformation and precedence order
-
-- **ORD1 — Collapse availability.** `count` present → disclosure enabled; `count`
-  omitted → no disclosure or collapsed summary.
-- **ORD2 — Effective state.** `isCollapsed` when defined → otherwise internal state
-  initialized from `defaultIsCollapsed`.
-- **ORD3 — Visual summary.** Caller-provided `collapsedSummary` → otherwise the
-  neutral Badge for `count` followed by the resolved `label`.
-- **ORD4 — Accessible name.** Resolve `label` from the prop or locale catalog → use
-  the catalog's expand or collapse action message for the effective state. Visual
-  summary content never enters or overrides this pipeline.
-
-### Performance and resources
-
-- **PR1 — Local state only.** The summary seam MUST NOT require an Effect, observer,
-  listener, timer, or external resource.
-
-## Accessibility contract
-
-- **AR1 — Disclosure relationship.** The toggle exposes one localized name, expanded
-  state, and a resolvable controlled-content ID.
-- **AR2 — Naming stays component-owned.** `label` identifies the controlled drawer
-  content in the expand/collapse catalog message. Default or custom visual summary
-  text MUST NOT replace, duplicate, or concatenate into that accessible name.
-- **AR3 — Hidden content is unavailable.** Visually collapsed drawer descendants are
-  unavailable until expansion.
-- **AR4 — Custom summary remains presentation-only.** Custom content cannot add a
-  second focus stop, activation target, role, or announcement inside the disclosure.
-
-## Design relationships
-
-No current design specification governs this component-local representation.
-
-| Anatomy or state  | Design requirement                                                                   | Representation authority                         | Hierarchy role | Component contract |
-| ----------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------ | -------------- | ------------------ |
-| root surface      | Existing released surface remains unchanged by this decision.                        | released behavior                                | supporting     | FR7                |
-| disclosure toggle | One operable, named control owns collapse interaction.                               | component-owned                                  | supporting     | FR1–FR5, AR1       |
-| collapsed summary | Badge hierarchy remains the default; callers may choose one visual composition slot. | component default or caller-selected composition | supporting     | FR8–FR10, AR2–AR4  |
-| content area      | Collapsed descendants remain unavailable to keyboard and assistive technology.       | component-owned                                  | supporting     | FR4, FR6, AR3      |
-
-The existing `chat-composer-drawer` target remains on the painted root. The
-Badge-preserving default delegates count paint to Badge. Caller-composed summary
-content retains the theme ownership of the components it supplies. This decision
-adds no ChatComposerDrawer summary target and does not make arbitrary slot internals
-part of ChatComposerDrawer's theming API.
-
-## Family and system relationships
-
-- `architecture:public-component-api` owns reachability, naming grammar, and
-  compatibility of the additive slot; this component owns its local meaning and
-  default.
-- `architecture:interaction-modality` owns shared focus-visibility mechanics; this
-  component owns the disclosure as its semantic focus owner.
-- `architecture:component-theming-surface` owns target and anatomy mapping rules; the
-  custom summary does not create a new target or transfer ownership of caller
-  content.
-- `architecture:knowledge-contracts` limits this current authority to the explicit
-  claims in this record.
-- `spec:AST-002/DEC-1` admits the slot because otherwise-identical drawers may need
-  a caller-owned visual hierarchy the component cannot derive. `DEC-2` requires the
-  seam to preserve a dependable, accessibility-safe outcome.
-
-## Verification map
-
-| Contract                 | Verification                                                            | Representative states                                                      | Mutation or failure expectation                                                                                                    | Audit section                            |
-| ------------------------ | ----------------------------------------------------------------------- | -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- |
-| FR1–FR3, FR6, ORD1–2     | focused ChatComposerDrawer state and keyboard tests                     | no count; zero count; controlled; uncontrolled; pointer; Enter; Space      | Presence/truthiness changes collapse availability, state authority changes, or callback reports the wrong next state.              | `audit:ChatComposerDrawer/behavior`      |
-| FR8–FR9, ORD3            | focused default/custom summary tests and consumer-doc projection checks | default; custom node; expanded; collapsed; no count                        | The default Badge disappears, default and custom content render together, custom content changes behavior, or no-count exposes it. | `audit:ChatComposerDrawer/api`           |
-| FR4, FR10, AR2–AR4       | focused inert-state and custom-descendant tests plus exact-head a11y CI | default text; custom text; custom focusable descendant; collapsed/expanded | Hidden drawer content or custom summary becomes focusable, announced, or a second action; visual text replaces the catalog name.   | `audit:ChatComposerDrawer/accessibility` |
-| FR5, AR1                 | `KeyboardFocus` Storybook play and exact-head visual/a11y gates         | keyboard focus in representative light and dark themes                     | Focus has no shared visible indicator or the disclosure relationship/name breaks.                                                  | `audit:ChatComposerDrawer/accessibility` |
-| FR7                      | focused DOM/type tests and package checks                               | ref, BaseProps, xstyle, className, style                                   | Root ownership or a styling seam moves or disappears.                                                                              | `audit:ChatComposerDrawer/api`           |
-| AV4 and theming boundary | source/runtime theme inspection of default and custom summaries         | default Badge; caller-composed Astryx content                              | A new summary target appears, Badge loses its target, or caller-owned content is retargeted as ChatComposerDrawer anatomy.         | `audit:ChatComposerDrawer/theming`       |
-
-## Decision log
-
-### DEC-1 — One visual slot preserves the Badge default
-
-**Reference:** `component:ChatComposerDrawer/DEC-1`
-**Decider:** `cixzhang`, `2026-09-21`
-
-ChatComposerDrawer admits one optional `collapsedSummary` node for the complete
-visual summary. Product builders own whether a particular collapsed row needs the
-established Badge hierarchy or a quieter localized composition, and the component
-cannot derive that visual hierarchy. Omitting the slot preserves the existing
-neutral Badge plus label, so no current builder receives a new choice or migration.
-
-Rejected: replacing the default with a `{count} {label}` sentence, adding a Badge
-boolean or finite presentation enum, adding a render callback for values already
-owned by the caller, or exposing parallel summary seams. Those shapes either break
-the released default, encode presentation machinery, invite locale-unsafe string
-concatenation, or add more API than the caller-owned distinction requires.
-
-### DEC-2 — Visual composition does not own disclosure semantics
-
-**Reference:** `component:ChatComposerDrawer/DEC-2`
-**Decider:** `cixzhang`, `2026-09-21`
-
-The custom summary is presentation-only. The existing `label` and locale catalog
-continue to name the expand/collapse action; `count` continues to enable the
-disclosure; and the component keeps summary descendants out of focus, activation,
-and assistive-technology navigation. The seam cannot replace these obligations.
-
-Rejected: deriving the accessible name from arbitrary summary content or letting a
-custom summary introduce another action inside the disclosure. Both make correct
-semantics depend on caller markup the component cannot verify.
-
-## Open questions
-
-None for this contract slice.
-
-## Content boundary
-
-This file owns ChatComposerDrawer's collapsed-summary composition boundary,
-Badge-preserving default, collapse gating and state behavior, accessible naming,
-compatibility, and required evidence. It does not duplicate the complete consumer
-prop reference, implementation steps, current audit score, or unrelated component
-gaps. Current authority is claim-scoped to the explicit requirements above and does
-not certify every ChatComposerDrawer behavior.