@eifi1/ui-kit 0.4.0 → 0.5.0

package/dist/hooks/use-overlay-history.js

@@ -1,3 +1,4 @@
+"use client";
 import { useEffect, useRef } from "react";
 const SENTINEL_KEY = "__hbUiOverlayHistory";
 const stack = [];
@@ -22,13 +23,36 @@ function forgetPushed(id) {
   const at = pushed.findIndex((p) => p.id === id);
   if (at >= 0) pushed.splice(at, 1);
 }
-function currentSentinel() {
+let standing = null;
+function taggedSentinel() {
   const state = typeof window !== "undefined" ? window.history.state : null;
   if (!state || typeof state !== "object") return null;
   const id = state[SENTINEL_KEY];
   return typeof id === "string" ? id : null;
 }
+function retag(id) {
+  const prev = window.history.state;
+  window.history.replaceState(
+    { ...prev && typeof prev === "object" ? prev : {}, [SENTINEL_KEY]: id },
+    ""
+  );
+}
+function currentSentinel() {
+  const tag = taggedSentinel();
+  if (tag !== null) {
+    standing = tag;
+    return tag;
+  }
+  if (standing === null || typeof window === "undefined") return null;
+  if (!pushed.some((p) => p.id === standing)) {
+    standing = null;
+    return null;
+  }
+  retag(standing);
+  return standing;
+}
 function handlePop() {
+  standing = taggedSentinel();
   if (pendingProgrammatic > 0) {
     pendingProgrammatic -= 1;
     return;
@@ -67,11 +91,13 @@ function useOverlayHistory(open, onClose) {
       window.history.replaceState(marked, "");
       for (const owed of inherited.slice(0, -1)) pushed.push({ ...owed, dead: true });
       pushed.push({ id, href: currentHref(), dead: false });
+      standing = id;
     } else {
       const under = pushed.findIndex((p) => p.id === currentSentinel());
       pushed.splice(under + 1);
       window.history.pushState(marked, "");
       pushed.push({ id, href: currentHref(), dead: false });
+      standing = id;
     }
     return () => {
       const at = stack.indexOf(entry);

package/dist/hooks/use-overlay-history.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hooks/use-overlay-history.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\n\n/**\n * Back closes the overlay, not the page (Keksdose feedback #172).\n *\n * On a phone the Back gesture is the universal \"dismiss this\" — so a dialog or a\n * full-screen search surface that ignores it doesn't merely fail to close: the\n * navigation lands somewhere else entirely, and on a route with nothing beneath it\n * that means leaving the app with the overlay still notionally open.\n *\n * The mechanism is one throwaway, SAME-URL history entry pushed while the overlay is\n * up. Back then pops a same-document entry — no route change, no re-render of the\n * page under it — and this hook turns that pop into `onClose()`. Same trick the\n * transactions page already uses for its unsaved-edit trap\n * (`use-soft-leave-guard.ts`); the two coexist because they use different marker\n * keys AND because `handlePop` only claims a pop that actually consumed OUR entry\n * — a foreign sentinel stacked on top of ours pops back ONTO us, and an overlay\n * that closed on that would vanish mid-edit (feedback #424/#426).\n *\n * Not a URL parameter, deliberately. Encoding \"a dialog is open\" in the address bar\n * makes it shareable and restorable, which is wrong for the overlays this covers —\n * nobody wants to send someone a link that opens a confirm dialog — and it would\n * fight the page-owned `?row=` / `f.*` params that ARE meaningful state.\n *\n * ## Ordering\n *\n * The stack is module-level because correctness here is about order ACROSS\n * instances: every mounted overlay hears the same `popstate`, but only the one whose\n * entry was actually popped may close. Overlays nest and unwind last-in-first-out —\n * a dialog opened from a search surface closes before the surface — so the top of\n * this stack is by construction the entry the browser just popped.\n *\n * ## Not undoing a real navigation\n *\n * The cleanup pops our entry when the overlay closes some other way (a button,\n * Escape, a backdrop click) so history doesn't silently accumulate dead entries. It\n * first checks that our marker is still the CURRENT entry: if the user followed a\n * link while the overlay was open, the router has pushed on top of us, and a blind\n * `history.back()` there would undo their navigation.\n *\n * ## The traversal is deferred\n *\n * And it is *scheduled* rather than issued, because `history.go()` lands a task\n * later while everything this module knows is written synchronously. See\n * {@link Unwind}: an overlay opening inside that window adopts the entry instead\n * of stacking a second one on it, which is what makes the hook survive React\n * StrictMode's mount → clean up → mount (steering-design feedback #49).\n */\nconst SENTINEL_KEY = \"__hbUiOverlayHistory\";\n\ninterface OverlayEntry {\n  id: string;\n  close: () => void;\n}\n\nconst stack: OverlayEntry[] = [];\n\n/**\n * The sentinels we have PUSHED and not yet unwound, oldest first.\n *\n * The stack above tracks live overlays; this tracks live history entries, and the\n * two come apart in exactly one case — which is the bug this list exists for.\n * Nested overlays that close in the same commit unwind parent-first, so the dialog's\n * cleanup runs while the sheet's entry is still on top of its own. It cannot call\n * `history.back()` there (that would consume the SHEET's entry, and the sheet is\n * about to consume it itself), so its entry was simply abandoned: a husk with no\n * live owner sitting between the user and the page.\n *\n * The user paid for it on the next Back press. It popped the husk, `handlePop` found\n * an empty stack and returned, and nothing visible happened — Back had to be pressed\n * twice to leave the page.\n *\n * So an abandoned entry is recorded as `dead` instead, and whichever overlay DOES\n * get to unwind pays the debt with a single `history.go(-n)`. `href` is what keeps\n * that safe: only dead entries pushed at the address we are still sitting at are\n * unwound, so a router navigation that landed between two sentinels is never\n * reversed on the user's behalf.\n */\ninterface PushedEntry {\n  id: string;\n  href: string;\n  /** Its overlay is gone but the entry is not — someone above owes this pop. */\n  dead: boolean;\n}\nconst pushed: PushedEntry[] = [];\n\n/** Entries a real Back press already consumed. Their overlay's cleanup still has to\n *  run, and it must not mistake \"my entry is not current\" for \"my entry is buried\"\n *  — it has no entry left at all. */\nconst consumed = new Set<string>();\n\n/** Pops WE caused (a cleanup unwinding its own entries) — their `popstate` is\n *  bookkeeping, not a user gesture, and must not close a second overlay. A\n *  `history.go(-n)` traversal fires exactly ONE popstate however far it travels. */\nlet pendingProgrammatic = 0;\nlet listening = false;\nlet nextId = 0;\n\n/**\n * The unwind a cleanup has asked for and not yet issued.\n *\n * **`history.go()` is asynchronous and everything above is written\n * synchronously**, which is the seam the whole of this block exists to close.\n * The traversal lands a task later, so an overlay that opens in the *same* tick\n * as one that closed used to push its sentinel on top of the entry that was\n * about to be popped — and the pop then took the NEW entry. The overlay left on\n * screen had no entry of its own (so Back no longer closed it) and the old one\n * stayed behind as a husk between the user and their page.\n *\n * That is not an exotic race. **React StrictMode remounts every effect** — mount,\n * clean up, mount again, all in one commit — so in development *every* dialog\n * anyone opened left a husk behind, the position drifted one entry further from\n * the page on each open, and the Back press that was meant to leave the page was\n * spent on something invisible instead (steering-design feedback #49).\n *\n * So the traversal is deferred by a task, and an overlay mounting inside that\n * window **adopts** the entry instead of pushing a second one (see the effect).\n * Adoption is `replaceState` on an entry that is already there: no traversal, no\n * window in which the count can be wrong, and the StrictMode remount costs\n * exactly nothing.\n */\ninterface Unwind {\n  timer: ReturnType<typeof setTimeout>;\n  /** The sentinel on the entry to leave — the top of `entries`. */\n  id: string;\n  href: string;\n  /** That entry plus the abandoned ones directly beneath it, oldest first. */\n  entries: PushedEntry[];\n}\nlet unwind: Unwind | null = null;\n\n/** Issue the deferred traversal, if the ground has not moved under it.\n *\n *  A real Back press or a router navigation during the deferred task leaves us\n *  somewhere that is not the entry we meant to leave, and going back from there\n *  would take something that is not ours. The entries are then simply forgotten\n *  rather than handed back as `dead`: a forgotten entry costs one dead Back\n *  press, while an over-counted one costs the user a navigation they did make. */\nfunction runUnwind(): void {\n  const job = unwind;\n  unwind = null;\n  if (!job) return;\n  if (currentSentinel() !== job.id || currentHref() !== job.href) return;\n  pendingProgrammatic += 1;\n  window.history.go(-job.entries.length);\n}\n\nfunction currentHref(): string {\n  return typeof window === \"undefined\" ? \"\" : window.location.href;\n}\n\nfunction forgetPushed(id: string): void {\n  const at = pushed.findIndex((p) => p.id === id);\n  if (at >= 0) pushed.splice(at, 1);\n}\n\nfunction currentSentinel(): string | null {\n  const state = typeof window !== \"undefined\" ? window.history.state : null;\n  if (!state || typeof state !== \"object\") return null;\n  const id = (state as Record<string, unknown>)[SENTINEL_KEY];\n  return typeof id === \"string\" ? id : null;\n}\n\nfunction handlePop() {\n  if (pendingProgrammatic > 0) {\n    pendingProgrammatic -= 1;\n    return;\n  }\n  // Nothing open → an ordinary navigation, which is none of our business.\n  const top = stack[stack.length - 1];\n  if (!top) return;\n  // We landed back ON the top overlay's own entry, so that entry was NOT what the\n  // pop consumed — something stacked ABOVE it was (Keksdose feedback #424/#426).\n  // The app layers a second same-URL sentinel of its own on top of ours for the\n  // unsaved-edit trap (`use-soft-leave-guard.ts`), and it pops that sentinel every\n  // time the form goes back to clean — twice-toggling one field was enough to\n  // close the whole dialog. A pop is only ours when the entry we came to rest on\n  // is no longer ours: either the layer below (a different overlay's marker) or\n  // the plain page entry (none at all).\n  if (currentSentinel() === top.id) return;\n  stack.pop();\n  // The browser consumed this entry, so the overlay's own cleanup has nothing left\n  // to unwind and nothing to record as owed.\n  consumed.add(top.id);\n  forgetPushed(top.id);\n  top.close();\n}\n\nfunction ensureListening() {\n  if (listening || typeof window === \"undefined\") return;\n  window.addEventListener(\"popstate\", handlePop);\n  listening = true;\n}\n\n/**\n * Make the platform Back gesture dismiss an overlay.\n *\n * @param open      whether the overlay is currently showing. Components that mount\n *                  only while open (the common case) pass `true`.\n * @param onClose   the overlay's own close handler — the same one Escape calls.\n */\nexport function useOverlayHistory(open: boolean, onClose: () => void): void {\n  // The listener fires outside React's render, so it reads the latest handler\n  // through a ref rather than through the closure the effect captured.\n  const closeRef = useRef(onClose);\n  useEffect(() => {\n    closeRef.current = onClose;\n  });\n\n  useEffect(() => {\n    if (!open || typeof window === \"undefined\") return;\n    ensureListening();\n    const id = `overlay-${(nextId += 1)}`;\n    const entry: OverlayEntry = { id, close: () => closeRef.current() };\n    stack.push(entry);\n    const prev = window.history.state;\n    const marked = { ...(prev && typeof prev === \"object\" ? prev : {}), [SENTINEL_KEY]: id };\n    // An entry that is on its way out and that we are still standing on is ours\n    // to take over: same URL, same slot, only the marker changes. Pushing a\n    // second one on top of it is what used to leave a husk on every StrictMode\n    // remount — see {@link Unwind}.\n    const adopting = unwind && unwind.id === currentSentinel() && unwind.href === currentHref();\n    if (adopting && unwind) {\n      clearTimeout(unwind.timer);\n      const inherited = unwind.entries;\n      unwind = null;\n      // Preserve react-router's own `{usr,key,idx}` — we only swap the marker,\n      // and the entry we are swapping it on is the one the router is already on.\n      window.history.replaceState(marked, \"\");\n      // The abandoned ones beneath come back owed; ours takes the top slot.\n      for (const owed of inherited.slice(0, -1)) pushed.push({ ...owed, dead: true });\n      pushed.push({ id, href: currentHref(), dead: false });\n    } else {\n      // A push DESTROYS every entry ahead of the one we are on, so anything we\n      // still had recorded above our own position is gone. Kept, those would be\n      // counted into a later `history.go(-n)` and the overshoot would come out\n      // of a navigation the user actually made. Where we cannot tell which of\n      // ours are beneath us — we are standing on a plain page entry, or on a\n      // husk nobody tracks — none of them can be proven to be, so none survive.\n      const under = pushed.findIndex((p) => p.id === currentSentinel());\n      pushed.splice(under + 1);\n      // Preserve react-router's own `{usr,key,idx}` — we only tack a marker on, and\n      // the URL is unchanged, so the router treats popping this as a no-op re-render.\n      window.history.pushState(marked, \"\");\n      pushed.push({ id, href: currentHref(), dead: false });\n    }\n    return () => {\n      const at = stack.indexOf(entry);\n      if (at >= 0) stack.splice(at, 1);\n\n      // A Back press already took this entry; there is nothing to unwind or to owe.\n      if (consumed.delete(id)) return;\n\n      const mine = pushed.findIndex((p) => p.id === id);\n      // Only unwind an entry that is still THE current one. If a router push landed\n      // on top of it, going back would undo the user's navigation instead — and if\n      // a SIBLING overlay's sentinel landed on top, that overlay is about to unwind\n      // and is the one that can take ours with it.\n      if (currentSentinel() !== id) {\n        if (mine >= 0) pushed[mine].dead = true;\n        return;\n      }\n\n      // Ours plus every abandoned entry lying directly beneath it at this address.\n      // One traversal, so one popstate, so one programmatic pop to absorb.\n      const here = currentHref();\n      let steps = 1;\n      while (steps <= mine && pushed[mine - steps].dead && pushed[mine - steps].href === here) {\n        steps += 1;\n      }\n      const leaving = pushed.splice(mine - (steps - 1), steps);\n      // Scheduled, not issued: an overlay opening in this same tick takes the\n      // entry over instead, which is what makes the hook survive a StrictMode\n      // remount. An unwind already waiting is dropped rather than merged — it\n      // was the entry ABOVE ours and something has since moved off it, so its\n      // count can no longer be proven, and an over-counted traversal costs a\n      // navigation the user made while an under-counted one costs one dead Back.\n      if (unwind) clearTimeout(unwind.timer);\n      unwind = { timer: setTimeout(runUnwind, 0), id, href: here, entries: leaving };\n    };\n  }, [open]);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/hooks/use-overlay-history.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\n\n/**\n * Back closes the overlay, not the page (Keksdose feedback #172).\n *\n * On a phone the Back gesture is the universal \"dismiss this\" — so a dialog or a\n * full-screen search surface that ignores it doesn't merely fail to close: the\n * navigation lands somewhere else entirely, and on a route with nothing beneath it\n * that means leaving the app with the overlay still notionally open.\n *\n * The mechanism is one throwaway, SAME-URL history entry pushed while the overlay is\n * up. Back then pops a same-document entry — no route change, no re-render of the\n * page under it — and this hook turns that pop into `onClose()`. Same trick the\n * transactions page already uses for its unsaved-edit trap\n * (`use-soft-leave-guard.ts`); the two coexist because they use different marker\n * keys AND because `handlePop` only claims a pop that actually consumed OUR entry\n * — a foreign sentinel stacked on top of ours pops back ONTO us, and an overlay\n * that closed on that would vanish mid-edit (feedback #424/#426).\n *\n * Not a URL parameter, deliberately. Encoding \"a dialog is open\" in the address bar\n * makes it shareable and restorable, which is wrong for the overlays this covers —\n * nobody wants to send someone a link that opens a confirm dialog — and it would\n * fight the page-owned `?row=` / `f.*` params that ARE meaningful state.\n *\n * ## Ordering\n *\n * The stack is module-level because correctness here is about order ACROSS\n * instances: every mounted overlay hears the same `popstate`, but only the one whose\n * entry was actually popped may close. Overlays nest and unwind last-in-first-out —\n * a dialog opened from a search surface closes before the surface — so the top of\n * this stack is by construction the entry the browser just popped.\n *\n * ## Not undoing a real navigation\n *\n * The cleanup pops our entry when the overlay closes some other way (a button,\n * Escape, a backdrop click) so history doesn't silently accumulate dead entries. It\n * first checks that our marker is still the CURRENT entry: if the user followed a\n * link while the overlay was open, the router has pushed on top of us, and a blind\n * `history.back()` there would undo their navigation.\n *\n * ## The traversal is deferred\n *\n * And it is *scheduled* rather than issued, because `history.go()` lands a task\n * later while everything this module knows is written synchronously. See\n * {@link Unwind}: an overlay opening inside that window adopts the entry instead\n * of stacking a second one on it, which is what makes the hook survive React\n * StrictMode's mount → clean up → mount (steering-design feedback #49).\n */\nconst SENTINEL_KEY = \"__hbUiOverlayHistory\";\n\ninterface OverlayEntry {\n  id: string;\n  close: () => void;\n}\n\nconst stack: OverlayEntry[] = [];\n\n/**\n * The sentinels we have PUSHED and not yet unwound, oldest first.\n *\n * The stack above tracks live overlays; this tracks live history entries, and the\n * two come apart in exactly one case — which is the bug this list exists for.\n * Nested overlays that close in the same commit unwind parent-first, so the dialog's\n * cleanup runs while the sheet's entry is still on top of its own. It cannot call\n * `history.back()` there (that would consume the SHEET's entry, and the sheet is\n * about to consume it itself), so its entry was simply abandoned: a husk with no\n * live owner sitting between the user and the page.\n *\n * The user paid for it on the next Back press. It popped the husk, `handlePop` found\n * an empty stack and returned, and nothing visible happened — Back had to be pressed\n * twice to leave the page.\n *\n * So an abandoned entry is recorded as `dead` instead, and whichever overlay DOES\n * get to unwind pays the debt with a single `history.go(-n)`. `href` is what keeps\n * that safe: only dead entries pushed at the address we are still sitting at are\n * unwound, so a router navigation that landed between two sentinels is never\n * reversed on the user's behalf.\n */\ninterface PushedEntry {\n  id: string;\n  href: string;\n  /** Its overlay is gone but the entry is not — someone above owes this pop. */\n  dead: boolean;\n}\nconst pushed: PushedEntry[] = [];\n\n/** Entries a real Back press already consumed. Their overlay's cleanup still has to\n *  run, and it must not mistake \"my entry is not current\" for \"my entry is buried\"\n *  — it has no entry left at all. */\nconst consumed = new Set<string>();\n\n/** Pops WE caused (a cleanup unwinding its own entries) — their `popstate` is\n *  bookkeeping, not a user gesture, and must not close a second overlay. A\n *  `history.go(-n)` traversal fires exactly ONE popstate however far it travels. */\nlet pendingProgrammatic = 0;\nlet listening = false;\nlet nextId = 0;\n\n/**\n * The unwind a cleanup has asked for and not yet issued.\n *\n * **`history.go()` is asynchronous and everything above is written\n * synchronously**, which is the seam the whole of this block exists to close.\n * The traversal lands a task later, so an overlay that opens in the *same* tick\n * as one that closed used to push its sentinel on top of the entry that was\n * about to be popped — and the pop then took the NEW entry. The overlay left on\n * screen had no entry of its own (so Back no longer closed it) and the old one\n * stayed behind as a husk between the user and their page.\n *\n * That is not an exotic race. **React StrictMode remounts every effect** — mount,\n * clean up, mount again, all in one commit — so in development *every* dialog\n * anyone opened left a husk behind, the position drifted one entry further from\n * the page on each open, and the Back press that was meant to leave the page was\n * spent on something invisible instead (steering-design feedback #49).\n *\n * So the traversal is deferred by a task, and an overlay mounting inside that\n * window **adopts** the entry instead of pushing a second one (see the effect).\n * Adoption is `replaceState` on an entry that is already there: no traversal, no\n * window in which the count can be wrong, and the StrictMode remount costs\n * exactly nothing.\n */\ninterface Unwind {\n  timer: ReturnType<typeof setTimeout>;\n  /** The sentinel on the entry to leave — the top of `entries`. */\n  id: string;\n  href: string;\n  /** That entry plus the abandoned ones directly beneath it, oldest first. */\n  entries: PushedEntry[];\n}\nlet unwind: Unwind | null = null;\n\n/** Issue the deferred traversal, if the ground has not moved under it.\n *\n *  A real Back press or a router navigation during the deferred task leaves us\n *  somewhere that is not the entry we meant to leave, and going back from there\n *  would take something that is not ours. The entries are then simply forgotten\n *  rather than handed back as `dead`: a forgotten entry costs one dead Back\n *  press, while an over-counted one costs the user a navigation they did make. */\nfunction runUnwind(): void {\n  const job = unwind;\n  unwind = null;\n  if (!job) return;\n  if (currentSentinel() !== job.id || currentHref() !== job.href) return;\n  pendingProgrammatic += 1;\n  window.history.go(-job.entries.length);\n}\n\nfunction currentHref(): string {\n  return typeof window === \"undefined\" ? \"\" : window.location.href;\n}\n\nfunction forgetPushed(id: string): void {\n  const at = pushed.findIndex((p) => p.id === id);\n  if (at >= 0) pushed.splice(at, 1);\n}\n\n/**\n * The sentinel this module believes is on the entry we are standing on.\n *\n * `history.state` is where the tag physically sits, because it is the only\n * per-entry storage a browser has — but it is not this module's storage, so\n * since the 2026-09-22 audit it is no longer read as the last word.\n * The ROUTER owns that object and writes it WHOLE: every\n * `setSearchParams(…, { replace: true })` stamps `{usr, key, idx}` over\n * whatever was there. A `DataTable` with `urlSync` does exactly that, on mount\n * and on every filter change — so an overlay opened from such a table had its\n * tag wiped off the entry it was standing on, and then:\n *\n *  * its cleanup read \"not my entry\" and abandoned a live entry as a husk;\n *  * the push path below could not find itself in `pushed`, so it discarded\n *    every record it had (`splice(0)`) and nothing was ever unwound again;\n *  * the StrictMode adoption never matched, so in development every dialog\n *    pushed a second entry and the deferred `go(-1)` ate the live one — which\n *    is Back no longer closing the overlay at all.\n *\n * So `standing` answers when the tag is gone: a MISSING tag on an entry we have\n * not left is a wipe to repair rather than a verdict. The tag is still read\n * FIRST wherever it is there, because it is the one thing that can see a FOREIGN\n * same-URL entry stacked above ours (feedback #424/#426, below) — module-level\n * bookkeeping cannot, since nobody tells us about someone else's `pushState`.\n */\nlet standing: string | null = null;\n\n/** The tag actually on the current entry, with no repair and no belief. */\nfunction taggedSentinel(): string | null {\n  const state = typeof window !== \"undefined\" ? window.history.state : null;\n  if (!state || typeof state !== \"object\") return null;\n  const id = (state as Record<string, unknown>)[SENTINEL_KEY];\n  return typeof id === \"string\" ? id : null;\n}\n\n/** Put our tag back on the current entry, keeping whatever the router has since\n *  written there — we are a passenger in that object, not its owner. */\nfunction retag(id: string): void {\n  const prev = window.history.state;\n  window.history.replaceState(\n    { ...(prev && typeof prev === \"object\" ? prev : {}), [SENTINEL_KEY]: id },\n    \"\",\n  );\n}\n\nfunction currentSentinel(): string | null {\n  const tag = taggedSentinel();\n  if (tag !== null) {\n    standing = tag;\n    return tag;\n  }\n  if (standing === null || typeof window === \"undefined\") return null;\n  // Only ever re-stamp an entry we still hold a record for. Without that guard a\n  // belief left over from an overlay that is long gone — a tab that has since\n  // navigated, a test file that ran another case — would be stamped onto a\n  // stranger's entry, and the next cleanup would traverse off it.\n  if (!pushed.some((p) => p.id === standing)) {\n    standing = null;\n    return null;\n  }\n  retag(standing);\n  return standing;\n}\n\nfunction handlePop() {\n  // A pop MOVES us, so the belief is stale by definition: re-read it from the\n  // entry we have landed on before anything below consults it, or the repair in\n  // `currentSentinel` would stamp the entry we just left onto the one we are on.\n  standing = taggedSentinel();\n  if (pendingProgrammatic > 0) {\n    pendingProgrammatic -= 1;\n    return;\n  }\n  // Nothing open → an ordinary navigation, which is none of our business.\n  const top = stack[stack.length - 1];\n  if (!top) return;\n  // We landed back ON the top overlay's own entry, so that entry was NOT what the\n  // pop consumed — something stacked ABOVE it was (Keksdose feedback #424/#426).\n  // The app layers a second same-URL sentinel of its own on top of ours for the\n  // unsaved-edit trap (`use-soft-leave-guard.ts`), and it pops that sentinel every\n  // time the form goes back to clean — twice-toggling one field was enough to\n  // close the whole dialog. A pop is only ours when the entry we came to rest on\n  // is no longer ours: either the layer below (a different overlay's marker) or\n  // the plain page entry (none at all).\n  if (currentSentinel() === top.id) return;\n  stack.pop();\n  // The browser consumed this entry, so the overlay's own cleanup has nothing left\n  // to unwind and nothing to record as owed.\n  consumed.add(top.id);\n  forgetPushed(top.id);\n  top.close();\n}\n\nfunction ensureListening() {\n  if (listening || typeof window === \"undefined\") return;\n  window.addEventListener(\"popstate\", handlePop);\n  listening = true;\n}\n\n/**\n * Make the platform Back gesture dismiss an overlay.\n *\n * @param open      whether the overlay is currently showing. Components that mount\n *                  only while open (the common case) pass `true`.\n * @param onClose   the overlay's own close handler — the same one Escape calls.\n */\nexport function useOverlayHistory(open: boolean, onClose: () => void): void {\n  // The listener fires outside React's render, so it reads the latest handler\n  // through a ref rather than through the closure the effect captured.\n  const closeRef = useRef(onClose);\n  useEffect(() => {\n    closeRef.current = onClose;\n  });\n\n  useEffect(() => {\n    if (!open || typeof window === \"undefined\") return;\n    ensureListening();\n    const id = `overlay-${(nextId += 1)}`;\n    const entry: OverlayEntry = { id, close: () => closeRef.current() };\n    stack.push(entry);\n    const prev = window.history.state;\n    const marked = { ...(prev && typeof prev === \"object\" ? prev : {}), [SENTINEL_KEY]: id };\n    // An entry that is on its way out and that we are still standing on is ours\n    // to take over: same URL, same slot, only the marker changes. Pushing a\n    // second one on top of it is what used to leave a husk on every StrictMode\n    // remount — see {@link Unwind}.\n    const adopting = unwind && unwind.id === currentSentinel() && unwind.href === currentHref();\n    if (adopting && unwind) {\n      clearTimeout(unwind.timer);\n      const inherited = unwind.entries;\n      unwind = null;\n      // Preserve react-router's own `{usr,key,idx}` — we only swap the marker,\n      // and the entry we are swapping it on is the one the router is already on.\n      window.history.replaceState(marked, \"\");\n      // The abandoned ones beneath come back owed; ours takes the top slot.\n      for (const owed of inherited.slice(0, -1)) pushed.push({ ...owed, dead: true });\n      pushed.push({ id, href: currentHref(), dead: false });\n      standing = id;\n    } else {\n      // A push DESTROYS every entry ahead of the one we are on, so anything we\n      // still had recorded above our own position is gone. Kept, those would be\n      // counted into a later `history.go(-n)` and the overshoot would come out\n      // of a navigation the user actually made. Where we cannot tell which of\n      // ours are beneath us — we are standing on a plain page entry, or on a\n      // husk nobody tracks — none of them can be proven to be, so none survive.\n      const under = pushed.findIndex((p) => p.id === currentSentinel());\n      pushed.splice(under + 1);\n      // Preserve react-router's own `{usr,key,idx}` — we only tack a marker on, and\n      // the URL is unchanged, so the router treats popping this as a no-op re-render.\n      window.history.pushState(marked, \"\");\n      pushed.push({ id, href: currentHref(), dead: false });\n      standing = id;\n    }\n    return () => {\n      const at = stack.indexOf(entry);\n      if (at >= 0) stack.splice(at, 1);\n\n      // A Back press already took this entry; there is nothing to unwind or to owe.\n      if (consumed.delete(id)) return;\n\n      const mine = pushed.findIndex((p) => p.id === id);\n      // Only unwind an entry that is still THE current one. If a router push landed\n      // on top of it, going back would undo the user's navigation instead — and if\n      // a SIBLING overlay's sentinel landed on top, that overlay is about to unwind\n      // and is the one that can take ours with it.\n      if (currentSentinel() !== id) {\n        if (mine >= 0) pushed[mine].dead = true;\n        return;\n      }\n\n      // Ours plus every abandoned entry lying directly beneath it at this address.\n      // One traversal, so one popstate, so one programmatic pop to absorb.\n      const here = currentHref();\n      let steps = 1;\n      while (steps <= mine && pushed[mine - steps].dead && pushed[mine - steps].href === here) {\n        steps += 1;\n      }\n      const leaving = pushed.splice(mine - (steps - 1), steps);\n      // Scheduled, not issued: an overlay opening in this same tick takes the\n      // entry over instead, which is what makes the hook survive a StrictMode\n      // remount. An unwind already waiting is dropped rather than merged — it\n      // was the entry ABOVE ours and something has since moved off it, so its\n      // count can no longer be proven, and an over-counted traversal costs a\n      // navigation the user made while an under-counted one costs one dead Back.\n      if (unwind) clearTimeout(unwind.timer);\n      unwind = { timer: setTimeout(runUnwind, 0), id, href: here, entries: leaving };\n    };\n  }, [open]);\n}\n"],"mappings":"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","names":[]}

package/dist/hooks/use-row-swipe.js

@@ -1,3 +1,4 @@
+"use client";
 import { useCallback, useEffect, useRef, useState } from "react";
 const CLICK_SWALLOW_PX = 24;
 const EMPTY_SIDE_RUBBER_PX = 28;

package/dist/hooks/use-row-swipe.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hooks/use-row-swipe.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport type { PointerEvent } from \"react\";\n\n// ---------- Mobile swipe gesture ----------\n//\n// Multi-stage half-swipe affordance (feedback #103, extended #9): drag a row\n// horizontally to commit an action; how FAR you drag picks which action, so a\n// single gesture can walk a chain of increasingly involved outcomes (e.g. on a\n// cleared row, a short left-swipe un-clears it, further un-accepts it, further\n// still deletes it). We track via Pointer Events, lock the gesture to the X axis\n// only after the user has moved more horizontally than vertically, and clamp the\n// drag to `maxDrag` so the row can't be pulled across the whole viewport.\n//\n// Each side is an ordered list of stages sorted by ascending `threshold` (px of\n// drag magnitude). On release the LAST stage whose threshold the drag passed is\n// committed; while dragging, `armedRightIndex`/`armedLeftIndex` report which\n// stage is currently armed so the reveal panel can preview its label/colour.\n\nexport interface SwipeStage {\n  /** Drag magnitude (px) at which this stage arms. Stages must be sorted ascending. */\n  threshold: number;\n  onCommit: () => void;\n}\n\n/** Below this much horizontal travel a gesture is treated as a clumsy click, not\n *  a swipe: the row still follows the pointer, but the click that follows is NOT\n *  swallowed. Without it, `swallowClick` was set the instant the axis lock\n *  resolved to \"x\" — 8px — so a slightly-draggy click on a control INSIDE a\n *  swipeable row silently did nothing, which is a poor trade on rows whose\n *  content is itself interactive (Keksdose feedback #144: budget rows edit their\n *  assigned amount and their name by clicking them). */\nconst CLICK_SWALLOW_PX = 24;\n\n/** How far a drag may travel toward a side that has no actions. Zero — the old\n *  behaviour — makes the row completely inert in that direction, which reads as\n *  \"this row is not swipeable at all\" rather than \"there is nothing on this\n *  side\"; that is exactly the report behind Keksdose feedback #144 (\"tried, but\n *  there is nothing swipeable\"). A short, resisted travel that snaps back is the\n *  conventional answer and the one that answers the question the drag asked. */\nconst EMPTY_SIDE_RUBBER_PX = 28;\n\n/** Resistance applied past a bound: the row keeps moving, at a fraction of the\n *  pointer, so the gesture feels answered without ever looking committed. */\nfunction rubberBand(overshoot: number, limit: number): number {\n  const eased = limit * (1 - Math.exp(-Math.abs(overshoot) / limit));\n  return Math.sign(overshoot) * eased;\n}\n\nexport interface RowSwipeOptions {\n  enabled: boolean;\n  // Ordered stages per direction (ascending threshold). A longer drag commits a\n  // later — usually more involved — stage. An empty/undefined side means that\n  // direction rubber-bands a little and snaps back, committing nothing.\n  leftStages?: SwipeStage[];\n  rightStages?: SwipeStage[];\n  maxDrag?: number;\n}\n\nexport interface RowSwipeReturn {\n  dx: number;\n  dragging: boolean;\n  /** Highest armed stage index for the current drag (-1 when none armed). */\n  armedRightIndex: number;\n  armedLeftIndex: number;\n  handlers: {\n    onPointerDown: (e: PointerEvent) => void;\n    onPointerMove: (e: PointerEvent) => void;\n    onPointerUp: (e: PointerEvent) => void;\n    onPointerCancel: (e: PointerEvent) => void;\n  };\n  consumeClick: () => boolean;\n}\n\n/** The highest index whose threshold the magnitude has reached (-1 if none).\n *  Stages are ascending, so we can stop at the first one not yet reached. */\nfunction lastArmed(stages: SwipeStage[] | undefined, magnitude: number): number {\n  if (!stages) return -1;\n  let idx = -1;\n  for (let i = 0; i < stages.length; i++) {\n    if (magnitude >= stages[i].threshold) idx = i;\n    else break;\n  }\n  return idx;\n}\n\nexport function useRowSwipe({\n  enabled,\n  leftStages,\n  rightStages,\n  maxDrag = 252,\n}: RowSwipeOptions): RowSwipeReturn {\n  const [dx, setDx] = useState(0);\n  const [dragging, setDragging] = useState(false);\n  const startX = useRef(0);\n  const startY = useRef(0);\n  const axis = useRef<\"none\" | \"x\" | \"y\">(\"none\");\n  const pointerId = useRef<number | null>(null);\n  const dxRef = useRef(0);\n  // True after the user has dragged horizontally far enough that the following\n  // synthetic click should be swallowed (so a swipe doesn't also expand the row).\n  const swallowClick = useRef(false);\n\n  // Keep the latest stage arrays in refs so the memoised pointer handlers always\n  // commit against the current plan rather than a stale closure — the arrays and\n  // their onCommit closures are rebuilt on every render. Written in an effect (not\n  // during render) so it satisfies react-hooks/refs; pointer events fire after the\n  // commit, so the refs are always current by the time a gesture reads them.\n  const leftRef = useRef(leftStages);\n  const rightRef = useRef(rightStages);\n  useEffect(() => {\n    leftRef.current = leftStages;\n    rightRef.current = rightStages;\n  });\n\n  const reset = useCallback(() => {\n    setDx(0);\n    dxRef.current = 0;\n    setDragging(false);\n    startX.current = 0;\n    startY.current = 0;\n    axis.current = \"none\";\n    pointerId.current = null;\n  }, []);\n\n  const onPointerDown = useCallback(\n    (e: PointerEvent) => {\n      if (!enabled) return;\n      if (e.pointerType === \"mouse\" && e.button !== 0) return;\n      pointerId.current = e.pointerId;\n      startX.current = e.clientX;\n      startY.current = e.clientY;\n      axis.current = \"none\";\n      swallowClick.current = false;\n      setDragging(true);\n    },\n    [enabled],\n  );\n\n  const onPointerMove = useCallback(\n    (e: PointerEvent) => {\n      if (pointerId.current !== e.pointerId) return;\n      const rawDx = e.clientX - startX.current;\n      const rawDy = e.clientY - startY.current;\n      if (axis.current === \"none\") {\n        if (Math.abs(rawDx) < 8 && Math.abs(rawDy) < 8) return;\n        axis.current = Math.abs(rawDx) > Math.abs(rawDy) ? \"x\" : \"y\";\n        if (axis.current === \"x\") {\n          (e.currentTarget as Element).setPointerCapture?.(e.pointerId);\n        } else {\n          // Vertical scroll wins — bail out of the gesture entirely.\n          reset();\n          return;\n        }\n      }\n      if (axis.current !== \"x\") return;\n      if (Math.abs(rawDx) >= CLICK_SWALLOW_PX) swallowClick.current = true;\n      // Toward a side that HAS actions the row tracks the pointer up to maxDrag.\n      // Toward an empty one it rubber-bands a little and snaps back on release —\n      // inert would be indistinguishable from \"not swipeable\".\n      const hasLeft = (leftRef.current?.length ?? 0) > 0;\n      const hasRight = (rightRef.current?.length ?? 0) > 0;\n      let next: number;\n      if (rawDx > 0) {\n        next = hasRight ? Math.min(maxDrag, rawDx) : rubberBand(rawDx, EMPTY_SIDE_RUBBER_PX);\n      } else if (rawDx < 0) {\n        next = hasLeft ? Math.max(-maxDrag, rawDx) : rubberBand(rawDx, EMPTY_SIDE_RUBBER_PX);\n      } else {\n        next = 0;\n      }\n      dxRef.current = next;\n      setDx(next);\n    },\n    [maxDrag, reset],\n  );\n\n  const onPointerUp = useCallback(\n    (e: PointerEvent) => {\n      if (pointerId.current !== e.pointerId) return;\n      const finalDx = dxRef.current;\n      const wasDragX = axis.current === \"x\";\n      reset();\n      if (!wasDragX) return;\n      if (finalDx > 0) {\n        const i = lastArmed(rightRef.current, finalDx);\n        if (i >= 0) rightRef.current![i].onCommit();\n      } else if (finalDx < 0) {\n        const i = lastArmed(leftRef.current, -finalDx);\n        if (i >= 0) leftRef.current![i].onCommit();\n      }\n    },\n    [reset],\n  );\n\n  const onPointerCancel = useCallback(() => reset(), [reset]);\n\n  const consumeClick = useCallback(() => {\n    if (swallowClick.current) {\n      swallowClick.current = false;\n      return true;\n    }\n    return false;\n  }, []);\n\n  return {\n    dx,\n    dragging,\n    armedRightIndex: lastArmed(rightStages, dx > 0 ? dx : 0),\n    armedLeftIndex: lastArmed(leftStages, dx < 0 ? -dx : 0),\n    handlers: { onPointerDown, onPointerMove, onPointerUp, onPointerCancel },\n    consumeClick,\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/hooks/use-row-swipe.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport type { PointerEvent } from \"react\";\n\n// ---------- Mobile swipe gesture ----------\n//\n// Multi-stage half-swipe affordance (feedback #103, extended #9): drag a row\n// horizontally to commit an action; how FAR you drag picks which action, so a\n// single gesture can walk a chain of increasingly involved outcomes (e.g. on a\n// cleared row, a short left-swipe un-clears it, further un-accepts it, further\n// still deletes it). We track via Pointer Events, lock the gesture to the X axis\n// only after the user has moved more horizontally than vertically, and clamp the\n// drag to `maxDrag` so the row can't be pulled across the whole viewport.\n//\n// Each side is an ordered list of stages sorted by ascending `threshold` (px of\n// drag magnitude). On release the LAST stage whose threshold the drag passed is\n// committed; while dragging, `armedRightIndex`/`armedLeftIndex` report which\n// stage is currently armed so the reveal panel can preview its label/colour.\n\nexport interface SwipeStage {\n  /** Drag magnitude (px) at which this stage arms. Stages must be sorted ascending. */\n  threshold: number;\n  onCommit: () => void;\n}\n\n/** Below this much horizontal travel a gesture is treated as a clumsy click, not\n *  a swipe: the row still follows the pointer, but the click that follows is NOT\n *  swallowed. Without it, `swallowClick` was set the instant the axis lock\n *  resolved to \"x\" — 8px — so a slightly-draggy click on a control INSIDE a\n *  swipeable row silently did nothing, which is a poor trade on rows whose\n *  content is itself interactive (Keksdose feedback #144: budget rows edit their\n *  assigned amount and their name by clicking them). */\nconst CLICK_SWALLOW_PX = 24;\n\n/** How far a drag may travel toward a side that has no actions. Zero — the old\n *  behaviour — makes the row completely inert in that direction, which reads as\n *  \"this row is not swipeable at all\" rather than \"there is nothing on this\n *  side\"; that is exactly the report behind Keksdose feedback #144 (\"tried, but\n *  there is nothing swipeable\"). A short, resisted travel that snaps back is the\n *  conventional answer and the one that answers the question the drag asked. */\nconst EMPTY_SIDE_RUBBER_PX = 28;\n\n/** Resistance applied past a bound: the row keeps moving, at a fraction of the\n *  pointer, so the gesture feels answered without ever looking committed. */\nfunction rubberBand(overshoot: number, limit: number): number {\n  const eased = limit * (1 - Math.exp(-Math.abs(overshoot) / limit));\n  return Math.sign(overshoot) * eased;\n}\n\nexport interface RowSwipeOptions {\n  enabled: boolean;\n  // Ordered stages per direction (ascending threshold). A longer drag commits a\n  // later — usually more involved — stage. An empty/undefined side means that\n  // direction rubber-bands a little and snaps back, committing nothing.\n  leftStages?: SwipeStage[];\n  rightStages?: SwipeStage[];\n  maxDrag?: number;\n}\n\nexport interface RowSwipeReturn {\n  dx: number;\n  dragging: boolean;\n  /** Highest armed stage index for the current drag (-1 when none armed). */\n  armedRightIndex: number;\n  armedLeftIndex: number;\n  handlers: {\n    onPointerDown: (e: PointerEvent) => void;\n    onPointerMove: (e: PointerEvent) => void;\n    onPointerUp: (e: PointerEvent) => void;\n    onPointerCancel: (e: PointerEvent) => void;\n  };\n  consumeClick: () => boolean;\n}\n\n/** The highest index whose threshold the magnitude has reached (-1 if none).\n *  Stages are ascending, so we can stop at the first one not yet reached. */\nfunction lastArmed(stages: SwipeStage[] | undefined, magnitude: number): number {\n  if (!stages) return -1;\n  let idx = -1;\n  for (let i = 0; i < stages.length; i++) {\n    if (magnitude >= stages[i].threshold) idx = i;\n    else break;\n  }\n  return idx;\n}\n\nexport function useRowSwipe({\n  enabled,\n  leftStages,\n  rightStages,\n  maxDrag = 252,\n}: RowSwipeOptions): RowSwipeReturn {\n  const [dx, setDx] = useState(0);\n  const [dragging, setDragging] = useState(false);\n  const startX = useRef(0);\n  const startY = useRef(0);\n  const axis = useRef<\"none\" | \"x\" | \"y\">(\"none\");\n  const pointerId = useRef<number | null>(null);\n  const dxRef = useRef(0);\n  // True after the user has dragged horizontally far enough that the following\n  // synthetic click should be swallowed (so a swipe doesn't also expand the row).\n  const swallowClick = useRef(false);\n\n  // Keep the latest stage arrays in refs so the memoised pointer handlers always\n  // commit against the current plan rather than a stale closure — the arrays and\n  // their onCommit closures are rebuilt on every render. Written in an effect (not\n  // during render) so it satisfies react-hooks/refs; pointer events fire after the\n  // commit, so the refs are always current by the time a gesture reads them.\n  const leftRef = useRef(leftStages);\n  const rightRef = useRef(rightStages);\n  useEffect(() => {\n    leftRef.current = leftStages;\n    rightRef.current = rightStages;\n  });\n\n  const reset = useCallback(() => {\n    setDx(0);\n    dxRef.current = 0;\n    setDragging(false);\n    startX.current = 0;\n    startY.current = 0;\n    axis.current = \"none\";\n    pointerId.current = null;\n  }, []);\n\n  const onPointerDown = useCallback(\n    (e: PointerEvent) => {\n      if (!enabled) return;\n      if (e.pointerType === \"mouse\" && e.button !== 0) return;\n      pointerId.current = e.pointerId;\n      startX.current = e.clientX;\n      startY.current = e.clientY;\n      axis.current = \"none\";\n      swallowClick.current = false;\n      setDragging(true);\n    },\n    [enabled],\n  );\n\n  const onPointerMove = useCallback(\n    (e: PointerEvent) => {\n      if (pointerId.current !== e.pointerId) return;\n      const rawDx = e.clientX - startX.current;\n      const rawDy = e.clientY - startY.current;\n      if (axis.current === \"none\") {\n        if (Math.abs(rawDx) < 8 && Math.abs(rawDy) < 8) return;\n        axis.current = Math.abs(rawDx) > Math.abs(rawDy) ? \"x\" : \"y\";\n        if (axis.current === \"x\") {\n          (e.currentTarget as Element).setPointerCapture?.(e.pointerId);\n        } else {\n          // Vertical scroll wins — bail out of the gesture entirely.\n          reset();\n          return;\n        }\n      }\n      if (axis.current !== \"x\") return;\n      if (Math.abs(rawDx) >= CLICK_SWALLOW_PX) swallowClick.current = true;\n      // Toward a side that HAS actions the row tracks the pointer up to maxDrag.\n      // Toward an empty one it rubber-bands a little and snaps back on release —\n      // inert would be indistinguishable from \"not swipeable\".\n      const hasLeft = (leftRef.current?.length ?? 0) > 0;\n      const hasRight = (rightRef.current?.length ?? 0) > 0;\n      let next: number;\n      if (rawDx > 0) {\n        next = hasRight ? Math.min(maxDrag, rawDx) : rubberBand(rawDx, EMPTY_SIDE_RUBBER_PX);\n      } else if (rawDx < 0) {\n        next = hasLeft ? Math.max(-maxDrag, rawDx) : rubberBand(rawDx, EMPTY_SIDE_RUBBER_PX);\n      } else {\n        next = 0;\n      }\n      dxRef.current = next;\n      setDx(next);\n    },\n    [maxDrag, reset],\n  );\n\n  const onPointerUp = useCallback(\n    (e: PointerEvent) => {\n      if (pointerId.current !== e.pointerId) return;\n      const finalDx = dxRef.current;\n      const wasDragX = axis.current === \"x\";\n      reset();\n      if (!wasDragX) return;\n      if (finalDx > 0) {\n        const i = lastArmed(rightRef.current, finalDx);\n        if (i >= 0) rightRef.current![i].onCommit();\n      } else if (finalDx < 0) {\n        const i = lastArmed(leftRef.current, -finalDx);\n        if (i >= 0) leftRef.current![i].onCommit();\n      }\n    },\n    [reset],\n  );\n\n  const onPointerCancel = useCallback(() => reset(), [reset]);\n\n  const consumeClick = useCallback(() => {\n    if (swallowClick.current) {\n      swallowClick.current = false;\n      return true;\n    }\n    return false;\n  }, []);\n\n  return {\n    dx,\n    dragging,\n    armedRightIndex: lastArmed(rightStages, dx > 0 ? dx : 0),\n    armedLeftIndex: lastArmed(leftStages, dx < 0 ? -dx : 0),\n    handlers: { onPointerDown, onPointerMove, onPointerUp, onPointerCancel },\n    consumeClick,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/i18n/defaults.d.ts

@@ -0,0 +1,31 @@
+import { UiKitLabels } from './kit-labels.js';
+import 'react';
+import '../components/data-table-labels.js';
+import '../components/mini-calendar.js';
+import '../components/popover.js';
+import '../components/chip.js';
+import 'lucide-react';
+import '../components/field-sync.js';
+import '../components/ui.js';
+import '../wizard/types.js';
+import '../tour/tour.js';
+import '../search/command-palette.js';
+import '../components/month-picker.js';
+import '../components/page-contents.js';
+import '../components/series-chart-labels.js';
+import '../components/sparkline.js';
+import '../components/stat-tile.js';
+import '../components/signature-pad.js';
+import '../components/password-strength.js';
+
+/**
+ * The whole English tree in one object: what a translation is written against, and
+ * the `reference` for {@link missingKitLabels}.
+ *
+ * A separate module from the provider on purpose. Components import the provider's
+ * hooks; this file imports the components' defaults. Kept together they would be an
+ * import cycle through every component in the kit.
+ */
+declare const DEFAULT_UI_KIT_LABELS: UiKitLabels;
+
+export { DEFAULT_UI_KIT_LABELS };

package/dist/i18n/defaults.js

@@ -0,0 +1,63 @@
+"use client";
+import { DEFAULT_DATA_TABLE_LABELS } from "../components/data-table-labels.js";
+import { DEFAULT_MINI_CALENDAR_LABELS } from "../components/mini-calendar.js";
+import { DEFAULT_MONTH_PICKER_LABELS } from "../components/month-picker.js";
+import { DEFAULT_PAGE_CONTENTS_LABELS } from "../components/page-contents.js";
+import { DEFAULT_POPOVER_LABELS } from "../components/popover.js";
+import { DEFAULT_CHIP_INPUT_LABELS } from "../components/chip.js";
+import { DEFAULT_FIELD_SYNC_LABELS } from "../components/field-sync.js";
+import { DEFAULT_PASSWORD_REVEAL_LABELS } from "../components/ui.js";
+import { DEFAULT_WIZARD_LABELS } from "../wizard/types.js";
+import { DEFAULT_TOUR_LABELS } from "../tour/tour.js";
+import { DEFAULT_COMMAND_PALETTE_LABELS } from "../search/command-palette.js";
+import { DEFAULT_SERIES_CHART_LABELS } from "../components/series-chart-labels.js";
+import { DEFAULT_SPARKLINE_LABELS } from "../components/sparkline.js";
+import { DEFAULT_STAT_TILE_LABELS } from "../components/stat-tile.js";
+import { DEFAULT_SIGNATURE_PAD_LABELS } from "../components/signature-pad.js";
+import { DEFAULT_PASSWORD_STRENGTH_LABELS } from "../components/password-strength.js";
+import {
+  DEFAULT_APP_SHELL_LABELS,
+  DEFAULT_CALCULATOR_LABELS,
+  DEFAULT_COMBOBOX_LABELS,
+  DEFAULT_COMMON_LABELS,
+  DEFAULT_CURRENCY_LABELS,
+  DEFAULT_DATE_PICKER_LABELS,
+  DEFAULT_FILE_LABELS,
+  DEFAULT_MULTI_SELECT_LABELS,
+  DEFAULT_PICKER_SHEET_LABELS,
+  DEFAULT_SWIPEABLE_ROW_LABELS,
+  DEFAULT_TOP_BAR_LABELS
+} from "./kit-labels.js";
+const DEFAULT_UI_KIT_LABELS = {
+  common: DEFAULT_COMMON_LABELS,
+  dataTable: DEFAULT_DATA_TABLE_LABELS,
+  miniCalendar: DEFAULT_MINI_CALENDAR_LABELS,
+  datePicker: DEFAULT_DATE_PICKER_LABELS,
+  monthPicker: DEFAULT_MONTH_PICKER_LABELS,
+  popover: DEFAULT_POPOVER_LABELS,
+  combobox: DEFAULT_COMBOBOX_LABELS,
+  multiSelect: DEFAULT_MULTI_SELECT_LABELS,
+  calculator: DEFAULT_CALCULATOR_LABELS,
+  currency: DEFAULT_CURRENCY_LABELS,
+  chipInput: DEFAULT_CHIP_INPUT_LABELS,
+  fieldSync: DEFAULT_FIELD_SYNC_LABELS,
+  passwordReveal: DEFAULT_PASSWORD_REVEAL_LABELS,
+  appShell: DEFAULT_APP_SHELL_LABELS,
+  pageContents: DEFAULT_PAGE_CONTENTS_LABELS,
+  topBar: DEFAULT_TOP_BAR_LABELS,
+  pickerSheet: DEFAULT_PICKER_SHEET_LABELS,
+  swipeableRow: DEFAULT_SWIPEABLE_ROW_LABELS,
+  file: DEFAULT_FILE_LABELS,
+  wizard: DEFAULT_WIZARD_LABELS,
+  tour: DEFAULT_TOUR_LABELS,
+  commandPalette: DEFAULT_COMMAND_PALETTE_LABELS,
+  seriesChart: DEFAULT_SERIES_CHART_LABELS,
+  sparkline: DEFAULT_SPARKLINE_LABELS,
+  statTile: DEFAULT_STAT_TILE_LABELS,
+  signaturePad: DEFAULT_SIGNATURE_PAD_LABELS,
+  passwordStrength: DEFAULT_PASSWORD_STRENGTH_LABELS
+};
+export {
+  DEFAULT_UI_KIT_LABELS
+};
+//# sourceMappingURL=defaults.js.map

package/dist/i18n/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/i18n/defaults.ts"],"sourcesContent":["import { DEFAULT_DATA_TABLE_LABELS } from \"../components/data-table-labels\";\nimport { DEFAULT_MINI_CALENDAR_LABELS } from \"../components/mini-calendar\";\nimport { DEFAULT_MONTH_PICKER_LABELS } from \"../components/month-picker\";\nimport { DEFAULT_PAGE_CONTENTS_LABELS } from \"../components/page-contents\";\nimport { DEFAULT_POPOVER_LABELS } from \"../components/popover\";\nimport { DEFAULT_CHIP_INPUT_LABELS } from \"../components/chip\";\nimport { DEFAULT_FIELD_SYNC_LABELS } from \"../components/field-sync\";\nimport { DEFAULT_PASSWORD_REVEAL_LABELS } from \"../components/ui\";\nimport { DEFAULT_WIZARD_LABELS } from \"../wizard/types\";\nimport { DEFAULT_TOUR_LABELS } from \"../tour/tour\";\nimport { DEFAULT_COMMAND_PALETTE_LABELS } from \"../search/command-palette\";\nimport { DEFAULT_SERIES_CHART_LABELS } from \"../components/series-chart-labels\";\nimport { DEFAULT_SPARKLINE_LABELS } from \"../components/sparkline\";\nimport { DEFAULT_STAT_TILE_LABELS } from \"../components/stat-tile\";\nimport { DEFAULT_SIGNATURE_PAD_LABELS } from \"../components/signature-pad\";\nimport { DEFAULT_PASSWORD_STRENGTH_LABELS } from \"../components/password-strength\";\nimport {\n  DEFAULT_APP_SHELL_LABELS,\n  DEFAULT_CALCULATOR_LABELS,\n  DEFAULT_COMBOBOX_LABELS,\n  DEFAULT_COMMON_LABELS,\n  DEFAULT_CURRENCY_LABELS,\n  DEFAULT_DATE_PICKER_LABELS,\n  DEFAULT_FILE_LABELS,\n  DEFAULT_MULTI_SELECT_LABELS,\n  DEFAULT_PICKER_SHEET_LABELS,\n  DEFAULT_SWIPEABLE_ROW_LABELS,\n  DEFAULT_TOP_BAR_LABELS,\n} from \"./kit-labels\";\nimport type { UiKitLabels } from \"./kit-labels\";\n\n/**\n * The whole English tree in one object: what a translation is written against, and\n * the `reference` for {@link missingKitLabels}.\n *\n * A separate module from the provider on purpose. Components import the provider's\n * hooks; this file imports the components' defaults. Kept together they would be an\n * import cycle through every component in the kit.\n */\nexport const DEFAULT_UI_KIT_LABELS: UiKitLabels = {\n  common: DEFAULT_COMMON_LABELS,\n  dataTable: DEFAULT_DATA_TABLE_LABELS,\n  miniCalendar: DEFAULT_MINI_CALENDAR_LABELS,\n  datePicker: DEFAULT_DATE_PICKER_LABELS,\n  monthPicker: DEFAULT_MONTH_PICKER_LABELS,\n  popover: DEFAULT_POPOVER_LABELS,\n  combobox: DEFAULT_COMBOBOX_LABELS,\n  multiSelect: DEFAULT_MULTI_SELECT_LABELS,\n  calculator: DEFAULT_CALCULATOR_LABELS,\n  currency: DEFAULT_CURRENCY_LABELS,\n  chipInput: DEFAULT_CHIP_INPUT_LABELS,\n  fieldSync: DEFAULT_FIELD_SYNC_LABELS,\n  passwordReveal: DEFAULT_PASSWORD_REVEAL_LABELS,\n  appShell: DEFAULT_APP_SHELL_LABELS,\n  pageContents: DEFAULT_PAGE_CONTENTS_LABELS,\n  topBar: DEFAULT_TOP_BAR_LABELS,\n  pickerSheet: DEFAULT_PICKER_SHEET_LABELS,\n  swipeableRow: DEFAULT_SWIPEABLE_ROW_LABELS,\n  file: DEFAULT_FILE_LABELS,\n  wizard: DEFAULT_WIZARD_LABELS,\n  tour: DEFAULT_TOUR_LABELS,\n  commandPalette: DEFAULT_COMMAND_PALETTE_LABELS,\n  seriesChart: DEFAULT_SERIES_CHART_LABELS,\n  sparkline: DEFAULT_SPARKLINE_LABELS,\n  statTile: DEFAULT_STAT_TILE_LABELS,\n  signaturePad: DEFAULT_SIGNATURE_PAD_LABELS,\n  passwordStrength: DEFAULT_PASSWORD_STRENGTH_LABELS,\n};\n"],"mappings":";AAAA,SAAS,iCAAiC;AAC1C,SAAS,oCAAoC;AAC7C,SAAS,mCAAmC;AAC5C,SAAS,oCAAoC;AAC7C,SAAS,8BAA8B;AACvC,SAAS,iCAAiC;AAC1C,SAAS,iCAAiC;AAC1C,SAAS,sCAAsC;AAC/C,SAAS,6BAA6B;AACtC,SAAS,2BAA2B;AACpC,SAAS,sCAAsC;AAC/C,SAAS,mCAAmC;AAC5C,SAAS,gCAAgC;AACzC,SAAS,gCAAgC;AACzC,SAAS,oCAAoC;AAC7C,SAAS,wCAAwC;AACjD;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAWA,MAAM,wBAAqC;AAAA,EAChD,QAAQ;AAAA,EACR,WAAW;AAAA,EACX,cAAc;AAAA,EACd,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,SAAS;AAAA,EACT,UAAU;AAAA,EACV,aAAa;AAAA,EACb,YAAY;AAAA,EACZ,UAAU;AAAA,EACV,WAAW;AAAA,EACX,WAAW;AAAA,EACX,gBAAgB;AAAA,EAChB,UAAU;AAAA,EACV,cAAc;AAAA,EACd,QAAQ;AAAA,EACR,aAAa;AAAA,EACb,cAAc;AAAA,EACd,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,gBAAgB;AAAA,EAChB,aAAa;AAAA,EACb,WAAW;AAAA,EACX,UAAU;AAAA,EACV,cAAc;AAAA,EACd,kBAAkB;AACpB;","names":[]}

package/dist/i18n/kit-labels.d.ts

@@ -0,0 +1,250 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { DataTableLabels } from '../components/data-table-labels.js';
+import { MiniCalendarLabels } from '../components/mini-calendar.js';
+import { PopoverLabels } from '../components/popover.js';
+import { ChipInputLabels } from '../components/chip.js';
+import { FieldSyncLabels } from '../components/field-sync.js';
+import { PasswordRevealLabels } from '../components/ui.js';
+import { WizardLabels } from '../wizard/types.js';
+import { TourLabels } from '../tour/tour.js';
+import { CommandPaletteLabels } from '../search/command-palette.js';
+import { MonthPickerLabels } from '../components/month-picker.js';
+import { PageContentsLabels } from '../components/page-contents.js';
+import { SeriesChartLabels } from '../components/series-chart-labels.js';
+import { SparklineLabels } from '../components/sparkline.js';
+import { StatTileLabels } from '../components/stat-tile.js';
+import { SignaturePadLabels } from '../components/signature-pad.js';
+import { PasswordStrengthLabels } from '../components/password-strength.js';
+import 'lucide-react';
+
+/**
+ * EVERY string the kit renders, as one typed tree — and an optional provider that
+ * hands it to every component at once.
+ *
+ * WHY THIS EXISTS. The kit ships no catalogue and resolves no strings, and that stays
+ * true: the app supplies every word. What was wrong was HOW it had to supply them —
+ * one `labels` prop per component instance, under a different prop name per
+ * component (`labels`, `calendarLabels`, `passwordLabels`, `clearLabel`,
+ * `searchPlaceholder`, `ariaLabel` …). A translated app therefore rendered English
+ * wherever one call site forgot one prop, and nothing told it so: a German showcase
+ * still said "Rows per page", "Collapse sidebar" and "Popover" in seven languages.
+ *
+ * Now there is one key per string, addressed by a dot path (`dataTable.pageSize`,
+ * `datePicker.today`), and three sources in a fixed order of precedence:
+ *
+ *     the component's own prop   >   <UiKitProvider labels>   >   English default
+ *
+ * A consumer writes its translation ONCE, as a `UiKitLabels` (or a partial of it),
+ * mounts `<UiKitProvider labels={…} locale={…}>` at the root, and every kit component
+ * below speaks that language — including the ones nested inside other kit components
+ * (the calendar inside the data table's date filter, the popover inside the date
+ * picker), which no prop at the outer call site could reach before.
+ *
+ * Messages that carry a value are FUNCTIONS of that value, never a template to fill:
+ * a number glued into an English sentence is untranslatable, because the grammar
+ * around it moves with it in most languages.
+ */
+/** The words several components share. A component's own namespace wins over these
+ *  where both exist; these are what a new component reaches for first. */
+interface CommonLabels {
+    close: string;
+    clear: string;
+    search: string;
+    done: string;
+    cancel: string;
+    save: string;
+    back: string;
+    next: string;
+    remove: string;
+    loading: string;
+    noResults: string;
+    /** "Name: value" — how a field's accessible name is composed with its value.
+     *  A colon-and-space is not universal punctuation (French puts a space before
+     *  the colon, Chinese uses a full-width one). */
+    fieldValue: (field: string, value: string) => string;
+}
+/** `DatePicker` / `DateRangePicker` chrome. The calendar inside has its own
+ *  namespace, `miniCalendar`. */
+interface DatePickerLabels {
+    /** Accessible name of the popover panel the calendar opens in. */
+    panel: string;
+    /** The same, for `DateRangePicker`'s panel. */
+    rangePanel: string;
+    clear: string;
+    previousDay: string;
+    nextDay: string;
+    today: string;
+}
+/** The whole combobox family: `Combobox`, `EntityCombobox`,
+ *  `MultiEntityCombobox`, `InlineEntityCombobox`. */
+interface ComboboxLabels {
+    search: string;
+    noResults: string;
+    clear: string;
+    loading: string;
+    /** The "add this" row when free entry is allowed. */
+    create: (query: string) => string;
+    /** Trigger summary once more than one value is picked. */
+    selectedCount: (count: number) => string;
+}
+interface MultiSelectLabels {
+    search: string;
+    selectAll: string;
+    clear: string;
+    /** Trigger text when nothing is picked, which a multi-select reads as "all". */
+    all: string;
+    /** Trigger summary once some (but not all) values are picked. The English
+     *  default is the bare count, which is what the trigger has always shown. */
+    selectedCount: (count: number) => string;
+}
+/** `CalculatorButton` (desktop popover keypad) and `NumberPadSheet` (phone sheet). */
+interface CalculatorLabels {
+    /** The button that opens the calculator. */
+    open: string;
+    /** The popover / sheet itself. */
+    panel: string;
+    calculation: string;
+    backspace: string;
+    clear: string;
+    equals: string;
+    /** The primary key of the phone pad — visible text, not an aria-label. */
+    done: string;
+    /** Names of the operator keys and the decimal key. Their glyphs are not names a
+     *  screen reader agrees on — "÷" is read as "division sign", "divided by" or
+     *  nothing at all depending on the reader — so each says what it does. */
+    plus: string;
+    minus: string;
+    times: string;
+    divide: string;
+    decimal: string;
+}
+/** `CurrencySelect` and the currency half of `AmountInput`. */
+interface CurrencyLabels {
+    currency: string;
+    search: string;
+}
+interface AppShellLabels {
+    collapse: string;
+    expand: string;
+    /** Accessible name of an inline group's disclosure button (`subNav="inline"`). */
+    toggleGroup: (groupLabel: string) => string;
+}
+interface TopBarLabels {
+    theme: string;
+    palette: string;
+    language: string;
+    switchRole: string;
+    /** The role switcher's tooltip, given the active role's name. */
+    role: (value: string) => string;
+}
+interface PickerSheetLabels {
+    close: string;
+}
+interface SwipeableRowLabels {
+    actions: string;
+}
+interface FileLabels {
+    /** A file size for display, given its size in BYTES. The default uses
+     *  `Intl.NumberFormat`'s unit formatting in the provider's locale. */
+    size: (bytes: number) => string;
+}
+/** The complete tree. `UiKitProvider` takes any partial of it. */
+interface UiKitLabels {
+    common: CommonLabels;
+    dataTable: DataTableLabels;
+    miniCalendar: MiniCalendarLabels;
+    datePicker: DatePickerLabels;
+    monthPicker: MonthPickerLabels;
+    popover: PopoverLabels;
+    combobox: ComboboxLabels;
+    multiSelect: MultiSelectLabels;
+    calculator: CalculatorLabels;
+    currency: CurrencyLabels;
+    chipInput: ChipInputLabels;
+    fieldSync: FieldSyncLabels;
+    passwordReveal: PasswordRevealLabels;
+    appShell: AppShellLabels;
+    pageContents: PageContentsLabels;
+    topBar: TopBarLabels;
+    pickerSheet: PickerSheetLabels;
+    swipeableRow: SwipeableRowLabels;
+    file: FileLabels;
+    wizard: WizardLabels;
+    tour: TourLabels;
+    commandPalette: CommandPaletteLabels;
+    seriesChart: SeriesChartLabels;
+    sparkline: SparklineLabels;
+    statTile: StatTileLabels;
+    signaturePad: SignaturePadLabels;
+    passwordStrength: PasswordStrengthLabels;
+}
+/** Any subset of the tree, one level deep — each namespace may be partial, and a
+ *  namespace that holds a record (`dataTable.presets`) is merged key by key. */
+type UiKitLabelOverrides = {
+    [K in keyof UiKitLabels]?: Partial<UiKitLabels[K]>;
+};
+declare const DEFAULT_COMMON_LABELS: CommonLabels;
+declare const DEFAULT_DATE_PICKER_LABELS: DatePickerLabels;
+declare const DEFAULT_COMBOBOX_LABELS: ComboboxLabels;
+declare const DEFAULT_MULTI_SELECT_LABELS: MultiSelectLabels;
+declare const DEFAULT_CALCULATOR_LABELS: CalculatorLabels;
+declare const DEFAULT_CURRENCY_LABELS: CurrencyLabels;
+declare const DEFAULT_APP_SHELL_LABELS: AppShellLabels;
+declare const DEFAULT_TOP_BAR_LABELS: TopBarLabels;
+declare const DEFAULT_PICKER_SHEET_LABELS: PickerSheetLabels;
+declare const DEFAULT_SWIPEABLE_ROW_LABELS: SwipeableRowLabels;
+/** Formats with the locale the provider was given (see {@link useKitFileLabels}).
+ *  This static default has no locale to hand and falls back to the runtime's. */
+declare const DEFAULT_FILE_LABELS: FileLabels;
+/** "12 kB", "3.4 MB" — `Intl`'s unit formatting, so the digits, the decimal mark and
+ *  the unit's spelling all follow `locale`. */
+declare function formatFileSize(bytes: number, locale?: string): string;
+interface UiKitProviderProps {
+    /** Any part of {@link UiKitLabels}. Missing keys fall back to English. */
+    labels?: UiKitLabelOverrides;
+    /**
+     * BCP 47 tag used by every kit component that formats something — dates, numbers,
+     * month and weekday names, file sizes — when it is not handed a `locale` prop of
+     * its own. Without a provider, and without a prop, those use the runtime default.
+     */
+    locale?: string;
+    children: ReactNode;
+}
+/**
+ * Hand every kit component below this point its strings and its locale.
+ *
+ * Optional: a component outside any provider behaves exactly as it did before the
+ * provider existed. Nesting works as a merge — an inner provider overrides only what
+ * it names, so a page can re-label one table's `dataTable.table` without restating
+ * the language.
+ */
+declare function UiKitProvider({ labels, locale, children }: UiKitProviderProps): react.JSX.Element;
+/** What the nearest provider says about one namespace — `undefined` outside one.
+ *  For a component whose own resolver does more than a merge (the data table
+ *  derives `columnsCount` from `columns`): feed `{ ...overrides, ...props }` to it. */
+declare function useKitLabelOverrides<K extends keyof UiKitLabels>(ns: K): Partial<UiKitLabels[K]> | undefined;
+/**
+ * One namespace, resolved: `defaults`, then the provider, then the component's own
+ * `prop`. Record-valued keys are merged key by key at each step.
+ */
+declare function useKitLabels<K extends keyof UiKitLabels>(ns: K, defaults: UiKitLabels[K], prop?: Partial<UiKitLabels[K]>): UiKitLabels[K];
+/** The component's own `locale` prop, else the provider's, else `undefined` (which
+ *  every `Intl` API reads as "the runtime's default"). */
+declare function useKitLocale(prop?: string): string | undefined;
+/** {@link DEFAULT_FILE_LABELS}, but formatting in the provider's locale. */
+declare function useKitFileLabels(prop?: Partial<FileLabels>): FileLabels;
+/**
+ * The dot paths of every key `labels` does NOT supply — the ones a translated app is
+ * still showing in English. Assert on it in the app's own test:
+ *
+ *     expect(missingKitLabels(de)).toEqual([]);
+ *
+ * `reference` is the complete tree to check against — pass
+ * {@link DEFAULT_UI_KIT_LABELS} (src/i18n/defaults.ts). It is a parameter rather than an import
+ * because the defaults live beside their components, and this module is imported BY
+ * those components.
+ */
+declare function missingKitLabels(labels: UiKitLabelOverrides | undefined, reference: UiKitLabels): string[];
+
+export { type AppShellLabels, type CalculatorLabels, type ComboboxLabels, type CommonLabels, type CurrencyLabels, DEFAULT_APP_SHELL_LABELS, DEFAULT_CALCULATOR_LABELS, DEFAULT_COMBOBOX_LABELS, DEFAULT_COMMON_LABELS, DEFAULT_CURRENCY_LABELS, DEFAULT_DATE_PICKER_LABELS, DEFAULT_FILE_LABELS, DEFAULT_MULTI_SELECT_LABELS, DEFAULT_PICKER_SHEET_LABELS, DEFAULT_SWIPEABLE_ROW_LABELS, DEFAULT_TOP_BAR_LABELS, type DatePickerLabels, type FileLabels, type MultiSelectLabels, type PickerSheetLabels, type SwipeableRowLabels, type TopBarLabels, type UiKitLabelOverrides, type UiKitLabels, UiKitProvider, type UiKitProviderProps, formatFileSize, missingKitLabels, useKitFileLabels, useKitLabelOverrides, useKitLabels, useKitLocale };