@smwb/ui-react 2.8.0 → 2.9.0

package/dist/headless/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/headless/utils/keyboardShortcut.js

@@ -0,0 +1,49 @@
+import { detectKbdPlatform as d } from "../components/dataDisplay/kbd/kbdKeys.js";
+const p = {
+  mod: "mod",
+  ctrl: "ctrl",
+  control: "ctrl",
+  alt: "alt",
+  option: "alt",
+  shift: "shift",
+  meta: "meta",
+  cmd: "meta",
+  command: "meta"
+}, h = {
+  esc: "escape",
+  space: " ",
+  spacebar: " ",
+  up: "arrowup",
+  down: "arrowdown",
+  left: "arrowleft",
+  right: "arrowright",
+  plus: "+",
+  return: "enter",
+  del: "delete"
+};
+function y(t, m, n = d()) {
+  var i, c;
+  let l = !1, s = !1, f = !1, a = !1, e = null;
+  for (const u of m) {
+    const o = u.trim().toLowerCase() || u, r = p[o];
+    if (r === "mod")
+      n === "mac" ? a = !0 : l = !0;
+    else if (r === "ctrl")
+      l = !0;
+    else if (r === "alt")
+      s = !0;
+    else if (r === "shift")
+      f = !0;
+    else if (r === "meta")
+      a = !0;
+    else if (e === null)
+      e = (i = h[o]) != null ? i : o;
+    else
+      return !1;
+  }
+  return e === null || t.ctrlKey !== l || t.altKey !== s || t.shiftKey !== f || t.metaKey !== a ? !1 : ((c = t.key) != null ? c : "").toLowerCase() === e ? !0 : /^[a-z]$/.test(e) ? t.code === `Key${e.toUpperCase()}` : /^[0-9]$/.test(e) ? t.code === `Digit${e}` : !1;
+}
+export {
+  y as matchesKeyboardShortcut
+};
+//# sourceMappingURL=keyboardShortcut.js.map

package/dist/headless/utils/keyboardShortcut.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboardShortcut.js","sources":["../../../src/utils/keyboardShortcut.ts"],"sourcesContent":["import { detectKbdPlatform, type KbdPlatform } from \"../components/dataDisplay/kbd/kbdKeys\";\n\ntype ShortcutEvent = Pick<KeyboardEvent, \"key\" | \"code\" | \"ctrlKey\" | \"metaKey\" | \"altKey\" | \"shiftKey\">;\n\n// Modifier names (lower case) and the flag each one asks for. `mod` is resolved per platform.\nconst MODIFIERS: Record<string, \"mod\" | \"ctrl\" | \"alt\" | \"shift\" | \"meta\"> = {\n  mod: \"mod\",\n  ctrl: \"ctrl\",\n  control: \"ctrl\",\n  alt: \"alt\",\n  option: \"alt\",\n  shift: \"shift\",\n  meta: \"meta\",\n  cmd: \"meta\",\n  command: \"meta\",\n};\n\n// Names (lower case) that stand for another `KeyboardEvent.key`.\nconst KEY_ALIASES: Record<string, string> = {\n  esc: \"escape\",\n  space: \" \",\n  spacebar: \" \",\n  up: \"arrowup\",\n  down: \"arrowdown\",\n  left: \"arrowleft\",\n  right: \"arrowright\",\n  plus: \"+\",\n  return: \"enter\",\n  del: \"delete\",\n};\n\n/**\n * Whether a keyboard event is the shortcut `keys` (in `Kbd` key names, e.g. `[\"Mod\", \"K\"]`).\n * `Mod` is Meta on `mac` and Ctrl elsewhere. The modifiers must match exactly, so Mod+K does not\n * match Mod+Shift+K. The list needs exactly one key that is not a modifier. It is compared with\n * `event.key` ignoring case; a single ASCII letter or digit also matches `event.code`\n * (`KeyK`, `Digit1`), so a shortcut keeps working on a layout that types other letters.\n * `platform` is the running browser's by default.\n */\nexport function matchesKeyboardShortcut(\n  event: ShortcutEvent,\n  keys: string[],\n  platform: KbdPlatform = detectKbdPlatform()\n): boolean {\n  let ctrl = false;\n  let alt = false;\n  let shift = false;\n  let meta = false;\n  let main: string | null = null;\n  for (const key of keys) {\n    const lower = key.trim().toLowerCase() || key; // a lone \" \" is the space bar\n    const modifier = MODIFIERS[lower];\n    if (modifier === \"mod\") {\n      if (platform === \"mac\") {\n        meta = true;\n      } else {\n        ctrl = true;\n      }\n    } else if (modifier === \"ctrl\") {\n      ctrl = true;\n    } else if (modifier === \"alt\") {\n      alt = true;\n    } else if (modifier === \"shift\") {\n      shift = true;\n    } else if (modifier === \"meta\") {\n      meta = true;\n    } else if (main === null) {\n      main = KEY_ALIASES[lower] ?? lower;\n    } else {\n      return false;\n    }\n  }\n  if (main === null) {\n    return false;\n  }\n  if (event.ctrlKey !== ctrl || event.altKey !== alt || event.shiftKey !== shift || event.metaKey !== meta) {\n    return false;\n  }\n  if ((event.key ?? \"\").toLowerCase() === main) {\n    return true;\n  }\n  if (/^[a-z]$/.test(main)) {\n    return event.code === `Key${main.toUpperCase()}`;\n  }\n  if (/^[0-9]$/.test(main)) {\n    return event.code === `Digit${main}`;\n  }\n  return false;\n}\n"],"names":["MODIFIERS","KEY_ALIASES","matchesKeyboardShortcut","event","keys","platform","detectKbdPlatform","ctrl","alt","shift","meta","main","key","lower","modifier","_a","_b"],"mappings":";AAKA,MAAMA,IAAuE;AAAA,EAC3E,KAAK;AAAA,EACL,MAAM;AAAA,EACN,SAAS;AAAA,EACT,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,MAAM;AAAA,EACN,KAAK;AAAA,EACL,SAAS;AACX,GAGMC,IAAsC;AAAA,EAC1C,KAAK;AAAA,EACL,OAAO;AAAA,EACP,UAAU;AAAA,EACV,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AAAA,EACP,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,KAAK;AACP;AAUO,SAASC,EACdC,GACAC,GACAC,IAAwBC,KACf;;AACT,MAAIC,IAAO,IACPC,IAAM,IACNC,IAAQ,IACRC,IAAO,IACPC,IAAsB;AAC1B,aAAWC,KAAOR,GAAM;AACtB,UAAMS,IAAQD,EAAI,KAAA,EAAO,iBAAiBA,GACpCE,IAAWd,EAAUa,CAAK;AAChC,QAAIC,MAAa;AACf,MAAIT,MAAa,QACfK,IAAO,KAEPH,IAAO;AAAA,aAEAO,MAAa;AACtB,MAAAP,IAAO;AAAA,aACEO,MAAa;AACtB,MAAAN,IAAM;AAAA,aACGM,MAAa;AACtB,MAAAL,IAAQ;AAAA,aACCK,MAAa;AACtB,MAAAJ,IAAO;AAAA,aACEC,MAAS;AAClB,MAAAA,KAAOI,IAAAd,EAAYY,CAAK,MAAjB,OAAAE,IAAsBF;AAAA;AAE7B,aAAO;AAAA,EAEX;AAIA,SAHIF,MAAS,QAGTR,EAAM,YAAYI,KAAQJ,EAAM,WAAWK,KAAOL,EAAM,aAAaM,KAASN,EAAM,YAAYO,IAC3F,OAEJM,IAAAb,EAAM,QAAN,OAAAa,IAAa,IAAI,YAAA,MAAkBL,IAC/B,KAEL,UAAU,KAAKA,CAAI,IACdR,EAAM,SAAS,MAAMQ,EAAK,aAAa,KAE5C,UAAU,KAAKA,CAAI,IACdR,EAAM,SAAS,QAAQQ,CAAI,KAE7B;AACT;"}

package/dist/headless/utils/linkAttrs.js

@@ -0,0 +1,13 @@
+const o = "_blank";
+function r(e) {
+  return e === void 0 ? o : e === null || e === "" ? void 0 : e;
+}
+function l(e, n) {
+  return e !== void 0 ? e || void 0 : n !== void 0 && n !== "_self" && n !== "_parent" && n !== "_top" ? "noreferrer" : void 0;
+}
+export {
+  o as DEFAULT_LINK_TARGET,
+  l as resolveLinkRel,
+  r as resolveLinkTarget
+};
+//# sourceMappingURL=linkAttrs.js.map

package/dist/headless/utils/linkAttrs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linkAttrs.js","sources":["../../../src/utils/linkAttrs.ts"],"sourcesContent":["/** Where a link opens unless its `target` says otherwise. */\nexport const DEFAULT_LINK_TARGET = \"_blank\";\n\n/**\n * The `target` attribute for a link: `undefined` (not given) keeps `\"_blank\"`, `null` (or an\n * empty string) leaves the attribute out so the link opens in place, any other string is used as is.\n */\nexport function resolveLinkTarget(target: string | null | undefined): string | undefined {\n  if (target === undefined) return DEFAULT_LINK_TARGET;\n  return target === null || target === \"\" ? undefined : target;\n}\n\n/**\n * The `rel` attribute for a link: the caller's wins (an empty string drops it), `undefined` keeps the\n * default. The default is `\"noreferrer\"` for a link that opens another browsing context (a new tab or\n * a named window), which also implies `noopener`, and none for a link that opens in place.\n */\nexport function resolveLinkRel(rel: string | undefined, target: string | undefined): string | undefined {\n  if (rel !== undefined) return rel || undefined;\n  const elsewhere = target !== undefined && target !== \"_self\" && target !== \"_parent\" && target !== \"_top\";\n  return elsewhere ? \"noreferrer\" : undefined;\n}\n"],"names":["DEFAULT_LINK_TARGET","resolveLinkTarget","target","resolveLinkRel","rel"],"mappings":"AACO,MAAMA,IAAsB;AAM5B,SAASC,EAAkBC,GAAuD;AACvF,SAAIA,MAAW,SAAkBF,IAC1BE,MAAW,QAAQA,MAAW,KAAK,SAAYA;AACxD;AAOO,SAASC,EAAeC,GAAyBF,GAAgD;AACtG,SAAIE,MAAQ,SAAkBA,KAAO,SACnBF,MAAW,UAAaA,MAAW,WAAWA,MAAW,aAAaA,MAAW,SAChF,eAAe;AACpC;"}

package/dist/headless/utils/restoreFocus.js

@@ -0,0 +1,10 @@
+function c(e, n) {
+  if (!(e instanceof HTMLElement) || e === document.body || !e.isConnected)
+    return;
+  const t = document.activeElement;
+  t && t !== document.body && !(n != null && n.contains(t)) || e.focus({ preventScroll: !0 });
+}
+export {
+  c as restoreFocus
+};
+//# sourceMappingURL=restoreFocus.js.map

package/dist/headless/utils/restoreFocus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restoreFocus.js","sources":["../../../src/utils/restoreFocus.ts"],"sourcesContent":["/**\n * Hands focus back to `opener`, the element that had it when an overlay opened, once the\n * overlay `root` closes. Focus the app moved elsewhere on purpose stays where it is: it\n * is restored only while it is still inside `root` or has been dropped on the body (the\n * root is gone, or the element that had it was removed). An opener that left the document\n * is skipped, and one that cannot take focus (disabled, hidden) simply ignores the call.\n */\nexport function restoreFocus(opener: Element | null, root: Element | null | undefined): void {\n  if (!(opener instanceof HTMLElement) || opener === document.body || !opener.isConnected) {\n    return;\n  }\n  const active = document.activeElement;\n  if (active && active !== document.body && !root?.contains(active)) {\n    return;\n  }\n  opener.focus({ preventScroll: true });\n}\n"],"names":["restoreFocus","opener","root","active"],"mappings":"AAOO,SAASA,EAAaC,GAAwBC,GAAwC;AAC3F,MAAI,EAAED,aAAkB,gBAAgBA,MAAW,SAAS,QAAQ,CAACA,EAAO;AAC1E;AAEF,QAAME,IAAS,SAAS;AACxB,EAAIA,KAAUA,MAAW,SAAS,QAAQ,EAACD,KAAA,QAAAA,EAAM,SAASC,OAG1DF,EAAO,MAAM,EAAE,eAAe,GAAA,CAAM;AACtC;"}

package/dist/hooks/useFocusTrap.d.ts

@@ -8,10 +8,15 @@ export interface UseFocusTrapOptions {
     restoreFocus?: boolean;
     /** Focus the first focusable element on activate. */
     autoFocus?: boolean;
+    /**
+     * Checked on every Tab. While it returns false the trap leaves the key alone, so a trap stacked above
+     * this one (a dialog opened from inside the container) handles it. Defaults to always true.
+     */
+    isTopmost?: () => boolean;
 }
 /**
  * Confines Tab/Shift+Tab focus within `containerRef` while `active`.
  * Restores focus to the previously focused element on teardown.
  */
-export declare function useFocusTrap<T extends HTMLElement>(containerRef: RefObject<T>, { active, restoreFocus, autoFocus }: UseFocusTrapOptions): void;
+export declare function useFocusTrap<T extends HTMLElement>(containerRef: RefObject<T>, { active, restoreFocus, autoFocus, isTopmost }: UseFocusTrapOptions): void;
 export default useFocusTrap;

package/dist/hooks/useFocusTrap.js

@@ -1,39 +1,42 @@
-import { useRef as m, useEffect as p } from "react";
-const b = 'a[href],button:not([disabled]),textarea:not([disabled]),input:not([disabled]),select:not([disabled]),[tabindex]:not([tabindex="-1"])';
-function E(c, { active: s, restoreFocus: f = !0, autoFocus: l = !0 }) {
-  const r = m(null);
-  p(() => {
-    if (!s)
+import { useRef as y, useEffect as E } from "react";
+const v = 'a[href],button:not([disabled]),textarea:not([disabled]),input:not([disabled]),select:not([disabled]),[tabindex]:not([tabindex="-1"])';
+function D(s, { active: f, restoreFocus: l = !0, autoFocus: i = !0, isTopmost: a }) {
+  const u = y(null), d = y(a);
+  d.current = a, E(() => {
+    if (!f)
       return;
-    const t = c.current;
+    const t = s.current;
     if (!t)
       return;
-    r.current = document.activeElement;
-    const i = () => Array.from(t.querySelectorAll(b)).filter(
+    u.current = document.activeElement;
+    const m = () => Array.from(t.querySelectorAll(v)).filter(
       (e) => e.offsetParent !== null || e === document.activeElement
     );
-    if (l) {
-      const e = i()[0];
+    if (i && !t.contains(document.activeElement)) {
+      const e = m()[0];
       (e != null ? e : t).focus({ preventScroll: !0 });
     }
-    const a = (e) => {
+    const p = (e) => {
       if (e.key !== "Tab")
         return;
-      const n = i();
+      const b = d.current;
+      if (b && !b())
+        return;
+      const n = m();
       if (n.length === 0) {
-        e.preventDefault();
+        e.preventDefault(), t.focus({ preventScroll: !0 });
         return;
       }
-      const o = n[0], d = n[n.length - 1], u = document.activeElement;
-      e.shiftKey && u === o ? (e.preventDefault(), d.focus()) : !e.shiftKey && u === d ? (e.preventDefault(), o.focus()) : t.contains(u) || (e.preventDefault(), o.focus());
+      const r = n[0], c = n[n.length - 1], o = document.activeElement;
+      o === t ? (e.preventDefault(), (e.shiftKey ? c : r).focus()) : e.shiftKey && o === r ? (e.preventDefault(), c.focus()) : !e.shiftKey && o === c ? (e.preventDefault(), r.focus()) : t.contains(o) || (e.preventDefault(), r.focus());
     };
-    return document.addEventListener("keydown", a, !0), () => {
-      document.removeEventListener("keydown", a, !0), f && r.current && r.current.focus({ preventScroll: !0 });
+    return document.addEventListener("keydown", p, !0), () => {
+      document.removeEventListener("keydown", p, !0), l && u.current && u.current.focus({ preventScroll: !0 });
     };
-  }, [s, l, f, c]);
+  }, [f, i, l, s]);
 }
 export {
-  b as FOCUSABLE,
-  E as useFocusTrap
+  v as FOCUSABLE,
+  D as useFocusTrap
 };
 //# sourceMappingURL=useFocusTrap.js.map

package/dist/hooks/useFocusTrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFocusTrap.js","sources":["../../src/hooks/useFocusTrap.ts"],"sourcesContent":["import { RefObject, useEffect, useRef } from \"react\";\n\n/** Elements in the Tab order (hidden ones match too). */\nexport const FOCUSABLE =\n  'a[href],button:not([disabled]),textarea:not([disabled]),input:not([disabled]),select:not([disabled]),[tabindex]:not([tabindex=\"-1\"])';\n\nexport interface UseFocusTrapOptions {\n  /** Trap is active only while true. */\n  active: boolean;\n  /** Restore focus to the previously focused element on deactivate. */\n  restoreFocus?: boolean;\n  /** Focus the first focusable element on activate. */\n  autoFocus?: boolean;\n}\n\n/**\n * Confines Tab/Shift+Tab focus within `containerRef` while `active`.\n * Restores focus to the previously focused element on teardown.\n */\nexport function useFocusTrap<T extends HTMLElement>(\n  containerRef: RefObject<T>,\n  { active, restoreFocus = true, autoFocus = true }: UseFocusTrapOptions\n): void {\n  const prevFocused = useRef<HTMLElement | null>(null);\n\n  useEffect(() => {\n    if (!active) {\n      return;\n    }\n    const container = containerRef.current;\n    if (!container) {\n      return;\n    }\n\n    prevFocused.current = document.activeElement as HTMLElement | null;\n\n    const focusables = () =>\n      Array.from(container.querySelectorAll<HTMLElement>(FOCUSABLE)).filter(\n        (el) => el.offsetParent !== null || el === document.activeElement\n      );\n\n    if (autoFocus) {\n      const first = focusables()[0];\n      (first ?? container).focus({ preventScroll: true });\n    }\n\n    const onKeyDown = (event: KeyboardEvent) => {\n      if (event.key !== \"Tab\") {\n        return;\n      }\n      const items = focusables();\n      if (items.length === 0) {\n        event.preventDefault();\n        return;\n      }\n      const first = items[0];\n      const last = items[items.length - 1];\n      const activeEl = document.activeElement;\n\n      if (event.shiftKey && activeEl === first) {\n        event.preventDefault();\n        last.focus();\n      } else if (!event.shiftKey && activeEl === last) {\n        event.preventDefault();\n        first.focus();\n      } else if (!container.contains(activeEl)) {\n        event.preventDefault();\n        first.focus();\n      }\n    };\n\n    document.addEventListener(\"keydown\", onKeyDown, true);\n    return () => {\n      document.removeEventListener(\"keydown\", onKeyDown, true);\n      if (restoreFocus && prevFocused.current) {\n        prevFocused.current.focus({ preventScroll: true });\n      }\n    };\n  }, [active, autoFocus, restoreFocus, containerRef]);\n}\n\nexport default useFocusTrap;\n"],"names":["FOCUSABLE","useFocusTrap","containerRef","active","restoreFocus","autoFocus","prevFocused","useRef","useEffect","container","focusables","el","first","onKeyDown","event","items","last","activeEl"],"mappings":";AAGO,MAAMA,IACX;AAeK,SAASC,EACdC,GACA,EAAE,QAAAC,GAAQ,cAAAC,IAAe,IAAM,WAAAC,IAAY,MACrC;AACN,QAAMC,IAAcC,EAA2B,IAAI;AAEnD,EAAAC,EAAU,MAAM;AACd,QAAI,CAACL;AACH;AAEF,UAAMM,IAAYP,EAAa;AAC/B,QAAI,CAACO;AACH;AAGF,IAAAH,EAAY,UAAU,SAAS;AAE/B,UAAMI,IAAa,MACjB,MAAM,KAAKD,EAAU,iBAA8BT,CAAS,CAAC,EAAE;AAAA,MAC7D,CAACW,MAAOA,EAAG,iBAAiB,QAAQA,MAAO,SAAS;AAAA,IAAA;AAGxD,QAAIN,GAAW;AACb,YAAMO,IAAQF,EAAA,EAAa,CAAC;AAC5B,OAACE,KAAA,OAAAA,IAASH,GAAW,MAAM,EAAE,eAAe,IAAM;AAAA,IACpD;AAEA,UAAMI,IAAY,CAACC,MAAyB;AAC1C,UAAIA,EAAM,QAAQ;AAChB;AAEF,YAAMC,IAAQL,EAAA;AACd,UAAIK,EAAM,WAAW,GAAG;AACtB,QAAAD,EAAM,eAAA;AACN;AAAA,MACF;AACA,YAAMF,IAAQG,EAAM,CAAC,GACfC,IAAOD,EAAMA,EAAM,SAAS,CAAC,GAC7BE,IAAW,SAAS;AAE1B,MAAIH,EAAM,YAAYG,MAAaL,KACjCE,EAAM,eAAA,GACNE,EAAK,MAAA,KACI,CAACF,EAAM,YAAYG,MAAaD,KACzCF,EAAM,eAAA,GACNF,EAAM,MAAA,KACIH,EAAU,SAASQ,CAAQ,MACrCH,EAAM,eAAA,GACNF,EAAM,MAAA;AAAA,IAEV;AAEA,oBAAS,iBAAiB,WAAWC,GAAW,EAAI,GAC7C,MAAM;AACX,eAAS,oBAAoB,WAAWA,GAAW,EAAI,GACnDT,KAAgBE,EAAY,WAC9BA,EAAY,QAAQ,MAAM,EAAE,eAAe,IAAM;AAAA,IAErD;AAAA,EACF,GAAG,CAACH,GAAQE,GAAWD,GAAcF,CAAY,CAAC;AACpD;"}
+{"version":3,"file":"useFocusTrap.js","sources":["../../src/hooks/useFocusTrap.ts"],"sourcesContent":["import { RefObject, useEffect, useRef } from \"react\";\n\n/** Elements in the Tab order (hidden ones match too). */\nexport const FOCUSABLE =\n  'a[href],button:not([disabled]),textarea:not([disabled]),input:not([disabled]),select:not([disabled]),[tabindex]:not([tabindex=\"-1\"])';\n\nexport interface UseFocusTrapOptions {\n  /** Trap is active only while true. */\n  active: boolean;\n  /** Restore focus to the previously focused element on deactivate. */\n  restoreFocus?: boolean;\n  /** Focus the first focusable element on activate. */\n  autoFocus?: boolean;\n  /**\n   * Checked on every Tab. While it returns false the trap leaves the key alone, so a trap stacked above\n   * this one (a dialog opened from inside the container) handles it. Defaults to always true.\n   */\n  isTopmost?: () => boolean;\n}\n\n/**\n * Confines Tab/Shift+Tab focus within `containerRef` while `active`.\n * Restores focus to the previously focused element on teardown.\n */\nexport function useFocusTrap<T extends HTMLElement>(\n  containerRef: RefObject<T>,\n  { active, restoreFocus = true, autoFocus = true, isTopmost }: UseFocusTrapOptions\n): void {\n  const prevFocused = useRef<HTMLElement | null>(null);\n  // Read at key time, never as an effect dependency: an inline callback would re-arm the trap on every\n  // render and re-run `autoFocus`.\n  const isTopmostRef = useRef(isTopmost);\n  isTopmostRef.current = isTopmost;\n\n  useEffect(() => {\n    if (!active) {\n      return;\n    }\n    const container = containerRef.current;\n    if (!container) {\n      return;\n    }\n\n    prevFocused.current = document.activeElement as HTMLElement | null;\n\n    const focusables = () =>\n      Array.from(container.querySelectorAll<HTMLElement>(FOCUSABLE)).filter(\n        (el) => el.offsetParent !== null || el === document.activeElement\n      );\n\n    // A child that has already taken the focus (an `autoFocus` field, or one focusing itself in an\n    // effect) keeps it; the trap only brings in a focus that is still outside.\n    if (autoFocus && !container.contains(document.activeElement)) {\n      const first = focusables()[0];\n      (first ?? container).focus({ preventScroll: true });\n    }\n\n    const onKeyDown = (event: KeyboardEvent) => {\n      if (event.key !== \"Tab\") {\n        return;\n      }\n      const isTopmost = isTopmostRef.current;\n      if (isTopmost && !isTopmost()) {\n        return;\n      }\n      const items = focusables();\n      if (items.length === 0) {\n        event.preventDefault();\n        // Nothing left to tab through (e.g. every control disabled) and Chromium has dropped the\n        // focus to <body>: pull it back into the container instead of leaving it behind the dialog.\n        container.focus({ preventScroll: true });\n        return;\n      }\n      const first = items[0];\n      const last = items[items.length - 1];\n      const activeEl = document.activeElement;\n\n      if (activeEl === container) {\n        // The container itself holds the focus (a press on its empty area, or the `autoFocus`\n        // fallback): it is not a tab stop, so the browser would step to the page behind it.\n        event.preventDefault();\n        (event.shiftKey ? last : first).focus();\n      } else if (event.shiftKey && activeEl === first) {\n        event.preventDefault();\n        last.focus();\n      } else if (!event.shiftKey && activeEl === last) {\n        event.preventDefault();\n        first.focus();\n      } else if (!container.contains(activeEl)) {\n        event.preventDefault();\n        first.focus();\n      }\n    };\n\n    document.addEventListener(\"keydown\", onKeyDown, true);\n    return () => {\n      document.removeEventListener(\"keydown\", onKeyDown, true);\n      if (restoreFocus && prevFocused.current) {\n        prevFocused.current.focus({ preventScroll: true });\n      }\n    };\n  }, [active, autoFocus, restoreFocus, containerRef]);\n}\n\nexport default useFocusTrap;\n"],"names":["FOCUSABLE","useFocusTrap","containerRef","active","restoreFocus","autoFocus","isTopmost","prevFocused","useRef","isTopmostRef","useEffect","container","focusables","el","first","onKeyDown","event","items","last","activeEl"],"mappings":";AAGO,MAAMA,IACX;AAoBK,SAASC,EACdC,GACA,EAAE,QAAAC,GAAQ,cAAAC,IAAe,IAAM,WAAAC,IAAY,IAAM,WAAAC,KAC3C;AACN,QAAMC,IAAcC,EAA2B,IAAI,GAG7CC,IAAeD,EAAOF,CAAS;AACrC,EAAAG,EAAa,UAAUH,GAEvBI,EAAU,MAAM;AACd,QAAI,CAACP;AACH;AAEF,UAAMQ,IAAYT,EAAa;AAC/B,QAAI,CAACS;AACH;AAGF,IAAAJ,EAAY,UAAU,SAAS;AAE/B,UAAMK,IAAa,MACjB,MAAM,KAAKD,EAAU,iBAA8BX,CAAS,CAAC,EAAE;AAAA,MAC7D,CAACa,MAAOA,EAAG,iBAAiB,QAAQA,MAAO,SAAS;AAAA,IAAA;AAKxD,QAAIR,KAAa,CAACM,EAAU,SAAS,SAAS,aAAa,GAAG;AAC5D,YAAMG,IAAQF,EAAA,EAAa,CAAC;AAC5B,OAACE,KAAA,OAAAA,IAASH,GAAW,MAAM,EAAE,eAAe,IAAM;AAAA,IACpD;AAEA,UAAMI,IAAY,CAACC,MAAyB;AAC1C,UAAIA,EAAM,QAAQ;AAChB;AAEF,YAAMV,IAAYG,EAAa;AAC/B,UAAIH,KAAa,CAACA;AAChB;AAEF,YAAMW,IAAQL,EAAA;AACd,UAAIK,EAAM,WAAW,GAAG;AACtB,QAAAD,EAAM,eAAA,GAGNL,EAAU,MAAM,EAAE,eAAe,GAAA,CAAM;AACvC;AAAA,MACF;AACA,YAAMG,IAAQG,EAAM,CAAC,GACfC,IAAOD,EAAMA,EAAM,SAAS,CAAC,GAC7BE,IAAW,SAAS;AAE1B,MAAIA,MAAaR,KAGfK,EAAM,eAAA,IACLA,EAAM,WAAWE,IAAOJ,GAAO,MAAA,KACvBE,EAAM,YAAYG,MAAaL,KACxCE,EAAM,eAAA,GACNE,EAAK,MAAA,KACI,CAACF,EAAM,YAAYG,MAAaD,KACzCF,EAAM,eAAA,GACNF,EAAM,MAAA,KACIH,EAAU,SAASQ,CAAQ,MACrCH,EAAM,eAAA,GACNF,EAAM,MAAA;AAAA,IAEV;AAEA,oBAAS,iBAAiB,WAAWC,GAAW,EAAI,GAC7C,MAAM;AACX,eAAS,oBAAoB,WAAWA,GAAW,EAAI,GACnDX,KAAgBG,EAAY,WAC9BA,EAAY,QAAQ,MAAM,EAAE,eAAe,IAAM;AAAA,IAErD;AAAA,EACF,GAAG,CAACJ,GAAQE,GAAWD,GAAcF,CAAY,CAAC;AACpD;"}

package/dist/hooks/useKeyboardShortcut.d.ts

@@ -0,0 +1,30 @@
+export interface UseKeyboardShortcutOptions {
+    /** The shortcut in `Kbd` key names, e.g. `["Mod", "K"]` (Command on macOS, Ctrl elsewhere). */
+    keys: string[];
+    /** Runs on a matching keydown anywhere in the document; the event's default action is prevented. */
+    onTrigger: (event: KeyboardEvent) => void;
+    /** Listen only while true; `true` by default. */
+    enabled?: boolean;
+}
+/**
+ * Binds a global keyboard shortcut while the component is mounted — the Mod+K that opens a
+ * `CommandPalette`, or any other app-wide key. One `keydown` listener on the document, added while
+ * `enabled` and removed on cleanup; nothing runs on the server.
+ *
+ * An event another handler already used (`defaultPrevented`), a key repeat and an IME composition
+ * are ignored. On a match the default action is prevented first — Chrome and Firefox otherwise take
+ * Ctrl+K for their own search — and then `onTrigger` runs. Modifiers must match exactly, so Mod+K
+ * does not fire on Mod+Shift+K, and a single letter or digit also matches by `event.code`, so the
+ * shortcut keeps working on a keyboard layout that types other letters.
+ *
+ * `keys` and `onTrigger` are read when the event arrives, so a new function identity on each render
+ * never re-subscribes the listener.
+ *
+ * ```tsx
+ * const [open, setOpen] = useState(false);
+ * useKeyboardShortcut({ keys: ["Mod", "K"], onTrigger: () => setOpen((was) => !was) });
+ * <Kbd keys={["Mod", "K"]} />
+ * ```
+ */
+export declare function useKeyboardShortcut({ keys, onTrigger, enabled }: UseKeyboardShortcutOptions): void;
+export default useKeyboardShortcut;

package/dist/hooks/useKeyboardShortcut.js

@@ -0,0 +1,19 @@
+import { useRef as c, useEffect as f } from "react";
+import { matchesKeyboardShortcut as s } from "../utils/keyboardShortcut.js";
+function m({ keys: t, onTrigger: o, enabled: u = !0 }) {
+  const e = c({ keys: t, onTrigger: o });
+  e.current = { keys: t, onTrigger: o }, f(() => {
+    if (!u)
+      return;
+    const n = (r) => {
+      r.defaultPrevented || r.repeat || r.isComposing || r.keyCode === 229 || s(r, e.current.keys) && (r.preventDefault(), e.current.onTrigger(r));
+    };
+    return document.addEventListener("keydown", n), () => {
+      document.removeEventListener("keydown", n);
+    };
+  }, [u]);
+}
+export {
+  m as useKeyboardShortcut
+};
+//# sourceMappingURL=useKeyboardShortcut.js.map

package/dist/hooks/useKeyboardShortcut.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeyboardShortcut.js","sources":["../../src/hooks/useKeyboardShortcut.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\nimport { matchesKeyboardShortcut } from \"../utils/keyboardShortcut\";\n\nexport interface UseKeyboardShortcutOptions {\n  /** The shortcut in `Kbd` key names, e.g. `[\"Mod\", \"K\"]` (Command on macOS, Ctrl elsewhere). */\n  keys: string[];\n  /** Runs on a matching keydown anywhere in the document; the event's default action is prevented. */\n  onTrigger: (event: KeyboardEvent) => void;\n  /** Listen only while true; `true` by default. */\n  enabled?: boolean;\n}\n\n/**\n * Binds a global keyboard shortcut while the component is mounted — the Mod+K that opens a\n * `CommandPalette`, or any other app-wide key. One `keydown` listener on the document, added while\n * `enabled` and removed on cleanup; nothing runs on the server.\n *\n * An event another handler already used (`defaultPrevented`), a key repeat and an IME composition\n * are ignored. On a match the default action is prevented first — Chrome and Firefox otherwise take\n * Ctrl+K for their own search — and then `onTrigger` runs. Modifiers must match exactly, so Mod+K\n * does not fire on Mod+Shift+K, and a single letter or digit also matches by `event.code`, so the\n * shortcut keeps working on a keyboard layout that types other letters.\n *\n * `keys` and `onTrigger` are read when the event arrives, so a new function identity on each render\n * never re-subscribes the listener.\n *\n * ```tsx\n * const [open, setOpen] = useState(false);\n * useKeyboardShortcut({ keys: [\"Mod\", \"K\"], onTrigger: () => setOpen((was) => !was) });\n * <Kbd keys={[\"Mod\", \"K\"]} />\n * ```\n */\nexport function useKeyboardShortcut({ keys, onTrigger, enabled = true }: UseKeyboardShortcutOptions): void {\n  const latest = useRef({ keys, onTrigger });\n  latest.current = { keys, onTrigger };\n\n  useEffect(() => {\n    if (!enabled) {\n      return;\n    }\n    const onKeyDown = (event: KeyboardEvent) => {\n      if (event.defaultPrevented || event.repeat || event.isComposing || event.keyCode === 229) {\n        return;\n      }\n      if (!matchesKeyboardShortcut(event, latest.current.keys)) {\n        return;\n      }\n      event.preventDefault();\n      latest.current.onTrigger(event);\n    };\n    document.addEventListener(\"keydown\", onKeyDown);\n    return () => {\n      document.removeEventListener(\"keydown\", onKeyDown);\n    };\n  }, [enabled]);\n}\n\nexport default useKeyboardShortcut;\n"],"names":["useKeyboardShortcut","keys","onTrigger","enabled","latest","useRef","useEffect","onKeyDown","event","matchesKeyboardShortcut"],"mappings":";;AAgCO,SAASA,EAAoB,EAAE,MAAAC,GAAM,WAAAC,GAAW,SAAAC,IAAU,MAA0C;AACzG,QAAMC,IAASC,EAAO,EAAE,MAAAJ,GAAM,WAAAC,GAAW;AACzC,EAAAE,EAAO,UAAU,EAAE,MAAAH,GAAM,WAAAC,EAAA,GAEzBI,EAAU,MAAM;AACd,QAAI,CAACH;AACH;AAEF,UAAMI,IAAY,CAACC,MAAyB;AAC1C,MAAIA,EAAM,oBAAoBA,EAAM,UAAUA,EAAM,eAAeA,EAAM,YAAY,OAGhFC,EAAwBD,GAAOJ,EAAO,QAAQ,IAAI,MAGvDI,EAAM,eAAA,GACNJ,EAAO,QAAQ,UAAUI,CAAK;AAAA,IAChC;AACA,oBAAS,iBAAiB,WAAWD,CAAS,GACvC,MAAM;AACX,eAAS,oBAAoB,WAAWA,CAAS;AAAA,IACnD;AAAA,EACF,GAAG,CAACJ,CAAO,CAAC;AACd;"}