@pixerate/editor 0.22.0 → 0.24.0

package/dist/persistence/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/persistence/recoveryPolicy.ts","../../src/persistence/storage.ts","../../src/persistence/autosave.ts","../../src/persistence/revisions.ts"],"sourcesContent":["// Portions ported from filmcraft-main/apps/filmcraft-web/src/recovery_policy.rs (MIT OR Apache-2.0,\n// © ArtCraft Team and contributors). See THIRD_PARTY_NOTICES.md.\n\n/**\n * What the caller should do now (see `RecoveryPolicy.tick`).\n *\n * - `writeSnapshot`: write the snapshot and a dirty meta for `revision`, then report with `written`.\n * - `writeClean`: write a clean meta (retire the snapshot), then report with `cleaned`.\n * - `wakeAfter`: nothing now; tick again after `delay` (same unit as `now`).\n */\nexport type RecoveryAction =\n  | { type: \"nothing\" }\n  | { type: \"writeSnapshot\"; revision: number }\n  | { type: \"writeClean\" }\n  | { type: \"wakeAfter\"; delay: number };\n\nexport interface RecoveryPolicyOptions {\n  /**\n   * Minimum time between snapshots of a changing document, in the unit of `now`\n   * (default 5000, i.e. milliseconds).\n   */\n  interval?: number;\n  /**\n   * Wait before retrying after the `failures`-th consecutive failed write\n   * (default: `interval`, as in FilmCraft). Use `exponentialBackoff` for doubling delays.\n   */\n  retryDelay?: (failures: number) => number;\n}\n\nexport interface RecoveryTickOptions {\n  /** Ignore the interval and any retry wait (e.g. on `pagehide`). */\n  force?: boolean;\n}\n\nexport interface RecoveryPolicy {\n  /** Called whenever something may have changed, with the revisions and the current time. */\n  tick(\n    now: number,\n    revision: number,\n    savedRevision: number,\n    options?: RecoveryTickOptions,\n  ): RecoveryAction;\n  /** The snapshot write for `revision` finished. */\n  written(revision: number, ok: boolean, now: number): void;\n  /** The clean-meta write finished. */\n  cleaned(ok: boolean, now: number): void;\n  /** Whether this session wrote a dirty snapshot that is not retired yet. */\n  readonly ownsSnapshot: boolean;\n  /** Consecutive failed writes (reset by a successful one). */\n  readonly failures: number;\n}\n\n/**\n * Exponential backoff: `base`, `2·base`, `4·base`, … capped at `max`.\n * `failures` is 1 for the first failure.\n */\nexport function exponentialBackoff(\n  failures: number,\n  base = 1000,\n  max = 30000,\n): number {\n  const exp = Math.min(Math.max(failures - 1, 0), 16);\n  return Math.min(base * 2 ** exp, max);\n}\n\n/**\n * Pure state machine deciding when a crash-recovery snapshot is written or\n * retired. Deterministic: time is always passed in.\n *\n * - A dirty document is snapshotted at most every `interval`, once per revision.\n *   A write that fails is retried after `retryDelay`, without waiting for another edit.\n * - The snapshot is marked clean only if this session wrote it. A snapshot left by an\n *   earlier session (that was not restored) stays dirty, so it can still be recovered.\n * - An edit made while the clean write is in flight keeps the snapshot owned.\n */\nexport function createRecoveryPolicy(\n  options: RecoveryPolicyOptions = {},\n): RecoveryPolicy {\n  const interval = options.interval ?? 5000;\n  const retryDelay = options.retryDelay ?? (() => interval);\n  const minWake = interval * 0.01;\n\n  /** Revision whose snapshot was last written or is being written. */\n  let lastRevision: number | null = null;\n  let lastTime: number | null = null;\n  /** Required gap after `lastTime`: the interval, or the retry delay after a failure. */\n  let gap = interval;\n  /** This session wrote a dirty meta that is not yet retired. */\n  let ownsDirtyMeta = false;\n  /** A clean-meta write is in flight. */\n  let cleaning = false;\n  /** Snapshot writes started so far, and how many had started when the clean write did. */\n  let snapshots = 0;\n  let snapshotsAtClean = 0;\n  let failures = 0;\n\n  const fail = (now: number) => {\n    failures++;\n    lastRevision = null;\n    lastTime = now;\n    gap = retryDelay(failures);\n  };\n\n  return {\n    tick(now, revision, savedRevision, tickOptions) {\n      const force = tickOptions?.force === true;\n      const since = force || lastTime === null ? Infinity : now - lastTime;\n      if (revision !== savedRevision) {\n        if (lastRevision === revision) return { type: \"nothing\" };\n        if (since >= gap) {\n          lastRevision = revision;\n          lastTime = now;\n          ownsDirtyMeta = true;\n          snapshots++;\n          return { type: \"writeSnapshot\", revision };\n        }\n        return { type: \"wakeAfter\", delay: Math.max(gap - since, minWake) };\n      }\n      if (ownsDirtyMeta && !cleaning) {\n        if (lastRevision !== null || since >= gap) {\n          cleaning = true;\n          snapshotsAtClean = snapshots;\n          return { type: \"writeClean\" };\n        }\n        return { type: \"wakeAfter\", delay: Math.max(gap - since, minWake) };\n      }\n      return { type: \"nothing\" };\n    },\n    written(revision, ok, now) {\n      if (ok) {\n        if (lastRevision === revision) {\n          failures = 0;\n          gap = interval;\n        }\n      } else if (lastRevision === revision) {\n        // retry after the delay, even if nothing else changes\n        fail(now);\n      }\n    },\n    cleaned(ok, now) {\n      cleaning = false;\n      if (ok) {\n        ownsDirtyMeta = snapshots !== snapshotsAtClean;\n        failures = 0;\n        gap = interval;\n      } else {\n        fail(now);\n      }\n    },\n    get ownsSnapshot() {\n      return ownsDirtyMeta;\n    },\n    get failures() {\n      return failures;\n    },\n  };\n}\n","/**\n * Key/value storage adapters for autosave and crash recovery. Every adapter is\n * async, stores strings, feature-detects its backend (an unavailable backend\n * rejects every call with `StorageUnavailableError` instead of throwing at\n * construction, so SSR and old browsers are safe) and accepts an injectable\n * failure mode for tests.\n */\n\nexport type StorageOperation = \"get\" | \"set\" | \"remove\";\n\n/**\n * Injected failure: return `true` (or an `Error`) to make that operation fail.\n * Example: `failure: (op) => op === \"set\"` simulates a full disk.\n */\nexport type StorageFailureMode = (\n  operation: StorageOperation,\n  key: string,\n) => boolean | Error | undefined | void;\n\nexport interface StorageAdapter {\n  /** Short backend name, e.g. `\"memory\"`, `\"localStorage\"`, `\"indexedDB\"`, `\"opfs\"`. */\n  readonly kind: string;\n  /** Whether the backend was found. When `false`, every call rejects. */\n  readonly available: boolean;\n  get(key: string): Promise<string | null>;\n  set(key: string, value: string): Promise<void>;\n  remove(key: string): Promise<void>;\n}\n\nexport interface StorageAdapterOptions {\n  failure?: StorageFailureMode;\n}\n\nexport class StorageUnavailableError extends Error {\n  constructor(kind: string) {\n    super(`${kind} storage is not available in this environment`);\n    this.name = \"StorageUnavailableError\";\n  }\n}\n\nexport class InjectedStorageError extends Error {\n  constructor(operation: StorageOperation, key: string) {\n    super(`injected ${operation} failure for \"${key}\"`);\n    this.name = \"InjectedStorageError\";\n  }\n}\n\nfunction checkFailure(\n  failure: StorageFailureMode | undefined,\n  operation: StorageOperation,\n  key: string,\n): void {\n  if (!failure) return;\n  const result = failure(operation, key);\n  if (result instanceof Error) throw result;\n  if (result) throw new InjectedStorageError(operation, key);\n}\n\n/** Wraps an adapter so `failure` can make any of its operations fail. */\nexport function withStorageFailures(\n  inner: StorageAdapter,\n  failure: StorageFailureMode,\n): StorageAdapter {\n  return {\n    kind: inner.kind,\n    get available() {\n      return inner.available;\n    },\n    async get(key) {\n      checkFailure(failure, \"get\", key);\n      return inner.get(key);\n    },\n    async set(key, value) {\n      checkFailure(failure, \"set\", key);\n      return inner.set(key, value);\n    },\n    async remove(key) {\n      checkFailure(failure, \"remove\", key);\n      return inner.remove(key);\n    },\n  };\n}\n\nfunction guarded(\n  kind: string,\n  isAvailable: () => boolean,\n  failure: StorageFailureMode | undefined,\n  impl: Omit<StorageAdapter, \"kind\" | \"available\">,\n): StorageAdapter {\n  const check = (operation: StorageOperation, key: string) => {\n    if (!isAvailable()) throw new StorageUnavailableError(kind);\n    checkFailure(failure, operation, key);\n  };\n  return {\n    kind,\n    get available() {\n      return isAvailable();\n    },\n    async get(key) {\n      check(\"get\", key);\n      return impl.get(key);\n    },\n    async set(key, value) {\n      check(\"set\", key);\n      return impl.set(key, value);\n    },\n    async remove(key) {\n      check(\"remove\", key);\n      return impl.remove(key);\n    },\n  };\n}\n\n// ---------------------------------------------------------------- memory\n\nexport interface MemoryStorage extends StorageAdapter {\n  /** The underlying map (inspect it in tests). */\n  readonly entries: Map<string, string>;\n}\n\n/** In-memory storage (tests, SSR, or a session-only fallback). */\nexport function createMemoryStorage(\n  options: StorageAdapterOptions & { initial?: Record<string, string> } = {},\n): MemoryStorage {\n  const entries = new Map<string, string>(Object.entries(options.initial ?? {}));\n  const adapter = guarded(\"memory\", () => true, options.failure, {\n    async get(key) {\n      return entries.has(key) ? (entries.get(key) as string) : null;\n    },\n    async set(key, value) {\n      entries.set(key, value);\n    },\n    async remove(key) {\n      entries.delete(key);\n    },\n  });\n  return Object.assign(adapter, { entries });\n}\n\n// ---------------------------------------------------------------- localStorage\n\n/** Minimal `Storage` surface used by the localStorage adapter. */\nexport interface WebStorageLike {\n  getItem(key: string): string | null;\n  setItem(key: string, value: string): void;\n  removeItem(key: string): void;\n}\n\nexport interface LocalStorageAdapterOptions extends StorageAdapterOptions {\n  /** Storage to use (default `globalThis.localStorage`, e.g. pass `sessionStorage`). */\n  storage?: WebStorageLike;\n}\n\nfunction detectLocalStorage(): WebStorageLike | undefined {\n  try {\n    const storage = (globalThis as { localStorage?: WebStorageLike }).localStorage;\n    return storage && typeof storage.getItem === \"function\" ? storage : undefined;\n  } catch {\n    // Accessing localStorage throws when site data is blocked.\n    return undefined;\n  }\n}\n\n/** Whether `localStorage` can be used (it throws when site data is blocked). */\nexport function isLocalStorageAvailable(): boolean {\n  return detectLocalStorage() !== undefined;\n}\n\n/**\n * `localStorage` adapter; every key is prefixed with `prefix`. Writes are\n * synchronous under the hood, so they complete even inside `pagehide`.\n * A full quota rejects the `set` (`QuotaExceededError`).\n */\nexport function createLocalStorageAdapter(\n  prefix = \"\",\n  options: LocalStorageAdapterOptions = {},\n): StorageAdapter {\n  const storage = options.storage ?? detectLocalStorage();\n  return guarded(\"localStorage\", () => storage !== undefined, options.failure, {\n    async get(key) {\n      return storage!.getItem(prefix + key);\n    },\n    async set(key, value) {\n      storage!.setItem(prefix + key, value);\n    },\n    async remove(key) {\n      storage!.removeItem(prefix + key);\n    },\n  });\n}\n\n// ---------------------------------------------------------------- IndexedDB\n\n/** Minimal `IDBFactory` surface (the real `indexedDB`, or a fake in tests). */\nexport interface IdbFactoryLike {\n  open(name: string, version?: number): any;\n}\n\nexport interface IndexedDbAdapterOptions extends StorageAdapterOptions {\n  /** Object store name (default `\"kv\"`). */\n  store?: string;\n  /** Factory to use (default `globalThis.indexedDB`). */\n  indexedDB?: IdbFactoryLike;\n}\n\nfunction detectIndexedDb(): IdbFactoryLike | undefined {\n  try {\n    const factory = (globalThis as { indexedDB?: IdbFactoryLike }).indexedDB;\n    return factory && typeof factory.open === \"function\" ? factory : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** Whether `indexedDB` exists in this environment. */\nexport function isIndexedDbAvailable(): boolean {\n  return detectIndexedDb() !== undefined;\n}\n\nconst requestToPromise = <T>(request: any): Promise<T> =>\n  new Promise((resolve, reject) => {\n    request.onsuccess = () => resolve(request.result as T);\n    request.onerror = () => reject(request.error ?? new Error(\"IndexedDB request failed\"));\n  });\n\n/**\n * IndexedDB adapter: one database `name` with a single key/value object store.\n * A `set` resolves when its transaction completes (not merely when the request\n * succeeds), so a resolved write is durable.\n */\nexport function createIndexedDbAdapter(\n  name = \"pixerate-editor\",\n  options: IndexedDbAdapterOptions = {},\n): StorageAdapter {\n  const factory = options.indexedDB ?? detectIndexedDb();\n  const storeName = options.store ?? \"kv\";\n  let dbPromise: Promise<any> | null = null;\n\n  const open = (): Promise<any> => {\n    dbPromise ??= new Promise((resolve, reject) => {\n      const request = factory!.open(name, 1);\n      request.onupgradeneeded = () => {\n        const db = request.result;\n        if (!db.objectStoreNames.contains(storeName)) db.createObjectStore(storeName);\n      };\n      request.onsuccess = () => resolve(request.result);\n      request.onerror = () => {\n        dbPromise = null;\n        reject(request.error ?? new Error(\"IndexedDB open failed\"));\n      };\n    });\n    return dbPromise;\n  };\n\n  const write = async (fn: (store: any) => void): Promise<void> => {\n    const db = await open();\n    await new Promise<void>((resolve, reject) => {\n      const tx = db.transaction(storeName, \"readwrite\");\n      tx.oncomplete = () => resolve();\n      tx.onerror = () => reject(tx.error ?? new Error(\"IndexedDB transaction failed\"));\n      tx.onabort = () => reject(tx.error ?? new Error(\"IndexedDB transaction aborted\"));\n      fn(tx.objectStore(storeName));\n    });\n  };\n\n  return guarded(\"indexedDB\", () => factory !== undefined, options.failure, {\n    async get(key) {\n      const db = await open();\n      const tx = db.transaction(storeName, \"readonly\");\n      const value = await requestToPromise<unknown>(tx.objectStore(storeName).get(key));\n      return typeof value === \"string\" ? value : null;\n    },\n    set: (key, value) => write((store) => store.put(value, key)),\n    remove: (key) => write((store) => store.delete(key)),\n  });\n}\n\n// ---------------------------------------------------------------- OPFS\n\n/** Minimal `FileSystemDirectoryHandle` surface used by the OPFS adapter. */\nexport interface OpfsDirectoryLike {\n  getDirectoryHandle(name: string, options?: { create?: boolean }): Promise<OpfsDirectoryLike>;\n  getFileHandle(name: string, options?: { create?: boolean }): Promise<OpfsFileLike>;\n  removeEntry(name: string): Promise<void>;\n}\n\nexport interface OpfsFileLike {\n  getFile(): Promise<{ text(): Promise<string> }>;\n  createWritable?(): Promise<{ write(data: string): Promise<void>; close(): Promise<void> }>;\n  /** Rename in place (Chromium, Safari). Used for temp-file + rename writes. */\n  move?(name: string): Promise<void>;\n}\n\nexport interface OpfsAdapterOptions extends StorageAdapterOptions {\n  /** Root directory (default `navigator.storage.getDirectory()`). */\n  root?: () => Promise<OpfsDirectoryLike>;\n  /** Force the write-then-pointer-swap strategy even when `move` exists. */\n  disableRename?: boolean;\n}\n\nfunction detectOpfsRoot(): (() => Promise<OpfsDirectoryLike>) | undefined {\n  try {\n    const storage = (globalThis as any).navigator?.storage;\n    if (storage && typeof storage.getDirectory === \"function\") {\n      return () => storage.getDirectory();\n    }\n  } catch {\n    // ignore\n  }\n  return undefined;\n}\n\n/** Whether the Origin Private File System exists (`navigator.storage.getDirectory`). */\nexport function isOpfsAvailable(): boolean {\n  return detectOpfsRoot() !== undefined;\n}\n\nconst isNotFound = (error: unknown) =>\n  !!error && typeof error === \"object\" && (error as { name?: string }).name === \"NotFoundError\";\n\n/**\n * Origin Private File System adapter. Values are files in `dir` (created on\n * demand), named after the URI-encoded key.\n *\n * Writes never leave a half-written value behind: where file handles support\n * `move`, the value is written to `<file>.tmp` and renamed over `<file>`;\n * otherwise it alternates between two slots (`<file>.a` / `<file>.b`) and then\n * swaps a pointer file (`<file>.ptr`), so a crash mid-write keeps the previous\n * value. Main-thread writes need `createWritable` (missing in some Safari\n * versions); without it, `set` rejects with `StorageUnavailableError`.\n */\nexport function createOpfsAdapter(\n  dir = \"pixerate-editor\",\n  options: OpfsAdapterOptions = {},\n): StorageAdapter {\n  const getRoot = options.root ?? detectOpfsRoot();\n  let dirPromise: Promise<OpfsDirectoryLike> | null = null;\n  const directory = () => {\n    dirPromise ??= getRoot!().then((root) => root.getDirectoryHandle(dir, { create: true }));\n    dirPromise.catch(() => {\n      dirPromise = null;\n    });\n    return dirPromise;\n  };\n  const fileName = (key: string) => encodeURIComponent(key) || \"_\";\n\n  const readFile = async (d: OpfsDirectoryLike, name: string): Promise<string | null> => {\n    try {\n      const handle = await d.getFileHandle(name);\n      return await (await handle.getFile()).text();\n    } catch (error) {\n      if (isNotFound(error)) return null;\n      throw error;\n    }\n  };\n\n  const writeFile = async (d: OpfsDirectoryLike, name: string, value: string) => {\n    const handle = await d.getFileHandle(name, { create: true });\n    if (typeof handle.createWritable !== \"function\") {\n      throw new StorageUnavailableError(\"opfs (createWritable)\");\n    }\n    const writable = await handle.createWritable();\n    await writable.write(value);\n    await writable.close();\n    return handle;\n  };\n\n  const removeFile = async (d: OpfsDirectoryLike, name: string) => {\n    try {\n      await d.removeEntry(name);\n    } catch (error) {\n      if (!isNotFound(error)) throw error;\n    }\n  };\n\n  return guarded(\"opfs\", () => getRoot !== undefined, options.failure, {\n    async get(key) {\n      const d = await directory();\n      const base = fileName(key);\n      const pointer = await readFile(d, `${base}.ptr`);\n      if (pointer === \"a\" || pointer === \"b\") return readFile(d, `${base}.${pointer}`);\n      return readFile(d, base);\n    },\n    async set(key, value) {\n      const d = await directory();\n      const base = fileName(key);\n      const pointer = await readFile(d, `${base}.ptr`);\n      if (!options.disableRename && pointer === null) {\n        const tmp = await writeFile(d, `${base}.tmp`, value);\n        if (typeof tmp.move === \"function\") {\n          await tmp.move(base);\n          return;\n        }\n        await removeFile(d, `${base}.tmp`);\n      }\n      // Write-then-pointer swap: the pointer only moves once the new slot is complete.\n      const next = pointer === \"a\" ? \"b\" : \"a\";\n      await writeFile(d, `${base}.${next}`, value);\n      await writeFile(d, `${base}.ptr`, next);\n    },\n    async remove(key) {\n      const d = await directory();\n      const base = fileName(key);\n      for (const name of [`${base}.ptr`, base, `${base}.a`, `${base}.b`, `${base}.tmp`]) {\n        await removeFile(d, name);\n      }\n    },\n  });\n}\n","// Portions ported from filmcraft-main/apps/filmcraft-web/src/recovery.rs and\n// craft-libs-main/crates/settings/src/store.rs (MIT OR Apache-2.0, © ArtCraft Team and\n// contributors). See THIRD_PARTY_NOTICES.md.\n\nimport {\n  createRecoveryPolicy,\n  exponentialBackoff,\n  type RecoveryAction,\n  type RecoveryPolicy,\n} from \"./recoveryPolicy\";\nimport type { StorageAdapter } from \"./storage\";\n\nexport type AutosaveStatus = \"idle\" | \"dirty\" | \"saving\" | \"saved\" | \"error\";\n\nexport interface AutosaveStatusInfo {\n  status: AutosaveStatus;\n  /** Last write error (while `status` is `\"error\"`). */\n  error: unknown;\n  /** Consecutive failed writes. */\n  failures: number;\n  /** When the next attempt is due (`now()` units), while waiting. */\n  nextAttemptAt: number | null;\n  /** When the last snapshot was written (`now()` units). */\n  lastSavedAt: number | null;\n  /** Whether `ready()` was called. */\n  ready: boolean;\n}\n\n/** Stored next to the snapshot (`<key>:meta`). */\nexport interface RecoveryMeta {\n  dirty: boolean;\n  revision?: number;\n  /** `Date.now()` of the write. */\n  time?: number;\n  /** Document name, for the \"Restore unsaved changes from …?\" prompt. */\n  name?: string;\n}\n\nexport interface AutosaveRecovery<T = unknown> {\n  /** The parsed snapshot (`undefined` when `deserialize` threw; see `error`). */\n  snapshot: T | undefined;\n  /** The stored text. */\n  text: string;\n  meta: RecoveryMeta & { dirty: true };\n  error?: unknown;\n}\n\nexport interface AutosaveControllerOptions<T> {\n  storage: StorageAdapter;\n  /** Snapshot key; the meta lives at `<key>:meta`. */\n  key: string;\n  /** Reads the current document. */\n  getSnapshot: () => T;\n  /** Default `JSON.stringify`. */\n  serialize?: (snapshot: T) => string;\n  /** Default `JSON.parse` (used by `checkRecovery`). */\n  deserialize?: (text: string) => T;\n  /** Current document revision; must change on every edit. */\n  revision: () => number;\n  /** Revision of the last explicit save (equal to `revision()` when clean). */\n  savedRevision: () => number;\n  /** Document name stored in the meta. */\n  name?: string | (() => string | undefined);\n  onStatus?: (info: AutosaveStatusInfo) => void;\n  /** Minimum time between snapshots while edits keep coming (default 5000 ms). */\n  interval?: number;\n  /** Quiet time after the last edit before a snapshot is written (default 1000 ms). */\n  debounceMs?: number;\n  /** First retry delay after a failed write; doubles per failure (default 1000 ms). */\n  retryBaseMs?: number;\n  /** Retry delay cap (default 30000 ms). */\n  retryMaxMs?: number;\n  /** Clock for scheduling (default `Date.now`). */\n  now?: () => number;\n  /** Wall clock stored in the meta (default `Date.now`). */\n  wallClock?: () => number;\n  setTimeout?: (fn: () => void, ms: number) => unknown;\n  clearTimeout?: (handle: any) => void;\n  /** Start hydrated, i.e. as if `ready()` was already called (default `false`). */\n  ready?: boolean;\n}\n\nexport interface AutosaveController<T = unknown> {\n  /** Current status. */\n  getStatus(): AutosaveStatusInfo;\n  /** Listener is called on every status change (not immediately). */\n  subscribe(listener: (info: AutosaveStatusInfo) => void): () => void;\n  /** Call after every change (edit, undo, save). Cheap; the write is scheduled. */\n  notify(): void;\n  /** Lifts the hydration gate: no snapshot is written before this. */\n  ready(): void;\n  readonly isReady: boolean;\n  /**\n   * Writes a snapshot of unsaved changes right away, skipping the debounce, the\n   * interval and retry waits. Use on `pagehide` / `visibilitychange`. Resolves\n   * once the write settled.\n   */\n  flushNow(): Promise<void>;\n  /**\n   * Call after the document was saved (`savedRevision()` now equals\n   * `revision()`): retires the snapshot only if this session wrote it.\n   */\n  markClean(): Promise<void>;\n  /**\n   * A dirty snapshot left by an earlier session, or `null`. Returns `null` once\n   * this session has written its own snapshot.\n   */\n  checkRecovery(): Promise<AutosaveRecovery<T> | null>;\n  /** Deletes an earlier session's snapshot. No-op once this session wrote its own. */\n  discardRecovery(): Promise<boolean>;\n  /** Runs one scheduling step now (normally driven by `notify` and timers). */\n  tick(): void;\n  /** Resolves when no write is in flight. */\n  whenIdle(): Promise<void>;\n  /** Stops all timers. Pending changes are not written; call `flushNow` first. */\n  destroy(): void;\n}\n\nexport const recoveryMetaKey = (key: string) => `${key}:meta`;\n\n/**\n * Text for a recovery prompt: \"Restore unsaved changes from <time>?\" (the\n * React and Svelte `RecoveryPrompt` components use it).\n */\nexport function formatRecoveryMessage(\n  meta: Pick<RecoveryMeta, \"time\">,\n  formatTime: (time: number) => string = (time) => new Date(time).toLocaleString(),\n): string {\n  return typeof meta.time === \"number\" && Number.isFinite(meta.time)\n    ? `Restore unsaved changes from ${formatTime(meta.time)}?`\n    : \"Restore unsaved changes?\";\n}\n\n/**\n * Debounced autosave of crash-recovery snapshots.\n *\n * - Hydration gate: nothing is written until `ready()`, so loading a document\n *   (or deciding about a recovered one) never overwrites the previous session's snapshot.\n * - A snapshot is written `debounceMs` after the last edit, and at least every\n *   `interval` while edits keep coming; never twice for one revision.\n * - Failed writes are retried with exponential backoff (`retryBaseMs` doubling up to\n *   `retryMaxMs`) without waiting for another edit.\n * - The snapshot is written before its dirty meta, so the meta never points at a\n *   missing snapshot. Once saved, the meta is marked clean only if this session\n *   wrote the snapshot (`createRecoveryPolicy`).\n */\nexport function createAutosaveController<T>(\n  options: AutosaveControllerOptions<T>,\n): AutosaveController<T> {\n  const {\n    storage,\n    key,\n    getSnapshot,\n    revision,\n    savedRevision,\n    interval = 5000,\n    debounceMs = 1000,\n    retryBaseMs = 1000,\n    retryMaxMs = 30000,\n  } = options;\n  const serialize = options.serialize ?? ((value: T) => JSON.stringify(value));\n  const deserialize = options.deserialize ?? ((text: string) => JSON.parse(text) as T);\n  const now = options.now ?? (() => Date.now());\n  const wallClock = options.wallClock ?? (() => Date.now());\n  const setTimer =\n    options.setTimeout ?? ((fn: () => void, ms: number) => globalThis.setTimeout(fn, ms));\n  const clearTimer = options.clearTimeout ?? ((handle: any) => globalThis.clearTimeout(handle));\n  const metaKey = recoveryMetaKey(key);\n\n  const policy: RecoveryPolicy = createRecoveryPolicy({\n    interval,\n    retryDelay: (failures) => exponentialBackoff(failures, retryBaseMs, retryMaxMs),\n  });\n\n  let hydrated = options.ready === true;\n  let destroyed = false;\n  let timer: unknown = null;\n  let timerDue = Infinity;\n  let inflight: Promise<void> | null = null;\n  let observedRevision = revision();\n  let lastChangeAt: number | null = null;\n  let pendingSince: number | null = null;\n  let forceNext = false;\n  let info: AutosaveStatusInfo = {\n    status: \"idle\",\n    error: null,\n    failures: 0,\n    nextAttemptAt: null,\n    lastSavedAt: null,\n    ready: hydrated,\n  };\n  const listeners = new Set<(info: AutosaveStatusInfo) => void>();\n\n  const setInfo = (patch: Partial<AutosaveStatusInfo>) => {\n    const next = { ...info, ...patch, failures: policy.failures, ready: hydrated };\n    if (\n      next.status === info.status &&\n      next.error === info.error &&\n      next.failures === info.failures &&\n      next.nextAttemptAt === info.nextAttemptAt &&\n      next.lastSavedAt === info.lastSavedAt &&\n      next.ready === info.ready\n    ) {\n      return;\n    }\n    info = next;\n    options.onStatus?.(info);\n    listeners.forEach((listener) => {\n      try {\n        listener(info);\n      } catch (error) {\n        console.error(\"[autosave] Error in status listener:\", error);\n      }\n    });\n  };\n\n  const cancelTimer = () => {\n    if (timer !== null) clearTimer(timer);\n    timer = null;\n    timerDue = Infinity;\n  };\n\n  const schedule = (delay: number) => {\n    if (destroyed) return;\n    const due = now() + Math.max(0, delay);\n    if (timer !== null && timerDue <= due) return;\n    cancelTimer();\n    timerDue = due;\n    timer = setTimer(() => {\n      timer = null;\n      timerDue = Infinity;\n      tick();\n    }, Math.max(0, delay));\n  };\n\n  const observe = (t: number) => {\n    const rev = revision();\n    if (rev !== observedRevision) {\n      observedRevision = rev;\n      lastChangeAt = t;\n      pendingSince ??= t;\n    }\n    return rev;\n  };\n\n  const docName = () =>\n    typeof options.name === \"function\" ? options.name() : options.name;\n\n  const run = (action: RecoveryAction, rev: number) => {\n    if (action.type === \"writeSnapshot\") {\n      setInfo({ status: \"saving\", nextAttemptAt: null });\n      inflight = (async () => {\n        let ok = false;\n        let error: unknown = null;\n        try {\n          const text = serialize(getSnapshot());\n          await storage.set(key, text);\n          const meta: RecoveryMeta = {\n            dirty: true,\n            revision: action.revision,\n            time: wallClock(),\n            name: docName(),\n          };\n          await storage.set(metaKey, JSON.stringify(meta));\n          ok = true;\n        } catch (e) {\n          error = e;\n        }\n        const t = now();\n        policy.written(action.revision, ok, t);\n        inflight = null;\n        if (ok) {\n          if (observedRevision === action.revision) pendingSince = null;\n          setInfo({ status: \"saved\", error: null, lastSavedAt: t });\n        } else {\n          setInfo({ status: \"error\", error });\n        }\n        tick();\n      })();\n    } else if (action.type === \"writeClean\") {\n      setInfo({ status: \"saving\", nextAttemptAt: null });\n      inflight = (async () => {\n        let ok = false;\n        let error: unknown = null;\n        try {\n          await storage.set(metaKey, JSON.stringify({ dirty: false } satisfies RecoveryMeta));\n          ok = true;\n        } catch (e) {\n          error = e;\n        }\n        policy.cleaned(ok, now());\n        inflight = null;\n        if (ok) {\n          // Best effort: the clean meta already retired the snapshot.\n          if (!policy.ownsSnapshot) await storage.remove(key).catch(() => undefined);\n          setInfo({ status: \"saved\", error: null });\n        } else {\n          setInfo({ status: \"error\", error });\n        }\n        tick();\n      })();\n    } else if (action.type === \"wakeAfter\") {\n      schedule(action.delay);\n      setInfo(\n        info.status === \"error\"\n          ? { nextAttemptAt: now() + action.delay }\n          : { status: rev !== savedRevision() ? \"dirty\" : info.status, nextAttemptAt: now() + action.delay },\n      );\n    } else if (rev === savedRevision() && info.status === \"dirty\") {\n      setInfo({ status: policy.ownsSnapshot ? \"dirty\" : \"idle\", nextAttemptAt: null });\n    } else if (rev !== savedRevision() && info.status !== \"saved\" && info.status !== \"error\") {\n      setInfo({ status: \"dirty\" });\n    }\n  };\n\n  function tick(): void {\n    if (destroyed || inflight) return;\n    const t = now();\n    const rev = observe(t);\n    const saved = savedRevision();\n    if (!hydrated) {\n      if (rev !== saved) setInfo({ status: \"dirty\" });\n      return;\n    }\n    const force = forceNext;\n    forceNext = false;\n    if (rev !== saved && !force && info.status !== \"error\") {\n      const changed = lastChangeAt ?? t;\n      const due = Math.min(changed + debounceMs, (pendingSince ?? changed) + interval);\n      if (t < due) {\n        setInfo({ status: \"dirty\", nextAttemptAt: due });\n        schedule(due - t);\n        return;\n      }\n    }\n    run(policy.tick(t, rev, saved, { force }), rev);\n  }\n\n  const whenIdle = async () => {\n    while (inflight) await inflight;\n  };\n\n  return {\n    getStatus: () => info,\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    notify() {\n      if (destroyed) return;\n      const t = now();\n      const before = observedRevision;\n      const rev = observe(t);\n      const dirty = rev !== savedRevision();\n      if (dirty && rev !== before && info.status !== \"error\" && !inflight) {\n        setInfo({ status: \"dirty\" });\n      }\n      if (!hydrated) return;\n      // Never synchronous: listeners that update `savedRevision` may run after us.\n      const changed = lastChangeAt ?? t;\n      const due = Math.min(changed + debounceMs, (pendingSince ?? changed) + interval);\n      schedule(dirty ? due - t : 0);\n    },\n    ready() {\n      if (hydrated || destroyed) return;\n      hydrated = true;\n      setInfo({});\n      schedule(0);\n    },\n    get isReady() {\n      return hydrated;\n    },\n    async flushNow() {\n      if (destroyed || !hydrated) return;\n      await whenIdle();\n      cancelTimer();\n      forceNext = true;\n      tick();\n      await whenIdle();\n    },\n    async markClean() {\n      if (destroyed) return;\n      await whenIdle();\n      cancelTimer();\n      tick();\n      await whenIdle();\n    },\n    async checkRecovery() {\n      if (policy.ownsSnapshot) return null;\n      let meta: RecoveryMeta;\n      try {\n        const metaText = await storage.get(metaKey);\n        if (!metaText) return null;\n        meta = JSON.parse(metaText) as RecoveryMeta;\n      } catch {\n        return null;\n      }\n      if (!meta || meta.dirty !== true) return null;\n      const text = await storage.get(key).catch(() => null);\n      if (text === null) return null;\n      try {\n        return { snapshot: deserialize(text), text, meta: meta as RecoveryMeta & { dirty: true } };\n      } catch (error) {\n        return { snapshot: undefined, text, meta: meta as RecoveryMeta & { dirty: true }, error };\n      }\n    },\n    async discardRecovery() {\n      if (policy.ownsSnapshot) return false;\n      await whenIdle();\n      await storage.remove(metaKey);\n      await storage.remove(key);\n      return true;\n    },\n    tick,\n    whenIdle,\n    destroy() {\n      destroyed = true;\n      cancelTimer();\n      listeners.clear();\n    },\n  };\n}\n","/** Anything that notifies on every document change (`HistoryManager` satisfies it). */\nexport interface RevisionChangeSource {\n  subscribe(listener: (...args: any[]) => void): () => void;\n}\n\n/** Anything with a dirty flag (`DirtyTracker` and `HistoryDirtyBinding` satisfy it). */\nexport interface DirtyFlagSource {\n  readonly dirty: boolean;\n  subscribe(listener: (dirty: boolean) => void): () => void;\n}\n\nexport interface RevisionTrackerOptions {\n  /** Change notifications (e.g. a `HistoryManager`). Every notification is a new revision. */\n  history?: RevisionChangeSource;\n  /**\n   * Saved-vs-current flag (e.g. `bindDirtyToHistory(...)` or a `DirtyTracker`).\n   * Whenever it reads clean, the current revision counts as saved, so undoing\n   * back to the saved state needs no snapshot. Without it, call `markSaved()`.\n   */\n  dirty?: DirtyFlagSource;\n}\n\nexport interface RevisionTracker {\n  /** Bumped on every change. */\n  revision(): number;\n  /** Revision of the last save; equals `revision()` while clean. */\n  savedRevision(): number;\n  /** Records a change made outside `history`. */\n  bump(): void;\n  /** Marks the current revision saved. */\n  markSaved(): void;\n  /** Called after every change, save or dirty flip. */\n  subscribe(listener: () => void): () => void;\n  destroy(): void;\n}\n\n/**\n * Derives the `revision` / `savedRevision` pair an autosave controller needs\n * from a history and a dirty flag (`bindDirtyToHistory` or `DirtyTracker`).\n * Structural types only, so this entry stays dependency-free.\n */\nexport function createRevisionTracker(options: RevisionTrackerOptions = {}): RevisionTracker {\n  let revision = 0;\n  let saved = 0;\n  const listeners = new Set<() => void>();\n  const emit = () =>\n    listeners.forEach((listener) => {\n      try {\n        listener();\n      } catch (error) {\n        console.error(\"[autosave] Error in revision listener:\", error);\n      }\n    });\n  const syncSaved = () => {\n    // Read lazily: the dirty binding may update after our history listener ran.\n    if (options.dirty && !options.dirty.dirty) saved = revision;\n  };\n\n  const unsubscribers: (() => void)[] = [];\n  if (options.history) {\n    unsubscribers.push(\n      options.history.subscribe(() => {\n        revision++;\n        emit();\n      }),\n    );\n  }\n  if (options.dirty) {\n    let first = true;\n    unsubscribers.push(\n      options.dirty.subscribe((dirty) => {\n        if (first) {\n          first = false;\n          // DirtyTracker calls back immediately with the current value.\n          if (dirty && revision === saved) revision++;\n          return;\n        }\n        if (dirty && revision === saved) revision++;\n        if (!dirty) saved = revision;\n        emit();\n      }),\n    );\n  }\n\n  return {\n    revision: () => revision,\n    savedRevision: () => {\n      syncSaved();\n      return saved;\n    },\n    bump() {\n      revision++;\n      emit();\n    },\n    markSaved() {\n      saved = revision;\n      emit();\n    },\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    destroy() {\n      unsubscribers.forEach((fn) => fn());\n      unsubscribers.length = 0;\n      listeners.clear();\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/registry-BDe-vlv3.d.ts

@@ -0,0 +1,171 @@
+import { J as JsonSchema, S as SchemaValidationError } from './schema-DYDGdYL9.js';
+
+/**
+ * MCP-shaped tool definition, as returned by `tools/list`.
+ */
+interface McpToolDefinition {
+    name: string;
+    title?: string;
+    description?: string;
+    inputSchema: JsonSchema & {
+        type: 'object';
+    };
+    outputSchema?: JsonSchema;
+    annotations?: {
+        title?: string;
+        readOnlyHint?: boolean;
+        destructiveHint?: boolean;
+        idempotentHint?: boolean;
+        openWorldHint?: boolean;
+        [key: string]: unknown;
+    };
+}
+type McpToolContent = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image';
+    data: string;
+    mimeType: string;
+} | {
+    type: string;
+    [key: string]: unknown;
+};
+/** MCP `tools/call` result. */
+interface McpToolResult {
+    content: McpToolContent[];
+    structuredContent?: Record<string, unknown>;
+    isError?: boolean;
+}
+/** MCP `tools/list` result. */
+interface McpListToolsResult {
+    tools: McpToolDefinition[];
+}
+interface ToolCallContext {
+    /** Name the tool was called by (possibly namespaced). */
+    name: string;
+    /** Id of the provider that owns the tool. */
+    providerId: string;
+    signal?: AbortSignal;
+}
+/**
+ * Handler return values are normalized into an {@link McpToolResult}: a full
+ * result (`{ content: [...] }`) is passed through, a string becomes a text
+ * block, `undefined` becomes an empty result, and anything else is returned
+ * as `structuredContent` (plain objects) plus a JSON text block.
+ */
+type AgentToolHandler = (args: Record<string, any>, context: ToolCallContext) => unknown | Promise<unknown>;
+interface AgentTool extends McpToolDefinition {
+    handler: AgentToolHandler;
+}
+/**
+ * A source of tools, typically one per mounted editor, spreadsheet or canvas.
+ */
+interface AgentToolProvider {
+    /** Unique id within a registry, e.g. `doc-1`. Used as the namespace on collisions. */
+    id: string;
+    /** Always prefix this provider's tools with `<namespace>__`. */
+    namespace?: string;
+    /** Tools, or a function returning the current tools (re-read on every `listTools`). */
+    tools: readonly AgentTool[] | (() => readonly AgentTool[]);
+    /** Lets the provider signal that its tool list changed; returns an unsubscribe function. */
+    subscribe?: (notify: () => void) => () => void;
+}
+type ToolErrorCode = 'unknown_tool' | 'invalid_arguments' | 'tool_failed';
+/** Structured error carried in `structuredContent.error` of a failed call. */
+interface ToolCallError {
+    code: ToolErrorCode;
+    message: string;
+    tool: string;
+    details?: SchemaValidationError[];
+}
+declare class ToolRegistryError extends Error {
+    readonly code: 'duplicate_provider' | 'name_collision' | 'invalid_tool';
+    constructor(code: ToolRegistryError['code'], message: string);
+}
+interface ToolRegistryOptions {
+    /**
+     * What to do when two providers contribute the same tool name:
+     * `namespace` (default) exposes every colliding tool as `<providerId>__<name>`;
+     * `error` makes `register` throw.
+     */
+    onCollision?: 'namespace' | 'error';
+    /** Coalescing window for `listChanged` notifications in ms (default 0: same tick). */
+    listChangedDelayMs?: number;
+    /** Validate arguments against `inputSchema` before calling handlers (default `true`). */
+    validateArguments?: boolean;
+}
+/** Separator between namespace and tool name; valid in MCP and LLM tool-name charsets. */
+declare const TOOL_NAMESPACE_SEPARATOR = "__";
+/** Normalizes a handler's return value into an MCP `tools/call` result. */
+declare function toToolResult(value: unknown): McpToolResult;
+/**
+ * Transport-agnostic registry of agent tools contributed by live providers.
+ *
+ * `listTools()` and `callTool()` return MCP `tools/list` / `tools/call`
+ * result shapes, and `onListChanged` fires (coalesced) whenever the exposed
+ * tool list changes, mirroring MCP's `notifications/tools/list_changed`, so an
+ * MCP server can be a thin wrapper around it.
+ */
+declare class ToolRegistry {
+    /** MCP server capabilities this registry supports. */
+    readonly capabilities: {
+        readonly tools: {
+            readonly listChanged: true;
+        };
+    };
+    private readonly entries;
+    private readonly listeners;
+    private readonly options;
+    private timer;
+    private lastSignature;
+    constructor(options?: ToolRegistryOptions);
+    /**
+     * Registers a provider and returns a function that unregisters it.
+     * Throws a {@link ToolRegistryError} for a duplicate provider id, an invalid
+     * tool name, or (with `onCollision: 'error'`) a tool name collision.
+     */
+    register(provider: AgentToolProvider): () => void;
+    /** Removes a provider by id or instance. Returns whether it was registered. */
+    unregister(providerOrId: string | AgentToolProvider): boolean;
+    /** Registered provider ids in registration order. */
+    providerIds(): string[];
+    /**
+     * Resolves exposed names. Tools are ordered by provider registration, then
+     * by their order within the provider.
+     */
+    private resolve;
+    /** MCP `tools/list` result for the current providers. */
+    listTools(): McpListToolsResult;
+    /** Whether a tool with this exposed name exists. */
+    hasTool(name: string): boolean;
+    /** Looks up a tool definition by exposed name. */
+    getTool(name: string): McpToolDefinition | undefined;
+    /**
+     * Calls a tool by exposed name and returns an MCP `tools/call` result.
+     * Never rejects: unknown tools, invalid arguments and handler errors come
+     * back as `isError: true` results with a {@link ToolCallError} in
+     * `structuredContent.error` (MCP transports may map `unknown_tool` to a
+     * JSON-RPC `-32602` error instead).
+     */
+    callTool(name: string, args?: Record<string, unknown>, options?: {
+        signal?: AbortSignal;
+    }): Promise<McpToolResult>;
+    /**
+     * Subscribes to tool-list changes. Notifications are coalesced: many
+     * registrations or provider signals within the delay window produce one
+     * call, and none if the exposed list ends up unchanged (e.g. a provider
+     * unmounted and remounted). Returns an unsubscribe function.
+     */
+    onListChanged(listener: (tools: McpToolDefinition[]) => void): () => void;
+    /** Schedules a coalesced `listChanged` check; providers may call it directly. */
+    notifyListChanged(): void;
+    /** Runs a pending `listChanged` check immediately. */
+    flush(): void;
+    private signature;
+    /** Unregisters every provider and listener and cancels pending notifications. */
+    dispose(): void;
+}
+declare function createToolRegistry(options?: ToolRegistryOptions): ToolRegistry;
+
+export { type AgentToolProvider as A, type McpListToolsResult as M, TOOL_NAMESPACE_SEPARATOR as T, type AgentTool as a, type AgentToolHandler as b, type McpToolContent as c, type McpToolDefinition as d, type McpToolResult as e, type ToolCallContext as f, type ToolCallError as g, type ToolErrorCode as h, ToolRegistry as i, ToolRegistryError as j, type ToolRegistryOptions as k, createToolRegistry as l, toToolResult as t };

package/dist/registry-D32LpIc4.d.cts

@@ -0,0 +1,354 @@
+import { J as JsonSchema, S as SchemaValidationError } from './schema-DYDGdYL9.cjs';
+
+/**
+ * Keyboard chords in a platform-neutral notation.
+ *
+ * | token | macOS | Windows / Linux |
+ * |---|---|---|
+ * | `Mod` | ⌘ Command | Ctrl |
+ * | `Ctrl` | ⌃ Control | Ctrl (same key as `Mod`: conflicts are reported) |
+ * | `Meta` / `Cmd` | ⌘ Command | Win / Super |
+ * | `Alt` / `Option` | ⌥ Option | Alt |
+ * | `Shift` | ⇧ Shift | Shift |
+ *
+ * Keys are stored as `KeyboardEvent.code` values (`KeyZ`, `Digit1`, `BracketRight`,
+ * `PageDown`), so Option/Alt chords work on macOS (where Option changes `event.key`).
+ */
+type Platform = 'mac' | 'windows' | 'linux';
+declare const PLATFORMS: readonly Platform[];
+/** A parsed chord. `mod` is the platform's primary modifier. */
+interface Chord {
+    /** `KeyboardEvent.code` of the key, e.g. `KeyZ`. */
+    key: string;
+    mod?: boolean;
+    ctrl?: boolean;
+    meta?: boolean;
+    alt?: boolean;
+    shift?: boolean;
+}
+/** The modifiers a chord needs on one platform (`mod` resolved to `meta` or `ctrl`). */
+interface EffectiveChord {
+    key: string;
+    ctrl: boolean;
+    meta: boolean;
+    alt: boolean;
+    shift: boolean;
+}
+/** The current platform from `navigator` (`linux` when unknown, e.g. in Node). */
+declare function detectPlatform(): Platform;
+/** `KeyboardEvent.code` for a key token (`Z`, `1`, `]`, `PageDown`, `F5`, `KeyZ`), or `null`. */
+declare function keyToCode(token: string): string | null;
+/** Neutral text for a code: `KeyZ` → `Z`, `BracketRight` → `]`, `ArrowUp` → `Up`. */
+declare function codeToKeyText(code: string): string;
+/**
+ * Parses chord text (`Mod+Shift+Z`, `Alt+]`, `⌥⇧⌘K`, `CmdOrCtrl+K`). Throws on unknown
+ * modifiers or keys. The last `+`-separated token is the key (`+` itself is `Plus`).
+ */
+declare function parseChord(text: string): Chord;
+/** Canonical platform-neutral text: `Mod+Ctrl+Meta+Alt+Shift+<key>`. */
+declare function chordToString(chord: Chord): string;
+/** Canonical spelling of chord text (`shift+cmdorctrl+z` → `Mod+Shift+Z`). Throws when invalid. */
+declare function normalizeChord(text: string): string;
+/** The modifiers a chord needs on `platform`: `Mod` is ⌘ (meta) on macOS and Ctrl elsewhere. */
+declare function effectiveChord(chord: string | Chord, platform: Platform): EffectiveChord;
+/** Identity of an effective chord, for conflict detection (`Ctrl+Shift+KeyZ`). */
+declare function effectiveChordKey(chord: string | Chord, platform: Platform): string;
+/**
+ * Display text: `⌥⇧⌘K` on macOS, `Ctrl+Alt+Shift+K` on Windows / Linux (`Meta` shows as
+ * `Win` / `Super`). Invalid text is returned unchanged.
+ */
+declare function formatShortcut(chord: string | Chord, platform?: Platform): string;
+/** Minimal keyboard event surface (DOM `KeyboardEvent` satisfies it). */
+interface KeyboardEventLike {
+    key?: string;
+    code?: string;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    altKey?: boolean;
+    shiftKey?: boolean;
+    target?: EventTarget | null | unknown;
+    defaultPrevented?: boolean;
+    preventDefault?: () => void;
+}
+/** `event.code`, or one derived from `event.key` for synthetic events without a code. */
+declare function eventCode(event: KeyboardEventLike): string;
+/**
+ * The key code a shortcut event is matched by: `event.code` (layout-independent, so
+ * Option/Alt chords work on macOS and punctuation chords follow the physical key),
+ * except that a letter key producing a different Latin letter without Alt (AZERTY,
+ * QWERTZ, Dvorak) uses the produced letter, as browsers and operating systems do.
+ */
+declare function shortcutCode(event: KeyboardEventLike): string;
+/** The code a printable `event.key` names on a US layout (`z` → `KeyZ`, `]` → `BracketRight`). */
+declare function codeFromKey(key: string): string | null;
+/**
+ * Whether a keyboard event comes from a text-entry element: `<input>`, `<textarea>`,
+ * `<select>`, a `contenteditable` element (or a descendant) or a ProseMirror editor.
+ * Falls back to `document.activeElement` when the event has no element target.
+ */
+declare function isEditableEventTarget(event: {
+    target?: unknown;
+}): boolean;
+
+/** One key binding: a chord that runs `command`, optionally only in one scope / on some platforms. */
+interface ShortcutBinding {
+    command: string;
+    /** Chord text (`Mod+Shift+Z`) or a parsed chord. */
+    chord: string | Chord;
+    /** Scope (e.g. `canvas`, `spreadsheet`); scoped bindings win over global ones. Omit for global. */
+    scope?: string;
+    /** Platforms the binding exists on (default: all). E.g. `Mod+Y` redo only off macOS. */
+    platforms?: readonly Platform[];
+    /** Also fire while focus is in an input, textarea or contenteditable (default `false`). */
+    allowInEditable?: boolean;
+}
+/** Shortcut declaration on a command: chord text, or an object for platform / scope specifics. */
+type ShortcutInput = string | Omit<ShortcutBinding, 'command'> | ReadonlyArray<string | Omit<ShortcutBinding, 'command'>>;
+/** Expands a command's `shortcut` declaration into bindings. */
+declare function toShortcutBindings(command: string, input: ShortcutInput | undefined, scope?: string): ShortcutBinding[];
+interface ShortcutConflict {
+    /** Scope shared by the bindings (`undefined` = global). */
+    scope?: string;
+    /** Effective chord, e.g. `Ctrl+KeyZ`. */
+    chord: string;
+    /** Commands bound to it (two or more). */
+    commands: string[];
+}
+interface ShortcutMatch {
+    command: string;
+    binding: ShortcutBinding;
+}
+interface ShortcutResolveOptions {
+    /** Active scopes, most specific first. Bindings in these scopes win over global ones. */
+    scopes?: string | readonly string[];
+    /** Resolve even when the event comes from a text input (default: per binding). */
+    allowInEditable?: boolean;
+    /** Override the map's platform. */
+    platform?: Platform;
+}
+interface ShortcutMapOptions {
+    /** Platform used to resolve `Mod` (default: detected from `navigator` on every resolve). */
+    platform?: Platform;
+    /**
+     * `platform` (default): `Mod` means ⌘ on macOS and Ctrl elsewhere, exactly.
+     * `either`: `Mod` (and `Ctrl` / `Meta`) match ⌘ or Ctrl on every platform.
+     */
+    modifierMode?: 'platform' | 'either';
+}
+/**
+ * Keyboard shortcuts as data: default bindings plus user overrides, resolved from
+ * `KeyboardEvent`s by `event.code` (so Option/Alt chords work on macOS), with scopes
+ * (scoped bindings win), conflict detection per platform and display formatting.
+ */
+declare class ShortcutMap {
+    private defaults;
+    private overrides;
+    private readonly listeners;
+    private readonly options;
+    constructor(bindings?: readonly ShortcutBinding[], options?: ShortcutMapOptions);
+    get platform(): Platform;
+    private entry;
+    private changed;
+    /** Subscribes to binding changes. Returns an unsubscribe function. */
+    subscribe(listener: () => void): () => void;
+    /** Adds default bindings (throws on invalid chord text). Returns a function removing them. */
+    bind(bindings: ShortcutBinding | readonly ShortcutBinding[]): () => void;
+    /**
+     * User override for a command: replaces all of its default bindings with `chords`
+     * (an empty list unbinds it). Throws on invalid chord text.
+     */
+    setOverride(command: string, chords: string | Chord | ReadonlyArray<string | Chord | Omit<ShortcutBinding, 'command'>>): void;
+    /** Removes a user override (the defaults apply again). */
+    clearOverride(command: string): void;
+    /** User overrides as plain data (`{ command: ['Mod+K'] }`), e.g. to persist them. */
+    getOverrides(): Record<string, string[]>;
+    /** Restores overrides saved with `getOverrides` (replacing the current ones). */
+    setOverrides(overrides: Record<string, readonly string[]>): void;
+    private active;
+    /** Effective bindings on `platform` (defaults without overridden commands, plus overrides). */
+    bindings(platform?: Platform): ShortcutBinding[];
+    /** Canonical chord text bound to `command` on `platform` (first = primary). */
+    forCommand(command: string, platform?: Platform): string[];
+    /**
+     * The command a keydown event runs, or `null`. Events from text inputs are ignored
+     * unless the binding (or `options`) allows them. Bindings in the active scopes
+     * (in order) win over global bindings; bindings in other scopes never match.
+     * Keys are matched by `event.code`, except that a letter key producing another Latin
+     * letter (AZERTY, QWERTZ, Dvorak) matches that letter when Alt is not held, so
+     * `Mod+Z` follows the Z label (see `shortcutCode`).
+     */
+    resolve(event: KeyboardEventLike, options?: ShortcutResolveOptions): ShortcutMatch | null;
+    private matches;
+    /**
+     * Groups of bindings that share an effective chord in one scope on `platform`
+     * (e.g. `Mod+Y` and `Ctrl+Y` collide off macOS). A scoped binding shadowing a
+     * global one is not a conflict.
+     */
+    findConflicts(platform?: Platform): ShortcutConflict[];
+    /** Conflicts on every platform, keyed by platform (only platforms with conflicts). */
+    findAllConflicts(): Partial<Record<Platform, ShortcutConflict[]>>;
+}
+
+/** Object JSON Schema describing a command's parameters. */
+type CommandParamsSchema = JsonSchema & {
+    type: 'object';
+};
+/**
+ * Metadata and implementation of one command. Menus, shortcuts, the palette and agent
+ * tools all run commands by id, so every entry point shares enablement and validation.
+ */
+interface CommandSpec<TContext = any, TParams = any, TResult = unknown> {
+    /** Unique id, e.g. `history.undo` or `canvas.alignLeft`. */
+    id: string;
+    label: string;
+    /** Group / menu name shown next to the label, e.g. `Edit` or `Arrange`. */
+    group?: string;
+    /** Extra search terms for the palette. */
+    keywords?: readonly string[];
+    description?: string;
+    /** Object JSON Schema for `params`. Unknown keys are rejected unless `additionalProperties` allows them. */
+    params?: CommandParamsSchema;
+    /** Default shortcut(s): platform-neutral chord text such as `Mod+Shift+Z`. */
+    shortcut?: ShortcutInput;
+    /** Scope the command (and its shortcuts) belong to, e.g. `canvas`. Omit for global commands. */
+    scope?: string;
+    /**
+     * Whether the command can run: `true` (or `undefined`), `false`, or a reason string
+     * ("Nothing to undo"). Receives the params a caller named, so a command acting on the
+     * selection can still run on targets passed explicitly (`params` is `undefined` for menus).
+     */
+    enabled?: (context: TContext, params: TParams | undefined) => boolean | string | undefined;
+    run: (context: TContext, params: TParams) => TResult;
+    /**
+     * Runs inside the registry's `history.batch(label, …)`, so all history entries the
+     * command records become one undo step and a throw rolls back its partial changes.
+     */
+    undoable?: boolean;
+    /** The command only reads state (agent tools mark it read-only). */
+    readOnly?: boolean;
+    /** Hide from the palette and `list()` unless `includeHidden` (still runnable by id). */
+    hidden?: boolean;
+}
+type CommandErrorCode = 'unknown_command' | 'disabled' | 'invalid_params' | 'failed';
+type CommandResult<T = unknown> = {
+    ok: true;
+    id: string;
+    result: T;
+} | {
+    ok: false;
+    id: string;
+    code: CommandErrorCode;
+    message: string;
+    details?: SchemaValidationError[];
+};
+/** A command as listed for menus, palettes and agents. */
+interface CommandEntry {
+    id: string;
+    label: string;
+    group?: string;
+    keywords?: readonly string[];
+    description?: string;
+    params?: CommandParamsSchema;
+    scope?: string;
+    /** Canonical chord text bound on the registry's platform (first = primary). */
+    shortcuts: string[];
+    enabled: boolean;
+    /** Why the command is disabled (only when `enabled` is false). */
+    disabledReason?: string;
+    undoable: boolean;
+    readOnly: boolean;
+}
+interface CommandListOptions<TContext = any> {
+    /** Only global commands plus commands of these scopes. */
+    scope?: string | readonly string[];
+    enabledOnly?: boolean;
+    includeHidden?: boolean;
+    /** Context for the enablement check (default: the registry's context). */
+    context?: TContext;
+}
+/** Minimal history surface (`HistoryManager` satisfies it). */
+interface CommandHistoryTarget {
+    batch(name: string, fn: () => void): void;
+}
+interface CommandRegistryOptions<TContext = any> {
+    /** Default context passed to `enabled` / `run` (a value or a getter). */
+    context?: TContext | (() => TContext);
+    /** Wraps `undoable` commands in one history step (see `CommandSpec.undoable`). */
+    history?: CommandHistoryTarget;
+    /** Options for the registry's `ShortcutMap`. */
+    shortcuts?: ShortcutMapOptions;
+}
+declare class CommandRegistryError extends Error {
+    readonly code: 'duplicate_command' | 'invalid_command';
+    constructor(code: CommandRegistryError['code'], message: string);
+}
+/**
+ * Registry of commands: one id per action, shared by shortcuts (`shortcuts`), the
+ * command palette (`list` + `rankCommands`) and agent tools (`createCommandToolProvider`).
+ */
+declare class CommandRegistry<TContext = any> {
+    /** Shortcut bindings of the registered commands (plus any user overrides). */
+    readonly shortcuts: ShortcutMap;
+    private readonly commands;
+    private readonly listeners;
+    private readonly options;
+    private version;
+    private muted;
+    constructor(options?: CommandRegistryOptions<TContext>);
+    /** Monotonic counter bumped on every change (useful as a snapshot key). */
+    getVersion(): number;
+    /** The default context. */
+    get context(): TContext;
+    /**
+     * Registers a command (or several) and returns a function that unregisters it.
+     * Throws a `CommandRegistryError` for a duplicate or invalid id, or invalid chord text.
+     */
+    register(spec: CommandSpec<TContext> | readonly CommandSpec<TContext>[]): () => void;
+    /** Removes a command by id. Returns whether it was registered. */
+    unregister(id: string): boolean;
+    private unbindQuietly;
+    has(id: string): boolean;
+    get(id: string): CommandSpec<TContext> | undefined;
+    /** Registered ids in registration order. */
+    ids(): string[];
+    /** Whether `id` can run now (`{ enabled, reason }`); `params` are the targets a caller named. */
+    isEnabled(id: string, params?: unknown, context?: TContext): {
+        enabled: boolean;
+        reason?: string;
+    };
+    /** Commands for menus, palettes and agents, with their current enablement. */
+    list(options?: CommandListOptions<TContext>): CommandEntry[];
+    private check;
+    private invoke;
+    /**
+     * Runs a command synchronously and returns a structured result; never throws.
+     * A command whose `run` returns a promise yields `{ ok: true, result: promise }`
+     * (use `executeAsync` to await it and catch its rejection).
+     */
+    execute<T = unknown>(id: string, params?: unknown, context?: TContext): CommandResult<T>;
+    /** Like `execute`, but awaits async commands (rejections become `failed` results). */
+    executeAsync<T = unknown>(id: string, params?: unknown, context?: TContext): Promise<CommandResult<T>>;
+    /**
+     * Resolves a keydown event to a command (see `ShortcutMap.resolve`) and runs it when
+     * enabled, calling `preventDefault()`. Disabled commands leave the event alone, so the
+     * browser or a focused editor can still handle it. Returns the result, or `null`.
+     */
+    handleKeyDown(event: KeyboardEventLike, options?: ShortcutResolveOptions & {
+        context?: TContext;
+    }): CommandResult | null;
+    /** Display-ready primary shortcut of a command (`⇧⌘Z` / `Ctrl+Shift+Z`), or `undefined`. */
+    shortcutFor(id: string, platform?: Platform): string | undefined;
+    /**
+     * Subscribes to changes: commands registered or removed, shortcut overrides, executed
+     * commands and `invalidate()` calls (e.g. when enablement inputs change).
+     */
+    subscribe(listener: () => void): () => void;
+    /** Tells subscribers that enablement may have changed (e.g. the selection changed). */
+    invalidate(): void;
+    private notify;
+}
+declare function createCommandRegistry<TContext = any>(options?: CommandRegistryOptions<TContext>): CommandRegistry<TContext>;
+/** Identity helper that types a command spec. */
+declare function defineCommand<TContext = any, TParams = any, TResult = unknown>(spec: CommandSpec<TContext, TParams, TResult>): CommandSpec<TContext, TParams, TResult>;
+
+export { formatShortcut as A, isEditableEventTarget as B, CommandRegistry as C, keyToCode as D, type EffectiveChord as E, normalizeChord as F, parseChord as G, shortcutCode as H, toShortcutBindings as I, type KeyboardEventLike as K, type Platform as P, type ShortcutBinding as S, type CommandResult as a, type CommandEntry as b, type CommandSpec as c, type Chord as d, type CommandErrorCode as e, type CommandHistoryTarget as f, type CommandListOptions as g, type CommandParamsSchema as h, CommandRegistryError as i, type CommandRegistryOptions as j, PLATFORMS as k, type ShortcutConflict as l, type ShortcutInput as m, ShortcutMap as n, type ShortcutMapOptions as o, type ShortcutMatch as p, type ShortcutResolveOptions as q, chordToString as r, codeFromKey as s, codeToKeyText as t, createCommandRegistry as u, defineCommand as v, detectPlatform as w, effectiveChord as x, effectiveChordKey as y, eventCode as z };