@astryxdesign/core 0.7.5 → 0.7.6-canary.0ef60dd

package/src/TextInput/TextInput.test.tsx

@@ -823,6 +823,27 @@ describe('TextInput', () => {
     });
   });
 
+  it('keeps the clear button where it is when the field turns busy', () => {
+    // What follows the button in the lane (a `<template>` is not rendered).
+    const after = (button: HTMLElement) =>
+      Array.from(button.parentElement?.children ?? [])
+        .slice(Array.from(button.parentElement?.children ?? []).indexOf(button))
+        .filter(el => el !== button && el.tagName !== 'TEMPLATE');
+    const props = {label: 'Name', value: 'hello', onChange: () => {}};
+    const {rerender} = render(<TextInput {...props} hasClear />);
+    const idle = screen.getByRole('button', {name: 'Clear Name'});
+    const idleAfter = after(idle).length;
+
+    rerender(<TextInput {...props} hasClear isLoading />);
+    const busy = screen.getByRole('button', {name: 'Clear Name'});
+    // The Spinner joins on the inward side, before the button, so nothing new
+    // follows it and its distance from the end does not change.
+    expect(after(busy)).toHaveLength(idleAfter);
+    expect(busy.previousElementSibling?.getAttribute('aria-hidden')).toBe(
+      'true',
+    );
+  });
+
   describe('click-to-focus', () => {
     it('focuses input when clicking the start icon', () => {
       render(

package/src/TextInput/TextInput.tsx

@@ -537,13 +537,15 @@ export function TextInput({
         aria-labelledby={inputLabelledBy}
         {...stylex.props(styles.input, isDisabled && styles.inputDisabled)}
       />
+      {/* The Spinner comes first so it appears inward of the clear button
+          and the button keeps its place when the field turns busy. */}
+      {isBusy && <Spinner size="sm" aria-hidden="true" />}
       {hasClear && value !== '' && !isDisabled && !isReadOnly && (
         <InputClearButton
           label={t('@astryx.textInput.clearLabel', {label})}
           onClick={handleClear}
         />
       )}
-      {isBusy && <Spinner size="sm" aria-hidden="true" />}
       {statusIcon}
     </div>
   );

package/src/TimeInput/NativeTimeInput.test.tsx

@@ -10,6 +10,7 @@
 import {afterEach, describe, expect, it, vi} from 'vitest';
 import {act, fireEvent, render, screen} from '@testing-library/react';
 import {TimeInput} from './TimeInput';
+import {InternationalizationProvider} from '../i18n';
 import {InputGroup, InputGroupText} from '../InputGroup';
 import {resetDateSegmentProbe} from '../DateInput/nativeDateSegments';
 import type {ISOTimeString} from '../utils';
@@ -48,6 +49,22 @@ afterEach(() => {
 });
 
 describe('TimeInput nativePicker', () => {
+  it("shows the resting value in the locale's hour cycle", () => {
+    stubPointer(true);
+    render(
+      <InternationalizationProvider locale="de-DE">
+        <TimeInput
+          label="Start time"
+          value={'14:30' as ISOTimeString}
+          onChange={() => {}}
+        />
+      </InternationalizationProvider>,
+    );
+    expect(getNativeTimeInput()).toHaveValue('14:30');
+    expect(screen.getByText('14:30')).toBeInTheDocument();
+    expect(screen.queryByText('2:30 PM')).toBeNull();
+  });
+
   it('uses the browser/OS picker on a coarse pointer by default', () => {
     stubPointer(true);
     render(

package/src/TimeInput/Presentation.test.tsx

@@ -10,6 +10,8 @@
 import {afterEach, beforeAll, describe, expect, it, vi} from 'vitest';
 import {fireEvent, render, screen} from '@testing-library/react';
 import {TimeInput} from './TimeInput';
+import {InternationalizationProvider} from '../i18n';
+import type {ISOTimeString} from '../utils';
 import {resetDateSegmentProbe} from '../DateInput/nativeDateSegments';
 
 const HOVER_CAPABLE = /\(\s*hover\s*:\s*hover\s*\)/;
@@ -80,6 +82,25 @@ describe('TimeInput presentation', () => {
     }
   });
 
+  it("bottom-sheet follows the locale's hour cycle in its text and wheels", () => {
+    stubPointer(false);
+    render(
+      <InternationalizationProvider locale="de-DE">
+        <TimeInput
+          label="Start"
+          presentation="bottom-sheet"
+          value={'14:30' as ISOTimeString}
+          onChange={() => {}}
+        />
+      </InternationalizationProvider>,
+    );
+    const input = screen.getByRole('combobox', {name: 'Start'});
+    expect(input).toHaveValue('14:30');
+    fireEvent.click(input);
+    expect(screen.getByRole('listbox', {name: 'Hour'})).toBeInTheDocument();
+    expect(screen.queryByRole('listbox', {name: 'AM/PM'})).toBeNull();
+  });
+
   it('bottom-sheet renders the sheet field even on a fine pointer', () => {
     stubPointer(false);
     render(

package/src/TimeInput/TimeInput.doc.mjs

@@ -31,7 +31,7 @@ export const docs = {
       {
         guidance: true,
         description:
-          "Choose the hour format (12h or 24h) that matches your audience's locale: 12-hour with AM/PM for US-centric UIs, 24-hour for international or technical contexts.",
+          "Leave hourFormat unset so the field follows the InternationalizationProvider locale's hour cycle (12-hour in en-US, 24-hour in en-GB or de-DE). Set it only when the field itself needs a fixed format, and carry a person's own 12/24-hour preference on the provider locale (e.g. 'en-US-u-hc-h23') rather than on each field.",
       },
       {
         guidance: true,
@@ -206,8 +206,8 @@ export const docs = {
       name: 'hourFormat',
       type: "'12h' | '24h'",
       description:
-        "Controls the display format. '12h' shows AM/PM (e.g. '2:30 PM'); '24h' uses 24-hour notation (e.g. '14:30').",
-      default: "'12h'",
+        "Controls the display format. '12h' shows the locale's day period (e.g. '2:30 PM', '오후 2:30'); '24h' uses 24-hour notation (e.g. '14:30'). When unset, follows the InternationalizationProvider locale's hour cycle: en-US reads 12-hour, en-GB and de-DE read 24-hour. To honor a person's own preference, pass it on the locale tag (e.g. 'en-US-u-hc-h23') rather than per field.",
+      default: "the locale's hour cycle",
     },
     {
       name: 'increment',
@@ -387,8 +387,8 @@ export const docsZh = {
       name: 'hourFormat',
       type: "'12h' | '24h'",
       description:
-        "控制显示格式。'12h' 显示 AM/PM（例如 '2:30 PM'）；'24h' 使用 24 小时制（例如 '14:30'）。",
-      default: "'12h'",
+        "控制显示格式。'12h' 使用区域设置的上午/下午用语（例如 '2:30 PM'、'오후 2:30'）；'24h' 使用 24 小时制（例如 '14:30'）。未设置时遵循 InternationalizationProvider 区域设置的小时制：en-US 为 12 小时制，en-GB 和 de-DE 为 24 小时制。要遵循用户自己的偏好，请在区域标签中传入（例如 'en-US-u-hc-h23'），而不是逐个字段设置。",
+      default: '区域设置的小时制',
     },
     {
       name: 'increment',
@@ -476,7 +476,7 @@ export const docsZh = {
       {
         guidance: true,
         description:
-          "Choose the hour format (12h or 24h) that matches your audience's locale: 12-hour with AM/PM for US-centric UIs, 24-hour for international or technical contexts.",
+          "Leave hourFormat unset so the field follows the InternationalizationProvider locale's hour cycle (12-hour in en-US, 24-hour in en-GB or de-DE). Set it only when the field itself needs a fixed format, and carry a person's own 12/24-hour preference on the provider locale (e.g. 'en-US-u-hc-h23') rather than on each field.",
       },
       {
         guidance: true,
@@ -565,7 +565,7 @@ export const docsDense = {
       {
         guidance: true,
         description:
-          'Choose hour format (12h/24h) to match locale: 12h for US, 24h for international.',
+          "Leave hourFormat unset to follow the provider locale's hour cycle; put a person's 12/24h preference on the locale tag (en-US-u-hc-h23), not on each field.",
       },
       {
         guidance: true,
@@ -624,7 +624,7 @@ export const docsDense = {
     hasSeconds: 'Includes seconds in display+parsing.',
     hasClear: 'Shows clear button when value set+not disabled.',
     hourFormat:
-      "Display format. '12h' shows AM/PM; '24h' uses 24-hour notation.",
+      "Display format. '12h' shows the locale's day period; '24h' uses 24-hour notation. Unset follows the provider locale's hour cycle (a -u-hc- tag carries a user preference).",
     increment:
       'Minutes to add/subtract on arrow up/down. Whole minutes only; a fractional value leaves the time unchanged.',
     presentation:

package/src/TimeInput/TimeInput.spec.md

@@ -37,15 +37,15 @@ system_specs: [spec:AST-043, spec:AST-085, spec:AST-086, spec:AST-102]
 
 ## Contract at a glance
 
-| Area                    | Contract                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
-| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Public contract         | None changes. TimeInput takes an ISO time `value`, `onChange`, `changeAction`, `isLoading`, `min`, `max`, `hasSeconds`, `hourFormat`, `increment`, `hasClear`, `presentation` (and deprecated `nativePicker`), Field props, size, status, and the input-family part props.                                                                                                                                                                                                                                                                                                                                                                                                                                                |
-| Behavior                | `presentation` picks the surface: a typed field, the browser time picker, or bottom-sheet wheels, each committing ISO times inside the range through `onChange` and an optional `changeAction`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| End-user impact         | Desktop users type times in many forms and step with arrows; touch users get the OS picker by default. Keyboard and screen-reader users can reach a disabled field and hear invalid entries and stepped times.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
-| Builder impact          | None.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
-| Compatibility/readiness | Records shipped behavior; no API, default, or DOM change. Caller handlers other than focus, blur, and click still run while disabled, the format hint is fixed English, the clear and Save buttons scale under reduced motion, the grouped sheet field is unnamed by its own label, stepping a draft shows stale text, a focused clear button drops focus when disabled, the sheet surface is pointer-only, the sheet and native surfaces drop focus on clear, the format hint outlasts a disable, the grouped tooltip status describes nothing, time text ignores the locale's digits, separator, and day periods, and typed parsing ignores the locale and commits prefixes; all are listed under Current-state impact. |
-| Review checks           | Reject a surface other than the one `presentation` names, a commit outside `min`/`max`, an Action skipped by clear, a disabled field that leaves the tab order or changes value, or `nativePicker` winning over `presentation`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| Governing rules         | `spec:AST-043` FR1–FR4; `family:input-fields` FR3–FR6, FR8–FR11; `spec:AST-085` FR1, FR2, FR4, FR6; `spec:AST-086` FR3, FR4, FR8; `architecture:internationalization` INV1a, INV8; `design:reduced-motion` DR1; `architecture:interaction-modality` INV4.                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| Area                    | Contract                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Public contract         | The Hour format default is the provider locale's hour cycle, not a fixed `12h`; no prop, type, or export changes. TimeInput takes an ISO time `value`, `onChange`, `changeAction`, `isLoading`, `min`, `max`, `hasSeconds`, `hourFormat`, `increment`, `hasClear`, `presentation` (and deprecated `nativePicker`), Field props, size, status, and the input-family part props.                                                                                                                                                                                                                                                                                                                                                                                                |
+| Behavior                | `presentation` picks the surface: a typed field, the browser time picker, or bottom-sheet wheels, each committing ISO times inside the range through `onChange` and an optional `changeAction`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| End-user impact         | Desktop users type times in many forms and step with arrows; touch users get the OS picker by default. Keyboard and screen-reader users can reach a disabled field and hear invalid entries and stepped times.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| Builder impact          | A caller that relied on the `12h` default under a 24-hour locale passes `hourFormat="12h"` to keep twelve-hour text. A per-user 12/24-hour preference goes on the provider locale as a `-u-hc-` extension (`en-US-u-hc-h23`) rather than on each field.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| Compatibility/readiness | The `hourFormat` default is the provider locale's hour cycle, which is `12h` for `en`/`en-US` and with no provider; every other released default, API, and DOM shape holds. Caller handlers other than focus, blur, and click still run while disabled, the clear and Save buttons scale under reduced motion, the grouped sheet field is unnamed by its own label, stepping a draft shows stale text, a focused clear button drops focus when disabled, the sheet surface is pointer-only, the sheet and native surfaces drop focus on clear, the format hint outlasts a disable, the grouped tooltip status describes nothing, the sheet's hour, minute, and second wheels use ASCII digits, and typed parsing commits prefixes; all are listed under Current-state impact. |
+| Review checks           | Reject a surface other than the one `presentation` names, a commit outside `min`/`max`, an Action skipped by clear, a disabled field that leaves the tab order or changes value, or `nativePicker` winning over `presentation`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| Governing rules         | `spec:AST-043` FR1–FR4; `family:input-fields` FR3–FR6, FR8–FR11; `spec:AST-085` FR1, FR2, FR4, FR6; `spec:AST-086` FR3, FR4, FR8; `architecture:internationalization` INV1a, INV8; `design:reduced-motion` DR1; `architecture:interaction-modality` INV4.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
 
 This table is a review projection; the body below is authoritative.
 
@@ -58,11 +58,12 @@ under `family:input-fields`. Consumer usage lives in `TimeInput.doc.mjs`.
 
 ## Compatibility and migration
 
-- Released default preserved: `yes`; `presentation="adaptive-native"`,
-  `hourFormat="12h"`, `increment={1}`, no seconds, no clear, `size="md"`,
-  `statusVariant="attached"`
-- Compatibility class: records shipped behavior; no public prop, default,
-  export, or DOM change
+- Released default preserved: `no` for `hourFormat`, which follows the
+  provider locale's hour cycle (`12h` for `en` and `en-US`, the released
+  default with no provider); `yes` for `presentation="adaptive-native"`,
+  `increment={1}`, no seconds, no clear, `size="md"`, `statusVariant="attached"`
+- Compatibility class: default change for non-English-US locales; no public
+  prop, type, export, or DOM change
 - Controlled/uncontrolled behavior: controlled; `value` is an ISO time or
   `undefined`, and the field shows an optimistic value only while a
   `changeAction` is pending
@@ -95,32 +96,32 @@ 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                                                                                                                       |
-| ------------- | --------------------------------------------------------------------------------------------- | ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | --------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
-| Presentation  | `text-input`, `popover`, `bottom-sheet`, `native`, `adaptive-bottom-sheet`, `adaptive-native` | Which surface selects the time.      | Always.                                                                                                                                | `adaptive-native` | `spec:AST-043`        | Stable     | TypeScript rejects other values.                                                                                                             |
-| Native picker | `touch`, `always`, `never` (deprecated)                                                       | Released surface selector.           | Ignored when `presentation` is set.                                                                                                    | unset             | `spec:AST-043`        | Deprecated | A development warning names the replacement.                                                                                                 |
-| Hour format   | `12h`, `24h`                                                                                  | Display and wheel hour format.       | Typed, native (resting text), and sheet surfaces.                                                                                      | `12h`             | `component:TimeInput` | Stable     | TypeScript rejects other values.                                                                                                             |
-| Seconds       | off, on                                                                                       | Whether values carry seconds.        | Typed and sheet surfaces; keeps adaptive and legacy native off. A forced native surface ignores it and commits hours and minutes only. | off               | `component:TimeInput` | Stable     | Not applicable.                                                                                                                              |
-| Increment     | whole minutes                                                                                 | Arrow-key step.                      | Typed surface; not 1 keeps adaptive and legacy native off.                                                                             | `1`               | `component:TimeInput` | Stable     | A fractional increment steps by nothing: an arrow key re-commits and announces `value`, or commits the current time when the field is empty. |
-| Range         | `min`, `max` ISO times                                                                        | Inclusive allowed times.             | Every surface.                                                                                                                         | unbounded         | `component:TimeInput` | Stable     | Out-of-range entries do not commit.                                                                                                          |
-| Busy          | idle, busy                                                                                    | The value is loading or being saved. | `isLoading`, or while a `changeAction` is pending.                                                                                     | idle              | `family:input-fields` | Stable     | Not applicable.                                                                                                                              |
+| Concept       | Closed values or states                                                                       | Meaning                              | Availability by variant/orientation/state                                                                                              | Default                                                                     | Owner                 | Stability  | Invalid-value behavior                                                                                                                       |
+| ------------- | --------------------------------------------------------------------------------------------- | ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | --------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
+| Presentation  | `text-input`, `popover`, `bottom-sheet`, `native`, `adaptive-bottom-sheet`, `adaptive-native` | Which surface selects the time.      | Always.                                                                                                                                | `adaptive-native`                                                           | `spec:AST-043`        | Stable     | TypeScript rejects other values.                                                                                                             |
+| Native picker | `touch`, `always`, `never` (deprecated)                                                       | Released surface selector.           | Ignored when `presentation` is set.                                                                                                    | unset                                                                       | `spec:AST-043`        | Deprecated | A development warning names the replacement.                                                                                                 |
+| Hour format   | `12h`, `24h`                                                                                  | Display and wheel hour format.       | Typed, native (resting text), and sheet surfaces.                                                                                      | The provider locale's hour cycle, including a `-u-hc-` extension on its tag | `component:TimeInput` | Stable     | TypeScript rejects other values.                                                                                                             |
+| Seconds       | off, on                                                                                       | Whether values carry seconds.        | Typed and sheet surfaces; keeps adaptive and legacy native off. A forced native surface ignores it and commits hours and minutes only. | off                                                                         | `component:TimeInput` | Stable     | Not applicable.                                                                                                                              |
+| Increment     | whole minutes                                                                                 | Arrow-key step.                      | Typed surface; not 1 keeps adaptive and legacy native off.                                                                             | `1`                                                                         | `component:TimeInput` | Stable     | A fractional increment steps by nothing: an arrow key re-commits and announces `value`, or commits the current time when the field is empty. |
+| Range         | `min`, `max` ISO times                                                                        | Inclusive allowed times.             | Every surface.                                                                                                                         | unbounded                                                                   | `component:TimeInput` | Stable     | Out-of-range entries do not commit.                                                                                                          |
+| Busy          | idle, busy                                                                                    | The value is loading or being saved. | `isLoading`, or while a `changeAction` is pending.                                                                                     | idle                                                                        | `family:input-fields` | Stable     | Not applicable.                                                                                                                              |
 
 ## Behavioral and layout contract
 
-| ID   | Invariant                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | Basis                                                                                    |
-| ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
-| FR1  | Surface by `presentation` and pointer: `text-input` and `popover` → typed field; `bottom-sheet` → sheet; `native` → native picker on every pointer with no fallback; `adaptive-bottom-sheet` → typed on a fine pointer, sheet on a coarse one; `adaptive-native` → typed on a fine pointer, native on a coarse one, falling back to the typed field when `hasSeconds` or `increment` is not 1. Deprecated `nativePicker` maps `touch` → `adaptive-native`, `always` → native with the same fallbacks, `never` → `text-input`; `presentation` wins when both are set.                                                                                                                                                                                                                                                                                                                                                                                                                                 | `spec:AST-043` FR1–FR4; current tests                                                    |
-| FR2  | Every surface reports changes as `onChange(isoTime \| undefined)` and then, when supplied, `changeAction` in a transition; while the Action is pending the field shows the proposed value; while `isLoading` or while the shown value differs from `value`, it sets `aria-busy`, shows a decorative Spinner, and announces the busy start once; once the Action settles the field shows `value`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | `family:input-fields` FR5, FR6; `spec:AST-086` FR8; current source                       |
-| FR3  | Typed field: a native text input with a leading clock icon. Typing keeps a draft and commits as soon as the draft parses to an in-range time different from `value`. On blur an empty draft commits `undefined` (when a value exists), a valid draft commits if changed, and an invalid draft reverts. An invalid draft sets `aria-invalid` and fills a persistent assertive region with the localized invalid-time message. Typed times MUST parse in the active locale, and a commit MUST reflect the whole typed time (`architecture:internationalization` INV8). Implementation gap: the parser takes no locale. It recognizes only an English `a`/`p` day period, a `:` separator, and ASCII digits, and it commits as soon as a prefix parses: typing "2.30pm" commits 02:00 from "2" and keeps it on blur; `fi-FI`'s "14.30" keeps 14:00; under `es-ES` "2:30 p. m." commits 02:30 with no warning; and `ja-JP` "午後2:30" and `ar-SA` digits are rejected.                                   | `spec:AST-086` FR3; current tests; `architecture:internationalization` INV8              |
-| FR4  | Typed field: ArrowUp and ArrowDown step by `increment` minutes from `value`, or from the current time when empty, commit only when the result is in range, and announce the new time politely (in FR5's display text for the field's hour format, including FR5's digit, separator, and day-period gap). Arrow keys that belong to an IME composition do nothing. The shown text MUST match the committed and announced time. Implementation gap: stepping while a typed draft is pending commits and announces the stepped time but keeps showing the draft, and blur then commits the draft when it parses.                                                                                                                                                                                                                                                                                                                                                                                        | Current tests                                                                            |
-| FR5  | Typed field: the value shows as 12-hour or 24-hour text, with seconds when `hasSeconds`. While focused, enabled, and empty, the placeholder becomes a format hint for the hour format ("e.g., 2:30 PM" or "e.g., 14:30"); otherwise it is `placeholder` or the localized default. The format hint MUST be catalog text (`architecture:internationalization` INV1a). Implementation gap: it is a fixed English string. Implementation gap: a field that becomes disabled while focused keeps showing the hint until blur. On every surface, time text MUST use the locale's digits, separator, and (for twelve-hour text) day-period words (`architecture:internationalization` INV1a, INV8). Implementation gap: every surface's field text and the stepped announcement use ASCII digits, a `:` separator, and a fixed English "AM"/"PM" whatever the locale, and the sheet's hour, minute, and second wheel options use ASCII digits; the sheet's AM/PM wheel uses the catalog's day-period words. | `architecture:internationalization`; current tests                                       |
-| FR6  | Native surface: an `<input type="time">` the platform picks with, plus a clock button labelled with the localized open-picker phrase. Native edits outside `min`/`max` do not commit; they set `aria-invalid` and fill the assertive invalid-time region. A pending Action keeps the picker enabled. Clearing does not refocus or reopen the picker.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | `spec:AST-043` FR2; current tests                                                        |
-| FR7  | Sheet surface: a read-only combobox (`aria-haspopup="dialog"`, `aria-expanded`) that opens a BottomSheet of hour, minute, optional second, and (12-hour) meridiem wheels when tapped. Wheel options outside the range are disabled; each wheel change clamps to the range and commits. `isLoading` makes the sheet field inert as well as busy. The wheels MUST be reachable by keyboard (`architecture:interaction-modality` INV4). Implementation gap: Enter, Space, ArrowDown, and Alt+ArrowDown do not open the sheet, and the clock button is out of the tab order, so keyboard users cannot set a time on this surface.                                                                                                                                                                                                                                                                                                                                                                        | `spec:AST-043` DEC-3; current source and tests; `architecture:interaction-modality` INV4 |
-| FR8  | With `hasClear`, a clear button shows while a value is shown and the field is editable. It commits `undefined` through FR2's pipeline, including `changeAction`. On the typed surface it then focuses the input (keyboard: at once; pointer: on the next frame without scrolling). Implementation gap: on the sheet surface, and on the native surface (which does not refocus so the picker does not reopen), it moves focus nowhere, so a keyboard clear leaves focus on the document body. The clear button, and the sheet's Save button, are `component:Button`s, so their press scale MUST NOT apply under reduced motion (`design:reduced-motion` DR1). Implementation gap: both still scale under reduced motion.                                                                                                                                                                                                                                                                             | `family:input-fields` FR6, FR11; current tests                                           |
-| FR9  | TimeInput is disabled when its own `isDisabled` or an enclosing InputGroup's `isDisabled` is true; an enabled group never re-enables a field that disables itself (`spec:AST-085` FR7). Disabled, on every surface: `aria-disabled="true"` on the focusable control, a kept tab stop, no value change by typing, arrows, the picker, or the wheels, a dropped draft, no caller `onClick`, Enter cancelled, the clear button hidden, the control dimmed, and a keyboard focus ring. With `disabledMessage`, a reason tooltip opens on hover and keyboard focus and describes the control. Implementation gap: caller DOM handlers other than focus and blur (`onKeyDown` and the like) still run; only `onClick` is blocked. Implementation gap: when a focused clear button disappears because the field becomes disabled, focus falls to the document body; no destination is named (`spec:AST-085` FR4).                                                                                           | `spec:AST-085` FR1, FR2, FR6; `family:input-fields` FR4; current tests                   |
-| FR10 | Inside InputGroup there is no Field. On the typed and native surfaces, a visually hidden label, description, and status message inside the control name and describe it, the local status icon is suppressed, and a status message is announced through the shared channel (assertive for errors, polite otherwise) when it appears. The sheet surface MUST be named and described the same way. Implementation gap: the grouped sheet field renders no hidden label, description, or status node, so it is named only by the group label, its description and status ids resolve to nothing, and its own status message is not announced (the group's status still describes it). Implementation gap: with `statusVariant="tooltip"`, the grouped typed and native fields render the hidden status message but leave it out of `aria-describedby`, so it is announced once and never describes the control.                                                                                         | `family:input-fields` FR3; `spec:AST-086`; current tests                                 |
-| FR11 | Base props reach the semantic control; a caller DOM handler runs after the component's own handler for the same event and cannot cancel built-in behavior. A caller `aria-labelledby` is appended to the field label. `container*` and `control*` reach the Field box and control box; root styling is not accepted.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | `family:input-fields` FR10; current tests                                                |
-| FR12 | Size and text size (typed and native surfaces; the sheet field sets no font of its own), status presentation, and click-to-focus (typed surface) match `component:TextInput` FR9, FR11, and FR12, including its implementation gaps (the fixed height against `spec:AST-102` FR4, an error status without text, and the color-only `detached` status without a message). The control box carries `astryx-time-input` with `data-size`, `data-status`, and `data-disabled`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | `family:input-fields` FR8, FR9; current tests                                            |
+| ID   | Invariant                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Basis                                                                                    |
+| ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| FR1  | Surface by `presentation` and pointer: `text-input` and `popover` → typed field; `bottom-sheet` → sheet; `native` → native picker on every pointer with no fallback; `adaptive-bottom-sheet` → typed on a fine pointer, sheet on a coarse one; `adaptive-native` → typed on a fine pointer, native on a coarse one, falling back to the typed field when `hasSeconds` or `increment` is not 1. Deprecated `nativePicker` maps `touch` → `adaptive-native`, `always` → native with the same fallbacks, `never` → `text-input`; `presentation` wins when both are set.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | `spec:AST-043` FR1–FR4; current tests                                                    |
+| FR2  | Every surface reports changes as `onChange(isoTime \| undefined)` and then, when supplied, `changeAction` in a transition; while the Action is pending the field shows the proposed value; while `isLoading` or while the shown value differs from `value`, it sets `aria-busy`, shows a decorative Spinner, and announces the busy start once; once the Action settles the field shows `value`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | `family:input-fields` FR5, FR6; `spec:AST-086` FR8; current source                       |
+| FR3  | Typed field: a native text input with a leading clock icon. Typing keeps a draft and commits as soon as the draft parses to an in-range time different from `value`. On blur an empty draft commits `undefined` (when a value exists), a valid draft commits if changed, and an invalid draft reverts. An invalid draft sets `aria-invalid` and fills a persistent assertive region with the localized invalid-time message. Typed times MUST parse in the active locale, and a commit MUST reflect the whole typed time (`architecture:internationalization` INV8). The parser reads the locale's digits, hour-minute and minute-second separators, and day-period words on either side of the time, plus English day periods, `:`, and ASCII digits in every locale, so every time FR5 displays reads back as itself. Implementation gap: it commits as soon as a prefix parses: typing "2.30pm" under `en` commits 02:00 from "2" and keeps it on blur.                                                                                                                                                                                                                                      | `spec:AST-086` FR3; current tests; `architecture:internationalization` INV8              |
+| FR4  | Typed field: ArrowUp and ArrowDown step by `increment` minutes from `value`, or from the current time when empty, commit only when the result is in range, and announce the new time politely (in FR5's display text for the field's hour format). Arrow keys that belong to an IME composition do nothing. The shown text MUST match the committed and announced time. Implementation gap: stepping while a typed draft is pending commits and announces the stepped time but keeps showing the draft, and blur then commits the draft when it parses.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Current tests                                                                            |
+| FR5  | Typed field: the value shows as 12-hour or 24-hour text, with seconds when `hasSeconds`. The hour format is `hourFormat` when set, else the provider locale's hour cycle (`h11`/`h12` → 12-hour, `h23`/`h24` → 24-hour), so a `-u-hc-` extension on the provider tag carries an app's per-user preference. Every surface receives the same resolved hour format. While focused, enabled, and empty, the placeholder becomes the catalog format hint for that hour format; otherwise it is `placeholder` or the localized default. Implementation gap: a field that becomes disabled while focused keeps showing the hint until blur. On every surface, time text MUST use the locale's digits, separator, and (for twelve-hour text) day-period words (`architecture:internationalization` INV1a, INV8): the typed, native resting, and sheet field text and the stepped announcement come from the shared time formatter. A locale whose twelve-hour reading writes 02:00 and 14:00 alike (no day period) gets English twelve-hour text. Implementation gap: the sheet's hour, minute, and second wheel options use ASCII digits; the sheet's AM/PM wheel uses the catalog's day-period words. | `architecture:internationalization`; current tests                                       |
+| FR6  | Native surface: an `<input type="time">` the platform picks with, plus a clock button labelled with the localized open-picker phrase. Native edits outside `min`/`max` do not commit; they set `aria-invalid` and fill the assertive invalid-time region. A pending Action keeps the picker enabled. Clearing does not refocus or reopen the picker.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | `spec:AST-043` FR2; current tests                                                        |
+| FR7  | Sheet surface: a read-only combobox (`aria-haspopup="dialog"`, `aria-expanded`) that opens a BottomSheet of hour, minute, optional second, and (12-hour) meridiem wheels when tapped. Wheel options outside the range are disabled; each wheel change clamps to the range and commits. `isLoading` makes the sheet field inert as well as busy. The wheels MUST be reachable by keyboard (`architecture:interaction-modality` INV4). Implementation gap: Enter, Space, ArrowDown, and Alt+ArrowDown do not open the sheet, and the clock button is out of the tab order, so keyboard users cannot set a time on this surface.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | `spec:AST-043` DEC-3; current source and tests; `architecture:interaction-modality` INV4 |
+| FR8  | With `hasClear`, a clear button shows while a value is shown and the field is editable. It commits `undefined` through FR2's pipeline, including `changeAction`. On the typed surface it then focuses the input (keyboard: at once; pointer: on the next frame without scrolling). Implementation gap: on the sheet surface, and on the native surface (which does not refocus so the picker does not reopen), it moves focus nowhere, so a keyboard clear leaves focus on the document body. The clear button, and the sheet's Save button, are `component:Button`s, so their press scale MUST NOT apply under reduced motion (`design:reduced-motion` DR1). Implementation gap: both still scale under reduced motion.                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | `family:input-fields` FR6, FR11; current tests                                           |
+| FR9  | TimeInput is disabled when its own `isDisabled` or an enclosing InputGroup's `isDisabled` is true; an enabled group never re-enables a field that disables itself (`spec:AST-085` FR7). Disabled, on every surface: `aria-disabled="true"` on the focusable control, a kept tab stop, no value change by typing, arrows, the picker, or the wheels, a dropped draft, no caller `onClick`, Enter cancelled, the clear button hidden, the control dimmed, and a keyboard focus ring. With `disabledMessage`, a reason tooltip opens on hover and keyboard focus and describes the control. Implementation gap: caller DOM handlers other than focus and blur (`onKeyDown` and the like) still run; only `onClick` is blocked. Implementation gap: when a focused clear button disappears because the field becomes disabled, focus falls to the document body; no destination is named (`spec:AST-085` FR4).                                                                                                                                                                                                                                                                                      | `spec:AST-085` FR1, FR2, FR6; `family:input-fields` FR4; current tests                   |
+| FR10 | Inside InputGroup there is no Field. On the typed and native surfaces, a visually hidden label, description, and status message inside the control name and describe it, the local status icon is suppressed, and a status message is announced through the shared channel (assertive for errors, polite otherwise) when it appears. The sheet surface MUST be named and described the same way. Implementation gap: the grouped sheet field renders no hidden label, description, or status node, so it is named only by the group label, its description and status ids resolve to nothing, and its own status message is not announced (the group's status still describes it). Implementation gap: with `statusVariant="tooltip"`, the grouped typed and native fields render the hidden status message but leave it out of `aria-describedby`, so it is announced once and never describes the control.                                                                                                                                                                                                                                                                                    | `family:input-fields` FR3; `spec:AST-086`; current tests                                 |
+| FR11 | Base props reach the semantic control; a caller DOM handler runs after the component's own handler for the same event and cannot cancel built-in behavior. A caller `aria-labelledby` is appended to the field label. `container*` and `control*` reach the Field box and control box; root styling is not accepted.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | `family:input-fields` FR10; current tests                                                |
+| FR12 | Size and text size (typed and native surfaces; the sheet field sets no font of its own), status presentation, and click-to-focus (typed surface) match `component:TextInput` FR9, FR11, and FR12, including its implementation gaps (the fixed height against `spec:AST-102` FR4, an error status without text, and the color-only `detached` status without a message). The control box carries `astryx-time-input` with `data-size`, `data-status`, and `data-disabled`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | `family:input-fields` FR8, FR9; current tests                                            |
 
 ### Allowed variation
 
@@ -128,8 +129,7 @@ Consumer migration instructions belong in consumer docs and release notes.
   and steps.
 - **AV2 — Accepted typed forms.** The shared time parser decides which typed
   spellings parse. A parse MUST commit the time the person typed, never a
-  different one (FR3 gap: prefix commits and locale separators, digits, and day
-  periods).
+  different one (FR3 gap: prefix commits).
 
 ### Representative states
 
@@ -237,17 +237,14 @@ anatomy-theming map.
 - **Caller handlers while disabled (FR9).** A disabled TimeInput still runs a
   caller's DOM handlers other than focus and blur, such as `onKeyDown`, and
   blocks only `onClick`, against `spec:AST-085` FR2.
-- **Format hint (FR5).** The focused-empty format hint is fixed English text,
-  against `architecture:internationalization` INV1a, and stays shown until blur
+- **Format hint (FR5).** The focused-empty format hint stays shown until blur
   when a focused field becomes disabled.
-- **Typed parsing (FR3, AV2).** The typed field ignores the locale's day
-  periods, separator, and digits, and commits a parsed prefix, so a typed time
-  can commit a different time or be rejected, against
+- **Typed parsing (FR3, AV2).** The typed field commits a parsed prefix, so a
+  typed time can commit a different time, against
   `architecture:internationalization` INV8.
-- **Time text (FR4, FR5).** Field text on every surface and the stepped-time
-  announcement use ASCII digits, a `:` separator, and a fixed English "AM"/"PM"
-  in every locale, and the sheet's hour, minute, and second wheels use ASCII
-  digits, against `architecture:internationalization` INV1a and INV8.
+- **Wheel digits (FR5).** The sheet's hour, minute, and second wheels use ASCII
+  digits in every locale, against `architecture:internationalization` INV1a
+  and INV8.
 - **Grouped tooltip status (FR10).** Inside InputGroup with
   `statusVariant="tooltip"`, the typed and native fields never reference the
   hidden status message from `aria-describedby`.

package/src/TimeInput/TimeInput.test.tsx

@@ -829,3 +829,79 @@ describe('TimeInput disabled theme state', () => {
     expect(root).not.toHaveAttribute('data-disabled');
   });
 });
+
+describe('TimeInput locale time text (issue 8992)', () => {
+  function renderIn(
+    locale: string,
+    props: Partial<React.ComponentProps<typeof TimeInput>> = {},
+  ) {
+    return render(
+      <InternationalizationProvider locale={locale}>
+        <TimeInput
+          label="Time"
+          value={'14:30' as ISOTimeString}
+          onChange={() => {}}
+          presentation="text-input"
+          {...props}
+        />
+      </InternationalizationProvider>,
+    );
+  }
+
+  it.each([
+    ['en-US', '2:30 PM'],
+    ['en-GB', '14:30'],
+    ['de-DE', '14:30'],
+    ['vi-VN', '14:30'],
+    ['ko-KR', '오후 2:30'],
+  ])(
+    'follows the hour cycle of %s when hourFormat is unset',
+    (locale, text) => {
+      renderIn(locale);
+      expect(screen.getByRole('textbox')).toHaveValue(text);
+    },
+  );
+
+  it('follows a per-user preference carried on the locale tag', () => {
+    renderIn('en-US-u-hc-h23');
+    expect(screen.getByRole('textbox')).toHaveValue('14:30');
+  });
+
+  it('lets an explicit hourFormat win over the locale', () => {
+    renderIn('de-DE', {hourFormat: '12h'});
+    expect(screen.getByRole('textbox')).toHaveValue('2:30 PM');
+  });
+
+  it("writes the locale's day period instead of a fixed English AM/PM", () => {
+    renderIn('ja-JP', {hourFormat: '12h'});
+    expect(screen.getByRole('textbox')).toHaveValue('午後2:30');
+  });
+
+  it('commits an edit of the localized text', () => {
+    const onChange = vi.fn();
+    renderIn('ko-KR', {onChange});
+    const input = screen.getByRole('textbox');
+    fireEvent.focus(input);
+    fireEvent.change(input, {target: {value: '오전 9:15'}});
+    expect(onChange).toHaveBeenLastCalledWith('09:15');
+  });
+
+  it('announces a stepped time in the locale text', async () => {
+    const onChange = vi.fn();
+    renderIn('de-DE', {onChange});
+    fireEvent.keyDown(screen.getByRole('textbox'), {key: 'ArrowUp'});
+    expect(onChange).toHaveBeenLastCalledWith('14:31');
+    await waitFor(() => {
+      expect(politeRegion()).toHaveTextContent('14:31');
+    });
+  });
+
+  it('shows the catalog format hint for the resolved hour format', () => {
+    renderIn('de-DE', {value: undefined});
+    fireEvent.focus(screen.getByRole('textbox'));
+    expect(screen.getByRole('textbox')).toHaveAttribute(
+      'placeholder',
+      'e.g., 14:30',
+    );
+  });
+});