@ai-matrx/summon 0.1.7 → 0.1.8

package/dist/react.cjs

@@ -21,7 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/react.ts
 var react_exports = {};
 __export(react_exports, {
-  CALLBACK_GROUP_KEY: () => CALLBACK_GROUP_KEY,
+  CALLBACK_GROUP_KEY: () => import_root9.CALLBACK_GROUP_KEY,
   DEFAULT_IMPORT_TIMEOUT_MS: () => DEFAULT_IMPORT_TIMEOUT_MS,
   DEFAULT_KEEP_ALIVE_LIMIT: () => DEFAULT_KEEP_ALIVE_LIMIT,
   DEFAULT_STALL_WARN_MS: () => DEFAULT_STALL_WARN_MS,
@@ -31,152 +31,50 @@ __export(react_exports, {
   OverlayLoadingFallback: () => OverlayLoadingFallback,
   SummonHost: () => SummonHost,
   SummonProvider: () => SummonProvider,
-  SummonStoreContext: () => SummonStoreContext,
+  SummonRoot: () => import_root10.SummonRoot,
+  SummonStoreContext: () => import_root.SummonStoreContext,
   chunkTimeoutError: () => chunkTimeoutError,
-  defineOverlay: () => defineOverlay,
+  configureSummonHost: () => import_root10.configureSummonHost,
+  defineOverlay: () => import_root9.defineOverlay,
+  emitOverlayEvent: () => emitOverlayEvent,
   normalizeOverlayError: () => normalizeOverlayError,
   useCloseOnNavigation: () => useCloseOnNavigation,
   useCloseOverlay: () => useCloseOverlay,
   useIsOverlayOpen: () => useIsOverlayOpen,
   useOpenOverlay: () => useOpenOverlay,
-  useOptionalOverlayInstance: () => useOptionalOverlayInstance,
-  useOptionalSummonPorts: () => useOptionalSummonPorts,
-  useOptionalSummonStore: () => useOptionalSummonStore,
-  useOverlayInstance: () => useOverlayInstance,
+  useOptionalOverlayInstance: () => import_root6.useOptionalOverlayInstance,
+  useOptionalSummonPorts: () => import_root3.useOptionalSummonPorts,
+  useOptionalSummonStore: () => import_root3.useOptionalSummonStore,
+  useOverlayInstance: () => import_root6.useOverlayInstance,
   useOverlayLink: () => useOverlayLink,
   useOverlayState: () => useOverlayState,
-  useSummonDispatch: () => useSummonDispatch,
-  useSummonPorts: () => useSummonPorts,
-  useSummonSelector: () => useSummonSelector,
-  useSummonStore: () => useSummonStore
+  useSummonDispatch: () => import_root3.useSummonDispatch,
+  useSummonPorts: () => import_root3.useSummonPorts,
+  useSummonSelector: () => import_root3.useSummonSelector,
+  useSummonStore: () => import_root3.useSummonStore
 });
 module.exports = __toCommonJS(react_exports);
 
 // src/react/SummonProvider.tsx
 var import_react5 = require("react");
-var import_react_redux2 = require("react-redux");
+var import_react_redux = require("react-redux");
+var import_summon = require("@ai-matrx/summon");
 var import_summon2 = require("@ai-matrx/summon");
-var import_summon3 = require("@ai-matrx/summon");
 
 // src/react/context.ts
 var import_react = require("react");
-var SummonStoreContext = (0, import_react.createContext)(null);
-SummonStoreContext.displayName = "SummonStoreContext";
-var SummonPortsContext = (0, import_react.createContext)(null);
-SummonPortsContext.displayName = "SummonPortsContext";
+var import_root = require("@ai-matrx/summon/root");
 var SummonConfigContext = (0, import_react.createContext)(null);
 SummonConfigContext.displayName = "SummonConfigContext";
 
 // src/react/fallbacks.tsx
-var import_react3 = require("react");
+var import_react4 = require("react");
 var import_design_system = require("@ai-matrx/design-system");
 
 // src/react/storeHooks.ts
-var import_react2 = require("react");
-var import_react_redux = require("react-redux");
-var import_summon = require("@ai-matrx/summon");
-var useSummonSelector = (0, import_react_redux.createSelectorHook)(SummonStoreContext).withTypes();
-var useSummonDispatch = (0, import_react_redux.createDispatchHook)(SummonStoreContext).withTypes();
-var useSummonStore = (0, import_react_redux.createStoreHook)(SummonStoreContext).withTypes();
-var MISSING_PROVIDER = "[summon] No <SummonProvider> above this component. Wrap the app (or the part that opens overlays) in <SummonProvider>.";
-function useSummonPorts() {
-  const ports = (0, import_react2.useContext)(SummonPortsContext);
-  if (!ports) throw new Error(MISSING_PROVIDER);
-  return ports;
-}
-function useOptionalSummonPorts() {
-  return (0, import_react2.useContext)(SummonPortsContext) ?? import_summon.DEFAULT_PORTS;
-}
-function useOptionalSummonStore() {
-  const context = (0, import_react2.useContext)(SummonStoreContext);
-  return context ? context.store : null;
-}
-function useSummonConfig() {
-  const config = (0, import_react2.useContext)(SummonConfigContext);
-  if (!config) throw new Error(MISSING_PROVIDER);
-  return config;
-}
-
-// src/react/fallbacks.tsx
-var import_jsx_runtime = require("react/jsx-runtime");
-function normalizeOverlayError(error) {
-  if (error instanceof Error) {
-    const isChunkLoadError = error.name === "ChunkLoadError" || /Loading chunk [\w-]+ failed|Failed to fetch dynamically imported module|Importing a module script failed/i.test(
-      error.message
-    );
-    return { name: error.name, message: error.message, stack: error.stack ?? null, isChunkLoadError };
-  }
-  return { name: "Error", message: typeof error === "string" ? error : String(error), stack: null, isChunkLoadError: false };
-}
-function OverlayLoadingFallback({ overlayId, label }) {
-  const ports = useSummonPorts();
-  const { stallWarnMs } = useSummonConfig();
-  (0, import_react3.useEffect)(() => {
-    const timer = setTimeout(() => {
-      ports.errors.capture(new Error(`Overlay "${overlayId}" still loading after ${stallWarnMs}ms`), {
-        stage: "overlay-load-stall",
-        overlayId,
-        level: "warning"
-      });
-    }, stallWarnMs);
-    return () => clearTimeout(timer);
-  }, [ports, overlayId, stallWarnMs]);
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "pointer-events-none fixed inset-0 z-[2147483000] flex items-center justify-center p-4", children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
-    "div",
-    {
-      role: "status",
-      "aria-label": `Loading ${label}`,
-      className: "pointer-events-auto flex items-center gap-3 rounded-xl border border-border bg-card px-5 py-4 text-sm text-muted-foreground shadow-[var(--elevation-2)]",
-      children: [
-        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { "aria-hidden": true, className: "size-4 animate-spin rounded-full border-2 border-border border-t-primary" }),
-        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { children: "Loading\u2026" })
-      ]
-    }
-  ) });
-}
-function OverlayErrorFallback({ label, error, retry, close, extras }) {
-  const e = normalizeOverlayError(error);
-  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "pointer-events-none fixed inset-0 z-[2147483001] flex items-center justify-center p-4", children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
-    "div",
-    {
-      role: "alertdialog",
-      "aria-label": `${label} failed to load`,
-      className: "pointer-events-auto flex max-h-[85dvh] w-full max-w-lg flex-col overflow-hidden rounded-xl border border-destructive bg-card shadow-[var(--elevation-3)]",
-      children: [
-        /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "border-b border-border px-5 py-4", children: [
-          /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("h2", { className: "text-sm font-semibold text-foreground", children: [
-            label,
-            " failed to load"
-          ] }),
-          /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { className: "mt-1 text-xs text-muted-foreground", children: e.isChunkLoadError ? "Part of it did not finish loading." : "It hit an error while rendering." })
-        ] }),
-        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "min-h-0 flex-1 overflow-auto px-5 py-4", children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "rounded-lg bg-muted px-3 py-2 font-mono text-xs text-foreground", children: [
-          /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "text-destructive", children: e.name }),
-          ": ",
-          e.message
-        ] }) }),
-        /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "flex items-center justify-between gap-2 border-t border-border px-5 py-3", children: [
-          /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { children: extras }),
-          /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "flex items-center gap-2", children: [
-            /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_design_system.Button, { variant: "ghost", size: "sm", onClick: close, children: "Close" }),
-            /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_design_system.Button, { variant: "primary", size: "sm", onClick: retry, children: "Try again" }),
-            /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
-              import_design_system.Button,
-              {
-                variant: "outline",
-                size: "sm",
-                onClick: () => {
-                  if (typeof window !== "undefined") window.location.reload();
-                },
-                children: "Reload page"
-              }
-            )
-          ] })
-        ] })
-      ]
-    }
-  ) });
-}
+var import_react3 = require("react");
+var import_root2 = require("@ai-matrx/summon/root");
+var import_global_slot = require("@ai-matrx/kit/global-slot");
 
 // src/react/keepAlive.ts
 var KeepAliveRegistry = class {
@@ -221,7 +119,7 @@ var KeepAliveRegistry = class {
 };
 
 // src/react/loaderCache.ts
-var import_react4 = require("react");
+var import_react2 = require("react");
 function chunkTimeoutError(key, timeoutMs) {
   const error = new Error(
     `Overlay "${key}" render module did not load within ${timeoutMs}ms. The import() did not resolve before the recovery timeout.`
@@ -246,7 +144,7 @@ var LoaderCache = class {
     this.options = options;
   }
   create(key, loader, attempt) {
-    const Component2 = (0, import_react4.lazy)(() => {
+    const Component2 = (0, import_react2.lazy)(() => {
       this.options.onImportStart?.(key, attempt);
       return raceTimeout(key, loader(), this.options.timeoutMs());
     });
@@ -269,11 +167,119 @@ var LoaderCache = class {
   }
 };
 
-// src/react/SummonProvider.tsx
-var import_jsx_runtime2 = require("react/jsx-runtime");
+// src/react/storeHooks.ts
+var import_root3 = require("@ai-matrx/summon/root");
 var DEFAULT_KEEP_ALIVE_LIMIT = 8;
 var DEFAULT_IMPORT_TIMEOUT_MS = 12e3;
 var DEFAULT_STALL_WARN_MS = 1e4;
+var hostConfigSlot = () => (0, import_global_slot.globalSlot)("ai-matrx.summon.hostReactConfig", () => ({ version: -1, config: null, keepAlive: null, loaders: null }));
+function hostReactConfig() {
+  const s = hostConfigSlot();
+  const version = (0, import_root2.getSummonHostVersion)();
+  if (s.config && s.version === version) return s.config;
+  const host = (0, import_root2.getSummonHostConfig)();
+  s.keepAlive ??= new KeepAliveRegistry(DEFAULT_KEEP_ALIVE_LIMIT);
+  s.loaders ??= new LoaderCache({ timeoutMs: () => DEFAULT_IMPORT_TIMEOUT_MS });
+  s.config = {
+    loadingFallback: OverlayLoadingFallback,
+    errorFallback: OverlayErrorFallback,
+    errorReportExtras: host.errorReportExtras ?? null,
+    renderWrapper: host.renderWrapper ?? null,
+    importTimeoutMs: DEFAULT_IMPORT_TIMEOUT_MS,
+    stallWarnMs: DEFAULT_STALL_WARN_MS,
+    keepAlive: s.keepAlive,
+    loaders: s.loaders
+  };
+  s.version = version;
+  return s.config;
+}
+function useSummonConfig() {
+  return (0, import_react3.useContext)(SummonConfigContext) ?? hostReactConfig();
+}
+
+// src/react/fallbacks.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+function normalizeOverlayError(error) {
+  if (error instanceof Error) {
+    const isChunkLoadError = error.name === "ChunkLoadError" || /Loading chunk [\w-]+ failed|Failed to fetch dynamically imported module|Importing a module script failed/i.test(
+      error.message
+    );
+    return { name: error.name, message: error.message, stack: error.stack ?? null, isChunkLoadError };
+  }
+  return { name: "Error", message: typeof error === "string" ? error : String(error), stack: null, isChunkLoadError: false };
+}
+function OverlayLoadingFallback({ overlayId, label }) {
+  const ports = (0, import_root3.useSummonPorts)();
+  const { stallWarnMs } = useSummonConfig();
+  (0, import_react4.useEffect)(() => {
+    const timer = setTimeout(() => {
+      ports.errors.capture(new Error(`Overlay "${overlayId}" still loading after ${stallWarnMs}ms`), {
+        stage: "overlay-load-stall",
+        overlayId,
+        level: "warning"
+      });
+    }, stallWarnMs);
+    return () => clearTimeout(timer);
+  }, [ports, overlayId, stallWarnMs]);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "pointer-events-none fixed inset-0 z-[2147483000] flex items-center justify-center p-4", children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+    "div",
+    {
+      role: "status",
+      "aria-label": `Loading ${label}`,
+      className: "pointer-events-auto flex items-center gap-3 rounded-xl border border-border bg-card px-5 py-4 text-sm text-muted-foreground shadow-[var(--elevation-2)]",
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { "aria-hidden": true, className: "size-4 animate-spin rounded-full border-2 border-border border-t-primary" }),
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { children: "Loading\u2026" })
+      ]
+    }
+  ) });
+}
+function OverlayErrorFallback({ label, error, retry, close, extras }) {
+  const e = normalizeOverlayError(error);
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "pointer-events-none fixed inset-0 z-[2147483001] flex items-center justify-center p-4", children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+    "div",
+    {
+      role: "alertdialog",
+      "aria-label": `${label} failed to load`,
+      className: "pointer-events-auto flex max-h-[85dvh] w-full max-w-lg flex-col overflow-hidden rounded-xl border border-destructive bg-card shadow-[var(--elevation-3)]",
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "border-b border-border px-5 py-4", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("h2", { className: "text-sm font-semibold text-foreground", children: [
+            label,
+            " failed to load"
+          ] }),
+          /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { className: "mt-1 text-xs text-muted-foreground", children: e.isChunkLoadError ? "Part of it did not finish loading." : "It hit an error while rendering." })
+        ] }),
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "min-h-0 flex-1 overflow-auto px-5 py-4", children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "rounded-lg bg-muted px-3 py-2 font-mono text-xs text-foreground", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { className: "text-destructive", children: e.name }),
+          ": ",
+          e.message
+        ] }) }),
+        /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "flex items-center justify-between gap-2 border-t border-border px-5 py-3", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { children: extras }),
+          /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "flex items-center gap-2", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_design_system.Button, { variant: "ghost", size: "sm", onClick: close, children: "Close" }),
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_design_system.Button, { variant: "primary", size: "sm", onClick: retry, children: "Try again" }),
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+              import_design_system.Button,
+              {
+                variant: "outline",
+                size: "sm",
+                onClick: () => {
+                  if (typeof window !== "undefined") window.location.reload();
+                },
+                children: "Reload page"
+              }
+            )
+          ] })
+        ] })
+      ]
+    }
+  ) });
+}
+
+// src/react/SummonProvider.tsx
+var import_jsx_runtime2 = require("react/jsx-runtime");
 function SummonProvider({
   store,
   ports,
@@ -285,8 +291,8 @@ function SummonProvider({
   stallWarnMs = DEFAULT_STALL_WARN_MS,
   children
 }) {
-  const resolvedPorts = (0, import_react5.useMemo)(() => (0, import_summon2.resolvePorts)(ports), [ports]);
-  const [privateStore] = (0, import_react5.useState)(() => store ? null : (0, import_summon3.createSummonStore)({ ports: resolvedPorts }));
+  const resolvedPorts = (0, import_react5.useMemo)(() => (0, import_summon.resolvePorts)(ports), [ports]);
+  const [privateStore] = (0, import_react5.useState)(() => store ? null : (0, import_summon2.createSummonStore)({ ports: resolvedPorts }));
   const activeStore = store ?? privateStore;
   const timeoutRef = (0, import_react5.useRef)(importTimeoutMs);
   timeoutRef.current = importTimeoutMs;
@@ -308,55 +314,58 @@ function SummonProvider({
     }),
     [loading, error, errorReportExtras, renderWrapper, importTimeoutMs, stallWarnMs, keepAlive, loaders]
   );
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react_redux2.Provider, { store: activeStore, context: SummonStoreContext, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(SummonPortsContext.Provider, { value: resolvedPorts, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(SummonConfigContext.Provider, { value: config, children }) }) });
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react_redux.Provider, { store: activeStore, context: import_root.SummonStoreContext, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_root.SummonPortsContext.Provider, { value: resolvedPorts, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(SummonConfigContext.Provider, { value: config, children }) }) });
 }
 
-// src/react/defineOverlay.tsx
-var import_react10 = require("react");
-var import_summon7 = require("@ai-matrx/summon");
-var import_summon8 = require("@ai-matrx/summon");
-
-// src/react/dispatchers.ts
-var import_summon4 = require("@ai-matrx/summon");
-var import_summon5 = require("@ai-matrx/summon");
-function newInstanceId(overlayId) {
-  return `${overlayId}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
-}
-function dispatchOpen(dispatch, overlayId, instanceId, data) {
-  dispatch(
-    (0, import_summon4.openOverlay)({
-      overlayId,
-      instanceId,
-      data: data ?? null
-    })
-  );
-}
-function dispatchClose(dispatch, overlayId, instanceId = import_summon5.DEFAULT_INSTANCE_ID) {
-  dispatch((0, import_summon4.closeOverlay)({ overlayId, instanceId }));
-}
+// src/react.ts
+var import_root9 = require("@ai-matrx/summon/root");
 
 // src/react/events.ts
 var import_handles = require("@ai-matrx/summon/handles");
-function openOverlayEventChannel(owner, getHandlers) {
-  const channel = (0, import_handles.createEventChannel)({ owner });
-  channel.subscribe((message) => {
-    const handlers = getHandlers();
-    handlers?.[message.type]?.(message.payload);
-  });
-  return channel.id;
-}
+var import_open = require("@ai-matrx/summon/open");
+var import_root4 = require("@ai-matrx/summon/root");
 function emitOverlayEvent(channelId, type, payload) {
+  (0, import_open.materializePendingChannels)(import_handles.createEventChannel);
   (0, import_handles.getEventChannel)(channelId)?.emit({ type, payload });
 }
+(0, import_root4.registerOverlayEmitter)(emitOverlayEvent);
+
+// src/react/SummonHost.tsx
+var import_react10 = require("react");
+var import_summon4 = require("@ai-matrx/summon");
+var import_summon5 = require("@ai-matrx/summon");
+var import_summon6 = require("@ai-matrx/summon");
+var import_summon7 = require("@ai-matrx/summon");
+var import_root7 = require("@ai-matrx/summon/root");
+
+// src/react/hostRenders.ts
+var import_react6 = require("react");
+var HostRendersContext = (0, import_react6.createContext)(null);
+var MISSING_RENDER_ERROR = "OverlayRenderMissingError";
+var missing = /* @__PURE__ */ new Map();
+function missingRenderLoader(overlayId) {
+  let loader = missing.get(overlayId);
+  if (!loader) {
+    const message = `Overlay "${overlayId}" is open but has no render module: its definition has no \`render\` and <SummonHost renders> has no "${overlayId}" entry.`;
+    loader = () => {
+      if (process.env.NODE_ENV !== "production") console.error(`[summon] ${message}`);
+      const error = new Error(message);
+      error.name = MISSING_RENDER_ERROR;
+      return Promise.reject(error);
+    };
+    missing.set(overlayId, loader);
+  }
+  return loader;
+}
 
 // src/react/instanceBody.tsx
 var import_react9 = require("react");
 
 // src/react/OverlayErrorBoundary.tsx
-var import_react6 = require("react");
+var import_react7 = require("react");
 var import_jsx_runtime3 = require("react/jsx-runtime");
 var CLEAR = { error: null, hasError: false, componentStack: null };
-var OverlayErrorBoundary = class extends import_react6.Component {
+var OverlayErrorBoundary = class extends import_react7.Component {
   state = CLEAR;
   static getDerivedStateFromError(error) {
     return { error, hasError: true };
@@ -401,32 +410,22 @@ var OverlayErrorBoundary = class extends import_react6.Component {
 };
 
 // src/react/instance.tsx
-var import_react7 = require("react");
-var import_summon6 = require("@ai-matrx/summon");
-var OverlayInstanceContext = (0, import_react7.createContext)(null);
-OverlayInstanceContext.displayName = "OverlayInstanceContext";
-function useOverlayInstance() {
-  const value = (0, import_react7.useContext)(OverlayInstanceContext);
-  if (!value) {
-    throw new Error("[summon] useOverlayInstance() was called outside a rendered overlay.");
-  }
-  return value;
-}
-function useOptionalOverlayInstance() {
-  return (0, import_react7.useContext)(OverlayInstanceContext);
-}
+var import_react8 = require("react");
+var import_summon3 = require("@ai-matrx/summon");
+var import_root5 = require("@ai-matrx/summon/root");
+var import_root6 = require("@ai-matrx/summon/root");
 function useOverlayState(name, initial) {
-  const { instanceKey } = useOverlayInstance();
-  const dispatch = useSummonDispatch();
-  const store = useSummonStore();
-  const stored = useSummonSelector((state) => (0, import_summon6.selectOverlayStateValue)(state, instanceKey, name));
+  const { instanceKey } = (0, import_root5.useOverlayInstance)();
+  const dispatch = (0, import_root3.useSummonDispatch)();
+  const store = (0, import_root3.useSummonStore)();
+  const stored = (0, import_root3.useSummonSelector)((state) => (0, import_summon3.selectOverlayStateValue)(state, instanceKey, name));
   const value = stored === void 0 ? initial : stored;
-  const setValue = (0, import_react7.useCallback)(
+  const setValue = (0, import_react8.useCallback)(
     (next) => {
-      const current = (0, import_summon6.selectOverlayStateValue)(store.getState(), instanceKey, name);
+      const current = (0, import_summon3.selectOverlayStateValue)(store.getState(), instanceKey, name);
       const previous = current === void 0 ? initial : current;
       const resolved = typeof next === "function" ? next(previous) : next;
-      dispatch((0, import_summon6.setOverlayStateValue)({ key: instanceKey, name, value: resolved }));
+      dispatch((0, import_summon3.setOverlayStateValue)({ key: instanceKey, name, value: resolved }));
     },
     // `initial` is the first-render default, like useState's; its identity never re-binds.
     // eslint-disable-next-line react-hooks/exhaustive-deps
@@ -435,26 +434,6 @@ function useOverlayState(name, initial) {
   return [value, setValue];
 }
 
-// src/react/hostRenders.ts
-var import_react8 = require("react");
-var HostRendersContext = (0, import_react8.createContext)(null);
-var MISSING_RENDER_ERROR = "OverlayRenderMissingError";
-var missing = /* @__PURE__ */ new Map();
-function missingRenderLoader(overlayId) {
-  let loader = missing.get(overlayId);
-  if (!loader) {
-    const message = `Overlay "${overlayId}" is open but has no render module: its definition has no \`render\` and <SummonHost renders> has no "${overlayId}" entry.`;
-    loader = () => {
-      if (process.env.NODE_ENV !== "production") console.error(`[summon] ${message}`);
-      const error = new Error(message);
-      error.name = MISSING_RENDER_ERROR;
-      return Promise.reject(error);
-    };
-    missing.set(overlayId, loader);
-  }
-  return loader;
-}
-
 // src/react/instanceBody.tsx
 var import_jsx_runtime4 = require("react/jsx-runtime");
 function LazyRender({ overlayId, instanceId, data, hidden, close, render, attemptRef }) {
@@ -467,7 +446,7 @@ function LazyRender({ overlayId, instanceId, data, hidden, close, render, attemp
 function createInstanceBody(overlayId, label, ownRender, parse, refusable) {
   function OverlayInstanceBody({ instanceId, instanceKey, data, hidden, close }) {
     const config = useSummonConfig();
-    const ports = useSummonPorts();
+    const ports = (0, import_root3.useSummonPorts)();
     const hostRenders = (0, import_react9.useContext)(HostRendersContext);
     const hostRender = ownRender ? void 0 : hostRenders?.[overlayId];
     const render = ownRender ?? hostRender ?? missingRenderLoader(overlayId);
@@ -515,110 +494,13 @@ function createInstanceBody(overlayId, label, ownRender, parse, refusable) {
         ) })
       }
     );
-    return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(OverlayInstanceContext.Provider, { value: instance, children: config.renderWrapper ? config.renderWrapper(body, context) : body });
+    return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_root6.OverlayInstanceContext.Provider, { value: instance, children: config.renderWrapper ? config.renderWrapper(body, context) : body });
   }
   OverlayInstanceBody.displayName = `Overlay(${overlayId})`;
   return (0, import_react9.memo)(OverlayInstanceBody);
 }
 
-// src/react/defineOverlay.tsx
-var CALLBACK_GROUP_KEY = "callbackGroupId";
-function openWith(dispatch, id, multi, options) {
-  const instanceId = options?.instanceId ?? (multi ? newInstanceId(id) : import_summon7.DEFAULT_INSTANCE_ID);
-  const key = (0, import_summon7.instanceKey)(id, instanceId);
-  const data = {};
-  const given = options?.data;
-  if (typeof given === "object" && given !== null) Object.assign(data, given);
-  const handlers = options?.handlers;
-  if (handlers) data[CALLBACK_GROUP_KEY] = openOverlayEventChannel(key, () => handlers);
-  dispatchOpen(dispatch, id, instanceId, data);
-  return { overlayId: id, instanceId, close: () => dispatchClose(dispatch, id, instanceId) };
-}
-function dataSignature(data) {
-  try {
-    return JSON.stringify(data, (_key, value) => typeof value === "function" ? void 0 : value);
-  } catch {
-    return String(Date.now());
-  }
-}
-function defineOverlay() {
-  return function define(spec) {
-    const id = spec.id;
-    const multi = spec.instance === "multi";
-    const parse = spec.parse ?? ((raw) => raw);
-    const Body = createInstanceBody(id, spec.label, spec.render, parse, spec.parse !== void 0);
-    const meta = spec;
-    function useSummon() {
-      const dispatch = useSummonDispatch();
-      return (0, import_react10.useCallback)((options) => openWith(dispatch, id, multi, options), [dispatch]);
-    }
-    function useIsOpen(instanceId = import_summon7.DEFAULT_INSTANCE_ID) {
-      return useSummonSelector((state) => (0, import_summon8.selectIsOverlayOpen)(state, id, instanceId));
-    }
-    function useClose() {
-      const dispatch = useSummonDispatch();
-      return (0, import_react10.useCallback)((instanceId) => dispatchClose(dispatch, id, instanceId ?? import_summon7.DEFAULT_INSTANCE_ID), [dispatch]);
-    }
-    function useEmit() {
-      const instance = useOptionalOverlayInstance();
-      const channelId = instance?.overlayId === id ? instance.rawData?.[CALLBACK_GROUP_KEY] : void 0;
-      return (0, import_react10.useCallback)(
-        (event, payload) => {
-          if (typeof channelId === "string") emitOverlayEvent(channelId, event, payload);
-        },
-        [channelId]
-      );
-    }
-    function Controller(props) {
-      const dispatch = useSummonDispatch();
-      const [ownInstanceId] = (0, import_react10.useState)(() => multi ? newInstanceId(id) : import_summon7.DEFAULT_INSTANCE_ID);
-      const instanceId = props.instanceId ?? ownInstanceId;
-      const handlersRef = (0, import_react10.useRef)(props.handlers);
-      handlersRef.current = props.handlers;
-      const hasHandlers = props.handlers !== void 0;
-      const data = (0, import_react10.useMemo)(() => {
-        const out = {};
-        for (const [key, value] of Object.entries(props)) {
-          if (key !== "instanceId" && key !== "handlers") out[key] = value;
-        }
-        return out;
-      }, [props]);
-      const signature = dataSignature(data);
-      const dataRef = (0, import_react10.useRef)(data);
-      dataRef.current = data;
-      (0, import_react10.useEffect)(() => {
-        const key = (0, import_summon7.instanceKey)(id, instanceId);
-        const open = { ...dataRef.current };
-        if (hasHandlers) open[CALLBACK_GROUP_KEY] = openOverlayEventChannel(key, () => handlersRef.current);
-        dispatchOpen(dispatch, id, instanceId, open);
-        return () => dispatchClose(dispatch, id, instanceId);
-      }, [dispatch, instanceId, signature, hasHandlers]);
-      return null;
-    }
-    Controller.displayName = `${id}Controller`;
-    return {
-      ...spec,
-      id,
-      label: spec.label,
-      instance: multi ? "multi" : "single",
-      keepAlive: spec.keepAlive ?? "none",
-      meta,
-      Body,
-      useSummon,
-      Controller,
-      useIsOpen,
-      useClose,
-      useEmit
-    };
-  };
-}
-
 // src/react/SummonHost.tsx
-var import_react11 = require("react");
-var import_summon9 = require("@ai-matrx/summon");
-var import_summon10 = require("@ai-matrx/summon");
-var import_summon11 = require("@ai-matrx/summon");
-var import_summon12 = require("@ai-matrx/summon");
 var import_jsx_runtime5 = require("react/jsx-runtime");
 function asRawData(data) {
   return typeof data === "object" && data !== null && !Array.isArray(data) ? data : null;
@@ -633,35 +515,46 @@ function sameInstances(a, b) {
   }
   return true;
 }
+var bodies = /* @__PURE__ */ new WeakMap();
+function bodyOf(definition) {
+  let body = bodies.get(definition);
+  if (!body) {
+    const parse = definition.parse ?? ((raw) => raw);
+    const render = definition.render;
+    body = createInstanceBody(definition.id, definition.label, render, parse, definition.parse !== void 0);
+    bodies.set(definition, body);
+  }
+  return body;
+}
 var NO_RETAINED = /* @__PURE__ */ new Map();
 function useCloseOnNavigation() {
-  const ports = useSummonPorts();
-  const dispatch = useSummonDispatch();
-  (0, import_react11.useEffect)(() => {
+  const ports = (0, import_root3.useSummonPorts)();
+  const dispatch = (0, import_root3.useSummonDispatch)();
+  (0, import_react10.useEffect)(() => {
     const router = ports.router;
     let previous = router.pathname();
     return router.subscribe(() => {
       const next = router.pathname();
       if (next === previous) return;
       previous = next;
-      const overlayIds = (0, import_summon11.overlayIdsBoundToPage)();
-      if (overlayIds.length > 0) dispatch((0, import_summon11.closeOverlaysBoundToPage)({ overlayIds }));
+      const overlayIds = (0, import_summon6.overlayIdsBoundToPage)();
+      if (overlayIds.length > 0) dispatch((0, import_summon6.closeOverlaysBoundToPage)({ overlayIds }));
     });
   }, [ports, dispatch]);
 }
-var InstanceSlot = (0, import_react11.memo)(function InstanceSlot2({ definition, instanceId, data, hidden }) {
-  const dispatch = useSummonDispatch();
-  const close = (0, import_react11.useCallback)(() => dispatchClose(dispatch, definition.id, instanceId), [dispatch, definition.id, instanceId]);
-  const Body = definition.Body;
-  return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Body, { instanceId, instanceKey: (0, import_summon12.instanceKey)(definition.id, instanceId), data, hidden, close });
+var InstanceSlot = (0, import_react10.memo)(function InstanceSlot2({ definition, instanceId, data, hidden }) {
+  const dispatch = (0, import_root3.useSummonDispatch)();
+  const close = (0, import_react10.useCallback)(() => (0, import_root7.dispatchClose)(dispatch, definition.id, instanceId), [dispatch, definition.id, instanceId]);
+  const Body = bodyOf(definition);
+  return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Body, { instanceId, instanceKey: (0, import_summon7.instanceKey)(definition.id, instanceId), data, hidden, close });
 });
-var DefinitionSlot = (0, import_react11.memo)(function DefinitionSlot2({ definition }) {
+var DefinitionSlot = (0, import_react10.memo)(function DefinitionSlot2({ definition }) {
   const { keepAlive } = useSummonConfig();
-  const dispatch = useSummonDispatch();
-  const open = useSummonSelector((state) => (0, import_summon11.selectOpenInstances)(state, definition.id), sameInstances);
+  const dispatch = (0, import_root3.useSummonDispatch)();
+  const open = (0, import_root3.useSummonSelector)((state) => (0, import_summon6.selectOpenInstances)(state, definition.id), sameInstances);
   const keepHidden = definition.keepAlive === "hidden";
-  const [retained, setRetained] = (0, import_react11.useState)(NO_RETAINED);
-  const [previousOpen, setPreviousOpen] = (0, import_react11.useState)(open);
+  const [retained, setRetained] = (0, import_react10.useState)(NO_RETAINED);
+  const [previousOpen, setPreviousOpen] = (0, import_react10.useState)(open);
   if (previousOpen !== open) {
     setPreviousOpen(open);
     if (keepHidden) {
@@ -674,16 +567,16 @@ var DefinitionSlot = (0, import_react11.memo)(function DefinitionSlot2({ definit
       setRetained(next);
     }
   }
-  const registered = (0, import_react11.useRef)(/* @__PURE__ */ new Set());
-  (0, import_react11.useEffect)(() => {
+  const registered = (0, import_react10.useRef)(/* @__PURE__ */ new Set());
+  (0, import_react10.useEffect)(() => {
     const seen = registered.current;
     for (const instanceId of retained.keys()) {
       if (seen.has(instanceId)) continue;
       seen.add(instanceId);
-      const key = (0, import_summon12.instanceKey)(definition.id, instanceId);
+      const key = (0, import_summon7.instanceKey)(definition.id, instanceId);
       keepAlive.retain(key, () => {
         seen.delete(instanceId);
-        (0, import_summon9.releaseOverlayInstance)(dispatch, key);
+        (0, import_summon4.releaseOverlayInstance)(dispatch, key);
         setRetained((current) => {
           if (!current.has(instanceId)) return current;
           const next = new Map(current);
@@ -695,16 +588,16 @@ var DefinitionSlot = (0, import_react11.memo)(function DefinitionSlot2({ definit
     for (const instanceId of [...seen]) {
       if (retained.has(instanceId)) continue;
       seen.delete(instanceId);
-      keepAlive.release((0, import_summon12.instanceKey)(definition.id, instanceId));
+      keepAlive.release((0, import_summon7.instanceKey)(definition.id, instanceId));
     }
   }, [retained, keepAlive, definition.id, dispatch]);
-  (0, import_react11.useEffect)(() => {
+  (0, import_react10.useEffect)(() => {
     const seen = registered.current;
     return () => {
       for (const instanceId of seen) {
-        const key = (0, import_summon12.instanceKey)(definition.id, instanceId);
+        const key = (0, import_summon7.instanceKey)(definition.id, instanceId);
         keepAlive.release(key);
-        (0, import_summon9.releaseOverlayInstance)(dispatch, key);
+        (0, import_summon4.releaseOverlayInstance)(dispatch, key);
       }
       seen.clear();
     };
@@ -714,67 +607,71 @@ var DefinitionSlot = (0, import_react11.memo)(function DefinitionSlot2({ definit
   for (const instance of open) {
     const node = /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(InstanceSlot, { definition, instanceId: instance.instanceId, data: asRawData(instance.data), hidden: false }, instance.instanceId);
     nodes.push(
-      keepHidden ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_react11.Activity, { mode: "visible", children: node }, instance.instanceId) : node
+      keepHidden ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_react10.Activity, { mode: "visible", children: node }, instance.instanceId) : node
     );
   }
   if (keepHidden) {
     for (const [instanceId, data] of retained) {
       nodes.push(
-        /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_react11.Activity, { mode: "hidden", children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(InstanceSlot, { definition, instanceId, data, hidden: true }, instanceId) }, instanceId)
+        /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_react10.Activity, { mode: "hidden", children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(InstanceSlot, { definition, instanceId, data, hidden: true }, instanceId) }, instanceId)
       );
     }
   }
   return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_jsx_runtime5.Fragment, { children: nodes });
 });
 function SummonHost({ definitions, renders }) {
-  const registeredFor = (0, import_react11.useRef)(null);
+  const registeredFor = (0, import_react10.useRef)(null);
   if (registeredFor.current !== definitions) {
-    (0, import_summon10.registerOverlayMeta)(definitions.map((definition) => definition.meta));
+    (0, import_summon5.registerOverlayMeta)(definitions.map((definition) => definition.meta));
     registeredFor.current = definitions;
   }
   useCloseOnNavigation();
   return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(HostRendersContext.Provider, { value: renders ?? null, children: definitions.map((definition) => /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(DefinitionSlot, { definition }, definition.id)) });
 }
 
+// src/react.ts
+var import_root10 = require("@ai-matrx/summon/root");
+
 // src/react/hooks.ts
-var import_react12 = require("react");
-var import_summon13 = require("@ai-matrx/summon");
-var import_summon14 = require("@ai-matrx/summon");
-var import_summon15 = require("@ai-matrx/summon");
-function useIsOverlayOpen(overlayId, instanceId = import_summon15.DEFAULT_INSTANCE_ID) {
-  return useSummonSelector((state) => (0, import_summon14.selectIsOverlayOpen)(state, overlayId, instanceId));
+var import_react11 = require("react");
+var import_summon8 = require("@ai-matrx/summon");
+var import_summon9 = require("@ai-matrx/summon");
+var import_summon10 = require("@ai-matrx/summon");
+var import_root8 = require("@ai-matrx/summon/root");
+function useIsOverlayOpen(overlayId, instanceId = import_summon10.DEFAULT_INSTANCE_ID) {
+  return (0, import_root3.useSummonSelector)((state) => (0, import_summon9.selectIsOverlayOpen)(state, overlayId, instanceId));
 }
 function useOpenOverlay(overlayId) {
-  const dispatch = useSummonDispatch();
-  return (0, import_react12.useCallback)(
+  const dispatch = (0, import_root3.useSummonDispatch)();
+  return (0, import_react11.useCallback)(
     (options) => {
-      const multi = (0, import_summon13.getOverlayMeta)(overlayId)?.instance === "multi";
-      const instanceId = options?.instanceId ?? (multi ? newInstanceId(overlayId) : import_summon15.DEFAULT_INSTANCE_ID);
-      dispatchOpen(dispatch, overlayId, instanceId, options?.data ?? null);
-      return { overlayId, instanceId, close: () => dispatchClose(dispatch, overlayId, instanceId) };
+      const multi = (0, import_summon8.getOverlayMeta)(overlayId)?.instance === "multi";
+      const instanceId = options?.instanceId ?? (multi ? (0, import_root8.newInstanceId)(overlayId) : import_summon10.DEFAULT_INSTANCE_ID);
+      (0, import_root8.dispatchOpen)(dispatch, overlayId, instanceId, options?.data ?? null);
+      return { overlayId, instanceId, close: () => (0, import_root8.dispatchClose)(dispatch, overlayId, instanceId) };
     },
     [dispatch, overlayId]
   );
 }
-function useCloseOverlay(overlayId, instanceId = import_summon15.DEFAULT_INSTANCE_ID) {
-  const dispatch = useSummonDispatch();
-  return (0, import_react12.useCallback)(() => dispatchClose(dispatch, overlayId, instanceId), [dispatch, overlayId, instanceId]);
+function useCloseOverlay(overlayId, instanceId = import_summon10.DEFAULT_INSTANCE_ID) {
+  const dispatch = (0, import_root3.useSummonDispatch)();
+  return (0, import_react11.useCallback)(() => (0, import_root8.dispatchClose)(dispatch, overlayId, instanceId), [dispatch, overlayId, instanceId]);
 }
 
 // src/react/useOverlayLink.ts
-var import_react13 = require("react");
-var import_summon16 = require("@ai-matrx/summon");
+var import_react12 = require("react");
+var import_summon11 = require("@ai-matrx/summon");
 function useOverlayLink(linkKey, id, args) {
-  const dispatch = useSummonDispatch();
+  const dispatch = (0, import_root3.useSummonDispatch)();
   const argsKey = args ? JSON.stringify(
     Object.keys(args).sort().map((k) => [k, args[k]])
   ) : "";
-  const stableArgs = (0, import_react13.useMemo)(() => args ? { ...args } : void 0, [argsKey]);
-  (0, import_react13.useEffect)(() => {
+  const stableArgs = (0, import_react12.useMemo)(() => args ? { ...args } : void 0, [argsKey]);
+  (0, import_react12.useEffect)(() => {
     if (!linkKey || !id) return void 0;
-    dispatch((0, import_summon16.registerSyncEntry)(stableArgs ? { typeKey: linkKey, instanceId: id, args: stableArgs } : { typeKey: linkKey, instanceId: id }));
+    dispatch((0, import_summon11.registerSyncEntry)(stableArgs ? { typeKey: linkKey, instanceId: id, args: stableArgs } : { typeKey: linkKey, instanceId: id }));
     return () => {
-      dispatch((0, import_summon16.unregisterSyncEntry)({ typeKey: linkKey, instanceId: id }));
+      dispatch((0, import_summon11.unregisterSyncEntry)({ typeKey: linkKey, instanceId: id }));
     };
   }, [dispatch, linkKey, id, stableArgs]);
 }