An open source design system that's fully customizable and agent ready
TypeScript
docs(InputGroupText): point verification at the tests that closed its gaps (#10103)
Cindy Zhangff939deda6ca
diff --git a/docs/specs/components/InputGroup/InputGroupText.spec.md b/docs/specs/components/InputGroup/InputGroupText.spec.mdindex 0df4531881..d6695f8a22 100644--- a/docs/specs/components/InputGroup/InputGroupText.spec.md+++ b/docs/specs/components/InputGroup/InputGroupText.spec.md@@ -13,6 +13,9 @@ review_triggers: [public-api, layout, theming]verified_by:[packages/core/src/InputGroup/InputGroup.test.tsx,+ packages/core/src/InputGroup/InputGroupText.test.tsx,+ packages/core/src/InputGroup/__tests__/InputGroupTextAudit.a11y.chromium.spec.ts,+ packages/core/src/utils/mergeProps.test.ts,apps/storybook/rtl-audit/targets.json,]modules: []@@ -124,11 +127,14 @@ No design record governs InputGroupText.## 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` |-| RTL relation | RTL audit curated D2 target (`apps/storybook/rtl-audit/targets.json`) on `InputGroup / With prefix` | A text prefix before a text input; LTR and RTL | A prefix that is not at the inline start of its input fails D2. | `audit:InputGroupText/i18n-rtl` |+| Contract | Verification | Representative states | Mutation or failure expectation | Audit section |+| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------- |+| FR1 | `InputGroupText.test.tsx` "is plain text with no role and no tab stop (FR1, AR1)" and "passes ref, DOM props, className, and style to the cell, which carries its target (FR1, FR4)"; `InputGroup.test.tsx` addon and prefix/suffix cases | Prefix and suffix text; a `ref`, a DOM prop, `className`, and `style` | A role, a tab stop, missing addon text, or a prop that does not reach the cell fails. | `audit:InputGroupText/anatomy` |+| FR2 | `InputGroupText.test.tsx` "keeps its content on one line, unshrunk and centered on the cross axis (FR2)"; `InputGroupTextAudit.a11y.chromium.spec.ts` paint checks | Prefix, suffix, and both; small and large sizes; a narrow viewport; light, dark, and Butter | Wrapping, shrinking, off-centre content, or padding, text colour, font size, or background other than the token fails. Evidence gap: no check asserts the body font family or line height. | `audit:InputGroupText/layout` |+| FR3 | `InputGroupTextAudit.a11y.chromium.spec.ts` border, join, and corner checks | A prefix and a suffix around a text input; LTR and RTL | A border colour or width other than the token, a border style other than `solid`, an overlap other than one border width, or a rounded inner corner fails. | `audit:InputGroupText/layout` |+| FR4 | `InputGroupText.test.tsx` "passes ref, DOM props, className, and style to the cell, which carries its target (FR1, FR4)"; `InputGroupTextAudit.a11y.chromium.spec.ts` class check | Each cell | A cell without `astryx-input-group-text` fails. | `audit:InputGroupText/anatomy` |+| ORD1 | `InputGroupText.test.tsx` "applies caller xstyle after its own styles (ORD1)"; `mergeProps.test.ts` "treats a string third argument as an appended className" and "applies the fourth argument as an overriding style" | A caller `xstyle`, `className`, and `style` that override a cell style | A cell style that wins over caller `xstyle`, a caller `className` that replaces the cell classes instead of being appended, or a caller `style` that does not override fails. | `audit:InputGroupText/anatomy` |+| RTL relation | RTL audit curated D2 target (`apps/storybook/rtl-audit/targets.json`) on `InputGroup / With prefix`; `InputGroupTextAudit.a11y.chromium.spec.ts` RTL case on `InputGroup / With prefix and suffix` | A text prefix before a text input, and a prefix and suffix around one; LTR and RTL | A prefix that is not at the inline start of its input fails D2. In the audit, a cell that does not follow the row direction, or an overlap on the wrong side, fails. | `audit:InputGroupText/i18n-rtl` |## Decision log