@eifi1/ui-kit 0.52.0 → 0.54.0

package/dist/components/field-sync.js

@@ -1,269 +0,0 @@
-"use client";
-import { jsx, jsxs } from "react/jsx-runtime";
-import { useCallback, useEffect, useRef, useState } from "react";
-import { AlertCircle, Check, Loader2, Pencil, PencilLine } from "lucide-react";
-import { cn } from "../lib/cn.js";
-import { Tooltip } from "./tooltip.js";
-import { FOCUS_RING } from "./focus-ring.js";
-import { useKitLabels } from "../i18n/kit-labels.js";
-import { useLargeText } from "../hooks/use-large-text.js";
-import { DEFAULT_FIELD_SYNC_LABELS } from "./field-sync-labels.js";
-function toError(cause) {
-  if (cause instanceof Error) return cause;
-  return new Error(typeof cause === "string" ? cause : "", { cause });
-}
-function useFieldSync({
-  value,
-  onSave,
-  debounceMs = 0,
-  equals = Object.is,
-  onError
-}) {
-  const [draft, setDraft] = useState(value);
-  const [state, setState] = useState("synced");
-  const [error, setError] = useState(null);
-  const savedRef = useRef(value);
-  const draftRef = useRef(value);
-  const inFlightRef = useRef(false);
-  const timerRef = useRef(null);
-  const mountedRef = useRef(true);
-  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);
-    };
-  }, []);
-  const flush = useCallback(() => {
-    const run = async () => {
-      if (inFlightRef.current) return;
-      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;
-        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) => {
-      draftRef.current = next;
-      setDraft(next);
-      if (timerRef.current) clearTimeout(timerRef.current);
-      if (equalsRef.current(next, savedRef.current)) {
-        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);
-  }, []);
-  const dirty = state !== "synced";
-  useEffect(() => {
-    if (inFlightRef.current) return;
-    if (!equalsRef.current(draftRef.current, savedRef.current)) return;
-    if (equalsRef.current(value, savedRef.current)) return;
-    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 = {
-  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 }
-};
-function FieldSyncIndicator({
-  state,
-  error,
-  labels,
-  showLabel = false,
-  onRetry,
-  className
-}) {
-  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 /* @__PURE__ */ jsxs(
-    "span",
-    {
-      className: cn("inline-flex items-center gap-1.5 text-xs text-secondary", className),
-      role: state === "error" ? "alert" : "status",
-      "aria-live": state === "error" ? "assertive" : "polite",
-      children: [
-        /* @__PURE__ */ jsx(Tooltip, { label: showLabel ? void 0 : text, redact: state === "error", children: /* @__PURE__ */ jsxs("span", { className: "inline-flex items-center gap-1.5", children: [
-          /* @__PURE__ */ jsx(
-            Icon,
-            {
-              "aria-hidden": true,
-              style: { color },
-              className: cn("size-3.5 shrink-0", state === "pending" && "animate-spin")
-            }
-          ),
-          /* @__PURE__ */ jsx("span", { className: showLabel ? void 0 : "sr-only", children: text })
-        ] }) }),
-        state === "error" && onRetry && /* @__PURE__ */ jsx(
-          "button",
-          {
-            type: "button",
-            onClick: onRetry,
-            className: cn(
-              "rounded underline underline-offset-2 hover:no-underline focus-visible:ring-offset-2 focus-visible:ring-offset-surface",
-              FOCUS_RING
-            ),
-            style: { color },
-            children: l.retry
-          }
-        )
-      ]
-    }
-  );
-}
-const FIELD_SYNC_FRAME = {
-  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)]"
-};
-const FIELD_SYNC_SAVED_MS = 1500;
-function FieldSyncRow({
-  sync,
-  children,
-  className,
-  labels,
-  onRetry,
-  saveOnBlur = true,
-  savedMs = FIELD_SYNC_SAVED_MS
-}) {
-  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;
-  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 = 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. */
-    /* @__PURE__ */ jsxs(
-      "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) => {
-          if (!e.currentTarget.contains(e.relatedTarget)) sync.save();
-        } : void 0,
-        children: [
-          children,
-          /* @__PURE__ */ jsxs("span", { className: "pointer-events-none absolute inset-y-0 end-0 flex items-center pe-3", children: [
-            state === "edited" && /* @__PURE__ */ jsx(PencilLine, { "aria-hidden": true, className: "size-4 text-[var(--status-edited)]" }),
-            state === "pending" && /* @__PURE__ */ jsx(
-              Loader2,
-              {
-                "aria-hidden": true,
-                className: "size-4 animate-spin text-[var(--status-pending)] motion-reduce:animate-none"
-              }
-            ),
-            state === "synced" && /* @__PURE__ */ jsx(
-              Check,
-              {
-                "aria-hidden": true,
-                className: cn(
-                  "size-4 text-[var(--status-synced)] transition-opacity duration-500 motion-reduce:transition-none",
-                  justSaved ? "opacity-100" : "opacity-0"
-                )
-              }
-            ),
-            isError && /* @__PURE__ */ jsx(Tooltip, { label: text, portal: true, redact: true, children: /* @__PURE__ */ jsx(
-              "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
-                ),
-                children: /* @__PURE__ */ jsx(AlertCircle, { "aria-hidden": true, className: "size-4" })
-              }
-            ) })
-          ] }),
-          /* @__PURE__ */ jsx("span", { role: isError ? "alert" : "status", "aria-live": isError ? "assertive" : "polite", className: "sr-only", children: shown === null ? "" : text })
-        ]
-      }
-    )
-  );
-}
-export {
-  DEFAULT_FIELD_SYNC_LABELS,
-  FIELD_SYNC_FRAME,
-  FIELD_SYNC_SAVED_MS,
-  FieldSyncIndicator,
-  FieldSyncRow,
-  useFieldSync
-};
-//# sourceMappingURL=field-sync.js.map

package/dist/components/field-sync.js.map

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

package/dist/components/section-nav.d.ts

@@ -1,44 +0,0 @@
-import type { NavPillItem, NavPillLinkProps } from "./nav-pills.js";
-import type { ReactElement, Ref } from "react";
-/** @deprecated 0.52 — `NavPillsProps` with `layout="scroll"`, what SectionNav wraps; removed in
- *  0.53 (no app renders SectionNav: refactor audit 2026-10-30, MOD-5). */
-export interface SectionNavProps<T extends string> {
-    /** The section's pages, each with its `href` (a pill without one is a button that
-     *  calls `onSelect`). Labels short: the row is one line. */
-    items: NavPillItem<T>[];
-    /** The page that is open. `null`: none of them. */
-    current: T | null;
-    /** The section's name — the landmark's accessible name ("Accounting"). */
-    label: string;
-    /** Called with a pill's value on a click, before the router follows its link. */
-    onSelect?: (value: T) => void;
-    /** Your router's link. Default: the `<UiKitProvider linkComponent>`, then `<a>`. */
-    renderLink?: (props: NavPillLinkProps) => ReactElement;
-    /** Default `true`: only below `md`, where the sidebar that lists the same pages is
-     *  gone. `false` shows it at every width. */
-    phoneOnly?: boolean;
-    className?: string;
-    ref?: Ref<HTMLElement>;
-}
-/**
- * The pages of a section on a phone, as one row of pills under the page title (0.49
- * KIT-6) — kastlan's section pills, which each section page drew by hand.
- *
- * On a desktop the sidebar lists a group's pages; on a phone the AppShell's bar holds
- * the groups, and a group's pages are a sheet away. This row puts them on the page
- * itself: {@link NavPills} with `layout="scroll"` — one line that scrolls sideways, faded
- * where it is cut, the open page scrolled into view (the row only, never the page). At
- * most 48 px high: 44 px pills, the touch target a finger needs, and 2 px above and
- * below. Each pill is a link (`aria-current="page"` on the open one) and its own tab
- * stop; the row is a `<nav>` named by `label`.
- *
- * Place it right under the page's title (`PageHeader`); the AppShell's own row of a
- * group's pages above the bar (`mobileSubNav`) is the shell-wide alternative — use one,
- * not both, for the same pages.
- *
- * @deprecated 0.52 — `<NavPills layout="scroll" itemClassName="min-h-11 focus-visible:ring-inset"
- * className="md:hidden">`, the same row; removed in 0.53. kastlan, whose section pills it
- * was made for (0.49 KIT-6), never adopted it: no app renders it (refactor audit
- * 2026-10-30, MOD-5).
- */
-export declare function SectionNav<T extends string>({ items, current, label, onSelect, renderLink, phoneOnly, className, ref, }: SectionNavProps<T>): import("react").JSX.Element;

package/dist/components/section-nav.js

@@ -1,33 +0,0 @@
-"use client";
-import { jsx } from "react/jsx-runtime";
-import { cn } from "../lib/cn.js";
-import { NavPills } from "./nav-pills.js";
-function SectionNav({
-  items,
-  current,
-  label,
-  onSelect,
-  renderLink,
-  phoneOnly = true,
-  className,
-  ref
-}) {
-  return /* @__PURE__ */ jsx(
-    NavPills,
-    {
-      ref,
-      "aria-label": label,
-      items,
-      current,
-      onSelect,
-      renderLink,
-      layout: "scroll",
-      itemClassName: "min-h-11 focus-visible:ring-inset",
-      className: cn("py-0.5 large:py-0", phoneOnly && "md:hidden", className)
-    }
-  );
-}
-export {
-  SectionNav
-};
-//# sourceMappingURL=section-nav.js.map

package/dist/components/section-nav.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/components/section-nav.tsx"],"sourcesContent":["import { cn } from \"../lib/cn\";\nimport { NavPills } from \"./nav-pills\";\nimport type { NavPillItem, NavPillLinkProps } from \"./nav-pills\";\nimport type { ReactElement, Ref } from \"react\";\n\n/** @deprecated 0.52 — `NavPillsProps` with `layout=\"scroll\"`, what SectionNav wraps; removed in\n *  0.53 (no app renders SectionNav: refactor audit 2026-10-30, MOD-5). */\nexport interface SectionNavProps<T extends string> {\n  /** The section's pages, each with its `href` (a pill without one is a button that\n   *  calls `onSelect`). Labels short: the row is one line. */\n  items: NavPillItem<T>[];\n  /** The page that is open. `null`: none of them. */\n  current: T | null;\n  /** The section's name — the landmark's accessible name (\"Accounting\"). */\n  label: string;\n  /** Called with a pill's value on a click, before the router follows its link. */\n  onSelect?: (value: T) => void;\n  /** Your router's link. Default: the `<UiKitProvider linkComponent>`, then `<a>`. */\n  renderLink?: (props: NavPillLinkProps) => ReactElement;\n  /** Default `true`: only below `md`, where the sidebar that lists the same pages is\n   *  gone. `false` shows it at every width. */\n  phoneOnly?: boolean;\n  className?: string;\n  ref?: Ref<HTMLElement>;\n}\n\n/**\n * The pages of a section on a phone, as one row of pills under the page title (0.49\n * KIT-6) — kastlan's section pills, which each section page drew by hand.\n *\n * On a desktop the sidebar lists a group's pages; on a phone the AppShell's bar holds\n * the groups, and a group's pages are a sheet away. This row puts them on the page\n * itself: {@link NavPills} with `layout=\"scroll\"` — one line that scrolls sideways, faded\n * where it is cut, the open page scrolled into view (the row only, never the page). At\n * most 48 px high: 44 px pills, the touch target a finger needs, and 2 px above and\n * below. Each pill is a link (`aria-current=\"page\"` on the open one) and its own tab\n * stop; the row is a `<nav>` named by `label`.\n *\n * Place it right under the page's title (`PageHeader`); the AppShell's own row of a\n * group's pages above the bar (`mobileSubNav`) is the shell-wide alternative — use one,\n * not both, for the same pages.\n *\n * @deprecated 0.52 — `<NavPills layout=\"scroll\" itemClassName=\"min-h-11 focus-visible:ring-inset\"\n * className=\"md:hidden\">`, the same row; removed in 0.53. kastlan, whose section pills it\n * was made for (0.49 KIT-6), never adopted it: no app renders it (refactor audit\n * 2026-10-30, MOD-5).\n */\nexport function SectionNav<T extends string>({\n  items,\n  current,\n  label,\n  onSelect,\n  renderLink,\n  phoneOnly = true,\n  className,\n  ref,\n}: SectionNavProps<T>) {\n  return (\n    <NavPills\n      ref={ref}\n      aria-label={label}\n      items={items}\n      current={current}\n      onSelect={onSelect}\n      renderLink={renderLink}\n      layout=\"scroll\"\n      // The ring inside the pill: the row scrolls, so it clips what leaves its box.\n      itemClassName=\"min-h-11 focus-visible:ring-inset\"\n      className={cn(\"py-0.5 large:py-0\", phoneOnly && \"md:hidden\", className)}\n    />\n  );\n}\n"],"mappings":";AA0DI;AA1DJ,SAAS,UAAU;AACnB,SAAS,gBAAgB;AA8ClB,SAAS,WAA6B;AAAA,EAC3C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,YAAY;AAAA,EACZ;AAAA,EACA;AACF,GAAuB;AACrB,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,cAAY;AAAA,MACZ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,QAAO;AAAA,MAEP,eAAc;AAAA,MACd,WAAW,GAAG,qBAAqB,aAAa,aAAa,SAAS;AAAA;AAAA,EACxE;AAEJ;","names":[]}

package/dist/components/sign-chip-labels.d.ts

@@ -1,3 +0,0 @@
-import type { SignChipLabels } from "./sign-chip.js";
-/** @deprecated 0.52 — a `Chip` of your own, as keksdose's DirectionToggle is (MOD-5); removed in 0.53. */
-export declare const DEFAULT_SIGN_CHIP_LABELS: SignChipLabels;

package/dist/components/sign-chip-labels.js

@@ -1,11 +0,0 @@
-"use client";
-const DEFAULT_SIGN_CHIP_LABELS = {
-  outflow: "Outflow",
-  inflow: "Inflow",
-  direction: (current, next) => `Direction: ${current} \u2014 switch to ${next}`,
-  switchTo: (next) => `Switch to ${next}`
-};
-export {
-  DEFAULT_SIGN_CHIP_LABELS
-};
-//# sourceMappingURL=sign-chip-labels.js.map

package/dist/components/sign-chip-labels.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/components/sign-chip-labels.ts"],"sourcesContent":["// The English words of ./sign-chip, in a module with no component code: the English\n// catalogue (src/i18n/defaults.ts) imports them without the component, so `en` loads as one\n// chunk like the other languages (0.34, KS U8). ./sign-chip re-exports them.\n\nimport type { SignChipLabels } from \"./sign-chip\";\n\n/** @deprecated 0.52 — a `Chip` of your own, as keksdose's DirectionToggle is (MOD-5); removed in 0.53. */\nexport const DEFAULT_SIGN_CHIP_LABELS: SignChipLabels = {\n  outflow: \"Outflow\",\n  inflow: \"Inflow\",\n  direction: (current, next) => `Direction: ${current} — switch to ${next}`,\n  switchTo: (next) => `Switch to ${next}`,\n};\n"],"mappings":";AAOO,MAAM,2BAA2C;AAAA,EACtD,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,WAAW,CAAC,SAAS,SAAS,cAAc,OAAO,qBAAgB,IAAI;AAAA,EACvE,UAAU,CAAC,SAAS,aAAa,IAAI;AACvC;","names":[]}

package/dist/components/sign-chip.d.ts

@@ -1,77 +0,0 @@
-import { type LabelOverride } from "../i18n/kit-labels.js";
-import { DEFAULT_SIGN_CHIP_LABELS } from "./sign-chip-labels.js";
-/** The words a {@link SignChip} says — the `signChip` namespace of
- *  `<UiKitProvider labels>`, and per chip through its `labels` prop.
- *
- * @deprecated 0.52 — a `Chip` of your own, as keksdose's DirectionToggle is (MOD-5); removed in 0.53. */
-export interface SignChipLabels {
-    /** The chip's text while the figure is negative — money going out. */
-    outflow: string;
-    /** The chip's text while the figure is positive — money coming in. */
-    inflow: string;
-    /** The chip's accessible name and its tooltip: the state it is in, and what a press
-     *  turns it into — `current` and `next` are the two words above. The other option is
-     *  nowhere on screen to be read, so the name has to say both. */
-    direction: (current: string, next: string) => string;
-    /** 0.32: what a press does, in words under the chip at Large and Extra large —
-     *  `next` is the other direction's word ("Switch to Inflow"). The tooltip's half of
-     *  `direction`, shown, since a fact may not live only in a tooltip there (§4). */
-    switchTo: (next: string) => string;
-}
-export { DEFAULT_SIGN_CHIP_LABELS };
-/** @deprecated 0.52 — a `Chip` of your own, as keksdose's DirectionToggle is (MOD-5); removed in 0.53. */
-export interface SignChipProps {
-    /** The figure is negative (an outflow) — the same flag {@link AmountInput}'s
-     *  `negative` is, so one state feeds both: `<AmountInput negative={neg}
-     *  onNegativeChange={setNeg} />` and `<SignChip negative={neg}
-     *  onNegativeChange={setNeg} />`. */
-    negative: boolean;
-    /** A press: the other direction. */
-    onNegativeChange: (negative: boolean) => void;
-    disabled?: boolean;
-    /** Per-chip overrides of the `signChip` namespace. */
-    labels?: LabelOverride<SignChipLabels>;
-    /** On the chip. Place it in its row from here — keksdose's form passes `self-end`
-     *  to sit it on the display figure's baseline strip. */
-    className?: string;
-}
-/**
- * The SIGN of an amount, as one chip that shows only the state it is in — keksdose
- * K15, its `DirectionToggle` (feedback #417, #430, #431, dev#434) made a kit piece,
- * so the figure and its direction come from one package and wear one palette.
- *
- * WHY A CHIP, NOT A SEGMENTED CONTROL. A two-option toggle spends half its width
- * telling you what the figure is NOT, and at a phone's width it was the widest thing on
- * the form after the figure itself (#417). This sits beside the amount and reads as one
- * phrase with it — "−42,50 Outflow" — and a press flips it. Hiding the alternative costs
- * discoverability, so two things pay it back: the ± glyph and the swap arrows say "this
- * is a control", not a badge; and the name and tooltip spell out both the current state
- * and what a press will do.
- *
- * NOT A PRESSED/UNPRESSED TOGGLE. A {@link Chip} toggle has a FIXED label naming its
- * on-state, with `aria-pressed` carrying the state. Here the word IS the state, so it
- * is an action button with no `aria-pressed`: "Direction: Inflow, not pressed" would
- * name no on-state for "not pressed" to be the absence of. The name changing under
- * focus is the echo.
- *
- * THE COLOUR is the money pairing — the chip's `expense` / `income` tones, the same
- * `--money-expense` / `--money-income` that {@link AmountInput}'s `tone` paints the
- * figure with (dev#434): only the text and the border carry the tint, on a neutral
- * surface, because a filled pill next to a tinted figure reads as one smear.
- *
- * SIZE. `lg` on a phone — the 44px touch target beside a display figure that has no
- * field height to match — and from `md` up exactly a labelled field's 42px, so it never
- * stands taller than the fields in its grid row (#431).
- *
- * An exported chip rather than an `AmountInput signControl` slot: the slot would have
- * to own the row the two share, and every form lays that row out differently (beside
- * the figure on a phone, in a grid column on a desktop). The chip is the part that was
- * being re-written; the row stays the form's.
- *
- * Deprecated in 0.52, removed in 0.53 (decision 4 of the refactor audit 2026-10-30,
- * MOD-5): keksdose, whose chip this was (K15), kept its own `DirectionToggle` on `Chip`
- * and `Tooltip`, and no other app renders one.
- *
- * @deprecated 0.52 — a `Chip` of your own, as keksdose's DirectionToggle is (MOD-5); removed in 0.53.
- */
-export declare function SignChip({ negative, onNegativeChange, disabled, labels: labelsProp, className }: SignChipProps): import("react").JSX.Element;

package/dist/components/sign-chip.js

@@ -1,47 +0,0 @@
-"use client";
-import { jsx, jsxs } from "react/jsx-runtime";
-import { ArrowUpDown, Minus, Plus } from "lucide-react";
-import { Chip } from "./chip.js";
-import { Tooltip } from "./tooltip.js";
-import { cn } from "../lib/cn.js";
-import { useKitLabels } from "../i18n/kit-labels.js";
-import { useLargeText } from "../hooks/use-large-text.js";
-import { DEFAULT_SIGN_CHIP_LABELS } from "./sign-chip-labels.js";
-function SignChip({ negative, onNegativeChange, disabled, labels: labelsProp, className }) {
-  const labels = useKitLabels("signChip", DEFAULT_SIGN_CHIP_LABELS, labelsProp);
-  const current = negative ? labels.outflow : labels.inflow;
-  const next = negative ? labels.inflow : labels.outflow;
-  const name = labels.direction(current, next);
-  const large = useLargeText();
-  const chip = /* @__PURE__ */ jsxs(
-    Chip,
-    {
-      size: "lg",
-      tone: negative ? "expense" : "income",
-      icon: negative ? Minus : Plus,
-      onClick: () => onNegativeChange(!negative),
-      disabled,
-      "aria-label": name,
-      className: cn("shrink-0 gap-1.5 whitespace-nowrap px-3 font-medium md:min-h-0 md:py-2.5", !large && className),
-      children: [
-        current,
-        /* @__PURE__ */ jsx(ArrowUpDown, { className: "ms-1.5 inline size-3.5 align-[-0.2em] opacity-60", "aria-hidden": true })
-      ]
-    }
-  );
-  if (!large) {
-    return /* @__PURE__ */ jsx(Tooltip, { label: name, lazy: true, children: chip });
-  }
-  return (
-    // The caller's placement (`self-end`…) moves to the pair, which is now the row's item.
-    /* @__PURE__ */ jsxs("span", { "data-slot": "sign-chip", className: cn("inline-flex shrink-0 flex-col items-start gap-0.5", className), children: [
-      chip,
-      /* @__PURE__ */ jsx("span", { "aria-hidden": true, className: "text-xs text-muted", children: labels.switchTo(next) })
-    ] })
-  );
-}
-export {
-  DEFAULT_SIGN_CHIP_LABELS,
-  SignChip
-};
-//# sourceMappingURL=sign-chip.js.map

package/dist/components/sign-chip.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/components/sign-chip.tsx"],"sourcesContent":["import { ArrowUpDown, Minus, Plus } from \"lucide-react\";\nimport { Chip } from \"./chip\";\nimport { Tooltip } from \"./tooltip\";\nimport { cn } from \"../lib/cn\";\nimport { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport { useLargeText } from \"../hooks/use-large-text\";\nimport { DEFAULT_SIGN_CHIP_LABELS } from \"./sign-chip-labels\";\n\n// ── Labels ────────────────────────────────────────────────────────────────────\n\n/** The words a {@link SignChip} says — the `signChip` namespace of\n *  `<UiKitProvider labels>`, and per chip through its `labels` prop.\n *\n * @deprecated 0.52 — a `Chip` of your own, as keksdose's DirectionToggle is (MOD-5); removed in 0.53. */\nexport interface SignChipLabels {\n  /** The chip's text while the figure is negative — money going out. */\n  outflow: string;\n  /** The chip's text while the figure is positive — money coming in. */\n  inflow: string;\n  /** The chip's accessible name and its tooltip: the state it is in, and what a press\n   *  turns it into — `current` and `next` are the two words above. The other option is\n   *  nowhere on screen to be read, so the name has to say both. */\n  direction: (current: string, next: string) => string;\n  /** 0.32: what a press does, in words under the chip at Large and Extra large —\n   *  `next` is the other direction's word (\"Switch to Inflow\"). The tooltip's half of\n   *  `direction`, shown, since a fact may not live only in a tooltip there (§4). */\n  switchTo: (next: string) => string;\n}\n\n// Defined in ./sign-chip-labels, which holds no component code (0.34, KS U8).\nexport { DEFAULT_SIGN_CHIP_LABELS };\n\n/** @deprecated 0.52 — a `Chip` of your own, as keksdose's DirectionToggle is (MOD-5); removed in 0.53. */\nexport interface SignChipProps {\n  /** The figure is negative (an outflow) — the same flag {@link AmountInput}'s\n   *  `negative` is, so one state feeds both: `<AmountInput negative={neg}\n   *  onNegativeChange={setNeg} />` and `<SignChip negative={neg}\n   *  onNegativeChange={setNeg} />`. */\n  negative: boolean;\n  /** A press: the other direction. */\n  onNegativeChange: (negative: boolean) => void;\n  disabled?: boolean;\n  /** Per-chip overrides of the `signChip` namespace. */\n  labels?: LabelOverride<SignChipLabels>;\n  /** On the chip. Place it in its row from here — keksdose's form passes `self-end`\n   *  to sit it on the display figure's baseline strip. */\n  className?: string;\n}\n\n/**\n * The SIGN of an amount, as one chip that shows only the state it is in — keksdose\n * K15, its `DirectionToggle` (feedback #417, #430, #431, dev#434) made a kit piece,\n * so the figure and its direction come from one package and wear one palette.\n *\n * WHY A CHIP, NOT A SEGMENTED CONTROL. A two-option toggle spends half its width\n * telling you what the figure is NOT, and at a phone's width it was the widest thing on\n * the form after the figure itself (#417). This sits beside the amount and reads as one\n * phrase with it — \"−42,50 Outflow\" — and a press flips it. Hiding the alternative costs\n * discoverability, so two things pay it back: the ± glyph and the swap arrows say \"this\n * is a control\", not a badge; and the name and tooltip spell out both the current state\n * and what a press will do.\n *\n * NOT A PRESSED/UNPRESSED TOGGLE. A {@link Chip} toggle has a FIXED label naming its\n * on-state, with `aria-pressed` carrying the state. Here the word IS the state, so it\n * is an action button with no `aria-pressed`: \"Direction: Inflow, not pressed\" would\n * name no on-state for \"not pressed\" to be the absence of. The name changing under\n * focus is the echo.\n *\n * THE COLOUR is the money pairing — the chip's `expense` / `income` tones, the same\n * `--money-expense` / `--money-income` that {@link AmountInput}'s `tone` paints the\n * figure with (dev#434): only the text and the border carry the tint, on a neutral\n * surface, because a filled pill next to a tinted figure reads as one smear.\n *\n * SIZE. `lg` on a phone — the 44px touch target beside a display figure that has no\n * field height to match — and from `md` up exactly a labelled field's 42px, so it never\n * stands taller than the fields in its grid row (#431).\n *\n * An exported chip rather than an `AmountInput signControl` slot: the slot would have\n * to own the row the two share, and every form lays that row out differently (beside\n * the figure on a phone, in a grid column on a desktop). The chip is the part that was\n * being re-written; the row stays the form's.\n *\n * Deprecated in 0.52, removed in 0.53 (decision 4 of the refactor audit 2026-10-30,\n * MOD-5): keksdose, whose chip this was (K15), kept its own `DirectionToggle` on `Chip`\n * and `Tooltip`, and no other app renders one.\n *\n * @deprecated 0.52 — a `Chip` of your own, as keksdose's DirectionToggle is (MOD-5); removed in 0.53.\n */\nexport function SignChip({ negative, onNegativeChange, disabled, labels: labelsProp, className }: SignChipProps) {\n  const labels = useKitLabels(\"signChip\", DEFAULT_SIGN_CHIP_LABELS, labelsProp);\n  const current = negative ? labels.outflow : labels.inflow;\n  const next = negative ? labels.inflow : labels.outflow;\n  const name = labels.direction(current, next);\n  // §4: at Large the chip's word is joined by what a press does, as a line under it —\n  // and the bubble that said only that goes.\n  const large = useLargeText();\n  const chip = (\n    <Chip\n      size=\"lg\"\n      tone={negative ? \"expense\" : \"income\"}\n      icon={negative ? Minus : Plus}\n      onClick={() => onNegativeChange(!negative)}\n      disabled={disabled}\n      aria-label={name}\n      // `gap-1.5 px-3`: the chip's narrower body, because on a 375px screen every\n      // pixel of it is taken from the figure beside it (#430). `md:py-2.5` with the\n      // hairline border is the 42px a labelled field measures (#431).\n      className={cn(\"shrink-0 gap-1.5 whitespace-nowrap px-3 font-medium md:min-h-0 md:py-2.5\", !large && className)}\n    >\n      {current}\n      {/* The swap arrows after the word, in the label's own row: decoration (the\n            name already says what a press does), set a little apart from the word. */}\n      <ArrowUpDown className=\"ms-1.5 inline size-3.5 align-[-0.2em] opacity-60\" aria-hidden />\n    </Chip>\n  );\n  if (!large) {\n    return (\n      <Tooltip label={name} lazy>\n        {chip}\n      </Tooltip>\n    );\n  }\n  return (\n    // The caller's placement (`self-end`…) moves to the pair, which is now the row's item.\n    <span data-slot=\"sign-chip\" className={cn(\"inline-flex shrink-0 flex-col items-start gap-0.5\", className)}>\n      {chip}\n      {/* Hidden from the accessibility tree: the chip's name already says it. */}\n      <span aria-hidden className=\"text-xs text-muted\">\n        {labels.switchTo(next)}\n      </span>\n    </span>\n  );\n}\n"],"mappings":";AAiGI,SAeE,KAfF;AAjGJ,SAAS,aAAa,OAAO,YAAY;AACzC,SAAS,YAAY;AACrB,SAAS,eAAe;AACxB,SAAS,UAAU;AACnB,SAAS,oBAAwC;AACjD,SAAS,oBAAoB;AAC7B,SAAS,gCAAgC;AAkFlC,SAAS,SAAS,EAAE,UAAU,kBAAkB,UAAU,QAAQ,YAAY,UAAU,GAAkB;AAC/G,QAAM,SAAS,aAAa,YAAY,0BAA0B,UAAU;AAC5E,QAAM,UAAU,WAAW,OAAO,UAAU,OAAO;AACnD,QAAM,OAAO,WAAW,OAAO,SAAS,OAAO;AAC/C,QAAM,OAAO,OAAO,UAAU,SAAS,IAAI;AAG3C,QAAM,QAAQ,aAAa;AAC3B,QAAM,OACJ;AAAA,IAAC;AAAA;AAAA,MACC,MAAK;AAAA,MACL,MAAM,WAAW,YAAY;AAAA,MAC7B,MAAM,WAAW,QAAQ;AAAA,MACzB,SAAS,MAAM,iBAAiB,CAAC,QAAQ;AAAA,MACzC;AAAA,MACA,cAAY;AAAA,MAIZ,WAAW,GAAG,4EAA4E,CAAC,SAAS,SAAS;AAAA,MAE5G;AAAA;AAAA,QAGD,oBAAC,eAAY,WAAU,oDAAmD,eAAW,MAAC;AAAA;AAAA;AAAA,EACxF;AAEF,MAAI,CAAC,OAAO;AACV,WACE,oBAAC,WAAQ,OAAO,MAAM,MAAI,MACvB,gBACH;AAAA,EAEJ;AACA;AAAA;AAAA,IAEE,qBAAC,UAAK,aAAU,aAAY,WAAW,GAAG,qDAAqD,SAAS,GACrG;AAAA;AAAA,MAED,oBAAC,UAAK,eAAW,MAAC,WAAU,sBACzB,iBAAO,SAAS,IAAI,GACvB;AAAA,OACF;AAAA;AAEJ;","names":[]}

package/dist/lib/isin.d.ts

@@ -1,38 +0,0 @@
-/**
- * ISIN helpers — ISO 6166 — for keksdose, whose securities holdings are keyed by ISIN
- * and whose import and edit forms checked only the shape (two letters, ten
- * characters): a mistyped ISIN saved happily and then matched no price feed.
- *
- * An ISIN is twelve characters: a two-letter prefix (the issuing country, or a
- * supranational code such as `XS`), nine letters or digits (the national number) and
- * one check digit. The check digit is the Luhn digit of the first eleven characters
- * with every letter expanded to two digits (A = 10 … Z = 35) — which is all that is
- * checked here. Whether the prefix is an assigned code, and whether the security
- * exists, is a lookup, not a checksum.
- *
- * Deprecated in 0.52, removed in 0.53 (decision 4 of the refactor audit 2026-10-30,
- * MOD-5): keksdose, which they were written for, never imported them, and no other app
- * does.
- */
-/**
- * The ISIN as it is printed: upper case, unbroken (ISO 6166 has no grouping), with
- * the spaces and hyphens a paste from a broker's statement carries dropped.
- *
- * @deprecated 0.52 — none: no app checks an ISIN with it; copy lib/isin.ts (MOD-5); removed in 0.53.
- */
-export declare function formatIsin(value: string): string;
-/**
- * The check digit for the first eleven characters of an ISIN (prefix and national
- * number). For BUILDING one — a test fixture, a demo — rather than checking it.
- *
- * @deprecated 0.52 — none: no app checks an ISIN with it; copy lib/isin.ts (MOD-5); removed in 0.53.
- */
-export declare function isinCheckDigit(body: string): string;
-/**
- * Whether `value` is a valid ISIN: two letters, nine letters or digits, one digit,
- * and a matching Luhn check digit over the letter-expanded form. Spaces, hyphens and
- * lower case are fine (see {@link formatIsin}).
- *
- * @deprecated 0.52 — none: no app checks an ISIN with it; copy lib/isin.ts (MOD-5); removed in 0.53.
- */
-export declare function isValidIsin(value: string): boolean;