@eifi1/ui-kit 0.48.2 → 0.50.0

package/dist/lib/document-title.js

@@ -0,0 +1,29 @@
+"use client";
+const DEFAULT_DOCUMENT_TITLE_FORMAT = "{page} \xB7 {section} \xB7 {app}";
+const PLACEHOLDER = /\{(page|section|app)\}/g;
+function formatDocumentTitle(format, parts) {
+  let prefix = "";
+  let out = "";
+  let pending = "";
+  let last = 0;
+  let seen = false;
+  for (const m of format.matchAll(PLACEHOLDER)) {
+    const literal = format.slice(last, m.index);
+    last = m.index + m[0].length;
+    if (!seen) prefix = literal;
+    else pending = out === "" ? "" : literal || pending;
+    seen = true;
+    const value = parts[m[1]]?.trim();
+    if (!value) continue;
+    out += (out === "" ? "" : pending) + value;
+    pending = "";
+  }
+  if (!seen) return format;
+  if (out === "") return "";
+  return prefix + out + format.slice(last);
+}
+export {
+  DEFAULT_DOCUMENT_TITLE_FORMAT,
+  formatDocumentTitle
+};
+//# sourceMappingURL=document-title.js.map

package/dist/lib/document-title.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/document-title.ts"],"sourcesContent":["/**\n * The window's title from its parts (0.49 KIT-9): `{page}`, `{section}` and `{app}` in a\n * format, by default \"{page} · {section} · {app}\" — \"Invoices · Finance · Kastlan\".\n *\n * A part that is missing (undefined, null, empty or blank) is dropped WITH the separator\n * before it, so \"Invoices · Kastlan\" never reads \"Invoices ·  · Kastlan\". The text between\n * two parts is the separator; text before the first part and after the last is kept as\n * written (\"[{page} – {app}]\" → \"[KS]\"). No part at all gives \"\".\n */\nexport const DEFAULT_DOCUMENT_TITLE_FORMAT = \"{page} · {section} · {app}\";\n\n/** The parts {@link formatDocumentTitle} fills in. */\nexport interface DocumentTitleParts {\n  page?: string | null;\n  section?: string | null;\n  app?: string | null;\n}\n\nconst PLACEHOLDER = /\\{(page|section|app)\\}/g;\n\nexport function formatDocumentTitle(format: string, parts: DocumentTitleParts): string {\n  let prefix = \"\";\n  let out = \"\";\n  let pending = \"\";\n  let last = 0;\n  let seen = false;\n  for (const m of format.matchAll(PLACEHOLDER)) {\n    const literal = format.slice(last, m.index!);\n    last = m.index! + m[0].length;\n    if (!seen) prefix = literal;\n    else pending = out === \"\" ? \"\" : literal || pending;\n    seen = true;\n    const value = parts[m[1] as keyof DocumentTitleParts]?.trim();\n    if (!value) continue;\n    out += (out === \"\" ? \"\" : pending) + value;\n    pending = \"\";\n  }\n  if (!seen) return format;\n  if (out === \"\") return \"\";\n  return prefix + out + format.slice(last);\n}\n"],"mappings":";AASO,MAAM,gCAAgC;AAS7C,MAAM,cAAc;AAEb,SAAS,oBAAoB,QAAgB,OAAmC;AACrF,MAAI,SAAS;AACb,MAAI,MAAM;AACV,MAAI,UAAU;AACd,MAAI,OAAO;AACX,MAAI,OAAO;AACX,aAAW,KAAK,OAAO,SAAS,WAAW,GAAG;AAC5C,UAAM,UAAU,OAAO,MAAM,MAAM,EAAE,KAAM;AAC3C,WAAO,EAAE,QAAS,EAAE,CAAC,EAAE;AACvB,QAAI,CAAC,KAAM,UAAS;AAAA,QACf,WAAU,QAAQ,KAAK,KAAK,WAAW;AAC5C,WAAO;AACP,UAAM,QAAQ,MAAM,EAAE,CAAC,CAA6B,GAAG,KAAK;AAC5D,QAAI,CAAC,MAAO;AACZ,YAAQ,QAAQ,KAAK,KAAK,WAAW;AACrC,cAAU;AAAA,EACZ;AACA,MAAI,CAAC,KAAM,QAAO;AAClB,MAAI,QAAQ,GAAI,QAAO;AACvB,SAAO,SAAS,MAAM,OAAO,MAAM,IAAI;AACzC;","names":[]}

package/dist/lib/float-clearance.js

@@ -1,12 +1,18 @@
 "use client";
 import { useEffect } from "react";
 const claims = /* @__PURE__ */ new Map();
+const NAV_OR_HOME_INDICATOR = "max(var(--app-nav-h, 0px), env(safe-area-inset-bottom, 0px))";
 function publish() {
   if (typeof document === "undefined") return;
   const root = document.documentElement;
   const values = [...claims.values()];
-  if (values.length === 0) root.style.removeProperty("--app-float-clearance");
-  else root.style.setProperty("--app-float-clearance", values.length === 1 ? values[0] : `max(${values.join(", ")})`);
+  if (values.length === 0) {
+    root.style.removeProperty("--app-float-clearance");
+    root.style.removeProperty("--kit-floating-inset");
+    return;
+  }
+  root.style.setProperty("--app-float-clearance", values.length === 1 ? values[0] : `max(${values.join(", ")})`);
+  root.style.setProperty("--kit-floating-inset", `calc(${NAV_OR_HOME_INDICATOR} + var(--app-float-clearance))`);
 }
 function claimFloatClearance(value) {
   const key = /* @__PURE__ */ Symbol("float-clearance");

package/dist/lib/float-clearance.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/float-clearance.ts"],"sourcesContent":["import { useEffect } from \"react\";\n\n/**\n * The room the floating launchers take above the bottom nav, published as\n * `--app-float-clearance` on `<html>` so `AppShell` can pad `<main>` past them.\n *\n * keksdose dev#612 (UX-1.3, \"the help button covers content\"): the shell padded `<main>`\n * for the nav plus 1.5rem, so on a phone the last row of every page ended under the help\n * launcher — and on /transactions under the action group below it, exactly where the\n * row's amount is. keksdose patched it with its own `--help-launcher-clearance` and an\n * unlayered app.css rule. Here every kit launcher (`FloatingActionButton`, so\n * `FloatingPanel`'s too, and `FloatingActionGroup`) declares its own room while it is\n * mounted and shown, and the shell takes the largest.\n *\n * Declared, not measured: a launcher knows its `offset` and its 3rem height exactly, as\n * CSS lengths, and the variable then follows the nav and the text size by itself. A\n * `hidden` launcher keeps its claim: the room is its own while it is mounted, so the page\n * does not change length as it hides and shows (keksdose's launcher steps aside while an\n * editor covers its corner). Unmount it to give the room back.\n *\n * Internal: not exported from the barrel.\n */\n\nconst claims = new Map<symbol, string>();\n\nfunction publish() {\n  if (typeof document === \"undefined\") return;\n  const root = document.documentElement;\n  const values = [...claims.values()];\n  if (values.length === 0) root.style.removeProperty(\"--app-float-clearance\");\n  else root.style.setProperty(\"--app-float-clearance\", values.length === 1 ? values[0] : `max(${values.join(\", \")})`);\n}\n\n/** Claim `value` (a CSS length: the launcher's top edge above the nav, plus a gap) until\n *  the returned function is called. */\nexport function claimFloatClearance(value: string): () => void {\n  const key = Symbol(\"float-clearance\");\n  claims.set(key, value);\n  publish();\n  return () => {\n    claims.delete(key);\n    publish();\n  };\n}\n\n/**\n * A launcher at `offset` above the nav claims its 3rem height plus a 0.5rem gap while\n * mounted (`extra`: what its frame adds, the group's 1px borders).\n */\nexport function useFloatClearance(offset: string, extra?: string): void {\n  useEffect(() => {\n    return claimFloatClearance(`calc(${offset} + 3.5rem${extra ? ` + ${extra}` : \"\"})`);\n  }, [offset, extra]);\n}\n"],"mappings":";AAAA,SAAS,iBAAiB;AAuB1B,MAAM,SAAS,oBAAI,IAAoB;AAEvC,SAAS,UAAU;AACjB,MAAI,OAAO,aAAa,YAAa;AACrC,QAAM,OAAO,SAAS;AACtB,QAAM,SAAS,CAAC,GAAG,OAAO,OAAO,CAAC;AAClC,MAAI,OAAO,WAAW,EAAG,MAAK,MAAM,eAAe,uBAAuB;AAAA,MACrE,MAAK,MAAM,YAAY,yBAAyB,OAAO,WAAW,IAAI,OAAO,CAAC,IAAI,OAAO,OAAO,KAAK,IAAI,CAAC,GAAG;AACpH;AAIO,SAAS,oBAAoB,OAA2B;AAC7D,QAAM,MAAM,uBAAO,iBAAiB;AACpC,SAAO,IAAI,KAAK,KAAK;AACrB,UAAQ;AACR,SAAO,MAAM;AACX,WAAO,OAAO,GAAG;AACjB,YAAQ;AAAA,EACV;AACF;AAMO,SAAS,kBAAkB,QAAgB,OAAsB;AACtE,YAAU,MAAM;AACd,WAAO,oBAAoB,QAAQ,MAAM,YAAY,QAAQ,MAAM,KAAK,KAAK,EAAE,GAAG;AAAA,EACpF,GAAG,CAAC,QAAQ,KAAK,CAAC;AACpB;","names":[]}
+{"version":3,"sources":["../../src/lib/float-clearance.ts"],"sourcesContent":["import { useEffect } from \"react\";\n\n/**\n * The room the floating launchers take above the bottom nav, published as\n * `--app-float-clearance` on `<html>` so `AppShell` can pad `<main>` past them, and with\n * the nav included as `--kit-floating-inset` (0.49 KIT-11, below).\n *\n * keksdose dev#612 (UX-1.3, \"the help button covers content\"): the shell padded `<main>`\n * for the nav plus 1.5rem, so on a phone the last row of every page ended under the help\n * launcher — and on /transactions under the action group below it, exactly where the\n * row's amount is. keksdose patched it with its own `--help-launcher-clearance` and an\n * unlayered app.css rule. Here every kit launcher (`FloatingActionButton`, so\n * `FloatingPanel`'s too, and `FloatingActionGroup`) declares its own room while it is\n * mounted and shown, and the shell takes the largest.\n *\n * Declared, not measured: a launcher knows its `offset` and its 3rem height exactly, as\n * CSS lengths, and the variable then follows the nav and the text size by itself. A\n * `hidden` launcher keeps its claim: the room is its own while it is mounted, so the page\n * does not change length as it hides and shows (keksdose's launcher steps aside while an\n * editor covers its corner). Unmount it to give the room back.\n *\n * Internal: not exported from the barrel.\n */\n\nconst claims = new Map<symbol, string>();\n\n/**\n * 0.49 KIT-11: `--kit-floating-inset` is the same room measured from the screen's bottom\n * edge — the phone's bottom nav (`--app-nav-h`, 0px from `md` up) or the home indicator,\n * whichever is taller, plus `--app-float-clearance` — so a page's own fixed or sticky\n * footer, or its last row, can clear the launchers with one length at every width.\n * Unset while no launcher is mounted, like `--app-float-clearance`: write\n * `var(--kit-floating-inset, var(--app-nav-h, 0px))`.\n */\nconst NAV_OR_HOME_INDICATOR = \"max(var(--app-nav-h, 0px), env(safe-area-inset-bottom, 0px))\";\n\nfunction publish() {\n  if (typeof document === \"undefined\") return;\n  const root = document.documentElement;\n  const values = [...claims.values()];\n  if (values.length === 0) {\n    root.style.removeProperty(\"--app-float-clearance\");\n    root.style.removeProperty(\"--kit-floating-inset\");\n    return;\n  }\n  root.style.setProperty(\"--app-float-clearance\", values.length === 1 ? values[0] : `max(${values.join(\", \")})`);\n  root.style.setProperty(\"--kit-floating-inset\", `calc(${NAV_OR_HOME_INDICATOR} + var(--app-float-clearance))`);\n}\n\n/** Claim `value` (a CSS length: the launcher's top edge above the nav, plus a gap) until\n *  the returned function is called. */\nexport function claimFloatClearance(value: string): () => void {\n  const key = Symbol(\"float-clearance\");\n  claims.set(key, value);\n  publish();\n  return () => {\n    claims.delete(key);\n    publish();\n  };\n}\n\n/**\n * A launcher at `offset` above the nav claims its 3rem height plus a 0.5rem gap while\n * mounted (`extra`: what its frame adds, the group's 1px borders).\n */\nexport function useFloatClearance(offset: string, extra?: string): void {\n  useEffect(() => {\n    return claimFloatClearance(`calc(${offset} + 3.5rem${extra ? ` + ${extra}` : \"\"})`);\n  }, [offset, extra]);\n}\n"],"mappings":";AAAA,SAAS,iBAAiB;AAwB1B,MAAM,SAAS,oBAAI,IAAoB;AAUvC,MAAM,wBAAwB;AAE9B,SAAS,UAAU;AACjB,MAAI,OAAO,aAAa,YAAa;AACrC,QAAM,OAAO,SAAS;AACtB,QAAM,SAAS,CAAC,GAAG,OAAO,OAAO,CAAC;AAClC,MAAI,OAAO,WAAW,GAAG;AACvB,SAAK,MAAM,eAAe,uBAAuB;AACjD,SAAK,MAAM,eAAe,sBAAsB;AAChD;AAAA,EACF;AACA,OAAK,MAAM,YAAY,yBAAyB,OAAO,WAAW,IAAI,OAAO,CAAC,IAAI,OAAO,OAAO,KAAK,IAAI,CAAC,GAAG;AAC7G,OAAK,MAAM,YAAY,wBAAwB,QAAQ,qBAAqB,gCAAgC;AAC9G;AAIO,SAAS,oBAAoB,OAA2B;AAC7D,QAAM,MAAM,uBAAO,iBAAiB;AACpC,SAAO,IAAI,KAAK,KAAK;AACrB,UAAQ;AACR,SAAO,MAAM;AACX,WAAO,OAAO,GAAG;AACjB,YAAQ;AAAA,EACV;AACF;AAMO,SAAS,kBAAkB,QAAgB,OAAsB;AACtE,YAAU,MAAM;AACd,WAAO,oBAAoB,QAAQ,MAAM,YAAY,QAAQ,MAAM,KAAK,KAAK,EAAE,GAAG;AAAA,EACpF,GAAG,CAAC,QAAQ,KAAK,CAAC;AACpB;","names":[]}

package/dist/lib/format.d.ts

@@ -1,3 +1,6 @@
+import { type MinusStyle } from "./minus.js";
+export type { MinusStyle } from "./minus.js";
+export { formatWithMinus } from "./minus.js";
 /**
  * Number, money, percentage, date and relative-time formatting — `Intl`, in one place,
  * for the figures an app prints OUTSIDE a kit component.
@@ -14,9 +17,18 @@
  * functions bound to the `<UiKitProvider locale>`, so a page formats exactly like the
  * kit components on it.
  *
- * A missing value — `null`, `undefined`, `NaN`, an unparseable date — formats as
- * `empty` (default "—", the dash `StatTile` shows for no value), never as "NaN" or
- * "Invalid Date".
+ * A missing value — `null`, `undefined`, an unparseable date — formats as `empty`
+ * (default "—", the dash `StatTile` shows for no value), never as "NaN" or "Invalid
+ * Date". A number may also arrive as a numeric STRING (0.49, KIT-2) — "1850.00", "-12.5",
+ * "0": a Decimal field off a Python API — and is formatted like the number. Anything
+ * else (a non-numeric string, an object, `NaN`, ±`Infinity`) prints `empty` too, but is
+ * a bug upstream rather than a gap in the data, so a development build says so on the
+ * console, once per call site. Zero is a figure: `0` and `"0"` print "CHF 0.00", never
+ * the dash.
+ *
+ * A negative figure carries the typographic minus, U+2212 (0.49, KIT-1), in every
+ * locale — `Intl` writes a hyphen in most. `minus: "ascii"` for text a machine reads
+ * back (a CSV, the clipboard).
  */
 /** What every formatter here prints for a missing value, unless told otherwise. */
 export declare const EMPTY_FORMATTED_VALUE = "\u2014";
@@ -41,6 +53,14 @@ export interface FormatNumberBaseOptions extends BaseOptions {
     signDisplay?: Intl.NumberFormatOptions["signDisplay"];
     /** Any further `Intl.NumberFormat` options, merged over the ones above. */
     options?: Intl.NumberFormatOptions;
+    /**
+     * The minus sign of a negative figure (0.49, KIT-1). `"typographic"` (default):
+     * U+2212, as wide as "+" and the digits, as `SignedAmount` prints it — in every
+     * locale, also where `Intl` writes a hyphen. `"ascii"`: U+002D, for an export a
+     * machine parses back (a CSV download, the clipboard) — there, also pass
+     * `options: { useGrouping: false }` or write the raw number.
+     */
+    minus?: MinusStyle;
 }
 /** The options {@link formatNumber} takes: the shared ones plus a free-text `unit`. */
 export interface FormatNumberOptions extends FormatNumberBaseOptions {
@@ -71,13 +91,20 @@ export interface FormatPercentOptions extends FormatNumberBaseOptions {
      */
     ratio?: boolean;
 }
+/**
+ * What the number formatters take (0.49, KIT-2): a number, a numeric string ("1850.00",
+ * "-12.5", "1e3" — what a Decimal arrives as in JSON), or `null` / `undefined` for no
+ * value. A string is read with `Number()`, so a figure with more significant digits than
+ * a double holds (about 15–17) is printed as its nearest double.
+ */
+export type FormattableNumber = number | string | null | undefined;
 /** A number in `locale`: "1,234.5", "1.234,5", "1’234.5" — with `unit`, "3.400 N". */
-export declare function formatNumber(value: number | null | undefined, options?: FormatNumberOptions): string;
+export declare function formatNumber(value: FormattableNumber, options?: FormatNumberOptions): string;
 /** An amount of `currency` (ISO 4217) in `locale`: "CHF 1’234.50", "1.234,50 €". */
-export declare function formatMoney(value: number | null | undefined, currency: string, options?: FormatMoneyOptions): string;
+export declare function formatMoney(value: FormattableNumber, currency: string, options?: FormatMoneyOptions): string;
 /** A percentage in `locale` ("12%", "12 %", "+1.25%"). See {@link FormatPercentOptions.ratio}
  *  for what `value` means. Default digits: at most one. */
-export declare function formatPercent(value: number | null | undefined, options?: FormatPercentOptions): string;
+export declare function formatPercent(value: FormattableNumber, options?: FormatPercentOptions): string;
 /**
  * The shapes a date is printed in, each a set of `Intl.DateTimeFormat` options:
  *  - `short` / `medium` / `long` / `full` — the date alone, at that `dateStyle`
@@ -148,9 +175,9 @@ type WithoutLocale<T> = Omit<T, "locale"> & {
 export interface KitFormat {
     /** The locale they format in — the provider's, or `undefined` (runtime default). */
     locale: string | undefined;
-    formatNumber: (value: number | null | undefined, options?: WithoutLocale<FormatNumberOptions>) => string;
-    formatMoney: (value: number | null | undefined, currency: string, options?: WithoutLocale<FormatMoneyOptions>) => string;
-    formatPercent: (value: number | null | undefined, options?: WithoutLocale<FormatPercentOptions>) => string;
+    formatNumber: (value: FormattableNumber, options?: WithoutLocale<FormatNumberOptions>) => string;
+    formatMoney: (value: FormattableNumber, currency: string, options?: WithoutLocale<FormatMoneyOptions>) => string;
+    formatPercent: (value: FormattableNumber, options?: WithoutLocale<FormatPercentOptions>) => string;
     formatDate: (value: DateInput, style?: FormatDateStyle | Intl.DateTimeFormatOptions, options?: WithoutLocale<FormatDateOptions>) => string;
     formatRelativeTime: (value: DateInput, options?: WithoutLocale<FormatRelativeTimeOptions>) => string;
 }
@@ -193,4 +220,3 @@ export interface RoundToCurrencyOptions {
  * 0.1 + 0.2 - 0.3 → 0, -0.004 → 0.
  */
 export declare function roundToCurrency(value: number, currency: string | null | undefined, digits?: number | RoundToCurrencyOptions): number;
-export {};

package/dist/lib/format.js

@@ -2,7 +2,9 @@
 import { useMemo } from "react";
 import { useKitLocale, useKitTimeZone } from "../i18n/kit-labels.js";
 import { parseIsoDate } from "./dates.js";
+import { formatWithMinus } from "./minus.js";
 import { roundHalfAway } from "./round.js";
+import { formatWithMinus as formatWithMinus2 } from "./minus.js";
 const EMPTY_FORMATTED_VALUE = "\u2014";
 const UNIT_SEPARATOR = "\u202F";
 const numberFormatters = /* @__PURE__ */ new Map();
@@ -31,31 +33,74 @@ function numberOptions(o) {
     ...o.options
   };
 }
-function isMissing(value) {
-  return value === null || value === void 0 || !Number.isFinite(value);
+const NUMERIC_STRING = /^[+-]?(?:\d+\.?\d*|\.\d+)(?:[eE][+-]?\d+)?$/;
+function devWarnings() {
+  return Boolean(import.meta.env?.DEV) && !import.meta.env?.VITEST;
+}
+const warnedSites = /* @__PURE__ */ new Set();
+const OWN_FRAME = /\b(?:formatNumber|formatMoney|formatPercent|toFormattable|warnInvalid|callSite)\b/;
+function callSite() {
+  const frames = (new Error().stack ?? "").split("\n").slice(1);
+  return frames.find((frame) => !OWN_FRAME.test(frame))?.trim() ?? "";
+}
+function describeValue(value) {
+  if (typeof value === "number" || typeof value === "bigint" || typeof value === "boolean") return String(value);
+  try {
+    return JSON.stringify(value) ?? String(value);
+  } catch {
+    return Object.prototype.toString.call(value);
+  }
+}
+function warnInvalid(fn, value) {
+  if (!devWarnings()) return;
+  const site = callSite();
+  const key = `${fn}|${site || typeof value}`;
+  if (warnedSites.has(key)) return;
+  warnedSites.add(key);
+  const type = Array.isArray(value) ? "array" : typeof value;
+  console.warn(
+    `[ui-kit] ${fn} got ${describeValue(value)} (${type}), which is not a number: printed the empty value. Pass a number, a numeric string, or null/undefined for a missing value.` + (site ? `
+  at ${site.replace(/^at /, "")}` : "")
+  );
+}
+function toFormattable(fn, value) {
+  if (value === null || value === void 0) return void 0;
+  let n;
+  if (typeof value === "number") n = value;
+  else if (typeof value === "string" && NUMERIC_STRING.test(value.trim())) n = Number(value.trim());
+  if (n === void 0 || !Number.isFinite(n)) {
+    warnInvalid(fn, value);
+    return void 0;
+  }
+  return n + 0;
 }
 function formatNumber(value, options = {}) {
-  if (isMissing(value)) return options.empty ?? EMPTY_FORMATTED_VALUE;
-  const figure = numberFormatter(options.locale, numberOptions(options)).format(value);
+  const n = toFormattable("formatNumber", value);
+  if (n === void 0) return options.empty ?? EMPTY_FORMATTED_VALUE;
+  const figure = formatWithMinus(numberFormatter(options.locale, numberOptions(options)), n, options.minus);
   return options.unit ? `${figure}${UNIT_SEPARATOR}${options.unit}` : figure;
 }
 function formatMoney(value, currency, options = {}) {
-  if (isMissing(value)) return options.empty ?? EMPTY_FORMATTED_VALUE;
-  return numberFormatter(options.locale, {
+  const n = toFormattable("formatMoney", value);
+  if (n === void 0) return options.empty ?? EMPTY_FORMATTED_VALUE;
+  const formatter = numberFormatter(options.locale, {
     style: "currency",
     currency,
     ...options.currencyDisplay ? { currencyDisplay: options.currencyDisplay } : null,
     ...numberOptions(options)
-  }).format(value);
+  });
+  return formatWithMinus(formatter, n, options.minus);
 }
 function formatPercent(value, options = {}) {
-  if (isMissing(value)) return options.empty ?? EMPTY_FORMATTED_VALUE;
-  const ratio = options.ratio === false ? value / 100 : value;
-  return numberFormatter(options.locale, {
+  const n = toFormattable("formatPercent", value);
+  if (n === void 0) return options.empty ?? EMPTY_FORMATTED_VALUE;
+  const ratio = options.ratio === false ? n / 100 : n;
+  const formatter = numberFormatter(options.locale, {
     style: "percent",
     ...options.digits === void 0 ? { maximumFractionDigits: 1 } : null,
     ...numberOptions(options)
-  }).format(ratio);
+  });
+  return formatWithMinus(formatter, ratio, options.minus);
 }
 const DATE_STYLES = {
   short: { dateStyle: "short" },
@@ -167,6 +212,7 @@ export {
   formatNumber,
   formatPercent,
   formatRelativeTime,
+  formatWithMinus2 as formatWithMinus,
   roundToCurrency,
   toDate,
   useKitFormat

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 { roundHalfAway } from \"./round\";\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`, `NaN`, an unparseable date — formats as\n * `empty` (default \"—\", the dash `StatTile` shows for no value), never as \"NaN\" or\n * \"Invalid Date\".\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\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\nfunction isMissing(value: number | null | undefined): value is null | undefined {\n  // ±Infinity too (lenkbank, adopting 0.13): a division by zero upstream is a missing\n  // figure, and \"∞\" printed in a money or measurement column reads like data.\n  return value === null || value === undefined || !Number.isFinite(value);\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: number | null | undefined, options: FormatNumberOptions = {}): string {\n  if (isMissing(value)) return options.empty ?? EMPTY_FORMATTED_VALUE;\n  const figure = numberFormatter(options.locale, numberOptions(options)).format(value);\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(\n  value: number | null | undefined,\n  currency: string,\n  options: FormatMoneyOptions = {},\n): string {\n  if (isMissing(value)) return options.empty ?? EMPTY_FORMATTED_VALUE;\n  return numberFormatter(options.locale, {\n    style: \"currency\",\n    currency,\n    ...(options.currencyDisplay ? { currencyDisplay: options.currencyDisplay } : null),\n    ...numberOptions(options),\n  }).format(value);\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: number | null | undefined, options: FormatPercentOptions = {}): string {\n  if (isMissing(value)) return options.empty ?? EMPTY_FORMATTED_VALUE;\n  const ratio = options.ratio === false ? value / 100 : value;\n  return numberFormatter(options.locale, {\n    style: \"percent\",\n    ...(options.digits === undefined ? { maximumFractionDigits: 1 } : null),\n    ...numberOptions(options),\n  }).format(ratio);\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). Left out: the\n   *  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\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.\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  // 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: number | null | undefined, options?: WithoutLocale<FormatNumberOptions>) => string;\n  formatMoney: (\n    value: number | null | undefined,\n    currency: string,\n    options?: WithoutLocale<FormatMoneyOptions>,\n  ) => string;\n  formatPercent: (value: number | null | undefined, 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":[]}
+{"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). Left out: the\n   *  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\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.\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  // 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/minus.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The one minus sign (0.49, KIT-1). `Intl.NumberFormat` writes a negative with the
+ * HYPHEN-MINUS (U+002D) in nearly every locale — en, de-CH, fr, it, es, hu, zh — and
+ * with the typographic MINUS SIGN (U+2212) in a few (sv, fi). The kit prints U+2212
+ * everywhere, as `SignedAmount` always has: it is as wide as "+" and the tabular
+ * digits, so a column of signed figures lines up, and it does not break a line the way
+ * a hyphen may.
+ *
+ * `"ascii"` is the other way round, for text a machine reads back — a CSV, the
+ * clipboard: every minus becomes U+002D, whatever the locale wrote, so `Number()` and a
+ * spreadsheet parse it.
+ */
+export type MinusStyle = "typographic" | "ascii";
+/** U+2212 MINUS SIGN. */
+export declare const TYPOGRAPHIC_MINUS = "\u2212";
+/**
+ * `formatter.format(value)` with every minus sign in `minus` style. Only the parts
+ * `Intl` marks as a minus are touched — a hyphen inside a currency's name
+ * ("Bosnia-Herzegovina convertible marks") stays — and only when the text holds the
+ * other sign at all, so a positive figure costs no `formatToParts`.
+ *
+ * Public since 0.50 (the KIT-1 follow-up): an app that keeps its OWN `Intl.NumberFormat`
+ * wrapper (a currency with app-specific digits, a quantity) calls it in place of
+ * `formatter.format(value)`, so its negatives match the kit's "−". Where the wrapper only
+ * re-states `formatMoney` / `formatNumber`, route it through those instead.
+ *
+ * @example
+ *   const eur = new Intl.NumberFormat("en", { style: "currency", currency: "EUR" });
+ *   formatWithMinus(eur, -150);          // "−€150.00"
+ *   formatWithMinus(eur, -150, "ascii"); // "-€150.00", for a CSV
+ */
+export declare function formatWithMinus(formatter: Intl.NumberFormat, value: number, minus?: MinusStyle): string;

package/dist/lib/minus.js

@@ -0,0 +1,14 @@
+"use client";
+const TYPOGRAPHIC_MINUS = "\u2212";
+const MINUS_PARTS = /* @__PURE__ */ new Set(["minusSign", "exponentMinusSign"]);
+function formatWithMinus(formatter, value, minus = "typographic") {
+  const text = formatter.format(value);
+  const [wanted, other] = minus === "ascii" ? ["-", TYPOGRAPHIC_MINUS] : [TYPOGRAPHIC_MINUS, "-"];
+  if (!text.includes(other)) return text;
+  return formatter.formatToParts(value).map((part) => MINUS_PARTS.has(part.type) ? wanted : part.value).join("");
+}
+export {
+  TYPOGRAPHIC_MINUS,
+  formatWithMinus
+};
+//# sourceMappingURL=minus.js.map

package/dist/lib/minus.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/minus.ts"],"sourcesContent":["/**\n * The one minus sign (0.49, KIT-1). `Intl.NumberFormat` writes a negative with the\n * HYPHEN-MINUS (U+002D) in nearly every locale — en, de-CH, fr, it, es, hu, zh — and\n * with the typographic MINUS SIGN (U+2212) in a few (sv, fi). The kit prints U+2212\n * everywhere, as `SignedAmount` always has: it is as wide as \"+\" and the tabular\n * digits, so a column of signed figures lines up, and it does not break a line the way\n * a hyphen may.\n *\n * `\"ascii\"` is the other way round, for text a machine reads back — a CSV, the\n * clipboard: every minus becomes U+002D, whatever the locale wrote, so `Number()` and a\n * spreadsheet parse it.\n */\nexport type MinusStyle = \"typographic\" | \"ascii\";\n\n/** U+2212 MINUS SIGN. */\nexport const TYPOGRAPHIC_MINUS = \"\\u2212\";\n\n/** The parts `formatToParts` writes a minus in (the exponent's, under `notation:\n *  \"scientific\"`, too). */\nconst MINUS_PARTS: ReadonlySet<string> = new Set([\"minusSign\", \"exponentMinusSign\"]);\n\n/**\n * `formatter.format(value)` with every minus sign in `minus` style. Only the parts\n * `Intl` marks as a minus are touched — a hyphen inside a currency's name\n * (\"Bosnia-Herzegovina convertible marks\") stays — and only when the text holds the\n * other sign at all, so a positive figure costs no `formatToParts`.\n *\n * Public since 0.50 (the KIT-1 follow-up): an app that keeps its OWN `Intl.NumberFormat`\n * wrapper (a currency with app-specific digits, a quantity) calls it in place of\n * `formatter.format(value)`, so its negatives match the kit's \"−\". Where the wrapper only\n * re-states `formatMoney` / `formatNumber`, route it through those instead.\n *\n * @example\n *   const eur = new Intl.NumberFormat(\"en\", { style: \"currency\", currency: \"EUR\" });\n *   formatWithMinus(eur, -150);          // \"−€150.00\"\n *   formatWithMinus(eur, -150, \"ascii\"); // \"-€150.00\", for a CSV\n */\nexport function formatWithMinus(\n  formatter: Intl.NumberFormat,\n  value: number,\n  minus: MinusStyle = \"typographic\",\n): string {\n  const text = formatter.format(value);\n  const [wanted, other] = minus === \"ascii\" ? [\"-\", TYPOGRAPHIC_MINUS] : [TYPOGRAPHIC_MINUS, \"-\"];\n  if (!text.includes(other)) return text;\n  return formatter\n    .formatToParts(value)\n    .map((part) => (MINUS_PARTS.has(part.type) ? wanted : part.value))\n    .join(\"\");\n}\n"],"mappings":";AAeO,MAAM,oBAAoB;AAIjC,MAAM,cAAmC,oBAAI,IAAI,CAAC,aAAa,mBAAmB,CAAC;AAkB5E,SAAS,gBACd,WACA,OACA,QAAoB,eACZ;AACR,QAAM,OAAO,UAAU,OAAO,KAAK;AACnC,QAAM,CAAC,QAAQ,KAAK,IAAI,UAAU,UAAU,CAAC,KAAK,iBAAiB,IAAI,CAAC,mBAAmB,GAAG;AAC9F,MAAI,CAAC,KAAK,SAAS,KAAK,EAAG,QAAO;AAClC,SAAO,UACJ,cAAc,KAAK,EACnB,IAAI,CAAC,SAAU,YAAY,IAAI,KAAK,IAAI,IAAI,SAAS,KAAK,KAAM,EAChE,KAAK,EAAE;AACZ;","names":[]}

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

@@ -0,0 +1,30 @@
+/**
+ * What a status means, in five domain-free words, and the tone that says it (0.49 KIT-8).
+ *
+ * Every app paints its statuses by hand: kastlan's ~15 enums each carry a Chip tone
+ * (`shared/enums/enum-meta.ts`), keksdose's job and transaction states theirs, and the
+ * same meaning drifted into different colours — "unpaid" amber in one table, brand in
+ * the next. The kind is the decision ("does the reader have to act?"), the tone only
+ * its colour, so an app maps each of its states to a kind once and the colours agree
+ * everywhere:
+ *
+ * | kind | tone | for |
+ * |---|---|---|
+ * | `good` | `success` | done, settled, healthy: nothing to do (Paid, Verified) |
+ * | `attention` | `warning` | needs a look or an action soon, nothing broken yet (Unpaid, Due soon) |
+ * | `problem` | `danger` | something is wrong or late and needs action now (Overdue, Failed) |
+ * | `active` | `info` | in progress or current, neither good nor bad (Running, Sent) |
+ * | `inactive` | `neutral` | over, paused or not started: out of the way (Draft, Archived) |
+ *
+ * `brand` is not a status tone: it is the app's own colour, and a status in it reads as
+ * "this is the app" rather than as a state. Money (`income` / `expense`) is not one
+ * either: it says which way an amount flows, not how a record stands.
+ */
+export type StatusKind = "good" | "attention" | "problem" | "active" | "inactive";
+/** The tones a {@link StatusKind} maps to — a subset of `ChipTone` and `StatusDotTone`. */
+export type StatusTone = "success" | "warning" | "danger" | "info" | "neutral";
+/** The five kinds, in the order the table above lists them. */
+export declare const STATUS_KINDS: readonly StatusKind[];
+/** The tone for a status kind: good → success, attention → warning, problem → danger,
+ *  active → info, inactive → neutral. See {@link StatusKind}. */
+export declare function statusTone(kind: StatusKind): StatusTone;

package/dist/lib/status-tone.js

@@ -0,0 +1,17 @@
+"use client";
+const STATUS_KINDS = ["good", "attention", "problem", "active", "inactive"];
+const TONES = {
+  good: "success",
+  attention: "warning",
+  problem: "danger",
+  active: "info",
+  inactive: "neutral"
+};
+function statusTone(kind) {
+  return TONES[kind];
+}
+export {
+  STATUS_KINDS,
+  statusTone
+};
+//# sourceMappingURL=status-tone.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/status-tone.ts"],"sourcesContent":["/**\n * What a status means, in five domain-free words, and the tone that says it (0.49 KIT-8).\n *\n * Every app paints its statuses by hand: kastlan's ~15 enums each carry a Chip tone\n * (`shared/enums/enum-meta.ts`), keksdose's job and transaction states theirs, and the\n * same meaning drifted into different colours — \"unpaid\" amber in one table, brand in\n * the next. The kind is the decision (\"does the reader have to act?\"), the tone only\n * its colour, so an app maps each of its states to a kind once and the colours agree\n * everywhere:\n *\n * | kind | tone | for |\n * |---|---|---|\n * | `good` | `success` | done, settled, healthy: nothing to do (Paid, Verified) |\n * | `attention` | `warning` | needs a look or an action soon, nothing broken yet (Unpaid, Due soon) |\n * | `problem` | `danger` | something is wrong or late and needs action now (Overdue, Failed) |\n * | `active` | `info` | in progress or current, neither good nor bad (Running, Sent) |\n * | `inactive` | `neutral` | over, paused or not started: out of the way (Draft, Archived) |\n *\n * `brand` is not a status tone: it is the app's own colour, and a status in it reads as\n * \"this is the app\" rather than as a state. Money (`income` / `expense`) is not one\n * either: it says which way an amount flows, not how a record stands.\n */\nexport type StatusKind = \"good\" | \"attention\" | \"problem\" | \"active\" | \"inactive\";\n\n/** The tones a {@link StatusKind} maps to — a subset of `ChipTone` and `StatusDotTone`. */\nexport type StatusTone = \"success\" | \"warning\" | \"danger\" | \"info\" | \"neutral\";\n\n/** The five kinds, in the order the table above lists them. */\nexport const STATUS_KINDS: readonly StatusKind[] = [\"good\", \"attention\", \"problem\", \"active\", \"inactive\"];\n\nconst TONES: Readonly<Record<StatusKind, StatusTone>> = {\n  good: \"success\",\n  attention: \"warning\",\n  problem: \"danger\",\n  active: \"info\",\n  inactive: \"neutral\",\n};\n\n/** The tone for a status kind: good → success, attention → warning, problem → danger,\n *  active → info, inactive → neutral. See {@link StatusKind}. */\nexport function statusTone(kind: StatusKind): StatusTone {\n  return TONES[kind];\n}\n"],"mappings":";AA4BO,MAAM,eAAsC,CAAC,QAAQ,aAAa,WAAW,UAAU,UAAU;AAExG,MAAM,QAAkD;AAAA,EACtD,MAAM;AAAA,EACN,WAAW;AAAA,EACX,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,UAAU;AACZ;AAIO,SAAS,WAAW,MAA8B;AACvD,SAAO,MAAM,IAAI;AACnB;","names":[]}

package/dist/settings/settings-layout.js

@@ -160,6 +160,7 @@ function SettingsLayout({
         PageHeader,
         {
           size: "compact",
+          documentTitle: false,
           title: open.title,
           description: open.help,
           breadcrumbs: /* @__PURE__ */ jsxs(
@@ -183,7 +184,7 @@ function SettingsLayout({
       ),
       cards(open.id)
     ] }) : /* @__PURE__ */ jsxs("div", { className: pageClass, "data-settings-view": "list", children: [
-      /* @__PURE__ */ jsx(PageHeader, { size: "compact", title: pageTitle }),
+      /* @__PURE__ */ jsx(PageHeader, { size: "compact", documentTitle: false, title: pageTitle }),
       searchField,
       searching ? results : /* @__PURE__ */ jsx(Card, { className: "p-1", children: /* @__PURE__ */ jsx(List, { separator: "divider", density: "comfortable", "aria-label": labels.sections, children: route.groups.map((g) => /* @__PURE__ */ jsx(
         ListItem,
@@ -219,7 +220,7 @@ function SettingsLayout({
       /* @__PURE__ */ jsx("div", { "data-slot": "settings-sidebar-footer", children: sidebarFooter })
     ] });
     body = /* @__PURE__ */ jsxs("div", { className: pageClass, "data-settings-view": "desktop", children: [
-      /* @__PURE__ */ jsx(PageHeader, { size: "compact", title: pageTitle }),
+      /* @__PURE__ */ jsx(PageHeader, { size: "compact", documentTitle: false, title: pageTitle }),
       searchField,
       /* @__PURE__ */ jsxs("div", { className: "md:grid md:grid-cols-[14rem_minmax(0,1fr)] md:gap-6", children: [
         withSidebarFooter(