@astryxdesign/core 0.7.5 → 0.7.6-canary.0135af4

package/src/HoverCard/HoverCard.spec.md

@@ -9,11 +9,13 @@ superseded_by: null
 approved_by: cixzhang
 approved_at: 2026-10-28
 owners: [cixzhang]
-review_triggers: [behavior, theming, accessibility]
+review_triggers: [public-api, behavior, theming, accessibility]
 verified_by:
   [
     packages/core/src/HoverCard/HoverCard.test.tsx,
     packages/core/src/Layer/layerDismissalFamilies.test.tsx,
+    packages/core/src/Layer/useTouchTrigger.test.ts,
+    packages/core/src/Layer/touchTriggerTargets.test.tsx,
     apps/storybook/stories/HoverCard.stories.tsx,
     scripts/check-knowledge.mjs,
   ]
@@ -25,24 +27,25 @@ architecture:
     architecture:component-theming-surface,
     architecture:interaction-modality,
     architecture:layer-runtime,
+    architecture:public-component-api,
   ]
 contributing: []
-system_specs: []
+system_specs: [spec:AST-003, spec:AST-017]
 ---
 
 # HoverCard component contract
 
 ## Contract at a glance
 
-| Area                    | Contract                                                                                                                                                                                                                                                                                                                                                       |
-| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Public contract         | `HoverCard` with `children` (trigger), `content`, `label`, `placement` (`above`), `alignment` (`center`), `delay` (300), `hideDelay` (200), `focusTrigger`, `touchTrigger`, `isEnabled`, `isOpen`, `isDefaultOpen`, `onOpenChange`, and `hasHoverIndication`; target `hover-card`.                                                                             |
-| Behavior                | A floating card of rich, possibly interactive content anchored to a trigger. It opens on hover after `delay`, on focus, and on a qualifying tap, stays open while the pointer is on the trigger or card, and closes on leave, Escape, or a tap outside. With `label` it is a named dialog the trigger advertises; without, a group that describes the trigger. |
-| End-user impact         | Mouse, keyboard, and touch users can open the preview, move into it to use its actions, and dismiss it; screen-reader users hear it as a named popup dialog or as the trigger's description.                                                                                                                                                                   |
-| Builder impact          | None.                                                                                                                                                                                                                                                                                                                                                          |
-| Compatibility/readiness | Records shipped behavior; no public change. Seven implementation gaps (see Current-state impact).                                                                                                                                                                                                                                                              |
-| Review checks           | Reject an unnamed `dialog`, a card that cannot be hovered or dismissed (WCAG 1.4.13), Escape in the page that also closes a layer underneath, or `aria-expanded` set on a trigger whose role does not support it.                                                                                                                                              |
-| Governing rules         | WCAG 1.4.13; `family:overlay-dismissal`; `architecture:layer-runtime`; `architecture:interaction-modality`; `architecture:component-theming-surface`.                                                                                                                                                                                                          |
+| Area                    | Contract                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| Public contract         | `HoverCard` with `children` (trigger), `content`, `label`, `placement` (`above`), `alignment` (`center`), `delay` (300), `hideDelay` (200), `focusTrigger`, `pressTrigger` (`none`), `touchTrigger` (`tap` deprecated by `component:Tooltip` DEP-0016), `isEnabled`, `isOpen`, `isDefaultOpen`, `onOpenChange`, and `hasHoverIndication`; target `hover-card`. `useHoverCard` takes the same `pressTrigger` and `touchTrigger`.                                                                                                                              |
+| Behavior                | A floating card of rich, possibly interactive content anchored to a trigger. It opens on hover after `delay`, on focus, and on a qualifying tap, stays open while the pointer is on the trigger or card, and closes on leave, Escape, or a tap outside. With `label` it is a named dialog the trigger advertises; without, a group that describes the trigger. With `pressTrigger="toggle"`, hover and focus preview it, and a click, tap, Enter, or Space on a button trigger pins it open until Escape, a second press, a press outside, or focus leaving. |
+| End-user impact         | Mouse, keyboard, and touch users can open the preview, move into it to use its actions, and dismiss it; screen-reader users hear it as a named popup dialog or as the trigger's description. With the toggle, a pinned card stays open while people read or use it, whatever the pointer does.                                                                                                                                                                                                                                                               |
+| Builder impact          | A trigger whose information lives only in the card passes `pressTrigger="toggle"` and a button trigger (DEC-1). `touchTrigger="tap"` callers migrate by trigger kind: the deprecating release's codemod rewrites icon and span triggers and reports the rest (`component:Tooltip` DEP-0016), and `component:Tooltip` CLN-0024 names each remaining kind's replacement at the next minor.                                                                                                                                                                     |
+| Compatibility/readiness | Additive `pressTrigger`, default `none`; `touchTrigger="tap"` deprecated and `touchTrigger` folded into `pressTrigger` at the next minor (`component:Tooltip` DEP-0016, CLN-0024). FR9, FR10, and AR3 are not yet built; eight further implementation gaps (see Current-state impact).                                                                                                                                                                                                                                                                       |
+| Review checks           | Reject an unnamed `dialog`, a card that cannot be hovered or dismissed (WCAG 1.4.13), Escape in the page that also closes a layer underneath, or `aria-expanded` set on a trigger whose role does not support it, a pinned card that closes on pointer leave, or a non-button toggle trigger without the development warning.                                                                                                                                                                                                                                |
+| Governing rules         | WCAG 1.4.13, 2.1.1; `family:overlay-dismissal`; `spec:AST-003` FR4; `spec:AST-017` (deprecation); `architecture:public-component-api` INV9, INV21; `architecture:layer-runtime`; `architecture:interaction-modality`; `architecture:component-theming-surface`.                                                                                                                                                                                                                                                                                              |
 
 This table is a review projection; the body below is authoritative.
 
@@ -55,17 +58,41 @@ Consumer usage lives in `HoverCard.doc.mjs`.
 
 ## Compatibility and migration
 
-- Released default preserved: `yes`
-- Compatibility class: records shipped behavior; no public change
+- Released default preserved: the defaults stay `pressTrigger="none"` and
+  `touchTrigger="auto"`. In patch releases `auto` keeps its released
+  behavior: a tap opens the card unless the trigger itself performs an
+  action. The one exception is a disabled control, which is not an action, so
+  its reason opens on a tap; that restoration ships on its own as a patch
+  `[fix]`. FR5's walk, under which a tap that already acts on a control around
+  the trigger does not open the card, needs app code where a hint-only
+  trigger sits inside a control (it declares `pressTrigger="toggle"`), so it
+  is a breaking change under `spec:AST-017` FR1 and DEC-17 and ships with
+  CLN-0024 in the next minor; no caller's behavior changes in a patch
+- Compatibility class: additive `pressTrigger`; `touchTrigger="tap"` is
+  deprecated; FR5's walk is a breaking change for the next minor
+  (`component:Tooltip` CLN-0024); no DOM or styling change without
+  `pressTrigger`
 - Controlled/uncontrolled behavior: uncontrolled by default; `isOpen` forces the
   state, and a controlled card reports close requests through
-  `onOpenChange(false)` without closing itself (FR7)
-- Migration decision: none
+  `onOpenChange(false)` without closing itself (FR7); under
+  `pressTrigger="toggle"` a press on a controlled card reports the toggled
+  value through `onOpenChange` and does not change the state itself (FR9)
+- Migration decision: `component:Tooltip` DEP-0016, then CLN-0024 in the next
+  minor; both cover HoverCard's and `useHoverCard`'s `touchTrigger`, with the
+  same codemods, and CLN-0024 brings FR5's walk to `auto`
 
 Consumer migration instructions belong in consumer docs and release notes.
 
 ## Current-state impact
 
+- **A tap inside a control still opens the card.** The shipped
+  `touchTrigger="auto"` asks only whether the trigger itself performs an action,
+  so a name or ID inside a clickable card opens its card on the tap that opens
+  the card behind it. The walk ships with `component:Tooltip` CLN-0024 (FR5,
+  DEC-1).
+- **Press-to-pin is not built.** `pressTrigger`, its toggle (FR9), and the
+  trigger wiring and announcement (FR10) are specified and not implemented.
+  `touchTrigger="tap"` is the shipped way to open on every tap.
 - **A held-closed card still opens on focus.** With `isOpen={false}`, the hover
   path stays shut but focus on the trigger opens the card, so a caller cannot
   hold it closed. Escape then only reports `onOpenChange(false)`, which the
@@ -96,6 +123,7 @@ Consumer migration instructions belong in consumer docs and release notes.
   focus, and a hover-opened card the user has tabbed into closes when the
   pointer leaves the trigger, dropping focus to the page. WCAG 1.4.13 requires
   content shown on focus to persist until focus moves or the user dismisses it.
+  A card pinned by a press (FR9) is held whatever the pointer does.
 - **Mixed text children get no trigger.** Text children that reach React as
   several strings, such as `Edited {when}`, have no element to attach to: no
   focusable span or popup attributes are added, and hover and focus never open
@@ -106,7 +134,8 @@ Consumer migration instructions belong in consumer docs and release notes.
 **Owns**
 
 - Trigger wiring, open and close behavior per input, card semantics, and the
-  `hover-card` surface (FR1–FR8).
+  `hover-card` surface (FR1–FR8), including the press toggle and the trigger
+  state it sets (FR9, FR10).
 
 **Does not own / non-goals**
 
@@ -119,24 +148,27 @@ Consumer migration instructions belong in consumer docs and release notes.
 
 ## Public concepts
 
-| Concept       | Closed values or states   | Meaning                                                                            | Availability by variant/orientation/state | Default | Owner                 | Stability | Invalid-value behavior           |
-| ------------- | ------------------------- | ---------------------------------------------------------------------------------- | ----------------------------------------- | ------- | --------------------- | --------- | -------------------------------- |
-| Popup role    | named dialog, group       | `label` makes the card a named `dialog`; without it the card is a `group`.         | Every card.                               | group   | `component:HoverCard` | Stable    | Not applicable.                  |
-| Focus trigger | `auto`, `always`, `never` | Whether focus opens the card: on focusable triggers (FR4's gap), always, or never. | Every trigger.                            | `auto`  | `component:HoverCard` | Stable    | TypeScript rejects other values. |
-| Touch trigger | `auto`, `tap`, `none`     | Whether a tap opens it: unless the trigger performs its own action, always, never. | Touch without hover.                      | `auto`  | `component:HoverCard` | Stable    | TypeScript rejects other values. |
+| Concept       | Closed values or states   | Meaning                                                                                                                                                                        | Availability by variant/orientation/state                           | Default | Owner                 | Stability                                                                                     | Invalid-value behavior           |
+| ------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------- | ------- | --------------------- | --------------------------------------------------------------------------------------------- | -------------------------------- |
+| Popup role    | named dialog, group       | `label` makes the card a named `dialog`; without it the card is a `group`.                                                                                                     | Every card.                                                         | group   | `component:HoverCard` | Stable                                                                                        | Not applicable.                  |
+| Focus trigger | `auto`, `always`, `never` | Whether focus opens the card: on focusable triggers (FR4's gap), always, or never.                                                                                             | Every trigger.                                                      | `auto`  | `component:HoverCard` | Stable                                                                                        | TypeScript rejects other values. |
+| Press trigger | `none`, `toggle`          | Whether a click, tap, Enter, or Space on the trigger pins the card open: never, leaving taps to `touchTrigger`, or on every press (FR9).                                       | Button triggers; a non-button trigger keeps tap-only opening (FR9). | `none`  | `component:HoverCard` | Stable                                                                                        | TypeScript rejects other values. |
+| Touch trigger | `auto`, `tap`, `none`     | Whether a tap opens it: unless the tap already acts, as the innermost control around the tapped element decides (DEC-1); always; never. Ignored under `pressTrigger="toggle"`. | Touch without hover.                                                | `auto`  | `component:HoverCard` | Stable; `tap` deprecated (`component:Tooltip` DEP-0016); folds into `pressTrigger` (CLN-0024) | TypeScript rejects other values. |
 
 ## Behavioral and layout contract
 
-| ID  | Invariant                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Basis                    |
-| --- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ |
-| FR1 | The open card is one surface carrying only the `hover-card` target, padded on every logical edge, with `content` inside and the theme's body font. `xstyle`, `className`, and `style` apply to the card.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | Current source and tests |
-| FR2 | Trigger wiring: a single string or number child is wrapped in a focusable inline span; element `children` attach to their first element inside an inline-safe wrapper.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Current source and tests |
-| FR3 | With `label`, the card is `role="dialog"` named by `label`; the trigger gets `aria-haspopup="dialog"` and, only when its role supports it, `aria-expanded`, each replacing the trigger's own value while the card is wired, plus `aria-controls` naming the card while open, merged with the trigger's own; the trigger's own values return on cleanup. Without `label`, the card is `role="group"` and the trigger's `aria-describedby` gains the card's id.                                                                                                                                                                                                                                                                 | Current source and tests |
-| FR4 | On a hover-capable pointer, entering the trigger opens the card after `delay` ms; leaving the trigger or the card closes it after `hideDelay` ms, and moving between them keeps it open. Any focus on the trigger, keyboard, pointer, or programmatic, opens it per `focusTrigger`, except the focus a tap leaves behind, the refocus after an Escape dismiss (FR6), and the refocus after a controlled close (FR7). Implementation gap: under `auto` the tab order is read only when the trigger's listeners attach, on mount and on a re-render that re-attaches them, so a trigger rendered with `tabindex="-1"` does not open on focus until such a re-render follows its move into the tab order (Current-state impact). | WCAG 1.4.13; tests       |
-| FR5 | On touch, a completed tap opens it per `touchTrigger` when the finger lifts; a touch that becomes a scroll does not. A tap on the card's own content keeps it open; a second tap on the trigger, a tap outside, or a scroll starting outside closes it.                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Current source and tests |
-| FR6 | Escape closes a visible card through the shared dismissal stack when it is the topmost layer in the page, so a layer underneath stays open. Implementation gap: a card rendered into another document, such as an iframe or a Picture-in-Picture window, with no layer beneath it is never closed by Escape (Current-state impact). When focus was inside the card, it returns to the trigger, and that refocus does not reopen the card.                                                                                                                                                                                                                                                                                     | WCAG 1.4.13; tests       |
-| FR7 | `isOpen` forces the card shown or hidden, and `isOpen={true}` suppresses hover and focus hiding; a controlled card answers Escape by calling `onOpenChange(false)` without hiding, and setting `isOpen={false}` while focus is inside the card returns focus to the trigger. `isDefaultOpen` opens it on mount, still dismissible. Implementation gap: with `isOpen={false}`, focus on the trigger still opens the card, and Escape then only reports `onOpenChange(false)` (Current-state impact). `isEnabled={false}` disables the triggers. `onOpenChange` reports each show and hide.                                                                                                                                     | Current source and tests |
-| FR8 | Content renders only while open; server markup and the first client render match, including a default-open card. `hasHoverIndication` (`auto`: a single string or number child) adds a hover cue to the inline trigger.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Current source and tests |
+| ID   | Invariant                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Basis                               |
+| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
+| FR1  | The open card is one surface carrying only the `hover-card` target, padded on every logical edge, with `content` inside and the theme's body font. `xstyle`, `className`, and `style` apply to the card.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Current source and tests            |
+| FR2  | Trigger wiring: a single string or number child is wrapped in a focusable inline span; element `children` attach to their first element inside an inline-safe wrapper.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Current source and tests            |
+| FR3  | With `label`, the card is `role="dialog"` named by `label`; the trigger gets `aria-haspopup="dialog"` and, only when its role supports it, `aria-expanded`, each replacing the trigger's own value while the card is wired, plus `aria-controls` naming the card while open, merged with the trigger's own; the trigger's own values return on cleanup. Without `label`, the card is `role="group"` and the trigger's `aria-describedby` gains the card's id.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Current source and tests            |
+| FR4  | On a hover-capable pointer, entering the trigger opens the card after `delay` ms; leaving the trigger or the card closes it after `hideDelay` ms, and moving between them keeps it open. Any focus on the trigger, keyboard, pointer, or programmatic, opens it per `focusTrigger`, except the focus a tap leaves behind, the refocus after an Escape dismiss (FR6), and the refocus after a controlled close (FR7). Implementation gap: under `auto` the tab order is read only when the trigger's listeners attach, on mount and on a re-render that re-attaches them, so a trigger rendered with `tabindex="-1"` does not open on focus until such a re-render follows its move into the tab order (Current-state impact).                                                                                                                                                                                                                                                                                                                                                                                                                           | WCAG 1.4.13; tests                  |
+| FR5  | On touch, a completed tap opens it per `touchTrigger` when the finger lifts; a touch that becomes a scroll does not. Under `auto`, a tap that already acts leaves it shut, decided as `component:Tooltip` DEC-1 decides it: the innermost control from the tapped element outward, the trigger included, decides, and an `aria-disabled` control, or a label for a disabled control, is not an action (DEC-1). Implementation gap: the walk ships with `component:Tooltip` CLN-0024 in the next minor; until then `auto` asks only whether the trigger itself performs an action, apart from a disabled control (Compatibility and migration). A tap on the card's own content keeps it open; a second tap on the trigger, a tap outside, or a scroll starting outside closes it. Under `pressTrigger="toggle"`, FR9 decides what a tap does and `touchTrigger` is ignored.                                                                                                                                                                                                                                                                             | Current source and tests            |
+| FR6  | Escape closes a visible card through the shared dismissal stack when it is the topmost layer in the page, so a layer underneath stays open. Implementation gap: a card rendered into another document, such as an iframe or a Picture-in-Picture window, with no layer beneath it is never closed by Escape (Current-state impact). When focus was inside the card, it returns to the trigger, and that refocus does not reopen the card.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | WCAG 1.4.13; tests                  |
+| FR7  | `isOpen` forces the card shown or hidden, and `isOpen={true}` suppresses hover and focus hiding; a controlled card answers Escape by calling `onOpenChange(false)` without hiding, and setting `isOpen={false}` while focus is inside the card returns focus to the trigger. `isDefaultOpen` opens it on mount, still dismissible. Implementation gap: with `isOpen={false}`, focus on the trigger still opens the card, and Escape then only reports `onOpenChange(false)` (Current-state impact). `isEnabled={false}` disables the triggers. `onOpenChange` reports each show and hide.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Current source and tests            |
+| FR8  | Content renders only while open; server markup and the first client render match, including a default-open card. `hasHoverIndication` (`auto`: a single string or number child) adds a hover cue to the inline trigger.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Current source and tests            |
+| FR9  | With `pressTrigger="toggle"` and a trigger whose role is `button` (a `<button>` or `role="button"`), a click, a completed tap, Enter, or Space on the trigger pins the card open, and the same press on a pinned card closes it. Hover and focus still preview it per FR4; on touch no preview opens and a tap pins it, while a touch that becomes a scroll pins nothing. A pinned card stays open when the pointer leaves the trigger and the card, and a press on its own content keeps it pinned; Escape (FR6), a second press on the trigger, a press outside the trigger and the card, or focus moving outside them closes it. In a controlled card a press reports the toggled value through `onOpenChange` and does not change the state itself (FR7). A press that pins or closes the layer stops at its trigger: it does not reach a clickable row, card, or container around it, or the control a label names. A trigger whose role is not `button` gets a development warning and keeps tap-only opening: a tap opens the card as `touchTrigger="tap"` does, and no press pins it. Implementation gap: not yet built (Current-state impact). | DEC-1; WCAG 1.4.13, 2.1.1           |
+| FR10 | While `pressTrigger="toggle"` wires a button trigger, the trigger carries `aria-expanded`, `true` only while pinned, and `aria-controls` naming the card while it shows, with or without `label`, each replacing the trigger's own value while wired and restored on cleanup; FR3's popup role and description are kept. When the card pins, a polite live region announces it once: its `label` when it has one, else its text. Implementation gap: not yet built (Current-state impact).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | DEC-1; WAI-ARIA 1.2 `aria-expanded` |
 
 ### Allowed variation
 
@@ -171,6 +203,12 @@ Consumer migration instructions belong in consumer docs and release notes.
   dismissible, and persistent per WCAG 1.4.13, except FR6's other-document gap,
   FR7's held-closed Escape gap, and the pointer-only hold (Current-state
   impact).
+- **AR3 — A pinned card is a toggletip.** Under `pressTrigger="toggle"` the
+  trigger is a named button that reports `aria-expanded` and `aria-controls`
+  (FR10); keyboard and touch users pin and close the card without hover (FR9);
+  it is announced once when it pins (FR10); and it persists until Escape, a
+  second press, a press outside, or focus leaving (FR9, WCAG 1.4.13).
+  Implementation gap: not yet built.
 
 ## Design relationships
 
@@ -212,13 +250,14 @@ Consumer migration instructions belong in consumer docs and release notes.
 
 ## Verification map
 
-| Contract            | Verification                                                                                                                       | Representative states                                    | Mutation or failure expectation                                                       | Audit section                   |
-| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------- |
-| FR1, FR2, FR8       | `HoverCard.test.tsx` render, wrapper, portal, theme font, and SSR tests                                                            | Text and element triggers; default open                  | A stray target, lost font, or hydration mismatch fails.                               | `audit:HoverCard/anatomy`       |
-| FR3, AR1            | `HoverCard.test.tsx` role and trigger-attribute tests                                                                              | Labelled and unlabelled; supported and unsupported roles | Wrong role, or trigger attributes that are not replaced and restored as stated, fail. | `audit:HoverCard/accessibility` |
-| FR4–FR6, AR2        | `HoverCard.test.tsx` hover, Escape, refocus, and touch tests                                                                       | Hover, focus, tap, Escape from trigger and content       | A card that cannot be reached or dismissed fails.                                     | `audit:HoverCard/behavior`      |
-| FR7                 | `HoverCard.test.tsx` isEnabled, isDefaultOpen, and onOpenChange tests; `layerDismissalFamilies.test.tsx` controlled HoverCard case | Disabled, default open                                   | Wrong state reporting fails.                                                          | `audit:HoverCard/behavior`      |
-| Theming anatomy map | `scripts/check-knowledge.mjs`                                                                                                      | Consumer anatomy and current target                      | Missing, extra, or stale mappings fail validation.                                    | `audit:HoverCard/theming`       |
+| Contract            | Verification                                                                                                                                                                                         | Representative states                                                                                                                                                                                                                                                  | Mutation or failure expectation                                                                                                                                                                                                                                                                                             | Audit section                   |
+| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
+| FR1, FR2, FR8       | `HoverCard.test.tsx` render, wrapper, portal, theme font, and SSR tests                                                                                                                              | Text and element triggers; default open                                                                                                                                                                                                                                | A stray target, lost font, or hydration mismatch fails.                                                                                                                                                                                                                                                                     | `audit:HoverCard/anatomy`       |
+| FR3, AR1            | `HoverCard.test.tsx` role and trigger-attribute tests                                                                                                                                                | Labelled and unlabelled; supported and unsupported roles                                                                                                                                                                                                               | Wrong role, or trigger attributes that are not replaced and restored as stated, fail.                                                                                                                                                                                                                                       | `audit:HoverCard/accessibility` |
+| FR4–FR6, AR2        | `HoverCard.test.tsx` hover, Escape, refocus, and touch tests; `useTouchTrigger.test.ts` and `touchTriggerTargets.test.tsx` disabled-control cases; tap-destination cases an evidence gap until built | Hover, focus, tap, Escape from trigger and content; a trigger inside a link or a clickable card; a disabled control inside a clickable row                                                                                                                             | A card that cannot be reached or dismissed, or that opens on a tap that already acts, fails.                                                                                                                                                                                                                                | `audit:HoverCard/behavior`      |
+| FR7                 | `HoverCard.test.tsx` isEnabled, isDefaultOpen, and onOpenChange tests; `layerDismissalFamilies.test.tsx` controlled HoverCard case                                                                   | Disabled, default open                                                                                                                                                                                                                                                 | Wrong state reporting fails.                                                                                                                                                                                                                                                                                                | `audit:HoverCard/behavior`      |
+| FR9, FR10, AR3      | Evidence gap until built: a press-toggle suite in `HoverCard.test.tsx` and a controlled pinned case in `layerDismissalFamilies.test.tsx`                                                             | Click, Enter, Space, and tap pin; second press, press outside, focus leaving, and Escape close; pointer leave and presses on the card keep the pin; labelled and unlabelled; non-button trigger; a toggle trigger inside a ClickableCard, an Item row, and a `<label>` | A press that does not pin or close as stated, a pin lost on pointer leave, a missing or stale `aria-expanded` or `aria-controls`, a second announcement, a non-button trigger without the warning or its tap fallback, or a pinning press that also activates the card, row, or labelled control around the trigger, fails. | `audit:HoverCard/behavior`      |
+| Theming anatomy map | `scripts/check-knowledge.mjs`                                                                                                                                                                        | Consumer anatomy and current target                                                                                                                                                                                                                                    | Missing, extra, or stale mappings fail validation.                                                                                                                                                                                                                                                                          | `audit:HoverCard/theming`       |
 
 Read from source, with no focused test yet:
 
@@ -232,7 +271,27 @@ Read from source, with no focused test yet:
 
 ## Decision log
 
-No component-local decision is recorded.
+### DEC-1 — A press pins the card; a tap that already acts stays with its control
+
+**Reference:** `component:HoverCard/DEC-1`
+**Decider:** `cixzhang`, `2026-10-31`
+
+A card keeps previewing on hover and focus, and `pressTrigger="toggle"` adds
+one more open state of the same layer: a press pins it, so people on touch,
+keyboard, or a screen reader can keep it open to read or use it. Components
+declare `pressTrigger="toggle"` where the card is the only home of their
+information, such as a timestamp's details. `touchTrigger="auto"`, the
+default until `touchTrigger` folds into `pressTrigger` at the next minor, is
+the fallback: under it, a tap that already acts does not open the card. The
+walk that decides it starts at the tapped element and the innermost control
+decides; an `aria-disabled` control, or a label for a disabled control, is not
+an action; and an element that acts only through a role-less `onClick` is a
+caller fix, as `component:Tooltip` DEC-1 states. The deprecation of
+`touchTrigger="tap"` and the fold are `component:Tooltip` DEP-0016 and CLN-0024,
+which apply here unchanged.
+
+Rejected: judging the trigger alone, which lets one tap open a name's card over
+the card the same tap opened.
 
 ## Open questions
 

package/src/HoverCard/useHoverCard.doc.mjs

@@ -12,7 +12,7 @@ export const docs = {
     {name: 'delay', type: 'number', description: 'Delay before showing the hover card on hover, in milliseconds.', default: '300'},
     {name: 'hideDelay', type: 'number', description: 'Delay before hiding after mouse or focus leaves, in milliseconds.', default: '200'},
     {name: 'focusTrigger', type: "'auto' | 'always' | 'never'", description: 'When focus should open the hover card. auto only attaches focus listeners to naturally focusable elements.', default: "'auto'"},
-    {name: 'touchTrigger', type: "'auto' | 'tap' | 'none'", description: 'What a tap does where there is no hover. auto opens on tap unless the trigger performs an action of its own; tap always opens; none never opens on touch.', default: "'auto'"},
+    {name: 'touchTrigger', type: "'auto' | 'tap' | 'none'", description: 'What a tap does where there is no hover. auto opens on tap unless the trigger performs an action of its own (an aria-disabled control performs none); tap always opens; none never opens on touch.', default: "'auto'"},
     {name: 'isEnabled', type: 'boolean', description: 'Whether hover and focus triggers are enabled.', default: 'true'},
     {name: 'label', type: 'string', description: 'Accessible name for the hover card popup. When provided, the popup is exposed as a named role="dialog"; when omitted, it falls back to role="group" (a group may validly be unnamed).'},
     {name: 'isOpen', type: 'boolean', description: 'Controlled open state. true force-shows, false force-hides, undefined lets hover/focus manage visibility.'},

package/src/Icon/Icon.tsx

@@ -38,7 +38,7 @@ import {useThemeName} from '../theme/useTheme';
 import {resolveIcon} from './globalIconRegistry';
 import type {IconName, NamespacedIconName} from './globalIconRegistry';
 import type {IconVariant} from './index';
-import {mergeProps} from '../utils';
+import {mergeProps} from '../utils/mergeProps';
 import {themeProps} from '../utils/themeProps';
 import {useIconSize} from './IconDefaultSizeContext';
 import {iconSizeStyles, type IconSize} from './IconSize.stylex';

package/src/Indicator/CheckIndicator.spec.md

@@ -1,20 +1,19 @@
 ---
 schema_version: 3
-template_version: 6
+template_version: 7
 kind: component
 id: component:CheckIndicator
-authority: draft
+authority: current
 archive_reason: null
 superseded_by: null
-approved_by: null
-approved_at: null
+approved_by: cixzhang
+approved_at: 2026-10-31
 owners: [cixzhang]
 review_triggers: [public-api, behavior, theming, accessibility, visual]
 verified_by:
   [
     packages/core/src/Indicator/Indicator.test.tsx,
     packages/core/src/theme/themingTargets.test.ts,
-    apps/storybook/stories/Indicator.stories.tsx,
   ]
 modules: []
 families: []
@@ -33,17 +32,17 @@ system_specs: []
 
 ## Contract at a glance
 
-| Area                    | Contract                                                                                                                                                                                                                                                   |
-| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Public contract         | `CheckIndicator` is exported from `@astryxdesign/core/Indicator`; `state` is required, `size` defaults to `md`, `isDisabled` defaults to `false`, and `children` may replace the built-in mark.                                                            |
-| Behavior                | The component draws a decorative check glyph only when checked. Shallow-renderable `children` replace that glyph in either state; unchecked without replacement content renders no element.                                                                |
-| End-user impact         | People receive one selection cue from the owning control without a duplicate accessible object or an empty placeholder beside unselected rows.                                                                                                             |
-| Builder impact          | Builders may replace the named `check` indicator or compose host-owned classes and styling without taking over the owning control's semantics.                                                                                                             |
-| Compatibility/readiness | The released component and default state behavior remain unchanged. The checked glyph path currently drops the declared `ref`; this draft records that current-authority gap without choosing a new DOM or ref contract.                                   |
-| Review checks           | Reject lost `aria-hidden`, a mark in the unchecked default, a missing checked mark, dropped supported DOM/styling passthrough, changed replacement precedence, a new component-owned theme target, or any claim that the checked-path ref gap is resolved. |
-| Governing rules         | `architecture:public-component-api/INV1,INV5,INV6,INV8,INV9`; `architecture:component-theming-surface/INV3–INV6`; `architecture:component-test-sufficiency/INV1–INV7,INV10–INV11`.                                                                         |
+| Area                    | Contract                                                                                                                                                                                                                                                           |
+| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| Public contract         | `CheckIndicator` is exported from `@astryxdesign/core/Indicator`; `state` is required, `size` defaults to `md`, `isDisabled` defaults to `false`, and `children` may replace the built-in mark.                                                                    |
+| Behavior                | The component draws a decorative check glyph only when checked. Shallow-renderable `children` replace that glyph in either state; unchecked without replacement content renders no element.                                                                        |
+| End-user impact         | People receive one selection cue from the owning control without a duplicate accessible object or an empty placeholder beside unselected rows.                                                                                                                     |
+| Builder impact          | Builders may replace the named `check` indicator or compose host-owned classes and styling without taking over the owning control's semantics.                                                                                                                     |
+| Compatibility/readiness | Records shipped behavior; no API, default, or DOM change. The checked glyph path drops the declared `ref`; listed under Current-state impact, with the fix open (OQ1).                                                                                             |
+| Review checks           | Reject lost `aria-hidden`, a mark in the unchecked default, a missing checked mark, dropped supported DOM/styling passthrough, changed replacement precedence, a new component-owned theme target, or a checked path that still drops the ref once OQ1 is decided. |
+| Governing rules         | `architecture:public-component-api/INV1,INV5,INV6,INV8,INV9`; `architecture:component-theming-surface/INV3–INV6`; `architecture:component-test-sufficiency/INV1–INV7,INV10–INV11`.                                                                                 |
 
-This table is a review projection; the body below is authoritative only after owner approval.
+This table is a review projection; the body below is authoritative.
 
 ## Intent
 
@@ -52,7 +51,8 @@ Render the replaceable, decorative checkmark used by a host to show that one opt
 ## Compatibility and migration
 
 - Released default preserved: yes
-- Compatibility class: observational only; no runtime or public-type change
+- Compatibility class: records shipped behavior; no public prop, default,
+  export, or DOM change
 - Controlled/uncontrolled behavior: not applicable; `state` is supplied by the owner
 - Migration decision: none; the public component and `check` registry name remain unchanged
 
@@ -68,29 +68,29 @@ Consumer migration instructions belong in consumer docs and release notes.
 **Does not own / non-goals**
 
 - Selection role, accessible name, state, focus, keyboard, activation, or busy semantics — owned by the composing control.
-- Persistent checkbox or radio chrome — owned by `component:CheckboxIndicator` or `component:RadioIndicator`.
+- Persistent checkbox or radio chrome — owned by `component:CheckboxIndicator` or `component:Indicator`.
 - Row placement and logical-edge layout — owned by the host component.
 - The behavior or accessibility of consumer-supplied replacement content.
 
 ## Public concepts
 
-| Concept             | Closed values or states     | Meaning                                                                                                                                                                     | Availability by variant/orientation/state             | Default            | Owner                      | Stability                                  | Invalid-value behavior                             |
-| ------------------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- | ------------------ | -------------------------- | ------------------------------------------ | -------------------------------------------------- |
-| state               | `unchecked`, `checked`      | Selects whether the built-in check glyph is absent or present.                                                                                                              | Every render path.                                    | required           | `component:CheckIndicator` | stable                                     | rejected by the public type                        |
-| size                | `sm`, `md`                  | Selects the shared indicator size; both current values use the `sm` Icon glyph.                                                                                             | Checked and replacement-content roots.                | `md`               | `component:CheckIndicator` | stable                                     | rejected by the public type                        |
-| disabled appearance | enabled, disabled           | Mirrors the owning control's disabled color without creating semantics.                                                                                                     | Checked and replacement-content roots.                | enabled            | `component:CheckIndicator` | stable                                     | boolean only                                       |
-| replacement content | shallow renderable or empty | Replaces the built-in mark in either state when `isRenderable(children)` returns true. React elements and containers take this branch even when descendants render nothing. | Every state; replacement content creates a span root. | built-in mark path | `component:CheckIndicator` | observed; empty-container policy unsettled | unsupported values follow React rendering behavior |
+| Concept             | Closed values or states     | Meaning                                                                                                                                                                     | Availability by variant/orientation/state             | Default            | Owner                      | Stability                                 | Invalid-value behavior                             |
+| ------------------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- | ------------------ | -------------------------- | ----------------------------------------- | -------------------------------------------------- |
+| state               | `unchecked`, `checked`      | Selects whether the built-in check glyph is absent or present.                                                                                                              | Every render path.                                    | required           | `component:CheckIndicator` | stable                                    | rejected by the public type                        |
+| size                | `sm`, `md`                  | Selects the shared indicator size; both current values use the `sm` Icon glyph.                                                                                             | Checked and replacement-content roots.                | `md`               | `component:CheckIndicator` | stable                                    | rejected by the public type                        |
+| disabled appearance | enabled, disabled           | Mirrors the owning control's disabled color without creating semantics.                                                                                                     | Checked and replacement-content roots.                | enabled            | `component:CheckIndicator` | stable                                    | boolean only                                       |
+| replacement content | shallow renderable or empty | Replaces the built-in mark in either state when `isRenderable(children)` returns true. React elements and containers take this branch even when descendants render nothing. | Every state; replacement content creates a span root. | built-in mark path | `component:CheckIndicator` | stable; empty-container policy open (OQ2) | unsupported values follow React rendering behavior |
 
 ## Behavioral and layout contract
 
-| ID  | Candidate invariant                                                                                                                                                                                                                                                                                                                                              | Basis                                                                     | Draft review state |
-| --- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | ------------------ |
-| FR1 | The component MUST render one decorative check glyph when `state="checked"` and no replacement content is present, and MUST set its own `aria-hidden="true"` after caller passthrough.                                                                                                                                                                           | shipped source; `architecture:public-component-api/INV5`                  | verify             |
-| FR2 | The default component MUST render no element when `state="unchecked"` and no replacement content is present.                                                                                                                                                                                                                                                     | shipped source, docs, tests, and stories                                  | verify             |
-| FR3 | The current implementation uses shallow `isRenderable(children)` replacement precedence in both states: nullish values, booleans, and the empty string keep the built-in state behavior; React elements and containers replace it even when descendants render nothing. This draft does not settle whether empty-container behavior should remain public policy. | shipped source and regression tests                                       | verify             |
-| FR4 | Every rendered root MUST preserve supported DOM props, `className`, `style`, and `xstyle` while keeping component-owned accessibility precedence. Under `architecture:public-component-api/INV8`, the declared ref also MUST reach the promised root; the replacement-content span does, but the checked Icon path currently drops it.                           | `architecture:public-component-api/INV5,INV6,INV8`; shipped source review | human decision     |
-| FR5 | The built-in checked mark MUST remain an Icon-owned painter on the same element as host-supplied classes; CheckIndicator MUST NOT add a wrapper or a distinct public target without an approved contract change.                                                                                                                                                 | shipped source; `architecture:component-theming-surface/INV3–INV5`        | verify             |
-| FR6 | Disabled color and replacement-content color MUST continue to use semantic tokens rather than raw color values.                                                                                                                                                                                                                                                  | shipped source; current token and theming architecture                    | verify             |
+| ID  | Invariant                                                                                                                                                                                                                                                                                                                                                    | Basis                                                              |
+| --- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------ |
+| FR1 | The component MUST render one decorative check glyph when `state="checked"` and no replacement content is present, and MUST set its own `aria-hidden="true"` after caller passthrough.                                                                                                                                                                       | shipped source; `architecture:public-component-api/INV5`           |
+| FR2 | The default component MUST render no element when `state="unchecked"` and no replacement content is present.                                                                                                                                                                                                                                                 | shipped source, docs, tests, and stories                           |
+| FR3 | Replacement uses shallow `isRenderable(children)` precedence in both states: nullish values, booleans, and the empty string keep the built-in state behavior; React elements and containers replace it even when descendants render nothing (OQ2).                                                                                                           | shipped source and regression tests                                |
+| FR4 | Every rendered root MUST preserve supported DOM props, `className`, `style`, and `xstyle` while keeping component-owned accessibility precedence, and the declared ref MUST reach the rendered root (`architecture:public-component-api/INV8`). Implementation gap: the replacement-content span receives the ref, but the checked Icon path drops it (OQ1). | `architecture:public-component-api/INV5,INV6,INV8`; current source |
+| FR5 | The built-in checked mark MUST remain an Icon-owned painter on the same element as host-supplied classes; CheckIndicator MUST NOT add a wrapper or a distinct public target without an approved contract change.                                                                                                                                             | shipped source; `architecture:component-theming-surface/INV3–INV5` |
+| FR6 | Disabled color and replacement-content color MUST continue to use semantic tokens rather than raw color values.                                                                                                                                                                                                                                              | shipped source; current token and theming architecture             |
 
 ### Allowed variation
 
@@ -126,7 +126,7 @@ Consumer migration instructions belong in consumer docs and release notes.
 | Chrome           | CheckIndicator intentionally owns no persistent chrome. | observed shipped representation         | not applicable       | FR2, FR5           |
 | State mark       | Checked state renders the shared decorative check Icon. | Icon-owned current theming architecture | supporting state cue | FR1, FR5–FR6       |
 
-The shared `Indicator.doc.mjs` owns anatomy and targets for CheckboxIndicator, CheckIndicator, and RadioIndicator together. This component draft does not add an `anatomy-theming:v1` block while that shared consumer record remains the canonical cross-component inventory; the block is optional during migration. CheckIndicator owns no persistent chrome and delegates its built-in checked mark to Icon.
+The shared `Indicator.doc.mjs` lists anatomy and targets for CheckboxIndicator, CheckIndicator, and RadioIndicator together, so this record carries no anatomy-theming map. CheckIndicator owns no persistent chrome and delegates its built-in checked mark to Icon.
 
 ## Family and system relationships
 
@@ -136,23 +136,28 @@ The shared `Indicator.doc.mjs` owns anatomy and targets for CheckboxIndicator, C
 
 ## Verification map
 
-| Contract    | Verification                                                | Representative states                                                                   | Mutation or failure expectation                                                                                             | Audit section                   |
-| ----------- | ----------------------------------------------------------- | --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
-| FR1–FR3     | `Indicator.test.tsx` state and replacement-content cases    | checked, unchecked, empty scalar, visible child, numeric 0                              | Removing the glyph, adding unchecked chrome, or choosing the wrong children branch fails DOM assertions.                    | `audit:CheckIndicator/behavior` |
-| FR1, AR1    | `Indicator.test.tsx` decorative-contract cases              | glyph and replacement roots; hostile `aria-hidden` input                                | Removing or reordering owned `aria-hidden` exposes duplicate semantics.                                                     | `audit:CheckIndicator/a11y`     |
-| FR4         | `Indicator.test.tsx`, strict lint, and source review        | neutral DOM props on both roots; replacement-root class; checked-path style composition | Passthrough stops reaching a rendered root or the checked Icon stops receiving composed `className`, `style`, and `xstyle`. | `audit:CheckIndicator/api`      |
-| FR4 ref gap | source review                                               | checked Icon root and replacement-content span                                          | The declared ref remains `null` on the checked path while reaching the replacement span.                                    | `audit:CheckIndicator/api`      |
-| FR5–FR6     | source review, Icon target guards, and rendered evidence    | checked, disabled, replacement content; light/dark                                      | A wrapper separates the host target from the painter or semantic color stops reaching the mark.                             | `audit:CheckIndicator/theming`  |
-| All         | `Indicator.stories.tsx`, component-scoped axe and RTL audit | all states, sizes, disabled, replacement content                                        | A required rendered state is unreachable or gains an accessibility/RTL failure.                                             | `audit:CheckIndicator/testing`  |
+| Contract      | Verification                                                                                           | Representative states                                       | Mutation or failure expectation                                                                                                                                                                                                                                                                                               | Audit section                        |
+| ------------- | ------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ |
+| FR1, FR2, FR3 | `Indicator.test.tsx` CheckIndicator state and replacement cases; falsy-children cases                  | Checked, unchecked, empty scalar, visible child, `0`        | Removing the glyph, adding unchecked chrome, or choosing the wrong children branch fails.                                                                                                                                                                                                                                     | `audit:CheckIndicator/behavior`      |
+| FR1, AR1      | `Indicator.test.tsx` decorative-contract cases                                                         | Glyph and replacement roots; a caller `aria-hidden={false}` | A root that a caller can expose fails. Evidence gap: no test asserts that replacement content is not the only state expression (AR2).                                                                                                                                                                                         | `audit:CheckIndicator/accessibility` |
+| FR4           | `Indicator.test.tsx` "forwards caller props and styling on both render paths"                          | Both render paths                                           | A caller DOM prop that stops reaching either root, or a `className` that stops reaching the replacement span, fails. Evidence gap: no test asserts `className`, `style`, or `xstyle` on the checked-glyph path, `style` or `xstyle` on the replacement span, or the ref on either path (the checked-path ref is the FR4 gap). | `audit:CheckIndicator/api`           |
+| FR5, FR6      | `themingTargets.test.ts`                                                                               | Checked glyph                                               | A rendered class absent from the documented targets fails. Evidence gap: no test asserts that no wrapper separates host classes from the Icon painter, or that disabled and replacement colors use semantic tokens.                                                                                                           | `audit:CheckIndicator/theming`       |
+| ORD1, PR1     | Covered by the FR1–FR4 rows. Evidence gap: no test asserts the absence of state, effects, or listeners | —                                                           | —                                                                                                                                                                                                                                                                                                                             | `audit:CheckIndicator/behavior`      |
+
+## Current-state impact
+
+- **Checked-path ref (FR4).** The declared ref is `null` when CheckIndicator
+  draws its checked glyph, against `architecture:public-component-api` INV8; the
+  fix is OQ1.
 
 ## Decision log
 
-None. This draft records only verified shipped behavior.
+No component-local decision.
 
 ## Open questions
 
 - **OQ1 — Should CheckIndicator preserve its declared `HTMLSpanElement` ref by owning a stable span root in the checked path, or should the public ref contract change to match the Icon-owned painter?** (`human-api`) The current checked path returns `null`; either correction changes a released DOM or ref contract.
-- **OQ2 — Should empty React containers continue to suppress the built-in state mark?** (`human-api`) This observational draft records the current shallow branch without approving it as future policy.
+- **OQ2 — Should empty React containers continue to suppress the built-in state mark?** (`human-api`) FR3 records that they do today.
 
 ## Content boundary
 

package/src/Indicator/CheckIndicator.tsx

@@ -34,7 +34,8 @@ import * as stylex from '@stylexjs/stylex';
 import type {SVGProps} from 'react';
 import {Icon} from '../Icon/Icon';
 import {colorVars} from '../theme/tokens.stylex';
-import {isRenderable, mergeProps} from '../utils';
+import {isRenderable} from '../utils/isRenderable';
+import {mergeProps} from '../utils/mergeProps';
 import type {IndicatorProps} from './types';
 
 /** The check glyph matches the control sizes the indicator families share. */