@ai-matrx/summon 0.1.16 → 0.1.18

package/dist/open.js

@@ -1,185 +1,74 @@
-// src/core/types.ts
-var DEFAULT_INSTANCE_ID = "default";
-function instanceKey(overlayId, instanceId = DEFAULT_INSTANCE_ID) {
-  return `${overlayId}:${instanceId}`;
-}
-function parseInstanceKey(key) {
-  const at = key.indexOf(":");
-  if (at <= 0 || at === key.length - 1) return null;
-  return { overlayId: key.slice(0, at), instanceId: key.slice(at + 1) };
-}
-function defaultWindowIdFor(meta) {
-  return meta.window?.windowId ?? meta.id;
-}
-
-// src/core/ports.ts
-var noop = () => {
-};
-var anonymousIdentity = {
-  current: () => ({ key: "anonymous", ready: true }),
-  subscribe: () => noop
-};
-var locationRouter = {
-  pathname: () => typeof window === "undefined" ? "/" : window.location.pathname,
-  search: () => typeof window === "undefined" ? "" : window.location.search,
-  replaceSearch: (nextSearch) => {
-    if (typeof window === "undefined") return;
-    const query = nextSearch && !nextSearch.startsWith("?") ? `?${nextSearch}` : nextSearch;
-    const url = `${window.location.pathname}${query}${window.location.hash}`;
-    window.history.replaceState(window.history.state, "", url);
-  },
-  subscribe: (listener) => {
-    if (typeof window === "undefined") return noop;
-    window.addEventListener("popstate", listener);
-    return () => window.removeEventListener("popstate", listener);
-  }
-};
-var consoleNotify = {
-  info: (message) => console.info(`[summon] ${message}`),
-  warn: (message) => console.warn(`[summon] ${message}`),
-  error: (message) => console.error(`[summon] ${message}`)
-};
-var consoleErrorSink = {
-  capture: (error, context) => console.error("[summon]", error, context)
-};
-var debugOff = { enabled: () => false };
-var DEFAULT_PORTS = {
-  identity: anonymousIdentity,
-  router: locationRouter,
-  notify: consoleNotify,
-  errors: consoleErrorSink,
-  debug: debugOff,
-  persistence: null
-};
-function resolvePorts(overrides) {
-  return { ...DEFAULT_PORTS, ...overrides };
-}
-
-// src/core/registry.ts
-import { globalSlot } from "@ai-matrx/kit/global-slot";
-var state = () => globalSlot("ai-matrx.summon.registry", () => ({
-  byId: /* @__PURE__ */ new Map(),
-  byLinkKey: /* @__PURE__ */ new Map(),
-  listeners: /* @__PURE__ */ new Set()
-}));
-function registerOverlayMeta(definitions) {
-  const s = state();
-  for (const def of definitions) {
-    s.byId.set(def.id, def);
-    const keys = def.link ? [def.link.key, ...def.link.aliases ?? []] : [];
-    for (const key of keys) {
-      const holder = s.byLinkKey.get(key);
-      if (holder && holder.id !== def.id) {
-        throw new Error(`[summon] link key "${key}" is claimed by both "${holder.id}" and "${def.id}"`);
-      }
-      s.byLinkKey.set(key, def);
-    }
-  }
-  for (const listener of s.listeners) listener();
-}
-function getOverlayMeta(overlayId) {
-  return state().byId.get(overlayId);
-}
-function getOverlayMetaByLinkKey(linkKey) {
-  return state().byLinkKey.get(linkKey);
-}
-function allOverlayMeta() {
-  return [...state().byId.values()];
-}
-function isRegisteredOverlay(overlayId) {
-  return state().byId.has(overlayId);
-}
-function subscribeToOverlayRegistry(listener) {
-  const s = state();
-  s.listeners.add(listener);
-  return () => s.listeners.delete(listener);
-}
-function resetOverlayRegistry() {
-  const s = state();
-  s.byId.clear();
-  s.byLinkKey.clear();
-}
-
-// src/open/actions.ts
-function creator(type, build) {
-  const create = (...args) => ({ type, payload: build(...args) });
-  return Object.assign(create, {
-    type,
-    toString: () => type,
-    match: (action) => typeof action === "object" && action !== null && action.type === type
-  });
-}
-function isPlainRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function stripFunctions(overlayId, data) {
-  if (!isPlainRecord(data)) return data;
-  const offenders = Object.keys(data).filter((key) => typeof data[key] === "function");
-  if (offenders.length === 0) return data;
-  console.error(
-    `[summon] BUG: function value(s) in openOverlay data for "${overlayId}" (keys: ${offenders.join(", ")}). Functions cannot travel through Redux \u2014 the handler would NEVER fire. Register a handle (@ai-matrx/summon/handles) and pass its id string instead. The offending key(s) were stripped from state.`
-  );
-  const cleaned = { ...data };
-  for (const key of offenders) delete cleaned[key];
-  return cleaned;
-}
-function rawOpen(payload) {
-  const raw = { overlayId: payload.overlayId };
-  if (payload.instanceId !== void 0) raw.instanceId = payload.instanceId;
-  if (payload.data !== void 0) raw.data = stripFunctions(payload.overlayId, payload.data);
-  const defaults = getOverlayMeta(payload.overlayId)?.defaults;
-  if (isPlainRecord(defaults)) raw.defaults = stripFunctions(payload.overlayId, defaults);
-  return raw;
-}
-var O = "overlays/";
-var openOverlay = creator(O + "openOverlay", (payload) => rawOpen(payload));
-var closeOverlay = creator(
-  O + "closeOverlay",
-  (payload) => payload.instanceId === void 0 ? { overlayId: payload.overlayId } : { overlayId: payload.overlayId, instanceId: payload.instanceId }
-);
-var toggleOverlay = creator(O + "toggleOverlay", (payload) => rawOpen(payload));
-var closeAllInstancesOfOverlay = creator(O + "closeAllInstancesOfOverlay", (payload) => ({
-  overlayId: payload.overlayId
-}));
-function overlayIdsBoundToPage() {
-  return allOverlayMeta().filter((meta) => meta.closesOnNavigation === true).map((meta) => meta.id);
-}
-var closeOverlaysBoundToPage = creator(
-  O + "closeOverlaysBoundToPage",
-  (payload) => ({
-    overlayIds: [...payload?.overlayIds ?? overlayIdsBoundToPage()]
-  })
-);
-var closeAllOverlays = creator(O + "closeAllOverlays", () => void 0);
-var pruneStaleInstances = creator(O + "pruneStaleInstances", (payload) => payload);
-var W = "windowManager/";
-var pass = () => (payload) => payload;
-var focusWindow = creator(W + "focusWindow", pass());
-var restoreWindow = creator(W + "restoreWindow", pass());
-var toggleWindowsHidden = creator(W + "toggleWindowsHidden", () => void 0);
-var restoreAll = creator(W + "restoreAll", () => void 0);
-var minimizeAll = creator(W + "minimizeAll", pass());
-var arrangeActiveWindows = creator(W + "arrangeActiveWindows", pass());
-var revealWindow = creator(W + "revealWindow", pass());
-var updateWindowRect = creator(
-  W + "updateWindowRect",
-  pass()
-);
-var setOverlayStateValue = creator("overlayState/setOverlayStateValue", pass());
-var registerSyncEntry = creator("urlSync/registerSyncEntry", pass());
-var unregisterSyncEntry = creator("urlSync/unregisterSyncEntry", pass());
-var SUMMON_SLICE_KEYS = ["overlays", "windowManager", "urlSync", "overlayState"];
-function isSummonAction(action) {
-  if (typeof action !== "object" || action === null) return false;
-  const type = action.type;
-  if (typeof type !== "string") return false;
-  const slash = type.indexOf("/");
-  return slash > 0 && SUMMON_SLICE_KEYS.includes(type.slice(0, slash));
-}
+import {
+  DEFAULT_INSTANCE_ID,
+  DEFAULT_PORTS,
+  SUMMON_INSTALLED_ACTION,
+  SUMMON_SLICE_KEYS,
+  allOverlayMeta,
+  anonymousIdentity,
+  arrangeActiveWindows,
+  closeAllInstancesOfOverlay,
+  closeAllOverlays,
+  closeOverlay,
+  closeOverlaysBoundToPage,
+  consoleErrorSink,
+  consoleNotify,
+  createSummonGate,
+  debugOff,
+  defaultWindowIdFor,
+  dropPendingChannelsOf,
+  ensureSummonRuntime,
+  focusWindow,
+  getOverlayMeta,
+  getOverlayMetaByLinkKey,
+  installSummonCore,
+  instanceKey,
+  isRegisteredOverlay,
+  isSummonAction,
+  isSummonInstalled,
+  listOpenInstanceKeys,
+  locationRouter,
+  materializePendingChannels,
+  minimizeAll,
+  openOverlay,
+  openPendingEventChannel,
+  overlayIdsBoundToPage,
+  parseInstanceKey,
+  prefetchSummonRuntime,
+  pruneStaleInstances,
+  registerOverlayMeta,
+  registerSyncEntry,
+  resetOverlayRegistry,
+  resolvePorts,
+  restoreAll,
+  restoreWindow,
+  revealWindow,
+  selectAllMinimized,
+  selectAllWindows,
+  selectAnyOverlayTouched,
+  selectIsOverlayOpen,
+  selectOpenInstances,
+  selectOverlay,
+  selectOverlayData,
+  selectWindowsHidden,
+  setOverlayStateValue,
+  subscribeSummonInstalled,
+  subscribeToOverlayRegistry,
+  toggleOverlay,
+  toggleWindowsHidden,
+  unregisterSyncEntry,
+  updateWindowRect
+} from "./chunk-server-C4KQZFIN.js";
+import {
+  HANDLES_SLOT,
+  newHandleId,
+  registerHandleEntry,
+  removeHandleGroup,
+  unregisterHandleEntry
+} from "./chunk-server-H7NUWPEM.js";
 
 // src/open/renderAcks.ts
-import { globalSlot as globalSlot2 } from "@ai-matrx/kit/global-slot";
-var slot = () => globalSlot2("ai-matrx.summon.renderWatchdog", () => ({ renderAcks: /* @__PURE__ */ new Map(), ackWaiters: /* @__PURE__ */ new Map(), watches: /* @__PURE__ */ new Map() }));
+import { globalSlot } from "@ai-matrx/kit/global-slot";
+var slot = () => globalSlot("ai-matrx.summon.renderWatchdog", () => ({ renderAcks: /* @__PURE__ */ new Map(), ackWaiters: /* @__PURE__ */ new Map(), watches: /* @__PURE__ */ new Map() }));
 function ackOverlaySurfaceRender(overlayId) {
   const s = slot();
   s.renderAcks.set(overlayId, { kind: "surface" });
@@ -194,162 +83,10 @@ function clearOverlaySurfaceRender(overlayId) {
   if (s.renderAcks.get(overlayId)?.kind === "surface") s.renderAcks.delete(overlayId);
 }
 
-// src/open/selectors.ts
-import { globalSlot as globalSlot3 } from "@ai-matrx/kit/global-slot";
-var overlaysOf = (state2) => state2.overlays;
-var CLOSED = Object.freeze({ isOpen: false, data: null });
-var EMPTY = Object.freeze([]);
-var selectOverlay = (state2, overlayId, instanceId = DEFAULT_INSTANCE_ID) => overlaysOf(state2)?.overlays[overlayId]?.[instanceId] ?? CLOSED;
-var selectIsOverlayOpen = (state2, overlayId, instanceId = DEFAULT_INSTANCE_ID) => selectOverlay(state2, overlayId, instanceId).isOpen;
-var selectOverlayData = (state2, overlayId, instanceId = DEFAULT_INSTANCE_ID) => selectOverlay(state2, overlayId, instanceId).data;
-var openCache = () => globalSlot3("ai-matrx.summon.openInstances", () => /* @__PURE__ */ new Map());
-var selectOpenInstances = (state2, overlayId) => {
-  const bucket = overlaysOf(state2)?.overlays[overlayId];
-  const cache = openCache();
-  const hit = cache.get(overlayId);
-  if (hit && hit.bucket === bucket) return hit.result;
-  let result = EMPTY;
-  if (bucket) {
-    const open = [];
-    for (const [instanceId, inst] of Object.entries(bucket)) if (inst.isOpen) open.push({ instanceId, data: inst.data });
-    if (open.length > 0) result = open;
-  }
-  cache.set(overlayId, { bucket, result });
-  return result;
-};
-function listOpenInstanceKeys(state2) {
-  const keys = [];
-  for (const [overlayId, bucket] of Object.entries(overlaysOf(state2)?.overlays ?? {})) {
-    for (const [instanceId, inst] of Object.entries(bucket)) if (inst.isOpen) keys.push(`${overlayId}:${instanceId}`);
-  }
-  return keys;
-}
-function selectAnyOverlayTouched(state2) {
-  for (const _ in overlaysOf(state2)?.overlays ?? {}) return true;
-  return false;
-}
-var selectWindowsHidden = (state2) => state2.windowManager?.windowsHidden ?? false;
-var EMPTY_WINDOWS = Object.freeze([]);
-var lastWindowsMap = null;
-var lastWindows = EMPTY_WINDOWS;
-function selectAllWindows(state2) {
-  const map = state2.windowManager?.windows;
-  if (!map) return EMPTY_WINDOWS;
-  if (map !== lastWindowsMap) {
-    lastWindowsMap = map;
-    lastWindows = Object.values(map).sort((a, b) => b.zIndex - a.zIndex);
-  }
-  return lastWindows;
-}
-function selectAllMinimized(state2) {
-  const map = state2.windowManager?.windows;
-  if (!map) return false;
-  const wins = Object.values(map);
-  return wins.length > 0 && wins.every((w) => w.state === "minimized");
-}
-
-// src/open/gate.ts
-import { globalSlot as globalSlot4 } from "@ai-matrx/kit/global-slot";
-var SUMMON_INSTALLED_ACTION = "@@summon/installed";
-var slot2 = () => globalSlot4("ai-matrx.summon.gate", () => ({ core: null, loading: null, gates: /* @__PURE__ */ new Set(), listeners: /* @__PURE__ */ new Set() }));
-function installSummonCore(core) {
-  const s = slot2();
-  if (s.core) return;
-  s.core = core;
-  const gates = [...s.gates];
-  s.gates.clear();
-  for (const gate of gates) gate.install(core);
-  for (const listener of [...s.listeners]) listener();
-}
-function isSummonInstalled() {
-  return slot2().core !== null;
-}
-function subscribeSummonInstalled(listener) {
-  const s = slot2();
-  s.listeners.add(listener);
-  return () => s.listeners.delete(listener);
-}
-function ensureSummonRuntime() {
-  const s = slot2();
-  if (s.core) return Promise.resolve();
-  s.loading ??= import("@ai-matrx/summon").then(
-    (core) => installSummonCore(core.summonCore),
-    (error) => {
-      s.loading = null;
-      throw error;
-    }
-  );
-  return s.loading;
-}
-function prefetchSummonRuntime() {
-  ensureSummonRuntime().catch(() => void 0);
-}
-function createSummonGate(options = {}) {
-  let inject = null;
-  let injected = false;
-  let api = null;
-  let next = null;
-  let chain = null;
-  const queue = [];
-  const settle = (core2, live) => {
-    if (inject && !injected) {
-      inject(core2.reducers);
-      injected = true;
-    }
-    if (!api || !next || chain) return;
-    const store = api;
-    let composed = next;
-    for (const middleware2 of [...core2.createMiddleware(options.ports)].reverse()) {
-      composed = middleware2(store)(composed);
-    }
-    chain = composed;
-    const flush = () => {
-      if (live) store.dispatch({ type: SUMMON_INSTALLED_ACTION });
-      for (const action of queue.splice(0)) store.dispatch(action);
-    };
-    if (live) flush();
-    else if (queue.length > 0) queueMicrotask(flush);
-  };
-  const internals = { install: (core2) => settle(core2, true) };
-  const core = () => slot2().core;
-  const middleware = (storeApi) => {
-    api = storeApi;
-    return (nextDispatch) => {
-      next = nextDispatch;
-      const loaded = core();
-      if (loaded) settle(loaded, false);
-      else slot2().gates.add(internals);
-      return (action) => {
-        if (chain) return chain(action);
-        if (!isSummonAction(action)) return nextDispatch(action);
-        queue.push(action);
-        void ensureSummonRuntime().catch((error) => {
-          console.error("[summon] the overlay runtime failed to load; queued requests are kept for the next try", error);
-        });
-        return action;
-      };
-    };
-  };
-  return {
-    middleware,
-    attachReducer(fn) {
-      inject = fn;
-      const loaded = core();
-      if (loaded) {
-        inject(loaded.reducers);
-        injected = true;
-      }
-    }
-  };
-}
-
-// src/handles/slot.ts
-var HANDLES_SLOT = "ai-matrx.summon.handles";
-
 // src/open/peek.ts
 function peekHandle(id) {
-  const slot3 = globalThis[Symbol.for(HANDLES_SLOT)];
-  return slot3?.callbacks.get(id)?.callback;
+  const slot2 = globalThis[Symbol.for(HANDLES_SLOT)];
+  return slot2?.callbacks.get(id)?.callback;
 }
 
 // src/open/lazyOpener.ts
@@ -391,7 +128,7 @@ function lazyOpener(overlayId, load, options = {}) {
     if (real) return real(...args);
     let target = null;
     let closed = false;
-    const pending2 = [];
+    const pending = [];
     const standIn = {
       instanceId: instanceId ?? "",
       get callbackGroupId() {
@@ -399,7 +136,7 @@ function lazyOpener(overlayId, load, options = {}) {
       },
       update(patch) {
         if (target) target.update?.(patch);
-        else if (!closed) pending2.push(patch);
+        else if (!closed) pending.push(patch);
       },
       close() {
         if (target) target.close?.();
@@ -411,7 +148,7 @@ function lazyOpener(overlayId, load, options = {}) {
         if (closed) return;
         const handle = opener(...args);
         target = handle ?? {};
-        for (const patch of pending2.splice(0)) target.update?.(patch);
+        for (const patch of pending.splice(0)) target.update?.(patch);
       },
       (error) => {
         console.error(`[summon] the "${overlayId}" opener failed to load; nothing opened`, error);
@@ -422,28 +159,6 @@ function lazyOpener(overlayId, load, options = {}) {
   return lazy;
 }
 
-// src/open/channels.ts
-import { globalSlot as globalSlot5 } from "@ai-matrx/kit/global-slot";
-var pending = () => globalSlot5("ai-matrx.summon.pendingChannels", () => /* @__PURE__ */ new Map());
-function materializePendingChannels(createEventChannel) {
-  const map = pending();
-  for (const [id, entry] of [...map]) {
-    map.delete(id);
-    const channel = createEventChannel({ owner: entry.owner, id });
-    channel.subscribe((message) => entry.getHandlers()?.[message.type]?.(message.payload));
-  }
-}
-function openPendingEventChannel(owner, getHandlers) {
-  const id = `ch-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
-  pending().set(id, { owner, getHandlers });
-  void import("@ai-matrx/summon/handles").then(({ createEventChannel }) => materializePendingChannels(createEventChannel));
-  return id;
-}
-function dropPendingChannelsOf(owner) {
-  const map = pending();
-  for (const [id, entry] of [...map]) if (entry.owner === owner) map.delete(id);
-}
-
 // src/open/grammar.ts
 var hex = (ch) => `%${ch.charCodeAt(0).toString(16).toUpperCase().padStart(2, "0")}`;
 function encodeLinkId(id) {
@@ -501,6 +216,7 @@ export {
   materializePendingChannels,
   minimizeAll,
   mintInstanceId,
+  newHandleId,
   openOverlay,
   openPendingEventChannel,
   overlayIdsBoundToPage,
@@ -508,8 +224,10 @@ export {
   peekHandle,
   prefetchSummonRuntime,
   pruneStaleInstances,
+  registerHandleEntry,
   registerOverlayMeta,
   registerSyncEntry,
+  removeHandleGroup,
   resetOverlayRegistry,
   resolvePorts,
   restoreAll,
@@ -528,6 +246,7 @@ export {
   subscribeToOverlayRegistry,
   toggleOverlay,
   toggleWindowsHidden,
+  unregisterHandleEntry,
   unregisterSyncEntry,
   updateWindowRect
 };