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.mdindex 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: cixzhangapproved_at: 2026-10-27owners: [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 itsfield inputs, so this gap may close by clarifying FR10 rather than bychanging 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