An open source design system that's fully customizable and agent ready
TypeScript
test(rtl): RTL coverage for seven Core parts (Step, OverflowList, dialogs, MobileNav, menus) (#9332)
Cindy Zhange7530dbb458f
diff --git a/apps/storybook/rtl-audit/targets.json b/apps/storybook/rtl-audit/targets.jsonindex f208e7b8f6..3719979ef8 100644--- a/apps/storybook/rtl-audit/targets.json+++ b/apps/storybook/rtl-audit/targets.json@@ -752,6 +752,78 @@"next": "svg[role=\"img\"]"}},+ {+ "component": "Step",+ "storyId": "core-stepper--default-horizontal",+ "dims": ["D2"],+ "selectors": {+ "prev": ".astryx-step:first-child .astryx-step-indicator",+ "next": ".astryx-step:first-child .astryx-step-label"+ }+ },+ {+ "component": "OverflowList",+ "storyId": "core-overflowlist--default",+ "dims": ["D2"],+ "selectors": {+ "prev": ".astryx-overflow-list > button:first-child",+ "next": ".astryx-overflow-list button:has-text(\"more\")"+ }+ },+ {+ "component": "DialogHeader",+ "storyId": "core-dialog--default",+ "dims": ["D2"],+ "setup": {"click": "button:has-text(\"Open Modal\")"},+ "selectors": {+ "prev": ".astryx-dialog-header-title-block",+ "next": ".astryx-dialog-header-end-content"+ }+ },+ {+ "component": "AlertDialog",+ "storyId": "core-alertdialog--delete",+ "dims": ["D2"],+ "setup": {"click": "button:has-text(\"Delete item\")"},+ "selectors": {+ "prev": "[role=\"alertdialog\"] button:has-text(\"Cancel\")",+ "next": "[role=\"alertdialog\"] button:has-text(\"Delete\") >> nth=-1"+ }+ },+ {+ "component": "MobileNav",+ "storyId": "core-mobilenav--default",+ "dims": ["D4"],+ "setup": {"click": "button[aria-label=\"Open Navigation\"]"},+ "selectors": {+ "overlay": "[class*=\"astryx-mobile-nav\"] > div:first-child",+ "overlayRoot": "body"+ }+ },+ {+ "component": "MoreMenu",+ "storyId": "core-moremenu--default",+ "dims": ["D4"],+ "setup": {"click": "button[aria-label=\"More options\"]"},+ "selectors": {+ "overlay": "[role=\"menu\"]",+ "overlayRoot": "button[aria-label=\"More options\"]"+ }+ },+ {+ "component": "Dialog",+ "storyId": "core-dialog--default",+ "dims": []+ },+ {+ "component": "NavHeadingMenu",+ "storyId": "core-navmenu--with-icons",+ "dims": ["D2"],+ "selectors": {+ "prev": ".astryx-nav-heading-menu-item svg.astryx-icon >> nth=0",+ "next": ".astryx-nav-heading-menu-item span.astryx-text:text-is(\"Profile\")"+ }+ },{"component": "ChartLegend","storyId": "charts-chrome-legend--default",diff --git a/docs/specs/components/AlertDialog/AlertDialog.spec.md b/docs/specs/components/AlertDialog/AlertDialog.spec.mdindex 95e1f45b9b..4d2e3646a0 100644--- a/docs/specs/components/AlertDialog/AlertDialog.spec.md+++ b/docs/specs/components/AlertDialog/AlertDialog.spec.md@@ -18,6 +18,7 @@ verified_by:packages/core/src/AlertDialog/__tests__/AlertDialog.a11y.chromium.spec.ts,packages/core/src/Dialog/Dialog.test.tsx,scripts/check-knowledge.mjs,+ apps/storybook/rtl-audit/targets.json,]modules: []families: [family:overlay-dismissal]@@ -222,15 +223,16 @@ The dialog surface (the Dialog element AlertDialog renders) carries `alert-dialo## Verification map-| Contract | Verification | Representative states | Mutation or failure expectation | Audit section |-| -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- |-| FR1–FR5 | `AlertDialog.test.tsx` ("calls onOpenChange(false) on Escape", "does not call onOpenChange when action is clicked", "does not call onAction on Escape", "does not disable the cancel button while the action is loading", "exposes a named group instead, with no aria-modal") and `useImperativeAlertDialog.test.tsx` ("opens on show()", "closes on hide()") | open, loading, inline, imperative | Escape not cancelling, the action closing by itself, or the inline path claiming the role fails. | `audit:AlertDialog/behavior` |-| FR6, PR2 | Browser tests under a coarse pointer in Chromium and WebKit, a spring-curve oracle, a busy-main-thread case, and real-device clips on iOS Safari and Android Chrome | present, dismiss, close during present, reopen during dismiss, Reduce Motion, a fine pointer, a narrow viewport | a curve off its role, a start outside the viewport, a jump on interruption, a scale under Reduce Motion, changed motion under a fine pointer, or an added element fails. No test exists yet; FR6 is not shipped. | `audit:AlertDialog/behavior` |-| FR7 | Browser tests under a coarse pointer, with keyboard and assistive-technology input | a tap during the presentation, Enter and Escape during it, a screen reader's activation, a tap during the dismissal; a mouse click during the presentation under a fine pointer | a held key or assistive-technology action, content made inert during the entrance, a tap that reaches a leaving alert, or a mouse click held under a fine pointer fails. No test exists yet; FR7 is not shipped. | `audit:AlertDialog/behavior` |-| FR8 | Pointer-stream tests with a mouse, a pen, and a finger, and keyboard tests | a press on Cancel slid onto the action and lifted, and a press lifted outside the actions, each with a mouse, a pen, and a finger; Enter and Space on each action | the press-start action running after a slide, any action running on a lift outside, or a changed keyboard or assistive-technology activation fails. No test exists yet; FR8 is not shipped. | `audit:AlertDialog/behavior` |-| FR9 | Browser tests at a phone width and at a desktop width, in the default and an alternate theme | a phone width and a desktop width, in the default and an alternate theme; a caller `width` at a phone width; a screen narrower than 320 px; a narrow window under a fine pointer; a coarse screen that is not compact | a phone-width alert other than 320 px in any theme without a caller `width`, a caller `width` overridden, a desktop width changed, an alert wider than the viewport, or a 320 px alert in a narrow fine-pointer window or on a non-compact coarse screen fails. No test exists yet; FR9 is not shipped. | `audit:AlertDialog/behavior` |-| AR1 | `AlertDialog.test.tsx` ("links title via aria-labelledby", "marks cancel as the initial focus target", "keeps the initial focus target on the least destructive action", "calls onOpenChange(false) on Escape", "stacks long destructive action labels above cancel on a narrow fine-pointer screen", "reaches both buttons by Tab, cancel first", "is a modal alertdialog", "does not claim the alertdialog role") and `useImperativeAlertDialog.test.tsx`; the Alert Dialog accessibility contract binding in `__tests__/AlertDialog.a11y.test.tsx` and `__tests__/AlertDialog.a11y.chromium.spec.ts` (role, description link, no backdrop dismiss, focus delegation) | open modal; after Escape; after Cancel | The role, name link, description link, or Cancel initial focus is lost, or a click outside dismisses the dialog. Gap: the contract keeps `alertdialog.focus.least-destructive-first` and `alertdialog.dismissal.click-beside-is-inert` advisory, so a regression in either only reports; `spec:AST-020` FR9 makes them required once this record is current. No test covers Tab wrapping inside the alert (Current-state impact). | `audit:AlertDialog/accessibility` |-| PR1 | Source review | Small and wide screens | Gap: no automated check fails if AlertDialog adds a listener beyond the small-screen media query. | `audit:AlertDialog/behavior` |+| Contract | Verification | Representative states | Mutation or failure expectation | Audit section |+| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- |+| FR1–FR5 | `AlertDialog.test.tsx` ("calls onOpenChange(false) on Escape", "does not call onOpenChange when action is clicked", "does not call onAction on Escape", "does not disable the cancel button while the action is loading", "exposes a named group instead, with no aria-modal") and `useImperativeAlertDialog.test.tsx` ("opens on show()", "closes on hide()") | open, loading, inline, imperative | Escape not cancelling, the action closing by itself, or the inline path claiming the role fails. | `audit:AlertDialog/behavior` |+| FR6, PR2 | Browser tests under a coarse pointer in Chromium and WebKit, a spring-curve oracle, a busy-main-thread case, and real-device clips on iOS Safari and Android Chrome | present, dismiss, close during present, reopen during dismiss, Reduce Motion, a fine pointer, a narrow viewport | a curve off its role, a start outside the viewport, a jump on interruption, a scale under Reduce Motion, changed motion under a fine pointer, or an added element fails. No test exists yet; FR6 is not shipped. | `audit:AlertDialog/behavior` |+| FR7 | Browser tests under a coarse pointer, with keyboard and assistive-technology input | a tap during the presentation, Enter and Escape during it, a screen reader's activation, a tap during the dismissal; a mouse click during the presentation under a fine pointer | a held key or assistive-technology action, content made inert during the entrance, a tap that reaches a leaving alert, or a mouse click held under a fine pointer fails. No test exists yet; FR7 is not shipped. | `audit:AlertDialog/behavior` |+| FR8 | Pointer-stream tests with a mouse, a pen, and a finger, and keyboard tests | a press on Cancel slid onto the action and lifted, and a press lifted outside the actions, each with a mouse, a pen, and a finger; Enter and Space on each action | the press-start action running after a slide, any action running on a lift outside, or a changed keyboard or assistive-technology activation fails. No test exists yet; FR8 is not shipped. | `audit:AlertDialog/behavior` |+| FR9 | Browser tests at a phone width and at a desktop width, in the default and an alternate theme | a phone width and a desktop width, in the default and an alternate theme; a caller `width` at a phone width; a screen narrower than 320 px; a narrow window under a fine pointer; a coarse screen that is not compact | a phone-width alert other than 320 px in any theme without a caller `width`, a caller `width` overridden, a desktop width changed, an alert wider than the viewport, or a 320 px alert in a narrow fine-pointer window or on a non-compact coarse screen fails. No test exists yet; FR9 is not shipped. | `audit:AlertDialog/behavior` |+| AR1 | `AlertDialog.test.tsx` ("links title via aria-labelledby", "marks cancel as the initial focus target", "keeps the initial focus target on the least destructive action", "calls onOpenChange(false) on Escape", "stacks long destructive action labels above cancel on a narrow fine-pointer screen", "reaches both buttons by Tab, cancel first", "is a modal alertdialog", "does not claim the alertdialog role") and `useImperativeAlertDialog.test.tsx`; the Alert Dialog accessibility contract binding in `__tests__/AlertDialog.a11y.test.tsx` and `__tests__/AlertDialog.a11y.chromium.spec.ts` (role, description link, no backdrop dismiss, focus delegation) | open modal; after Escape; after Cancel | The role, name link, description link, or Cancel initial focus is lost, or a click outside dismisses the dialog. Gap: the contract keeps `alertdialog.focus.least-destructive-first` and `alertdialog.dismissal.click-beside-is-inert` advisory, so a regression in either only reports; `spec:AST-020` FR9 makes them required once this record is current. No test covers Tab wrapping inside the alert (Current-state impact). | `audit:AlertDialog/accessibility` |+| PR1 | Source review | Small and wide screens | Gap: no automated check fails if AlertDialog adds a listener beyond the small-screen media query. | `audit:AlertDialog/behavior` |+| RTL relation | RTL audit curated D2 target (`apps/storybook/rtl-audit/targets.json`) on `AlertDialog / Delete` (dialog opened) | Cancel and confirm actions; LTR and RTL | A cancel action that is not at the inline start of the confirm action fails D2. | `audit:AlertDialog/i18n-rtl` |## Decision logdiff --git a/docs/specs/components/Dialog/modules/DialogHeader.spec.md b/docs/specs/components/Dialog/modules/DialogHeader.spec.mdindex feaf06c789..8be219b905 100644--- a/docs/specs/components/Dialog/modules/DialogHeader.spec.md+++ b/docs/specs/components/Dialog/modules/DialogHeader.spec.md@@ -16,6 +16,7 @@ verified_by:packages/core/src/theme/themingTargets.test.ts,packages/cli/foundation/discovery/theming-targets.test.mjs,scripts/check-knowledge.mjs,+ apps/storybook/rtl-audit/targets.json,]parent_component: component:Dialogreferences:@@ -158,13 +159,14 @@ For this slot-targeted prop, `inline` means the slot's logical inline-end edge,## Verification map-| Contract | Verification | Representative states | Mutation or failure expectation |-| ------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |-| FR1–FR3, FR9–FR10 | Target tests, target inventory, generated probe theme, and source inspection | title only, title/subtitle, start content, end content, close action | A target is missing, undocumented, duplicated, or moved away from its owning painter. |-| FR4–FR5 | Existing content and close-button tests | end content only; close only; both | The close action or slot content disappears, reorders, or gains another wrapper. |-| FR6–FR7 | Focused end-slot class-selection assertions | close only; end content only; both; explicit `inline`, `block`, and `all` | An omitted prop changes released geometry, or an explicit value selects the wrong axes. |-| FR8 | Source inspection, RTL CI, interaction tests, and focused real-browser geometry | LTR and RTL; custom end control; close action | Physical margins, caller-controlled amounts, or hit-target changes enter the implementation. |-| Theming anatomy map | `scripts/check-knowledge.mjs` | all five module anatomy entries and targets | Anatomy, docs, runtime targets, and the module map drift. |+| Contract | Verification | Representative states | Mutation or failure expectation |+| ------------------- | ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |+| FR1–FR3, FR9–FR10 | Target tests, target inventory, generated probe theme, and source inspection | title only, title/subtitle, start content, end content, close action | A target is missing, undocumented, duplicated, or moved away from its owning painter. |+| FR4–FR5 | Existing content and close-button tests | end content only; close only; both | The close action or slot content disappears, reorders, or gains another wrapper. |+| FR6–FR7 | Focused end-slot class-selection assertions | close only; end content only; both; explicit `inline`, `block`, and `all` | An omitted prop changes released geometry, or an explicit value selects the wrong axes. |+| FR8 | Source inspection, RTL CI, interaction tests, and focused real-browser geometry | LTR and RTL; custom end control; close action | Physical margins, caller-controlled amounts, or hit-target changes enter the implementation. |+| Theming anatomy map | `scripts/check-knowledge.mjs` | all five module anatomy entries and targets | Anatomy, docs, runtime targets, and the module map drift. |+| RTL relation | RTL audit curated D2 target (`apps/storybook/rtl-audit/targets.json`) on `Dialog / Default` (dialog opened) | Title block and close control; LTR and RTL | A title that is not at the inline start of the close control fails D2. |## Decision logdiff --git a/docs/specs/components/MobileNav/MobileNav.spec.md b/docs/specs/components/MobileNav/MobileNav.spec.mdindex 1fd887d170..d42cb5bd2f 100644--- a/docs/specs/components/MobileNav/MobileNav.spec.md+++ b/docs/specs/components/MobileNav/MobileNav.spec.md@@ -26,6 +26,7 @@ verified_by:packages/core/src/MobileNav/__tests__/MobileNavWidth.a11y.chromium.spec.ts,packages/core/src/theme/themingTargets.test.ts,scripts/check-knowledge.mjs,+ apps/storybook/rtl-audit/targets.json,]modules: []families: [family:overlay-dismissal]@@ -258,18 +259,19 @@ ownership.## Verification map-| Contract | Verification | Representative states | Mutation or failure expectation | Audit section |-| -------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | ------------------------------- |-| FR1, FR2, FR10, FR12 | `MobileNav.test.tsx` | Open and closed; string and no header; caller `id` on a standalone drawer | Losing the dialog, name, Close, or forwarded props fails. | `audit:MobileNav/anatomy` |-| FR2, FR3, FR4 | `MobileNav.test.tsx`; `MobileNavCloseEdgeCases.test.tsx`; `MobileNavScrollbarGutter.test.tsx` | Escape, backdrop, content click, Close | A wrong close source or a lingering scroll lock fails. | `audit:MobileNav/behavior` |-| FR4 | `layerDismissalFamilies.test.tsx` MobileNav cases | Escape over a required Dialog; cancel while topmost and while not | Closing when not topmost, or not closing when topmost, fails. | `audit:MobileNav/behavior` |-| FR5, ORD3 | `MobileNavCloseVisibility.test.tsx`; `MobileNavCloseEdgeCases.test.tsx`; `MobileNavCloseTiming.test.ts` | Close, reduced motion, reopen, unmount, the 250 ms bound | Closing before the slide-out or a stuck dialog fails. | `audit:MobileNav/behavior` |-| FR6, AR2 | `MobileNavFocus.test.tsx` | Standalone, AppShell, Escape, removed opener | Focus not returned, or returned too early, fails. | `audit:MobileNav/accessibility` |-| FR7 | `MobileNavEntryAnimation.test.tsx` | Start and end edges | Missing starting style or a scroll-container overlay fails. | `audit:MobileNav/behavior` |-| FR11, AR3 | `MobileNavToggle.test.tsx`; `MobileNavReopen.test.tsx` | Closed, open, reopen | Broken expanded state or id link fails. | `audit:MobileNav/accessibility` |-| AR4 | `MobileNavPinchZoom.a11y.chromium.spec.ts` | Open drawer on a touch viewport | Pinch zoom blocked fails. | `audit:MobileNav/accessibility` |-| FR9 | `MobileNav.test.tsx` drawer cap test; `MobileNavWidth.a11y.chromium.spec.ts` | Default and wide `width` on a narrow viewport | A drawer wider than 85% of the viewport fails. | `audit:MobileNav/behavior` |-| Theming anatomy map | `scripts/check-knowledge.mjs`; `themingTargets.test.ts` | Canonical parent anatomy and current target | Missing, extra, prefixed, stale, or multiply assigned mappings fail repository validation. | `audit:MobileNav/theming` |+| Contract | Verification | Representative states | Mutation or failure expectation | Audit section |+| -------------------- | -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- |+| FR1, FR2, FR10, FR12 | `MobileNav.test.tsx` | Open and closed; string and no header; caller `id` on a standalone drawer | Losing the dialog, name, Close, or forwarded props fails. | `audit:MobileNav/anatomy` |+| FR2, FR3, FR4 | `MobileNav.test.tsx`; `MobileNavCloseEdgeCases.test.tsx`; `MobileNavScrollbarGutter.test.tsx` | Escape, backdrop, content click, Close | A wrong close source or a lingering scroll lock fails. | `audit:MobileNav/behavior` |+| FR4 | `layerDismissalFamilies.test.tsx` MobileNav cases | Escape over a required Dialog; cancel while topmost and while not | Closing when not topmost, or not closing when topmost, fails. | `audit:MobileNav/behavior` |+| FR5, ORD3 | `MobileNavCloseVisibility.test.tsx`; `MobileNavCloseEdgeCases.test.tsx`; `MobileNavCloseTiming.test.ts` | Close, reduced motion, reopen, unmount, the 250 ms bound | Closing before the slide-out or a stuck dialog fails. | `audit:MobileNav/behavior` |+| FR6, AR2 | `MobileNavFocus.test.tsx` | Standalone, AppShell, Escape, removed opener | Focus not returned, or returned too early, fails. | `audit:MobileNav/accessibility` |+| FR7 | `MobileNavEntryAnimation.test.tsx` | Start and end edges | Missing starting style or a scroll-container overlay fails. | `audit:MobileNav/behavior` |+| FR11, AR3 | `MobileNavToggle.test.tsx`; `MobileNavReopen.test.tsx` | Closed, open, reopen | Broken expanded state or id link fails. | `audit:MobileNav/accessibility` |+| AR4 | `MobileNavPinchZoom.a11y.chromium.spec.ts` | Open drawer on a touch viewport | Pinch zoom blocked fails. | `audit:MobileNav/accessibility` |+| FR9 | `MobileNav.test.tsx` drawer cap test; `MobileNavWidth.a11y.chromium.spec.ts` | Default and wide `width` on a narrow viewport | A drawer wider than 85% of the viewport fails. | `audit:MobileNav/behavior` |+| Theming anatomy map | `scripts/check-knowledge.mjs`; `themingTargets.test.ts` | Canonical parent anatomy and current target | Missing, extra, prefixed, stale, or multiply assigned mappings fail repository validation. | `audit:MobileNav/theming` |+| RTL relation | RTL audit curated D4 target (`apps/storybook/rtl-audit/targets.json`) on `MobileNav / Default` (drawer opened) | The open drawer; LTR and RTL | A drawer that does not move to the mirrored side of the page in RTL fails D4. Evidence gap: the story centres its opener, so the documented `side="auto"` far-side RTL drawer (FR8) is not observed. | `audit:MobileNav/i18n-rtl` |Read from source, with no focused test yet:diff --git a/docs/specs/components/MoreMenu/MoreMenu.spec.md b/docs/specs/components/MoreMenu/MoreMenu.spec.mdindex 9947098871..4198e5ab35 100644--- a/docs/specs/components/MoreMenu/MoreMenu.spec.md+++ b/docs/specs/components/MoreMenu/MoreMenu.spec.md@@ -21,6 +21,7 @@ verified_by:packages/core/src/Icon/Icon.test.tsx,packages/core/src/List/List.test.tsx,scripts/check-knowledge.mjs,+ apps/storybook/rtl-audit/targets.json,]modules: []families: [family:overlay-dismissal]@@ -239,6 +240,7 @@ presentation.| AR1 | `MoreMenu.test.tsx` label, popup, and pointer-focus tests; the menu-button pattern binding `MenuButton.a11y.test.tsx` and `MenuButton.a11y.chromium.spec.ts`, which render MoreMenu states; `DropdownMenu.test.tsx` ArrowDown and ArrowUp trigger-key tests on the shared Button trigger path | Default and custom-icon triggers; closed/open; Enter, Space, ArrowDown, ArrowUp | The trigger loses its label, `aria-haspopup="menu"`, `aria-expanded` or `aria-controls`, or an Enter or Space open does not land on the first enabled row | `audit:MoreMenu/accessibility` || Layer relationships | `MoreMenu.test.tsx`, `DropdownMenu.test.tsx`, and current layer/dismissal records | Light dismiss, Escape, pointer, touch | Documentation gives MoreMenu a parallel runtime or misstates the current dismissal owner. | `audit:MoreMenu/behavior` || Theming anatomy map | `scripts/check-knowledge.mjs` | Canonical anatomy and current target | Missing, extra, prefixed, stale, or unclassified mappings fail repository validation. | `audit:MoreMenu/theming` |+| RTL relation | RTL audit curated D4 target (`apps/storybook/rtl-audit/targets.json`) on `MoreMenu / Default` (menu opened) | The open menu against its trigger; LTR and RTL | A menu that does not move to the mirrored side of its trigger in RTL fails D4. | `audit:MoreMenu/i18n-rtl` |Read from source, with no focused test yet:diff --git a/docs/specs/components/NavMenu/NavHeadingMenu.spec.md b/docs/specs/components/NavMenu/NavHeadingMenu.spec.mdindex bac8727f04..78cbf42402 100644--- a/docs/specs/components/NavMenu/NavHeadingMenu.spec.md+++ b/docs/specs/components/NavMenu/NavHeadingMenu.spec.md@@ -18,6 +18,7 @@ verified_by:packages/core/src/Text/Text.test.tsx,packages/core/src/theme/themingTargets.test.ts,scripts/check-knowledge.mjs,+ apps/storybook/rtl-audit/targets.json,]modules: []families: [family:navigation-destinations, family:action-groups]@@ -231,14 +232,15 @@ owns the layer lifecycle and supplies the close callback through context.## Verification map-| Contract | Verification | Representative states | Mutation or failure expectation | Audit section |-| ------------------- | ------------------------------------------------------------------------------ | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------- |-| FR1, FR2 | `NavHeadingMenu.test.tsx` role, render, link, and disabled suites | Menu with link, action, and disabled Items | Removing menu/item semantics, content, or current rendering branches fails existing role, tag, attribute, and text checks. | `audit:NavHeadingMenu/anatomy` |-| FR3 | NavHeadingMenuItem source inspection plus Icon and Text target metadata | Icon, string label, caller-rendered label, and description paths | Source proves Icon-slot delegation, conditional label rendering, and Text-wrapped description; focused tests assert string and description content but not target placement or custom-label ownership. | `audit:NavHeadingMenu/theming` |-| FR4–FR7 | `NavHeadingMenu.test.tsx` context, keyboard, disabled, and pass-through suites | Selection, Escape, arrows, Home/End, typeahead, disabled, caller handlers | Breaking close callback consumption, keyboard behavior, or role precedence fails focused interaction assertions. | `audit:NavHeadingMenu/behavior` |-| Target inventory | Source inspection and `themingTargets.test.ts` | Menu, Item, and delegated Icon targets | Runtime and documented target metadata drift fails target validation. | `audit:NavHeadingMenu/theming` |-| Theming anatomy map | `scripts/check-knowledge.mjs` | Canonical anatomy and both current local targets | Missing, extra, prefixed, or stale mappings fail repository validation. | `audit:NavHeadingMenu/theming` |-| FR8 | `NavHeadingMenu.test.tsx` action-group suite (touch and mouse slides) | Touch and mouse slides across items; a disabled item; undraggable link items | Removing the adoption fails the slide tests. | — |+| Contract | Verification | Representative states | Mutation or failure expectation | Audit section |+| ------------------- | ----------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------- |+| FR1, FR2 | `NavHeadingMenu.test.tsx` role, render, link, and disabled suites | Menu with link, action, and disabled Items | Removing menu/item semantics, content, or current rendering branches fails existing role, tag, attribute, and text checks. | `audit:NavHeadingMenu/anatomy` |+| FR3 | NavHeadingMenuItem source inspection plus Icon and Text target metadata | Icon, string label, caller-rendered label, and description paths | Source proves Icon-slot delegation, conditional label rendering, and Text-wrapped description; focused tests assert string and description content but not target placement or custom-label ownership. | `audit:NavHeadingMenu/theming` |+| FR4–FR7 | `NavHeadingMenu.test.tsx` context, keyboard, disabled, and pass-through suites | Selection, Escape, arrows, Home/End, typeahead, disabled, caller handlers | Breaking close callback consumption, keyboard behavior, or role precedence fails focused interaction assertions. | `audit:NavHeadingMenu/behavior` |+| Target inventory | Source inspection and `themingTargets.test.ts` | Menu, Item, and delegated Icon targets | Runtime and documented target metadata drift fails target validation. | `audit:NavHeadingMenu/theming` |+| Theming anatomy map | `scripts/check-knowledge.mjs` | Canonical anatomy and both current local targets | Missing, extra, prefixed, or stale mappings fail repository validation. | `audit:NavHeadingMenu/theming` |+| FR8 | `NavHeadingMenu.test.tsx` action-group suite (touch and mouse slides) | Touch and mouse slides across items; a disabled item; undraggable link items | Removing the adoption fails the slide tests. | — |+| RTL relation | RTL audit curated D2 target (`apps/storybook/rtl-audit/targets.json`) on `NavMenu / With icons` | A menu item icon and its label; LTR and RTL | An icon that is not at the inline start of its label fails D2. | `audit:NavHeadingMenu/i18n-rtl` |Read from source, with no focused test yet:diff --git a/docs/specs/components/OverflowList/OverflowList.spec.md b/docs/specs/components/OverflowList/OverflowList.spec.mdindex d67f8f93f1..9df9811006 100644--- a/docs/specs/components/OverflowList/OverflowList.spec.md+++ b/docs/specs/components/OverflowList/OverflowList.spec.md@@ -18,6 +18,7 @@ verified_by:packages/core/src/theme/themingTargets.test.ts,.github/visual-baseline/manifest.json,scripts/check-knowledge.mjs,+ apps/storybook/rtl-audit/targets.json,]modules: []families: []@@ -188,6 +189,7 @@ The hidden measurement copy is implementation structure, not consumer anatomy.| FR6 | `OverflowList.test.tsx` ref and passthrough tests | Ref; DOM props | A ref on another element or a dropped DOM prop fails. Gap: no test covers `className`, `style`, or the `xstyle` merge order. | `audit:OverflowList/api` || AR2, PR1 | Source review | Collapsed items | Gap: no automated check covers keyboard reach to collapsed items or the observer lifecycle. | `audit:OverflowList/a11y` || Theming anatomy map | `scripts/check-knowledge.mjs` | Canonical anatomy and current target | Missing, extra, or stale mappings fail repository validation. | `audit:OverflowList/theming` |+| RTL relation | RTL audit curated D2 target (`apps/storybook/rtl-audit/targets.json`) on `OverflowList / Default` | First item and the overflow trigger; LTR and RTL | A first item that is not at the inline start of the overflow trigger fails D2. | `audit:OverflowList/i18n-rtl` |## Decision logdiff --git a/docs/specs/components/Stepper/Step.spec.md b/docs/specs/components/Stepper/Step.spec.mdindex 12fef86337..35676fab49 100644--- a/docs/specs/components/Stepper/Step.spec.md+++ b/docs/specs/components/Stepper/Step.spec.md@@ -14,6 +14,7 @@ verified_by:[packages/core/src/Stepper/Stepper.test.tsx,apps/storybook/stories/Stepper.stories.tsx,+ apps/storybook/rtl-audit/targets.json,]modules: []families: []@@ -169,13 +170,14 @@ Consumer migration instructions belong in consumer docs and release notes.## Verification map-| Contract | Verification | Representative states | Mutation or failure expectation | Audit section |-| ------------ | ------------------------------------------------------------------- | ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- |-| FR1 | `Stepper.test.tsx` list and aria-current tests | Each progress | Wrong current step fails. | `audit:Step/accessibility` |-| FR2, AR3–AR4 | `Stepper.test.tsx` onStepClick, keyboard, and accessible-name tests | Completed, active, upcoming, disabled | A missing button or wrong name fails, and so does a disabled step that leaves the tab order, loses focus when it becomes disabled, lacks `aria-disabled`, or activates. | `audit:Step/behavior` |-| FR3, FR4 | `Stepper.test.tsx` step-number, indicator, and status glyph tests | Each indicator mode and status | Wrong glyph or recolored bar fails. | `audit:Step/behavior` |-| FR8 | `Stepper.test.tsx` compact content-mount tests | Both indicator positions | Step content that loses its state while hidden in a compact Stepper fails. | `audit:Step/behavior` |-| FR5, AR2 | `Stepper.test.tsx` hidden status text tests | Separated and on-track | Missing status text fails. | `audit:Step/accessibility` |+| Contract | Verification | Representative states | Mutation or failure expectation | Audit section |+| ------------ | ------------------------------------------------------------------------------------------------------- | ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- |+| FR1 | `Stepper.test.tsx` list and aria-current tests | Each progress | Wrong current step fails. | `audit:Step/accessibility` |+| FR2, AR3–AR4 | `Stepper.test.tsx` onStepClick, keyboard, and accessible-name tests | Completed, active, upcoming, disabled | A missing button or wrong name fails, and so does a disabled step that leaves the tab order, loses focus when it becomes disabled, lacks `aria-disabled`, or activates. | `audit:Step/behavior` |+| FR3, FR4 | `Stepper.test.tsx` step-number, indicator, and status glyph tests | Each indicator mode and status | Wrong glyph or recolored bar fails. | `audit:Step/behavior` |+| FR8 | `Stepper.test.tsx` compact content-mount tests | Both indicator positions | Step content that loses its state while hidden in a compact Stepper fails. | `audit:Step/behavior` |+| FR5, AR2 | `Stepper.test.tsx` hidden status text tests | Separated and on-track | Missing status text fails. | `audit:Step/accessibility` |+| RTL relation | RTL audit curated D2 target (`apps/storybook/rtl-audit/targets.json`) on `Stepper / Default horizontal` | Step indicator and label; LTR and RTL | An indicator that is not at the inline start of its label fails D2. | `audit:Step/i18n-rtl` |Read from source, with no focused test yet: