@astryxdesign/core 0.7.1-canary.ff40b78 → 0.7.1

package/src/Resizable/__tests__/ResizeHandle.a11y.test.tsx

@@ -0,0 +1,123 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+/** @vitest-environment jsdom */
+
+/**
+ * @file ResizeHandle.a11y.test.tsx
+ * @input WINDOW_SPLITTER_PATTERN bound to ResizeHandle's representative states
+ * @output jsdom-lane proof of the DOM expectations and an honest "unrun" report for the browser layers
+ * @position Binding test for component:Resizable AR1 (the Chromium spec covers the rest)
+ */
+
+import {cleanup, render, screen} from '@testing-library/react';
+import {describe, expect, it} from 'vitest';
+import {
+  WINDOW_SPLITTER_PATTERN,
+  checkAccessibilitySpec,
+  createJsdomHarness,
+  expectAccessibilitySpec,
+  summarize,
+  type BindingResult,
+} from '@astryxdesign/a11y-spec';
+import {RESIZE_HANDLE_KNOWN_FAILURES} from './ResizeHandle.a11y.known-failures';
+import {
+  BARE_PANE_ID,
+  renderResizeHandleState,
+} from './ResizeHandle.a11y.renders';
+import {
+  RESIZE_HANDLE_BINDING_STATES,
+  RESIZE_HANDLE_EXCLUSIONS,
+  type ResizeHandleBindingState,
+} from './ResizeHandle.a11y.states';
+
+function separator(state: ResizeHandleBindingState): HTMLElement {
+  return screen.getByRole('separator', {name: state.label});
+}
+
+function pane(): HTMLElement {
+  const element = document.getElementById(BARE_PANE_ID);
+  if (element == null) {
+    throw new Error('the bare pane is not rendered');
+  }
+  return element;
+}
+
+async function checkState(
+  state: ResizeHandleBindingState,
+): Promise<BindingResult> {
+  return checkAccessibilitySpec({
+    spec: WINDOW_SPLITTER_PATTERN,
+    binding: 'ResizeHandle',
+    state: state.id,
+    facts: state.facts,
+    knownFailures: RESIZE_HANDLE_KNOWN_FAILURES,
+    mount: async () => {
+      render(renderResizeHandleState(state));
+      return createJsdomHarness({
+        subject: separator(state),
+        related: {pane: pane()},
+      });
+    },
+    unmount: cleanup,
+  });
+}
+
+describe('ResizeHandle — window splitter pattern, jsdom lane', () => {
+  it.each(
+    RESIZE_HANDLE_BINDING_STATES.map(
+      state => [state.id, state.summary, state] as const,
+    ),
+  )('%s — %s', async (_id, _summary, state) => {
+    await expectAccessibilitySpec({
+      spec: WINDOW_SPLITTER_PATTERN,
+      binding: 'ResizeHandle',
+      state: state.id,
+      facts: state.facts,
+      knownFailures: RESIZE_HANDLE_KNOWN_FAILURES,
+      render: () => {
+        render(renderResizeHandleState(state));
+      },
+      subject: () => separator(state),
+      related: () => ({pane: pane()}),
+      cleanup,
+    });
+  });
+
+  it('runs the DOM layer and reports the browser-owned outcomes as unrun', async () => {
+    const results: BindingResult[] = [];
+    for (const state of RESIZE_HANDLE_BINDING_STATES) {
+      results.push(await checkState(state));
+    }
+    const report = summarize(WINDOW_SPLITTER_PATTERN, results);
+    expect(report.counts.pass).toBeGreaterThan(0);
+    expect(report.unrunLayers).toEqual(['accessibility-tree', 'real-browser']);
+    expect(report.counts.unexpectedPass).toBe(0);
+  });
+});
+
+describe('ResizeHandle binding inventory', () => {
+  it('gives every representative state a distinct checked-in story', () => {
+    const stories = RESIZE_HANDLE_BINDING_STATES.map(state => state.storyId);
+    expect(new Set(stories).size).toBe(stories.length);
+  });
+
+  it('keeps pointer and pane-cycling ownership explicit', () => {
+    expect(RESIZE_HANDLE_EXCLUSIONS.map(exclusion => exclusion.id)).toEqual([
+      'sidenav-binding',
+      'pointer-drag-model',
+      'pane-cycling',
+    ]);
+    for (const exclusion of RESIZE_HANDLE_EXCLUSIONS) {
+      expect(exclusion.owner.length, exclusion.id).toBeGreaterThan(20);
+      expect(exclusion.reason.length, exclusion.id).toBeGreaterThan(80);
+    }
+  });
+
+  it('renders exactly one named separator and its pane for every state', () => {
+    for (const state of RESIZE_HANDLE_BINDING_STATES) {
+      render(renderResizeHandleState(state));
+      expect(separator(state), state.id).toBeTruthy();
+      expect(pane(), state.id).toBeTruthy();
+      cleanup();
+    }
+  });
+});

package/src/Resizable/useResizable.ts

@@ -303,6 +303,9 @@ function persistState(key: string, state: PersistedResizableState): void {
 
 /** The released compatibility basis when there is no window to measure. */
 const SERVER_BASIS = 1200;
+
+/** A store that never changes on its own; the snapshot is re-read on render. */
+const noopSubscribe = () => () => {};
 const DEFAULT_SIZE_FALLBACK = 250;
 const RESIZABLE_SIZE_GUIDANCE =
   'Use a non-negative number of pixels, an exact "Npx" string, an exact ' +
@@ -699,6 +702,23 @@ function useSingleResizable(config: UseResizableSingleConfig): ResizableRegion {
     () => SERVER_BASIS,
   );
 
+  // The window's extent along the hook's axis, for the REPORTED maximum of an
+  // unbounded region (never for clamping). Read through the same store shape
+  // so a server-rendered handle hydrates with no maximum and gains the real
+  // one on the first client render, instead of a hydration mismatch. It takes
+  // no resize subscription: an unbounded pixel region observes nothing
+  // (component:Resizable Performance and resources).
+  const windowExtent = useSyncExternalStore(
+    noopSubscribe,
+    () =>
+      typeof window === 'undefined'
+        ? null
+        : direction === 'vertical'
+          ? window.innerHeight
+          : window.innerWidth,
+    () => null,
+  );
+
   // With a container, its content box is the basis; without one, the released
   // viewport basis. Before a supplied container has been measured — the first
   // render, the server, and any moment it is display:none or detached — the
@@ -1026,6 +1046,29 @@ function useSingleResizable(config: UseResizableSingleConfig): ResizableRegion {
   // percentage bound stays pinned to the container size at grab time.
   const onResizeCancel = releaseGestureBasis;
 
+  // The maximum a handle REPORTS (End uses only a configured maximum). A
+  // configured maximum wins. Otherwise a measured extent stands in — the
+  // container's content box while a percentage bound already observes it, or
+  // the window's extent along the axis — and never drops below the current size, so
+  // `aria-valuenow` can never exceed `aria-valuemax` (a saved, default, or
+  // pre-resize size may already be larger than the window). An unobserved
+  // container reports nothing: measuring it would add an observer to an
+  // atomic pixel path.
+  const measuredBasisForMax = hasContainer
+    ? hasPositiveMeasurement && observeContainerBasis
+      ? containerBasis
+      : null
+    : windowExtent;
+  // Never below the announced value either: a collapsed pane announces the
+  // resolved minimum as its value, so the stand-in floors there as well, and
+  // `aria-valuemax` can never fall under `aria-valuemin`.
+  const effectiveMaxPx =
+    resolvedMax !== Infinity
+      ? resolvedMax
+      : measuredBasisForMax == null
+        ? undefined
+        : Math.max(measuredBasisForMax, isCollapsed ? resolvedMin : size);
+
   const props: ResizableProps = {
     _size: isCollapsed ? 0 : size,
     _isCollapsed: isCollapsed,
@@ -1041,6 +1084,16 @@ function useSingleResizable(config: UseResizableSingleConfig): ResizableRegion {
     _direction: direction,
     _isResizableProps: true,
   };
+  collapseControls.set(props, {collapse, expand});
+  // Without a configured maximum the basis stands in — only when it is a
+  // real measurement (an observed container, or the window), never the
+  // temporary 1200px placeholder (component:Resizable Performance: atomic
+  // pixel paths add no observer, so an unobserved container stays unknown).
+  // The released no-container basis is the window WIDTH on both axes; a
+  // vertical region's reported maximum reads the window height instead.
+  if (effectiveMaxPx != null) {
+    effectiveMaxima.set(props, effectiveMaxPx);
+  }
 
   return {
     size: isCollapsed ? 0 : size,
@@ -1097,6 +1150,48 @@ function useMultiResizable(
 // Public API
 // =============================================================================
 
+/**
+ * Collapse/expand for a region, keyed by the `ResizableProps` object the hook
+ * returns. A handle's Enter and double-click use them so the pane restores
+ * its previous position (APG window splitter) rather than emulating the
+ * toggle with a resize to the minimum.
+ *
+ * Kept off `ResizableProps` on purpose: that type is exported, so a new field
+ * on it — optional or underscored — is a public delta. This module-private
+ * map and {@link getCollapseControls} are the package's own channel between
+ * the hook and the handle; neither is re-exported.
+ */
+type CollapseControls = {collapse: () => void; expand: () => void};
+const collapseControls = new WeakMap<ResizableProps, CollapseControls>();
+
+/**
+ * The maximum an unbounded region reports as `aria-valuemax`: a measured
+ * extent that stands in for the missing configured maximum — the container's
+ * content box on the active axis while a percentage bound already observes
+ * it, or the window's extent along the axis — floored at the current size
+ * and, while collapsed, at the resolved minimum. The region is never clamped
+ * to it; it is what the separator announces. Kept off the exported
+ * `ResizableProps` for the same reason as the collapse controls;
+ * `getEffectiveMaxPx` is internal.
+ */
+const effectiveMaxima = new WeakMap<ResizableProps, number>();
+
+/** The reported maximum for `props`, or `undefined` for a hand-built object. */
+export function getEffectiveMaxPx(props: ResizableProps): number | undefined {
+  return effectiveMaxima.get(props);
+}
+
+/**
+ * The collapse/expand pair the hook registered for `props`, or `undefined`
+ * for a hand-built `ResizableProps` object (which the handle then toggles
+ * with a resize gesture). Internal to the package.
+ */
+export function getCollapseControls(
+  props: ResizableProps,
+): CollapseControls | undefined {
+  return collapseControls.get(props);
+}
+
 /** Removed keys must fail even when a variable bypasses excess-property checks. */
 type RejectRemovedPixelBounds<Config> = Config extends unknown
   ? Config & {minSizePx?: never; maxSizePx?: never}

package/src/Selector/Selector.doc.mjs

@@ -245,9 +245,9 @@ export const docs = {
     },
     {
       name: 'variant',
-      type: "'input' | 'ghost'",
+      type: "'input' | 'secondary' | 'ghost'",
       description:
-        'Visual trigger style. input is the bordered input treatment for forms; ghost is borderless and matches ghost buttons for toolbar usage.',
+        'Visual trigger style. input is the bordered input treatment for forms; secondary matches the secondary buttons of the active theme (borderless and neutral-filled by default) for navs and toolbars; ghost is borderless and transparent, matching ghost buttons for toolbar usage.',
       default: "'input'",
     },
     {
@@ -307,8 +307,9 @@ export const docs = {
       name: 'statusVariant',
       type: "'attached' | 'detached' | 'tooltip'",
       description:
-        'How the status message is placed relative to the input. attached overlaps directly below the bordered input and is only valid for the input variant; ghost selectors detach attached status messages by default. Use tooltip for compact toolbar controls.',
-      default: "'attached' for input selectors; 'detached' for ghost selectors",
+        'How the status message is placed relative to the input. attached overlaps directly below the bordered input and is only valid for the input variant; secondary and ghost selectors detach attached status messages by default. Use tooltip for compact toolbar controls.',
+      default:
+        "'attached' for input selectors; 'detached' for secondary and ghost selectors",
     },
     {
       name: 'renderOption',
@@ -439,7 +440,7 @@ export const docs = {
       {
         guidance: true,
         description:
-          'Use variant="ghost" when a selector sits in a toolbar with ghost buttons. If validation status is needed there, prefer statusVariant="tooltip" so the toolbar height stays compact.',
+          'Use variant="secondary" when a selector sits in a nav or toolbar beside secondary buttons or a segmented control, so it shares their treatment instead of reading as a form field. Use variant="ghost" when a selector sits in a toolbar with ghost buttons. If validation status is needed there, prefer statusVariant="tooltip" so the toolbar height stays compact.',
       },
       {
         guidance: true,
@@ -576,7 +577,7 @@ export const docsDense = {
       {
         guidance: true,
         description:
-          'Use variant="ghost" in toolbars with ghost buttons; prefer statusVariant="tooltip" for compact validation status.',
+          'Use variant="secondary" in navs/toolbars beside secondary buttons; use variant="ghost" in toolbars with ghost buttons; prefer statusVariant="tooltip" for compact validation status.',
       },
       {
         guidance: false,

package/src/Selector/Selector.spec.md

@@ -16,6 +16,8 @@ verified_by:
     packages/core/src/Selector/Selector.source-build.test.mjs,
     packages/core/src/Selector/__tests__/Selector.listbox.a11y.test.tsx,
     packages/core/src/Selector/__tests__/Listbox.a11y.chromium.spec.ts,
+    packages/core/src/Selector/__tests__/Selector.combobox.a11y.test.tsx,
+    packages/core/src/Selector/__tests__/Selector.combobox.a11y.chromium.spec.ts,
     apps/storybook/stories/Selector.stories.tsx,
     .github/scripts/story-play-guard.js,
   ]
@@ -60,6 +62,8 @@ connection between the closed trigger and its selection surface.
 - `isReadOnly` is additive and defaults to `false`. It preserves the selected
   value, focus, and form participation while removing selection-surface and
   editing affordances. `isDisabled` takes precedence when both are set.
+- `secondary` is an additive trigger variant. `input` remains the default;
+  existing `input` and `ghost` callers keep their released behavior.
 - `spec:AST-004/DEC-1` governs the state-derived indicator-space behavior in FR3.
 - 0.7.0 removes the `selector-clear-icon` alias; the shared clear glyph remains
   available through `input-clear-icon`.
@@ -122,15 +126,15 @@ connection between the closed trigger and its selection surface.
 This table names semantic concepts reviewers need. Prop syntax, complete defaults,
 and examples remain in `Selector.doc.mjs`.
 
-| Concept                | Closed values or states                | Meaning                                                  | Availability by variant/orientation/state | Default    | Owner    | Stability | Invalid-value behavior          |
-| ---------------------- | -------------------------------------- | -------------------------------------------------------- | ----------------------------------------- | ---------- | -------- | --------- | ------------------------------- |
-| trigger variant        | `input`, `ghost`                       | Form-field or toolbar presentation                       | All trigger states                        | `input`    | Selector | released  | TypeScript rejects other values |
-| size                   | `sm`, `md`, `lg`                       | Trigger and option-row density                           | All presentations                         | `md`       | Selector | released  | TypeScript rejects other values |
-| selected-mark position | `start`, `end`                         | Logical edge containing a rendered selection mark        | Every option row                          | `end`      | Selector | released  | TypeScript rejects other values |
-| presentation           | `popover`, `bottom-sheet`, `adaptive`  | Anchored pointer surface or modal compact-touch surface  | All trigger variants                      | `adaptive` | Selector | released  | TypeScript rejects other values |
-| popup semantics        | `listbox`; modal dialog containing one | Semantics follow the active presentation                 | Popover; bottom sheet                     | `listbox`  | Selector | released  | No separate role prop is public |
-| option-row state       | `selected`, `disabled`                 | Stable theming state on each option row                  | Every rendered option                     | neither    | Selector | released  | Unknown states are not emitted  |
-| read-only state        | `false`, `true`                        | Preserves and submits value without selection affordance | Closed trigger                            | `false`    | Caller   | additive  | Boolean normalization           |
+| Concept                | Closed values or states                | Meaning                                                  | Availability by variant/orientation/state | Default    | Owner    | Stability                      | Invalid-value behavior          |
+| ---------------------- | -------------------------------------- | -------------------------------------------------------- | ----------------------------------------- | ---------- | -------- | ------------------------------ | ------------------------------- |
+| trigger variant        | `input`, `secondary`, `ghost`          | Form-field or button-aligned toolbar presentation        | All trigger states                        | `input`    | Selector | released; `secondary` additive | TypeScript rejects other values |
+| size                   | `sm`, `md`, `lg`                       | Trigger and option-row density                           | All presentations                         | `md`       | Selector | released                       | TypeScript rejects other values |
+| selected-mark position | `start`, `end`                         | Logical edge containing a rendered selection mark        | Every option row                          | `end`      | Selector | released                       | TypeScript rejects other values |
+| presentation           | `popover`, `bottom-sheet`, `adaptive`  | Anchored pointer surface or modal compact-touch surface  | All trigger variants                      | `adaptive` | Selector | released                       | TypeScript rejects other values |
+| popup semantics        | `listbox`; modal dialog containing one | Semantics follow the active presentation                 | Popover; bottom sheet                     | `listbox`  | Selector | released                       | No separate role prop is public |
+| option-row state       | `selected`, `disabled`                 | Stable theming state on each option row                  | Every rendered option                     | neither    | Selector | released                       | Unknown states are not emitted  |
+| read-only state        | `false`, `true`                        | Preserves and submits value without selection affordance | Closed trigger                            | `false`    | Caller   | additive                       | Boolean normalization           |
 
 ## Behavioral and layout contract
 
@@ -217,14 +221,22 @@ These requirements describe shipped behavior on current `main`.
 
 No current design spec is linked.
 
-| Anatomy or state                 | Current representation requirement                                                                 | Representation authority   | Hierarchy role          | Component contract |
-| -------------------------------- | -------------------------------------------------------------------------------------------------- | -------------------------- | ----------------------- | ------------------ |
-| selected mark and option spacing | Empty resolved marks collapse; visible marks retain space, so row label geometry may vary by state | `spec:AST-004/DEC-1`       | supporting              | FR3                |
-| input versus ghost trigger       | none recorded                                                                                      | existing released behavior | form or toolbar control | Public concepts    |
+| Anatomy or state                 | Current representation requirement                                                                                        | Representation authority | Hierarchy role              | Component contract |
+| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | ------------------------ | --------------------------- | ------------------ |
+| selected mark and option spacing | Empty resolved marks collapse; visible marks retain space, so row label geometry may vary by state                        | `spec:AST-004/DEC-1`     | supporting                  | FR3                |
+| trigger variants                 | `input` reads as a form field; `secondary` matches adjacent secondary `Button`s; `ghost` matches adjacent ghost `Button`s | `component:Selector/DD1` | form or peer action control | Public concepts    |
 
 The first row implements the state-derived spacing decision in
 `spec:AST-004/DEC-1`.
 
+### Design decisions
+
+<!-- design-decisions:v1 -->
+
+| ID  | Decision                                                                        | Intent or reason                                                                                                                          | Applies to                                           | Allowed variation                                                                               |
+| --- | ------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
+| DD1 | A `secondary` Selector matches the visual role of adjacent secondary `Button`s. | A mixed toolbar or navigation area reads as one action hierarchy instead of making the Selector look like a form field or a ghost action. | The secondary trigger at rest and through its states | Themes may choose exact tokens while preserving parity with their secondary `Button` treatment. |
+
 ### Theming anatomy
 
 <!-- anatomy-theming:v1 -->
@@ -319,17 +331,18 @@ new theming target.
 
 ## Verification map
 
-| Contract              | Verification                                                                                                         | Representative states                                                                   | Mutation or failure expectation                                                                                                         | Audit section                    |
-| --------------------- | -------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
-| FR1, AR2, AR3         | `Selector.test.tsx` selection, focus, and keyboard suites                                                            | closed/open, search/non-search, disabled option                                         | Removing selection wiring, focus movement, or keyboard behavior fails the named interaction tests                                       | `audit:Selector/behavior`        |
-| FR2                   | placement and selected-item geometry tests                                                                           | default, explicit, RTL, transformed entry                                               | Using the wrong positioning model fails the expected position-area or margin                                                            | `audit:Selector/behavior`        |
-| FR3, AV1              | Focused `Selector.test.tsx` computed-display checks plus guarded Chromium Storybook matrix and stable visual stories | popover/bottom sheet, narrow/wide, start/end, LTR/RTL, selected/unselected, check/radio | Empty output reserves width, visible output collapses, logical placement flips incorrectly, or row content overflows                    | `audit:Selector/design-rendered` |
-| FR4, AR1, AR2         | presentation tests plus `aria-haspopup` source review                                                                | pointer, compact coarse pointer, search/non-search                                      | Wrong Popover/dialog roles or focus destinations fail tests; `aria-haspopup` values require source/a11y review                          | `audit:Selector/accessibility`   |
-| AR1, AV2              | `Selector.listbox.a11y.test.tsx` and `Listbox.a11y.chromium.spec.ts` against the shared Listbox contract             | popover/sheet, flat/grouped, selected/unselected, disabled, search, loading, custom RTL | A new or wider loss of role, listbox/option name, state, or ownership gates; the exact unnamed no-search sheet state remains known debt | `audit:Selector/accessibility`   |
-| FR5                   | loading, empty-state, and live-region tests                                                                          | empty options, unmatched search, loading                                                | Empty/no-results output appears or is announced while loading                                                                           | `audit:Selector/behavior`        |
-| FR6, AR4              | read-only interaction, form, ARIA, and theme-state tests                                                             | search/non-search, clearable, open→read-only, disabled precedence                       | A value changes, popup or edit affordance remains, form value disappears, or read-only semantics are absent                             | `audit:Selector/accessibility`   |
-| FR7                   | `Selector.test.tsx` press model suite                                                                                | finger release over another option, finger/mouse release outside, listbox marker        | The press option is selected, the listbox takes focus, a finger release outside closes the list, or the stray click selects             | `audit:Selector/behavior`        |
-| source-build contract | `Selector.source-build.test.mjs`                                                                                     | package source compiled by consumer Babel                                               | Moving evaluated StyleX values outside the supported source form fails compilation                                                      | `audit:Selector/code-health`     |
+| Contract                           | Verification                                                                                                         | Representative states                                                                                | Mutation or failure expectation                                                                                                                                                                                                                                  | Audit section                    |
+| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
+| FR1, AR2, AR3                      | `Selector.test.tsx` selection, focus, and keyboard suites                                                            | closed/open, search/non-search, disabled option                                                      | Removing selection wiring, focus movement, or keyboard behavior fails the named interaction tests                                                                                                                                                                | `audit:Selector/behavior`        |
+| FR2                                | placement and selected-item geometry tests                                                                           | default, explicit, RTL, transformed entry                                                            | Using the wrong positioning model fails the expected position-area or margin                                                                                                                                                                                     | `audit:Selector/behavior`        |
+| FR3, AV1                           | Focused `Selector.test.tsx` computed-display checks plus guarded Chromium Storybook matrix and stable visual stories | popover/bottom sheet, narrow/wide, start/end, LTR/RTL, selected/unselected, check/radio              | Empty output reserves width, visible output collapses, logical placement flips incorrectly, or row content overflows                                                                                                                                             | `audit:Selector/design-rendered` |
+| FR4, AR1, AR2                      | presentation tests plus `aria-haspopup` source review                                                                | pointer, compact coarse pointer, search/non-search                                                   | Wrong Popover/dialog roles or focus destinations fail tests; `aria-haspopup` values require source/a11y review                                                                                                                                                   | `audit:Selector/accessibility`   |
+| AR1, AV2                           | `Selector.listbox.a11y.test.tsx` and `Listbox.a11y.chromium.spec.ts` against the shared Listbox contract             | popover/sheet, flat/grouped, selected/unselected, disabled, search, loading, custom RTL              | A new or wider loss of role, listbox/option name, state, or ownership gates; the exact unnamed no-search sheet state remains known debt                                                                                                                          | `audit:Selector/accessibility`   |
+| FR5, FR6, AR1, AR2 (anchored), AR4 | `Selector.combobox.a11y.test.tsx` and `Selector.combobox.a11y.chromium.spec.ts` against the shared Combobox contract | closed, open with active option, read-only, busy, bottom-sheet open, search input with active option | The trigger or search input loses its role/name/state or popup kind, its open popup or active option relationship breaks, or read-only exposes a selection surface; the bottom-sheet trigger's `aria-controls` naming the inner listbox remains exact known debt | `audit:Selector/accessibility`   |
+| FR5                                | loading, empty-state, and live-region tests                                                                          | empty options, unmatched search, loading                                                             | Empty/no-results output appears or is announced while loading                                                                                                                                                                                                    | `audit:Selector/behavior`        |
+| FR6, AR4                           | read-only interaction, form, ARIA, and theme-state tests                                                             | search/non-search, clearable, open→read-only, disabled precedence                                    | A value changes, popup or edit affordance remains, form value disappears, or read-only semantics are absent                                                                                                                                                      | `audit:Selector/accessibility`   |
+| FR7                                | `Selector.test.tsx` press model suite                                                                                | finger release over another option, finger/mouse release outside, listbox marker                     | The press option is selected, the listbox takes focus, a finger release outside closes the list, or the stray click selects                                                                                                                                      | `audit:Selector/behavior`        |
+| source-build contract              | `Selector.source-build.test.mjs`                                                                                     | package source compiled by consumer Babel                                                            | Moving evaluated StyleX values outside the supported source form fails compilation                                                                                                                                                                               | `audit:Selector/code-health`     |
 
 ## Decision log