@eifi1/ui-kit 0.10.0 → 0.12.0

package/dist/lib/clipping.d.ts

@@ -1,9 +1,25 @@
-/** Internal (not exported from the package): the Tooltip's auto-portal check. */
+/** Internal (not exported from the package): the Tooltip's auto-portal check. The
+ *  attribute name itself IS exported, as `CLIPS_ATTRIBUTE` from the tooltip module. */
+/**
+ * The explicit "this element clips or scrolls" marker. A container carrying it counts
+ * as clipping whatever its computed `overflow` says.
+ *
+ * Why a marker as well as the computed style: the kit's containers get their
+ * `overflow` from Tailwind classes, and jsdom computes no stylesheet — so under test
+ * every scroller reads `overflow: visible`, the Tooltip stays in place, and its always-
+ * mounted bubble shows up in the cell's text (keksdose 0.10: "CheckingChecking"). The
+ * browser and the test then disagreed about where the bubble lives, and apps pinned
+ * `portal` on every tooltip in a table to make them agree. The kit's own scrollers
+ * (DataTable's body, Table's wrapper) carry the marker, so the answer is the same in
+ * both; an app marks its own with `{ [CLIPS_ATTRIBUTE]: "" }` or a literal `data-clips`.
+ */
+declare const CLIPS_ATTRIBUTE = "data-clips";
 /** Whether anything between `el` and `<body>` clips or scrolls its content — the
  *  containers an absolutely positioned bubble would be cut off by, or would widen.
- *  `<body>` and `<html>` are not counted: their `overflow` belongs to the viewport (a
- *  dialog's scroll lock sets it), and the viewport clips a portalled bubble just the
- *  same. */
+ *  Either the computed `overflow` says so or the element carries
+ *  {@link CLIPS_ATTRIBUTE}. `<body>` and `<html>` are not counted: their `overflow`
+ *  belongs to the viewport (a dialog's scroll lock sets it), and the viewport clips a
+ *  portalled bubble just the same. */
 declare function hasClippingAncestor(el: Element | null): boolean;
 
-export { hasClippingAncestor };
+export { CLIPS_ATTRIBUTE, hasClippingAncestor };

package/dist/lib/clipping.js

@@ -1,14 +1,17 @@
 "use client";
+const CLIPS_ATTRIBUTE = "data-clips";
 function hasClippingAncestor(el) {
   if (typeof window === "undefined" || !el) return false;
   for (let node = el.parentElement; node; node = node.parentElement) {
     if (node === document.body || node === document.documentElement) return false;
+    if (node.hasAttribute(CLIPS_ATTRIBUTE)) return true;
     const style = window.getComputedStyle(node);
     if (style.overflowX !== "visible" || style.overflowY !== "visible") return true;
   }
   return false;
 }
 export {
+  CLIPS_ATTRIBUTE,
   hasClippingAncestor
 };
 //# sourceMappingURL=clipping.js.map

package/dist/lib/clipping.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/clipping.ts"],"sourcesContent":["/** Internal (not exported from the package): the Tooltip's auto-portal check. */\n\n/** Whether anything between `el` and `<body>` clips or scrolls its content — the\n *  containers an absolutely positioned bubble would be cut off by, or would widen.\n *  `<body>` and `<html>` are not counted: their `overflow` belongs to the viewport (a\n *  dialog's scroll lock sets it), and the viewport clips a portalled bubble just the\n *  same. */\nexport function hasClippingAncestor(el: Element | null): boolean {\n  if (typeof window === \"undefined\" || !el) return false;\n  for (let node = el.parentElement; node; node = node.parentElement) {\n    if (node === document.body || node === document.documentElement) return false;\n    const style = window.getComputedStyle(node);\n    if (style.overflowX !== \"visible\" || style.overflowY !== \"visible\") return true;\n  }\n  return false;\n}\n"],"mappings":";AAOO,SAAS,oBAAoB,IAA6B;AAC/D,MAAI,OAAO,WAAW,eAAe,CAAC,GAAI,QAAO;AACjD,WAAS,OAAO,GAAG,eAAe,MAAM,OAAO,KAAK,eAAe;AACjE,QAAI,SAAS,SAAS,QAAQ,SAAS,SAAS,gBAAiB,QAAO;AACxE,UAAM,QAAQ,OAAO,iBAAiB,IAAI;AAC1C,QAAI,MAAM,cAAc,aAAa,MAAM,cAAc,UAAW,QAAO;AAAA,EAC7E;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/lib/clipping.ts"],"sourcesContent":["/** Internal (not exported from the package): the Tooltip's auto-portal check. The\n *  attribute name itself IS exported, as `CLIPS_ATTRIBUTE` from the tooltip module. */\n\n/**\n * The explicit \"this element clips or scrolls\" marker. A container carrying it counts\n * as clipping whatever its computed `overflow` says.\n *\n * Why a marker as well as the computed style: the kit's containers get their\n * `overflow` from Tailwind classes, and jsdom computes no stylesheet — so under test\n * every scroller reads `overflow: visible`, the Tooltip stays in place, and its always-\n * mounted bubble shows up in the cell's text (keksdose 0.10: \"CheckingChecking\"). The\n * browser and the test then disagreed about where the bubble lives, and apps pinned\n * `portal` on every tooltip in a table to make them agree. The kit's own scrollers\n * (DataTable's body, Table's wrapper) carry the marker, so the answer is the same in\n * both; an app marks its own with `{ [CLIPS_ATTRIBUTE]: \"\" }` or a literal `data-clips`.\n */\nexport const CLIPS_ATTRIBUTE = \"data-clips\";\n\n/** Whether anything between `el` and `<body>` clips or scrolls its content — the\n *  containers an absolutely positioned bubble would be cut off by, or would widen.\n *  Either the computed `overflow` says so or the element carries\n *  {@link CLIPS_ATTRIBUTE}. `<body>` and `<html>` are not counted: their `overflow`\n *  belongs to the viewport (a dialog's scroll lock sets it), and the viewport clips a\n *  portalled bubble just the same. */\nexport function hasClippingAncestor(el: Element | null): boolean {\n  if (typeof window === \"undefined\" || !el) return false;\n  for (let node = el.parentElement; node; node = node.parentElement) {\n    if (node === document.body || node === document.documentElement) return false;\n    if (node.hasAttribute(CLIPS_ATTRIBUTE)) return true;\n    const style = window.getComputedStyle(node);\n    if (style.overflowX !== \"visible\" || style.overflowY !== \"visible\") return true;\n  }\n  return false;\n}\n"],"mappings":";AAgBO,MAAM,kBAAkB;AAQxB,SAAS,oBAAoB,IAA6B;AAC/D,MAAI,OAAO,WAAW,eAAe,CAAC,GAAI,QAAO;AACjD,WAAS,OAAO,GAAG,eAAe,MAAM,OAAO,KAAK,eAAe;AACjE,QAAI,SAAS,SAAS,QAAQ,SAAS,SAAS,gBAAiB,QAAO;AACxE,QAAI,KAAK,aAAa,eAAe,EAAG,QAAO;AAC/C,UAAM,QAAQ,OAAO,iBAAiB,IAAI;AAC1C,QAAI,MAAM,cAAc,aAAa,MAAM,cAAc,UAAW,QAAO;AAAA,EAC7E;AACA,SAAO;AACT;","names":[]}

package/dist/lib/dates.d.ts

@@ -67,6 +67,22 @@ declare function formatIsoDate(iso: string, locale: string, options?: Intl.DateT
  *  {@link toLocalIso} reads local components back, so this never slides a day the way
  *  a `toISOString()` round-trip does west of UTC. */
 declare function addDaysIso(iso: string, days: number): string;
+/**
+ * `d` moved by whole months, keeping the day of the month where the target has one.
+ * `setMonth` alone ROLLS OVER — 31 January + 1 month is 3 March — which would skip
+ * February entirely for anyone paging through the year with PageDown. Returns a new
+ * Date; `d` is not touched.
+ */
+declare function addMonthsClamped(d: Date, months: number): Date;
+/**
+ * The first day of the week in `locale`, as a `Date#getDay` index (0 = Sunday).
+ *
+ * `Intl.Locale#getWeekInfo()` is the standard spelling; V8 shipped it first as the
+ * `weekInfo` accessor, and Firefox has neither yet — hence both reads and a Monday
+ * fallback, which is ISO 8601. Its `firstDay` counts 1 = Monday … 7 = Sunday, so `% 7`
+ * maps it onto `getDay`. `undefined` asks for the runtime's default locale.
+ */
+declare function localeWeekStart(locale: string | undefined): 0 | 1 | 2 | 3 | 4 | 5 | 6;
 /** Whether two Dates fall on the same local calendar day. */
 declare function sameYmd(a: Date, b: Date): boolean;
 interface DateRangePreset {
@@ -117,4 +133,4 @@ interface CalendarMonthPresetOptions {
  */
 declare function calendarMonthPresets(options?: CalendarMonthPresetOptions): DateRangePreset[];
 
-export { type CalendarMonthPresetOptions, type DateRangePreset, addDaysIso, calendarMonthPresets, dateRangePresets, endOfMonthIso, endOfYearIso, formatIsoDate, lastFullMonthsRange, lastFullYearsRange, monthKey, pad, parseIsoDate, sameYmd, shiftIso, startOfMonthIso, startOfWeekIso, startOfYearIso, toLocalIso, todayIso };
+export { type CalendarMonthPresetOptions, type DateRangePreset, addDaysIso, addMonthsClamped, calendarMonthPresets, dateRangePresets, endOfMonthIso, endOfYearIso, formatIsoDate, lastFullMonthsRange, lastFullYearsRange, localeWeekStart, monthKey, pad, parseIsoDate, sameYmd, shiftIso, startOfMonthIso, startOfWeekIso, startOfYearIso, toLocalIso, todayIso };

package/dist/lib/dates.js

@@ -70,6 +70,23 @@ function addDaysIso(iso, days) {
   d.setDate(d.getDate() + days);
   return toLocalIso(d);
 }
+function addMonthsClamped(d, months) {
+  const day = d.getDate();
+  const out = new Date(d.getFullYear(), d.getMonth() + months, 1);
+  const lastOfTarget = new Date(out.getFullYear(), out.getMonth() + 1, 0).getDate();
+  out.setDate(Math.min(day, lastOfTarget));
+  return out;
+}
+function localeWeekStart(locale) {
+  try {
+    const tag = locale ?? new Intl.DateTimeFormat().resolvedOptions().locale;
+    const loc = new Intl.Locale(tag);
+    const firstDay = (loc.getWeekInfo?.() ?? loc.weekInfo)?.firstDay;
+    if (typeof firstDay === "number") return firstDay % 7;
+  } catch {
+  }
+  return 1;
+}
 function sameYmd(a, b) {
   return a.getFullYear() === b.getFullYear() && a.getMonth() === b.getMonth() && a.getDate() === b.getDate();
 }
@@ -107,6 +124,7 @@ function calendarMonthPresets(options = {}) {
 }
 export {
   addDaysIso,
+  addMonthsClamped,
   calendarMonthPresets,
   dateRangePresets,
   endOfMonthIso,
@@ -114,6 +132,7 @@ export {
   formatIsoDate,
   lastFullMonthsRange,
   lastFullYearsRange,
+  localeWeekStart,
   monthKey,
   pad,
   parseIsoDate,

package/dist/lib/dates.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/dates.ts"],"sourcesContent":["/**\n * ISO date helpers, collected from copies that were scattered across the pages.\n *\n * **Every \"what day is it\" helper here reads the LOCAL calendar** — one family, not\n * two. It used to be two: these all built a local Date and then read it back through\n * `toISOString()`, which is UTC, so east of Greenwich they all returned YESTERDAY\n * between local midnight and the UTC rollover. The old module note called that\n * deliberate and warned against changing it. It was not defensible, and dev#471 is\n * what it cost:\n *\n * > *\"Just entered a tx now from scheduled. But it still shows as upcoming. Is there\n * > a problem with timezones? It is currently 1 o clock middle european summer time.\"*\n *\n * There was: at 01:00 CEST `todayIso()` answered with the 14th, the row the scheduler\n * had just booked was dated the 15th, and `isUpcoming` compares the two strings — so a\n * transaction entered a second ago read as one still to come. The same slip moved\n * `startOfMonthIso()` onto the last day of the PREVIOUS month for an hour every first\n * of the month, which is a report range nobody would have questioned.\n *\n * A calendar day only means anything to the human reading it, and every caller here —\n * the register's today, the date-range presets, the budget cursor, a new\n * transaction's default date — is asking that question. There is no caller for whom\n * \"the UTC day\" is the right answer; the server compares plain dates with no zone at\n * all, so sending it the user's local day is also what it wants.\n */\n\n/** Zero-pad a number to two digits (\"3\" -> \"03\"). */\nexport function pad(n: number): string {\n  return String(n).padStart(2, \"0\");\n}\n\n/** Today as \"YYYY-MM-DD\" on the LOCAL calendar (see the module note). */\nexport function todayIso(): string {\n  return toLocalIso(new Date());\n}\n\n/** A Date as a local-time \"YYYY-MM-DD\" string. */\nexport function toLocalIso(d: Date): string {\n  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;\n}\n\n/** A Date as a local-time \"YYYY-MM\" month key. */\nexport function monthKey(d: Date): string {\n  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}`;\n}\n\n// ---------- Date-range presets + calendar helpers ----------\n// Local-calendar like todayIso (see the module note); used by the data-table date\n// filter and its MiniCalendar. Each one mutates a local Date and must therefore READ\n// it back locally — going out through toISOString() is what shifted every one of\n// these by a day near midnight (dev#471).\n\n/** Today shifted by `days`, as \"YYYY-MM-DD\". */\nexport function shiftIso(days: number): string {\n  const d = new Date();\n  d.setDate(d.getDate() + days);\n  return toLocalIso(d);\n}\n\n/** First day (Monday) of the current week, as \"YYYY-MM-DD\". */\nexport function startOfWeekIso(): string {\n  const d = new Date();\n  const day = d.getDay();\n  const diff = (day + 6) % 7; // monday = 0\n  d.setDate(d.getDate() - diff);\n  return toLocalIso(d);\n}\n\n/** First day of the month `offsetMonths` from now, as \"YYYY-MM-DD\". */\nexport function startOfMonthIso(offsetMonths = 0): string {\n  const d = new Date();\n  d.setDate(1);\n  d.setMonth(d.getMonth() + offsetMonths);\n  return toLocalIso(d);\n}\n\n/** Last day of the month `offsetMonths` from now, as \"YYYY-MM-DD\". */\nexport function endOfMonthIso(offsetMonths = 0): string {\n  const d = new Date();\n  d.setDate(1);\n  d.setMonth(d.getMonth() + offsetMonths + 1);\n  d.setDate(0);\n  return toLocalIso(d);\n}\n\n/** First day of the year `offsetYears` from now, as \"YYYY-MM-DD\". */\nexport function startOfYearIso(offsetYears = 0): string {\n  const d = new Date();\n  d.setMonth(0);\n  d.setDate(1);\n  d.setFullYear(d.getFullYear() + offsetYears);\n  return toLocalIso(d);\n}\n\n/** Last day of the year `offsetYears` from now, as \"YYYY-MM-DD\". */\nexport function endOfYearIso(offsetYears = 0): string {\n  const d = new Date();\n  d.setMonth(11);\n  d.setDate(31);\n  d.setFullYear(d.getFullYear() + offsetYears);\n  return toLocalIso(d);\n}\n\n/** Parse a \"YYYY-MM-DD\" string to a local-midnight Date, or null if malformed —\n *  where \"malformed\" includes a date that does not exist.\n *\n *  The falsy check alone was not enough. `new Date(y, m - 1, d)` ROLLS OVER out-of-range\n *  components rather than refusing them, so \"2026-13-45\" came back as 2027-02-14 and\n *  \"2026-02-30\" as 2026-03-02: a valid-looking Date for a day that never happened. No\n *  caller could tell — {@link formatIsoDate} blanks only on `null`, so the invented\n *  date formatted and displayed exactly like a real one.\n *\n *  The round-trip is the check: build the Date, then read the components back off it.\n *  A value that rolled over cannot answer with the numbers it was given. That is the\n *  same shape {@link sameYmd} already expresses, applied to a Date and its source. */\nexport function parseIsoDate(s: string): Date | null {\n  if (!s) return null;\n  const [y, m, d] = s.split(\"-\").map(Number);\n  if (!y || !m || !d) return null;\n  if (!Number.isInteger(y) || !Number.isInteger(m) || !Number.isInteger(d)) return null;\n  const dt = new Date(y, m - 1, d);\n  if (Number.isNaN(dt.getTime())) return null;\n  if (dt.getFullYear() !== y || dt.getMonth() !== m - 1 || dt.getDate() !== d) return null;\n  return dt;\n}\n\n/** Format a \"YYYY-MM-DD\" string for display in `locale` (empty string when\n *  unparseable). Defaults to the locale's short numeric date; pass `options` to\n *  override (e.g. `{ dateStyle: \"medium\" }`). */\nexport function formatIsoDate(\n  iso: string,\n  locale: string,\n  options?: Intl.DateTimeFormatOptions,\n): string {\n  const d = parseIsoDate(iso);\n  return d ? d.toLocaleDateString(locale, options) : \"\";\n}\n\n/** A \"YYYY-MM-DD\" string shifted by `days` (negative shifts back), or the input\n *  unchanged when it isn't a parseable date.\n *\n *  Local-time throughout — {@link parseIsoDate} builds a local-midnight Date and\n *  {@link toLocalIso} reads local components back, so this never slides a day the way\n *  a `toISOString()` round-trip does west of UTC. */\nexport function addDaysIso(iso: string, days: number): string {\n  const d = parseIsoDate(iso);\n  if (!d) return iso;\n  d.setDate(d.getDate() + days);\n  return toLocalIso(d);\n}\n\n/** Whether two Dates fall on the same local calendar day. */\nexport function sameYmd(a: Date, b: Date): boolean {\n  return (\n    a.getFullYear() === b.getFullYear() &&\n    a.getMonth() === b.getMonth() &&\n    a.getDate() === b.getDate()\n  );\n}\n\nexport interface DateRangePreset {\n  key: string;\n  from: string;\n  to: string;\n}\n\n/**\n * The named ranges offered by the data-table date filter (local-calendar, like\n * {@link todayIso} — see the module note). `key` maps to the consumer's\n * `table.preset_*` labels.\n */\nexport function dateRangePresets(): DateRangePreset[] {\n  const mondayOffset = (new Date().getDay() + 6) % 7; // monday = 0\n  return [\n    { key: \"today\", from: todayIso(), to: todayIso() },\n    { key: \"yesterday\", from: shiftIso(-1), to: shiftIso(-1) },\n    { key: \"this_week\", from: startOfWeekIso(), to: todayIso() },\n    { key: \"last_week\", from: shiftIso(-7 - mondayOffset), to: shiftIso(-1 - mondayOffset) },\n    { key: \"last_7_days\", from: shiftIso(-6), to: todayIso() },\n    { key: \"last_30_days\", from: shiftIso(-29), to: todayIso() },\n    { key: \"this_month\", from: startOfMonthIso(0), to: todayIso() },\n    { key: \"last_month\", from: startOfMonthIso(-1), to: endOfMonthIso(-1) },\n    { key: \"last_3_months\", from: shiftIso(-90), to: todayIso() },\n    { key: \"ytd\", from: startOfYearIso(0), to: todayIso() },\n    { key: \"last_year\", from: startOfYearIso(-1), to: endOfYearIso(-1) },\n  ];\n}\n\n/** The last `n` WHOLE calendar months before the current one, as an inclusive\n *  `{ from, to }` — on 15 May, `n = 3` is 1 February … 30 April. Local-calendar, like\n *  everything here; `now` is for tests and for a host with its own clock. */\nexport function lastFullMonthsRange(n: number, now: Date = new Date()): { from: string; to: string } {\n  const from = new Date(now.getFullYear(), now.getMonth() - n, 1);\n  // Day 0 of the current month is the last day of the previous one.\n  const to = new Date(now.getFullYear(), now.getMonth(), 0);\n  return { from: toLocalIso(from), to: toLocalIso(to) };\n}\n\n/** The last `n` WHOLE calendar years before the current one — in 2026, `n = 2` is\n *  1 January 2024 … 31 December 2025. */\nexport function lastFullYearsRange(n: number, now: Date = new Date()): { from: string; to: string } {\n  const year = now.getFullYear();\n  return { from: `${year - n}-01-01`, to: `${year - 1}-12-31` };\n}\n\nexport interface CalendarMonthPresetOptions {\n  /** How many whole months each month preset spans. Default `[3, 6]`. */\n  months?: readonly number[];\n  /** How many whole years each year preset spans. Default `[2]`. */\n  years?: readonly number[];\n  /** The day to count back from. Default: now, on the local calendar. */\n  now?: Date;\n}\n\n/**\n * Month-ALIGNED presets, beside the rolling-day ones of {@link dateRangePresets}.\n *\n * kastlan's accounting reports are closed by the month: \"the last three months\" there\n * means February, March and April, never \"the 90 days up to this morning\", which\n * starts mid-month and ends with a day that is still being booked. `last_3_months`\n * above is the rolling kind and stays that way for the data table's filter, so these\n * are separate keys rather than a changed meaning under an old one.\n *\n * Keys are `last_<n>_full_months` and `last_<n>_full_years`; the host labels them (the\n * same arrangement as `dateRangePresets`' keys and its `table.preset_*` strings). With\n * `DateRangePicker`, pass the key as the preset's `id` so the choice keeps its\n * identity while the dates are recomputed on every render.\n */\nexport function calendarMonthPresets(options: CalendarMonthPresetOptions = {}): DateRangePreset[] {\n  const { months = [3, 6], years = [2], now = new Date() } = options;\n  return [\n    ...months.map((n) => ({ key: `last_${n}_full_months`, ...lastFullMonthsRange(n, now) })),\n    ...years.map((n) => ({ key: `last_${n}_full_years`, ...lastFullYearsRange(n, now) })),\n  ];\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/lib/dates.ts"],"sourcesContent":["/**\n * ISO date helpers, collected from copies that were scattered across the pages.\n *\n * **Every \"what day is it\" helper here reads the LOCAL calendar** — one family, not\n * two. It used to be two: these all built a local Date and then read it back through\n * `toISOString()`, which is UTC, so east of Greenwich they all returned YESTERDAY\n * between local midnight and the UTC rollover. The old module note called that\n * deliberate and warned against changing it. It was not defensible, and dev#471 is\n * what it cost:\n *\n * > *\"Just entered a tx now from scheduled. But it still shows as upcoming. Is there\n * > a problem with timezones? It is currently 1 o clock middle european summer time.\"*\n *\n * There was: at 01:00 CEST `todayIso()` answered with the 14th, the row the scheduler\n * had just booked was dated the 15th, and `isUpcoming` compares the two strings — so a\n * transaction entered a second ago read as one still to come. The same slip moved\n * `startOfMonthIso()` onto the last day of the PREVIOUS month for an hour every first\n * of the month, which is a report range nobody would have questioned.\n *\n * A calendar day only means anything to the human reading it, and every caller here —\n * the register's today, the date-range presets, the budget cursor, a new\n * transaction's default date — is asking that question. There is no caller for whom\n * \"the UTC day\" is the right answer; the server compares plain dates with no zone at\n * all, so sending it the user's local day is also what it wants.\n */\n\n/** Zero-pad a number to two digits (\"3\" -> \"03\"). */\nexport function pad(n: number): string {\n  return String(n).padStart(2, \"0\");\n}\n\n/** Today as \"YYYY-MM-DD\" on the LOCAL calendar (see the module note). */\nexport function todayIso(): string {\n  return toLocalIso(new Date());\n}\n\n/** A Date as a local-time \"YYYY-MM-DD\" string. */\nexport function toLocalIso(d: Date): string {\n  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;\n}\n\n/** A Date as a local-time \"YYYY-MM\" month key. */\nexport function monthKey(d: Date): string {\n  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}`;\n}\n\n// ---------- Date-range presets + calendar helpers ----------\n// Local-calendar like todayIso (see the module note); used by the data-table date\n// filter and its MiniCalendar. Each one mutates a local Date and must therefore READ\n// it back locally — going out through toISOString() is what shifted every one of\n// these by a day near midnight (dev#471).\n\n/** Today shifted by `days`, as \"YYYY-MM-DD\". */\nexport function shiftIso(days: number): string {\n  const d = new Date();\n  d.setDate(d.getDate() + days);\n  return toLocalIso(d);\n}\n\n/** First day (Monday) of the current week, as \"YYYY-MM-DD\". */\nexport function startOfWeekIso(): string {\n  const d = new Date();\n  const day = d.getDay();\n  const diff = (day + 6) % 7; // monday = 0\n  d.setDate(d.getDate() - diff);\n  return toLocalIso(d);\n}\n\n/** First day of the month `offsetMonths` from now, as \"YYYY-MM-DD\". */\nexport function startOfMonthIso(offsetMonths = 0): string {\n  const d = new Date();\n  d.setDate(1);\n  d.setMonth(d.getMonth() + offsetMonths);\n  return toLocalIso(d);\n}\n\n/** Last day of the month `offsetMonths` from now, as \"YYYY-MM-DD\". */\nexport function endOfMonthIso(offsetMonths = 0): string {\n  const d = new Date();\n  d.setDate(1);\n  d.setMonth(d.getMonth() + offsetMonths + 1);\n  d.setDate(0);\n  return toLocalIso(d);\n}\n\n/** First day of the year `offsetYears` from now, as \"YYYY-MM-DD\". */\nexport function startOfYearIso(offsetYears = 0): string {\n  const d = new Date();\n  d.setMonth(0);\n  d.setDate(1);\n  d.setFullYear(d.getFullYear() + offsetYears);\n  return toLocalIso(d);\n}\n\n/** Last day of the year `offsetYears` from now, as \"YYYY-MM-DD\". */\nexport function endOfYearIso(offsetYears = 0): string {\n  const d = new Date();\n  d.setMonth(11);\n  d.setDate(31);\n  d.setFullYear(d.getFullYear() + offsetYears);\n  return toLocalIso(d);\n}\n\n/** Parse a \"YYYY-MM-DD\" string to a local-midnight Date, or null if malformed —\n *  where \"malformed\" includes a date that does not exist.\n *\n *  The falsy check alone was not enough. `new Date(y, m - 1, d)` ROLLS OVER out-of-range\n *  components rather than refusing them, so \"2026-13-45\" came back as 2027-02-14 and\n *  \"2026-02-30\" as 2026-03-02: a valid-looking Date for a day that never happened. No\n *  caller could tell — {@link formatIsoDate} blanks only on `null`, so the invented\n *  date formatted and displayed exactly like a real one.\n *\n *  The round-trip is the check: build the Date, then read the components back off it.\n *  A value that rolled over cannot answer with the numbers it was given. That is the\n *  same shape {@link sameYmd} already expresses, applied to a Date and its source. */\nexport function parseIsoDate(s: string): Date | null {\n  if (!s) return null;\n  const [y, m, d] = s.split(\"-\").map(Number);\n  if (!y || !m || !d) return null;\n  if (!Number.isInteger(y) || !Number.isInteger(m) || !Number.isInteger(d)) return null;\n  const dt = new Date(y, m - 1, d);\n  if (Number.isNaN(dt.getTime())) return null;\n  if (dt.getFullYear() !== y || dt.getMonth() !== m - 1 || dt.getDate() !== d) return null;\n  return dt;\n}\n\n/** Format a \"YYYY-MM-DD\" string for display in `locale` (empty string when\n *  unparseable). Defaults to the locale's short numeric date; pass `options` to\n *  override (e.g. `{ dateStyle: \"medium\" }`). */\nexport function formatIsoDate(\n  iso: string,\n  locale: string,\n  options?: Intl.DateTimeFormatOptions,\n): string {\n  const d = parseIsoDate(iso);\n  return d ? d.toLocaleDateString(locale, options) : \"\";\n}\n\n/** A \"YYYY-MM-DD\" string shifted by `days` (negative shifts back), or the input\n *  unchanged when it isn't a parseable date.\n *\n *  Local-time throughout — {@link parseIsoDate} builds a local-midnight Date and\n *  {@link toLocalIso} reads local components back, so this never slides a day the way\n *  a `toISOString()` round-trip does west of UTC. */\nexport function addDaysIso(iso: string, days: number): string {\n  const d = parseIsoDate(iso);\n  if (!d) return iso;\n  d.setDate(d.getDate() + days);\n  return toLocalIso(d);\n}\n\n/**\n * `d` moved by whole months, keeping the day of the month where the target has one.\n * `setMonth` alone ROLLS OVER — 31 January + 1 month is 3 March — which would skip\n * February entirely for anyone paging through the year with PageDown. Returns a new\n * Date; `d` is not touched.\n */\nexport function addMonthsClamped(d: Date, months: number): Date {\n  const day = d.getDate();\n  const out = new Date(d.getFullYear(), d.getMonth() + months, 1);\n  const lastOfTarget = new Date(out.getFullYear(), out.getMonth() + 1, 0).getDate();\n  out.setDate(Math.min(day, lastOfTarget));\n  return out;\n}\n\n/**\n * The first day of the week in `locale`, as a `Date#getDay` index (0 = Sunday).\n *\n * `Intl.Locale#getWeekInfo()` is the standard spelling; V8 shipped it first as the\n * `weekInfo` accessor, and Firefox has neither yet — hence both reads and a Monday\n * fallback, which is ISO 8601. Its `firstDay` counts 1 = Monday … 7 = Sunday, so `% 7`\n * maps it onto `getDay`. `undefined` asks for the runtime's default locale.\n */\nexport function localeWeekStart(locale: string | undefined): 0 | 1 | 2 | 3 | 4 | 5 | 6 {\n  try {\n    const tag = locale ?? new Intl.DateTimeFormat().resolvedOptions().locale;\n    const loc = new Intl.Locale(tag) as Intl.Locale & {\n      getWeekInfo?: () => { firstDay: number };\n      weekInfo?: { firstDay: number };\n    };\n    const firstDay = (loc.getWeekInfo?.() ?? loc.weekInfo)?.firstDay;\n    if (typeof firstDay === \"number\") return (firstDay % 7) as 0 | 1 | 2 | 3 | 4 | 5 | 6;\n  } catch {\n    // A malformed tag throws from `Intl.Locale`; a calendar still has to render.\n  }\n  return 1;\n}\n\n/** Whether two Dates fall on the same local calendar day. */\nexport function sameYmd(a: Date, b: Date): boolean {\n  return (\n    a.getFullYear() === b.getFullYear() &&\n    a.getMonth() === b.getMonth() &&\n    a.getDate() === b.getDate()\n  );\n}\n\nexport interface DateRangePreset {\n  key: string;\n  from: string;\n  to: string;\n}\n\n/**\n * The named ranges offered by the data-table date filter (local-calendar, like\n * {@link todayIso} — see the module note). `key` maps to the consumer's\n * `table.preset_*` labels.\n */\nexport function dateRangePresets(): DateRangePreset[] {\n  const mondayOffset = (new Date().getDay() + 6) % 7; // monday = 0\n  return [\n    { key: \"today\", from: todayIso(), to: todayIso() },\n    { key: \"yesterday\", from: shiftIso(-1), to: shiftIso(-1) },\n    { key: \"this_week\", from: startOfWeekIso(), to: todayIso() },\n    { key: \"last_week\", from: shiftIso(-7 - mondayOffset), to: shiftIso(-1 - mondayOffset) },\n    { key: \"last_7_days\", from: shiftIso(-6), to: todayIso() },\n    { key: \"last_30_days\", from: shiftIso(-29), to: todayIso() },\n    { key: \"this_month\", from: startOfMonthIso(0), to: todayIso() },\n    { key: \"last_month\", from: startOfMonthIso(-1), to: endOfMonthIso(-1) },\n    { key: \"last_3_months\", from: shiftIso(-90), to: todayIso() },\n    { key: \"ytd\", from: startOfYearIso(0), to: todayIso() },\n    { key: \"last_year\", from: startOfYearIso(-1), to: endOfYearIso(-1) },\n  ];\n}\n\n/** The last `n` WHOLE calendar months before the current one, as an inclusive\n *  `{ from, to }` — on 15 May, `n = 3` is 1 February … 30 April. Local-calendar, like\n *  everything here; `now` is for tests and for a host with its own clock. */\nexport function lastFullMonthsRange(n: number, now: Date = new Date()): { from: string; to: string } {\n  const from = new Date(now.getFullYear(), now.getMonth() - n, 1);\n  // Day 0 of the current month is the last day of the previous one.\n  const to = new Date(now.getFullYear(), now.getMonth(), 0);\n  return { from: toLocalIso(from), to: toLocalIso(to) };\n}\n\n/** The last `n` WHOLE calendar years before the current one — in 2026, `n = 2` is\n *  1 January 2024 … 31 December 2025. */\nexport function lastFullYearsRange(n: number, now: Date = new Date()): { from: string; to: string } {\n  const year = now.getFullYear();\n  return { from: `${year - n}-01-01`, to: `${year - 1}-12-31` };\n}\n\nexport interface CalendarMonthPresetOptions {\n  /** How many whole months each month preset spans. Default `[3, 6]`. */\n  months?: readonly number[];\n  /** How many whole years each year preset spans. Default `[2]`. */\n  years?: readonly number[];\n  /** The day to count back from. Default: now, on the local calendar. */\n  now?: Date;\n}\n\n/**\n * Month-ALIGNED presets, beside the rolling-day ones of {@link dateRangePresets}.\n *\n * kastlan's accounting reports are closed by the month: \"the last three months\" there\n * means February, March and April, never \"the 90 days up to this morning\", which\n * starts mid-month and ends with a day that is still being booked. `last_3_months`\n * above is the rolling kind and stays that way for the data table's filter, so these\n * are separate keys rather than a changed meaning under an old one.\n *\n * Keys are `last_<n>_full_months` and `last_<n>_full_years`; the host labels them (the\n * same arrangement as `dateRangePresets`' keys and its `table.preset_*` strings). With\n * `DateRangePicker`, pass the key as the preset's `id` so the choice keeps its\n * identity while the dates are recomputed on every render.\n */\nexport function calendarMonthPresets(options: CalendarMonthPresetOptions = {}): DateRangePreset[] {\n  const { months = [3, 6], years = [2], now = new Date() } = options;\n  return [\n    ...months.map((n) => ({ key: `last_${n}_full_months`, ...lastFullMonthsRange(n, now) })),\n    ...years.map((n) => ({ key: `last_${n}_full_years`, ...lastFullYearsRange(n, now) })),\n  ];\n}\n"],"mappings":"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","names":[]}

package/dist/lib/format.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Number, money, percentage, date and relative-time formatting — `Intl`, in one place,
+ * for the figures an app prints OUTSIDE a kit component.
+ *
+ * Each app grew its own: kastlan's `utils/formatters.ts` (a Swiss-pinned
+ * `formatNumber`/`formatCurrency`, a date-fns `formatDate`, and a `formatRelativeTime`
+ * whose "5m ago" / "3h ago" / "2d ago" stayed English in every language), its tenancy
+ * `format.ts` (`formatChf`, a `formatPct` gluing a "+" onto `toFixed(2)`), keksdose's
+ * own set. Every one of them is `Intl` with a locale bolted on, so the only thing
+ * worth sharing is the locale — and the kit already has one, the provider's.
+ *
+ * The plain functions take a `locale` (none: the runtime default, as every `Intl` API
+ * reads `undefined`). Inside a component, {@link useKitFormat} hands back the same
+ * 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".
+ */
+/** What every formatter here prints for a missing value, unless told otherwise. */
+declare const EMPTY_FORMATTED_VALUE = "\u2014";
+/** Fraction digits: a number pins both the minimum and the maximum (`2` → "3.10");
+ *  an object sets them apart (a meter reading, 1–3). */
+type FormatDigits = number | {
+    min?: number;
+    max?: number;
+};
+interface BaseOptions {
+    /** BCP 47 tag. Left out: the runtime default (the hook: the provider's). */
+    locale?: string;
+    /** Printed for a missing value. Default {@link EMPTY_FORMATTED_VALUE}. */
+    empty?: string;
+}
+interface FormatNumberOptions extends BaseOptions {
+    digits?: FormatDigits;
+    /** Compact notation: 12 400 → "12K". */
+    compact?: boolean;
+    /** `"exceptZero"` for a change ("+3", "−3", "0"). Default: the minus only. */
+    signDisplay?: Intl.NumberFormatOptions["signDisplay"];
+    /** Any further `Intl.NumberFormat` options, merged over the ones above. */
+    options?: Intl.NumberFormatOptions;
+}
+interface FormatMoneyOptions extends FormatNumberOptions {
+    /** `"symbol"` (default), `"narrowSymbol"`, `"code"` ("CHF 12.00") or `"name"`. */
+    currencyDisplay?: Intl.NumberFormatOptions["currencyDisplay"];
+}
+interface FormatPercentOptions extends FormatNumberOptions {
+    /**
+     * `true` (default): `value` is a RATIO, as `Intl` and `StatTile`'s percent delta read
+     * it — `0.12` is 12 %. `false`: it is already a percentage — `12` is 12 %
+     * (kastlan's rent `change_pct`).
+     */
+    ratio?: boolean;
+}
+/** A number in `locale`: "1,234.5", "1.234,5", "1’234.5". */
+declare function formatNumber(value: number | null | undefined, options?: FormatNumberOptions): string;
+/** An amount of `currency` (ISO 4217) in `locale`: "CHF 1’234.50", "1.234,50 €". */
+declare function formatMoney(value: number | null | undefined, 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. */
+declare function formatPercent(value: number | null | undefined, 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`
+ *    ("08/07/2026", "8 Jul 2026", "8 July 2026", "Wednesday, 8 July 2026" in en-GB).
+ *  - `dateTime` — medium date and short time: a timestamp ("8 Jul 2026, 14:05").
+ *  - `time` — the short time alone ("14:05").
+ *  - `monthYear` — "July 2026".
+ *
+ * Or pass `Intl.DateTimeFormatOptions` for anything else. A date-fns PATTERN
+ * ("dd.MM.yyyy") is deliberately not accepted: a pattern is one locale's order baked
+ * into a string, which is how an English page ends up with German dates.
+ */
+type FormatDateStyle = "short" | "medium" | "long" | "full" | "dateTime" | "time" | "monthYear";
+interface FormatDateOptions extends BaseOptions {
+    /** An IANA zone ("Europe/Zurich") for a timestamp. Left out: the device's. */
+    timeZone?: string;
+}
+/** What {@link formatDate} and {@link formatRelativeTime} accept. */
+type DateInput = string | number | Date | null | undefined;
+/**
+ * `value` as a Date, or null. A bare "YYYY-MM-DD" is a CALENDAR day and is read on the
+ * local calendar (`parseIsoDate`) — `new Date("2026-07-08")` is UTC midnight, which is
+ * the 7th anywhere west of Greenwich. Anything else (a full ISO timestamp, epoch
+ * milliseconds, a Date) is an instant and goes through `Date` as is.
+ */
+declare function toDate(value: DateInput): Date | null;
+/**
+ * A date or timestamp in `locale`. Takes an ISO date ("2026-07-08", read on the local
+ * calendar), an ISO timestamp ("2026-07-08T14:05:00Z"), epoch milliseconds or a Date.
+ * `style` defaults to `medium`; see {@link FormatDateStyle}.
+ *
+ * `formatIsoDate` (`@eifi1/ui-kit/dates`) remains for a plain "YYYY-MM-DD" with an
+ * explicit locale; this is its superset for timestamps and the named styles.
+ */
+declare function formatDate(value: DateInput, style?: FormatDateStyle | Intl.DateTimeFormatOptions, options?: FormatDateOptions): string;
+interface FormatRelativeTimeOptions extends BaseOptions {
+    /** The moment it is measured from. Default: now. */
+    now?: DateInput;
+    /** `"auto"` (default): "yesterday", "now", "next week". `"always"`: "1 day ago". */
+    numeric?: Intl.RelativeTimeFormatNumeric;
+    /** `"long"` (default) "3 hours ago", `"short"` "3 hr. ago", `"narrow"` "3h ago". */
+    style?: Intl.RelativeTimeFormatStyle;
+    /**
+     * Past this many days either way, print the date instead ({@link formatDate} in
+     * `absoluteStyle`) — kastlan's feed switches to the date after a week, because "5
+     * weeks ago" makes a reader do sums. Default: never.
+     */
+    absoluteAfterDays?: number;
+    /** The style of that date. Default `medium`. */
+    absoluteStyle?: FormatDateStyle | Intl.DateTimeFormatOptions;
+}
+/**
+ * How long ago (or until) `value` is, in `locale`'s words, through
+ * `Intl.RelativeTimeFormat`: "3 hours ago", "vor 3 Stunden", "il y a 3 heures",
+ * "in 2 days", and under 45 seconds "now". The unit is picked by size — seconds,
+ * minutes, hours, days, weeks, months, years — and the count is rounded.
+ */
+declare function formatRelativeTime(value: DateInput, options?: FormatRelativeTimeOptions): string;
+type WithoutLocale<T> = Omit<T, "locale"> & {
+    locale?: string;
+};
+/** What {@link useKitFormat} returns: the formatters above with the provider's locale
+ *  as their default (an explicit `locale` in the options still wins). */
+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;
+    formatDate: (value: DateInput, style?: FormatDateStyle | Intl.DateTimeFormatOptions, options?: WithoutLocale<FormatDateOptions>) => string;
+    formatRelativeTime: (value: DateInput, options?: WithoutLocale<FormatRelativeTimeOptions>) => string;
+}
+/**
+ * The formatters, bound to the `<UiKitProvider locale>` (or to `locale`, which wins
+ * over it — the same precedence as a component's `locale` prop):
+ *
+ *     const { formatMoney, formatRelativeTime } = useKitFormat();
+ *     formatMoney(row.balance, "CHF");
+ */
+declare function useKitFormat(locale?: string): KitFormat;
+
+export { type DateInput, EMPTY_FORMATTED_VALUE, type FormatDateOptions, type FormatDateStyle, type FormatDigits, type FormatMoneyOptions, type FormatNumberOptions, type FormatPercentOptions, type FormatRelativeTimeOptions, type KitFormat, formatDate, formatMoney, formatNumber, formatPercent, formatRelativeTime, toDate, useKitFormat };

package/dist/lib/format.js

@@ -0,0 +1,149 @@
+"use client";
+import { useMemo } from "react";
+import { useKitLocale } from "../i18n/kit-labels.js";
+import { parseIsoDate } from "./dates.js";
+const EMPTY_FORMATTED_VALUE = "\u2014";
+const numberFormatters = /* @__PURE__ */ new Map();
+function numberFormatter(locale, options) {
+  const key = `${locale ?? ""}|${JSON.stringify(options)}`;
+  let f = numberFormatters.get(key);
+  if (!f) {
+    f = new Intl.NumberFormat(locale, options);
+    numberFormatters.set(key, f);
+  }
+  return f;
+}
+function digitOptions(digits) {
+  if (digits === void 0) return {};
+  if (typeof digits === "number") return { minimumFractionDigits: digits, maximumFractionDigits: digits };
+  return {
+    ...digits.min !== void 0 ? { minimumFractionDigits: digits.min } : null,
+    ...digits.max !== void 0 ? { maximumFractionDigits: digits.max } : null
+  };
+}
+function numberOptions(o) {
+  return {
+    ...digitOptions(o.digits),
+    ...o.compact ? { notation: "compact" } : null,
+    ...o.signDisplay ? { signDisplay: o.signDisplay } : null,
+    ...o.options
+  };
+}
+function isMissing(value) {
+  return value === null || value === void 0 || Number.isNaN(value);
+}
+function formatNumber(value, options = {}) {
+  if (isMissing(value)) return options.empty ?? EMPTY_FORMATTED_VALUE;
+  return numberFormatter(options.locale, numberOptions(options)).format(value);
+}
+function formatMoney(value, currency, options = {}) {
+  if (isMissing(value)) return options.empty ?? EMPTY_FORMATTED_VALUE;
+  return numberFormatter(options.locale, {
+    style: "currency",
+    currency,
+    ...options.currencyDisplay ? { currencyDisplay: options.currencyDisplay } : null,
+    ...numberOptions(options)
+  }).format(value);
+}
+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, {
+    style: "percent",
+    ...options.digits === void 0 ? { maximumFractionDigits: 1 } : null,
+    ...numberOptions(options)
+  }).format(ratio);
+}
+const DATE_STYLES = {
+  short: { dateStyle: "short" },
+  medium: { dateStyle: "medium" },
+  long: { dateStyle: "long" },
+  full: { dateStyle: "full" },
+  dateTime: { dateStyle: "medium", timeStyle: "short" },
+  time: { timeStyle: "short" },
+  monthYear: { month: "long", year: "numeric" }
+};
+function toDate(value) {
+  if (value === null || value === void 0 || value === "") return null;
+  if (typeof value === "string" && /^\d{4}-\d{2}-\d{2}$/.test(value)) return parseIsoDate(value);
+  const d = value instanceof Date ? value : new Date(value);
+  return Number.isNaN(d.getTime()) ? null : d;
+}
+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;
+}
+function formatDate(value, style = "medium", options = {}) {
+  const d = toDate(value);
+  if (!d) return options.empty ?? EMPTY_FORMATTED_VALUE;
+  const base = typeof style === "string" ? DATE_STYLES[style] : style;
+  return dateFormatter(options.locale, options.timeZone ? { ...base, timeZone: options.timeZone } : base).format(d);
+}
+const SECOND = 1e3;
+const MINUTE = 60 * SECOND;
+const HOUR = 60 * MINUTE;
+const DAY = 24 * HOUR;
+const RELATIVE_STEPS = [
+  [45 * SECOND, "second", SECOND],
+  [45 * MINUTE, "minute", MINUTE],
+  [22 * HOUR, "hour", HOUR],
+  [6.5 * DAY, "day", DAY],
+  [26 * DAY, "week", 7 * DAY],
+  [320 * DAY, "month", 30.44 * DAY],
+  [Infinity, "year", 365.25 * DAY]
+];
+const relativeFormatters = /* @__PURE__ */ new Map();
+function relativeFormatter(locale, numeric, style) {
+  const key = `${locale ?? ""}|${numeric}|${style}`;
+  let f = relativeFormatters.get(key);
+  if (!f) {
+    f = new Intl.RelativeTimeFormat(locale, { numeric, style });
+    relativeFormatters.set(key, f);
+  }
+  return f;
+}
+function formatRelativeTime(value, options = {}) {
+  const d = toDate(value);
+  if (!d) return options.empty ?? EMPTY_FORMATTED_VALUE;
+  const now = toDate(options.now ?? /* @__PURE__ */ new Date()) ?? /* @__PURE__ */ new Date();
+  const diff = d.getTime() - now.getTime();
+  const abs = Math.abs(diff);
+  if (options.absoluteAfterDays !== void 0 && abs > options.absoluteAfterDays * DAY) {
+    return formatDate(d, options.absoluteStyle ?? "medium", options);
+  }
+  const rtf = relativeFormatter(options.locale, options.numeric ?? "auto", options.style ?? "long");
+  const [, unit, size] = RELATIVE_STEPS.find(([limit]) => abs < limit);
+  const count = unit === "second" ? 0 : Math.round(diff / size);
+  return rtf.format(count + 0, unit);
+}
+function useKitFormat(locale) {
+  const kitLocale = useKitLocale(locale);
+  return useMemo(
+    () => ({
+      locale: kitLocale,
+      formatNumber: (value, options) => formatNumber(value, { locale: kitLocale, ...options }),
+      formatMoney: (value, currency, options) => formatMoney(value, currency, { locale: kitLocale, ...options }),
+      formatPercent: (value, options) => formatPercent(value, { locale: kitLocale, ...options }),
+      formatDate: (value, style, options) => formatDate(value, style, { locale: kitLocale, ...options }),
+      formatRelativeTime: (value, options) => formatRelativeTime(value, { locale: kitLocale, ...options })
+    }),
+    [kitLocale]
+  );
+}
+export {
+  EMPTY_FORMATTED_VALUE,
+  formatDate,
+  formatMoney,
+  formatNumber,
+  formatPercent,
+  formatRelativeTime,
+  toDate,
+  useKitFormat
+};
+//# sourceMappingURL=format.js.map

package/dist/lib/format.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/format.ts"],"sourcesContent":["import { useMemo } from \"react\";\nimport { useKitLocale } from \"../i18n/kit-labels\";\nimport { parseIsoDate } from \"./dates\";\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\nexport interface FormatNumberOptions 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\nexport interface FormatMoneyOptions extends FormatNumberOptions {\n  /** `\"symbol\"` (default), `\"narrowSymbol\"`, `\"code\"` (\"CHF 12.00\") or `\"name\"`. */\n  currencyDisplay?: Intl.NumberFormatOptions[\"currencyDisplay\"];\n}\n\nexport interface FormatPercentOptions extends FormatNumberOptions {\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: FormatNumberOptions): 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  return value === null || value === undefined || Number.isNaN(value);\n}\n\n/** A number in `locale`: \"1,234.5\", \"1.234,5\", \"1’234.5\". */\nexport function formatNumber(value: number | null | undefined, options: FormatNumberOptions = {}): string {\n  if (isMissing(value)) return options.empty ?? EMPTY_FORMATTED_VALUE;\n  return numberFormatter(options.locale, numberOptions(options)).format(value);\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. */\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 (typeof value === \"string\" && /^\\d{4}-\\d{2}-\\d{2}$/.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  return dateFormatter(options.locale, options.timeZone ? { ...base, timeZone: options.timeZone } : base).format(d);\n}\n\nexport interface FormatRelativeTimeOptions extends BaseOptions {\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  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, ...options }),\n      formatRelativeTime: (value, options) => formatRelativeTime(value, { locale: kitLocale, ...options }),\n    }),\n    [kitLocale],\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/lib/qr-encode.d.ts

@@ -0,0 +1,44 @@
+/**
+ * A QR code encoder: text in, a square of dark / light modules out (ISO/IEC 18004).
+ *
+ * WHY IT IS IN THE KIT rather than a dependency. `TwoFactorSetting` needs one QR code —
+ * an `otpauth://` URI, around 100–200 bytes — and every app that shows it was pulling
+ * in `qrcode.react` plus `react-dom/server` to render that one code to a static SVG
+ * string, then base64-encoding it so the kit could draw it back as an `<img>`.
+ * A dependency here would land in all three apps whether they show 2FA or not; an
+ * optional peer would mean a lazy import and a loading state for something that is
+ * a few hundred lines of arithmetic. So it is those lines: pure, no imports, no module
+ * state beyond two constant tables, safe under `sideEffects: false`, and
+ * tree-shaken out of every app that never renders a {@link QrCode}.
+ *
+ * Scope, chosen for what the kit renders: BYTE mode only (UTF-8), all 40 versions,
+ * all four error-correction levels, automatic version and mask selection. Numeric,
+ * alphanumeric and Kanji modes are denser for their alphabets but would not shrink an
+ * otpauth URI (lower-case letters are not in the alphanumeric set). The algorithm and
+ * its penalty rules follow the reference implementation by Project Nayuki (MIT),
+ * which is also what `qrcode.react` wraps — so for the same input, level and boost
+ * the modules match that library's output exactly (the test suite pins a matrix).
+ */
+type QrErrorCorrection = "L" | "M" | "Q" | "H";
+interface QrEncodeOptions {
+    /** How much of the code may be damaged and still read. Default `"M"` (~15 %). */
+    errorCorrection?: QrErrorCorrection;
+    /** Raise the level as far as the chosen version still fits, for free. Default true. */
+    boostErrorCorrection?: boolean;
+}
+interface QrMatrix {
+    /** 1–40. */
+    version: number;
+    /** Modules per side: `version * 4 + 17`. */
+    size: number;
+    /** The level actually used — higher than asked when boosted. */
+    errorCorrection: QrErrorCorrection;
+    /** 0–7. */
+    mask: number;
+    /** `modules[y][x]`, true = dark. No quiet zone: the renderer adds its own. */
+    modules: boolean[][];
+}
+/** Encode `text` (as UTF-8 bytes). Throws a `RangeError` past version 40's capacity. */
+declare function encodeQr(text: string, options?: QrEncodeOptions): QrMatrix;
+
+export { type QrEncodeOptions, type QrErrorCorrection, type QrMatrix, encodeQr };