@ai-matrx/office 0.8.23 → 0.8.25

package/dist/univer-collab.d.cts

@@ -1,6 +1,6 @@
 import * as Y from 'yjs';
 import { Awareness } from 'y-protocols/awareness';
-import { OpSessionNotice, OpSession, OpTransport, OpPresence, OpSessionIncident, OpSessionStatus, AwarenessState, CollabRpcClient, collabReplace, OpDocumentAdapter } from '@ai-matrx/data/realtime/collab';
+import { OpSessionNotice, OpSession, OpTransport, OpPresence, OpSessionIncident, OpSessionStatus, OpOfflineOptions, OpOfflineState, AwarenessState, CollabRpcClient, collabReplace, OpDocumentAdapter, CollabGroup } from '@ai-matrx/data/realtime/collab';
 import { IDocumentData } from '@univerjs/core';
 import { CommitReason } from '@ai-matrx/kit/working-copy';
 
@@ -362,6 +362,10 @@ interface OpenDocsOtRoomOptions {
     onNotice?: (n: DocsOtNotice) => void;
     onIncident?: (i: OpSessionIncident) => void;
     onStatus?: (s: OpSessionStatus) => void;
+    /** C10: unsent edits persist on this device under a lease (the host builds it: `browserOfflineOptions`). */
+    offline?: OpOfflineOptions | null;
+    /** C10: the chrome's offline state. */
+    onOffline?: (s: OpOfflineState) => void;
     /** Watch IME composition here (default: `document`). */
     compositionTarget?: Pick<Document, "addEventListener" | "removeEventListener"> | null;
 }
@@ -481,6 +485,8 @@ interface DocumentOtFactoryOptions {
     onNotice?: (n: DocsOtNotice) => void;
     onIncident?: (i: OpSessionIncident) => void;
     onStatus?: (s: OpSessionStatus) => void;
+    /** C10: the chrome's offline state (unsent edits are kept on this device, one tab per document and person owns them). */
+    onOffline?: (s: OpOfflineState) => void;
 }
 /** The `DocumentModel.startOtRoom` factory for one document. */
 declare function documentOtFactory(o: DocumentOtFactoryOptions): DocumentOtFactory;
@@ -599,6 +605,12 @@ interface SheetsOtPort {
         service: unknown;
         unitId: string;
     }>;
+    /**
+     * Run `fn` right before this seat takes an undo or redo (synchronously, before the command reads its stack). With
+     * it the room rebases the undo stack lazily: a remote op only queues, and an undo catches its stack up first.
+     * Without it every remote op rebases the whole stack at once.
+     */
+    beforeUndo?(fn: () => void): () => void;
     /** Ask for a save (the record's one coalesced save). */
     markDirty(): void;
 }
@@ -651,6 +663,8 @@ declare function rebaseSheetUndoStack(items: UndoItem[], remote: SheetOp, unitId
 interface SheetsOtAdapterHooks {
     /** Called once per applied remote op that rebased this seat's undo stacks (for tests and logs). */
     onUndoRebased?: (dropped: number) => void;
+    /** Called with the milliseconds of undo bookkeeping each remote op (and each catch-up) cost (tests, logs). */
+    onUndoWork?: (ms: number, kind: "remote" | "catch_up") => void;
     /**
      * The state hash of a snapshot (default `sheetsStateHash`, Web Crypto). A seeded test passes a synchronous one:
      * Web Crypto resolves on a worker thread, outside a virtual clock, so the same seed would not replay.
@@ -683,6 +697,10 @@ interface OpenSheetsOtRoomOptions {
     onNotice?: (n: SheetsOtNotice) => void;
     onIncident?: (i: OpSessionIncident) => void;
     onStatus?: (s: OpSessionStatus) => void;
+    /** C10: unsent edits persist on this device under a lease (the host builds it: `browserOfflineOptions`). */
+    offline?: OpOfflineOptions | null;
+    /** C10: the chrome's offline state. */
+    onOffline?: (s: OpOfflineState) => void;
 }
 interface SheetsOtRoom {
     session: OpSession<SheetOp>;
@@ -821,6 +839,15 @@ declare const canonicalSheetString: (snapshot: unknown) => string;
 /** SHA-256 (hex) of the canonical form. Web Crypto, so the browser and Node compute the same hash. */
 declare function sheetsStateHash(snapshot: unknown): Promise<string>;
 
+/**
+ * "Copy my offline text" (C10): the words a person typed while offline, pulled out of the wire groups of a buffer
+ * the room refused (changed protocol, document trashed). Format-light on purpose: Docs inserts carry their text in
+ * `body.dataStream`; Sheets writes carry cell values in `cellValue`. Anything else contributes nothing, and the
+ * caller says so when nothing could be read (the record stays on the device regardless).
+ */
+
+declare function offlineTextOfGroups(buffers: CollabGroup[][]): string;
+
 /** `collab.ot_rooms` (§12.2): which workbooks without a room open one. */
 type WorkbookOtRoomsKnob = "off" | "new" | "all";
 /** Whether this workbook opens on the ordered log: its room exists, or the knob opens one. */
@@ -836,6 +863,8 @@ interface WorkbookOtRoomOptions {
     onNotice?: (n: SheetsOtNotice) => void;
     onIncident?: (i: OpSessionIncident) => void;
     onStatus?: (s: OpSessionStatus) => void;
+    /** C10: the chrome's offline state (unsent edits are kept on this device, one tab per workbook and person owns them). */
+    onOffline?: (s: OpOfflineState) => void;
 }
 interface WorkbookOtRoomHandle {
     session: OpSession<SheetOp>;
@@ -857,4 +886,4 @@ declare function startWorkbookOtRoom(port: SheetsOtPort & {
     dispose?: () => void;
 }, o: WorkbookOtRoomOptions): Promise<WorkbookOtRoomHandle>;
 
-export { COLLAB_COVERED_KEY, type CollabBase, type CollabMutationInfo, type CollabProviderLike, type CommandServiceLike, DOCS_COLLAB_PROTO, DOCS_TRANSFORM_VERSION, DOC_LOCAL_KEYS, type DocsLocalMutation, type DocsLost, type DocsOp, type DocsOtNotice, type DocsOtPort, type DocsOtRoom, type DocsTransformResult, type DocumentOtFactoryOptions, type DocumentRestoreDeps, type DocumentRestoreResult, type OpenDocsOtRoomOptions, type OpenSheetsOtRoomOptions, type OtRoomsKnob, RICH_TEXT_EDITING, SENDER_VIEW_PARAMS, SHEETS_COLLAB_PROTO, SHEETS_EDIT_GROUP, type SheetOp, type SheetSelection, type SheetsCommandService, type SheetsLocalEvent, type SheetsLocalGroup, type SheetsNotShared, type SheetsOtAdapter, type SheetsOtAdapterHooks, type SheetsOtNotice, type SheetsOtPort, type SheetsOtRoom, type SheetsWorkbookLike, type SheetsWorksheetLike, type UniverSheetsOtPortOptions, WorkbookCollabSession, type WorkbookCollabSessionOptions, type WorkbookOtRoomHandle, type WorkbookOtRoomOptions, type WorkbookOtRoomsKnob, applyDocsOp, asLoadedDocsSnapshot, canonicalDocsSnapshot, canonicalDocsString, canonicalKeys, canonicalSheet, canonicalSheetString, composeDocsOps, createSheetsOtAdapter, decodeSheetOp, docsStateHash, documentOtFactory, documentUsesOrderedRoom, dropEmptyStyleRetains, encodeSheetOp, invertDocsOp, isCellEditorScratch, isNoopDocsOp, moveSelectionsThrough, normalizeDocsOp, openDocsOtRoom, openSheetsOtRoom, rebaseSheetUndoStack, rebaseUndoStack, restoreDocumentSnapshot, sheetsStateHash, stampCovered, stampDeterministicIds, startWorkbookOtRoom, stripSenderView, takeCovered, transformDocsOp, transformSheetOp, transformTextX, undoStacksOf, univerSheetsOtPort, workbookUsesOrderedRoom };
+export { COLLAB_COVERED_KEY, type CollabBase, type CollabMutationInfo, type CollabProviderLike, type CommandServiceLike, DOCS_COLLAB_PROTO, DOCS_TRANSFORM_VERSION, DOC_LOCAL_KEYS, type DocsLocalMutation, type DocsLost, type DocsOp, type DocsOtNotice, type DocsOtPort, type DocsOtRoom, type DocsTransformResult, type DocumentOtFactoryOptions, type DocumentRestoreDeps, type DocumentRestoreResult, type OpenDocsOtRoomOptions, type OpenSheetsOtRoomOptions, type OtRoomsKnob, RICH_TEXT_EDITING, SENDER_VIEW_PARAMS, SHEETS_COLLAB_PROTO, SHEETS_EDIT_GROUP, type SheetOp, type SheetSelection, type SheetsCommandService, type SheetsLocalEvent, type SheetsLocalGroup, type SheetsNotShared, type SheetsOtAdapter, type SheetsOtAdapterHooks, type SheetsOtNotice, type SheetsOtPort, type SheetsOtRoom, type SheetsWorkbookLike, type SheetsWorksheetLike, type UniverSheetsOtPortOptions, WorkbookCollabSession, type WorkbookCollabSessionOptions, type WorkbookOtRoomHandle, type WorkbookOtRoomOptions, type WorkbookOtRoomsKnob, applyDocsOp, asLoadedDocsSnapshot, canonicalDocsSnapshot, canonicalDocsString, canonicalKeys, canonicalSheet, canonicalSheetString, composeDocsOps, createSheetsOtAdapter, decodeSheetOp, docsStateHash, documentOtFactory, documentUsesOrderedRoom, dropEmptyStyleRetains, encodeSheetOp, invertDocsOp, isCellEditorScratch, isNoopDocsOp, moveSelectionsThrough, normalizeDocsOp, offlineTextOfGroups, openDocsOtRoom, openSheetsOtRoom, rebaseSheetUndoStack, rebaseUndoStack, restoreDocumentSnapshot, sheetsStateHash, stampCovered, stampDeterministicIds, startWorkbookOtRoom, stripSenderView, takeCovered, transformDocsOp, transformSheetOp, transformTextX, undoStacksOf, univerSheetsOtPort, workbookUsesOrderedRoom };

package/dist/univer-collab.d.ts

@@ -1,6 +1,6 @@
 import * as Y from 'yjs';
 import { Awareness } from 'y-protocols/awareness';
-import { OpSessionNotice, OpSession, OpTransport, OpPresence, OpSessionIncident, OpSessionStatus, AwarenessState, CollabRpcClient, collabReplace, OpDocumentAdapter } from '@ai-matrx/data/realtime/collab';
+import { OpSessionNotice, OpSession, OpTransport, OpPresence, OpSessionIncident, OpSessionStatus, OpOfflineOptions, OpOfflineState, AwarenessState, CollabRpcClient, collabReplace, OpDocumentAdapter, CollabGroup } from '@ai-matrx/data/realtime/collab';
 import { IDocumentData } from '@univerjs/core';
 import { CommitReason } from '@ai-matrx/kit/working-copy';
 
@@ -362,6 +362,10 @@ interface OpenDocsOtRoomOptions {
     onNotice?: (n: DocsOtNotice) => void;
     onIncident?: (i: OpSessionIncident) => void;
     onStatus?: (s: OpSessionStatus) => void;
+    /** C10: unsent edits persist on this device under a lease (the host builds it: `browserOfflineOptions`). */
+    offline?: OpOfflineOptions | null;
+    /** C10: the chrome's offline state. */
+    onOffline?: (s: OpOfflineState) => void;
     /** Watch IME composition here (default: `document`). */
     compositionTarget?: Pick<Document, "addEventListener" | "removeEventListener"> | null;
 }
@@ -481,6 +485,8 @@ interface DocumentOtFactoryOptions {
     onNotice?: (n: DocsOtNotice) => void;
     onIncident?: (i: OpSessionIncident) => void;
     onStatus?: (s: OpSessionStatus) => void;
+    /** C10: the chrome's offline state (unsent edits are kept on this device, one tab per document and person owns them). */
+    onOffline?: (s: OpOfflineState) => void;
 }
 /** The `DocumentModel.startOtRoom` factory for one document. */
 declare function documentOtFactory(o: DocumentOtFactoryOptions): DocumentOtFactory;
@@ -599,6 +605,12 @@ interface SheetsOtPort {
         service: unknown;
         unitId: string;
     }>;
+    /**
+     * Run `fn` right before this seat takes an undo or redo (synchronously, before the command reads its stack). With
+     * it the room rebases the undo stack lazily: a remote op only queues, and an undo catches its stack up first.
+     * Without it every remote op rebases the whole stack at once.
+     */
+    beforeUndo?(fn: () => void): () => void;
     /** Ask for a save (the record's one coalesced save). */
     markDirty(): void;
 }
@@ -651,6 +663,8 @@ declare function rebaseSheetUndoStack(items: UndoItem[], remote: SheetOp, unitId
 interface SheetsOtAdapterHooks {
     /** Called once per applied remote op that rebased this seat's undo stacks (for tests and logs). */
     onUndoRebased?: (dropped: number) => void;
+    /** Called with the milliseconds of undo bookkeeping each remote op (and each catch-up) cost (tests, logs). */
+    onUndoWork?: (ms: number, kind: "remote" | "catch_up") => void;
     /**
      * The state hash of a snapshot (default `sheetsStateHash`, Web Crypto). A seeded test passes a synchronous one:
      * Web Crypto resolves on a worker thread, outside a virtual clock, so the same seed would not replay.
@@ -683,6 +697,10 @@ interface OpenSheetsOtRoomOptions {
     onNotice?: (n: SheetsOtNotice) => void;
     onIncident?: (i: OpSessionIncident) => void;
     onStatus?: (s: OpSessionStatus) => void;
+    /** C10: unsent edits persist on this device under a lease (the host builds it: `browserOfflineOptions`). */
+    offline?: OpOfflineOptions | null;
+    /** C10: the chrome's offline state. */
+    onOffline?: (s: OpOfflineState) => void;
 }
 interface SheetsOtRoom {
     session: OpSession<SheetOp>;
@@ -821,6 +839,15 @@ declare const canonicalSheetString: (snapshot: unknown) => string;
 /** SHA-256 (hex) of the canonical form. Web Crypto, so the browser and Node compute the same hash. */
 declare function sheetsStateHash(snapshot: unknown): Promise<string>;
 
+/**
+ * "Copy my offline text" (C10): the words a person typed while offline, pulled out of the wire groups of a buffer
+ * the room refused (changed protocol, document trashed). Format-light on purpose: Docs inserts carry their text in
+ * `body.dataStream`; Sheets writes carry cell values in `cellValue`. Anything else contributes nothing, and the
+ * caller says so when nothing could be read (the record stays on the device regardless).
+ */
+
+declare function offlineTextOfGroups(buffers: CollabGroup[][]): string;
+
 /** `collab.ot_rooms` (§12.2): which workbooks without a room open one. */
 type WorkbookOtRoomsKnob = "off" | "new" | "all";
 /** Whether this workbook opens on the ordered log: its room exists, or the knob opens one. */
@@ -836,6 +863,8 @@ interface WorkbookOtRoomOptions {
     onNotice?: (n: SheetsOtNotice) => void;
     onIncident?: (i: OpSessionIncident) => void;
     onStatus?: (s: OpSessionStatus) => void;
+    /** C10: the chrome's offline state (unsent edits are kept on this device, one tab per workbook and person owns them). */
+    onOffline?: (s: OpOfflineState) => void;
 }
 interface WorkbookOtRoomHandle {
     session: OpSession<SheetOp>;
@@ -857,4 +886,4 @@ declare function startWorkbookOtRoom(port: SheetsOtPort & {
     dispose?: () => void;
 }, o: WorkbookOtRoomOptions): Promise<WorkbookOtRoomHandle>;
 
-export { COLLAB_COVERED_KEY, type CollabBase, type CollabMutationInfo, type CollabProviderLike, type CommandServiceLike, DOCS_COLLAB_PROTO, DOCS_TRANSFORM_VERSION, DOC_LOCAL_KEYS, type DocsLocalMutation, type DocsLost, type DocsOp, type DocsOtNotice, type DocsOtPort, type DocsOtRoom, type DocsTransformResult, type DocumentOtFactoryOptions, type DocumentRestoreDeps, type DocumentRestoreResult, type OpenDocsOtRoomOptions, type OpenSheetsOtRoomOptions, type OtRoomsKnob, RICH_TEXT_EDITING, SENDER_VIEW_PARAMS, SHEETS_COLLAB_PROTO, SHEETS_EDIT_GROUP, type SheetOp, type SheetSelection, type SheetsCommandService, type SheetsLocalEvent, type SheetsLocalGroup, type SheetsNotShared, type SheetsOtAdapter, type SheetsOtAdapterHooks, type SheetsOtNotice, type SheetsOtPort, type SheetsOtRoom, type SheetsWorkbookLike, type SheetsWorksheetLike, type UniverSheetsOtPortOptions, WorkbookCollabSession, type WorkbookCollabSessionOptions, type WorkbookOtRoomHandle, type WorkbookOtRoomOptions, type WorkbookOtRoomsKnob, applyDocsOp, asLoadedDocsSnapshot, canonicalDocsSnapshot, canonicalDocsString, canonicalKeys, canonicalSheet, canonicalSheetString, composeDocsOps, createSheetsOtAdapter, decodeSheetOp, docsStateHash, documentOtFactory, documentUsesOrderedRoom, dropEmptyStyleRetains, encodeSheetOp, invertDocsOp, isCellEditorScratch, isNoopDocsOp, moveSelectionsThrough, normalizeDocsOp, openDocsOtRoom, openSheetsOtRoom, rebaseSheetUndoStack, rebaseUndoStack, restoreDocumentSnapshot, sheetsStateHash, stampCovered, stampDeterministicIds, startWorkbookOtRoom, stripSenderView, takeCovered, transformDocsOp, transformSheetOp, transformTextX, undoStacksOf, univerSheetsOtPort, workbookUsesOrderedRoom };
+export { COLLAB_COVERED_KEY, type CollabBase, type CollabMutationInfo, type CollabProviderLike, type CommandServiceLike, DOCS_COLLAB_PROTO, DOCS_TRANSFORM_VERSION, DOC_LOCAL_KEYS, type DocsLocalMutation, type DocsLost, type DocsOp, type DocsOtNotice, type DocsOtPort, type DocsOtRoom, type DocsTransformResult, type DocumentOtFactoryOptions, type DocumentRestoreDeps, type DocumentRestoreResult, type OpenDocsOtRoomOptions, type OpenSheetsOtRoomOptions, type OtRoomsKnob, RICH_TEXT_EDITING, SENDER_VIEW_PARAMS, SHEETS_COLLAB_PROTO, SHEETS_EDIT_GROUP, type SheetOp, type SheetSelection, type SheetsCommandService, type SheetsLocalEvent, type SheetsLocalGroup, type SheetsNotShared, type SheetsOtAdapter, type SheetsOtAdapterHooks, type SheetsOtNotice, type SheetsOtPort, type SheetsOtRoom, type SheetsWorkbookLike, type SheetsWorksheetLike, type UniverSheetsOtPortOptions, WorkbookCollabSession, type WorkbookCollabSessionOptions, type WorkbookOtRoomHandle, type WorkbookOtRoomOptions, type WorkbookOtRoomsKnob, applyDocsOp, asLoadedDocsSnapshot, canonicalDocsSnapshot, canonicalDocsString, canonicalKeys, canonicalSheet, canonicalSheetString, composeDocsOps, createSheetsOtAdapter, decodeSheetOp, docsStateHash, documentOtFactory, documentUsesOrderedRoom, dropEmptyStyleRetains, encodeSheetOp, invertDocsOp, isCellEditorScratch, isNoopDocsOp, moveSelectionsThrough, normalizeDocsOp, offlineTextOfGroups, openDocsOtRoom, openSheetsOtRoom, rebaseSheetUndoStack, rebaseUndoStack, restoreDocumentSnapshot, sheetsStateHash, stampCovered, stampDeterministicIds, startWorkbookOtRoom, stripSenderView, takeCovered, transformDocsOp, transformSheetOp, transformTextX, undoStacksOf, univerSheetsOtPort, workbookUsesOrderedRoom };

package/dist/univer-collab.js

@@ -1290,7 +1290,9 @@ function openDocsOtRoom(o) {
     ...o.presence ? { presence: o.presence } : {},
     onNotice: (n) => notice(n),
     ...o.onIncident ? { onIncident: o.onIncident } : {},
-    ...o.onStatus ? { onStatus: o.onStatus } : {}
+    ...o.onStatus ? { onStatus: o.onStatus } : {},
+    ...o.offline ? { offline: o.offline } : {},
+    ...o.onOffline ? { onOffline: o.onOffline } : {}
   });
   const isSaver = () => {
     if (!o.presence) return true;
@@ -1328,6 +1330,7 @@ import * as Y2 from "yjs";
 import { Awareness as Awareness2 } from "y-protocols/awareness";
 import {
   awarenessOpPresence,
+  browserOfflineOptions,
   claimCollaboratorColor as claimCollaboratorColor2,
   collabReplace,
   collabRoomExists,
@@ -1565,7 +1568,9 @@ function documentOtFactory(o) {
       replace: ({ snapshot, stateHash, clientId }) => collabReplace(client, { roomId: o.documentId, snapshot, stateHash, origin: "restore", clientId }),
       ...o.onNotice ? { onNotice: o.onNotice } : {},
       ...o.onIncident ? { onIncident: o.onIncident } : {},
-      ...o.onStatus ? { onStatus: o.onStatus } : {}
+      ...o.onStatus ? { onStatus: o.onStatus } : {},
+      offline: browserOfflineOptions(`${o.documentId}:${o.uid}`),
+      ...o.onOffline ? { onOffline: o.onOffline } : {}
     });
     await room.session.ready;
     let lastKey = "";
@@ -3495,17 +3500,65 @@ function rebaseSheetUndoStack(items, remote, unitId) {
 function createSheetsOtAdapter(port, hooks = {}) {
   let queue = [];
   let draining = false;
+  const lazy = typeof port.beforeUndo === "function";
+  let pending = [];
+  let pendingBase = 0;
+  let applied = 0;
+  let currentAt = /* @__PURE__ */ new WeakMap();
+  const PENDING_CAP = 2e3;
+  const now = () => typeof performance !== "undefined" ? performance.now() : Date.now();
+  const stacksOfTargets = () => port.undoTargets().flatMap((t) => {
+    const stacks = undoStacksOf2(t.service);
+    return stacks ? [stacks.undo, stacks.redo].map((map) => ({ items: map.get(t.unitId), unitId: t.unitId, isUndo: map === stacks.undo })) : [];
+  });
+  const markNew = (items) => {
+    for (let i = items.length - 1; i >= 0 && !currentAt.has(items[i]); i--) currentAt.set(items[i], applied);
+  };
+  const catchUpItem = (item, unitId) => {
+    const from = currentAt.get(item) ?? applied;
+    for (let k = from - pendingBase; k < pending.length; k++) if (rebaseSheetUndoStack([item], pending[k], unitId) > 0) return false;
+    currentAt.set(item, applied);
+    return true;
+  };
+  const catchUp = () => {
+    if (!pending.length) return;
+    const t0 = now();
+    let dropped = 0;
+    for (const { items, unitId } of stacksOfTargets()) {
+      if (!items?.length) continue;
+      for (let i = items.length - 1; i >= 0; i--)
+        if (!catchUpItem(items[i], unitId)) {
+          items.splice(i, 1);
+          dropped++;
+        }
+    }
+    pending = [];
+    pendingBase = applied;
+    hooks.onUndoWork?.(now() - t0, "catch_up");
+    if (dropped) hooks.onUndoRebased?.(dropped);
+  };
+  if (lazy) port.beforeUndo(catchUp);
   const applyNow = (op) => {
     for (const m of op) port.applyRemote(m);
+    const t0 = now();
     let dropped = 0;
-    for (const t of port.undoTargets()) {
-      const stacks = undoStacksOf2(t.service);
-      if (!stacks) continue;
-      for (const map of [stacks.undo, stacks.redo]) {
-        const items = map.get(t.unitId);
-        if (items?.length) dropped += rebaseSheetUndoStack(items, op, t.unitId);
+    if (!lazy) {
+      for (const { items, unitId } of stacksOfTargets()) if (items?.length) dropped += rebaseSheetUndoStack(items, op, unitId);
+    } else if (!isNoopSheetOp(op)) {
+      for (const { items, unitId, isUndo } of stacksOfTargets()) {
+        if (!items?.length) continue;
+        markNew(items);
+        const top = items[items.length - 1];
+        if (isUndo && (!catchUpItem(top, unitId) || rebaseSheetUndoStack([top], op, unitId) > 0)) {
+          items.pop();
+          dropped++;
+        } else if (isUndo) currentAt.set(top, applied + 1);
       }
+      pending.push(op);
+      applied++;
+      if (pending.length > PENDING_CAP) catchUp();
     }
+    hooks.onUndoWork?.(now() - t0, "remote");
     hooks.onUndoRebased?.(dropped);
     port.markDirty();
   };
@@ -3543,6 +3596,9 @@ function createSheetsOtAdapter(port, hooks = {}) {
         stacks?.undo.delete(t.unitId);
         stacks?.redo.delete(t.unitId);
       }
+      pending = [];
+      pendingBase = applied;
+      currentAt = /* @__PURE__ */ new WeakMap();
     },
     snapshot: () => port.snapshot(),
     async hash() {
@@ -3629,7 +3685,9 @@ function openSheetsOtRoom(o) {
     ...o.presence ? { presence: o.presence } : {},
     onNotice: (n) => notice(n),
     ...o.onIncident ? { onIncident: o.onIncident } : {},
-    ...o.onStatus ? { onStatus: o.onStatus } : {}
+    ...o.onStatus ? { onStatus: o.onStatus } : {},
+    ...o.offline ? { offline: o.offline } : {},
+    ...o.onOffline ? { onOffline: o.onOffline } : {}
   });
   const isSaver = () => {
     if (!o.presence) return true;
@@ -3660,6 +3718,65 @@ function openSheetsOtRoom(o) {
   };
 }
 
+// src/univer/collab/sheets-ot/plugin-teardown.ts
+var perSheetList = (data) => Object.entries(data).flatMap(([sheet, list]) => Array.isArray(list) ? [[sheet, list.filter((x) => !!x && typeof x === "object")]] : []);
+var PLUGIN_TEARDOWNS = [
+  {
+    resource: "SHEET_CONDITIONAL_FORMATTING_PLUGIN",
+    removals: (unitId, data) => perSheetList(data).flatMap(
+      ([subUnitId, rules]) => rules.filter((r) => typeof r.cfId === "string").map((r) => ({ id: "sheet.mutation.delete-conditional-rule", params: { unitId, subUnitId, cfId: r.cfId } }))
+    )
+  },
+  {
+    resource: "SHEET_DATA_VALIDATION_PLUGIN",
+    removals: (unitId, data) => perSheetList(data).flatMap(([subUnitId, rules]) => {
+      const ids = rules.map((r) => r.uid).filter((u) => typeof u === "string");
+      return ids.length ? [{ id: "data-validation.mutation.removeRule", params: { unitId, subUnitId, ruleId: ids, source: "command" } }] : [];
+    })
+  },
+  {
+    resource: "SHEET_NOTE_PLUGIN",
+    removals: (unitId, data) => Object.entries(data).flatMap(
+      ([sheetId, rows]) => Object.entries(rows ?? {}).flatMap(
+        ([row, cols]) => Object.entries(cols ?? {}).map(([col, note]) => ({
+          id: "sheet.mutation.remove-note",
+          params: { unitId, sheetId, row: Number(row), col: Number(col), ...note && typeof note.id === "string" ? { noteId: note.id } : {}, silent: true }
+        }))
+      )
+    )
+  }
+];
+function resourcesOf(saved) {
+  const out = /* @__PURE__ */ new Map();
+  const list = saved?.resources;
+  for (const r of Array.isArray(list) ? list : []) {
+    if (!r?.name) continue;
+    try {
+      const data = typeof r.data === "string" ? r.data ? JSON.parse(r.data) : null : r.data;
+      if (data && typeof data === "object") out.set(r.name, data);
+    } catch {
+    }
+  }
+  return out;
+}
+function releaseUnitPluginState(cs, unitId, saved) {
+  const resources = resourcesOf(saved);
+  let ran = 0;
+  for (const t of PLUGIN_TEARDOWNS) {
+    const data = resources.get(t.resource);
+    if (!data) continue;
+    for (const m of t.removals(unitId, data)) {
+      try {
+        cs.syncExecuteCommand(m.id, m.params, { onlyLocal: true });
+        ran++;
+      } catch (err) {
+        console.warn(`[sheets-ot] could not release ${t.resource} state before a reload`, err);
+      }
+    }
+  }
+  return ran;
+}
+
 // src/univer/collab/sheets-ot/univer-port.ts
 var COMMAND = 0;
 var MUTATION = 2;
@@ -3669,6 +3786,8 @@ var REMOVE_MERGE = "sheet.mutation.remove-worksheet-merge";
 var SHEET_NAME = "sheet.mutation.set-worksheet-name";
 var INSERT_SHEET = "sheet.mutation.insert-sheet";
 var RESHAPE = /* @__PURE__ */ new Set(["sheet.mutation.set-worksheet-row-count", "sheet.mutation.set-worksheet-column-count", "sheet.mutation.remove-sheet", INSERT_SHEET]);
+var UNDO = "univer.command.undo";
+var REDO = "univer.command.redo";
 var DEPTH_GUARD = /* @__PURE__ */ Symbol.for("ai-matrx.office.sheets.command-depth-guard");
 var json = (v) => v === void 0 ? v : JSON.parse(JSON.stringify(v));
 var flagged = (options) => {
@@ -3678,6 +3797,7 @@ var flagged = (options) => {
 function univerSheetsOtPort(o) {
   const cs = o.commandService;
   const listeners = /* @__PURE__ */ new Set();
+  const undoWatchers = /* @__PURE__ */ new Set();
   const idle = [];
   const pre = /* @__PURE__ */ new WeakMap();
   const tracker = { stack: [], settle: () => settle() };
@@ -3734,6 +3854,7 @@ function univerSheetsOtPort(o) {
     if (tracker.stack.length === 0 && !group) for (const fn of idle.splice(0)) fn();
   }
   const before = cs.beforeCommandExecuted((info, options) => {
+    if (info.id === UNDO || info.id === REDO) for (const fn of [...undoWatchers]) fn();
     if (info.type === COMMAND) {
       if (tracker.stack.length === 0 && !group) group = openGroup(info.id);
       tracker.stack.push(info.id);
@@ -3979,6 +4100,8 @@ function univerSheetsOtPort(o) {
       group = null;
       applying = true;
       try {
+        const u = unitId();
+        if (u) releaseUnitPluginState(cs, u, o.saveUnit?.(u) ?? null);
         o.load(snapshot);
       } finally {
         applying = false;
@@ -3989,8 +4112,13 @@ function univerSheetsOtPort(o) {
       const service = o.undoRedo?.();
       return u && service ? [{ service, unitId: u }] : [];
     },
+    beforeUndo(fn) {
+      undoWatchers.add(fn);
+      return () => void undoWatchers.delete(fn);
+    },
     markDirty: () => o.markDirty(),
     dispose() {
+      undoWatchers.clear();
       before.dispose();
       after.dispose();
       collab.dispose();
@@ -4068,11 +4196,59 @@ function moveSelectionsThrough(selections, m, maxRows, maxCols) {
   return selections.map((s) => ({ ...s, range: box(s.range, s.range.rangeType), ...s.primary ? { primary: box(s.primary) } : {} }));
 }
 
+// src/univer/collab/offline-text.ts
+var colName3 = (c) => {
+  let n = c;
+  let s = "";
+  do {
+    s = String.fromCharCode(65 + n % 26) + s;
+    n = Math.floor(n / 26) - 1;
+  } while (n >= 0);
+  return s;
+};
+function collectDocText(v, out) {
+  if (Array.isArray(v)) {
+    for (const x of v) collectDocText(x, out);
+    return;
+  }
+  if (!v || typeof v !== "object") return;
+  const o = v;
+  if (typeof o.dataStream === "string" && o.dataStream.length) out.push(o.dataStream);
+  for (const k of Object.keys(o)) if (k !== "dataStream") collectDocText(o[k], out);
+}
+function collectCells(cellValue, out) {
+  if (!cellValue || typeof cellValue !== "object") return;
+  for (const [r, cols] of Object.entries(cellValue)) {
+    if (!cols || typeof cols !== "object") continue;
+    for (const [c, cell] of Object.entries(cols)) {
+      const x = cell;
+      const val = x?.f ?? x?.v;
+      if (val !== void 0 && val !== null && val !== "") out.push(`${colName3(Number(c))}${Number(r) + 1}: ${String(val)}`);
+    }
+  }
+}
+function offlineTextOfGroups(buffers) {
+  const docs = [];
+  const cells = [];
+  for (const groups of buffers) {
+    for (const g of groups) {
+      for (const m of g.mutations) {
+        const p = m.params;
+        if (p && "cellValue" in p) collectCells(p.cellValue, cells);
+        else collectDocText(p, docs);
+      }
+    }
+  }
+  const text = docs.join("").replace(/\r/g, "\n").replace(/\u0000/g, "");
+  return [text, cells.join("\n")].filter((s) => s.length > 0).join("\n");
+}
+
 // src/sheets/workbook-ot-room.ts
 import * as Y3 from "yjs";
 import { Awareness as Awareness3 } from "y-protocols/awareness";
 import {
   awarenessOpPresence as awarenessOpPresence2,
+  browserOfflineOptions as browserOfflineOptions2,
   claimCollaboratorColor as claimCollaboratorColor3,
   collabReplace as collabReplace3,
   collabRoomExists as collabRoomExists3,
@@ -4177,6 +4353,7 @@ async function startWorkbookOtRoom(port, o) {
   await provider.connect();
   publishAwareness();
   const client = db4();
+  const offline = browserOfflineOptions2(`${o.workbookId}:${o.uid}`);
   const room = openSheetsOtRoom({
     port,
     clientId: o.clientId,
@@ -4197,7 +4374,9 @@ async function startWorkbookOtRoom(port, o) {
     replace: ({ snapshot, stateHash, clientId }) => collabReplace3(client, { roomId: o.workbookId, snapshot, stateHash, origin: "restore", clientId }),
     ...o.onNotice ? { onNotice: o.onNotice } : {},
     ...o.onIncident ? { onIncident: o.onIncident } : {},
-    ...o.onStatus ? { onStatus: o.onStatus } : {}
+    ...o.onStatus ? { onStatus: o.onStatus } : {},
+    ...offline ? { offline } : {},
+    ...o.onOffline ? { onOffline: o.onOffline } : {}
   });
   await room.session.ready;
   return {
@@ -4250,6 +4429,7 @@ export {
   isNoopDocsOp,
   moveSelectionsThrough,
   normalizeDocsOp,
+  offlineTextOfGroups,
   openDocsOtRoom,
   openSheetsOtRoom,
   rebaseSheetUndoStack,