@eifi1/ui-kit 0.52.0 → 0.54.0

package/src/shell/account-menu-language.tsx

@@ -39,11 +39,15 @@ function flagOf(lang: AccountMenuLanguageOption): ReactNode {
   );
 }
 
-/** {@link AccountMenuLanguageProps} but the handler. */
-interface AccountMenuLanguageBaseProps {
+export interface AccountMenuLanguageProps {
   languages: readonly AccountMenuLanguageOption[];
   /** The active language's code. */
   value: string | undefined;
+  /** A pick: the app sets the device's language and, signed in, the account's
+   *  (settings §6.2). `value` + `onChange`, as every kit control pairs them
+   *  (CONTRIBUTING §4; refactor audit 2026-10-30, API-5). Required: 0.53 removed the
+   *  deprecated `onPick`. */
+  onChange: (code: string) => void;
   /** The account menu's `close` (from `TopBarActionMenu`'s `children`): a pick shuts it. */
   close?: () => void;
   /** The row's name. Default: `topBar.language` ("Language"). */
@@ -52,28 +56,6 @@ interface AccountMenuLanguageBaseProps {
   defaultOpen?: boolean;
 }
 
-/**
- * `onChange`, or the deprecated `onPick`, is required: with both optional, a row an app
- * moved off `onPick` without adding `onChange` — or with it misspelt — compiled, and a
- * pick only closed the menu (0.52 code review, account-menu-language.tsx).
- */
-export type AccountMenuLanguageProps = AccountMenuLanguageBaseProps &
-  (
-    | {
-        /** A pick: the app sets the device's language and, signed in, the account's
-         *  (settings §6.2). `value` + `onChange`, as every kit control pairs them
-         *  (CONTRIBUTING §4; refactor audit 2026-10-30, API-5). */
-        onChange: (code: string) => void;
-        /** @deprecated 0.52 — `onChange` (the same call); removed in 0.53. */
-        onPick?: (code: string) => void;
-      }
-    | {
-        onChange?: undefined;
-        /** @deprecated 0.52 — `onChange` (the same call); removed in 0.53. */
-        onPick: (code: string) => void;
-      }
-  );
-
 /**
  * The language choice INSIDE the account menu (docs/top-bar-harmonization.md §2.3),
  * keksdose's sub-list: a `Disclosure variant="menu"` row — the globe, "Language", the
@@ -89,12 +71,10 @@ export function AccountMenuLanguage({
   languages,
   value,
   onChange,
-  onPick,
   close,
   label,
   defaultOpen = false,
 }: AccountMenuLanguageProps) {
-  const change = onChange ?? onPick;
   const words = useKitLabels("topBar", DEFAULT_TOP_BAR_LABELS);
   const [open, setOpen] = useState(defaultOpen);
   const active = languages.find((l) => l.code === value);
@@ -131,7 +111,7 @@ export function AccountMenuLanguage({
               <MenuItem
                 checked={lang.code === value}
                 onClick={() => {
-                  change?.(lang.code);
+                  onChange(lang.code);
                   setOpen(false);
                   close?.();
                 }}

package/src/shell/account-menu-text-size.tsx

@@ -4,44 +4,26 @@ import { useAppearanceLabels, type AppearanceLabels } from "../components/appear
 import type { LabelOverride } from "../i18n/kit-labels";
 import { TEXT_SIZES, useTextSize, type TextSize } from "../theme/text-size";
 
-/** {@link AccountMenuTextSizeProps} but the handler. */
-interface AccountMenuTextSizeBaseProps {
+export interface AccountMenuTextSizeProps {
   /** The size in force. Default: the one on `<html>` ({@link useTextSize}), which is the
    *  size whoever applied it put there. */
   value?: TextSize;
+  /**
+   * A step: the next size down or up. The app applies it and keeps it as its
+   * Settings ▸ Appearance does — `useAccountAppearance`'s `pickTextSize` (this
+   * device, and the account when signed in), with `appearance.saveFailed` as the
+   * toast when the account refused. The kit does not apply it itself, so the two
+   * places can never disagree. `value` + `onChange`, as every kit control pairs them
+   * (CONTRIBUTING §4; refactor audit 2026-10-30, API-5). Required: 0.53 removed the
+   * deprecated `onPick`.
+   */
+  onChange: (size: TextSize) => void;
   /** The row's name. Default: `appearance.textSize` ("Text size"). */
   label?: string;
   /** The `appearance` words (`textSize`, `textSizes`, `textSmaller`, `textLarger`). */
   labels?: LabelOverride<AppearanceLabels>;
 }
 
-/**
- * `onChange`, or the deprecated `onPick`, is required: with both optional, a row an app
- * moved off `onPick` without adding `onChange` — or with it misspelt — compiled, and A− /
- * A+ stayed enabled and changed nothing (0.52 code review, account-menu-language.tsx).
- */
-export type AccountMenuTextSizeProps = AccountMenuTextSizeBaseProps &
-  (
-    | {
-        /**
-         * A step: the next size down or up. The app applies it and keeps it as its
-         * Settings ▸ Appearance does — `useAccountAppearance`'s `pickTextSize` (this
-         * device, and the account when signed in), with `appearance.saveFailed` as the
-         * toast when the account refused. The kit does not apply it itself, so the two
-         * places can never disagree. `value` + `onChange`, as every kit control pairs them
-         * (CONTRIBUTING §4; refactor audit 2026-10-30, API-5).
-         */
-        onChange: (size: TextSize) => void;
-        /** @deprecated 0.52 — `onChange` (the same call); removed in 0.53. */
-        onPick?: (size: TextSize) => void;
-      }
-    | {
-        onChange?: undefined;
-        /** @deprecated 0.52 — `onChange` (the same call); removed in 0.53. */
-        onPick: (size: TextSize) => void;
-      }
-  );
-
 /**
  * The text size one tap away, INSIDE the account menu (0.46, keksdose live #426, its
  * `TextSizeRow`): the row's icon and name, the size in force, and A− / A+, which step
@@ -55,15 +37,14 @@ export type AccountMenuTextSizeProps = AccountMenuTextSizeBaseProps &
  * behind it and can step again. The size's name is a polite live region, so a step is
  * announced.
  */
-export function AccountMenuTextSize({ value, onChange, onPick, label, labels: labelsProp }: AccountMenuTextSizeProps) {
-  const change = onChange ?? onPick;
+export function AccountMenuTextSize({ value, onChange, label, labels: labelsProp }: AccountMenuTextSizeProps) {
   const labels = useAppearanceLabels(labelsProp);
   const onHtml = useTextSize().size;
   const size = value ?? onHtml;
   const index = TEXT_SIZES.indexOf(size);
   const step = (by: -1 | 1) => {
     const next = TEXT_SIZES[index + by];
-    if (next) change?.(next);
+    if (next) onChange(next);
   };
   return (
     <li data-account-menu-text-size="" className="flex items-center gap-2 px-3 py-1.5 text-sm">

package/src/shell/app-shell.tsx

@@ -201,19 +201,6 @@ export function pickMobileBar<T>(
   };
 }
 
-/**
- * Split the bar's entries into the cells shown and the ones under "More", in the app's
- * order (§10.7: the app puts its four most used first, or orders by role). One hidden
- * entry is no saving — the More cell would take its place — so the bar then shows them
- * all: the cell count is the same either way, and a real entry beats a detour.
- */
-export function splitMobileBar<T>(entries: readonly T[], max: number): { shown: T[]; hidden: T[] } {
-  // Entries before More, as 0.32 counted them; {@link pickMobileBar} counts cells.
-  const limit = Math.max(1, Math.floor(max));
-  if (entries.length <= limit + 1) return { shown: [...entries], hidden: [] };
-  return { shown: entries.slice(0, limit), hidden: entries.slice(limit) };
-}
-
 /** The bar's cell count at `size`: `mobileMaxItems`, else the default. */
 function mobileCells(maxItems: AppShellProps["mobileMaxItems"], size: TextSize): number {
   if (maxItems === undefined) return DEFAULT_MOBILE_MAX_ITEMS[size];

package/src/shell/company-switcher.tsx

@@ -56,7 +56,7 @@ export interface CompanySwitcherProps<Id extends string | number> {
  * The company switcher in the top bar (docs/auth-harmonization.md §5.3, §8): a kastlan
  * user may belong to several companies, and the access token carries the current one,
  * so switching is a request for new tokens — `onSwitch`, the app's. Built on
- * {@link OptionSwitcherMenu}, like `RoleSwitcher`: the icon trigger, the current company
+ * {@link OptionSwitcherMenu}: the icon trigger, the current company
  * in its tooltip, the list with a check on the current one.
  *
  * **Only for more than one company** — a user in one company has nothing to switch, and

package/src/shell/dev-menu.tsx

@@ -95,7 +95,7 @@ const isRow = (entry: TopBarMenuEntry) => entry.kind !== "heading" && entry.kind
 
 /**
  * The top bar's local-dev menu (docs/top-bar-harmonization.md §2.7, §2.7.1, §6.2, §6.3):
- * ONE amber flask, `RoleSwitcher`'s, over the kit's Account section and the app's own.
+ * ONE amber flask over the kit's Account section and the app's own.
  *
  * 0.42's `DevSwitchers` drew a flask per switcher and had no place for anything else,
  * and an app has more dev controls than a role and a plan — keksdose's budget role, a

package/src/shell/top-bar-parts-labels.ts

@@ -6,7 +6,7 @@ import { useKitLabels, type LabelOverride } from "../i18n/kit-labels";
  * `DevSwitchers`, whose words these still are, §2.7.1). A module
  * of words with no component code, like every `*-labels.ts` (0.34, KS U8). The language
  * sub-list (`AccountMenuLanguage`) names itself with `topBar.language`, and the role in the
- * dev flask's name is `topBar.role`, as `RoleSwitcher`'s tooltip.
+ * dev flask's name is `topBar.role`.
  */
 
 /** `TourMenu`'s words (§2.4). */

package/src/shell.ts

@@ -4,17 +4,20 @@
 // `react-router`: AppShell renders NavLink and TopBarActionMenu renders Link.
 export * from "./shell/topbar-controls";
 export * from "./shell/top-bar";
-export * from "./shell/app-shell";
-// 0.52: the slice's share of the 55 names no app reads (refactor audit 2026-10-30, API-4,
-// decision 4), tagged on their specifiers as the barrel's are — the modules keep them.
+// Named, not `*`: 0.53 took `pickMobileBar` off the surface (deprecated in 0.52, refactor
+// audit 2026-10-30, API-4) — AppShell's own — and removed `splitMobileBar`, which nothing
+// called any more.
 export {
-  /** @deprecated 0.52 — `AppShell`, which picks its phone bar with it (API-4); removed in 0.53 */
-  pickMobileBar,
-  /** @deprecated 0.52 — `AppShell`, which splits its phone bar with it (API-4); removed in 0.53 */
-  splitMobileBar,
+  DEFAULT_APP_SHELL_MORE_LABELS,
+  DEFAULT_MOBILE_MAX_ITEMS,
+  AppShell,
+  type AppShellSubItem,
+  type AppShellNavItem,
+  type AppShellSidebarFooterItem,
+  type AppShellMoreLabels,
+  type AppShellProps,
 } from "./shell/app-shell";
 export * from "./shell/option-switcher-menu";
-export * from "./shell/role-switcher";
 export * from "./shell/topbar-action-menu";
 export * from "./shell/top-bar-brand";
 export * from "./shell/auth-layout";
@@ -33,20 +36,9 @@ export type { UseAdminMenuEntryOptions } from "./shell/admin-menu";
 export { AdminWaitingBadge } from "./shell/admin-menu";
 export type { AdminWaitingBadgeProps } from "./shell/admin-menu";
 // 0.31.0: the settings and admin pages' shell (docs/settings-harmonization.md §3, §5).
-export {
-  SettingsLayout,
-  /** @deprecated 0.52 — `SettingsLayout`, which shows its search past that many entries (API-4); removed in 0.53 */
-  SETTINGS_SEARCH_THRESHOLD,
-} from "./settings/settings-layout";
+export { SettingsLayout } from "./settings/settings-layout";
 export type { SettingsLayoutProps, SettingsLayoutWidth, SettingsDocumentTitleParts } from "./settings/settings-layout";
-export {
-  useSettingsRoute,
-  /** @deprecated 0.52 — `useSettingsRoute`, which resolves the location with it (API-4); removed in 0.53 */
-  resolveSettingsLocation,
-  settingsFromListState,
-  /** @deprecated 0.52 — `settingsFromListState` and `useSettingsRoute`, which write and read it (API-4); removed in 0.53 */
-  SETTINGS_FROM_LIST_STATE,
-} from "./settings/use-settings-route";
+export { useSettingsRoute, settingsFromListState } from "./settings/use-settings-route";
 export type {
   UseSettingsRouteOptions,
   SettingsRoute,
@@ -55,14 +47,7 @@ export type {
   SettingsLocationRules,
   SettingsLocationResult,
 } from "./settings/use-settings-route";
-export {
-  useSettingsFocus,
-  useFocusParam,
-  /** @deprecated 0.52 — `useSettingsFocus` / `useFocusParam`, which ring the card with it (API-4); removed in 0.53 */
-  SETTINGS_FOCUS_RING,
-  /** @deprecated 0.52 — `useSettingsFocus` / `useFocusParam`, which hold the ring that long (API-4); removed in 0.53 */
-  SETTINGS_FOCUS_MS,
-} from "./settings/use-settings-focus";
+export { useSettingsFocus, useFocusParam } from "./settings/use-settings-focus";
 export { SettingsSection } from "./settings/settings-section";
 export type { SettingsSectionProps } from "./settings/settings-section";
 export { useSettingsLayout } from "./settings/settings-context";
@@ -99,11 +84,7 @@ export type { PublicHeaderProps, PublicHeaderBrand } from "./landing/public-head
 // 0.42.0: the top bar's shared parts (docs/top-bar-harmonization.md §3.1) — the slots in
 // §2.1's order, the account menu's language sub-list, the tours menu, the sync status, the
 // local-dev menu, and their words.
-export {
-  TopBarActions,
-  /** @deprecated 0.52 — `TopBarActions`, which puts its slots in that order (API-4); removed in 0.53 */
-  TOP_BAR_ACTION_ORDER,
-} from "./shell/top-bar-actions";
+export { TopBarActions } from "./shell/top-bar-actions";
 export type { TopBarActionsProps } from "./shell/top-bar-actions";
 export { AccountMenuLanguage } from "./shell/account-menu-language";
 export type { AccountMenuLanguageProps, AccountMenuLanguageOption } from "./shell/account-menu-language";
@@ -112,19 +93,11 @@ export { AccountMenuTextSize } from "./shell/account-menu-text-size";
 export type { AccountMenuTextSizeProps } from "./shell/account-menu-text-size";
 export { TourMenu } from "./shell/tour-menu";
 export type { TourMenuProps, TourMenuTour } from "./shell/tour-menu";
-export {
-  SyncStatusIndicator,
-  /** @deprecated 0.52 — `SyncStatusIndicator`, which derives its state with it (API-4); removed in 0.53 */
-  syncState,
-} from "./shell/sync-status-indicator";
+export { SyncStatusIndicator } from "./shell/sync-status-indicator";
 export type { SyncStatus, SyncState, SyncStatusScope, SyncStatusIndicatorProps } from "./shell/sync-status-indicator";
 // 0.51 (§2.7.1, keksdose): one flask, the kit's Account section and the app's own dev
 // sections. 0.42's `DevSwitchers`, a DevMenu with no sections since 0.51, went in 0.52.
-export {
-  DevMenu,
-  /** @deprecated 0.52 — `DevMenu`, which keeps the role there unless `storageKey` names another key (API-4); removed in 0.53 */
-  DEV_ORIGINAL_ROLE_KEY,
-} from "./shell/dev-menu";
+export { DevMenu } from "./shell/dev-menu";
 export type { DevMenuProps, DevMenuSection } from "./shell/dev-menu";
 export { DEFAULT_TOP_BAR_PARTS_LABELS, useTopBarPartsLabels } from "./shell/top-bar-parts-labels";
 export type {

package/src/sync.ts

@@ -4,13 +4,7 @@
 // The only entry point that imports `dexie` — an optional peer for that reason. It never loads
 // `/offline`'s TanStack and idb-keyval peers: the leaf utilities both entries export live in
 // one module of their own (src/offline/local-first.ts). NOT re-exported from the main barrel.
-export {
-  createSyncDb,
-  rowByPk,
-  SYNC_DB_PK_INDEX,
-  /** @deprecated 0.52 — `createSyncDb`, which declares them (`extraStores` for an app's own) (API-4); removed in 0.53 */
-  SYNC_DB_STORES,
-} from "./sync/db";
+export { createSyncDb, rowByPk, SYNC_DB_PK_INDEX } from "./sync/db";
 export type {
   CreateSyncDbOptions,
   OutboxChange,
@@ -20,14 +14,7 @@ export type {
   SyncedRow,
   SyncMetaEntry,
 } from "./sync/db";
-export {
-  createSyncEngine,
-  DEFAULT_HOLD_CODES,
-  /** @deprecated 0.52 — `createSyncEngine`, whose `backoffMs` defaults to it (API-4); removed in 0.53 */
-  DEFAULT_SYNC_BACKOFF_MS,
-  releaseSyncEngine,
-  syncEngineFor,
-} from "./sync/engine";
+export { createSyncEngine, DEFAULT_HOLD_CODES, releaseSyncEngine, syncEngineFor } from "./sync/engine";
 export type {
   SyncCounts,
   SyncEngine,

package/src/theme/chart-palette.ts

@@ -74,8 +74,6 @@ export const CHART_ROLES = {
   outline: "var(--chart-ink)",
 } as const;
 
-/** `--chart-ink` per theme, as hex (tokens.css holds the same two). */
-export const CHART_INK_HEX = { light: "#1a1a17", dark: "#f0efe8" } as const;
 /** `--chart-muted` per theme, as hex (tokens.css holds the same two). */
 export const CHART_MUTED_HEX = { light: "#6b6a63", dark: "#a8a79f" } as const;
 

package/tokens.css

@@ -397,13 +397,13 @@ html[data-text-size="xlarge"] {
      was: beside red-700 that orange read as a second error colour, and "unsaved" has
      to look like a caution, not an alarm. Light, it is amber-600's hue and chroma at a
      SOLVED lightness (3.1:1 on the worst surface). Below 4.5:1, so it is not a TEXT
-     colour: `FieldSyncIndicator` prints its words in `--text-secondary` beside it.
+     colour: a state's words go in `--text-secondary` beside it.
 
      GREEN AND RED ARE THE CLASSIC CVD-UNSAFE PAIR, and the rest of this file goes out
      of its way to avoid it — the money trio is teal/amber/violet for exactly this
      reason. They are used here because the states were specified in these colours, so
-     `FieldSyncIndicator` gives every state its own ICON as well and colour is never
-     the only signal. Do not drop the icons.  */
+     every state needs its own ICON as well and colour is never the only signal (as
+     FieldSyncIndicator, which drew them until 0.53, gave it). Do not drop the icons.  */
   --status-synced: #166534; /* green-800  — persisted */
   --status-pending: #1d4ed8; /* blue-700   — in flight */
   --status-edited: #bf6800; /* solved     — dirty, not yet saved */
@@ -871,7 +871,7 @@ html[data-text-size="xlarge"] {
  * counts a `[var(--role)]` class, and a `ring-[length:var(--…)]` width, for any token that
  * has a utility here and allows none (`ROLE_BUDGET` 0). What stays `[var()]` has no
  * utility on purpose: the chart colours (lookup tables of `--chart-N`), `--status-*`
- * (FieldSync's own four), and the cross-property one-offs (`bg-[var(--border)]` as a
+ * (the field-sync four), and the cross-property one-offs (`bg-[var(--border)]` as a
  * divider, `ring-[var(--text-primary)]`) — a utility there would undo the property
  * scoping above. `check:tailwind` asserts one per namespace survives a build, and the
  * README's "Styling" table is generated from this block (`scripts/gen-styling-inventory.mjs`).

package/dist/billing/dialog-close.d.ts

@@ -1,29 +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 declare function dialogClose({ onClose, onOpenChange }: CloseProps): () => void;
-export {};

package/dist/billing/dialog-close.js

@@ -1,8 +0,0 @@
-"use client";
-function dialogClose({ onClose, onOpenChange }) {
-  return () => onClose ? onClose() : onOpenChange?.(false);
-}
-export {
-  dialogClose
-};
-//# sourceMappingURL=dialog-close.js.map

package/dist/billing/dialog-close.js.map

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

package/dist/components/field-sync-labels.d.ts

@@ -1,3 +0,0 @@
-import type { FieldSyncLabels } from "./field-sync.js";
-/** @deprecated 0.52 — none: no app uses the FieldSync family (MOD-5); removed in 0.53. */
-export declare const DEFAULT_FIELD_SYNC_LABELS: FieldSyncLabels;

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

@@ -1,12 +0,0 @@
-"use client";
-const DEFAULT_FIELD_SYNC_LABELS = {
-  synced: "Saved",
-  edited: "Unsaved changes",
-  pending: "Saving\u2026",
-  error: "Could not save",
-  retry: "Retry"
-};
-export {
-  DEFAULT_FIELD_SYNC_LABELS
-};
-//# sourceMappingURL=field-sync-labels.js.map

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

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/components/field-sync-labels.ts"],"sourcesContent":["// The English words of ./field-sync, 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). ./field-sync re-exports them.\n\nimport type { FieldSyncLabels } from \"./field-sync\";\n\n/** @deprecated 0.52 — none: no app uses the FieldSync family (MOD-5); removed in 0.53. */\nexport const DEFAULT_FIELD_SYNC_LABELS: FieldSyncLabels = {\n  synced: \"Saved\",\n  edited: \"Unsaved changes\",\n  pending: \"Saving…\",\n  error: \"Could not save\",\n  retry: \"Retry\",\n};\n"],"mappings":";AAOO,MAAM,4BAA6C;AAAA,EACxD,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,OAAO;AAAA,EACP,OAAO;AACT;","names":[]}

package/dist/components/field-sync.d.ts

@@ -1,186 +0,0 @@
-import type { ReactNode } from "react";
-import { type LabelOverride } from "../i18n/kit-labels.js";
-import { DEFAULT_FIELD_SYNC_LABELS } from "./field-sync-labels.js";
-/**
- * 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;
-}
-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;
-}
-/**
- * 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 declare function useFieldSync<T>({ value, onSave, debounceMs, equals, onError, }: UseFieldSyncOptions<T>): UseFieldSyncReturn<T>;
-/** @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 declare function FieldSyncIndicator({ state, error, labels, showLabel, onRetry, className, }: FieldSyncIndicatorProps): import("react").JSX.Element;
-/**
- * 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 declare const FIELD_SYNC_FRAME: Record<FieldSyncState, string>;
-/** 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 declare 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 declare function FieldSyncRow<T>({ sync, children, className, labels, onRetry, saveOnBlur, savedMs, }: FieldSyncRowProps<T>): import("react").JSX.Element;