@smwb/ui-react 2.7.0 → 2.9.0

package/dist/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/utils/controlProps.d.ts

@@ -0,0 +1,16 @@
+import type React from "react";
+/** What an element is to the keyboard and to assistive tech. */
+export type ControlProps = Pick<React.HTMLAttributes<HTMLElement>, "role" | "tabIndex" | "onFocus" | "onBlur"> & React.AriaAttributes;
+/**
+ * Splits the caller's props of a component whose root is a box around its
+ * control and other content beside it: a card's button and its footer or
+ * corner slots, a chip's button and its delete button.
+ *
+ * What the component is to the keyboard and to assistive tech goes to the
+ * control, the element that takes focus: `role`, `tabIndex`, `onFocus`,
+ * `onBlur` and the `aria-*` attributes. The rest stays on the box, and so does
+ * `aria-hidden`, which hides the whole component. While `toControl` is false
+ * (the component is not a control, e.g. a card without `onClick`), all of them
+ * stay on the box.
+ */
+export declare function splitControlProps<T extends object>(props: T, toControl?: boolean): [ControlProps, T];

package/dist/utils/controlProps.js

@@ -0,0 +1,14 @@
+function u(o) {
+  return o === "role" || o === "tabIndex" || o === "onFocus" || o === "onBlur" || o.startsWith("aria-") && o !== "aria-hidden";
+}
+function c(o, i = !0) {
+  if (!i) return [{}, o];
+  const t = {}, r = {};
+  for (const [n, s] of Object.entries(o))
+    (u(n) ? t : r)[n] = s;
+  return [t, r];
+}
+export {
+  c as splitControlProps
+};
+//# sourceMappingURL=controlProps.js.map

package/dist/utils/controlProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controlProps.js","sources":["../../src/utils/controlProps.ts"],"sourcesContent":["import type React from \"react\";\n\n/** What an element is to the keyboard and to assistive tech. */\nexport type ControlProps = Pick<React.HTMLAttributes<HTMLElement>, \"role\" | \"tabIndex\" | \"onFocus\" | \"onBlur\"> &\n  React.AriaAttributes;\n\nfunction isControlProp(key: string): boolean {\n  return (\n    key === \"role\" ||\n    key === \"tabIndex\" ||\n    key === \"onFocus\" ||\n    key === \"onBlur\" ||\n    (key.startsWith(\"aria-\") && key !== \"aria-hidden\")\n  );\n}\n\n/**\n * Splits the caller's props of a component whose root is a box around its\n * control and other content beside it: a card's button and its footer or\n * corner slots, a chip's button and its delete button.\n *\n * What the component is to the keyboard and to assistive tech goes to the\n * control, the element that takes focus: `role`, `tabIndex`, `onFocus`,\n * `onBlur` and the `aria-*` attributes. The rest stays on the box, and so does\n * `aria-hidden`, which hides the whole component. While `toControl` is false\n * (the component is not a control, e.g. a card without `onClick`), all of them\n * stay on the box.\n */\nexport function splitControlProps<T extends object>(props: T, toControl = true): [ControlProps, T] {\n  if (!toControl) return [{}, props];\n  const control: Record<string, unknown> = {};\n  const box: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(props)) {\n    (isControlProp(key) ? control : box)[key] = value;\n  }\n  return [control, box as T];\n}\n"],"names":["isControlProp","key","splitControlProps","props","toControl","control","box","value"],"mappings":"AAMA,SAASA,EAAcC,GAAsB;AAC3C,SACEA,MAAQ,UACRA,MAAQ,cACRA,MAAQ,aACRA,MAAQ,YACPA,EAAI,WAAW,OAAO,KAAKA,MAAQ;AAExC;AAcO,SAASC,EAAoCC,GAAUC,IAAY,IAAyB;AACjG,MAAI,CAACA,EAAW,QAAO,CAAC,CAAA,GAAID,CAAK;AACjC,QAAME,IAAmC,CAAA,GACnCC,IAA+B,CAAA;AACrC,aAAW,CAACL,GAAKM,CAAK,KAAK,OAAO,QAAQJ,CAAK;AAC7C,KAACH,EAAcC,CAAG,IAAII,IAAUC,GAAKL,CAAG,IAAIM;AAE9C,SAAO,CAACF,GAASC,CAAQ;AAC3B;"}

package/dist/utils/keyboardShortcut.d.ts

@@ -0,0 +1,12 @@
+import { type KbdPlatform } from "../components/dataDisplay/kbd/kbdKeys";
+type ShortcutEvent = Pick<KeyboardEvent, "key" | "code" | "ctrlKey" | "metaKey" | "altKey" | "shiftKey">;
+/**
+ * Whether a keyboard event is the shortcut `keys` (in `Kbd` key names, e.g. `["Mod", "K"]`).
+ * `Mod` is Meta on `mac` and Ctrl elsewhere. The modifiers must match exactly, so Mod+K does not
+ * match Mod+Shift+K. The list needs exactly one key that is not a modifier. It is compared with
+ * `event.key` ignoring case; a single ASCII letter or digit also matches `event.code`
+ * (`KeyK`, `Digit1`), so a shortcut keeps working on a layout that types other letters.
+ * `platform` is the running browser's by default.
+ */
+export declare function matchesKeyboardShortcut(event: ShortcutEvent, keys: string[], platform?: KbdPlatform): boolean;
+export {};

package/dist/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/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/utils/linkAttrs.d.ts

@@ -0,0 +1,13 @@
+/** Where a link opens unless its `target` says otherwise. */
+export declare const DEFAULT_LINK_TARGET = "_blank";
+/**
+ * The `target` attribute for a link: `undefined` (not given) keeps `"_blank"`, `null` (or an
+ * empty string) leaves the attribute out so the link opens in place, any other string is used as is.
+ */
+export declare function resolveLinkTarget(target: string | null | undefined): string | undefined;
+/**
+ * The `rel` attribute for a link: the caller's wins (an empty string drops it), `undefined` keeps the
+ * default. The default is `"noreferrer"` for a link that opens another browsing context (a new tab or
+ * a named window), which also implies `noopener`, and none for a link that opens in place.
+ */
+export declare function resolveLinkRel(rel: string | undefined, target: string | undefined): string | undefined;

package/dist/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/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/utils/overlayLayer.d.ts

@@ -1,13 +1,25 @@
 /** Attribute marking the root of a portaled overlay layer (modal, sheet wrapper, dropdown, …). */
 export declare const OVERLAY_LAYER_ATTR = "data-smwb-overlay-layer";
 /**
- * True when `event` happened inside an overlay layer that does NOT contain
- * `node` — i.e. `node` sits underneath that layer, so the interaction is not
- * a "click away" from `node`.
+ * True when `event` happened inside an overlay layer above `node`, so the
+ * interaction is not a "click away" from `node`. A layer is above `node` when it
+ * comes later in document order (portaled after it, as everything opened from
+ * inside `node` is) or sits inside it. A layer that holds `node` or comes before
+ * it is below: a click in the Modal a select menu was opened from is a click away
+ * from the menu.
  */
 export declare const isEventInForeignOverlay: (event: Event, node: Element) => boolean;
 /**
  * True when `el` belongs to the topmost open overlay layer (or no layers are
  * open). Used to make Escape close only the top layer instead of every layer.
+ * A layer inside `el`, such as a select menu rendered into a Modal through
+ * `menuContainer`, is above `el` rather than part of it.
  */
 export declare const isTopOverlayLayer: (el: Element | null | undefined) => boolean;
+/**
+ * True when an open overlay layer other than `el` sits above it: inside it, or
+ * later in document order (portaled after it). FloatingWindow and the fullscreen
+ * ExpansionPanel leave Escape to such a layer, e.g. a select menu opened from
+ * inside them. Layers earlier in document order are below `el`.
+ */
+export declare const hasOverlayLayerAbove: (el: Element | null | undefined) => boolean;

package/dist/utils/overlayLayer.js

@@ -1,11 +1,18 @@
-const e = "data-smwb-overlay-layer", r = () => typeof document == "undefined" ? [] : Array.from(document.querySelectorAll(`[${e}]`)), a = (n, o) => typeof n.composedPath != "function" ? !1 : n.composedPath().some((t) => t instanceof Element && t.hasAttribute(e) && !t.contains(o)), s = (n) => {
-  if (!n) return !0;
-  const o = r(), t = o[o.length - 1];
-  return !t || t === n || t.contains(n) || n.contains(t);
-};
+const r = "data-smwb-overlay-layer", s = () => typeof document == "undefined" ? [] : Array.from(document.querySelectorAll(`[${r}]`)), a = (o, e) => {
+  if (typeof o.composedPath != "function") return !1;
+  const t = Node.DOCUMENT_POSITION_FOLLOWING | Node.DOCUMENT_POSITION_DISCONNECTED;
+  return o.composedPath().some(
+    (n) => n instanceof Element && n.hasAttribute(r) && (e.compareDocumentPosition(n) & t) !== 0
+  );
+}, c = (o) => {
+  if (!o) return !0;
+  const e = s(), t = e[e.length - 1];
+  return !t || t === o || t.contains(o);
+}, O = (o) => !o || !o.isConnected ? !1 : s().some((e) => (o.compareDocumentPosition(e) & Node.DOCUMENT_POSITION_FOLLOWING) !== 0);
 export {
-  e as OVERLAY_LAYER_ATTR,
+  r as OVERLAY_LAYER_ATTR,
+  O as hasOverlayLayerAbove,
   a as isEventInForeignOverlay,
-  s as isTopOverlayLayer
+  c as isTopOverlayLayer
 };
 //# sourceMappingURL=overlayLayer.js.map

package/dist/utils/overlayLayer.js.map

@@ -1 +1 @@
-{"version":3,"file":"overlayLayer.js","sources":["../../src/utils/overlayLayer.ts"],"sourcesContent":["/** Attribute marking the root of a portaled overlay layer (modal, sheet wrapper, dropdown, …). */\nexport const OVERLAY_LAYER_ATTR = \"data-smwb-overlay-layer\";\n\n/** All open overlay layers in document order (last = topmost). */\nconst overlayLayers = (): Element[] =>\n  typeof document === \"undefined\" ? [] : Array.from(document.querySelectorAll(`[${OVERLAY_LAYER_ATTR}]`));\n\n/**\n * True when `event` happened inside an overlay layer that does NOT contain\n * `node` — i.e. `node` sits underneath that layer, so the interaction is not\n * a \"click away\" from `node`.\n */\nexport const isEventInForeignOverlay = (event: Event, node: Element): boolean => {\n  if (typeof event.composedPath !== \"function\") return false;\n  return event\n    .composedPath()\n    .some((el) => el instanceof Element && el.hasAttribute(OVERLAY_LAYER_ATTR) && !el.contains(node));\n};\n\n/**\n * True when `el` belongs to the topmost open overlay layer (or no layers are\n * open). Used to make Escape close only the top layer instead of every layer.\n */\nexport const isTopOverlayLayer = (el: Element | null | undefined): boolean => {\n  if (!el) return true;\n  const all = overlayLayers();\n  const top = all[all.length - 1];\n  return !top || top === el || top.contains(el) || el.contains(top);\n};\n"],"names":["OVERLAY_LAYER_ATTR","overlayLayers","isEventInForeignOverlay","event","node","el","isTopOverlayLayer","all","top"],"mappings":"AACO,MAAMA,IAAqB,2BAG5BC,IAAgB,MACpB,OAAO,YAAa,cAAc,CAAA,IAAK,MAAM,KAAK,SAAS,iBAAiB,IAAID,CAAkB,GAAG,CAAC,GAO3FE,IAA0B,CAACC,GAAcC,MAChD,OAAOD,EAAM,gBAAiB,aAAmB,KAC9CA,EACJ,aAAA,EACA,KAAK,CAACE,MAAOA,aAAc,WAAWA,EAAG,aAAaL,CAAkB,KAAK,CAACK,EAAG,SAASD,CAAI,CAAC,GAOvFE,IAAoB,CAACD,MAA4C;AAC5E,MAAI,CAACA,EAAI,QAAO;AAChB,QAAME,IAAMN,EAAA,GACNO,IAAMD,EAAIA,EAAI,SAAS,CAAC;AAC9B,SAAO,CAACC,KAAOA,MAAQH,KAAMG,EAAI,SAASH,CAAE,KAAKA,EAAG,SAASG,CAAG;AAClE;"}
+{"version":3,"file":"overlayLayer.js","sources":["../../src/utils/overlayLayer.ts"],"sourcesContent":["/** Attribute marking the root of a portaled overlay layer (modal, sheet wrapper, dropdown, …). */\nexport const OVERLAY_LAYER_ATTR = \"data-smwb-overlay-layer\";\n\n/** All open overlay layers in document order (last = topmost). */\nconst overlayLayers = (): Element[] =>\n  typeof document === \"undefined\" ? [] : Array.from(document.querySelectorAll(`[${OVERLAY_LAYER_ATTR}]`));\n\n/**\n * True when `event` happened inside an overlay layer above `node`, so the\n * interaction is not a \"click away\" from `node`. A layer is above `node` when it\n * comes later in document order (portaled after it, as everything opened from\n * inside `node` is) or sits inside it. A layer that holds `node` or comes before\n * it is below: a click in the Modal a select menu was opened from is a click away\n * from the menu.\n */\nexport const isEventInForeignOverlay = (event: Event, node: Element): boolean => {\n  if (typeof event.composedPath !== \"function\") return false;\n  // A layer detached during the dispatch can't be ranked; it counts as above.\n  const above = Node.DOCUMENT_POSITION_FOLLOWING | Node.DOCUMENT_POSITION_DISCONNECTED;\n  return event\n    .composedPath()\n    .some(\n      (el) =>\n        el instanceof Element && el.hasAttribute(OVERLAY_LAYER_ATTR) && (node.compareDocumentPosition(el) & above) !== 0\n    );\n};\n\n/**\n * True when `el` belongs to the topmost open overlay layer (or no layers are\n * open). Used to make Escape close only the top layer instead of every layer.\n * A layer inside `el`, such as a select menu rendered into a Modal through\n * `menuContainer`, is above `el` rather than part of it.\n */\nexport const isTopOverlayLayer = (el: Element | null | undefined): boolean => {\n  if (!el) return true;\n  const all = overlayLayers();\n  const top = all[all.length - 1];\n  return !top || top === el || top.contains(el);\n};\n\n/**\n * True when an open overlay layer other than `el` sits above it: inside it, or\n * later in document order (portaled after it). FloatingWindow and the fullscreen\n * ExpansionPanel leave Escape to such a layer, e.g. a select menu opened from\n * inside them. Layers earlier in document order are below `el`.\n */\nexport const hasOverlayLayerAbove = (el: Element | null | undefined): boolean => {\n  if (!el || !el.isConnected) return false;\n  return overlayLayers().some((layer) => (el.compareDocumentPosition(layer) & Node.DOCUMENT_POSITION_FOLLOWING) !== 0);\n};\n"],"names":["OVERLAY_LAYER_ATTR","overlayLayers","isEventInForeignOverlay","event","node","above","el","isTopOverlayLayer","all","top","hasOverlayLayerAbove","layer"],"mappings":"AACO,MAAMA,IAAqB,2BAG5BC,IAAgB,MACpB,OAAO,YAAa,cAAc,CAAA,IAAK,MAAM,KAAK,SAAS,iBAAiB,IAAID,CAAkB,GAAG,CAAC,GAU3FE,IAA0B,CAACC,GAAcC,MAA2B;AAC/E,MAAI,OAAOD,EAAM,gBAAiB,WAAY,QAAO;AAErD,QAAME,IAAQ,KAAK,8BAA8B,KAAK;AACtD,SAAOF,EACJ,eACA;AAAA,IACC,CAACG,MACCA,aAAc,WAAWA,EAAG,aAAaN,CAAkB,MAAMI,EAAK,wBAAwBE,CAAE,IAAID,OAAW;AAAA,EAAA;AAEvH,GAQaE,IAAoB,CAACD,MAA4C;AAC5E,MAAI,CAACA,EAAI,QAAO;AAChB,QAAME,IAAMP,EAAA,GACNQ,IAAMD,EAAIA,EAAI,SAAS,CAAC;AAC9B,SAAO,CAACC,KAAOA,MAAQH,KAAMG,EAAI,SAASH,CAAE;AAC9C,GAQaI,IAAuB,CAACJ,MAC/B,CAACA,KAAM,CAACA,EAAG,cAAoB,KAC5BL,EAAA,EAAgB,KAAK,CAACU,OAAWL,EAAG,wBAAwBK,CAAK,IAAI,KAAK,iCAAiC,CAAC;"}

package/dist/utils/ownClick.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Whether a click belongs to the control that listens for it on a wrapper (a
+ * sortable header, a selectable card) rather than to something inside it.
+ *
+ * The control must match `INTERACTIVE` itself (`role="button"`, `tabindex`), and
+ * then a click is its own when it is the nearest match from the click's target
+ * up, and no handler has prevented the click's default yet. So a click in a
+ * nested control is that control's, and so is a click in a portal rendered
+ * inside: React delivers it to the wrapper, though it landed outside.
+ *
+ * The control is the element that listens (`currentTarget`), unless the caller
+ * passes another: a box that holds a control and other content beside it (a
+ * card's button and its corner slots) listens for both. A click on that content
+ * is then the control's too, unless it lands in a control of its own there.
+ */
+export declare function isOwnClick(event: Pick<Event, "target" | "currentTarget" | "defaultPrevented">, control?: Element | null): boolean;

package/dist/utils/ownClick.js

@@ -0,0 +1,40 @@
+const a = [
+  "a[href]",
+  "button",
+  "input",
+  "select",
+  "textarea",
+  "label",
+  "summary",
+  "[tabindex]",
+  "[contenteditable]:not([contenteditable='false'])",
+  ...[
+    "button",
+    "link",
+    "checkbox",
+    "radio",
+    "switch",
+    "textbox",
+    "searchbox",
+    "combobox",
+    "spinbutton",
+    "slider",
+    "menuitem",
+    "menuitemcheckbox",
+    "menuitemradio",
+    "option",
+    "tab"
+  ].map((t) => `[role='${t}']`)
+].join(",");
+function c(t, r = t.currentTarget) {
+  var i;
+  if (t.defaultPrevented) return !1;
+  const e = t.target, o = (i = e == null ? void 0 : e.closest(a)) != null ? i : null;
+  if (o !== null && o === r) return !0;
+  const n = t.currentTarget;
+  return r === n || !e || !(n != null && n.contains(e)) ? !1 : !(o && n.contains(o));
+}
+export {
+  c as isOwnClick
+};
+//# sourceMappingURL=ownClick.js.map

package/dist/utils/ownClick.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownClick.js","sources":["../../src/utils/ownClick.ts"],"sourcesContent":["/**\n * Whatever takes a click of its own: a native control or link, a label,\n * anything focusable, a widget role, editable content.\n */\nconst INTERACTIVE = [\n  \"a[href]\",\n  \"button\",\n  \"input\",\n  \"select\",\n  \"textarea\",\n  \"label\",\n  \"summary\",\n  \"[tabindex]\",\n  \"[contenteditable]:not([contenteditable='false'])\",\n  ...[\n    \"button\",\n    \"link\",\n    \"checkbox\",\n    \"radio\",\n    \"switch\",\n    \"textbox\",\n    \"searchbox\",\n    \"combobox\",\n    \"spinbutton\",\n    \"slider\",\n    \"menuitem\",\n    \"menuitemcheckbox\",\n    \"menuitemradio\",\n    \"option\",\n    \"tab\",\n  ].map((role) => `[role='${role}']`),\n].join(\",\");\n\n/**\n * Whether a click belongs to the control that listens for it on a wrapper (a\n * sortable header, a selectable card) rather than to something inside it.\n *\n * The control must match `INTERACTIVE` itself (`role=\"button\"`, `tabindex`), and\n * then a click is its own when it is the nearest match from the click's target\n * up, and no handler has prevented the click's default yet. So a click in a\n * nested control is that control's, and so is a click in a portal rendered\n * inside: React delivers it to the wrapper, though it landed outside.\n *\n * The control is the element that listens (`currentTarget`), unless the caller\n * passes another: a box that holds a control and other content beside it (a\n * card's button and its corner slots) listens for both. A click on that content\n * is then the control's too, unless it lands in a control of its own there.\n */\nexport function isOwnClick(\n  event: Pick<Event, \"target\" | \"currentTarget\" | \"defaultPrevented\">,\n  control: Element | null = event.currentTarget as Element | null\n): boolean {\n  if (event.defaultPrevented) return false;\n  const target = event.target as Element | null;\n  const nearest = target?.closest(INTERACTIVE) ?? null;\n  if (nearest !== null && nearest === control) return true;\n  const box = event.currentTarget as Element | null;\n  if (control === box || !target || !box?.contains(target)) return false;\n  return !(nearest && box.contains(nearest));\n}\n"],"names":["INTERACTIVE","role","isOwnClick","event","control","_a","target","nearest","box"],"mappings":"AAIA,MAAMA,IAAc;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AAAA,IACD;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA,EACA,IAAI,CAACC,MAAS,UAAUA,CAAI,IAAI;AACpC,EAAE,KAAK,GAAG;AAiBH,SAASC,EACdC,GACAC,IAA0BD,EAAM,eACvB;AA/CX,MAAAE;AAgDE,MAAIF,EAAM,iBAAkB,QAAO;AACnC,QAAMG,IAASH,EAAM,QACfI,KAAUF,IAAAC,KAAA,gBAAAA,EAAQ,QAAQN,OAAhB,OAAAK,IAAgC;AAChD,MAAIE,MAAY,QAAQA,MAAYH,EAAS,QAAO;AACpD,QAAMI,IAAML,EAAM;AAClB,SAAIC,MAAYI,KAAO,CAACF,KAAU,EAACE,KAAA,QAAAA,EAAK,SAASF,MAAgB,KAC1D,EAAEC,KAAWC,EAAI,SAASD,CAAO;AAC1C;"}

package/dist/utils/readOnlyToggle.d.ts

@@ -0,0 +1,15 @@
+import type React from "react";
+/**
+ * Call from the input's `onClick`. Cancels the click on an uncontrolled input; the browser then
+ * restores its previous state, and re-checks the radio that was checked before.
+ */
+export declare function cancelToggle(event: React.MouseEvent<HTMLInputElement>, checked: boolean | null | undefined): void;
+/**
+ * Call from the input's `onChange`. React has recorded the toggled state of an uncontrolled input,
+ * and the browser puts the old one back after the cancelled click without React noticing; React
+ * would then take the next real change for no change and skip `onChange`. Record the old state
+ * instead: set it through the input's own `checked` (the property React watches), then put the
+ * toggled one back through the prototype's setter, which React doesn't watch, so the input stays
+ * as it is until the browser restores it.
+ */
+export declare function forgetCancelledToggle(event: React.ChangeEvent<HTMLInputElement>, checked: boolean | null | undefined): void;

package/dist/utils/readOnlyToggle.js

@@ -0,0 +1,14 @@
+function r(e, t) {
+  t == null && e.preventDefault();
+}
+function g(e, t) {
+  var l, o;
+  if (t != null) return;
+  const c = e.currentTarget, n = c.checked;
+  c.checked = !n, (o = (l = Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, "checked")) == null ? void 0 : l.set) == null || o.call(c, n);
+}
+export {
+  r as cancelToggle,
+  g as forgetCancelledToggle
+};
+//# sourceMappingURL=readOnlyToggle.js.map

package/dist/utils/readOnlyToggle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readOnlyToggle.js","sources":["../../src/utils/readOnlyToggle.ts"],"sourcesContent":["import type React from \"react\";\n\n// `readonly` means nothing to a checkbox or radio input: a click on it or on its label, Space, and\n// the arrow keys in a radio group still toggle it, each through a click on the input. Checkbox,\n// RadioButton and Toggle call these two while read-only.\n//\n// A controlled input (`checked` given) needs neither: after every click React puts it back to\n// `checked`, and the rest of its named radio group to theirs. Cancelling the click as well would\n// give the last word to the browser, which restores the state from before the click even when the\n// click changed `checked` (say, a row that selects itself on click).\n\n/**\n * Call from the input's `onClick`. Cancels the click on an uncontrolled input; the browser then\n * restores its previous state, and re-checks the radio that was checked before.\n */\nexport function cancelToggle(event: React.MouseEvent<HTMLInputElement>, checked: boolean | null | undefined): void {\n  if (checked == null) event.preventDefault();\n}\n\n/**\n * Call from the input's `onChange`. React has recorded the toggled state of an uncontrolled input,\n * and the browser puts the old one back after the cancelled click without React noticing; React\n * would then take the next real change for no change and skip `onChange`. Record the old state\n * instead: set it through the input's own `checked` (the property React watches), then put the\n * toggled one back through the prototype's setter, which React doesn't watch, so the input stays\n * as it is until the browser restores it.\n */\nexport function forgetCancelledToggle(\n  event: React.ChangeEvent<HTMLInputElement>,\n  checked: boolean | null | undefined\n): void {\n  if (checked != null) return;\n  const input = event.currentTarget;\n  const toggled = input.checked;\n  input.checked = !toggled;\n  Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, \"checked\")?.set?.call(input, toggled);\n}\n"],"names":["cancelToggle","event","checked","forgetCancelledToggle","_a","_b","input","toggled"],"mappings":"AAeO,SAASA,EAAaC,GAA2CC,GAA2C;AACjH,EAAIA,KAAW,QAAMD,EAAM,eAAA;AAC7B;AAUO,SAASE,EACdF,GACAC,GACM;AAfD,MAAAE,GAAAC;AAgBL,MAAIH,KAAW,KAAM;AACrB,QAAMI,IAAQL,EAAM,eACdM,IAAUD,EAAM;AACtB,EAAAA,EAAM,UAAU,CAACC,IACjBF,KAAAD,IAAA,OAAO,yBAAyB,iBAAiB,WAAW,SAAS,MAArE,gBAAAA,EAAwE,QAAxE,QAAAC,EAA6E,KAAKC,GAAOC;AAC3F;"}

package/dist/utils/restoreFocus.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Hands focus back to `opener`, the element that had it when an overlay opened, once the
+ * overlay `root` closes. Focus the app moved elsewhere on purpose stays where it is: it
+ * is restored only while it is still inside `root` or has been dropped on the body (the
+ * root is gone, or the element that had it was removed). An opener that left the document
+ * is skipped, and one that cannot take focus (disabled, hidden) simply ignores the call.
+ */
+export declare function restoreFocus(opener: Element | null, root: Element | null | undefined): void;

package/dist/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/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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@smwb/ui-react",
   "main": "./dist/index.cjs",
-  "version": "2.7.0",
+  "version": "2.9.0",
   "license": "MIT",
   "engines": {
     "node": ">=20"
@@ -14,7 +14,7 @@
     "test": "npm run lint && npm run jest",
     "jest": "vitest run",
     "test:storybook": "test-storybook --url http://127.0.0.1:6006",
-    "test:storybook:ci": "concurrently -k -s first -n \"SB,TEST\" -c \"magenta,blue\" \"npm run build-storybook -- --quiet && npx http-server storybook-static --port 6006 --silent\" \"npx wait-on tcp:6006 && npm run test:storybook\"",
+    "test:storybook:ci": "node ../../scripts/storybook-test-ci.mjs",
     "eject": "react-scripts eject",
     "lint": "eslint . --max-warnings=0",
     "prettier:check": "npx prettier --check .",
@@ -44,6 +44,7 @@
     "clsx": "^2.1.1",
     "react-transition-group": "^4.4.5",
     "rifm": "^0.12.1",
+    "uqr": "^0.1.3",
     "uuid": "^11.1.1",
     "zod": "^4.4.3"
   },
@@ -52,7 +53,7 @@
     "@babel/preset-typescript": "^7.28.5",
     "@chromatic-com/storybook": "^5.2.1",
     "@eslint/js": "^10.0.1",
-    "@smwb/ui-styles": "^1.5.0",
+    "@smwb/ui-styles": "^2.0.0",
     "@storybook/addon-docs": "^10.4.0",
     "@storybook/addon-links": "^10.4.0",
     "@storybook/react": "^10.4.0",
@@ -80,6 +81,7 @@
     "globals": "^17.6.0",
     "http-server": "^14.1.1",
     "jsdom": "^26.1.0",
+    "jsqr": "^1.4.0",
     "less": "^4.6.4",
     "path-browserify": "^1.0.1",
     "playwright": "^1.60.0",