@astryxdesign/core 0.7.6-canary.fdabeba → 0.7.6

package/src/Indicator/Indicator.spec.md

@@ -1,188 +0,0 @@
----
-schema_version: 3
-template_version: 7
-kind: component
-id: component:Indicator
-authority: current
-archive_reason: null
-superseded_by: null
-approved_by: cixzhang
-approved_at: 2026-10-31
-owners: [cixzhang]
-review_triggers: [public-api, behavior, theming, accessibility]
-verified_by:
-  [
-    packages/core/src/Indicator/Indicator.test.tsx,
-    packages/core/src/Indicator/indicatorRegistry.test.tsx,
-    packages/core/src/theme/themingTargets.test.ts,
-  ]
-modules: []
-families: []
-design_specs: []
-architecture:
-  [
-    architecture:component-theming-surface,
-    architecture:public-component-api,
-    architecture:theme-authoring-contract,
-  ]
-contributing: []
-system_specs: []
----
-
-# Indicator component contract
-
-## Contract at a glance
-
-| Area                    | Contract                                                                                                                                                                                                                                                                   |
-| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Public contract         | None changes. `@astryxdesign/core/Indicator` exports the three built-in indicators (`CheckboxIndicator`, `CheckIndicator`, `RadioIndicator`), the shared indicator props and types, the default registry, and name-based resolution.                                       |
-| Behavior                | Hosts draw a decorative control visual by name (`check`, `checkbox`, `radio`). A theme's `indicators` entry for that name replaces it in every host that resolves indicators by name; otherwise the built-in renders. Every indicator is hidden from assistive technology. |
-| End-user impact         | People see one consistent mark for a chosen option, a checkbox, or a radio across the components that resolve indicators by name, and screen-reader users hear the host control's semantics, never a duplicate.                                                            |
-| Builder impact          | None.                                                                                                                                                                                                                                                                      |
-| Compatibility/readiness | Records shipped behavior; no API, default, or DOM change. Three hosts render the built-ins directly instead of resolving by name; listed under Current-state impact.                                                                                                       |
-| Review checks           | Reject an indicator that is exposed to assistive technology, a theme override that a host resolving by name ignores, a falsy `children` that suppresses the built-in mark, or a role or tab stop on an indicator.                                                          |
-| Governing rules         | `architecture:component-theming-surface`; `architecture:public-component-api` INV5; `architecture:theme-authoring-contract`.                                                                                                                                               |
-
-This table is a review projection; the body below is authoritative.
-
-## Intent
-
-Indicator is the shared, replaceable set of decorative control visuals: the
-mark on a chosen option, the box a checkbox draws, and the circle a radio
-draws. It owns the indicator names, theme replacement by name, the shared
-decorative prop contract, and RadioIndicator. Consumer usage lives in
-`Indicator.doc.mjs`.
-
-## Compatibility and migration
-
-- Released default preserved: `yes`; with no theme override, `check`,
-  `checkbox`, and `radio` resolve to the built-ins
-- Compatibility class: records shipped behavior; no public prop, default,
-  export, or DOM change
-- Controlled/uncontrolled behavior: not applicable; hosts supply `state`
-- Migration decision: none
-
-Consumer migration instructions belong in consumer docs and release notes.
-
-## Ownership boundary
-
-**Owns**
-
-- The core indicator names and the default registry that maps them to the
-  built-ins.
-- Theme replacement by name and the shared indicator prop contract.
-- RadioIndicator, documented as an inline component of `Indicator.doc.mjs`,
-  with the `radio-indicator` and `radio-indicator-dot` targets.
-- The `indicatorScope` marker hosts put on the element whose hover drives the
-  indicator's hover tint.
-
-**Does not own / non-goals**
-
-- CheckboxIndicator — owned by `component:CheckboxIndicator`.
-- CheckIndicator — owned by `component:CheckIndicator`.
-- Role, name, state, focus, keyboard, and activation of the host control —
-  owned by each host (CheckboxInput, RadioList, Selector, menu rows).
-- `useIndicator` and `getIndicator` as API — a public hook and function without
-  their own module records; uncontracted beyond the resolution FR2 states.
-
-## Public concepts
-
-| Concept             | Closed values or states                                | Meaning                                           | Availability by variant/orientation/state | Default  | Owner                 | Stability | Invalid-value behavior                                              |
-| ------------------- | ------------------------------------------------------ | ------------------------------------------------- | ----------------------------------------- | -------- | --------------------- | --------- | ------------------------------------------------------------------- |
-| Indicator name      | `check`, `checkbox`, `radio`, plus augmented names     | Which visual a host draws.                        | Always.                                   | —        | `component:Indicator` | Stable    | An augmented name no theme supplies resolves to nothing.            |
-| State               | `unchecked`, `checked`, and `indeterminate` (checkbox) | The host's selection state.                       | Per indicator family.                     | required | `component:Indicator` | Stable    | TypeScript rejects values outside the family.                       |
-| Size                | `sm`, `md`                                             | Indicator box size.                               | Always.                                   | `md`     | `component:Indicator` | Stable    | TypeScript rejects other values.                                    |
-| Replacement content | renderable `children`                                  | Content drawn instead of the built-in state mark. | Always.                                   | none     | `component:Indicator` | Stable    | Nullish, boolean, and empty-string children keep the built-in mark. |
-
-## Behavioral and layout contract
-
-| ID  | Invariant                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Basis                                                   |
-| --- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
-| FR1 | The default registry maps exactly `check` → CheckIndicator, `checkbox` → CheckboxIndicator, and `radio` → RadioIndicator.                                                                                                                                                                                                                                                                                                                                                                | Current tests                                           |
-| FR2 | A host resolves an indicator by name from the nearest theme: the theme's `indicators` entry for that name wins, otherwise the built-in. One override reaches every host that resolves that name. The Tokenizer bottom sheet and the Lab MobileTokenizer and MobilePowerSearch value editor render CheckboxIndicator and RadioIndicator directly, so a theme's `checkbox` or `radio` entry does not reach them. An augmented name resolves only when a theme supplies it.                 | `architecture:theme-authoring-contract`; current tests  |
-| FR3 | Every built-in indicator root sets `aria-hidden="true"` after caller props, so a caller cannot expose it; the public props type rejects `role` and `tabIndex`. Indicators receive `state`, `size`, `isDisabled`, and `children` and nothing that would give them semantics.                                                                                                                                                                                                              | `architecture:public-component-api` INV5; current tests |
-| FR4 | Renderable `children` replace the built-in state mark inside the indicator; nullish, boolean, and empty-string children keep it, and `0` counts as content.                                                                                                                                                                                                                                                                                                                              | Current tests                                           |
-| FR5 | RadioIndicator renders one circular span (20 or 24 CSS px) whose border and fill follow the state: an emphasized border on the surface when unchecked, an accent fill when checked with an on-accent dot (8 or 10 CSS px) inside. Disabled halves the opacity and mutes the border (and the fill when unchecked). Under a hover-capable pointer, hovering the host's `indicatorScope` tints it. The dot stays visible under forced colors. Transitions are instant under reduced motion. | Current source and tests                                |
-| FR6 | RadioIndicator's root carries `astryx-radio-indicator` with `data-size`, `data-checked`, and `data-disabled`; the dot carries `astryx-radio-indicator-dot` with `data-size`. No alias target is emitted. Caller props, `ref`, `className`, `style`, and `xstyle` reach the root.                                                                                                                                                                                                         | `architecture:component-theming-surface`; current tests |
-
-### Allowed variation
-
-- **AV1 — Replacement.** A theme may replace any named indicator with a
-  component that honors FR3.
-- **AV2 — Theme paint.** Themes may restyle the built-ins through their
-  targets without replacing them.
-
-### Representative states
-
-| State             | Required invariant                                    | Allowed variation |
-| ----------------- | ----------------------------------------------------- | ----------------- |
-| No theme override | Built-ins render for each name.                       | —                 |
-| Theme override    | Every host that resolves the name draws the override. | Override design.  |
-| Radio checked     | Accent circle with dot; `data-checked`.               | Size.             |
-| Falsy children    | Built-in mark still renders.                          | —                 |
-
-### Transformation and precedence order
-
-- **ORD1 — Resolution.** Nearest theme's `indicators[name]`, then the built-in,
-  then nothing for an unsupplied augmented name.
-- **ORD2 — Attributes.** Caller props, then the indicator's own `aria-hidden`.
-
-### Performance and resources
-
-- **PR1 — Pure render.** Indicators own no state, effect, listener, or
-  observer.
-
-## Accessibility contract
-
-- **AR1 — Decorative.** Indicators are hidden from assistive technology; the
-  host owns all semantics (FR3).
-- **AR2 — Forced colors.** The radio dot stays visible under forced colors.
-
-## Design relationships
-
-| Anatomy or state | Design requirement                                | Representation authority | Hierarchy role | Component contract |
-| ---------------- | ------------------------------------------------- | ------------------------ | -------------- | ------------------ |
-| Radio circle     | Emphasized border unchecked; accent fill checked. | Current source           | Supporting     | FR5, FR6           |
-| Radio dot        | On-accent dot when checked.                       | Current source           | Supporting     | FR5, FR6           |
-
-No design record governs Indicator. The checkbox and check visuals are owned by
-their own records.
-
-## Family and system relationships
-
-- `architecture:theme-authoring-contract` owns how a theme supplies
-  `indicators`.
-- `component:CheckboxIndicator` and `component:CheckIndicator` own the other two
-  built-ins.
-- CheckboxInput, RadioListItem, Selector, and menu selection rows host
-  indicators.
-
-## Verification map
-
-| Contract        | Verification                                                                                               | Representative states                                                                                      | Mutation or failure expectation                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Audit section                   |
-| --------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------- |
-| FR1, FR2        | `indicatorRegistry.test.tsx`; `Indicator.test.tsx` useIndicator suite                                      | No theme; theme override; augmented names                                                                  | A wrong default, an ignored override, or a resolved unsupplied name fails.                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | `audit:Indicator/behavior`      |
-| FR3             | `Indicator.test.tsx` decorative-contract suite                                                             | Each built-in in the checked state; a caller `aria-hidden={false}`; `role` and `tabIndex` as literal props | An indicator a caller can expose, a dropped ordinary prop, or an accepted literal `role` or `tabIndex` fails. Evidence gap: no test checks `aria-hidden` on the unchecked states.                                                                                                                                                                                                                                                                                                                                                                | `audit:Indicator/accessibility` |
-| FR4             | `Indicator.test.tsx` falsy-children suite                                                                  | `null`, `false`, `''`, `0`, real children                                                                  | A falsy child (`false`, `null`, `undefined`, or `''`) that suppresses any built-in's mark fails, and CheckIndicator treating `0` as empty fails. Evidence gap: no test renders `0` as children of CheckboxIndicator or RadioIndicator.                                                                                                                                                                                                                                                                                                           | `audit:Indicator/behavior`      |
-| FR5, FR6, AR2   | `Indicator.test.tsx` radio-dot, disabled, and target-name cases                                            | Checked and unchecked; disabled; canonical targets                                                         | A dot when unchecked, no dot when checked, a missing checked `data-checked` or disabled `data-disabled`, or an alias target fails. Evidence gap: no test asserts the radio sizes, the state colors (emphasized border, accent fill, on-accent dot), the instant transitions under reduced motion, the disabled opacity and border, the hover tint, the forced-colors dot (the RadioList forced-colors case passes on any matching rule), radio `data-size` on the root and dot, `ref`, or caller `className`, `style`, and `xstyle` on the root. | `audit:Indicator/theming`       |
-| ORD1, ORD2, PR1 | Covered by the FR2 and FR3 rows. Evidence gap: no test asserts the absence of state, effects, or listeners | —                                                                                                          | —                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | `audit:Indicator/behavior`      |
-
-## Current-state impact
-
-- **Direct indicator imports (FR2).** The Tokenizer bottom sheet and the Lab
-  MobileTokenizer and MobilePowerSearch value editor render CheckboxIndicator
-  and RadioIndicator directly, so a theme's `checkbox` or `radio` override does
-  not reach them.
-
-## Decision log
-
-No component-local decision.
-
-## 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/InputGroup/InputGroup.spec.md

@@ -1,199 +0,0 @@
----
-schema_version: 3
-template_version: 7
-kind: component
-id: component:InputGroup
-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]
-verified_by: [packages/core/src/InputGroup/InputGroup.test.tsx]
-modules: []
-families: [family:input-fields]
-design_specs: [design:reduced-motion]
-architecture:
-  [
-    architecture:component-size-cascade,
-    architecture:component-theming-surface,
-    architecture:public-component-api,
-  ]
-contributing: []
-system_specs: [spec:AST-038, spec:AST-085, spec:AST-102]
----
-
-# InputGroup component contract
-
-## Contract at a glance
-
-| Area                    | Contract                                                                                                                                                                                                                                                                      |
-| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Public contract         | None changes. InputGroup takes `label`, `isLabelHidden`, `description`, `isOptional`, `isRequired`, `isDisabled`, `size`, `status`, `labelTooltip`, and input and addon children.                                                                                             |
-| Behavior                | One Field-labelled `role="group"` row at the shared element height that joins admitted inputs, InputGroupText addons, and Button addons into one connected shape, and gives each grouped input the group's name and description.                                              |
-| End-user impact         | People see a prefix, input, and suffix as one field, and screen-reader users hear the group label with each input's own label. A disabled group disables its inputs and Button addons together.                                                                               |
-| Builder impact          | None.                                                                                                                                                                                                                                                                         |
-| Compatibility/readiness | Records shipped behavior; no API, default, or DOM change. The row holds a fixed height, Button addons scale under reduced motion, the row accepts root styling against FR10's scope, and the group border does not paint `status`; all are listed under Current-state impact. |
-| Review checks           | Reject a grouped input that loses the group label or description, inner corners that round, a disabled group whose compatible children stay operable, or an internal input button reshaped as an addon.                                                                       |
-| Governing rules         | `family:input-fields` FR3, AV3; `architecture:component-size-cascade` INV3–INV8; `spec:AST-085` FR7; `spec:AST-038` FR7, FR8; `spec:AST-102` FR4; `design:reduced-motion` DR1.                                                                                                |
-
-This table is a review projection; the body below is authoritative.
-
-## Intent
-
-InputGroup joins an input with prefix and suffix addons into one connected
-row, as `family:input-fields` assigns: it owns the row height, the connected
-outer shape, edge alignment, and the group's label and supporting text.
-Consumer usage lives in `InputGroup.doc.mjs`.
-
-## Compatibility and migration
-
-- Released default preserved: `yes`; `size="md"`, label visible, not disabled
-- Compatibility class: records shipped behavior; no public prop, default,
-  export, or DOM change
-- Controlled/uncontrolled behavior: not applicable
-- Migration decision: none
-
-Consumer migration instructions belong in consumer docs and release notes.
-
-## Ownership boundary
-
-**Owns**
-
-- The group Field (label, description, optional or required marker, label
-  tooltip, detached status message) and the `role="group"` row.
-- The row height and the size it provides to descendants up to the next layer boundary.
-- The group context that tells admitted children they are grouped and which
-  label and description ids to compose.
-- Connected geometry for direct Button addons.
-- The `input-group` target.
-
-**Does not own / non-goals**
-
-- Each grouped input's own adaptation (hidden inner label, no nested Field,
-  grouped corners, status icon handling) — owned by that input under
-  `family:input-fields` FR3.
-- The text addon — owned by `component:InputGroupText` (this lane).
-- Which inputs are admitted — decided per component under
-  `family:input-fields` FR3; membership alone does not admit one.
-- Disabling caller-owned controls that do not read the group — not provided.
-
-## Public concepts
-
-| Concept  | Closed values or states                         | Meaning                                         | Availability by variant/orientation/state | Default                   | Owner                  | Stability | Invalid-value behavior           |
-| -------- | ----------------------------------------------- | ----------------------------------------------- | ----------------------------------------- | ------------------------- | ---------------------- | --------- | -------------------------------- |
-| Size     | `sm`, `md`, `lg`                                | Row height and default size for children.       | Always.                                   | Inherited size, else `md` | `family:input-fields`  | Stable    | TypeScript rejects other values. |
-| Status   | `error`, `warning`, `success`, optional message | Group validation state.                         | Always; the message is detached.          | none                      | `component:InputGroup` | Stable    | TypeScript rejects other types.  |
-| Disabled | off, on                                         | Disables the group and its compatible children. | Always.                                   | off                       | `component:InputGroup` | Stable    | Not applicable.                  |
-
-## Behavioral and layout contract
-
-| ID  | Invariant                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Basis                                                                               |
-| --- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
-| FR1 | InputGroup renders one Field in group-label mode with `label` (visible unless `isLabelHidden`), `description`, the optional or required marker, `labelTooltip`, and `status` as a detached message. Inside it, the row is one element with `role="group"`, `aria-labelledby` set to the label, and `aria-describedby` set to the description and status message ids that exist.                                                                                                                                                                                                                                                                    | `family:input-fields` FR3; current tests                                            |
-| FR2 | Grouped inputs receive the label id and description ids through context. Each admitted input is named by the group label plus its own label and described by the group's description and status plus its own.                                                                                                                                                                                                                                                                                                                                                                                                                                      | `family:input-fields` FR3; current tests                                            |
-| FR3 | The row is inline-flex, stretched, and transparent; its height is the shared element height for its size, as a minimum that grows with a set text size under `spec:AST-102` FR4. Implementation gap: the height is fixed at that size. It provides its resolved size to descendants up to the next layer boundary (`spec:AST-038` FR7, FR8): explicit `size`, then the nearest outer provider, then `md`.                                                                                                                                                                                                                                          | `family:input-fields` FR3; `architecture:component-size-cascade`; current source    |
-| FR4 | Direct Button addons join the shape: no inner corner rounding toward a neighbour, full row height, and their keyboard focus ring raised above the adjacent member. Buttons deeper inside a grouped input (clear, calendar, disclosure), and a Button addon wrapped in a Tooltip or HoverCard (not a direct child), keep their own shape. A following popover, template, or dialog element does not count as a neighbour. Addons are `component:Button`s outside a ButtonGroup, so their press scale MUST NOT apply under reduced motion (`design:reduced-motion` DR1). Implementation gap: it still applies under reduced motion.                  | Current source; `design:reduced-motion` DR1                                         |
-| FR5 | The `role="group"` row inside the Field box carries `astryx-input-group` and reflects `data-size` and `data-status`. `ref`, `data-testid`, and other DOM props reach the row. InputGroup composes Field, so `family:input-fields` FR10 forbids root `xstyle`, `className`, and `style`. Implementation gap: they are accepted and reach the row.                                                                                                                                                                                                                                                                                                   | `architecture:component-theming-surface`; `family:input-fields` FR10; current tests |
-| FR6 | The group is disabled when its own `isDisabled` or an enclosing InputGroup's is true. A disabled group sets `aria-disabled="true"` on the row, dims it to half opacity with the default cursor, passes the disabled state to the group Field, and disables every compatible child (TextInput, NumberInput, Selector, MultiSelector, DateInput, TimeInput, Typeahead, and Button addons) and nested group up to the next layer boundary; each child then follows its own disabled contract. A child or nested group that disables itself stays disabled when the group is enabled. Caller-owned controls that do not read the group are unaffected. | `spec:AST-085` FR7; `spec:AST-038` FR7, FR8; current tests                          |
-
-### Allowed variation
-
-- **AV1 — Members.** Any admitted input, InputGroupText, Button, and
-  Button-triggered controls may appear in any order.
-- **AV2 — Status paint.** A theme may paint the group from `data-status`; core
-  paints no group border for it.
-
-### Representative states
-
-| State                       | Required invariant                                               | Allowed variation |
-| --------------------------- | ---------------------------------------------------------------- | ----------------- |
-| Prefix text + TextInput     | One row; outer corners only; input named by group and own label. | Size.             |
-| Input + Button suffix       | Button full height, square toward the input.                     | Variant.          |
-| With description and status | Group and inputs described by both; message detached below.      | —                 |
-| Hidden label                | Label visually hidden; still names the group.                    | —                 |
-
-### Transformation and precedence order
-
-- **ORD1 — Size.** Explicit `size`, then outer provider, then `md`; a grouped
-  input's own explicit `size` still wins for that input.
-- **ORD2 — Description.** Group description, then group status message.
-
-### Performance and resources
-
-- **PR1 — No measurement.** Geometry comes from CSS selectors; InputGroup adds
-  no observer or listener.
-
-## Accessibility contract
-
-- **AR1 — Group name.** `role="group"` labelled by the visible or hidden
-  label (FR1).
-- **AR2 — Input names.** Each admitted input combines the group label with its
-  own label, so its purpose stays specific (FR2).
-- **AR3 — Focus.** A focused member is raised above its neighbours so its
-  focus presentation is not covered.
-
-## Design relationships
-
-| Anatomy or state | Design requirement                             | Representation authority | Hierarchy role | Component contract |
-| ---------------- | ---------------------------------------------- | ------------------------ | -------------- | ------------------ |
-| Label            | Group label above the row, or hidden.          | Current source           | Prominent      | FR1                |
-| Prefix addon     | Text or Button before the input, joined to it. | Current source           | Supporting     | FR4                |
-| Input            | The admitted input, filling remaining width.   | Current source           | Prominent      | FR2                |
-| Suffix addon     | Text or Button after the input, joined to it.  | Current source           | Supporting     | FR4                |
-
-`design:reduced-motion` governs the Button addons' press scale (FR4); no other
-design record governs InputGroup. The row carries `input-group`; the
-consumer anatomy names no row part, so this record carries no anatomy-theming
-map.
-
-## Family and system relationships
-
-- `family:input-fields` assigns InputGroup the row height, connected surface,
-  edge alignment, and group focus; admission stays with each input.
-- `component:InputGroupText` supplies the text addon.
-- `component:Button` applies FR4's addon geometry from the group context.
-- `architecture:component-size-cascade` owns size inheritance (FR3).
-
-## Verification map
-
-| Contract             | Verification                                                                                                                                    | Representative states                                                                                      | Mutation or failure expectation                                                                                                                                                                                                                                         | Audit section                    |
-| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
-| FR1, AR1             | `InputGroup.test.tsx` label, description, status, hidden-label cases                                                                            | Visible and hidden label; description and status                                                           | A missing group name or description fails. Evidence gap: no test asserts the optional or required marker or the label tooltip. The hidden-label case checks neither the group name nor the visual hiding, and no test asserts the description-then-status order (ORD2). | `audit:InputGroup/accessibility` |
-| FR2, AR2             | `InputGroup.test.tsx` grouped-input naming cases and the grouped DateInput semantics case                                                       | TextInput, NumberInput, DateInput, Typeahead, Selector, MultiSelector                                      | A grouped input that loses the group or its own label fails.                                                                                                                                                                                                            | `audit:InputGroup/accessibility` |
-| FR4                  | Evidence gap: no InputGroup-level test of addon geometry, wrapped addons, or the reduced-motion press; `component:Button` verifies its own side | —                                                                                                          | —                                                                                                                                                                                                                                                                       | `audit:InputGroup/layout`        |
-| FR5                  | `InputGroup.test.tsx` data-testid case                                                                                                          | Root                                                                                                       | A dropped test id fails. Evidence gap: the size case asserts only rendering; no test asserts the target, `data-size`, `data-status`, `ref`, `className`, `style`, or `xstyle`.                                                                                          | `audit:InputGroup/theming`       |
-| FR6                  | `InputGroup.test.tsx` disabled-propagation cases                                                                                                | Every compatible input and Button addon; nested groups; re-enabled group with an explicitly disabled child | A child that stays operable in a disabled group, a nested group that opts out, or a re-enabled explicitly disabled child fails.                                                                                                                                         | `audit:InputGroup/behavior`      |
-| FR3, FR6 (paint)     | Evidence gap: no assertion of row height, size propagation, or disabled dimming                                                                 | —                                                                                                          | —                                                                                                                                                                                                                                                                       | `audit:InputGroup/layout`        |
-| ORD1, ORD2, PR1, AR3 | Evidence gap: no test asserts size precedence, the description-then-status order, the absence of observers, or a raised focused member          | —                                                                                                          | —                                                                                                                                                                                                                                                                       | `audit:InputGroup/behavior`      |
-
-## Current-state impact
-
-- **Fixed height (FR3).** The row holds the fixed shared element height instead
-  of growing with a set text size, against `spec:AST-102` FR4.
-- **Addon press under reduced motion (FR4).** A Button addon scales to 0.98 on a
-  press when the person prefers reduced motion, as `component:Button` FR15
-  records, against `design:reduced-motion` DR1.
-- **Root styling (FR5).** InputGroup accepts root `className`, `style`, and
-  `xstyle` on its row, against the scope of `family:input-fields` FR10. FR10
-  item 3 names InputGroup as the caller's styling surface, and the family
-  coverage test `Field/fieldInputFamily.test.tsx` leaves InputGroup out of its
-  field inputs, so this gap may close by clarifying FR10 rather than by
-  changing code.
-- **Status paint (AV2).** The consumer docs say `status` is applied to the group
-  border; core reflects it as `data-status` and shows the detached message, and
-  paints no group border.
-
-## Decision log
-
-No component-local decision. InputGroup applies `family:input-fields`.
-
-## 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/InputGroup/InputGroupText.spec.md

@@ -1,139 +0,0 @@
----
-schema_version: 3
-template_version: 7
-kind: component
-id: component:InputGroupText
-authority: current
-archive_reason: null
-superseded_by: null
-approved_by: cixzhang
-approved_at: 2026-10-27
-owners: [cixzhang]
-review_triggers: [public-api, layout, theming]
-verified_by: [packages/core/src/InputGroup/InputGroup.test.tsx]
-modules: []
-families: []
-design_specs: []
-architecture:
-  [architecture:component-theming-surface, architecture:public-component-api]
-contributing: []
-system_specs: []
----
-
-# InputGroupText component contract
-
-## Contract at a glance
-
-| Area                    | Contract                                                                                                                                   |
-| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
-| Public contract         | None changes. InputGroupText takes `children` and the base props.                                                                          |
-| Behavior                | A non-interactive, muted text or icon cell inside InputGroup that joins its neighbours' borders and rounds only the group's outer corners. |
-| End-user impact         | People see a fixed prefix or suffix such as `$` or `https://` as part of the field. It is read as plain text, not as a control.            |
-| Builder impact          | None.                                                                                                                                      |
-| Compatibility/readiness | Records shipped behavior; no API, default, or DOM change.                                                                                  |
-| Review checks           | Reject an interactive role or tab stop on the cell, text that wraps or shrinks, or rounded inner corners.                                  |
-| Governing rules         | `component:InputGroup`; `architecture:component-theming-surface`.                                                                          |
-
-This table is a review projection; the body below is authoritative.
-
-## Intent
-
-InputGroupText is InputGroup's text addon: a fixed piece of text or an icon
-shown before or after the input. Consumer usage lives in
-`InputGroupText.doc.mjs`.
-
-## Compatibility and migration
-
-- Released default preserved: `yes`
-- Compatibility class: records shipped behavior; no public prop, default,
-  export, or DOM change
-- Controlled/uncontrolled behavior: not applicable
-- Migration decision: none
-
-Consumer migration instructions belong in consumer docs and release notes.
-
-## Ownership boundary
-
-**Owns**
-
-- The text cell's paint, sizing, border join, and corner rounding.
-- The `input-group-text` target.
-
-**Does not own / non-goals**
-
-- Group label, row height, and description — owned by `component:InputGroup`.
-- Naming or describing the input — the cell is not referenced by the input's
-  name or description.
-- Use outside InputGroup — uncontracted.
-
-## Public concepts
-
-No new public concept. Content is caller text or an icon.
-
-## Behavioral and layout contract
-
-| ID  | Invariant                                                                                                                                                                                                                                              | Basis                                                    |
-| --- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------- |
-| FR1 | InputGroupText renders one non-interactive element with no role, holding `children`. `ref`, `className`, `style`, `xstyle`, and other DOM props reach it.                                                                                              | Current source and tests                                 |
-| FR2 | The cell centers its content vertically with small inline padding, uses body text in the secondary text color on the muted background, never wraps, and never shrinks.                                                                                 | Current source                                           |
-| FR3 | The cell draws an emphasized one-border-width border. Every cell after the first overlaps its leading neighbour by one border width. Only the first child's leading corners and the last child's trailing corners are rounded with the element radius. | Current source                                           |
-| FR4 | The cell carries `astryx-input-group-text`.                                                                                                                                                                                                            | `architecture:component-theming-surface`; current source |
-
-### Allowed variation
-
-- **AV1 — Content.** Any text or icon; the cell does not inspect it.
-- **AV2 — Theme paint.** Themes may restyle the cell through
-  `input-group-text`.
-
-### Representative states
-
-| State  | Required invariant                                     | Allowed variation |
-| ------ | ------------------------------------------------------ | ----------------- |
-| Prefix | Leading corners rounded; trailing edge square.         | Content.          |
-| Suffix | Trailing corners rounded; overlaps the input's border. | Content.          |
-
-### Transformation and precedence order
-
-- **ORD1 — Styling.** Component styles, then `xstyle`, then `className` and
-  `style`.
-
-### Performance and resources
-
-- **PR1 — Static.** No state, effect, or listener.
-
-## Accessibility contract
-
-- **AR1 — Plain text.** The cell has no role or tab stop and is read as
-  ordinary text in reading order.
-
-## Design relationships
-
-| Anatomy or state | Design requirement                                      | Representation authority | Hierarchy role | Component contract |
-| ---------------- | ------------------------------------------------------- | ------------------------ | -------------- | ------------------ |
-| Text cell        | Muted, bordered, secondary-text cell joined to the row. | Current source           | Supporting     | FR2, FR3           |
-
-No design record governs InputGroupText.
-
-## Family and system relationships
-
-- `component:InputGroup` hosts the cell and owns the row it joins.
-
-## Verification map
-
-| Contract | Verification                                                     | Representative states  | Mutation or failure expectation                                                                                     | Audit section                  |
-| -------- | ---------------------------------------------------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------- | ------------------------------ |
-| FR1      | `InputGroup.test.tsx` addon and prefix/suffix cases              | Prefix and suffix text | Missing addon text fails. Evidence gap: no test asserts the absent role or that `ref` and DOM props reach the cell. | `audit:InputGroupText/anatomy` |
-| FR2–FR4  | Evidence gap: no assertion of cell paint, border join, or target | —                      | —                                                                                                                   | `audit:InputGroupText/layout`  |
-
-## Decision log
-
-No component-local decision.
-
-## 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.