@ai-matrx/office 0.6.0 → 0.7.0

package/dist/univer-collab.js

@@ -90,7 +90,7 @@ var WorkbookCollabSession = class {
       this.awareness.on("change", this.awarenessObserver);
     }
     this.commandDisposer = this.options.commandService.onMutationExecutedForCollab(
-      (info) => this.handleLocalMutation(info)
+      (info, options) => this.handleLocalMutation(info, options)
     );
     await this.provider.connect();
     await this.provider.ready();
@@ -238,8 +238,9 @@ var WorkbookCollabSession = class {
     return electCollabHost(states, this.options.uid, this.options.clientId, leader, opts.tabTieBreak ?? false);
   }
   // ─── internals ────────────────────────────────────────────────────────
-  handleLocalMutation(info) {
+  handleLocalMutation(info, options) {
     if (this.muted > 0) return;
+    if (options?.onlyLocal) return;
     if (!this.options.forwardDocumentMutations && isCellEditorScratch(info)) return;
     if (info.params && typeof info.params === "object" && !Array.isArray(info.params) && remoteOriginOf(info.params) !== null) {
       return;
@@ -247,7 +248,7 @@ var WorkbookCollabSession = class {
     if (!this.doc) return;
     let safeParams;
     try {
-      safeParams = info.params === void 0 || info.params === null ? null : JSON.parse(JSON.stringify(info.params));
+      safeParams = info.params === void 0 || info.params === null ? null : stripSenderView(JSON.parse(JSON.stringify(info.params)));
     } catch (err) {
       console.warn(
         `[collab] skipping non-serializable mutation "${info.id}" \u2014 peers will not receive it`,
@@ -321,6 +322,13 @@ var WorkbookCollabSession = class {
     }
   }
 };
+var SENDER_VIEW_PARAMS = ["layoutState", "textRanges", "prevTextRanges"];
+function stripSenderView(params) {
+  if (!params || typeof params !== "object" || Array.isArray(params)) return params;
+  const out = { ...params };
+  for (const key of SENDER_VIEW_PARAMS) delete out[key];
+  return out;
+}
 function isCellEditorScratch(info) {
   return typeof info.id === "string" && info.id.startsWith("doc.mutation.");
 }
@@ -352,9 +360,11 @@ function pickColor(uid) {
 }
 export {
   COLLAB_COVERED_KEY,
+  SENDER_VIEW_PARAMS,
   WorkbookCollabSession,
   isCellEditorScratch,
   stampCovered,
+  stripSenderView,
   takeCovered
 };
 //# sourceMappingURL=univer-collab.js.map

package/dist/univer-collab.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/univer/collab/WorkbookCollabSession.ts","../src/univer/collab/covered.ts"],"sourcesContent":["/**\n * WorkbookCollabSession — the Univer ↔ Yjs bridge.\n *\n * Subscribes to Univer's public `commandService.onMutationExecutedForCollab`\n * hook for local mutations and pushes them onto a `Y.Array<MutationOp>` shared\n * via `SupabaseYjsProvider`. Inbound Yjs updates produce `IMutationInfo` ops\n * that are applied through `commandService.syncExecuteCommand` with the\n * `fromCollab` execution option flagged so the outbound listener short-\n * circuits and we don't echo our own apply.\n *\n * See `FEATURE.md` in this directory for the architecture, the \"do NOT use\n * the Pro preset\" verdict, and the host-election rule. This class is the\n * runtime side of that plan.\n *\n * Lifecycle:\n *   - constructor: wire references, no side effects\n *   - start():   create Y.Doc + Awareness, instantiate provider, subscribe to\n *                command stream, subscribe to Yjs Array observer\n *   - stop():    detach all listeners, dispose provider\n *\n * The session is one-shot per workbook open. Reload = stop() + new instance.\n */\n\"use client\";\n\nimport * as Y from \"yjs\";\nimport { Awareness } from \"y-protocols/awareness\";\n\nimport { electCollabHost, remoteOriginOf, REMOTE_PARAM_TAG } from \"@ai-matrx/data/realtime/collab\";\n\nexport { COLLAB_COVERED_KEY, stampCovered, takeCovered } from \"./covered\";\n\n/**\n * Structural transport contract. `SupabaseYjsProvider` satisfies it in\n * production; the verification harness injects an in-memory loopback\n * transport through the same seam. Keeping this structural (not the concrete\n * class) is what makes the session testable without network.\n */\nexport type CollabProviderLike = {\n  connect(): Promise<void>;\n  disconnect(): void;\n  ready(): Promise<void>;\n  /**\n   * True when this is the only holder of its room in this tab allowed to act as\n   * host (autosave). Same-tab holders share one client id and one uid, so\n   * awareness cannot tell them apart. Absent = a lone holder = leader.\n   */\n  isTabLeader?(): boolean;\n};\n\n// Univer types are loose at the public hook boundary; we narrow with a\n// structural interface so we don't have to import the full Univer surface.\ntype MutationParams = Record<string, unknown> | unknown[] | null;\n\nexport type CollabMutationInfo = {\n  id: string;\n  type: number; // CommandType.MUTATION = 2 in Univer's enum\n  params: MutationParams;\n  /** Who made it (the person's uid), so a peer can tell its own other tab's edit from a stranger's. */\n  uid?: string;\n  /**\n   * The entry's identity in the room (`<clientId>:<seq>`). A saved snapshot names the entries it holds\n   * (`stampCovered`), so a seat that boots from that snapshot never replays them a second time.\n   */\n  eid?: string;\n};\n\n/**\n * What a seat booted from: the saved snapshot's row id and the room entries that snapshot already holds.\n * The session never replays a covered entry, and a seat that booted from an OLDER snapshot than the\n * room's newest checkpoint first reloads (the entries that checkpoint trimmed are only in that snapshot).\n */\nexport type CollabBase = {\n  snapshotId: () => string | null;\n  covered: () => ReadonlySet<string>;\n  /** Show the newest saved snapshot (and make it the base). */\n  reload: () => Promise<void>;\n};\n\ntype ExecuteOptions = {\n  /** Per-Univer convention: when true, the command runs locally only and is\n   *  NOT broadcast to other plugins. We set this on inbound-apply so the\n   *  subsequent onMutationExecutedForCollab does NOT re-fire on our peer. */\n  onlyLocal?: boolean;\n  fromCollab?: boolean;\n};\n\nexport type CommandServiceLike = {\n  onMutationExecutedForCollab(\n    listener: (info: CollabMutationInfo, options?: ExecuteOptions) => void,\n  ): {\n    dispose: () => void;\n  };\n  syncExecuteCommand(\n    id: string,\n    params: MutationParams,\n    options?: ExecuteOptions,\n  ): unknown;\n};\n\nexport type WorkbookCollabSessionOptions = {\n  workbookId: string;\n  uid: string;\n  clientId: string;\n  commandService: CommandServiceLike;\n  /** Factory so this file does not statically depend on the provider. */\n  makeProvider: (args: {\n    workbookId: string;\n    clientId: string;\n    doc: Y.Doc;\n    awareness: Awareness;\n    /** Wire to the provider so a host handover re-runs the election. */\n    onLeaderChange: () => void;\n  }) => CollabProviderLike;\n  /** Called when the awareness set changes (peers join / leave / move cursor). */\n  onAwarenessChange?: (awareness: Awareness) => void;\n  /**\n   * A peer replaced the whole content (history restore, Google update): the\n   * newest saved snapshot is the content now. Reload it in place; never\n   * re-announce. See `announceReplaced`.\n   */\n  onReplaced?: (snapshotId: string) => void;\n  /**\n   * TRUE when the room is bound to a Univer DOCUMENT unit (the Docs editor): there the `doc.mutation.*`\n   * stream IS the content, so it must travel. Leave unset for a workbook, where `doc.mutation.*` is the\n   * in-cell editor's scratch document and never travels (see `isCellEditorScratch`).\n   */\n  forwardDocumentMutations?: boolean;\n  /**\n   * The Univer unit id this seat mounted. Each seat can mount its own unit, so a peer's mutation\n   * (addressed to the SENDER's unit) is re-addressed to this one before it is applied.\n   */\n  unitId?: () => string | null;\n  /** A peer's mutation could not be applied here: the seat says so and re-syncs; never only a console line. */\n  onApplyFailed?: (mutationId: string, error: unknown) => void;\n  /**\n   * The saved snapshot this seat booted from. Without it a reloading seat replays every entry still in\n   * the room's log on top of a snapshot that already holds them: the text shows twice, and the next save\n   * stores it twice (2026-10-16).\n   */\n  base?: CollabBase;\n};\n\n/** What `checkpoint` writes into the room's control map: the newest saved snapshot whose entries left the log. */\ntype CheckpointSignal = { snapshotId: string; by: string };\n\n/** What `announceReplaced` writes into the room's control map. */\ntype ReplacedSignal = { snapshotId: string; by: string; nonce: string };\n\nconst MUTATIONS_ARRAY_KEY = \"mutations\";\nconst CONTROL_MAP_KEY = \"control\";\nconst REPLACED_KEY = \"replaced\";\nconst CHECKPOINT_KEY = \"checkpoint\";\n\nexport class WorkbookCollabSession {\n  private readonly options: WorkbookCollabSessionOptions;\n  private doc: Y.Doc | null = null;\n  private awareness: Awareness | null = null;\n  private provider: CollabProviderLike | null = null;\n  private commandDisposer: { dispose: () => void } | null = null;\n  private yArrayObserver:\n    ((event: Y.YArrayEvent<CollabMutationInfo>) => void) | null = null;\n  private awarenessObserver: (() => void) | null = null;\n  private controlObserver: ((event: Y.YMapEvent<unknown>) => void) | null = null;\n  /** >0 while this client swaps its own content: its mutations are not edits. */\n  private muted = 0;\n  private started = false;\n  private disposed = false;\n  /** Room entries this seat holds in its content: applied from a peer, or made here. */\n  private readonly applied = new Set<string>();\n  /** Entries without an id (a peer on an older build) are applied once, by identity. */\n  private readonly appliedRefs = new WeakSet<object>();\n  private seq = 0;\n  /** False until this seat has seen the room's content once (the join-time check runs then). */\n  private joined = false;\n  /** The base is being reloaded: entries wait in the log until it is shown. */\n  private reloadingBase = false;\n\n  constructor(options: WorkbookCollabSessionOptions) {\n    this.options = options;\n  }\n\n  async start(): Promise<void> {\n    if (this.started || this.disposed) return;\n    this.started = true;\n\n    this.doc = new Y.Doc();\n    this.awareness = new Awareness(this.doc);\n\n    // Seed local awareness with the user identity. Cursor (sheetId/row/col)\n    // is set later via setCursor().\n    this.awareness.setLocalState({\n      uid: this.options.uid,\n      clientId: this.options.clientId,\n      name: this.options.uid.slice(0, 8),\n      color: pickColor(this.options.uid),\n      sheetId: null,\n      row: null,\n      col: null,\n      ts: Date.now(),\n    });\n\n    this.provider = this.options.makeProvider({\n      workbookId: this.options.workbookId,\n      clientId: this.options.clientId,\n      doc: this.doc,\n      awareness: this.awareness,\n      onLeaderChange: () => {\n        if (this.awareness) this.options.onAwarenessChange?.(this.awareness);\n      },\n    });\n\n    // Subscribe to inbound Yjs array changes BEFORE connecting the provider,\n    // so the initial-state replay (if any) hits our observer.\n    const yArray = this.doc.getArray<CollabMutationInfo>(MUTATIONS_ARRAY_KEY);\n    this.yArrayObserver = (event) => {\n      // Local transactions are OUR OWN pushes from handleLocalMutation —\n      // Univer already executed those mutations. Re-applying them here would\n      // double-apply every local edit on the originator. Only act on\n      // transactions that arrived via Y.applyUpdate (origin 'remote').\n      if (event.transaction.local) return;\n      if (!event.changes.delta.some((change) => Array.isArray(change.insert) && change.insert.length > 0)) return;\n      this.drain();\n    };\n    yArray.observe(this.yArrayObserver as Parameters<typeof yArray.observe>[0]);\n\n    // Awareness change passthrough.\n    if (this.options.onAwarenessChange) {\n      const cb = this.options.onAwarenessChange;\n      this.awarenessObserver = () => {\n        if (this.awareness) cb(this.awareness);\n      };\n      this.awareness.on(\"change\", this.awarenessObserver);\n    }\n\n    // Subscribe to Univer's collab-grain mutation stream.\n    this.commandDisposer =\n      this.options.commandService.onMutationExecutedForCollab((info) =>\n        this.handleLocalMutation(info),\n      );\n\n    await this.provider.connect();\n    await this.provider.ready();\n    this.drain();\n\n    // Whole-content replacement from a peer. Bound AFTER the initial sync: a\n    // joiner already loaded the newest snapshot, so the signal it finds in\n    // the room's state is history, not news (the editor also skips a\n    // snapshot it already shows).\n    if (this.disposed || !this.doc) return;\n    const control = this.doc.getMap<unknown>(CONTROL_MAP_KEY);\n    const seen = (control.get(REPLACED_KEY) as ReplacedSignal | undefined)?.nonce ?? null;\n    this.controlObserver = (event) => {\n      if (event.transaction.local || !event.keysChanged.has(REPLACED_KEY)) return;\n      const signal = control.get(REPLACED_KEY) as ReplacedSignal | undefined;\n      if (!signal?.snapshotId || signal.nonce === seen) return;\n      this.options.onReplaced?.(signal.snapshotId);\n    };\n    control.observe(this.controlObserver);\n  }\n\n  stop(): void {\n    if (this.disposed) return;\n    this.disposed = true;\n\n    this.commandDisposer?.dispose();\n    this.commandDisposer = null;\n\n    if (this.doc && this.yArrayObserver) {\n      const yArray = this.doc.getArray<CollabMutationInfo>(MUTATIONS_ARRAY_KEY);\n      yArray.unobserve(\n        this.yArrayObserver as Parameters<typeof yArray.unobserve>[0],\n      );\n      this.yArrayObserver = null;\n    }\n\n    if (this.doc && this.controlObserver) {\n      this.doc.getMap<unknown>(CONTROL_MAP_KEY).unobserve(this.controlObserver);\n      this.controlObserver = null;\n    }\n\n    if (this.awareness && this.awarenessObserver) {\n      this.awareness.off(\"change\", this.awarenessObserver);\n      this.awarenessObserver = null;\n    }\n\n    this.provider?.disconnect();\n    this.provider = null;\n\n    if (this.awareness) {\n      this.awareness.destroy();\n      this.awareness = null;\n    }\n\n    if (this.doc) {\n      this.doc.destroy();\n      this.doc = null;\n    }\n  }\n\n  /** How many mutations the shared log holds right now. */\n  logLength(): number {\n    return this.doc?.getArray<CollabMutationInfo>(MUTATIONS_ARRAY_KEY).length ?? 0;\n  }\n\n  /**\n   * The room entries this seat's content holds RIGHT NOW. Read it in the same synchronous step as the\n   * content you are about to save, and save it with that content (`stampCovered`); after the save lands,\n   * pass it to `checkpoint`.\n   */\n  coveredNow(): string[] {\n    if (!this.doc) return [];\n    const covered = this.options.base?.covered();\n    const out: string[] = [];\n    for (const op of this.doc.getArray<CollabMutationInfo>(MUTATIONS_ARRAY_KEY).toArray()) {\n      if (op.eid && (this.applied.has(op.eid) || covered?.has(op.eid))) out.push(op.eid);\n    }\n    return out;\n  }\n\n  /**\n   * The snapshot `snapshotId` was SAVED holding `covered` (from `coveredNow`): those entries leave the\n   * shared log, and the room records the snapshot as its newest checkpoint. Removal is by entry id, never\n   * by position — an entry that arrived while the save was in flight is not in the snapshot and stays.\n   * Only the elected saver calls this; peers receive it as a delete (never replayed).\n   */\n  checkpoint(snapshotId: string, covered: readonly string[]): void {\n    if (!this.doc) return;\n    const yArray = this.doc.getArray<CollabMutationInfo>(MUTATIONS_ARRAY_KEY);\n    const control = this.doc.getMap<unknown>(CONTROL_MAP_KEY);\n    const drop = new Set(covered);\n    const signal: CheckpointSignal = { snapshotId, by: this.options.clientId };\n    this.doc.transact(() => {\n      const entries = yArray.toArray();\n      for (let i = entries.length - 1; i >= 0; i -= 1) {\n        const eid = entries[i]?.eid;\n        if (eid && drop.has(eid)) yArray.delete(i, 1);\n      }\n      control.set(CHECKPOINT_KEY, signal);\n    });\n  }\n\n  /**\n   * This client replaced the whole content and SAVED it as `snapshotId`.\n   * One transaction empties the shared mutation log (every entry targets the\n   * content that is gone — a joiner must never replay them onto the new\n   * snapshot) and tells every peer to reload the newest snapshot.\n   */\n  announceReplaced(snapshotId: string): void {\n    if (!this.doc) return;\n    const yArray = this.doc.getArray<CollabMutationInfo>(MUTATIONS_ARRAY_KEY);\n    const control = this.doc.getMap<unknown>(CONTROL_MAP_KEY);\n    const signal: ReplacedSignal = {\n      snapshotId,\n      by: this.options.clientId,\n      nonce: `${this.options.clientId}:${Date.now()}:${Math.random().toString(36).slice(2, 8)}`,\n    };\n    this.doc.transact(() => {\n      if (yArray.length > 0) yArray.delete(0, yArray.length);\n      control.set(REPLACED_KEY, signal);\n      control.set(CHECKPOINT_KEY, { snapshotId, by: this.options.clientId } satisfies CheckpointSignal);\n    });\n  }\n\n  /**\n   * Run `swap` (this client tearing its content down and mounting the new\n   * one) without broadcasting what Univer emits while it does: those are not\n   * edits, and peers reload the same snapshot themselves.\n   */\n  muteWhile<T>(swap: () => T): T {\n    this.muted += 1;\n    try {\n      return swap();\n    } finally {\n      this.muted -= 1;\n    }\n  }\n\n  /**\n   * Update the local awareness cursor. Call this from Univer's selection\n   * listener (`worksheet.onSelectionChange(...)`). Throttle at the call site\n   * (~50ms is plenty); the provider broadcasts on its own debounced cycle.\n   */\n  setCursor(input: {\n    sheetId: string | null;\n    row: number | null;\n    col: number | null;\n  }): void {\n    if (!this.awareness) return;\n    const current = this.awareness.getLocalState() ?? {};\n    this.awareness.setLocalState({\n      ...current,\n      sheetId: input.sheetId,\n      row: input.row,\n      col: input.col,\n      ts: Date.now(),\n    });\n  }\n\n  /**\n   * Returns the deterministic host: the connected peer with the lowest uid\n   * (lexicographic). Host is the only client that writes canonical snapshots.\n   * No election protocol; recompute whenever awareness changes.\n   */\n  electHost(opts: { tabTieBreak?: boolean } = {}): { isHost: boolean; hostUid: string | null } {\n    if (!this.awareness) return { isHost: false, hostUid: null };\n    const states = Array.from(this.awareness.getStates().values()) as Array<\n      Record<string, unknown>\n    >;\n    // Lowest uid wins ACROSS tabs; inside this tab only the room's tab leader\n    // may be host, because every same-tab holder carries the same uid.\n    const leader = this.provider?.isTabLeader?.() ?? true;\n    return electCollabHost(states, this.options.uid, this.options.clientId, leader, opts.tabTieBreak ?? false);\n  }\n\n  // ─── internals ────────────────────────────────────────────────────────\n\n  private handleLocalMutation(info: CollabMutationInfo): void {\n    if (this.muted > 0) return;\n    if (!this.options.forwardDocumentMutations && isCellEditorScratch(info)) return;\n    // Inbound-applied mutations re-fire this listener because Univer's\n    // syncExecuteCommand legitimately processes them through the full\n    // pipeline. Skip by sniffing the sentinel we stamped on apply.\n    if (\n      info.params &&\n      typeof info.params === \"object\" &&\n      !Array.isArray(info.params) &&\n      remoteOriginOf(info.params) !== null\n    ) {\n      return;\n    }\n    if (!this.doc) return;\n\n    // Normalize params through a JSON round-trip BEFORE pushing into Yjs.\n    // Yjs (and the Broadcast transport) only carry JSON-encodable values;\n    // Univer types its mutation params as \"serializable\" but JS objects can\n    // smuggle Date / Map / class instances through that promise. The\n    // round-trip makes the failure mode deterministic: a non-encodable\n    // mutation is skipped with a warning instead of corrupting the shared\n    // doc or desyncing peers mid-session. What we push here is byte-for-byte\n    // what remote peers will apply, so local-apply == remote-apply.\n    let safeParams: MutationParams;\n    try {\n      safeParams =\n        info.params === undefined || info.params === null\n          ? null\n          : (JSON.parse(JSON.stringify(info.params)) as MutationParams);\n    } catch (err) {\n      console.warn(\n        `[collab] skipping non-serializable mutation \"${info.id}\" — peers will not receive it`,\n        err,\n      );\n      return;\n    }\n\n    const yArray = this.doc.getArray<CollabMutationInfo>(MUTATIONS_ARRAY_KEY);\n    const eid = `${this.options.clientId}:${++this.seq}`;\n    this.applied.add(eid);\n    // An edit made here is made on what this seat shows: the join-time check is over.\n    this.joined = true;\n    yArray.push([{ id: info.id, type: info.type, params: safeParams, uid: this.options.uid, eid }]);\n  }\n\n  /**\n   * Apply every log entry this seat's content does not hold yet, in the log's order. The first time the\n   * room shows content, the join-time check runs: a seat that booted from a snapshot OLDER than the\n   * room's newest checkpoint reloads first (the entries that checkpoint trimmed exist only in it).\n   */\n  private drain(): void {\n    if (!this.doc || this.disposed || this.reloadingBase) return;\n    const yArray = this.doc.getArray<CollabMutationInfo>(MUTATIONS_ARRAY_KEY);\n    const entries = yArray.toArray();\n    const base = this.options.base;\n    if (!this.joined) {\n      const control = this.doc.getMap<unknown>(CONTROL_MAP_KEY);\n      const checkpoint = control.get(CHECKPOINT_KEY) as CheckpointSignal | undefined;\n      if (entries.length === 0 && !checkpoint) return;\n      this.joined = true;\n      if (base && checkpoint?.snapshotId && checkpoint.snapshotId !== base.snapshotId()) {\n        this.reloadingBase = true;\n        void base\n          .reload()\n          .catch((error: unknown) => {\n            console.warn(\"[collab] could not load the newest saved version on joining\", error);\n            this.options.onApplyFailed?.(\"collab.join\", error);\n          })\n          .finally(() => {\n            this.reloadingBase = false;\n            this.drain();\n          });\n        return;\n      }\n    }\n    const covered = base?.covered();\n    for (const op of entries) {\n      if (op.eid) {\n        if (this.applied.has(op.eid) || covered?.has(op.eid)) continue;\n        this.applied.add(op.eid);\n      } else {\n        if (this.appliedRefs.has(op)) continue;\n        this.appliedRefs.add(op);\n      }\n      this.applyRemoteMutation(op);\n    }\n  }\n\n  private applyRemoteMutation(op: CollabMutationInfo): void {\n    // Wrap params with the sentinel so handleLocalMutation knows not to\n    // echo the apply back into Yjs.\n    const ownUnit = this.options.unitId?.() ?? null;\n    const taggedParams: MutationParams =\n      op.params && typeof op.params === \"object\" && !Array.isArray(op.params)\n        ? {\n            ...(op.params as Record<string, unknown>),\n            ...(ownUnit && typeof (op.params as { unitId?: unknown }).unitId === \"string\" ? { unitId: ownUnit } : {}),\n            [REMOTE_PARAM_TAG]: op.uid ?? true,\n          }\n        : op.params;\n\n    try {\n      this.options.commandService.syncExecuteCommand(op.id, taggedParams, {\n        onlyLocal: true,\n        fromCollab: true,\n      });\n    } catch (err) {\n      // One unappliable op (already baked into the loaded snapshot, or a\n      // stale target) must not throw into the realtime channel handler and\n      // abort the rest of the catch-up. Said, never swallowed.\n      console.warn(\n        `[collab] could not apply remote mutation \"${op.id}\" — skipped`,\n        err,\n      );\n      this.options.onApplyFailed?.(op.id, err);\n    }\n  }\n}\n\n// ─── helpers ────────────────────────────────────────────────────────────\n\n/**\n * A workbook holds no Univer DOCUMENT units of its own: the `doc.mutation.*` stream a sheet emits is\n * the in-cell editor's scratch document (typing into a cell). The finished text reaches the sheet as\n * `sheet.mutation.set-range-values`, which does travel. Sending the scratch edits made a joiner replay\n * them against an editor unit it does not have (\"Trying to overwrite value at key\").\n */\nexport function isCellEditorScratch(info: Pick<CollabMutationInfo, \"id\">): boolean {\n  return typeof info.id === \"string\" && info.id.startsWith(\"doc.mutation.\");\n}\n\nconst CURSOR_PALETTE = [\n  \"#3b82f6\", // blue\n  \"#10b981\", // emerald\n  \"#f59e0b\", // amber\n  \"#ef4444\", // red\n  \"#8b5cf6\", // violet\n  \"#06b6d4\", // cyan\n  \"#ec4899\", // pink\n  \"#84cc16\", // lime\n];\n\nfunction pickColor(uid: string): string {\n  // Deterministic FNV-1a-ish hash so the same user is always the same color\n  // across sessions and across other users' screens.\n  let h = 2166136261;\n  for (let i = 0; i < uid.length; i++) {\n    h ^= uid.charCodeAt(i);\n    h = Math.imul(h, 16777619);\n  }\n  return CURSOR_PALETTE[Math.abs(h) % CURSOR_PALETTE.length] ?? \"#ec4899\";\n}\n","/**\n * A saved snapshot names the collab-room entries it already holds, so a seat that boots from it never\n * replays them (2026-10-16: a reload showed the text twice). Pure — no Yjs — so the editors' model can\n * stamp and read it without loading the room.\n */\n\n/** The key a saved snapshot carries its covered room entries under (`stampCovered` / `takeCovered`). */\nexport const COLLAB_COVERED_KEY = \"__matrxCollabCovered\";\n\n/** The snapshot to SAVE: `snapshot` plus the room entries it holds (`WorkbookCollabSession.coveredNow`). */\nexport function stampCovered<T extends object>(snapshot: T, covered: readonly string[]): T {\n  return { ...snapshot, [COLLAB_COVERED_KEY]: [...covered] };\n}\n\n/** A LOADED snapshot split into the content to mount and the room entries it already holds. */\nexport function takeCovered<T>(snapshot: T): { snapshot: T; covered: Set<string> } {\n  if (!snapshot || typeof snapshot !== \"object\" || !(COLLAB_COVERED_KEY in (snapshot as object))) {\n    return { snapshot, covered: new Set() };\n  }\n  const { [COLLAB_COVERED_KEY]: list, ...rest } = snapshot as Record<string, unknown>;\n  return {\n    snapshot: rest as T,\n    covered: new Set(Array.isArray(list) ? list.filter((e): e is string => typeof e === \"string\") : []),\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/univer/collab/WorkbookCollabSession.ts","../src/univer/collab/covered.ts"],"sourcesContent":["/**\n * WorkbookCollabSession — the Univer ↔ Yjs bridge.\n *\n * Subscribes to Univer's public `commandService.onMutationExecutedForCollab`\n * hook for local mutations and pushes them onto a `Y.Array<MutationOp>` shared\n * via `SupabaseYjsProvider`. Inbound Yjs updates produce `IMutationInfo` ops\n * that are applied through `commandService.syncExecuteCommand` with the\n * `fromCollab` execution option flagged so the outbound listener short-\n * circuits and we don't echo our own apply.\n *\n * See `FEATURE.md` in this directory for the architecture, the \"do NOT use\n * the Pro preset\" verdict, and the host-election rule. This class is the\n * runtime side of that plan.\n *\n * Lifecycle:\n *   - constructor: wire references, no side effects\n *   - start():   create Y.Doc + Awareness, instantiate provider, subscribe to\n *                command stream, subscribe to Yjs Array observer\n *   - stop():    detach all listeners, dispose provider\n *\n * The session is one-shot per workbook open. Reload = stop() + new instance.\n */\n\"use client\";\n\nimport * as Y from \"yjs\";\nimport { Awareness } from \"y-protocols/awareness\";\n\nimport { electCollabHost, remoteOriginOf, REMOTE_PARAM_TAG } from \"@ai-matrx/data/realtime/collab\";\n\nexport { COLLAB_COVERED_KEY, stampCovered, takeCovered } from \"./covered\";\n\n/**\n * Structural transport contract. `SupabaseYjsProvider` satisfies it in\n * production; the verification harness injects an in-memory loopback\n * transport through the same seam. Keeping this structural (not the concrete\n * class) is what makes the session testable without network.\n */\nexport type CollabProviderLike = {\n  connect(): Promise<void>;\n  disconnect(): void;\n  ready(): Promise<void>;\n  /**\n   * True when this is the only holder of its room in this tab allowed to act as\n   * host (autosave). Same-tab holders share one client id and one uid, so\n   * awareness cannot tell them apart. Absent = a lone holder = leader.\n   */\n  isTabLeader?(): boolean;\n};\n\n// Univer types are loose at the public hook boundary; we narrow with a\n// structural interface so we don't have to import the full Univer surface.\ntype MutationParams = Record<string, unknown> | unknown[] | null;\n\nexport type CollabMutationInfo = {\n  id: string;\n  type: number; // CommandType.MUTATION = 2 in Univer's enum\n  params: MutationParams;\n  /** Who made it (the person's uid), so a peer can tell its own other tab's edit from a stranger's. */\n  uid?: string;\n  /**\n   * The entry's identity in the room (`<clientId>:<seq>`). A saved snapshot names the entries it holds\n   * (`stampCovered`), so a seat that boots from that snapshot never replays them a second time.\n   */\n  eid?: string;\n};\n\n/**\n * What a seat booted from: the saved snapshot's row id and the room entries that snapshot already holds.\n * The session never replays a covered entry, and a seat that booted from an OLDER snapshot than the\n * room's newest checkpoint first reloads (the entries that checkpoint trimmed are only in that snapshot).\n */\nexport type CollabBase = {\n  snapshotId: () => string | null;\n  covered: () => ReadonlySet<string>;\n  /** Show the newest saved snapshot (and make it the base). */\n  reload: () => Promise<void>;\n};\n\ntype ExecuteOptions = {\n  /** Per-Univer convention: when true, the command runs locally only and is\n   *  NOT broadcast to other plugins. We set this on inbound-apply so the\n   *  subsequent onMutationExecutedForCollab does NOT re-fire on our peer. */\n  onlyLocal?: boolean;\n  fromCollab?: boolean;\n};\n\nexport type CommandServiceLike = {\n  onMutationExecutedForCollab(\n    listener: (info: CollabMutationInfo, options?: ExecuteOptions) => void,\n  ): {\n    dispose: () => void;\n  };\n  syncExecuteCommand(\n    id: string,\n    params: MutationParams,\n    options?: ExecuteOptions,\n  ): unknown;\n};\n\nexport type WorkbookCollabSessionOptions = {\n  workbookId: string;\n  uid: string;\n  clientId: string;\n  commandService: CommandServiceLike;\n  /** Factory so this file does not statically depend on the provider. */\n  makeProvider: (args: {\n    workbookId: string;\n    clientId: string;\n    doc: Y.Doc;\n    awareness: Awareness;\n    /** Wire to the provider so a host handover re-runs the election. */\n    onLeaderChange: () => void;\n  }) => CollabProviderLike;\n  /** Called when the awareness set changes (peers join / leave / move cursor). */\n  onAwarenessChange?: (awareness: Awareness) => void;\n  /**\n   * A peer replaced the whole content (history restore, Google update): the\n   * newest saved snapshot is the content now. Reload it in place; never\n   * re-announce. See `announceReplaced`.\n   */\n  onReplaced?: (snapshotId: string) => void;\n  /**\n   * TRUE when the room is bound to a Univer DOCUMENT unit (the Docs editor): there the `doc.mutation.*`\n   * stream IS the content, so it must travel. Leave unset for a workbook, where `doc.mutation.*` is the\n   * in-cell editor's scratch document and never travels (see `isCellEditorScratch`).\n   */\n  forwardDocumentMutations?: boolean;\n  /**\n   * The Univer unit id this seat mounted. Each seat can mount its own unit, so a peer's mutation\n   * (addressed to the SENDER's unit) is re-addressed to this one before it is applied.\n   */\n  unitId?: () => string | null;\n  /** A peer's mutation could not be applied here: the seat says so and re-syncs; never only a console line. */\n  onApplyFailed?: (mutationId: string, error: unknown) => void;\n  /**\n   * The saved snapshot this seat booted from. Without it a reloading seat replays every entry still in\n   * the room's log on top of a snapshot that already holds them: the text shows twice, and the next save\n   * stores it twice (2026-10-16).\n   */\n  base?: CollabBase;\n};\n\n/** What `checkpoint` writes into the room's control map: the newest saved snapshot whose entries left the log. */\ntype CheckpointSignal = { snapshotId: string; by: string };\n\n/** What `announceReplaced` writes into the room's control map. */\ntype ReplacedSignal = { snapshotId: string; by: string; nonce: string };\n\nconst MUTATIONS_ARRAY_KEY = \"mutations\";\nconst CONTROL_MAP_KEY = \"control\";\nconst REPLACED_KEY = \"replaced\";\nconst CHECKPOINT_KEY = \"checkpoint\";\n\nexport class WorkbookCollabSession {\n  private readonly options: WorkbookCollabSessionOptions;\n  private doc: Y.Doc | null = null;\n  private awareness: Awareness | null = null;\n  private provider: CollabProviderLike | null = null;\n  private commandDisposer: { dispose: () => void } | null = null;\n  private yArrayObserver:\n    ((event: Y.YArrayEvent<CollabMutationInfo>) => void) | null = null;\n  private awarenessObserver: (() => void) | null = null;\n  private controlObserver: ((event: Y.YMapEvent<unknown>) => void) | null = null;\n  /** >0 while this client swaps its own content: its mutations are not edits. */\n  private muted = 0;\n  private started = false;\n  private disposed = false;\n  /** Room entries this seat holds in its content: applied from a peer, or made here. */\n  private readonly applied = new Set<string>();\n  /** Entries without an id (a peer on an older build) are applied once, by identity. */\n  private readonly appliedRefs = new WeakSet<object>();\n  private seq = 0;\n  /** False until this seat has seen the room's content once (the join-time check runs then). */\n  private joined = false;\n  /** The base is being reloaded: entries wait in the log until it is shown. */\n  private reloadingBase = false;\n\n  constructor(options: WorkbookCollabSessionOptions) {\n    this.options = options;\n  }\n\n  async start(): Promise<void> {\n    if (this.started || this.disposed) return;\n    this.started = true;\n\n    this.doc = new Y.Doc();\n    this.awareness = new Awareness(this.doc);\n\n    // Seed local awareness with the user identity. Cursor (sheetId/row/col)\n    // is set later via setCursor().\n    this.awareness.setLocalState({\n      uid: this.options.uid,\n      clientId: this.options.clientId,\n      name: this.options.uid.slice(0, 8),\n      color: pickColor(this.options.uid),\n      sheetId: null,\n      row: null,\n      col: null,\n      ts: Date.now(),\n    });\n\n    this.provider = this.options.makeProvider({\n      workbookId: this.options.workbookId,\n      clientId: this.options.clientId,\n      doc: this.doc,\n      awareness: this.awareness,\n      onLeaderChange: () => {\n        if (this.awareness) this.options.onAwarenessChange?.(this.awareness);\n      },\n    });\n\n    // Subscribe to inbound Yjs array changes BEFORE connecting the provider,\n    // so the initial-state replay (if any) hits our observer.\n    const yArray = this.doc.getArray<CollabMutationInfo>(MUTATIONS_ARRAY_KEY);\n    this.yArrayObserver = (event) => {\n      // Local transactions are OUR OWN pushes from handleLocalMutation —\n      // Univer already executed those mutations. Re-applying them here would\n      // double-apply every local edit on the originator. Only act on\n      // transactions that arrived via Y.applyUpdate (origin 'remote').\n      if (event.transaction.local) return;\n      if (!event.changes.delta.some((change) => Array.isArray(change.insert) && change.insert.length > 0)) return;\n      this.drain();\n    };\n    yArray.observe(this.yArrayObserver as Parameters<typeof yArray.observe>[0]);\n\n    // Awareness change passthrough.\n    if (this.options.onAwarenessChange) {\n      const cb = this.options.onAwarenessChange;\n      this.awarenessObserver = () => {\n        if (this.awareness) cb(this.awareness);\n      };\n      this.awareness.on(\"change\", this.awarenessObserver);\n    }\n\n    // Subscribe to Univer's collab-grain mutation stream.\n    this.commandDisposer =\n      this.options.commandService.onMutationExecutedForCollab((info, options) =>\n        this.handleLocalMutation(info, options),\n      );\n\n    await this.provider.connect();\n    await this.provider.ready();\n    this.drain();\n\n    // Whole-content replacement from a peer. Bound AFTER the initial sync: a\n    // joiner already loaded the newest snapshot, so the signal it finds in\n    // the room's state is history, not news (the editor also skips a\n    // snapshot it already shows).\n    if (this.disposed || !this.doc) return;\n    const control = this.doc.getMap<unknown>(CONTROL_MAP_KEY);\n    const seen = (control.get(REPLACED_KEY) as ReplacedSignal | undefined)?.nonce ?? null;\n    this.controlObserver = (event) => {\n      if (event.transaction.local || !event.keysChanged.has(REPLACED_KEY)) return;\n      const signal = control.get(REPLACED_KEY) as ReplacedSignal | undefined;\n      if (!signal?.snapshotId || signal.nonce === seen) return;\n      this.options.onReplaced?.(signal.snapshotId);\n    };\n    control.observe(this.controlObserver);\n  }\n\n  stop(): void {\n    if (this.disposed) return;\n    this.disposed = true;\n\n    this.commandDisposer?.dispose();\n    this.commandDisposer = null;\n\n    if (this.doc && this.yArrayObserver) {\n      const yArray = this.doc.getArray<CollabMutationInfo>(MUTATIONS_ARRAY_KEY);\n      yArray.unobserve(\n        this.yArrayObserver as Parameters<typeof yArray.unobserve>[0],\n      );\n      this.yArrayObserver = null;\n    }\n\n    if (this.doc && this.controlObserver) {\n      this.doc.getMap<unknown>(CONTROL_MAP_KEY).unobserve(this.controlObserver);\n      this.controlObserver = null;\n    }\n\n    if (this.awareness && this.awarenessObserver) {\n      this.awareness.off(\"change\", this.awarenessObserver);\n      this.awarenessObserver = null;\n    }\n\n    this.provider?.disconnect();\n    this.provider = null;\n\n    if (this.awareness) {\n      this.awareness.destroy();\n      this.awareness = null;\n    }\n\n    if (this.doc) {\n      this.doc.destroy();\n      this.doc = null;\n    }\n  }\n\n  /** How many mutations the shared log holds right now. */\n  logLength(): number {\n    return this.doc?.getArray<CollabMutationInfo>(MUTATIONS_ARRAY_KEY).length ?? 0;\n  }\n\n  /**\n   * The room entries this seat's content holds RIGHT NOW. Read it in the same synchronous step as the\n   * content you are about to save, and save it with that content (`stampCovered`); after the save lands,\n   * pass it to `checkpoint`.\n   */\n  coveredNow(): string[] {\n    if (!this.doc) return [];\n    const covered = this.options.base?.covered();\n    const out: string[] = [];\n    for (const op of this.doc.getArray<CollabMutationInfo>(MUTATIONS_ARRAY_KEY).toArray()) {\n      if (op.eid && (this.applied.has(op.eid) || covered?.has(op.eid))) out.push(op.eid);\n    }\n    return out;\n  }\n\n  /**\n   * The snapshot `snapshotId` was SAVED holding `covered` (from `coveredNow`): those entries leave the\n   * shared log, and the room records the snapshot as its newest checkpoint. Removal is by entry id, never\n   * by position — an entry that arrived while the save was in flight is not in the snapshot and stays.\n   * Only the elected saver calls this; peers receive it as a delete (never replayed).\n   */\n  checkpoint(snapshotId: string, covered: readonly string[]): void {\n    if (!this.doc) return;\n    const yArray = this.doc.getArray<CollabMutationInfo>(MUTATIONS_ARRAY_KEY);\n    const control = this.doc.getMap<unknown>(CONTROL_MAP_KEY);\n    const drop = new Set(covered);\n    const signal: CheckpointSignal = { snapshotId, by: this.options.clientId };\n    this.doc.transact(() => {\n      const entries = yArray.toArray();\n      for (let i = entries.length - 1; i >= 0; i -= 1) {\n        const eid = entries[i]?.eid;\n        if (eid && drop.has(eid)) yArray.delete(i, 1);\n      }\n      control.set(CHECKPOINT_KEY, signal);\n    });\n  }\n\n  /**\n   * This client replaced the whole content and SAVED it as `snapshotId`.\n   * One transaction empties the shared mutation log (every entry targets the\n   * content that is gone — a joiner must never replay them onto the new\n   * snapshot) and tells every peer to reload the newest snapshot.\n   */\n  announceReplaced(snapshotId: string): void {\n    if (!this.doc) return;\n    const yArray = this.doc.getArray<CollabMutationInfo>(MUTATIONS_ARRAY_KEY);\n    const control = this.doc.getMap<unknown>(CONTROL_MAP_KEY);\n    const signal: ReplacedSignal = {\n      snapshotId,\n      by: this.options.clientId,\n      nonce: `${this.options.clientId}:${Date.now()}:${Math.random().toString(36).slice(2, 8)}`,\n    };\n    this.doc.transact(() => {\n      if (yArray.length > 0) yArray.delete(0, yArray.length);\n      control.set(REPLACED_KEY, signal);\n      control.set(CHECKPOINT_KEY, { snapshotId, by: this.options.clientId } satisfies CheckpointSignal);\n    });\n  }\n\n  /**\n   * Run `swap` (this client tearing its content down and mounting the new\n   * one) without broadcasting what Univer emits while it does: those are not\n   * edits, and peers reload the same snapshot themselves.\n   */\n  muteWhile<T>(swap: () => T): T {\n    this.muted += 1;\n    try {\n      return swap();\n    } finally {\n      this.muted -= 1;\n    }\n  }\n\n  /**\n   * Update the local awareness cursor. Call this from Univer's selection\n   * listener (`worksheet.onSelectionChange(...)`). Throttle at the call site\n   * (~50ms is plenty); the provider broadcasts on its own debounced cycle.\n   */\n  setCursor(input: {\n    sheetId: string | null;\n    row: number | null;\n    col: number | null;\n  }): void {\n    if (!this.awareness) return;\n    const current = this.awareness.getLocalState() ?? {};\n    this.awareness.setLocalState({\n      ...current,\n      sheetId: input.sheetId,\n      row: input.row,\n      col: input.col,\n      ts: Date.now(),\n    });\n  }\n\n  /**\n   * Returns the deterministic host: the connected peer with the lowest uid\n   * (lexicographic). Host is the only client that writes canonical snapshots.\n   * No election protocol; recompute whenever awareness changes.\n   */\n  electHost(opts: { tabTieBreak?: boolean } = {}): { isHost: boolean; hostUid: string | null } {\n    if (!this.awareness) return { isHost: false, hostUid: null };\n    const states = Array.from(this.awareness.getStates().values()) as Array<\n      Record<string, unknown>\n    >;\n    // Lowest uid wins ACROSS tabs; inside this tab only the room's tab leader\n    // may be host, because every same-tab holder carries the same uid.\n    const leader = this.provider?.isTabLeader?.() ?? true;\n    return electCollabHost(states, this.options.uid, this.options.clientId, leader, opts.tabTieBreak ?? false);\n  }\n\n  // ─── internals ────────────────────────────────────────────────────────\n\n  private handleLocalMutation(info: CollabMutationInfo, options?: ExecuteOptions): void {\n    if (this.muted > 0) return;\n    // Univer marks a mutation `onlyLocal` when every seat derives it itself (formula-engine recalculation,\n    // layout results): relaying it turns every recalculation into network traffic and a logged op.\n    if (options?.onlyLocal) return;\n    if (!this.options.forwardDocumentMutations && isCellEditorScratch(info)) return;\n    // Inbound-applied mutations re-fire this listener because Univer's\n    // syncExecuteCommand legitimately processes them through the full\n    // pipeline. Skip by sniffing the sentinel we stamped on apply.\n    if (\n      info.params &&\n      typeof info.params === \"object\" &&\n      !Array.isArray(info.params) &&\n      remoteOriginOf(info.params) !== null\n    ) {\n      return;\n    }\n    if (!this.doc) return;\n\n    // Normalize params through a JSON round-trip BEFORE pushing into Yjs.\n    // Yjs (and the Broadcast transport) only carry JSON-encodable values;\n    // Univer types its mutation params as \"serializable\" but JS objects can\n    // smuggle Date / Map / class instances through that promise. The\n    // round-trip makes the failure mode deterministic: a non-encodable\n    // mutation is skipped with a warning instead of corrupting the shared\n    // doc or desyncing peers mid-session. What we push here is byte-for-byte\n    // what remote peers will apply, so local-apply == remote-apply.\n    let safeParams: MutationParams;\n    try {\n      safeParams =\n        info.params === undefined || info.params === null\n          ? null\n          : stripSenderView(JSON.parse(JSON.stringify(info.params)) as MutationParams);\n    } catch (err) {\n      console.warn(\n        `[collab] skipping non-serializable mutation \"${info.id}\" — peers will not receive it`,\n        err,\n      );\n      return;\n    }\n\n    const yArray = this.doc.getArray<CollabMutationInfo>(MUTATIONS_ARRAY_KEY);\n    const eid = `${this.options.clientId}:${++this.seq}`;\n    this.applied.add(eid);\n    // An edit made here is made on what this seat shows: the join-time check is over.\n    this.joined = true;\n    yArray.push([{ id: info.id, type: info.type, params: safeParams, uid: this.options.uid, eid }]);\n  }\n\n  /**\n   * Apply every log entry this seat's content does not hold yet, in the log's order. The first time the\n   * room shows content, the join-time check runs: a seat that booted from a snapshot OLDER than the\n   * room's newest checkpoint reloads first (the entries that checkpoint trimmed exist only in it).\n   */\n  private drain(): void {\n    if (!this.doc || this.disposed || this.reloadingBase) return;\n    const yArray = this.doc.getArray<CollabMutationInfo>(MUTATIONS_ARRAY_KEY);\n    const entries = yArray.toArray();\n    const base = this.options.base;\n    if (!this.joined) {\n      const control = this.doc.getMap<unknown>(CONTROL_MAP_KEY);\n      const checkpoint = control.get(CHECKPOINT_KEY) as CheckpointSignal | undefined;\n      if (entries.length === 0 && !checkpoint) return;\n      this.joined = true;\n      if (base && checkpoint?.snapshotId && checkpoint.snapshotId !== base.snapshotId()) {\n        this.reloadingBase = true;\n        void base\n          .reload()\n          .catch((error: unknown) => {\n            console.warn(\"[collab] could not load the newest saved version on joining\", error);\n            this.options.onApplyFailed?.(\"collab.join\", error);\n          })\n          .finally(() => {\n            this.reloadingBase = false;\n            this.drain();\n          });\n        return;\n      }\n    }\n    const covered = base?.covered();\n    for (const op of entries) {\n      if (op.eid) {\n        if (this.applied.has(op.eid) || covered?.has(op.eid)) continue;\n        this.applied.add(op.eid);\n      } else {\n        if (this.appliedRefs.has(op)) continue;\n        this.appliedRefs.add(op);\n      }\n      this.applyRemoteMutation(op);\n    }\n  }\n\n  private applyRemoteMutation(op: CollabMutationInfo): void {\n    // Wrap params with the sentinel so handleLocalMutation knows not to\n    // echo the apply back into Yjs.\n    const ownUnit = this.options.unitId?.() ?? null;\n    const taggedParams: MutationParams =\n      op.params && typeof op.params === \"object\" && !Array.isArray(op.params)\n        ? {\n            ...(op.params as Record<string, unknown>),\n            ...(ownUnit && typeof (op.params as { unitId?: unknown }).unitId === \"string\" ? { unitId: ownUnit } : {}),\n            [REMOTE_PARAM_TAG]: op.uid ?? true,\n          }\n        : op.params;\n\n    try {\n      this.options.commandService.syncExecuteCommand(op.id, taggedParams, {\n        onlyLocal: true,\n        fromCollab: true,\n      });\n    } catch (err) {\n      // One unappliable op (already baked into the loaded snapshot, or a\n      // stale target) must not throw into the realtime channel handler and\n      // abort the rest of the catch-up. Said, never swallowed.\n      console.warn(\n        `[collab] could not apply remote mutation \"${op.id}\" — skipped`,\n        err,\n      );\n      this.options.onApplyFailed?.(op.id, err);\n    }\n  }\n}\n\n// ─── helpers ────────────────────────────────────────────────────────────\n\n/**\n * A workbook holds no Univer DOCUMENT units of its own: the `doc.mutation.*` stream a sheet emits is\n * the in-cell editor's scratch document (typing into a cell). The finished text reaches the sheet as\n * `sheet.mutation.set-range-values`, which does travel. Sending the scratch edits made a joiner replay\n * them against an editor unit it does not have (\"Trying to overwrite value at key\").\n */\nexport const SENDER_VIEW_PARAMS: readonly string[] = [\"layoutState\", \"textRanges\", \"prevTextRanges\"];\n\n/**\n * Remove what describes the SENDER'S view (the editor's layout cache, caret and selection ranges) from a\n * mutation's params before it travels: a receiver would otherwise restore the sender's layout and caret.\n * Everything else (the content-changing `actions`, ids, addresses) is left as is.\n */\nexport function stripSenderView(params: MutationParams): MutationParams {\n  if (!params || typeof params !== \"object\" || Array.isArray(params)) return params;\n  const out: Record<string, unknown> = { ...params };\n  for (const key of SENDER_VIEW_PARAMS) delete out[key];\n  return out;\n}\n\nexport function isCellEditorScratch(info: Pick<CollabMutationInfo, \"id\">): boolean {\n  return typeof info.id === \"string\" && info.id.startsWith(\"doc.mutation.\");\n}\n\nconst CURSOR_PALETTE = [\n  \"#3b82f6\", // blue\n  \"#10b981\", // emerald\n  \"#f59e0b\", // amber\n  \"#ef4444\", // red\n  \"#8b5cf6\", // violet\n  \"#06b6d4\", // cyan\n  \"#ec4899\", // pink\n  \"#84cc16\", // lime\n];\n\nfunction pickColor(uid: string): string {\n  // Deterministic FNV-1a-ish hash so the same user is always the same color\n  // across sessions and across other users' screens.\n  let h = 2166136261;\n  for (let i = 0; i < uid.length; i++) {\n    h ^= uid.charCodeAt(i);\n    h = Math.imul(h, 16777619);\n  }\n  return CURSOR_PALETTE[Math.abs(h) % CURSOR_PALETTE.length] ?? \"#ec4899\";\n}\n","/**\n * A saved snapshot names the collab-room entries it already holds, so a seat that boots from it never\n * replays them (2026-10-16: a reload showed the text twice). Pure — no Yjs — so the editors' model can\n * stamp and read it without loading the room.\n */\n\n/** The key a saved snapshot carries its covered room entries under (`stampCovered` / `takeCovered`). */\nexport const COLLAB_COVERED_KEY = \"__matrxCollabCovered\";\n\n/** The snapshot to SAVE: `snapshot` plus the room entries it holds (`WorkbookCollabSession.coveredNow`). */\nexport function stampCovered<T extends object>(snapshot: T, covered: readonly string[]): T {\n  return { ...snapshot, [COLLAB_COVERED_KEY]: [...covered] };\n}\n\n/** A LOADED snapshot split into the content to mount and the room entries it already holds. */\nexport function takeCovered<T>(snapshot: T): { snapshot: T; covered: Set<string> } {\n  if (!snapshot || typeof snapshot !== \"object\" || !(COLLAB_COVERED_KEY in (snapshot as object))) {\n    return { snapshot, covered: new Set() };\n  }\n  const { [COLLAB_COVERED_KEY]: list, ...rest } = snapshot as Record<string, unknown>;\n  return {\n    snapshot: rest as T,\n    covered: new Set(Array.isArray(list) ? list.filter((e): e is string => typeof e === \"string\") : []),\n  };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/office",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "The AI Matrx Office layer: the editors' shared command and menu model, the Google and Microsoft ribbon model, page setup, the Office record types and the configured product hosts. The Univer glue shared by Sheets and Docs. Sheets, Docs and the other products arrive as sections of this one package.",
   "type": "module",
   "main": "./dist/core.cjs",
@@ -151,6 +151,16 @@
         "types": "./dist/docs-tools.d.cts",
         "default": "./dist/docs-tools.cjs"
       }
+    },
+    "./collab/sheets-transform": {
+      "import": {
+        "types": "./dist/collab-sheets-transform.d.ts",
+        "default": "./dist/collab-sheets-transform.js"
+      },
+      "require": {
+        "types": "./dist/collab-sheets-transform.d.cts",
+        "default": "./dist/collab-sheets-transform.cjs"
+      }
     }
   },
   "dependencies": {
@@ -158,28 +168,31 @@
     "@univerjs/docs": "1.0.4",
     "@univerjs/icons": "1.43.1",
     "@univerjs/presets": "1.0.4",
+    "@univerjs/sheets": "1.0.4",
     "@univerjs/ui": "1.0.4",
     "y-protocols": "^1.0.7",
     "yjs": "^13.6.33",
     "@ai-matrx/alchemy": "latest",
     "@ai-matrx/api": "latest",
     "@ai-matrx/auth": "latest",
-    "@ai-matrx/data": "latest",
     "@ai-matrx/content-ir": "latest",
+    "@ai-matrx/data": "latest",
     "@ai-matrx/kit": "latest",
     "@ai-matrx/print": "latest",
     "@ai-matrx/records": "latest",
     "@ai-matrx/rich-content": "latest"
   },
   "peerDependencies": {
-    "react": ">=18.0.0",
-    "@supabase/supabase-js": ">=2.0.0"
+    "@supabase/supabase-js": ">=2.0.0",
+    "react": ">=18.0.0"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
     "@supabase/supabase-js": "^2.117.0",
     "@types/node": "^26.6.2",
     "@types/react": "19.3.0",
+    "@univerjs/engine-formula": "1.0.4",
+    "@univerjs/engine-render": "1.0.4",
     "jsdom": "^30.1.1",
     "publint": "^0.3.24",
     "react": "^19.3.0",
@@ -221,5 +234,5 @@
     "test:watch": "vitest",
     "verify:tarball": "node ./scripts/verify-tarball.mjs"
   },
-  "gitHead": "dc7cb47c4b04e105e9058efccf765ba7b770a4b2"
+  "gitHead": "3d2a47e84dd5932df84c17e6f9087f2abc600dd8"
 }