@ai-matrx/summon 0.1.6 → 0.1.8

package/dist/handles.d.ts

@@ -1,3 +1,5 @@
+export { E as EventChannel, H as HandleDisposedError, O as OwnerOption, P as PendingRequest, R as RequestHandle, c as createEventChannel, a as createRequest, g as getEventChannel, b as getHandle, d as getRequest, r as registerHandle, e as removeHandle } from './helpers-2NY1ha0V.js';
+
 type CallbackContext = Record<string, unknown>;
 interface ProgressInfo {
     progress?: number;
@@ -100,67 +102,7 @@ declare const callbackManager: CallbackManager;
 /** Remove everything owned by an open instance (`overlayId:instanceId`). */
 declare function disposeOwner(owner: string): number;
 
-interface OwnerOption {
-    /** The InstanceKey (`overlayId:instanceId`) that owns this handle; disposed when it closes. */
-    owner?: string;
-}
-/** Thrown into a request's promise when it is disposed before being answered. */
-declare class HandleDisposedError extends Error {
-    readonly handleId: string;
-    constructor(handleId: string, message?: string);
-}
-/**
- * Register an imperative object handle under a caller-chosen id (an editor API, a widget handle,
- * a ref's methods). Re-registering an id replaces the previous handle. Returns a disposer that
- * removes the handle only if it is still the one registered (safe for React effect cleanup).
- */
-declare function registerHandle<T extends object>(id: string, handle: T, options?: OwnerOption): () => void;
-/** The object handle registered under `id`, or undefined. */
-declare function getHandle<T extends object>(id: string): T | undefined;
-/** Remove the handle registered under `id`. */
-declare function removeHandle(id: string): void;
-interface EventChannel<Events> {
-    readonly id: string;
-    /** Deliver an event to every subscriber (no-op after dispose). */
-    emit(event: Events): void;
-    /** Listen; returns the unsubscribe. */
-    subscribe(listener: (event: Events) => void): () => void;
-    /** Remove the channel and drop every subscriber. */
-    dispose(): void;
-    readonly disposed: boolean;
-}
-/**
- * A many-shot event stream between an opener and an overlay. Pass `channel.id` in open data; the
- * overlay resolves it with `getEventChannel(id)`.
- */
-declare function createEventChannel<Events>(options?: OwnerOption): EventChannel<Events>;
-/** The channel registered under `id`, or undefined once disposed. */
-declare function getEventChannel<Events>(id: string): EventChannel<Events> | undefined;
-interface PendingRequest<Req, Res> {
-    readonly id: string;
-    /** What the asker sent. */
-    readonly request: Req;
-    /** Answer the request (first answer wins; later calls are ignored). */
-    resolve(response: Res): void;
-    /** Fail the request. */
-    reject(reason: unknown): void;
-    readonly settled: boolean;
-}
-interface RequestHandle<Req, Res> extends PendingRequest<Req, Res> {
-    /** Settles with the answer; rejects with `HandleDisposedError` when disposed unanswered. */
-    readonly promise: Promise<Res>;
-    /** Remove the request; an unanswered one rejects. */
-    dispose(): void;
-}
-/**
- * A one-shot promise bridge: the asker awaits `promise`, the overlay answers through
- * `getRequest(id).resolve(…)`. Disposing it unanswered (or closing its owner) rejects.
- */
-declare function createRequest<Req, Res>(request: Req, options?: OwnerOption): RequestHandle<Req, Res>;
-/** The pending request registered under `id`, or undefined once answered or disposed. */
-declare function getRequest<Req, Res>(id: string): PendingRequest<Req, Res> | undefined;
-
 /** A fresh handle id: `crypto.randomUUID` when present, else a v4 UUID from `getRandomValues`. */
 declare function newHandleId(): string;
 
-export { type Callback, type CallbackContext, CallbackManager, type EventChannel, HANDLES_SLOT, HandleDisposedError, type HandleSlot, type OwnerOption, type PendingRequest, type ProgressInfo, type RegisterOptions, type RequestHandle, type TriggerOptions, callbackManager, createEventChannel, createRequest, disposeOwner, getEventChannel, getHandle, getRequest, newHandleId, registerHandle, removeHandle };
+export { type Callback, type CallbackContext, CallbackManager, HANDLES_SLOT, type HandleSlot, type ProgressInfo, type RegisterOptions, type TriggerOptions, callbackManager, disposeOwner, newHandleId };

package/dist/handles.js

@@ -310,6 +310,7 @@ function createEventChannel(options) {
     }
   };
   id = callbackManager.registerEntry(channel, {
+    ...options?.id === void 0 ? {} : { id: options.id },
     ...ownerOptions(options),
     onRemove: () => {
       disposed = true;

package/dist/handles.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/handles/callbackManager.ts","../src/handles/ids.ts","../src/handles/helpers.ts"],"sourcesContent":["/**\n * The handles registry — everything that cannot travel through Redux (callbacks, event channels,\n * one-shot requests, imperative object handles) lives here under a string id; only the id goes\n * into overlay open data.\n *\n * Successor of `@ai-matrx/chat` `utils/callbackManager.ts` with the SAME public verbs and types, so\n * moving a caller is an import-path swap. Changes (CHANGELOG 0.1.0):\n *   1. State lives in the global slot \"ai-matrx.summon.handles\", never in module scope: a\n *      duplicated module graph (ESM + CJS, unsplit bundles, two packages) sees one registry.\n *   2. Removal bug fixed: `trigger` / `triggerWithContext` / `remove` deleted the entry BEFORE\n *      `removeFromGroups` read it, so group membership never shrank and emptied groups were never\n *      dropped. Removal now reads the entry first, in one place (`deleteEntry`).\n *   3. Owner scoping: `registerWithContext(cb, { owner })` (an InstanceKey `overlayId:instanceId`)\n *      ties the entry to an open overlay instance; `disposeOwner(owner)` removes everything it\n *      owns. The overlays close middleware calls it, so no opener disposes by hand.\n *   4. The object slot is handle-agnostic: `registerWidgetHandle<H extends object>(handle)` stores\n *      any object (no chat `WidgetHandle` import).\n *   5. Ids come from `crypto.randomUUID` (no `uuid` dependency), with a fallback for insecure\n *      contexts where `randomUUID` is absent.\n *\n * Framework-free: no React, no Redux.\n */\nimport { globalSlot } from \"@ai-matrx/kit/global-slot\";\nimport { newHandleId } from \"./ids\";\n\nexport type CallbackContext = Record<string, unknown>;\n\nexport interface ProgressInfo {\n  progress?: number;\n  status?: \"pending\" | \"running\" | \"completed\" | \"error\";\n  error?: Error;\n}\n\nexport type Callback<T = unknown, C extends CallbackContext = CallbackContext> = (\n  data: T,\n  context?: C,\n) => void | Promise<void>;\n\n/** What an entry's slot holds: a callback, or an object handle retrieved with `get`. */\nexport type HandleSlot = Callback<never, never> | object;\n\nexport interface RegisterOptions<C extends CallbackContext = CallbackContext> {\n  context?: C;\n  groupId?: string;\n  /** The InstanceKey (`overlayId:instanceId`) that owns this entry; disposed when it closes. */\n  owner?: string;\n}\n\nexport interface TriggerOptions<C extends CallbackContext = CallbackContext> {\n  context?: C;\n  progress?: ProgressInfo;\n  removeAfterTrigger?: boolean;\n}\n\n/** A registry entry. `callback` is the heterogeneous slot (function or object handle). */\ninterface CallbackEntry {\n  callback: HandleSlot;\n  context?: CallbackContext;\n  groupId?: string;\n  owner?: string;\n  listeners?: Array<Callback<never, never>>;\n  /** Runs once when the entry leaves the registry for any reason (requests reject here). */\n  onRemove?: () => void;\n}\n\ninterface HandlesState {\n  readonly callbacks: Map<string, CallbackEntry>;\n  readonly groups: Map<string, Set<string>>;\n  readonly owners: Map<string, Set<string>>;\n  readonly registryListeners: Set<() => void>;\n}\n\nexport const HANDLES_SLOT = \"ai-matrx.summon.handles\";\n\nconst handlesState = (): HandlesState =>\n  globalSlot<HandlesState>(HANDLES_SLOT, () => ({\n    callbacks: new Map(),\n    groups: new Map(),\n    owners: new Map(),\n    registryListeners: new Set(),\n  }));\n\n/** Invoke a slot as a callback (a function slot only; object handles are never invoked). */\nfunction invoke(slot: HandleSlot, data: unknown, context?: CallbackContext): void | Promise<void> {\n  if (typeof slot !== \"function\") return undefined;\n  return (slot as Callback<unknown, CallbackContext>)(data, context);\n}\n\nfunction invokeListener(listener: Callback<never, never>, data: unknown, context?: CallbackContext): void | Promise<void> {\n  return (listener as Callback<unknown, CallbackContext>)(data, context);\n}\n\n/** Internal registration options beyond the public ones (used by the typed helpers). */\nexport interface InternalRegisterOptions extends RegisterOptions {\n  id?: string;\n  onRemove?: () => void;\n}\n\nexport class CallbackManager {\n  private get s(): HandlesState {\n    return handlesState();\n  }\n\n  /**\n   * Observe the registry itself: `listener` runs after any entry is added or removed. This lets a\n   * view that resolves ids with `get` re-render when an id goes away (`useSyncExternalStore`).\n   */\n  subscribeToRegistry(listener: () => void): () => void {\n    const listeners = this.s.registryListeners;\n    listeners.add(listener);\n    return () => {\n      listeners.delete(listener);\n    };\n  }\n\n  private notifyRegistry(): void {\n    for (const listener of [...this.s.registryListeners]) listener();\n  }\n\n  /** Register a callback; returns its id. */\n  register<T>(callback: Callback<T>): string {\n    return this.registerEntry(callback as HandleSlot, {});\n  }\n\n  /** Register with optional context, group and owner. */\n  registerWithContext<T, C extends CallbackContext = CallbackContext>(\n    callback: Callback<T, C>,\n    options: RegisterOptions<C> = {},\n  ): string {\n    return this.registerEntry(callback as HandleSlot, options);\n  }\n\n  /** @internal The one insertion path (typed helpers pass a fixed id and a removal hook). */\n  registerEntry(slot: HandleSlot, options: InternalRegisterOptions): string {\n    const s = this.s;\n    const callbackId = options.id ?? newHandleId();\n    if (s.callbacks.has(callbackId)) this.deleteEntry(callbackId, false);\n    const entry: CallbackEntry = { callback: slot };\n    if (options.context !== undefined) entry.context = options.context;\n    if (options.groupId !== undefined) entry.groupId = options.groupId;\n    if (options.owner !== undefined) entry.owner = options.owner;\n    if (options.onRemove !== undefined) entry.onRemove = options.onRemove;\n    s.callbacks.set(callbackId, entry);\n\n    if (options.groupId !== undefined) {\n      const group = s.groups.get(options.groupId) ?? new Set<string>();\n      group.add(callbackId);\n      s.groups.set(options.groupId, group);\n    }\n    if (options.owner !== undefined) {\n      const owned = s.owners.get(options.owner) ?? new Set<string>();\n      owned.add(callbackId);\n      s.owners.set(options.owner, owned);\n    }\n    this.notifyRegistry();\n    return callbackId;\n  }\n\n  /** Subscribe to results for a callback id. */\n  subscribe<T, C extends CallbackContext = CallbackContext>(callbackId: string, listener: Callback<T, C>): boolean {\n    const entry = this.s.callbacks.get(callbackId);\n    if (!entry) return false;\n    (entry.listeners ??= []).push(listener as Callback<never, never>);\n    return true;\n  }\n\n  /** Unsubscribe a listener from a callback id. */\n  unsubscribe<T, C extends CallbackContext = CallbackContext>(callbackId: string, listener: Callback<T, C>): boolean {\n    const entry = this.s.callbacks.get(callbackId);\n    if (!entry || !entry.listeners) return false;\n    const index = entry.listeners.indexOf(listener as Callback<never, never>);\n    if (index === -1) return false;\n    entry.listeners.splice(index, 1);\n    return true;\n  }\n\n  /** Run a callback once, notify its listeners, then remove it. */\n  trigger<T>(callbackId: string, data: T): void {\n    const entry = this.s.callbacks.get(callbackId);\n    if (!entry) return;\n    void invoke(entry.callback, data);\n    if (entry.listeners && entry.listeners.length > 0) {\n      for (const listener of [...entry.listeners]) void invokeListener(listener, data);\n    }\n    this.deleteEntry(callbackId, true);\n  }\n\n  /** Trigger with merged context and progress; removes unless `removeAfterTrigger: false`. */\n  triggerWithContext<T, C extends CallbackContext = CallbackContext>(\n    callbackId: string,\n    data: T,\n    options?: TriggerOptions<C>,\n  ): void {\n    const entry = this.s.callbacks.get(callbackId);\n    if (!entry) return;\n    const mergedContext: CallbackContext = {\n      ...entry.context,\n      ...options?.context,\n      ...(options?.progress && { progress: options.progress }),\n    };\n    void invoke(entry.callback, data, mergedContext);\n    if (entry.listeners && entry.listeners.length > 0) {\n      for (const listener of [...entry.listeners]) void invokeListener(listener, data, mergedContext);\n    }\n    if (options?.removeAfterTrigger !== false) this.deleteEntry(callbackId, true);\n  }\n\n  /** Trigger every callback in a group. */\n  triggerGroup<T, C extends CallbackContext = CallbackContext>(groupId: string, data: T, options?: TriggerOptions<C>): void {\n    const group = this.s.groups.get(groupId);\n    if (!group) return;\n    for (const callbackId of [...group]) this.triggerWithContext(callbackId, data, options);\n    if (options?.removeAfterTrigger !== false) this.s.groups.delete(groupId);\n  }\n\n  /**\n   * Run the one durable command registered for a group. A command is retained on rejection so its\n   * caller can retry, and is removed only after its promise settles successfully.\n   */\n  async triggerGroupCommand<T, C extends CallbackContext = CallbackContext>(\n    groupId: string,\n    data: T,\n    options?: { context?: C; removeAfterSuccess?: boolean },\n  ): Promise<void> {\n    const group = this.s.groups.get(groupId);\n    const callbackIds = group ? [...group] : [];\n    const callbackId = callbackIds[0];\n    if (callbackIds.length !== 1 || callbackId === undefined) {\n      throw new Error(`Expected exactly one command callback for group \"${groupId}\", found ${callbackIds.length}`);\n    }\n    const entry = this.s.callbacks.get(callbackId);\n    if (!entry) throw new Error(`Command callback \"${callbackId}\" is no longer available`);\n\n    const mergedContext: CallbackContext = { ...entry.context, ...options?.context };\n    await invoke(entry.callback, data, mergedContext);\n\n    // Observers never control command settlement: the command already acknowledged.\n    for (const listener of entry.listeners ?? []) {\n      try {\n        await invokeListener(listener, data, mergedContext);\n      } catch (error) {\n        // eslint-disable-next-line no-console\n        console.error(\"[overlays/handles] command observer failed\", error);\n      }\n    }\n\n    if (options?.removeAfterSuccess !== false) {\n      this.deleteEntry(callbackId, true);\n      this.s.groups.delete(groupId);\n    }\n  }\n\n  /** Report progress to a callback (or every callback of a group) without removing it. */\n  updateProgress(\n    id: string,\n    progress: number,\n    options?: { status?: ProgressInfo[\"status\"]; error?: Error; groupId?: boolean },\n  ): void {\n    const progressInfo: ProgressInfo = { progress, status: options?.status || \"running\" };\n    if (options?.error !== undefined) progressInfo.error = options.error;\n    if (options?.groupId) {\n      this.triggerGroup(id, null, { progress: progressInfo, removeAfterTrigger: false });\n    } else {\n      this.triggerWithContext(id, null, { progress: progressInfo, removeAfterTrigger: false });\n    }\n  }\n\n  /** Create a new, empty group and return its id. */\n  createGroup(): string {\n    const groupId = newHandleId();\n    this.s.groups.set(groupId, new Set());\n    return groupId;\n  }\n\n  /** Remove one entry (and its group/owner membership). */\n  remove(callbackId: string): void {\n    this.deleteEntry(callbackId, true);\n  }\n\n  /** Alias of `remove` — the preferred name when unregistering a handle on unmount. */\n  unregister(callbackId: string): void {\n    this.remove(callbackId);\n  }\n\n  /** The stored callback or object handle for an id, without invoking it. */\n  get<T = unknown>(callbackId: string): T | undefined {\n    return this.s.callbacks.get(callbackId)?.callback as T | undefined;\n  }\n\n  /** True when the id is registered. */\n  has(callbackId: string): boolean {\n    return this.s.callbacks.has(callbackId);\n  }\n\n  /**\n   * Register an object handle (a widget handle, an editor API, …). The object occupies the slot;\n   * it is never invoked by `trigger`, only retrieved with `get`.\n   */\n  registerWidgetHandle<H extends object>(handle: H, options: { owner?: string } = {}): string {\n    return this.registerEntry(handle, options.owner === undefined ? {} : { owner: options.owner });\n  }\n\n  /** Remove a group and all its callbacks. */\n  removeGroup(groupId: string): void {\n    const s = this.s;\n    const group = s.groups.get(groupId);\n    if (!group) return;\n    s.groups.delete(groupId);\n    for (const callbackId of [...group]) this.deleteEntry(callbackId, false);\n    this.notifyRegistry();\n  }\n\n  /** Remove everything registered with `owner` (an InstanceKey). Returns how many were removed. */\n  disposeOwner(owner: string): number {\n    const s = this.s;\n    const owned = s.owners.get(owner);\n    if (!owned) return 0;\n    s.owners.delete(owner);\n    const ids = [...owned];\n    for (const callbackId of ids) this.deleteEntry(callbackId, false);\n    if (ids.length > 0) this.notifyRegistry();\n    return ids.length;\n  }\n\n  /** Ids currently owned by `owner`. */\n  ownedBy(owner: string): readonly string[] {\n    return [...(this.s.owners.get(owner) ?? [])];\n  }\n\n  /** The member ids of a group (empty when unknown). */\n  groupMembers(groupId: string): readonly string[] {\n    return [...(this.s.groups.get(groupId) ?? [])];\n  }\n\n  /** Total registered entries (diagnostics, leak tests). */\n  size(): number {\n    return this.s.callbacks.size;\n  }\n\n  /**\n   * The one removal path. Reads the entry BEFORE deleting it so group and owner membership shrink\n   * (the old `removeFromGroups`-after-delete bug), then runs the entry's removal hook.\n   */\n  private deleteEntry(callbackId: string, notify: boolean): void {\n    const s = this.s;\n    const entry = s.callbacks.get(callbackId);\n    if (!entry) return;\n    s.callbacks.delete(callbackId);\n    if (entry.groupId !== undefined) {\n      const group = s.groups.get(entry.groupId);\n      group?.delete(callbackId);\n      if (group?.size === 0) s.groups.delete(entry.groupId);\n    }\n    if (entry.owner !== undefined) {\n      const owned = s.owners.get(entry.owner);\n      owned?.delete(callbackId);\n      if (owned?.size === 0) s.owners.delete(entry.owner);\n    }\n    if (notify) this.notifyRegistry();\n    entry.onRemove?.();\n  }\n}\n\n/** The process-wide handles registry (state in the global slot; every instance shares it). */\nexport const callbackManager = new CallbackManager();\n\n/** Remove everything owned by an open instance (`overlayId:instanceId`). */\nexport function disposeOwner(owner: string): number {\n  return callbackManager.disposeOwner(owner);\n}\n","/** A fresh handle id: `crypto.randomUUID` when present, else a v4 UUID from `getRandomValues`. */\nexport function newHandleId(): string {\n  const c: Crypto | undefined = typeof globalThis.crypto === \"undefined\" ? undefined : globalThis.crypto;\n  if (c && typeof c.randomUUID === \"function\") return c.randomUUID();\n  const bytes = new Uint8Array(16);\n  if (c && typeof c.getRandomValues === \"function\") {\n    c.getRandomValues(bytes);\n  } else {\n    for (let i = 0; i < 16; i += 1) bytes[i] = Math.floor(Math.random() * 256);\n  }\n  bytes[6] = ((bytes[6] ?? 0) & 0x0f) | 0x40;\n  bytes[8] = ((bytes[8] ?? 0) & 0x3f) | 0x80;\n  const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, \"0\")).join(\"\");\n  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;\n}\n","/**\n * Typed helpers over the handles registry: imperative object handles, event channels and one-shot\n * requests. Each is stored in the same registry (so its id can ride overlay open data and `get`\n * still resolves it) and accepts an `owner` InstanceKey so closing the owning overlay disposes it.\n */\nimport { callbackManager } from \"./callbackManager\";\n\nexport interface OwnerOption {\n  /** The InstanceKey (`overlayId:instanceId`) that owns this handle; disposed when it closes. */\n  owner?: string;\n}\n\n/** Thrown into a request's promise when it is disposed before being answered. */\nexport class HandleDisposedError extends Error {\n  readonly handleId: string;\n  constructor(handleId: string, message = `[overlays/handles] \"${handleId}\" was disposed before it settled`) {\n    super(message);\n    this.name = \"HandleDisposedError\";\n    this.handleId = handleId;\n  }\n}\n\nfunction ownerOptions(options: OwnerOption | undefined): { owner?: string } {\n  return options?.owner === undefined ? {} : { owner: options.owner };\n}\n\n// ── Imperative object handles ────────────────────────────────────────────────────────────────\n\n/**\n * Register an imperative object handle under a caller-chosen id (an editor API, a widget handle,\n * a ref's methods). Re-registering an id replaces the previous handle. Returns a disposer that\n * removes the handle only if it is still the one registered (safe for React effect cleanup).\n */\nexport function registerHandle<T extends object>(id: string, handle: T, options?: OwnerOption): () => void {\n  callbackManager.registerEntry(handle, { id, ...ownerOptions(options) });\n  return () => {\n    if (callbackManager.get<T>(id) === handle) callbackManager.remove(id);\n  };\n}\n\n/** The object handle registered under `id`, or undefined. */\nexport function getHandle<T extends object>(id: string): T | undefined {\n  const value = callbackManager.get<unknown>(id);\n  return typeof value === \"object\" && value !== null ? (value as T) : undefined;\n}\n\n/** Remove the handle registered under `id`. */\nexport function removeHandle(id: string): void {\n  callbackManager.remove(id);\n}\n\n// ── Event channels ───────────────────────────────────────────────────────────────────────────\n\nexport interface EventChannel<Events> {\n  readonly id: string;\n  /** Deliver an event to every subscriber (no-op after dispose). */\n  emit(event: Events): void;\n  /** Listen; returns the unsubscribe. */\n  subscribe(listener: (event: Events) => void): () => void;\n  /** Remove the channel and drop every subscriber. */\n  dispose(): void;\n  readonly disposed: boolean;\n}\n\n/**\n * A many-shot event stream between an opener and an overlay. Pass `channel.id` in open data; the\n * overlay resolves it with `getEventChannel(id)`.\n */\nexport function createEventChannel<Events>(options?: OwnerOption): EventChannel<Events> {\n  const listeners = new Set<(event: Events) => void>();\n  let disposed = false;\n  let id = \"\";\n  const channel: EventChannel<Events> = {\n    get id() {\n      return id;\n    },\n    get disposed() {\n      return disposed;\n    },\n    emit(event) {\n      if (disposed) return;\n      for (const listener of [...listeners]) listener(event);\n    },\n    subscribe(listener) {\n      if (disposed) return () => {};\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    dispose() {\n      if (disposed) return;\n      callbackManager.remove(id);\n    },\n  };\n  id = callbackManager.registerEntry(channel, {\n    ...ownerOptions(options),\n    onRemove: () => {\n      disposed = true;\n      listeners.clear();\n    },\n  });\n  return channel;\n}\n\n/** The channel registered under `id`, or undefined once disposed. */\nexport function getEventChannel<Events>(id: string): EventChannel<Events> | undefined {\n  return getHandle<EventChannel<Events>>(id);\n}\n\n// ── One-shot requests ────────────────────────────────────────────────────────────────────────\n\nexport interface PendingRequest<Req, Res> {\n  readonly id: string;\n  /** What the asker sent. */\n  readonly request: Req;\n  /** Answer the request (first answer wins; later calls are ignored). */\n  resolve(response: Res): void;\n  /** Fail the request. */\n  reject(reason: unknown): void;\n  readonly settled: boolean;\n}\n\nexport interface RequestHandle<Req, Res> extends PendingRequest<Req, Res> {\n  /** Settles with the answer; rejects with `HandleDisposedError` when disposed unanswered. */\n  readonly promise: Promise<Res>;\n  /** Remove the request; an unanswered one rejects. */\n  dispose(): void;\n}\n\n/**\n * A one-shot promise bridge: the asker awaits `promise`, the overlay answers through\n * `getRequest(id).resolve(…)`. Disposing it unanswered (or closing its owner) rejects.\n */\nexport function createRequest<Req, Res>(request: Req, options?: OwnerOption): RequestHandle<Req, Res> {\n  let settle!: (response: Res) => void;\n  let fail!: (reason: unknown) => void;\n  const promise = new Promise<Res>((resolve, reject) => {\n    settle = resolve;\n    fail = reject;\n  });\n  // A disposed request nobody awaited must not surface as an unhandled rejection.\n  promise.catch(() => {});\n  let settled = false;\n  let id = \"\";\n  const handle: RequestHandle<Req, Res> = {\n    get id() {\n      return id;\n    },\n    request,\n    promise,\n    get settled() {\n      return settled;\n    },\n    resolve(response) {\n      if (settled) return;\n      settled = true;\n      settle(response);\n      callbackManager.remove(id);\n    },\n    reject(reason) {\n      if (settled) return;\n      settled = true;\n      fail(reason);\n      callbackManager.remove(id);\n    },\n    dispose() {\n      callbackManager.remove(id);\n    },\n  };\n  id = callbackManager.registerEntry(handle, {\n    ...ownerOptions(options),\n    onRemove: () => {\n      if (settled) return;\n      settled = true;\n      fail(new HandleDisposedError(id));\n    },\n  });\n  return handle;\n}\n\n/** The pending request registered under `id`, or undefined once answered or disposed. */\nexport function getRequest<Req, Res>(id: string): PendingRequest<Req, Res> | undefined {\n  return getHandle<RequestHandle<Req, Res>>(id);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/handles/callbackManager.ts","../src/handles/ids.ts","../src/handles/helpers.ts"],"sourcesContent":["/**\n * The handles registry — everything that cannot travel through Redux (callbacks, event channels,\n * one-shot requests, imperative object handles) lives here under a string id; only the id goes\n * into overlay open data.\n *\n * Successor of `@ai-matrx/chat` `utils/callbackManager.ts` with the SAME public verbs and types, so\n * moving a caller is an import-path swap. Changes (CHANGELOG 0.1.0):\n *   1. State lives in the global slot \"ai-matrx.summon.handles\", never in module scope: a\n *      duplicated module graph (ESM + CJS, unsplit bundles, two packages) sees one registry.\n *   2. Removal bug fixed: `trigger` / `triggerWithContext` / `remove` deleted the entry BEFORE\n *      `removeFromGroups` read it, so group membership never shrank and emptied groups were never\n *      dropped. Removal now reads the entry first, in one place (`deleteEntry`).\n *   3. Owner scoping: `registerWithContext(cb, { owner })` (an InstanceKey `overlayId:instanceId`)\n *      ties the entry to an open overlay instance; `disposeOwner(owner)` removes everything it\n *      owns. The overlays close middleware calls it, so no opener disposes by hand.\n *   4. The object slot is handle-agnostic: `registerWidgetHandle<H extends object>(handle)` stores\n *      any object (no chat `WidgetHandle` import).\n *   5. Ids come from `crypto.randomUUID` (no `uuid` dependency), with a fallback for insecure\n *      contexts where `randomUUID` is absent.\n *\n * Framework-free: no React, no Redux.\n */\nimport { globalSlot } from \"@ai-matrx/kit/global-slot\";\nimport { newHandleId } from \"./ids\";\n\nexport type CallbackContext = Record<string, unknown>;\n\nexport interface ProgressInfo {\n  progress?: number;\n  status?: \"pending\" | \"running\" | \"completed\" | \"error\";\n  error?: Error;\n}\n\nexport type Callback<T = unknown, C extends CallbackContext = CallbackContext> = (\n  data: T,\n  context?: C,\n) => void | Promise<void>;\n\n/** What an entry's slot holds: a callback, or an object handle retrieved with `get`. */\nexport type HandleSlot = Callback<never, never> | object;\n\nexport interface RegisterOptions<C extends CallbackContext = CallbackContext> {\n  context?: C;\n  groupId?: string;\n  /** The InstanceKey (`overlayId:instanceId`) that owns this entry; disposed when it closes. */\n  owner?: string;\n}\n\nexport interface TriggerOptions<C extends CallbackContext = CallbackContext> {\n  context?: C;\n  progress?: ProgressInfo;\n  removeAfterTrigger?: boolean;\n}\n\n/** A registry entry. `callback` is the heterogeneous slot (function or object handle). */\ninterface CallbackEntry {\n  callback: HandleSlot;\n  context?: CallbackContext;\n  groupId?: string;\n  owner?: string;\n  listeners?: Array<Callback<never, never>>;\n  /** Runs once when the entry leaves the registry for any reason (requests reject here). */\n  onRemove?: () => void;\n}\n\ninterface HandlesState {\n  readonly callbacks: Map<string, CallbackEntry>;\n  readonly groups: Map<string, Set<string>>;\n  readonly owners: Map<string, Set<string>>;\n  readonly registryListeners: Set<() => void>;\n}\n\nexport const HANDLES_SLOT = \"ai-matrx.summon.handles\";\n\nconst handlesState = (): HandlesState =>\n  globalSlot<HandlesState>(HANDLES_SLOT, () => ({\n    callbacks: new Map(),\n    groups: new Map(),\n    owners: new Map(),\n    registryListeners: new Set(),\n  }));\n\n/** Invoke a slot as a callback (a function slot only; object handles are never invoked). */\nfunction invoke(slot: HandleSlot, data: unknown, context?: CallbackContext): void | Promise<void> {\n  if (typeof slot !== \"function\") return undefined;\n  return (slot as Callback<unknown, CallbackContext>)(data, context);\n}\n\nfunction invokeListener(listener: Callback<never, never>, data: unknown, context?: CallbackContext): void | Promise<void> {\n  return (listener as Callback<unknown, CallbackContext>)(data, context);\n}\n\n/** Internal registration options beyond the public ones (used by the typed helpers). */\nexport interface InternalRegisterOptions extends RegisterOptions {\n  id?: string;\n  onRemove?: () => void;\n}\n\nexport class CallbackManager {\n  private get s(): HandlesState {\n    return handlesState();\n  }\n\n  /**\n   * Observe the registry itself: `listener` runs after any entry is added or removed. This lets a\n   * view that resolves ids with `get` re-render when an id goes away (`useSyncExternalStore`).\n   */\n  subscribeToRegistry(listener: () => void): () => void {\n    const listeners = this.s.registryListeners;\n    listeners.add(listener);\n    return () => {\n      listeners.delete(listener);\n    };\n  }\n\n  private notifyRegistry(): void {\n    for (const listener of [...this.s.registryListeners]) listener();\n  }\n\n  /** Register a callback; returns its id. */\n  register<T>(callback: Callback<T>): string {\n    return this.registerEntry(callback as HandleSlot, {});\n  }\n\n  /** Register with optional context, group and owner. */\n  registerWithContext<T, C extends CallbackContext = CallbackContext>(\n    callback: Callback<T, C>,\n    options: RegisterOptions<C> = {},\n  ): string {\n    return this.registerEntry(callback as HandleSlot, options);\n  }\n\n  /** @internal The one insertion path (typed helpers pass a fixed id and a removal hook). */\n  registerEntry(slot: HandleSlot, options: InternalRegisterOptions): string {\n    const s = this.s;\n    const callbackId = options.id ?? newHandleId();\n    if (s.callbacks.has(callbackId)) this.deleteEntry(callbackId, false);\n    const entry: CallbackEntry = { callback: slot };\n    if (options.context !== undefined) entry.context = options.context;\n    if (options.groupId !== undefined) entry.groupId = options.groupId;\n    if (options.owner !== undefined) entry.owner = options.owner;\n    if (options.onRemove !== undefined) entry.onRemove = options.onRemove;\n    s.callbacks.set(callbackId, entry);\n\n    if (options.groupId !== undefined) {\n      const group = s.groups.get(options.groupId) ?? new Set<string>();\n      group.add(callbackId);\n      s.groups.set(options.groupId, group);\n    }\n    if (options.owner !== undefined) {\n      const owned = s.owners.get(options.owner) ?? new Set<string>();\n      owned.add(callbackId);\n      s.owners.set(options.owner, owned);\n    }\n    this.notifyRegistry();\n    return callbackId;\n  }\n\n  /** Subscribe to results for a callback id. */\n  subscribe<T, C extends CallbackContext = CallbackContext>(callbackId: string, listener: Callback<T, C>): boolean {\n    const entry = this.s.callbacks.get(callbackId);\n    if (!entry) return false;\n    (entry.listeners ??= []).push(listener as Callback<never, never>);\n    return true;\n  }\n\n  /** Unsubscribe a listener from a callback id. */\n  unsubscribe<T, C extends CallbackContext = CallbackContext>(callbackId: string, listener: Callback<T, C>): boolean {\n    const entry = this.s.callbacks.get(callbackId);\n    if (!entry || !entry.listeners) return false;\n    const index = entry.listeners.indexOf(listener as Callback<never, never>);\n    if (index === -1) return false;\n    entry.listeners.splice(index, 1);\n    return true;\n  }\n\n  /** Run a callback once, notify its listeners, then remove it. */\n  trigger<T>(callbackId: string, data: T): void {\n    const entry = this.s.callbacks.get(callbackId);\n    if (!entry) return;\n    void invoke(entry.callback, data);\n    if (entry.listeners && entry.listeners.length > 0) {\n      for (const listener of [...entry.listeners]) void invokeListener(listener, data);\n    }\n    this.deleteEntry(callbackId, true);\n  }\n\n  /** Trigger with merged context and progress; removes unless `removeAfterTrigger: false`. */\n  triggerWithContext<T, C extends CallbackContext = CallbackContext>(\n    callbackId: string,\n    data: T,\n    options?: TriggerOptions<C>,\n  ): void {\n    const entry = this.s.callbacks.get(callbackId);\n    if (!entry) return;\n    const mergedContext: CallbackContext = {\n      ...entry.context,\n      ...options?.context,\n      ...(options?.progress && { progress: options.progress }),\n    };\n    void invoke(entry.callback, data, mergedContext);\n    if (entry.listeners && entry.listeners.length > 0) {\n      for (const listener of [...entry.listeners]) void invokeListener(listener, data, mergedContext);\n    }\n    if (options?.removeAfterTrigger !== false) this.deleteEntry(callbackId, true);\n  }\n\n  /** Trigger every callback in a group. */\n  triggerGroup<T, C extends CallbackContext = CallbackContext>(groupId: string, data: T, options?: TriggerOptions<C>): void {\n    const group = this.s.groups.get(groupId);\n    if (!group) return;\n    for (const callbackId of [...group]) this.triggerWithContext(callbackId, data, options);\n    if (options?.removeAfterTrigger !== false) this.s.groups.delete(groupId);\n  }\n\n  /**\n   * Run the one durable command registered for a group. A command is retained on rejection so its\n   * caller can retry, and is removed only after its promise settles successfully.\n   */\n  async triggerGroupCommand<T, C extends CallbackContext = CallbackContext>(\n    groupId: string,\n    data: T,\n    options?: { context?: C; removeAfterSuccess?: boolean },\n  ): Promise<void> {\n    const group = this.s.groups.get(groupId);\n    const callbackIds = group ? [...group] : [];\n    const callbackId = callbackIds[0];\n    if (callbackIds.length !== 1 || callbackId === undefined) {\n      throw new Error(`Expected exactly one command callback for group \"${groupId}\", found ${callbackIds.length}`);\n    }\n    const entry = this.s.callbacks.get(callbackId);\n    if (!entry) throw new Error(`Command callback \"${callbackId}\" is no longer available`);\n\n    const mergedContext: CallbackContext = { ...entry.context, ...options?.context };\n    await invoke(entry.callback, data, mergedContext);\n\n    // Observers never control command settlement: the command already acknowledged.\n    for (const listener of entry.listeners ?? []) {\n      try {\n        await invokeListener(listener, data, mergedContext);\n      } catch (error) {\n        // eslint-disable-next-line no-console\n        console.error(\"[overlays/handles] command observer failed\", error);\n      }\n    }\n\n    if (options?.removeAfterSuccess !== false) {\n      this.deleteEntry(callbackId, true);\n      this.s.groups.delete(groupId);\n    }\n  }\n\n  /** Report progress to a callback (or every callback of a group) without removing it. */\n  updateProgress(\n    id: string,\n    progress: number,\n    options?: { status?: ProgressInfo[\"status\"]; error?: Error; groupId?: boolean },\n  ): void {\n    const progressInfo: ProgressInfo = { progress, status: options?.status || \"running\" };\n    if (options?.error !== undefined) progressInfo.error = options.error;\n    if (options?.groupId) {\n      this.triggerGroup(id, null, { progress: progressInfo, removeAfterTrigger: false });\n    } else {\n      this.triggerWithContext(id, null, { progress: progressInfo, removeAfterTrigger: false });\n    }\n  }\n\n  /** Create a new, empty group and return its id. */\n  createGroup(): string {\n    const groupId = newHandleId();\n    this.s.groups.set(groupId, new Set());\n    return groupId;\n  }\n\n  /** Remove one entry (and its group/owner membership). */\n  remove(callbackId: string): void {\n    this.deleteEntry(callbackId, true);\n  }\n\n  /** Alias of `remove` — the preferred name when unregistering a handle on unmount. */\n  unregister(callbackId: string): void {\n    this.remove(callbackId);\n  }\n\n  /** The stored callback or object handle for an id, without invoking it. */\n  get<T = unknown>(callbackId: string): T | undefined {\n    return this.s.callbacks.get(callbackId)?.callback as T | undefined;\n  }\n\n  /** True when the id is registered. */\n  has(callbackId: string): boolean {\n    return this.s.callbacks.has(callbackId);\n  }\n\n  /**\n   * Register an object handle (a widget handle, an editor API, …). The object occupies the slot;\n   * it is never invoked by `trigger`, only retrieved with `get`.\n   */\n  registerWidgetHandle<H extends object>(handle: H, options: { owner?: string } = {}): string {\n    return this.registerEntry(handle, options.owner === undefined ? {} : { owner: options.owner });\n  }\n\n  /** Remove a group and all its callbacks. */\n  removeGroup(groupId: string): void {\n    const s = this.s;\n    const group = s.groups.get(groupId);\n    if (!group) return;\n    s.groups.delete(groupId);\n    for (const callbackId of [...group]) this.deleteEntry(callbackId, false);\n    this.notifyRegistry();\n  }\n\n  /** Remove everything registered with `owner` (an InstanceKey). Returns how many were removed. */\n  disposeOwner(owner: string): number {\n    const s = this.s;\n    const owned = s.owners.get(owner);\n    if (!owned) return 0;\n    s.owners.delete(owner);\n    const ids = [...owned];\n    for (const callbackId of ids) this.deleteEntry(callbackId, false);\n    if (ids.length > 0) this.notifyRegistry();\n    return ids.length;\n  }\n\n  /** Ids currently owned by `owner`. */\n  ownedBy(owner: string): readonly string[] {\n    return [...(this.s.owners.get(owner) ?? [])];\n  }\n\n  /** The member ids of a group (empty when unknown). */\n  groupMembers(groupId: string): readonly string[] {\n    return [...(this.s.groups.get(groupId) ?? [])];\n  }\n\n  /** Total registered entries (diagnostics, leak tests). */\n  size(): number {\n    return this.s.callbacks.size;\n  }\n\n  /**\n   * The one removal path. Reads the entry BEFORE deleting it so group and owner membership shrink\n   * (the old `removeFromGroups`-after-delete bug), then runs the entry's removal hook.\n   */\n  private deleteEntry(callbackId: string, notify: boolean): void {\n    const s = this.s;\n    const entry = s.callbacks.get(callbackId);\n    if (!entry) return;\n    s.callbacks.delete(callbackId);\n    if (entry.groupId !== undefined) {\n      const group = s.groups.get(entry.groupId);\n      group?.delete(callbackId);\n      if (group?.size === 0) s.groups.delete(entry.groupId);\n    }\n    if (entry.owner !== undefined) {\n      const owned = s.owners.get(entry.owner);\n      owned?.delete(callbackId);\n      if (owned?.size === 0) s.owners.delete(entry.owner);\n    }\n    if (notify) this.notifyRegistry();\n    entry.onRemove?.();\n  }\n}\n\n/** The process-wide handles registry (state in the global slot; every instance shares it). */\nexport const callbackManager = new CallbackManager();\n\n/** Remove everything owned by an open instance (`overlayId:instanceId`). */\nexport function disposeOwner(owner: string): number {\n  return callbackManager.disposeOwner(owner);\n}\n","/** A fresh handle id: `crypto.randomUUID` when present, else a v4 UUID from `getRandomValues`. */\nexport function newHandleId(): string {\n  const c: Crypto | undefined = typeof globalThis.crypto === \"undefined\" ? undefined : globalThis.crypto;\n  if (c && typeof c.randomUUID === \"function\") return c.randomUUID();\n  const bytes = new Uint8Array(16);\n  if (c && typeof c.getRandomValues === \"function\") {\n    c.getRandomValues(bytes);\n  } else {\n    for (let i = 0; i < 16; i += 1) bytes[i] = Math.floor(Math.random() * 256);\n  }\n  bytes[6] = ((bytes[6] ?? 0) & 0x0f) | 0x40;\n  bytes[8] = ((bytes[8] ?? 0) & 0x3f) | 0x80;\n  const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, \"0\")).join(\"\");\n  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;\n}\n","/**\n * Typed helpers over the handles registry: imperative object handles, event channels and one-shot\n * requests. Each is stored in the same registry (so its id can ride overlay open data and `get`\n * still resolves it) and accepts an `owner` InstanceKey so closing the owning overlay disposes it.\n */\nimport { callbackManager } from \"./callbackManager\";\n\nexport interface OwnerOption {\n  /** The InstanceKey (`overlayId:instanceId`) that owns this handle; disposed when it closes. */\n  owner?: string;\n}\n\n/** Thrown into a request's promise when it is disposed before being answered. */\nexport class HandleDisposedError extends Error {\n  readonly handleId: string;\n  constructor(handleId: string, message = `[overlays/handles] \"${handleId}\" was disposed before it settled`) {\n    super(message);\n    this.name = \"HandleDisposedError\";\n    this.handleId = handleId;\n  }\n}\n\nfunction ownerOptions(options: OwnerOption | undefined): { owner?: string } {\n  return options?.owner === undefined ? {} : { owner: options.owner };\n}\n\n// ── Imperative object handles ────────────────────────────────────────────────────────────────\n\n/**\n * Register an imperative object handle under a caller-chosen id (an editor API, a widget handle,\n * a ref's methods). Re-registering an id replaces the previous handle. Returns a disposer that\n * removes the handle only if it is still the one registered (safe for React effect cleanup).\n */\nexport function registerHandle<T extends object>(id: string, handle: T, options?: OwnerOption): () => void {\n  callbackManager.registerEntry(handle, { id, ...ownerOptions(options) });\n  return () => {\n    if (callbackManager.get<T>(id) === handle) callbackManager.remove(id);\n  };\n}\n\n/** The object handle registered under `id`, or undefined. */\nexport function getHandle<T extends object>(id: string): T | undefined {\n  const value = callbackManager.get<unknown>(id);\n  return typeof value === \"object\" && value !== null ? (value as T) : undefined;\n}\n\n/** Remove the handle registered under `id`. */\nexport function removeHandle(id: string): void {\n  callbackManager.remove(id);\n}\n\n// ── Event channels ───────────────────────────────────────────────────────────────────────────\n\nexport interface EventChannel<Events> {\n  readonly id: string;\n  /** Deliver an event to every subscriber (no-op after dispose). */\n  emit(event: Events): void;\n  /** Listen; returns the unsubscribe. */\n  subscribe(listener: (event: Events) => void): () => void;\n  /** Remove the channel and drop every subscriber. */\n  dispose(): void;\n  readonly disposed: boolean;\n}\n\n/**\n * A many-shot event stream between an opener and an overlay. Pass `channel.id` in open data; the\n * overlay resolves it with `getEventChannel(id)`.\n */\nexport function createEventChannel<Events>(options?: OwnerOption & { readonly id?: string }): EventChannel<Events> {\n  const listeners = new Set<(event: Events) => void>();\n  let disposed = false;\n  let id = \"\";\n  const channel: EventChannel<Events> = {\n    get id() {\n      return id;\n    },\n    get disposed() {\n      return disposed;\n    },\n    emit(event) {\n      if (disposed) return;\n      for (const listener of [...listeners]) listener(event);\n    },\n    subscribe(listener) {\n      if (disposed) return () => {};\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    dispose() {\n      if (disposed) return;\n      callbackManager.remove(id);\n    },\n  };\n  id = callbackManager.registerEntry(channel, {\n    ...(options?.id === undefined ? {} : { id: options.id }),\n    ...ownerOptions(options),\n    onRemove: () => {\n      disposed = true;\n      listeners.clear();\n    },\n  });\n  return channel;\n}\n\n/** The channel registered under `id`, or undefined once disposed. */\nexport function getEventChannel<Events>(id: string): EventChannel<Events> | undefined {\n  return getHandle<EventChannel<Events>>(id);\n}\n\n// ── One-shot requests ────────────────────────────────────────────────────────────────────────\n\nexport interface PendingRequest<Req, Res> {\n  readonly id: string;\n  /** What the asker sent. */\n  readonly request: Req;\n  /** Answer the request (first answer wins; later calls are ignored). */\n  resolve(response: Res): void;\n  /** Fail the request. */\n  reject(reason: unknown): void;\n  readonly settled: boolean;\n}\n\nexport interface RequestHandle<Req, Res> extends PendingRequest<Req, Res> {\n  /** Settles with the answer; rejects with `HandleDisposedError` when disposed unanswered. */\n  readonly promise: Promise<Res>;\n  /** Remove the request; an unanswered one rejects. */\n  dispose(): void;\n}\n\n/**\n * A one-shot promise bridge: the asker awaits `promise`, the overlay answers through\n * `getRequest(id).resolve(…)`. Disposing it unanswered (or closing its owner) rejects.\n */\nexport function createRequest<Req, Res>(request: Req, options?: OwnerOption): RequestHandle<Req, Res> {\n  let settle!: (response: Res) => void;\n  let fail!: (reason: unknown) => void;\n  const promise = new Promise<Res>((resolve, reject) => {\n    settle = resolve;\n    fail = reject;\n  });\n  // A disposed request nobody awaited must not surface as an unhandled rejection.\n  promise.catch(() => {});\n  let settled = false;\n  let id = \"\";\n  const handle: RequestHandle<Req, Res> = {\n    get id() {\n      return id;\n    },\n    request,\n    promise,\n    get settled() {\n      return settled;\n    },\n    resolve(response) {\n      if (settled) return;\n      settled = true;\n      settle(response);\n      callbackManager.remove(id);\n    },\n    reject(reason) {\n      if (settled) return;\n      settled = true;\n      fail(reason);\n      callbackManager.remove(id);\n    },\n    dispose() {\n      callbackManager.remove(id);\n    },\n  };\n  id = callbackManager.registerEntry(handle, {\n    ...ownerOptions(options),\n    onRemove: () => {\n      if (settled) return;\n      settled = true;\n      fail(new HandleDisposedError(id));\n    },\n  });\n  return handle;\n}\n\n/** The pending request registered under `id`, or undefined once answered or disposed. */\nexport function getRequest<Req, Res>(id: string): PendingRequest<Req, Res> | undefined {\n  return getHandle<RequestHandle<Req, Res>>(id);\n}\n"],"mappings":"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","names":[]}

package/dist/helpers-2NY1ha0V.d.cts

@@ -0,0 +1,63 @@
+interface OwnerOption {
+    /** The InstanceKey (`overlayId:instanceId`) that owns this handle; disposed when it closes. */
+    owner?: string;
+}
+/** Thrown into a request's promise when it is disposed before being answered. */
+declare class HandleDisposedError extends Error {
+    readonly handleId: string;
+    constructor(handleId: string, message?: string);
+}
+/**
+ * Register an imperative object handle under a caller-chosen id (an editor API, a widget handle,
+ * a ref's methods). Re-registering an id replaces the previous handle. Returns a disposer that
+ * removes the handle only if it is still the one registered (safe for React effect cleanup).
+ */
+declare function registerHandle<T extends object>(id: string, handle: T, options?: OwnerOption): () => void;
+/** The object handle registered under `id`, or undefined. */
+declare function getHandle<T extends object>(id: string): T | undefined;
+/** Remove the handle registered under `id`. */
+declare function removeHandle(id: string): void;
+interface EventChannel<Events> {
+    readonly id: string;
+    /** Deliver an event to every subscriber (no-op after dispose). */
+    emit(event: Events): void;
+    /** Listen; returns the unsubscribe. */
+    subscribe(listener: (event: Events) => void): () => void;
+    /** Remove the channel and drop every subscriber. */
+    dispose(): void;
+    readonly disposed: boolean;
+}
+/**
+ * A many-shot event stream between an opener and an overlay. Pass `channel.id` in open data; the
+ * overlay resolves it with `getEventChannel(id)`.
+ */
+declare function createEventChannel<Events>(options?: OwnerOption & {
+    readonly id?: string;
+}): EventChannel<Events>;
+/** The channel registered under `id`, or undefined once disposed. */
+declare function getEventChannel<Events>(id: string): EventChannel<Events> | undefined;
+interface PendingRequest<Req, Res> {
+    readonly id: string;
+    /** What the asker sent. */
+    readonly request: Req;
+    /** Answer the request (first answer wins; later calls are ignored). */
+    resolve(response: Res): void;
+    /** Fail the request. */
+    reject(reason: unknown): void;
+    readonly settled: boolean;
+}
+interface RequestHandle<Req, Res> extends PendingRequest<Req, Res> {
+    /** Settles with the answer; rejects with `HandleDisposedError` when disposed unanswered. */
+    readonly promise: Promise<Res>;
+    /** Remove the request; an unanswered one rejects. */
+    dispose(): void;
+}
+/**
+ * A one-shot promise bridge: the asker awaits `promise`, the overlay answers through
+ * `getRequest(id).resolve(…)`. Disposing it unanswered (or closing its owner) rejects.
+ */
+declare function createRequest<Req, Res>(request: Req, options?: OwnerOption): RequestHandle<Req, Res>;
+/** The pending request registered under `id`, or undefined once answered or disposed. */
+declare function getRequest<Req, Res>(id: string): PendingRequest<Req, Res> | undefined;
+
+export { type EventChannel as E, HandleDisposedError as H, type OwnerOption as O, type PendingRequest as P, type RequestHandle as R, createRequest as a, getHandle as b, createEventChannel as c, getRequest as d, removeHandle as e, getEventChannel as g, registerHandle as r };

package/dist/helpers-2NY1ha0V.d.ts

@@ -0,0 +1,63 @@
+interface OwnerOption {
+    /** The InstanceKey (`overlayId:instanceId`) that owns this handle; disposed when it closes. */
+    owner?: string;
+}
+/** Thrown into a request's promise when it is disposed before being answered. */
+declare class HandleDisposedError extends Error {
+    readonly handleId: string;
+    constructor(handleId: string, message?: string);
+}
+/**
+ * Register an imperative object handle under a caller-chosen id (an editor API, a widget handle,
+ * a ref's methods). Re-registering an id replaces the previous handle. Returns a disposer that
+ * removes the handle only if it is still the one registered (safe for React effect cleanup).
+ */
+declare function registerHandle<T extends object>(id: string, handle: T, options?: OwnerOption): () => void;
+/** The object handle registered under `id`, or undefined. */
+declare function getHandle<T extends object>(id: string): T | undefined;
+/** Remove the handle registered under `id`. */
+declare function removeHandle(id: string): void;
+interface EventChannel<Events> {
+    readonly id: string;
+    /** Deliver an event to every subscriber (no-op after dispose). */
+    emit(event: Events): void;
+    /** Listen; returns the unsubscribe. */
+    subscribe(listener: (event: Events) => void): () => void;
+    /** Remove the channel and drop every subscriber. */
+    dispose(): void;
+    readonly disposed: boolean;
+}
+/**
+ * A many-shot event stream between an opener and an overlay. Pass `channel.id` in open data; the
+ * overlay resolves it with `getEventChannel(id)`.
+ */
+declare function createEventChannel<Events>(options?: OwnerOption & {
+    readonly id?: string;
+}): EventChannel<Events>;
+/** The channel registered under `id`, or undefined once disposed. */
+declare function getEventChannel<Events>(id: string): EventChannel<Events> | undefined;
+interface PendingRequest<Req, Res> {
+    readonly id: string;
+    /** What the asker sent. */
+    readonly request: Req;
+    /** Answer the request (first answer wins; later calls are ignored). */
+    resolve(response: Res): void;
+    /** Fail the request. */
+    reject(reason: unknown): void;
+    readonly settled: boolean;
+}
+interface RequestHandle<Req, Res> extends PendingRequest<Req, Res> {
+    /** Settles with the answer; rejects with `HandleDisposedError` when disposed unanswered. */
+    readonly promise: Promise<Res>;
+    /** Remove the request; an unanswered one rejects. */
+    dispose(): void;
+}
+/**
+ * A one-shot promise bridge: the asker awaits `promise`, the overlay answers through
+ * `getRequest(id).resolve(…)`. Disposing it unanswered (or closing its owner) rejects.
+ */
+declare function createRequest<Req, Res>(request: Req, options?: OwnerOption): RequestHandle<Req, Res>;
+/** The pending request registered under `id`, or undefined once answered or disposed. */
+declare function getRequest<Req, Res>(id: string): PendingRequest<Req, Res> | undefined;
+
+export { type EventChannel as E, HandleDisposedError as H, type OwnerOption as O, type PendingRequest as P, type RequestHandle as R, createRequest as a, getHandle as b, createEventChannel as c, getRequest as d, removeHandle as e, getEventChannel as g, registerHandle as r };