@eifi1/ui-kit 0.35.0 → 0.37.0

package/README.md

@@ -175,6 +175,16 @@ module runs needs the text size even earlier: see "Before the first paint" under
 [Styling](#styling). Worked example:
 [`showcase/src/main.tsx`](https://github.com/Eifi1/ui-kit/blob/main/showcase/src/main.tsx).
 
+**Reset this device's settings** (0.36, `docs/settings-harmonization.md` §11): the four
+stores, `AppShell`'s sidebar key and `UiKitProvider`'s table prefix join a registry by
+themselves; `DeviceResetSetting` (the last card of the appearance group) clears them all and
+puts each back live. An app adds its own device keys, each with a reset that goes through its
+own store:
+
+```ts
+registerDeviceSetting({ key: "myapp-lang", kind: "appearance", reset: () => setDeviceLanguage(null) });
+```
+
 ### 4. Labels — one provider, the shipped catalogues
 
 Load the kit's words with `await loadUiKitLabels(code)` before the first render and hand
@@ -188,9 +198,9 @@ re-skins the kit by changing values rather than by forking components. The famil
 
 | Family | Tokens | Set by |
 |---|---|---|
-| **Palette** | `--bg-page` `--bg-surface` `--bg-surface-2` `--border` `--text-primary` `--text-secondary` `--text-muted` `--brand` `--brand-hover` `--brand-contrast` `--money-income` `--money-expense` `--money-net` `--money-neutral` `--chart-1…9` | `applyTokenSet()`, written inline on `<html>` from the active `PalettePreset` (More contrast steps four of them) |
+| **Palette** | `--bg-page` `--bg-surface` `--bg-surface-2` `--border` `--text-primary` `--text-secondary` `--text-muted` `--brand` `--brand-hover` `--brand-contrast` `--money-income` `--money-expense` `--money-net` `--money-neutral` `--chart-1…9` | `applyTokenSet()`, written inline on `<html>` from the active `PalettePreset` (More contrast steps four of them; in light also the well and the four money colours) |
 | **Derived** | `--text-placeholder` `--bg-hover` `--bg-active` `--bg-inverse` `--text-inverse` `--border-strong` `--brand-bg` `--brand-bg-hover` `--brand-muted`, and `--neutral` (`--text-muted` as a fill) | `color-mix()` or `var()` in `tokens.css`, from the layer above — so they follow the preset with no preset having to list them |
-| **Semantic** | `--danger*` `--warning*` `--info*` `--success*` — each the colour, `-contrast`, `-border` and `-bg`; danger and warning also `-border-strong`, danger `-hover` — and `--status-synced/-pending/-edited/-error` | literals in `tokens.css`, per theme |
+| **Semantic** | `--danger*` `--warning*` `--info*` `--success*` — each the colour, `-contrast`, `-border` and `-bg`; danger and warning also `-border-strong`, danger `-hover` — and `--status-synced/-pending/-edited/-error` | literals in `tokens.css`, per theme; in light under More contrast the four colours and `--status-edited` deepen for the darker well |
 | **Categorical hues** | `--hue-blue` `--hue-indigo` `--hue-purple` `--hue-teal` `--hue-orange`, each with `-contrast`, `-border` and `-bg` | literals in `tokens.css`, per theme — values that mean only "a different value" (a status enum), at the semantic family's weight |
 | **Fill foregrounds** | `<fill>-contrast`: the text ON a fill — `--brand-contrast`, `--money-income-contrast` … `--money-neutral-contrast`, `--neutral-contrast`, and each tone's and hue's `-contrast` | with their family; money is white in light and the page in dark |
 | **Media** | `--media-ink` `--media-scrim` `--media-scrim-hover` | literals, the SAME in both themes: controls drawn on a photo or a camera picture, whose background is the picture, not the page |
@@ -372,7 +382,11 @@ ONE scale on `<html>`: `data-text-size="normal" | "large" | "xlarge"` is 100 / 1
 of the browser's own font size, so Normal keeps whatever the reader set in the browser,
 and everything sized in rem (Tailwind's spacing and type) grows with it.
 `data-contrast="more"` is More contrast, from the setting or from `prefers-contrast: more`
-on "System"; it steps the colour tokens in JavaScript and widens `--focus-ring-width`. The
+on "System"; it steps the colour tokens in JavaScript and widens `--focus-ring-width`. In
+light it also darkens the well (`--bg-surface-2`, 10 % ink into the card) and deepens the
+money, status, teal, orange and `--status-edited` colours and `--bg-active` so they keep
+their contrast on it; dark keeps its well. A link button's and TextLink's brand reads
+`--brand-muted` (the brand as text) under it, in both modes. The
 stores in [Wiring](#wiring) put both attributes there; the attribute names are frozen.
 
 - **`large:`** applies at Large AND Extra large, **`xlarge:`** only at Extra large, and
@@ -542,14 +556,14 @@ columns, strings and permissions (see the note at the top of `src/feedback/feedb
 
 <!-- BEGIN GENERATED: exports — node scripts/gen-export-inventory.mjs -->
 
-**1878 names from 302 modules** — 868 values and 1010 types. _Italic_ is a type-only export.
+**1925 names from 313 modules** — 890 values and 1035 types. _Italic_ is a type-only export.
 
 Generated from `dist/index.d.ts` by `node scripts/gen-export-inventory.mjs`; the count
 is pinned by `src/__tests__/public-surface.test.ts`. Do not edit between the markers.
 
 | Entry point | Names |
 |---|---|
-| `@eifi1/ui-kit` | 1878 |
+| `@eifi1/ui-kit` | 1925 |
 | `@eifi1/ui-kit/chart` | 92 |
 | `@eifi1/ui-kit/shell` | 77 |
 | `@eifi1/ui-kit/data-table` | 51 |
@@ -588,6 +602,7 @@ re-slicing of it, never a second API.
 | `lib/isin` | `formatIsin`, `isinCheckDigit`, `isValidIsin` |
 | `lib/phone` | `formatNationalPhone`, `formatPhone`, `isE164`, `parsePhone`, `PHONE_COUNTRIES`, `PHONE_DIAL_CODES`, _`ParsedPhone`_, _`PhoneCountry`_, _`PhoneCountryCode`_ |
 | `lib/column-mapping` | `assignColumnRole`, `guessMapping`, `missingRoles`, `readMappedTable`, `readTextFile`, `roleOfColumn`, _`ColumnMapperResult`_, _`ColumnMapping`_, _`ColumnRole`_ |
+| `lib/device-settings` | `deviceSettings`, `registerDeviceSetting`, `resetDeviceSettings`, _`DeviceSetting`_, _`DeviceSettingKind`_ |
 | `lib/clipping` | `CLIPS_ATTRIBUTE` |
 | `lib/chip-edge-snap` | `refreshChipEdges` |
 
@@ -817,6 +832,7 @@ re-slicing of it, never a second API.
 | `settings/settings-heading` | `SettingsHeadingLevel`, `useSettingsHeadingLevel`, _`SettingsHeadingLevelProps`_, _`SettingsHeadingTag`_ |
 | `settings/settings-catalogue` | `settingsHref`, `settingsSearchEntries`, `visibleSettingsEntries`, `visibleSettingsGroups`, _`SettingsEntry`_, _`SettingsGroup`_, _`SettingsSearchEntriesOptions`_ |
 | `settings/settings-labels` | `DEFAULT_SETTINGS_LABELS`, `useSettingsLabels`, _`SettingsCoreGroup`_, _`SettingsGroupLabels`_, _`SettingsLabels`_ |
+| `settings/device-reset-setting` | `DEFAULT_DEVICE_RESET_LABELS`, `DEVICE_RESET_ANCHOR`, `DeviceResetSetting`, _`DeviceResetLabels`_, _`DeviceResetSettingProps`_ |
 | `settings/use-account-language` | `matchOfferedLanguage`, `resolveAccountLanguage`, `useAccountLanguage`, _`AccountLanguage`_, _`AccountLanguageSource`_, _`ResolveAccountLanguageInput`_, _`ResolvedAccountLanguage`_, _`UseAccountLanguageOptions`_ |
 | `settings/use-account-appearance` | `resolveAccountAppearance`, `useAccountAppearance`, _`AccountAppearance`_, _`AccountAppearanceFields`_, _`AccountAppearancePatch`_, _`AppearanceSource`_, _`DeviceAppearance`_, _`ResolvedAccountAppearance`_, _`UseAccountAppearanceOptions`_ |
 
@@ -942,6 +958,20 @@ re-slicing of it, never a second API.
 | `billing/billing-overview` | _`BillingOverview`_, _`PortalRequest`_, _`PortalTarget`_, _`SubscriptionSource`_ |
 | `billing/plan-limit-toast` | `usePlanLimitToast`, _`PlanLimitToastOptions`_ |
 
+### notifications
+
+| Module | Exports |
+|---|---|
+| `notifications/notifications-labels` | `DEFAULT_NOTIFICATIONS_LABELS`, _`NotificationRegionLabels`_, _`NotificationsLabels`_ |
+| `notifications/notification-types` | _`DigestCadence`_, _`NotificationSettingsPatch`_, _`NotificationSwitches`_, _`NotificationTypeEntry`_, _`NotificationTypeGroup`_, _`NotificationTypesValue`_, _`PushDeviceItem`_ |
+| `notifications/notification-types-setting` | `NotificationTypesSetting`, _`NotificationTypesSettingProps`_ |
+| `notifications/quiet-hours-setting` | `QuietHoursSetting`, _`QuietHoursSettingProps`_ |
+| `notifications/time-zone-select` | `deviceTimeZone`, `timeZoneOptions`, `TimeZoneSelect`, _`TimeZoneSelectProps`_ |
+| `notifications/use-push-device` | `notifyPushSubscriptionChanged`, `PUSH_SUBSCRIPTION_CHANGED`, `PushDeviceError`, `pushSupported`, `usePushDevice`, _`PushDevice`_, _`PushDeviceErrorCode`_, _`PushPermission`_, _`PushSubscriptionInput`_, _`UsePushDeviceOptions`_ |
+| `notifications/push-device-setting` | `PushDeviceSetting`, _`PushDeviceAction`_, _`PushDeviceSettingProps`_ |
+| `notifications/push-devices-setting` | `describeUserAgent`, `PushDevicesSetting`, _`PushDevicesSettingProps`_ |
+| `notifications/unsubscribe-panel` | `UnsubscribePanel`, `unsubscribeTokenType`, _`UnsubscribePanelProps`_ |
+
 ### demo
 
 | Module | Exports |

package/dist/admin/role-select.d.ts

@@ -3,6 +3,7 @@ import { type LabelOverride } from "../i18n/kit-labels.js";
 import type { RoleVocabulary } from "../components/account-chips.js";
 import type { SelectProps } from "../components/select.js";
 import type { CommitScope } from "../components/write-lock.js";
+import type { FieldHelpProps } from "../components/field-parts.js";
 import { DEFAULT_ROLE_SELECT_LABELS } from "./role-select-labels.js";
 /**
  * The role of an account, chosen by an admin (docs/user-admin-harmonization.md §3.3,
@@ -94,7 +95,7 @@ export interface RoleSelectProps<R extends string = string> extends Omit<SelectP
  * (`size`, `commit`, `hint`, `error`, `data-*`).
  */
 export declare function RoleSelect<R extends string = string>({ value, roles, onChange, offered, disabledReason, optionDisabledReason, name, labels: labelsProp, label, ...rest }: RoleSelectProps<R>): import("react").JSX.Element;
-export interface RolesEditorProps<R extends string = string> {
+export interface RolesEditorProps<R extends string = string> extends FieldHelpProps {
     /** The roles ticked — the draft the app holds while its dialog is open. */
     value: readonly R[];
     roles: RoleVocabulary<R>;
@@ -133,4 +134,4 @@ export interface RolesEditorProps<R extends string = string> {
  * `AdminActionConfirm` (`acknowledge`, §4.2) — which can draw this editor as its
  * `children`, so the roles and the tick are one dialog.
  */
-export declare function RolesEditor<R extends string = string>({ value, roles, onChange, offered, disabledReason, optionDisabledReason, legend, legendVisibility, required, hint, error, columns, commit, className, labels: labelsProp, }: RolesEditorProps<R>): import("react").JSX.Element;
+export declare function RolesEditor<R extends string = string>({ value, roles, onChange, offered, disabledReason, optionDisabledReason, legend, legendVisibility, required, hint, help, error, columns, commit, className, labels: labelsProp, }: RolesEditorProps<R>): import("react").JSX.Element;

package/dist/admin/role-select.js

@@ -71,6 +71,7 @@ function RolesEditor({
   legendVisibility,
   required,
   hint,
+  help,
   error,
   columns,
   commit,
@@ -101,6 +102,7 @@ function RolesEditor({
       onChange,
       required,
       hint,
+      help,
       error,
       columns,
       commit,

package/dist/admin/role-select.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/admin/role-select.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport { hasContent } from \"../lib/presence\";\nimport type { RoleVocabulary } from \"../components/account-chips\";\nimport { CheckboxGroup } from \"../components/checkbox-group\";\nimport type { CheckboxGroupOption } from \"../components/checkbox-group\";\nimport { Select } from \"../components/select\";\nimport type { SelectProps } from \"../components/select\";\nimport type { CommitScope } from \"../components/write-lock\";\nimport { DEFAULT_ROLE_SELECT_LABELS } from \"./role-select-labels\";\n\n/**\n * The role of an account, chosen by an admin (docs/user-admin-harmonization.md §3.3,\n * §4.1, §7): {@link RoleSelect} for the apps where an account has ONE role (keksdose,\n * Kurvenschmiede) and {@link RolesEditor} for kastlan, where an account has several per\n * company.\n *\n * Both take the app's {@link RoleVocabulary} — the one `RoleChip` reads — so a role is\n * called the same in the chip, the select and the editor. Neither sends a request: a role\n * change is an `acknowledge` action (§4.2), so the app opens `AdminActionConfirm` from\n * `onChange` and the value stays where the server has it until the server says otherwise.\n *\n * WHY THE REASONS. The server refuses the last active admin's demotion (`last_admin`),\n * your own admin role (`self`), Kurvenschmiede's CUSTOMER for an account that owns work,\n * kastlan's TENANT until a tenant portal exists (§4.1, §9.6). A choice the server will\n * refuse is shown as unavailable, with why, rather than offered and answered with an\n * error after a confirmation dialog — the 0.18 write-lock rule: a control that cannot\n * act says so where it is. `\"last_admin\"` and `\"self\"` are the kit's words in every\n * language; anything else is the app's own sentence.\n */\n\n/** A reason the kit words itself. `self_action` is the server's code for `self` (the\n *  account error codes), so a refusal's code can be handed on as it came. */\nexport type RoleLockCode = \"last_admin\" | \"self\" | \"self_action\";\n\n/**\n * Why a role (or the whole control) cannot be changed: one of the kit's\n * {@link RoleLockCode}s, or the app's own words.\n */\nexport type RoleLock = RoleLockCode | (string & {}) | ReactNode;\n\n/** The `roleSelect` namespace — RoleSelect's and RolesEditor's words. */\nexport interface RoleSelectLabels {\n  /** The select's name where no `label` is drawn, and RolesEditor's legend. \"Role\". */\n  label: string;\n  /** RolesEditor's legend. \"Roles\". */\n  rolesLegend: string;\n  /** The select's accessible name in a roster row — \"Role of Ada Example\". */\n  roleOf: (name: string) => string;\n  /** The whole control is locked: the account is the last active administrator. */\n  lockedLastAdmin: string;\n  /** The whole control is locked: it is the admin's own account. */\n  lockedSelf: string;\n  /** One option is unavailable for the last active administrator — said after the\n   *  role's name, inside the option. */\n  notForLastAdmin: string;\n  /** One option is unavailable on the admin's own account. */\n  notForSelf: string;\n  /** An unavailable option's text: the role's name and why. */\n  unavailable: (role: string, reason: string) => string;\n}\n\n// Defined in ./role-select-labels, which holds no component code (0.34, KS U8).\nexport { DEFAULT_ROLE_SELECT_LABELS };\n\n/** The whole-control reason, the kit's codes in the kit's words. */\nfunction lockText(reason: RoleLock, labels: RoleSelectLabels): ReactNode {\n  if (reason === \"last_admin\") return labels.lockedLastAdmin;\n  if (reason === \"self\" || reason === \"self_action\") return labels.lockedSelf;\n  return reason;\n}\n\n/** An option's reason as the text a native `<option>` can hold. */\nfunction optionReasonText(reason: string, labels: RoleSelectLabels): string {\n  if (reason === \"last_admin\") return labels.notForLastAdmin;\n  if (reason === \"self\" || reason === \"self_action\") return labels.notForSelf;\n  return reason;\n}\n\n/** The vocabulary's keys, in its own order. */\nfunction keysOf<R extends string>(roles: RoleVocabulary<R>): R[] {\n  return Object.keys(roles) as R[];\n}\n\n/* ── RoleSelect ─────────────────────────────────────────────────────────────── */\n\nexport interface RoleSelectProps<R extends string = string>\n  extends Omit<SelectProps, \"value\" | \"defaultValue\" | \"onChange\" | \"children\" | \"multiple\" | \"disabledReason\"> {\n  /** The role the server has. Controlled: a pick does not move the select until the\n   *  app's request lands and the row comes back with the new role. */\n  value: R | null | undefined;\n  /** The app's roles — what `RoleChip` reads. Their order is the list's. */\n  roles: RoleVocabulary<R>;\n  /** A role other than `value` was picked. The app asks `AdminActionConfirm` (an\n   *  `acknowledge` action, §4.2) and sends the change. */\n  onChange: (role: R) => void;\n  /**\n   * The roles that may be CHOSEN here, in the vocabulary's order whatever order this is\n   * in. Default: all of them. A role the account holds that is not offered (Kurvenschmiede's\n   * REVIEWER, given only through the reviewer scope, §9.6) is still shown, unavailable:\n   * a select that dropped it would show the account as something it is not.\n   */\n  offered?: readonly R[];\n  /**\n   * Why the whole choice is locked for this account: `\"last_admin\"`, `\"self\"`, or the\n   * app's own words. The select stays focusable and says so (Select's `disabledReason`).\n   */\n  disabledReason?: RoleLock;\n  /**\n   * Why ONE role cannot be chosen for this account: `\"last_admin\"`, `\"self\"`, or the\n   * app's own words (Kurvenschmiede: \"owns work\", for CUSTOMER) — a STRING, because a\n   * native option holds text only. The option is disabled and reads \"Member (not for the\n   * last administrator)\". `undefined` for an available role.\n   */\n  optionDisabledReason?: (role: R) => string | undefined;\n  /** The account's name, for the select's accessible name in a roster row (\"Role of\n   *  Ada Example\") where no `label` is drawn. */\n  name?: string;\n  labels?: LabelOverride<RoleSelectLabels>;\n}\n\n/**\n * One role, picked from the app's vocabulary — Kurvenschmiede's roster `Select`\n * (users-panel.tsx), with the reasons it left to the server's toast drawn in place.\n *\n * Unlabelled by default, for a table cell: named \"Role of Ada Example\" (`name`) or\n * \"Role\". Pass `label` for a form field. Every {@link Select} prop passes through\n * (`size`, `commit`, `hint`, `error`, `data-*`).\n */\nexport function RoleSelect<R extends string = string>({\n  value,\n  roles,\n  onChange,\n  offered,\n  disabledReason,\n  optionDisabledReason,\n  name,\n  labels: labelsProp,\n  label,\n  ...rest\n}: RoleSelectProps<R>) {\n  const labels = useKitLabels(\"roleSelect\", DEFAULT_ROLE_SELECT_LABELS, labelsProp);\n  const all = keysOf(roles);\n  const choosable = new Set<R>(offered ?? all);\n  const held = value ?? null;\n  // A cell has no room for a visible label: the select is named for the account it\n  // belongs to, so fifty of them in a roster are not fifty \"Role\"s.\n  const ariaLabel =\n    label === undefined ? (rest[\"aria-label\"] ?? (name ? labels.roleOf(name) : labels.label)) : rest[\"aria-label\"];\n  return (\n    <Select\n      {...rest}\n      label={label}\n      aria-label={ariaLabel}\n      value={held ?? \"\"}\n      disabledReason={hasContent(disabledReason) ? lockText(disabledReason, labels) : undefined}\n      onChange={(event) => {\n        const next = event.target.value as R;\n        if (next && next !== held) onChange(next);\n      }}\n    >\n      {held === null && <option value=\"\" disabled />}\n      {all\n        .filter((role) => choosable.has(role) || role === held)\n        .map((role) => {\n          const word = roles[role].label;\n          const reason = role === held ? undefined : optionDisabledReason?.(role);\n          const unavailable = !choosable.has(role) || hasContent(reason);\n          return (\n            <option key={role} value={role} disabled={unavailable && role !== held}>\n              {reason ? labels.unavailable(word, optionReasonText(reason, labels)) : word}\n            </option>\n          );\n        })}\n      {/* A role the vocabulary does not know (an older client against a newer API) is\n          still the account's role: shown as its key, as RoleChip shows it. */}\n      {held !== null && !all.includes(held) && (\n        <option value={held} disabled>\n          {held}\n        </option>\n      )}\n    </Select>\n  );\n}\n\n/* ── RolesEditor ────────────────────────────────────────────────────────────── */\n\nexport interface RolesEditorProps<R extends string = string> {\n  /** The roles ticked — the draft the app holds while its dialog is open. */\n  value: readonly R[];\n  roles: RoleVocabulary<R>;\n  /** The new set, in the vocabulary's order (a role the editor does not offer, but the\n   *  account holds, is kept after the rest — CheckboxGroup's rule). */\n  onChange: (roles: R[]) => void;\n  /** The roles that may be ticked or unticked here. Default: all. kastlan leaves TENANT\n   *  out until a tenant portal exists (§4.1). */\n  offered?: readonly R[];\n  /** Why nothing can be changed: `\"last_admin\"`, `\"self\"` or the app's words. */\n  disabledReason?: RoleLock;\n  /** Why one role cannot be changed — shown under it, and the box keeps its state:\n   *  `\"last_admin\"` on the last administrator's ADMIN, say. */\n  optionDisabledReason?: (role: R) => RoleLock | undefined;\n  /** Default `roleSelect.rolesLegend` — \"Roles\". kastlan names the company: \"Roles in\n   *  Example Ltd\". */\n  legend?: ReactNode;\n  legendVisibility?: \"visible\" | \"sr-only\";\n  /** At least one role (kastlan's dialog saves none). Draws the required star. */\n  required?: boolean;\n  hint?: ReactNode;\n  error?: ReactNode;\n  columns?: 1 | 2 | 3 | 4;\n  /** The editor SAVES on change — the write lock's opt-in (CheckboxGroup's `commit`). */\n  commit?: CommitScope;\n  className?: string;\n  labels?: LabelOverride<RoleSelectLabels>;\n}\n\n/**\n * Several roles at once — kastlan's manage-roles dialog (`ChoiceCardGroup multiple`),\n * which holds an account's roles in the CURRENT company (§4.1: `PUT /admin/users/{id}/roles`).\n * A kit {@link CheckboxGroup} of the vocabulary, with the reasons of {@link RoleSelect}:\n * a role that cannot change keeps its box as it is and says why under it.\n *\n * A field, not a form: the app's dialog holds the draft, and its Save goes through\n * `AdminActionConfirm` (`acknowledge`, §4.2) — which can draw this editor as its\n * `children`, so the roles and the tick are one dialog.\n */\nexport function RolesEditor<R extends string = string>({\n  value,\n  roles,\n  onChange,\n  offered,\n  disabledReason,\n  optionDisabledReason,\n  legend,\n  legendVisibility,\n  required,\n  hint,\n  error,\n  columns,\n  commit,\n  className,\n  labels: labelsProp,\n}: RolesEditorProps<R>) {\n  const labels = useKitLabels(\"roleSelect\", DEFAULT_ROLE_SELECT_LABELS, labelsProp);\n  const all = keysOf(roles);\n  const choosable = new Set<R>(offered ?? all);\n  const held = new Set<R>(value);\n  const options: CheckboxGroupOption<R>[] = all\n    .filter((role) => choosable.has(role) || held.has(role))\n    .map((role) => {\n      const reason = optionDisabledReason?.(role);\n      const locked = hasContent(reason);\n      return {\n        value: role,\n        label: roles[role].label,\n        hint: locked ? lockText(reason, labels) : undefined,\n        disabled: locked || !choosable.has(role),\n      };\n    });\n  return (\n    <CheckboxGroup<R>\n      legend={legend ?? labels.rolesLegend}\n      legendVisibility={legendVisibility}\n      options={options}\n      value={[...value]}\n      onChange={onChange}\n      required={required}\n      hint={hint}\n      error={error}\n      columns={columns}\n      commit={commit}\n      disabledReason={hasContent(disabledReason) ? lockText(disabledReason, labels) : undefined}\n      className={className}\n    />\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/admin/role-select.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport { hasContent } from \"../lib/presence\";\nimport type { RoleVocabulary } from \"../components/account-chips\";\nimport { CheckboxGroup } from \"../components/checkbox-group\";\nimport type { CheckboxGroupOption } from \"../components/checkbox-group\";\nimport { Select } from \"../components/select\";\nimport type { SelectProps } from \"../components/select\";\nimport type { CommitScope } from \"../components/write-lock\";\nimport type { FieldHelpProps } from \"../components/field-parts\";\nimport { DEFAULT_ROLE_SELECT_LABELS } from \"./role-select-labels\";\n\n/**\n * The role of an account, chosen by an admin (docs/user-admin-harmonization.md §3.3,\n * §4.1, §7): {@link RoleSelect} for the apps where an account has ONE role (keksdose,\n * Kurvenschmiede) and {@link RolesEditor} for kastlan, where an account has several per\n * company.\n *\n * Both take the app's {@link RoleVocabulary} — the one `RoleChip` reads — so a role is\n * called the same in the chip, the select and the editor. Neither sends a request: a role\n * change is an `acknowledge` action (§4.2), so the app opens `AdminActionConfirm` from\n * `onChange` and the value stays where the server has it until the server says otherwise.\n *\n * WHY THE REASONS. The server refuses the last active admin's demotion (`last_admin`),\n * your own admin role (`self`), Kurvenschmiede's CUSTOMER for an account that owns work,\n * kastlan's TENANT until a tenant portal exists (§4.1, §9.6). A choice the server will\n * refuse is shown as unavailable, with why, rather than offered and answered with an\n * error after a confirmation dialog — the 0.18 write-lock rule: a control that cannot\n * act says so where it is. `\"last_admin\"` and `\"self\"` are the kit's words in every\n * language; anything else is the app's own sentence.\n */\n\n/** A reason the kit words itself. `self_action` is the server's code for `self` (the\n *  account error codes), so a refusal's code can be handed on as it came. */\nexport type RoleLockCode = \"last_admin\" | \"self\" | \"self_action\";\n\n/**\n * Why a role (or the whole control) cannot be changed: one of the kit's\n * {@link RoleLockCode}s, or the app's own words.\n */\nexport type RoleLock = RoleLockCode | (string & {}) | ReactNode;\n\n/** The `roleSelect` namespace — RoleSelect's and RolesEditor's words. */\nexport interface RoleSelectLabels {\n  /** The select's name where no `label` is drawn, and RolesEditor's legend. \"Role\". */\n  label: string;\n  /** RolesEditor's legend. \"Roles\". */\n  rolesLegend: string;\n  /** The select's accessible name in a roster row — \"Role of Ada Example\". */\n  roleOf: (name: string) => string;\n  /** The whole control is locked: the account is the last active administrator. */\n  lockedLastAdmin: string;\n  /** The whole control is locked: it is the admin's own account. */\n  lockedSelf: string;\n  /** One option is unavailable for the last active administrator — said after the\n   *  role's name, inside the option. */\n  notForLastAdmin: string;\n  /** One option is unavailable on the admin's own account. */\n  notForSelf: string;\n  /** An unavailable option's text: the role's name and why. */\n  unavailable: (role: string, reason: string) => string;\n}\n\n// Defined in ./role-select-labels, which holds no component code (0.34, KS U8).\nexport { DEFAULT_ROLE_SELECT_LABELS };\n\n/** The whole-control reason, the kit's codes in the kit's words. */\nfunction lockText(reason: RoleLock, labels: RoleSelectLabels): ReactNode {\n  if (reason === \"last_admin\") return labels.lockedLastAdmin;\n  if (reason === \"self\" || reason === \"self_action\") return labels.lockedSelf;\n  return reason;\n}\n\n/** An option's reason as the text a native `<option>` can hold. */\nfunction optionReasonText(reason: string, labels: RoleSelectLabels): string {\n  if (reason === \"last_admin\") return labels.notForLastAdmin;\n  if (reason === \"self\" || reason === \"self_action\") return labels.notForSelf;\n  return reason;\n}\n\n/** The vocabulary's keys, in its own order. */\nfunction keysOf<R extends string>(roles: RoleVocabulary<R>): R[] {\n  return Object.keys(roles) as R[];\n}\n\n/* ── RoleSelect ─────────────────────────────────────────────────────────────── */\n\nexport interface RoleSelectProps<R extends string = string>\n  extends Omit<SelectProps, \"value\" | \"defaultValue\" | \"onChange\" | \"children\" | \"multiple\" | \"disabledReason\"> {\n  /** The role the server has. Controlled: a pick does not move the select until the\n   *  app's request lands and the row comes back with the new role. */\n  value: R | null | undefined;\n  /** The app's roles — what `RoleChip` reads. Their order is the list's. */\n  roles: RoleVocabulary<R>;\n  /** A role other than `value` was picked. The app asks `AdminActionConfirm` (an\n   *  `acknowledge` action, §4.2) and sends the change. */\n  onChange: (role: R) => void;\n  /**\n   * The roles that may be CHOSEN here, in the vocabulary's order whatever order this is\n   * in. Default: all of them. A role the account holds that is not offered (Kurvenschmiede's\n   * REVIEWER, given only through the reviewer scope, §9.6) is still shown, unavailable:\n   * a select that dropped it would show the account as something it is not.\n   */\n  offered?: readonly R[];\n  /**\n   * Why the whole choice is locked for this account: `\"last_admin\"`, `\"self\"`, or the\n   * app's own words. The select stays focusable and says so (Select's `disabledReason`).\n   */\n  disabledReason?: RoleLock;\n  /**\n   * Why ONE role cannot be chosen for this account: `\"last_admin\"`, `\"self\"`, or the\n   * app's own words (Kurvenschmiede: \"owns work\", for CUSTOMER) — a STRING, because a\n   * native option holds text only. The option is disabled and reads \"Member (not for the\n   * last administrator)\". `undefined` for an available role.\n   */\n  optionDisabledReason?: (role: R) => string | undefined;\n  /** The account's name, for the select's accessible name in a roster row (\"Role of\n   *  Ada Example\") where no `label` is drawn. */\n  name?: string;\n  labels?: LabelOverride<RoleSelectLabels>;\n}\n\n/**\n * One role, picked from the app's vocabulary — Kurvenschmiede's roster `Select`\n * (users-panel.tsx), with the reasons it left to the server's toast drawn in place.\n *\n * Unlabelled by default, for a table cell: named \"Role of Ada Example\" (`name`) or\n * \"Role\". Pass `label` for a form field. Every {@link Select} prop passes through\n * (`size`, `commit`, `hint`, `error`, `data-*`).\n */\nexport function RoleSelect<R extends string = string>({\n  value,\n  roles,\n  onChange,\n  offered,\n  disabledReason,\n  optionDisabledReason,\n  name,\n  labels: labelsProp,\n  label,\n  ...rest\n}: RoleSelectProps<R>) {\n  const labels = useKitLabels(\"roleSelect\", DEFAULT_ROLE_SELECT_LABELS, labelsProp);\n  const all = keysOf(roles);\n  const choosable = new Set<R>(offered ?? all);\n  const held = value ?? null;\n  // A cell has no room for a visible label: the select is named for the account it\n  // belongs to, so fifty of them in a roster are not fifty \"Role\"s.\n  const ariaLabel =\n    label === undefined ? (rest[\"aria-label\"] ?? (name ? labels.roleOf(name) : labels.label)) : rest[\"aria-label\"];\n  return (\n    <Select\n      {...rest}\n      label={label}\n      aria-label={ariaLabel}\n      value={held ?? \"\"}\n      disabledReason={hasContent(disabledReason) ? lockText(disabledReason, labels) : undefined}\n      onChange={(event) => {\n        const next = event.target.value as R;\n        if (next && next !== held) onChange(next);\n      }}\n    >\n      {held === null && <option value=\"\" disabled />}\n      {all\n        .filter((role) => choosable.has(role) || role === held)\n        .map((role) => {\n          const word = roles[role].label;\n          const reason = role === held ? undefined : optionDisabledReason?.(role);\n          const unavailable = !choosable.has(role) || hasContent(reason);\n          return (\n            <option key={role} value={role} disabled={unavailable && role !== held}>\n              {reason ? labels.unavailable(word, optionReasonText(reason, labels)) : word}\n            </option>\n          );\n        })}\n      {/* A role the vocabulary does not know (an older client against a newer API) is\n          still the account's role: shown as its key, as RoleChip shows it. */}\n      {held !== null && !all.includes(held) && (\n        <option value={held} disabled>\n          {held}\n        </option>\n      )}\n    </Select>\n  );\n}\n\n/* ── RolesEditor ────────────────────────────────────────────────────────────── */\n\nexport interface RolesEditorProps<R extends string = string> extends FieldHelpProps {\n  /** The roles ticked — the draft the app holds while its dialog is open. */\n  value: readonly R[];\n  roles: RoleVocabulary<R>;\n  /** The new set, in the vocabulary's order (a role the editor does not offer, but the\n   *  account holds, is kept after the rest — CheckboxGroup's rule). */\n  onChange: (roles: R[]) => void;\n  /** The roles that may be ticked or unticked here. Default: all. kastlan leaves TENANT\n   *  out until a tenant portal exists (§4.1). */\n  offered?: readonly R[];\n  /** Why nothing can be changed: `\"last_admin\"`, `\"self\"` or the app's words. */\n  disabledReason?: RoleLock;\n  /** Why one role cannot be changed — shown under it, and the box keeps its state:\n   *  `\"last_admin\"` on the last administrator's ADMIN, say. */\n  optionDisabledReason?: (role: R) => RoleLock | undefined;\n  /** Default `roleSelect.rolesLegend` — \"Roles\". kastlan names the company: \"Roles in\n   *  Example Ltd\". */\n  legend?: ReactNode;\n  legendVisibility?: \"visible\" | \"sr-only\";\n  /** At least one role (kastlan's dialog saves none). Draws the required star. */\n  required?: boolean;\n  hint?: ReactNode;\n  error?: ReactNode;\n  columns?: 1 | 2 | 3 | 4;\n  /** The editor SAVES on change — the write lock's opt-in (CheckboxGroup's `commit`). */\n  commit?: CommitScope;\n  className?: string;\n  labels?: LabelOverride<RoleSelectLabels>;\n}\n\n/**\n * Several roles at once — kastlan's manage-roles dialog (`ChoiceCardGroup multiple`),\n * which holds an account's roles in the CURRENT company (§4.1: `PUT /admin/users/{id}/roles`).\n * A kit {@link CheckboxGroup} of the vocabulary, with the reasons of {@link RoleSelect}:\n * a role that cannot change keeps its box as it is and says why under it.\n *\n * A field, not a form: the app's dialog holds the draft, and its Save goes through\n * `AdminActionConfirm` (`acknowledge`, §4.2) — which can draw this editor as its\n * `children`, so the roles and the tick are one dialog.\n */\nexport function RolesEditor<R extends string = string>({\n  value,\n  roles,\n  onChange,\n  offered,\n  disabledReason,\n  optionDisabledReason,\n  legend,\n  legendVisibility,\n  required,\n  hint,\n  help,\n  error,\n  columns,\n  commit,\n  className,\n  labels: labelsProp,\n}: RolesEditorProps<R>) {\n  const labels = useKitLabels(\"roleSelect\", DEFAULT_ROLE_SELECT_LABELS, labelsProp);\n  const all = keysOf(roles);\n  const choosable = new Set<R>(offered ?? all);\n  const held = new Set<R>(value);\n  const options: CheckboxGroupOption<R>[] = all\n    .filter((role) => choosable.has(role) || held.has(role))\n    .map((role) => {\n      const reason = optionDisabledReason?.(role);\n      const locked = hasContent(reason);\n      return {\n        value: role,\n        label: roles[role].label,\n        hint: locked ? lockText(reason, labels) : undefined,\n        disabled: locked || !choosable.has(role),\n      };\n    });\n  return (\n    <CheckboxGroup<R>\n      legend={legend ?? labels.rolesLegend}\n      legendVisibility={legendVisibility}\n      options={options}\n      value={[...value]}\n      onChange={onChange}\n      required={required}\n      hint={hint}\n      help={help}\n      error={error}\n      columns={columns}\n      commit={commit}\n      disabledReason={hasContent(disabledReason) ? lockText(disabledReason, labels) : undefined}\n      className={className}\n    />\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/components/amount-input.d.ts

@@ -1,11 +1,11 @@
 import type { ReactNode, Ref } from "react";
 import { type CalculatorButtonLabels } from "./calculator.js";
 import { type NumberPadSheetLabels } from "./numpad-sheet.js";
-import { type DisabledReasonDisplay } from "./field-parts.js";
+import { type DisabledReasonDisplay, type FieldHelpProps } from "./field-parts.js";
 import type { CommitScope } from "./write-lock.js";
 /** {@link AmountInput}'s props — exported since 0.34 (refactor audit 2026-10, API-9): a
  *  wrapper typed itself off `ComponentProps<typeof AmountInput>` until then. */
-export interface AmountInputProps {
+export interface AmountInputProps extends FieldHelpProps {
     value: string;
     onChange: (value: string) => void;
     currency?: string;

package/dist/components/amount-input.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/amount-input.tsx"],"sourcesContent":["import { useId, useMemo, useRef } from \"react\";\nimport { ChevronDown } from \"lucide-react\";\nimport type { ReactNode, Ref } from \"react\";\nimport { CurrencyOptionList, getCurrency } from \"./currency-option-list\";\nimport { useComboboxCore } from \"./combobox-core\";\nimport {\n  FIELD_BASE,\n  FIELD_DISPLAY,\n  FIELD_INVALID,\n  FLOATING_INPUT_CLASS,\n  FloatingField,\n} from \"./field-base\";\nimport { cn } from \"../lib/cn\";\nimport { currencyMinorDigits } from \"../lib/format\";\nimport { roundHalfAway } from \"../lib/round\";\nimport { CalculatorButton, type CalculatorButtonLabels } from \"./calculator\";\nimport { NumberPadSheet, type NumberPadSheetLabels } from \"./numpad-sheet\";\nimport {\n  DEFAULT_COMMON_LABELS,\n  DEFAULT_CURRENCY_LABELS,\n  useKitLabels,\n  useKitLocale,\n  type CurrencyLabels,\n} from \"../i18n/kit-labels\";\nimport {\n  commitExpression,\n  evaluateExpression,\n  formatResult,\n  isBareAmount,\n  looksLikeExpression,\n  sanitizeLive,\n  splitLeadingSign,\n} from \"../lib/calc\";\nimport {\n  FieldCaption,\n  LockedReason,\n  mergeRefs,\n  type DisabledReasonDisplay,\n  type LockReason,\n} from \"./field-parts\";\nimport { useEndWidth, useNumericField } from \"./numeric-field\";\nimport type { CommitScope } from \"./write-lock\";\n\n/** {@link AmountInput}'s props — exported since 0.34 (refactor audit 2026-10, API-9): a\n *  wrapper typed itself off `ComponentProps<typeof AmountInput>` until then. */\nexport interface AmountInputProps {\n  value: string;\n  onChange: (value: string) => void;\n  currency?: string;\n  onCurrencyChange?: (code: string) => void;\n  placeholder?: string;\n  label?: ReactNode;\n  disabled?: boolean;\n  /** Required and unanswered — {@link FIELD_INVALID}. See {@link Input}'s `invalid`. */\n  invalid?: boolean;\n  /**\n   * What is wrong with the amount, in the caller's own words — {@link Input}'s `error`\n   * (keksdose K4: \"exceeds the outstanding balance\" was a loose `<p>` beside the field\n   * that nothing pointed at). Rendered under the field, after a text `hint`; merged into\n   * `aria-describedby` after the caller's ids and the hint's; implies `invalid`, so the\n   * field paints as well as announces. `null`, `false` and `\"\"` are no message.\n   * {@link MoneyField} takes it too.\n   */\n  error?: ReactNode;\n  /**\n   * Show the desktop calculator trigger (default `true`). `false` for an amount in an\n   * ephemeral close-on-blur editor — a budget's assigned cell, a VAT cell (keksdose K6)\n   * — where a click on the icon blurs the field and tears the editor down before the\n   * popover can open. Typing a calculation (\"200+50\", then Enter) still evaluates, and\n   * a phone keeps its numpad, exactly as {@link NumberInput}'s `calculator={false}`.\n   */\n  calculator?: boolean;\n  /** The field's WRAPPER — width, a margin, a flex share. The `<input>` is\n   *  `inputClassName`'s. */\n  className?: string;\n  /**\n   * Classes for the `<input>` itself — {@link NumberInput}'s and {@link Input}'s prop of\n   * the same name, merged the same way: after everything the field sets for LOOKS — the\n   * base classes, the plain end padding, the display shape's centring and the `tone`\n   * colour — so it can restyle the figure (`text-end` for a money column whose decimal\n   * points line up, `font-medium`, a tighter `py-1` or a symmetric `px-2` in a table\n   * cell, `text-transparent` while a figure is being re-fetched), and before what the\n   * field needs to WORK: the end padding the calculator and the currency chip reserve,\n   * and the invalid border. Neither of those can be taken away by accident — a caller's\n   * `px-2` keeps its start edge and the digits still stop short of the chip, and a\n   * borderless cell's `border-transparent` still turns red when the value is wrong.\n   *\n   * keksdose G7: the invoice's VAT cell right-aligns its figure, and with only\n   * `className` (the wrapper) it reached the element through `[&_input]:text-end` — a\n   * descendant selector that depends on the field's inner markup, which the kit is free\n   * to change, and that a reader of the call site has to decode. {@link MoneyField}\n   * passes it through, and `RhfMoneyField` takes it too.\n   *\n   * keksdose 0.24: until then it sat BEFORE the plain end padding (`pe-3`) and the tone,\n   * so the budget's assigned cell could not make its padding symmetric (`px-2` came out\n   * `px-2 pe-3`) and the holdings price could not hide an outflow-toned figure while\n   * re-fetching — both were back on `[&_input]:` selectors on the wrapper.\n   */\n  inputClassName?: string;\n  id?: string;\n  /** Names the field when it has no visible `label` (a table cell, the display shape). */\n  \"aria-label\"?: string;\n  /**\n   * Set on the `<input>`, with `id` above. Declared so `Field`'s render-prop spread —\n   * `{(ids) => <AmountInput {...ids} … />}` — is typed and reaches the input: the\n   * hint and error are described, a required amount is announced as required, and\n   * `aria-invalid` paints {@link FIELD_INVALID} the way `invalid` does.\n   */\n  \"aria-describedby\"?: string;\n  \"aria-invalid\"?: boolean | \"true\" | \"false\";\n  \"aria-required\"?: boolean | \"true\" | \"false\";\n  /**\n   * BCP 47 tag for this field — {@link NumberInput}'s `locale` (0.34, DUP-10): the decimal\n   * mark the field SHOWS and reads typing in (\"1,5\" for fr-CH, \"1.5\" for de-CH, as `Intl`\n   * decides), and the language of the currency picker's search. Default the\n   * `<UiKitProvider locale>`, else the runtime's. `value` and `onChange` stay\n   * dot-decimal.\n   */\n  locale?: string;\n  /** {@link NumberInput}'s `hint`, the same rule: a {@link FieldHint} \"?\" rides the\n   *  label's own line, beside the label (not at the far end, where the calculator and\n   *  the currency chip live); plain TEXT (a string or a number) is a caption UNDER\n   *  the field, attached through `aria-describedby` after the caller's own. A phone's\n   *  `variant=\"display\"` has no visible label, so a FieldHint is dropped there; a\n   *  caption still shows.\n   *\n   *  Since 0.34 a FieldHint is that caption at Large and on a touch screen, as on\n   *  NumberInput since 0.32 (`useInlineHint`, docs/text-size-harmonization.md §4: a fact\n   *  a finger cannot hover open is printed). A `HelpPopover` — help, not a fact (§10.23)\n   *  — stays on the label line at every size. */\n  hint?: ReactNode;\n  /** Every user-facing string this component and the two it composes own, so a\n   *  translating host can supply its own. Each key optional, and each a per-field\n   *  override of the kit-wide translation in `<UiKitProvider labels>`: `currency`\n   *  and `currencySearch` of its `currency` namespace, the rest of `calculator`.\n   *  `currency` names the picker chip, composed with the selected code through\n   *  `common.fieldValue`; the rest are pass-through. */\n  labels?: {\n    currency?: string;\n    currencySearch?: string;\n    /** Names the calculator TRIGGER this component renders. `calculator` below\n     *  names the controls inside the popover it opens. */\n    calculatorTrigger?: string;\n    pad?: NumberPadSheetLabels;\n    calculator?: CalculatorButtonLabels;\n  };\n  /** Translated currency names for the chip's picker, keyed by ISO code. The same\n   *  sparse override `CurrencySelect` takes, and for the same reason: the names in\n   *  `CURRENCIES` are shipped data, so without this they are the one English word\n   *  left in a translated row. Not part of `labels` because it is keyed by DATA\n   *  rather than by a fixed set of slots, and an app passes the same map to both\n   *  pickers. */\n  currencyNames?: Record<string, string>;\n  /** Offer only these ISO codes in the chip's list, in this order — `CurrencySelect`'s\n   *  `options`, since the chip renders CurrencySelect's list (round 0.34 Wave 2, DUP-4).\n   *  Default every currency the kit knows. */\n  currencyOptions?: string[];\n  /** Focus the field on mount — on mobile this also opens the numpad sheet, so a\n   *  new-transaction form can jump straight to amount entry (feedback #70). */\n  autoFocus?: boolean;\n  /**\n   * Tint the typed figure by what it will DO (Keksdose feedback #167).\n   *\n   * The direction is chosen with a toggle beside the field rather than typed, so\n   * the digits alone say nothing about which way the money goes — on the one screen\n   * where getting that backwards is the expensive mistake. Colour says it\n   * continuously, and it costs no layout. It stays the MAIN indication (live #201\n   * rework: *\"The main indication shall still be the color\"*); {@link negative}\n   * renders the sign as a second, quieter signal in front of the figure.\n   *\n   * Never the ONLY signal: the toggle it mirrors is right there, labelled, so this\n   * is reinforcement rather than the sole carrier of the meaning.\n   */\n  tone?: \"neutral\" | \"outflow\" | \"inflow\";\n  /**\n   * The SIGN of the figure, owned by the caller's direction control (Keksdose live\n   * #201 rework: *\"Outflow should be negative and inflow positive … the sign shall\n   * be displayed but not necessarily be typed in\"*).\n   *\n   * `value` stays the MAGNITUDE. The minus is glued on at render time and stripped\n   * off again before anything is reported back, so the caller never sees its own\n   * prefix echoed and no code path can end up applying it twice. That is the whole\n   * cure: there is exactly ONE place the sign lives, and it is not the text.\n   *\n   * Because it is rendered rather than stored it cannot be deleted (the next render\n   * puts it back), a select-all-and-retype keeps the direction, and the caret needs\n   * no minding.\n   *\n   * Since 0.15.5 it is drawn on its own too, for a read-only or disabled signed figure\n   * (an \"Items total\" of −5.18): no `onNegativeChange` needed just to show the minus.\n   */\n  negative?: boolean;\n  /**\n   * A sign the user TYPED, or a calculation that resolved to a signed number.\n   *\n   * SET, never flip. A \"-\" means *\"this is an outflow\"*, so typing it twice says the\n   * same thing twice — which is exactly what the rework asks for (*\"Subtracting\n   * values twice resulting in inflow -> outflow and back to inflow seems not\n   * reasonable\"*). \"+\" says the other direction.\n   *\n   * Its presence is what ARMS the whole sign behaviour. A field with no direction\n   * control — an account's starting balance, a loan payment, a holding's cost —\n   * passes neither prop and keeps a text that is the whole truth, minus included.\n   */\n  onNegativeChange?: (negative: boolean) => void;\n  /**\n   * How the field presents itself ON A PHONE (Keksdose feedback #176).\n   *\n   * `\"field\"` (default) is the labelled, bordered input used everywhere else.\n   *\n   * `\"display\"` keeps every mechanic — the same `<input>`, the same numpad sheet,\n   * the same currency picker, the same commit/blur contract — and only drops the\n   * chrome: no border, no fill, no floating label, the figure set at display size.\n   * On a form whose whole point is one number, a bordered `text-sm` box draws the\n   * amount at the same weight as the memo beside it; this makes it the headline\n   * instead. It stays fully editable — the underline and the caret are what say so.\n   *\n   * Phone-only by construction: it keys off the same breakpoint as the numpad, so\n   * from `md` up the field is byte-for-byte the normal one and a desktop grid keeps\n   * its column rhythm.\n   */\n  variant?: \"field\" | \"display\";\n  /**\n   * Where the figure sits in its row, for `variant=\"display\"` only (Keksdose\n   * feedback #176 rework).\n   *\n   * `\"start\"` (default) keeps it flush left, in the reading column the fields\n   * below it share — and it is what the entry forms use, because a figure that\n   * starts at a known edge is legible at any width: when the value outgrows the\n   * field, the digits that scroll out of sight are the trailing ones, not the\n   * magnitude (Keksdose feedback #430 rework).\n   *\n   * `\"center\"` makes it a centred headline. It centres in the width that REMAINS\n   * after the trailing currency control, not in the whole box: the control is\n   * pinned to the right edge, so a plain `text-center` would centre the figure\n   * under it and the last digits would sit behind the chip. This used to mirror\n   * the control's reservation onto the left instead, which centred correctly but\n   * spent twice the control's width on padding — fatal on a 375px screen, where\n   * it left a 36px figure 16px to live in.\n   */\n  align?: \"start\" | \"center\";\n  /**\n   * Decimals the committed amount is rounded to (kastlan 0.12: \"12.345\" and a\n   * calculator's \"100/3\" reached a `Numeric(10,2)` column unrounded and failed with a\n   * 422). Default: the currency's minor unit, from `Intl` (CHF and EUR 2, JPY 0). With\n   * no `currency`, nothing is rounded unless this is set. Rounding is half away from\n   * zero (12.345 → 12.35, -12.345 → -12.35) and happens when the figure settles: on\n   * blur, on Enter, and on every result the calculator writes back. Keystrokes are left\n   * alone, so \"12.3\" can still become \"12.34\".\n   *\n   * ⚠️ **A unit price or a rate needs `digits`.** The default is right for an amount of\n   * money and silently wrong for a price per unit: a fund's NAV of 123.4567 or fuel at\n   * 1.789 €/l is stored as 123.46 / 1.79, and no test fails (keksdose G2, a\n   * `Numeric(18,6)` holding price and a `Numeric(18,4)` unit price). Pass the column's\n   * scale: `digits={4}`, `digits={6}`.\n   *\n   * **Set `digits` for any sub-currency scale** — not only a price: any field whose\n   * column holds more decimals than the currency's minor unit. A split line stored at\n   * the ledger's 4dp (`Numeric(18,4)`) and loaded as 12.3456 is SHOWN as 12.35, and\n   * committed as 12.35 as soon as the user tabs through it (blur settles) — so the form\n   * no longer equals what the server holds: the lines stop summing to the 4dp total,\n   * and Save is held (keksdose live #240). With a `currency`, every commit rounds to that currency's\n   * minor unit unless `digits` says otherwise: pass the column's scale (`digits={4}`).\n   */\n  digits?: number;\n  /** The smallest amount the field settles on. A lower figure is raised to it when it\n   *  settles, like `digits`. Compared with the signed figure. */\n  min?: number;\n  /** The largest amount the field settles on (a deposit release capped at the\n   *  balance). A higher figure is lowered to it when it settles. */\n  max?: number;\n  /**\n   * The SETTLED figure, dot-decimal, sign included — fired on blur, on Enter, on the\n   * numpad's \"=\" and on every result the calculator writes back, never on a keystroke\n   * (\"1200+\" is not a figure yet). `onChange` still reports every keystroke; this is\n   * for a host that stores a number and must not see drafts (kastlan 52; see\n   * {@link MoneyField}, which is built on it).\n   */\n  onCommit?: (value: string) => void;\n  /**\n   * Why the amount cannot be changed — {@link NumberInput}'s `disabledReason` (0.34,\n   * round 0.34 C2), for an amount that SAVES itself: a budget row's assigned cell, a\n   * price committed on blur. `disabled` takes the field out of the tab order, so the\n   * reason never reached a keyboard.\n   *\n   * With a reason the field stays in the tab order and shows its figure, `readOnly` (the\n   * settled grey FIELD_BASE gives a `[readonly]` field) and `aria-disabled`. Nothing\n   * changes the amount: the calculator and the phone's numpad are not offered, the\n   * currency chip is a read-out rather than a picker, and neither blur nor Enter\n   * settles — so `onChange`, `onCommit`, `onNegativeChange` and `onCurrencyChange` are\n   * never called. Enter is swallowed, so the field does not submit the form around it.\n   * The reason is a line under the field at Large and on a touch screen, else in the kit\n   * {@link Tooltip} (`disabledReasonDisplay`), and on the input's `aria-describedby`,\n   * between the caption and the error. Wins over `disabled`. {@link MoneyField} and\n   * `RhfMoneyField` take it too.\n   */\n  disabledReason?: ReactNode;\n  /**\n   * Where the reason shows — {@link Button}'s `disabledReasonDisplay`: by default a line\n   * under the field at Large and on a touch screen, the tooltip otherwise (§4 \"No fact\n   * only in a tooltip\"; DUP-3, refactor audit 2026-10).\n   */\n  disabledReasonDisplay?: DisabledReasonDisplay;\n  /**\n   * This amount COMMITS — {@link Button}'s `commit`, NumberInput's: under a locked\n   * {@link WriteLockProvider} it is locked the `disabledReason` way with the lock's reason\n   * (which wins over its own). An amount that only reaches the server through its form's\n   * Save leaves this off and stays editable under the lock; the Save takes `commit`. No\n   * provider, or an unlocked one: no effect.\n   */\n  commit?: CommitScope;\n  /** The `<input>`. A React 19 ref prop since 0.34 (MOD-4, refactor audit 2026-10); it\n   *  was `forwardRef`. */\n  ref?: Ref<HTMLInputElement>;\n}\n\n\n/**\n * A settled figure, rounded to `digits` (half away from zero) and clamped to\n * `min`/`max`. Only a plain number is touched. A half-typed draft or an expression\n * comes back as it was. Rounding is `lib/round.ts`'s, shared with `roundToCurrency`\n * (BUG-11: this copy blanked \"0.0000001\" and a 22-digit figure on blur).\n */\nfunction settleAmount(text: string, digits: number | undefined, min?: number, max?: number): string {\n  const t = text.trim();\n  if (!/^-?\\d*\\.?\\d*$/.test(t) || !/\\d/.test(t)) return text;\n  let n = Number(t);\n  if (!Number.isFinite(n)) return text;\n  if (digits !== undefined) n = roundHalfAway(n, digits);\n  if (min !== undefined && n < min) n = min;\n  if (max !== undefined && n > max) n = max;\n  const out = formatResult(n);\n  // Unchanged figures keep their own spelling (\"12.50\" stays \"12.50\").\n  return Number(out) === Number(t) ? text : out;\n}\n\n// The locale's decimal mark and the grouping parse (kastlan 40, keksdose G1) live in\n// `lib/decimal-marks.ts`, read through the engine NumberInput and this field share\n// (`numeric-field.ts`, DUP-10).\n\n// The consuming app's ONE money palette (`--money-expense` / `--money-income`),\n// not a bespoke rose/emerald pairing: a figure being typed has to wear the same\n// colour the same figure will wear once it is a row in the table behind the form\n// (Keksdose dev#434). The utilities are unlayered and theme-aware, so no `dark:`\n// variant is needed and they win over the field's own text colour regardless of\n// where `cn` puts them.\nconst TONE_CLASS: Record<\"neutral\" | \"outflow\" | \"inflow\", string> = {\n  neutral: \"\",\n  outflow: \"text-money-neg\",\n  inflow: \"text-money-pos\",\n};\n\n// The shared chrome-less treatment at money size. `tabular-nums` so digits don't\n// reflow the figure as they are typed; FIELD_DISPLAY's own muted placeholder\n// colour is what keeps an EMPTY form from painting its zero in the direction tint\n// (`tone` is computed from 0, which reads as an inflow).\nconst DISPLAY_INPUT_CLASS = cn(\n  FIELD_DISPLAY,\n  \"text-4xl font-semibold leading-tight tracking-tight tabular-nums\",\n);\n\n/**\n * Is `text` the ANSWER to `previous`, or something typed OVER it?\n *\n * \"The old text was a sum and the new one is bare\" cannot tell those apart, and both\n * gestures are ordinary: select-all-and-retype after a typo, or backspacing \"-20+\"\n * back down to a fresh figure. Read as an answer, they move the direction chip — so\n * an outflow of 7 quietly booked +7.00 (live #201 rework).\n *\n * The question that does separate them is arithmetic, not shape: evaluate what the\n * text replaced and see whether this IS that number. \"-12+30\" → \"18\" still is, so a\n * sum that comes out positive still takes the chip with it; \"-20+50\" → \"7\" is not,\n * and \"-20+\" evaluates to nothing at all.\n */\nfunction isResultOf(previous: string, text: string, settle: (text: string) => string): boolean {\n  const n = evaluateExpression(previous);\n  // Compared settled, since the field rounds what the calculator hands it.\n  return n !== null && settle(formatResult(n)) === text.trim();\n}\n\nexport function AmountInput(props: AmountInputProps) {\n  const { ref, value, onChange, currency, onCurrencyChange, placeholder, label, className, inputClassName, id, \"aria-label\": ariaLabel, \"aria-required\": ariaRequired, autoFocus, tone = \"neutral\", negative = false, onNegativeChange, align = \"start\", labels, currencyNames, currencyOptions, digits: digitsProp, min, max, onCommit, disabledReasonDisplay } = props;\n  const generatedId = useId();\n  const fieldId = id ?? generatedId;\n  // The sign is DISPLAYED, not stored (live #201 rework). `value` is the\n  // magnitude; the minus is glued on here and taken off again in handleText, so\n  // the two can never disagree and the caller can never double-apply it. Only in\n  // front of a bare amount: an expression being typed (\"12-30\") owns its own\n  // minus and has to survive keystroke-for-keystroke.\n  const signOwned = onNegativeChange !== undefined;\n  // The sign is DRAWN whenever `negative` says so, handler or not (keksdose live #366):\n  // a read-only or disabled total (\"−5.18\") used to need a dummy `onNegativeChange`\n  // just to show its minus. Without the handler there is nothing to toggle — a typed\n  // minus simply stays in the text, as in any field without a direction control.\n  const shown = negative && isBareAmount(value) ? `-${value}` : value;\n  // What the user SEES is `shown` with the locale's decimal mark (kastlan 40: a\n  // fr-CH user typed \"1,5\" and watched it turn into \"1.5\" under their fingers). Display only — `value`, `onChange`, the sign split and the settle all\n  // stay dot-decimal, because that string is the contract: RhfMoneyField's\n  // `parseAmount`, every app's `Number(value)` and the calculator's evaluator read\n  // it. The way back is free: {@link sanitizeLive} already folds a typed \",\" into\n  // \".\", so a comma typed, pasted or tapped on the numpad lands as a dot.\n  //\n  // One character for one character, and no digit grouping: the caret stays where\n  // the typist put it, and \"1.000\" cannot be read back as a thousand in one locale\n  // and as one in the other. de-CH and it-CH are \".\" — CLDR says so, and this\n  // follows `Intl` rather than a guess about a country. The field's own `locale`,\n  // else the provider's (0.34, DUP-10).\n  const locale = useKitLocale(props.locale);\n  // Decimals the figure settles to: `digits`, else the currency's minor unit.\n  const digits = digitsProp ?? currencyMinorDigits(currency);\n  const settle = (text: string) => settleAmount(text, digits, min, max);\n  // The engine NumberInput shares (DUP-10): the lock (focusable, `readOnly`, nothing\n  // changes or settles — see `disabledReason`), the hint — a FieldHint is its words at\n  // Large and on touch, §4 — the error, the description's order, the typist's draft\n  // in the locale's mark, the calculator and the numpad. On a phone the OS keyboard\n  // is suppressed for the numpad sheet (feedback #334), and the display shape keys off\n  // the SAME phone layout, so the two can never drift apart on the breakpoint.\n  //\n  // A value the HOST set (not one typed here) is shown at the currency's minor unit\n  // while the field is not being edited: an FX estimate of 93.4213 showed four\n  // decimals (keksdose live #356). Display only — `value` is the host's, untouched.\n  const numeric = useNumericField(props, {\n    settle,\n    display: (focused) => (focused ? shown : settleAmount(shown, digits)),\n  });\n  const { lock, locked, off, isMobile, asDisplay, showCalc, showNumpad, setFocused, mark, draft, setDraft, derived } =\n    numeric;\n  const invalid = numeric.isInvalid;\n  // A locked chip is a read-out: picking a currency is a change too.\n  const editable = !!onCurrencyChange && !locked;\n  // Room for the trailing controls — the calculator and the currency chip — once\n  // measured, as NumberInput reserves its own (keksdose live #367, DUP-10): their\n  // width, the track's `end-1` inset in the boxed shape, and NumberInput's 4px gap.\n  // Before that (the first paint, and wherever there is no layout) the classes below\n  // stand in. showCalc is always false on a phone, so the display shape only has to\n  // clear the chip, by its own width rather than the boxed shape's room (feedback #430\n  // rework: on a 375px screen 16px decide between a readable figure and a clipped one).\n  const hasEnd = showCalc || Boolean(currency);\n  const [endRef, endWidth] = useEndWidth(hasEnd);\n  const trailingRoom = asDisplay\n    ? currency ? (editable ? \"pe-16\" : \"pe-12\") : undefined\n    : showCalc\n      ? currency ? (editable ? \"pe-24\" : \"pe-16\") : \"pe-10\"\n      : currency ? (editable ? \"pe-20\" : \"pe-14\") : undefined;\n  const innerRef = useRef<HTMLInputElement>(null);\n  const setRefs = useMemo(() => mergeRefs(innerRef, ref), [ref]);\n  // While the typist is typing, the field shows THEIR text (\"1.234,5\" stays exactly\n  // that), not the value re-spelt: re-spelling turned a grouping \".\" into a \",\" under\n  // their fingers, after which no rule could tell the two apart (keksdose G1). The\n  // draft only while it says what the field holds AND holds nothing the live\n  // sanitising would drop — a letter, a second decimal point (see `showsTyped`); a\n  // value set from outside, a calculator result or a commit shows the derived spelling.\n  const display =\n    draft === null\n      ? derived\n      : (numeric.typedFor(shown) ??\n        // The caller owns the sign: the typed \"12\" is shown as the \"-12\" it is.\n        (signOwned && negative && shown.startsWith(\"-\") && numeric.typedFor(shown.slice(1)) !== null\n          ? `-${draft}`\n          : derived));\n  // Every route into the field — typing, the numpad sheet, the desktop\n  // calculator, the blur/Enter commit — funnels through here, so the split is\n  // written once and the four entry paths cannot drift.\n  //\n  // `previous` is the text this one REPLACES, and it is what says whether a bare\n  // figure arriving here is an answer or a magnitude. For the three paths that\n  // edit the field's own text that is simply what the field was showing; the\n  // desktop calculator keeps its expression in a popover the field never sees,\n  // so it passes it in (see `CalculatorButton`'s `onChange`).\n  const handleText = (raw: string, previous: string = shown) => {\n    const text = sanitizeLive(raw);\n    if (!signOwned) {\n      onChange(text);\n      return;\n    }\n    const { sign, rest } = splitLeadingSign(text);\n    if (sign) {\n      // SET, not flip: re-reporting the same sign on every keystroke is a no-op.\n      onNegativeChange(sign === \"-\");\n    } else if (looksLikeExpression(previous) && isBareAmount(text) && isResultOf(previous, text, settle)) {\n      // A calculation that just RESOLVED states its sign in both directions. The\n      // figure it ran on is the SIGNED one the user could see — \"-12+30\" is +18 —\n      // so a positive result has to move the chip too, or the field would answer\n      // that sum with \"-18\" and contradict the arithmetic it just showed.\n      //\n      // Only when it really resolved, though: see {@link isResultOf}. A bare figure\n      // arriving on top of an expression is far more often a replacement than an\n      // answer, and reading it as an answer flips the direction of money.\n      onNegativeChange(false);\n    }\n    onChange(sign ? rest : text);\n  };\n  const commit = () => {\n    setDraft(null);\n    const settled = settle(commitExpression(shown));\n    handleText(settled);\n    onCommit?.(settled);\n  };\n  const typed = (raw: string) => handleText(numeric.read(raw));\n  // The currency list is CurrencySelect's (round 0.34 Wave 2, DUP-4) on the picker\n  // family's core: the chip was a hand copy of it and had drifted (no wrap at Large, no\n  // `options` subset, no check mark, no listbox id, no #308 width), and both were plain\n  // buttons under a listbox promise. `filter: false`: the list filters its own rows.\n  const core = useComboboxCore<string>({ filter: false, backCloses: true });\n  // `chipRef`: the chip the currency list hangs off (Keksdose dev#548: portalled, so the\n  // panel needs a real trigger rect rather than a relative parent). It is also where\n  // Escape and a pick hand focus back (round 0.34 BUG-1): Safari does not focus a\n  // clicked button, so \"whatever held focus\" is not the chip.\n  const { open, setOpen, closeToTrigger, triggerRef: chipRef } = core;\n  const listboxId = `${generatedId}-currencies`;\n  // A lock arriving while the list is up closes it, as on CountrySelect — adjusted\n  // while rendering, so no frame shows a list that can no longer be used.\n  if (!editable && open) setOpen(false);\n\n  // The currency chip's strings are the `currency` namespace — the same two\n  // `CurrencySelect` resolves, under this component's older key names. The\n  // calculator and the numpad resolve `calculator` themselves; `labels.calculator`\n  // and `labels.pad` are handed straight through to them as overrides.\n  // The two strings read out first, so the memo depends on them and not on the\n  // caller's `labels` object (a new one every render) — what the React Compiler infers.\n  const currencyLabel = labels?.currency;\n  const currencySearchLabel = labels?.currencySearch;\n  const currencyOverrides = useMemo(() => {\n    const out: Partial<CurrencyLabels> = {};\n    if (currencyLabel !== undefined) out.currency = currencyLabel;\n    if (currencySearchLabel !== undefined) out.search = currencySearchLabel;\n    return out;\n  }, [currencyLabel, currencySearchLabel]);\n  const currencyText = useKitLabels(\"currency\", DEFAULT_CURRENCY_LABELS, currencyOverrides);\n  const common = useKitLabels(\"common\", DEFAULT_COMMON_LABELS);\n\n  const selected = getCurrency(currency);\n\n  return (\n    <div className={cn(\"w-full\", className)}>\n      {/* Inner relative box holds the input + its absolutely-positioned\n          trailing controls (calculator / currency), so those stay anchored to\n          the INPUT even when the mobile math bar is rendered below (#334). It is\n          the kit's FloatingField, which draws the label — floating, or sr-only in\n          the display shape — and puts a FieldHint on the label's line, as it does\n          for NumberInput. */}\n      {/* Locked, the field sits in the reason's frame (LockedReason: the line, or the\n          Tooltip), as NumberInput does; the root above keeps `className`, so nothing\n          reflows. */}\n      <LockedOrNot lock={lock} display={disabledReasonDisplay}>\n      <FloatingField\n        className=\"w-full\"\n        htmlFor={fieldId}\n        label={label}\n        srOnlyLabel={asDisplay}\n        hint={numeric.hint.labelHint}\n      >\n      <input\n        ref={setRefs}\n        id={fieldId}\n        aria-label={ariaLabel}\n        type=\"text\"\n        // eslint-disable-next-line jsx-a11y/no-autofocus -- opt-in per call site (feedback #70)\n        autoFocus={autoFocus}\n        // On mobile suppress the OS keyboard so our numpad sheet owns entry; the\n        // field keeps focus/caret. Desktop keeps the native decimal keypad.\n        inputMode={isMobile ? \"none\" : \"decimal\"}\n        autoComplete=\"off\"\n        disabled={off}\n        // Locked: focusable, `readOnly`, `aria-disabled` — see `disabledReason`.\n        readOnly={locked || undefined}\n        aria-disabled={locked || undefined}\n        // The floating-label pattern needs a blank placeholder for its\n        // peer-placeholder-shown trick. The display shape has no floating label,\n        // so it spends the placeholder on what an empty borderless form actually\n        // needs: a zero to aim at, at full size. The caller supplies it because\n        // only the app knows the locale's decimal separator.\n        placeholder={asDisplay ? (placeholder ?? \"0\") : label !== undefined ? \" \" : placeholder}\n        value={display}\n        onChange={(e) => {\n          if (!locked) typed(e.target.value);\n        }}\n        onFocus={() => setFocused(true)}\n        onBlur={() => {\n          // Nothing settles under the lock — not even a draft typed before it arrived,\n          // which stays in the field for when it lifts.\n          if (!locked) commit();\n          setFocused(false);\n        }}\n        onKeyDown={(e) => {\n          if (e.key !== \"Enter\") return;\n          // Locked: Enter submits no form and settles nothing.\n          if (locked) e.preventDefault();\n          else commit();\n        }}\n        className={cn(\n          // With a label, use the floating-input padding (pt-4 pb-1) like every\n          // other labelled field so the value sits BELOW the floated label rather\n          // than vertically centred where it overlaps the resting label\n          // (feedback #314). FLOATING_INPUT_CLASS already bundles the peer +\n          // transparent-placeholder bits.\n          asDisplay ? DISPLAY_INPUT_CLASS : label !== undefined ? FLOATING_INPUT_CLASS : FIELD_BASE,\n          // The plain end padding, with nothing trailing: cosmetic, so the caller's\n          // to change (keksdose 0.24 — a symmetric `px-2` in a budget cell).\n          !trailingRoom && (asDisplay ? \"pe-0\" : \"pe-3\"),\n          // Centred display shape: centre in what is LEFT of the currency chip.\n          // `text-center` alone would centre the figure in the whole box, i.e.\n          // partly underneath the chip; the padding below is what takes the chip\n          // out of the centring, and nothing is added at the start because a\n          // mirrored reservation would spend the width twice (see `align`).\n          asDisplay && align === \"center\" && \"text-center\",\n          // Over the base class's own text colour.\n          TONE_CLASS[tone],\n          // The caller's, over all of the above — base, plain padding, alignment and\n          // tone — and under only what the field needs to work (see `inputClassName`).\n          inputClassName,\n          // Room for the trailing controls, after the caller's so a `px-2` cannot run\n          // the digits under the chip (NumberInput's order, which reserves its unit\n          // and calculator the same way).\n          trailingRoom,\n          invalid && FIELD_INVALID,\n          locked && \"cursor-not-allowed\",\n        )}\n        // The classes above are the fallback; once measured the field reserves exactly\n        // its trailing controls' width, inline so it wins over every class (see\n        // `trailingRoom`).\n        style={hasEnd && endWidth != null ? { paddingInlineEnd: endWidth + (asDisplay ? 4 : 8) } : undefined}\n        aria-invalid={invalid || undefined}\n        aria-describedby={numeric.describedBy}\n        aria-required={ariaRequired}\n      />\n      {/* The label is FloatingField's, after these children (the floating trick\n          reads the input through `peer-*`). The display shape drops it VISUALLY,\n          not from the accessibility tree: a 36px tinted figure at the top of a\n          transaction form is legibly the amount, but a screen reader still needs\n          the name, and callers that pass `label` without `aria-label` would\n          otherwise be left with none. */}\n      {/* Trailing controls share one flex track so the calculator icon and the\n          currency suffix/picker sit side by side without overlapping. */}\n      {/* The display shape has no box to inset from, so the controls align to the\n          figure's own end edge and its baseline strip (`bottom-1`, matching the\n          input's pb-1) instead of floating inside a field. */}\n      <div\n        // Measured for the input's end padding (see `trailingRoom`).\n        ref={endRef}\n        className={cn(\n          \"absolute flex items-center gap-0.5\",\n          // Logical `end-*`: the chip and the calculator are the figure's trailing\n          // controls, so a right-to-left form carries them on the left.\n          asDisplay ? \"bottom-1 end-0\" : \"inset-y-1 end-1\",\n        )}\n      >\n        {showCalc && (\n          <CalculatorButton\n            // The mark the field shows but not the typist's grouping: the evaluator\n            // reads either mark, and \"1.234,5\" is two of them. The result comes back\n            // dot-decimal.\n            value={derived}\n            onChange={(result, expression) => {\n              setDraft(null);\n              const settled = settle(result);\n              handleText(settled, expression);\n              onCommit?.(settled);\n            }}\n            className=\"px-1.5\"\n            aria-label={labels?.calculatorTrigger}\n            labels={labels?.calculator}\n          />\n        )}\n        {currency && !editable && (\n          <span\n            aria-hidden\n            className={cn(\n              \"pointer-events-none px-1 font-medium text-muted\",\n              // A text-xs chip next to a 36px figure reads as a stray footnote.\n              asDisplay ? \"text-sm\" : \"text-xs\",\n            )}\n          >\n            {currency}\n          </span>\n        )}\n        {currency && editable && (\n          <button\n            ref={chipRef}\n            type=\"button\"\n            onClick={() => setOpen((v) => !v)}\n            // A button that opens a listbox, and says so: the chip is a control inside\n            // a text field, not a field of its own, so not a combobox.\n            aria-haspopup=\"listbox\"\n            aria-expanded={open}\n            aria-controls={listboxId}\n            aria-label={\n              // \"Currency: EUR\" through `common.fieldValue`, not a template literal:\n              // the colon-and-space is punctuation a translation has to own.\n              selected ? common.fieldValue(currencyText.currency, selected.code) : currencyText.currency\n            }\n            className={cn(\n              \"flex items-center gap-1 rounded px-2 py-1 font-medium text-secondary hover:bg-hover\",\n              asDisplay ? \"text-sm\" : \"text-xs\",\n            )}\n          >\n            {currency}\n            <ChevronDown className=\"size-3\" />\n          </button>\n        )}\n      </div>\n      {editable && (\n        <CurrencyOptionList\n          core={core}\n          listboxId={listboxId}\n          value={currency}\n          codes={currencyOptions}\n          currencyNames={currencyNames}\n          locale={locale}\n          searchPlaceholder={currencyText.search}\n          // The phone sheet's title: what the chip is for.\n          sheetTitle={currencyText.currency}\n          onChoose={(code) => {\n            onCurrencyChange?.(code);\n            closeToTrigger();\n          }}\n        />\n      )}\n      </FloatingField>\n      </LockedOrNot>\n      {/* Outside the relative box, as NumberInput's caption is: the trailing\n          controls are `inset-y-1` in it and would stretch down over a second line. */}\n      <FieldCaption parts={numeric.hint} />\n      {/* The news after the standing advice, as Select orders them. The root is\n          already a steady box, so the message coming and going remounts nothing. */}\n      {numeric.errorEl}\n      {showNumpad && (\n        <NumberPadSheet\n          // Localised like the field it mirrors. Keys are typing, read by the\n          // locale's marks like the keyboard's; \"=\" is a result, dot-decimal.\n          value={display}\n          onChange={typed}\n          onResult={(result) => {\n            setDraft(null);\n            const settled = settle(result);\n            handleText(settled);\n            onCommit?.(settled);\n          }}\n          onDone={() => innerRef.current?.blur()}\n          label={label}\n          labels={labels?.pad}\n          decimalMark={mark}\n        />\n      )}\n    </div>\n  );\n}\n\n/** The field in its lock's {@link LockedReason} while locked, as it is otherwise. A\n *  component rather than a ternary so the field's JSX is written once. `block w-full`:\n *  the frame's box stands where the field's own did. */\nfunction LockedOrNot({\n  lock,\n  display,\n  children,\n}: {\n  lock: LockReason;\n  display: DisabledReasonDisplay | undefined;\n  children: ReactNode;\n}) {\n  if (!lock.locked) return <>{children}</>;\n  return (\n    <LockedReason lock={lock} display={display} className=\"block w-full\">\n      {children}\n    </LockedReason>\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/components/amount-input.tsx"],"sourcesContent":["import { useId, useMemo, useRef } from \"react\";\nimport { ChevronDown } from \"lucide-react\";\nimport type { ReactNode, Ref } from \"react\";\nimport { CurrencyOptionList, getCurrency } from \"./currency-option-list\";\nimport { useComboboxCore } from \"./combobox-core\";\nimport {\n  FIELD_BASE,\n  FIELD_DISPLAY,\n  FIELD_INVALID,\n  FLOATING_INPUT_CLASS,\n  FloatingField,\n} from \"./field-base\";\nimport { cn } from \"../lib/cn\";\nimport { currencyMinorDigits } from \"../lib/format\";\nimport { roundHalfAway } from \"../lib/round\";\nimport { CalculatorButton, type CalculatorButtonLabels } from \"./calculator\";\nimport { NumberPadSheet, type NumberPadSheetLabels } from \"./numpad-sheet\";\nimport {\n  DEFAULT_COMMON_LABELS,\n  DEFAULT_CURRENCY_LABELS,\n  useKitLabels,\n  useKitLocale,\n  type CurrencyLabels,\n} from \"../i18n/kit-labels\";\nimport {\n  commitExpression,\n  evaluateExpression,\n  formatResult,\n  isBareAmount,\n  looksLikeExpression,\n  sanitizeLive,\n  splitLeadingSign,\n} from \"../lib/calc\";\nimport {\n  FieldCaption,\n  LockedReason,\n  mergeRefs,\n  type DisabledReasonDisplay,\n  type FieldHelpProps,\n  type LockReason,\n} from \"./field-parts\";\nimport { useEndWidth, useNumericField } from \"./numeric-field\";\nimport type { CommitScope } from \"./write-lock\";\n\n/** {@link AmountInput}'s props — exported since 0.34 (refactor audit 2026-10, API-9): a\n *  wrapper typed itself off `ComponentProps<typeof AmountInput>` until then. */\nexport interface AmountInputProps extends FieldHelpProps {\n  value: string;\n  onChange: (value: string) => void;\n  currency?: string;\n  onCurrencyChange?: (code: string) => void;\n  placeholder?: string;\n  label?: ReactNode;\n  disabled?: boolean;\n  /** Required and unanswered — {@link FIELD_INVALID}. See {@link Input}'s `invalid`. */\n  invalid?: boolean;\n  /**\n   * What is wrong with the amount, in the caller's own words — {@link Input}'s `error`\n   * (keksdose K4: \"exceeds the outstanding balance\" was a loose `<p>` beside the field\n   * that nothing pointed at). Rendered under the field, after a text `hint`; merged into\n   * `aria-describedby` after the caller's ids and the hint's; implies `invalid`, so the\n   * field paints as well as announces. `null`, `false` and `\"\"` are no message.\n   * {@link MoneyField} takes it too.\n   */\n  error?: ReactNode;\n  /**\n   * Show the desktop calculator trigger (default `true`). `false` for an amount in an\n   * ephemeral close-on-blur editor — a budget's assigned cell, a VAT cell (keksdose K6)\n   * — where a click on the icon blurs the field and tears the editor down before the\n   * popover can open. Typing a calculation (\"200+50\", then Enter) still evaluates, and\n   * a phone keeps its numpad, exactly as {@link NumberInput}'s `calculator={false}`.\n   */\n  calculator?: boolean;\n  /** The field's WRAPPER — width, a margin, a flex share. The `<input>` is\n   *  `inputClassName`'s. */\n  className?: string;\n  /**\n   * Classes for the `<input>` itself — {@link NumberInput}'s and {@link Input}'s prop of\n   * the same name, merged the same way: after everything the field sets for LOOKS — the\n   * base classes, the plain end padding, the display shape's centring and the `tone`\n   * colour — so it can restyle the figure (`text-end` for a money column whose decimal\n   * points line up, `font-medium`, a tighter `py-1` or a symmetric `px-2` in a table\n   * cell, `text-transparent` while a figure is being re-fetched), and before what the\n   * field needs to WORK: the end padding the calculator and the currency chip reserve,\n   * and the invalid border. Neither of those can be taken away by accident — a caller's\n   * `px-2` keeps its start edge and the digits still stop short of the chip, and a\n   * borderless cell's `border-transparent` still turns red when the value is wrong.\n   *\n   * keksdose G7: the invoice's VAT cell right-aligns its figure, and with only\n   * `className` (the wrapper) it reached the element through `[&_input]:text-end` — a\n   * descendant selector that depends on the field's inner markup, which the kit is free\n   * to change, and that a reader of the call site has to decode. {@link MoneyField}\n   * passes it through, and `RhfMoneyField` takes it too.\n   *\n   * keksdose 0.24: until then it sat BEFORE the plain end padding (`pe-3`) and the tone,\n   * so the budget's assigned cell could not make its padding symmetric (`px-2` came out\n   * `px-2 pe-3`) and the holdings price could not hide an outflow-toned figure while\n   * re-fetching — both were back on `[&_input]:` selectors on the wrapper.\n   */\n  inputClassName?: string;\n  id?: string;\n  /** Names the field when it has no visible `label` (a table cell, the display shape). */\n  \"aria-label\"?: string;\n  /**\n   * Set on the `<input>`, with `id` above. Declared so `Field`'s render-prop spread —\n   * `{(ids) => <AmountInput {...ids} … />}` — is typed and reaches the input: the\n   * hint and error are described, a required amount is announced as required, and\n   * `aria-invalid` paints {@link FIELD_INVALID} the way `invalid` does.\n   */\n  \"aria-describedby\"?: string;\n  \"aria-invalid\"?: boolean | \"true\" | \"false\";\n  \"aria-required\"?: boolean | \"true\" | \"false\";\n  /**\n   * BCP 47 tag for this field — {@link NumberInput}'s `locale` (0.34, DUP-10): the decimal\n   * mark the field SHOWS and reads typing in (\"1,5\" for fr-CH, \"1.5\" for de-CH, as `Intl`\n   * decides), and the language of the currency picker's search. Default the\n   * `<UiKitProvider locale>`, else the runtime's. `value` and `onChange` stay\n   * dot-decimal.\n   */\n  locale?: string;\n  /** {@link NumberInput}'s `hint`, the same rule: a {@link FieldHint} \"?\" rides the\n   *  label's own line, beside the label (not at the far end, where the calculator and\n   *  the currency chip live); plain TEXT (a string or a number) is a caption UNDER\n   *  the field, attached through `aria-describedby` after the caller's own. A phone's\n   *  `variant=\"display\"` has no visible label, so a FieldHint is dropped there; a\n   *  caption still shows.\n   *\n   *  Since 0.34 a FieldHint is that caption at Large and on a touch screen, as on\n   *  NumberInput since 0.32 (`useInlineHint`, docs/text-size-harmonization.md §4: a fact\n   *  a finger cannot hover open is printed). A `HelpPopover` — help, not a fact (§10.23)\n   *  — stays on the label line at every size. */\n  hint?: ReactNode;\n  /** Every user-facing string this component and the two it composes own, so a\n   *  translating host can supply its own. Each key optional, and each a per-field\n   *  override of the kit-wide translation in `<UiKitProvider labels>`: `currency`\n   *  and `currencySearch` of its `currency` namespace, the rest of `calculator`.\n   *  `currency` names the picker chip, composed with the selected code through\n   *  `common.fieldValue`; the rest are pass-through. */\n  labels?: {\n    currency?: string;\n    currencySearch?: string;\n    /** Names the calculator TRIGGER this component renders. `calculator` below\n     *  names the controls inside the popover it opens. */\n    calculatorTrigger?: string;\n    pad?: NumberPadSheetLabels;\n    calculator?: CalculatorButtonLabels;\n  };\n  /** Translated currency names for the chip's picker, keyed by ISO code. The same\n   *  sparse override `CurrencySelect` takes, and for the same reason: the names in\n   *  `CURRENCIES` are shipped data, so without this they are the one English word\n   *  left in a translated row. Not part of `labels` because it is keyed by DATA\n   *  rather than by a fixed set of slots, and an app passes the same map to both\n   *  pickers. */\n  currencyNames?: Record<string, string>;\n  /** Offer only these ISO codes in the chip's list, in this order — `CurrencySelect`'s\n   *  `options`, since the chip renders CurrencySelect's list (round 0.34 Wave 2, DUP-4).\n   *  Default every currency the kit knows. */\n  currencyOptions?: string[];\n  /** Focus the field on mount — on mobile this also opens the numpad sheet, so a\n   *  new-transaction form can jump straight to amount entry (feedback #70). */\n  autoFocus?: boolean;\n  /**\n   * Tint the typed figure by what it will DO (Keksdose feedback #167).\n   *\n   * The direction is chosen with a toggle beside the field rather than typed, so\n   * the digits alone say nothing about which way the money goes — on the one screen\n   * where getting that backwards is the expensive mistake. Colour says it\n   * continuously, and it costs no layout. It stays the MAIN indication (live #201\n   * rework: *\"The main indication shall still be the color\"*); {@link negative}\n   * renders the sign as a second, quieter signal in front of the figure.\n   *\n   * Never the ONLY signal: the toggle it mirrors is right there, labelled, so this\n   * is reinforcement rather than the sole carrier of the meaning.\n   */\n  tone?: \"neutral\" | \"outflow\" | \"inflow\";\n  /**\n   * The SIGN of the figure, owned by the caller's direction control (Keksdose live\n   * #201 rework: *\"Outflow should be negative and inflow positive … the sign shall\n   * be displayed but not necessarily be typed in\"*).\n   *\n   * `value` stays the MAGNITUDE. The minus is glued on at render time and stripped\n   * off again before anything is reported back, so the caller never sees its own\n   * prefix echoed and no code path can end up applying it twice. That is the whole\n   * cure: there is exactly ONE place the sign lives, and it is not the text.\n   *\n   * Because it is rendered rather than stored it cannot be deleted (the next render\n   * puts it back), a select-all-and-retype keeps the direction, and the caret needs\n   * no minding.\n   *\n   * Since 0.15.5 it is drawn on its own too, for a read-only or disabled signed figure\n   * (an \"Items total\" of −5.18): no `onNegativeChange` needed just to show the minus.\n   */\n  negative?: boolean;\n  /**\n   * A sign the user TYPED, or a calculation that resolved to a signed number.\n   *\n   * SET, never flip. A \"-\" means *\"this is an outflow\"*, so typing it twice says the\n   * same thing twice — which is exactly what the rework asks for (*\"Subtracting\n   * values twice resulting in inflow -> outflow and back to inflow seems not\n   * reasonable\"*). \"+\" says the other direction.\n   *\n   * Its presence is what ARMS the whole sign behaviour. A field with no direction\n   * control — an account's starting balance, a loan payment, a holding's cost —\n   * passes neither prop and keeps a text that is the whole truth, minus included.\n   */\n  onNegativeChange?: (negative: boolean) => void;\n  /**\n   * How the field presents itself ON A PHONE (Keksdose feedback #176).\n   *\n   * `\"field\"` (default) is the labelled, bordered input used everywhere else.\n   *\n   * `\"display\"` keeps every mechanic — the same `<input>`, the same numpad sheet,\n   * the same currency picker, the same commit/blur contract — and only drops the\n   * chrome: no border, no fill, no floating label, the figure set at display size.\n   * On a form whose whole point is one number, a bordered `text-sm` box draws the\n   * amount at the same weight as the memo beside it; this makes it the headline\n   * instead. It stays fully editable — the underline and the caret are what say so.\n   *\n   * Phone-only by construction: it keys off the same breakpoint as the numpad, so\n   * from `md` up the field is byte-for-byte the normal one and a desktop grid keeps\n   * its column rhythm.\n   */\n  variant?: \"field\" | \"display\";\n  /**\n   * Where the figure sits in its row, for `variant=\"display\"` only (Keksdose\n   * feedback #176 rework).\n   *\n   * `\"start\"` (default) keeps it flush left, in the reading column the fields\n   * below it share — and it is what the entry forms use, because a figure that\n   * starts at a known edge is legible at any width: when the value outgrows the\n   * field, the digits that scroll out of sight are the trailing ones, not the\n   * magnitude (Keksdose feedback #430 rework).\n   *\n   * `\"center\"` makes it a centred headline. It centres in the width that REMAINS\n   * after the trailing currency control, not in the whole box: the control is\n   * pinned to the right edge, so a plain `text-center` would centre the figure\n   * under it and the last digits would sit behind the chip. This used to mirror\n   * the control's reservation onto the left instead, which centred correctly but\n   * spent twice the control's width on padding — fatal on a 375px screen, where\n   * it left a 36px figure 16px to live in.\n   */\n  align?: \"start\" | \"center\";\n  /**\n   * Decimals the committed amount is rounded to (kastlan 0.12: \"12.345\" and a\n   * calculator's \"100/3\" reached a `Numeric(10,2)` column unrounded and failed with a\n   * 422). Default: the currency's minor unit, from `Intl` (CHF and EUR 2, JPY 0). With\n   * no `currency`, nothing is rounded unless this is set. Rounding is half away from\n   * zero (12.345 → 12.35, -12.345 → -12.35) and happens when the figure settles: on\n   * blur, on Enter, and on every result the calculator writes back. Keystrokes are left\n   * alone, so \"12.3\" can still become \"12.34\".\n   *\n   * ⚠️ **A unit price or a rate needs `digits`.** The default is right for an amount of\n   * money and silently wrong for a price per unit: a fund's NAV of 123.4567 or fuel at\n   * 1.789 €/l is stored as 123.46 / 1.79, and no test fails (keksdose G2, a\n   * `Numeric(18,6)` holding price and a `Numeric(18,4)` unit price). Pass the column's\n   * scale: `digits={4}`, `digits={6}`.\n   *\n   * **Set `digits` for any sub-currency scale** — not only a price: any field whose\n   * column holds more decimals than the currency's minor unit. A split line stored at\n   * the ledger's 4dp (`Numeric(18,4)`) and loaded as 12.3456 is SHOWN as 12.35, and\n   * committed as 12.35 as soon as the user tabs through it (blur settles) — so the form\n   * no longer equals what the server holds: the lines stop summing to the 4dp total,\n   * and Save is held (keksdose live #240). With a `currency`, every commit rounds to that currency's\n   * minor unit unless `digits` says otherwise: pass the column's scale (`digits={4}`).\n   */\n  digits?: number;\n  /** The smallest amount the field settles on. A lower figure is raised to it when it\n   *  settles, like `digits`. Compared with the signed figure. */\n  min?: number;\n  /** The largest amount the field settles on (a deposit release capped at the\n   *  balance). A higher figure is lowered to it when it settles. */\n  max?: number;\n  /**\n   * The SETTLED figure, dot-decimal, sign included — fired on blur, on Enter, on the\n   * numpad's \"=\" and on every result the calculator writes back, never on a keystroke\n   * (\"1200+\" is not a figure yet). `onChange` still reports every keystroke; this is\n   * for a host that stores a number and must not see drafts (kastlan 52; see\n   * {@link MoneyField}, which is built on it).\n   */\n  onCommit?: (value: string) => void;\n  /**\n   * Why the amount cannot be changed — {@link NumberInput}'s `disabledReason` (0.34,\n   * round 0.34 C2), for an amount that SAVES itself: a budget row's assigned cell, a\n   * price committed on blur. `disabled` takes the field out of the tab order, so the\n   * reason never reached a keyboard.\n   *\n   * With a reason the field stays in the tab order and shows its figure, `readOnly` (the\n   * settled grey FIELD_BASE gives a `[readonly]` field) and `aria-disabled`. Nothing\n   * changes the amount: the calculator and the phone's numpad are not offered, the\n   * currency chip is a read-out rather than a picker, and neither blur nor Enter\n   * settles — so `onChange`, `onCommit`, `onNegativeChange` and `onCurrencyChange` are\n   * never called. Enter is swallowed, so the field does not submit the form around it.\n   * The reason is a line under the field at Large and on a touch screen, else in the kit\n   * {@link Tooltip} (`disabledReasonDisplay`), and on the input's `aria-describedby`,\n   * between the caption and the error. Wins over `disabled`. {@link MoneyField} and\n   * `RhfMoneyField` take it too.\n   */\n  disabledReason?: ReactNode;\n  /**\n   * Where the reason shows — {@link Button}'s `disabledReasonDisplay`: by default a line\n   * under the field at Large and on a touch screen, the tooltip otherwise (§4 \"No fact\n   * only in a tooltip\"; DUP-3, refactor audit 2026-10).\n   */\n  disabledReasonDisplay?: DisabledReasonDisplay;\n  /**\n   * This amount COMMITS — {@link Button}'s `commit`, NumberInput's: under a locked\n   * {@link WriteLockProvider} it is locked the `disabledReason` way with the lock's reason\n   * (which wins over its own). An amount that only reaches the server through its form's\n   * Save leaves this off and stays editable under the lock; the Save takes `commit`. No\n   * provider, or an unlocked one: no effect.\n   */\n  commit?: CommitScope;\n  /** The `<input>`. A React 19 ref prop since 0.34 (MOD-4, refactor audit 2026-10); it\n   *  was `forwardRef`. */\n  ref?: Ref<HTMLInputElement>;\n}\n\n\n/**\n * A settled figure, rounded to `digits` (half away from zero) and clamped to\n * `min`/`max`. Only a plain number is touched. A half-typed draft or an expression\n * comes back as it was. Rounding is `lib/round.ts`'s, shared with `roundToCurrency`\n * (BUG-11: this copy blanked \"0.0000001\" and a 22-digit figure on blur).\n */\nfunction settleAmount(text: string, digits: number | undefined, min?: number, max?: number): string {\n  const t = text.trim();\n  if (!/^-?\\d*\\.?\\d*$/.test(t) || !/\\d/.test(t)) return text;\n  let n = Number(t);\n  if (!Number.isFinite(n)) return text;\n  if (digits !== undefined) n = roundHalfAway(n, digits);\n  if (min !== undefined && n < min) n = min;\n  if (max !== undefined && n > max) n = max;\n  const out = formatResult(n);\n  // Unchanged figures keep their own spelling (\"12.50\" stays \"12.50\").\n  return Number(out) === Number(t) ? text : out;\n}\n\n// The locale's decimal mark and the grouping parse (kastlan 40, keksdose G1) live in\n// `lib/decimal-marks.ts`, read through the engine NumberInput and this field share\n// (`numeric-field.ts`, DUP-10).\n\n// The consuming app's ONE money palette (`--money-expense` / `--money-income`),\n// not a bespoke rose/emerald pairing: a figure being typed has to wear the same\n// colour the same figure will wear once it is a row in the table behind the form\n// (Keksdose dev#434). The utilities are unlayered and theme-aware, so no `dark:`\n// variant is needed and they win over the field's own text colour regardless of\n// where `cn` puts them.\nconst TONE_CLASS: Record<\"neutral\" | \"outflow\" | \"inflow\", string> = {\n  neutral: \"\",\n  outflow: \"text-money-neg\",\n  inflow: \"text-money-pos\",\n};\n\n// The shared chrome-less treatment at money size. `tabular-nums` so digits don't\n// reflow the figure as they are typed; FIELD_DISPLAY's own muted placeholder\n// colour is what keeps an EMPTY form from painting its zero in the direction tint\n// (`tone` is computed from 0, which reads as an inflow).\nconst DISPLAY_INPUT_CLASS = cn(\n  FIELD_DISPLAY,\n  \"text-4xl font-semibold leading-tight tracking-tight tabular-nums\",\n);\n\n/**\n * Is `text` the ANSWER to `previous`, or something typed OVER it?\n *\n * \"The old text was a sum and the new one is bare\" cannot tell those apart, and both\n * gestures are ordinary: select-all-and-retype after a typo, or backspacing \"-20+\"\n * back down to a fresh figure. Read as an answer, they move the direction chip — so\n * an outflow of 7 quietly booked +7.00 (live #201 rework).\n *\n * The question that does separate them is arithmetic, not shape: evaluate what the\n * text replaced and see whether this IS that number. \"-12+30\" → \"18\" still is, so a\n * sum that comes out positive still takes the chip with it; \"-20+50\" → \"7\" is not,\n * and \"-20+\" evaluates to nothing at all.\n */\nfunction isResultOf(previous: string, text: string, settle: (text: string) => string): boolean {\n  const n = evaluateExpression(previous);\n  // Compared settled, since the field rounds what the calculator hands it.\n  return n !== null && settle(formatResult(n)) === text.trim();\n}\n\nexport function AmountInput(props: AmountInputProps) {\n  const { ref, value, onChange, currency, onCurrencyChange, placeholder, label, className, inputClassName, id, \"aria-label\": ariaLabel, \"aria-required\": ariaRequired, autoFocus, tone = \"neutral\", negative = false, onNegativeChange, align = \"start\", labels, currencyNames, currencyOptions, digits: digitsProp, min, max, onCommit, disabledReasonDisplay } = props;\n  const generatedId = useId();\n  const fieldId = id ?? generatedId;\n  // The sign is DISPLAYED, not stored (live #201 rework). `value` is the\n  // magnitude; the minus is glued on here and taken off again in handleText, so\n  // the two can never disagree and the caller can never double-apply it. Only in\n  // front of a bare amount: an expression being typed (\"12-30\") owns its own\n  // minus and has to survive keystroke-for-keystroke.\n  const signOwned = onNegativeChange !== undefined;\n  // The sign is DRAWN whenever `negative` says so, handler or not (keksdose live #366):\n  // a read-only or disabled total (\"−5.18\") used to need a dummy `onNegativeChange`\n  // just to show its minus. Without the handler there is nothing to toggle — a typed\n  // minus simply stays in the text, as in any field without a direction control.\n  const shown = negative && isBareAmount(value) ? `-${value}` : value;\n  // What the user SEES is `shown` with the locale's decimal mark (kastlan 40: a\n  // fr-CH user typed \"1,5\" and watched it turn into \"1.5\" under their fingers). Display only — `value`, `onChange`, the sign split and the settle all\n  // stay dot-decimal, because that string is the contract: RhfMoneyField's\n  // `parseAmount`, every app's `Number(value)` and the calculator's evaluator read\n  // it. The way back is free: {@link sanitizeLive} already folds a typed \",\" into\n  // \".\", so a comma typed, pasted or tapped on the numpad lands as a dot.\n  //\n  // One character for one character, and no digit grouping: the caret stays where\n  // the typist put it, and \"1.000\" cannot be read back as a thousand in one locale\n  // and as one in the other. de-CH and it-CH are \".\" — CLDR says so, and this\n  // follows `Intl` rather than a guess about a country. The field's own `locale`,\n  // else the provider's (0.34, DUP-10).\n  const locale = useKitLocale(props.locale);\n  // Decimals the figure settles to: `digits`, else the currency's minor unit.\n  const digits = digitsProp ?? currencyMinorDigits(currency);\n  const settle = (text: string) => settleAmount(text, digits, min, max);\n  // The engine NumberInput shares (DUP-10): the lock (focusable, `readOnly`, nothing\n  // changes or settles — see `disabledReason`), the hint — a FieldHint is its words at\n  // Large and on touch, §4 — the error, the description's order, the typist's draft\n  // in the locale's mark, the calculator and the numpad. On a phone the OS keyboard\n  // is suppressed for the numpad sheet (feedback #334), and the display shape keys off\n  // the SAME phone layout, so the two can never drift apart on the breakpoint.\n  //\n  // A value the HOST set (not one typed here) is shown at the currency's minor unit\n  // while the field is not being edited: an FX estimate of 93.4213 showed four\n  // decimals (keksdose live #356). Display only — `value` is the host's, untouched.\n  const numeric = useNumericField(props, {\n    settle,\n    display: (focused) => (focused ? shown : settleAmount(shown, digits)),\n  });\n  const { lock, locked, off, isMobile, asDisplay, showCalc, showNumpad, setFocused, mark, draft, setDraft, derived } =\n    numeric;\n  const invalid = numeric.isInvalid;\n  // A locked chip is a read-out: picking a currency is a change too.\n  const editable = !!onCurrencyChange && !locked;\n  // Room for the trailing controls — the calculator and the currency chip — once\n  // measured, as NumberInput reserves its own (keksdose live #367, DUP-10): their\n  // width, the track's `end-1` inset in the boxed shape, and NumberInput's 4px gap.\n  // Before that (the first paint, and wherever there is no layout) the classes below\n  // stand in. showCalc is always false on a phone, so the display shape only has to\n  // clear the chip, by its own width rather than the boxed shape's room (feedback #430\n  // rework: on a 375px screen 16px decide between a readable figure and a clipped one).\n  const hasEnd = showCalc || Boolean(currency);\n  const [endRef, endWidth] = useEndWidth(hasEnd);\n  const trailingRoom = asDisplay\n    ? currency ? (editable ? \"pe-16\" : \"pe-12\") : undefined\n    : showCalc\n      ? currency ? (editable ? \"pe-24\" : \"pe-16\") : \"pe-10\"\n      : currency ? (editable ? \"pe-20\" : \"pe-14\") : undefined;\n  const innerRef = useRef<HTMLInputElement>(null);\n  const setRefs = useMemo(() => mergeRefs(innerRef, ref), [ref]);\n  // While the typist is typing, the field shows THEIR text (\"1.234,5\" stays exactly\n  // that), not the value re-spelt: re-spelling turned a grouping \".\" into a \",\" under\n  // their fingers, after which no rule could tell the two apart (keksdose G1). The\n  // draft only while it says what the field holds AND holds nothing the live\n  // sanitising would drop — a letter, a second decimal point (see `showsTyped`); a\n  // value set from outside, a calculator result or a commit shows the derived spelling.\n  const display =\n    draft === null\n      ? derived\n      : (numeric.typedFor(shown) ??\n        // The caller owns the sign: the typed \"12\" is shown as the \"-12\" it is.\n        (signOwned && negative && shown.startsWith(\"-\") && numeric.typedFor(shown.slice(1)) !== null\n          ? `-${draft}`\n          : derived));\n  // Every route into the field — typing, the numpad sheet, the desktop\n  // calculator, the blur/Enter commit — funnels through here, so the split is\n  // written once and the four entry paths cannot drift.\n  //\n  // `previous` is the text this one REPLACES, and it is what says whether a bare\n  // figure arriving here is an answer or a magnitude. For the three paths that\n  // edit the field's own text that is simply what the field was showing; the\n  // desktop calculator keeps its expression in a popover the field never sees,\n  // so it passes it in (see `CalculatorButton`'s `onChange`).\n  const handleText = (raw: string, previous: string = shown) => {\n    const text = sanitizeLive(raw);\n    if (!signOwned) {\n      onChange(text);\n      return;\n    }\n    const { sign, rest } = splitLeadingSign(text);\n    if (sign) {\n      // SET, not flip: re-reporting the same sign on every keystroke is a no-op.\n      onNegativeChange(sign === \"-\");\n    } else if (looksLikeExpression(previous) && isBareAmount(text) && isResultOf(previous, text, settle)) {\n      // A calculation that just RESOLVED states its sign in both directions. The\n      // figure it ran on is the SIGNED one the user could see — \"-12+30\" is +18 —\n      // so a positive result has to move the chip too, or the field would answer\n      // that sum with \"-18\" and contradict the arithmetic it just showed.\n      //\n      // Only when it really resolved, though: see {@link isResultOf}. A bare figure\n      // arriving on top of an expression is far more often a replacement than an\n      // answer, and reading it as an answer flips the direction of money.\n      onNegativeChange(false);\n    }\n    onChange(sign ? rest : text);\n  };\n  const commit = () => {\n    setDraft(null);\n    const settled = settle(commitExpression(shown));\n    handleText(settled);\n    onCommit?.(settled);\n  };\n  const typed = (raw: string) => handleText(numeric.read(raw));\n  // The currency list is CurrencySelect's (round 0.34 Wave 2, DUP-4) on the picker\n  // family's core: the chip was a hand copy of it and had drifted (no wrap at Large, no\n  // `options` subset, no check mark, no listbox id, no #308 width), and both were plain\n  // buttons under a listbox promise. `filter: false`: the list filters its own rows.\n  const core = useComboboxCore<string>({ filter: false, backCloses: true });\n  // `chipRef`: the chip the currency list hangs off (Keksdose dev#548: portalled, so the\n  // panel needs a real trigger rect rather than a relative parent). It is also where\n  // Escape and a pick hand focus back (round 0.34 BUG-1): Safari does not focus a\n  // clicked button, so \"whatever held focus\" is not the chip.\n  const { open, setOpen, closeToTrigger, triggerRef: chipRef } = core;\n  const listboxId = `${generatedId}-currencies`;\n  // A lock arriving while the list is up closes it, as on CountrySelect — adjusted\n  // while rendering, so no frame shows a list that can no longer be used.\n  if (!editable && open) setOpen(false);\n\n  // The currency chip's strings are the `currency` namespace — the same two\n  // `CurrencySelect` resolves, under this component's older key names. The\n  // calculator and the numpad resolve `calculator` themselves; `labels.calculator`\n  // and `labels.pad` are handed straight through to them as overrides.\n  // The two strings read out first, so the memo depends on them and not on the\n  // caller's `labels` object (a new one every render) — what the React Compiler infers.\n  const currencyLabel = labels?.currency;\n  const currencySearchLabel = labels?.currencySearch;\n  const currencyOverrides = useMemo(() => {\n    const out: Partial<CurrencyLabels> = {};\n    if (currencyLabel !== undefined) out.currency = currencyLabel;\n    if (currencySearchLabel !== undefined) out.search = currencySearchLabel;\n    return out;\n  }, [currencyLabel, currencySearchLabel]);\n  const currencyText = useKitLabels(\"currency\", DEFAULT_CURRENCY_LABELS, currencyOverrides);\n  const common = useKitLabels(\"common\", DEFAULT_COMMON_LABELS);\n\n  const selected = getCurrency(currency);\n\n  return (\n    <div className={cn(\"w-full\", className)}>\n      {/* Inner relative box holds the input + its absolutely-positioned\n          trailing controls (calculator / currency), so those stay anchored to\n          the INPUT even when the mobile math bar is rendered below (#334). It is\n          the kit's FloatingField, which draws the label — floating, or sr-only in\n          the display shape — and puts a FieldHint on the label's line, as it does\n          for NumberInput. */}\n      {/* Locked, the field sits in the reason's frame (LockedReason: the line, or the\n          Tooltip), as NumberInput does; the root above keeps `className`, so nothing\n          reflows. */}\n      <LockedOrNot lock={lock} display={disabledReasonDisplay}>\n      <FloatingField\n        className=\"w-full\"\n        htmlFor={fieldId}\n        label={label}\n        srOnlyLabel={asDisplay}\n        hint={numeric.hint.labelHint}\n      >\n      <input\n        ref={setRefs}\n        id={fieldId}\n        aria-label={ariaLabel}\n        type=\"text\"\n        // eslint-disable-next-line jsx-a11y/no-autofocus -- opt-in per call site (feedback #70)\n        autoFocus={autoFocus}\n        // On mobile suppress the OS keyboard so our numpad sheet owns entry; the\n        // field keeps focus/caret. Desktop keeps the native decimal keypad.\n        inputMode={isMobile ? \"none\" : \"decimal\"}\n        autoComplete=\"off\"\n        disabled={off}\n        // Locked: focusable, `readOnly`, `aria-disabled` — see `disabledReason`.\n        readOnly={locked || undefined}\n        aria-disabled={locked || undefined}\n        // The floating-label pattern needs a blank placeholder for its\n        // peer-placeholder-shown trick. The display shape has no floating label,\n        // so it spends the placeholder on what an empty borderless form actually\n        // needs: a zero to aim at, at full size. The caller supplies it because\n        // only the app knows the locale's decimal separator.\n        placeholder={asDisplay ? (placeholder ?? \"0\") : label !== undefined ? \" \" : placeholder}\n        value={display}\n        onChange={(e) => {\n          if (!locked) typed(e.target.value);\n        }}\n        onFocus={() => setFocused(true)}\n        onBlur={() => {\n          // Nothing settles under the lock — not even a draft typed before it arrived,\n          // which stays in the field for when it lifts.\n          if (!locked) commit();\n          setFocused(false);\n        }}\n        onKeyDown={(e) => {\n          if (e.key !== \"Enter\") return;\n          // Locked: Enter submits no form and settles nothing.\n          if (locked) e.preventDefault();\n          else commit();\n        }}\n        className={cn(\n          // With a label, use the floating-input padding (pt-4 pb-1) like every\n          // other labelled field so the value sits BELOW the floated label rather\n          // than vertically centred where it overlaps the resting label\n          // (feedback #314). FLOATING_INPUT_CLASS already bundles the peer +\n          // transparent-placeholder bits.\n          asDisplay ? DISPLAY_INPUT_CLASS : label !== undefined ? FLOATING_INPUT_CLASS : FIELD_BASE,\n          // The plain end padding, with nothing trailing: cosmetic, so the caller's\n          // to change (keksdose 0.24 — a symmetric `px-2` in a budget cell).\n          !trailingRoom && (asDisplay ? \"pe-0\" : \"pe-3\"),\n          // Centred display shape: centre in what is LEFT of the currency chip.\n          // `text-center` alone would centre the figure in the whole box, i.e.\n          // partly underneath the chip; the padding below is what takes the chip\n          // out of the centring, and nothing is added at the start because a\n          // mirrored reservation would spend the width twice (see `align`).\n          asDisplay && align === \"center\" && \"text-center\",\n          // Over the base class's own text colour.\n          TONE_CLASS[tone],\n          // The caller's, over all of the above — base, plain padding, alignment and\n          // tone — and under only what the field needs to work (see `inputClassName`).\n          inputClassName,\n          // Room for the trailing controls, after the caller's so a `px-2` cannot run\n          // the digits under the chip (NumberInput's order, which reserves its unit\n          // and calculator the same way).\n          trailingRoom,\n          invalid && FIELD_INVALID,\n          locked && \"cursor-not-allowed\",\n        )}\n        // The classes above are the fallback; once measured the field reserves exactly\n        // its trailing controls' width, inline so it wins over every class (see\n        // `trailingRoom`).\n        style={hasEnd && endWidth != null ? { paddingInlineEnd: endWidth + (asDisplay ? 4 : 8) } : undefined}\n        aria-invalid={invalid || undefined}\n        aria-describedby={numeric.describedBy}\n        aria-required={ariaRequired}\n      />\n      {/* The label is FloatingField's, after these children (the floating trick\n          reads the input through `peer-*`). The display shape drops it VISUALLY,\n          not from the accessibility tree: a 36px tinted figure at the top of a\n          transaction form is legibly the amount, but a screen reader still needs\n          the name, and callers that pass `label` without `aria-label` would\n          otherwise be left with none. */}\n      {/* Trailing controls share one flex track so the calculator icon and the\n          currency suffix/picker sit side by side without overlapping. */}\n      {/* The display shape has no box to inset from, so the controls align to the\n          figure's own end edge and its baseline strip (`bottom-1`, matching the\n          input's pb-1) instead of floating inside a field. */}\n      <div\n        // Measured for the input's end padding (see `trailingRoom`).\n        ref={endRef}\n        className={cn(\n          \"absolute flex items-center gap-0.5\",\n          // Logical `end-*`: the chip and the calculator are the figure's trailing\n          // controls, so a right-to-left form carries them on the left.\n          asDisplay ? \"bottom-1 end-0\" : \"inset-y-1 end-1\",\n        )}\n      >\n        {showCalc && (\n          <CalculatorButton\n            // The mark the field shows but not the typist's grouping: the evaluator\n            // reads either mark, and \"1.234,5\" is two of them. The result comes back\n            // dot-decimal.\n            value={derived}\n            onChange={(result, expression) => {\n              setDraft(null);\n              const settled = settle(result);\n              handleText(settled, expression);\n              onCommit?.(settled);\n            }}\n            className=\"px-1.5\"\n            aria-label={labels?.calculatorTrigger}\n            labels={labels?.calculator}\n          />\n        )}\n        {currency && !editable && (\n          <span\n            aria-hidden\n            className={cn(\n              \"pointer-events-none px-1 font-medium text-muted\",\n              // A text-xs chip next to a 36px figure reads as a stray footnote.\n              asDisplay ? \"text-sm\" : \"text-xs\",\n            )}\n          >\n            {currency}\n          </span>\n        )}\n        {currency && editable && (\n          <button\n            ref={chipRef}\n            type=\"button\"\n            onClick={() => setOpen((v) => !v)}\n            // A button that opens a listbox, and says so: the chip is a control inside\n            // a text field, not a field of its own, so not a combobox.\n            aria-haspopup=\"listbox\"\n            aria-expanded={open}\n            aria-controls={listboxId}\n            aria-label={\n              // \"Currency: EUR\" through `common.fieldValue`, not a template literal:\n              // the colon-and-space is punctuation a translation has to own.\n              selected ? common.fieldValue(currencyText.currency, selected.code) : currencyText.currency\n            }\n            className={cn(\n              \"flex items-center gap-1 rounded px-2 py-1 font-medium text-secondary hover:bg-hover\",\n              asDisplay ? \"text-sm\" : \"text-xs\",\n            )}\n          >\n            {currency}\n            <ChevronDown className=\"size-3\" />\n          </button>\n        )}\n      </div>\n      {editable && (\n        <CurrencyOptionList\n          core={core}\n          listboxId={listboxId}\n          value={currency}\n          codes={currencyOptions}\n          currencyNames={currencyNames}\n          locale={locale}\n          searchPlaceholder={currencyText.search}\n          // The phone sheet's title: what the chip is for.\n          sheetTitle={currencyText.currency}\n          onChoose={(code) => {\n            onCurrencyChange?.(code);\n            closeToTrigger();\n          }}\n        />\n      )}\n      </FloatingField>\n      </LockedOrNot>\n      {/* Outside the relative box, as NumberInput's caption is: the trailing\n          controls are `inset-y-1` in it and would stretch down over a second line. */}\n      <FieldCaption parts={numeric.hint} />\n      {/* The news after the standing advice, as Select orders them. The root is\n          already a steady box, so the message coming and going remounts nothing. */}\n      {numeric.errorEl}\n      {showNumpad && (\n        <NumberPadSheet\n          // Localised like the field it mirrors. Keys are typing, read by the\n          // locale's marks like the keyboard's; \"=\" is a result, dot-decimal.\n          value={display}\n          onChange={typed}\n          onResult={(result) => {\n            setDraft(null);\n            const settled = settle(result);\n            handleText(settled);\n            onCommit?.(settled);\n          }}\n          onDone={() => innerRef.current?.blur()}\n          label={label}\n          labels={labels?.pad}\n          decimalMark={mark}\n        />\n      )}\n    </div>\n  );\n}\n\n/** The field in its lock's {@link LockedReason} while locked, as it is otherwise. A\n *  component rather than a ternary so the field's JSX is written once. `block w-full`:\n *  the frame's box stands where the field's own did. */\nfunction LockedOrNot({\n  lock,\n  display,\n  children,\n}: {\n  lock: LockReason;\n  display: DisabledReasonDisplay | undefined;\n  children: ReactNode;\n}) {\n  if (!lock.locked) return <>{children}</>;\n  return (\n    <LockedReason lock={lock} display={display} className=\"block w-full\">\n      {children}\n    </LockedReason>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/components/autocomplete.d.ts

@@ -1,13 +1,13 @@
 import type { ComponentPropsWithoutRef, ReactNode, Ref } from "react";
 import { type ComboOption } from "./combobox-core.js";
-import { type DisabledReasonDisplay } from "./field-parts.js";
+import { type DisabledReasonDisplay, type FieldHelpProps } from "./field-parts.js";
 import type { CommitScope } from "./write-lock.js";
 /**
  * `value`/`onChange` are the TEXT's, and `onSelect` is "a suggestion was taken" —
  * not the DOM's text-selection event — so the input's own spellings of those three
  * are omitted. Everything else reaches the `<input>`, the way it does on {@link Input}.
  */
-export interface AutocompleteProps<V extends string | number = string> extends Omit<ComponentPropsWithoutRef<"input">, "value" | "defaultValue" | "onChange" | "onSelect" | "children" | "type" | "size"> {
+export interface AutocompleteProps<V extends string | number = string> extends Omit<ComponentPropsWithoutRef<"input">, "value" | "defaultValue" | "onChange" | "onSelect" | "children" | "type" | "size">, FieldHelpProps {
     /** What is in the field. Controlled, and never reset by the component: opening,
      *  closing and a failed lookup all leave it exactly as typed. */
     value: string;

package/dist/components/autocomplete.js

@@ -50,6 +50,7 @@ function Autocomplete(props) {
     invalid,
     error,
     hint,
+    help,
     status,
     emptyLabel,
     loadErrorLabel,
@@ -81,7 +82,7 @@ function Autocomplete(props) {
     noResults: emptyLabel,
     loadError: loadErrorLabel
   });
-  const hintParts = useFieldHint(hint, ariaDescribedBy);
+  const hintParts = useFieldHint(hint, ariaDescribedBy, { help, name: label ?? ariaLabel });
   const field = useFieldError(error, invalid, hintParts.describedBy, rest["aria-invalid"]);
   const [ownOpen, setOwnOpen] = useState(false);
   const open = openProp ?? ownOpen;