@ai-matrx/kit 0.7.4 → 0.9.0

package/dist/html-escape.d.cts

@@ -0,0 +1,40 @@
+/**
+ * @ai-matrx/kit/html-escape — ONE HTML escaper, with a decided character set.
+ *
+ * WHY THIS FILE EXISTS (2026-09-07 duplication census, row 14). Nine copies of
+ * `escapeHtml` were live across the fleet — six in matrx-frontend, one in
+ * matrx-extend, one in aidream's dashboard, and one private to
+ * `@ai-matrx/print/core` — and **they did not escape the same characters**.
+ * Three escaped only `& < >`; two added `"`; four added `'` (two as `&#39;`,
+ * two as `&#039;`). A string that is safe through one of them is an attribute
+ * break-out through another. That is not a style difference; it is a latent
+ * XSS class with nine independent chances to be wrong.
+ *
+ * The print package was the wrong owner (an HTML escaper must not require the
+ * print engine's `jspdf` + `html2canvas` graph), so it lives here, in the
+ * package with no sibling dependencies that everything can reach.
+ *
+ * THE DECIDED SET: `& < > " '` → `&amp; &lt; &gt; &quot; &#39;`.
+ *
+ * All five, always. Escaping the two quote characters is what makes the result
+ * safe to interpolate into an unquoted-or-quoted HTML *attribute*, not just
+ * into element text — and every caller that only escaped three was one
+ * refactor away from being an attribute caller. `'` uses the numeric `&#39;`
+ * rather than the named `&apos;`, which is XML, not HTML 4, and rather than
+ * `&#039;`, which is the same character with a pointless leading zero.
+ *
+ * WHAT THIS IS NOT. This escapes text for an HTML *document* context. It is
+ * not a sanitiser for untrusted HTML markup (use a real sanitiser), not a
+ * JavaScript-string escaper (a `</script>` inside a JSON blob needs
+ * `<`), and not a URL encoder.
+ */
+/**
+ * Escape `& < > " '` so `value` is safe as HTML element text or as the
+ * contents of a quoted HTML attribute.
+ *
+ * Non-string input returns the empty string rather than `"undefined"` — a
+ * literal "undefined" rendered into a page is a screen telling a lie.
+ */
+declare function escapeHtml(value: string | null | undefined): string;
+
+export { escapeHtml };

package/dist/html-escape.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @ai-matrx/kit/html-escape — ONE HTML escaper, with a decided character set.
+ *
+ * WHY THIS FILE EXISTS (2026-09-07 duplication census, row 14). Nine copies of
+ * `escapeHtml` were live across the fleet — six in matrx-frontend, one in
+ * matrx-extend, one in aidream's dashboard, and one private to
+ * `@ai-matrx/print/core` — and **they did not escape the same characters**.
+ * Three escaped only `& < >`; two added `"`; four added `'` (two as `&#39;`,
+ * two as `&#039;`). A string that is safe through one of them is an attribute
+ * break-out through another. That is not a style difference; it is a latent
+ * XSS class with nine independent chances to be wrong.
+ *
+ * The print package was the wrong owner (an HTML escaper must not require the
+ * print engine's `jspdf` + `html2canvas` graph), so it lives here, in the
+ * package with no sibling dependencies that everything can reach.
+ *
+ * THE DECIDED SET: `& < > " '` → `&amp; &lt; &gt; &quot; &#39;`.
+ *
+ * All five, always. Escaping the two quote characters is what makes the result
+ * safe to interpolate into an unquoted-or-quoted HTML *attribute*, not just
+ * into element text — and every caller that only escaped three was one
+ * refactor away from being an attribute caller. `'` uses the numeric `&#39;`
+ * rather than the named `&apos;`, which is XML, not HTML 4, and rather than
+ * `&#039;`, which is the same character with a pointless leading zero.
+ *
+ * WHAT THIS IS NOT. This escapes text for an HTML *document* context. It is
+ * not a sanitiser for untrusted HTML markup (use a real sanitiser), not a
+ * JavaScript-string escaper (a `</script>` inside a JSON blob needs
+ * `<`), and not a URL encoder.
+ */
+/**
+ * Escape `& < > " '` so `value` is safe as HTML element text or as the
+ * contents of a quoted HTML attribute.
+ *
+ * Non-string input returns the empty string rather than `"undefined"` — a
+ * literal "undefined" rendered into a page is a screen telling a lie.
+ */
+declare function escapeHtml(value: string | null | undefined): string;
+
+export { escapeHtml };

package/dist/html-escape.js

@@ -0,0 +1,17 @@
+// src/html-escape.ts
+var HTML_ESCAPES = {
+  "&": "&",
+  "<": "&lt;",
+  ">": "&gt;",
+  '"': "&quot;",
+  "'": "&#39;"
+};
+var HTML_ESCAPE_RE = /[&<>"']/g;
+function escapeHtml(value) {
+  if (typeof value !== "string") return "";
+  return value.replace(HTML_ESCAPE_RE, (char) => HTML_ESCAPES[char] ?? char);
+}
+export {
+  escapeHtml
+};
+//# sourceMappingURL=html-escape.js.map

package/dist/html-escape.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/html-escape.ts"],"sourcesContent":["/**\n * @ai-matrx/kit/html-escape — ONE HTML escaper, with a decided character set.\n *\n * WHY THIS FILE EXISTS (2026-09-07 duplication census, row 14). Nine copies of\n * `escapeHtml` were live across the fleet — six in matrx-frontend, one in\n * matrx-extend, one in aidream's dashboard, and one private to\n * `@ai-matrx/print/core` — and **they did not escape the same characters**.\n * Three escaped only `& < >`; two added `\"`; four added `'` (two as `&#39;`,\n * two as `&#039;`). A string that is safe through one of them is an attribute\n * break-out through another. That is not a style difference; it is a latent\n * XSS class with nine independent chances to be wrong.\n *\n * The print package was the wrong owner (an HTML escaper must not require the\n * print engine's `jspdf` + `html2canvas` graph), so it lives here, in the\n * package with no sibling dependencies that everything can reach.\n *\n * THE DECIDED SET: `& < > \" '` → `&amp; &lt; &gt; &quot; &#39;`.\n *\n * All five, always. Escaping the two quote characters is what makes the result\n * safe to interpolate into an unquoted-or-quoted HTML *attribute*, not just\n * into element text — and every caller that only escaped three was one\n * refactor away from being an attribute caller. `'` uses the numeric `&#39;`\n * rather than the named `&apos;`, which is XML, not HTML 4, and rather than\n * `&#039;`, which is the same character with a pointless leading zero.\n *\n * WHAT THIS IS NOT. This escapes text for an HTML *document* context. It is\n * not a sanitiser for untrusted HTML markup (use a real sanitiser), not a\n * JavaScript-string escaper (a `</script>` inside a JSON blob needs\n * `<`), and not a URL encoder.\n */\n\nconst HTML_ESCAPES: Readonly<Record<string, string>> = {\n  \"&\": \"&amp;\",\n  \"<\": \"&lt;\",\n  \">\": \"&gt;\",\n  '\"': \"&quot;\",\n  \"'\": \"&#39;\",\n};\n\nconst HTML_ESCAPE_RE = /[&<>\"']/g;\n\n/**\n * Escape `& < > \" '` so `value` is safe as HTML element text or as the\n * contents of a quoted HTML attribute.\n *\n * Non-string input returns the empty string rather than `\"undefined\"` — a\n * literal \"undefined\" rendered into a page is a screen telling a lie.\n */\nexport function escapeHtml(value: string | null | undefined): string {\n  if (typeof value !== \"string\") return \"\";\n  return value.replace(HTML_ESCAPE_RE, (char) => HTML_ESCAPES[char] ?? char);\n}\n"],"mappings":";AA+BA,IAAM,eAAiD;AAAA,EACrD,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AACP;AAEA,IAAM,iBAAiB;AAShB,SAAS,WAAW,OAA0C;AACnE,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,SAAO,MAAM,QAAQ,gBAAgB,CAAC,SAAS,aAAa,IAAI,KAAK,IAAI;AAC3E;","names":[]}

package/dist/index.cjs

@@ -31,8 +31,6 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
-  ConfirmDialog: () => ConfirmDialog,
-  ConfirmDialogHost: () => ConfirmDialogHost,
   DBStoreManager: () => DBStoreManager,
   DEFAULT_JSON_INDENT: () => DEFAULT_JSON_INDENT,
   DEFAULT_JSON_WIDTH: () => DEFAULT_JSON_WIDTH,
@@ -44,7 +42,6 @@ __export(src_exports, {
   captureDrafts: () => captureDrafts,
   commitUrlParams: () => commitUrlParams,
   computeSearchScore: () => computeSearchScore,
-  confirm: () => confirm,
   createColorNormalizer: () => createColorNormalizer,
   createFormatter: () => createFormatter,
   createMatrxToast: () => createMatrxToast,
@@ -925,320 +922,6 @@ function isLocalDraft(value) {
   return typeof d.key === "string" && typeof d.namespace === "string" && typeof d.entityId === "string" && typeof d.content === "string" && typeof d.capturedAt === "number";
 }
 
-// src/confirm/opener.ts
-var STATE_SLOT = /* @__PURE__ */ Symbol.for("ai-matrx.kit.confirm-opener-state");
-function getState() {
-  const holder = globalThis;
-  let state = holder[STATE_SLOT];
-  if (!state) {
-    state = { host: null, queue: [] };
-    holder[STATE_SLOT] = state;
-  }
-  return state;
-}
-function _registerHost(controller) {
-  const state = getState();
-  state.host = controller;
-  while (state.queue.length > 0) {
-    const next = state.queue.shift();
-    controller.show(next.opts, next.resolve);
-  }
-}
-function _unregisterHost(controller) {
-  const state = getState();
-  if (state.host === controller) state.host = null;
-}
-function confirm(opts) {
-  return new Promise((resolve) => {
-    const state = getState();
-    if (state.host) {
-      state.host.show(opts, resolve);
-    } else {
-      state.queue.push({ opts, resolve });
-    }
-  });
-}
-
-// src/confirm/host.tsx
-var React3 = __toESM(require("react"), 1);
-
-// src/confirm/cn.ts
-var import_tailwind_merge = require("tailwind-merge");
-function cn(...values) {
-  return (0, import_tailwind_merge.twMerge)(values.filter(Boolean).join(" "));
-}
-
-// src/confirm/alert-dialog.tsx
-var React2 = __toESM(require("react"), 1);
-var AlertDialogPrimitive = __toESM(require("@radix-ui/react-alert-dialog"), 1);
-
-// src/react-tree.ts
-var React = __toESM(require("react"), 1);
-var REACT_PORTAL_TYPE = /* @__PURE__ */ Symbol.for("react.portal");
-function treeContainsComponent(node, Component) {
-  if (node == null || typeof node === "boolean") return false;
-  if (Array.isArray(node)) {
-    return node.some((child) => treeContainsComponent(child, Component));
-  }
-  if (React.isValidElement(node)) {
-    if (node.type === Component) return true;
-    const props = node.props;
-    return props.children != null ? treeContainsComponent(props.children, Component) : false;
-  }
-  if (typeof node === "string" || typeof node === "number") return false;
-  if (typeof node === "object" && node.$$typeof === REACT_PORTAL_TYPE) {
-    return treeContainsComponent(
-      node.children,
-      Component
-    );
-  }
-  if (typeof node === "object" && Symbol.iterator in node) {
-    return Array.from(node).some(
-      (child) => treeContainsComponent(child, Component)
-    );
-  }
-  const runtimeProcess = globalThis.process;
-  if (runtimeProcess?.env?.NODE_ENV !== "production") {
-    const keys = typeof node === "object" ? ` with keys {${Object.keys(node).join(", ")}}` : "";
-    console.error(
-      `[treeContainsComponent] A non-renderable value${keys} is being passed as a React child. React will throw 'Objects are not valid as a React child' at the real render site. Stringify it (e.g. JSON.stringify) before rendering.`,
-      node
-    );
-  }
-  return false;
-}
-
-// src/confirm/alert-dialog.tsx
-var import_jsx_runtime = require("react/jsx-runtime");
-var buttonBase = "inline-flex cursor-pointer items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-all duration-200 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-0 disabled:pointer-events-none disabled:opacity-50 active:scale-[0.98] [&_svg]:pointer-events-none [&_svg]:size-4 [&_svg]:shrink-0 h-9 px-4 py-2";
-var buttonDefault = "bg-primary text-primary-foreground shadow-sm hover:bg-primary/90";
-var buttonOutline = "border border-border bg-card shadow-sm hover:bg-accent hover:text-accent-foreground";
-var AlertDialog = AlertDialogPrimitive.Root;
-var AlertDialogPortal = AlertDialogPrimitive.Portal;
-var AlertDialogOverlay = React2.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-  AlertDialogPrimitive.Overlay,
-  {
-    className: cn(
-      "fixed inset-0 z-[10000] bg-black/80 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0",
-      className
-    ),
-    ...props,
-    ref
-  }
-));
-AlertDialogOverlay.displayName = AlertDialogPrimitive.Overlay.displayName;
-var AlertDialogContentPrimitive = React2.forwardRef(({ ...props }, ref) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(AlertDialogPrimitive.Content, { ...props, ref, "aria-modal": "true" }));
-AlertDialogContentPrimitive.displayName = "AlertDialogContentPrimitive";
-var AlertDialogDescription = React2.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-  AlertDialogPrimitive.Description,
-  {
-    ref,
-    className: cn("text-sm text-muted-foreground", className),
-    ...props
-  }
-));
-AlertDialogDescription.displayName = AlertDialogPrimitive.Description.displayName;
-var AlertDialogContent = React2.forwardRef(({ className, children, container, ...props }, ref) => {
-  const hasDescription = treeContainsComponent(children, AlertDialogDescription) || treeContainsComponent(children, AlertDialogPrimitive.Description);
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(AlertDialogPortal, { container: container ?? void 0, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(AlertDialogOverlay, {}),
-    /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
-      AlertDialogContentPrimitive,
-      {
-        ref,
-        className: cn(
-          "fixed left-[50%] top-[50%] z-[10000] grid w-full max-w-lg translate-x-[-50%] translate-y-[-50%] gap-4 border bg-background p-6 shadow-lg duration-200 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[state=closed]:slide-out-to-left-1/2 data-[state=closed]:slide-out-to-top-[48%] data-[state=open]:slide-in-from-left-1/2 data-[state=open]:slide-in-from-top-[48%] sm:rounded-lg",
-          className
-        ),
-        ...props,
-        children: [
-          !hasDescription && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(AlertDialogPrimitive.Description, { className: "sr-only", children: "Please confirm the action described in this dialog." }),
-          children
-        ]
-      }
-    )
-  ] });
-});
-AlertDialogContent.displayName = AlertDialogPrimitive.Content.displayName;
-var AlertDialogHeader = ({
-  className,
-  ...props
-}) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-  "div",
-  {
-    className: cn(
-      "flex flex-col space-y-2 text-center sm:text-left",
-      className
-    ),
-    ...props
-  }
-);
-AlertDialogHeader.displayName = "AlertDialogHeader";
-var AlertDialogFooter = ({
-  className,
-  ...props
-}) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-  "div",
-  {
-    className: cn(
-      "flex flex-col-reverse sm:flex-row sm:justify-end sm:space-x-2",
-      className
-    ),
-    ...props
-  }
-);
-AlertDialogFooter.displayName = "AlertDialogFooter";
-var AlertDialogTitle = React2.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-  AlertDialogPrimitive.Title,
-  {
-    ref,
-    className: cn("text-lg font-semibold", className),
-    ...props
-  }
-));
-AlertDialogTitle.displayName = AlertDialogPrimitive.Title.displayName;
-var AlertDialogAction = React2.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-  AlertDialogPrimitive.Action,
-  {
-    ref,
-    className: cn(buttonBase, buttonDefault, className),
-    ...props
-  }
-));
-AlertDialogAction.displayName = AlertDialogPrimitive.Action.displayName;
-var AlertDialogCancel = React2.forwardRef(({ className, ...props }, ref) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-  AlertDialogPrimitive.Cancel,
-  {
-    ref,
-    className: cn(buttonBase, buttonOutline, "mt-2 sm:mt-0", className),
-    ...props
-  }
-));
-AlertDialogCancel.displayName = AlertDialogPrimitive.Cancel.displayName;
-
-// src/confirm/confirm-dialog.tsx
-var import_jsx_runtime2 = require("react/jsx-runtime");
-function SpinnerIcon({ className }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
-    "svg",
-    {
-      xmlns: "http://www.w3.org/2000/svg",
-      width: 24,
-      height: 24,
-      viewBox: "0 0 24 24",
-      fill: "none",
-      stroke: "currentColor",
-      strokeWidth: 2,
-      strokeLinecap: "round",
-      strokeLinejoin: "round",
-      "aria-hidden": "true",
-      className,
-      children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("path", { d: "M21 12a9 9 0 1 1-6.219-8.56" })
-    }
-  );
-}
-function ConfirmDialog({
-  open,
-  onOpenChange,
-  title,
-  description,
-  content,
-  contentClassName,
-  confirmLabel = "Confirm",
-  cancelLabel = "Cancel",
-  variant = "default",
-  busy = false,
-  confirmDisabled = false,
-  portalContainer,
-  onConfirm
-}) {
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(AlertDialog, { open, onOpenChange, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(
-    AlertDialogContent,
-    {
-      className: contentClassName,
-      container: portalContainer ?? void 0,
-      children: [
-        /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(AlertDialogHeader, { children: [
-          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(AlertDialogTitle, { children: title }),
-          description ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(AlertDialogDescription, { children: description }) : null
-        ] }),
-        content ?? null,
-        /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(AlertDialogFooter, { children: [
-          cancelLabel === null ? null : /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(AlertDialogCancel, { className: "max-lg:min-h-11", disabled: busy, children: cancelLabel }),
-          /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(
-            AlertDialogAction,
-            {
-              disabled: busy || confirmDisabled,
-              onClick: (event) => {
-                event.preventDefault();
-                void onConfirm();
-              },
-              className: cn(
-                "max-lg:min-h-11",
-                variant === "destructive" && "bg-destructive text-destructive-foreground hover:bg-destructive/90"
-              ),
-              children: [
-                busy ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(SpinnerIcon, { className: "mr-2 h-4 w-4 animate-spin" }) : null,
-                confirmLabel
-              ]
-            }
-          )
-        ] })
-      ]
-    }
-  ) });
-}
-
-// src/confirm/host.tsx
-var import_jsx_runtime3 = require("react/jsx-runtime");
-function ConfirmDialogHost() {
-  const [active, setActive] = React3.useState(null);
-  const [tick, setTick] = React3.useState(0);
-  const queueRef = React3.useRef([]);
-  React3.useEffect(() => {
-    const controller = {
-      show: (opts, resolve) => {
-        queueRef.current.push({ opts, resolve });
-        setTick((n) => n + 1);
-      }
-    };
-    _registerHost(controller);
-    return () => _unregisterHost(controller);
-  }, []);
-  React3.useEffect(() => {
-    if (active === null && queueRef.current.length > 0) {
-      setActive(queueRef.current.shift());
-    }
-  }, [active, tick]);
-  const handleConfirm = React3.useCallback(() => {
-    if (!active) return;
-    active.resolve(true);
-    setActive(null);
-  }, [active]);
-  const handleOpenChange = React3.useCallback(
-    (open) => {
-      if (!open && active) {
-        active.resolve(false);
-        setActive(null);
-      }
-    },
-    [active]
-  );
-  return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
-    ConfirmDialog,
-    {
-      open: !!active,
-      onOpenChange: handleOpenChange,
-      title: active?.opts.title ?? "",
-      description: active?.opts.description,
-      confirmLabel: active?.opts.confirmLabel,
-      cancelLabel: active?.opts.cancelLabel,
-      variant: active?.opts.variant,
-      onConfirm: handleConfirm
-    }
-  );
-}
-
 // src/toast.ts
 function messageText(message, data) {
   const description = data && typeof data.description === "string" ? data.description : "";
@@ -1289,13 +972,13 @@ function createMatrxToast({
 }
 
 // src/invalidation.ts
-var STATE_SLOT2 = /* @__PURE__ */ Symbol.for("ai-matrx.kit.invalidation-registry");
+var STATE_SLOT = /* @__PURE__ */ Symbol.for("ai-matrx.kit.invalidation-registry");
 function getCallbacks() {
   const holder = globalThis;
-  let state = holder[STATE_SLOT2];
+  let state = holder[STATE_SLOT];
   if (!state) {
     state = /* @__PURE__ */ new Map();
-    holder[STATE_SLOT2] = state;
+    holder[STATE_SLOT] = state;
   }
   return state;
 }
@@ -1749,10 +1432,10 @@ function formatJsonText(text, options) {
 }
 
 // src/idle-scheduler/scheduler.ts
-var STATE_SLOT3 = /* @__PURE__ */ Symbol.for("ai-matrx.kit.idle-scheduler-state");
-function getState2() {
+var STATE_SLOT2 = /* @__PURE__ */ Symbol.for("ai-matrx.kit.idle-scheduler-state");
+function getState() {
   const holder = globalThis;
-  let state = holder[STATE_SLOT3];
+  let state = holder[STATE_SLOT2];
   if (!state) {
     state = {
       queue: /* @__PURE__ */ new Map(),
@@ -1760,7 +1443,7 @@ function getState2() {
       cleanupFns: [],
       flushListeners: /* @__PURE__ */ new Set()
     };
-    holder[STATE_SLOT3] = state;
+    holder[STATE_SLOT2] = state;
     if (typeof window !== "undefined") {
       window.__idleSched = getSchedulerState;
     }
@@ -1768,7 +1451,7 @@ function getState2() {
   return state;
 }
 function registerIdleTask(key, priority, callback) {
-  const state = getState2();
+  const state = getState();
   if (state.flushState === "done") {
     scheduleImmediate(callback);
     return () => {
@@ -1783,7 +1466,7 @@ function registerIdleTask(key, priority, callback) {
   };
 }
 function onFlushComplete(listener) {
-  const state = getState2();
+  const state = getState();
   if (state.flushState === "done") {
     queueMicrotask(listener);
     return () => {
@@ -1816,7 +1499,7 @@ function whenPageIdle(signal) {
   });
 }
 function getSchedulerState() {
-  const state = getState2();
+  const state = getState();
   return {
     flushState: state.flushState,
     pendingCount: state.queue.size,
@@ -1824,7 +1507,7 @@ function getSchedulerState() {
   };
 }
 function resetScheduler() {
-  const state = getState2();
+  const state = getState();
   state.cleanupFns.forEach((fn) => fn());
   state.cleanupFns = [];
   state.queue.clear();
@@ -2284,25 +1967,25 @@ var FeatureStore = class extends PublicStoreManager {
 };
 
 // src/idb-store/singleton.ts
-var STATE_SLOT4 = /* @__PURE__ */ Symbol.for("ai-matrx.kit.idb-store-state");
-function getState3() {
+var STATE_SLOT3 = /* @__PURE__ */ Symbol.for("ai-matrx.kit.idb-store-state");
+function getState2() {
   const holder = globalThis;
-  let state = holder[STATE_SLOT4];
+  let state = holder[STATE_SLOT3];
   if (!state) {
     state = { instances: /* @__PURE__ */ new Map() };
-    holder[STATE_SLOT4] = state;
+    holder[STATE_SLOT3] = state;
   }
   return state;
 }
 function getIdbStoreSingleton(key, create) {
-  const state = getState3();
+  const state = getState2();
   if (!state.instances.has(key)) {
     state.instances.set(key, create());
   }
   return state.instances.get(key);
 }
 function _resetIdbStoreSingletons() {
-  getState3().instances.clear();
+  getState2().instances.clear();
 }
 
 // src/color-util/lab-delta.ts
@@ -3048,6 +2731,42 @@ function createColorNormalizer({ isValid }) {
   };
 }
 
+// src/react-tree.ts
+var React = __toESM(require("react"), 1);
+var REACT_PORTAL_TYPE = /* @__PURE__ */ Symbol.for("react.portal");
+function treeContainsComponent(node, Component) {
+  if (node == null || typeof node === "boolean") return false;
+  if (Array.isArray(node)) {
+    return node.some((child) => treeContainsComponent(child, Component));
+  }
+  if (React.isValidElement(node)) {
+    if (node.type === Component) return true;
+    const props = node.props;
+    return props.children != null ? treeContainsComponent(props.children, Component) : false;
+  }
+  if (typeof node === "string" || typeof node === "number") return false;
+  if (typeof node === "object" && node.$$typeof === REACT_PORTAL_TYPE) {
+    return treeContainsComponent(
+      node.children,
+      Component
+    );
+  }
+  if (typeof node === "object" && Symbol.iterator in node) {
+    return Array.from(node).some(
+      (child) => treeContainsComponent(child, Component)
+    );
+  }
+  const runtimeProcess = globalThis.process;
+  if (runtimeProcess?.env?.NODE_ENV !== "production") {
+    const keys = typeof node === "object" ? ` with keys {${Object.keys(node).join(", ")}}` : "";
+    console.error(
+      `[treeContainsComponent] A non-renderable value${keys} is being passed as a React child. React will throw 'Objects are not valid as a React child' at the real render site. Stringify it (e.g. JSON.stringify) before rendering.`,
+      node
+    );
+  }
+  return false;
+}
+
 // src/qr.ts
 var MAX_EDGE = 1600;
 function nativeDetector() {