@astryxdesign/core 0.7.6-canary.fdabeba → 0.7.6

package/src/Dialog/modules/DialogHeader.spec.md

@@ -1,211 +0,0 @@
----
-schema_version: 3
-template_version: 1
-kind: module
-id: module:Dialog/DialogHeader
-authority: current
-archive_reason: null
-superseded_by: null
-approved_by: cixzhang
-approved_at: 2026-09-23
-owners: [cixzhang, imdreamrunner]
-review_triggers: [theming, layout, public-api]
-verified_by:
-  [
-    packages/core/src/Dialog/DialogHeader.test.tsx,
-    packages/core/src/theme/themingTargets.test.ts,
-    packages/cli/foundation/discovery/theming-targets.test.mjs,
-    scripts/check-knowledge.mjs,
-  ]
-parent_component: component:Dialog
-references:
-  [architecture:component-theming-surface, architecture:container-padding]
----
-
-# DialogHeader module contract
-
-## Intent
-
-`DialogHeader` presents the title region of a Dialog and its optional close
-control. This record owns the stable header-row, start-content, title-block,
-end-content, and close-icon anatomy, their public theming targets, and the fixed
-compensation applied to the existing end-content slot.
-
-## Compatibility and migration
-
-- Released default preserved: `yes`
-- Compatibility class: two additive theme targets and one additive prop; omitted
-  layout, paint, interaction, accessibility, and theming remain unchanged
-- Migration decision: none
-
-Consumer migration instructions belong in consumer docs and release notes.
-
-## Ownership boundary
-
-**Owns**
-
-- The header row that arranges title content and controls.
-- The start-content wrapper for optional leading content.
-- The title block that groups the title and optional subtitle.
-- The existing end-content wrapper that groups optional trailing content with
-  the close action.
-- The fixed end-slot compensation derived from the medium close action's
-  transparent inset.
-- The close icon rendered for the optional close action.
-- The `dialog-header`, `dialog-header-start-content`,
-  `dialog-header-title-block`, `dialog-header-end-content`, and
-  `dialog-header-close-icon` targets.
-
-**Does not own / non-goals**
-
-- Dialog modality, dismissal policy, or focus lifecycle — owned by
-  `component:Dialog` and its linked system records.
-- Generic Button or Icon presentation outside this module — owned by those
-  components.
-- List-style inherited container-padding compensation, caller-supplied margin
-  values, or a general alignment primitive.
-
-## Public API and concepts
-
-This contract preserves the three existing theming surfaces, adds two content-
-slot targets, and adds one slot-targeted compensation override.
-
-| Concept                      | Closed values or states                          | Meaning                                                                               | Default                                               | Owner                        | Stability |
-| ---------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------- | --------- |
-| Header row target            | present                                          | Styles the row that arranges title content and controls                               | Existing row visuals                                  | `module:Dialog/DialogHeader` | stable    |
-| Start-content target         | present when start content renders               | Styles the wrapper for optional leading content                                       | Existing start-content layout                         | `module:Dialog/DialogHeader` | stable    |
-| Title block target           | present                                          | Styles the title/subtitle grouping element                                            | Existing title stack visuals                          | `module:Dialog/DialogHeader` | stable    |
-| End-content target           | present when end content or close action renders | Styles the wrapper that groups trailing content with the close action                 | Existing end-content layout                           | `module:Dialog/DialogHeader` | stable    |
-| Close icon target            | present when close action renders                | Styles the close glyph itself                                                         | Existing medium Icon visuals                          | `module:Dialog/DialogHeader` | stable    |
-| `endContentEdgeCompensation` | `inline`, `block`, `all`                         | Selects which axes of the existing end-content wrapper receive its fixed compensation | omitted; preserve automatic close-action compensation | `module:Dialog/DialogHeader` | stable    |
-
-For this slot-targeted prop, `inline` means the slot's logical inline-end edge,
-`block` means both block edges, and `all` combines them.
-
-## Behavioral contract
-
-| ID   | Invariant                                                                                                                                                                                                                                                   | Basis                                            | Review state |
-| ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------ | ------------ |
-| FR1  | The header row MUST carry `dialog-header` on the element that applies its row layout and gap.                                                                                                                                                               | Current implementation and owner decision        | settled      |
-| FR2  | The title block MUST carry `dialog-header-title-block` on the element that applies its title/subtitle layout and gap.                                                                                                                                       | Current implementation and owner decision        | settled      |
-| FR3  | The rendered close Icon MUST carry `dialog-header-close-icon` on the glyph element that applies icon presentation.                                                                                                                                          | Current implementation and owner decision        | settled      |
-| FR4  | Omitting `onOpenChange` MUST continue to omit the close action and its optional close-icon anatomy.                                                                                                                                                         | Released behavior                                | settled      |
-| FR5  | The existing end wrapper MUST continue to group optional `endContent` with the optional close action; this change MUST NOT add another wrapper.                                                                                                             | Current implementation                           | settled      |
-| FR6  | When `endContentEdgeCompensation` is omitted, rendering the close action MUST preserve the released fixed negative block and logical inline-end inset, whether or not `endContent` is present. Without the close action, no automatic compensation applies. | Released behavior and owner decision             | settled      |
-| FR7  | Explicit `inline` MUST apply only logical inline-end compensation; `block` MUST apply only both block edges; `all` MUST apply both. The explicit value overrides the automatic close-action selection.                                                      | `module:Dialog/DialogHeader/DEC-2`               | settled      |
-| FR8  | Compensation MUST use logical inline properties, preserve title, slot, and close-action semantics and hit targets, and expose no caller-controlled margin amount.                                                                                           | `architecture:container-padding`; owner decision | settled      |
-| FR9  | The leading content wrapper MUST carry `dialog-header-start-content` whenever optional start content renders.                                                                                                                                               | `module:Dialog/DialogHeader/DEC-3`               | settled      |
-| FR10 | The existing trailing content wrapper MUST carry `dialog-header-end-content` whenever optional end content or the close action renders.                                                                                                                     | `module:Dialog/DialogHeader/DEC-3`               | settled      |
-
-### Transformation and precedence order
-
-1. If `endContentEdgeCompensation` is present, its closed value selects the
-   compensated axes.
-2. Otherwise, a rendered close action selects `all`; omission of the close
-   action selects no compensation.
-3. The module applies each theme target to its owning element before normal
-   theme CSS resolves through the shared theming pipeline.
-
-### Performance and resources
-
-- The additive closed-value branch and class selection introduce no listener,
-  observer, timer, measurement, or asynchronous resource.
-
-## Accessibility contract
-
-- Compensation and theme targets MUST NOT change the title's role, focus
-  behavior, dialog naming, the close button's accessible name and operation, or
-  any slot child's hit target.
-
-## Design relationships
-
-| Anatomy or state | Design requirement                                                                                                                       | Representation authority        | Module contract |
-| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- | --------------- |
-| Header row       | Owns arrangement and spacing among title content and controls.                                                                           | This module                     | FR1             |
-| Start content    | Owns the leading wrapper for optional start content.                                                                                     | This module                     | FR9             |
-| Title block      | Owns title/subtitle grouping and spacing.                                                                                                | This module                     | FR2             |
-| End content      | Owns the existing trailing wrapper containing optional end content and the close action, including its fixed slot-targeted compensation. | This module                     | FR4–FR8, FR10   |
-| Close icon       | Owns the close glyph's visual box inside the Button-owned action.                                                                        | This module with Icon rendering | FR3, FR4        |
-
-### Theming anatomy
-
-<!-- anatomy-theming:v1 -->
-
-```json
-{
-  "Header row": {"target": "dialog-header"},
-  "Start content": {"target": "dialog-header-start-content"},
-  "Title block": {"target": "dialog-header-title-block"},
-  "End content": {"target": "dialog-header-end-content"},
-  "Close icon": {"target": "dialog-header-close-icon"}
-}
-```
-
-## Parent and system relationships
-
-- `component:Dialog` owns modal behavior and the aggregate Dialog contract.
-- `component:Layout` owns the composed LayoutHeader region outside the five
-  module-owned inner parts.
-- `component:Button` owns the close action's control behavior, hit target, and
-  outer presentation.
-- `component:Icon` renders the glyph; this module guarantees a distinct target
-  for the close icon's DialogHeader-specific visual contract.
-- `architecture:component-theming-surface` owns target qualification, anatomy
-  mapping, and the requirement that each target sits on its painter.
-- `architecture:container-padding` defines the retained-inset edge-compensation
-  intent and distinguishes this slot-targeted projection from List-style
-  inherited-inset self-compensation and full bleed.
-
-## Verification map
-
-| Contract            | Verification                                                                    | Representative states                                                     | Mutation or failure expectation                                                              |
-| ------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
-| FR1–FR3, FR9–FR10   | Target tests, target inventory, generated probe theme, and source inspection    | title only, title/subtitle, start content, end content, close action      | A target is missing, undocumented, duplicated, or moved away from its owning painter.        |
-| FR4–FR5             | Existing content and close-button tests                                         | end content only; close only; both                                        | The close action or slot content disappears, reorders, or gains another wrapper.             |
-| FR6–FR7             | Focused end-slot class-selection assertions                                     | close only; end content only; both; explicit `inline`, `block`, and `all` | An omitted prop changes released geometry, or an explicit value selects the wrong axes.      |
-| FR8                 | Source inspection, RTL CI, interaction tests, and focused real-browser geometry | LTR and RTL; custom end control; close action                             | Physical margins, caller-controlled amounts, or hit-target changes enter the implementation. |
-| Theming anatomy map | `scripts/check-knowledge.mjs`                                                   | all five module anatomy entries and targets                               | Anatomy, docs, runtime targets, and the module map drift.                                    |
-
-## Decision log
-
-### DEC-1 — Header targets follow stable anatomy and visual ownership
-
-**Reference:** `module:Dialog/DialogHeader/DEC-1`
-**Decider:** cixzhang, 2026-09-14
-
-Each public target represents documented anatomy and is applied to the element
-that owns the corresponding visuals. The header row, title block, and close icon
-meet that admission rule and are approved as additive targets.
-
-### DEC-2 — End-content compensation is slot-targeted and explicit
-
-**Reference:** `module:Dialog/DialogHeader/DEC-2`
-**Decider:** cixzhang, 2026-09-22
-
-DialogHeader preserves its released automatic compensation whenever the close
-action renders. `endContentEdgeCompensation` targets the existing end-content
-slot and selects `inline`, `block`, or `all` without exposing a margin amount.
-This is a slot-targeted projection of the retained-inset edge-compensation
-intent; it does not make DialogHeader a List-style inherited-padding consumer.
-
-### DEC-3 — Content-slot wrappers are approved target destinations
-
-**Reference:** `module:Dialog/DialogHeader/DEC-3`
-**Decider:** cixzhang, 2026-09-23
-
-The existing wrappers for `startContent` and `endContent` are approved as stable
-visible anatomy. Their target destinations are
-`dialog-header-start-content` and `dialog-header-end-content`; implementation
-must add no wrapper and must preserve default layout, paint, interaction,
-accessibility, and public props. The end-content name follows the public prop
-even though that slot also contains the optional close action.
-
-## Open questions
-
-None.
-
-## Content boundary
-
-This record does not duplicate consumer signatures/examples, parent Dialog
-behavior, implementation steps, or shared theming rules. It links to their
-canonical owners.

package/src/Divider/Divider.spec.md

@@ -1,252 +0,0 @@
----
-schema_version: 3
-template_version: 7
-kind: component
-id: component:Divider
-authority: current
-archive_reason: null
-superseded_by: null
-approved_by: cixzhang
-approved_at: 2026-10-27
-owners: [cixzhang]
-review_triggers: [public-api, behavior, layout, theming, accessibility, testing]
-verified_by:
-  [
-    .github/visual-baseline/manifest.json,
-    packages/core/src/Divider/Divider.test.tsx,
-    packages/core/src/theme/themingTargets.test.ts,
-    apps/storybook/stories/Divider.stories.tsx,
-  ]
-modules: []
-families: []
-design_specs: []
-architecture:
-  [
-    architecture:public-component-api,
-    architecture:component-theming-surface,
-    architecture:container-padding,
-    architecture:component-test-sufficiency,
-  ]
-contributing: []
-system_specs: [spec:AST-009, spec:AST-020]
----
-
-# Divider component contract
-
-## Contract at a glance
-
-| Area                    | Contract                                                                                                                                                                                                                     |
-| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Public contract         | `orientation`, `label`, theme-extensible `variant`, `isFullBleed`, `BaseProps<HTMLDivElement>`, and a root `ref`.                                                                                                            |
-| Behavior                | The separator renders one rule without a label and two rules around a renderable label; full bleed consumes inherited logical container inset.                                                                               |
-| End-user impact         | People perceive a named separator across horizontal, vertical, labelled, full-bleed, narrow, and RTL compositions.                                                                                                           |
-| Builder impact          | None; the record describes shipped behavior. Numeric zero is a valid label; booleans and empty strings leave one continuous unnamed rule.                                                                                    |
-| Compatibility/readiness | Released behavior recorded as current; no API, default, or output changes. Two implementation gaps are listed under Current-state impact.                                                                                    |
-| Review checks           | Reject missing numeric labels, physical-edge bleed, dropped root inputs, or a target or axis that disagrees with the rendered separator.                                                                                     |
-| Governing rules         | `architecture:public-component-api/INV1,INV5–INV9`; `architecture:component-theming-surface/INV3–INV7,INV14`; `architecture:container-padding/INV1,INV3,INV7–INV10`; WCAG 2.2 SC 1.3.1 and 4.1.2 through `spec:AST-020/FR1`. |
-
-This table is a review projection; the body below is authoritative.
-
-## Intent
-
-Divider provides a programmatic and visual separator between caller-owned content
-regions. It owns orientation, line weight, optional label placement and naming,
-logical full-bleed geometry, and the aggregate `divider` theme target. The caller
-owns the meaning of the surrounding regions.
-
-Consumer syntax and examples belong in `Divider.doc.mjs`.
-
-## Compatibility and migration
-
-- Released default preserved: yes — horizontal, subtle, unlabelled, and not full
-  bleed.
-- Compatibility class: records shipped behavior; no public prop, default, DOM,
-  or styling output changes. ReactNode values that React renders, including
-  numeric zero, stay inside the label wrapper; skipped scalar labels leave one
-  continuous unnamed rule.
-- Controlled/uncontrolled behavior: not applicable.
-- Migration decision: none.
-
-Consumer migration instructions belong in consumer docs and release notes.
-
-## Current-state impact
-
-- **Theme-added variant without line paint (FR3).** `DividerVariantMap` admits
-  theme-added values, but an unmatched value leaves the inner rule unpainted, so
-  the line can disappear. `architecture:component-theming-surface` INV14
-  requires an extensible visual axis to have a safe theme-independent baseline;
-  OQ2 holds the remediation direction.
-- **Caller `role` and `aria-orientation` replaced (FR6).** Divider sets
-  `role="separator"` and `aria-orientation` after caller props, so a caller's
-  explicit values never reach the root, where
-  `architecture:public-component-api` INV5 lets a caller's explicit input reach
-  the element.
-
-## Ownership boundary
-
-**Owns**
-
-- One semantic separator root and its public ref, DOM, data, ARIA, class, style,
-  event, and `xstyle` composition.
-- Horizontal and vertical rule geometry.
-- Optional label placement and the separator naming relationship.
-- Built-in subtle and strong line weights.
-- The reflected custom-variant state, including the missing line-paint fallback
-  recorded under Current-state impact.
-- Logical full-bleed consumption of inherited container inset.
-- The aggregate `divider` target with reflected orientation and variant axes.
-
-**Does not own / non-goals**
-
-- The meaning or heading structure of surrounding content regions — owned by the
-  product callsite.
-- Container inset publication — owned by `architecture:container-padding`.
-- A separate public target for Rule or Label — none exists; OQ1 holds the question.
-- Theme-authored custom variant paint and the public part that should own it —
-  OQ2 holds the question.
-
-## Public concepts
-
-| Concept      | Closed values or states                       | Meaning                                                                                       | Availability by variant/orientation/state | Default      | Owner                        | Stability                               | Invalid-value behavior                                                                     |
-| ------------ | --------------------------------------------- | --------------------------------------------------------------------------------------------- | ----------------------------------------- | ------------ | ---------------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------ |
-| Orientation  | `horizontal`; `vertical`                      | Selects the separator axis, rule geometry, and `aria-orientation`.                            | Every divider                             | `horizontal` | component                    | stable                                  | Closed union; rejected by types                                                            |
-| Label        | renderable ReactNode; omitted/skipped scalar  | Inserts one label between two rules and names the separator unless explicit ARIA naming wins. | Every orientation and variant             | omitted      | caller/component             | stable                                  | `null`, booleans, and empty strings render no label; numeric zero remains visible          |
-| Variant      | `subtle`; `strong`; theme-added visual values | Selects line paint and reflects the requested value on the target.                            | Every orientation and label state         | `subtle`     | component/theme              | stable built-ins; theme-extensible axis | An unmatched custom value leaves the rule unpainted (FR3)                                  |
-| Full bleed   | false; true                                   | Consumes inherited logical container inset on the divider axis.                               | Every orientation                         | false        | component/container protocol | stable                                  | Missing variables resolve to zero                                                          |
-| Root surface | ref; DOM/data/ARIA; class/style/xstyle/events | Extends the semantic separator root.                                                          | Every divider                             | omitted      | public component API         | stable                                  | Accepted inputs compose; a caller `role` or `aria-orientation` is replaced today (FR6 gap) |
-
-## Behavioral and layout contract
-
-| ID  | Invariant                                                                                                                                                                                                                                                                                                                                                                                                     | Basis                                                                       |
-| --- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
-| FR1 | The divider renders one rule without a renderable label and two rules with the label between them. Numeric zero is a renderable label; `null`, booleans, and empty strings render no label. A horizontal divider is a full-width flex row and a vertical divider a full-height inline flex column; the label uses supporting type in secondary text with `--spacing-3` padding on the divider's axis.         | Released ReactNode API; current source, docs, and tests                     |
-| FR2 | By default the root exposes `role="separator"` and the selected `aria-orientation`; a caller's explicit `role` or `aria-orientation` wins and is used as given, even where it contradicts `orientation` (FR6). A renderable label names it through `aria-labelledby` unless a caller `aria-label` or `aria-labelledby` is supplied.                                                                           | WCAG 2.2 SC 1.3.1 and 4.1.2; current source and tests                       |
-| FR3 | `subtle` paints the rule `--color-border` and `strong` paints it `--color-border-emphasized`, at `--border-width`. The exported map accepts theme-added values, which the root reflects, and an extensible visual axis has a safe theme-independent baseline (`architecture:component-theming-surface` INV14). Implementation gap: an unmatched value leaves the inner rule unpainted (Current-state impact). | `architecture:component-theming-surface/INV4,INV6,INV14`; current source    |
-| FR4 | Full bleed consumes the inherited logical inline inset for horizontal dividers and the logical block inset for vertical dividers, extending the box by the same amounts; absent inset resolves to zero.                                                                                                                                                                                                       | `architecture:container-padding/INV1,INV3,INV7–INV10`; current source       |
-| FR5 | The root carries the `divider` target and reflects `orientation` and the requested `variant`. Rule and Label carry no public target. The reflected `data-orientation` and `data-variant` are component-owned theming state and replace a caller's values.                                                                                                                                                     | `architecture:component-theming-surface/INV3–INV6`; current source and docs |
-| FR6 | `ref`, DOM, data, ARIA, class, style, event, and `xstyle` inputs reach or compose on the separator root, and a caller's explicit `role` or `aria-orientation` reaches it (`architecture:public-component-api` INV5). Implementation gap: the component sets `role` and `aria-orientation` after caller props, so a caller's values are replaced (Current-state impact).                                       | `architecture:public-component-api/INV5–INV8`; current source and tests     |
-
-### Allowed variation
-
-- **AV1 — Label content.** Any caller-owned ReactNode that React renders may fill
-  the label wrapper.
-- **AV2 — Theme paint.** An active theme may restyle the aggregate target and its
-  variant axis. OQ2 owns the unresolved inner-rule paint and fallback boundary.
-- **AV3 — Container geometry.** Full bleed follows the inherited per-edge inset,
-  including asymmetric and zero values.
-
-### Representative states
-
-| State                               | Required invariant                                                                      | Allowed variation                          |
-| ----------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------ |
-| Unlabelled horizontal               | One subtle or strong inline rule; horizontal separator semantics                        | Container width and theme paint            |
-| Labelled horizontal                 | Two rules around one visible, naming label                                              | Any renderable label content               |
-| Numeric zero label                  | One visible `0` inside the label wrapper; separator name `0`                            | Any orientation or variant                 |
-| Vertical labelled/unlabelled        | Block-axis rules and vertical separator semantics                                       | Container height and label content         |
-| Theme-added variant without a match | Requested variant reflected; inner rule has no component-owned paint (FR3 gap)          | Custom variant name                        |
-| Full bleed                          | Logical-axis inset consumed without physical-direction assumptions                      | Uniform, asymmetric, zero, or absent inset |
-| RTL                                 | Horizontal geometry remains logical; full bleed consumes inline start/end independently | Surrounding content and label language     |
-
-### Transformation and precedence order
-
-- **ORD1 — Label presence.** Apply the shared renderable-value predicate; when a
-  label remains, render and reference one wrapper between two rules.
-- **ORD2 — Accessible name.** Explicit `aria-labelledby` wins, then explicit
-  `aria-label`, then the rendered label wrapper; an unlabelled separator stays
-  unnamed.
-- **ORD3 — Variant paint.** Reflect the requested value on the root target. Built-in
-  values select subtle or strong inner-rule paint; unmatched custom values select no
-  inner-rule paint (FR3).
-
-### Performance and resources
-
-- **PR1 — No external lifecycle.** Divider installs no listener, observer, timer,
-  request, state machine, or Effect.
-
-## Accessibility contract
-
-- **AR1 — Programmatic separator.** By default the root exposes separator role
-  and the exact visual orientation; a caller's explicit `role` or
-  `aria-orientation` wins (FR6), and today the component's values replace it
-  (FR6 gap).
-- **AR2 — Label relationship.** A rendered label names the separator unless the
-  caller supplies an explicit accessible name relationship.
-- **AR3 — Decorative rule segments.** Internal rule elements add no separate role,
-  name, focus target, or interaction.
-
-## Design relationships
-
-| Anatomy or state | Design requirement                                                                            | Representation authority                                     | Hierarchy role | Component contract |
-| ---------------- | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------ | -------------- | ------------------ |
-| Divider group    | Arrange rule segments and the optional label on one logical axis.                             | Current source; container geometry from current architecture | supporting     | FR1, FR4           |
-| Rule             | Paint a visible subtle or strong separation line; theme-added values lack a settled fallback. | Current source; custom fallback is the FR3 gap               | supporting     | FR3                |
-| Label            | Present optional content between two rules using supporting text tokens.                      | Current source; no separate target (OQ1)                     | prominent      | FR1–FR2            |
-
-No component-local design decision is recorded.
-
-### Theming anatomy
-
-<!-- anatomy-theming:v1 -->
-
-```json
-{
-  "Divider group": {"target": "divider"},
-  "Rule": {
-    "none": {
-      "reason": "unsettled: No current public target reaches this part"
-    }
-  },
-  "Label": {
-    "none": {
-      "reason": "unsettled: No current public target reaches this part"
-    }
-  }
-}
-```
-
-The two `none` dispositions record that no public target reaches Rule or Label;
-OQ1 holds whether they should gain one.
-
-## Family and system relationships
-
-- `architecture:container-padding` owns the inherited internal inset protocol;
-  Divider consumes it only through `isFullBleed`.
-- `architecture:component-theming-surface` sets the rules for the target,
-  reflected axes, and anatomy qualification, and the requirement that an open visual axis have
-  a deterministic fallback. Divider's custom-value path does not satisfy that
-  requirement (FR3); OQ2 holds the remediation direction.
-- `architecture:public-component-api` owns root composition, ref behavior, and
-  compatibility of the released ReactNode label surface.
-- There is no current Divider family or design record.
-
-## Verification map
-
-| Contract           | Verification                                                                                                          | Representative states                                                    | Mutation or failure expectation                                                                                                                                                                                                                                                                                    | Audit section            |
-| ------------------ | --------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------ |
-| FR1, FR2, AR1, AR2 | `Divider.test.tsx` orientation, label, naming, and numeric-zero tests                                                 | Labelled and unlabelled, numeric zero, explicit names, both orientations | Rendering zero outside the wrapper, an unnamed labelled separator, or role, orientation, or name drift fails. Gap: only the unlabelled horizontal default is in the stable visual baseline (`core-divider--default`); the vertical layout and the label's type and padding have no automated check.                | `audit:Divider/a11y`     |
-| AR3                | Source review                                                                                                         | Labelled and unlabelled                                                  | Gap: no automated check fails if a rule segment gains a role, name, or tab stop.                                                                                                                                                                                                                                   | `audit:Divider/a11y`     |
-| FR3, FR5           | `Divider.test.tsx` variant and target tests; `themingTargets.test.ts`; stable visual baseline `core-divider--default` | Subtle, strong, both orientations; default                               | A lost class or `orientation`/`variant` reflection fails; a changed default rule paint comes back changed for review. Gap: the strong paint and the unmatched theme-added path have no automated check.                                                                                                            | `audit:Divider/theming`  |
-| FR4                | `@astryx/no-physical-properties` lint rule; `Divider.stories.tsx` full-bleed fixtures                                 | Horizontal and vertical, LTR and RTL, absent inset                       | A physical left/right property in Divider's styles fails lint. Gap: the `Divider.test.tsx` full-bleed test only checks that the element renders, so no automated check fails when full bleed is not applied, on the wrong axis, or with a non-zero fallback, and no browser right-to-left check covers full bleed. | `audit:Divider/layout`   |
-| FR6                | `Divider.test.tsx` ref and passthrough tests                                                                          | Ref, extra props                                                         | A dropped ref or caller prop fails. Gap: the ref test accepts any element, so a ref on a wrapper passes; no test covers the styling-input merge or a caller `role` or `aria-orientation`.                                                                                                                          | `audit:Divider/behavior` |
-| PR1                | Source review                                                                                                         | Every state                                                              | Gap: no automated check fails if Divider adds a listener, observer, timer, or effect.                                                                                                                                                                                                                              | `audit:Divider/behavior` |
-| AR1, AR2           | Accessibility-tree evidence (`spec:AST-009` FR3)                                                                      | Labelled and unlabelled separators                                       | Gap: no accessibility-tree check proves the separator role, orientation, or name; the unit tests query the DOM.                                                                                                                                                                                                    | `audit:Divider/a11y`     |
-
-## Decision log
-
-None recorded. The record describes shipped behavior.
-
-## Open questions
-
-- **OQ1 — Should Rule or Label gain stable public theming targets?** (`human-api`)
-  No public target reaches them today; that absence does not decide the answer.
-- **OQ2 — Should the open `variant` axis close, or which painting part owns its
-  deterministic custom-value fallback?** (`human-api`) The root target can carry
-  theme paint while the inner rule carries built-in paint. Applying a subtle inner
-  fallback can cover an existing root background; keeping the current path can make
-  the rule disappear. Options: close the axis, move target ownership, or route
-  paint through a reviewed public property.
-
-## Content boundary
-
-This file does not duplicate consumer prop tables/examples, current audit
-results, implementation steps, or family/system rules. It links to their owners.