@eifi1/ui-kit 0.54.0 → 0.56.0

package/dist/lib/changelog.js

@@ -0,0 +1,137 @@
+"use client";
+const COMMIT_LINK = /\s*\(\[[0-9a-f]{4,40}\]\([^)]*\)\)/gi;
+const TRAILING_REFS = /(?:(?:,\s*\b(?:close[sd]?|fix(?:e[sd])?|resolve[sd]?|references?)(?:\s*\[[^\]]*#\d+\]\([^)]*\))+)+|(?:\s*\[[^\]]*#\d+\]\([^)]*\))+)\s*$/i;
+const SCOPE = /^\*\*([^*:]+?)(?::\*\*|\*\*:)\s*/;
+const INLINE_LINK = /\[([^\]]+)\]\([^)]*\)/g;
+function parseChangelogItem(line) {
+  let text = line.replace(COMMIT_LINK, "").replace(TRAILING_REFS, "");
+  let scope = null;
+  const scoped = SCOPE.exec(text);
+  if (scoped) {
+    scope = plain(scoped[1]).trim();
+    text = text.slice(scoped[0].length);
+  }
+  text = plain(text).replace(/\s+([,.;:])(?=\s|$)/g, "$1").replace(/\s{2,}/g, " ").replace(/[,;:]+\s*$/, "").trim();
+  return { scope, text };
+}
+function plain(markdown) {
+  return markdown.replace(INLINE_LINK, "$1").replace(/\*\*(.+?)\*\*/g, "$1").replace(/`([^`]+)`/g, "$1");
+}
+function groupByScope(items) {
+  const groups = /* @__PURE__ */ new Map();
+  const seen = /* @__PURE__ */ new Set();
+  for (const raw of items) {
+    const { scope, text } = typeof raw === "string" ? parseChangelogItem(raw) : raw;
+    if (!text) continue;
+    const repeat = `${scope ?? ""}\0${text.toLowerCase()}`;
+    if (seen.has(repeat)) continue;
+    seen.add(repeat);
+    const group = groups.get(scope ?? "") ?? { scope, texts: [] };
+    group.texts.push(text);
+    groups.set(scope ?? "", group);
+  }
+  return [...groups.values()];
+}
+const SECTION_NAMES = {
+  breaking: ["breaking changes", "breaking"],
+  added: ["added", "features", "feat"],
+  changed: ["changed", "performance improvements", "performance", "code refactoring"],
+  fixed: ["fixed", "bug fixes", "fixes"],
+  deprecated: ["deprecated"],
+  removed: ["removed"],
+  security: ["security"],
+  reverted: ["reverts", "reverted"]
+};
+const SECTION_KEYS = new Map(
+  Object.entries(SECTION_NAMES).flatMap(([key, names]) => names.map((name) => [name, key]))
+);
+function changelogSectionKey(title) {
+  const name = title.toLowerCase().replace(/^[^\p{L}]+/u, "").split(/\s+[—–-]\s+|\s*\(/)[0].trim();
+  return SECTION_KEYS.get(name) ?? null;
+}
+const VERSION = String.raw`\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.+-]*)?`;
+const RELEASE_HEADING = new RegExp(String.raw`^#{2,3}\s+(?:\[(${VERSION})\](?:\([^)]*\))?|(${VERSION}))(.*)$`);
+const DATE = /(?:^|[^\d-])(\d{4}-\d{2}-\d{2})(?![\d-])/;
+const HEADING = /^(#{1,6})\s+(.*?)\s*#*\s*$/;
+const BULLET = /^[*-]\s+(.*)$/;
+const NESTED_BULLET = /^\s+[*-]\s+/;
+const FENCE = /^\s*(`{3,}|~{3,})/;
+function parseChangelog(markdown) {
+  const releases = [];
+  let release = null;
+  let sections = [];
+  let section = null;
+  let body = [];
+  let open = null;
+  let fence = null;
+  const close = () => {
+    if (!release) return;
+    release.body = body.join("\n").trim() || null;
+    release.sections = sections.map((s) => ({
+      title: s.title,
+      key: changelogSectionKey(s.title),
+      items: s.bullets.map(parseChangelogItem).filter((item) => item.text !== "")
+    })).filter((s) => s.items.length > 0);
+    releases.push(release);
+    release = null;
+  };
+  for (const raw of markdown.split(/\r?\n/)) {
+    const line = raw.trimEnd();
+    if (fence !== null) {
+      if (line.trimStart().startsWith(fence)) fence = null;
+      continue;
+    }
+    const fenced = FENCE.exec(line);
+    if (fenced) {
+      fence = fenced[1];
+      open = null;
+      continue;
+    }
+    const heading = HEADING.exec(line);
+    if (heading) {
+      open = null;
+      const released = RELEASE_HEADING.exec(line);
+      if (released) {
+        close();
+        const [, bracketed, bare, rest] = released;
+        release = { version: bracketed ?? bare, date: DATE.exec(rest)?.[1] ?? null, sections: [], body: null };
+        sections = [];
+        section = null;
+        body = [];
+      } else if (heading[1].length <= 2) {
+        close();
+      } else if (heading[1].length === 3 && release) {
+        section = { title: heading[2], bullets: [] };
+        sections.push(section);
+      }
+      continue;
+    }
+    if (!release) continue;
+    if (line.trim() === "") {
+      open = null;
+      if (!section) body.push("");
+      continue;
+    }
+    if (!section) {
+      body.push(line);
+      continue;
+    }
+    const bullet = BULLET.exec(line);
+    if (bullet) {
+      open = section.bullets.push(bullet[1]) - 1;
+    } else if (NESTED_BULLET.test(line)) {
+      open = null;
+    } else if (open !== null) {
+      section.bullets[open] += ` ${line.trim()}`;
+    }
+  }
+  close();
+  return releases;
+}
+export {
+  changelogSectionKey,
+  groupByScope,
+  parseChangelog,
+  parseChangelogItem
+};
+//# sourceMappingURL=changelog.js.map

package/dist/lib/changelog.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/changelog.ts"],"sourcesContent":["/**\n * Reading a generated changelog for a person (kastlan reuse audit 2026-11-02, proposal 1).\n *\n * All four repositories write CHANGELOG.md with `commit-and-tag-version`, and two apps\n * show it: keksdose on its changelog page and in the what's-new dialog (its backend\n * splits the file into releases, `changelog-format.ts` reads each bullet), kastlan on its\n * changelog page (`parse-changelog.ts`). kastlan's parser read the compare link's \"(\" as\n * the release date, so every release showed a GitHub URL, and left `**scope:**` and\n * `, closes [#12](…)` in the text. It fixed that with keksdose's rules (kastlan 153248c),\n * and those rules are here once, with what the four files still asked of them:\n *\n * ```\n * ## [0.13.9](https://github.com/…/compare/v0.13.8...v0.13.9) (2026-10-20)\n *\n * ### Added\n *\n * * **admin:** a company rename logs both names again ([8f698eb](https://…/commit/8f698eb…)), closes [#12](…)\n * ```\n *\n * reads as `{ version: \"0.13.9\", date: \"2026-10-20\", sections: [{ title: \"Added\", key:\n * \"added\", items: [{ scope: \"admin\", text: \"a company rename logs both names again\" }] }] }`.\n *\n *  - **Every heading shape the tool writes**: `## [x.y.z](compare) (date)`, the `###` it\n *    writes for a patch under the default template, and `## x.y.z (date)` without a link\n *    (the first release, which has nothing to compare with). The compare link is skipped\n *    before the date is read, and a date is `YYYY-MM-DD` or nothing. The hand-written\n *    shapes before a repository adopted the tool read too: `## [0.2.0] - 2026-04-10`,\n *    `## [0.6.1] — 2026-09-24`.\n *  - **One key per kind of section**, whichever names the repository's `.versionrc`\n *    gives it: \"Added\", \"Fixed\", \"Changed\" (the kit's, kastlan's, Kurvenschmiede's) and\n *    \"Features\", \"Bug Fixes\", \"Performance Improvements\" (the default preset's; keksdose\n *    writes \"Performance\") are the same three ({@link changelogSectionKey}).\n *  - **An item is its sentence**: the scope comes out as a value, the commit link and the\n *    trailing references go, and the rest of the markdown is resolved\n *    ({@link parseChangelogItem}).\n *  - **An item is all its lines**: a breaking change's note that runs on over several\n *    lines is one item, where both apps' parsers kept its first line (\"…the beta\n *    allow-list and profile routes are\").\n *\n * Pure string work, no React: the page that shows it is the app's.\n */\n\n/**\n * What a section's heading means, whichever preset named it. `null` from\n * {@link changelogSectionKey} for a heading no preset writes (\"Known\", say): show its own\n * title then, rather than hide it behind a missing translation.\n */\nexport type ChangelogSectionKey =\n  \"breaking\" | \"added\" | \"changed\" | \"fixed\" | \"deprecated\" | \"removed\" | \"security\" | \"reverted\";\n\n/** One bullet: its conventional-commit scope and its sentence. */\nexport interface ChangelogItem {\n  /** `**admin:**` → `\"admin\"`; `null` for a bullet with no scope. */\n  scope: string | null;\n  /** The sentence, without the commit link, the trailing references or any markdown. */\n  text: string;\n}\n\n/** One `###` section of a release. */\nexport interface ChangelogSection {\n  /** The heading as written: \"Added\", \"Bug Fixes\", \"⚠ BREAKING CHANGES\". */\n  title: string;\n  /** {@link changelogSectionKey} of the title. */\n  key: ChangelogSectionKey | null;\n  /** Never empty: a section whose bullets all read as nothing is left out. */\n  items: ChangelogItem[];\n}\n\n/** One release, as the file lists them: newest first. */\nexport interface ChangelogRelease {\n  /** `\"0.13.9\"`, without brackets. */\n  version: string;\n  /** The release day, `YYYY-MM-DD`, or `null` when the heading carries none. */\n  date: string | null;\n  sections: ChangelogSection[];\n  /** The prose between the heading and the first section, as written; `null` when there\n   *  is none. A hand-written release can carry its notes here alone. */\n  body: string | null;\n}\n\n/** The items of one scope, from {@link groupByScope}. */\nexport interface ChangelogScopeGroup {\n  scope: string | null;\n  texts: string[];\n}\n\n// ── Items ─────────────────────────────────────────────────────────────────────\n\n/** `([abc1234](https://…/commit/…))`, the generator's commit link. Four hex digits at\n *  least, git's shortest abbreviation. */\nconst COMMIT_LINK = /\\s*\\(\\[[0-9a-f]{4,40}\\]\\([^)]*\\)\\)/gi;\n\n/**\n * The trailing references, to the end of the line: every `, closes …` clause with EVERY\n * link to an issue after its word, or a run of such links with no word. Anchored at the\n * end, because a link inside the sentence is prose the author wrote; the run at the end\n * is machinery. `[^\\]]*#\\d+` reads `#455`, `dev#435` and `Eifi1/ui-kit#12` alike.\n *\n * The words are conventional-changelog's `referenceActions` (close, fix, resolve and their\n * inflections) and `references`, which conventional-changelog 8 writes where 7 wrote\n * `closes`: both spellings stay in a CHANGELOG.md for good, and keksdose's what's-new\n * dialog showed \"…, references\" after a bump that only knew `closes` (live #211). Version\n * 8 writes both clauses on one line — `, closes [#639](…), references [#405](…)` in\n * keksdose's 0.4.72 — so there can be more than one. A clause starts with the comma the\n * generator writes and a whole word, so \"a quick fix\" and \"disclose\" keep theirs.\n */\nconst TRAILING_REFS =\n  /(?:(?:,\\s*\\b(?:close[sd]?|fix(?:e[sd])?|resolve[sd]?|references?)(?:\\s*\\[[^\\]]*#\\d+\\]\\([^)]*\\))+)+|(?:\\s*\\[[^\\]]*#\\d+\\]\\([^)]*\\))+)\\s*$/i;\n\n/** A leading scope: `**admin:**`, or `**admin**:`. The colon makes it one: a hand-written\n *  bullet that opens with a bold phrase (`**The path was wrong.** README …`) has none. */\nconst SCOPE = /^\\*\\*([^*:]+?)(?::\\*\\*|\\*\\*:)\\s*/;\n\n/** `[label](url)` inside the sentence: the label is what it meant. */\nconst INLINE_LINK = /\\[([^\\]]+)\\]\\([^)]*\\)/g;\n\n/**\n * One bullet, without its `* `, as its scope and its sentence:\n * `**admin:** a rename ([8f698eb](…)), closes [#12](…)` → `{ scope: \"admin\", text: \"a\n * rename\" }`. keksdose's rules (`changelog-format.ts`), which kastlan copied, with three\n * corrections the four files asked for: every reference clause goes, not the last alone;\n * a scope needs its colon; and a code span that opens with a dot keeps the space before\n * it.\n *\n * The commit link and the trailing references go BEFORE the general link rule, which\n * would unwrap them into bare hashes and issue numbers. Then emphasis and code spans are\n * resolved, and what the removals left is repaired: a space before punctuation that ends a\n * clause (not the one before a code span's `.mutate`), doubled spaces, and the comma that\n * introduced \", closes …\".\n */\nexport function parseChangelogItem(line: string): ChangelogItem {\n  let text = line.replace(COMMIT_LINK, \"\").replace(TRAILING_REFS, \"\");\n  let scope: string | null = null;\n  const scoped = SCOPE.exec(text);\n  if (scoped) {\n    // A hand-written label can carry code (`**`Autocomplete`:**`): plain, like the text.\n    scope = plain(scoped[1]).trim();\n    text = text.slice(scoped[0].length);\n  }\n  text = plain(text)\n    .replace(/\\s+([,.;:])(?=\\s|$)/g, \"$1\")\n    .replace(/\\s{2,}/g, \" \")\n    .replace(/[,;:]+\\s*$/, \"\")\n    .trim();\n  return { scope, text };\n}\n\n/** Links as their labels, emphasis and code spans as their text. */\nfunction plain(markdown: string): string {\n  return markdown\n    .replace(INLINE_LINK, \"$1\")\n    .replace(/\\*\\*(.+?)\\*\\*/g, \"$1\")\n    .replace(/`([^`]+)`/g, \"$1\");\n}\n\n/**\n * Items grouped by scope, in the order each scope first appears, with exact repeats\n * dropped (keksdose's `groupByScope`). A feature that lands over several commits gets a\n * bullet per commit; the same sentence twice goes, and two different sentences both stay —\n * whether they mean the same is not a regex's call. Takes raw bullets (keksdose's\n * backend sends them) or parsed items; an item that reads as nothing is left out.\n */\nexport function groupByScope(items: readonly (string | ChangelogItem)[]): ChangelogScopeGroup[] {\n  const groups = new Map<string, ChangelogScopeGroup>();\n  const seen = new Set<string>();\n  for (const raw of items) {\n    const { scope, text } = typeof raw === \"string\" ? parseChangelogItem(raw) : raw;\n    if (!text) continue;\n    const repeat = `${scope ?? \"\"}\\u0000${text.toLowerCase()}`;\n    if (seen.has(repeat)) continue;\n    seen.add(repeat);\n    const group = groups.get(scope ?? \"\") ?? { scope, texts: [] };\n    group.texts.push(text);\n    groups.set(scope ?? \"\", group);\n  }\n  return [...groups.values()];\n}\n\n// ── Sections ──────────────────────────────────────────────────────────────────\n\n/** Each key's headings, lower-cased: the kit's `.versionrc.cjs` (and kastlan's and\n *  Kurvenschmiede's), the default preset, keksdose's, and Keep a Changelog's. */\nconst SECTION_NAMES: Record<ChangelogSectionKey, readonly string[]> = {\n  breaking: [\"breaking changes\", \"breaking\"],\n  added: [\"added\", \"features\", \"feat\"],\n  changed: [\"changed\", \"performance improvements\", \"performance\", \"code refactoring\"],\n  fixed: [\"fixed\", \"bug fixes\", \"fixes\"],\n  deprecated: [\"deprecated\"],\n  removed: [\"removed\"],\n  security: [\"security\"],\n  reverted: [\"reverts\", \"reverted\"],\n};\n\nconst SECTION_KEYS = new Map(\n  Object.entries(SECTION_NAMES).flatMap(([key, names]) => names.map((name) => [name, key as ChangelogSectionKey])),\n);\n\n/**\n * The key of a section's heading, for the app's own words: \"Added\" and \"Features\" are\n * `\"added\"`, \"Fixed\" and \"Bug Fixes\" `\"fixed\"`, \"Changed\", \"Performance Improvements\" and\n * keksdose's \"Performance\" `\"changed\"`, \"⚠ BREAKING CHANGES\" `\"breaking\"`, \"Reverts\"\n * `\"reverted\"`; Keep a Changelog's \"Deprecated\", \"Removed\" and \"Security\" are their own.\n * Case and a leading \"⚠\" don't count, nor a qualifier after a dash or in parentheses\n * (\"Fixed — layout\", \"Deprecated (removed in 0.35)\"). `null` for any other heading.\n */\nexport function changelogSectionKey(title: string): ChangelogSectionKey | null {\n  const name = title\n    .toLowerCase()\n    .replace(/^[^\\p{L}]+/u, \"\")\n    .split(/\\s+[—–-]\\s+|\\s*\\(/)[0]\n    .trim();\n  return SECTION_KEYS.get(name) ?? null;\n}\n\n// ── Releases ──────────────────────────────────────────────────────────────────\n\nconst VERSION = String.raw`\\d+\\.\\d+\\.\\d+(?:[-+][0-9A-Za-z.+-]*)?`;\n\n/** A release heading: `##` (or `###`, a patch under the default template), the version\n *  bracketed with its compare link or bare, then the rest of the line. */\nconst RELEASE_HEADING = new RegExp(String.raw`^#{2,3}\\s+(?:\\[(${VERSION})\\](?:\\([^)]*\\))?|(${VERSION}))(.*)$`);\n\n/** The date in what follows the version, once the compare link is behind it. */\nconst DATE = /(?:^|[^\\d-])(\\d{4}-\\d{2}-\\d{2})(?![\\d-])/;\n\nconst HEADING = /^(#{1,6})\\s+(.*?)\\s*#*\\s*$/;\nconst BULLET = /^[*-]\\s+(.*)$/;\nconst NESTED_BULLET = /^\\s+[*-]\\s+/;\nconst FENCE = /^\\s*(`{3,}|~{3,})/;\n\n/** A section while its release is read: the bullets as written, continuations joined. */\ninterface OpenSection {\n  title: string;\n  bullets: string[];\n}\n\n/**\n * A CHANGELOG.md as its releases, in the file's order (newest first).\n *\n * What counts as what, line by line:\n *\n *  - a `##` or `###` heading with a version starts a release (see the module note for the\n *    shapes); any other `#` or `##` heading ends it, so an \"Unreleased\" block or the\n *    file's title is no release's;\n *  - inside a release, any other `###` heading starts a section, keyed by\n *    {@link changelogSectionKey};\n *  - a bullet at the start of the line is an item of its section. The lines straight\n *    after it continue it, indented or not, as a breaking change's note runs on; a blank\n *    line, a heading, a nested bullet or a code fence ends it. Nested bullets, prose\n *    inside a section and fenced code (where a `- ` line is a diff) are no item;\n *  - before the first section, the prose is the release's {@link ChangelogRelease.body}.\n *\n * A section whose items all read as nothing is left out, as kastlan's parser did.\n */\nexport function parseChangelog(markdown: string): ChangelogRelease[] {\n  const releases: ChangelogRelease[] = [];\n  let release: ChangelogRelease | null = null;\n  let sections: OpenSection[] = [];\n  let section: OpenSection | null = null;\n  let body: string[] = [];\n  /** The bullet that later lines continue, as an index into `section.bullets`. */\n  let open: number | null = null;\n  /** The opening fence while inside a code block. */\n  let fence: string | null = null;\n\n  const close = () => {\n    if (!release) return;\n    release.body = body.join(\"\\n\").trim() || null;\n    release.sections = sections\n      .map((s) => ({\n        title: s.title,\n        key: changelogSectionKey(s.title),\n        items: s.bullets.map(parseChangelogItem).filter((item) => item.text !== \"\"),\n      }))\n      .filter((s) => s.items.length > 0);\n    releases.push(release);\n    release = null;\n  };\n\n  for (const raw of markdown.split(/\\r?\\n/)) {\n    const line = raw.trimEnd();\n\n    if (fence !== null) {\n      if (line.trimStart().startsWith(fence)) fence = null;\n      continue;\n    }\n    const fenced = FENCE.exec(line);\n    if (fenced) {\n      fence = fenced[1];\n      open = null;\n      continue;\n    }\n\n    const heading = HEADING.exec(line);\n    if (heading) {\n      open = null;\n      const released = RELEASE_HEADING.exec(line);\n      if (released) {\n        close();\n        const [, bracketed, bare, rest] = released;\n        release = { version: bracketed ?? bare, date: DATE.exec(rest)?.[1] ?? null, sections: [], body: null };\n        sections = [];\n        section = null;\n        body = [];\n      } else if (heading[1].length <= 2) {\n        close();\n      } else if (heading[1].length === 3 && release) {\n        section = { title: heading[2], bullets: [] };\n        sections.push(section);\n      }\n      continue;\n    }\n    if (!release) continue;\n\n    if (line.trim() === \"\") {\n      open = null;\n      if (!section) body.push(\"\");\n      continue;\n    }\n    if (!section) {\n      body.push(line);\n      continue;\n    }\n    const bullet = BULLET.exec(line);\n    if (bullet) {\n      open = section.bullets.push(bullet[1]) - 1;\n    } else if (NESTED_BULLET.test(line)) {\n      open = null;\n    } else if (open !== null) {\n      section.bullets[open] += ` ${line.trim()}`;\n    }\n  }\n  close();\n  return releases;\n}\n"],"mappings":"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","names":[]}

package/dist/lib/clipboard-minus.js

@@ -1,4 +1,5 @@
 "use client";
+import { isEditableContent } from "./editable-content.js";
 const MINUS_BEFORE_NUMBER = /\u2212(?=[\p{L}\p{Sc}.]{0,5}[\s\u00a0\u202f]*\d)/gu;
 function asciiMinusInNumbers(text) {
   return text.replace(MINUS_BEFORE_NUMBER, "-");
@@ -12,8 +13,7 @@ function hasMinusBeforeNumber(text) {
 function isEditable(node) {
   const el = node instanceof Element ? node : node?.parentElement;
   if (!el) return false;
-  if (el.closest("input, textarea, select")) return true;
-  return el.isContentEditable === true || el.closest('[contenteditable=""], [contenteditable="true"]') !== null;
+  return el.closest("input, textarea, select") !== null || isEditableContent(el);
 }
 function wrapTableParts(container) {
   const first = container.firstElementChild?.tagName;

package/dist/lib/clipboard-minus.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/clipboard-minus.ts"],"sourcesContent":["/**\n * The copy handler for the one minus sign (0.49 KIT-1b, Marcel's follow-up to KIT-1).\n *\n * The kit prints a negative with U+2212 (lib/minus.ts). A spreadsheet does not read that\n * as a number: a figure copied out of a kit table and pasted into Excel landed as text.\n * So while a selection inside the page is copied, every U+2212 standing directly before a\n * number — optionally after a currency code or symbol and spaces: \"−CHF 1,250.50\",\n * \"−€2,000\", \"−US$12\", \"−12%\" — becomes the ASCII \"-\" in the clipboard, in `text/plain` AND\n * in `text/html` (Excel pastes the HTML flavour, as cells). The page keeps \"−\".\n *\n * A copy with no such minus is left to the browser untouched, and so is any copy out of an\n * input, a textarea or an editable element: what the person typed is theirs.\n *\n * Installed once per document by `UiKitProvider` (`copyAsciiMinus`, default `true`) —\n * the one part every app mounts, the signed-out pages included.\n */\n\n/**\n * U+2212, then up to five letters, currency symbols or dots, then spaces, then a digit.\n *\n * Five of them, not \"a code or one symbol\": English and Chinese write a currency with\n * letters before the symbol — \"−US$\", \"−CA$\", \"−A$\", \"−NZ$\", \"−HK$\", \"−R$\", \"−MX$\",\n * \"−JP¥\", \"−CN¥\" — and `narrowSymbol` with letters alone (\"−kr\", \"−zł\", \"−Kč\"). Those kept\n * U+2212 in the clipboard, and Excel pasted them as text: 35 of 351 locale × currency\n * pairs at the default display, every one English or Chinese, and 136 of 1428 with\n * `narrowSymbol` (refactor audit 2026-10-30, DSP-11). A minus with no digit after it\n * (\"x−y\", \"a − b\") is still left alone.\n */\nconst MINUS_BEFORE_NUMBER = /\\u2212(?=[\\p{L}\\p{Sc}.]{0,5}[\\s\\u00a0\\u202f]*\\d)/gu;\n\n/**\n * `text` with each U+2212 that stands before a number (in the sense above) as the ASCII\n * hyphen-minus, every other character as it was — for text an app hands a machine that\n * did not come from a formatter's `minus: \"ascii\"`.\n */\nexport function asciiMinusInNumbers(text: string): string {\n  return text.replace(MINUS_BEFORE_NUMBER, \"-\");\n}\n\nfunction hasMinusBeforeNumber(text: string): boolean {\n  MINUS_BEFORE_NUMBER.lastIndex = 0;\n  const found = MINUS_BEFORE_NUMBER.test(text);\n  MINUS_BEFORE_NUMBER.lastIndex = 0;\n  return found;\n}\n\n/** An input, a textarea or an editable element: a copy there is the person's own text. */\nfunction isEditable(node: Node | null | undefined): boolean {\n  const el = node instanceof Element ? node : node?.parentElement;\n  if (!el) return false;\n  if (el.closest(\"input, textarea, select\")) return true;\n  return (\n    (el as HTMLElement).isContentEditable === true ||\n    el.closest('[contenteditable=\"\"], [contenteditable=\"true\"]') !== null\n  );\n}\n\n/** Table parts copied alone are wrapped back into a table, which Excel reads as cells. */\nfunction wrapTableParts(container: HTMLElement): string {\n  const first = container.firstElementChild?.tagName;\n  const html = container.innerHTML;\n  if (first === \"TD\" || first === \"TH\") return `<table><tbody><tr>${html}</tr></tbody></table>`;\n  if (first === \"TR\") return `<table><tbody>${html}</tbody></table>`;\n  if (first === \"TBODY\" || first === \"THEAD\" || first === \"TFOOT\") return `<table>${html}</table>`;\n  return html;\n}\n\nfunction onCopy(event: ClipboardEvent): void {\n  if (event.defaultPrevented || !event.clipboardData) return;\n  const doc = (event.target as Node | null)?.ownerDocument ?? document;\n  if (isEditable(event.target as Node | null) || isEditable(doc.activeElement)) return;\n  const selection = doc.getSelection();\n  if (!selection || selection.rangeCount === 0 || selection.isCollapsed) return;\n  if (isEditable(selection.anchorNode) || isEditable(selection.focusNode)) return;\n  const text = selection.toString();\n  if (!hasMinusBeforeNumber(text)) return;\n\n  const container = doc.createElement(\"div\");\n  for (let i = 0; i < selection.rangeCount; i++) container.appendChild(selection.getRangeAt(i).cloneContents());\n  const walker = doc.createTreeWalker(container, NodeFilter.SHOW_TEXT);\n  for (let node = walker.nextNode(); node; node = walker.nextNode()) {\n    node.nodeValue = asciiMinusInNumbers(node.nodeValue ?? \"\");\n  }\n  event.clipboardData.setData(\"text/plain\", asciiMinusInNumbers(text));\n  event.clipboardData.setData(\"text/html\", wrapTableParts(container));\n  event.preventDefault();\n}\n\nconst installs = new WeakMap<Document, number>();\n\n/**\n * Listen for copies on `doc` until the returned function is called. Counted: nested\n * providers install it once, and the last one to go removes it.\n */\nexport function installClipboardMinus(doc: Document = document): () => void {\n  const count = installs.get(doc) ?? 0;\n  if (count === 0) doc.addEventListener(\"copy\", onCopy);\n  installs.set(doc, count + 1);\n  let done = false;\n  return () => {\n    if (done) return;\n    done = true;\n    const left = (installs.get(doc) ?? 1) - 1;\n    installs.set(doc, left);\n    if (left === 0) doc.removeEventListener(\"copy\", onCopy);\n  };\n}\n"],"mappings":";AA4BA,MAAM,sBAAsB;AAOrB,SAAS,oBAAoB,MAAsB;AACxD,SAAO,KAAK,QAAQ,qBAAqB,GAAG;AAC9C;AAEA,SAAS,qBAAqB,MAAuB;AACnD,sBAAoB,YAAY;AAChC,QAAM,QAAQ,oBAAoB,KAAK,IAAI;AAC3C,sBAAoB,YAAY;AAChC,SAAO;AACT;AAGA,SAAS,WAAW,MAAwC;AAC1D,QAAM,KAAK,gBAAgB,UAAU,OAAO,MAAM;AAClD,MAAI,CAAC,GAAI,QAAO;AAChB,MAAI,GAAG,QAAQ,yBAAyB,EAAG,QAAO;AAClD,SACG,GAAmB,sBAAsB,QAC1C,GAAG,QAAQ,gDAAgD,MAAM;AAErE;AAGA,SAAS,eAAe,WAAgC;AACtD,QAAM,QAAQ,UAAU,mBAAmB;AAC3C,QAAM,OAAO,UAAU;AACvB,MAAI,UAAU,QAAQ,UAAU,KAAM,QAAO,qBAAqB,IAAI;AACtE,MAAI,UAAU,KAAM,QAAO,iBAAiB,IAAI;AAChD,MAAI,UAAU,WAAW,UAAU,WAAW,UAAU,QAAS,QAAO,UAAU,IAAI;AACtF,SAAO;AACT;AAEA,SAAS,OAAO,OAA6B;AAC3C,MAAI,MAAM,oBAAoB,CAAC,MAAM,cAAe;AACpD,QAAM,MAAO,MAAM,QAAwB,iBAAiB;AAC5D,MAAI,WAAW,MAAM,MAAqB,KAAK,WAAW,IAAI,aAAa,EAAG;AAC9E,QAAM,YAAY,IAAI,aAAa;AACnC,MAAI,CAAC,aAAa,UAAU,eAAe,KAAK,UAAU,YAAa;AACvE,MAAI,WAAW,UAAU,UAAU,KAAK,WAAW,UAAU,SAAS,EAAG;AACzE,QAAM,OAAO,UAAU,SAAS;AAChC,MAAI,CAAC,qBAAqB,IAAI,EAAG;AAEjC,QAAM,YAAY,IAAI,cAAc,KAAK;AACzC,WAAS,IAAI,GAAG,IAAI,UAAU,YAAY,IAAK,WAAU,YAAY,UAAU,WAAW,CAAC,EAAE,cAAc,CAAC;AAC5G,QAAM,SAAS,IAAI,iBAAiB,WAAW,WAAW,SAAS;AACnE,WAAS,OAAO,OAAO,SAAS,GAAG,MAAM,OAAO,OAAO,SAAS,GAAG;AACjE,SAAK,YAAY,oBAAoB,KAAK,aAAa,EAAE;AAAA,EAC3D;AACA,QAAM,cAAc,QAAQ,cAAc,oBAAoB,IAAI,CAAC;AACnE,QAAM,cAAc,QAAQ,aAAa,eAAe,SAAS,CAAC;AAClE,QAAM,eAAe;AACvB;AAEA,MAAM,WAAW,oBAAI,QAA0B;AAMxC,SAAS,sBAAsB,MAAgB,UAAsB;AAC1E,QAAM,QAAQ,SAAS,IAAI,GAAG,KAAK;AACnC,MAAI,UAAU,EAAG,KAAI,iBAAiB,QAAQ,MAAM;AACpD,WAAS,IAAI,KAAK,QAAQ,CAAC;AAC3B,MAAI,OAAO;AACX,SAAO,MAAM;AACX,QAAI,KAAM;AACV,WAAO;AACP,UAAM,QAAQ,SAAS,IAAI,GAAG,KAAK,KAAK;AACxC,aAAS,IAAI,KAAK,IAAI;AACtB,QAAI,SAAS,EAAG,KAAI,oBAAoB,QAAQ,MAAM;AAAA,EACxD;AACF;","names":[]}
+{"version":3,"sources":["../../src/lib/clipboard-minus.ts"],"sourcesContent":["/**\n * The copy handler for the one minus sign (0.49 KIT-1b, Marcel's follow-up to KIT-1).\n *\n * The kit prints a negative with U+2212 (lib/minus.ts). A spreadsheet does not read that\n * as a number: a figure copied out of a kit table and pasted into Excel landed as text.\n * So while a selection inside the page is copied, every U+2212 standing directly before a\n * number — optionally after a currency code or symbol and spaces: \"−CHF 1,250.50\",\n * \"−€2,000\", \"−US$12\", \"−12%\" — becomes the ASCII \"-\" in the clipboard, in `text/plain` AND\n * in `text/html` (Excel pastes the HTML flavour, as cells). The page keeps \"−\".\n *\n * A copy with no such minus is left to the browser untouched, and so is any copy out of an\n * input, a textarea or an editable element: what the person typed is theirs.\n *\n * Installed once per document by `UiKitProvider` (`copyAsciiMinus`, default `true`) —\n * the one part every app mounts, the signed-out pages included.\n */\n\nimport { isEditableContent } from \"./editable-content\";\n\n/**\n * U+2212, then up to five letters, currency symbols or dots, then spaces, then a digit.\n *\n * Five of them, not \"a code or one symbol\": English and Chinese write a currency with\n * letters before the symbol — \"−US$\", \"−CA$\", \"−A$\", \"−NZ$\", \"−HK$\", \"−R$\", \"−MX$\",\n * \"−JP¥\", \"−CN¥\" — and `narrowSymbol` with letters alone (\"−kr\", \"−zł\", \"−Kč\"). Those kept\n * U+2212 in the clipboard, and Excel pasted them as text: 35 of 351 locale × currency\n * pairs at the default display, every one English or Chinese, and 136 of 1428 with\n * `narrowSymbol` (refactor audit 2026-10-30, DSP-11). A minus with no digit after it\n * (\"x−y\", \"a − b\") is still left alone.\n */\nconst MINUS_BEFORE_NUMBER = /\\u2212(?=[\\p{L}\\p{Sc}.]{0,5}[\\s\\u00a0\\u202f]*\\d)/gu;\n\n/**\n * `text` with each U+2212 that stands before a number (in the sense above) as the ASCII\n * hyphen-minus, every other character as it was — for text an app hands a machine that\n * did not come from a formatter's `minus: \"ascii\"`.\n */\nexport function asciiMinusInNumbers(text: string): string {\n  return text.replace(MINUS_BEFORE_NUMBER, \"-\");\n}\n\nfunction hasMinusBeforeNumber(text: string): boolean {\n  MINUS_BEFORE_NUMBER.lastIndex = 0;\n  const found = MINUS_BEFORE_NUMBER.test(text);\n  MINUS_BEFORE_NUMBER.lastIndex = 0;\n  return found;\n}\n\n/**\n * An input, a textarea or editable content: a copy there is the person's own text.\n * Editable content by the kit's one rule (lib/editable-content, 0.54 follow-up): beside\n * `isContentEditable` this asked a `[contenteditable=\"\"], [contenteditable=\"true\"]`\n * selector, which found the editor round a `contenteditable=\"false\"` island (a chip no\n * one typed) and left its figure's U+2212 in the clipboard — in every engine — and,\n * where the engine has no `isContentEditable` (jsdom), missed `plaintext-only` and took\n * the minus out of what someone typed there.\n */\nfunction isEditable(node: Node | null | undefined): boolean {\n  const el = node instanceof Element ? node : node?.parentElement;\n  if (!el) return false;\n  return el.closest(\"input, textarea, select\") !== null || isEditableContent(el);\n}\n\n/** Table parts copied alone are wrapped back into a table, which Excel reads as cells. */\nfunction wrapTableParts(container: HTMLElement): string {\n  const first = container.firstElementChild?.tagName;\n  const html = container.innerHTML;\n  if (first === \"TD\" || first === \"TH\") return `<table><tbody><tr>${html}</tr></tbody></table>`;\n  if (first === \"TR\") return `<table><tbody>${html}</tbody></table>`;\n  if (first === \"TBODY\" || first === \"THEAD\" || first === \"TFOOT\") return `<table>${html}</table>`;\n  return html;\n}\n\nfunction onCopy(event: ClipboardEvent): void {\n  if (event.defaultPrevented || !event.clipboardData) return;\n  const doc = (event.target as Node | null)?.ownerDocument ?? document;\n  if (isEditable(event.target as Node | null) || isEditable(doc.activeElement)) return;\n  const selection = doc.getSelection();\n  if (!selection || selection.rangeCount === 0 || selection.isCollapsed) return;\n  if (isEditable(selection.anchorNode) || isEditable(selection.focusNode)) return;\n  const text = selection.toString();\n  if (!hasMinusBeforeNumber(text)) return;\n\n  const container = doc.createElement(\"div\");\n  for (let i = 0; i < selection.rangeCount; i++) container.appendChild(selection.getRangeAt(i).cloneContents());\n  const walker = doc.createTreeWalker(container, NodeFilter.SHOW_TEXT);\n  for (let node = walker.nextNode(); node; node = walker.nextNode()) {\n    node.nodeValue = asciiMinusInNumbers(node.nodeValue ?? \"\");\n  }\n  event.clipboardData.setData(\"text/plain\", asciiMinusInNumbers(text));\n  event.clipboardData.setData(\"text/html\", wrapTableParts(container));\n  event.preventDefault();\n}\n\nconst installs = new WeakMap<Document, number>();\n\n/**\n * Listen for copies on `doc` until the returned function is called. Counted: nested\n * providers install it once, and the last one to go removes it.\n */\nexport function installClipboardMinus(doc: Document = document): () => void {\n  const count = installs.get(doc) ?? 0;\n  if (count === 0) doc.addEventListener(\"copy\", onCopy);\n  installs.set(doc, count + 1);\n  let done = false;\n  return () => {\n    if (done) return;\n    done = true;\n    const left = (installs.get(doc) ?? 1) - 1;\n    installs.set(doc, left);\n    if (left === 0) doc.removeEventListener(\"copy\", onCopy);\n  };\n}\n"],"mappings":";AAiBA,SAAS,yBAAyB;AAalC,MAAM,sBAAsB;AAOrB,SAAS,oBAAoB,MAAsB;AACxD,SAAO,KAAK,QAAQ,qBAAqB,GAAG;AAC9C;AAEA,SAAS,qBAAqB,MAAuB;AACnD,sBAAoB,YAAY;AAChC,QAAM,QAAQ,oBAAoB,KAAK,IAAI;AAC3C,sBAAoB,YAAY;AAChC,SAAO;AACT;AAWA,SAAS,WAAW,MAAwC;AAC1D,QAAM,KAAK,gBAAgB,UAAU,OAAO,MAAM;AAClD,MAAI,CAAC,GAAI,QAAO;AAChB,SAAO,GAAG,QAAQ,yBAAyB,MAAM,QAAQ,kBAAkB,EAAE;AAC/E;AAGA,SAAS,eAAe,WAAgC;AACtD,QAAM,QAAQ,UAAU,mBAAmB;AAC3C,QAAM,OAAO,UAAU;AACvB,MAAI,UAAU,QAAQ,UAAU,KAAM,QAAO,qBAAqB,IAAI;AACtE,MAAI,UAAU,KAAM,QAAO,iBAAiB,IAAI;AAChD,MAAI,UAAU,WAAW,UAAU,WAAW,UAAU,QAAS,QAAO,UAAU,IAAI;AACtF,SAAO;AACT;AAEA,SAAS,OAAO,OAA6B;AAC3C,MAAI,MAAM,oBAAoB,CAAC,MAAM,cAAe;AACpD,QAAM,MAAO,MAAM,QAAwB,iBAAiB;AAC5D,MAAI,WAAW,MAAM,MAAqB,KAAK,WAAW,IAAI,aAAa,EAAG;AAC9E,QAAM,YAAY,IAAI,aAAa;AACnC,MAAI,CAAC,aAAa,UAAU,eAAe,KAAK,UAAU,YAAa;AACvE,MAAI,WAAW,UAAU,UAAU,KAAK,WAAW,UAAU,SAAS,EAAG;AACzE,QAAM,OAAO,UAAU,SAAS;AAChC,MAAI,CAAC,qBAAqB,IAAI,EAAG;AAEjC,QAAM,YAAY,IAAI,cAAc,KAAK;AACzC,WAAS,IAAI,GAAG,IAAI,UAAU,YAAY,IAAK,WAAU,YAAY,UAAU,WAAW,CAAC,EAAE,cAAc,CAAC;AAC5G,QAAM,SAAS,IAAI,iBAAiB,WAAW,WAAW,SAAS;AACnE,WAAS,OAAO,OAAO,SAAS,GAAG,MAAM,OAAO,OAAO,SAAS,GAAG;AACjE,SAAK,YAAY,oBAAoB,KAAK,aAAa,EAAE;AAAA,EAC3D;AACA,QAAM,cAAc,QAAQ,cAAc,oBAAoB,IAAI,CAAC;AACnE,QAAM,cAAc,QAAQ,aAAa,eAAe,SAAS,CAAC;AAClE,QAAM,eAAe;AACvB;AAEA,MAAM,WAAW,oBAAI,QAA0B;AAMxC,SAAS,sBAAsB,MAAgB,UAAsB;AAC1E,QAAM,QAAQ,SAAS,IAAI,GAAG,KAAK;AACnC,MAAI,UAAU,EAAG,KAAI,iBAAiB,QAAQ,MAAM;AACpD,WAAS,IAAI,KAAK,QAAQ,CAAC;AAC3B,MAAI,OAAO;AACX,SAAO,MAAM;AACX,QAAI,KAAM;AACV,WAAO;AACP,UAAM,QAAQ,SAAS,IAAI,GAAG,KAAK,KAAK;AACxC,aAAS,IAAI,KAAK,IAAI;AACtB,QAAI,SAAS,EAAG,KAAI,oBAAoB,QAAQ,MAAM;AAAA,EACxD;AACF;","names":[]}

package/dist/lib/dates.d.ts

@@ -25,7 +25,32 @@
  */
 /** Zero-pad a number to two digits ("3" -> "03"). */
 export declare function pad(n: number): string;
-/** Today as "YYYY-MM-DD" on the LOCAL calendar (see the module note). */
+/**
+ * Move "today" for every helper here, and for the kit's calendars and pickers, to `day`
+ * ("YYYY-MM-DD") — the dev clock's day, which the app reads at boot and from its dev menu's
+ * Time rows (`setToday(answer.today)`) — or back to the device's own with `null`. A string
+ * that is not a real day is the device's own too: a dev tool must not stop the app.
+ *
+ * Only the DATE moves, as on the server: {@link currentDate} keeps the device's time of
+ * day, and a timestamp the kit takes (`new Date()` for a sync, a crash report, a relative
+ * time) stays on the device's real clock. Not for production code: the app gates the call
+ * (`import.meta.env.DEV`), as it gates the menu. The kit's `DevMenu` puts its "Overrides
+ * on" dot on the flask while a day is set.
+ */
+export declare function setToday(day: string | null): void;
+/** The day {@link setToday} moved "today" to, or `null` while it is the device's own. */
+export declare function todayOverride(): string | null;
+/** Hear {@link setToday} move the day; returns the unsubscribe. With {@link todayOverride},
+ *  `useSyncExternalStore`'s pair. */
+export declare function subscribeToday(listener: () => void): () => void;
+/**
+ * Now, on the day the kit takes for today: the device's clock, or — while {@link setToday}
+ * has moved it — that day at the device's time of day. A new Date on every call, free to
+ * mutate. Every "what day is it" here reads it; read it for an app's own.
+ */
+export declare function currentDate(): Date;
+/** Today as "YYYY-MM-DD" on the LOCAL calendar (see the module note), on the day
+ *  {@link currentDate} takes for today. */
 export declare function todayIso(): string;
 /** A Date as a local-time "YYYY-MM-DD" string. */
 export declare function toLocalIso(d: Date): string;
@@ -106,7 +131,8 @@ export interface DateRangePreset {
 export declare function dateRangePresets(): DateRangePreset[];
 /** The last `n` WHOLE calendar months before the current one, as an inclusive
  *  `{ from, to }` — on 15 May, `n = 3` is 1 February … 30 April. Local-calendar, like
- *  everything here; `now` is for tests and for a host with its own clock. */
+ *  everything here; `now` is for tests and for a host with its own clock (default
+ *  {@link currentDate}). */
 export declare function lastFullMonthsRange(n: number, now?: Date): {
     from: string;
     to: string;
@@ -122,7 +148,7 @@ export interface CalendarMonthPresetOptions {
     months?: readonly number[];
     /** How many whole years each year preset spans. Default `[2]`. */
     years?: readonly number[];
-    /** The day to count back from. Default: now, on the local calendar. */
+    /** The day to count back from. Default: now, on the local calendar ({@link currentDate}). */
     now?: Date;
 }
 /**

package/dist/lib/dates.js

@@ -3,8 +3,33 @@ import { dateFormatter } from "./intl-cache.js";
 function pad(n) {
   return String(n).padStart(2, "0");
 }
+let movedToday = null;
+const todayListeners = /* @__PURE__ */ new Set();
+function setToday(day) {
+  const next = day !== null && parseIsoDate(day) !== null ? day : null;
+  if (next === movedToday) return;
+  movedToday = next;
+  for (const listener of [...todayListeners]) listener();
+}
+function todayOverride() {
+  return movedToday;
+}
+function subscribeToday(listener) {
+  todayListeners.add(listener);
+  return () => {
+    todayListeners.delete(listener);
+  };
+}
+function currentDate() {
+  const now = /* @__PURE__ */ new Date();
+  if (movedToday !== null) {
+    const [y, m, d] = movedToday.split("-").map(Number);
+    now.setFullYear(y, m - 1, d);
+  }
+  return now;
+}
 function todayIso() {
-  return toLocalIso(/* @__PURE__ */ new Date());
+  return toLocalIso(currentDate());
 }
 function toLocalIso(d) {
   return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
@@ -13,39 +38,39 @@ function monthKey(d) {
   return `${d.getFullYear()}-${pad(d.getMonth() + 1)}`;
 }
 function shiftIso(days) {
-  const d = /* @__PURE__ */ new Date();
+  const d = currentDate();
   d.setDate(d.getDate() + days);
   return toLocalIso(d);
 }
 function startOfWeekIso() {
-  const d = /* @__PURE__ */ new Date();
+  const d = currentDate();
   const day = d.getDay();
   const diff = (day + 6) % 7;
   d.setDate(d.getDate() - diff);
   return toLocalIso(d);
 }
 function startOfMonthIso(offsetMonths = 0) {
-  const d = /* @__PURE__ */ new Date();
+  const d = currentDate();
   d.setDate(1);
   d.setMonth(d.getMonth() + offsetMonths);
   return toLocalIso(d);
 }
 function endOfMonthIso(offsetMonths = 0) {
-  const d = /* @__PURE__ */ new Date();
+  const d = currentDate();
   d.setDate(1);
   d.setMonth(d.getMonth() + offsetMonths + 1);
   d.setDate(0);
   return toLocalIso(d);
 }
 function startOfYearIso(offsetYears = 0) {
-  const d = /* @__PURE__ */ new Date();
+  const d = currentDate();
   d.setMonth(0);
   d.setDate(1);
   d.setFullYear(d.getFullYear() + offsetYears);
   return toLocalIso(d);
 }
 function endOfYearIso(offsetYears = 0) {
-  const d = /* @__PURE__ */ new Date();
+  const d = currentDate();
   d.setMonth(11);
   d.setDate(31);
   d.setFullYear(d.getFullYear() + offsetYears);
@@ -98,7 +123,7 @@ function sameYmd(a, b) {
   return a.getFullYear() === b.getFullYear() && a.getMonth() === b.getMonth() && a.getDate() === b.getDate();
 }
 function dateRangePresets() {
-  const mondayOffset = ((/* @__PURE__ */ new Date()).getDay() + 6) % 7;
+  const mondayOffset = (currentDate().getDay() + 6) % 7;
   return [
     { key: "today", from: todayIso(), to: todayIso() },
     { key: "yesterday", from: shiftIso(-1), to: shiftIso(-1) },
@@ -113,17 +138,17 @@ function dateRangePresets() {
     { key: "last_year", from: startOfYearIso(-1), to: endOfYearIso(-1) }
   ];
 }
-function lastFullMonthsRange(n, now = /* @__PURE__ */ new Date()) {
+function lastFullMonthsRange(n, now = currentDate()) {
   const from = new Date(now.getFullYear(), now.getMonth() - n, 1);
   const to = new Date(now.getFullYear(), now.getMonth(), 0);
   return { from: toLocalIso(from), to: toLocalIso(to) };
 }
-function lastFullYearsRange(n, now = /* @__PURE__ */ new Date()) {
+function lastFullYearsRange(n, now = currentDate()) {
   const year = now.getFullYear();
   return { from: `${year - n}-01-01`, to: `${year - 1}-12-31` };
 }
 function calendarMonthPresets(options = {}) {
-  const { months = [3, 6], years = [2], now = /* @__PURE__ */ new Date() } = options;
+  const { months = [3, 6], years = [2], now = currentDate() } = options;
   return [
     ...months.map((n) => ({ key: `last_${n}_full_months`, ...lastFullMonthsRange(n, now) })),
     ...years.map((n) => ({ key: `last_${n}_full_years`, ...lastFullYearsRange(n, now) }))
@@ -133,6 +158,7 @@ export {
   addDaysIso,
   addMonthsClamped,
   calendarMonthPresets,
+  currentDate,
   dateRangePresets,
   endOfMonthIso,
   endOfYearIso,
@@ -144,11 +170,14 @@ export {
   pad,
   parseIsoDate,
   sameYmd,
+  setToday,
   shiftIso,
   startOfMonthIso,
   startOfWeekIso,
   startOfYearIso,
+  subscribeToday,
   toLocalIso,
-  todayIso
+  todayIso,
+  todayOverride
 };
 //# sourceMappingURL=dates.js.map

package/dist/lib/dates.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/dates.ts"],"sourcesContent":["/**\n * ISO date helpers, collected from copies that were scattered across the pages.\n *\n * **Every \"what day is it\" helper here reads the LOCAL calendar** — one family, not\n * two. It used to be two: these all built a local Date and then read it back through\n * `toISOString()`, which is UTC, so east of Greenwich they all returned YESTERDAY\n * between local midnight and the UTC rollover. The old module note called that\n * deliberate and warned against changing it. It was not defensible, and dev#471 is\n * what it cost:\n *\n * > *\"Just entered a tx now from scheduled. But it still shows as upcoming. Is there\n * > a problem with timezones? It is currently 1 o clock middle european summer time.\"*\n *\n * There was: at 01:00 CEST `todayIso()` answered with the 14th, the row the scheduler\n * had just booked was dated the 15th, and `isUpcoming` compares the two strings — so a\n * transaction entered a second ago read as one still to come. The same slip moved\n * `startOfMonthIso()` onto the last day of the PREVIOUS month for an hour every first\n * of the month, which is a report range nobody would have questioned.\n *\n * A calendar day only means anything to the human reading it, and every caller here —\n * the register's today, the date-range presets, the budget cursor, a new\n * transaction's default date — is asking that question. There is no caller for whom\n * \"the UTC day\" is the right answer; the server compares plain dates with no zone at\n * all, so sending it the user's local day is also what it wants.\n */\n\n// Imports nothing else: `@eifi1/ui-kit/dates` reaches no package (packaging-contract).\nimport { dateFormatter } from \"./intl-cache\";\n\n/** Zero-pad a number to two digits (\"3\" -> \"03\"). */\nexport function pad(n: number): string {\n  return String(n).padStart(2, \"0\");\n}\n\n/** Today as \"YYYY-MM-DD\" on the LOCAL calendar (see the module note). */\nexport function todayIso(): string {\n  return toLocalIso(new Date());\n}\n\n/** A Date as a local-time \"YYYY-MM-DD\" string. */\nexport function toLocalIso(d: Date): string {\n  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;\n}\n\n/** A Date as a local-time \"YYYY-MM\" month key. */\nexport function monthKey(d: Date): string {\n  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}`;\n}\n\n// ---------- Date-range presets + calendar helpers ----------\n// Local-calendar like todayIso (see the module note); used by the data-table date\n// filter and its MiniCalendar. Each one mutates a local Date and must therefore READ\n// it back locally — going out through toISOString() is what shifted every one of\n// these by a day near midnight (dev#471).\n\n/** Today shifted by `days`, as \"YYYY-MM-DD\". */\nexport function shiftIso(days: number): string {\n  const d = new Date();\n  d.setDate(d.getDate() + days);\n  return toLocalIso(d);\n}\n\n/** First day (Monday) of the current week, as \"YYYY-MM-DD\". */\nexport function startOfWeekIso(): string {\n  const d = new Date();\n  const day = d.getDay();\n  const diff = (day + 6) % 7; // monday = 0\n  d.setDate(d.getDate() - diff);\n  return toLocalIso(d);\n}\n\n/** First day of the month `offsetMonths` from now, as \"YYYY-MM-DD\". */\nexport function startOfMonthIso(offsetMonths = 0): string {\n  const d = new Date();\n  d.setDate(1);\n  d.setMonth(d.getMonth() + offsetMonths);\n  return toLocalIso(d);\n}\n\n/** Last day of the month `offsetMonths` from now, as \"YYYY-MM-DD\". */\nexport function endOfMonthIso(offsetMonths = 0): string {\n  const d = new Date();\n  d.setDate(1);\n  d.setMonth(d.getMonth() + offsetMonths + 1);\n  d.setDate(0);\n  return toLocalIso(d);\n}\n\n/** First day of the year `offsetYears` from now, as \"YYYY-MM-DD\". */\nexport function startOfYearIso(offsetYears = 0): string {\n  const d = new Date();\n  d.setMonth(0);\n  d.setDate(1);\n  d.setFullYear(d.getFullYear() + offsetYears);\n  return toLocalIso(d);\n}\n\n/** Last day of the year `offsetYears` from now, as \"YYYY-MM-DD\". */\nexport function endOfYearIso(offsetYears = 0): string {\n  const d = new Date();\n  d.setMonth(11);\n  d.setDate(31);\n  d.setFullYear(d.getFullYear() + offsetYears);\n  return toLocalIso(d);\n}\n\n/** Parse a \"YYYY-MM-DD\" string to a local-midnight Date, or null if malformed —\n *  where \"malformed\" includes a date that does not exist.\n *\n *  The falsy check alone was not enough. `new Date(y, m - 1, d)` ROLLS OVER out-of-range\n *  components rather than refusing them, so \"2026-13-45\" came back as 2027-02-14 and\n *  \"2026-02-30\" as 2026-03-02: a valid-looking Date for a day that never happened. No\n *  caller could tell — {@link formatIsoDate} blanks only on `null`, so the invented\n *  date formatted and displayed exactly like a real one.\n *\n *  The round-trip is the check: build the Date, then read the components back off it.\n *  A value that rolled over cannot answer with the numbers it was given. That is the\n *  same shape {@link sameYmd} already expresses, applied to a Date and its source. */\nexport function parseIsoDate(s: string): Date | null {\n  if (!s) return null;\n  const [y, m, d] = s.split(\"-\").map(Number);\n  if (!y || !m || !d) return null;\n  if (!Number.isInteger(y) || !Number.isInteger(m) || !Number.isInteger(d)) return null;\n  const dt = new Date(y, m - 1, d);\n  if (Number.isNaN(dt.getTime())) return null;\n  if (dt.getFullYear() !== y || dt.getMonth() !== m - 1 || dt.getDate() !== d) return null;\n  return dt;\n}\n\n/** The fields that make an option set a DATE for `toLocaleDateString` (ECMA-402's\n *  ToDateTimeOptions, required \"date\"): with none of them it adds year, month and day. */\nconst DATE_FIELDS = [\"weekday\", \"year\", \"month\", \"day\", \"dateStyle\"] as const;\nconst NUMERIC_DATE: Intl.DateTimeFormatOptions = { year: \"numeric\", month: \"numeric\", day: \"numeric\" };\n\n/** `options` as `toLocaleDateString` reads them: with a date in them, whatever else they\n *  ask for. `{ hour: \"numeric\" }` alone is a date and an hour there, never the hour alone\n *  that `Intl.DateTimeFormat` would print for it. */\nfunction asDateOptions(options: Intl.DateTimeFormatOptions | undefined): Intl.DateTimeFormatOptions {\n  if (!options) return NUMERIC_DATE;\n  return DATE_FIELDS.some((field) => options[field] !== undefined) ? options : { ...options, ...NUMERIC_DATE };\n}\n\n/** Format a \"YYYY-MM-DD\" string for display in `locale` (empty string when\n *  unparseable). Defaults to the locale's short numeric date; pass `options` to\n *  override (e.g. `{ dateStyle: \"medium\" }`). `locale` may be `undefined` since 0.34 —\n *  the runtime's default, as `Intl` reads it and as every other kit formatter takes it\n *  (DUP-11: DatePicker re-wrapped this function only to pass none).\n *\n *  Through the kit's formatter cache since 0.54 (keksdose audit follow-up, 2026-11-01):\n *  `toLocaleDateString` builds a formatter per call, and this one runs for the date\n *  pickers' trigger on every render and for an app's date column once per row. The output\n *  is `toLocaleDateString`'s: the same options, with the date it adds when they name none\n *  (`asDateOptions`). */\nexport function formatIsoDate(iso: string, locale: string | undefined, options?: Intl.DateTimeFormatOptions): string {\n  const d = parseIsoDate(iso);\n  return d ? dateFormatter(locale, asDateOptions(options)).format(d) : \"\";\n}\n\n/** A \"YYYY-MM-DD\" string shifted by `days` (negative shifts back), or the input\n *  unchanged when it isn't a parseable date.\n *\n *  Local-time throughout — {@link parseIsoDate} builds a local-midnight Date and\n *  {@link toLocalIso} reads local components back, so this never slides a day the way\n *  a `toISOString()` round-trip does west of UTC. */\nexport function addDaysIso(iso: string, days: number): string {\n  const d = parseIsoDate(iso);\n  if (!d) return iso;\n  d.setDate(d.getDate() + days);\n  return toLocalIso(d);\n}\n\n/**\n * `d` moved by whole months, keeping the day of the month where the target has one.\n * `setMonth` alone ROLLS OVER — 31 January + 1 month is 3 March — which would skip\n * February entirely for anyone paging through the year with PageDown. Returns a new\n * Date; `d` is not touched.\n */\nexport function addMonthsClamped(d: Date, months: number): Date {\n  const day = d.getDate();\n  const out = new Date(d.getFullYear(), d.getMonth() + months, 1);\n  const lastOfTarget = new Date(out.getFullYear(), out.getMonth() + 1, 0).getDate();\n  out.setDate(Math.min(day, lastOfTarget));\n  return out;\n}\n\n/**\n * The first day of the week in `locale`, as a `Date#getDay` index (0 = Sunday).\n *\n * `Intl.Locale#getWeekInfo()` is the standard spelling; V8 shipped it first as the\n * `weekInfo` accessor, and Firefox has neither yet — hence both reads and a Monday\n * fallback, which is ISO 8601. Its `firstDay` counts 1 = Monday … 7 = Sunday, so `% 7`\n * maps it onto `getDay`. `undefined` asks for the runtime's default locale.\n */\nexport function localeWeekStart(locale: string | undefined): 0 | 1 | 2 | 3 | 4 | 5 | 6 {\n  try {\n    const tag = locale ?? new Intl.DateTimeFormat().resolvedOptions().locale;\n    const loc = new Intl.Locale(tag) as Intl.Locale & {\n      getWeekInfo?: () => { firstDay: number };\n      weekInfo?: { firstDay: number };\n    };\n    const firstDay = (loc.getWeekInfo?.() ?? loc.weekInfo)?.firstDay;\n    if (typeof firstDay === \"number\") return (firstDay % 7) as 0 | 1 | 2 | 3 | 4 | 5 | 6;\n  } catch {\n    // A malformed tag throws from `Intl.Locale`; a calendar still has to render.\n  }\n  return 1;\n}\n\n/** Whether two Dates fall on the same local calendar day. */\nexport function sameYmd(a: Date, b: Date): boolean {\n  return a.getFullYear() === b.getFullYear() && a.getMonth() === b.getMonth() && a.getDate() === b.getDate();\n}\n\nexport interface DateRangePreset {\n  key: string;\n  from: string;\n  to: string;\n}\n\n/**\n * The named ranges offered by the data-table date filter (local-calendar, like\n * {@link todayIso} — see the module note). `key` maps to the consumer's\n * `table.preset_*` labels.\n */\nexport function dateRangePresets(): DateRangePreset[] {\n  const mondayOffset = (new Date().getDay() + 6) % 7; // monday = 0\n  return [\n    { key: \"today\", from: todayIso(), to: todayIso() },\n    { key: \"yesterday\", from: shiftIso(-1), to: shiftIso(-1) },\n    { key: \"this_week\", from: startOfWeekIso(), to: todayIso() },\n    { key: \"last_week\", from: shiftIso(-7 - mondayOffset), to: shiftIso(-1 - mondayOffset) },\n    { key: \"last_7_days\", from: shiftIso(-6), to: todayIso() },\n    { key: \"last_30_days\", from: shiftIso(-29), to: todayIso() },\n    { key: \"this_month\", from: startOfMonthIso(0), to: todayIso() },\n    { key: \"last_month\", from: startOfMonthIso(-1), to: endOfMonthIso(-1) },\n    { key: \"last_3_months\", from: shiftIso(-90), to: todayIso() },\n    { key: \"ytd\", from: startOfYearIso(0), to: todayIso() },\n    { key: \"last_year\", from: startOfYearIso(-1), to: endOfYearIso(-1) },\n  ];\n}\n\n/** The last `n` WHOLE calendar months before the current one, as an inclusive\n *  `{ from, to }` — on 15 May, `n = 3` is 1 February … 30 April. Local-calendar, like\n *  everything here; `now` is for tests and for a host with its own clock. */\nexport function lastFullMonthsRange(n: number, now: Date = new Date()): { from: string; to: string } {\n  const from = new Date(now.getFullYear(), now.getMonth() - n, 1);\n  // Day 0 of the current month is the last day of the previous one.\n  const to = new Date(now.getFullYear(), now.getMonth(), 0);\n  return { from: toLocalIso(from), to: toLocalIso(to) };\n}\n\n/** The last `n` WHOLE calendar years before the current one — in 2026, `n = 2` is\n *  1 January 2024 … 31 December 2025. */\nexport function lastFullYearsRange(n: number, now: Date = new Date()): { from: string; to: string } {\n  const year = now.getFullYear();\n  return { from: `${year - n}-01-01`, to: `${year - 1}-12-31` };\n}\n\nexport interface CalendarMonthPresetOptions {\n  /** How many whole months each month preset spans. Default `[3, 6]`. */\n  months?: readonly number[];\n  /** How many whole years each year preset spans. Default `[2]`. */\n  years?: readonly number[];\n  /** The day to count back from. Default: now, on the local calendar. */\n  now?: Date;\n}\n\n/**\n * Month-ALIGNED presets, beside the rolling-day ones of {@link dateRangePresets}.\n *\n * kastlan's accounting reports are closed by the month: \"the last three months\" there\n * means February, March and April, never \"the 90 days up to this morning\", which\n * starts mid-month and ends with a day that is still being booked. `last_3_months`\n * above is the rolling kind and stays that way for the data table's filter, so these\n * are separate keys rather than a changed meaning under an old one.\n *\n * Keys are `last_<n>_full_months` and `last_<n>_full_years`; the host labels them (the\n * same arrangement as `dateRangePresets`' keys and its `table.preset_*` strings). With\n * `DateRangePicker`, pass the key as the preset's `id` so the choice keeps its\n * identity while the dates are recomputed on every render.\n */\nexport function calendarMonthPresets(options: CalendarMonthPresetOptions = {}): DateRangePreset[] {\n  const { months = [3, 6], years = [2], now = new Date() } = options;\n  return [\n    ...months.map((n) => ({ key: `last_${n}_full_months`, ...lastFullMonthsRange(n, now) })),\n    ...years.map((n) => ({ key: `last_${n}_full_years`, ...lastFullYearsRange(n, now) })),\n  ];\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/lib/dates.ts"],"sourcesContent":["/**\n * ISO date helpers, collected from copies that were scattered across the pages.\n *\n * **Every \"what day is it\" helper here reads the LOCAL calendar** — one family, not\n * two. It used to be two: these all built a local Date and then read it back through\n * `toISOString()`, which is UTC, so east of Greenwich they all returned YESTERDAY\n * between local midnight and the UTC rollover. The old module note called that\n * deliberate and warned against changing it. It was not defensible, and dev#471 is\n * what it cost:\n *\n * > *\"Just entered a tx now from scheduled. But it still shows as upcoming. Is there\n * > a problem with timezones? It is currently 1 o clock middle european summer time.\"*\n *\n * There was: at 01:00 CEST `todayIso()` answered with the 14th, the row the scheduler\n * had just booked was dated the 15th, and `isUpcoming` compares the two strings — so a\n * transaction entered a second ago read as one still to come. The same slip moved\n * `startOfMonthIso()` onto the last day of the PREVIOUS month for an hour every first\n * of the month, which is a report range nobody would have questioned.\n *\n * A calendar day only means anything to the human reading it, and every caller here —\n * the register's today, the date-range presets, the budget cursor, a new\n * transaction's default date — is asking that question. There is no caller for whom\n * \"the UTC day\" is the right answer; the server compares plain dates with no zone at\n * all, so sending it the user's local day is also what it wants.\n */\n\n// Imports nothing else: `@eifi1/ui-kit/dates` reaches no package (packaging-contract).\nimport { dateFormatter } from \"./intl-cache\";\n\n/** Zero-pad a number to two digits (\"3\" -> \"03\"). */\nexport function pad(n: number): string {\n  return String(n).padStart(2, \"0\");\n}\n\n// ---------- Where \"today\" comes from (0.55) ----------\n// keksdose's 0.51 adoption N2: the dev clock (server-kit 0.20's `DevSwitchAnswer.today`,\n// docs/top-bar-harmonization.md §2.7.1 rule 5) moves the day the SERVER takes for today,\n// and the app's own `todayIso()` followed it — but every helper below and the kit's\n// calendars (DatePicker's today, MonthPicker's this month) read the device clock, so a\n// month end or a \"today\" worked out by the kit disagreed with the server's. One settable\n// source now, which all of them read: the device clock until something moves it.\n\n/** The day {@link setToday} moved \"today\" to, or `null`: the device's own. */\nlet movedToday: string | null = null;\nconst todayListeners = new Set<() => void>();\n\n/**\n * Move \"today\" for every helper here, and for the kit's calendars and pickers, to `day`\n * (\"YYYY-MM-DD\") — the dev clock's day, which the app reads at boot and from its dev menu's\n * Time rows (`setToday(answer.today)`) — or back to the device's own with `null`. A string\n * that is not a real day is the device's own too: a dev tool must not stop the app.\n *\n * Only the DATE moves, as on the server: {@link currentDate} keeps the device's time of\n * day, and a timestamp the kit takes (`new Date()` for a sync, a crash report, a relative\n * time) stays on the device's real clock. Not for production code: the app gates the call\n * (`import.meta.env.DEV`), as it gates the menu. The kit's `DevMenu` puts its \"Overrides\n * on\" dot on the flask while a day is set.\n */\nexport function setToday(day: string | null): void {\n  const next = day !== null && parseIsoDate(day) !== null ? day : null;\n  if (next === movedToday) return;\n  movedToday = next;\n  for (const listener of [...todayListeners]) listener();\n}\n\n/** The day {@link setToday} moved \"today\" to, or `null` while it is the device's own. */\nexport function todayOverride(): string | null {\n  return movedToday;\n}\n\n/** Hear {@link setToday} move the day; returns the unsubscribe. With {@link todayOverride},\n *  `useSyncExternalStore`'s pair. */\nexport function subscribeToday(listener: () => void): () => void {\n  todayListeners.add(listener);\n  return () => {\n    todayListeners.delete(listener);\n  };\n}\n\n/**\n * Now, on the day the kit takes for today: the device's clock, or — while {@link setToday}\n * has moved it — that day at the device's time of day. A new Date on every call, free to\n * mutate. Every \"what day is it\" here reads it; read it for an app's own.\n */\nexport function currentDate(): Date {\n  const now = new Date();\n  if (movedToday !== null) {\n    const [y, m, d] = movedToday.split(\"-\").map(Number);\n    // The date's three parts at once, so no day is passed through that does not exist\n    // (31 March set to February first); the time of day is kept.\n    now.setFullYear(y, m - 1, d);\n  }\n  return now;\n}\n\n/** Today as \"YYYY-MM-DD\" on the LOCAL calendar (see the module note), on the day\n *  {@link currentDate} takes for today. */\nexport function todayIso(): string {\n  return toLocalIso(currentDate());\n}\n\n/** A Date as a local-time \"YYYY-MM-DD\" string. */\nexport function toLocalIso(d: Date): string {\n  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;\n}\n\n/** A Date as a local-time \"YYYY-MM\" month key. */\nexport function monthKey(d: Date): string {\n  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}`;\n}\n\n// ---------- Date-range presets + calendar helpers ----------\n// Local-calendar like todayIso (see the module note); used by the data-table date\n// filter and its MiniCalendar. Each one mutates a local Date and must therefore READ\n// it back locally — going out through toISOString() is what shifted every one of\n// these by a day near midnight (dev#471). \"Now\" is `currentDate()`, so a day moved by\n// `setToday` moves them all (0.55).\n\n/** Today shifted by `days`, as \"YYYY-MM-DD\". */\nexport function shiftIso(days: number): string {\n  const d = currentDate();\n  d.setDate(d.getDate() + days);\n  return toLocalIso(d);\n}\n\n/** First day (Monday) of the current week, as \"YYYY-MM-DD\". */\nexport function startOfWeekIso(): string {\n  const d = currentDate();\n  const day = d.getDay();\n  const diff = (day + 6) % 7; // monday = 0\n  d.setDate(d.getDate() - diff);\n  return toLocalIso(d);\n}\n\n/** First day of the month `offsetMonths` from now, as \"YYYY-MM-DD\". */\nexport function startOfMonthIso(offsetMonths = 0): string {\n  const d = currentDate();\n  d.setDate(1);\n  d.setMonth(d.getMonth() + offsetMonths);\n  return toLocalIso(d);\n}\n\n/** Last day of the month `offsetMonths` from now, as \"YYYY-MM-DD\". */\nexport function endOfMonthIso(offsetMonths = 0): string {\n  const d = currentDate();\n  d.setDate(1);\n  d.setMonth(d.getMonth() + offsetMonths + 1);\n  d.setDate(0);\n  return toLocalIso(d);\n}\n\n/** First day of the year `offsetYears` from now, as \"YYYY-MM-DD\". */\nexport function startOfYearIso(offsetYears = 0): string {\n  const d = currentDate();\n  d.setMonth(0);\n  d.setDate(1);\n  d.setFullYear(d.getFullYear() + offsetYears);\n  return toLocalIso(d);\n}\n\n/** Last day of the year `offsetYears` from now, as \"YYYY-MM-DD\". */\nexport function endOfYearIso(offsetYears = 0): string {\n  const d = currentDate();\n  d.setMonth(11);\n  d.setDate(31);\n  d.setFullYear(d.getFullYear() + offsetYears);\n  return toLocalIso(d);\n}\n\n/** Parse a \"YYYY-MM-DD\" string to a local-midnight Date, or null if malformed —\n *  where \"malformed\" includes a date that does not exist.\n *\n *  The falsy check alone was not enough. `new Date(y, m - 1, d)` ROLLS OVER out-of-range\n *  components rather than refusing them, so \"2026-13-45\" came back as 2027-02-14 and\n *  \"2026-02-30\" as 2026-03-02: a valid-looking Date for a day that never happened. No\n *  caller could tell — {@link formatIsoDate} blanks only on `null`, so the invented\n *  date formatted and displayed exactly like a real one.\n *\n *  The round-trip is the check: build the Date, then read the components back off it.\n *  A value that rolled over cannot answer with the numbers it was given. That is the\n *  same shape {@link sameYmd} already expresses, applied to a Date and its source. */\nexport function parseIsoDate(s: string): Date | null {\n  if (!s) return null;\n  const [y, m, d] = s.split(\"-\").map(Number);\n  if (!y || !m || !d) return null;\n  if (!Number.isInteger(y) || !Number.isInteger(m) || !Number.isInteger(d)) return null;\n  const dt = new Date(y, m - 1, d);\n  if (Number.isNaN(dt.getTime())) return null;\n  if (dt.getFullYear() !== y || dt.getMonth() !== m - 1 || dt.getDate() !== d) return null;\n  return dt;\n}\n\n/** The fields that make an option set a DATE for `toLocaleDateString` (ECMA-402's\n *  ToDateTimeOptions, required \"date\"): with none of them it adds year, month and day. */\nconst DATE_FIELDS = [\"weekday\", \"year\", \"month\", \"day\", \"dateStyle\"] as const;\nconst NUMERIC_DATE: Intl.DateTimeFormatOptions = { year: \"numeric\", month: \"numeric\", day: \"numeric\" };\n\n/** `options` as `toLocaleDateString` reads them: with a date in them, whatever else they\n *  ask for. `{ hour: \"numeric\" }` alone is a date and an hour there, never the hour alone\n *  that `Intl.DateTimeFormat` would print for it. */\nfunction asDateOptions(options: Intl.DateTimeFormatOptions | undefined): Intl.DateTimeFormatOptions {\n  if (!options) return NUMERIC_DATE;\n  return DATE_FIELDS.some((field) => options[field] !== undefined) ? options : { ...options, ...NUMERIC_DATE };\n}\n\n/** Format a \"YYYY-MM-DD\" string for display in `locale` (empty string when\n *  unparseable). Defaults to the locale's short numeric date; pass `options` to\n *  override (e.g. `{ dateStyle: \"medium\" }`). `locale` may be `undefined` since 0.34 —\n *  the runtime's default, as `Intl` reads it and as every other kit formatter takes it\n *  (DUP-11: DatePicker re-wrapped this function only to pass none).\n *\n *  Through the kit's formatter cache since 0.54 (keksdose audit follow-up, 2026-11-01):\n *  `toLocaleDateString` builds a formatter per call, and this one runs for the date\n *  pickers' trigger on every render and for an app's date column once per row. The output\n *  is `toLocaleDateString`'s: the same options, with the date it adds when they name none\n *  (`asDateOptions`). */\nexport function formatIsoDate(iso: string, locale: string | undefined, options?: Intl.DateTimeFormatOptions): string {\n  const d = parseIsoDate(iso);\n  return d ? dateFormatter(locale, asDateOptions(options)).format(d) : \"\";\n}\n\n/** A \"YYYY-MM-DD\" string shifted by `days` (negative shifts back), or the input\n *  unchanged when it isn't a parseable date.\n *\n *  Local-time throughout — {@link parseIsoDate} builds a local-midnight Date and\n *  {@link toLocalIso} reads local components back, so this never slides a day the way\n *  a `toISOString()` round-trip does west of UTC. */\nexport function addDaysIso(iso: string, days: number): string {\n  const d = parseIsoDate(iso);\n  if (!d) return iso;\n  d.setDate(d.getDate() + days);\n  return toLocalIso(d);\n}\n\n/**\n * `d` moved by whole months, keeping the day of the month where the target has one.\n * `setMonth` alone ROLLS OVER — 31 January + 1 month is 3 March — which would skip\n * February entirely for anyone paging through the year with PageDown. Returns a new\n * Date; `d` is not touched.\n */\nexport function addMonthsClamped(d: Date, months: number): Date {\n  const day = d.getDate();\n  const out = new Date(d.getFullYear(), d.getMonth() + months, 1);\n  const lastOfTarget = new Date(out.getFullYear(), out.getMonth() + 1, 0).getDate();\n  out.setDate(Math.min(day, lastOfTarget));\n  return out;\n}\n\n/**\n * The first day of the week in `locale`, as a `Date#getDay` index (0 = Sunday).\n *\n * `Intl.Locale#getWeekInfo()` is the standard spelling; V8 shipped it first as the\n * `weekInfo` accessor, and Firefox has neither yet — hence both reads and a Monday\n * fallback, which is ISO 8601. Its `firstDay` counts 1 = Monday … 7 = Sunday, so `% 7`\n * maps it onto `getDay`. `undefined` asks for the runtime's default locale.\n */\nexport function localeWeekStart(locale: string | undefined): 0 | 1 | 2 | 3 | 4 | 5 | 6 {\n  try {\n    const tag = locale ?? new Intl.DateTimeFormat().resolvedOptions().locale;\n    const loc = new Intl.Locale(tag) as Intl.Locale & {\n      getWeekInfo?: () => { firstDay: number };\n      weekInfo?: { firstDay: number };\n    };\n    const firstDay = (loc.getWeekInfo?.() ?? loc.weekInfo)?.firstDay;\n    if (typeof firstDay === \"number\") return (firstDay % 7) as 0 | 1 | 2 | 3 | 4 | 5 | 6;\n  } catch {\n    // A malformed tag throws from `Intl.Locale`; a calendar still has to render.\n  }\n  return 1;\n}\n\n/** Whether two Dates fall on the same local calendar day. */\nexport function sameYmd(a: Date, b: Date): boolean {\n  return a.getFullYear() === b.getFullYear() && a.getMonth() === b.getMonth() && a.getDate() === b.getDate();\n}\n\nexport interface DateRangePreset {\n  key: string;\n  from: string;\n  to: string;\n}\n\n/**\n * The named ranges offered by the data-table date filter (local-calendar, like\n * {@link todayIso} — see the module note). `key` maps to the consumer's\n * `table.preset_*` labels.\n */\nexport function dateRangePresets(): DateRangePreset[] {\n  const mondayOffset = (currentDate().getDay() + 6) % 7; // monday = 0\n  return [\n    { key: \"today\", from: todayIso(), to: todayIso() },\n    { key: \"yesterday\", from: shiftIso(-1), to: shiftIso(-1) },\n    { key: \"this_week\", from: startOfWeekIso(), to: todayIso() },\n    { key: \"last_week\", from: shiftIso(-7 - mondayOffset), to: shiftIso(-1 - mondayOffset) },\n    { key: \"last_7_days\", from: shiftIso(-6), to: todayIso() },\n    { key: \"last_30_days\", from: shiftIso(-29), to: todayIso() },\n    { key: \"this_month\", from: startOfMonthIso(0), to: todayIso() },\n    { key: \"last_month\", from: startOfMonthIso(-1), to: endOfMonthIso(-1) },\n    { key: \"last_3_months\", from: shiftIso(-90), to: todayIso() },\n    { key: \"ytd\", from: startOfYearIso(0), to: todayIso() },\n    { key: \"last_year\", from: startOfYearIso(-1), to: endOfYearIso(-1) },\n  ];\n}\n\n/** The last `n` WHOLE calendar months before the current one, as an inclusive\n *  `{ from, to }` — on 15 May, `n = 3` is 1 February … 30 April. Local-calendar, like\n *  everything here; `now` is for tests and for a host with its own clock (default\n *  {@link currentDate}). */\nexport function lastFullMonthsRange(n: number, now: Date = currentDate()): { from: string; to: string } {\n  const from = new Date(now.getFullYear(), now.getMonth() - n, 1);\n  // Day 0 of the current month is the last day of the previous one.\n  const to = new Date(now.getFullYear(), now.getMonth(), 0);\n  return { from: toLocalIso(from), to: toLocalIso(to) };\n}\n\n/** The last `n` WHOLE calendar years before the current one — in 2026, `n = 2` is\n *  1 January 2024 … 31 December 2025. */\nexport function lastFullYearsRange(n: number, now: Date = currentDate()): { from: string; to: string } {\n  const year = now.getFullYear();\n  return { from: `${year - n}-01-01`, to: `${year - 1}-12-31` };\n}\n\nexport interface CalendarMonthPresetOptions {\n  /** How many whole months each month preset spans. Default `[3, 6]`. */\n  months?: readonly number[];\n  /** How many whole years each year preset spans. Default `[2]`. */\n  years?: readonly number[];\n  /** The day to count back from. Default: now, on the local calendar ({@link currentDate}). */\n  now?: Date;\n}\n\n/**\n * Month-ALIGNED presets, beside the rolling-day ones of {@link dateRangePresets}.\n *\n * kastlan's accounting reports are closed by the month: \"the last three months\" there\n * means February, March and April, never \"the 90 days up to this morning\", which\n * starts mid-month and ends with a day that is still being booked. `last_3_months`\n * above is the rolling kind and stays that way for the data table's filter, so these\n * are separate keys rather than a changed meaning under an old one.\n *\n * Keys are `last_<n>_full_months` and `last_<n>_full_years`; the host labels them (the\n * same arrangement as `dateRangePresets`' keys and its `table.preset_*` strings). With\n * `DateRangePicker`, pass the key as the preset's `id` so the choice keeps its\n * identity while the dates are recomputed on every render.\n */\nexport function calendarMonthPresets(options: CalendarMonthPresetOptions = {}): DateRangePreset[] {\n  const { months = [3, 6], years = [2], now = currentDate() } = options;\n  return [\n    ...months.map((n) => ({ key: `last_${n}_full_months`, ...lastFullMonthsRange(n, now) })),\n    ...years.map((n) => ({ key: `last_${n}_full_years`, ...lastFullYearsRange(n, now) })),\n  ];\n}\n"],"mappings":"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","names":[]}

package/dist/lib/editable-content.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Internal (not exported from the package): the kit's one reading of "this is editable
+ * content", for the five places that leave typed text alone — `useHotkey`'s typing check,
+ * the tour's Enter and arrows (tour-overlay `ownsKey`), the bulk bar's arrows
+ * (`ownsArrows`), the clipboard's minus (clipboard-minus `isEditable`) and the Lightbox's
+ * paging keys.
+ *
+ * 0.54 wrote it for `useHotkey` (keksdose audit follow-up, 2026-11-01); the other three
+ * read `isContentEditable` alone, or a `[contenteditable=""], [contenteditable="true"]`
+ * selector beside it, and had the gap it closed (0.54 follow-up). The Lightbox's
+ * `[contenteditable='true']` selector had it too (0.52 code review 2026-10-31, held to
+ * 0.55). Here, so the five cannot drift, and in lib/ because it is DOM reading with no
+ * component code: the
+ * clipboard handler, which `UiKitProvider` loads on its own, must not bring a component
+ * with it.
+ */
+/**
+ * Whether `el` is editable content — `isContentEditable`, read from the attributes where
+ * the engine has no such property. jsdom is one: there a hotkey fired while typing in a
+ * contenteditable, the tour stepped on and the bulk bar took the caret's arrows, so no
+ * test could show an editor keeping its keys, and an engine without the property would
+ * do the same.
+ *
+ * The nearest element with a `contenteditable` that names a state decides: `""`,
+ * `"true"` and `"plaintext-only"` edit, `"false"` does not — a `false` island inside an
+ * editor (a mention chip) is not typed in. Any other value is the attribute's
+ * invalid-value default, which inherits, so the search goes on to the next one up.
+ * Keywords are case-insensitive. None at all: editable only in a `designMode` document.
+ *
+ * An `Element`, not only an `HTMLElement`: the clipboard asks about whatever node a
+ * selection starts in, an SVG icon inside an editor included.
+ */
+export declare function isEditableContent(el: Element): boolean;

package/dist/lib/editable-content.js

@@ -0,0 +1,15 @@
+"use client";
+function isEditableContent(el) {
+  const native = el.isContentEditable;
+  if (native !== void 0) return native;
+  for (let at = el.closest("[contenteditable]"); at; at = at.parentElement?.closest("[contenteditable]") ?? null) {
+    const state = (at.getAttribute("contenteditable") ?? "").toLowerCase();
+    if (state === "" || state === "true" || state === "plaintext-only") return true;
+    if (state === "false") return false;
+  }
+  return el.ownerDocument.designMode === "on";
+}
+export {
+  isEditableContent
+};
+//# sourceMappingURL=editable-content.js.map

package/dist/lib/editable-content.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/editable-content.ts"],"sourcesContent":["/**\n * Internal (not exported from the package): the kit's one reading of \"this is editable\n * content\", for the five places that leave typed text alone — `useHotkey`'s typing check,\n * the tour's Enter and arrows (tour-overlay `ownsKey`), the bulk bar's arrows\n * (`ownsArrows`), the clipboard's minus (clipboard-minus `isEditable`) and the Lightbox's\n * paging keys.\n *\n * 0.54 wrote it for `useHotkey` (keksdose audit follow-up, 2026-11-01); the other three\n * read `isContentEditable` alone, or a `[contenteditable=\"\"], [contenteditable=\"true\"]`\n * selector beside it, and had the gap it closed (0.54 follow-up). The Lightbox's\n * `[contenteditable='true']` selector had it too (0.52 code review 2026-10-31, held to\n * 0.55). Here, so the five cannot drift, and in lib/ because it is DOM reading with no\n * component code: the\n * clipboard handler, which `UiKitProvider` loads on its own, must not bring a component\n * with it.\n */\n\n/**\n * Whether `el` is editable content — `isContentEditable`, read from the attributes where\n * the engine has no such property. jsdom is one: there a hotkey fired while typing in a\n * contenteditable, the tour stepped on and the bulk bar took the caret's arrows, so no\n * test could show an editor keeping its keys, and an engine without the property would\n * do the same.\n *\n * The nearest element with a `contenteditable` that names a state decides: `\"\"`,\n * `\"true\"` and `\"plaintext-only\"` edit, `\"false\"` does not — a `false` island inside an\n * editor (a mention chip) is not typed in. Any other value is the attribute's\n * invalid-value default, which inherits, so the search goes on to the next one up.\n * Keywords are case-insensitive. None at all: editable only in a `designMode` document.\n *\n * An `Element`, not only an `HTMLElement`: the clipboard asks about whatever node a\n * selection starts in, an SVG icon inside an editor included.\n */\nexport function isEditableContent(el: Element): boolean {\n  const native = (el as { isContentEditable?: boolean }).isContentEditable;\n  if (native !== undefined) return native;\n  for (let at = el.closest(\"[contenteditable]\"); at; at = at.parentElement?.closest(\"[contenteditable]\") ?? null) {\n    const state = (at.getAttribute(\"contenteditable\") ?? \"\").toLowerCase();\n    if (state === \"\" || state === \"true\" || state === \"plaintext-only\") return true;\n    if (state === \"false\") return false;\n  }\n  return el.ownerDocument.designMode === \"on\";\n}\n"],"mappings":";AAiCO,SAAS,kBAAkB,IAAsB;AACtD,QAAM,SAAU,GAAuC;AACvD,MAAI,WAAW,OAAW,QAAO;AACjC,WAAS,KAAK,GAAG,QAAQ,mBAAmB,GAAG,IAAI,KAAK,GAAG,eAAe,QAAQ,mBAAmB,KAAK,MAAM;AAC9G,UAAM,SAAS,GAAG,aAAa,iBAAiB,KAAK,IAAI,YAAY;AACrE,QAAI,UAAU,MAAM,UAAU,UAAU,UAAU,iBAAkB,QAAO;AAC3E,QAAI,UAAU,QAAS,QAAO;AAAA,EAChC;AACA,SAAO,GAAG,cAAc,eAAe;AACzC;","names":[]}