@astryxdesign/core 0.7.6-canary.f73623d → 0.7.6-canary.f77aaf2

package/src/DateTimeInput/DateTimeInput.fr10.test.tsx

@@ -1,319 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file DateTimeInput.fr10.test.tsx
- * @input Uses vitest, Testing Library, DateTimeInput, FormLayout, and the input-family FR10 test helpers
- * @output Tests that every DateTimeInput surface takes no root styling and routes
- *   base props, container*, and control* to their FR10 targets
- * @position Colocated test for family:input-fields FR10
- */
-
-import {
-  describe,
-  it,
-  expect,
-  vi,
-  beforeAll,
-  beforeEach,
-  afterEach,
-} from 'vitest';
-import {render, screen, fireEvent} from '@testing-library/react';
-import {DateTimeInput, type DateTimeInputProps} from './DateTimeInput';
-import {FormLayout} from '../FormLayout';
-import {expectFieldInputProps} from '../Field/fieldInputFamily.testing';
-import {describeFieldInputParts} from '../Field/fieldInputFamily.render-testing';
-
-// The date input is the field's semantic control: the label names it.
-const SURFACES = [
-  ['pointer', 'popover', 'input[role="combobox"]'],
-  ['native', 'native', 'input[type="date"]'],
-  ['touch', 'bottom-sheet', 'input[role="combobox"]'],
-] as const;
-
-// The touch surface's month scroller measures itself and its sheet is a
-// modal <dialog>; jsdom implements neither.
-class MockResizeObserver {
-  observe() {}
-  unobserve() {}
-  disconnect() {}
-}
-
-beforeAll(() => {
-  Element.prototype.scrollTo = vi.fn();
-  HTMLDialogElement.prototype.showModal = vi.fn(function (
-    this: HTMLDialogElement,
-  ) {
-    this.open = true;
-  });
-  HTMLDialogElement.prototype.close = vi.fn(function (this: HTMLDialogElement) {
-    this.open = false;
-  });
-});
-
-beforeEach(() => {
-  vi.stubGlobal('ResizeObserver', MockResizeObserver);
-});
-
-afterEach(() => {
-  vi.unstubAllGlobals();
-});
-
-function control(selector: string): HTMLElement {
-  const el = document.querySelector<HTMLElement>(selector);
-  if (el == null) {
-    throw new Error(`no control matching ${selector}`);
-  }
-  return el;
-}
-
-// A required value callback the tests do not observe.
-const noop = () => {};
-
-describe('DateTimeInput FR10 styling contract', () => {
-  it('has no root styling props and has the container* and control* parts', () => {
-    expectFieldInputProps<DateTimeInputProps>();
-  });
-
-  it('rejects root xstyle, className, and style at compile time', () => {
-    const typeOnly = () => (
-      <>
-        {/* Control: the same element without root styling compiles. */}
-        <DateTimeInput
-          onChange={noop}
-          label="L"
-          controlClassName="x"
-          containerClassName="y"
-        />
-        {/* @ts-expect-error -- root className is not a DateTimeInput prop (FR10) */}
-        <DateTimeInput onChange={noop} label="L" className="x" />
-        {/* @ts-expect-error -- root style is not a DateTimeInput prop (FR10) */}
-        <DateTimeInput onChange={noop} label="L" style={{margin: 1}} />
-        {/* @ts-expect-error -- root xstyle is not a DateTimeInput prop (FR10) */}
-        <DateTimeInput onChange={noop} label="L" xstyle={{}} />
-      </>
-    );
-    void typeOnly;
-  });
-});
-
-for (const [surface, presentation, selector] of SURFACES) {
-  describe(`${surface} surface`, () => {
-    describeFieldInputParts('DateTimeInput', {
-      renderMember: props => (
-        <DateTimeInput
-          onChange={noop}
-          label="Due"
-          presentation={presentation}
-          {...props}
-        />
-      ),
-      getControl: () => control(selector),
-      inGroup: false,
-    });
-  });
-
-  describe(`DateTimeInput (${surface}) FR10 details`, () => {
-    it('names the control from its label when the caller sets id', () => {
-      render(
-        <DateTimeInput
-          onChange={noop}
-          label="Due"
-          presentation={presentation}
-          id="due"
-        />,
-      );
-      expect(control(selector).id).toBe('due');
-      expect(document.querySelector('label[for="due"]')).not.toBeNull();
-    });
-
-    it("adds a caller's aria-describedby to the component's own", () => {
-      render(
-        <DateTimeInput
-          onChange={noop}
-          label="Due"
-          description="Pick a weekday"
-          presentation={presentation}
-          aria-describedby="caller-desc"
-        />,
-      );
-      const ids = control(selector)
-        .getAttribute('aria-describedby')
-        ?.split(' ');
-      expect(ids).toContain('caller-desc');
-      expect(ids?.length).toBeGreaterThan(1);
-    });
-
-    it('keeps component-only props off the control', () => {
-      const error = vi.spyOn(console, 'error').mockImplementation(() => {});
-      render(
-        <DateTimeInput
-          onChange={noop}
-          label="Due"
-          presentation={presentation}
-          hasSeconds
-          hourFormat="24h"
-          timeIncrement={5}
-          timeOptionInterval={30}
-          timeLabel="Time"
-          timePlaceholder="hh:mm"
-          numberOfMonths={2}
-          weekStartsOn={1}
-          hasClear
-          size="sm"
-          labelTooltip="tip"
-          placeholder="Pick"
-          isOptional
-          width={240}
-        />,
-      );
-      const attrs = [...control(selector).attributes].map(a => a.name);
-      for (const prop of [
-        'increment',
-        'hasautofocus',
-        'timeincrement',
-        'timeoptioninterval',
-        'numberofmonths',
-        'weekstartson',
-        'dateconstraints',
-        'hasclear',
-        'hasseconds',
-        'hourformat',
-        'statusvariant',
-        'labeltooltip',
-        'format',
-        'width',
-        'size',
-      ]) {
-        expect(attrs).not.toContain(prop);
-      }
-      expect(
-        error.mock.calls.filter(call =>
-          /React does not recognize|Invalid value for prop|non-boolean attribute/.test(
-            String(call[0]),
-          ),
-        ),
-      ).toEqual([]);
-      error.mockRestore();
-    });
-
-    it("names the control by its label and then a caller's aria-labelledby", () => {
-      render(
-        <>
-          <span id="caller-name">Billing</span>
-          <DateTimeInput
-            onChange={noop}
-            label="Due"
-            presentation={presentation}
-            aria-labelledby="caller-name"
-          />
-        </>,
-      );
-      const ids = control(selector).getAttribute('aria-labelledby')?.split(' ');
-      expect(ids?.at(-1)).toBe('caller-name');
-      const own = document.getElementById(ids?.[0] ?? '');
-      expect(own?.tagName).toBe('LABEL');
-      expect(own?.textContent).toContain('Due');
-    });
-
-    it('keeps control* on the control box in a horizontal-labels FormLayout', () => {
-      vi.spyOn(console, 'warn').mockImplementation(() => {});
-      const {container} = render(
-        <FormLayout direction="horizontal-labels">
-          <DateTimeInput
-            onChange={noop}
-            label="Due"
-            presentation={presentation}
-            controlClassName="fr10-control"
-          />
-        </FormLayout>,
-      );
-      const box = container.querySelector('.fr10-control');
-      expect(box).not.toBeNull();
-      expect(box).toContainElement(control(selector));
-      expect(box).not.toBe(control(selector));
-      vi.restoreAllMocks();
-    });
-  });
-}
-
-describe('DateTimeInput FR10 handler composition', () => {
-  it('runs a caller onClick after the pointer field opens its calendar', () => {
-    const onClick = vi.fn();
-    render(
-      <DateTimeInput
-        onChange={noop}
-        label="Due"
-        presentation="popover"
-        onClick={onClick}
-      />,
-    );
-    const input = screen.getByRole('combobox', {name: 'Due'});
-    fireEvent.click(input);
-    expect(onClick).toHaveBeenCalledOnce();
-    expect(input).toHaveAttribute('aria-expanded', 'true');
-  });
-
-  it('runs a caller onKeyDown for keys the field does not consume', () => {
-    const onKeyDown = vi.fn();
-    render(
-      <DateTimeInput
-        onChange={noop}
-        label="Due"
-        presentation="popover"
-        onKeyDown={onKeyDown}
-      />,
-    );
-    fireEvent.keyDown(screen.getByRole('combobox', {name: 'Due'}), {key: 'a'});
-    expect(onKeyDown).toHaveBeenCalledOnce();
-  });
-
-  it('runs a caller onClick after the touch field opens its sheet', () => {
-    const onClick = vi.fn();
-    render(
-      <DateTimeInput
-        onChange={noop}
-        label="Due"
-        presentation="bottom-sheet"
-        onClick={onClick}
-      />,
-    );
-    const input = screen.getByRole('combobox', {name: 'Due'});
-    fireEvent.click(input);
-    expect(onClick).toHaveBeenCalledOnce();
-    expect(input).toHaveAttribute('aria-expanded', 'true');
-  });
-
-  it('still hands a caller onKeyDown the keys the field consumes, after the field', () => {
-    const seen: {key: string; defaultPrevented: boolean}[] = [];
-    render(
-      <DateTimeInput
-        onChange={noop}
-        label="Due"
-        presentation="popover"
-        onKeyDown={event =>
-          seen.push({key: event.key, defaultPrevented: event.defaultPrevented})
-        }
-      />,
-    );
-    fireEvent.keyDown(screen.getByRole('combobox', {name: 'Due'}), {
-      key: 'Enter',
-    });
-    expect(seen).toEqual([{key: 'Enter', defaultPrevented: true}]);
-  });
-
-  it('runs a caller onBlur on the native field', () => {
-    const onBlur = vi.fn();
-    render(
-      <DateTimeInput
-        onChange={noop}
-        label="Due"
-        presentation="native"
-        onBlur={onBlur}
-      />,
-    );
-    const input = control('input[type="date"]');
-    fireEvent.focus(input);
-    fireEvent.blur(input);
-    expect(onBlur).toHaveBeenCalledOnce();
-  });
-});

package/src/DateTimeInput/DateTimeInput.spec.md

@@ -1,270 +0,0 @@
----
-schema_version: 3
-template_version: 7
-kind: component
-id: component:DateTimeInput
-authority: current
-archive_reason: null
-superseded_by: null
-approved_by: cixzhang
-approved_at: 2026-10-30
-owners: [cixzhang]
-review_triggers: [public-api, behavior, layout, theming, accessibility]
-verified_by:
-  [
-    packages/core/src/DateTimeInput/DateTimeInput.test.tsx,
-    packages/core/src/DateTimeInput/DateTimeInputTouch.test.tsx,
-    packages/core/src/DateTimeInput/NativePickerSegments.test.tsx,
-    packages/core/src/DateTimeInput/Presentation.test.tsx,
-    packages/core/src/DateTimeInput/DateTimeInput.fr10.test.tsx,
-    packages/core/src/__tests__/BusyOwnerAnnouncement.test.tsx,
-    packages/core/src/theme/themingTargets.test.ts,
-    scripts/check-knowledge.mjs,
-  ]
-modules: []
-families: [family:input-fields, family:overlay-dismissal]
-design_specs: []
-architecture:
-  [
-    architecture:component-theming-surface,
-    architecture:internationalization,
-    architecture:public-component-api,
-  ]
-contributing: []
-system_specs: [spec:AST-043, spec:AST-085, spec:AST-086, spec:AST-102]
----
-
-# DateTimeInput component contract
-
-## Contract at a glance
-
-| Area                    | Contract                                                                                                                                                                                                                                                                                                                                                                                        |
-| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Public contract         | One controlled ISO date-time value presented through coordinated date and time segments; `presentation` selects Astryx, native, or adaptive picker surfaces.                                                                                                                                                                                                                                    |
-| Behavior                | Date and time changes emit one combined value; clear emits `undefined`; controlled empty state remains empty in every rendered picker.                                                                                                                                                                                                                                                          |
-| End-user impact         | People selecting a date and time see one value reflected consistently in the closed field and the active picker, including after clearing.                                                                                                                                                                                                                                                      |
-| Builder impact          | A caller that relied on the `12h` hour-format default under a 24-hour locale passes `hourFormat="12h"` to keep twelve-hour time text. A per-user 12/24-hour preference goes on the provider locale as a `-u-hc-` extension (`en-US-u-hc-h23`).                                                                                                                                                  |
-| Compatibility/readiness | The `hourFormat` default is the provider locale's hour cycle (`12h` for `en`/`en-US` and with no provider); every other released default, API, and DOM shape holds. The presentation matrix and deprecated `nativePicker` mapping follow `spec:AST-043`. Fixed segment height, typed-time prefix commits, busy paint, and caller handlers while disabled are listed under Current-state impact. |
-| Review checks           | Reject competing picker selection, date/time output that is not one valid combined value, presentation precedence drift, lost per-segment fallback, or broken segment accessibility.                                                                                                                                                                                                            |
-| Governing rules         | `spec:AST-043`, `family:input-fields`, `family:overlay-dismissal`, `spec:AST-085`, `spec:AST-086` FR8, and objective platform accessibility standards.                                                                                                                                                                                                                                          |
-
-This table is a review projection; the body below is authoritative.
-
-## Intent
-
-DateTimeInput presents one controlled date-time value as coordinated date and time
-segments under one field label. Depending on `presentation`, the segments use
-Astryx popovers, one coordinated bottom sheet, browser or operating-system inputs,
-or pointer-adaptive combinations of those surfaces.
-
-## Compatibility and migration
-
-- Released default preserved: `yes`, except `hourFormat`, which follows the
-  provider locale's hour cycle (`12h` for `en` and `en-US`, the released
-  default with no provider) and shares TimeInput's locale time text
-- Compatibility class: default change for non-English-US locales; existing
-  types, callbacks, roles, and exports remain stable
-- Controlled/uncontrolled behavior: DateTimeInput remains controlled; `undefined`
-  represents no committed date-time value
-- Migration decision: none; picker presentation and deprecated `nativePicker`
-  compatibility remain governed by `spec:AST-043`
-
-Consumer migration instructions belong in consumer docs and release notes.
-
-## Ownership boundary
-
-**Owns**
-
-- Coordinating date and time segments into one controlled ISO date-time value.
-- Choosing and composing the date and time surfaces selected by `presentation`.
-- Applying component-local date-time bounds, date constraints, time precision,
-  typed-time stepping, and optional preset-time behavior.
-- Emitting `onChange` before an optional optimistic `changeAction`.
-- The disabled-reason Tooltip composition, which `family:input-fields` assigns
-  to the member.
-
-**Does not own / non-goals**
-
-- Field label, description, status, and clear-button presentation —
-  owned by Field under `family:input-fields` (shared owner section) and
-  `component:FieldStatus`.
-- Calendar-grid rendering and date-cell interaction — owned by
-  Calendar.
-- Popover and sheet hosting or dismissal — owned by the composed layer components
-  and `family:overlay-dismissal`.
-- Cross-component picker-presentation vocabulary and deprecated-prop mapping —
-  owned by `spec:AST-043`.
-
-## Public concepts
-
-| Concept                 | Closed values or states                                                         | Meaning                                                                     | Availability by variant/orientation/state                         | Default           | Owner                     | Stability  | Invalid-value behavior                         |
-| ----------------------- | ------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | ----------------------------------------------------------------- | ----------------- | ------------------------- | ---------- | ---------------------------------------------- |
-| Committed date-time     | valid ISO local date-time string or `undefined`                                 | The one controlled value reflected by both segments and active picker.      | Every presentation.                                               | `undefined`       | `component:DateTimeInput` | Stable     | Rejected edits revert without emitting change. |
-| Picker presentation     | `popover`, `bottom-sheet`, `native`, `adaptive-bottom-sheet`, `adaptive-native` | Selects which surface collects date and time.                               | Every render; pointer adaptation applies only to adaptive values. | `adaptive-native` | `spec:AST-043`            | Stable     | Type-rejected.                                 |
-| Legacy picker selection | `touch`, `always`, `never`                                                      | Deprecated compatibility input mapped by `spec:AST-043`; presentation wins. | When `presentation` is omitted.                                   | `touch`           | `spec:AST-043`            | Deprecated | Type-rejected.                                 |
-| Time precision          | minute-only or seconds                                                          | Controls value precision and whether native time can represent it.          | Every presentation; native fallback follows `spec:AST-043`.       | minute-only       | `component:DateTimeInput` | Stable     | Type-rejected.                                 |
-| Preset-time cadence     | omitted, `5`, `10`, `15`, `30`, or `60` minutes                                 | Adds a fine-pointer time listbox without restricting typed entry.           | Astryx pointer time field only.                                   | omitted           | `component:DateTimeInput` | Stable     | Type-rejected.                                 |
-
-## Behavioral and layout contract
-
-| ID  | Invariant                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Basis                                                                                                   |
-| --- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------- |
-| FR1 | DateTimeInput MUST reflect one controlled date-time value across its visible segments and active picker, and MUST NOT reveal a competing selected date after the parent accepts a clear.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Public docs, controlled component seam, current source, focused tests                                   |
-| FR2 | Every committed date or time change MUST emit one valid combined ISO date-time value; clearing MUST emit `undefined`; changing time while no date is committed MUST emit nothing.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Public types, docs, current source, focused tests                                                       |
-| FR3 | `presentation`, deprecated `nativePicker`, precedence, pointer adaptation, forced surfaces, and per-segment native fallbacks MUST follow `spec:AST-043` FR1–FR4.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | `spec:AST-043`                                                                                          |
-| FR4 | When `changeAction` is present, every value-change path MUST call `onChange` first, show the proposed controlled value optimistically, and contribute to one busy state until the controlled value accepts or replaces it.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | `family:input-fields/FR6`                                                                               |
-| FR5 | The two pointer segments share one row while each retains its intrinsic basis; when the container is narrower, flex wrapping moves them into separate full-width rows. Each segment is the shared element height for its size, as a minimum that grows with a set text size under `spec:AST-102` FR4. Implementation gap: the height is fixed at that size.                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Public docs, current source, focused layout tests; `spec:AST-102` FR4                                   |
-| FR6 | Date-time bounds and date constraints MUST prevent invalid commits. Native controls MAY receive platform hints, but JavaScript validation remains the final commit boundary; calendar-only options MAY be unavailable on native surfaces.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Public docs, current source, focused presentation tests                                                 |
-| FR7 | A preset-time listbox MUST remain optional, preserve typed entry, expose one selected option independently from keyboard highlight, and limit offered values to the selected date's effective minimum and maximum. Time text and typed times MUST follow the active locale's digits, separator, and day-period words (`architecture:internationalization` INV1a, INV8). The hour format is `hourFormat` when set, else the provider locale's hour cycle; time text, preset options, and the stepped-time announcement come from the shared time formatter, and typed times parse the locale's digits, separators, and day-period words as well as English. Implementation gap: the typed time field commits as soon as a prefix parses.                                                                            | Public docs, current source, focused interaction tests; `architecture:internationalization` INV1a, INV8 |
-| FR8 | Base props and `ref` MUST reach the date segment's input; a caller `aria-describedby` joins the component's own descriptions, and a caller DOM handler runs after the field's own handler. `container*` reaches the Field box and `control*` the segment row; root `xstyle`, `className`, and `style` are not accepted.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | `family:input-fields` FR10; `DateTimeInput.fr10.test.tsx`                                               |
-| FR9 | A disabled field MUST keep both segments focusable with `aria-disabled` and no native `disabled`, block every value-changing path, keep the calendar button's tab stop, and paint the keyboard focus ring. Explicit `isLoading` makes every surface inert the same way; a pending `changeAction` does so only on the popover surface, and the bottom sheet and any field with a native date segment keep accepting edits. The busy start is announced once. Implementation gap: a caller `onKeyDown` and other DOM handlers on the date segment still run while disabled (`spec:AST-085` FR2). Implementation gap: a busy field that is not disabled takes the disabled paint (half opacity), on every surface while `isLoading` and on the popover while a `changeAction` is pending, against `spec:AST-085` FR6. | `spec:AST-085` FR1, FR2, FR6; `spec:AST-086` FR8; current source and tests                              |
-
-### Allowed variation
-
-- **AV1 — Surface.** The caller may force Astryx, native, or bottom-sheet surfaces,
-  or choose an adaptive presentation within the current system-spec matrix.
-- **AV2 — Date and time formatting.** Locale, hour format, seconds, week start,
-  month count, and preset cadence may vary through their documented inputs.
-- **AV3 — Optional field support.** Clear, loading, status, disabled reason,
-  description, and label visibility may be omitted without changing value ownership.
-
-### Representative states
-
-| State                       | Required invariant                                                                                                                                                                                          | Allowed variation                          |
-| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
-| Empty                       | Both segments and every active picker expose no committed selection.                                                                                                                                        | Placeholder and selected surface.          |
-| Date-time value             | Date segment, time segment, and active picker reflect the same committed value.                                                                                                                             | Locale, hour format, and time precision.   |
-| Cleared after picker change | Closed field is empty and reopening the picker reveals no selected date or retained committed time.                                                                                                         | Picker focus date may remain navigational. |
-| Busy                        | Proposed value remains visible; both editable segments expose busy. With explicit `isLoading`, mutation paths are unavailable on every surface; with a pending `changeAction`, only on the popover surface. | Explicit loading or pending action source. |
-| Focusable disabled          | Both segments stay focusable with `aria-disabled` while every value-changing path stays blocked.                                                                                                            | Disabled-reason text.                      |
-
-### Transformation and precedence order
-
-- **ORD1 — Picker selection.** Resolve `presentation` before deprecated
-  `nativePicker`, apply pointer adaptation, then apply only the per-segment native
-  fallbacks permitted by `spec:AST-043`.
-- **ORD2 — Value mutation.** Validate the proposed segment value, combine it with
-  its committed counterpart, call `onChange`, present the optimistic combined
-  value, then run `changeAction` in a transition.
-
-### Performance and resources
-
-- **PR1 — Preset options.** The time listbox mounts option nodes only while open;
-  omitted preset cadence leaves no listbox nodes or combobox semantics.
-
-Current measurements belong in the audit record; this subsection owns only
-durable constraints and their verification target.
-
-## Accessibility contract
-
-- **AR1 — Field naming.** The date segment is named by the field label; the time
-  segment uses `timeLabel` or a localized label-derived fallback. Description,
-  status, and disabled-reason text remain referenced from both segments.
-- **AR2 — Picker semantics.** The Astryx date segment is a combobox controlling a
-  dialog; the optional preset-time field is a combobox controlling one listbox.
-  Omitted preset cadence leaves the time field without combobox semantics.
-- **AR3 — Keyboard and focus.** Documented keyboard activation, date-popover
-  dismissal, preset-time navigation, focus containment, and focus restoration
-  remain operable on their active surfaces.
-- **AR4 — Required, invalid, busy, and disabled.** Both editable segments expose
-  applicable required, invalid, busy, and disabled states; a focusable disabled
-  reason never re-enables mutation.
-
-## Design relationships
-
-| Anatomy or state     | Design requirement                                                 | Representation authority                        | Hierarchy role | Component contract |
-| -------------------- | ------------------------------------------------------------------ | ----------------------------------------------- | -------------- | ------------------ |
-| Segment row          | Groups the two bordered segments and wraps them as one layout row. | Current source and public docs                  | Prominent      | FR1, FR5           |
-| Date segment         | Presents date text and access to the active date picker.           | Current source and public docs                  | Prominent      | FR1–FR3, AR1–AR3   |
-| Time segment         | Presents time text and access to the active time surface.          | Current source and public docs                  | Prominent      | FR1–FR3, AR1–AR3   |
-| Picker surfaces      | Collect date and time without becoming competing values.           | `spec:AST-043` and composed component contracts | Supporting     | FR1–FR3            |
-| Busy/disabled/status | Uses shared input-family representations.                          | `family:input-fields`                           | Supporting     | FR4, AR4           |
-
-The component implements design requirements without copying their rationale.
-An unsettled representation remains a human decision; principles do not let an
-agent invent the answer.
-
-### Theming anatomy
-
-<!-- anatomy-theming:v1 -->
-
-```json
-{
-  "Label": {
-    "delegatesTo": {"owner": "component:Field", "target": "field-label"}
-  },
-  "Segment row": {"target": "date-time-input"},
-  "Date input": {"target": "date-time-input-date-segment"},
-  "Calendar icon": {"target": "date-time-input-toggle-icon"},
-  "Date picker": {
-    "none": {
-      "reason": "reachability-gap: Active picker paint is owned by Calendar, Popover, BottomSheet, or the browser-native control, so no single DateTimeInput target reaches every presentation."
-    }
-  },
-  "Time input": {"target": "date-time-input-time-segment"},
-  "Clock icon": {"target": "date-time-input-clock-icon"},
-  "Time options popover": {"target": "date-time-input-time-listbox"},
-  "Time option": {"target": "date-time-input-time-option"},
-  "Clear button": {
-    "delegatesTo": {"owner": "component:Field", "target": "input-clear-button"}
-  },
-  "Status message": {
-    "delegatesTo": {"owner": "component:FieldStatus", "target": "field-status"}
-  }
-}
-```
-
-The calendar-toggle target reflects expanded or collapsed state. The time-options
-listbox owns option rows through the `date-time-input-time-option` target; the
-leading clock glyph uses `date-time-input-clock-icon`.
-
-## Family and system relationships
-
-- `family:input-fields` owns shared field sizing, end-control geometry, loading,
-  optimistic change actions, status placement, disabled reasons, and iOS text-entry
-  focus-zoom behavior.
-- `family:overlay-dismissal` owns the Popover and BottomSheet dismissal stack.
-- `architecture:component-theming-surface` owns target admission, state
-  reflection, and anatomy mapping.
-- `spec:AST-043` owns picker-presentation values, defaults, precedence,
-  compatibility mapping, forced surfaces, and native fallback rules.
-
-## Verification map
-
-| Contract            | Verification                                                                                                 | Representative states                                         | Mutation or failure expectation                                                                                                                                                                                                                      | Audit section                     |
-| ------------------- | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- |
-| FR1–FR2             | `DateTimeInput.test.tsx`                                                                                     | empty, calendar selection, typed date/time, clear             | A stale Calendar selection, partial output, or invalid mutation makes a public-state test fail.                                                                                                                                                      | `audit:DateTimeInput/behavior`    |
-| FR3, FR6            | `Presentation.test.tsx`, `NativePickerSegments.test.tsx`, `DateTimeInputTouch.test.tsx`                      | forced, adaptive, legacy, native fallback, constrained commit | A substituted surface, precedence drift, or invalid commit makes a presentation test fail.                                                                                                                                                           | `audit:DateTimeInput/surfaces`    |
-| FR4, FR9, AR4       | `DateTimeInput.test.tsx`, `DateTimeInputTouch.test.tsx`; `BusyOwnerAnnouncement.test.tsx` DateTimeInput case | pending, loading, disabled reason                             | Mutation during busy/disabled state or stale optimistic output makes a state test fail. Evidence gap: no test asserts that caller handlers still run while disabled.                                                                                 | `audit:DateTimeInput/state`       |
-| FR5                 | `DateTimeInput.test.tsx`                                                                                     | intrinsic row, narrow-container wrap classes                  | Removing the intrinsic basis or wrap styles makes the class-level layout assertions fail; rendered geometry remains review evidence. Evidence gap: no test asserts segment heights or text growth.                                                   | `audit:DateTimeInput/layout`      |
-| FR7, AR1–AR3        | `DateTimeInput.test.tsx`, `DateTimeInputTouch.test.tsx`                                                      | popovers, time options, keyboard/focus                        | Wrong role, name, state, keyboard behavior, or focus behavior makes a focused interaction test fail. A provider-locale test asserts the closed time text follows the locale's hour cycle and day period; the shared formatter's tests cover parsing. | `audit:DateTimeInput/interaction` |
-| FR8                 | `DateTimeInput.fr10.test.tsx`                                                                                | each surface; caller id, describedby, onClick, onKeyDown      | A base prop off the date input, a dropped caller description, or styling on the wrong part fails.                                                                                                                                                    | `audit:DateTimeInput/api`         |
-| Theming anatomy map | `scripts/check-knowledge.mjs`, `themingTargets.test.ts`                                                      | root, segments, icons, listbox, options                       | Missing, undocumented, or wrongly placed targets fail knowledge or target checks.                                                                                                                                                                    | `audit:DateTimeInput/theming`     |
-
-## Current-state impact
-
-- **Fixed height (FR5).** Segments hold the fixed shared element height instead
-  of growing with a set text size, against `spec:AST-102` FR4.
-- **Typed-time prefix commits (FR7).** The typed time field commits a parsed
-  prefix, so a typed time can commit a different time, against
-  `architecture:internationalization` INV8.
-- **Busy paint (FR9).** A busy field that is not disabled takes the disabled
-  half-opacity paint, against `spec:AST-085` FR6.
-- **Caller handlers while disabled (FR9).** Caller DOM handlers on the date
-  segment, such as `onKeyDown`, still run while disabled, against
-  `spec:AST-085` FR2.
-
-## Decision log
-
-No component-local decision. Cross-component picker decisions live in
-`spec:AST-043`.
-
-## Open questions
-
-None.
-
-## Content boundary
-
-This file does not duplicate consumer prop tables or examples, current audit
-results, implementation steps, Calendar/Field/layer contracts, or the
-picker-presentation system specification.