@astryxdesign/core 0.7.6-canary.fdabeba → 0.7.6

package/src/Chat/ChatSendButton.spec.md

@@ -1,238 +0,0 @@
----
-schema_version: 3
-template_version: 7
-kind: component
-id: component:ChatSendButton
-authority: current
-archive_reason: null
-superseded_by: null
-approved_by: cixzhang
-approved_at: 2026-10-31
-owners: [cixzhang]
-review_triggers: [public-api, behavior, theming, accessibility, testing]
-verified_by:
-  [
-    packages/core/src/Chat/ChatSendButton.test.tsx,
-    packages/core/src/Chat/__tests__/ChatSendButton.a11y.chromium.spec.ts,
-    packages/core/src/theme/themingTargets.test.ts,
-    apps/storybook/stories/ChatComposer.stories.tsx,
-    apps/storybook/stories/ChatSendButtonAudit.stories.tsx,
-    apps/storybook/rtl-audit/verified-not-applicable.json,
-  ]
-modules: []
-families: []
-design_specs: []
-architecture:
-  [
-    architecture:public-component-api,
-    architecture:icon-resolution-and-component-slots,
-    architecture:component-theming-surface,
-    architecture:interaction-modality,
-    architecture:component-test-sufficiency,
-    architecture:knowledge-contracts,
-  ]
-contributing: []
-system_specs: [spec:AST-002, spec:AST-020, spec:AST-029, spec:AST-032]
----
-
-# ChatSendButton component contract
-
-## Contract at a glance
-
-| Area                    | Contract                                                                                                                                                                                                                                |
-| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Public contract         | The exported control selects send or stop presentation from props over ChatComposer context, accepts `sm` or `md`, supports icon overrides, and extends the rendered Button with supported Button DOM, event, styling, and ref inputs.  |
-| Behavior                | Send is disabled from explicit or composer readiness, stop remains enabled, state-specific actions run before a composed generic click handler, and current send artwork resolves from an explicit override before the shared fallback. |
-| End-user impact         | People receive a translated, state-appropriate send or stop action whose availability follows composer readiness.                                                                                                                       |
-| Builder impact          | None.                                                                                                                                                                                                                                   |
-| Compatibility/readiness | Records shipped behavior; no public change. One implementation gap, listed under Current-state impact.                                                                                                                                  |
-| Review checks           | Reject lost send/stop routing, consumer events that replace the state action, a disabled stop action, unlabelled icon-only output, dropped root inputs, or a lost explicit-first send icon or `arrowUp` fallback.                       |
-| Governing rules         | `spec:AST-032` FR2–FR3; `architecture:public-component-api` INV5–INV8; `architecture:interaction-modality`; `architecture:component-test-sufficiency`; `spec:AST-020`; `spec:AST-029`.                                                  |
-
-This table is a review projection; the body below is authoritative.
-
-## Intent
-
-ChatSendButton is the compact action control used by ChatComposer. It translates
-composer readiness and streaming state into a shared Button while keeping action,
-icon, styling, and ref seams available for standalone composition.
-
-## Compatibility and migration
-
-- Released default preserved: `yes`
-- Compatibility class: records shipped behavior; no public change
-- Controlled/uncontrolled behavior: not applicable; explicit props take
-  precedence over context-derived values
-- Migration decision: none
-
-Consumer migration instructions belong in consumer docs and release notes.
-
-## Current-state impact
-
-- **The send icon has no component-slot stage.** Send artwork resolves from
-  `sendIcon`, then the shared `arrowUp`. `spec:AST-032` FR2–FR3 put a
-  component-icon slot stage in that resolution; ChatSendButton does not offer
-  it yet (FR3).
-
-## Ownership boundary
-
-**Owns**
-
-- Selection of the send or stop state.
-- State-specific translated accessible names and Button variants.
-- Composer-context fallback for readiness and actions.
-- Send and stop icon selection at the component seam.
-- Composition of the state action with an accepted generic click handler.
-- The `chat-send-button` theme target and circular root treatment.
-
-**Does not own / non-goals**
-
-- ChatComposer value editing, submission lifecycle, streaming lifecycle, or placement.
-- Shared Button activation, focus, disabled semantics, hit area, or base styling.
-- Shared icon artwork or theme icon registration.
-- A public policy for whether `isStopShown` may appear without a stop action.
-
-## Public concepts
-
-Consumer syntax remains in `ChatSendButton.doc.mjs`. This inventory closes the
-observable semantic surface without duplicating the prop table.
-
-| Concept      | Closed values or states                                        | Meaning                                                                                | Availability by variant/orientation/state | Default                                                     | Owner                               | Stability | Invalid-value behavior                                                                      |
-| ------------ | -------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------- | ----------------------------------------------------------- | ----------------------------------- | --------- | ------------------------------------------------------------------------------------------- |
-| Action state | send; stop                                                     | Selects the name, Button variant, icon role, disabled rule, and state action.          | Every render.                             | Composer `isStopShown`, otherwise send.                     | `component:ChatSendButton`          | Stable    | Values outside the boolean prop type are unsupported.                                       |
-| Availability | enabled; disabled                                              | Prevents send activation when content is not ready. Stop intentionally ignores it.     | Disabled applies only to send.            | Explicit `isDisabled`, otherwise inverse composer canSend.  | component and ChatComposer context  | Stable    | Values outside the boolean prop type are unsupported.                                       |
-| Action       | state callback; composer fallback; composed generic click      | Runs the state action and then an accepted consumer click handler.                     | Enabled send and stop activation.         | `onSend` or submit current value; `onStop` or context stop. | component, context, and caller      | Stable    | With no state callback or matching context action, only a supplied generic click can run.   |
-| Send icon    | explicit content; shared fallback                              | Selects artwork for the send state.                                                    | Send state.                               | `sendIcon`, then shared `arrowUp`.                          | component and caller                | Stable    | Unsupported React content follows the shared Button rendering boundary.                     |
-| Stop icon    | explicit content; shared fallback                              | Selects artwork for the stop state.                                                    | Stop state.                               | `stopIcon`, then shared `stop`.                             | component and caller                | Stable    | Unsupported React content follows the shared Button rendering boundary.                     |
-| Size         | `sm`; `md`                                                     | Selects the delegated Button size while preserving circular treatment.                 | Both states.                              | `md`.                                                       | `component:ChatSendButton`          | Stable    | Values outside the public union are rejected by TypeScript.                                 |
-| Root surface | ref; supported Button DOM/data/ARIA/events; style/class/xstyle | Extends and styles the rendered Button without replacing component-owned action logic. | Every render.                             | Omitted.                                                    | `architecture:public-component-api` | Stable    | Unsupported BaseProps omissions remain unsupported; owned semantics win accidental clashes. |
-
-## Behavioral and layout contract
-
-| ID  | Invariant                                                                                                                                                                                                         | Basis                                                                                    |
-| --- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
-| FR1 | The send state MUST render a primary icon-only Button named by the send translation, and it MUST be disabled when explicit or context-derived readiness is false.                                                 | Current implementation, docs, tests, `spec:AST-020`, and shared Button behavior          |
-| FR2 | The stop state MUST render a secondary icon-only Button named by the stop translation, remain enabled regardless of send readiness, and invoke explicit or context stop behavior.                                 | Current implementation, docs, and tests                                                  |
-| FR3 | Send icon resolution prefers `sendIcon` and otherwise resolves the shared `arrowUp`. Implementation gap: the component-icon slot stage `spec:AST-032` FR2–FR3 require is not offered (Current-state impact).      | Current implementation, docs, tests, and current owner requirement in `spec:AST-032`     |
-| FR4 | Stop icon resolution prefers `stopIcon` and otherwise resolves the shared `stop` icon.                                                                                                                            | Current implementation, docs, and tests                                                  |
-| FR5 | Explicit state, disabled, callback, icon, and size props MUST win over their context or component fallback. A generic accepted click handler MUST compose after the selected state action rather than replace it. | Current source and tests; `architecture:public-component-api` INV5–INV7                  |
-| FR6 | Supported Button DOM, data, ARIA, className, style, xstyle, and ref inputs MUST reach or compose on the rendered Button while component-owned label, state, and activation behavior remain intact.                | Current implementation plus `architecture:public-component-api/INV5-INV8`                |
-| FR7 | The component MUST paint through the shared Button on the co-located `chat-send-button` target and preserve its circular component treatment.                                                                     | Current implementation, Chat consumer docs, and `architecture:component-theming-surface` |
-
-### Allowed variation
-
-- **AV1 — Context or standalone composition.** A builder may rely on ChatComposer
-  context or provide all state, action, and disabled values explicitly.
-- **AV2 — Artwork.** Explicit send and stop content and shared fallback artwork may
-  vary within the icon resolution FR3 and FR4 state.
-- **AV3 — Consumer styling.** Supported styling inputs may extend the Button while
-  component-owned state and activation behavior remain.
-
-### Representative states
-
-| State                  | Required invariant                                                                  | Allowed variation                               |
-| ---------------------- | ----------------------------------------------------------------------------------- | ----------------------------------------------- |
-| Send, disabled         | Primary translated send action is unavailable and does not run callbacks.           | Icon source, size, theme, and consumer styling. |
-| Send, enabled          | Primary translated send action runs explicit or context submission.                 | Icon source, size, theme, and consumer styling. |
-| Stop                   | Secondary translated stop action remains enabled and runs explicit or context stop. | Icon source, size, theme, and consumer styling. |
-| Explicit override      | Explicit state, callback, icon, disabled value, and size win their fallback seams.  | Context may still supply unspecified values.    |
-| Composed generic click | State action and accepted generic click both run without one replacing the other.   | Either handler may be absent.                   |
-
-### Transformation and precedence order
-
-- **ORD1 — Resolve state.** Explicit `isStopShown` wins, then composer context,
-  then the send state.
-- **ORD2 — Resolve action.** Explicit state callback wins its composer fallback.
-  The selected state action runs before the accepted generic click handler because
-  this component does not promise consumer cancellation of its state action.
-- **ORD3 — Resolve availability.** Stop remains enabled. Send uses explicit
-  `isDisabled`, then inverse composer readiness, then disabled outside context.
-- **ORD4 — Resolve artwork.** In send, explicit `sendIcon` wins, then shared
-  `arrowUp`; in stop, explicit `stopIcon` wins, then shared `stop`. The
-  component-icon slot stage `spec:AST-032` FR2 requires is not offered yet
-  (FR3).
-- **ORD5 — Compose root.** Apply component-owned Button semantics and the
-  `chat-send-button` target while preserving supported consumer root inputs.
-
-### Performance and resources
-
-- **PR1 — Render-only projection.** The component adds no Effect, observer,
-  listener, timer, state mirror, or owned async lifecycle.
-
-## Accessibility contract
-
-- **AR1 — Native action semantics.** The delegated Button MUST own native button
-  activation, keyboard behavior, focus indication, and disabled semantics.
-- **AR2 — State-appropriate name.** The icon-only control MUST expose the current
-  translated send or stop label independently of icon artwork.
-- **AR3 — Disabled send behavior.** A disabled send action MUST not invoke either
-  the state action or a consumer click handler.
-- **AR4 — Modality parity.** Pointer and keyboard activation MUST traverse the same
-  state-action and composed-event path.
-
-## Design relationships
-
-| Anatomy or state | Design requirement                                                | Representation authority                                     | Hierarchy role           | Component contract |
-| ---------------- | ----------------------------------------------------------------- | ------------------------------------------------------------ | ------------------------ | ------------------ |
-| Action button    | Circular compact Button carrying the current send or stop action. | Current source and consumer docs; exact tuning stays in code | Primary/secondary action | FR1, FR2, FR7      |
-| Send artwork     | Upward send glyph unless explicit content wins (FR3's gap).       | Current source and docs; `spec:AST-032` FR2–FR3              | Action cue               | FR3                |
-| Stop artwork     | Shared stop glyph unless explicit content wins.                   | Current source and consumer docs                             | Action cue               | FR4                |
-
-This record selects no new dimensions, variants, icon artwork, color roles, or
-visual prominence. No anatomy-theming map is recorded yet; the block is
-optional during migration, so the map is deferred.
-
-The Chat family consumer doc catalogs `chat-send-button`. Button owns the
-underlying painting and interaction-state styling; the component target is
-co-located on that painting element.
-
-## Family and system relationships
-
-- ChatComposer owns value, readiness, submission, stop lifecycle, and placement.
-- Button owns shared activation, focus, disabled semantics, hit area, and paint.
-- `architecture:public-component-api` owns BaseProps reachability, style/ref
-  composition, and deliberate event composition.
-- `architecture:icon-resolution-and-component-slots` owns the shared slot model;
-  `spec:AST-032` FR2–FR3 put a component-slot stage in send resolution, which is
-  not shipped (Current-state impact).
-- `architecture:component-theming-surface` owns the qualification and placement
-  of the co-located `chat-send-button` target.
-- `architecture:interaction-modality` and `spec:AST-020` own pointer, keyboard,
-  focus, and accessibility parity inherited through Button.
-- `architecture:component-test-sufficiency` owns public-seam regression coverage.
-- `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, FR2, AR1-AR4         | `ChatSendButton.test.tsx`, `ChatSendButton.a11y.chromium.spec.ts`, and `ChatComposer.test.tsx`                       | Enabled/disabled send, stop with and without handler, context stop, keyboard/pointer, light/dark interaction states      | Label, disabled, native activation, state routing, or interaction paint drift fails focused or exact-head browser evidence.                      | `audit:ChatSendButton/accessibility` |
-| FR3                       | `ChatSendButton.test.tsx`                                                                                            | Explicit and shared-fallback send icon                                                                                   | Losing explicit-first precedence or the `arrowUp` fallback fails focused tests; the `spec:AST-032` slot stage is not tested here.                | `audit:ChatSendButton/theming`       |
-| FR4                       | `ChatSendButton.test.tsx`                                                                                            | Explicit and fallback stop icon                                                                                          | Losing explicit precedence or registry resolution fails focused assertions.                                                                      | `audit:ChatSendButton/behavior`      |
-| FR5, FR6                  | `ChatSendButton.test.tsx` callback composition, ordering, size, root passthrough, disabled-click, and keyboard tests | Send, stop, `sm`/`md`, ref/class/data/ARIA, Enter/Space                                                                  | Consumer events replacing state actions, cancellation reordering, lost root inputs, or modality drift fails focused tests.                       | `audit:ChatSendButton/api`           |
-| FR7                       | `themingTargets.test.ts` and `ChatSendButton.a11y.chromium.spec.ts`                                                  | Send and stop themes                                                                                                     | Target removal, movement off paint, or undocumented target drift fails tests or browser evidence.                                                | `audit:ChatSendButton/theming`       |
-| RTL relation              | RTL shared-fixture route plus refreshed verified-N/A source receipts for ChatSendButton and ChatComposer             | Send and stop                                                                                                            | Directional artwork, physical positioning, or transform invalidates the checked-in receipts.                                                     | `audit:ChatSendButton/i18n-rtl`      |
-| Browser matrix            | `ChatSendButton.a11y.chromium.spec.ts` browser states                                                                | Light/dark send and stop rest/hover/focus/press, disabled rest/hover, `sm`/`md`, 320px coarse pointer, D7 contrast pairs | A stale build, decoy selector, missing state, changed disabled paint, absent interaction pixels, failed contrast, or geometry miss fails closed. | `audit:ChatSendButton/visual`        |
-| Documentation and surface | Consumer docs, export checks, Storybook, and `check:knowledge`                                                       | Props, public subpath, states, contract                                                                                  | Missing or stale docs, exports, relationships, or required structure fails validation.                                                           | `audit:ChatSendButton/docs`          |
-
-Read from source, with no focused test yet:
-
-- FR5: explicit props winning over ChatComposer context.
-- FR6: `style` and `xstyle` reaching the root.
-
-## Decision log
-
-No component-local decision is recorded.
-
-## Open questions
-
-- **Cross-reference: stop without handler.** `component:ChatComposer/OQ4` owns
-  the unresolved policy for a visible stop action without an explicit or context
-  `onStop`. This record covers today's enabled no-op branch without
-  duplicating that question.
-
-## Content boundary
-
-This file does not duplicate consumer examples, audit scores, screenshots,
-eligibility data, or shared Button and icon-system rules. It links to their owners.

package/src/Chat/ChatSystemMessage.spec.md

@@ -1,224 +0,0 @@
----
-schema_version: 3
-template_version: 6
-kind: component
-id: component:ChatSystemMessage
-authority: draft
-archive_reason: null
-superseded_by: null
-approved_by: null
-approved_at: null
-owners: [cixzhang]
-review_triggers: [public-api, behavior, layout, theming, accessibility, testing]
-verified_by:
-  [
-    packages/core/src/Chat/ChatSystemMessage.test.tsx,
-    packages/core/src/Chat/__tests__/ChatSystemMessage.a11y.chromium.spec.ts,
-    packages/core/src/theme/themingTargets.test.ts,
-    apps/storybook/stories/ChatSystemMessageAudit.stories.tsx,
-    apps/storybook/rtl-audit/verified-not-applicable.json,
-  ]
-modules: []
-families: []
-design_specs: []
-architecture:
-  [
-    architecture:public-component-api,
-    architecture:component-theming-surface,
-    architecture:component-test-sufficiency,
-    architecture:react-component-runtime,
-    architecture:theme-tokens,
-    architecture:knowledge-contracts,
-  ]
-contributing: []
-system_specs: [spec:AST-002, spec:AST-009, spec:AST-020, spec:AST-029]
----
-
-# ChatSystemMessage component contract
-
-## Contract at a glance
-
-| Area                    | Contract                                                                                                                                                                                                                                                                                          |
-| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Public contract         | The exported noninteractive chat row accepts required content, `default` or `divider` presentation, optional icon content, and supported root DOM, styling, and ref inputs.                                                                                                                       |
-| Behavior                | The default branch centers and wraps content with optional icon content in a status region. The divider branch delegates its labelled separator to Divider and currently does not render the `icon` input.                                                                                        |
-| End-user impact         | People can distinguish factual chat notices from sender messages and can identify temporal or section breaks through a labelled separator.                                                                                                                                                        |
-| Builder impact          | Builders choose between a plain status row and a labelled divider and provide self-contained content. No new caller choice is introduced by this observational record.                                                                                                                            |
-| Compatibility/readiness | This draft records the wrapping correction plus released observable behavior. The unresolved divider/icon combination remains unchanged and requires an owner decision before its behavior changes.                                                                                               |
-| Review checks           | Reject lost status or separator semantics, dropped supported root inputs, target/anatomy drift, or claims that the unresolved divider/icon combination has been settled.                                                                                                                          |
-| Governing rules         | `architecture:public-component-api/INV3`, `architecture:public-component-api/INV5`, `architecture:public-component-api/INV9`; `spec:AST-002/FR15`; `architecture:component-theming-surface/INV3-INV6`; `architecture:component-test-sufficiency`; `spec:AST-009`; `spec:AST-020`; `spec:AST-029`. |
-
-This table is a review projection. The draft body below records checkable current
-behavior and does not create product policy.
-
-## Intent
-
-ChatSystemMessage presents concise non-sender content inside a chat transcript. It
-separates system-originated notices from sender messages and delegates labelled date
-or section separators to Divider.
-
-## Compatibility and migration
-
-- Released default preserved: yes; the default branch now allows long content to wrap within its container.
-- Compatibility class: additive layout correction, observational documentation, and evidence.
-- Controlled/uncontrolled behavior: not applicable; the component owns no state.
-- Migration decision: none for wrapping. Any divider/icon type restriction would require an explicit compatibility decision under `architecture:public-component-api/INV9`.
-
-Consumer migration instructions belong in consumer docs and release notes.
-
-## Ownership boundary
-
-**Owns**
-
-- The non-sender status row and its `chat-system-message` target.
-- Selection between the default centered row and the delegated divider composition.
-- Wrapping default-variant content within the available inline space while keeping icon artwork from shrinking.
-- Root DOM, styling, and ref composition.
-
-**Does not own / non-goals**
-
-- Sender identity, avatar, bubble, transcript ordering, or scrolling.
-- Divider rule paint, label placement, separator role, or separator naming, which are delegated to `component:Divider`.
-- Long Divider-label overflow and forced-colors rule paint, which remain shared `component:Divider` advisories rather than ChatSystemMessage-owned defects.
-- Divider's skipped-label rendering. Empty strings and empty Fragments leave the separator without a visible label or accessible name; numeric zero renders one visible `0` and names the separator `0`. These partitions remain owned by `component:Divider`.
-- The semantic or directional meaning of caller-provided content or icon artwork.
-- Announcement timing or spoken output; claims at that layer require `spec:AST-009` evidence.
-
-## Public concepts
-
-Consumer syntax remains in `ChatSystemMessage.doc.mjs`. This table closes the
-observable public surface without deciding the unresolved divider/icon contract.
-
-| Concept          | Closed values or states                                  | Meaning                                                                     | Availability by variant/orientation/state             | Default   | Owner                               | Stability                  | Invalid-value behavior                              |
-| ---------------- | -------------------------------------------------------- | --------------------------------------------------------------------------- | ----------------------------------------------------- | --------- | ----------------------------------- | -------------------------- | --------------------------------------------------- |
-| Presentation     | `default`; `divider`                                     | Selects a centered status row or a labelled horizontal Divider composition. | Every render.                                         | `default` | `component:ChatSystemMessage`       | Observed released surface  | Values outside the public union are rejected by TS. |
-| Content          | caller-provided `ReactNode`                              | Supplies the visible status or separator label.                             | Both variants.                                        | Required  | caller and component                | Observed released surface  | Missing content is rejected by TS.                  |
-| Icon content     | omitted; caller-provided `ReactNode`                     | Supplies optional caller-owned icon content associated with the message.    | Rendered by default and currently ignored by divider. | Omitted   | caller and component                | Unsettled released surface | Divider currently ignores the input; see OQ1.       |
-| Root surface     | ref; supported DOM/data/ARIA/events; class/style/xstyle  | Extends the component-owned root without replacing its owned role or state. | Both variants.                                        | Omitted   | `architecture:public-component-api` | Observed released surface  | Unsupported BaseProps omissions stay unsupported.   |
-| Status semantics | persistent `role="status"`; delegated labelled separator | Exposes the row as status content and the divider child as a separator.     | Status on both; separator on divider.                 | Fixed     | component and `component:Divider`   | Observed released surface  | Consumer role input does not replace owned role.    |
-
-## Behavioral and layout contract
-
-| ID  | Candidate invariant                                                                                                                                                                                  | Basis                                                                                                       | Draft review state                                      |
-| --- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
-| FR1 | The default branch MUST render the required content in a centered, noninteractive status row, allow long content to wrap within the available inline space, and preserve optional icon geometry.     | Current source, released docs, tests, and examples                                                          | Verified current behavior                               |
-| FR2 | The divider branch MUST render renderable content through Divider as a labelled horizontal separator inside the component's status root. Skipped content follows Divider's delegated label contract. | Current source, released docs, Divider implementation, tests, and examples                                  | Verified current behavior; delegated Divider partitions |
-| FR3 | The divider branch currently ignores `icon`; this draft MUST NOT convert that observation into a stable restriction, a requirement to render the icon, or a warning policy.                          | `architecture:public-component-api/INV3`, `architecture:public-component-api/INV5`, and `spec:AST-002/FR15` | Human API decision required; see OQ1                    |
-| FR4 | Supported root DOM, data, ARIA, className, style, xstyle, and ref inputs MUST reach or compose on the root while component-owned `role="status"` and reflected `variant` remain intact.              | Current source plus `architecture:public-component-api/INV5-INV8`                                           | Verified current behavior and existing focused evidence |
-| FR5 | The component MUST use semantic color, spacing, and typography tokens and logical layout; the `variant` state remains reflected on the single `chat-system-message` target.                          | Current source, `architecture:theme-tokens`, and theming architecture                                       | Verified current behavior                               |
-| FR6 | The component remains render-only: props determine output without Effects, state mirrors, observers, listeners, timers, or owned async resources.                                                    | Current source and `architecture:react-component-runtime/INV1-INV8`                                         | Verified current behavior                               |
-
-### Allowed variation
-
-- **AV1 - Caller content.** Text and other React content may vary while remaining
-  self-contained. Empty strings, numeric zero, and empty Fragments are reachable
-  `ReactNode` partitions. The default variant keeps `role="status"` and renders the
-  content unchanged: empty string and empty Fragment content remain empty, while
-  numeric zero renders one `0`. In the divider variant, the status root and separator
-  remain; empty string and empty Fragment content produce no visible label or
-  accessible name, while numeric zero renders one visible `0` and names the
-  separator `0`. Divider owns those label partitions.
-- **AV2 - Caller styling.** Supported root styling inputs may extend the component
-  without replacing owned status semantics or variant reflection.
-- **AV3 - Delegated Divider paint.** Divider owns its rule and label paint and may
-  evolve within its own contract.
-
-### Representative states
-
-| State                 | Required invariant                                                                                                                                                                                                                       | Allowed variation                           |
-| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- |
-| Default               | Centered status content is present.                                                                                                                                                                                                      | Content, theme, and root styling.           |
-| Default with icon     | Optional icon content and visible content render together.                                                                                                                                                                               | Caller-provided artwork and content.        |
-| Default long content  | Content wraps without crossing either inline edge or creating page overflow.                                                                                                                                                             | Theme and localized content.                |
-| Divider               | A labelled horizontal separator presents the supplied content.                                                                                                                                                                           | Label content, theme, and root styling.     |
-| Divider with icon     | Current output is measured without deciding the ignored-input contract.                                                                                                                                                                  | No behavior change until OQ1 is resolved.   |
-| Empty ReactNode       | The default variant keeps `role="status"` and renders content unchanged (empty or one `0`). In the divider variant, the status root and separator remain; empty content has no label/name, while numeric zero renders and names one `0`. | Empty string, numeric zero, empty Fragment. |
-| Narrow/coarse pointer | The noninteractive row remains visible without horizontal page overflow.                                                                                                                                                                 | Theme and supported content.                |
-
-### Transformation and precedence order
-
-- **ORD1 - Select branch.** `variant="divider"` selects the Divider branch;
-  every other supported value uses the default branch.
-- **ORD2 - Compose root.** Apply component-owned target/state and styles, then
-  compose supported consumer styling and root inputs while retaining the owned
-  status role.
-- **ORD3 - Delegate divider.** Divider owns separator semantics and paint inside
-  the component root.
-
-### Performance and resources
-
-- **PR1 - Render-only projection.** The component adds no Effect, observer,
-  listener, timer, state mirror, or owned asynchronous lifecycle.
-
-## Accessibility contract
-
-- **AR1 - Status exposure.** The root currently exposes `role="status"` for both
-  variants. Browser evidence may prove role exposure; spoken announcement timing is
-  outside this draft and requires `spec:AST-009` evidence.
-- **AR2 - Divider relationship.** Renderable content in the divider branch delegates a
-  horizontal `separator` whose labelled target contains the visible label; focused DOM
-  tests verify the computed accessible name. Skipped content follows Divider's
-  delegated label contract.
-- **AR3 - Caller content.** Visible content remains the self-contained message.
-  Caller-provided icon content does not replace that text.
-- **AR4 - Noninteractive surface.** The component introduces no focus target,
-  keyboard command, pointer action, disabled state, or interactive state machine.
-
-## Design relationships
-
-| Anatomy or state | Design requirement                                                                                 | Representation authority                                     | Hierarchy role | Component contract |
-| ---------------- | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | -------------- | ------------------ |
-| System message   | Centers a concise non-sender row and owns the component target.                                    | Current source and released consumer docs                    | Supporting     | FR1, FR4, FR5      |
-| Content          | Presents the caller's visible message.                                                             | Current source and released consumer docs                    | Prominent      | FR1, FR2, AR3      |
-| Icon content     | Supplies optional caller-owned artwork associated with the message; variant behavior is unsettled. | Current source and released consumer docs; divider unsettled | Supporting     | FR1, FR3, AR3      |
-| Divider          | Delegates labelled separator paint and semantics to Divider.                                       | `component:Divider` observed implementation and docs         | Supporting     | FR2, AR2           |
-
-This observational draft does not choose new spacing, proportions, color roles,
-icon artwork, live-region timing, or divider/icon behavior.
-
-## Family and system relationships
-
-- `component:Divider` owns the delegated separator structure, role, name,
-  paint, long-label overflow, and label partitions. Numeric zero renders as one
-  visible label and names the separator `0`; skipped content remains unlabelled.
-- `architecture:public-component-api` owns released exports, BaseProps reachability,
-  styling composition, and the ref contract.
-- `architecture:component-theming-surface` owns the target/anatomy mapping and
-  variant reflection.
-- `architecture:component-test-sufficiency` owns bounded, mutation-sensitive evidence
-  for applicable promises and established public seams.
-- `architecture:react-component-runtime` owns the render-only lifecycle boundary.
-- `architecture:theme-tokens` owns the semantic token vocabulary.
-- `spec:AST-009` owns any future claim about spoken announcement timing or AT output.
-- `spec:AST-020` owns evidence-layer and accessibility completeness boundaries.
-- `spec:AST-029` owns this observational audit backfill and prevents it from settling
-  new public meaning.
-
-## Verification map
-
-| Contract                  | Verification                                                                                                    | Representative states                                                                                                              | Mutation or failure expectation                                                                                                                         | Audit section                           |
-| ------------------------- | --------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
-| FR1, AR1, AR3             | `ChatSystemMessage.test.tsx`, scoped axe, and exact-head Chromium receipts                                      | Default, default with icon, long content, nested live log, neutral light/dark                                                      | Missing content, status role, icon content, wrapping, or browser-visible subject fails focused or browser evidence.                                     | `audit:ChatSystemMessage/accessibility` |
-| FR2, AR2                  | `ChatSystemMessage.test.tsx`, Divider tests, scoped axe, and exact-head Chromium receipts                       | Labelled divider content plus empty string, numeric zero, and empty Fragment observations                                          | Lost separator role, label association, orientation, content, or paint fails focused or browser evidence; skipped partitions stay delegated to Divider. | `audit:ChatSystemMessage/behavior`      |
-| FR3                       | Closed audit inventory and exact-head observation of the divider/icon partition                                 | Divider with supplied icon                                                                                                         | The audit must expose, not silently omit, the unresolved branch; implementation remains unchanged until owner decision.                                 | `audit:ChatSystemMessage/public-api`    |
-| FR4                       | Mutation-sensitive root-passthrough tests, source inspection, type checks, and target reflection                | Default and divider roots                                                                                                          | Removing ref, className, style, xstyle, ARIA forwarding, or owned role precedence fails focused tests.                                                  | `audit:ChatSystemMessage/public-api`    |
-| FR5                       | `themingTargets.test.ts`, source inspection, generated build, and exact-head computed paint                     | Both variants and color modes                                                                                                      | Target/state metadata drift, raw styling, physical layout, or unresolved mode paint fails checks or browser evidence.                                   | `audit:ChatSystemMessage/theming`       |
-| FR6                       | Source inspection, strict lint, and component test suite                                                        | Every render                                                                                                                       | Adding hidden state or an owned external resource triggers runtime review and corresponding evidence.                                                   | `audit:ChatSystemMessage/code-health`   |
-| RTL relation              | Source-hashed verified-N/A record                                                                               | Both variants and caller-owned icon content                                                                                        | Directional component-owned content, physical positioning, ordering, scroll/drag, overlay, or horizontal keyboard behavior invalidates the record.      | `audit:ChatSystemMessage/i18n-rtl`      |
-| Browser matrix            | `ChatSystemMessage.a11y.chromium.spec.ts` exact-head 10-sensor receipts                                         | Default, icon, wrapped long content, divider, unresolved divider/icon, nested live log, 320px/coarse pointer, light/dark, D7 pairs | Stale build, wrong story, incorrect mode, missing semantics, default overflow, failed contrast, blank crop, or page error fails closed.                 | `audit:ChatSystemMessage/visual`        |
-| Documentation and surface | Consumer docs, published declarations, block metadata, explicit story ownership, exports, and `check:knowledge` | Props, `./Chat` subpath, four blocks, draft record                                                                                 | Missing or stale public docs, export, owner route, target map, or knowledge shape fails validation or review.                                           | `audit:ChatSystemMessage/docs`          |
-
-## Decision log
-
-None. This draft records the wrapping correction, released observable behavior,
-and audit evidence. It introduces no public API, default, divider/icon decision,
-ownership transfer, or subjective visual decision.
-
-## Open questions
-
-- **OQ1 - Which explicit contract should govern `icon` with `variant="divider"`: render the icon with the divider label; introduce a breaking type restriction with the migration required by `architecture:public-component-api/INV9`; or retain the current no-op with documentation and a development warning?** (`human-api`)
-
-## Content boundary
-
-This file does not duplicate consumer examples, audit scores, screenshots,
-eligibility data, or shared Divider and system rules. It links to their owners.