@eifi1/ui-kit 0.54.0 → 0.55.0

package/src/components/number-input.tsx

@@ -1,559 +0,0 @@
-import { useEffect, useId, useMemo, useRef } from "react";
-import type { KeyboardEvent, ReactNode, Ref } from "react";
-import { CalculatorButton, type CalculatorButtonLabels } from "./calculator";
-import { NumberPadSheet, type NumberPadSheetLabels } from "./numpad-sheet";
-import { FIELD_BASE, FIELD_DISPLAY, FIELD_INVALID, FLOATING_INPUT_CLASS, FloatingField } from "./field-base";
-// The data alone (0.35): not the picker, which this field does not render.
-import { CURRENCIES } from "../currencies";
-import { FieldCaption, LockedReason, mergeRefs, type DisabledReasonDisplay, type FieldHelpProps } from "./field-parts";
-import { useEndWidth, useNumericField } from "./numeric-field";
-import type { CommitScope } from "./write-lock";
-import { cn } from "../lib/cn";
-import { commitExpression, formatResult } from "../lib/calc";
-import { dataAttributes, type DataAttributes } from "../lib/data-attributes";
-
-/** {@link NumberInput}'s props — exported since 0.34 (refactor audit 2026-10, API-9): a
- *  wrapper typed itself off `ComponentProps<typeof NumberInput>` until then. */
-export interface NumberInputProps extends FieldHelpProps, DataAttributes {
-  /** The text, DOT-decimal ("1234.5", or a calculation being typed: "12+5"), as
-   *  `onChange` reports it — so a caller's `Number(value)` reads it. The field SHOWS it
-   *  in the locale's mark (see `locale`). A comma here is read as the decimal mark too,
-   *  never as grouping. */
-  value: string;
-  /** Fired on every keystroke with the text as a number reads it: grouping marks read
-   *  off ("1.234,56" → "1234.56" for a German typist, keksdose K5), the decimal mark
-   *  folded to a dot, operators kept so a typed expression survives. */
-  onChange: (value: string) => void;
-  /** Fired on blur/Enter with the *evaluated* value — use this for save-on-blur
-   * fields so the save always sees the resolved number, never "10+5". And once per
-   * calculator session — its "=", or closing it on a result not committed yet — never
-   * per calculator keystroke (refactor audit 2026-10-30, INP-1: a result used to reach
-   * `onChange` only, and the host kept the number from before the calculation). */
-  onCommit?: (value: string) => void;
-  label?: ReactNode;
-  /** Names the field when it has no visible `label` (a table cell, a phone's display
-   *  shape). */
-  "aria-label"?: string;
-  /** Names for the calculator this field renders — its trigger, and the controls
-   *  inside the popover — and for the numpad sheet it opens on a phone. Overrides
-   *  for THIS field only: both resolve the `calculator` namespace of
-   *  `<UiKitProvider labels>` themselves, then fall back to English.
-   *
-   *  `pad` is not optional plumbing: this field renders a {@link NumberPadSheet}
-   *  exactly as {@link AmountInput} does, but had no way to pass it anything, so
-   *  the SAME keypad announced itself in German when a money field opened it and in
-   *  English when a goal target did. */
-  labels?: {
-    calculatorTrigger?: string;
-    calculator?: CalculatorButtonLabels;
-    pad?: NumberPadSheetLabels;
-  };
-  placeholder?: string;
-  disabled?: boolean;
-  autoFocus?: boolean;
-  /** Wrapper class. */
-  className?: string;
-  /** Overrides the input's own styling (merged after the field base). */
-  inputClassName?: string;
-  id?: string;
-  /** Show the calculator-popover trigger (default true). Set false for fields in
-   * an ephemeral close-on-blur editor, where clicking the icon would blur away
-   * and tear the editor down before the popover could open — inline typing
-   * (e.g. "200+50" → Enter) still evaluates there. */
-  calculator?: boolean;
-  /** {@link FIELD_DISPLAY} — on a phone, the figure at display size with the field
-   *  chrome dropped. The currency-free half of the same treatment `AmountInput`
-   *  carries, for a dialog whose whole point is the one number (a budget goal's
-   *  target); not for a field among many, and never for the compact inline
-   *  editors this control also serves. */
-  variant?: "field" | "display";
-  /** A {@link FieldHint} "?" on the label's own line, beside the label rather
-   *  than at the far end of the strip — the far end is where the calculator
-   *  lives, and a hint placed there landed on top of it (steering-design
-   *  feedback #48). Plain TEXT (a string or a number) is a caption instead, UNDER
-   *  the field and attached through `aria-describedby` after the caller's own —
-   *  the same rule as {@link Select}'s `hint`: the label line has no room for a
-   *  sentence, and one placed there ran over the label and into the value.
-   *  Since 0.32 a FieldHint is that caption too at Large and on a touch screen,
-   *  where a "?" cannot be hovered open (`useInlineHint`). */
-  hint?: ReactNode;
-  /** Required and unanswered — {@link FIELD_INVALID}. See {@link Input}'s `invalid`. */
-  invalid?: boolean;
-  /**
-   * What is wrong with the value, in the caller's own words — {@link Input}'s `error`,
-   * the same anatomy (keksdose K5/K4: of the kit's fields only `Input` and
-   * `NumberField` had one, so a goal target or a rate field wrote its message as a
-   * loose `<p>` that nothing pointed at). Rendered under the field, after a text
-   * `hint`; merged into `aria-describedby` after the caller's ids and the hint's; and
-   * it implies `invalid`, so the field paints as well as announces. `null`, `false`
-   * and `""` — a `touched && errors.x` on the happy path — are no message.
-   *
-   * Passing the key at all (even `undefined`) keeps the field in a steady wrapper,
-   * message or not, so the message coming and going never remounts the `<input>` and
-   * takes the caret with it — see `Input`'s `FieldGroup`. A field that never passes
-   * `error` renders exactly the DOM it did before the prop existed.
-   */
-  error?: ReactNode;
-  /**
-   * BCP 47 tag that decides the decimal mark the field SHOWS; default the
-   * `<UiKitProvider locale>`, else the runtime's (keksdose K5). A French or Italian
-   * reader sees "3,5", a German one too, de-CH and en-US see "3.5" — `Intl`
-   * decides, not a guess about a country. Display only: `value` and `onChange` stay
-   * dot-decimal. {@link NumberField} passes its own `locale` through here.
-   */
-  locale?: string;
-  /**
-   * Set on the `<input>`, with `id` above. Declared so `Field`'s render-prop spread —
-   * `{(ids) => <NumberInput {...ids} … />}` — is typed and reaches the input: the hint
-   * and error are described, a required number is announced as required, and
-   * `aria-invalid` paints {@link FIELD_INVALID} the way `invalid` does.
-   */
-  "aria-describedby"?: string;
-  "aria-invalid"?: boolean | "true" | "false";
-  "aria-required"?: boolean | "true" | "false";
-  /**
-   * A static unit shown at the field's right edge — "%", "kg", "km/h".
-   *
-   * The read-out half of {@link AmountInput}'s currency chip, and it exists for the
-   * same reason that one does: a unit belongs to the FIELD, not to the text, so
-   * typing it is a way to get it into the value. Keksdose had a percentage spelled
-   * three different ways across three screens — `<Input type="number" step="0.01">`
-   * for a loan rate, `step="0.1"` for a tax rate, `inputMode="decimal"` for a VAT
-   * rate — and none of the three showed a "%" anywhere near the box, so what the
-   * digits meant was a question the label alone had to answer.
-   *
-   * `aria-hidden`, like the currency read-out: it is a property of the field that
-   * the label already names ("Interest rate (%)"), and announcing it again after
-   * every value reads as part of the number.
-   */
-  suffix?: ReactNode;
-  /**
-   * Turns on the step keys: ArrowUp / ArrowDown add or subtract `step`, PageUp /
-   * PageDown ten of them. The result lands on the grid `min + k × step` (or `0 + k ×
-   * step` without a `min`), so 3.1 with `step={0.25}` goes up to 3.25, not 3.35 —
-   * what a native number input does. Decimal-exact: `0.1 + 0.2` steps to "0.3".
-   *
-   * A step changes the text through `onChange` like a keystroke would; `onCommit`
-   * still fires on blur/Enter. Without `step` the arrow keys move the caret as before.
-   */
-  step?: number;
-  /** Bounds for the step keys only — a step never leaves `[min, max]`. This field's
-   *  value is a STRING, so typed text is not clamped: {@link NumberField} is the
-   *  numeric field that clamps what is typed as well. */
-  min?: number;
-  max?: number;
-  /**
-   * Why the value cannot be changed — {@link Button}'s `disabledReason`, for a number
-   * that SAVES itself: a setting committed on blur, a figure in a row editor
-   * (Kurvenschmiede's session page, 0.33.1). `disabled` takes the field out of the tab
-   * order, so the reason never reached a keyboard, and Kurvenschmiede wrote its own
-   * `CommitInput` to keep it in.
-   *
-   * With a reason the field stays in the tab order and shows its value, `readOnly` (the
-   * settled grey FIELD_BASE gives a `[readonly]` field) and `aria-disabled`, as the
-   * Combobox family's lock is. Nothing changes the value: the step keys do nothing, the
-   * calculator and the phone's numpad are not offered, and neither blur nor Enter
-   * commits — so `onChange` and `onCommit` are never called. Enter is swallowed, so the
-   * field does not submit the form around it. The reason is a line under the field at
-   * Large and on a touch screen, else in the kit {@link Tooltip} (`disabledReasonDisplay`),
-   * and on the input's `aria-describedby`, between the caption and the error. Wins over
-   * `disabled`.
-   */
-  disabledReason?: ReactNode;
-  /**
-   * Where the reason shows — {@link Button}'s `disabledReasonDisplay`: by default a line
-   * under the field at Large and on a touch screen, the tooltip otherwise (§4 "No fact
-   * only in a tooltip"; DUP-3, refactor audit 2026-10).
-   */
-  disabledReasonDisplay?: DisabledReasonDisplay;
-  /**
-   * This field COMMITS — {@link Button}'s `commit`: under a locked
-   * {@link WriteLockProvider} it is locked the `disabledReason` way with the lock's reason
-   * (which wins over its own). A field whose value only reaches the server through the
-   * form's Save leaves this off and stays editable under the lock; the Save takes
-   * `commit`. No provider, or an unlocked one: no effect. {@link NumberField} and
-   * {@link IntegerField} pass it on.
-   */
-  commit?: CommitScope;
-  /**
-   * The `<input>`, as a React 19 ref prop (0.34, API-3, refactor audit 2026-10): the one
-   * focusable field of its family with no ref at all, so react-hook-form's focus-on-error
-   * could reach it only through /rhf's id lookup, and an app not at all.
-   * {@link NumberField} and {@link IntegerField} pass it on.
-   */
-  ref?: Ref<HTMLInputElement>;
-}
-
-/** Decimal places of `n` as written ("0.25" → 2, "1e-7" → 7), for decimal-exact
- *  stepping. */
-function decimalsOf(n: number): number {
-  const text = formatResult(n);
-  const dot = text.indexOf(".");
-  return dot === -1 ? 0 : text.length - dot - 1;
-}
-
-/**
- * `current` moved by `count` steps (negative = down), on the grid `origin + k × step`
- * and clamped into `[min, max]`. An off-grid value moves to the NEXT grid point in
- * that direction first, so one press is never more than one step.
- *
- * The grid index is found by division and the result rebuilt as `origin + k × step`,
- * then cut to the decimals `step` and `origin` are written with — which is where
- * binary noise goes: `0.1 × 3` is 0.30000000000000004, and `toFixed(1)` of it is
- * "0.3". Summing steps would accumulate that noise press by press instead.
- */
-export function stepNumber(current: number | null, count: number, step: number, min?: number, max?: number): number {
-  const clamp = (n: number) => Math.min(max ?? Infinity, Math.max(min ?? -Infinity, n));
-  // Nothing to step from: land on the value nearest zero the bounds allow, rather
-  // than on ±step — a room count with `min={1}` goes to 1, a rate to 0.
-  if (current === null || !Number.isFinite(current)) return clamp(0);
-  const origin = min !== undefined && Number.isFinite(min) ? min : 0;
-  const raw = (current - origin) / step;
-  const nearest = Math.round(raw);
-  // "On the grid" within float tolerance: (0.3 - 0) / 0.1 is 2.9999999999999996.
-  const onGrid = Math.abs(raw - nearest) < 1e-9;
-  const k = onGrid ? nearest + count : count > 0 ? Math.ceil(raw) + count - 1 : Math.floor(raw) + count + 1;
-  const places = Math.min(Math.max(decimalsOf(step), decimalsOf(origin)), 20);
-  return clamp(Number((origin + k * step).toFixed(places)));
-}
-
-/** NumberInput never rounds: what was typed (or calculated) is what it reports. */
-const asTyped = (text: string) => text;
-
-// ── The money guard (kastlan 5, Kurvenschmiede) ─────────────────────────────────
-
-// The codes the kit's own currency pickers know, as whole words: "Amount (CHF)",
-// "EUR", "Kosten CHF". A `retired` one too (BGN): a label that names it is still money,
-// whatever the pickers offer. Not every ISO 4217 code — "ALL", "TOP" and "PEN" are codes
-// too, and an upper-case label would trip on them.
-const CURRENCY_CODE = new RegExp(`(?:^|[^A-Za-z])(?:${CURRENCIES.map((c) => c.code).join("|")})(?![A-Za-z])`);
-// Symbols no unit of measure is written with. Not "kr", "R" or "Fr": those are words
-// and units as often as they are money.
-const CURRENCY_SYMBOL = /[€$£¥₹₺₽₪₩₫฿₴₦₱]/;
-
-/** Text that names a currency and no unit to go with it. A slash makes it a rate or
- *  a unit price ("CHF/m²", "€/kWh") — a figure whose decimals are its column's
- *  business, not the currency's — and that is not what the guard is for. */
-function namesMoney(node: ReactNode): boolean {
-  if (typeof node !== "string" && typeof node !== "number") return false;
-  const text = String(node);
-  return (CURRENCY_CODE.test(text) || CURRENCY_SYMBOL.test(text)) && !text.includes("/") && !text.includes("%");
-}
-
-/**
- * Is this field being used for MONEY? A currency in the unit (`suffix="CHF"`), or in
- * the label, `aria-label` or placeholder of a field with no unit at all ("Estimated
- * cost (CHF)"). Any other suffix is a unit — "%", "mm", "N·m" — and says what the
- * digits are, whatever the label says. `digits` plays no part: NumberInput has none,
- * and Kurvenschmiede's engineering fields at 2 and 3 decimals are exactly what this
- * must stay quiet about.
- */
-function looksLikeMoney(suffix: ReactNode, texts: ReactNode[]): boolean {
-  if (suffix !== undefined && suffix !== null && suffix !== "") return namesMoney(suffix);
-  return texts.some(namesMoney);
-}
-
-/**
- * The kit's dev switch, as `lib/logger.ts` reads it: a development build, never a
- * production one — the consumer's bundler replaces `import.meta.env.DEV` with `false`
- * there, and this branch is dead code — and never under vitest, where every consumer
- * suite would print it once per render of every field it has not migrated yet. Read
- * per call rather than once per module, so a test can switch it on with `vi.stubEnv`.
- * Optional-chained: `import.meta.env` is a Vite injection, absent under plain Node.
- */
-function devWarnings(): boolean {
-  return Boolean(import.meta.env?.DEV) && !import.meta.env?.VITEST;
-}
-
-/**
- * A numeric text field with a built-in calculator: type a calculation straight
- * in (e.g. "12+5", evaluated on blur/Enter) or click the trailing calculator
- * icon for a keypad. String `value`/`onChange` contract, mirroring
- * {@link AmountInput} — the currency-free counterpart for quantities, rates,
- * percentages and measurements.
- *
- * NOT FOR MONEY. This field never rounds: "12.345", or a calculator's "100/3", is
- * reported exactly as typed. kastlan's journal lines, a payment allocation and a
- * defect's estimated cost were NumberInputs, and a 3-decimal amount reached a
- * 2-decimal Money column and failed the save with a 422 — in one wizard after the
- * record before it had already been created (kastlan 5). Money goes in
- * {@link AmountInput} (string value, like this one) or {@link MoneyField} (number
- * value): both settle to the currency's minor unit on blur, Enter and every calculator
- * result, and take `digits` for a unit price at a finer scale. In development a
- * NumberInput that looks like money — a currency as its unit, or a currency in the
- * label of a field with no unit — says so on the console, once per field. A unit of
- * measure ("mm", "N·m", "%") keeps it quiet, as does any number of decimals.
- *
- * THE LOCALE'S MARK (keksdose K5). The field shows the `locale`'s decimal mark — "3,5"
- * to a French, Italian or German reader — and reads what is typed the way
- * {@link AmountInput} does (keksdose G1): "1.234,56" from a German typist is 1234.56,
- * "1,234.56" from an English one too, and a lone mark that cannot be grouping is the
- * decimal, whichever key typed it. Before, it always showed "3.5" and folded
- * "1.234,56" into 1.23456. `value` and `onChange` stay dot-decimal, which is the
- * contract every caller's `Number(value)` reads.
- *
- * While a figure is being typed the field shows the typist's OWN text — "1.234,5"
- * stays exactly that — rather than the value re-spelt: re-spelling turned a grouping
- * "." into a "," under their fingers, after which no rule could tell the two apart, and
- * a text that changes length under the caret moves it to the end. It is re-spelt in the
- * locale's mark, without grouping, once the figure settles (blur, Enter, a step or a
- * calculator result) or when the value changes from outside.
- */
-export function NumberInput(props: NumberInputProps) {
-  const {
-    ref,
-    value,
-    onChange,
-    onCommit,
-    label,
-    "aria-label": ariaLabel,
-    labels,
-    placeholder,
-    autoFocus,
-    className,
-    inputClassName,
-    id,
-    "aria-required": ariaRequired,
-    suffix,
-    step,
-    min,
-    max,
-    disabledReasonDisplay,
-  } = props;
-  const generatedId = useId();
-  const fieldId = id ?? generatedId;
-  // The engine AmountInput shares (DUP-10): the lock (focusable, `readOnly`, nothing
-  // changes or commits — see `disabledReason`), the hint — a FieldHint is its words at
-  // Large and on touch, §4 — the error, the description's order, the typist's draft and
-  // the locale's mark (see the component's note), the calculator and the numpad.
-  // NumberInput never rounds; it shows the value as it is.
-  const numeric = useNumericField(props, { settle: asTyped, display: () => value });
-  const { lock, locked, off, isMobile, asDisplay, showCalc, showNumpad, setFocused, mark, setDraft, derived } = numeric;
-  const invalid = numeric.isInvalid;
-  // Passed at all — even as `undefined` — the field keeps its box; see `error`.
-  const reserve = "error" in props || "hint" in props;
-  const labelled = label !== undefined;
-  // The unit and the calculator's measured width, reserved as the field's end padding.
-  const hasEnd = showCalc || suffix !== undefined;
-  const [endRef, endWidth] = useEndWidth(hasEnd);
-  // Before the first measurement (and wherever there is no layout), a TEXT unit
-  // reserves an estimate from its length — one `ch` a character, in the input's own
-  // (larger) font, so it errs wide — plus the span's `pe-2` and the 4px gap, and the
-  // calculator's 36px. The class fallback's flat pe-8 gave a "%" 32px for a frame and
-  // "km/h" too little.
-  const suffixChars = typeof suffix === "string" || typeof suffix === "number" ? String(suffix).length : null;
-  const estimatedEnd =
-    suffixChars !== null ? `calc(${suffixChars}ch + 0.75rem${showCalc ? " + 2.25rem" : ""})` : undefined;
-  // On mobile, focusing opens the numpad bottom sheet instead of the native
-  // keyboard (#334); the ref lets its "Done" blur → commit + close. The caller's `ref`
-  // gets the same element.
-  const inputRef = useRef<HTMLInputElement>(null);
-  const setInput = useMemo(() => mergeRefs(inputRef, ref), [ref]);
-
-  // `derived` is the value in the locale's mark — one character for one, no grouping —
-  // and the draft the typist's own text, shown only while it still says what the value
-  // says (see `showsTyped`).
-  const display = numeric.typedFor(value) ?? derived;
-
-  // A keystroke, a paste or a numpad key: the typist's text is kept, the value is what
-  // a number reads it as.
-  const typed = (raw: string) => onChange(numeric.read(raw));
-  // A RESULT — the calculator's, the numpad's "=" — is dot-decimal already. It does not
-  // go through `typed`: "1.234" out of `100/81.03…` is never a thousand.
-  const result = (next: string) => {
-    setDraft(null);
-    onChange(next);
-  };
-
-  // The money guard: once per field, development only. See `looksLikeMoney`.
-  const warnedMoney = useRef(false);
-  useEffect(() => {
-    if (warnedMoney.current || !devWarnings()) return;
-    if (!looksLikeMoney(suffix, [label, ariaLabel, placeholder])) return;
-    warnedMoney.current = true;
-    const name = [label, ariaLabel, suffix].find((t) => typeof t === "string" || typeof t === "number");
-    console.warn(
-      `[ui-kit] NumberInput${name === undefined ? "" : ` "${String(name)}"`} looks like a money field: a ` +
-        `currency, and no unit. NumberInput never rounds, so "12.345" or a calculator's "100/3" is sent with ` +
-        `three or more decimals (kastlan 5: a 422 from a 2-decimal Money column). Use AmountInput (string ` +
-        `value) or MoneyField (number value) — both settle to the currency's minor unit. ` +
-        `(Development builds only; once per field.)`,
-    );
-  }, [suffix, label, ariaLabel, placeholder]);
-
-  // `text`: the calculator commits its session's result (INP-1), which on its "=" can be
-  // newer than this render's `value` — `onChange` was handed it in the same event.
-  const commit = (text: string = value) => {
-    setDraft(null);
-    const next = numeric.settle(commitExpression(text));
-    if (next !== value) onChange(next);
-    onCommit?.(next);
-  };
-
-  const stepBy = (count: number) => {
-    setDraft(null);
-    // The step starts from the text as a commit would read it, so "12+5" steps from 17.
-    const resolved = commitExpression(value).trim();
-    const n = resolved === "" ? NaN : Number(resolved);
-    const next = formatResult(stepNumber(Number.isFinite(n) ? n : null, count, step as number, min, max));
-    if (next !== value) onChange(next);
-  };
-
-  const onKeyDown = (e: KeyboardEvent<HTMLInputElement>) => {
-    // Locked: Enter submits no form and commits nothing, and no key steps the value.
-    // The arrows and Home/End stay the caret's, for a long value someone is reading.
-    if (locked) {
-      if (e.key === "Enter") e.preventDefault();
-      return;
-    }
-    if (e.key === "Enter") return commit();
-    // A zero, negative or non-finite step is no step: the keys stay the caret's.
-    if (!step || !(step > 0) || !Number.isFinite(step) || e.altKey || e.ctrlKey || e.metaKey) return;
-    const count =
-      e.key === "ArrowUp" ? 1 : e.key === "ArrowDown" ? -1 : e.key === "PageUp" ? 10 : e.key === "PageDown" ? -10 : 0;
-    if (count === 0) return;
-    // Otherwise ArrowUp/Down also jump the caret to the start/end of the text.
-    e.preventDefault();
-    stepBy(count);
-  };
-
-  // While locked the field sits in the reason's frame (line or Tooltip), its outermost
-  // box — so `className` (a width, a flex or grid cell) moves onto that, and the form
-  // keeps its layout, as on Select.
-  const field = (
-    <FloatingField
-      className={cn("w-full", !locked && className)}
-      htmlFor={fieldId}
-      label={label}
-      srOnlyLabel={asDisplay}
-      hint={numeric.hint.labelHint}
-    >
-      <input
-        ref={setInput}
-        id={fieldId}
-        aria-label={ariaLabel}
-        type="text"
-        // Mobile: suppress the OS keyboard so the numpad sheet owns entry (field
-        // keeps focus/caret); desktop keeps the native decimal keypad.
-        inputMode={isMobile ? "none" : "decimal"}
-        autoComplete="off"
-        // eslint-disable-next-line jsx-a11y/no-autofocus -- a documented prop the caller opts into (off by default); the field never takes focus on its own.
-        autoFocus={autoFocus}
-        disabled={off}
-        // Locked: focusable, `readOnly`, `aria-disabled` — see `disabledReason`.
-        readOnly={locked || undefined}
-        aria-disabled={locked || undefined}
-        // Display mode has no floating label to feed the blank-placeholder trick,
-        // and an empty borderless figure shows nothing — so it keeps whatever
-        // placeholder the caller gave, falling back to a zero to aim at.
-        placeholder={asDisplay ? (placeholder ?? "0") : labelled ? " " : placeholder}
-        value={display}
-        onChange={(e) => {
-          if (!locked) typed(e.target.value);
-        }}
-        onFocus={() => setFocused(true)}
-        onBlur={() => {
-          // Nothing commits under the lock — not even a draft typed before it arrived,
-          // which stays in the field for when it lifts.
-          if (!locked) commit();
-          setFocused(false);
-        }}
-        onKeyDown={onKeyDown}
-        aria-invalid={invalid || undefined}
-        aria-describedby={numeric.describedBy}
-        aria-required={ariaRequired}
-        // The end padding sits last so it always wins over an inputClassName that
-        // sets its own px. Both trailing controls can be on at once, so the room
-        // they need is reserved together rather than by whichever happens to render:
-        // the calculator is ~36px and a short unit ~24px, and a field that reserved
-        // only one of them would let the digits run under the other.
-        className={cn(
-          asDisplay
-            ? cn(FIELD_DISPLAY, "text-4xl font-semibold leading-tight tracking-tight tabular-nums")
-            : labelled
-              ? FLOATING_INPUT_CLASS
-              : FIELD_BASE,
-          inputClassName,
-          showCalc && suffix !== undefined ? "pe-16" : showCalc ? "pe-9" : suffix !== undefined ? "pe-8" : undefined,
-          invalid && FIELD_INVALID,
-          locked && "cursor-not-allowed",
-        )}
-        // The classes above are the fallback; once the end controls are measured the
-        // field reserves exactly their width (+4px). A fixed pe-8 for any unit left a
-        // "%" in a ~78px table cell 32px of padding and the digits ~32px of room
-        // (keksdose live #367); a long unit ("km/h") got too little.
-        style={
-          hasEnd && endWidth != null
-            ? { paddingInlineEnd: endWidth + 4 }
-            : estimatedEnd !== undefined
-              ? { paddingInlineEnd: estimatedEnd }
-              : undefined
-        }
-      />
-      {hasEnd && (
-        // One flex track for both, so the unit and the calculator sit side by side
-        // instead of stacking on the same corner — AmountInput's arrangement, which
-        // has carried a chip and a calculator together since #430.
-        <div ref={endRef} className="absolute inset-y-0 end-0 flex items-center">
-          {showCalc && (
-            <CalculatorButton
-              // Seeded with the value in the field's mark but WITHOUT the typist's
-              // grouping: the evaluator reads either mark, but "1.234,5" is two of them.
-              value={derived}
-              onChange={result}
-              onCommit={commit}
-              className="self-stretch px-2.5"
-              aria-label={labels?.calculatorTrigger}
-              labels={labels?.calculator}
-            />
-          )}
-          {suffix !== undefined && (
-            <span
-              aria-hidden
-              // pe-2, not the input's px-3: the unit is chrome at the box's edge, and
-              // with pe-3 plus the 4px gap it took ~26px of a narrow table cell.
-              className="pointer-events-none pe-2 text-xs font-medium text-muted"
-            >
-              {suffix}
-            </span>
-          )}
-        </div>
-      )}
-      {showNumpad && (
-        <NumberPadSheet
-          // Localised like the field it mirrors, as AmountInput's is: its keys are
-          // typing, read by the locale's marks like the keyboard's; "=" is a result.
-          value={display}
-          onChange={typed}
-          onResult={result}
-          onDone={() => inputRef.current?.blur()}
-          label={label}
-          labels={labels?.pad}
-          decimalMark={mark}
-        />
-      )}
-    </FloatingField>
-  );
-  const box = locked ? (
-    <LockedReason lock={lock} display={disabledReasonDisplay} className={cn("block w-full", className)}>
-      {field}
-    </LockedReason>
-  ) : (
-    field
-  );
-  const data = dataAttributes(props);
-  if (numeric.hint.captionText === undefined && numeric.errorEl === null && !reserve) {
-    // Bare, unless the caller tags it: then the same plain root as below carries the tags.
-    return Object.keys(data).length > 0 ? <div {...data}>{box}</div> : box;
-  }
-  // Outside the field's own `relative` box, as Select's caption is: the calculator
-  // and the unit are `inset-y-0` in it and would stretch down over a second line.
-  // `className` stays on the field, so adding a caption cannot change what it styles.
-  return (
-    <div {...data}>
-      {box}
-      <FieldCaption parts={numeric.hint} />
-      {numeric.errorEl}
-    </div>
-  );
-}