@eifi1/ui-kit 0.51.7 → 0.52.0

package/dist/hooks/use-focus-trap.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hooks/use-focus-trap.ts"],"sourcesContent":["import { useEffect, useLayoutEffect, useRef, useState } from \"react\";\n\n/**\n * Keep keyboard focus inside an open overlay, and give it back when it closes.\n *\n * Extracted from `Modal`, which was the ONLY component in this package that did any of\n * this. Every other overlay — the full-bleed dialog a phone's row editor opens, the\n * picker sheet, the numpad, the tour card — declared `role=\"dialog\" aria-modal=\"true\"`\n * and then left focus on the page behind it. That is the worst of the two possible\n * bugs: assistive technology hides the page because of `aria-modal`, while the user's\n * focus is still down there in the part that is now hidden, so Tab walks through\n * controls the screen reader refuses to describe.\n *\n * What this does beyond Modal's original copy:\n *\n *   - **Recomputes the tabbable list on every Tab**, not once when the overlay opens.\n *     These panels have conditionally-rendered contents — a search box that appears\n *     once options load, a \"clear\" button that exists only while a filter is set — and\n *     a list captured at open time traps focus against elements that have since gone.\n *   - **Guards the restore target.** The element focused before opening may have left\n *     the DOM by the time the overlay closes (the row that owned the button was\n *     filtered away). Calling `.focus()` on a detached node silently drops focus to\n *     `<body>`, which for a keyboard user means losing their place in the page\n *     entirely. When the target is gone, focus falls back to the nearest thing that\n *     still exists rather than to nothing.\n *   - **Leaves an app's own autofocus alone** (0.33.1). React honours a child's\n *     `autoFocus` while it commits, and this hook's effect runs AFTER that commit, so\n *     focusing the container there took focus straight back off the field the app had\n *     asked for. See `initialFocus`.\n *   - **Nests.** An overlay can open another — a picker inside a dialog. Only the\n *     innermost trap handles a keystroke, and closing it hands control back to the one\n *     underneath. Innermost is decided by DOM containment rather than by mount order;\n *     see the note on `TRAP_ATTR` for why the obvious stack is wrong.\n *     `use-overlay-history.ts` reasons about the same nesting problem for the back\n *     button; this is the focus half of it.\n */\n\n/**\n * Candidate tab stops, in DOM order — narrowed by {@link isTabStop} to the ones a Tab\n * really reaches.\n *\n * The selector is the one `Modal` used. On its own it was not enough (round 0.34\n * BUG-4): only the bare `[tabindex]` clause excluded `-1`, so a `button`, an `input` or\n * a link taken out of the tab order still counted. A panel that ends in a roving grid —\n * the calendar's days, the month grid, the picker sheet's rows, every one of them `-1`\n * but the active cell — then had a \"last\" stop no Tab ever reaches: Tab from the real\n * last stop was not wrapped and walked out of the open panel, and Shift+Tab from the\n * first landed on a cell that is not a stop at all.\n */\nconst FOCUSABLE =\n  'a[href],button:not([disabled]),textarea:not([disabled]),input:not([disabled]),select:not([disabled]),[tabindex]:not([tabindex=\"-1\"])';\n\n/**\n * A stop the browser's own Tab would land on: in the tab order (`tabIndex` ≥ 0) and not\n * inside something `hidden` or `inert`. Removes only elements a native Tab never\n * reaches, so no correct order changes. `visibility: hidden` and closed `<details>` are\n * still not walked — they need layout, which this list has never read.\n */\nconst isTabStop = (el: HTMLElement): boolean => el.tabIndex >= 0 && !el.closest(\"[hidden],[inert]\");\n\n/**\n * Marks a container whose trap is currently active.\n *\n * \"Which trap is innermost?\" is answered by DOM CONTAINMENT, not by mount order. The\n * obvious implementation — a module-level stack pushed in the effect — is wrong, and\n * wrong in a way that passes a casual reading: React runs CHILD effects before PARENT\n * effects, so a nested overlay pushes first and the outer one ends up on top of the\n * stack, claiming to be innermost. The outer trap then handles the keystroke and wraps\n * focus to its own first element, jumping the user out of the picker they had open.\n *\n * An attribute on the live DOM cannot disagree with the DOM.\n */\nconst TRAP_ATTR = \"data-focus-trap\";\n\nexport interface FocusTrapOptions {\n  /** Trap only while this is true. Mount-time `true` is the common case. */\n  active?: boolean;\n  /** Return focus to whatever had it before the trap engaged. Default `true`. */\n  restoreFocus?: boolean;\n  /**\n   * What to focus when the trap engages. Default is the container itself, which is\n   * what `Modal` does and why: focusing the first FIELD pops the software keyboard on\n   * a phone the moment a dialog opens, before the user has asked to type.\n   * The container needs `tabIndex={-1}` for this to work.\n   *\n   * `\"container\"` and `\"first\"` both step aside when focus is ALREADY inside the\n   * container, on something other than the container itself. That is a child the app\n   * focused on purpose — an `autoFocus`, which React honours before this hook's effect\n   * runs — and the keyboard it brings up is the one the user was promised. Moving focus\n   * off it lost keksdose's create card its amount field the instant it got it, and on a\n   * phone the numpad sheet with it, which shows only while the field is focused (live\n   * #402). A function is the caller's explicit choice and is always followed.\n   */\n  initialFocus?: \"container\" | \"first\" | (() => HTMLElement | null);\n}\n\n/** Whatever has focus right now; nothing on the server, where there is no document. */\nfunction focusedElement(): Element | null {\n  return typeof document === \"undefined\" ? null : document.activeElement;\n}\n\nexport function useFocusTrap(\n  containerRef: React.RefObject<HTMLElement | null>,\n  { active = true, restoreFocus = true, initialFocus = \"container\" }: FocusTrapOptions = {},\n): void {\n  // Latest-ref so a caller passing an inline `initialFocus` thunk — which every caller\n  // will — does not tear the trap down and re-engage it on each render, stealing focus\n  // back to the top of the panel mid-interaction. Written in a LAYOUT effect so that\n  // the trap's cleanup, which runs after the layout effects of the same commit, reads\n  // this render's `active` rather than the last one's — see the cleanup for why.\n  const optsRef = useRef({ active, restoreFocus, initialFocus });\n  useLayoutEffect(() => {\n    optsRef.current = { active, restoreFocus, initialFocus };\n  });\n\n  // Where focus was BEFORE the trap engaged: the element it is given back to on close.\n  //\n  // Read DURING the render that turns the trap on, and that timing is the point. React\n  // honours a child's `autoFocus` while it commits that render, before any effect runs,\n  // so the effect below asking `document.activeElement` would get the child, inside the\n  // overlay. Restoring to that on close aimed focus at the dialog that was closing —\n  // already out of the DOM, so focus fell to <body> rather than going back to the\n  // button that opened it.\n  //\n  // State adjusted during render (the pattern `Modal` uses for `open`) rather than a\n  // ref written there: set once per opening and cleared on release, so a re-render\n  // while open cannot replace it with something inside, and StrictMode's second render\n  // and second effect both see the same element. `undefined` means \"not captured\";\n  // `null` is a capture that found nothing.\n  const [opener, setOpener] = useState<Element | null | undefined>(undefined);\n  if (active && opener === undefined) setOpener(focusedElement());\n  else if (!active && opener !== undefined) setOpener(undefined);\n\n  useEffect(() => {\n    if (!active) return;\n    const container = containerRef.current;\n    if (!container) return;\n\n    container.setAttribute(TRAP_ATTR, \"\");\n\n    /** Is `node` inside a trap nested within this one? */\n    const inNestedTrap = (node: Element | null) => {\n      if (!node) return false;\n      const owner = node.closest(`[${TRAP_ATTR}]`);\n      return owner !== null && owner !== container;\n    };\n\n    const tabbables = () =>\n      Array.from(container.querySelectorAll<HTMLElement>(FOCUSABLE)).filter(\n        // A tabbable inside a NESTED open overlay belongs to that overlay's trap, not\n        // to this one — otherwise the outer list spans both panels and Tab from the\n        // inner panel's last control wraps to the OUTER panel's first.\n        (el) => isTabStop(el) && !inNestedTrap(el),\n      );\n\n    const { initialFocus: how } = optsRef.current;\n    const focused = document.activeElement;\n    // A child that already has focus was given it on purpose — see `initialFocus`.\n    const childHasFocus = focused !== container && container.contains(focused);\n    if (typeof how === \"function\") {\n      (how() ?? container).focus();\n    } else if (!childHasFocus) {\n      (how === \"first\" ? (tabbables()[0] ?? container) : container).focus();\n    }\n\n    const onKeyDown = (e: KeyboardEvent) => {\n      if (e.key !== \"Tab\") return;\n      // Only the innermost trap acts. The event bubbles through every ancestor\n      // container, so without this an outer dialog and an inner picker both handle one\n      // Tab and fight over where focus lands.\n      if (inNestedTrap(document.activeElement)) return;\n\n      // Recomputed per keystroke — see the note at the top of this file.\n      const items = tabbables();\n      if (items.length === 0) {\n        e.preventDefault();\n        container.focus();\n        return;\n      }\n      const first = items[0];\n      const last = items[items.length - 1];\n      const activeEl = document.activeElement;\n      if (e.shiftKey && (activeEl === first || activeEl === container)) {\n        e.preventDefault();\n        last.focus();\n      } else if (!e.shiftKey && activeEl === last) {\n        e.preventDefault();\n        first.focus();\n      }\n    };\n\n    // On the container, not the document: a portalled child panel (an open dropdown\n    // rendered to <body>) is outside this subtree and manages its own focus, which is\n    // the behaviour Modal's comment describes and consumers already depend on.\n    container.addEventListener(\"keydown\", onKeyDown);\n\n    return () => {\n      container.removeEventListener(\"keydown\", onKeyDown);\n      container.removeAttribute(TRAP_ATTR);\n\n      // Only when the trap is really being released: the container has left the page,\n      // or `active` has turned false. StrictMode runs this cleanup once more right after\n      // mounting, with the overlay still up, and then the effect again — and React does\n      // not re-apply `autoFocus` for that second run. Restoring here would pull focus\n      // out of the autofocused field for good: live #402 again, in development.\n      if (container.isConnected && optsRef.current.active) return;\n      if (!optsRef.current.restoreFocus) return;\n      // `isConnected` is the whole point: restoring to a node that has been removed\n      // sends focus to <body> and the user loses their place entirely. When the\n      // original is gone, leave focus where the browser put it rather than moving it\n      // somewhere arbitrary — a wrong guess is worse than no move.\n      if (opener?.isConnected) (opener as HTMLElement).focus?.();\n    };\n  }, [active, containerRef, opener]);\n}\n"],"mappings":";AAAA,SAAS,WAAW,iBAAiB,QAAQ,gBAAgB;AAiD7D,MAAM,YACJ;AAQF,MAAM,YAAY,CAAC,OAA6B,GAAG,YAAY,KAAK,CAAC,GAAG,QAAQ,kBAAkB;AAclG,MAAM,YAAY;AAyBlB,SAAS,iBAAiC;AACxC,SAAO,OAAO,aAAa,cAAc,OAAO,SAAS;AAC3D;AAEO,SAAS,aACd,cACA,EAAE,SAAS,MAAM,eAAe,MAAM,eAAe,YAAY,IAAsB,CAAC,GAClF;AAMN,QAAM,UAAU,OAAO,EAAE,QAAQ,cAAc,aAAa,CAAC;AAC7D,kBAAgB,MAAM;AACpB,YAAQ,UAAU,EAAE,QAAQ,cAAc,aAAa;AAAA,EACzD,CAAC;AAgBD,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAqC,MAAS;AAC1E,MAAI,UAAU,WAAW,OAAW,WAAU,eAAe,CAAC;AAAA,WACrD,CAAC,UAAU,WAAW,OAAW,WAAU,MAAS;AAE7D,YAAU,MAAM;AACd,QAAI,CAAC,OAAQ;AACb,UAAM,YAAY,aAAa;AAC/B,QAAI,CAAC,UAAW;AAEhB,cAAU,aAAa,WAAW,EAAE;AAGpC,UAAM,eAAe,CAAC,SAAyB;AAC7C,UAAI,CAAC,KAAM,QAAO;AAClB,YAAM,QAAQ,KAAK,QAAQ,IAAI,SAAS,GAAG;AAC3C,aAAO,UAAU,QAAQ,UAAU;AAAA,IACrC;AAEA,UAAM,YAAY,MAChB,MAAM,KAAK,UAAU,iBAA8B,SAAS,CAAC,EAAE;AAAA;AAAA;AAAA;AAAA,MAI7D,CAAC,OAAO,UAAU,EAAE,KAAK,CAAC,aAAa,EAAE;AAAA,IAC3C;AAEF,UAAM,EAAE,cAAc,IAAI,IAAI,QAAQ;AACtC,UAAM,UAAU,SAAS;AAEzB,UAAM,gBAAgB,YAAY,aAAa,UAAU,SAAS,OAAO;AACzE,QAAI,OAAO,QAAQ,YAAY;AAC7B,OAAC,IAAI,KAAK,WAAW,MAAM;AAAA,IAC7B,WAAW,CAAC,eAAe;AACzB,OAAC,QAAQ,UAAW,UAAU,EAAE,CAAC,KAAK,YAAa,WAAW,MAAM;AAAA,IACtE;AAEA,UAAM,YAAY,CAAC,MAAqB;AACtC,UAAI,EAAE,QAAQ,MAAO;AAIrB,UAAI,aAAa,SAAS,aAAa,EAAG;AAG1C,YAAM,QAAQ,UAAU;AACxB,UAAI,MAAM,WAAW,GAAG;AACtB,UAAE,eAAe;AACjB,kBAAU,MAAM;AAChB;AAAA,MACF;AACA,YAAM,QAAQ,MAAM,CAAC;AACrB,YAAM,OAAO,MAAM,MAAM,SAAS,CAAC;AACnC,YAAM,WAAW,SAAS;AAC1B,UAAI,EAAE,aAAa,aAAa,SAAS,aAAa,YAAY;AAChE,UAAE,eAAe;AACjB,aAAK,MAAM;AAAA,MACb,WAAW,CAAC,EAAE,YAAY,aAAa,MAAM;AAC3C,UAAE,eAAe;AACjB,cAAM,MAAM;AAAA,MACd;AAAA,IACF;AAKA,cAAU,iBAAiB,WAAW,SAAS;AAE/C,WAAO,MAAM;AACX,gBAAU,oBAAoB,WAAW,SAAS;AAClD,gBAAU,gBAAgB,SAAS;AAOnC,UAAI,UAAU,eAAe,QAAQ,QAAQ,OAAQ;AACrD,UAAI,CAAC,QAAQ,QAAQ,aAAc;AAKnC,UAAI,QAAQ,YAAa,CAAC,OAAuB,QAAQ;AAAA,IAC3D;AAAA,EACF,GAAG,CAAC,QAAQ,cAAc,MAAM,CAAC;AACnC;","names":[]}
+{"version":3,"sources":["../../src/hooks/use-focus-trap.ts"],"sourcesContent":["import { useEffect, useLayoutEffect, useRef, useState } from \"react\";\nimport { tabStops } from \"../lib/focus-left\";\n\n/**\n * Keep keyboard focus inside an open overlay, and give it back when it closes.\n *\n * Extracted from `Modal`, which was the ONLY component in this package that did any of\n * this. Every other overlay — the full-bleed dialog a phone's row editor opens, the\n * picker sheet, the numpad, the tour card — declared `role=\"dialog\" aria-modal=\"true\"`\n * and then left focus on the page behind it. That is the worst of the two possible\n * bugs: assistive technology hides the page because of `aria-modal`, while the user's\n * focus is still down there in the part that is now hidden, so Tab walks through\n * controls the screen reader refuses to describe.\n *\n * What this does beyond Modal's original copy:\n *\n *   - **Recomputes the tabbable list on every Tab**, not once when the overlay opens.\n *     These panels have conditionally-rendered contents — a search box that appears\n *     once options load, a \"clear\" button that exists only while a filter is set — and\n *     a list captured at open time traps focus against elements that have since gone.\n *   - **Guards the restore target.** The element focused before opening may have left\n *     the DOM by the time the overlay closes (the row that owned the button was\n *     filtered away). Calling `.focus()` on a detached node silently drops focus to\n *     `<body>`, which for a keyboard user means losing their place in the page\n *     entirely. When the target is gone, focus falls back to the nearest thing that\n *     still exists rather than to nothing.\n *   - **Leaves an app's own autofocus alone** (0.33.1). React honours a child's\n *     `autoFocus` while it commits, and this hook's effect runs AFTER that commit, so\n *     focusing the container there took focus straight back off the field the app had\n *     asked for. See `initialFocus`.\n *   - **Nests.** An overlay can open another — a picker inside a dialog. Only the\n *     innermost trap handles a keystroke, and closing it hands control back to the one\n *     underneath. Innermost is decided by DOM containment rather than by mount order;\n *     see the note on `TRAP_ATTR` for why the obvious stack is wrong.\n *     `use-overlay-history.ts` reasons about the same nesting problem for the back\n *     button; this is the focus half of it.\n */\n\n// The trap's reading of \"a Tab lands here\" is lib/focus-left's `tabStops` — the kit's one\n// copy of the rule since the 0.52 code review (round 0.34 BUG-4's history is there).\n// Re-exported where refactor audit 2026-10-30, DUP-9 put them, for a part that walks Tab\n// over something that is not a trap (the tour's field + card ring).\nexport { firstTabStop, tabStops } from \"../lib/focus-left\";\n\n/**\n * Marks a container whose trap is currently active.\n *\n * \"Which trap is innermost?\" is answered by DOM CONTAINMENT, not by mount order. The\n * obvious implementation — a module-level stack pushed in the effect — is wrong, and\n * wrong in a way that passes a casual reading: React runs CHILD effects before PARENT\n * effects, so a nested overlay pushes first and the outer one ends up on top of the\n * stack, claiming to be innermost. The outer trap then handles the keystroke and wraps\n * focus to its own first element, jumping the user out of the picker they had open.\n *\n * An attribute on the live DOM cannot disagree with the DOM.\n */\nconst TRAP_ATTR = \"data-focus-trap\";\n\nexport interface FocusTrapOptions {\n  /** Trap only while this is true. Mount-time `true` is the common case. */\n  active?: boolean;\n  /** Return focus to whatever had it before the trap engaged. Default `true`. */\n  restoreFocus?: boolean;\n  /**\n   * What to focus when the trap engages. Default is the container itself, which is\n   * what `Modal` does and why: focusing the first FIELD pops the software keyboard on\n   * a phone the moment a dialog opens, before the user has asked to type.\n   * The container needs `tabIndex={-1}` for this to work.\n   *\n   * `\"container\"` and `\"first\"` both step aside when focus is ALREADY inside the\n   * container, on something other than the container itself. That is a child the app\n   * focused on purpose — an `autoFocus`, which React honours before this hook's effect\n   * runs — and the keyboard it brings up is the one the user was promised. Moving focus\n   * off it lost keksdose's create card its amount field the instant it got it, and on a\n   * phone the numpad sheet with it, which shows only while the field is focused (live\n   * #402). A function is the caller's explicit choice and is always followed.\n   */\n  initialFocus?: \"container\" | \"first\" | (() => HTMLElement | null);\n}\n\n/** Whatever has focus right now; nothing on the server, where there is no document. */\nfunction focusedElement(): Element | null {\n  return typeof document === \"undefined\" ? null : document.activeElement;\n}\n\nexport function useFocusTrap(\n  containerRef: React.RefObject<HTMLElement | null>,\n  { active = true, restoreFocus = true, initialFocus = \"container\" }: FocusTrapOptions = {},\n): void {\n  // Latest-ref so a caller passing an inline `initialFocus` thunk — which every caller\n  // will — does not tear the trap down and re-engage it on each render, stealing focus\n  // back to the top of the panel mid-interaction. Written in a LAYOUT effect so that\n  // the trap's cleanup, which runs after the layout effects of the same commit, reads\n  // this render's `active` rather than the last one's — see the cleanup for why.\n  const optsRef = useRef({ active, restoreFocus, initialFocus });\n  useLayoutEffect(() => {\n    optsRef.current = { active, restoreFocus, initialFocus };\n  });\n\n  // Where focus was BEFORE the trap engaged: the element it is given back to on close.\n  //\n  // Read DURING the render that turns the trap on, and that timing is the point. React\n  // honours a child's `autoFocus` while it commits that render, before any effect runs,\n  // so the effect below asking `document.activeElement` would get the child, inside the\n  // overlay. Restoring to that on close aimed focus at the dialog that was closing —\n  // already out of the DOM, so focus fell to <body> rather than going back to the\n  // button that opened it.\n  //\n  // State adjusted during render (the pattern `Modal` uses for `open`) rather than a\n  // ref written there: set once per opening and cleared on release, so a re-render\n  // while open cannot replace it with something inside, and StrictMode's second render\n  // and second effect both see the same element. `undefined` means \"not captured\";\n  // `null` is a capture that found nothing.\n  const [opener, setOpener] = useState<Element | null | undefined>(undefined);\n  if (active && opener === undefined) setOpener(focusedElement());\n  else if (!active && opener !== undefined) setOpener(undefined);\n\n  useEffect(() => {\n    if (!active) return;\n    const container = containerRef.current;\n    if (!container) return;\n\n    container.setAttribute(TRAP_ATTR, \"\");\n\n    /** Is `node` inside a trap nested within this one? */\n    const inNestedTrap = (node: Element | null) => {\n      if (!node) return false;\n      const owner = node.closest(`[${TRAP_ATTR}]`);\n      return owner !== null && owner !== container;\n    };\n\n    const tabbables = () =>\n      tabStops(container, { includeSelf: false }).filter(\n        // A tabbable inside a NESTED open overlay belongs to that overlay's trap, not\n        // to this one — otherwise the outer list spans both panels and Tab from the\n        // inner panel's last control wraps to the OUTER panel's first.\n        (el) => !inNestedTrap(el),\n      );\n\n    const { initialFocus: how } = optsRef.current;\n    const focused = document.activeElement;\n    // A child that already has focus was given it on purpose — see `initialFocus`.\n    const childHasFocus = focused !== container && container.contains(focused);\n    if (typeof how === \"function\") {\n      (how() ?? container).focus();\n    } else if (!childHasFocus) {\n      (how === \"first\" ? (tabbables()[0] ?? container) : container).focus();\n    }\n\n    const onKeyDown = (e: KeyboardEvent) => {\n      if (e.key !== \"Tab\") return;\n      // Only the innermost trap acts. The event bubbles through every ancestor\n      // container, so without this an outer dialog and an inner picker both handle one\n      // Tab and fight over where focus lands.\n      if (inNestedTrap(document.activeElement)) return;\n\n      // Recomputed per keystroke — see the note at the top of this file.\n      const items = tabbables();\n      if (items.length === 0) {\n        e.preventDefault();\n        container.focus();\n        return;\n      }\n      const first = items[0];\n      const last = items[items.length - 1];\n      const activeEl = document.activeElement;\n      if (e.shiftKey && (activeEl === first || activeEl === container)) {\n        e.preventDefault();\n        last.focus();\n      } else if (!e.shiftKey && activeEl === last) {\n        e.preventDefault();\n        first.focus();\n      }\n    };\n\n    // On the container, not the document: a portalled child panel (an open dropdown\n    // rendered to <body>) is outside this subtree and manages its own focus, which is\n    // the behaviour Modal's comment describes and consumers already depend on.\n    container.addEventListener(\"keydown\", onKeyDown);\n\n    return () => {\n      container.removeEventListener(\"keydown\", onKeyDown);\n      container.removeAttribute(TRAP_ATTR);\n\n      // Only when the trap is really being released: the container has left the page,\n      // or `active` has turned false. StrictMode runs this cleanup once more right after\n      // mounting, with the overlay still up, and then the effect again — and React does\n      // not re-apply `autoFocus` for that second run. Restoring here would pull focus\n      // out of the autofocused field for good: live #402 again, in development.\n      if (container.isConnected && optsRef.current.active) return;\n      if (!optsRef.current.restoreFocus) return;\n      // `isConnected` is the whole point: restoring to a node that has been removed\n      // sends focus to <body> and the user loses their place entirely. When the\n      // original is gone, leave focus where the browser put it rather than moving it\n      // somewhere arbitrary — a wrong guess is worse than no move.\n      if (opener?.isConnected) (opener as HTMLElement).focus?.();\n    };\n  }, [active, containerRef, opener]);\n}\n"],"mappings":";AAAA,SAAS,WAAW,iBAAiB,QAAQ,gBAAgB;AAC7D,SAAS,gBAAgB;AAyCzB,SAAS,cAAc,YAAAA,iBAAgB;AAcvC,MAAM,YAAY;AAyBlB,SAAS,iBAAiC;AACxC,SAAO,OAAO,aAAa,cAAc,OAAO,SAAS;AAC3D;AAEO,SAAS,aACd,cACA,EAAE,SAAS,MAAM,eAAe,MAAM,eAAe,YAAY,IAAsB,CAAC,GAClF;AAMN,QAAM,UAAU,OAAO,EAAE,QAAQ,cAAc,aAAa,CAAC;AAC7D,kBAAgB,MAAM;AACpB,YAAQ,UAAU,EAAE,QAAQ,cAAc,aAAa;AAAA,EACzD,CAAC;AAgBD,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAqC,MAAS;AAC1E,MAAI,UAAU,WAAW,OAAW,WAAU,eAAe,CAAC;AAAA,WACrD,CAAC,UAAU,WAAW,OAAW,WAAU,MAAS;AAE7D,YAAU,MAAM;AACd,QAAI,CAAC,OAAQ;AACb,UAAM,YAAY,aAAa;AAC/B,QAAI,CAAC,UAAW;AAEhB,cAAU,aAAa,WAAW,EAAE;AAGpC,UAAM,eAAe,CAAC,SAAyB;AAC7C,UAAI,CAAC,KAAM,QAAO;AAClB,YAAM,QAAQ,KAAK,QAAQ,IAAI,SAAS,GAAG;AAC3C,aAAO,UAAU,QAAQ,UAAU;AAAA,IACrC;AAEA,UAAM,YAAY,MAChB,SAAS,WAAW,EAAE,aAAa,MAAM,CAAC,EAAE;AAAA;AAAA;AAAA;AAAA,MAI1C,CAAC,OAAO,CAAC,aAAa,EAAE;AAAA,IAC1B;AAEF,UAAM,EAAE,cAAc,IAAI,IAAI,QAAQ;AACtC,UAAM,UAAU,SAAS;AAEzB,UAAM,gBAAgB,YAAY,aAAa,UAAU,SAAS,OAAO;AACzE,QAAI,OAAO,QAAQ,YAAY;AAC7B,OAAC,IAAI,KAAK,WAAW,MAAM;AAAA,IAC7B,WAAW,CAAC,eAAe;AACzB,OAAC,QAAQ,UAAW,UAAU,EAAE,CAAC,KAAK,YAAa,WAAW,MAAM;AAAA,IACtE;AAEA,UAAM,YAAY,CAAC,MAAqB;AACtC,UAAI,EAAE,QAAQ,MAAO;AAIrB,UAAI,aAAa,SAAS,aAAa,EAAG;AAG1C,YAAM,QAAQ,UAAU;AACxB,UAAI,MAAM,WAAW,GAAG;AACtB,UAAE,eAAe;AACjB,kBAAU,MAAM;AAChB;AAAA,MACF;AACA,YAAM,QAAQ,MAAM,CAAC;AACrB,YAAM,OAAO,MAAM,MAAM,SAAS,CAAC;AACnC,YAAM,WAAW,SAAS;AAC1B,UAAI,EAAE,aAAa,aAAa,SAAS,aAAa,YAAY;AAChE,UAAE,eAAe;AACjB,aAAK,MAAM;AAAA,MACb,WAAW,CAAC,EAAE,YAAY,aAAa,MAAM;AAC3C,UAAE,eAAe;AACjB,cAAM,MAAM;AAAA,MACd;AAAA,IACF;AAKA,cAAU,iBAAiB,WAAW,SAAS;AAE/C,WAAO,MAAM;AACX,gBAAU,oBAAoB,WAAW,SAAS;AAClD,gBAAU,gBAAgB,SAAS;AAOnC,UAAI,UAAU,eAAe,QAAQ,QAAQ,OAAQ;AACrD,UAAI,CAAC,QAAQ,QAAQ,aAAc;AAKnC,UAAI,QAAQ,YAAa,CAAC,OAAuB,QAAQ;AAAA,IAC3D;AAAA,EACF,GAAG,CAAC,QAAQ,cAAc,MAAM,CAAC;AACnC;","names":["tabStops"]}

package/dist/hooks/use-hotkey.d.ts

@@ -49,9 +49,12 @@ export declare function matchesHotkey(e: KeyboardEvent, combo: ParsedHotkey): bo
  * - Modifiers match EXACTLY: `"Ctrl+K"` does not fire on Ctrl+Shift+K.
  * - Typing in a field is left alone unless `allowInInputs`, except for a combo with
  *   Ctrl / Meta / Alt, which no one types as text.
- * - A key held down fires once, not on every repeat.
+ * - A key held down fires once, not on every repeat — and its repeats are cancelled as
+ *   the first press was, or the browser acts on them.
  * - The newest `handler` is always called; changing it does not re-attach the listener.
  *
- * `useCommandKey` (the ⌘K palette hook) is unchanged; this is its general form.
+ * `useCommandKey` (the ⌘K palette hook) is this with `"Mod+K"` and `allowInInputs`
+ * since 0.52, and FormActions' Ctrl/Cmd+Enter is {@link matchesHotkey} (refactor audit
+ * 2026-10-30, DUP-12): one reading of a chord.
  */
 export declare function useHotkey(combo: Hotkey | ReadonlyArray<Hotkey>, handler: (event: KeyboardEvent) => void, options?: UseHotkeyOptions): void;

package/dist/hooks/use-hotkey.js

@@ -46,14 +46,15 @@ const KEY_ALIASES = {
   left: "arrowleft",
   right: "arrowright"
 };
+const NON_LATIN_LETTER = /^(?!\p{Script=Latin})\p{L}$/u;
 function matchesHotkey(e, combo) {
   if (e.ctrlKey !== combo.ctrl || e.metaKey !== combo.meta || e.altKey !== combo.alt) return false;
   const want = KEY_ALIASES[combo.key.toLowerCase()] ?? combo.key.toLowerCase();
   const key = (e.key ?? "").toLowerCase();
   const code = (e.code ?? "").toLowerCase();
-  const keyMatches = key === want || code === want;
-  if (!keyMatches) return false;
-  const symbol = want.length === 1 && !/[a-z0-9]/.test(want);
+  const physical = /^[a-z]$/.test(want) && NON_LATIN_LETTER.test(e.key ?? "") && code === `key${want}`;
+  if (key !== want && code !== want && !physical) return false;
+  const symbol = want.length === 1 && !/[a-z0-9 ]/.test(want);
   return symbol && !combo.shift ? true : e.shiftKey === combo.shift;
 }
 function isTypingTarget(target) {
@@ -82,7 +83,6 @@ function useHotkey(combo, handler, options = {}) {
     const parsed = key.split("\0").map((c) => parseHotkey(c, apple));
     const listener = (raw) => {
       const e = raw;
-      if (e.repeat) return;
       const hit = parsed.find((p) => matchesHotkey(e, p));
       if (!hit) return;
       if (allowInInputs !== true && isTypingTarget(e.target)) {
@@ -90,6 +90,7 @@ function useHotkey(combo, handler, options = {}) {
         if (allowInInputs === "never" || !chorded) return;
       }
       if (preventDefault) e.preventDefault();
+      if (e.repeat) return;
       handlerRef.current(e);
     };
     node.addEventListener(event, listener);

package/dist/hooks/use-hotkey.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hooks/use-hotkey.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\n\n/**\n * A key combination: modifiers and one key, joined by \"+\", case-insensitive —\n * `\"Ctrl+Shift+F\"`, `\"Mod+K\"`, `\"Alt+ArrowUp\"`, `\"Escape\"`, `\"?\"`.\n *\n * Modifiers: `Ctrl` (`Control`), `Meta` (`Cmd`, `Command`), `Shift`, `Alt` (`Option`),\n * and `Mod` — Cmd on Apple platforms, Ctrl everywhere else, the one to use for an\n * app shortcut. The key is `KeyboardEvent.key` (\"f\", \"Enter\", \"ArrowUp\", \"/\"), or a\n * `KeyboardEvent.code` (\"KeyF\", \"Digit1\") when the physical key is what matters.\n * Several combos: pass an array.\n */\nexport type Hotkey = string;\n\nexport interface UseHotkeyOptions {\n  /** Off while `false` (default `true`). */\n  enabled?: boolean;\n  /** Call `preventDefault()` on a match (default `true`): Ctrl+Shift+F must not also\n   *  open the browser's own dialog. */\n  preventDefault?: boolean;\n  /** Where to listen. Default `document`. A ref, an element, or `window`. */\n  target?: EventTarget | null | { current: EventTarget | null };\n  /**\n   * Fire while the focus is in a text field, select or contenteditable too. Default\n   * `false`: a shortcut must not steal the letters someone is typing. A combo with Ctrl,\n   * Meta or Alt is not typing — those still fire unless this is `\"never\"`.\n   */\n  allowInInputs?: boolean | \"never\";\n  /** `keydown` (default) or `keyup`. */\n  event?: \"keydown\" | \"keyup\";\n}\n\nexport interface ParsedHotkey {\n  ctrl: boolean;\n  meta: boolean;\n  shift: boolean;\n  alt: boolean;\n  key: string;\n}\n\n/** Whether this is an Apple platform, where `Mod` means Cmd. */\nexport function isApplePlatform(): boolean {\n  if (typeof navigator === \"undefined\") return false;\n  const nav = navigator as Navigator & { userAgentData?: { platform?: string } };\n  return /mac|iphone|ipad|ipod/i.test(nav.userAgentData?.platform || nav.platform || nav.userAgent);\n}\n\n/** Parse one combo. `apple` decides what `Mod` is. Throws on an empty key. */\nexport function parseHotkey(combo: Hotkey, apple = isApplePlatform()): ParsedHotkey {\n  const parts = combo\n    .split(\"+\")\n    .map((p) => p.trim())\n    // \"Ctrl++\" is Ctrl and \"+\": an empty part after a \"+\" is the plus key itself.\n    .map((p, i, all) => (p === \"\" && i === all.length - 1 ? \"+\" : p))\n    .filter((p) => p !== \"\");\n  const out: ParsedHotkey = { ctrl: false, meta: false, shift: false, alt: false, key: \"\" };\n  for (const part of parts) {\n    switch (part.toLowerCase()) {\n      case \"ctrl\":\n      case \"control\":\n        out.ctrl = true;\n        break;\n      case \"meta\":\n      case \"cmd\":\n      case \"command\":\n        out.meta = true;\n        break;\n      case \"mod\":\n        if (apple) out.meta = true;\n        else out.ctrl = true;\n        break;\n      case \"shift\":\n        out.shift = true;\n        break;\n      case \"alt\":\n      case \"option\":\n        out.alt = true;\n        break;\n      default:\n        out.key = part;\n    }\n  }\n  if (!out.key) throw new Error(`useHotkey: \"${combo}\" names no key`);\n  return out;\n}\n\nconst KEY_ALIASES: Record<string, string> = {\n  esc: \"escape\",\n  space: \" \",\n  del: \"delete\",\n  up: \"arrowup\",\n  down: \"arrowdown\",\n  left: \"arrowleft\",\n  right: \"arrowright\",\n};\n\n/** Whether `e` is `combo` — every modifier as named (no more, no fewer), and the key. */\nexport function matchesHotkey(e: KeyboardEvent, combo: ParsedHotkey): boolean {\n  if (e.ctrlKey !== combo.ctrl || e.metaKey !== combo.meta || e.altKey !== combo.alt) return false;\n  const want = KEY_ALIASES[combo.key.toLowerCase()] ?? combo.key.toLowerCase();\n  const key = (e.key ?? \"\").toLowerCase();\n  const code = (e.code ?? \"\").toLowerCase();\n  const keyMatches = key === want || code === want;\n  if (!keyMatches) return false;\n  // Shift must match exactly for a letter or a named key; for a symbol it is how the\n  // symbol is typed (\"?\" is Shift+/ on a US layout, a plain key on others), so an\n  // unnamed Shift is not held against it.\n  const symbol = want.length === 1 && !/[a-z0-9]/.test(want);\n  return symbol && !combo.shift ? true : e.shiftKey === combo.shift;\n}\n\n/** Is the focus somewhere that takes typed characters? */\nfunction isTypingTarget(target: EventTarget | null): boolean {\n  if (!(target instanceof HTMLElement)) return false;\n  if (target.isContentEditable) return true;\n  if (target instanceof HTMLTextAreaElement || target instanceof HTMLSelectElement) return true;\n  if (target instanceof HTMLInputElement) {\n    return ![\"button\", \"checkbox\", \"radio\", \"submit\", \"reset\", \"range\", \"color\", \"file\", \"image\"].includes(target.type);\n  }\n  return false;\n}\n\n/**\n * Call `handler` when `combo` is pressed — kastlan's feedback button (Ctrl+Shift+F,\n * feedback-button:60) wired it by hand, and so will every next shortcut.\n *\n * - `Mod` is Cmd on a Mac and Ctrl elsewhere, read once per mount.\n * - Modifiers match EXACTLY: `\"Ctrl+K\"` does not fire on Ctrl+Shift+K.\n * - Typing in a field is left alone unless `allowInInputs`, except for a combo with\n *   Ctrl / Meta / Alt, which no one types as text.\n * - A key held down fires once, not on every repeat.\n * - The newest `handler` is always called; changing it does not re-attach the listener.\n *\n * `useCommandKey` (the ⌘K palette hook) is unchanged; this is its general form.\n */\nexport function useHotkey(\n  combo: Hotkey | ReadonlyArray<Hotkey>,\n  handler: (event: KeyboardEvent) => void,\n  options: UseHotkeyOptions = {},\n): void {\n  const { enabled = true, preventDefault = true, target, allowInInputs = false, event = \"keydown\" } = options;\n  const handlerRef = useRef(handler);\n  useEffect(() => {\n    handlerRef.current = handler;\n  });\n  const key = typeof combo === \"string\" ? combo : combo.join(\"\\u0000\");\n  const targetEl = target && \"current\" in target ? undefined : target;\n  const targetRef = target && \"current\" in target ? target : undefined;\n\n  useEffect(() => {\n    if (!enabled) return;\n    const node: EventTarget | null =\n      targetRef?.current ?? targetEl ?? (typeof document === \"undefined\" ? null : document);\n    if (!node) return;\n    const apple = isApplePlatform();\n    const parsed = key.split(\"\\u0000\").map((c) => parseHotkey(c, apple));\n    const listener = (raw: Event) => {\n      const e = raw as KeyboardEvent;\n      if (e.repeat) return;\n      const hit = parsed.find((p) => matchesHotkey(e, p));\n      if (!hit) return;\n      if (allowInInputs !== true && isTypingTarget(e.target)) {\n        const chorded = hit.ctrl || hit.meta || hit.alt;\n        if (allowInInputs === \"never\" || !chorded) return;\n      }\n      if (preventDefault) e.preventDefault();\n      handlerRef.current(e);\n    };\n    node.addEventListener(event, listener);\n    return () => node.removeEventListener(event, listener);\n  }, [key, enabled, preventDefault, allowInInputs, event, targetEl, targetRef]);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/hooks/use-hotkey.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\n\n/**\n * A key combination: modifiers and one key, joined by \"+\", case-insensitive —\n * `\"Ctrl+Shift+F\"`, `\"Mod+K\"`, `\"Alt+ArrowUp\"`, `\"Escape\"`, `\"?\"`.\n *\n * Modifiers: `Ctrl` (`Control`), `Meta` (`Cmd`, `Command`), `Shift`, `Alt` (`Option`),\n * and `Mod` — Cmd on Apple platforms, Ctrl everywhere else, the one to use for an\n * app shortcut. The key is `KeyboardEvent.key` (\"f\", \"Enter\", \"ArrowUp\", \"/\"), or a\n * `KeyboardEvent.code` (\"KeyF\", \"Digit1\") when the physical key is what matters.\n * Several combos: pass an array.\n */\nexport type Hotkey = string;\n\nexport interface UseHotkeyOptions {\n  /** Off while `false` (default `true`). */\n  enabled?: boolean;\n  /** Call `preventDefault()` on a match (default `true`): Ctrl+Shift+F must not also\n   *  open the browser's own dialog. */\n  preventDefault?: boolean;\n  /** Where to listen. Default `document`. A ref, an element, or `window`. */\n  target?: EventTarget | null | { current: EventTarget | null };\n  /**\n   * Fire while the focus is in a text field, select or contenteditable too. Default\n   * `false`: a shortcut must not steal the letters someone is typing. A combo with Ctrl,\n   * Meta or Alt is not typing — those still fire unless this is `\"never\"`.\n   */\n  allowInInputs?: boolean | \"never\";\n  /** `keydown` (default) or `keyup`. */\n  event?: \"keydown\" | \"keyup\";\n}\n\nexport interface ParsedHotkey {\n  ctrl: boolean;\n  meta: boolean;\n  shift: boolean;\n  alt: boolean;\n  key: string;\n}\n\n/** Whether this is an Apple platform, where `Mod` means Cmd. */\nexport function isApplePlatform(): boolean {\n  if (typeof navigator === \"undefined\") return false;\n  const nav = navigator as Navigator & { userAgentData?: { platform?: string } };\n  return /mac|iphone|ipad|ipod/i.test(nav.userAgentData?.platform || nav.platform || nav.userAgent);\n}\n\n/** Parse one combo. `apple` decides what `Mod` is. Throws on an empty key. */\nexport function parseHotkey(combo: Hotkey, apple = isApplePlatform()): ParsedHotkey {\n  const parts = combo\n    .split(\"+\")\n    .map((p) => p.trim())\n    // \"Ctrl++\" is Ctrl and \"+\": an empty part after a \"+\" is the plus key itself.\n    .map((p, i, all) => (p === \"\" && i === all.length - 1 ? \"+\" : p))\n    .filter((p) => p !== \"\");\n  const out: ParsedHotkey = { ctrl: false, meta: false, shift: false, alt: false, key: \"\" };\n  for (const part of parts) {\n    switch (part.toLowerCase()) {\n      case \"ctrl\":\n      case \"control\":\n        out.ctrl = true;\n        break;\n      case \"meta\":\n      case \"cmd\":\n      case \"command\":\n        out.meta = true;\n        break;\n      case \"mod\":\n        if (apple) out.meta = true;\n        else out.ctrl = true;\n        break;\n      case \"shift\":\n        out.shift = true;\n        break;\n      case \"alt\":\n      case \"option\":\n        out.alt = true;\n        break;\n      default:\n        out.key = part;\n    }\n  }\n  if (!out.key) throw new Error(`useHotkey: \"${combo}\" names no key`);\n  return out;\n}\n\nconst KEY_ALIASES: Record<string, string> = {\n  esc: \"escape\",\n  space: \" \",\n  del: \"delete\",\n  up: \"arrowup\",\n  down: \"arrowdown\",\n  left: \"arrowleft\",\n  right: \"arrowright\",\n};\n\n/** One letter of a script other than Latin: what a Russian, Greek or Hebrew layout's letter keys type. */\nconst NON_LATIN_LETTER = /^(?!\\p{Script=Latin})\\p{L}$/u;\n\n/** Whether `e` is `combo` — every modifier as named (no more, no fewer), and the key. */\nexport function matchesHotkey(e: KeyboardEvent, combo: ParsedHotkey): boolean {\n  if (e.ctrlKey !== combo.ctrl || e.metaKey !== combo.meta || e.altKey !== combo.alt) return false;\n  const want = KEY_ALIASES[combo.key.toLowerCase()] ?? combo.key.toLowerCase();\n  const key = (e.key ?? \"\").toLowerCase();\n  const code = (e.code ?? \"\").toLowerCase();\n  // On a non-Latin layout `key` is the local letter — Ctrl+K types \"л\" on a Russian one —\n  // so a letter chord never fired there, ⌘K included (0.52 code review, use-hotkey.ts; the\n  // hand-written ⌘K listener before 0.52 compared `key` alone and missed it too). The\n  // physical key stands in for the letter there, and only there: a Latin layout's letter\n  // is wherever it types (Dvorak's K is on QWERTY's V).\n  const physical = /^[a-z]$/.test(want) && NON_LATIN_LETTER.test(e.key ?? \"\") && code === `key${want}`;\n  if (key !== want && code !== want && !physical) return false;\n  // Shift must match exactly for a letter or a named key; for a symbol it is how the\n  // symbol is typed (\"?\" is Shift+/ on a US layout, a plain key on others), so an\n  // unnamed Shift is not held against it. Space is a named key, not a symbol, though its\n  // alias is one character: \"Space\" fired on Shift+Space, the browser's page-up, and\n  // cancelled it (0.52 code review, use-hotkey.ts).\n  const symbol = want.length === 1 && !/[a-z0-9 ]/.test(want);\n  return symbol && !combo.shift ? true : e.shiftKey === combo.shift;\n}\n\n/** Is the focus somewhere that takes typed characters? */\nfunction isTypingTarget(target: EventTarget | null): boolean {\n  if (!(target instanceof HTMLElement)) return false;\n  if (target.isContentEditable) return true;\n  if (target instanceof HTMLTextAreaElement || target instanceof HTMLSelectElement) return true;\n  if (target instanceof HTMLInputElement) {\n    return ![\"button\", \"checkbox\", \"radio\", \"submit\", \"reset\", \"range\", \"color\", \"file\", \"image\"].includes(target.type);\n  }\n  return false;\n}\n\n/**\n * Call `handler` when `combo` is pressed — kastlan's feedback button (Ctrl+Shift+F,\n * feedback-button:60) wired it by hand, and so will every next shortcut.\n *\n * - `Mod` is Cmd on a Mac and Ctrl elsewhere, read once per mount.\n * - Modifiers match EXACTLY: `\"Ctrl+K\"` does not fire on Ctrl+Shift+K.\n * - Typing in a field is left alone unless `allowInInputs`, except for a combo with\n *   Ctrl / Meta / Alt, which no one types as text.\n * - A key held down fires once, not on every repeat — and its repeats are cancelled as\n *   the first press was, or the browser acts on them.\n * - The newest `handler` is always called; changing it does not re-attach the listener.\n *\n * `useCommandKey` (the ⌘K palette hook) is this with `\"Mod+K\"` and `allowInInputs`\n * since 0.52, and FormActions' Ctrl/Cmd+Enter is {@link matchesHotkey} (refactor audit\n * 2026-10-30, DUP-12): one reading of a chord.\n */\nexport function useHotkey(\n  combo: Hotkey | ReadonlyArray<Hotkey>,\n  handler: (event: KeyboardEvent) => void,\n  options: UseHotkeyOptions = {},\n): void {\n  const { enabled = true, preventDefault = true, target, allowInInputs = false, event = \"keydown\" } = options;\n  const handlerRef = useRef(handler);\n  useEffect(() => {\n    handlerRef.current = handler;\n  });\n  const key = typeof combo === \"string\" ? combo : combo.join(\"\\u0000\");\n  const targetEl = target && \"current\" in target ? undefined : target;\n  const targetRef = target && \"current\" in target ? target : undefined;\n\n  useEffect(() => {\n    if (!enabled) return;\n    const node: EventTarget | null =\n      targetRef?.current ?? targetEl ?? (typeof document === \"undefined\" ? null : document);\n    if (!node) return;\n    const apple = isApplePlatform();\n    const parsed = key.split(\"\\u0000\").map((c) => parseHotkey(c, apple));\n    const listener = (raw: Event) => {\n      const e = raw as KeyboardEvent;\n      const hit = parsed.find((p) => matchesHotkey(e, p));\n      if (!hit) return;\n      if (allowInInputs !== true && isTypingTarget(e.target)) {\n        const chorded = hit.ctrl || hit.meta || hit.alt;\n        if (allowInInputs === \"never\" || !chorded) return;\n      }\n      if (preventDefault) e.preventDefault();\n      // A held key's repeats are cancelled like its first press, and call nothing. They\n      // returned before the `preventDefault` once, so a held Ctrl+K's repeats reached the\n      // browser's own Ctrl+K and took the focus out of the palette ⌘K had just opened\n      // (0.52 code review, use-hotkey.ts; the hand-written ⌘K listener cancelled them).\n      if (e.repeat) return;\n      handlerRef.current(e);\n    };\n    node.addEventListener(event, listener);\n    return () => node.removeEventListener(event, listener);\n  }, [key, enabled, preventDefault, allowInInputs, event, targetEl, targetRef]);\n}\n"],"mappings":"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","names":[]}

package/dist/hooks/use-long-press.d.ts

@@ -1,4 +1,10 @@
 import { type PointerEvent as ReactPointerEvent } from "react";
+export interface LongPressOptions {
+    /** Default `true`. Off, a press does nothing and the context menu is the browser's. */
+    enabled?: boolean;
+    /** How long a press is held, in ms. Default 500. */
+    delay?: number;
+}
 export interface LongPressResult {
     handlers: {
         onPointerDown: (e: ReactPointerEvent) => void;
@@ -24,7 +30,4 @@ export interface LongPressResult {
  *    with `select-none [-webkit-touch-callout:none]` on the element: iOS's callout
  *    only yields to that CSS.
  */
-export declare function useLongPress(onLongPress: () => void, { enabled, delay }?: {
-    enabled?: boolean;
-    delay?: number;
-}): LongPressResult;
+export declare function useLongPress(onLongPress: () => void, { enabled, delay }?: LongPressOptions): LongPressResult;

package/dist/hooks/use-long-press.js

@@ -68,6 +68,9 @@ function useLongPress(onLongPress, { enabled = true, delay = LONG_PRESS_MS } = {
     fired.current = false;
     return true;
   }, []);
+  useEffect(() => {
+    if (!enabled) cancel();
+  }, [enabled, cancel]);
   useEffect(() => cancel, [cancel]);
   return { handlers: { onPointerDown, onPointerMove, onContextMenu }, consumeClick };
 }

package/dist/hooks/use-long-press.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hooks/use-long-press.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, type PointerEvent as ReactPointerEvent } from \"react\";\n\n// The press-and-hold that puts DataTable's phone cards into selection mode (0.40,\n// keksdose live #421). Taken over from keksdose's register list\n// (frontend/src/shared/hooks/use-long-press.ts, its feedback #153) so the kit's cards\n// and kk's register answer the same gesture the same way: 500 ms, an 8 px dead zone,\n// cancelled by a scroll, the trailing click swallowed.\n\nconst LONG_PRESS_MS = 500;\n/** The same 8 px dead zone `useRowSwipe` locks its axis at: the press is dead by the\n *  time the swipe hook takes pointer capture on its (ancestor) layer. */\nconst SLOP_PX = 8;\n\nconst movedBeyondSlop = (from: { x: number; y: number }, x: number, y: number) =>\n  Math.hypot(x - from.x, y - from.y) > SLOP_PX;\n\nexport interface LongPressResult {\n  handlers: {\n    onPointerDown: (e: ReactPointerEvent) => void;\n    onPointerMove: (e: ReactPointerEvent) => void;\n    onContextMenu: (e: { preventDefault: () => void }) => void;\n  };\n  /** True exactly once after a long press fired: call it from an `onClickCapture` to\n   *  swallow the click the browser still sends when the finger lifts. */\n  consumeClick: () => boolean;\n}\n\n/**\n * A press-and-hold on a touch row that may ALSO be swipeable.\n *\n *  - The cancel listeners live on `window`: `useRowSwipe` captures the pointer on an\n *    ancestor once a drag resolves to the x axis, after which the pressed element's\n *    own pointer handlers stop firing, and a timer cancelled only there would fire\n *    mid-swipe.\n *  - A scroll cancels too (`touch-action: pan-y` hands vertical panning to the\n *    browser, which sends `pointercancel`; the capture-phase `scroll` is the backstop).\n *  - `contextmenu` is suppressed while enabled — Android fires it at ~500 ms. Pair it\n *    with `select-none [-webkit-touch-callout:none]` on the element: iOS's callout\n *    only yields to that CSS.\n */\nexport function useLongPress(\n  onLongPress: () => void,\n  { enabled = true, delay = LONG_PRESS_MS }: { enabled?: boolean; delay?: number } = {},\n): LongPressResult {\n  const timer = useRef<number | null>(null);\n  const start = useRef({ x: 0, y: 0 });\n  const fired = useRef(false);\n  const teardown = useRef<(() => void) | null>(null);\n  const cbRef = useRef(onLongPress);\n  useEffect(() => {\n    cbRef.current = onLongPress;\n  });\n\n  const cancel = useCallback(() => {\n    if (timer.current !== null) {\n      window.clearTimeout(timer.current);\n      timer.current = null;\n    }\n    teardown.current?.();\n    teardown.current = null;\n  }, []);\n\n  const onPointerDown = useCallback(\n    (e: ReactPointerEvent) => {\n      // Cleared above every early return: a press whose trailing click never arrives\n      // (the finger lifted over another row) would otherwise leave the latch armed,\n      // and it would eat the next real tap once the card has switched modes.\n      fired.current = false;\n      if (!enabled) return;\n      if (e.pointerType === \"mouse\" && e.button !== 0) return;\n      cancel();\n      start.current = { x: e.clientX, y: e.clientY };\n\n      const onEnd = () => cancel();\n      const onMove = (ev: PointerEvent) => {\n        if (movedBeyondSlop(start.current, ev.clientX, ev.clientY)) cancel();\n      };\n      window.addEventListener(\"pointerup\", onEnd);\n      window.addEventListener(\"pointercancel\", onEnd);\n      window.addEventListener(\"pointermove\", onMove);\n      window.addEventListener(\"scroll\", onEnd, { capture: true, passive: true });\n      teardown.current = () => {\n        window.removeEventListener(\"pointerup\", onEnd);\n        window.removeEventListener(\"pointercancel\", onEnd);\n        window.removeEventListener(\"pointermove\", onMove);\n        window.removeEventListener(\"scroll\", onEnd, { capture: true });\n      };\n\n      timer.current = window.setTimeout(() => {\n        cancel();\n        fired.current = true;\n        // The swipe stages' haptic vocabulary; absent on iOS Safari.\n        navigator.vibrate?.(20);\n        cbRef.current();\n      }, delay);\n    },\n    [cancel, delay, enabled],\n  );\n\n  // Also on the element: it still cancels if an ancestor stops the native event\n  // before it reaches `window`.\n  const onPointerMove = useCallback(\n    (e: ReactPointerEvent) => {\n      if (timer.current === null) return;\n      if (movedBeyondSlop(start.current, e.clientX, e.clientY)) cancel();\n    },\n    [cancel],\n  );\n\n  const onContextMenu = useCallback(\n    (e: { preventDefault: () => void }) => {\n      if (enabled) e.preventDefault();\n    },\n    [enabled],\n  );\n\n  const consumeClick = useCallback(() => {\n    if (!fired.current) return false;\n    fired.current = false;\n    return true;\n  }, []);\n\n  useEffect(() => cancel, [cancel]);\n\n  return { handlers: { onPointerDown, onPointerMove, onContextMenu }, consumeClick };\n}\n"],"mappings":";AAAA,SAAS,aAAa,WAAW,cAAsD;AAQvF,MAAM,gBAAgB;AAGtB,MAAM,UAAU;AAEhB,MAAM,kBAAkB,CAAC,MAAgC,GAAW,MAClE,KAAK,MAAM,IAAI,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI;AA0BhC,SAAS,aACd,aACA,EAAE,UAAU,MAAM,QAAQ,cAAc,IAA2C,CAAC,GACnE;AACjB,QAAM,QAAQ,OAAsB,IAAI;AACxC,QAAM,QAAQ,OAAO,EAAE,GAAG,GAAG,GAAG,EAAE,CAAC;AACnC,QAAM,QAAQ,OAAO,KAAK;AAC1B,QAAM,WAAW,OAA4B,IAAI;AACjD,QAAM,QAAQ,OAAO,WAAW;AAChC,YAAU,MAAM;AACd,UAAM,UAAU;AAAA,EAClB,CAAC;AAED,QAAM,SAAS,YAAY,MAAM;AAC/B,QAAI,MAAM,YAAY,MAAM;AAC1B,aAAO,aAAa,MAAM,OAAO;AACjC,YAAM,UAAU;AAAA,IAClB;AACA,aAAS,UAAU;AACnB,aAAS,UAAU;AAAA,EACrB,GAAG,CAAC,CAAC;AAEL,QAAM,gBAAgB;AAAA,IACpB,CAAC,MAAyB;AAIxB,YAAM,UAAU;AAChB,UAAI,CAAC,QAAS;AACd,UAAI,EAAE,gBAAgB,WAAW,EAAE,WAAW,EAAG;AACjD,aAAO;AACP,YAAM,UAAU,EAAE,GAAG,EAAE,SAAS,GAAG,EAAE,QAAQ;AAE7C,YAAM,QAAQ,MAAM,OAAO;AAC3B,YAAM,SAAS,CAAC,OAAqB;AACnC,YAAI,gBAAgB,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,EAAG,QAAO;AAAA,MACrE;AACA,aAAO,iBAAiB,aAAa,KAAK;AAC1C,aAAO,iBAAiB,iBAAiB,KAAK;AAC9C,aAAO,iBAAiB,eAAe,MAAM;AAC7C,aAAO,iBAAiB,UAAU,OAAO,EAAE,SAAS,MAAM,SAAS,KAAK,CAAC;AACzE,eAAS,UAAU,MAAM;AACvB,eAAO,oBAAoB,aAAa,KAAK;AAC7C,eAAO,oBAAoB,iBAAiB,KAAK;AACjD,eAAO,oBAAoB,eAAe,MAAM;AAChD,eAAO,oBAAoB,UAAU,OAAO,EAAE,SAAS,KAAK,CAAC;AAAA,MAC/D;AAEA,YAAM,UAAU,OAAO,WAAW,MAAM;AACtC,eAAO;AACP,cAAM,UAAU;AAEhB,kBAAU,UAAU,EAAE;AACtB,cAAM,QAAQ;AAAA,MAChB,GAAG,KAAK;AAAA,IACV;AAAA,IACA,CAAC,QAAQ,OAAO,OAAO;AAAA,EACzB;AAIA,QAAM,gBAAgB;AAAA,IACpB,CAAC,MAAyB;AACxB,UAAI,MAAM,YAAY,KAAM;AAC5B,UAAI,gBAAgB,MAAM,SAAS,EAAE,SAAS,EAAE,OAAO,EAAG,QAAO;AAAA,IACnE;AAAA,IACA,CAAC,MAAM;AAAA,EACT;AAEA,QAAM,gBAAgB;AAAA,IACpB,CAAC,MAAsC;AACrC,UAAI,QAAS,GAAE,eAAe;AAAA,IAChC;AAAA,IACA,CAAC,OAAO;AAAA,EACV;AAEA,QAAM,eAAe,YAAY,MAAM;AACrC,QAAI,CAAC,MAAM,QAAS,QAAO;AAC3B,UAAM,UAAU;AAChB,WAAO;AAAA,EACT,GAAG,CAAC,CAAC;AAEL,YAAU,MAAM,QAAQ,CAAC,MAAM,CAAC;AAEhC,SAAO,EAAE,UAAU,EAAE,eAAe,eAAe,cAAc,GAAG,aAAa;AACnF;","names":[]}
+{"version":3,"sources":["../../src/hooks/use-long-press.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, type PointerEvent as ReactPointerEvent } from \"react\";\n\n// The press-and-hold that puts DataTable's phone cards into selection mode (0.40,\n// keksdose live #421). Taken over from keksdose's register list\n// (frontend/src/shared/hooks/use-long-press.ts, its feedback #153) so the kit's cards\n// and kk's register answer the same gesture the same way: 500 ms, an 8 px dead zone,\n// cancelled by a scroll, the trailing click swallowed. Public since 0.52 (DUP-8, refactor\n// audit 2026-10-30): private, it left keksdose keeping the original beside the copy.\n\nconst LONG_PRESS_MS = 500;\n/** The same 8 px dead zone `useRowSwipe` locks its axis at: the press is dead by the\n *  time the swipe hook takes pointer capture on its (ancestor) layer. */\nconst SLOP_PX = 8;\n\nconst movedBeyondSlop = (from: { x: number; y: number }, x: number, y: number) =>\n  Math.hypot(x - from.x, y - from.y) > SLOP_PX;\n\nexport interface LongPressOptions {\n  /** Default `true`. Off, a press does nothing and the context menu is the browser's. */\n  enabled?: boolean;\n  /** How long a press is held, in ms. Default 500. */\n  delay?: number;\n}\n\nexport interface LongPressResult {\n  handlers: {\n    onPointerDown: (e: ReactPointerEvent) => void;\n    onPointerMove: (e: ReactPointerEvent) => void;\n    onContextMenu: (e: { preventDefault: () => void }) => void;\n  };\n  /** True exactly once after a long press fired: call it from an `onClickCapture` to\n   *  swallow the click the browser still sends when the finger lifts. */\n  consumeClick: () => boolean;\n}\n\n/**\n * A press-and-hold on a touch row that may ALSO be swipeable.\n *\n *  - The cancel listeners live on `window`: `useRowSwipe` captures the pointer on an\n *    ancestor once a drag resolves to the x axis, after which the pressed element's\n *    own pointer handlers stop firing, and a timer cancelled only there would fire\n *    mid-swipe.\n *  - A scroll cancels too (`touch-action: pan-y` hands vertical panning to the\n *    browser, which sends `pointercancel`; the capture-phase `scroll` is the backstop).\n *  - `contextmenu` is suppressed while enabled — Android fires it at ~500 ms. Pair it\n *    with `select-none [-webkit-touch-callout:none]` on the element: iOS's callout\n *    only yields to that CSS.\n */\nexport function useLongPress(\n  onLongPress: () => void,\n  { enabled = true, delay = LONG_PRESS_MS }: LongPressOptions = {},\n): LongPressResult {\n  const timer = useRef<number | null>(null);\n  const start = useRef({ x: 0, y: 0 });\n  const fired = useRef(false);\n  const teardown = useRef<(() => void) | null>(null);\n  const cbRef = useRef(onLongPress);\n  useEffect(() => {\n    cbRef.current = onLongPress;\n  });\n\n  const cancel = useCallback(() => {\n    if (timer.current !== null) {\n      window.clearTimeout(timer.current);\n      timer.current = null;\n    }\n    teardown.current?.();\n    teardown.current = null;\n  }, []);\n\n  const onPointerDown = useCallback(\n    (e: ReactPointerEvent) => {\n      // Cleared above every early return: a press whose trailing click never arrives\n      // (the finger lifted over another row) would otherwise leave the latch armed,\n      // and it would eat the next real tap once the card has switched modes.\n      fired.current = false;\n      if (!enabled) return;\n      if (e.pointerType === \"mouse\" && e.button !== 0) return;\n      cancel();\n      start.current = { x: e.clientX, y: e.clientY };\n\n      const onEnd = () => cancel();\n      const onMove = (ev: PointerEvent) => {\n        if (movedBeyondSlop(start.current, ev.clientX, ev.clientY)) cancel();\n      };\n      window.addEventListener(\"pointerup\", onEnd);\n      window.addEventListener(\"pointercancel\", onEnd);\n      window.addEventListener(\"pointermove\", onMove);\n      window.addEventListener(\"scroll\", onEnd, { capture: true, passive: true });\n      teardown.current = () => {\n        window.removeEventListener(\"pointerup\", onEnd);\n        window.removeEventListener(\"pointercancel\", onEnd);\n        window.removeEventListener(\"pointermove\", onMove);\n        window.removeEventListener(\"scroll\", onEnd, { capture: true });\n      };\n\n      timer.current = window.setTimeout(() => {\n        cancel();\n        fired.current = true;\n        // The swipe stages' haptic vocabulary; absent on iOS Safari.\n        navigator.vibrate?.(20);\n        cbRef.current();\n      }, delay);\n    },\n    [cancel, delay, enabled],\n  );\n\n  // Also on the element: it still cancels if an ancestor stops the native event\n  // before it reaches `window`.\n  const onPointerMove = useCallback(\n    (e: ReactPointerEvent) => {\n      if (timer.current === null) return;\n      if (movedBeyondSlop(start.current, e.clientX, e.clientY)) cancel();\n    },\n    [cancel],\n  );\n\n  const onContextMenu = useCallback(\n    (e: { preventDefault: () => void }) => {\n      if (enabled) e.preventDefault();\n    },\n    [enabled],\n  );\n\n  const consumeClick = useCallback(() => {\n    if (!fired.current) return false;\n    fired.current = false;\n    return true;\n  }, []);\n\n  // Turned off mid-press: the armed timer still fired, entering selection mode against the\n  // caller's wish and arming `consumeClick` for the next click (0.52 code review).\n  useEffect(() => {\n    if (!enabled) cancel();\n  }, [enabled, cancel]);\n\n  useEffect(() => cancel, [cancel]);\n\n  return { handlers: { onPointerDown, onPointerMove, onContextMenu }, consumeClick };\n}\n"],"mappings":";AAAA,SAAS,aAAa,WAAW,cAAsD;AASvF,MAAM,gBAAgB;AAGtB,MAAM,UAAU;AAEhB,MAAM,kBAAkB,CAAC,MAAgC,GAAW,MAClE,KAAK,MAAM,IAAI,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI;AAiChC,SAAS,aACd,aACA,EAAE,UAAU,MAAM,QAAQ,cAAc,IAAsB,CAAC,GAC9C;AACjB,QAAM,QAAQ,OAAsB,IAAI;AACxC,QAAM,QAAQ,OAAO,EAAE,GAAG,GAAG,GAAG,EAAE,CAAC;AACnC,QAAM,QAAQ,OAAO,KAAK;AAC1B,QAAM,WAAW,OAA4B,IAAI;AACjD,QAAM,QAAQ,OAAO,WAAW;AAChC,YAAU,MAAM;AACd,UAAM,UAAU;AAAA,EAClB,CAAC;AAED,QAAM,SAAS,YAAY,MAAM;AAC/B,QAAI,MAAM,YAAY,MAAM;AAC1B,aAAO,aAAa,MAAM,OAAO;AACjC,YAAM,UAAU;AAAA,IAClB;AACA,aAAS,UAAU;AACnB,aAAS,UAAU;AAAA,EACrB,GAAG,CAAC,CAAC;AAEL,QAAM,gBAAgB;AAAA,IACpB,CAAC,MAAyB;AAIxB,YAAM,UAAU;AAChB,UAAI,CAAC,QAAS;AACd,UAAI,EAAE,gBAAgB,WAAW,EAAE,WAAW,EAAG;AACjD,aAAO;AACP,YAAM,UAAU,EAAE,GAAG,EAAE,SAAS,GAAG,EAAE,QAAQ;AAE7C,YAAM,QAAQ,MAAM,OAAO;AAC3B,YAAM,SAAS,CAAC,OAAqB;AACnC,YAAI,gBAAgB,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,EAAG,QAAO;AAAA,MACrE;AACA,aAAO,iBAAiB,aAAa,KAAK;AAC1C,aAAO,iBAAiB,iBAAiB,KAAK;AAC9C,aAAO,iBAAiB,eAAe,MAAM;AAC7C,aAAO,iBAAiB,UAAU,OAAO,EAAE,SAAS,MAAM,SAAS,KAAK,CAAC;AACzE,eAAS,UAAU,MAAM;AACvB,eAAO,oBAAoB,aAAa,KAAK;AAC7C,eAAO,oBAAoB,iBAAiB,KAAK;AACjD,eAAO,oBAAoB,eAAe,MAAM;AAChD,eAAO,oBAAoB,UAAU,OAAO,EAAE,SAAS,KAAK,CAAC;AAAA,MAC/D;AAEA,YAAM,UAAU,OAAO,WAAW,MAAM;AACtC,eAAO;AACP,cAAM,UAAU;AAEhB,kBAAU,UAAU,EAAE;AACtB,cAAM,QAAQ;AAAA,MAChB,GAAG,KAAK;AAAA,IACV;AAAA,IACA,CAAC,QAAQ,OAAO,OAAO;AAAA,EACzB;AAIA,QAAM,gBAAgB;AAAA,IACpB,CAAC,MAAyB;AACxB,UAAI,MAAM,YAAY,KAAM;AAC5B,UAAI,gBAAgB,MAAM,SAAS,EAAE,SAAS,EAAE,OAAO,EAAG,QAAO;AAAA,IACnE;AAAA,IACA,CAAC,MAAM;AAAA,EACT;AAEA,QAAM,gBAAgB;AAAA,IACpB,CAAC,MAAsC;AACrC,UAAI,QAAS,GAAE,eAAe;AAAA,IAChC;AAAA,IACA,CAAC,OAAO;AAAA,EACV;AAEA,QAAM,eAAe,YAAY,MAAM;AACrC,QAAI,CAAC,MAAM,QAAS,QAAO;AAC3B,UAAM,UAAU;AAChB,WAAO;AAAA,EACT,GAAG,CAAC,CAAC;AAIL,YAAU,MAAM;AACd,QAAI,CAAC,QAAS,QAAO;AAAA,EACvB,GAAG,CAAC,SAAS,MAAM,CAAC;AAEpB,YAAU,MAAM,QAAQ,CAAC,MAAM,CAAC;AAEhC,SAAO,EAAE,UAAU,EAAE,eAAe,eAAe,cAAc,GAAG,aAAa;AACnF;","names":[]}

package/dist/hooks/use-media-query.js

@@ -1,13 +1,21 @@
 "use client";
-import { useEffect, useState } from "react";
+import { useEffect, useEffectEvent, useState } from "react";
 function useMediaQuery(query, fallback) {
   const get = () => typeof window !== "undefined" && typeof window.matchMedia === "function" ? window.matchMedia(query).matches : fallback;
-  const [matches, setMatches] = useState(get);
+  const [state, setState] = useState(() => ({ query, matches: get() }));
+  let matches = state.matches;
+  if (state.query !== query) {
+    matches = get();
+    setState({ query, matches });
+  }
+  const answered = useEffectEvent(() => matches);
   useEffect(() => {
     if (typeof window === "undefined" || typeof window.matchMedia !== "function") return;
     const mql = window.matchMedia(query);
-    const update = () => setMatches(mql.matches);
-    update();
+    const update = () => setState(
+      (prev) => prev.query === query && prev.matches === mql.matches ? prev : { query, matches: mql.matches }
+    );
+    if (mql.matches !== answered()) update();
     mql.addEventListener("change", update);
     return () => mql.removeEventListener("change", update);
   }, [query]);

package/dist/hooks/use-media-query.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hooks/use-media-query.ts"],"sourcesContent":["import { useEffect, useState } from \"react\";\n\n/**\n * Subscribe to a CSS media query, returning whether it currently matches and\n * re-rendering when it changes. `fallback` is the value used during SSR / when\n * `window.matchMedia` is unavailable.\n */\nexport function useMediaQuery(query: string, fallback: boolean): boolean {\n  const get = () =>\n    typeof window !== \"undefined\" && typeof window.matchMedia === \"function\"\n      ? window.matchMedia(query).matches\n      : fallback;\n  const [matches, setMatches] = useState<boolean>(get);\n  useEffect(() => {\n    if (typeof window === \"undefined\" || typeof window.matchMedia !== \"function\") return;\n    const mql = window.matchMedia(query);\n    const update = () => setMatches(mql.matches);\n    update();\n    mql.addEventListener(\"change\", update);\n    return () => mql.removeEventListener(\"change\", update);\n  }, [query]);\n  return matches;\n}\n"],"mappings":";AAAA,SAAS,WAAW,gBAAgB;AAO7B,SAAS,cAAc,OAAe,UAA4B;AACvE,QAAM,MAAM,MACV,OAAO,WAAW,eAAe,OAAO,OAAO,eAAe,aAC1D,OAAO,WAAW,KAAK,EAAE,UACzB;AACN,QAAM,CAAC,SAAS,UAAU,IAAI,SAAkB,GAAG;AACnD,YAAU,MAAM;AACd,QAAI,OAAO,WAAW,eAAe,OAAO,OAAO,eAAe,WAAY;AAC9E,UAAM,MAAM,OAAO,WAAW,KAAK;AACnC,UAAM,SAAS,MAAM,WAAW,IAAI,OAAO;AAC3C,WAAO;AACP,QAAI,iBAAiB,UAAU,MAAM;AACrC,WAAO,MAAM,IAAI,oBAAoB,UAAU,MAAM;AAAA,EACvD,GAAG,CAAC,KAAK,CAAC;AACV,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/hooks/use-media-query.ts"],"sourcesContent":["import { useEffect, useEffectEvent, useState } from \"react\";\n\n/**\n * Subscribe to a CSS media query, returning whether it currently matches and\n * re-rendering when it changes. `fallback` is the value used during SSR / when\n * `window.matchMedia` is unavailable.\n */\nexport function useMediaQuery(query: string, fallback: boolean): boolean {\n  const get = () =>\n    typeof window !== \"undefined\" && typeof window.matchMedia === \"function\"\n      ? window.matchMedia(query).matches\n      : fallback;\n  // The answer is kept with the query it answers, and a new query is asked during the\n  // render that brings it. Read at mount only, the first commit after a new query still\n  // answered the OLD one, until the effect corrected it: `useBreakpoint` asks a new query\n  // when the text size changes, and at Large in a 700 px window the tour card was drawn\n  // un-docked for a frame before it docked (0.52 code review, use-breakpoint.ts).\n  const [state, setState] = useState(() => ({ query, matches: get() }));\n  let matches = state.matches;\n  if (state.query !== query) {\n    matches = get();\n    setState({ query, matches });\n  }\n  const answered = useEffectEvent(() => matches);\n  useEffect(() => {\n    if (typeof window === \"undefined\" || typeof window.matchMedia !== \"function\") return;\n    const mql = window.matchMedia(query);\n    const update = () =>\n      setState((prev) =>\n        prev.query === query && prev.matches === mql.matches ? prev : { query, matches: mql.matches },\n      );\n    // A change between the render and this subscription. Only then: an update that\n    // changes nothing still costs a render (and a commit) right after a new query.\n    if (mql.matches !== answered()) update();\n    mql.addEventListener(\"change\", update);\n    return () => mql.removeEventListener(\"change\", update);\n  }, [query]);\n  return matches;\n}\n"],"mappings":";AAAA,SAAS,WAAW,gBAAgB,gBAAgB;AAO7C,SAAS,cAAc,OAAe,UAA4B;AACvE,QAAM,MAAM,MACV,OAAO,WAAW,eAAe,OAAO,OAAO,eAAe,aAC1D,OAAO,WAAW,KAAK,EAAE,UACzB;AAMN,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAS,OAAO,EAAE,OAAO,SAAS,IAAI,EAAE,EAAE;AACpE,MAAI,UAAU,MAAM;AACpB,MAAI,MAAM,UAAU,OAAO;AACzB,cAAU,IAAI;AACd,aAAS,EAAE,OAAO,QAAQ,CAAC;AAAA,EAC7B;AACA,QAAM,WAAW,eAAe,MAAM,OAAO;AAC7C,YAAU,MAAM;AACd,QAAI,OAAO,WAAW,eAAe,OAAO,OAAO,eAAe,WAAY;AAC9E,UAAM,MAAM,OAAO,WAAW,KAAK;AACnC,UAAM,SAAS,MACb;AAAA,MAAS,CAAC,SACR,KAAK,UAAU,SAAS,KAAK,YAAY,IAAI,UAAU,OAAO,EAAE,OAAO,SAAS,IAAI,QAAQ;AAAA,IAC9F;AAGF,QAAI,IAAI,YAAY,SAAS,EAAG,QAAO;AACvC,QAAI,iBAAiB,UAAU,MAAM;AACrC,WAAO,MAAM,IAAI,oBAAoB,UAAU,MAAM;AAAA,EACvD,GAAG,CAAC,KAAK,CAAC;AACV,SAAO;AACT;","names":[]}

package/dist/hooks/use-mounted.d.ts

@@ -0,0 +1,22 @@
+/**
+ * A mounted guard and a callback-to-promise bridge, for a card that awaits an app's
+ * callback and must not set state after the page moved on.
+ *
+ * Written for the account settings parts (0.34) and then imported by seven notifications
+ * modules out of `account/account-parts.ts`: a generic helper living in a feature folder
+ * that the folder beside it reached into sideways (refactor audit 2026-10-30, MOD-6).
+ * `account-parts.ts` re-exports both, so nothing that imported them there moved, and
+ * `admin/admin-parts.ts` re-exports `settle` in place of its own copy (0.52 code review).
+ *
+ * @internal Not part of the barrel.
+ */
+/** Whether the component is still mounted — a late answer after the app navigated away
+ *  (the deletion signs out) must not set state. */
+export declare function useMounted(): {
+    readonly current: boolean;
+};
+/** Call `call` and hand back a promise, a throw included — a callback may return
+ *  nothing (done at once), a promise, or throw before it returns one. Typed by what it
+ *  answers, so the admin parts' copy, which kept the type, could go (0.52 code review,
+ *  admin/admin-parts.ts). */
+export declare function settle<R>(call: () => R): Promise<Awaited<R>>;

package/dist/hooks/use-mounted.js

@@ -0,0 +1,24 @@
+"use client";
+import { useEffect, useRef } from "react";
+function useMounted() {
+  const mounted = useRef(true);
+  useEffect(() => {
+    mounted.current = true;
+    return () => {
+      mounted.current = false;
+    };
+  }, []);
+  return mounted;
+}
+function settle(call) {
+  try {
+    return Promise.resolve(call());
+  } catch (error) {
+    return Promise.reject(error);
+  }
+}
+export {
+  settle,
+  useMounted
+};
+//# sourceMappingURL=use-mounted.js.map

package/dist/hooks/use-mounted.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/use-mounted.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\n\n/**\n * A mounted guard and a callback-to-promise bridge, for a card that awaits an app's\n * callback and must not set state after the page moved on.\n *\n * Written for the account settings parts (0.34) and then imported by seven notifications\n * modules out of `account/account-parts.ts`: a generic helper living in a feature folder\n * that the folder beside it reached into sideways (refactor audit 2026-10-30, MOD-6).\n * `account-parts.ts` re-exports both, so nothing that imported them there moved, and\n * `admin/admin-parts.ts` re-exports `settle` in place of its own copy (0.52 code review).\n *\n * @internal Not part of the barrel.\n */\n\n/** Whether the component is still mounted — a late answer after the app navigated away\n *  (the deletion signs out) must not set state. */\nexport function useMounted(): { readonly current: boolean } {\n  const mounted = useRef(true);\n  useEffect(() => {\n    mounted.current = true;\n    return () => {\n      mounted.current = false;\n    };\n  }, []);\n  return mounted;\n}\n\n/** Call `call` and hand back a promise, a throw included — a callback may return\n *  nothing (done at once), a promise, or throw before it returns one. Typed by what it\n *  answers, so the admin parts' copy, which kept the type, could go (0.52 code review,\n *  admin/admin-parts.ts). */\nexport function settle<R>(call: () => R): Promise<Awaited<R>> {\n  try {\n    return Promise.resolve(call());\n  } catch (error) {\n    return Promise.reject(error);\n  }\n}\n"],"mappings":";AAAA,SAAS,WAAW,cAAc;AAiB3B,SAAS,aAA4C;AAC1D,QAAM,UAAU,OAAO,IAAI;AAC3B,YAAU,MAAM;AACd,YAAQ,UAAU;AAClB,WAAO,MAAM;AACX,cAAQ,UAAU;AAAA,IACpB;AAAA,EACF,GAAG,CAAC,CAAC;AACL,SAAO;AACT;AAMO,SAAS,OAAU,MAAoC;AAC5D,MAAI;AACF,WAAO,QAAQ,QAAQ,KAAK,CAAC;AAAA,EAC/B,SAAS,OAAO;AACd,WAAO,QAAQ,OAAO,KAAK;AAAA,EAC7B;AACF;","names":[]}

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

@@ -8,6 +8,7 @@ let lastSeen = null;
 const consumed = /* @__PURE__ */ new Set();
 let pendingProgrammatic = 0;
 let listening = false;
+let noting = false;
 let nextId = 0;
 let unwind = null;
 function runUnwind() {
@@ -175,6 +176,7 @@ function closeOnPop() {
     return;
   }
   stack.pop();
+  syncGestureListeners();
   consumed.add(top.id);
   const record = pushed.find((p) => p.id === top.id);
   forgetPushed(top.id);
@@ -192,11 +194,23 @@ function putBack(id) {
 function ensureListening() {
   if (listening || typeof window === "undefined") return;
   window.addEventListener("popstate", handlePop);
-  window.addEventListener("pointerdown", noteAddress, true);
-  window.addEventListener("keydown", noteAddress, true);
-  for (const type of ["click", "keyup", "change", "input"]) window.addEventListener(type, noteSeenNowAndLater);
   listening = true;
 }
+const SEEN_EVENTS = ["click", "keyup", "change", "input"];
+function syncGestureListeners() {
+  const want = stack.length > 0;
+  if (want === noting || typeof window === "undefined") return;
+  noting = want;
+  if (want) {
+    window.addEventListener("pointerdown", noteAddress, true);
+    window.addEventListener("keydown", noteAddress, true);
+    for (const type of SEEN_EVENTS) window.addEventListener(type, noteSeenNowAndLater);
+  } else {
+    window.removeEventListener("pointerdown", noteAddress, true);
+    window.removeEventListener("keydown", noteAddress, true);
+    for (const type of SEEN_EVENTS) window.removeEventListener(type, noteSeenNowAndLater);
+  }
+}
 function useOverlayHistory(open, onClose, { held = false } = {}) {
   const closeRef = useRef(onClose);
   const heldRef = useRef(held);
@@ -210,6 +224,7 @@ function useOverlayHistory(open, onClose, { held = false } = {}) {
     const id = `overlay-${nextId += 1}`;
     const entry = { id, close: () => closeRef.current(), held: () => heldRef.current };
     stack.push(entry);
+    syncGestureListeners();
     const prev = window.history.state;
     const marked = { ...prev && typeof prev === "object" ? prev : {}, [SENTINEL_KEY]: id };
     const adopting = unwind && unwind.id === currentSentinel() && unwind.href === currentHref();
@@ -242,6 +257,7 @@ function useOverlayHistory(open, onClose, { held = false } = {}) {
     return () => {
       const at = stack.indexOf(entry);
       if (at >= 0) stack.splice(at, 1);
+      syncGestureListeners();
       if (consumed.delete(id)) return;
       const mine = pushed.findIndex((p) => p.id === id);
       if (mine >= 0 && currentHref() !== pushed[mine].href) {

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 * ## Not undoing the owner's own close\n *\n * Nor when the address under the entry changed in the same breath as the close\n * (keksdose dev #584). A page that opens its editor by PUSHING `?row=x` and closes it\n * by REPLACING the clean URL over the top entry rewrites OUR entry — the overlay sits\n * above `?row=x` — and that rewrite is what unmounts the overlay. Going back from there\n * lands on `?row=x` and the router opens the editor that was just closed. See\n * {@link noteAddress}: an address the overlay LIVED THROUGH (a filter the table wrote\n * while its sheet was up) is still unwound, because the user has acted since.\n *\n * ## Not undoing the owner's replaces either\n *\n * An address the overlay lived through is unwound as an ENTRY, never as an address\n * (keksdose live #412). A report that writes each tick of its payee sheet into the query\n * with `setSearchParams(…, { replace: true })` rewrites the overlay's own entry, and the\n * page entry beneath still carries the address from before the sheet opened — so the\n * traversal that took our entry away also took every tick with it. See {@link carryOnto}:\n * whichever way the entry goes (the unwind after a press, or a Back press), the address it\n * last showed is carried onto the entry it lands on, and the router is told.\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  /** The overlay refuses to close right now — see the `held` option. */\n  held: () => boolean;\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  /** The full address of the entry (query and hash included) as of the last time the\n   *  user acted while it was current — see {@link noteAddress}. */\n  href: string;\n  /** Its overlay is gone but the entry is not — someone above owes this pop. */\n  dead: boolean;\n  /** The router's `idx` on this entry when the marker went on — see {@link locate}. */\n  idx: number | undefined;\n  /** The router's `key` copied from the page entry beneath ours. */\n  key: string | undefined;\n  /** {@link routeOf} the address the marker was placed at. */\n  route: string;\n  /** The entry's address as last OBSERVED, after the user's last gesture had run its\n   *  handlers — what a Back press must carry down (see {@link carryOnto}). `href` is\n   *  the snapshot BEFORE the gesture, which the owner's-close check needs instead. */\n  seen: string;\n}\nconst pushed: PushedEntry[] = [];\n\n/**\n * Entries of ours that a ROUTER NAVIGATION made from inside the overlay has left\n * behind — ours, still in the history, but no longer on top and no longer anyone's.\n *\n * Nothing can take an entry out from under a newer one, so they cannot be unwound;\n * what can be done is to not let the user land on one. A traversal that comes to\n * rest on a buried entry is carried straight on over the whole run of them, in the\n * direction it was going (see `skipBuried`): Back from the new page lands on the page\n * the overlay was opened from, Forward from there lands on the new page, and no press\n * is spent on an entry with nothing on screen for it.\n *\n * `below` / `above` count the buried entries of the same run on either side. The\n * router's `idx` tells the direction apart — except after a REPLACE navigation, when\n * the page above the run shares the run's `idx`; the two keys decide there.\n */\ninterface BuriedEntry {\n  idx: number;\n  /** The `idx` of the router entry that buried the run: higher after a push, the\n   *  same after a replace. */\n  aboveIdx: number;\n  /** The key of the page entry directly beneath the run. */\n  belowKey: string | undefined;\n  /** The key of the router entry that buried the run, when it did. */\n  aboveKey: string | undefined;\n  below: number;\n  above: number;\n}\nconst buried = new Map<string, BuriedEntry>();\n\n/** The router `{idx, key}` of the entry the last traversal (or burial) left us on —\n *  what `skipBuried` compares against to know which way the user was going. */\nlet lastSeen: { idx: number | undefined; key: string | undefined } | null = null;\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) {\n    // A router navigation landed between the cleanup and this task: the entries\n    // are under it (or were replaced by it) rather than simply forgotten.\n    if (taggedSentinel() === null) buryUnder(job.entries);\n    return;\n  }\n  const bottom = job.entries[0];\n  carry = { href: job.href, idx: bottom.idx, key: bottom.key };\n  pendingProgrammatic += 1;\n  window.history.go(-job.entries.length);\n}\n\n/** The address an unwind in flight must carry onto the entry it lands on. */\nlet carry: { href: string; idx: number | undefined; key: string | undefined } | null = null;\n\n/**\n * Put `href` — the address the overlay's entry last showed — onto the entry a traversal\n * has just landed on, and tell the router (keksdose live #412).\n *\n * Only the query and the hash can differ: an address naming another page is a\n * navigation, never carried. And only onto the page entry the overlay was opened over,\n * which our push copied the router's `{idx, key}` from — a traversal that came to rest\n * anywhere else is not ours to rewrite.\n *\n * The router heard the traversal land on the OLD address in this same event, so a\n * `replaceState` alone would leave it showing the old query under the new one. A\n * synthetic `popstate` makes it read the address again; both reads happen in one event\n * dispatch, so React commits only the second. Ours absorbs it as programmatic.\n */\nfunction carryOnto(href: string, mark: { idx: number | undefined; key: string | undefined }): void {\n  const here = currentHref();\n  if (here === href || routeOf(here) !== routeOf(href)) return;\n  const now = routerMark();\n  if (mark.idx !== undefined && now.idx !== undefined && mark.idx !== now.idx) return;\n  if (mark.key !== undefined && now.key !== undefined && mark.key !== now.key) return;\n  const state: unknown = window.history.state;\n  window.history.replaceState(state, \"\", href);\n  pendingProgrammatic += 1;\n  window.dispatchEvent(new PopStateEvent(\"popstate\", { state }));\n}\n\nfunction currentHref(): string {\n  return typeof window === \"undefined\" ? \"\" : window.location.href;\n}\n\n/** The router's own `{idx, key}` on the current entry, where a router has put them. */\nfunction routerMark(): { idx: number | undefined; key: string | undefined } {\n  const state = typeof window !== \"undefined\" ? (window.history.state as unknown) : null;\n  if (!state || typeof state !== \"object\") return { idx: undefined, key: undefined };\n  const { idx, key } = state as Record<string, unknown>;\n  return { idx: typeof idx === \"number\" ? idx : undefined, key: typeof key === \"string\" ? key : undefined };\n}\n\n/**\n * The part of an address that names the PAGE — the query string left out.\n *\n * A `setSearchParams(…, { replace: true })` rewrites the query on the entry the\n * overlay is standing on; that is a wipe to repair, not a move. Anything else changing\n * is a navigation. Under a hash router the page lives in the hash (`#/table?f.q=x`), so\n * a hash that starts with `#/` counts up to its own `?`; an ordinary `#fragment` does\n * not name a page and is left out.\n */\nfunction routeOf(href: string): string {\n  try {\n    const url = new URL(href);\n    const hashRoute = url.hash.startsWith(\"#/\") ? url.hash.split(\"?\")[0] : \"\";\n    return url.origin + url.pathname + hashRoute;\n  } catch {\n    return href;\n  }\n}\n\n/**\n * Is the untagged entry we are standing on still `p`'s — merely wiped by the router —\n * or an entry the router NAVIGATED to from inside the overlay?\n *\n * The router's `idx` is the one per-entry fact that separates the two, because it is\n * the one the router itself keeps straight: a replace leaves it as it was, a push adds\n * one. Our own push copies the page's state, so our entry carries the page's `idx` and\n * a router push on top of it carries one more. The key would not do — every replace\n * mints a new one, so the wipe this repair exists for would already fail it. Neither\n * would the address alone: a push to the address we are already at is still a push.\n *\n * `idx` does not see one move, the router REPLACING our entry with a different page\n * (same `idx`), so the page named by the address must also be unchanged. Where there is\n * no `idx` to compare (no router, or one that keeps none) the address is all there is.\n */\nfunction isStillOn(p: PushedEntry): boolean {\n  if (routeOf(currentHref()) !== p.route) return false;\n  const { idx } = routerMark();\n  return idx === undefined || p.idx === undefined || idx === p.idx;\n}\n\n/**\n * The router has navigated while our entries were on top: record which of `records`\n * (ours, oldest first, ending with the top one) it buried and which it replaced, and\n * drop them from `pushed` — none of them can be unwound any more. Returns whether it\n * recognised a navigation at all; when it cannot tell (no router `idx` to go by), it\n * leaves everything as it was and the caller falls back to marking the entry dead.\n */\nfunction buryUnder(records: PushedEntry[]): boolean {\n  const top = records[records.length - 1];\n  const here = routerMark();\n  if (!top || top.idx === undefined || here.idx === undefined) return false;\n  let run: PushedEntry[];\n  if (here.idx > top.idx) {\n    run = [];\n    for (let i = records.length - 1; i >= 0 && records[i].idx === top.idx; i -= 1) run.unshift(records[i]);\n  } else if (here.idx === top.idx && !isStillOn(top)) {\n    // Replaced: the top entry IS the new page now, and gone as ours. Those beneath it\n    // are buried under it.\n    run = [];\n    for (let i = records.length - 2; i >= 0 && records[i].idx === top.idx; i -= 1) run.unshift(records[i]);\n  } else {\n    return false;\n  }\n  run.forEach((r, i) => {\n    buried.set(r.id, {\n      idx: top.idx as number,\n      aboveIdx: here.idx as number,\n      belowKey: run[0].key,\n      aboveKey: here.key,\n      below: i,\n      above: run.length - 1 - i,\n    });\n  });\n  for (const r of records) forgetPushed(r.id);\n  lastSeen = here;\n  return true;\n}\n\n/**\n * A traversal came to rest on one of our buried entries: carry it on over the run, the\n * way it was going. Back from above (a higher `idx`, or the very entry that buried us)\n * continues down to the page beneath; Forward from that page continues up. A landing\n * from anywhere this cannot place is left alone — one idle press is the price of not\n * guessing, and a wrong guess would move the user somewhere they did not ask to go.\n */\nfunction skipBuried(from: typeof lastSeen): void {\n  const tag = taggedSentinel();\n  const rec = tag !== null ? buried.get(tag) : undefined;\n  if (!rec || !from || stack.some((e) => e.id === tag)) return;\n  let steps = 0;\n  if ((from.idx !== undefined && from.idx > rec.idx) || (from.key !== undefined && from.key === rec.aboveKey)) {\n    steps = -(rec.below + 1);\n  } else if (\n    from.idx !== undefined &&\n    // Below the run, or level with it when nothing above it is (a push buried it),\n    // or level with it and provably the page beneath (a replace buried it). The\n    // router's first entry has no key at all, so an absent key is a key here.\n    (from.idx < rec.idx || (from.idx === rec.idx && (rec.aboveIdx > rec.idx || from.key === rec.belowKey)))\n  ) {\n    steps = rec.above + 1;\n  }\n  if (steps === 0) return;\n  pendingProgrammatic += 1;\n  window.history.go(steps);\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({ ...(prev && typeof prev === \"object\" ? prev : {}), [SENTINEL_KEY]: id }, \"\");\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  //\n  // And only an entry that is still the one the marker was placed on. A row that\n  // NAVIGATES (a palette result, a dialog's link) has the router push the new page\n  // before the overlay's cleanup runs; that entry carries no tag either, and\n  // re-stamping it made the cleanup \"unwind\" the navigation itself — the page\n  // changed and changed straight back. See `isStillOn` for how the two are told apart.\n  const record = pushed.find((p) => p.id === standing);\n  if (!record || !isStillOn(record)) {\n    standing = null;\n    return null;\n  }\n  retag(standing);\n  return standing;\n}\n\n/**\n * The user is about to act: what the current entry's address is NOW is what the\n * overlay standing on it has lived through.\n *\n * The cleanup needs to tell two same-page query rewrites apart, and the address alone\n * cannot. A `DataTable` with `urlSync` replaces `f.*` over the entry while its filter\n * sheet is up, and the sheet is closed LATER, by a press of its own — that entry is\n * still the sheet's and must be unwound (the audit's drift fix, below). A page whose\n * `?row=` drives the overlay replaces the clean URL over the entry and the overlay\n * unmounts BECAUSE of it (keksdose dev #584) — that entry is the owner's now, and\n * unwinding lands on `?row=` beneath and reopens what was just closed. What separates\n * them is whether the user acted in between: the rewrite that closes an overlay is\n * made by the very press that closes it, so it postdates this snapshot.\n *\n * Capture phase, so the snapshot is taken before any handler of the press runs.\n */\nfunction noteAddress(): void {\n  const top = pushed[pushed.length - 1];\n  if (!top || top.dead || !stack.some((e) => e.id === top.id)) return;\n  const tag = taggedSentinel();\n  // Read without `currentSentinel`'s repair: an observation must not write history.\n  if (tag === top.id || (tag === null && standing === top.id && isStillOn(top))) {\n    top.href = currentHref();\n    top.seen = top.href;\n  }\n}\n\n/** After the user's gesture has run its handlers: the address its entry now shows —\n *  what a Back press must carry down (keksdose live #412). Again a little later, for a\n *  handler that writes the address a task after the event. */\nfunction noteSeen(): void {\n  const top = pushed[pushed.length - 1];\n  if (!top || top.dead || !stack.some((e) => e.id === top.id)) return;\n  const tag = taggedSentinel();\n  if (tag === top.id || (tag === null && standing === top.id && isStillOn(top))) top.seen = currentHref();\n}\n\nfunction noteSeenNowAndLater(): void {\n  noteSeen();\n  setTimeout(noteSeen, 0);\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  const from = lastSeen;\n  lastSeen = routerMark();\n  if (pendingProgrammatic > 0) {\n    pendingProgrammatic -= 1;\n    const job = carry;\n    carry = null;\n    if (job) carryOnto(job.href, job);\n    return;\n  }\n  closeOnPop();\n  skipBuried(from);\n}\n\nfunction closeOnPop() {\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  // Checked before anything below moves: a held overlay keeps its place and its record.\n  if (top.held()) {\n    putBack(top.id);\n    return;\n  }\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  const record = pushed.find((p) => p.id === top.id);\n  forgetPushed(top.id);\n  // What the page wrote into the address while we were up stays (#412).\n  if (record && !record.dead) carryOnto(record.seen, record);\n  top.close();\n}\n\n/**\n * A Back press the top overlay refuses (a busy `Modal`, DUP-3). A popstate cannot be\n * refused — the browser has already left our entry — so the entry is put back: what the\n * page wrote into the address while the overlay was up is carried down first (#412), as\n * for a close, and the same marker is pushed again over it, as the mount pushed it. Left\n * on the page entry, the overlay would stay up with no entry of its own, and the Back\n * after its request would leave the page under it.\n *\n * A push and not `history.go(1)` back onto the old entry: a traversal lands a task later\n * and fires nothing at all if a listener has pushed meanwhile, and a programmatic pop\n * counted for it would then swallow the user's next real Back.\n */\nfunction putBack(id: string): void {\n  const record = pushed.find((p) => p.id === id);\n  if (record && !record.dead) carryOnto(record.seen, record);\n  const prev: unknown = window.history.state;\n  window.history.pushState({ ...(prev && typeof prev === \"object\" ? prev : {}), [SENTINEL_KEY]: id }, \"\");\n  standing = id;\n  // The address the entry shows now is the one the user last acted on: the cleanup's\n  // owner's-close check (#584) must not read the carried address as a rewrite.\n  if (record) record.href = record.seen = currentHref();\n}\n\nfunction ensureListening() {\n  if (listening || typeof window === \"undefined\") return;\n  window.addEventListener(\"popstate\", handlePop);\n  window.addEventListener(\"pointerdown\", noteAddress, true);\n  window.addEventListener(\"keydown\", noteAddress, true);\n  for (const type of [\"click\", \"keyup\", \"change\", \"input\"]) window.addEventListener(type, noteSeenNowAndLater);\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 * @param options.held  the overlay refuses to close right now (a `Modal` whose request\n *                  is in flight, DUP-3): Back does not call `onClose`, and the entry the\n *                  press took is put back, so the overlay still has one for the next\n *                  Back. Read when Back is pressed. Default false.\n */\nexport function useOverlayHistory(open: boolean, onClose: () => void, { held = false }: { held?: boolean } = {}): 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  const heldRef = useRef(held);\n  useEffect(() => {\n    closeRef.current = onClose;\n    heldRef.current = held;\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(), held: () => heldRef.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      const was = inherited[inherited.length - 1];\n      pushed.push({\n        id,\n        href: currentHref(),\n        seen: currentHref(),\n        dead: false,\n        idx: was.idx,\n        key: was.key,\n        route: was.route,\n      });\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      const page = routerMark();\n      const at = currentHref();\n      pushed.push({ id, href: at, seen: at, dead: false, idx: page.idx, key: page.key, route: routeOf(at) });\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      // Still our entry — same page, same router `idx` — but its address is not the one\n      // the user last acted on: the owner rewrote it as part of closing us (see\n      // {@link noteAddress}). The entry is the owner's page now, and the one beneath is\n      // the address it replaced — going back would restore exactly what was closed.\n      // Nothing to unwind; forget the record rather than re-stamp a page we left.\n      if (mine >= 0 && currentHref() !== pushed[mine].href) {\n        const tag = taggedSentinel();\n        if (tag === id || (tag === null && standing === id && isStillOn(pushed[mine]))) {\n          pushed.splice(mine, 1);\n          if (standing === id) standing = null;\n          return;\n        }\n      }\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        // A router navigation from inside the overlay: nothing to unwind — the\n        // entries it left beneath the new page are skipped over instead.\n        if (mine >= 0 && taggedSentinel() === null && buryUnder(pushed.slice(0, pushed.length))) return;\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 * ## Not undoing the owner's own close\n *\n * Nor when the address under the entry changed in the same breath as the close\n * (keksdose dev #584). A page that opens its editor by PUSHING `?row=x` and closes it\n * by REPLACING the clean URL over the top entry rewrites OUR entry — the overlay sits\n * above `?row=x` — and that rewrite is what unmounts the overlay. Going back from there\n * lands on `?row=x` and the router opens the editor that was just closed. See\n * {@link noteAddress}: an address the overlay LIVED THROUGH (a filter the table wrote\n * while its sheet was up) is still unwound, because the user has acted since.\n *\n * ## Not undoing the owner's replaces either\n *\n * An address the overlay lived through is unwound as an ENTRY, never as an address\n * (keksdose live #412). A report that writes each tick of its payee sheet into the query\n * with `setSearchParams(…, { replace: true })` rewrites the overlay's own entry, and the\n * page entry beneath still carries the address from before the sheet opened — so the\n * traversal that took our entry away also took every tick with it. See {@link carryOnto}:\n * whichever way the entry goes (the unwind after a press, or a Back press), the address it\n * last showed is carried onto the entry it lands on, and the router is told.\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  /** The overlay refuses to close right now — see the `held` option. */\n  held: () => boolean;\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  /** The full address of the entry (query and hash included) as of the last time the\n   *  user acted while it was current — see {@link noteAddress}. */\n  href: string;\n  /** Its overlay is gone but the entry is not — someone above owes this pop. */\n  dead: boolean;\n  /** The router's `idx` on this entry when the marker went on — see {@link locate}. */\n  idx: number | undefined;\n  /** The router's `key` copied from the page entry beneath ours. */\n  key: string | undefined;\n  /** {@link routeOf} the address the marker was placed at. */\n  route: string;\n  /** The entry's address as last OBSERVED, after the user's last gesture had run its\n   *  handlers — what a Back press must carry down (see {@link carryOnto}). `href` is\n   *  the snapshot BEFORE the gesture, which the owner's-close check needs instead. */\n  seen: string;\n}\nconst pushed: PushedEntry[] = [];\n\n/**\n * Entries of ours that a ROUTER NAVIGATION made from inside the overlay has left\n * behind — ours, still in the history, but no longer on top and no longer anyone's.\n *\n * Nothing can take an entry out from under a newer one, so they cannot be unwound;\n * what can be done is to not let the user land on one. A traversal that comes to\n * rest on a buried entry is carried straight on over the whole run of them, in the\n * direction it was going (see `skipBuried`): Back from the new page lands on the page\n * the overlay was opened from, Forward from there lands on the new page, and no press\n * is spent on an entry with nothing on screen for it.\n *\n * `below` / `above` count the buried entries of the same run on either side. The\n * router's `idx` tells the direction apart — except after a REPLACE navigation, when\n * the page above the run shares the run's `idx`; the two keys decide there.\n */\ninterface BuriedEntry {\n  idx: number;\n  /** The `idx` of the router entry that buried the run: higher after a push, the\n   *  same after a replace. */\n  aboveIdx: number;\n  /** The key of the page entry directly beneath the run. */\n  belowKey: string | undefined;\n  /** The key of the router entry that buried the run, when it did. */\n  aboveKey: string | undefined;\n  below: number;\n  above: number;\n}\nconst buried = new Map<string, BuriedEntry>();\n\n/** The router `{idx, key}` of the entry the last traversal (or burial) left us on —\n *  what `skipBuried` compares against to know which way the user was going. */\nlet lastSeen: { idx: number | undefined; key: string | undefined } | null = null;\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;\n/** Whether the gesture listeners ({@link noteAddress}, {@link noteSeen}) are on — see\n *  {@link syncGestureListeners}. */\nlet noting = 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) {\n    // A router navigation landed between the cleanup and this task: the entries\n    // are under it (or were replaced by it) rather than simply forgotten.\n    if (taggedSentinel() === null) buryUnder(job.entries);\n    return;\n  }\n  const bottom = job.entries[0];\n  carry = { href: job.href, idx: bottom.idx, key: bottom.key };\n  pendingProgrammatic += 1;\n  window.history.go(-job.entries.length);\n}\n\n/** The address an unwind in flight must carry onto the entry it lands on. */\nlet carry: { href: string; idx: number | undefined; key: string | undefined } | null = null;\n\n/**\n * Put `href` — the address the overlay's entry last showed — onto the entry a traversal\n * has just landed on, and tell the router (keksdose live #412).\n *\n * Only the query and the hash can differ: an address naming another page is a\n * navigation, never carried. And only onto the page entry the overlay was opened over,\n * which our push copied the router's `{idx, key}` from — a traversal that came to rest\n * anywhere else is not ours to rewrite.\n *\n * The router heard the traversal land on the OLD address in this same event, so a\n * `replaceState` alone would leave it showing the old query under the new one. A\n * synthetic `popstate` makes it read the address again; both reads happen in one event\n * dispatch, so React commits only the second. Ours absorbs it as programmatic.\n */\nfunction carryOnto(href: string, mark: { idx: number | undefined; key: string | undefined }): void {\n  const here = currentHref();\n  if (here === href || routeOf(here) !== routeOf(href)) return;\n  const now = routerMark();\n  if (mark.idx !== undefined && now.idx !== undefined && mark.idx !== now.idx) return;\n  if (mark.key !== undefined && now.key !== undefined && mark.key !== now.key) return;\n  const state: unknown = window.history.state;\n  window.history.replaceState(state, \"\", href);\n  pendingProgrammatic += 1;\n  window.dispatchEvent(new PopStateEvent(\"popstate\", { state }));\n}\n\nfunction currentHref(): string {\n  return typeof window === \"undefined\" ? \"\" : window.location.href;\n}\n\n/** The router's own `{idx, key}` on the current entry, where a router has put them. */\nfunction routerMark(): { idx: number | undefined; key: string | undefined } {\n  const state = typeof window !== \"undefined\" ? (window.history.state as unknown) : null;\n  if (!state || typeof state !== \"object\") return { idx: undefined, key: undefined };\n  const { idx, key } = state as Record<string, unknown>;\n  return { idx: typeof idx === \"number\" ? idx : undefined, key: typeof key === \"string\" ? key : undefined };\n}\n\n/**\n * The part of an address that names the PAGE — the query string left out.\n *\n * A `setSearchParams(…, { replace: true })` rewrites the query on the entry the\n * overlay is standing on; that is a wipe to repair, not a move. Anything else changing\n * is a navigation. Under a hash router the page lives in the hash (`#/table?f.q=x`), so\n * a hash that starts with `#/` counts up to its own `?`; an ordinary `#fragment` does\n * not name a page and is left out.\n */\nfunction routeOf(href: string): string {\n  try {\n    const url = new URL(href);\n    const hashRoute = url.hash.startsWith(\"#/\") ? url.hash.split(\"?\")[0] : \"\";\n    return url.origin + url.pathname + hashRoute;\n  } catch {\n    return href;\n  }\n}\n\n/**\n * Is the untagged entry we are standing on still `p`'s — merely wiped by the router —\n * or an entry the router NAVIGATED to from inside the overlay?\n *\n * The router's `idx` is the one per-entry fact that separates the two, because it is\n * the one the router itself keeps straight: a replace leaves it as it was, a push adds\n * one. Our own push copies the page's state, so our entry carries the page's `idx` and\n * a router push on top of it carries one more. The key would not do — every replace\n * mints a new one, so the wipe this repair exists for would already fail it. Neither\n * would the address alone: a push to the address we are already at is still a push.\n *\n * `idx` does not see one move, the router REPLACING our entry with a different page\n * (same `idx`), so the page named by the address must also be unchanged. Where there is\n * no `idx` to compare (no router, or one that keeps none) the address is all there is.\n */\nfunction isStillOn(p: PushedEntry): boolean {\n  if (routeOf(currentHref()) !== p.route) return false;\n  const { idx } = routerMark();\n  return idx === undefined || p.idx === undefined || idx === p.idx;\n}\n\n/**\n * The router has navigated while our entries were on top: record which of `records`\n * (ours, oldest first, ending with the top one) it buried and which it replaced, and\n * drop them from `pushed` — none of them can be unwound any more. Returns whether it\n * recognised a navigation at all; when it cannot tell (no router `idx` to go by), it\n * leaves everything as it was and the caller falls back to marking the entry dead.\n */\nfunction buryUnder(records: PushedEntry[]): boolean {\n  const top = records[records.length - 1];\n  const here = routerMark();\n  if (!top || top.idx === undefined || here.idx === undefined) return false;\n  let run: PushedEntry[];\n  if (here.idx > top.idx) {\n    run = [];\n    for (let i = records.length - 1; i >= 0 && records[i].idx === top.idx; i -= 1) run.unshift(records[i]);\n  } else if (here.idx === top.idx && !isStillOn(top)) {\n    // Replaced: the top entry IS the new page now, and gone as ours. Those beneath it\n    // are buried under it.\n    run = [];\n    for (let i = records.length - 2; i >= 0 && records[i].idx === top.idx; i -= 1) run.unshift(records[i]);\n  } else {\n    return false;\n  }\n  run.forEach((r, i) => {\n    buried.set(r.id, {\n      idx: top.idx as number,\n      aboveIdx: here.idx as number,\n      belowKey: run[0].key,\n      aboveKey: here.key,\n      below: i,\n      above: run.length - 1 - i,\n    });\n  });\n  for (const r of records) forgetPushed(r.id);\n  lastSeen = here;\n  return true;\n}\n\n/**\n * A traversal came to rest on one of our buried entries: carry it on over the run, the\n * way it was going. Back from above (a higher `idx`, or the very entry that buried us)\n * continues down to the page beneath; Forward from that page continues up. A landing\n * from anywhere this cannot place is left alone — one idle press is the price of not\n * guessing, and a wrong guess would move the user somewhere they did not ask to go.\n */\nfunction skipBuried(from: typeof lastSeen): void {\n  const tag = taggedSentinel();\n  const rec = tag !== null ? buried.get(tag) : undefined;\n  if (!rec || !from || stack.some((e) => e.id === tag)) return;\n  let steps = 0;\n  if ((from.idx !== undefined && from.idx > rec.idx) || (from.key !== undefined && from.key === rec.aboveKey)) {\n    steps = -(rec.below + 1);\n  } else if (\n    from.idx !== undefined &&\n    // Below the run, or level with it when nothing above it is (a push buried it),\n    // or level with it and provably the page beneath (a replace buried it). The\n    // router's first entry has no key at all, so an absent key is a key here.\n    (from.idx < rec.idx || (from.idx === rec.idx && (rec.aboveIdx > rec.idx || from.key === rec.belowKey)))\n  ) {\n    steps = rec.above + 1;\n  }\n  if (steps === 0) return;\n  pendingProgrammatic += 1;\n  window.history.go(steps);\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({ ...(prev && typeof prev === \"object\" ? prev : {}), [SENTINEL_KEY]: id }, \"\");\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  //\n  // And only an entry that is still the one the marker was placed on. A row that\n  // NAVIGATES (a palette result, a dialog's link) has the router push the new page\n  // before the overlay's cleanup runs; that entry carries no tag either, and\n  // re-stamping it made the cleanup \"unwind\" the navigation itself — the page\n  // changed and changed straight back. See `isStillOn` for how the two are told apart.\n  const record = pushed.find((p) => p.id === standing);\n  if (!record || !isStillOn(record)) {\n    standing = null;\n    return null;\n  }\n  retag(standing);\n  return standing;\n}\n\n/**\n * The user is about to act: what the current entry's address is NOW is what the\n * overlay standing on it has lived through.\n *\n * The cleanup needs to tell two same-page query rewrites apart, and the address alone\n * cannot. A `DataTable` with `urlSync` replaces `f.*` over the entry while its filter\n * sheet is up, and the sheet is closed LATER, by a press of its own — that entry is\n * still the sheet's and must be unwound (the audit's drift fix, below). A page whose\n * `?row=` drives the overlay replaces the clean URL over the entry and the overlay\n * unmounts BECAUSE of it (keksdose dev #584) — that entry is the owner's now, and\n * unwinding lands on `?row=` beneath and reopens what was just closed. What separates\n * them is whether the user acted in between: the rewrite that closes an overlay is\n * made by the very press that closes it, so it postdates this snapshot.\n *\n * Capture phase, so the snapshot is taken before any handler of the press runs.\n */\nfunction noteAddress(): void {\n  const top = pushed[pushed.length - 1];\n  if (!top || top.dead || !stack.some((e) => e.id === top.id)) return;\n  const tag = taggedSentinel();\n  // Read without `currentSentinel`'s repair: an observation must not write history.\n  if (tag === top.id || (tag === null && standing === top.id && isStillOn(top))) {\n    top.href = currentHref();\n    top.seen = top.href;\n  }\n}\n\n/** After the user's gesture has run its handlers: the address its entry now shows —\n *  what a Back press must carry down (keksdose live #412). Again a little later, for a\n *  handler that writes the address a task after the event. */\nfunction noteSeen(): void {\n  const top = pushed[pushed.length - 1];\n  if (!top || top.dead || !stack.some((e) => e.id === top.id)) return;\n  const tag = taggedSentinel();\n  if (tag === top.id || (tag === null && standing === top.id && isStillOn(top))) top.seen = currentHref();\n}\n\nfunction noteSeenNowAndLater(): void {\n  noteSeen();\n  setTimeout(noteSeen, 0);\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  const from = lastSeen;\n  lastSeen = routerMark();\n  if (pendingProgrammatic > 0) {\n    pendingProgrammatic -= 1;\n    const job = carry;\n    carry = null;\n    if (job) carryOnto(job.href, job);\n    return;\n  }\n  closeOnPop();\n  skipBuried(from);\n}\n\nfunction closeOnPop() {\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  // Checked before anything below moves: a held overlay keeps its place and its record.\n  if (top.held()) {\n    putBack(top.id);\n    return;\n  }\n  stack.pop();\n  syncGestureListeners();\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  const record = pushed.find((p) => p.id === top.id);\n  forgetPushed(top.id);\n  // What the page wrote into the address while we were up stays (#412).\n  if (record && !record.dead) carryOnto(record.seen, record);\n  top.close();\n}\n\n/**\n * A Back press the top overlay refuses (a busy `Modal`, DUP-3). A popstate cannot be\n * refused — the browser has already left our entry — so the entry is put back: what the\n * page wrote into the address while the overlay was up is carried down first (#412), as\n * for a close, and the same marker is pushed again over it, as the mount pushed it. Left\n * on the page entry, the overlay would stay up with no entry of its own, and the Back\n * after its request would leave the page under it.\n *\n * A push and not `history.go(1)` back onto the old entry: a traversal lands a task later\n * and fires nothing at all if a listener has pushed meanwhile, and a programmatic pop\n * counted for it would then swallow the user's next real Back.\n */\nfunction putBack(id: string): void {\n  const record = pushed.find((p) => p.id === id);\n  if (record && !record.dead) carryOnto(record.seen, record);\n  const prev: unknown = window.history.state;\n  window.history.pushState({ ...(prev && typeof prev === \"object\" ? prev : {}), [SENTINEL_KEY]: id }, \"\");\n  standing = id;\n  // The address the entry shows now is the one the user last acted on: the cleanup's\n  // owner's-close check (#584) must not read the carried address as a rewrite.\n  if (record) record.href = record.seen = currentHref();\n}\n\n/** `popstate` stays from the first overlay on: a traversal of ours (an unwind, a buried\n *  run to skip) lands after the overlay that caused it has gone. */\nfunction ensureListening() {\n  if (listening || typeof window === \"undefined\") return;\n  window.addEventListener(\"popstate\", handlePop);\n  listening = true;\n}\n\nconst SEEN_EVENTS = [\"click\", \"keyup\", \"change\", \"input\"] as const;\n\n/**\n * The gesture listeners, on while an overlay is open and off when the last one closes.\n * Both notes return at once with no overlay up, but the four bubbling ones scheduled a\n * timer for their second look even then — for every click and every keystroke in every\n * field, for the life of the page after its first dialog (refactor audit 2026-10-30,\n * INP-14). Called after each change to `stack`.\n */\nfunction syncGestureListeners(): void {\n  const want = stack.length > 0;\n  if (want === noting || typeof window === \"undefined\") return;\n  noting = want;\n  if (want) {\n    window.addEventListener(\"pointerdown\", noteAddress, true);\n    window.addEventListener(\"keydown\", noteAddress, true);\n    for (const type of SEEN_EVENTS) window.addEventListener(type, noteSeenNowAndLater);\n  } else {\n    window.removeEventListener(\"pointerdown\", noteAddress, true);\n    window.removeEventListener(\"keydown\", noteAddress, true);\n    for (const type of SEEN_EVENTS) window.removeEventListener(type, noteSeenNowAndLater);\n  }\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 * @param options.held  the overlay refuses to close right now (a `Modal` whose request\n *                  is in flight, DUP-3): Back does not call `onClose`, and the entry the\n *                  press took is put back, so the overlay still has one for the next\n *                  Back. Read when Back is pressed. Default false.\n */\nexport function useOverlayHistory(open: boolean, onClose: () => void, { held = false }: { held?: boolean } = {}): 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  const heldRef = useRef(held);\n  useEffect(() => {\n    closeRef.current = onClose;\n    heldRef.current = held;\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(), held: () => heldRef.current };\n    stack.push(entry);\n    syncGestureListeners();\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      const was = inherited[inherited.length - 1];\n      pushed.push({\n        id,\n        href: currentHref(),\n        seen: currentHref(),\n        dead: false,\n        idx: was.idx,\n        key: was.key,\n        route: was.route,\n      });\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      const page = routerMark();\n      const at = currentHref();\n      pushed.push({ id, href: at, seen: at, dead: false, idx: page.idx, key: page.key, route: routeOf(at) });\n      standing = id;\n    }\n    return () => {\n      const at = stack.indexOf(entry);\n      if (at >= 0) stack.splice(at, 1);\n      syncGestureListeners();\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      // Still our entry — same page, same router `idx` — but its address is not the one\n      // the user last acted on: the owner rewrote it as part of closing us (see\n      // {@link noteAddress}). The entry is the owner's page now, and the one beneath is\n      // the address it replaced — going back would restore exactly what was closed.\n      // Nothing to unwind; forget the record rather than re-stamp a page we left.\n      if (mine >= 0 && currentHref() !== pushed[mine].href) {\n        const tag = taggedSentinel();\n        if (tag === id || (tag === null && standing === id && isStillOn(pushed[mine]))) {\n          pushed.splice(mine, 1);\n          if (standing === id) standing = null;\n          return;\n        }\n      }\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        // A router navigation from inside the overlay: nothing to unwind — the\n        // entries it left beneath the new page are skipped over instead.\n        if (mine >= 0 && taggedSentinel() === null && buryUnder(pushed.slice(0, pushed.length))) return;\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":[]}