Skip to content

An open source design system that's fully customizable and agent ready

TypeScript

docs(InputGroup): the verification map and status paint match main (#10003)

Cindy Zhang6089ee62e7ec
diff --git a/docs/specs/components/InputGroup/InputGroup.spec.md b/docs/specs/components/InputGroup/InputGroup.spec.md
index ad57f3461b..d63ab9246e 100644
--- a/docs/specs/components/InputGroup/InputGroup.spec.md
+++ b/docs/specs/components/InputGroup/InputGroup.spec.md
@@ -10,7 +10,11 @@ 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]
+verified_by:
+ [
+ packages/core/src/InputGroup/InputGroup.test.tsx,
+ packages/core/src/InputGroup/__tests__/InputGroupAudit.a11y.chromium.spec.ts,
+ ]
modules: []
families: [family:input-fields]
design_specs: [design:reduced-motion]
@@ -28,15 +32,15 @@ system_specs: [spec:AST-038, spec:AST-085, spec:AST-102]
## 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. |
+| 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 or DOM change and no changed prop value. The row holds a fixed height, Button addons scale under reduced motion, and the row accepts root styling against FR10's scope; 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.
@@ -158,15 +162,16 @@ map.
## 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` |
+| Contract | Verification | Representative states | Mutation or failure expectation | Audit section |
+| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
+| FR1, AR1 | `InputGroup.test.tsx` label, description, status, hidden-label, marker and label-tooltip cases; `InputGroupAudit.a11y.chromium.spec.ts` label, hidden-label, description and status cases | Visible and hidden label; optional and required marker; label tooltip; description and status | A missing group name or description, a missing marker or label tooltip, a hidden label that shows, or a status message missing from the description or not below the row fails. | `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 | `InputGroupAudit.a11y.chromium.spec.ts` joined-corner and member-height checks | Button addon combinations; prefix and suffix; right-to-left | A member that rounds toward a neighbour, an outer corner that is square where it should round, or a member shorter than the row fails. Evidence gap: no test covers a wrapped addon or the reduced-motion press; `component:Button` verifies its own side. | `audit:InputGroup/layout` |
+| FR5 | `InputGroup.test.tsx` row-reflection and data-testid cases | Root; `size` and `status` | A missing `astryx-input-group` target, `data-size` or `data-status`, a `ref` that does not reach the row, or a dropped test id fails. Evidence gap: no test asserts `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, ORD1 | `InputGroup.test.tsx` size-precedence case; `InputGroupAudit.a11y.chromium.spec.ts` row-height check | Explicit `size`, outer provider, and no `size` given; `sm`, `md`, `lg` rows | A size that ignores the prop or the provider, an input that does not take the group's size, or rows that do not grow from `sm` to `lg` fails. Evidence gap: no test asserts growth with a set text size (FR3's gap). | `audit:InputGroup/layout` |
+| FR6 (paint), ORD2, AR3 | `InputGroupAudit.a11y.chromium.spec.ts` disabled, description and focus cases; `InputGroup.test.tsx` description-order case | Disabled group; description then status; keyboard focus on each of two adjacent members | A disabled row that is not half opacity with the arrow cursor, a status message before the description, or a focused member that is not above every unfocused member fails. | `audit:InputGroup/behavior` |
+| PR1 | Evidence gap: no test asserts the absence of observers | — | — | `audit:InputGroup/behavior` |
## Current-state impact
@@ -181,9 +186,6 @@ map.
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