@eifi1/ui-kit 0.51.7 → 0.52.0

package/dist/lib/date-format.js

@@ -1,5 +1,8 @@
 "use client";
 import { formatLocaleOf } from "../i18n/languages.js";
+import { pad, toLocalIso } from "./dates.js";
+import { dateFormatter } from "./intl-cache.js";
+import { isBareIsoDay } from "./iso-day.js";
 const DATE_FORMAT_PREFERENCES = ["auto", "de-DE", "en-GB", "en-US", "sv-SE"];
 function isDateFormatPreference(value) {
   return typeof value === "string" && DATE_FORMAT_PREFERENCES.includes(value);
@@ -12,10 +15,9 @@ function resolveDateFormat(preference, language, options = {}) {
   }
   return { locale: preference, options: { year: "numeric", month: "2-digit", day: "2-digit" }, ...weekday };
 }
-const DATE_ONLY = /^\d{4}-\d{2}-\d{2}$/;
 function withWeekday(date, dateText, locale, options) {
   const isDatePart = (p) => p.type === "day" || p.type === "month" || p.type === "year";
-  const parts = new Intl.DateTimeFormat(locale, { weekday: "short", ...options }).formatToParts(date);
+  const parts = dateFormatter(locale, { weekday: "short", ...options }).formatToParts(date);
   const first = parts.findIndex(isDatePart);
   if (first === -1) return dateText;
   let last = first;
@@ -28,16 +30,38 @@ function withWeekday(date, dateText, locale, options) {
 function formatDateWithPreference(value, preference, language, options = {}) {
   if (!value) return "";
   const resolved = resolveDateFormat(preference, language, options);
-  const dateOnly = typeof value === "string" && DATE_ONLY.test(value);
+  const dateOnly = isBareIsoDay(value);
   const date = typeof value === "string" ? new Date(value) : value;
   if (Number.isNaN(date.getTime())) return String(value);
-  const intl = dateOnly ? { ...resolved.options, timeZone: "UTC" } : resolved.options;
-  try {
-    const text = date.toLocaleDateString(resolved.locale, intl);
+  const render = (timeZone) => {
+    const intl = timeZone ? { ...resolved.options, timeZone } : resolved.options;
+    const text = dateFormatter(resolved.locale, intl).format(date);
     return resolved.weekday ? withWeekday(date, text, resolved.weekday.locale, intl) : text;
-  } catch {
-    return date.toISOString().slice(0, 10);
+  };
+  if (dateOnly) return firstAccepted([() => render("UTC")], () => value);
+  return firstAccepted([() => render(options.timeZone), () => render(void 0)], () => toLocalIso(date));
+}
+function firstAccepted(renders, last) {
+  for (const render of renders) {
+    try {
+      return render();
+    } catch {
+    }
   }
+  return last();
+}
+function clockTime(date, language, timeZone) {
+  const locale = language ? formatLocaleOf(language) : void 0;
+  const clock = (zone) => dateFormatter(locale, { hour: "2-digit", minute: "2-digit", ...zone ? { timeZone: zone } : null }).format(date);
+  const reader = () => `${pad(date.getHours())}:${pad(date.getMinutes())}`;
+  return firstAccepted([() => clock(timeZone), () => clock(void 0)], reader);
+}
+function formatDateTimeWithPreference(value, preference, language, options = {}) {
+  if (!value) return "";
+  if (isBareIsoDay(value)) return formatDateWithPreference(value, preference, language, options);
+  const date = typeof value === "string" ? new Date(value) : value;
+  if (Number.isNaN(date.getTime())) return String(value);
+  return `${formatDateWithPreference(date, preference, language, options)}, ${clockTime(date, language, options.timeZone)}`;
 }
 function dateFormatSample(preference, language) {
   return formatDateWithPreference("2026-08-01", preference, language);
@@ -47,8 +71,10 @@ function dateFormatterFor(preference, language) {
 }
 export {
   DATE_FORMAT_PREFERENCES,
+  clockTime,
   dateFormatSample,
   dateFormatterFor,
+  formatDateTimeWithPreference,
   formatDateWithPreference,
   isDateFormatPreference,
   resolveDateFormat

package/dist/lib/date-format.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/date-format.ts"],"sourcesContent":["import { formatLocaleOf } from \"../i18n/languages\";\nimport type { KitDateFormatter } from \"../i18n/kit-labels\";\n\n/**\n * The date-format preference (0.46, lifted from keksdose's `date-format-store.ts`,\n * feedback #180): how a DAY is written — the order of day, month and year and the\n * separator between them — as a choice of its own, apart from the interface language.\n * \"Read the app in English and still see German dates\", or ISO everywhere.\n *\n * keksdose's rules, which the kit keeps:\n *\n * 1. **A label that identifies a day follows the preference** — anything that prints\n *    day, month and year goes through {@link formatDateWithPreference} (or the\n *    provider's `formatDate`, {@link dateFormatterFor}, for the kit's own date fields).\n * 2. **A label without a day follows the language**: \"August 2026\", a month or weekday\n *    NAME has no order to arrange. {@link dateFormatterFor} answers `\"\"` for a month or a\n *    year, so the kit keeps its own rendering in the language.\n * 3. **A clock time follows the language**: `sv-SE` is a statement about digit order in\n *    a date, not about a 12- or 24-hour clock.\n * 4. **A weekday's NAME follows the language** (dev#546): `sv-SE` means \"year first,\n *    with dashes\", not \"the reader speaks Swedish\" — so with `weekday` the day's name is\n *    the language's, joined to the date the preference renders.\n *\n * The preference is the APP's to keep — keksdose holds it per device (a persisted store,\n * not an account column: nothing server-written formats a date for the reader). The kit\n * owns the vocabulary, the resolver, the renderer and the settings field\n * ({@link DateFormatSetting}).\n */\n\n/** `\"auto\"` follows the interface language (the default — nobody's dates move until\n *  they ask); the rest are BCP 47 tags chosen for the SHAPE they produce: German\n *  01.08.2026, British 01/08/2026, US 08/01/2026, ISO 2026-08-01. */\nexport type DateFormatPreference = \"auto\" | \"de-DE\" | \"en-GB\" | \"en-US\" | \"sv-SE\";\n\n/** The options in the order the setting lists them: `auto` first (the default), then\n *  German → UK → US → ISO. */\nexport const DATE_FORMAT_PREFERENCES: readonly DateFormatPreference[] = [\"auto\", \"de-DE\", \"en-GB\", \"en-US\", \"sv-SE\"];\n\n/** Whether `value` is one of {@link DATE_FORMAT_PREFERENCES} — for a value read back from\n *  storage, where anything else falls back to `\"auto\"`. */\nexport function isDateFormatPreference(value: unknown): value is DateFormatPreference {\n  return typeof value === \"string\" && (DATE_FORMAT_PREFERENCES as readonly string[]).includes(value);\n}\n\n/** A resolved preference: the locale and `Intl` options the date itself is rendered\n *  with, and — only when asked for — the locale the weekday's NAME comes from. */\nexport interface ResolvedDateFormat {\n  locale: string | undefined;\n  options: Intl.DateTimeFormatOptions;\n  /** The language's format locale, present when `weekday` was asked for. */\n  weekday?: { locale: string | undefined };\n}\n\n/** What {@link resolveDateFormat} and the renderers take beyond the preference. */\nexport interface DateFormatOptions {\n  /** Name the day of the week too, in the interface language (\"Mo., 01.08.2026\"). A date\n   *  in a COLUMN carries it; a date in a SENTENCE does not (keksdose dev#546). */\n  weekday?: boolean;\n}\n\n/**\n * What a date is rendered with, given the preference and the interface language\n * (`language`: a code or tag — `\"de\"`, `\"en\"`, i18next's `resolvedLanguage`; it is read\n * through `formatLocaleOf`, so English is British and an unshipped tag stays itself).\n *\n * `\"auto\"` keeps the short-month shape (\"01 Aug 2026\", \"01. Aug. 2026\"); every explicit\n * choice is all-numeric, the only way it produces the shape its option promises —\n * `month: \"short\"` under `sv-SE` would print \"2026 aug. 01\", not ISO.\n */\nexport function resolveDateFormat(\n  preference: DateFormatPreference,\n  language: string | undefined,\n  options: DateFormatOptions = {},\n): ResolvedDateFormat {\n  const languageLocale = language ? formatLocaleOf(language) : undefined;\n  const weekday = options.weekday ? { weekday: { locale: languageLocale } } : {};\n  if (preference === \"auto\") {\n    return { locale: languageLocale, options: { year: \"numeric\", month: \"short\", day: \"2-digit\" }, ...weekday };\n  }\n  return { locale: preference, options: { year: \"numeric\", month: \"2-digit\", day: \"2-digit\" }, ...weekday };\n}\n\n/** A bare calendar day: no time, no zone. */\nconst DATE_ONLY = /^\\d{4}-\\d{2}-\\d{2}$/;\n\n/**\n * `dateText`, already rendered under the preference, with the day's NAME around it in\n * `locale` (the language's). Not \"weekday alone + comma\": German says \"So\" alone and\n * \"So., 06.09.2026\" in company. The full date is formatted in the language and split\n * into parts; what that language puts before the first and after the last day/month/\n * year part (the weekday, its comma) frames the preference's digits — so where the two\n * locales coincide the output is the native string, character for character.\n */\nfunction withWeekday(date: Date, dateText: string, locale: string | undefined, options: Intl.DateTimeFormatOptions) {\n  const isDatePart = (p: Intl.DateTimeFormatPart) => p.type === \"day\" || p.type === \"month\" || p.type === \"year\";\n  const parts = new Intl.DateTimeFormat(locale, { weekday: \"short\", ...options }).formatToParts(date);\n  const first = parts.findIndex(isDatePart);\n  if (first === -1) return dateText;\n  let last = first;\n  parts.forEach((p, i) => {\n    if (isDatePart(p)) last = i;\n  });\n  const join = (ps: Intl.DateTimeFormatPart[]) => ps.map((p) => p.value).join(\"\");\n  return join(parts.slice(0, first)) + dateText + join(parts.slice(last + 1));\n}\n\n/**\n * A date under the preference: `\"\"` for no value, the input itself when it does not\n * parse. A bare \"YYYY-MM-DD\" is the calendar day it names in every zone (formatted in\n * UTC, undoing `new Date`'s UTC-midnight parse — west of Greenwich it read a day early);\n * a timestamp is an instant and stays in the reader's zone. The weekday, when asked for,\n * is rendered in the same zone, so a Sunday is never captioned Saturday.\n */\nexport function formatDateWithPreference(\n  value: string | Date | null | undefined,\n  preference: DateFormatPreference,\n  language: string | undefined,\n  options: DateFormatOptions = {},\n): string {\n  if (!value) return \"\";\n  const resolved = resolveDateFormat(preference, language, options);\n  const dateOnly = typeof value === \"string\" && DATE_ONLY.test(value);\n  const date = typeof value === \"string\" ? new Date(value) : value;\n  if (Number.isNaN(date.getTime())) return String(value);\n  const intl: Intl.DateTimeFormatOptions = dateOnly ? { ...resolved.options, timeZone: \"UTC\" } : resolved.options;\n  try {\n    const text = date.toLocaleDateString(resolved.locale, intl);\n    return resolved.weekday ? withWeekday(date, text, resolved.weekday.locale, intl) : text;\n  } catch {\n    // A language tag `Intl` refuses: the ISO day rather than nothing (keksdose's fallback).\n    return date.toISOString().slice(0, 10);\n  }\n}\n\n/** The sample an option is labelled with — 1 August 2026 in its shape, the shape being\n *  the whole choice (a country name would say nothing about the digit order). */\nexport function dateFormatSample(preference: DateFormatPreference, language: string | undefined): string {\n  return formatDateWithPreference(\"2026-08-01\", preference, language);\n}\n\n/**\n * The `<UiKitProvider formatDate>` for a preference — so the kit's own date fields\n * (DatePicker, DateRangePicker, DateMark) write a day as the app's dates do. A day\n * follows the preference, with the weekday where the kit suggests it; a month or a year\n * answers `\"\"` and keeps the kit's rendering in the language (rule 2). Rebuild it when\n * the preference or the language changes (a `useMemo` on both).\n */\nexport function dateFormatterFor(preference: DateFormatPreference, language: string | undefined): KitDateFormatter {\n  return (iso, { unit, weekday, locale }) =>\n    unit === \"day\" ? formatDateWithPreference(iso, preference, locale ?? language, { weekday }) : \"\";\n}\n"],"mappings":";AAAA,SAAS,sBAAsB;AAoCxB,MAAM,0BAA2D,CAAC,QAAQ,SAAS,SAAS,SAAS,OAAO;AAI5G,SAAS,uBAAuB,OAA+C;AACpF,SAAO,OAAO,UAAU,YAAa,wBAA8C,SAAS,KAAK;AACnG;AA2BO,SAAS,kBACd,YACA,UACA,UAA6B,CAAC,GACV;AACpB,QAAM,iBAAiB,WAAW,eAAe,QAAQ,IAAI;AAC7D,QAAM,UAAU,QAAQ,UAAU,EAAE,SAAS,EAAE,QAAQ,eAAe,EAAE,IAAI,CAAC;AAC7E,MAAI,eAAe,QAAQ;AACzB,WAAO,EAAE,QAAQ,gBAAgB,SAAS,EAAE,MAAM,WAAW,OAAO,SAAS,KAAK,UAAU,GAAG,GAAG,QAAQ;AAAA,EAC5G;AACA,SAAO,EAAE,QAAQ,YAAY,SAAS,EAAE,MAAM,WAAW,OAAO,WAAW,KAAK,UAAU,GAAG,GAAG,QAAQ;AAC1G;AAGA,MAAM,YAAY;AAUlB,SAAS,YAAY,MAAY,UAAkB,QAA4B,SAAqC;AAClH,QAAM,aAAa,CAAC,MAA+B,EAAE,SAAS,SAAS,EAAE,SAAS,WAAW,EAAE,SAAS;AACxG,QAAM,QAAQ,IAAI,KAAK,eAAe,QAAQ,EAAE,SAAS,SAAS,GAAG,QAAQ,CAAC,EAAE,cAAc,IAAI;AAClG,QAAM,QAAQ,MAAM,UAAU,UAAU;AACxC,MAAI,UAAU,GAAI,QAAO;AACzB,MAAI,OAAO;AACX,QAAM,QAAQ,CAAC,GAAG,MAAM;AACtB,QAAI,WAAW,CAAC,EAAG,QAAO;AAAA,EAC5B,CAAC;AACD,QAAM,OAAO,CAAC,OAAkC,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE;AAC9E,SAAO,KAAK,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,WAAW,KAAK,MAAM,MAAM,OAAO,CAAC,CAAC;AAC5E;AASO,SAAS,yBACd,OACA,YACA,UACA,UAA6B,CAAC,GACtB;AACR,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,WAAW,kBAAkB,YAAY,UAAU,OAAO;AAChE,QAAM,WAAW,OAAO,UAAU,YAAY,UAAU,KAAK,KAAK;AAClE,QAAM,OAAO,OAAO,UAAU,WAAW,IAAI,KAAK,KAAK,IAAI;AAC3D,MAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,EAAG,QAAO,OAAO,KAAK;AACrD,QAAM,OAAmC,WAAW,EAAE,GAAG,SAAS,SAAS,UAAU,MAAM,IAAI,SAAS;AACxG,MAAI;AACF,UAAM,OAAO,KAAK,mBAAmB,SAAS,QAAQ,IAAI;AAC1D,WAAO,SAAS,UAAU,YAAY,MAAM,MAAM,SAAS,QAAQ,QAAQ,IAAI,IAAI;AAAA,EACrF,QAAQ;AAEN,WAAO,KAAK,YAAY,EAAE,MAAM,GAAG,EAAE;AAAA,EACvC;AACF;AAIO,SAAS,iBAAiB,YAAkC,UAAsC;AACvG,SAAO,yBAAyB,cAAc,YAAY,QAAQ;AACpE;AASO,SAAS,iBAAiB,YAAkC,UAAgD;AACjH,SAAO,CAAC,KAAK,EAAE,MAAM,SAAS,OAAO,MACnC,SAAS,QAAQ,yBAAyB,KAAK,YAAY,UAAU,UAAU,EAAE,QAAQ,CAAC,IAAI;AAClG;","names":[]}
+{"version":3,"sources":["../../src/lib/date-format.ts"],"sourcesContent":["import { formatLocaleOf } from \"../i18n/languages\";\nimport type { KitDateFormatter } from \"../i18n/kit-labels\";\nimport { pad, toLocalIso } from \"./dates\";\nimport { dateFormatter } from \"./intl-cache\";\nimport { isBareIsoDay } from \"./iso-day\";\n\n/**\n * The date-format preference (0.46, lifted from keksdose's `date-format-store.ts`,\n * feedback #180): how a DAY is written — the order of day, month and year and the\n * separator between them — as a choice of its own, apart from the interface language.\n * \"Read the app in English and still see German dates\", or ISO everywhere.\n *\n * keksdose's rules, which the kit keeps:\n *\n * 1. **A label that identifies a day follows the preference** — anything that prints\n *    day, month and year goes through {@link formatDateWithPreference} (or the\n *    provider's `formatDate`, {@link dateFormatterFor}, for the kit's own date fields).\n * 2. **A label without a day follows the language**: \"August 2026\", a month or weekday\n *    NAME has no order to arrange. {@link dateFormatterFor} answers `\"\"` for a month or a\n *    year, so the kit keeps its own rendering in the language.\n * 3. **A clock time follows the language**: `sv-SE` is a statement about digit order in\n *    a date, not about a 12- or 24-hour clock.\n * 4. **A weekday's NAME follows the language** (dev#546): `sv-SE` means \"year first,\n *    with dashes\", not \"the reader speaks Swedish\" — so with `weekday` the day's name is\n *    the language's, joined to the date the preference renders.\n *\n * The preference is the APP's to keep — keksdose holds it per device (a persisted store,\n * not an account column: nothing server-written formats a date for the reader). The kit\n * owns the vocabulary, the resolver, the renderer and the settings field\n * ({@link DateFormatSetting}).\n */\n\n/** `\"auto\"` follows the interface language (the default — nobody's dates move until\n *  they ask); the rest are BCP 47 tags chosen for the SHAPE they produce: German\n *  01.08.2026, British 01/08/2026, US 08/01/2026, ISO 2026-08-01. */\nexport type DateFormatPreference = \"auto\" | \"de-DE\" | \"en-GB\" | \"en-US\" | \"sv-SE\";\n\n/** The options in the order the setting lists them: `auto` first (the default), then\n *  German → UK → US → ISO. */\nexport const DATE_FORMAT_PREFERENCES: readonly DateFormatPreference[] = [\"auto\", \"de-DE\", \"en-GB\", \"en-US\", \"sv-SE\"];\n\n/** Whether `value` is one of {@link DATE_FORMAT_PREFERENCES} — for a value read back from\n *  storage, where anything else falls back to `\"auto\"`. */\nexport function isDateFormatPreference(value: unknown): value is DateFormatPreference {\n  return typeof value === \"string\" && (DATE_FORMAT_PREFERENCES as readonly string[]).includes(value);\n}\n\n/** A resolved preference: the locale and `Intl` options the date itself is rendered\n *  with, and — only when asked for — the locale the weekday's NAME comes from. */\nexport interface ResolvedDateFormat {\n  locale: string | undefined;\n  options: Intl.DateTimeFormatOptions;\n  /** The language's format locale, present when `weekday` was asked for. */\n  weekday?: { locale: string | undefined };\n}\n\n/** What {@link resolveDateFormat} and the renderers take beyond the preference. */\nexport interface DateFormatOptions {\n  /** Name the day of the week too, in the interface language (\"Mo., 01.08.2026\"). A date\n   *  in a COLUMN carries it; a date in a SENTENCE does not (keksdose dev#546). */\n  weekday?: boolean;\n  /**\n   * 0.52: the IANA zone a TIMESTAMP's day and clock are read in (\"Europe/Zurich\") — pass\n   * the `<UiKitProvider timeZone>` (`useKitTimeZone()`), so an app's own column says what\n   * the kit's components say for the same instant. Left out: the device's. A bare\n   * \"YYYY-MM-DD\" ignores it: a calendar day is the day it names in every zone. A zone\n   * `Intl` refuses reads as the device's. The renderers read it; {@link resolveDateFormat}\n   * does not.\n   */\n  timeZone?: string;\n}\n\n/**\n * What a date is rendered with, given the preference and the interface language\n * (`language`: a code or tag — `\"de\"`, `\"en\"`, i18next's `resolvedLanguage`; it is read\n * through `formatLocaleOf`, so English is British and an unshipped tag stays itself).\n *\n * `\"auto\"` keeps the short-month shape (\"01 Aug 2026\", \"01. Aug. 2026\"); every explicit\n * choice is all-numeric, the only way it produces the shape its option promises —\n * `month: \"short\"` under `sv-SE` would print \"2026 aug. 01\", not ISO.\n */\nexport function resolveDateFormat(\n  preference: DateFormatPreference,\n  language: string | undefined,\n  options: DateFormatOptions = {},\n): ResolvedDateFormat {\n  const languageLocale = language ? formatLocaleOf(language) : undefined;\n  const weekday = options.weekday ? { weekday: { locale: languageLocale } } : {};\n  if (preference === \"auto\") {\n    return { locale: languageLocale, options: { year: \"numeric\", month: \"short\", day: \"2-digit\" }, ...weekday };\n  }\n  return { locale: preference, options: { year: \"numeric\", month: \"2-digit\", day: \"2-digit\" }, ...weekday };\n}\n\n/**\n * `dateText`, already rendered under the preference, with the day's NAME around it in\n * `locale` (the language's). Not \"weekday alone + comma\": German says \"So\" alone and\n * \"So., 06.09.2026\" in company. The full date is formatted in the language and split\n * into parts; what that language puts before the first and after the last day/month/\n * year part (the weekday, its comma) frames the preference's digits — so where the two\n * locales coincide the output is the native string, character for character.\n */\nfunction withWeekday(date: Date, dateText: string, locale: string | undefined, options: Intl.DateTimeFormatOptions) {\n  const isDatePart = (p: Intl.DateTimeFormatPart) => p.type === \"day\" || p.type === \"month\" || p.type === \"year\";\n  const parts = dateFormatter(locale, { weekday: \"short\", ...options }).formatToParts(date);\n  const first = parts.findIndex(isDatePart);\n  if (first === -1) return dateText;\n  let last = first;\n  parts.forEach((p, i) => {\n    if (isDatePart(p)) last = i;\n  });\n  const join = (ps: Intl.DateTimeFormatPart[]) => ps.map((p) => p.value).join(\"\");\n  return join(parts.slice(0, first)) + dateText + join(parts.slice(last + 1));\n}\n\n/**\n * A date under the preference: `\"\"` for no value, the input itself when it does not\n * parse. A bare \"YYYY-MM-DD\" is the calendar day it names in every zone (formatted in\n * UTC, undoing `new Date`'s UTC-midnight parse — west of Greenwich it read a day early);\n * a timestamp is an instant, read in `options.timeZone`, else the reader's zone. The\n * weekday, when asked for, is rendered in the same zone, so a Sunday is never captioned\n * Saturday.\n */\nexport function formatDateWithPreference(\n  value: string | Date | null | undefined,\n  preference: DateFormatPreference,\n  language: string | undefined,\n  options: DateFormatOptions = {},\n): string {\n  if (!value) return \"\";\n  const resolved = resolveDateFormat(preference, language, options);\n  const dateOnly = isBareIsoDay(value);\n  const date = typeof value === \"string\" ? new Date(value) : value;\n  if (Number.isNaN(date.getTime())) return String(value);\n  const render = (timeZone: string | undefined) => {\n    const intl: Intl.DateTimeFormatOptions = timeZone ? { ...resolved.options, timeZone } : resolved.options;\n    // Through the shared cache (refactor audit 2026-10-30, DUP-2): a `toLocaleDateString`\n    // builds a formatter per call, which is why keksdose kept its own copy of this\n    // renderer — 392 ms per click on a 270-row register (dev#632).\n    const text = dateFormatter(resolved.locale, intl).format(date);\n    return resolved.weekday ? withWeekday(date, text, resolved.weekday.locale, intl) : text;\n  };\n  if (dateOnly) return firstAccepted([() => render(\"UTC\")], () => value);\n  // A zone `Intl` refuses: the reader's own day, as `clockTime` reads the reader's own\n  // clock — never the UTC day `toISOString` gave, a day off around midnight (0.52 code\n  // review, this file).\n  return firstAccepted([() => render(options.timeZone), () => render(undefined)], () => toLocalIso(date));\n}\n\n/** The first of `renders` that `Intl` accepts — a language tag or a zone it refuses\n *  throws — else `last()`: the ISO day or the clock rather than nothing (keksdose's\n *  fallback). */\nfunction firstAccepted(renders: readonly (() => string)[], last: () => string): string {\n  for (const render of renders) {\n    try {\n      return render();\n    } catch {\n      // Refused: the next.\n    }\n  }\n  return last();\n}\n\n/**\n * The clock time of `date` as the language writes it (\"14:05\"), two digits each: rule 3,\n * a clock follows the language, never the preference — `sv-SE` is a statement about the\n * order of a date's digits, not about a 12- or 24-hour clock. `language` is read through\n * `formatLocaleOf`, so English is the British 24-hour clock, not \"02:05 PM\" in a\n * German household's app. In `timeZone` when given, else the reader's.\n *\n * @internal Shared with the kit's own day formatter; not part of the barrel.\n */\nexport function clockTime(date: Date, language: string | undefined, timeZone?: string): string {\n  const locale = language ? formatLocaleOf(language) : undefined;\n  const clock = (zone: string | undefined) =>\n    dateFormatter(locale, { hour: \"2-digit\", minute: \"2-digit\", ...(zone ? { timeZone: zone } : null) }).format(date);\n  // A zone `Intl` refuses: the reader's own clock, as `isoDayIn` reads the reader's own\n  // day — the UTC clock `toISOString` gave printed 13:05 for 14:05 in Zurich, an hour or\n  // more off with no error (0.52 code review, this file).\n  const reader = () => `${pad(date.getHours())}:${pad(date.getMinutes())}`;\n  return firstAccepted([() => clock(timeZone), () => clock(undefined)], reader);\n}\n\n/**\n * A timestamp under the preference (0.52, keksdose's `formatDateTimeFor`, refactor audit\n * 2026-10-30, DUP-2): the date as {@link formatDateWithPreference} writes it, weekday\n * when asked for, then the clock time in the LANGUAGE ({@link clockTime}): \"01.08.2026,\n * 14:05\", \"Sa., 01.08.2026, 14:05\". keksdose's notification inbox and admin scheduler\n * were where an explicit ISO choice did nothing until it wrote this. `\"\"` for no value,\n * the input itself when it does not parse; a bare \"YYYY-MM-DD\" names no moment, so it\n * prints as the date alone.\n *\n * Day and clock in `options.timeZone` — pass the provider's (`useKitTimeZone()`): without\n * it they were the device's, and an app on Zurich time read from New York printed 09:05\n * in its own column where the kit's inbox printed 14:05 for the same instant (0.52 code\n * review, this file).\n */\nexport function formatDateTimeWithPreference(\n  value: string | Date | null | undefined,\n  preference: DateFormatPreference,\n  language: string | undefined,\n  options: DateFormatOptions = {},\n): string {\n  if (!value) return \"\";\n  if (isBareIsoDay(value)) return formatDateWithPreference(value, preference, language, options);\n  const date = typeof value === \"string\" ? new Date(value) : value;\n  if (Number.isNaN(date.getTime())) return String(value);\n  return `${formatDateWithPreference(date, preference, language, options)}, ${clockTime(date, language, options.timeZone)}`;\n}\n\n/** The sample an option is labelled with — 1 August 2026 in its shape, the shape being\n *  the whole choice (a country name would say nothing about the digit order). */\nexport function dateFormatSample(preference: DateFormatPreference, language: string | undefined): string {\n  return formatDateWithPreference(\"2026-08-01\", preference, language);\n}\n\n/**\n * The `<UiKitProvider formatDate>` for a preference — so the kit's own date fields\n * (DatePicker, DateRangePicker, DateMark) write a day as the app's dates do. A day\n * follows the preference, with the weekday where the kit suggests it; a month or a year\n * answers `\"\"` and keeps the kit's rendering in the language (rule 2). Rebuild it when\n * the preference or the language changes (a `useMemo` on both).\n */\nexport function dateFormatterFor(preference: DateFormatPreference, language: string | undefined): KitDateFormatter {\n  return (iso, { unit, weekday, locale }) =>\n    unit === \"day\" ? formatDateWithPreference(iso, preference, locale ?? language, { weekday }) : \"\";\n}\n"],"mappings":";AAAA,SAAS,sBAAsB;AAE/B,SAAS,KAAK,kBAAkB;AAChC,SAAS,qBAAqB;AAC9B,SAAS,oBAAoB;AAmCtB,MAAM,0BAA2D,CAAC,QAAQ,SAAS,SAAS,SAAS,OAAO;AAI5G,SAAS,uBAAuB,OAA+C;AACpF,SAAO,OAAO,UAAU,YAAa,wBAA8C,SAAS,KAAK;AACnG;AAoCO,SAAS,kBACd,YACA,UACA,UAA6B,CAAC,GACV;AACpB,QAAM,iBAAiB,WAAW,eAAe,QAAQ,IAAI;AAC7D,QAAM,UAAU,QAAQ,UAAU,EAAE,SAAS,EAAE,QAAQ,eAAe,EAAE,IAAI,CAAC;AAC7E,MAAI,eAAe,QAAQ;AACzB,WAAO,EAAE,QAAQ,gBAAgB,SAAS,EAAE,MAAM,WAAW,OAAO,SAAS,KAAK,UAAU,GAAG,GAAG,QAAQ;AAAA,EAC5G;AACA,SAAO,EAAE,QAAQ,YAAY,SAAS,EAAE,MAAM,WAAW,OAAO,WAAW,KAAK,UAAU,GAAG,GAAG,QAAQ;AAC1G;AAUA,SAAS,YAAY,MAAY,UAAkB,QAA4B,SAAqC;AAClH,QAAM,aAAa,CAAC,MAA+B,EAAE,SAAS,SAAS,EAAE,SAAS,WAAW,EAAE,SAAS;AACxG,QAAM,QAAQ,cAAc,QAAQ,EAAE,SAAS,SAAS,GAAG,QAAQ,CAAC,EAAE,cAAc,IAAI;AACxF,QAAM,QAAQ,MAAM,UAAU,UAAU;AACxC,MAAI,UAAU,GAAI,QAAO;AACzB,MAAI,OAAO;AACX,QAAM,QAAQ,CAAC,GAAG,MAAM;AACtB,QAAI,WAAW,CAAC,EAAG,QAAO;AAAA,EAC5B,CAAC;AACD,QAAM,OAAO,CAAC,OAAkC,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE;AAC9E,SAAO,KAAK,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,WAAW,KAAK,MAAM,MAAM,OAAO,CAAC,CAAC;AAC5E;AAUO,SAAS,yBACd,OACA,YACA,UACA,UAA6B,CAAC,GACtB;AACR,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,WAAW,kBAAkB,YAAY,UAAU,OAAO;AAChE,QAAM,WAAW,aAAa,KAAK;AACnC,QAAM,OAAO,OAAO,UAAU,WAAW,IAAI,KAAK,KAAK,IAAI;AAC3D,MAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,EAAG,QAAO,OAAO,KAAK;AACrD,QAAM,SAAS,CAAC,aAAiC;AAC/C,UAAM,OAAmC,WAAW,EAAE,GAAG,SAAS,SAAS,SAAS,IAAI,SAAS;AAIjG,UAAM,OAAO,cAAc,SAAS,QAAQ,IAAI,EAAE,OAAO,IAAI;AAC7D,WAAO,SAAS,UAAU,YAAY,MAAM,MAAM,SAAS,QAAQ,QAAQ,IAAI,IAAI;AAAA,EACrF;AACA,MAAI,SAAU,QAAO,cAAc,CAAC,MAAM,OAAO,KAAK,CAAC,GAAG,MAAM,KAAK;AAIrE,SAAO,cAAc,CAAC,MAAM,OAAO,QAAQ,QAAQ,GAAG,MAAM,OAAO,MAAS,CAAC,GAAG,MAAM,WAAW,IAAI,CAAC;AACxG;AAKA,SAAS,cAAc,SAAoC,MAA4B;AACrF,aAAW,UAAU,SAAS;AAC5B,QAAI;AACF,aAAO,OAAO;AAAA,IAChB,QAAQ;AAAA,IAER;AAAA,EACF;AACA,SAAO,KAAK;AACd;AAWO,SAAS,UAAU,MAAY,UAA8B,UAA2B;AAC7F,QAAM,SAAS,WAAW,eAAe,QAAQ,IAAI;AACrD,QAAM,QAAQ,CAAC,SACb,cAAc,QAAQ,EAAE,MAAM,WAAW,QAAQ,WAAW,GAAI,OAAO,EAAE,UAAU,KAAK,IAAI,KAAM,CAAC,EAAE,OAAO,IAAI;AAIlH,QAAM,SAAS,MAAM,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,IAAI,IAAI,KAAK,WAAW,CAAC,CAAC;AACtE,SAAO,cAAc,CAAC,MAAM,MAAM,QAAQ,GAAG,MAAM,MAAM,MAAS,CAAC,GAAG,MAAM;AAC9E;AAgBO,SAAS,6BACd,OACA,YACA,UACA,UAA6B,CAAC,GACtB;AACR,MAAI,CAAC,MAAO,QAAO;AACnB,MAAI,aAAa,KAAK,EAAG,QAAO,yBAAyB,OAAO,YAAY,UAAU,OAAO;AAC7F,QAAM,OAAO,OAAO,UAAU,WAAW,IAAI,KAAK,KAAK,IAAI;AAC3D,MAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,EAAG,QAAO,OAAO,KAAK;AACrD,SAAO,GAAG,yBAAyB,MAAM,YAAY,UAAU,OAAO,CAAC,KAAK,UAAU,MAAM,UAAU,QAAQ,QAAQ,CAAC;AACzH;AAIO,SAAS,iBAAiB,YAAkC,UAAsC;AACvG,SAAO,yBAAyB,cAAc,YAAY,QAAQ;AACpE;AASO,SAAS,iBAAiB,YAAkC,UAAgD;AACjH,SAAO,CAAC,KAAK,EAAE,MAAM,SAAS,OAAO,MACnC,SAAS,QAAQ,yBAAyB,KAAK,YAAY,UAAU,UAAU,EAAE,QAAQ,CAAC,IAAI;AAClG;","names":[]}

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

@@ -0,0 +1,46 @@
+import { type DateInput, type FormatDateStyle } from "./format.js";
+/**
+ * How a kit component prints a day — ONE ladder (refactor audit 2026-10-30, DUP-2):
+ *
+ *  1. the component's own prop (`formatDate`, `renderDate`), when the app gave one and it
+ *     answers;
+ *  2. else the `<UiKitProvider formatDate>` (keksdose K12: the app's date-format
+ *     preference), asked for the calendar day with `source: "dateMark"`;
+ *  3. else the kit's `formatDate` in the provider's locale AND `timeZone` (0.46).
+ *
+ * 0.46's rule — "a label that identifies a day follows the preference" — held only where
+ * a component wrote that ladder itself: four copies (admin's `useDayText`, AccountStateChip,
+ * DateMark, the feedback table), while about twelve components took their own prop or
+ * nothing and went straight to `lib/format`. keksdose set the provider's `formatDate` and
+ * still passed it into six components by hand; and the 10 that imported the raw
+ * `formatDate` ignored the provider's `timeZone`.
+ *
+ * @internal Not part of the barrel: the components' props are the public way in.
+ */
+/** What a {@link DayFormatter} call may ask for. */
+export interface DayTextOptions {
+    /**
+     * Name the day of the week — what the provider's formatter is told (its `weekday`).
+     * keksdose's rule: a date in a COLUMN carries it, a date in a SENTENCE does not
+     * (dev#546). Default `false`. The kit's own rendering follows `style`, not this.
+     */
+    weekday?: boolean;
+    /** Add the clock time, in the language (date-format rule 3): a timestamp. Default false. */
+    time?: boolean;
+    /** The kit's own rendering (step 3). Default `"medium"`, `"dateTime"` with `time`. */
+    style?: FormatDateStyle | Intl.DateTimeFormatOptions;
+    /** `false`: skip the provider (step 2) — a component's explicit style wins over it,
+     *  as `DateMark`'s `dateStyle` does. Default `true`. */
+    preference?: boolean;
+    /** Printed for no value. Default "—". */
+    empty?: string;
+}
+/** A component's day printer: a value in, its text out. */
+export type DayFormatter<V extends DateInput = DateInput> = (value: V, options?: DayTextOptions) => string;
+/**
+ * The component's day printer, bound to its `prop`, the provider's `formatDate`, locale
+ * and `timeZone`. `prop` is called with the value as the component passed it, and wins
+ * whenever it answers non-empty. A value that does not parse is printed as it came
+ * (a bug upstream is better seen than hidden behind a dash).
+ */
+export declare function useDayFormatter<V extends DateInput = DateInput>(prop?: ((value: V) => string) | null, localeProp?: string): DayFormatter<V>;

package/dist/lib/day-format.js

@@ -0,0 +1,46 @@
+"use client";
+import { useCallback } from "react";
+import { useKitDateFormatter, useKitLocale, useKitTimeZone } from "../i18n/kit-labels.js";
+import { toLocalIso } from "./dates.js";
+import { clockTime } from "./date-format.js";
+import { EMPTY_FORMATTED_VALUE, formatDate, toDate } from "./format.js";
+import { dateFormatter } from "./intl-cache.js";
+import { isBareIsoDay } from "./iso-day.js";
+function isoDayIn(date, timeZone) {
+  if (!timeZone) return toLocalIso(date);
+  try {
+    const parts = dateFormatter("en-CA", { timeZone, year: "numeric", month: "2-digit", day: "2-digit" }).formatToParts(
+      date
+    );
+    const part = (type) => parts.find((p) => p.type === type)?.value ?? "";
+    return `${part("year")}-${part("month")}-${part("day")}`;
+  } catch {
+    return toLocalIso(date);
+  }
+}
+function useDayFormatter(prop, localeProp) {
+  const locale = useKitLocale(localeProp);
+  const timeZone = useKitTimeZone();
+  const fromProvider = useKitDateFormatter();
+  return useCallback(
+    (value, options = {}) => {
+      const own = prop?.(value);
+      if (own) return own;
+      if (value === null || value === void 0 || value === "") return options.empty ?? EMPTY_FORMATTED_VALUE;
+      const date = toDate(value);
+      if (!date) return String(value);
+      const bareDay = isBareIsoDay(value);
+      if (fromProvider && options.preference !== false) {
+        const iso = bareDay ? value : isoDayIn(date, timeZone);
+        const day = fromProvider(iso, { unit: "day", source: "dateMark", locale, weekday: options.weekday ?? false });
+        if (day) return options.time && !bareDay ? `${day}, ${clockTime(date, locale, timeZone)}` : day;
+      }
+      return formatDate(value, options.style ?? (options.time ? "dateTime" : "medium"), { locale, timeZone });
+    },
+    [prop, fromProvider, locale, timeZone]
+  );
+}
+export {
+  useDayFormatter
+};
+//# sourceMappingURL=day-format.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/day-format.ts"],"sourcesContent":["import { useCallback } from \"react\";\nimport { useKitDateFormatter, useKitLocale, useKitTimeZone } from \"../i18n/kit-labels\";\nimport { toLocalIso } from \"./dates\";\nimport { clockTime } from \"./date-format\";\nimport { EMPTY_FORMATTED_VALUE, formatDate, toDate, type DateInput, type FormatDateStyle } from \"./format\";\nimport { dateFormatter } from \"./intl-cache\";\nimport { isBareIsoDay } from \"./iso-day\";\n\n/**\n * How a kit component prints a day — ONE ladder (refactor audit 2026-10-30, DUP-2):\n *\n *  1. the component's own prop (`formatDate`, `renderDate`), when the app gave one and it\n *     answers;\n *  2. else the `<UiKitProvider formatDate>` (keksdose K12: the app's date-format\n *     preference), asked for the calendar day with `source: \"dateMark\"`;\n *  3. else the kit's `formatDate` in the provider's locale AND `timeZone` (0.46).\n *\n * 0.46's rule — \"a label that identifies a day follows the preference\" — held only where\n * a component wrote that ladder itself: four copies (admin's `useDayText`, AccountStateChip,\n * DateMark, the feedback table), while about twelve components took their own prop or\n * nothing and went straight to `lib/format`. keksdose set the provider's `formatDate` and\n * still passed it into six components by hand; and the 10 that imported the raw\n * `formatDate` ignored the provider's `timeZone`.\n *\n * @internal Not part of the barrel: the components' props are the public way in.\n */\n\n/** What a {@link DayFormatter} call may ask for. */\nexport interface DayTextOptions {\n  /**\n   * Name the day of the week — what the provider's formatter is told (its `weekday`).\n   * keksdose's rule: a date in a COLUMN carries it, a date in a SENTENCE does not\n   * (dev#546). Default `false`. The kit's own rendering follows `style`, not this.\n   */\n  weekday?: boolean;\n  /** Add the clock time, in the language (date-format rule 3): a timestamp. Default false. */\n  time?: boolean;\n  /** The kit's own rendering (step 3). Default `\"medium\"`, `\"dateTime\"` with `time`. */\n  style?: FormatDateStyle | Intl.DateTimeFormatOptions;\n  /** `false`: skip the provider (step 2) — a component's explicit style wins over it,\n   *  as `DateMark`'s `dateStyle` does. Default `true`. */\n  preference?: boolean;\n  /** Printed for no value. Default \"—\". */\n  empty?: string;\n}\n\n/** A component's day printer: a value in, its text out. */\nexport type DayFormatter<V extends DateInput = DateInput> = (value: V, options?: DayTextOptions) => string;\n\n/** The calendar day `date` falls on in `timeZone`, as \"YYYY-MM-DD\" — so the day the\n *  provider is asked for is the day the kit's own rendering would print. */\nfunction isoDayIn(date: Date, timeZone: string | undefined): string {\n  if (!timeZone) return toLocalIso(date);\n  try {\n    // `en-CA` writes YYYY-MM-DD with Latin digits.\n    const parts = dateFormatter(\"en-CA\", { timeZone, year: \"numeric\", month: \"2-digit\", day: \"2-digit\" }).formatToParts(\n      date,\n    );\n    const part = (type: Intl.DateTimeFormatPartTypes) => parts.find((p) => p.type === type)?.value ?? \"\";\n    return `${part(\"year\")}-${part(\"month\")}-${part(\"day\")}`;\n  } catch {\n    return toLocalIso(date);\n  }\n}\n\n/**\n * The component's day printer, bound to its `prop`, the provider's `formatDate`, locale\n * and `timeZone`. `prop` is called with the value as the component passed it, and wins\n * whenever it answers non-empty. A value that does not parse is printed as it came\n * (a bug upstream is better seen than hidden behind a dash).\n */\nexport function useDayFormatter<V extends DateInput = DateInput>(\n  prop?: ((value: V) => string) | null,\n  localeProp?: string,\n): DayFormatter<V> {\n  const locale = useKitLocale(localeProp);\n  const timeZone = useKitTimeZone();\n  const fromProvider = useKitDateFormatter();\n  return useCallback<DayFormatter<V>>(\n    (value, options = {}) => {\n      const own = prop?.(value);\n      if (own) return own;\n      if (value === null || value === undefined || value === \"\") return options.empty ?? EMPTY_FORMATTED_VALUE;\n      const date = toDate(value);\n      if (!date) return String(value);\n      const bareDay = isBareIsoDay(value);\n      if (fromProvider && options.preference !== false) {\n        const iso = bareDay ? value : isoDayIn(date, timeZone);\n        const day = fromProvider(iso, { unit: \"day\", source: \"dateMark\", locale, weekday: options.weekday ?? false });\n        if (day) return options.time && !bareDay ? `${day}, ${clockTime(date, locale, timeZone)}` : day;\n      }\n      return formatDate(value, options.style ?? (options.time ? \"dateTime\" : \"medium\"), { locale, timeZone });\n    },\n    [prop, fromProvider, locale, timeZone],\n  );\n}\n"],"mappings":";AAAA,SAAS,mBAAmB;AAC5B,SAAS,qBAAqB,cAAc,sBAAsB;AAClE,SAAS,kBAAkB;AAC3B,SAAS,iBAAiB;AAC1B,SAAS,uBAAuB,YAAY,cAAoD;AAChG,SAAS,qBAAqB;AAC9B,SAAS,oBAAoB;AA6C7B,SAAS,SAAS,MAAY,UAAsC;AAClE,MAAI,CAAC,SAAU,QAAO,WAAW,IAAI;AACrC,MAAI;AAEF,UAAM,QAAQ,cAAc,SAAS,EAAE,UAAU,MAAM,WAAW,OAAO,WAAW,KAAK,UAAU,CAAC,EAAE;AAAA,MACpG;AAAA,IACF;AACA,UAAM,OAAO,CAAC,SAAuC,MAAM,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI,GAAG,SAAS;AAClG,WAAO,GAAG,KAAK,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC;AAAA,EACxD,QAAQ;AACN,WAAO,WAAW,IAAI;AAAA,EACxB;AACF;AAQO,SAAS,gBACd,MACA,YACiB;AACjB,QAAM,SAAS,aAAa,UAAU;AACtC,QAAM,WAAW,eAAe;AAChC,QAAM,eAAe,oBAAoB;AACzC,SAAO;AAAA,IACL,CAAC,OAAO,UAAU,CAAC,MAAM;AACvB,YAAM,MAAM,OAAO,KAAK;AACxB,UAAI,IAAK,QAAO;AAChB,UAAI,UAAU,QAAQ,UAAU,UAAa,UAAU,GAAI,QAAO,QAAQ,SAAS;AACnF,YAAM,OAAO,OAAO,KAAK;AACzB,UAAI,CAAC,KAAM,QAAO,OAAO,KAAK;AAC9B,YAAM,UAAU,aAAa,KAAK;AAClC,UAAI,gBAAgB,QAAQ,eAAe,OAAO;AAChD,cAAM,MAAM,UAAU,QAAQ,SAAS,MAAM,QAAQ;AACrD,cAAM,MAAM,aAAa,KAAK,EAAE,MAAM,OAAO,QAAQ,YAAY,QAAQ,SAAS,QAAQ,WAAW,MAAM,CAAC;AAC5G,YAAI,IAAK,QAAO,QAAQ,QAAQ,CAAC,UAAU,GAAG,GAAG,KAAK,UAAU,MAAM,QAAQ,QAAQ,CAAC,KAAK;AAAA,MAC9F;AACA,aAAO,WAAW,OAAO,QAAQ,UAAU,QAAQ,OAAO,aAAa,WAAW,EAAE,QAAQ,SAAS,CAAC;AAAA,IACxG;AAAA,IACA,CAAC,MAAM,cAAc,QAAQ,QAAQ;AAAA,EACvC;AACF;","names":[]}

package/dist/lib/describe-failure.d.ts

@@ -0,0 +1,14 @@
+import type { ReactNode } from "react";
+/**
+ * The failure ladder, once: the app's words for a failure when it has any, else the
+ * kit's `fallback`.
+ *
+ * "Any" is {@link hasContent}, so an app's `describeError` answering `""` (nothing to say
+ * about this one) gets the kit's sentence. Written as `own ?? fallback` in the auth forms,
+ * where `""` printed an empty alert, and both ways within one file in the reviewer scope
+ * editor; it lived in the notification cards' parts only (refactor audit 2026-10-30,
+ * DUP-14).
+ *
+ * @internal Package-private — not re-exported from the barrel.
+ */
+export declare function describeFailure(own: ReactNode | undefined, fallback: ReactNode): ReactNode;

package/dist/lib/describe-failure.js

@@ -0,0 +1,9 @@
+"use client";
+import { hasContent } from "./presence.js";
+function describeFailure(own, fallback) {
+  return hasContent(own) ? own : fallback;
+}
+export {
+  describeFailure
+};
+//# sourceMappingURL=describe-failure.js.map

package/dist/lib/describe-failure.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/describe-failure.ts"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { hasContent } from \"./presence\";\n\n/**\n * The failure ladder, once: the app's words for a failure when it has any, else the\n * kit's `fallback`.\n *\n * \"Any\" is {@link hasContent}, so an app's `describeError` answering `\"\"` (nothing to say\n * about this one) gets the kit's sentence. Written as `own ?? fallback` in the auth forms,\n * where `\"\"` printed an empty alert, and both ways within one file in the reviewer scope\n * editor; it lived in the notification cards' parts only (refactor audit 2026-10-30,\n * DUP-14).\n *\n * @internal Package-private — not re-exported from the barrel.\n */\nexport function describeFailure(own: ReactNode | undefined, fallback: ReactNode): ReactNode {\n  return hasContent(own) ? own : fallback;\n}\n"],"mappings":";AACA,SAAS,kBAAkB;AAcpB,SAAS,gBAAgB,KAA4B,UAAgC;AAC1F,SAAO,WAAW,GAAG,IAAI,MAAM;AACjC;","names":[]}

package/dist/lib/direction.d.ts

@@ -20,3 +20,19 @@ export declare function isRtl(el: Element | null | undefined): boolean;
  * any other key. ArrowRight is forward in LTR and backward in RTL.
  */
 export declare function horizontalStep(key: string, el: Element | null | undefined): 1 | -1 | 0;
+/**
+ * Where a key moves the focus in a list with ONE tab stop (a roving tabindex): the index
+ * to focus from `at` among `count` items, or `undefined` for a key that moves nothing.
+ * ←/→ along `dir` — → is next in `ltr` and previous in `rtl` — ↓/↑ as next and previous,
+ * Home and End to the ends. With `wrap`, past the last is the first and before the first
+ * the last (a ring: PieChart's slices); without, the ends hold (a plane: Treemap's tiles).
+ *
+ * The charts each mapped the keys themselves, and differently at the ends (0.52 code
+ * review of treemap.tsx, finding 9); the end rule is now a word at the call.
+ *
+ * `dir` and not an element to read it off (0.52 code review, deep, charts, findings 1 and
+ * 14): a list in the page's flow takes the page's (`dirOf(el)`), but a plot is laid out
+ * left to right in any page (see `ChartContainer`) and passes `"ltr"` — read off the
+ * element, Treemap's → walked an RTL page's tiles backwards, against the picture.
+ */
+export declare function rovingTarget(key: string, dir: Direction, at: number, count: number, wrap: boolean): number | undefined;

package/dist/lib/direction.js

@@ -11,9 +11,17 @@ function horizontalStep(key, el) {
   const forward = key === "ArrowRight" !== isRtl(el);
   return forward ? 1 : -1;
 }
+function rovingTarget(key, dir, at, count, wrap) {
+  const physical = key === "ArrowRight" ? 1 : key === "ArrowLeft" ? -1 : 0;
+  const step = dir === "rtl" ? -physical : physical;
+  const to = step ? at + step : key === "ArrowDown" ? at + 1 : key === "ArrowUp" ? at - 1 : key === "Home" ? 0 : key === "End" ? count - 1 : void 0;
+  if (to === void 0 || count <= 0) return void 0;
+  return wrap ? (to % count + count) % count : Math.max(0, Math.min(count - 1, to));
+}
 export {
   dirOf,
   horizontalStep,
-  isRtl
+  isRtl,
+  rovingTarget
 };
 //# sourceMappingURL=direction.js.map

package/dist/lib/direction.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/direction.ts"],"sourcesContent":["/**\n * Reading direction, as the DOM has it — internal, not exported from the barrel.\n *\n * The kit lays itself out with logical classes (`ps-*`, `end-*`, `text-start`), which\n * need no JavaScript. These helpers are for the two things CSS cannot do:\n *\n * - **Arrow keys.** ←/→ mean previous/next in LTR and the reverse in RTL. Resolve the\n *   key through {@link horizontalStep} instead of comparing to \"ArrowRight\".\n * - **Portals.** A panel portalled to `document.body` leaves the subtree whose `dir`\n *   it inherited. Read the anchor's direction with {@link dirOf} and put it on the\n *   portalled root, and position it from the anchor's START edge, not `rect.left`.\n */\n\nexport type Direction = \"ltr\" | \"rtl\";\n\n/** The effective direction at `el`: its nearest `[dir]` ancestor (or itself), else the\n *  document's, else LTR. Attribute-based on purpose — jsdom computes no `direction`. */\nexport function dirOf(el: Element | null | undefined): Direction {\n  const source = el?.closest(\"[dir]\") ?? (typeof document !== \"undefined\" ? document.documentElement : null);\n  return source?.getAttribute(\"dir\") === \"rtl\" ? \"rtl\" : \"ltr\";\n}\n\nexport function isRtl(el: Element | null | undefined): boolean {\n  return dirOf(el) === \"rtl\";\n}\n\n/**\n * +1 for a key that moves FORWARD along the reading direction, -1 for backward, 0 for\n * any other key. ArrowRight is forward in LTR and backward in RTL.\n */\nexport function horizontalStep(key: string, el: Element | null | undefined): 1 | -1 | 0 {\n  if (key !== \"ArrowRight\" && key !== \"ArrowLeft\") return 0;\n  const forward = (key === \"ArrowRight\") !== isRtl(el);\n  return forward ? 1 : -1;\n}\n"],"mappings":";AAiBO,SAAS,MAAM,IAA2C;AAC/D,QAAM,SAAS,IAAI,QAAQ,OAAO,MAAM,OAAO,aAAa,cAAc,SAAS,kBAAkB;AACrG,SAAO,QAAQ,aAAa,KAAK,MAAM,QAAQ,QAAQ;AACzD;AAEO,SAAS,MAAM,IAAyC;AAC7D,SAAO,MAAM,EAAE,MAAM;AACvB;AAMO,SAAS,eAAe,KAAa,IAA4C;AACtF,MAAI,QAAQ,gBAAgB,QAAQ,YAAa,QAAO;AACxD,QAAM,UAAW,QAAQ,iBAAkB,MAAM,EAAE;AACnD,SAAO,UAAU,IAAI;AACvB;","names":[]}
+{"version":3,"sources":["../../src/lib/direction.ts"],"sourcesContent":["/**\n * Reading direction, as the DOM has it — internal, not exported from the barrel.\n *\n * The kit lays itself out with logical classes (`ps-*`, `end-*`, `text-start`), which\n * need no JavaScript. These helpers are for the two things CSS cannot do:\n *\n * - **Arrow keys.** ←/→ mean previous/next in LTR and the reverse in RTL. Resolve the\n *   key through {@link horizontalStep} instead of comparing to \"ArrowRight\".\n * - **Portals.** A panel portalled to `document.body` leaves the subtree whose `dir`\n *   it inherited. Read the anchor's direction with {@link dirOf} and put it on the\n *   portalled root, and position it from the anchor's START edge, not `rect.left`.\n */\n\nexport type Direction = \"ltr\" | \"rtl\";\n\n/** The effective direction at `el`: its nearest `[dir]` ancestor (or itself), else the\n *  document's, else LTR. Attribute-based on purpose — jsdom computes no `direction`. */\nexport function dirOf(el: Element | null | undefined): Direction {\n  const source = el?.closest(\"[dir]\") ?? (typeof document !== \"undefined\" ? document.documentElement : null);\n  return source?.getAttribute(\"dir\") === \"rtl\" ? \"rtl\" : \"ltr\";\n}\n\nexport function isRtl(el: Element | null | undefined): boolean {\n  return dirOf(el) === \"rtl\";\n}\n\n/**\n * +1 for a key that moves FORWARD along the reading direction, -1 for backward, 0 for\n * any other key. ArrowRight is forward in LTR and backward in RTL.\n */\nexport function horizontalStep(key: string, el: Element | null | undefined): 1 | -1 | 0 {\n  if (key !== \"ArrowRight\" && key !== \"ArrowLeft\") return 0;\n  const forward = (key === \"ArrowRight\") !== isRtl(el);\n  return forward ? 1 : -1;\n}\n\n/**\n * Where a key moves the focus in a list with ONE tab stop (a roving tabindex): the index\n * to focus from `at` among `count` items, or `undefined` for a key that moves nothing.\n * ←/→ along `dir` — → is next in `ltr` and previous in `rtl` — ↓/↑ as next and previous,\n * Home and End to the ends. With `wrap`, past the last is the first and before the first\n * the last (a ring: PieChart's slices); without, the ends hold (a plane: Treemap's tiles).\n *\n * The charts each mapped the keys themselves, and differently at the ends (0.52 code\n * review of treemap.tsx, finding 9); the end rule is now a word at the call.\n *\n * `dir` and not an element to read it off (0.52 code review, deep, charts, findings 1 and\n * 14): a list in the page's flow takes the page's (`dirOf(el)`), but a plot is laid out\n * left to right in any page (see `ChartContainer`) and passes `\"ltr\"` — read off the\n * element, Treemap's → walked an RTL page's tiles backwards, against the picture.\n */\nexport function rovingTarget(\n  key: string,\n  dir: Direction,\n  at: number,\n  count: number,\n  wrap: boolean,\n): number | undefined {\n  const physical = key === \"ArrowRight\" ? 1 : key === \"ArrowLeft\" ? -1 : 0;\n  const step = dir === \"rtl\" ? -physical : physical;\n  const to = step\n    ? at + step\n    : key === \"ArrowDown\"\n      ? at + 1\n      : key === \"ArrowUp\"\n        ? at - 1\n        : key === \"Home\"\n          ? 0\n          : key === \"End\"\n            ? count - 1\n            : undefined;\n  if (to === undefined || count <= 0) return undefined;\n  return wrap ? ((to % count) + count) % count : Math.max(0, Math.min(count - 1, to));\n}\n"],"mappings":";AAiBO,SAAS,MAAM,IAA2C;AAC/D,QAAM,SAAS,IAAI,QAAQ,OAAO,MAAM,OAAO,aAAa,cAAc,SAAS,kBAAkB;AACrG,SAAO,QAAQ,aAAa,KAAK,MAAM,QAAQ,QAAQ;AACzD;AAEO,SAAS,MAAM,IAAyC;AAC7D,SAAO,MAAM,EAAE,MAAM;AACvB;AAMO,SAAS,eAAe,KAAa,IAA4C;AACtF,MAAI,QAAQ,gBAAgB,QAAQ,YAAa,QAAO;AACxD,QAAM,UAAW,QAAQ,iBAAkB,MAAM,EAAE;AACnD,SAAO,UAAU,IAAI;AACvB;AAiBO,SAAS,aACd,KACA,KACA,IACA,OACA,MACoB;AACpB,QAAM,WAAW,QAAQ,eAAe,IAAI,QAAQ,cAAc,KAAK;AACvE,QAAM,OAAO,QAAQ,QAAQ,CAAC,WAAW;AACzC,QAAM,KAAK,OACP,KAAK,OACL,QAAQ,cACN,KAAK,IACL,QAAQ,YACN,KAAK,IACL,QAAQ,SACN,IACA,QAAQ,QACN,QAAQ,IACR;AACZ,MAAI,OAAO,UAAa,SAAS,EAAG,QAAO;AAC3C,SAAO,QAAS,KAAK,QAAS,SAAS,QAAQ,KAAK,IAAI,GAAG,KAAK,IAAI,QAAQ,GAAG,EAAE,CAAC;AACpF;","names":[]}

package/dist/lib/focus-left.d.ts

@@ -0,0 +1,63 @@
+export interface TabStopOptions {
+    /** Whether `el` itself counts, first, when it is a stop. Default true: the tour's
+     *  target may BE the field (refactor audit 2026-10-30, DUP-9). False for "a control
+     *  inside it" — a row, a drawer, a trap's container, a toolbar. */
+    includeSelf?: boolean;
+}
+/** The tab stops in `el`, in DOM order — `el` itself first when it is one, unless
+ *  `includeSelf: false`. */
+export declare function tabStops(el: Element, { includeSelf }?: TabStopOptions): HTMLElement[];
+/** The first of {@link tabStops} — the control a person types into or presses — or null. */
+export declare function firstTabStop(el: Element, options?: TabStopOptions): HTMLElement | null;
+/**
+ * Whether the focus has fallen out of the page: onto `<body>`, onto nothing, or onto a
+ * node no longer in the document. False on the server, where nothing has focus to lose.
+ * A recovery asks this first: focus that went somewhere real (a dialog, the next field,
+ * an app's own `focus()`) is the user's or the app's, and is left where it is.
+ */
+export declare function focusIsLost(): boolean;
+/**
+ * Calls `then` when a `blur`/`focusout` was the user's own move to nothing — a click on
+ * the page's background, or a click Safari answers by focusing nothing (it focuses no
+ * button or link on a click, and blurs what had the focus) — after which a note of where
+ * the focus was is stale (0.52 code review: DataTable's row, BulkActionBar's and
+ * AlertBanner's notes outlived it, and a removal much later pulled the focus, and the
+ * scroll, back to them).
+ *
+ * No element took the focus, the document holds none, and the node that lost it could
+ * still hold it. Not when it was removed, hidden, made inert or disabled: that is the page
+ * taking the focus away — the very case those notes are kept for. Not a window losing the
+ * focus either, which leaves the node the document's active element. Decided a microtask
+ * later, once the event's own work is done: a browser that blurs a node it is removing
+ * (or hiding) may do it while the node is still in place, and only after it is gone is
+ * that told apart from a click.
+ */
+export declare function whenFocusLeftForNothing(e: {
+    target: EventTarget | null;
+    relatedTarget: EventTarget | null;
+}, then: () => void): void;
+/**
+ * The tab stops around `frame`, outside it, nearest first on each side — where focus
+ * goes once `frame` is gone. Read BEFORE it goes: a removed node has no place in the
+ * document to measure from. `limit` per side keeps a long page's stops out of memory.
+ *
+ * Walked outwards from the frame, `limit` stops each way (0.52 code review,
+ * lib/focus-left.ts): read from every stop in the page, a banner under a 2000-row table
+ * read all 2000 to keep the nearest five before it.
+ */
+export declare function tabStopsAround(frame: Element, limit?: number): {
+    after: HTMLElement[];
+    before: HTMLElement[];
+};
+/**
+ * Focus the first of `candidates` that is still in the page and takes the focus; true
+ * when one did. Each is tried and checked, since `focus()` on a node that cannot hold it
+ * (detached, `display: none`, disabled since) fails without a word.
+ */
+export declare function focusFirst(candidates: Iterable<Element | null | undefined>): boolean;
+/**
+ * Focus a container that is not a tab stop of its own — a table, a list — as the place
+ * the user is in, without making it one: `tabindex="-1"` for as long as it holds the
+ * focus, unless it already carries a `tabindex` of its own.
+ */
+export declare function focusContainer(el: HTMLElement): void;

package/dist/lib/focus-left.js

@@ -0,0 +1,67 @@
+"use client";
+const TAB_STOP = 'a[href],button:not([disabled]),textarea:not([disabled]),input:not([disabled]):not([type="hidden"]),select:not([disabled]),[tabindex]:not([tabindex="-1"])';
+function isTabStop(el) {
+  return el.tabIndex >= 0 && !el.closest("[hidden],[inert]");
+}
+function tabStops(el, { includeSelf = true } = {}) {
+  const inside = Array.from(el.querySelectorAll(TAB_STOP)).filter(isTabStop);
+  const own = includeSelf && el instanceof HTMLElement && el.matches(TAB_STOP) && isTabStop(el);
+  return own ? [el, ...inside] : inside;
+}
+function firstTabStop(el, options) {
+  return tabStops(el, options)[0] ?? null;
+}
+function focusIsLost() {
+  if (typeof document === "undefined") return false;
+  const el = document.activeElement;
+  return !el || el === document.body || !el.isConnected;
+}
+function whenFocusLeftForNothing(e, then) {
+  const el = e.target;
+  if (e.relatedTarget !== null || !(el instanceof Element)) return;
+  queueMicrotask(() => {
+    if (!el.isConnected || el.matches(":disabled") || el.closest("[hidden],[inert]")) return;
+    if (typeof el.checkVisibility === "function" && !el.checkVisibility()) return;
+    if (focusIsLost()) then();
+  });
+}
+function tabStopsAround(frame, limit = 5) {
+  const doc = frame.ownerDocument;
+  const walker = doc.createTreeWalker(doc.documentElement, NodeFilter.SHOW_ELEMENT);
+  const isStop = (node2) => node2 instanceof HTMLElement && node2.matches(TAB_STOP) && isTabStop(node2);
+  const after = [];
+  walker.currentNode = frame;
+  let node = walker.nextSibling();
+  while (!node && walker.parentNode()) node = walker.nextSibling();
+  for (; node && after.length < limit; node = walker.nextNode()) if (isStop(node)) after.push(node);
+  const before = [];
+  walker.currentNode = frame;
+  for (node = walker.previousNode(); node && before.length < limit; node = walker.previousNode())
+    if (isStop(node)) before.push(node);
+  return { after, before };
+}
+function focusFirst(candidates) {
+  for (const el of candidates) {
+    if (!(el instanceof HTMLElement) || !el.isConnected) continue;
+    el.focus();
+    if (document.activeElement === el) return true;
+  }
+  return false;
+}
+function focusContainer(el) {
+  if (!el.hasAttribute("tabindex")) {
+    el.setAttribute("tabindex", "-1");
+    el.addEventListener("blur", () => el.removeAttribute("tabindex"), { once: true });
+  }
+  el.focus();
+}
+export {
+  firstTabStop,
+  focusContainer,
+  focusFirst,
+  focusIsLost,
+  tabStops,
+  tabStopsAround,
+  whenFocusLeftForNothing
+};
+//# sourceMappingURL=focus-left.js.map

package/dist/lib/focus-left.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/focus-left.ts"],"sourcesContent":["// \"The focused node left\" (refactor audit 2026-10-30, Wave 1: DSP-4, DSP-15). When the\n// element holding the keyboard's focus is removed — a table row deleted, filtered out or\n// approved; a bulk bar gone with its Clear; a banner its × took away — the browser puts\n// focus on <body> and says nothing: no blur in Chromium, none in jsdom. A keyboard or\n// screen-reader user then starts again from the top of the page. The overlays give focus\n// back to their opener (use-focus-trap); these helpers are for the controls that leave\n// the page while the focus is IN them, and decide where it goes instead.\n\n/**\n * Candidate tab stops, in DOM order — narrowed by {@link isTabStop} to the ones a Tab\n * really reaches. The kit's one copy of the rule (0.52 code review, lib/focus-left.ts):\n * this file and use-focus-trap each had it, with an exported `firstTabStop` apiece that\n * disagreed about the element itself, and a combobox panel's toolbar had a third\n * selector. The trap, the focus a removed node drops (below), the tour's field ring and\n * the toolbar all read it here, so \"the next stop\" is the same stop everywhere.\n *\n * The selector is the one `Modal` used. On its own it was not enough (round 0.34\n * BUG-4): only the bare `[tabindex]` clause excluded `-1`, so a `button`, an `input` or\n * a link taken out of the tab order still counted. A panel that ends in a roving grid —\n * the calendar's days, the month grid, the picker sheet's rows, every one of them `-1`\n * but the active cell — then had a \"last\" stop no Tab ever reaches: Tab from the real\n * last stop was not wrapped and walked out of the open panel, and Shift+Tab from the\n * first landed on a cell that is not a stop at all.\n */\n// `input[type=hidden]` is no stop: a Tab never lands on it and focus() on it does nothing,\n// but its tabIndex reads 0, so a trap could take a form's hidden field for its first or last\n// stop and Shift+Tab left the dialog (0.52 code review).\nconst TAB_STOP =\n  'a[href],button:not([disabled]),textarea:not([disabled]),input:not([disabled]):not([type=\"hidden\"]),select:not([disabled]),[tabindex]:not([tabindex=\"-1\"])';\n\n/**\n * A stop the browser's own Tab would land on: in the tab order (`tabIndex` ≥ 0) and not\n * inside something `hidden` or `inert`. Removes only elements a native Tab never\n * reaches, so no correct order changes. `visibility: hidden` and closed `<details>` are\n * still not walked — they need layout, which this rule has never read.\n */\nfunction isTabStop(el: HTMLElement): boolean {\n  return el.tabIndex >= 0 && !el.closest(\"[hidden],[inert]\");\n}\n\nexport interface TabStopOptions {\n  /** Whether `el` itself counts, first, when it is a stop. Default true: the tour's\n   *  target may BE the field (refactor audit 2026-10-30, DUP-9). False for \"a control\n   *  inside it\" — a row, a drawer, a trap's container, a toolbar. */\n  includeSelf?: boolean;\n}\n\n/** The tab stops in `el`, in DOM order — `el` itself first when it is one, unless\n *  `includeSelf: false`. */\nexport function tabStops(el: Element, { includeSelf = true }: TabStopOptions = {}): HTMLElement[] {\n  const inside = Array.from(el.querySelectorAll<HTMLElement>(TAB_STOP)).filter(isTabStop);\n  const own = includeSelf && el instanceof HTMLElement && el.matches(TAB_STOP) && isTabStop(el);\n  return own ? [el, ...inside] : inside;\n}\n\n/** The first of {@link tabStops} — the control a person types into or presses — or null. */\nexport function firstTabStop(el: Element, options?: TabStopOptions): HTMLElement | null {\n  return tabStops(el, options)[0] ?? null;\n}\n\n/**\n * Whether the focus has fallen out of the page: onto `<body>`, onto nothing, or onto a\n * node no longer in the document. False on the server, where nothing has focus to lose.\n * A recovery asks this first: focus that went somewhere real (a dialog, the next field,\n * an app's own `focus()`) is the user's or the app's, and is left where it is.\n */\nexport function focusIsLost(): boolean {\n  if (typeof document === \"undefined\") return false;\n  const el = document.activeElement;\n  return !el || el === document.body || !el.isConnected;\n}\n\n/**\n * Calls `then` when a `blur`/`focusout` was the user's own move to nothing — a click on\n * the page's background, or a click Safari answers by focusing nothing (it focuses no\n * button or link on a click, and blurs what had the focus) — after which a note of where\n * the focus was is stale (0.52 code review: DataTable's row, BulkActionBar's and\n * AlertBanner's notes outlived it, and a removal much later pulled the focus, and the\n * scroll, back to them).\n *\n * No element took the focus, the document holds none, and the node that lost it could\n * still hold it. Not when it was removed, hidden, made inert or disabled: that is the page\n * taking the focus away — the very case those notes are kept for. Not a window losing the\n * focus either, which leaves the node the document's active element. Decided a microtask\n * later, once the event's own work is done: a browser that blurs a node it is removing\n * (or hiding) may do it while the node is still in place, and only after it is gone is\n * that told apart from a click.\n */\nexport function whenFocusLeftForNothing(\n  e: { target: EventTarget | null; relatedTarget: EventTarget | null },\n  then: () => void,\n): void {\n  const el = e.target;\n  if (e.relatedTarget !== null || !(el instanceof Element)) return;\n  queueMicrotask(() => {\n    if (!el.isConnected || el.matches(\":disabled\") || el.closest(\"[hidden],[inert]\")) return;\n    // `display: none`, where the browser can say (jsdom cannot).\n    if (typeof el.checkVisibility === \"function\" && !el.checkVisibility()) return;\n    if (focusIsLost()) then();\n  });\n}\n\n/**\n * The tab stops around `frame`, outside it, nearest first on each side — where focus\n * goes once `frame` is gone. Read BEFORE it goes: a removed node has no place in the\n * document to measure from. `limit` per side keeps a long page's stops out of memory.\n *\n * Walked outwards from the frame, `limit` stops each way (0.52 code review,\n * lib/focus-left.ts): read from every stop in the page, a banner under a 2000-row table\n * read all 2000 to keep the nearest five before it.\n */\nexport function tabStopsAround(frame: Element, limit = 5): { after: HTMLElement[]; before: HTMLElement[] } {\n  const doc = frame.ownerDocument;\n  const walker = doc.createTreeWalker(doc.documentElement, NodeFilter.SHOW_ELEMENT);\n  const isStop = (node: Node): node is HTMLElement =>\n    node instanceof HTMLElement && node.matches(TAB_STOP) && isTabStop(node);\n  // After: from the first element past the frame's own subtree, in document order.\n  const after: HTMLElement[] = [];\n  walker.currentNode = frame;\n  let node: Node | null = walker.nextSibling();\n  while (!node && walker.parentNode()) node = walker.nextSibling();\n  for (; node && after.length < limit; node = walker.nextNode()) if (isStop(node)) after.push(node);\n  // Before: back from the frame, nearest first (its ancestors among them, as before).\n  const before: HTMLElement[] = [];\n  walker.currentNode = frame;\n  for (node = walker.previousNode(); node && before.length < limit; node = walker.previousNode())\n    if (isStop(node)) before.push(node);\n  return { after, before };\n}\n\n/**\n * Focus the first of `candidates` that is still in the page and takes the focus; true\n * when one did. Each is tried and checked, since `focus()` on a node that cannot hold it\n * (detached, `display: none`, disabled since) fails without a word.\n */\nexport function focusFirst(candidates: Iterable<Element | null | undefined>): boolean {\n  for (const el of candidates) {\n    if (!(el instanceof HTMLElement) || !el.isConnected) continue;\n    el.focus();\n    if (document.activeElement === el) return true;\n  }\n  return false;\n}\n\n/**\n * Focus a container that is not a tab stop of its own — a table, a list — as the place\n * the user is in, without making it one: `tabindex=\"-1\"` for as long as it holds the\n * focus, unless it already carries a `tabindex` of its own.\n */\nexport function focusContainer(el: HTMLElement): void {\n  if (!el.hasAttribute(\"tabindex\")) {\n    el.setAttribute(\"tabindex\", \"-1\");\n    el.addEventListener(\"blur\", () => el.removeAttribute(\"tabindex\"), { once: true });\n  }\n  el.focus();\n}\n"],"mappings":";AA2BA,MAAM,WACJ;AAQF,SAAS,UAAU,IAA0B;AAC3C,SAAO,GAAG,YAAY,KAAK,CAAC,GAAG,QAAQ,kBAAkB;AAC3D;AAWO,SAAS,SAAS,IAAa,EAAE,cAAc,KAAK,IAAoB,CAAC,GAAkB;AAChG,QAAM,SAAS,MAAM,KAAK,GAAG,iBAA8B,QAAQ,CAAC,EAAE,OAAO,SAAS;AACtF,QAAM,MAAM,eAAe,cAAc,eAAe,GAAG,QAAQ,QAAQ,KAAK,UAAU,EAAE;AAC5F,SAAO,MAAM,CAAC,IAAI,GAAG,MAAM,IAAI;AACjC;AAGO,SAAS,aAAa,IAAa,SAA8C;AACtF,SAAO,SAAS,IAAI,OAAO,EAAE,CAAC,KAAK;AACrC;AAQO,SAAS,cAAuB;AACrC,MAAI,OAAO,aAAa,YAAa,QAAO;AAC5C,QAAM,KAAK,SAAS;AACpB,SAAO,CAAC,MAAM,OAAO,SAAS,QAAQ,CAAC,GAAG;AAC5C;AAkBO,SAAS,wBACd,GACA,MACM;AACN,QAAM,KAAK,EAAE;AACb,MAAI,EAAE,kBAAkB,QAAQ,EAAE,cAAc,SAAU;AAC1D,iBAAe,MAAM;AACnB,QAAI,CAAC,GAAG,eAAe,GAAG,QAAQ,WAAW,KAAK,GAAG,QAAQ,kBAAkB,EAAG;AAElF,QAAI,OAAO,GAAG,oBAAoB,cAAc,CAAC,GAAG,gBAAgB,EAAG;AACvE,QAAI,YAAY,EAAG,MAAK;AAAA,EAC1B,CAAC;AACH;AAWO,SAAS,eAAe,OAAgB,QAAQ,GAAoD;AACzG,QAAM,MAAM,MAAM;AAClB,QAAM,SAAS,IAAI,iBAAiB,IAAI,iBAAiB,WAAW,YAAY;AAChF,QAAM,SAAS,CAACA,UACdA,iBAAgB,eAAeA,MAAK,QAAQ,QAAQ,KAAK,UAAUA,KAAI;AAEzE,QAAM,QAAuB,CAAC;AAC9B,SAAO,cAAc;AACrB,MAAI,OAAoB,OAAO,YAAY;AAC3C,SAAO,CAAC,QAAQ,OAAO,WAAW,EAAG,QAAO,OAAO,YAAY;AAC/D,SAAO,QAAQ,MAAM,SAAS,OAAO,OAAO,OAAO,SAAS,EAAG,KAAI,OAAO,IAAI,EAAG,OAAM,KAAK,IAAI;AAEhG,QAAM,SAAwB,CAAC;AAC/B,SAAO,cAAc;AACrB,OAAK,OAAO,OAAO,aAAa,GAAG,QAAQ,OAAO,SAAS,OAAO,OAAO,OAAO,aAAa;AAC3F,QAAI,OAAO,IAAI,EAAG,QAAO,KAAK,IAAI;AACpC,SAAO,EAAE,OAAO,OAAO;AACzB;AAOO,SAAS,WAAW,YAA2D;AACpF,aAAW,MAAM,YAAY;AAC3B,QAAI,EAAE,cAAc,gBAAgB,CAAC,GAAG,YAAa;AACrD,OAAG,MAAM;AACT,QAAI,SAAS,kBAAkB,GAAI,QAAO;AAAA,EAC5C;AACA,SAAO;AACT;AAOO,SAAS,eAAe,IAAuB;AACpD,MAAI,CAAC,GAAG,aAAa,UAAU,GAAG;AAChC,OAAG,aAAa,YAAY,IAAI;AAChC,OAAG,iBAAiB,QAAQ,MAAM,GAAG,gBAAgB,UAAU,GAAG,EAAE,MAAM,KAAK,CAAC;AAAA,EAClF;AACA,KAAG,MAAM;AACX;","names":["node"]}

package/dist/lib/format.js

@@ -2,6 +2,8 @@
 import { useMemo } from "react";
 import { useKitLocale, useKitTimeZone } from "../i18n/kit-labels.js";
 import { parseIsoDate } from "./dates.js";
+import { dateFormatter } from "./intl-cache.js";
+import { isBareIsoDay } from "./iso-day.js";
 import { formatWithMinus } from "./minus.js";
 import { roundHalfAway } from "./round.js";
 import { formatWithMinus as formatWithMinus2 } from "./minus.js";
@@ -111,28 +113,17 @@ const DATE_STYLES = {
   time: { timeStyle: "short" },
   monthYear: { month: "long", year: "numeric" }
 };
-const BARE_ISO_DAY = /^\d{4}-\d{2}-\d{2}$/;
 function toDate(value) {
   if (value === null || value === void 0 || value === "") return null;
-  if (typeof value === "string" && BARE_ISO_DAY.test(value)) return parseIsoDate(value);
+  if (isBareIsoDay(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;
-  if (typeof value === "string" && BARE_ISO_DAY.test(value)) {
+  if (isBareIsoDay(value)) {
     const day = new Date(Date.UTC(d.getFullYear(), d.getMonth(), d.getDate()));
     return dateFormatter(options.locale, { ...base, timeZone: "UTC" }).format(day);
   }
@@ -180,7 +171,7 @@ function formatRelativeTime(value, options = {}) {
   const rtf = relativeFormatter(options.locale, options.numeric ?? "auto", options.style ?? "long");
   const [, unit, size] = RELATIVE_STEPS.find(([limit]) => abs < limit);
   if (unit === "day") {
-    const bareDay = typeof value === "string" && BARE_ISO_DAY.test(value);
+    const bareDay = isBareIsoDay(value);
     const days = dayNumber(d, bareDay ? void 0 : options.timeZone) - dayNumber(now, options.timeZone);
     return days === 0 ? rtf.format(Math.round(diff / HOUR), "hour") : rtf.format(days, "day");
   }