@eifi1/ui-kit 0.52.0 → 0.54.0

package/dist/lib/isin.js

@@ -1,36 +0,0 @@
-"use client";
-function expandLetters(value) {
-  return value.replace(/[A-Z]/g, (c) => String(c.charCodeAt(0) - 55));
-}
-function luhnSum(digits, doubleRightmost) {
-  let sum = 0;
-  let double = doubleRightmost;
-  for (let i = digits.length - 1; i >= 0; i--) {
-    let d = digits.charCodeAt(i) - 48;
-    if (double) {
-      d *= 2;
-      if (d > 9) d -= 9;
-    }
-    sum += d;
-    double = !double;
-  }
-  return sum;
-}
-function formatIsin(value) {
-  return value.replace(/[\s-]/g, "").toUpperCase();
-}
-function isinCheckDigit(body) {
-  const sum = luhnSum(expandLetters(formatIsin(body)), true);
-  return String((10 - sum % 10) % 10);
-}
-function isValidIsin(value) {
-  const isin = formatIsin(value);
-  if (!/^[A-Z]{2}[A-Z0-9]{9}\d$/.test(isin)) return false;
-  return luhnSum(expandLetters(isin), false) % 10 === 0;
-}
-export {
-  formatIsin,
-  isValidIsin,
-  isinCheckDigit
-};
-//# sourceMappingURL=isin.js.map

package/dist/lib/isin.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/lib/isin.ts"],"sourcesContent":["/**\n * ISIN helpers — ISO 6166 — for keksdose, whose securities holdings are keyed by ISIN\n * and whose import and edit forms checked only the shape (two letters, ten\n * characters): a mistyped ISIN saved happily and then matched no price feed.\n *\n * An ISIN is twelve characters: a two-letter prefix (the issuing country, or a\n * supranational code such as `XS`), nine letters or digits (the national number) and\n * one check digit. The check digit is the Luhn digit of the first eleven characters\n * with every letter expanded to two digits (A = 10 … Z = 35) — which is all that is\n * checked here. Whether the prefix is an assigned code, and whether the security\n * exists, is a lookup, not a checksum.\n *\n * Deprecated in 0.52, removed in 0.53 (decision 4 of the refactor audit 2026-10-30,\n * MOD-5): keksdose, which they were written for, never imported them, and no other app\n * does.\n */\n\n/** Letters to their two-digit numbers (A = 10 … Z = 35), digits as they are. */\nfunction expandLetters(value: string): string {\n  return value.replace(/[A-Z]/g, (c) => String(c.charCodeAt(0) - 55));\n}\n\n/** The Luhn sum of `digits` with the RIGHTMOST digit doubled first — the shape of the\n *  sum when a check digit is about to be appended. */\nfunction luhnSum(digits: string, doubleRightmost: boolean): number {\n  let sum = 0;\n  let double = doubleRightmost;\n  for (let i = digits.length - 1; i >= 0; i--) {\n    let d = digits.charCodeAt(i) - 48;\n    if (double) {\n      d *= 2;\n      if (d > 9) d -= 9;\n    }\n    sum += d;\n    double = !double;\n  }\n  return sum;\n}\n\n/**\n * The ISIN as it is printed: upper case, unbroken (ISO 6166 has no grouping), with\n * the spaces and hyphens a paste from a broker's statement carries dropped.\n *\n * @deprecated 0.52 — none: no app checks an ISIN with it; copy lib/isin.ts (MOD-5); removed in 0.53.\n */\nexport function formatIsin(value: string): string {\n  return value.replace(/[\\s-]/g, \"\").toUpperCase();\n}\n\n/**\n * The check digit for the first eleven characters of an ISIN (prefix and national\n * number). For BUILDING one — a test fixture, a demo — rather than checking it.\n *\n * @deprecated 0.52 — none: no app checks an ISIN with it; copy lib/isin.ts (MOD-5); removed in 0.53.\n */\nexport function isinCheckDigit(body: string): string {\n  const sum = luhnSum(expandLetters(formatIsin(body)), true);\n  return String((10 - (sum % 10)) % 10);\n}\n\n/**\n * Whether `value` is a valid ISIN: two letters, nine letters or digits, one digit,\n * and a matching Luhn check digit over the letter-expanded form. Spaces, hyphens and\n * lower case are fine (see {@link formatIsin}).\n *\n * @deprecated 0.52 — none: no app checks an ISIN with it; copy lib/isin.ts (MOD-5); removed in 0.53.\n */\nexport function isValidIsin(value: string): boolean {\n  const isin = formatIsin(value);\n  if (!/^[A-Z]{2}[A-Z0-9]{9}\\d$/.test(isin)) return false;\n  return luhnSum(expandLetters(isin), false) % 10 === 0;\n}\n"],"mappings":";AAkBA,SAAS,cAAc,OAAuB;AAC5C,SAAO,MAAM,QAAQ,UAAU,CAAC,MAAM,OAAO,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;AACpE;AAIA,SAAS,QAAQ,QAAgB,iBAAkC;AACjE,MAAI,MAAM;AACV,MAAI,SAAS;AACb,WAAS,IAAI,OAAO,SAAS,GAAG,KAAK,GAAG,KAAK;AAC3C,QAAI,IAAI,OAAO,WAAW,CAAC,IAAI;AAC/B,QAAI,QAAQ;AACV,WAAK;AACL,UAAI,IAAI,EAAG,MAAK;AAAA,IAClB;AACA,WAAO;AACP,aAAS,CAAC;AAAA,EACZ;AACA,SAAO;AACT;AAQO,SAAS,WAAW,OAAuB;AAChD,SAAO,MAAM,QAAQ,UAAU,EAAE,EAAE,YAAY;AACjD;AAQO,SAAS,eAAe,MAAsB;AACnD,QAAM,MAAM,QAAQ,cAAc,WAAW,IAAI,CAAC,GAAG,IAAI;AACzD,SAAO,QAAQ,KAAM,MAAM,MAAO,EAAE;AACtC;AASO,SAAS,YAAY,OAAwB;AAClD,QAAM,OAAO,WAAW,KAAK;AAC7B,MAAI,CAAC,0BAA0B,KAAK,IAAI,EAAG,QAAO;AAClD,SAAO,QAAQ,cAAc,IAAI,GAAG,KAAK,IAAI,OAAO;AACtD;","names":[]}

package/dist/shell/role-switcher.d.ts

@@ -1,28 +0,0 @@
-/** @deprecated 0.52 — `DevMenuProps` (`roles`, `currentRole`, `onRole`) (MOD-5); removed in 0.53. */
-export interface RoleSwitcherProps<R extends string> {
-    roles: readonly R[];
-    value: R;
-    onChange: (role: R) => void;
-    /** Default: `topBar.switchRole` from the {@link UiKitProvider}, else English. */
-    "aria-label"?: string;
-    heading?: string;
-    /** The trigger's tooltip. Default: `topBar.role(value)`. */
-    title?: string;
-}
-/**
- * A reusable user-role switcher (feedback #337): a thin wrapper over
- * {@link OptionSwitcherMenu} with the standard flask icon, so an app drops it in
- * the top bar with just the role list + current value + a handler. Typically
- * dev-only / UI-only, but the app decides where and whether to render it.
- *
- * The flask wears `--warning` rather than a fixed `amber-500`: it is a caution
- * marker — the app is not showing you your own role — and the token carries that
- * amber across both themes instead of pinning one hue onto every palette.
- *
- * Deprecated in 0.52, removed in 0.53 (decision 4 of the refactor audit 2026-10-30,
- * MOD-5): the role switch every app draws is `DevMenu`'s Account section (0.51), and no
- * app renders this one.
- *
- * @deprecated 0.52 — `DevMenu` with `roles`, `currentRole` and `onRole` (MOD-5); removed in 0.53.
- */
-export declare function RoleSwitcher<R extends string>({ roles, value, onChange, "aria-label": ariaLabel, heading, title, }: RoleSwitcherProps<R>): import("react").JSX.Element;

package/dist/shell/role-switcher.js

@@ -1,31 +0,0 @@
-"use client";
-import { jsx } from "react/jsx-runtime";
-import { FlaskConical } from "lucide-react";
-import { OptionSwitcherMenu } from "./option-switcher-menu.js";
-import { DEFAULT_TOP_BAR_LABELS, useKitLabels } from "../i18n/kit-labels.js";
-function RoleSwitcher({
-  roles,
-  value,
-  onChange,
-  "aria-label": ariaLabel,
-  heading,
-  title
-}) {
-  const labels = useKitLabels("topBar", DEFAULT_TOP_BAR_LABELS, { switchRole: ariaLabel });
-  return /* @__PURE__ */ jsx(
-    OptionSwitcherMenu,
-    {
-      "aria-label": labels.switchRole,
-      title: title ?? labels.role(value),
-      heading,
-      icon: /* @__PURE__ */ jsx(FlaskConical, { className: "size-5 text-warning" }),
-      options: roles.map((r) => ({ value: r, label: r })),
-      value,
-      onSelect: onChange
-    }
-  );
-}
-export {
-  RoleSwitcher
-};
-//# sourceMappingURL=role-switcher.js.map

package/dist/shell/role-switcher.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/shell/role-switcher.tsx"],"sourcesContent":["import { FlaskConical } from \"lucide-react\";\nimport { OptionSwitcherMenu } from \"./option-switcher-menu\";\nimport { DEFAULT_TOP_BAR_LABELS, useKitLabels } from \"../i18n/kit-labels\";\n\n/** @deprecated 0.52 — `DevMenuProps` (`roles`, `currentRole`, `onRole`) (MOD-5); removed in 0.53. */\nexport interface RoleSwitcherProps<R extends string> {\n  roles: readonly R[];\n  value: R;\n  onChange: (role: R) => void;\n  /** Default: `topBar.switchRole` from the {@link UiKitProvider}, else English. */\n  \"aria-label\"?: string;\n  heading?: string;\n  /** The trigger's tooltip. Default: `topBar.role(value)`. */\n  title?: string;\n}\n\n/**\n * A reusable user-role switcher (feedback #337): a thin wrapper over\n * {@link OptionSwitcherMenu} with the standard flask icon, so an app drops it in\n * the top bar with just the role list + current value + a handler. Typically\n * dev-only / UI-only, but the app decides where and whether to render it.\n *\n * The flask wears `--warning` rather than a fixed `amber-500`: it is a caution\n * marker — the app is not showing you your own role — and the token carries that\n * amber across both themes instead of pinning one hue onto every palette.\n *\n * Deprecated in 0.52, removed in 0.53 (decision 4 of the refactor audit 2026-10-30,\n * MOD-5): the role switch every app draws is `DevMenu`'s Account section (0.51), and no\n * app renders this one.\n *\n * @deprecated 0.52 — `DevMenu` with `roles`, `currentRole` and `onRole` (MOD-5); removed in 0.53.\n */\nexport function RoleSwitcher<R extends string>({\n  roles,\n  value,\n  onChange,\n  \"aria-label\": ariaLabel,\n  heading,\n  title,\n}: RoleSwitcherProps<R>) {\n  const labels = useKitLabels(\"topBar\", DEFAULT_TOP_BAR_LABELS, { switchRole: ariaLabel });\n  return (\n    <OptionSwitcherMenu<R>\n      aria-label={labels.switchRole}\n      title={title ?? labels.role(value)}\n      heading={heading}\n      icon={<FlaskConical className=\"size-5 text-warning\" />}\n      options={roles.map((r) => ({ value: r, label: r }))}\n      value={value}\n      onSelect={onChange}\n    />\n  );\n}\n"],"mappings":";AA8CY;AA9CZ,SAAS,oBAAoB;AAC7B,SAAS,0BAA0B;AACnC,SAAS,wBAAwB,oBAAoB;AA8B9C,SAAS,aAA+B;AAAA,EAC7C;AAAA,EACA;AAAA,EACA;AAAA,EACA,cAAc;AAAA,EACd;AAAA,EACA;AACF,GAAyB;AACvB,QAAM,SAAS,aAAa,UAAU,wBAAwB,EAAE,YAAY,UAAU,CAAC;AACvF,SACE;AAAA,IAAC;AAAA;AAAA,MACC,cAAY,OAAO;AAAA,MACnB,OAAO,SAAS,OAAO,KAAK,KAAK;AAAA,MACjC;AAAA,MACA,MAAM,oBAAC,gBAAa,WAAU,uBAAsB;AAAA,MACpD,SAAS,MAAM,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,EAAE;AAAA,MAClD;AAAA,MACA,UAAU;AAAA;AAAA,EACZ;AAEJ;","names":[]}

package/src/billing/dialog-close.ts

@@ -1,34 +0,0 @@
-/**
- * How the three billing confirms — `CancelSubscriptionConfirm`, `PlanSwitchConfirm`,
- * `GrantWarningConfirm` — are closed in 0.52: `onClose`, as every other kit dialog
- * (CONTRIBUTING §4; refactor audit 2026-10-30, API-5), and for one minor the deprecated
- * `onOpenChange`, called with `false` when there is no `onClose`.
- *
- * 0.52 made `onOpenChange` optional for its deprecation and gave `onClose` beside it as
- * optional too, so a confirm given NEITHER compiled — `<CancelSubscriptionConfirm open
- * periodEnd={…} onConfirm={…} />` — and Back, Escape and the backdrop then called nothing:
- * a dialog nobody could dismiss, where 0.51's compiler had required `onOpenChange` (0.52
- * code review, cancel-subscription.tsx). And the fallback between the two was written
- * three times, once per dialog.
- *
- * @internal Not part of the barrel; each dialog's props type is.
- */
-
-/** The two close props as a dialog's own props interface declares them. */
-interface CloseProps {
-  onClose?: () => void;
-  onOpenChange?: (open: boolean) => void;
-}
-
-/**
- * `P` with ONE of its two close props required — `onClose`, or alone the deprecated
- * `onOpenChange`; both may be given, and `onClose` is then the one called. Built from
- * `P`'s own members (`Pick`), so their docs and the deprecation stay the ones `P` writes.
- */
-export type WithDialogClose<P extends CloseProps> = P &
-  (Required<Pick<P, "onClose">> | Required<Pick<P, "onOpenChange">>);
-
-/** The dialog's close: `onClose`, else `onOpenChange(false)`. */
-export function dialogClose({ onClose, onOpenChange }: CloseProps): () => void {
-  return () => (onClose ? onClose() : onOpenChange?.(false));
-}

package/src/components/field-sync-labels.ts

@@ -1,14 +0,0 @@
-// The English words of ./field-sync, in a module with no component code: the English
-// catalogue (src/i18n/defaults.ts) imports them without the component, so `en` loads as one
-// chunk like the other languages (0.34, KS U8). ./field-sync re-exports them.
-
-import type { FieldSyncLabels } from "./field-sync";
-
-/** @deprecated 0.52 — none: no app uses the FieldSync family (MOD-5); removed in 0.53. */
-export const DEFAULT_FIELD_SYNC_LABELS: FieldSyncLabels = {
-  synced: "Saved",
-  edited: "Unsaved changes",
-  pending: "Saving…",
-  error: "Could not save",
-  retry: "Retry",
-};

package/src/components/field-sync.tsx

@@ -1,504 +0,0 @@
-import { useCallback, useEffect, useRef, useState } from "react";
-import type { ReactNode } from "react";
-import { AlertCircle, Check, Loader2, Pencil, PencilLine } from "lucide-react";
-import { cn } from "../lib/cn";
-import { Tooltip } from "./tooltip";
-import { FOCUS_RING } from "./focus-ring";
-import { useKitLabels, type LabelOverride } from "../i18n/kit-labels";
-import { useLargeText } from "../hooks/use-large-text";
-import { DEFAULT_FIELD_SYNC_LABELS } from "./field-sync-labels";
-
-/**
- * Sync state for a field backed by a database row.
- *
- * The four states a value can be in between the keyboard and the server:
- *
- *   synced   the draft equals what was last persisted
- *   edited   the draft differs and nothing has been sent yet
- *   pending  a save is in flight
- *   error    the last save was rejected; `error` carries why
- *
- * `useFieldSync` is the engine and holds no opinion about markup;
- * `FieldSyncIndicator` is the affordance and holds no state. They are separate
- * because the state is useful without the dot — a form can disable its submit
- * button while any field is `pending`, and a router can block navigation while
- * any field is `edited`.
- *
- * Deprecated in 0.52 as a whole, removed in 0.53 (decision 4 of the refactor audit
- * 2026-10-30, MOD-5): no app renders it or calls the hook — 483 lines and a namespace in
- * seven catalogues that only this package's tests and showcase read. An app that wants
- * it keeps a copy of this file.
- *
- * @deprecated 0.52 — none: no app uses the FieldSync family (MOD-5); removed in 0.53.
- */
-export type FieldSyncState = "synced" | "edited" | "pending" | "error";
-
-/** @deprecated 0.52 — none: no app uses the FieldSync family (MOD-5); removed in 0.53. */
-export interface FieldSyncLabels {
-  synced: string;
-  edited: string;
-  pending: string;
-  /** Shown when the failure carries no message of its own. */
-  error: string;
-  retry: string;
-}
-
-// Defined in ./field-sync-labels, which holds no component code (0.34, KS U8).
-export { DEFAULT_FIELD_SYNC_LABELS };
-
-/** @deprecated 0.52 — none: no app uses the FieldSync family (MOD-5); removed in 0.53. */
-export interface UseFieldSyncOptions<T> {
-  /** What the database currently holds. Changing it re-seeds a CLEAN field. */
-  value: T;
-  /** Persist `next`. Reject — or throw — to put the field in `error`. */
-  onSave: (next: T) => Promise<void> | void;
-  /**
-   * Quiet period before an edit saves itself, in ms. Default `0`: no auto-save at
-   * all, so `save()` is the only way to persist — called on blur by `FieldSyncRow`,
-   * and on Enter by the caller. Saving after a pause in typing wrote half-finished
-   * values to the database whenever somebody stopped to think; pass a positive
-   * number only for a field where that is genuinely wanted.
-   */
-  debounceMs?: number;
-  /** How to tell two values apart. Defaults to `Object.is`. */
-  equals?: (a: T, b: T) => boolean;
-  /** Called once per rejected save, with whatever `onSave` threw. */
-  onError?: (error: Error) => void;
-}
-
-/** @deprecated 0.52 — none: no app uses the FieldSync family (MOD-5); removed in 0.53. */
-export interface UseFieldSyncReturn<T> {
-  /** The draft — bind this to the input, not the `value` option. */
-  value: T;
-  setValue: (next: T) => void;
-  state: FieldSyncState;
-  /** Non-null exactly when `state === "error"`. */
-  error: Error | null;
-  /** True whenever the draft differs from the last persisted value. */
-  dirty: boolean;
-  /** Persist now, cancelling any pending debounce. A no-op on a clean field. */
-  save: () => void;
-  /** Send the current draft again after a failure. */
-  retry: () => void;
-  /** Throw the draft away and go back to the last persisted value. */
-  reset: () => void;
-}
-
-function toError(cause: unknown): Error {
-  if (cause instanceof Error) return cause;
-  // An EMPTY message for a rejection that carried none, not an English one: the
-  // indicator shows `error.message` when there is one and the translated
-  // `fieldSync.error` otherwise, so a fallback message here was an English sentence
-  // that outranked the app's own translation. The original value stays on `cause`
-  // for whoever logs it from `onError`.
-  return new Error(typeof cause === "string" ? cause : "", { cause });
-}
-
-/**
- * Track one database-backed field: a local draft, a debounced save, and the state
- * of the round trip.
- *
- * Four things this handles that a `useState` + `useEffect` in a page does not:
- *
- *   1. **An edit during a save is never lost.** A save in flight is not cancelled
- *      and not raced — when it settles, the draft is compared again and sent once
- *      more if it moved. Cancelling instead would drop a keystroke that arrived
- *      mid-flight; firing immediately would let two writes land out of order.
- *   2. **The server value is only adopted when the field is clean.** An external
- *      refresh that overwrote what somebody was typing would be a data-loss bug, so
- *      a dirty draft wins and keeps winning until it is saved or reset.
- *   3. **Nothing is set after unmount.** The save resolves into a component that
- *      may be gone — a row scrolled out of a virtualised table, a closed dialog.
- *   4. **`onSave` is read through a ref**, so an inline arrow — which every call
- *      site will pass — does not restart the debounce on every render.
- *
- * @deprecated 0.52 — none: no app uses the FieldSync family (MOD-5); removed in 0.53.
- */
-export function useFieldSync<T>({
-  value,
-  onSave,
-  debounceMs = 0,
-  equals = Object.is,
-  onError,
-}: UseFieldSyncOptions<T>): UseFieldSyncReturn<T> {
-  const [draft, setDraft] = useState<T>(value);
-  const [state, setState] = useState<FieldSyncState>("synced");
-  const [error, setError] = useState<Error | null>(null);
-
-  // The last value known to be on the server. Not state: it changes together with
-  // `state` inside the save, and a second render for it would be a wasted one.
-  const savedRef = useRef<T>(value);
-  const draftRef = useRef<T>(value);
-  const inFlightRef = useRef(false);
-  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
-  const mountedRef = useRef(true);
-
-  // Latest-ref for the callbacks and comparators, so a caller passing inline
-  // functions (all of them) does not invalidate the timer on every render.
-  const onSaveRef = useRef(onSave);
-  const onErrorRef = useRef(onError);
-  const equalsRef = useRef(equals);
-  useEffect(() => {
-    onSaveRef.current = onSave;
-    onErrorRef.current = onError;
-    equalsRef.current = equals;
-  });
-
-  useEffect(() => {
-    mountedRef.current = true;
-    return () => {
-      mountedRef.current = false;
-      if (timerRef.current) clearTimeout(timerRef.current);
-    };
-  }, []);
-
-  // A named inner function so the settle path can start the next round by calling it
-  // again; a `useCallback` cannot refer to its own binding while it is being built.
-  const flush = useCallback(() => {
-    const run = async (): Promise<void> => {
-      if (inFlightRef.current) return; // the settle path below picks the new draft up
-      const next = draftRef.current;
-      if (equalsRef.current(next, savedRef.current)) return;
-
-      inFlightRef.current = true;
-      setState("pending");
-      setError(null);
-      try {
-        await onSaveRef.current(next);
-        savedRef.current = next;
-        inFlightRef.current = false;
-        if (!mountedRef.current) return;
-        // The draft may have moved while this was in the air. Compare against what is
-        // on screen NOW, not against what was sent.
-        if (equalsRef.current(draftRef.current, next)) {
-          setState("synced");
-        } else {
-          setState("edited");
-          void run();
-        }
-      } catch (cause) {
-        inFlightRef.current = false;
-        const err = toError(cause);
-        onErrorRef.current?.(err);
-        if (!mountedRef.current) return;
-        setState("error");
-        setError(err);
-      }
-    };
-    return run();
-  }, []);
-
-  const setValue = useCallback(
-    (next: T) => {
-      draftRef.current = next;
-      setDraft(next);
-      if (timerRef.current) clearTimeout(timerRef.current);
-
-      if (equalsRef.current(next, savedRef.current)) {
-        // Typed back to what the server already has. Nothing to send, and an error
-        // from the previous attempt no longer describes anything.
-        setState(inFlightRef.current ? "pending" : "synced");
-        setError(null);
-        return;
-      }
-
-      setState("edited");
-      setError(null);
-      if (debounceMs > 0) timerRef.current = setTimeout(() => void flush(), debounceMs);
-    },
-    [debounceMs, flush],
-  );
-
-  const save = useCallback(() => {
-    if (timerRef.current) clearTimeout(timerRef.current);
-    void flush();
-  }, [flush]);
-
-  const retry = save;
-
-  const reset = useCallback(() => {
-    if (timerRef.current) clearTimeout(timerRef.current);
-    draftRef.current = savedRef.current;
-    setDraft(savedRef.current);
-    setState(inFlightRef.current ? "pending" : "synced");
-    setError(null);
-  }, []);
-
-  // Anything that is not `synced` has something not yet on the server: `edited` and
-  // `error` obviously, and `pending` too — the write is in the air, not landed.
-  // Derived from state rather than by comparing against `savedRef` during render,
-  // because a ref read here would not re-render when the comparison's answer changes.
-  const dirty = state !== "synced";
-
-  // Adopt a new server value ONLY when there is nothing local to lose.
-  useEffect(() => {
-    if (inFlightRef.current) return;
-    if (!equalsRef.current(draftRef.current, savedRef.current)) return; // dirty: keep it
-    if (equalsRef.current(value, savedRef.current)) return; // unchanged
-    savedRef.current = value;
-    draftRef.current = value;
-    setDraft(value);
-    setState("synced");
-    setError(null);
-  }, [value]);
-
-  return { value: draft, setValue, state, error, dirty, save, retry, reset };
-}
-
-const STATE_STYLE: Record<FieldSyncState, { color: string; Icon: typeof Check }> = {
-  synced: { color: "var(--status-synced)", Icon: Check },
-  edited: { color: "var(--status-edited)", Icon: Pencil },
-  pending: { color: "var(--status-pending)", Icon: Loader2 },
-  error: { color: "var(--status-error)", Icon: AlertCircle },
-};
-
-/** @deprecated 0.52 — none: no app uses the FieldSync family (MOD-5); removed in 0.53. */
-export interface FieldSyncIndicatorProps {
-  state: FieldSyncState;
-  /** The failure. Its message becomes the tooltip when `state === "error"`. */
-  error?: Error | null;
-  /** Override any of the five English defaults. */
-  labels?: LabelOverride<FieldSyncLabels>;
-  /** Render the label beside the icon instead of only in the tooltip. Always on at
-   *  Large and Extra large (0.32, docs/text-size-harmonization.md §4 "No fact only in a
-   *  tooltip"): the reader who asked for bigger type gets the words, not a 14 px glyph
-   *  and a bubble. */
-  showLabel?: boolean;
-  /** When given, the error state renders a retry button after the icon. */
-  onRetry?: () => void;
-  className?: string;
-}
-
-/**
- * The affordance for {@link useFieldSync}: a coloured icon, and the reason on hover.
- *
- * **Every state has its own icon, and that is not decoration.** The four colours
- * include the green/red pair, which is the one combination this package's palette
- * otherwise refuses (see the note in `tokens.css`) because red-green colour blindness
- * affects roughly one man in twelve. The icon is what carries the meaning for them,
- * and what carries it into a greyscale print or a screenshot. WCAG 1.4.1 is the same
- * requirement stated formally.
- *
- * The state is also announced: the wrapper is a polite live region, so a screen
- * reader hears "Saving…" then "Saved" without the user going looking. `error` is
- * assertive instead — a failed write is worth interrupting for.
- *
- * @deprecated 0.52 — none: no app uses the FieldSync family (MOD-5); removed in 0.53.
- */
-export function FieldSyncIndicator({
-  state,
-  error,
-  labels,
-  showLabel = false,
-  onRetry,
-  className,
-}: FieldSyncIndicatorProps) {
-  const l = useKitLabels("fieldSync", DEFAULT_FIELD_SYNC_LABELS, labels);
-  const large = useLargeText();
-  showLabel = showLabel || large;
-  const { color, Icon } = STATE_STYLE[state];
-  const text = state === "error" ? (error?.message?.trim() ? error.message : l.error) : l[state];
-
-  return (
-    <span
-      // The ICON carries the status colour; the words are `--text-secondary`, because
-      // the amber of `edited` is a graphic colour (3:1), not a text colour (4.5:1).
-      className={cn("inline-flex items-center gap-1.5 text-xs text-secondary", className)}
-      // Polite for the three ordinary states so save chatter does not interrupt
-      // typing; assertive for a failure, which the user has to know about now.
-      role={state === "error" ? "alert" : "status"}
-      aria-live={state === "error" ? "assertive" : "polite"}
-    >
-      <Tooltip label={showLabel ? undefined : text} redact={state === "error"}>
-        <span className="inline-flex items-center gap-1.5">
-          <Icon
-            aria-hidden
-            style={{ color }}
-            className={cn("size-3.5 shrink-0", state === "pending" && "animate-spin")}
-          />
-          {/* Always in the DOM, so the live region has something to announce even
-              when the label is visually a tooltip. */}
-          <span className={showLabel ? undefined : "sr-only"}>{text}</span>
-        </span>
-      </Tooltip>
-      {state === "error" && onRetry && (
-        <button
-          type="button"
-          onClick={onRetry}
-          // The kit's focus frame (0.32, §5), stood off the word.
-          className={cn(
-            "rounded underline underline-offset-2 hover:no-underline focus-visible:ring-offset-2 focus-visible:ring-offset-surface",
-            FOCUS_RING,
-          )}
-          style={{ color }}
-        >
-          {l.retry}
-        </button>
-      )}
-    </span>
-  );
-}
-
-/**
- * The field's own frame, coloured by state — applied from the WRAPPER to whatever
- * native control sits inside it, so {@link FieldSyncRow} works with any of the kit's
- * inputs (and a caller's own) without each one growing a `syncState` prop.
- *
- * Border AND a 1px ring, for the reason {@link FIELD_INVALID} gives: a lone 1px
- * border loses a vertical edge to sub-pixel spread at 125% display scaling. The
- * `:focus` twins are what keep the state visible while the reader is typing —
- * the base field class's `focus:` brand colour is `(0,2,0)` and would otherwise win
- * over a descendant selector exactly when the field is in use.
- *
- * `synced` is green, but {@link FieldSyncRow} paints it only for a moment after a
- * save lands — a form of eight permanently green boxes says nothing the absence of
- * colour does not.
- *
- * Every class is a literal so Tailwind's scanner can see it.
- *
- * @deprecated 0.52 — none: no app uses the FieldSync family (MOD-5); removed in 0.53.
- */
-export const FIELD_SYNC_FRAME: Record<FieldSyncState, string> = {
-  synced:
-    "[&_:is(input,select,textarea)]:border-[var(--status-synced)] [&_:is(input,select,textarea)]:ring-1 [&_:is(input,select,textarea)]:ring-[var(--status-synced)] [&_:is(input,select,textarea):focus]:border-[var(--status-synced)] [&_:is(input,select,textarea):focus]:ring-[var(--status-synced)]",
-  edited:
-    "[&_:is(input,select,textarea)]:border-[var(--status-edited)] [&_:is(input,select,textarea)]:ring-1 [&_:is(input,select,textarea)]:ring-[var(--status-edited)] [&_:is(input,select,textarea):focus]:border-[var(--status-edited)] [&_:is(input,select,textarea):focus]:ring-[var(--status-edited)]",
-  pending:
-    "[&_:is(input,select,textarea)]:border-[var(--status-pending)] [&_:is(input,select,textarea)]:ring-1 [&_:is(input,select,textarea)]:ring-[var(--status-pending)] [&_:is(input,select,textarea):focus]:border-[var(--status-pending)] [&_:is(input,select,textarea):focus]:ring-[var(--status-pending)]",
-  error:
-    "[&_:is(input,select,textarea)]:border-[var(--status-error)] [&_:is(input,select,textarea)]:ring-1 [&_:is(input,select,textarea)]:ring-[var(--status-error)] [&_:is(input,select,textarea):focus]:border-[var(--status-error)] [&_:is(input,select,textarea):focus]:ring-[var(--status-error)]",
-};
-
-/** How long the green "saved" frame and check stay after a save lands, in ms.
- *
- * @deprecated 0.52 — none: no app uses the FieldSync family (MOD-5); removed in 0.53. */
-export const FIELD_SYNC_SAVED_MS = 1500;
-
-/** @deprecated 0.52 — none: no app uses the FieldSync family (MOD-5); removed in 0.53. */
-export interface FieldSyncRowProps<T> extends Omit<FieldSyncIndicatorProps, "state" | "error" | "showLabel"> {
-  sync: UseFieldSyncReturn<T>;
-  children: ReactNode;
-  /** Call `sync.save()` when focus leaves the field. Default true — together with the
-   *  hook's default `debounceMs: 0` this is "save on blur": nothing is written while
-   *  the reader is still typing, however long they pause. */
-  saveOnBlur?: boolean;
-  /** How long the saved confirmation shows. Default {@link FIELD_SYNC_SAVED_MS}. */
-  savedMs?: number;
-}
-
-/**
- * A field wearing its sync state — as its FRAME COLOUR and an ICON AT THE END OF THE
- * FIELD, so the field never changes size (a helper line appearing under it moved
- * everything below it on every save):
- *
- *   edited   amber frame, pencil          — changed, not yet saved
- *   pending  blue frame, spinning circle  — for as long as the save is in flight
- *   synced   green frame, check           — for {@link FIELD_SYNC_SAVED_MS} after a
- *                                            save lands, then an ordinary field again
- *   error    red frame, alert mark        — hover or focus the mark for the reason;
- *                                            click it to retry
- *
- * It saves when focus LEAVES the field (`saveOnBlur`), not after a pause in typing: a
- * database write in the middle of a word is a write nobody asked for. Enter in a
- * single-line field is the caller's to wire to `sync.save`.
- *
- * Colour is never the only signal: every state has its own icon, and the state text is
- * always in the DOM as a live region — polite for the ordinary states, assertive for
- * a failure. The input gets end padding for the icon whether or not one is showing,
- * so the text never reflows when the state changes.
- *
- * @deprecated 0.52 — none: no app uses the FieldSync family (MOD-5); removed in 0.53.
- */
-export function FieldSyncRow<T>({
-  sync,
-  children,
-  className,
-  labels,
-  onRetry,
-  saveOnBlur = true,
-  savedMs = FIELD_SYNC_SAVED_MS,
-}: FieldSyncRowProps<T>) {
-  const l = useKitLabels("fieldSync", DEFAULT_FIELD_SYNC_LABELS, labels);
-  const { state, error } = sync;
-  const isError = state === "error";
-  const text = isError ? (error?.message?.trim() ? error.message : l.error) : l[state];
-  const retry = onRetry ?? sync.retry;
-
-  // The saved confirmation: on only for the moment after a save lands. Keyed on the
-  // TRANSITION pending → synced, so a field that starts synced shows nothing. The
-  // transition is seen while rendering, against the previous state; the effect only
-  // owns the timer that turns it off again.
-  const [previous, setPrevious] = useState(state);
-  const [justSaved, setJustSaved] = useState(false);
-  if (state !== previous) {
-    setPrevious(state);
-    setJustSaved(state === "synced" && previous === "pending");
-  }
-  useEffect(() => {
-    if (!justSaved) return;
-    const t = setTimeout(() => setJustSaved(false), savedMs);
-    return () => clearTimeout(t);
-  }, [justSaved, savedMs]);
-  const shown: FieldSyncState | null = state === "synced" ? (justSaved ? "synced" : null) : state;
-
-  return (
-    /* eslint-disable-next-line jsx-a11y/no-static-element-interactions -- not an interaction:
-       `onBlur` listens for focus leaving the row's own controls (which are the
-       interactive elements) to save; the wrapper itself is never focused. */
-    <div
-      data-field-sync={state}
-      className={cn(
-        // `relative` for the icon and for the sr-only live region's containing block.
-        "relative [&_:is(input,select,textarea)]:pe-9",
-        shown && FIELD_SYNC_FRAME[shown],
-        className,
-      )}
-      onBlur={
-        saveOnBlur
-          ? (e) => {
-              // Focus moving between two controls INSIDE the row is not leaving it.
-              if (!e.currentTarget.contains(e.relatedTarget as Node | null)) sync.save();
-            }
-          : undefined
-      }
-    >
-      {children}
-      <span className="pointer-events-none absolute inset-y-0 end-0 flex items-center pe-3">
-        {state === "edited" && <PencilLine aria-hidden className="size-4 text-[var(--status-edited)]" />}
-        {state === "pending" && (
-          <Loader2
-            aria-hidden
-            className="size-4 animate-spin text-[var(--status-pending)] motion-reduce:animate-none"
-          />
-        )}
-        {state === "synced" && (
-          <Check
-            aria-hidden
-            className={cn(
-              "size-4 text-[var(--status-synced)] transition-opacity duration-500 motion-reduce:transition-none",
-              justSaved ? "opacity-100" : "opacity-0",
-            )}
-          />
-        )}
-        {isError && (
-          <Tooltip label={text} portal redact>
-            <button
-              type="button"
-              onClick={retry}
-              aria-label={l.retry}
-              className={cn(
-                "pointer-events-auto flex rounded-full text-[var(--status-error)] focus-visible:ring-offset-2 focus-visible:ring-offset-surface",
-                FOCUS_RING,
-              )}
-            >
-              <AlertCircle aria-hidden className="size-4" />
-            </button>
-          </Tooltip>
-        )}
-      </span>
-      <span role={isError ? "alert" : "status"} aria-live={isError ? "assertive" : "polite"} className="sr-only">
-        {shown === null ? "" : text}
-      </span>
-    </div>
-  );
-}