@astryxdesign/core 0.7.6-canary.fdabeba → 0.7.6

package/src/Card/Card.spec.md

@@ -1,205 +0,0 @@
----
-schema_version: 3
-template_version: 7
-kind: component
-id: component:Card
-authority: current
-archive_reason: null
-superseded_by: null
-approved_by: cixzhang
-approved_at: 2026-10-28
-owners: [cixzhang]
-review_triggers: [public-api, behavior, layout, theming, accessibility]
-verified_by:
-  [
-    .github/visual-baseline/manifest.json,
-    packages/core/src/Card/Card.test.tsx,
-    packages/core/src/theme/themingTargets.test.ts,
-    packages/core/src/theme/extensibleAxes.test.ts,
-    apps/storybook/stories/Card.stories.tsx,
-    scripts/check-knowledge.mjs,
-  ]
-modules: []
-families: []
-design_specs: []
-architecture:
-  [
-    architecture:component-theming-surface,
-    architecture:container-padding,
-    architecture:public-component-api,
-  ]
-contributing: []
-system_specs: []
----
-
-# Card component contract
-
-## Contract at a glance
-
-| Area                    | Contract                                                                                                                                                                                                 |
-| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Public contract         | A container with sizing props, `padding` on the spacing scale, a theme-extensible `variant`, and a resting `elevation`.                                                                                  |
-| Behavior                | Card paints a rounded surface, publishes its padding to descendants through the container-padding protocol, and only the `default` variant draws a border.                                               |
-| End-user impact         | Readers see grouped content on a consistent surface; with the default border and theme border width, content insets stay on the spacing scale whether or not a border is drawn, except at zero padding.  |
-| Builder impact          | None; the record describes shipped behavior.                                                                                                                                                             |
-| Compatibility/readiness | Released behavior recorded as current; no API, default, or output changes. One implementation gap is listed under Current-state impact.                                                                  |
-| Review checks           | Reject a card that holds its track at min-content width, a variant that falls through to another variant, a lost padding publication, or a published inset that drifts further from the applied padding. |
-| Governing rules         | `architecture:container-padding` (container publisher); `architecture:component-theming-surface/INV6,INV14`; `architecture:public-component-api/INV5,INV6,INV8`.                                         |
-
-This table is a review projection; the body below is authoritative.
-
-## Intent
-
-Card groups related content on a contained surface. It owns the surface's
-paint, border, radius, and elevation, its sizing, and the padding it publishes
-so Layout and other descendants align to it.
-
-## Compatibility and migration
-
-- Released default preserved: `yes`
-- Compatibility class: records shipped behavior; no public prop, default, DOM,
-  or styling output changes
-- Controlled/uncontrolled behavior: not applicable
-- Migration decision: none
-
-Consumer migration instructions belong in consumer docs and release notes.
-
-## Current-state impact
-
-- **Published inset exceeds applied padding (FR3).** At nonzero padding a
-  `default` card applies padding reduced by its border width but publishes
-  border plus padding (at `padding={0}` the two match). Every child that bleeds
-  to the published inset, on any edge — a full-bleed Divider, a Layout, or a
-  List `outset` or `bleed` box — overshoots the padding edge by the border
-  width. A fixed-height card holding such a child scrolls by that amount on
-  each axis the child bleeds on (both for a Layout) and becomes an unnamed tab
-  stop even when its content fits: in Chromium when it holds nothing
-  focusable, in Firefox even when it holds a focusable child. `architecture:container-padding` INV11
-  has a host publish its applied padding, and `component:List` FR8 counts a
-  Card's content area as such a host, so a `default` card at nonzero padding
-  does not yet meet List FR8: List `outset` and `bleed` lists cross its padding edge by the border width, and `bleed` rows with them.
-
-## Ownership boundary
-
-**Owns**
-
-- The Container: surface paint, border, radius, elevation, sizing, and
-  clipping.
-- Resolving and publishing card padding as a container publisher.
-
-**Does not own / non-goals**
-
-- Content structure inside the card — owned by the caller and Layout.
-- Interaction — owned by `component:ClickableCard` and
-  `component:SelectableCard`, which compose Card.
-- The padding protocol itself — owned by `architecture:container-padding`.
-
-## Public concepts
-
-| Concept   | Closed values or states                                                                                                                  | Meaning                                                 | Availability by variant/orientation/state | Default            | Owner            | Stability | Invalid-value behavior                                                                              |
-| --------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | ----------------------------------------- | ------------------ | ---------------- | --------- | --------------------------------------------------------------------------------------------------- |
-| Variant   | `default`, `transparent`, `muted`, `blue`, `cyan`, `gray`, `green`, `orange`, `pink`, `purple`, `red`, `teal`, `yellow`; theme additions | Surface paint; only `default` draws a border.           | Always                                    | `default`          | `component:Card` | Stable    | A theme-added value is reflected on `card` and renders the base surface with no fill and no border. |
-| Elevation | `none`, `low`, `med`, `high`                                                                                                             | Resting shadow from the shadow token scale.             | Always                                    | `none`             | `component:Card` | Stable    | TypeScript rejects other values.                                                                    |
-| Padding   | Spacing steps 0, 0.5, 1, 1.5, 2, 3, 4, 5, 6, 8, 10; omitted                                                                              | Uniform padding; omitted uses the theme's card padding. | Always                                    | theme card padding | `component:Card` | Stable    | TypeScript rejects other values.                                                                    |
-| Sizing    | `width`, `height`, `maxWidth`, `minHeight`: numbers in pixels or CSS strings                                                             | The card's box size.                                    | Always                                    | unset              | `component:Card` | Stable    | Strings pass through as CSS.                                                                        |
-
-## Behavioral and layout contract
-
-| ID  | Invariant                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Basis                    |
-| --- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ |
-| FR1 | Card renders one `div` carrying the `card` target, which reflects `variant` and `elevation`, with `--radius-container` corners and a box shadow composed of the selection ring and the elevation shadow.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Current source and tests |
-| FR2 | `default` paints `--color-background-card` with a `--border-width` solid `--color-border` border; `transparent` paints nothing; `muted` paints `--color-background-muted`; each palette variant paints its `--color-background-<name>` tint. A theme-added variant falls through to the base surface, never to another variant.                                                                                                                                                                                                                                                                                                                                                                                                                                            | Current source and tests |
-| FR3 | Card resolves padding as a container publisher: an omitted `padding` uses the theme's card padding (spacing step 4 with no theme), and a step applies uniformly to every edge. With the `default` border, each edge's padding is reduced by the global `--border-width` token (stopping at zero), so border plus padding matches the borderless inset. The published inset matches the padding the card applies (`architecture:container-padding` INV11). Implementation gap: at nonzero padding a `default` card publishes border plus padding, one border width more than its applied padding, so a full-bleed child overshoots the padding edge, a fixed-height card scrolls by that width, and the card does not yet meet `component:List` FR8 (Current-state impact). | Current source and tests |
-| FR4 | Card has zero minimum width, so it yields to its track instead of holding it at its min-content width, and clips overflow without becoming a scroll container. A `height` other than `auto` makes it scroll. `width`, `height`, `maxWidth`, and `minHeight` apply as given, and a caller minimum can win over `width`.                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Current source and tests |
-| FR5 | `elevation` sets the elevation shadow to none or the low, medium, or high shadow token.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Current source and tests |
-| FR6 | `ref` reaches the `div`. Supported DOM, ARIA, data, and event props reach the element carrying the target; `xstyle`, `className`, and `style` merge in that order after component styles, and a caller `className` joins the target class rather than replacing it.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Current source and tests |
-
-### Allowed variation
-
-- **AV1 — Theme paint and padding.** A theme may restyle `card` per `variant`
-  and `elevation`, including border width and color, and set the card padding.
-- **AV2 — Content.** Any content may fill the card.
-
-### Representative states
-
-| State               | Required invariant                                                                                 | Allowed variation |
-| ------------------- | -------------------------------------------------------------------------------------------------- | ----------------- |
-| Default             | Card surface with border; inset equals the theme card padding.                                     | Content.          |
-| Borderless variant  | No border; same inset as `default` except at `padding={0}`, where `default` adds its border width. | Variant.          |
-| Theme-added variant | Base surface; `data-variant` names the added value.                                                | Theme paint.      |
-| Fixed height        | Scrolls its content; still yields in its track.                                                    | Height.           |
-| Elevated            | Elevation shadow alongside any ring.                                                               | Elevation.        |
-
-### Transformation and precedence order
-
-- **ORD1 — Padding.** `padding` step → theme card padding → spacing step 4;
-  then subtract the border width per edge for `default`, stopping at zero.
-- **ORD2 — Shadow.** Ring and elevation compose in one shadow list; neither
-  replaces the other.
-
-### Performance and resources
-
-- **PR1 — Static render.** Card holds no state and uses no hooks.
-
-## Accessibility contract
-
-- **AR1 — No semantics added.** Card adds no role, name, or tab stop of its own;
-  its content's semantics pass through. Exception: a fixed-height card whose
-  content overflows is a scroll container (FR4), and browsers may make it an
-  unnamed tab stop so keyboard users can scroll it (Chromium when it holds
-  nothing focusable; Firefox even when it holds a focusable child).
-
-## Design relationships
-
-| Anatomy or state | Design requirement                                           | Representation authority | Hierarchy role | Component contract |
-| ---------------- | ------------------------------------------------------------ | ------------------------ | -------------- | ------------------ |
-| Container        | A rounded surface with background, optional border, padding. | Current source and docs  | Supporting     | FR1–FR5            |
-| Content          | Caller content inside the published inset.                   | Current source and docs  | Prominent      | FR3, AR1           |
-
-### Theming anatomy
-
-<!-- anatomy-theming:v1 -->
-
-```json
-{
-  "Container": {"target": "card"},
-  "Content": {
-    "none": {
-      "reason": "intentional: caller content keeps its own styling and has no component-owned paint target"
-    }
-  }
-}
-```
-
-## Family and system relationships
-
-- `architecture:container-padding` names Card a container publisher; FR3 records
-  how Card resolves and publishes its padding.
-- `component:ClickableCard` and `component:SelectableCard` compose Card; a
-  selection ring composes with Card's elevation shadow (ORD2).
-- `architecture:component-theming-surface` sets the rules the `card` target
-  follows (INV6) and qualifies `variant` as a theme-extensible axis (INV14).
-
-## Verification map
-
-| Contract            | Verification                                                                                                                                                                            | Representative states                                         | Mutation or failure expectation                                                                                                                                                                                                                                                                                                                                                                                  | Audit section         |
-| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- |
-| FR1, FR2, FR5, ORD2 | `Card.test.tsx` reflection, built-in variant, elevation, and theme-added variant tests; stable visual baselines `core-card--default` and `core-card--theme-added-variant` (probe theme) | Every built-in variant; elevations; added value; default card | A lost reflection, an elevation without its own class, or a theme-added value falling through to another variant fails; a changed default surface, border, radius, or rest shadow, or a theme-added card that loses its theme paint, comes back changed for review. Gap: the palette tints, the elevation shadow values, and the ring-and-shadow composition have no automated check beyond those two baselines. | `audit:Card/theming`  |
-| FR3                 | `Card.stories.tsx` in a browser                                                                                                                                                         | Default and borderless variants; padding steps                | Gap: no unit test asserts padding publication or the border subtraction; an inset mismatch is visible only in the rendered fixture. The full-bleed overshoot in a default card has no automated check.                                                                                                                                                                                                           | `audit:Card/layout`   |
-| FR4                 | `Card.test.tsx` sizing suite                                                                                                                                                            | Every variant; fixed height; caller minimum                   | A held min-content width, a scroll container without fixed height, or a lost caller minimum fails.                                                                                                                                                                                                                                                                                                               | `audit:Card/layout`   |
-| FR6                 | `Card.test.tsx` ref, passthrough, and className tests                                                                                                                                   | Ref; extra props; className                                   | A ref on another element, a prop on an element other than the target, or a replaced target class fails. Gap: no test asserts the `xstyle`, `className`, `style` merge order.                                                                                                                                                                                                                                     | `audit:Card/behavior` |
-| Theming anatomy map | `scripts/check-knowledge.mjs`                                                                                                                                                           | Consumer anatomy and current target                           | Missing, extra, or stale mappings fail repository validation.                                                                                                                                                                                                                                                                                                                                                    | `audit:Card/theming`  |
-| AR1, PR1            | Source review                                                                                                                                                                           | Every variant                                                 | Gap: no automated check fails if Card adds a role, tab stop, state, or hook. No test covers the fixed-height overflow tab stop, with or without focusable content. No test covers the tab stop a fixed-height default card gains from a bleeding child's overshoot.                                                                                                                                              | `audit:Card/behavior` |
-
-## Decision log
-
-None recorded. The record describes shipped behavior.
-
-## Open questions
-
-None.
-
-## 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.

package/src/Carousel/Carousel.spec.md

@@ -1,146 +0,0 @@
----
-schema_version: 3
-template_version: 7
-kind: component
-id: component:Carousel
-authority: current
-archive_reason: null
-superseded_by: null
-approved_by: cixzhang
-approved_at: 2026-10-22
-owners: [cixzhang]
-review_triggers: [behavior, accessibility]
-verified_by:
-  [
-    packages/core/src/Carousel/Carousel.test.tsx,
-    packages/core/src/Carousel/__tests__/Carousel.a11y.chromium.spec.ts,
-  ]
-modules: []
-families: [family:buttons]
-design_specs: []
-architecture: [architecture:interaction-modality]
-contributing: []
-system_specs: [spec:AST-085, spec:AST-025]
----
-
-# Carousel component contract
-
-## Contract at a glance
-
-| Area                    | Contract                                                                                                                                                                                                                                                                 |
-| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| Public contract         | None changes.                                                                                                                                                                                                                                                            |
-| Behavior                | An edge scroll button whose direction has run out is hidden and takes no tab stop. When the focused edge button runs out, focus moves to the scroll area.                                                                                                                |
-| End-user impact         | A keyboard user who scrolls to the first or last item stays inside the carousel instead of landing on the page body or on an invisible control. The scroll area is a group named like the carousel (`spec:AST-025` FR12), so screen-reader users hear where they landed. |
-| Builder impact          | None.                                                                                                                                                                                                                                                                    |
-| Compatibility/readiness | No API change. Shipped Carousel and its current tests still use native `disabled` and hand focus to the opposite button; they change with conformance work.                                                                                                              |
-| Review checks           | Reject focus left on a hidden edge button, focus dropped to the page body, or an edge handoff that moves focus to anything but the scroll area.                                                                                                                          |
-| Governing rules         | `spec:AST-085` FR1, FR4; `spec:AST-025` FR12; `architecture:interaction-modality` INV1.                                                                                                                                                                                  |
-
-This table is a review projection; the body below is authoritative.
-
-## Intent
-
-Carousel shows a horizontally scrolling row of items inside a labelled region,
-with optional scroll buttons at each edge. This record covers only what the edge
-scroll buttons do when their direction runs out. Other Carousel behavior is
-uncontracted until this record grows.
-
-## Compatibility and migration
-
-- Released default preserved: yes, except where focus lands at an edge.
-- Compatibility class: behavior correction; no API change.
-- Controlled/uncontrolled behavior: unchanged.
-- Migration decision: DEC-1.
-
-Consumer migration instructions belong in consumer docs and release notes.
-
-## Ownership boundary
-
-**Owns**
-
-- Edge scroll button visibility, tab order, and the focus destination when one
-  runs out.
-
-**Does not own / non-goals**
-
-- Scroll area keyboard access and naming — `spec:AST-025`.
-- Disabled control semantics in general — `spec:AST-085`.
-- Button naming, sizing, and activation — `family:buttons`.
-- Looping, snapping, edge fades, and slide semantics — uncontracted.
-
-## Public concepts
-
-| Concept            | Closed values or states | Meaning                                            | Availability by variant/orientation/state | Default | Owner                | Stability | Invalid-value behavior |
-| ------------------ | ----------------------- | -------------------------------------------------- | ----------------------------------------- | ------- | -------------------- | --------- | ---------------------- |
-| Edge scroll button | available, run out      | Whether content remains in that button's direction | Both edges when the carousel overflows    | —       | `component:Carousel` | stable    | not applicable         |
-
-## Behavioral and layout contract
-
-| ID  | Candidate invariant                                                                                                                                                                                                                                                                                                    | Basis                                    | Draft review state |
-| --- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | ------------------ |
-| FR1 | An edge scroll button whose direction has run out is hidden. While hidden it takes no tab stop and is not exposed to assistive technology. It stays mounted so layout does not shift. This is removal under `spec:AST-085` FR4, not a disabled control.                                                                | DEC-1                                    | settled            |
-| FR2 | When the focused edge scroll button runs out, focus moves to the scroll area without scrolling it. This holds when the content no longer overflows and the scroll area is out of the tab order (`spec:AST-025` FR12): it still takes focus programmatically. Focus never lands on the page body or on a hidden button. | DEC-1; `spec:AST-085` FR4                | settled            |
-| FR3 | The handoff happens once per edge transition, and only while the edge button held focus. An edge reached by swipe, resize, or wheel while focus is elsewhere moves nothing.                                                                                                                                            | `architecture:interaction-modality` INV8 | settled            |
-| FR4 | An edge scroll button that is available behaves as an ordinary Button.                                                                                                                                                                                                                                                 | `family:buttons`                         | settled            |
-
-### Representative states
-
-| State                                  | Required invariant                                              | Allowed variation       |
-| -------------------------------------- | --------------------------------------------------------------- | ----------------------- |
-| Mid-scroll                             | Both edge buttons available                                     | Loop keeps both enabled |
-| Focused "Scroll right" reaches the end | Button hides; focus is on the scroll area; no extra scroll      | Reduced motion          |
-| Edge reached by swipe, focus elsewhere | Button hides; focus does not move                               | —                       |
-| Content shrinks to fit                 | Both buttons hidden; a focused one hands off to the scroll area | —                       |
-
-## Accessibility contract
-
-- **AR1 — No invisible tab stops.** A hidden edge button is not focusable and is
-  not exposed to assistive technology (FR1).
-- **AR2 — Focus stays in the region.** The edge handoff keeps focus inside the
-  labelled carousel region (FR2), and the keyboard focus indicator follows
-  `architecture:interaction-modality` INV1.
-
-## Design relationships
-
-No design record governs Carousel yet. Edge button visuals stay in code and
-visual evidence.
-
-## Family and system relationships
-
-- `spec:AST-085` FR4 lets a component name a focus destination for a control it
-  removes; FR2 names the scroll area.
-- `spec:AST-025` FR12 owns the scroll area's tab stop and naming.
-- `family:buttons` owns the edge buttons' behavior while available.
-
-## Verification map
-
-| Contract | Verification                            | Representative states                                    | Mutation or failure expectation                                                | Audit section                  |
-| -------- | --------------------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------ | ------------------------------ |
-| FR1, AR1 | Unit and accessibility-tree tests       | at rest at each edge; no overflow                        | A hidden button that is focusable or exposed fails                             | `audit:Carousel/accessibility` |
-| FR2, AR2 | Real-browser keyboard test              | Enter on "Scroll right" until the end; same on the start | Focus on the page body, a hidden button, or the opposite button fails          | `audit:Carousel/accessibility` |
-| FR3      | Real-browser test with swipe and resize | edge reached with focus outside the carousel             | Focus moving without an edge-button press, or moving twice for one edge, fails | `audit:Carousel/accessibility` |
-
-## Decision log
-
-### DEC-1 — The scroll area receives focus when an edge button runs out
-
-**Reference:** `component:Carousel/DEC-1`
-**Decider:** cixzhang, 2026-10-22
-
-Carousel hides an edge button whose direction has run out, so keeping focus on
-it would leave a keyboard user on an invisible control. The scroll area is always
-mounted inside the labelled region and can take focus whether or not it is in the
-tab order, so focus moving there keeps the user in place inside the carousel.
-
-Rejected: the opposite edge button — it may be hidden too, and focus would jump
-across the carousel.
-
-## Open questions
-
-None.
-
-## 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.

package/src/Center/Center.spec.md

@@ -1,205 +0,0 @@
----
-schema_version: 3
-template_version: 7
-kind: component
-id: component:Center
-authority: current
-archive_reason: null
-superseded_by: null
-approved_by: cixzhang
-approved_at: 2026-10-28
-owners: [cixzhang]
-review_triggers: [public-api, layout, theming, accessibility]
-verified_by:
-  [
-    packages/core/src/serverSafeComponents.test.ts,
-    .github/visual-baseline/manifest.json,
-    packages/core/src/Center/Center.test.tsx,
-    packages/core/src/theme/themingTargets.test.ts,
-    apps/storybook/rtl-audit/targets.json,
-    apps/storybook/stories/Center.stories.tsx,
-    scripts/check-knowledge.mjs,
-  ]
-modules: []
-families: [family:layout-primitives]
-design_specs: []
-architecture:
-  [
-    architecture:public-component-api,
-    architecture:component-theming-surface,
-    architecture:container-padding,
-  ]
-contributing: []
-system_specs: [spec:AST-002]
----
-
-# Center component contract
-
-## Contract at a glance
-
-| Area                    | Contract                                                                                                                                                         |
-| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Public contract         | A flex container that centers its children on `axis` (`both`, `horizontal`, `vertical`), with `isInline`, box sizing, and per-edge logical `padding`.            |
-| Behavior                | `both` centers on both axes; the single-axis values are physical-axis names that the source maps to flex main and cross axes; padding resolves per logical edge. |
-| End-user impact         | Readers see content centered in its box, with padding that follows the writing direction.                                                                        |
-| Builder impact          | None; the record describes shipped behavior.                                                                                                                     |
-| Compatibility/readiness | Released behavior recorded as current; no API, default, or output changes. One implementation gap is listed under Current-state impact.                          |
-| Review checks           | Reject physical left/right padding, padding that publishes container inset, a caller `data-axis` that replaces the reflected axis, or added semantics.           |
-| Governing rules         | `family:layout-primitives/FR1–FR5,FR7,FR8`; `architecture:container-padding/INV8`; `architecture:public-component-api/INV5,INV6,INV8`.                           |
-
-This table is a review projection; the body below is authoritative.
-
-## Intent
-
-Center places caller content at the horizontal center, vertical center, or both
-within its own box. It owns the centering axis, its display mode, box sizing,
-and local padding.
-
-## Compatibility and migration
-
-- Released default preserved: `yes`
-- Compatibility class: records shipped behavior; no public type, default,
-  supported value, DOM element, or theme target changes
-- Controlled/uncontrolled behavior: not applicable
-- Migration decision: none
-
-Consumer migration instructions belong in consumer docs and release notes.
-
-## Current-state impact
-
-- **Single-axis values in vertical writing (FR2).** `family:layout-primitives`
-  lists `horizontal` and `vertical` as physical-axis alignment aliases. Center
-  maps `horizontal` to flex main-axis centering and `vertical` to cross-axis
-  centering, which matches the physical axes in horizontal writing but swaps
-  them in vertical writing modes.
-
-## Ownership boundary
-
-**Owns**
-
-- The `div` container, its flex or inline-flex display, and its `center` target
-  with the reflected `axis`.
-- Centering on the selected axis or axes.
-- Box sizing and logical padding precedence.
-
-**Does not own / non-goals**
-
-- The semantics, paint, interaction, size, or order of caller content.
-- Page and region layout — owned by Layout and the product callsite.
-- Gap between children, breakpoints, and overflow.
-- Container inset publication and descendant bleed — Center padding is local
-  under `architecture:container-padding`.
-
-## Public concepts
-
-| Concept  | Closed values or states                                                      | Meaning                                | Availability by variant/orientation/state | Default | Owner                      | Stability | Invalid-value behavior           |
-| -------- | ---------------------------------------------------------------------------- | -------------------------------------- | ----------------------------------------- | ------- | -------------------------- | --------- | -------------------------------- |
-| Axis     | `both`, `horizontal`, `vertical`                                             | Which axis or axes are centered (FR2). | Always                                    | `both`  | `component:Center`         | Stable    | TypeScript rejects other values. |
-| Display  | flex; inline-flex                                                            | Block-level or inline-level container. | Every axis                                | flex    | `component:Center`         | Stable    | —                                |
-| Box size | `width`, `height`, `maxWidth`, `minHeight`: numbers in pixels or CSS strings | Center's own box size.                 | Always                                    | unset   | `family:layout-primitives` | Stable    | Strings pass through as CSS.     |
-| Padding  | Spacing steps per edge, per axis, or uniform                                 | Local inner padding.                   | Always                                    | unset   | `family:layout-primitives` | Stable    | TypeScript rejects other values. |
-
-## Behavioral and layout contract
-
-| ID  | Invariant                                                                                                                                                                                                                                                                                                                                                                                                                                      | Basis                                    |
-| --- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- |
-| FR1 | Center renders one `div`, `display: flex` by default and `inline-flex` with `isInline`, holding its children in caller order.                                                                                                                                                                                                                                                                                                                  | Current source and tests                 |
-| FR2 | `both` centers on both axes. `horizontal` and `vertical` center the physical horizontal and vertical axes in every writing mode (`family:layout-primitives` physical-axis aliases). Center sets main- and cross-axis centering for `both`, main-axis only for `horizontal`, and cross-axis only for `vertical`. Implementation gap: in vertical writing modes the single-axis values center the opposite physical axis (Current-state impact). | Current source, tests, and family record |
-| FR3 | `width`, `height`, `maxWidth`, and `minHeight` apply numbers as pixels and strings as given.                                                                                                                                                                                                                                                                                                                                                   | Current source and tests                 |
-| FR4 | Padding resolves per logical edge: the edge prop, then its axis prop (`paddingInline` or `paddingBlock`), then `padding`; zero is an explicit step. Inline edges follow the writing direction.                                                                                                                                                                                                                                                 | Current source, tests, and family record |
-| FR5 | Center padding publishes no container-padding variables.                                                                                                                                                                                                                                                                                                                                                                                       | Current source and family record         |
-| FR6 | The root carries the `center` target and reflects `axis`; a caller `data-axis` does not replace it. `ref` reaches the `div`; supported DOM, ARIA, data, and event props reach it before the component's target and styles; `xstyle`, `className`, and `style` merge in that order.                                                                                                                                                             | Current source and tests                 |
-| FR7 | Center adds no breakpoint, overflow behavior, gap, or structural region. It renders on the server without a client boundary.                                                                                                                                                                                                                                                                                                                   | Current source and tests                 |
-
-### Allowed variation
-
-- **AV1 — Caller content.** Any content may appear inside Center and keeps its
-  own semantics and theming.
-- **AV2 — Available space.** Parent layout and size inputs change the box
-  without changing the axis contract.
-
-### Representative states
-
-| State                      | Required invariant                                                                             | Allowed variation |
-| -------------------------- | ---------------------------------------------------------------------------------------------- | ----------------- |
-| Both axes                  | Main- and cross-axis centering.                                                                | Box size.         |
-| Horizontal only            | The physical horizontal axis is centered; no physical vertical centering is added.             | Height.           |
-| Vertical only              | The physical vertical axis is centered; no physical horizontal centering is added.             | Width.            |
-| Vertical writing           | Single-axis values still name physical axes (today they center the opposite one, the FR2 gap). | —                 |
-| Inline                     | `inline-flex` with the selected axis.                                                          | —                 |
-| Asymmetric logical padding | Start and end keep their meaning; physical edges swap with direction.                          | —                 |
-
-### Transformation and precedence order
-
-- **ORD1 — Padding per edge.** Edge prop → axis prop → `padding`.
-- **ORD2 — Root attributes.** Caller props → component target, reflected axis,
-  and styles → `xstyle` → `className` → `style`.
-
-### Performance and resources
-
-- **PR1 — Static render.** Center holds no state and uses no hooks.
-
-## Accessibility contract
-
-- **AR1 — Passive container.** Center adds no role, name, state, focus
-  behavior, or live region of its own; caller ARIA and role props reach the
-  root.
-- **AR2 — Reading order.** Children render in caller order and are not visually
-  reordered.
-
-## Design relationships
-
-| Anatomy or state | Design requirement                                                | Representation authority                             | Hierarchy role    | Component contract |
-| ---------------- | ----------------------------------------------------------------- | ---------------------------------------------------- | ----------------- | ------------------ |
-| Container        | One- or two-axis centering with optional local inset, no surface. | Current source, docs, and `family:layout-primitives` | Supporting layout | FR1–FR7            |
-| Content          | Caller content inside the container.                              | Caller-owned content                                 | Context-dependent | AV1, AR1, AR2      |
-
-### Theming anatomy
-
-<!-- anatomy-theming:v1 -->
-
-```json
-{
-  "Container": {"target": "center"},
-  "Content": {
-    "none": {
-      "reason": "intentional: Caller-supplied content retains its own theming ownership; Center applies no content target."
-    }
-  }
-}
-```
-
-## Family and system relationships
-
-- `family:layout-primitives` owns the shared size and padding vocabulary,
-  padding precedence, and the physical-axis meaning of `horizontal` and
-  `vertical`; FR2 records Center's gap against it.
-- `architecture:container-padding` records Center padding as local (FR5).
-- `architecture:public-component-api` owns passthrough, styling composition, ref
-  reachability, and the owned-attribute boundary (FR6).
-- `spec:AST-002` owns admission of any change to this public surface.
-
-## Verification map
-
-| Contract            | Verification                                                                                                                                      | Representative states                                  | Mutation or failure expectation                                                                                                                                                                                                                                                                                                                                                                         | Audit section           |
-| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
-| FR1, FR2            | `Center.test.tsx` axis and inline tests; stable visual baselines `core-center--default` (neutral and probe themes)                                | Both, horizontal, vertical; inline; default            | A wrong computed display, `align-items`, or `justify-content` fails; a changed default centering comes back changed for review. Gap: no automated check runs a vertical writing mode or asserts child order.                                                                                                                                                                                            | `audit:Center/behavior` |
-| FR3                 | `Center.test.tsx` sizing tests                                                                                                                    | Width, height, both                                    | Gap: the sizing tests assert only that the element renders, so the pixel conversion and string pass-through have no automated check.                                                                                                                                                                                                                                                                    | `audit:Center/layout`   |
-| FR4                 | `Center.test.tsx` padding-precedence suite; `@astryx/no-physical-properties` lint rule; RTL audit dimension D8 on `core-center--padding-per-edge` | Uniform, axis, edge, zero, all four edges; LTR and RTL | Edge over axis on the end edges, and edge over uniform on inline-start, inline-end, and block-start, fails; a physical left/right padding property fails lint; the RTL audit fails unless logical start and end padding swap physical sides. Gap: edge over axis on the start edges, edge over uniform on block-end, and axis over uniform have no check, and CI keeps RTL audit findings non-blocking. | `audit:Center/layout`   |
-| FR5, FR7            | `serverSafeComponents.test.ts`; `Center.test.tsx` server-render test; source review                                                               | Padded container                                       | A client boundary fails `serverSafeComponents.test.ts`; a server-render error fails the Center test. Gap: a hook added together with a client directive passes every check; publishing container-padding variables, or adding a breakpoint, overflow rule, gap, or region, has no automated check.                                                                                                      | `audit:Center/layout`   |
-| FR6                 | `Center.test.tsx` ref, passthrough, xstyle, and owned-attribute tests; `themingTargets.test.ts`                                                   | Every axis; colliding `data-axis`                      | A lost target or a caller `data-axis` winning fails. Gap: the ref test accepts any `div`, so a ref on a wrapper passes, and the styling-input merge order has no check.                                                                                                                                                                                                                                 | `audit:Center/theming`  |
-| AR1, AR2, PR1       | `serverSafeComponents.test.ts`; source review                                                                                                     | Multiple children                                      | A hook added without a client directive fails `serverSafeComponents.test.ts`. Gap: a hook added together with a client directive passes, and no automated check fails if Center adds semantics or reorders children.                                                                                                                                                                                    | `audit:Center/a11y`     |
-| Theming anatomy map | `scripts/check-knowledge.mjs`                                                                                                                     | Consumer anatomy and current target                    | Missing, extra, or stale mappings fail repository validation.                                                                                                                                                                                                                                                                                                                                           | `audit:Center/theming`  |
-
-## Decision log
-
-None recorded. The record describes shipped behavior.
-
-## Open questions
-
-None.
-
-## 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.