@eifi1/ui-kit 0.51.7 → 0.52.0

package/dist/lib/format.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/format.ts"],"sourcesContent":["import { useMemo } from \"react\";\nimport { useKitLocale, useKitTimeZone } from \"../i18n/kit-labels\";\nimport { parseIsoDate } from \"./dates\";\nimport { formatWithMinus, type MinusStyle } from \"./minus\";\nimport { roundHalfAway } from \"./round\";\n\nexport type { MinusStyle } from \"./minus\";\n// 0.50 (KIT-1 follow-up): the kit's minus for an app's OWN `Intl.NumberFormat` wrapper.\nexport { formatWithMinus } from \"./minus\";\n\n/**\n * Number, money, percentage, date and relative-time formatting — `Intl`, in one place,\n * for the figures an app prints OUTSIDE a kit component.\n *\n * Each app grew its own: kastlan's `utils/formatters.ts` (a Swiss-pinned\n * `formatNumber`/`formatCurrency`, a date-fns `formatDate`, and a `formatRelativeTime`\n * whose \"5m ago\" / \"3h ago\" / \"2d ago\" stayed English in every language), its tenancy\n * `format.ts` (`formatChf`, a `formatPct` gluing a \"+\" onto `toFixed(2)`), keksdose's\n * own set. Every one of them is `Intl` with a locale bolted on, so the only thing\n * worth sharing is the locale — and the kit already has one, the provider's.\n *\n * The plain functions take a `locale` (none: the runtime default, as every `Intl` API\n * reads `undefined`). Inside a component, {@link useKitFormat} hands back the same\n * functions bound to the `<UiKitProvider locale>`, so a page formats exactly like the\n * kit components on it.\n *\n * A missing value — `null`, `undefined`, an unparseable date — formats as `empty`\n * (default \"—\", the dash `StatTile` shows for no value), never as \"NaN\" or \"Invalid\n * Date\". A number may also arrive as a numeric STRING (0.49, KIT-2) — \"1850.00\", \"-12.5\",\n * \"0\": a Decimal field off a Python API — and is formatted like the number. Anything\n * else (a non-numeric string, an object, `NaN`, ±`Infinity`) prints `empty` too, but is\n * a bug upstream rather than a gap in the data, so a development build says so on the\n * console, once per call site. Zero is a figure: `0` and `\"0\"` print \"CHF 0.00\", never\n * the dash.\n *\n * A negative figure carries the typographic minus, U+2212 (0.49, KIT-1), in every\n * locale — `Intl` writes a hyphen in most. `minus: \"ascii\"` for text a machine reads\n * back (a CSV, the clipboard).\n */\n\n/** What every formatter here prints for a missing value, unless told otherwise. */\nexport const EMPTY_FORMATTED_VALUE = \"—\";\n\n/** Fraction digits: a number pins both the minimum and the maximum (`2` → \"3.10\");\n *  an object sets them apart (a meter reading, 1–3). */\nexport type FormatDigits = number | { min?: number; max?: number };\n\ninterface BaseOptions {\n  /** BCP 47 tag. Left out: the runtime default (the hook: the provider's). */\n  locale?: string;\n  /** Printed for a missing value. Default {@link EMPTY_FORMATTED_VALUE}. */\n  empty?: string;\n}\n\n/** The options every number formatter shares (money and percent carry their own unit). */\nexport interface FormatNumberBaseOptions extends BaseOptions {\n  digits?: FormatDigits;\n  /** Compact notation: 12 400 → \"12K\". */\n  compact?: boolean;\n  /** `\"exceptZero\"` for a change (\"+3\", \"−3\", \"0\"). Default: the minus only. */\n  signDisplay?: Intl.NumberFormatOptions[\"signDisplay\"];\n  /** Any further `Intl.NumberFormat` options, merged over the ones above. */\n  options?: Intl.NumberFormatOptions;\n  /**\n   * The minus sign of a negative figure (0.49, KIT-1). `\"typographic\"` (default):\n   * U+2212, as wide as \"+\" and the digits, as `SignedAmount` prints it — in every\n   * locale, also where `Intl` writes a hyphen. `\"ascii\"`: U+002D, for an export a\n   * machine parses back (a CSV download, the clipboard) — there, also pass\n   * `options: { useGrouping: false }` or write the raw number.\n   */\n  minus?: MinusStyle;\n}\n\n/** The options {@link formatNumber} takes: the shared ones plus a free-text `unit`. */\nexport interface FormatNumberOptions extends FormatNumberBaseOptions {\n  /**\n   * A unit printed after the figure, joined by a narrow no-break space (U+202F):\n   * \"3.400 N\", \"12 kg\", \"4,5 m²\". lenkbank (P8) prints forces, masses and lengths in\n   * every table and summary, and each call site glued `${n} N` together with a plain\n   * space — which wraps the \"N\" onto the next line in a narrow column and reads loose\n   * beside the digit grouping. The narrow no-break space is the SI brochure's and the\n   * Swiss typesetting rule's separator between value and unit, and it never breaks.\n   *\n   * Free text, not `Intl`'s `style: \"unit\"`: that one only knows the ECMA-402\n   * sanctioned units (no \"N\", no \"kN\", no \"m³/h\"), so an app would still be gluing.\n   * A missing value prints `empty` ALONE — \"— N\" says there is a newton-shaped\n   * nothing, which is noise in a column that already heads its unit.\n   */\n  unit?: string;\n}\n\n/** Narrow no-break space (U+202F): between a figure and its {@link FormatNumberOptions.unit}. */\nconst UNIT_SEPARATOR = \"\\u202F\";\n\nexport interface FormatMoneyOptions extends FormatNumberBaseOptions {\n  /** `\"symbol\"` (default), `\"narrowSymbol\"`, `\"code\"` (\"CHF 12.00\") or `\"name\"`. */\n  currencyDisplay?: Intl.NumberFormatOptions[\"currencyDisplay\"];\n}\n\nexport interface FormatPercentOptions extends FormatNumberBaseOptions {\n  /**\n   * `true` (default): `value` is a RATIO, as `Intl` and `StatTile`'s percent delta read\n   * it — `0.12` is 12 %. `false`: it is already a percentage — `12` is 12 %\n   * (kastlan's rent `change_pct`).\n   */\n  ratio?: boolean;\n}\n\n// One formatter per option set: a table formats the same way thousands of times, and\n// constructing an Intl formatter is the expensive part.\nconst numberFormatters = new Map<string, Intl.NumberFormat>();\nfunction numberFormatter(locale: string | undefined, options: Intl.NumberFormatOptions): Intl.NumberFormat {\n  const key = `${locale ?? \"\"}|${JSON.stringify(options)}`;\n  let f = numberFormatters.get(key);\n  if (!f) {\n    f = new Intl.NumberFormat(locale, options);\n    numberFormatters.set(key, f);\n  }\n  return f;\n}\n\nfunction digitOptions(digits: FormatDigits | undefined): Intl.NumberFormatOptions {\n  if (digits === undefined) return {};\n  if (typeof digits === \"number\") return { minimumFractionDigits: digits, maximumFractionDigits: digits };\n  return {\n    ...(digits.min !== undefined ? { minimumFractionDigits: digits.min } : null),\n    ...(digits.max !== undefined ? { maximumFractionDigits: digits.max } : null),\n  };\n}\n\nfunction numberOptions(o: FormatNumberBaseOptions): Intl.NumberFormatOptions {\n  return {\n    ...digitOptions(o.digits),\n    ...(o.compact ? { notation: \"compact\" } : null),\n    ...(o.signDisplay ? { signDisplay: o.signDisplay } : null),\n    ...o.options,\n  };\n}\n\n/**\n * What the number formatters take (0.49, KIT-2): a number, a numeric string (\"1850.00\",\n * \"-12.5\", \"1e3\" — what a Decimal arrives as in JSON), or `null` / `undefined` for no\n * value. A string is read with `Number()`, so a figure with more significant digits than\n * a double holds (about 15–17) is printed as its nearest double.\n */\nexport type FormattableNumber = number | string | null | undefined;\n\n/** A plain decimal: optional sign, digits with an optional point, an optional exponent.\n *  No grouping marks, no decimal comma, no currency — those are formatted text, and\n *  reading them back is a locale's guess. */\nconst NUMERIC_STRING = /^[+-]?(?:\\d+\\.?\\d*|\\.\\d+)(?:[eE][+-]?\\d+)?$/;\n\n/** The kit's dev switch, as `lib/logger.ts` reads it: a development build, never a\n *  production one (the consumer's bundler makes `import.meta.env.DEV` false) and never\n *  under vitest. Read per call so a test can switch it on with `vi.stubEnv`. */\nfunction devWarnings(): boolean {\n  return Boolean(import.meta.env?.DEV) && !import.meta.env?.VITEST;\n}\n\nconst warnedSites = new Set<string>();\n/** This module's own frames, skipped to find the caller (\"Object.formatMoney\" is a\n *  `useKitFormat` wrapper). */\nconst OWN_FRAME = /\\b(?:formatNumber|formatMoney|formatPercent|toFormattable|warnInvalid|callSite)\\b/;\n\n/** The first stack frame outside the formatters: where the bad value was passed. */\nfunction callSite(): string {\n  const frames = (new Error().stack ?? \"\").split(\"\\n\").slice(1);\n  return frames.find((frame) => !OWN_FRAME.test(frame))?.trim() ?? \"\";\n}\n\nfunction describeValue(value: unknown): string {\n  if (typeof value === \"number\" || typeof value === \"bigint\" || typeof value === \"boolean\") return String(value);\n  try {\n    return JSON.stringify(value) ?? String(value);\n  } catch {\n    return Object.prototype.toString.call(value);\n  }\n}\n\n/** A development build's console note about an invalid value — once per call site. */\nfunction warnInvalid(fn: string, value: unknown): void {\n  if (!devWarnings()) return;\n  const site = callSite();\n  const key = `${fn}|${site || typeof value}`;\n  if (warnedSites.has(key)) return;\n  warnedSites.add(key);\n  const type = Array.isArray(value) ? \"array\" : typeof value;\n  console.warn(\n    `[ui-kit] ${fn} got ${describeValue(value)} (${type}), which is not a number: printed the empty value. ` +\n      \"Pass a number, a numeric string, or null/undefined for a missing value.\" +\n      (site ? `\\n  at ${site.replace(/^at /, \"\")}` : \"\"),\n  );\n}\n\n/**\n * `value` as a finite number to format, or `undefined` to print `empty`. `null` and\n * `undefined` are a missing value and pass quietly; anything that is neither a finite\n * number nor a numeric string is an invalid one — ±Infinity included (lenkbank, adopting\n * 0.13: a division by zero upstream; \"∞\" in a money column reads like data) — and a\n * development build warns. `-0` is folded into `0`: zero carries no sign.\n */\nfunction toFormattable(fn: string, value: unknown): number | undefined {\n  if (value === null || value === undefined) return undefined;\n  let n: number | undefined;\n  if (typeof value === \"number\") n = value;\n  else if (typeof value === \"string\" && NUMERIC_STRING.test(value.trim())) n = Number(value.trim());\n  if (n === undefined || !Number.isFinite(n)) {\n    warnInvalid(fn, value);\n    return undefined;\n  }\n  return n + 0;\n}\n\n/** A number in `locale`: \"1,234.5\", \"1.234,5\", \"1’234.5\" — with `unit`, \"3.400 N\". */\nexport function formatNumber(value: FormattableNumber, options: FormatNumberOptions = {}): string {\n  const n = toFormattable(\"formatNumber\", value);\n  if (n === undefined) return options.empty ?? EMPTY_FORMATTED_VALUE;\n  const figure = formatWithMinus(numberFormatter(options.locale, numberOptions(options)), n, options.minus);\n  return options.unit ? `${figure}${UNIT_SEPARATOR}${options.unit}` : figure;\n}\n\n/** An amount of `currency` (ISO 4217) in `locale`: \"CHF 1’234.50\", \"1.234,50 €\". */\nexport function formatMoney(value: FormattableNumber, currency: string, options: FormatMoneyOptions = {}): string {\n  const n = toFormattable(\"formatMoney\", value);\n  if (n === undefined) return options.empty ?? EMPTY_FORMATTED_VALUE;\n  const formatter = numberFormatter(options.locale, {\n    style: \"currency\",\n    currency,\n    ...(options.currencyDisplay ? { currencyDisplay: options.currencyDisplay } : null),\n    ...numberOptions(options),\n  });\n  return formatWithMinus(formatter, n, options.minus);\n}\n\n/** A percentage in `locale` (\"12%\", \"12 %\", \"+1.25%\"). See {@link FormatPercentOptions.ratio}\n *  for what `value` means. Default digits: at most one. */\nexport function formatPercent(value: FormattableNumber, options: FormatPercentOptions = {}): string {\n  const n = toFormattable(\"formatPercent\", value);\n  if (n === undefined) return options.empty ?? EMPTY_FORMATTED_VALUE;\n  const ratio = options.ratio === false ? n / 100 : n;\n  const formatter = numberFormatter(options.locale, {\n    style: \"percent\",\n    ...(options.digits === undefined ? { maximumFractionDigits: 1 } : null),\n    ...numberOptions(options),\n  });\n  return formatWithMinus(formatter, ratio, options.minus);\n}\n\n/* ── Dates ─────────────────────────────────────────────────────────────────── */\n\n/**\n * The shapes a date is printed in, each a set of `Intl.DateTimeFormat` options:\n *  - `short` / `medium` / `long` / `full` — the date alone, at that `dateStyle`\n *    (\"08/07/2026\", \"8 Jul 2026\", \"8 July 2026\", \"Wednesday, 8 July 2026\" in en-GB).\n *  - `dateTime` — medium date and short time: a timestamp (\"8 Jul 2026, 14:05\").\n *  - `time` — the short time alone (\"14:05\").\n *  - `monthYear` — \"July 2026\".\n *\n * Or pass `Intl.DateTimeFormatOptions` for anything else. A date-fns PATTERN\n * (\"dd.MM.yyyy\") is deliberately not accepted: a pattern is one locale's order baked\n * into a string, which is how an English page ends up with German dates.\n */\nexport type FormatDateStyle = \"short\" | \"medium\" | \"long\" | \"full\" | \"dateTime\" | \"time\" | \"monthYear\";\n\nconst DATE_STYLES: Record<FormatDateStyle, Intl.DateTimeFormatOptions> = {\n  short: { dateStyle: \"short\" },\n  medium: { dateStyle: \"medium\" },\n  long: { dateStyle: \"long\" },\n  full: { dateStyle: \"full\" },\n  dateTime: { dateStyle: \"medium\", timeStyle: \"short\" },\n  time: { timeStyle: \"short\" },\n  monthYear: { month: \"long\", year: \"numeric\" },\n};\n\nexport interface FormatDateOptions extends BaseOptions {\n  /** An IANA zone (\"Europe/Zurich\") for a timestamp. Left out: the device's. A bare\n   *  \"YYYY-MM-DD\" ignores it: a calendar day is the day it names in every zone. */\n  timeZone?: string;\n}\n\n/** A bare ISO calendar day, `\"YYYY-MM-DD\"`. */\nconst BARE_ISO_DAY = /^\\d{4}-\\d{2}-\\d{2}$/;\n\n/** What {@link formatDate} and {@link formatRelativeTime} accept. */\nexport type DateInput = string | number | Date | null | undefined;\n\n/**\n * `value` as a Date, or null. A bare \"YYYY-MM-DD\" is a CALENDAR day and is read on the\n * local calendar (`parseIsoDate`) — `new Date(\"2026-07-08\")` is UTC midnight, which is\n * the 7th anywhere west of Greenwich. Anything else (a full ISO timestamp, epoch\n * milliseconds, a Date) is an instant and goes through `Date` as is.\n */\nexport function toDate(value: DateInput): Date | null {\n  if (value === null || value === undefined || value === \"\") return null;\n  if (typeof value === \"string\" && BARE_ISO_DAY.test(value)) return parseIsoDate(value);\n  const d = value instanceof Date ? value : new Date(value);\n  return Number.isNaN(d.getTime()) ? null : d;\n}\n\nconst dateFormatters = new Map<string, Intl.DateTimeFormat>();\nfunction dateFormatter(locale: string | undefined, options: Intl.DateTimeFormatOptions): Intl.DateTimeFormat {\n  const key = `${locale ?? \"\"}|${JSON.stringify(options)}`;\n  let f = dateFormatters.get(key);\n  if (!f) {\n    f = new Intl.DateTimeFormat(locale, options);\n    dateFormatters.set(key, f);\n  }\n  return f;\n}\n\n/**\n * A date or timestamp in `locale`. Takes an ISO date (\"2026-07-08\", read on the local\n * calendar), an ISO timestamp (\"2026-07-08T14:05:00Z\"), epoch milliseconds or a Date.\n * `style` defaults to `medium`; see {@link FormatDateStyle}.\n *\n * `formatIsoDate` (`@eifi1/ui-kit/dates`) remains for a plain \"YYYY-MM-DD\" with an\n * explicit locale; this is its superset for timestamps and the named styles.\n */\nexport function formatDate(\n  value: DateInput,\n  style: FormatDateStyle | Intl.DateTimeFormatOptions = \"medium\",\n  options: FormatDateOptions = {},\n): string {\n  const d = toDate(value);\n  if (!d) return options.empty ?? EMPTY_FORMATTED_VALUE;\n  const base = typeof style === \"string\" ? DATE_STYLES[style] : style;\n  // A bare \"YYYY-MM-DD\" is a calendar day, which has no zone: it is the day it names\n  // wherever it is read, so a `timeZone` (in `options` or the style) never moves it — the\n  // device's local midnight shown in a zone west of it was the day before (round 0.45, N9).\n  if (typeof value === \"string\" && BARE_ISO_DAY.test(value)) {\n    const day = new Date(Date.UTC(d.getFullYear(), d.getMonth(), d.getDate()));\n    return dateFormatter(options.locale, { ...base, timeZone: \"UTC\" }).format(day);\n  }\n  return dateFormatter(options.locale, options.timeZone ? { ...base, timeZone: options.timeZone } : base).format(d);\n}\n\nexport interface FormatRelativeTimeOptions extends BaseOptions {\n  /** The zone of the date printed past `absoluteAfterDays` (0.46), and (0.51.7) the zone\n   *  whose calendar days \"yesterday\" and \"2 days ago\" count. Left out: the device's. */\n  timeZone?: string;\n  /** The moment it is measured from. Default: now. */\n  now?: DateInput;\n  /** `\"auto\"` (default): \"yesterday\", \"now\", \"next week\". `\"always\"`: \"1 day ago\". */\n  numeric?: Intl.RelativeTimeFormatNumeric;\n  /** `\"long\"` (default) \"3 hours ago\", `\"short\"` \"3 hr. ago\", `\"narrow\"` \"3h ago\". */\n  style?: Intl.RelativeTimeFormatStyle;\n  /**\n   * Past this many days either way, print the date instead ({@link formatDate} in\n   * `absoluteStyle`) — kastlan's feed switches to the date after a week, because \"5\n   * weeks ago\" makes a reader do sums. Default: never.\n   */\n  absoluteAfterDays?: number;\n  /** The style of that date. Default `medium`. */\n  absoluteStyle?: FormatDateStyle | Intl.DateTimeFormatOptions;\n}\n\nconst SECOND = 1000;\nconst MINUTE = 60 * SECOND;\nconst HOUR = 60 * MINUTE;\nconst DAY = 24 * HOUR;\n\n/** [the largest |difference| a unit is used for, the unit, its length]. */\nconst RELATIVE_STEPS: Array<[number, Intl.RelativeTimeFormatUnit, number]> = [\n  [45 * SECOND, \"second\", SECOND],\n  [45 * MINUTE, \"minute\", MINUTE],\n  [22 * HOUR, \"hour\", HOUR],\n  [6.5 * DAY, \"day\", DAY],\n  [26 * DAY, \"week\", 7 * DAY],\n  [320 * DAY, \"month\", 30.44 * DAY],\n  [Infinity, \"year\", 365.25 * DAY],\n];\n\n/**\n * `d`'s calendar day in `timeZone` (left out: the device's), as a whole number of days:\n * that day's UTC midnight over a day's length. Two of them subtract to whole calendar\n * days — a 23- or 25-hour DST day still counts one.\n */\nfunction dayNumber(d: Date, timeZone: string | undefined): number {\n  if (!timeZone) return Date.UTC(d.getFullYear(), d.getMonth(), d.getDate()) / DAY;\n  // `en-US`: Gregorian, Latin digits — the parts are read back as numbers.\n  const fields: Intl.DateTimeFormatOptions = { timeZone, year: \"numeric\", month: \"numeric\", day: \"numeric\" };\n  const parts = dateFormatter(\"en-US\", fields).formatToParts(d);\n  const part = (type: Intl.DateTimeFormatPartTypes) => Number(parts.find((p) => p.type === type)?.value);\n  return Date.UTC(part(\"year\"), part(\"month\") - 1, part(\"day\")) / DAY;\n}\n\nconst relativeFormatters = new Map<string, Intl.RelativeTimeFormat>();\nfunction relativeFormatter(\n  locale: string | undefined,\n  numeric: Intl.RelativeTimeFormatNumeric,\n  style: Intl.RelativeTimeFormatStyle,\n): Intl.RelativeTimeFormat {\n  const key = `${locale ?? \"\"}|${numeric}|${style}`;\n  let f = relativeFormatters.get(key);\n  if (!f) {\n    f = new Intl.RelativeTimeFormat(locale, { numeric, style });\n    relativeFormatters.set(key, f);\n  }\n  return f;\n}\n\n/**\n * How long ago (or until) `value` is, in `locale`'s words, through\n * `Intl.RelativeTimeFormat`: \"3 hours ago\", \"vor 3 Stunden\", \"il y a 3 heures\",\n * \"in 2 days\", and under 45 seconds \"now\". The unit is picked by size — seconds,\n * minutes, hours, days, weeks, months, years — and the count is rounded; days are\n * CALENDAR days (0.51.7), in `timeZone` when given: \"yesterday\" is the day before today,\n * however few hours ago that was.\n */\nexport function formatRelativeTime(value: DateInput, options: FormatRelativeTimeOptions = {}): string {\n  const d = toDate(value);\n  if (!d) return options.empty ?? EMPTY_FORMATTED_VALUE;\n  const now = toDate(options.now ?? new Date()) ?? new Date();\n  const diff = d.getTime() - now.getTime();\n  const abs = Math.abs(diff);\n  if (options.absoluteAfterDays !== undefined && abs > options.absoluteAfterDays * DAY) {\n    return formatDate(d, options.absoluteStyle ?? \"medium\", options);\n  }\n  const rtf = relativeFormatter(options.locale, options.numeric ?? \"auto\", options.style ?? \"long\");\n  const [, unit, size] = RELATIVE_STEPS.find(([limit]) => abs < limit)!;\n  if (unit === \"day\") {\n    // By the calendar, not in 24-hour units (refactor audit 2026-10-30, DSP-7): rounded\n    // elapsed time made 00:10 seen at 23:50 \"yesterday\" and 01:00 yesterday seen at 23:30\n    // \"2 days ago\", beside an exact date (DateMark's second line, the feedback thread's\n    // tooltip) that said otherwise. Counted in `timeZone`, the zone that date is printed\n    // in; a bare \"YYYY-MM-DD\" is the day it names wherever it is read, as in formatDate.\n    // Still the same day (22 hours and more since just after midnight): in hours.\n    const bareDay = typeof value === \"string\" && BARE_ISO_DAY.test(value);\n    const days = dayNumber(d, bareDay ? undefined : options.timeZone) - dayNumber(now, options.timeZone);\n    return days === 0 ? rtf.format(Math.round(diff / HOUR), \"hour\") : rtf.format(days, \"day\");\n  }\n  // Under 45 seconds is \"now\" rather than \"12 seconds ago\": a feed that ticks through\n  // the seconds is noise, and nothing reads a timestamp to the second.\n  const count = unit === \"second\" ? 0 : Math.round(diff / size);\n  // `+ 0` folds -0 into 0: `format(-0, …)` says \"0 seconds ago\" instead of \"now\".\n  return rtf.format(count + 0, unit);\n}\n\n/* ── Bound to the provider ─────────────────────────────────────────────────── */\n\ntype WithoutLocale<T> = Omit<T, \"locale\"> & { locale?: string };\n\n/** What {@link useKitFormat} returns: the formatters above with the provider's locale\n *  as their default (an explicit `locale` in the options still wins). */\nexport interface KitFormat {\n  /** The locale they format in — the provider's, or `undefined` (runtime default). */\n  locale: string | undefined;\n  formatNumber: (value: FormattableNumber, options?: WithoutLocale<FormatNumberOptions>) => string;\n  formatMoney: (value: FormattableNumber, currency: string, options?: WithoutLocale<FormatMoneyOptions>) => string;\n  formatPercent: (value: FormattableNumber, options?: WithoutLocale<FormatPercentOptions>) => string;\n  formatDate: (\n    value: DateInput,\n    style?: FormatDateStyle | Intl.DateTimeFormatOptions,\n    options?: WithoutLocale<FormatDateOptions>,\n  ) => string;\n  formatRelativeTime: (value: DateInput, options?: WithoutLocale<FormatRelativeTimeOptions>) => string;\n}\n\n/**\n * The formatters, bound to the `<UiKitProvider locale>` (or to `locale`, which wins\n * over it — the same precedence as a component's `locale` prop):\n *\n *     const { formatMoney, formatRelativeTime } = useKitFormat();\n *     formatMoney(row.balance, \"CHF\");\n */\nexport function useKitFormat(locale?: string): KitFormat {\n  const kitLocale = useKitLocale(locale);\n  // 0.46 (§10.3): the provider's `timeZone` for timestamps; a call's own wins, and a bare\n  // \"YYYY-MM-DD\" ignores it (formatDate).\n  const timeZone = useKitTimeZone();\n  return useMemo<KitFormat>(\n    () => ({\n      locale: kitLocale,\n      formatNumber: (value, options) => formatNumber(value, { locale: kitLocale, ...options }),\n      formatMoney: (value, currency, options) => formatMoney(value, currency, { locale: kitLocale, ...options }),\n      formatPercent: (value, options) => formatPercent(value, { locale: kitLocale, ...options }),\n      formatDate: (value, style, options) => formatDate(value, style, { locale: kitLocale, timeZone, ...options }),\n      formatRelativeTime: (value, options) => formatRelativeTime(value, { locale: kitLocale, timeZone, ...options }),\n    }),\n    [kitLocale, timeZone],\n  );\n}\n\n/* ── Currency minor units ──────────────────────────────────────────────────── */\n\n/**\n * The decimals a currency is written with — its minor unit: CHF and EUR 2, JPY 0,\n * KWD 3 — from `Intl`, or `undefined` for a code `Intl` does not accept. The rule\n * AmountInput settles a typed figure by, for a host that needs it outside the field.\n */\nexport function currencyMinorDigits(currency: string | null | undefined): number | undefined {\n  if (!currency) return undefined;\n  try {\n    return new Intl.NumberFormat(\"en\", { style: \"currency\", currency }).resolvedOptions().maximumFractionDigits;\n  } catch {\n    return undefined;\n  }\n}\n\n/** The options form of {@link roundToCurrency}'s third argument. */\nexport interface RoundToCurrencyOptions {\n  /** Decimals to round to, whatever the currency — the plain `digits` argument. */\n  digits?: number;\n  /**\n   * Decimals for a currency `Intl` cannot resolve — no code yet (`null`, `\"\"`), or a\n   * malformed one (\"EURO\", \"€\"). Left out, such a value comes back unchanged, as\n   * before. Note that `Intl` resolves ANY well-formed three-letter code, a made-up\n   * \"XYZ\" included (to 2), so this is the case of a missing or broken code, not of a\n   * rare currency.\n   */\n  fallbackDigits?: number;\n}\n\n/**\n * `value` rounded to the currency's minor unit (or to `digits`), half away from zero,\n * in decimal arithmetic: 93.4213 CHF → 93.42, 1.005 EUR → 1.01 (`Math.round(1.005 *\n * 100)` is 100, since 1.005 is 1.00499… in binary). A non-finite value, or a currency\n * `Intl` does not know without `digits`, comes back unchanged (keksdose live #356: an\n * FX estimate set into an AmountInput showed four decimals) — unless the options form\n * gives `fallbackDigits`: `roundToCurrency(v, code, { fallbackDigits: 2 })` rounds a\n * figure whose currency is not chosen yet to cents rather than leaving 0.1 + 0.2 as is.\n * A finite value never comes back NaN or -0, however small or large (BUG-11):\n * 0.1 + 0.2 - 0.3 → 0, -0.004 → 0.\n */\nexport function roundToCurrency(\n  value: number,\n  currency: string | null | undefined,\n  digits?: number | RoundToCurrencyOptions,\n): number {\n  const options = typeof digits === \"object\" && digits !== null ? digits : { digits };\n  const places = options.digits ?? currencyMinorDigits(currency) ?? options.fallbackDigits;\n  if (places === undefined) return value;\n  return roundHalfAway(value, places);\n}\n"],"mappings":";AAAA,SAAS,eAAe;AACxB,SAAS,cAAc,sBAAsB;AAC7C,SAAS,oBAAoB;AAC7B,SAAS,uBAAwC;AACjD,SAAS,qBAAqB;AAI9B,SAAS,mBAAAA,wBAAuB;AAiCzB,MAAM,wBAAwB;AAmDrC,MAAM,iBAAiB;AAkBvB,MAAM,mBAAmB,oBAAI,IAA+B;AAC5D,SAAS,gBAAgB,QAA4B,SAAsD;AACzG,QAAM,MAAM,GAAG,UAAU,EAAE,IAAI,KAAK,UAAU,OAAO,CAAC;AACtD,MAAI,IAAI,iBAAiB,IAAI,GAAG;AAChC,MAAI,CAAC,GAAG;AACN,QAAI,IAAI,KAAK,aAAa,QAAQ,OAAO;AACzC,qBAAiB,IAAI,KAAK,CAAC;AAAA,EAC7B;AACA,SAAO;AACT;AAEA,SAAS,aAAa,QAA4D;AAChF,MAAI,WAAW,OAAW,QAAO,CAAC;AAClC,MAAI,OAAO,WAAW,SAAU,QAAO,EAAE,uBAAuB,QAAQ,uBAAuB,OAAO;AACtG,SAAO;AAAA,IACL,GAAI,OAAO,QAAQ,SAAY,EAAE,uBAAuB,OAAO,IAAI,IAAI;AAAA,IACvE,GAAI,OAAO,QAAQ,SAAY,EAAE,uBAAuB,OAAO,IAAI,IAAI;AAAA,EACzE;AACF;AAEA,SAAS,cAAc,GAAsD;AAC3E,SAAO;AAAA,IACL,GAAG,aAAa,EAAE,MAAM;AAAA,IACxB,GAAI,EAAE,UAAU,EAAE,UAAU,UAAU,IAAI;AAAA,IAC1C,GAAI,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,IAAI;AAAA,IACrD,GAAG,EAAE;AAAA,EACP;AACF;AAaA,MAAM,iBAAiB;AAKvB,SAAS,cAAuB;AAC9B,SAAO,QAAQ,YAAY,KAAK,GAAG,KAAK,CAAC,YAAY,KAAK;AAC5D;AAEA,MAAM,cAAc,oBAAI,IAAY;AAGpC,MAAM,YAAY;AAGlB,SAAS,WAAmB;AAC1B,QAAM,UAAU,IAAI,MAAM,EAAE,SAAS,IAAI,MAAM,IAAI,EAAE,MAAM,CAAC;AAC5D,SAAO,OAAO,KAAK,CAAC,UAAU,CAAC,UAAU,KAAK,KAAK,CAAC,GAAG,KAAK,KAAK;AACnE;AAEA,SAAS,cAAc,OAAwB;AAC7C,MAAI,OAAO,UAAU,YAAY,OAAO,UAAU,YAAY,OAAO,UAAU,UAAW,QAAO,OAAO,KAAK;AAC7G,MAAI;AACF,WAAO,KAAK,UAAU,KAAK,KAAK,OAAO,KAAK;AAAA,EAC9C,QAAQ;AACN,WAAO,OAAO,UAAU,SAAS,KAAK,KAAK;AAAA,EAC7C;AACF;AAGA,SAAS,YAAY,IAAY,OAAsB;AACrD,MAAI,CAAC,YAAY,EAAG;AACpB,QAAM,OAAO,SAAS;AACtB,QAAM,MAAM,GAAG,EAAE,IAAI,QAAQ,OAAO,KAAK;AACzC,MAAI,YAAY,IAAI,GAAG,EAAG;AAC1B,cAAY,IAAI,GAAG;AACnB,QAAM,OAAO,MAAM,QAAQ,KAAK,IAAI,UAAU,OAAO;AACrD,UAAQ;AAAA,IACN,YAAY,EAAE,QAAQ,cAAc,KAAK,CAAC,KAAK,IAAI,gIAEhD,OAAO;AAAA,OAAU,KAAK,QAAQ,QAAQ,EAAE,CAAC,KAAK;AAAA,EACnD;AACF;AASA,SAAS,cAAc,IAAY,OAAoC;AACrE,MAAI,UAAU,QAAQ,UAAU,OAAW,QAAO;AAClD,MAAI;AACJ,MAAI,OAAO,UAAU,SAAU,KAAI;AAAA,WAC1B,OAAO,UAAU,YAAY,eAAe,KAAK,MAAM,KAAK,CAAC,EAAG,KAAI,OAAO,MAAM,KAAK,CAAC;AAChG,MAAI,MAAM,UAAa,CAAC,OAAO,SAAS,CAAC,GAAG;AAC1C,gBAAY,IAAI,KAAK;AACrB,WAAO;AAAA,EACT;AACA,SAAO,IAAI;AACb;AAGO,SAAS,aAAa,OAA0B,UAA+B,CAAC,GAAW;AAChG,QAAM,IAAI,cAAc,gBAAgB,KAAK;AAC7C,MAAI,MAAM,OAAW,QAAO,QAAQ,SAAS;AAC7C,QAAM,SAAS,gBAAgB,gBAAgB,QAAQ,QAAQ,cAAc,OAAO,CAAC,GAAG,GAAG,QAAQ,KAAK;AACxG,SAAO,QAAQ,OAAO,GAAG,MAAM,GAAG,cAAc,GAAG,QAAQ,IAAI,KAAK;AACtE;AAGO,SAAS,YAAY,OAA0B,UAAkB,UAA8B,CAAC,GAAW;AAChH,QAAM,IAAI,cAAc,eAAe,KAAK;AAC5C,MAAI,MAAM,OAAW,QAAO,QAAQ,SAAS;AAC7C,QAAM,YAAY,gBAAgB,QAAQ,QAAQ;AAAA,IAChD,OAAO;AAAA,IACP;AAAA,IACA,GAAI,QAAQ,kBAAkB,EAAE,iBAAiB,QAAQ,gBAAgB,IAAI;AAAA,IAC7E,GAAG,cAAc,OAAO;AAAA,EAC1B,CAAC;AACD,SAAO,gBAAgB,WAAW,GAAG,QAAQ,KAAK;AACpD;AAIO,SAAS,cAAc,OAA0B,UAAgC,CAAC,GAAW;AAClG,QAAM,IAAI,cAAc,iBAAiB,KAAK;AAC9C,MAAI,MAAM,OAAW,QAAO,QAAQ,SAAS;AAC7C,QAAM,QAAQ,QAAQ,UAAU,QAAQ,IAAI,MAAM;AAClD,QAAM,YAAY,gBAAgB,QAAQ,QAAQ;AAAA,IAChD,OAAO;AAAA,IACP,GAAI,QAAQ,WAAW,SAAY,EAAE,uBAAuB,EAAE,IAAI;AAAA,IAClE,GAAG,cAAc,OAAO;AAAA,EAC1B,CAAC;AACD,SAAO,gBAAgB,WAAW,OAAO,QAAQ,KAAK;AACxD;AAkBA,MAAM,cAAmE;AAAA,EACvE,OAAO,EAAE,WAAW,QAAQ;AAAA,EAC5B,QAAQ,EAAE,WAAW,SAAS;AAAA,EAC9B,MAAM,EAAE,WAAW,OAAO;AAAA,EAC1B,MAAM,EAAE,WAAW,OAAO;AAAA,EAC1B,UAAU,EAAE,WAAW,UAAU,WAAW,QAAQ;AAAA,EACpD,MAAM,EAAE,WAAW,QAAQ;AAAA,EAC3B,WAAW,EAAE,OAAO,QAAQ,MAAM,UAAU;AAC9C;AASA,MAAM,eAAe;AAWd,SAAS,OAAO,OAA+B;AACpD,MAAI,UAAU,QAAQ,UAAU,UAAa,UAAU,GAAI,QAAO;AAClE,MAAI,OAAO,UAAU,YAAY,aAAa,KAAK,KAAK,EAAG,QAAO,aAAa,KAAK;AACpF,QAAM,IAAI,iBAAiB,OAAO,QAAQ,IAAI,KAAK,KAAK;AACxD,SAAO,OAAO,MAAM,EAAE,QAAQ,CAAC,IAAI,OAAO;AAC5C;AAEA,MAAM,iBAAiB,oBAAI,IAAiC;AAC5D,SAAS,cAAc,QAA4B,SAA0D;AAC3G,QAAM,MAAM,GAAG,UAAU,EAAE,IAAI,KAAK,UAAU,OAAO,CAAC;AACtD,MAAI,IAAI,eAAe,IAAI,GAAG;AAC9B,MAAI,CAAC,GAAG;AACN,QAAI,IAAI,KAAK,eAAe,QAAQ,OAAO;AAC3C,mBAAe,IAAI,KAAK,CAAC;AAAA,EAC3B;AACA,SAAO;AACT;AAUO,SAAS,WACd,OACA,QAAsD,UACtD,UAA6B,CAAC,GACtB;AACR,QAAM,IAAI,OAAO,KAAK;AACtB,MAAI,CAAC,EAAG,QAAO,QAAQ,SAAS;AAChC,QAAM,OAAO,OAAO,UAAU,WAAW,YAAY,KAAK,IAAI;AAI9D,MAAI,OAAO,UAAU,YAAY,aAAa,KAAK,KAAK,GAAG;AACzD,UAAM,MAAM,IAAI,KAAK,KAAK,IAAI,EAAE,YAAY,GAAG,EAAE,SAAS,GAAG,EAAE,QAAQ,CAAC,CAAC;AACzE,WAAO,cAAc,QAAQ,QAAQ,EAAE,GAAG,MAAM,UAAU,MAAM,CAAC,EAAE,OAAO,GAAG;AAAA,EAC/E;AACA,SAAO,cAAc,QAAQ,QAAQ,QAAQ,WAAW,EAAE,GAAG,MAAM,UAAU,QAAQ,SAAS,IAAI,IAAI,EAAE,OAAO,CAAC;AAClH;AAsBA,MAAM,SAAS;AACf,MAAM,SAAS,KAAK;AACpB,MAAM,OAAO,KAAK;AAClB,MAAM,MAAM,KAAK;AAGjB,MAAM,iBAAuE;AAAA,EAC3E,CAAC,KAAK,QAAQ,UAAU,MAAM;AAAA,EAC9B,CAAC,KAAK,QAAQ,UAAU,MAAM;AAAA,EAC9B,CAAC,KAAK,MAAM,QAAQ,IAAI;AAAA,EACxB,CAAC,MAAM,KAAK,OAAO,GAAG;AAAA,EACtB,CAAC,KAAK,KAAK,QAAQ,IAAI,GAAG;AAAA,EAC1B,CAAC,MAAM,KAAK,SAAS,QAAQ,GAAG;AAAA,EAChC,CAAC,UAAU,QAAQ,SAAS,GAAG;AACjC;AAOA,SAAS,UAAU,GAAS,UAAsC;AAChE,MAAI,CAAC,SAAU,QAAO,KAAK,IAAI,EAAE,YAAY,GAAG,EAAE,SAAS,GAAG,EAAE,QAAQ,CAAC,IAAI;AAE7E,QAAM,SAAqC,EAAE,UAAU,MAAM,WAAW,OAAO,WAAW,KAAK,UAAU;AACzG,QAAM,QAAQ,cAAc,SAAS,MAAM,EAAE,cAAc,CAAC;AAC5D,QAAM,OAAO,CAAC,SAAuC,OAAO,MAAM,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI,GAAG,KAAK;AACrG,SAAO,KAAK,IAAI,KAAK,MAAM,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,KAAK,CAAC,IAAI;AAClE;AAEA,MAAM,qBAAqB,oBAAI,IAAqC;AACpE,SAAS,kBACP,QACA,SACA,OACyB;AACzB,QAAM,MAAM,GAAG,UAAU,EAAE,IAAI,OAAO,IAAI,KAAK;AAC/C,MAAI,IAAI,mBAAmB,IAAI,GAAG;AAClC,MAAI,CAAC,GAAG;AACN,QAAI,IAAI,KAAK,mBAAmB,QAAQ,EAAE,SAAS,MAAM,CAAC;AAC1D,uBAAmB,IAAI,KAAK,CAAC;AAAA,EAC/B;AACA,SAAO;AACT;AAUO,SAAS,mBAAmB,OAAkB,UAAqC,CAAC,GAAW;AACpG,QAAM,IAAI,OAAO,KAAK;AACtB,MAAI,CAAC,EAAG,QAAO,QAAQ,SAAS;AAChC,QAAM,MAAM,OAAO,QAAQ,OAAO,oBAAI,KAAK,CAAC,KAAK,oBAAI,KAAK;AAC1D,QAAM,OAAO,EAAE,QAAQ,IAAI,IAAI,QAAQ;AACvC,QAAM,MAAM,KAAK,IAAI,IAAI;AACzB,MAAI,QAAQ,sBAAsB,UAAa,MAAM,QAAQ,oBAAoB,KAAK;AACpF,WAAO,WAAW,GAAG,QAAQ,iBAAiB,UAAU,OAAO;AAAA,EACjE;AACA,QAAM,MAAM,kBAAkB,QAAQ,QAAQ,QAAQ,WAAW,QAAQ,QAAQ,SAAS,MAAM;AAChG,QAAM,CAAC,EAAE,MAAM,IAAI,IAAI,eAAe,KAAK,CAAC,CAAC,KAAK,MAAM,MAAM,KAAK;AACnE,MAAI,SAAS,OAAO;AAOlB,UAAM,UAAU,OAAO,UAAU,YAAY,aAAa,KAAK,KAAK;AACpE,UAAM,OAAO,UAAU,GAAG,UAAU,SAAY,QAAQ,QAAQ,IAAI,UAAU,KAAK,QAAQ,QAAQ;AACnG,WAAO,SAAS,IAAI,IAAI,OAAO,KAAK,MAAM,OAAO,IAAI,GAAG,MAAM,IAAI,IAAI,OAAO,MAAM,KAAK;AAAA,EAC1F;AAGA,QAAM,QAAQ,SAAS,WAAW,IAAI,KAAK,MAAM,OAAO,IAAI;AAE5D,SAAO,IAAI,OAAO,QAAQ,GAAG,IAAI;AACnC;AA6BO,SAAS,aAAa,QAA4B;AACvD,QAAM,YAAY,aAAa,MAAM;AAGrC,QAAM,WAAW,eAAe;AAChC,SAAO;AAAA,IACL,OAAO;AAAA,MACL,QAAQ;AAAA,MACR,cAAc,CAAC,OAAO,YAAY,aAAa,OAAO,EAAE,QAAQ,WAAW,GAAG,QAAQ,CAAC;AAAA,MACvF,aAAa,CAAC,OAAO,UAAU,YAAY,YAAY,OAAO,UAAU,EAAE,QAAQ,WAAW,GAAG,QAAQ,CAAC;AAAA,MACzG,eAAe,CAAC,OAAO,YAAY,cAAc,OAAO,EAAE,QAAQ,WAAW,GAAG,QAAQ,CAAC;AAAA,MACzF,YAAY,CAAC,OAAO,OAAO,YAAY,WAAW,OAAO,OAAO,EAAE,QAAQ,WAAW,UAAU,GAAG,QAAQ,CAAC;AAAA,MAC3G,oBAAoB,CAAC,OAAO,YAAY,mBAAmB,OAAO,EAAE,QAAQ,WAAW,UAAU,GAAG,QAAQ,CAAC;AAAA,IAC/G;AAAA,IACA,CAAC,WAAW,QAAQ;AAAA,EACtB;AACF;AASO,SAAS,oBAAoB,UAAyD;AAC3F,MAAI,CAAC,SAAU,QAAO;AACtB,MAAI;AACF,WAAO,IAAI,KAAK,aAAa,MAAM,EAAE,OAAO,YAAY,SAAS,CAAC,EAAE,gBAAgB,EAAE;AAAA,EACxF,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AA2BO,SAAS,gBACd,OACA,UACA,QACQ;AACR,QAAM,UAAU,OAAO,WAAW,YAAY,WAAW,OAAO,SAAS,EAAE,OAAO;AAClF,QAAM,SAAS,QAAQ,UAAU,oBAAoB,QAAQ,KAAK,QAAQ;AAC1E,MAAI,WAAW,OAAW,QAAO;AACjC,SAAO,cAAc,OAAO,MAAM;AACpC;","names":["formatWithMinus"]}
+{"version":3,"sources":["../../src/lib/format.ts"],"sourcesContent":["import { useMemo } from \"react\";\nimport { useKitLocale, useKitTimeZone } from \"../i18n/kit-labels\";\nimport { parseIsoDate } from \"./dates\";\nimport { dateFormatter } from \"./intl-cache\";\nimport { isBareIsoDay } from \"./iso-day\";\nimport { formatWithMinus, type MinusStyle } from \"./minus\";\nimport { roundHalfAway } from \"./round\";\n\nexport type { MinusStyle } from \"./minus\";\n// 0.50 (KIT-1 follow-up): the kit's minus for an app's OWN `Intl.NumberFormat` wrapper.\nexport { formatWithMinus } from \"./minus\";\n\n/**\n * Number, money, percentage, date and relative-time formatting — `Intl`, in one place,\n * for the figures an app prints OUTSIDE a kit component.\n *\n * Each app grew its own: kastlan's `utils/formatters.ts` (a Swiss-pinned\n * `formatNumber`/`formatCurrency`, a date-fns `formatDate`, and a `formatRelativeTime`\n * whose \"5m ago\" / \"3h ago\" / \"2d ago\" stayed English in every language), its tenancy\n * `format.ts` (`formatChf`, a `formatPct` gluing a \"+\" onto `toFixed(2)`), keksdose's\n * own set. Every one of them is `Intl` with a locale bolted on, so the only thing\n * worth sharing is the locale — and the kit already has one, the provider's.\n *\n * The plain functions take a `locale` (none: the runtime default, as every `Intl` API\n * reads `undefined`). Inside a component, {@link useKitFormat} hands back the same\n * functions bound to the `<UiKitProvider locale>`, so a page formats exactly like the\n * kit components on it.\n *\n * A missing value — `null`, `undefined`, an unparseable date — formats as `empty`\n * (default \"—\", the dash `StatTile` shows for no value), never as \"NaN\" or \"Invalid\n * Date\". A number may also arrive as a numeric STRING (0.49, KIT-2) — \"1850.00\", \"-12.5\",\n * \"0\": a Decimal field off a Python API — and is formatted like the number. Anything\n * else (a non-numeric string, an object, `NaN`, ±`Infinity`) prints `empty` too, but is\n * a bug upstream rather than a gap in the data, so a development build says so on the\n * console, once per call site. Zero is a figure: `0` and `\"0\"` print \"CHF 0.00\", never\n * the dash.\n *\n * A negative figure carries the typographic minus, U+2212 (0.49, KIT-1), in every\n * locale — `Intl` writes a hyphen in most. `minus: \"ascii\"` for text a machine reads\n * back (a CSV, the clipboard).\n */\n\n/** What every formatter here prints for a missing value, unless told otherwise. */\nexport const EMPTY_FORMATTED_VALUE = \"—\";\n\n/** Fraction digits: a number pins both the minimum and the maximum (`2` → \"3.10\");\n *  an object sets them apart (a meter reading, 1–3). */\nexport type FormatDigits = number | { min?: number; max?: number };\n\ninterface BaseOptions {\n  /** BCP 47 tag. Left out: the runtime default (the hook: the provider's). */\n  locale?: string;\n  /** Printed for a missing value. Default {@link EMPTY_FORMATTED_VALUE}. */\n  empty?: string;\n}\n\n/** The options every number formatter shares (money and percent carry their own unit). */\nexport interface FormatNumberBaseOptions extends BaseOptions {\n  digits?: FormatDigits;\n  /** Compact notation: 12 400 → \"12K\". */\n  compact?: boolean;\n  /** `\"exceptZero\"` for a change (\"+3\", \"−3\", \"0\"). Default: the minus only. */\n  signDisplay?: Intl.NumberFormatOptions[\"signDisplay\"];\n  /** Any further `Intl.NumberFormat` options, merged over the ones above. */\n  options?: Intl.NumberFormatOptions;\n  /**\n   * The minus sign of a negative figure (0.49, KIT-1). `\"typographic\"` (default):\n   * U+2212, as wide as \"+\" and the digits, as `SignedAmount` prints it — in every\n   * locale, also where `Intl` writes a hyphen. `\"ascii\"`: U+002D, for an export a\n   * machine parses back (a CSV download, the clipboard) — there, also pass\n   * `options: { useGrouping: false }` or write the raw number.\n   */\n  minus?: MinusStyle;\n}\n\n/** The options {@link formatNumber} takes: the shared ones plus a free-text `unit`. */\nexport interface FormatNumberOptions extends FormatNumberBaseOptions {\n  /**\n   * A unit printed after the figure, joined by a narrow no-break space (U+202F):\n   * \"3.400 N\", \"12 kg\", \"4,5 m²\". lenkbank (P8) prints forces, masses and lengths in\n   * every table and summary, and each call site glued `${n} N` together with a plain\n   * space — which wraps the \"N\" onto the next line in a narrow column and reads loose\n   * beside the digit grouping. The narrow no-break space is the SI brochure's and the\n   * Swiss typesetting rule's separator between value and unit, and it never breaks.\n   *\n   * Free text, not `Intl`'s `style: \"unit\"`: that one only knows the ECMA-402\n   * sanctioned units (no \"N\", no \"kN\", no \"m³/h\"), so an app would still be gluing.\n   * A missing value prints `empty` ALONE — \"— N\" says there is a newton-shaped\n   * nothing, which is noise in a column that already heads its unit.\n   */\n  unit?: string;\n}\n\n/** Narrow no-break space (U+202F): between a figure and its {@link FormatNumberOptions.unit}. */\nconst UNIT_SEPARATOR = \"\\u202F\";\n\nexport interface FormatMoneyOptions extends FormatNumberBaseOptions {\n  /** `\"symbol\"` (default), `\"narrowSymbol\"`, `\"code\"` (\"CHF 12.00\") or `\"name\"`. */\n  currencyDisplay?: Intl.NumberFormatOptions[\"currencyDisplay\"];\n}\n\nexport interface FormatPercentOptions extends FormatNumberBaseOptions {\n  /**\n   * `true` (default): `value` is a RATIO, as `Intl` and `StatTile`'s percent delta read\n   * it — `0.12` is 12 %. `false`: it is already a percentage — `12` is 12 %\n   * (kastlan's rent `change_pct`).\n   */\n  ratio?: boolean;\n}\n\n// One formatter per option set: a table formats the same way thousands of times, and\n// constructing an Intl formatter is the expensive part.\nconst numberFormatters = new Map<string, Intl.NumberFormat>();\nfunction numberFormatter(locale: string | undefined, options: Intl.NumberFormatOptions): Intl.NumberFormat {\n  const key = `${locale ?? \"\"}|${JSON.stringify(options)}`;\n  let f = numberFormatters.get(key);\n  if (!f) {\n    f = new Intl.NumberFormat(locale, options);\n    numberFormatters.set(key, f);\n  }\n  return f;\n}\n\nfunction digitOptions(digits: FormatDigits | undefined): Intl.NumberFormatOptions {\n  if (digits === undefined) return {};\n  if (typeof digits === \"number\") return { minimumFractionDigits: digits, maximumFractionDigits: digits };\n  return {\n    ...(digits.min !== undefined ? { minimumFractionDigits: digits.min } : null),\n    ...(digits.max !== undefined ? { maximumFractionDigits: digits.max } : null),\n  };\n}\n\nfunction numberOptions(o: FormatNumberBaseOptions): Intl.NumberFormatOptions {\n  return {\n    ...digitOptions(o.digits),\n    ...(o.compact ? { notation: \"compact\" } : null),\n    ...(o.signDisplay ? { signDisplay: o.signDisplay } : null),\n    ...o.options,\n  };\n}\n\n/**\n * What the number formatters take (0.49, KIT-2): a number, a numeric string (\"1850.00\",\n * \"-12.5\", \"1e3\" — what a Decimal arrives as in JSON), or `null` / `undefined` for no\n * value. A string is read with `Number()`, so a figure with more significant digits than\n * a double holds (about 15–17) is printed as its nearest double.\n */\nexport type FormattableNumber = number | string | null | undefined;\n\n/** A plain decimal: optional sign, digits with an optional point, an optional exponent.\n *  No grouping marks, no decimal comma, no currency — those are formatted text, and\n *  reading them back is a locale's guess. */\nconst NUMERIC_STRING = /^[+-]?(?:\\d+\\.?\\d*|\\.\\d+)(?:[eE][+-]?\\d+)?$/;\n\n/** The kit's dev switch, as `lib/logger.ts` reads it: a development build, never a\n *  production one (the consumer's bundler makes `import.meta.env.DEV` false) and never\n *  under vitest. Read per call so a test can switch it on with `vi.stubEnv`. */\nfunction devWarnings(): boolean {\n  return Boolean(import.meta.env?.DEV) && !import.meta.env?.VITEST;\n}\n\nconst warnedSites = new Set<string>();\n/** This module's own frames, skipped to find the caller (\"Object.formatMoney\" is a\n *  `useKitFormat` wrapper). */\nconst OWN_FRAME = /\\b(?:formatNumber|formatMoney|formatPercent|toFormattable|warnInvalid|callSite)\\b/;\n\n/** The first stack frame outside the formatters: where the bad value was passed. */\nfunction callSite(): string {\n  const frames = (new Error().stack ?? \"\").split(\"\\n\").slice(1);\n  return frames.find((frame) => !OWN_FRAME.test(frame))?.trim() ?? \"\";\n}\n\nfunction describeValue(value: unknown): string {\n  if (typeof value === \"number\" || typeof value === \"bigint\" || typeof value === \"boolean\") return String(value);\n  try {\n    return JSON.stringify(value) ?? String(value);\n  } catch {\n    return Object.prototype.toString.call(value);\n  }\n}\n\n/** A development build's console note about an invalid value — once per call site. */\nfunction warnInvalid(fn: string, value: unknown): void {\n  if (!devWarnings()) return;\n  const site = callSite();\n  const key = `${fn}|${site || typeof value}`;\n  if (warnedSites.has(key)) return;\n  warnedSites.add(key);\n  const type = Array.isArray(value) ? \"array\" : typeof value;\n  console.warn(\n    `[ui-kit] ${fn} got ${describeValue(value)} (${type}), which is not a number: printed the empty value. ` +\n      \"Pass a number, a numeric string, or null/undefined for a missing value.\" +\n      (site ? `\\n  at ${site.replace(/^at /, \"\")}` : \"\"),\n  );\n}\n\n/**\n * `value` as a finite number to format, or `undefined` to print `empty`. `null` and\n * `undefined` are a missing value and pass quietly; anything that is neither a finite\n * number nor a numeric string is an invalid one — ±Infinity included (lenkbank, adopting\n * 0.13: a division by zero upstream; \"∞\" in a money column reads like data) — and a\n * development build warns. `-0` is folded into `0`: zero carries no sign.\n */\nfunction toFormattable(fn: string, value: unknown): number | undefined {\n  if (value === null || value === undefined) return undefined;\n  let n: number | undefined;\n  if (typeof value === \"number\") n = value;\n  else if (typeof value === \"string\" && NUMERIC_STRING.test(value.trim())) n = Number(value.trim());\n  if (n === undefined || !Number.isFinite(n)) {\n    warnInvalid(fn, value);\n    return undefined;\n  }\n  return n + 0;\n}\n\n/** A number in `locale`: \"1,234.5\", \"1.234,5\", \"1’234.5\" — with `unit`, \"3.400 N\". */\nexport function formatNumber(value: FormattableNumber, options: FormatNumberOptions = {}): string {\n  const n = toFormattable(\"formatNumber\", value);\n  if (n === undefined) return options.empty ?? EMPTY_FORMATTED_VALUE;\n  const figure = formatWithMinus(numberFormatter(options.locale, numberOptions(options)), n, options.minus);\n  return options.unit ? `${figure}${UNIT_SEPARATOR}${options.unit}` : figure;\n}\n\n/** An amount of `currency` (ISO 4217) in `locale`: \"CHF 1’234.50\", \"1.234,50 €\". */\nexport function formatMoney(value: FormattableNumber, currency: string, options: FormatMoneyOptions = {}): string {\n  const n = toFormattable(\"formatMoney\", value);\n  if (n === undefined) return options.empty ?? EMPTY_FORMATTED_VALUE;\n  const formatter = numberFormatter(options.locale, {\n    style: \"currency\",\n    currency,\n    ...(options.currencyDisplay ? { currencyDisplay: options.currencyDisplay } : null),\n    ...numberOptions(options),\n  });\n  return formatWithMinus(formatter, n, options.minus);\n}\n\n/** A percentage in `locale` (\"12%\", \"12 %\", \"+1.25%\"). See {@link FormatPercentOptions.ratio}\n *  for what `value` means. Default digits: at most one. */\nexport function formatPercent(value: FormattableNumber, options: FormatPercentOptions = {}): string {\n  const n = toFormattable(\"formatPercent\", value);\n  if (n === undefined) return options.empty ?? EMPTY_FORMATTED_VALUE;\n  const ratio = options.ratio === false ? n / 100 : n;\n  const formatter = numberFormatter(options.locale, {\n    style: \"percent\",\n    ...(options.digits === undefined ? { maximumFractionDigits: 1 } : null),\n    ...numberOptions(options),\n  });\n  return formatWithMinus(formatter, ratio, options.minus);\n}\n\n/* ── Dates ─────────────────────────────────────────────────────────────────── */\n\n/**\n * The shapes a date is printed in, each a set of `Intl.DateTimeFormat` options:\n *  - `short` / `medium` / `long` / `full` — the date alone, at that `dateStyle`\n *    (\"08/07/2026\", \"8 Jul 2026\", \"8 July 2026\", \"Wednesday, 8 July 2026\" in en-GB).\n *  - `dateTime` — medium date and short time: a timestamp (\"8 Jul 2026, 14:05\").\n *  - `time` — the short time alone (\"14:05\").\n *  - `monthYear` — \"July 2026\".\n *\n * Or pass `Intl.DateTimeFormatOptions` for anything else. A date-fns PATTERN\n * (\"dd.MM.yyyy\") is deliberately not accepted: a pattern is one locale's order baked\n * into a string, which is how an English page ends up with German dates.\n */\nexport type FormatDateStyle = \"short\" | \"medium\" | \"long\" | \"full\" | \"dateTime\" | \"time\" | \"monthYear\";\n\nconst DATE_STYLES: Record<FormatDateStyle, Intl.DateTimeFormatOptions> = {\n  short: { dateStyle: \"short\" },\n  medium: { dateStyle: \"medium\" },\n  long: { dateStyle: \"long\" },\n  full: { dateStyle: \"full\" },\n  dateTime: { dateStyle: \"medium\", timeStyle: \"short\" },\n  time: { timeStyle: \"short\" },\n  monthYear: { month: \"long\", year: \"numeric\" },\n};\n\nexport interface FormatDateOptions extends BaseOptions {\n  /** An IANA zone (\"Europe/Zurich\") for a timestamp. Left out: the device's. A bare\n   *  \"YYYY-MM-DD\" ignores it: a calendar day is the day it names in every zone. */\n  timeZone?: string;\n}\n\n/** What {@link formatDate} and {@link formatRelativeTime} accept. */\nexport type DateInput = string | number | Date | null | undefined;\n\n/**\n * `value` as a Date, or null. A bare \"YYYY-MM-DD\" is a CALENDAR day and is read on the\n * local calendar (`parseIsoDate`) — `new Date(\"2026-07-08\")` is UTC midnight, which is\n * the 7th anywhere west of Greenwich. Anything else (a full ISO timestamp, epoch\n * milliseconds, a Date) is an instant and goes through `Date` as is.\n */\nexport function toDate(value: DateInput): Date | null {\n  if (value === null || value === undefined || value === \"\") return null;\n  if (isBareIsoDay(value)) return parseIsoDate(value);\n  const d = value instanceof Date ? value : new Date(value);\n  return Number.isNaN(d.getTime()) ? null : d;\n}\n\n/**\n * A date or timestamp in `locale`. Takes an ISO date (\"2026-07-08\", read on the local\n * calendar), an ISO timestamp (\"2026-07-08T14:05:00Z\"), epoch milliseconds or a Date.\n * `style` defaults to `medium`; see {@link FormatDateStyle}.\n *\n * `formatIsoDate` (`@eifi1/ui-kit/dates`) remains for a plain \"YYYY-MM-DD\" with an\n * explicit locale; this is its superset for timestamps and the named styles.\n */\nexport function formatDate(\n  value: DateInput,\n  style: FormatDateStyle | Intl.DateTimeFormatOptions = \"medium\",\n  options: FormatDateOptions = {},\n): string {\n  const d = toDate(value);\n  if (!d) return options.empty ?? EMPTY_FORMATTED_VALUE;\n  const base = typeof style === \"string\" ? DATE_STYLES[style] : style;\n  // A bare \"YYYY-MM-DD\" is a calendar day, which has no zone: it is the day it names\n  // wherever it is read, so a `timeZone` (in `options` or the style) never moves it — the\n  // device's local midnight shown in a zone west of it was the day before (round 0.45, N9).\n  if (isBareIsoDay(value)) {\n    const day = new Date(Date.UTC(d.getFullYear(), d.getMonth(), d.getDate()));\n    return dateFormatter(options.locale, { ...base, timeZone: \"UTC\" }).format(day);\n  }\n  return dateFormatter(options.locale, options.timeZone ? { ...base, timeZone: options.timeZone } : base).format(d);\n}\n\nexport interface FormatRelativeTimeOptions extends BaseOptions {\n  /** The zone of the date printed past `absoluteAfterDays` (0.46), and (0.51.7) the zone\n   *  whose calendar days \"yesterday\" and \"2 days ago\" count. Left out: the device's. */\n  timeZone?: string;\n  /** The moment it is measured from. Default: now. */\n  now?: DateInput;\n  /** `\"auto\"` (default): \"yesterday\", \"now\", \"next week\". `\"always\"`: \"1 day ago\". */\n  numeric?: Intl.RelativeTimeFormatNumeric;\n  /** `\"long\"` (default) \"3 hours ago\", `\"short\"` \"3 hr. ago\", `\"narrow\"` \"3h ago\". */\n  style?: Intl.RelativeTimeFormatStyle;\n  /**\n   * Past this many days either way, print the date instead ({@link formatDate} in\n   * `absoluteStyle`) — kastlan's feed switches to the date after a week, because \"5\n   * weeks ago\" makes a reader do sums. Default: never.\n   */\n  absoluteAfterDays?: number;\n  /** The style of that date. Default `medium`. */\n  absoluteStyle?: FormatDateStyle | Intl.DateTimeFormatOptions;\n}\n\nconst SECOND = 1000;\nconst MINUTE = 60 * SECOND;\nconst HOUR = 60 * MINUTE;\nconst DAY = 24 * HOUR;\n\n/** [the largest |difference| a unit is used for, the unit, its length]. */\nconst RELATIVE_STEPS: Array<[number, Intl.RelativeTimeFormatUnit, number]> = [\n  [45 * SECOND, \"second\", SECOND],\n  [45 * MINUTE, \"minute\", MINUTE],\n  [22 * HOUR, \"hour\", HOUR],\n  [6.5 * DAY, \"day\", DAY],\n  [26 * DAY, \"week\", 7 * DAY],\n  [320 * DAY, \"month\", 30.44 * DAY],\n  [Infinity, \"year\", 365.25 * DAY],\n];\n\n/**\n * `d`'s calendar day in `timeZone` (left out: the device's), as a whole number of days:\n * that day's UTC midnight over a day's length. Two of them subtract to whole calendar\n * days — a 23- or 25-hour DST day still counts one.\n */\nfunction dayNumber(d: Date, timeZone: string | undefined): number {\n  if (!timeZone) return Date.UTC(d.getFullYear(), d.getMonth(), d.getDate()) / DAY;\n  // `en-US`: Gregorian, Latin digits — the parts are read back as numbers.\n  const fields: Intl.DateTimeFormatOptions = { timeZone, year: \"numeric\", month: \"numeric\", day: \"numeric\" };\n  const parts = dateFormatter(\"en-US\", fields).formatToParts(d);\n  const part = (type: Intl.DateTimeFormatPartTypes) => Number(parts.find((p) => p.type === type)?.value);\n  return Date.UTC(part(\"year\"), part(\"month\") - 1, part(\"day\")) / DAY;\n}\n\nconst relativeFormatters = new Map<string, Intl.RelativeTimeFormat>();\nfunction relativeFormatter(\n  locale: string | undefined,\n  numeric: Intl.RelativeTimeFormatNumeric,\n  style: Intl.RelativeTimeFormatStyle,\n): Intl.RelativeTimeFormat {\n  const key = `${locale ?? \"\"}|${numeric}|${style}`;\n  let f = relativeFormatters.get(key);\n  if (!f) {\n    f = new Intl.RelativeTimeFormat(locale, { numeric, style });\n    relativeFormatters.set(key, f);\n  }\n  return f;\n}\n\n/**\n * How long ago (or until) `value` is, in `locale`'s words, through\n * `Intl.RelativeTimeFormat`: \"3 hours ago\", \"vor 3 Stunden\", \"il y a 3 heures\",\n * \"in 2 days\", and under 45 seconds \"now\". The unit is picked by size — seconds,\n * minutes, hours, days, weeks, months, years — and the count is rounded; days are\n * CALENDAR days (0.51.7), in `timeZone` when given: \"yesterday\" is the day before today,\n * however few hours ago that was.\n */\nexport function formatRelativeTime(value: DateInput, options: FormatRelativeTimeOptions = {}): string {\n  const d = toDate(value);\n  if (!d) return options.empty ?? EMPTY_FORMATTED_VALUE;\n  const now = toDate(options.now ?? new Date()) ?? new Date();\n  const diff = d.getTime() - now.getTime();\n  const abs = Math.abs(diff);\n  if (options.absoluteAfterDays !== undefined && abs > options.absoluteAfterDays * DAY) {\n    return formatDate(d, options.absoluteStyle ?? \"medium\", options);\n  }\n  const rtf = relativeFormatter(options.locale, options.numeric ?? \"auto\", options.style ?? \"long\");\n  const [, unit, size] = RELATIVE_STEPS.find(([limit]) => abs < limit)!;\n  if (unit === \"day\") {\n    // By the calendar, not in 24-hour units (refactor audit 2026-10-30, DSP-7): rounded\n    // elapsed time made 00:10 seen at 23:50 \"yesterday\" and 01:00 yesterday seen at 23:30\n    // \"2 days ago\", beside an exact date (DateMark's second line, the feedback thread's\n    // tooltip) that said otherwise. Counted in `timeZone`, the zone that date is printed\n    // in; a bare \"YYYY-MM-DD\" is the day it names wherever it is read, as in formatDate.\n    // Still the same day (22 hours and more since just after midnight): in hours.\n    const bareDay = isBareIsoDay(value);\n    const days = dayNumber(d, bareDay ? undefined : options.timeZone) - dayNumber(now, options.timeZone);\n    return days === 0 ? rtf.format(Math.round(diff / HOUR), \"hour\") : rtf.format(days, \"day\");\n  }\n  // Under 45 seconds is \"now\" rather than \"12 seconds ago\": a feed that ticks through\n  // the seconds is noise, and nothing reads a timestamp to the second.\n  const count = unit === \"second\" ? 0 : Math.round(diff / size);\n  // `+ 0` folds -0 into 0: `format(-0, …)` says \"0 seconds ago\" instead of \"now\".\n  return rtf.format(count + 0, unit);\n}\n\n/* ── Bound to the provider ─────────────────────────────────────────────────── */\n\ntype WithoutLocale<T> = Omit<T, \"locale\"> & { locale?: string };\n\n/** What {@link useKitFormat} returns: the formatters above with the provider's locale\n *  as their default (an explicit `locale` in the options still wins). */\nexport interface KitFormat {\n  /** The locale they format in — the provider's, or `undefined` (runtime default). */\n  locale: string | undefined;\n  formatNumber: (value: FormattableNumber, options?: WithoutLocale<FormatNumberOptions>) => string;\n  formatMoney: (value: FormattableNumber, currency: string, options?: WithoutLocale<FormatMoneyOptions>) => string;\n  formatPercent: (value: FormattableNumber, options?: WithoutLocale<FormatPercentOptions>) => string;\n  formatDate: (\n    value: DateInput,\n    style?: FormatDateStyle | Intl.DateTimeFormatOptions,\n    options?: WithoutLocale<FormatDateOptions>,\n  ) => string;\n  formatRelativeTime: (value: DateInput, options?: WithoutLocale<FormatRelativeTimeOptions>) => string;\n}\n\n/**\n * The formatters, bound to the `<UiKitProvider locale>` (or to `locale`, which wins\n * over it — the same precedence as a component's `locale` prop):\n *\n *     const { formatMoney, formatRelativeTime } = useKitFormat();\n *     formatMoney(row.balance, \"CHF\");\n */\nexport function useKitFormat(locale?: string): KitFormat {\n  const kitLocale = useKitLocale(locale);\n  // 0.46 (§10.3): the provider's `timeZone` for timestamps; a call's own wins, and a bare\n  // \"YYYY-MM-DD\" ignores it (formatDate).\n  const timeZone = useKitTimeZone();\n  return useMemo<KitFormat>(\n    () => ({\n      locale: kitLocale,\n      formatNumber: (value, options) => formatNumber(value, { locale: kitLocale, ...options }),\n      formatMoney: (value, currency, options) => formatMoney(value, currency, { locale: kitLocale, ...options }),\n      formatPercent: (value, options) => formatPercent(value, { locale: kitLocale, ...options }),\n      formatDate: (value, style, options) => formatDate(value, style, { locale: kitLocale, timeZone, ...options }),\n      formatRelativeTime: (value, options) => formatRelativeTime(value, { locale: kitLocale, timeZone, ...options }),\n    }),\n    [kitLocale, timeZone],\n  );\n}\n\n/* ── Currency minor units ──────────────────────────────────────────────────── */\n\n/**\n * The decimals a currency is written with — its minor unit: CHF and EUR 2, JPY 0,\n * KWD 3 — from `Intl`, or `undefined` for a code `Intl` does not accept. The rule\n * AmountInput settles a typed figure by, for a host that needs it outside the field.\n */\nexport function currencyMinorDigits(currency: string | null | undefined): number | undefined {\n  if (!currency) return undefined;\n  try {\n    return new Intl.NumberFormat(\"en\", { style: \"currency\", currency }).resolvedOptions().maximumFractionDigits;\n  } catch {\n    return undefined;\n  }\n}\n\n/** The options form of {@link roundToCurrency}'s third argument. */\nexport interface RoundToCurrencyOptions {\n  /** Decimals to round to, whatever the currency — the plain `digits` argument. */\n  digits?: number;\n  /**\n   * Decimals for a currency `Intl` cannot resolve — no code yet (`null`, `\"\"`), or a\n   * malformed one (\"EURO\", \"€\"). Left out, such a value comes back unchanged, as\n   * before. Note that `Intl` resolves ANY well-formed three-letter code, a made-up\n   * \"XYZ\" included (to 2), so this is the case of a missing or broken code, not of a\n   * rare currency.\n   */\n  fallbackDigits?: number;\n}\n\n/**\n * `value` rounded to the currency's minor unit (or to `digits`), half away from zero,\n * in decimal arithmetic: 93.4213 CHF → 93.42, 1.005 EUR → 1.01 (`Math.round(1.005 *\n * 100)` is 100, since 1.005 is 1.00499… in binary). A non-finite value, or a currency\n * `Intl` does not know without `digits`, comes back unchanged (keksdose live #356: an\n * FX estimate set into an AmountInput showed four decimals) — unless the options form\n * gives `fallbackDigits`: `roundToCurrency(v, code, { fallbackDigits: 2 })` rounds a\n * figure whose currency is not chosen yet to cents rather than leaving 0.1 + 0.2 as is.\n * A finite value never comes back NaN or -0, however small or large (BUG-11):\n * 0.1 + 0.2 - 0.3 → 0, -0.004 → 0.\n */\nexport function roundToCurrency(\n  value: number,\n  currency: string | null | undefined,\n  digits?: number | RoundToCurrencyOptions,\n): number {\n  const options = typeof digits === \"object\" && digits !== null ? digits : { digits };\n  const places = options.digits ?? currencyMinorDigits(currency) ?? options.fallbackDigits;\n  if (places === undefined) return value;\n  return roundHalfAway(value, places);\n}\n"],"mappings":"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","names":["formatWithMinus"]}

package/dist/lib/http-status.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The HTTP status of a thrown error, as one probe (DUP-11, refactor audit 2026-10: the
+ * session refresh carried its own copy).
+ *
+ * It lived in `auth/auth-errors.ts` until 0.52, which made `lib/session-refresh` and
+ * `/sync`'s engine import the auth folder — and put auth's English error words in the
+ * `/sync` entry's closure — for a three-line reader of `status` (refactor audit
+ * 2026-10-30, MOD-6). `auth-errors.ts` re-exports it, so nothing that imported it there
+ * moved.
+ *
+ * @internal Package-private — not re-exported from the barrel.
+ */
+/**
+ * The HTTP status a thrown error carries, wherever the apps' HTTP clients put it —
+ * without depending on any of them:
+ *
+ *  1. `err.response.status` — axios (all three apps' clients);
+ *  2. `err.status` — ofetch's `FetchError`, the generated OpenAPI clients' `ApiError`, and
+ *     a `Response` thrown as it came;
+ *  3. `err.statusCode` — ofetch's alias, and Node-style errors.
+ *
+ * `undefined` when none is a whole number.
+ */
+export declare function httpStatusOf(err: unknown): number | undefined;

package/dist/lib/http-status.js

@@ -0,0 +1,14 @@
+"use client";
+const isBag = (value) => typeof value === "object" && value !== null;
+function statusOf(value) {
+  return typeof value === "number" && Number.isInteger(value) ? value : void 0;
+}
+function httpStatusOf(err) {
+  if (!isBag(err)) return void 0;
+  const response = err.response;
+  return (isBag(response) ? statusOf(response.status) : void 0) ?? statusOf(err.status) ?? statusOf(err.statusCode);
+}
+export {
+  httpStatusOf
+};
+//# sourceMappingURL=http-status.js.map

package/dist/lib/http-status.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/http-status.ts"],"sourcesContent":["/**\n * The HTTP status of a thrown error, as one probe (DUP-11, refactor audit 2026-10: the\n * session refresh carried its own copy).\n *\n * It lived in `auth/auth-errors.ts` until 0.52, which made `lib/session-refresh` and\n * `/sync`'s engine import the auth folder — and put auth's English error words in the\n * `/sync` entry's closure — for a three-line reader of `status` (refactor audit\n * 2026-10-30, MOD-6). `auth-errors.ts` re-exports it, so nothing that imported it there\n * moved.\n *\n * @internal Package-private — not re-exported from the barrel.\n */\n\ntype Bag = Record<string, unknown>;\n\nconst isBag = (value: unknown): value is Bag => typeof value === \"object\" && value !== null;\n\n/** An HTTP status as a number, or undefined. */\nfunction statusOf(value: unknown): number | undefined {\n  return typeof value === \"number\" && Number.isInteger(value) ? value : undefined;\n}\n\n/**\n * The HTTP status a thrown error carries, wherever the apps' HTTP clients put it —\n * without depending on any of them:\n *\n *  1. `err.response.status` — axios (all three apps' clients);\n *  2. `err.status` — ofetch's `FetchError`, the generated OpenAPI clients' `ApiError`, and\n *     a `Response` thrown as it came;\n *  3. `err.statusCode` — ofetch's alias, and Node-style errors.\n *\n * `undefined` when none is a whole number.\n */\nexport function httpStatusOf(err: unknown): number | undefined {\n  if (!isBag(err)) return undefined;\n  const response = err.response;\n  return (isBag(response) ? statusOf(response.status) : undefined) ?? statusOf(err.status) ?? statusOf(err.statusCode);\n}\n"],"mappings":";AAeA,MAAM,QAAQ,CAAC,UAAiC,OAAO,UAAU,YAAY,UAAU;AAGvF,SAAS,SAAS,OAAoC;AACpD,SAAO,OAAO,UAAU,YAAY,OAAO,UAAU,KAAK,IAAI,QAAQ;AACxE;AAaO,SAAS,aAAa,KAAkC;AAC7D,MAAI,CAAC,MAAM,GAAG,EAAG,QAAO;AACxB,QAAM,WAAW,IAAI;AACrB,UAAQ,MAAM,QAAQ,IAAI,SAAS,SAAS,MAAM,IAAI,WAAc,SAAS,IAAI,MAAM,KAAK,SAAS,IAAI,UAAU;AACrH;","names":[]}

package/dist/lib/intl-cache.d.ts

@@ -0,0 +1,14 @@
+/**
+ * One `Intl.DateTimeFormat` per locale and option set, for every date the kit prints.
+ *
+ * Constructing the formatter is the expensive part: keksdose measured 392 ms per click on
+ * a 270-row register when each cell built its own (dev#632), and kept its own renderer of
+ * the date-format preference because the kit's built one per call (refactor audit
+ * 2026-10-30, DUP-2). `lib/format` and `lib/date-format` both format through this one.
+ *
+ * @internal Not part of the barrel — `lib/format` is re-exported whole, so the cache
+ * lives apart from it.
+ */
+/** The cached formatter for `locale` and `options`. Throws as `Intl.DateTimeFormat` does
+ *  for a tag it refuses — and caches nothing then. */
+export declare function dateFormatter(locale: string | undefined, options: Intl.DateTimeFormatOptions): Intl.DateTimeFormat;

package/dist/lib/intl-cache.js

@@ -0,0 +1,15 @@
+"use client";
+const dateFormatters = /* @__PURE__ */ new Map();
+function dateFormatter(locale, options) {
+  const key = `${locale ?? ""}|${JSON.stringify(options)}`;
+  let f = dateFormatters.get(key);
+  if (!f) {
+    f = new Intl.DateTimeFormat(locale, options);
+    dateFormatters.set(key, f);
+  }
+  return f;
+}
+export {
+  dateFormatter
+};
+//# sourceMappingURL=intl-cache.js.map

package/dist/lib/intl-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/intl-cache.ts"],"sourcesContent":["/**\n * One `Intl.DateTimeFormat` per locale and option set, for every date the kit prints.\n *\n * Constructing the formatter is the expensive part: keksdose measured 392 ms per click on\n * a 270-row register when each cell built its own (dev#632), and kept its own renderer of\n * the date-format preference because the kit's built one per call (refactor audit\n * 2026-10-30, DUP-2). `lib/format` and `lib/date-format` both format through this one.\n *\n * @internal Not part of the barrel — `lib/format` is re-exported whole, so the cache\n * lives apart from it.\n */\n\nconst dateFormatters = new Map<string, Intl.DateTimeFormat>();\n\n/** The cached formatter for `locale` and `options`. Throws as `Intl.DateTimeFormat` does\n *  for a tag it refuses — and caches nothing then. */\nexport function dateFormatter(locale: string | undefined, options: Intl.DateTimeFormatOptions): Intl.DateTimeFormat {\n  const key = `${locale ?? \"\"}|${JSON.stringify(options)}`;\n  let f = dateFormatters.get(key);\n  if (!f) {\n    f = new Intl.DateTimeFormat(locale, options);\n    dateFormatters.set(key, f);\n  }\n  return f;\n}\n"],"mappings":";AAYA,MAAM,iBAAiB,oBAAI,IAAiC;AAIrD,SAAS,cAAc,QAA4B,SAA0D;AAClH,QAAM,MAAM,GAAG,UAAU,EAAE,IAAI,KAAK,UAAU,OAAO,CAAC;AACtD,MAAI,IAAI,eAAe,IAAI,GAAG;AAC9B,MAAI,CAAC,GAAG;AACN,QAAI,IAAI,KAAK,eAAe,QAAQ,OAAO;AAC3C,mBAAe,IAAI,KAAK,CAAC;AAAA,EAC3B;AACA,SAAO;AACT;","names":[]}

package/dist/lib/isin.d.ts

@@ -9,20 +9,30 @@
  * 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;

package/dist/lib/isin.js.map

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

package/dist/lib/iso-day.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The bare ISO calendar day, `"YYYY-MM-DD"` — no time, no zone: the day it names in every
+ * zone. `toDate` and `formatDate` (lib/format), the kit's day ladder (`useDayFormatter`,
+ * lib/day-format) and the preference's renderers (lib/date-format) each kept a copy of this
+ * pattern (0.52 code review, lib/day-format.ts). Were one to learn a new shape (say
+ * `YYYY-MM-DDT00:00`) alone, the ladder would ask the provider for a different day than the
+ * kit prints. One rule.
+ *
+ * @internal Not part of the barrel: `lib/format` is re-exported whole, so it lives apart.
+ */
+export declare function isBareIsoDay(value: unknown): value is string;

package/dist/lib/iso-day.js

@@ -0,0 +1,8 @@
+"use client";
+function isBareIsoDay(value) {
+  return typeof value === "string" && /^\d{4}-\d{2}-\d{2}$/.test(value);
+}
+export {
+  isBareIsoDay
+};
+//# sourceMappingURL=iso-day.js.map

package/dist/lib/iso-day.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/iso-day.ts"],"sourcesContent":["/**\n * The bare ISO calendar day, `\"YYYY-MM-DD\"` — no time, no zone: the day it names in every\n * zone. `toDate` and `formatDate` (lib/format), the kit's day ladder (`useDayFormatter`,\n * lib/day-format) and the preference's renderers (lib/date-format) each kept a copy of this\n * pattern (0.52 code review, lib/day-format.ts). Were one to learn a new shape (say\n * `YYYY-MM-DDT00:00`) alone, the ladder would ask the provider for a different day than the\n * kit prints. One rule.\n *\n * @internal Not part of the barrel: `lib/format` is re-exported whole, so it lives apart.\n */\nexport function isBareIsoDay(value: unknown): value is string {\n  return typeof value === \"string\" && /^\\d{4}-\\d{2}-\\d{2}$/.test(value);\n}\n"],"mappings":";AAUO,SAAS,aAAa,OAAiC;AAC5D,SAAO,OAAO,UAAU,YAAY,sBAAsB,KAAK,KAAK;AACtE;","names":[]}

package/dist/lib/lazy-with-fallback.d.ts

@@ -0,0 +1,31 @@
+import type { ComponentType } from "react";
+/** What a {@link lazyWithFallback} fallback is given besides the component's own props. */
+export interface LazyFallbackProps {
+    /** What the import rejected with. Already on `console.error`. */
+    error: unknown;
+    /** Fetch the module again and draw it here if it comes (back online, the deploy's
+     *  new chunk). Call it on the person's next attempt, never at once: offline, a retry
+     *  on mount would fetch in a loop. */
+    retry: () => void;
+}
+/**
+ * `React.lazy` for a module the kit loads late (refactor audit 2026-10, MOD-1: the tour
+ * overlay, the search palette, the feedback dialog), where an import that fails — a tab
+ * left open across a deploy, a local-first app offline — draws `Fallback` instead of
+ * throwing.
+ *
+ * `React.lazy` keeps what its import settled to, so one failed fetch threw on every render
+ * for as long as the component stayed mounted, to the nearest error boundary. All three
+ * sit above the routes — in the provider every app mounts, in the top bar — where that
+ * boundary is the whole app's: a white page because somebody pressed ⌘K or "Take the
+ * tour" (0.52 code review, tour.tsx: the tour's own fix, written by hand with a module-level
+ * `let`, made shared here).
+ *
+ * A failure is logged and the next mount (or the fallback's `retry`) fetches again; a
+ * re-render of a mounted fallback does not. `load` resolves to the component itself,
+ * through a LITERAL relative dynamic import of its module (as feedback-submit's), so an
+ * app's bundler can split it off. Render the result under a `Suspense`, as a lazy
+ * component. (No import call is spelled out here: the build's fix-esm-extensions step
+ * reads specifiers in the .d.ts comments too, and would try to resolve an example.)
+ */
+export declare function lazyWithFallback<P extends object>(load: () => Promise<ComponentType<P>>, Fallback: ComponentType<P & LazyFallbackProps>): ComponentType<P>;

package/dist/lib/lazy-with-fallback.js

@@ -0,0 +1,40 @@
+"use client";
+import { createContext, createElement, lazy, useCallback, useContext, useLayoutEffect, useState } from "react";
+const RetryContext = createContext(() => {
+});
+function lazyWithFallback(load, Fallback) {
+  const attempt = () => {
+    const made = {
+      spent: false,
+      Component: lazy(
+        () => load().then(
+          (Loaded) => ({ default: Loaded }),
+          (error) => {
+            console.error(error);
+            function Failed(props) {
+              const retry = useContext(RetryContext);
+              useLayoutEffect(() => {
+                made.spent = true;
+              }, []);
+              return createElement(Fallback, { ...props, error, retry });
+            }
+            return { default: Failed };
+          }
+        )
+      )
+    };
+    return made;
+  };
+  let latest = attempt();
+  const take = () => latest.spent ? latest = attempt() : latest;
+  function LazyWithFallback(props) {
+    const [current, setCurrent] = useState(take);
+    const retry = useCallback(() => setCurrent(take), []);
+    return createElement(RetryContext.Provider, { value: retry }, createElement(current.Component, props));
+  }
+  return LazyWithFallback;
+}
+export {
+  lazyWithFallback
+};
+//# sourceMappingURL=lazy-with-fallback.js.map

package/dist/lib/lazy-with-fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/lazy-with-fallback.ts"],"sourcesContent":["import { createContext, createElement, lazy, useCallback, useContext, useLayoutEffect, useState } from \"react\";\nimport type { ComponentType, LazyExoticComponent } from \"react\";\n\n/** What a {@link lazyWithFallback} fallback is given besides the component's own props. */\nexport interface LazyFallbackProps {\n  /** What the import rejected with. Already on `console.error`. */\n  error: unknown;\n  /** Fetch the module again and draw it here if it comes (back online, the deploy's\n   *  new chunk). Call it on the person's next attempt, never at once: offline, a retry\n   *  on mount would fetch in a loop. */\n  retry: () => void;\n}\n\ninterface Attempt<P> {\n  Component: LazyExoticComponent<ComponentType<P>>;\n  /** Its import failed and its fallback was drawn: the next mount, or `retry`, takes a\n   *  fresh attempt. Marked when the fallback COMMITS, not when the import rejects: a\n   *  first mount that suspended is thrown away and rendered anew, and an attempt marked\n   *  at the rejection would hand that re-render a fresh import — which fails, and so on. */\n  spent: boolean;\n}\n\nconst RetryContext = createContext<() => void>(() => {});\n\n/**\n * `React.lazy` for a module the kit loads late (refactor audit 2026-10, MOD-1: the tour\n * overlay, the search palette, the feedback dialog), where an import that fails — a tab\n * left open across a deploy, a local-first app offline — draws `Fallback` instead of\n * throwing.\n *\n * `React.lazy` keeps what its import settled to, so one failed fetch threw on every render\n * for as long as the component stayed mounted, to the nearest error boundary. All three\n * sit above the routes — in the provider every app mounts, in the top bar — where that\n * boundary is the whole app's: a white page because somebody pressed ⌘K or \"Take the\n * tour\" (0.52 code review, tour.tsx: the tour's own fix, written by hand with a module-level\n * `let`, made shared here).\n *\n * A failure is logged and the next mount (or the fallback's `retry`) fetches again; a\n * re-render of a mounted fallback does not. `load` resolves to the component itself,\n * through a LITERAL relative dynamic import of its module (as feedback-submit's), so an\n * app's bundler can split it off. Render the result under a `Suspense`, as a lazy\n * component. (No import call is spelled out here: the build's fix-esm-extensions step\n * reads specifiers in the .d.ts comments too, and would try to resolve an example.)\n */\nexport function lazyWithFallback<P extends object>(\n  load: () => Promise<ComponentType<P>>,\n  Fallback: ComponentType<P & LazyFallbackProps>,\n): ComponentType<P> {\n  const attempt = (): Attempt<P> => {\n    const made: Attempt<P> = {\n      spent: false,\n      Component: lazy<ComponentType<P>>(() =>\n        load().then(\n          (Loaded) => ({ default: Loaded }),\n          (error: unknown) => {\n            console.error(error);\n            function Failed(props: P) {\n              const retry = useContext(RetryContext);\n              useLayoutEffect(() => {\n                made.spent = true;\n              }, []);\n              return createElement(Fallback, { ...props, error, retry });\n            }\n            return { default: Failed };\n          },\n        ),\n      ),\n    };\n    return made;\n  };\n  let latest = attempt();\n  /** The attempt a new mount takes: the latest, or a fresh one once that has failed. */\n  const take = () => (latest.spent ? (latest = attempt()) : latest);\n\n  function LazyWithFallback(props: P) {\n    // Fixed per mount, so a re-render of a mounted fallback fetches nothing.\n    const [current, setCurrent] = useState(take);\n    const retry = useCallback(() => setCurrent(take), []);\n    return createElement(RetryContext.Provider, { value: retry }, createElement(current.Component, props));\n  }\n  return LazyWithFallback;\n}\n"],"mappings":";AAAA,SAAS,eAAe,eAAe,MAAM,aAAa,YAAY,iBAAiB,gBAAgB;AAsBvG,MAAM,eAAe,cAA0B,MAAM;AAAC,CAAC;AAsBhD,SAAS,iBACd,MACA,UACkB;AAClB,QAAM,UAAU,MAAkB;AAChC,UAAM,OAAmB;AAAA,MACvB,OAAO;AAAA,MACP,WAAW;AAAA,QAAuB,MAChC,KAAK,EAAE;AAAA,UACL,CAAC,YAAY,EAAE,SAAS,OAAO;AAAA,UAC/B,CAAC,UAAmB;AAClB,oBAAQ,MAAM,KAAK;AACnB,qBAAS,OAAO,OAAU;AACxB,oBAAM,QAAQ,WAAW,YAAY;AACrC,8BAAgB,MAAM;AACpB,qBAAK,QAAQ;AAAA,cACf,GAAG,CAAC,CAAC;AACL,qBAAO,cAAc,UAAU,EAAE,GAAG,OAAO,OAAO,MAAM,CAAC;AAAA,YAC3D;AACA,mBAAO,EAAE,SAAS,OAAO;AAAA,UAC3B;AAAA,QACF;AAAA,MACF;AAAA,IACF;AACA,WAAO;AAAA,EACT;AACA,MAAI,SAAS,QAAQ;AAErB,QAAM,OAAO,MAAO,OAAO,QAAS,SAAS,QAAQ,IAAK;AAE1D,WAAS,iBAAiB,OAAU;AAElC,UAAM,CAAC,SAAS,UAAU,IAAI,SAAS,IAAI;AAC3C,UAAM,QAAQ,YAAY,MAAM,WAAW,IAAI,GAAG,CAAC,CAAC;AACpD,WAAO,cAAc,aAAa,UAAU,EAAE,OAAO,MAAM,GAAG,cAAc,QAAQ,WAAW,KAAK,CAAC;AAAA,EACvG;AACA,SAAO;AACT;","names":[]}

package/dist/lib/path-pattern.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Whether a pathname is one a `PathPattern` names — the rule `useLastVisitedPage`'s
+ * `exclude` reads (landing/routing.tsx) and the feedback guard's one-shot routes
+ * (refactor audit 2026-10-30, FLW-7), here without the router: `landing/routing` imports
+ * react-router, which `/feedback` must not drag in. The one copy: routing kept a private
+ * one, and the two had drifted within the round (0.52 code review, this file).
+ *
+ * A string is that path and everything under it (`/join` is `/join` and `/join/abc`, not
+ * `/joined`; `/` is only `/`); a RegExp is tested on the pathname (a `g` flag dropped, so
+ * `lastIndex` never carries over between calls).
+ *
+ * Case-INSENSITIVE, as React Router matches a route unless it sets `caseSensitive` (0.52
+ * code review, feedback/feedback-page-link.ts): the FLW-7 guard compared case-sensitively,
+ * and `/Join?token=` went out as a link the router still rendered as `/join`. A RegExp
+ * gets the `i` flag for the same reason. Matching more than a case-sensitive route would
+ * only turns a link into text, or leaves a page unrecorded as a resume target: both
+ * callers' safe side.
+ *
+ * @internal Package-private — not re-exported from the barrel.
+ */
+export declare function matchesPathPattern(pathname: string, pattern: string | RegExp): boolean;
+/**
+ * The pathname of `href` (a path with its query and hash) as React Router matches it:
+ * each segment percent-decoded, an encoded `/` kept as `%2F` so it never splits a segment
+ * (react-router 8, `decodePath` in `matchRoutesImpl`). The 0.52 code review
+ * (feedback/feedback-page-link.ts) found `/j%6Fin?token=` passing the FLW-7 guard as a
+ * link that the router decoded to `/join`.
+ *
+ * A malformed escape leaves its own segment as written, where the router gives up on the
+ * whole path: the rest still decodes, so the answer is never less than the router's.
+ *
+ * @internal Package-private — not re-exported from the barrel.
+ */
+export declare function routerPathname(href: string): string;

package/dist/lib/path-pattern.js

@@ -0,0 +1,24 @@
+"use client";
+function matchesPathPattern(pathname, pattern) {
+  if (typeof pattern !== "string") {
+    return new RegExp(pattern.source, `${pattern.flags.replace(/[gi]/g, "")}i`).test(pathname);
+  }
+  const path = pathname.toLowerCase();
+  if (pattern === "/") return path === "/";
+  const base = (pattern.endsWith("/") ? pattern.slice(0, -1) : pattern).toLowerCase();
+  return path === base || path.startsWith(`${base}/`);
+}
+function routerPathname(href) {
+  return href.replace(/[?#].*$/, "").split("/").map((segment) => {
+    try {
+      return decodeURIComponent(segment).replace(/\//g, "%2F");
+    } catch {
+      return segment;
+    }
+  }).join("/");
+}
+export {
+  matchesPathPattern,
+  routerPathname
+};
+//# sourceMappingURL=path-pattern.js.map

package/dist/lib/path-pattern.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/path-pattern.ts"],"sourcesContent":["/**\n * Whether a pathname is one a `PathPattern` names — the rule `useLastVisitedPage`'s\n * `exclude` reads (landing/routing.tsx) and the feedback guard's one-shot routes\n * (refactor audit 2026-10-30, FLW-7), here without the router: `landing/routing` imports\n * react-router, which `/feedback` must not drag in. The one copy: routing kept a private\n * one, and the two had drifted within the round (0.52 code review, this file).\n *\n * A string is that path and everything under it (`/join` is `/join` and `/join/abc`, not\n * `/joined`; `/` is only `/`); a RegExp is tested on the pathname (a `g` flag dropped, so\n * `lastIndex` never carries over between calls).\n *\n * Case-INSENSITIVE, as React Router matches a route unless it sets `caseSensitive` (0.52\n * code review, feedback/feedback-page-link.ts): the FLW-7 guard compared case-sensitively,\n * and `/Join?token=` went out as a link the router still rendered as `/join`. A RegExp\n * gets the `i` flag for the same reason. Matching more than a case-sensitive route would\n * only turns a link into text, or leaves a page unrecorded as a resume target: both\n * callers' safe side.\n *\n * @internal Package-private — not re-exported from the barrel.\n */\nexport function matchesPathPattern(pathname: string, pattern: string | RegExp): boolean {\n  if (typeof pattern !== \"string\") {\n    return new RegExp(pattern.source, `${pattern.flags.replace(/[gi]/g, \"\")}i`).test(pathname);\n  }\n  const path = pathname.toLowerCase();\n  if (pattern === \"/\") return path === \"/\";\n  const base = (pattern.endsWith(\"/\") ? pattern.slice(0, -1) : pattern).toLowerCase();\n  return path === base || path.startsWith(`${base}/`);\n}\n\n/**\n * The pathname of `href` (a path with its query and hash) as React Router matches it:\n * each segment percent-decoded, an encoded `/` kept as `%2F` so it never splits a segment\n * (react-router 8, `decodePath` in `matchRoutesImpl`). The 0.52 code review\n * (feedback/feedback-page-link.ts) found `/j%6Fin?token=` passing the FLW-7 guard as a\n * link that the router decoded to `/join`.\n *\n * A malformed escape leaves its own segment as written, where the router gives up on the\n * whole path: the rest still decodes, so the answer is never less than the router's.\n *\n * @internal Package-private — not re-exported from the barrel.\n */\nexport function routerPathname(href: string): string {\n  return href\n    .replace(/[?#].*$/, \"\")\n    .split(\"/\")\n    .map((segment) => {\n      try {\n        return decodeURIComponent(segment).replace(/\\//g, \"%2F\");\n      } catch {\n        return segment;\n      }\n    })\n    .join(\"/\");\n}\n"],"mappings":";AAoBO,SAAS,mBAAmB,UAAkB,SAAmC;AACtF,MAAI,OAAO,YAAY,UAAU;AAC/B,WAAO,IAAI,OAAO,QAAQ,QAAQ,GAAG,QAAQ,MAAM,QAAQ,SAAS,EAAE,CAAC,GAAG,EAAE,KAAK,QAAQ;AAAA,EAC3F;AACA,QAAM,OAAO,SAAS,YAAY;AAClC,MAAI,YAAY,IAAK,QAAO,SAAS;AACrC,QAAM,QAAQ,QAAQ,SAAS,GAAG,IAAI,QAAQ,MAAM,GAAG,EAAE,IAAI,SAAS,YAAY;AAClF,SAAO,SAAS,QAAQ,KAAK,WAAW,GAAG,IAAI,GAAG;AACpD;AAcO,SAAS,eAAe,MAAsB;AACnD,SAAO,KACJ,QAAQ,WAAW,EAAE,EACrB,MAAM,GAAG,EACT,IAAI,CAAC,YAAY;AAChB,QAAI;AACF,aAAO,mBAAmB,OAAO,EAAE,QAAQ,OAAO,KAAK;AAAA,IACzD,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF,CAAC,EACA,KAAK,GAAG;AACb;","names":[]}

package/dist/lib/reduced-motion.d.ts

@@ -13,6 +13,7 @@
  * screen only delays its `onClose` — every test suite, the kit's and the apps', reads a
  * closed overlay as gone at once.
  *
- * Package-private — not re-exported from the barrel.
+ * Public since 0.52 (DUP-8, refactor audit 2026-10-30): Kurvenschmiede's chain animation
+ * carried a copy of its own.
  */
 export declare function prefersReducedMotion(whereUnknown?: boolean): boolean;

package/dist/lib/reduced-motion.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/reduced-motion.ts"],"sourcesContent":["/**\n * Whether the user has asked for no motion (`prefers-reduced-motion: reduce`), read NOW —\n * not at mount: the setting can change under a long-lived page. The kit's one copy\n * (DUP-11, refactor audit 2026-10: the settings focus and the exit timers each had their\n * own, with opposite answers where `matchMedia` is missing).\n *\n * Where there is no `matchMedia` to ask (SSR, jsdom) the answer is `whereUnknown`,\n * default `false`: motion allowed — the platform's own default, `no-preference`, which\n * is what a browser that cannot say otherwise has. A smooth scroll there is harmless.\n *\n * An exit animation passes `true` (`skipsExitAnimation` in `hooks/use-close-transition`):\n * without `matchMedia` nothing is painting, and a timer that holds an unpainted panel on\n * screen only delays its `onClose` — every test suite, the kit's and the apps', reads a\n * closed overlay as gone at once.\n *\n * Package-private — not re-exported from the barrel.\n */\nexport function prefersReducedMotion(whereUnknown = false): boolean {\n  if (typeof window === \"undefined\" || typeof window.matchMedia !== \"function\") return whereUnknown;\n  return window.matchMedia(\"(prefers-reduced-motion: reduce)\").matches;\n}\n"],"mappings":";AAiBO,SAAS,qBAAqB,eAAe,OAAgB;AAClE,MAAI,OAAO,WAAW,eAAe,OAAO,OAAO,eAAe,WAAY,QAAO;AACrF,SAAO,OAAO,WAAW,kCAAkC,EAAE;AAC/D;","names":[]}
+{"version":3,"sources":["../../src/lib/reduced-motion.ts"],"sourcesContent":["/**\n * Whether the user has asked for no motion (`prefers-reduced-motion: reduce`), read NOW —\n * not at mount: the setting can change under a long-lived page. The kit's one copy\n * (DUP-11, refactor audit 2026-10: the settings focus and the exit timers each had their\n * own, with opposite answers where `matchMedia` is missing).\n *\n * Where there is no `matchMedia` to ask (SSR, jsdom) the answer is `whereUnknown`,\n * default `false`: motion allowed — the platform's own default, `no-preference`, which\n * is what a browser that cannot say otherwise has. A smooth scroll there is harmless.\n *\n * An exit animation passes `true` (`skipsExitAnimation` in `hooks/use-close-transition`):\n * without `matchMedia` nothing is painting, and a timer that holds an unpainted panel on\n * screen only delays its `onClose` — every test suite, the kit's and the apps', reads a\n * closed overlay as gone at once.\n *\n * Public since 0.52 (DUP-8, refactor audit 2026-10-30): Kurvenschmiede's chain animation\n * carried a copy of its own.\n */\nexport function prefersReducedMotion(whereUnknown = false): boolean {\n  if (typeof window === \"undefined\" || typeof window.matchMedia !== \"function\") return whereUnknown;\n  return window.matchMedia(\"(prefers-reduced-motion: reduce)\").matches;\n}\n"],"mappings":";AAkBO,SAAS,qBAAqB,eAAe,OAAgB;AAClE,MAAI,OAAO,WAAW,eAAe,OAAO,OAAO,eAAe,WAAY,QAAO;AACrF,SAAO,OAAO,WAAW,kCAAkC,EAAE;AAC/D;","names":[]}

package/dist/lib/round.d.ts

@@ -17,6 +17,7 @@
  * `n` rounded to `digits` decimals, half away from zero, in decimal arithmetic:
  * 1.005 → 1.01, -2.5 at 0 → -3. Never NaN for a finite `n`, and never -0 — `formatMoney`
  * prints -0 as "-0,00 €", so a negative that rounds away comes back as 0. A non-finite
- * `n` comes back unchanged.
+ * `n` comes back unchanged. `digits` counts in whole decimals, as `toFixed` takes it: 2.5
+ * is 2, and NaN is 0.
  */
 export declare function roundHalfAway(n: number, digits: number): number;

package/dist/lib/round.js

@@ -5,8 +5,9 @@ function shiftDecimal(value, by) {
 }
 function roundHalfAway(n, digits) {
   if (!Number.isFinite(n)) return n;
+  const places = Math.trunc(digits) || 0;
   const abs = Math.abs(n);
-  const magnitude = abs >= 2 ** 53 ? abs : shiftDecimal(Math.round(shiftDecimal(abs, digits)), -digits);
+  const magnitude = abs >= 2 ** 53 ? abs : shiftDecimal(Math.round(shiftDecimal(abs, places)), -places);
   return (n < 0 ? -magnitude : magnitude) || 0;
 }
 export {

package/dist/lib/round.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/round.ts"],"sourcesContent":["/**\n * Decimal rounding, half away from zero — the one copy behind {@link roundToCurrency}\n * and AmountInput's settle (BUG-11, refactor audit 2026-10).\n *\n * Package-private — not re-exported from the barrel; `format.ts` and `calc.ts` are\n * re-exported wholesale, so a helper there would become API.\n *\n * WHY THE STRING SHIFT. `Math.round(1.005 * 100)` is 100, because 1.005 is 1.00499…\n * in binary. Shifting the decimal point in the number's SHORTEST spelling instead\n * (\"1.005e2\" is exactly 100.5) rounds the figure a person typed. Both helpers did that\n * by gluing `e${digits}` onto `String(n)` — but `String(n)` is itself in exponent form\n * below 1e-6 and at or above 1e21, and \"5.55e-17e2\" is NaN: `roundToCurrency(0.1 + 0.2\n * - 0.3, \"EUR\")` was NaN, and AmountInput blanked a typed \"0.0000001\" on blur (U-2's\n * class, 2026-08-24). {@link shiftDecimal} moves the exponent the string already has.\n */\n\n/** `value × 10^by`, by moving the exponent of its shortest spelling (\"1.005\" → \"1.005e2\",\n *  \"5.55e-17\" → \"5.55e-15\"), so no binary multiplication creeps in. */\nfunction shiftDecimal(value: number, by: number): number {\n  const [mantissa, exponent = \"0\"] = String(value).split(\"e\");\n  return Number(`${mantissa}e${Number(exponent) + by}`);\n}\n\n/**\n * `n` rounded to `digits` decimals, half away from zero, in decimal arithmetic:\n * 1.005 → 1.01, -2.5 at 0 → -3. Never NaN for a finite `n`, and never -0 — `formatMoney`\n * prints -0 as \"-0,00 €\", so a negative that rounds away comes back as 0. A non-finite\n * `n` comes back unchanged.\n */\nexport function roundHalfAway(n: number, digits: number): number {\n  if (!Number.isFinite(n)) return n;\n  const abs = Math.abs(n);\n  // Every double from 2^53 up is a whole number already, and scaling one near\n  // Number.MAX_VALUE up would overflow to Infinity.\n  const magnitude = abs >= 2 ** 53 ? abs : shiftDecimal(Math.round(shiftDecimal(abs, digits)), -digits);\n  // The sign goes back on after rounding, so `|| 0` must see the signed result.\n  return (n < 0 ? -magnitude : magnitude) || 0;\n}\n"],"mappings":";AAkBA,SAAS,aAAa,OAAe,IAAoB;AACvD,QAAM,CAAC,UAAU,WAAW,GAAG,IAAI,OAAO,KAAK,EAAE,MAAM,GAAG;AAC1D,SAAO,OAAO,GAAG,QAAQ,IAAI,OAAO,QAAQ,IAAI,EAAE,EAAE;AACtD;AAQO,SAAS,cAAc,GAAW,QAAwB;AAC/D,MAAI,CAAC,OAAO,SAAS,CAAC,EAAG,QAAO;AAChC,QAAM,MAAM,KAAK,IAAI,CAAC;AAGtB,QAAM,YAAY,OAAO,KAAK,KAAK,MAAM,aAAa,KAAK,MAAM,aAAa,KAAK,MAAM,CAAC,GAAG,CAAC,MAAM;AAEpG,UAAQ,IAAI,IAAI,CAAC,YAAY,cAAc;AAC7C;","names":[]}
+{"version":3,"sources":["../../src/lib/round.ts"],"sourcesContent":["/**\n * Decimal rounding, half away from zero — the one copy behind {@link roundToCurrency}\n * and AmountInput's settle (BUG-11, refactor audit 2026-10).\n *\n * Package-private — not re-exported from the barrel; `format.ts` and `calc.ts` are\n * re-exported wholesale, so a helper there would become API.\n *\n * WHY THE STRING SHIFT. `Math.round(1.005 * 100)` is 100, because 1.005 is 1.00499…\n * in binary. Shifting the decimal point in the number's SHORTEST spelling instead\n * (\"1.005e2\" is exactly 100.5) rounds the figure a person typed. Both helpers did that\n * by gluing `e${digits}` onto `String(n)` — but `String(n)` is itself in exponent form\n * below 1e-6 and at or above 1e21, and \"5.55e-17e2\" is NaN: `roundToCurrency(0.1 + 0.2\n * - 0.3, \"EUR\")` was NaN, and AmountInput blanked a typed \"0.0000001\" on blur (U-2's\n * class, 2026-08-24). {@link shiftDecimal} moves the exponent the string already has.\n */\n\n/** `value × 10^by`, by moving the exponent of its shortest spelling (\"1.005\" → \"1.005e2\",\n *  \"5.55e-17\" → \"5.55e-15\"), so no binary multiplication creeps in. */\nfunction shiftDecimal(value: number, by: number): number {\n  const [mantissa, exponent = \"0\"] = String(value).split(\"e\");\n  return Number(`${mantissa}e${Number(exponent) + by}`);\n}\n\n/**\n * `n` rounded to `digits` decimals, half away from zero, in decimal arithmetic:\n * 1.005 → 1.01, -2.5 at 0 → -3. Never NaN for a finite `n`, and never -0 — `formatMoney`\n * prints -0 as \"-0,00 €\", so a negative that rounds away comes back as 0. A non-finite\n * `n` comes back unchanged. `digits` counts in whole decimals, as `toFixed` takes it: 2.5\n * is 2, and NaN is 0.\n */\nexport function roundHalfAway(n: number, digits: number): number {\n  if (!Number.isFinite(n)) return n;\n  // \"1.2345e2.5\" is NaN, and `|| 0` below made it 0: MeasuredGrid's `digits`, which went to\n  // `toFixed` before DUP-14 brought it here, wrote every computed cell of a table with a\n  // fractional one as \"0\" (0.52 code review, deep, charts, finding 5).\n  const places = Math.trunc(digits) || 0;\n  const abs = Math.abs(n);\n  // Every double from 2^53 up is a whole number already, and scaling one near\n  // Number.MAX_VALUE up would overflow to Infinity.\n  const magnitude = abs >= 2 ** 53 ? abs : shiftDecimal(Math.round(shiftDecimal(abs, places)), -places);\n  // The sign goes back on after rounding, so `|| 0` must see the signed result.\n  return (n < 0 ? -magnitude : magnitude) || 0;\n}\n"],"mappings":";AAkBA,SAAS,aAAa,OAAe,IAAoB;AACvD,QAAM,CAAC,UAAU,WAAW,GAAG,IAAI,OAAO,KAAK,EAAE,MAAM,GAAG;AAC1D,SAAO,OAAO,GAAG,QAAQ,IAAI,OAAO,QAAQ,IAAI,EAAE,EAAE;AACtD;AASO,SAAS,cAAc,GAAW,QAAwB;AAC/D,MAAI,CAAC,OAAO,SAAS,CAAC,EAAG,QAAO;AAIhC,QAAM,SAAS,KAAK,MAAM,MAAM,KAAK;AACrC,QAAM,MAAM,KAAK,IAAI,CAAC;AAGtB,QAAM,YAAY,OAAO,KAAK,KAAK,MAAM,aAAa,KAAK,MAAM,aAAa,KAAK,MAAM,CAAC,GAAG,CAAC,MAAM;AAEpG,UAAQ,IAAI,IAAI,CAAC,YAAY,cAAc;AAC7C;","names":[]}

package/dist/lib/safe-storage.d.ts

@@ -16,14 +16,21 @@
  *
  * Since 0.34 (DUP-11, refactor audit 2026-10) it also removes, and guards
  * `sessionStorage` the same way: `landing/routing`, `billing/checkout-processing` and
- * the demo banner each wrote that guard again by hand. `removeStored` and the session
- * pair are package-private — the barrel exports `readStored` / `writeStored` only.
+ * the demo banner each wrote that guard again by hand.
+ *
+ * Since 0.52 all of it but {@link storedKeys} is public, with a JSON pair beside it
+ * (DUP-8, refactor audit 2026-10-30). Kept package-private, the guard was written again
+ * four times in the kit's showcase and in 16 files across the three apps, some of them
+ * without it: a token read that throws where storage is blocked takes every request
+ * down with it. (The kit's own DevMenu, 0.51, wrote the session pair a second time too.)
  */
 /** The stored string for `key`, or null when absent, unreadable, or blocked. */
 export declare function readStored(key: string): string | null;
 /** Store `value` under `key`, silently doing nothing when storage is unavailable
- *  or full. A preference that cannot be persisted is not worth an exception. */
-export declare function writeStored(key: string, value: string): void;
+ *  or full. A preference that cannot be persisted is not worth an exception. `null`
+ *  removes the key, as {@link writeSessionStored}'s does (0.52; the two pairs wrote
+ *  differently, and `null` past the types stored the string "null" — 0.52 code review). */
+export declare function writeStored(key: string, value: string | null): void;
 /** Forget `key`, silently doing nothing when storage is blocked — there is nothing to
  *  forget then. */
 export declare function removeStored(key: string): void;
@@ -31,9 +38,21 @@ export declare function removeStored(key: string): void;
 export declare function readSessionStored(key: string): string | null;
 /** {@link writeStored} for `sessionStorage`; `null` removes the key. */
 export declare function writeSessionStored(key: string, value: string | null): void;
+/**
+ * The JSON stored under `key`, when it parses and `isShape` accepts it; else `null`. Absent,
+ * blocked, malformed and another shape all read as "never set" — the caller's default —
+ * which is what the six hand-written `JSON.parse(readStored(key))` reads in the kit each
+ * answered in their own try/catch (DUP-8). `isShape` gets the parsed value as `unknown`:
+ * the shape check is the one part that is the caller's. A shape check that throws reads
+ * as another shape: null.
+ */
+export declare function readStoredJson<T>(key: string, isShape: (value: unknown) => value is T): T | null;
+/** Store `value` as JSON under `key`, silently doing nothing when storage is unavailable
+ *  or full, or the value has no JSON form (a cycle, a BigInt) — {@link writeStored}'s rule. */
+export declare function writeStoredJson(key: string, value: unknown): void;
 /**
  * Every key in `area` that starts with `prefix`, or `[]` where storage refuses — for the
  * reset of this device's settings, which removes a table's views by their prefix
- * (docs/settings-harmonization.md §11.4). Package-private, like {@link removeStored}.
+ * (docs/settings-harmonization.md §11.4). Package-private: the reset's alone.
  */
 export declare function storedKeys(prefix: string, area?: "local" | "session"): string[];