wordinweb 0.2.2 → 0.2.4

package/dist/collab.js

@@ -42,6 +42,7 @@ import {
   moveTableTo,
   parseXml,
   recordedProvenance,
+  rejectAllRevisions,
   rejectRevision,
   removeDrawingRun,
   removeLink,
@@ -78,7 +79,7 @@ import {
   setSmartArtTextFormat,
   toggleCheckbox,
   validatePastedOoxml
-} from "./chunk-JGXXZTQE.js";
+} from "./chunk-QH2L3NPL.js";
 import "./chunk-7D4SUZUM.js";
 
 // src/collab.tsx
@@ -185,6 +186,7 @@ function runEditsOf(intent) {
     case "acceptRevision":
     case "rejectRevision":
     case "acceptAllRevisions":
+    case "rejectAllRevisions":
       return [];
   }
 }
@@ -327,6 +329,7 @@ function transformIntent(intent, ahead) {
     case "acceptRevision":
     case "rejectRevision":
     case "acceptAllRevisions":
+    case "rejectAllRevisions":
       return { ...intent, base: newBase };
     case "deleteText": {
       const s = transformPosition({ blockId: intent.blockId, runId: intent.runId, offset: intent.start }, ahead);
@@ -414,7 +417,15 @@ function applyIntentInner(doc, ids, intent, out) {
     case "splitParagraph": {
       const caret = resolveCaret(ids, runOf, intent.at);
       if (!caret) return false;
-      const res = applySplitParagraph(doc, caret, ctx);
+      const splitCtx = intent.suggest ? {
+        suggesting: true,
+        revMeta: () => ({
+          author: intent.suggest.author,
+          date: intent.suggest.date,
+          nextId: () => doc.nextRevisionId()
+        })
+      } : ctx;
+      const res = applySplitParagraph(doc, caret, splitCtx);
       if (!res) return false;
       ids.assign(res.after, intent.newBlockId);
       const newRun = res.after.children.find((c) => localRun(c));
@@ -908,6 +919,8 @@ function applyIntentInner(doc, ids, intent, out) {
     }
     case "acceptAllRevisions":
       return acceptAllRevisions(doc) > 0;
+    case "rejectAllRevisions":
+      return rejectAllRevisions(doc) > 0;
     case "insertTable": {
       const runEl = ids.elOf(intent.runId);
       if (!runEl) return false;
@@ -1074,7 +1087,7 @@ function tableOfParagraph(doc, ids, cellParagraphId) {
   return null;
 }
 function firstDrawingIn(el) {
-  if (localName(el.name) === "drawing") return el;
+  if (["drawing", "shape", "rect"].includes(localName(el.name))) return el;
   for (const c of el.children) {
     const found = firstDrawingIn(c);
     if (found) return found;
@@ -1511,7 +1524,8 @@ var InMemoryBundleStore = class {
       ...parseBundleKey(b.docId),
       key: b.docId,
       savedAt: b.savedAt,
-      byteLength: b.confirmedBytes.byteLength
+      byteLength: b.confirmedBytes.byteLength,
+      title: b.title
     }));
   }
 };
@@ -1588,6 +1602,7 @@ var BundlePersister = class {
     if (!bundle) return;
     bundle.savedAt = this.lastWrite;
     const prior = await this.store.get(this.docId);
+    bundle.title = prior?.title;
     const chain = [...prior?.lineage ?? []];
     const digest = await crypto.subtle.digest("SHA-256", bundle.confirmedBytes);
     let hash = "";
@@ -1600,6 +1615,7 @@ var BundlePersister = class {
     if (off && off.tail.length) {
       bundle.offlineTail = off.tail;
       bundle.offlineTailEpoch = off.epoch;
+      bundle.offlineBaseSeq = off.baseSeq ?? bundle.confirmedSeq;
     }
     await this.store.put(bundle);
   }
@@ -1619,6 +1635,14 @@ function toSuggestions(tail, author, date) {
         ranges: [{ blockId: intent.blockId, runId: intent.runId, start: intent.start, end: intent.end }],
         suggest: { author, date }
       });
+    } else if (intent.kind === "splitParagraph") {
+      suggestions.push({
+        kind: "splitParagraph",
+        at: intent.at,
+        newBlockId: intent.newBlockId,
+        newRunId: intent.newRunId,
+        suggest: { author, date }
+      });
     } else {
       dropped.push(intent);
     }
@@ -1632,7 +1656,7 @@ function arrivalMode(tailLength, diverged, opts = {}) {
 }
 
 // ../collab/src/protocol.ts
-var ENGINE_VERSION = "e7";
+var ENGINE_VERSION = "e10";
 var PRESENCE_MAX_RANGES = 64;
 function sanitizePresencePosition(pos) {
   if (!pos || !pos.ranges) return pos;
@@ -1648,7 +1672,20 @@ function sanitizePresencePosition(pos) {
   if (clean.length === pos.ranges.length) return pos;
   return clean.length > 0 ? { ...pos, ranges: clean } : { ...pos, ranges: void 0 };
 }
-var PROTOCOL_VERSION = 3;
+var PROTOCOL_VERSION = 5;
+
+// ../collab/src/id-allocator.ts
+var CarriedIdAllocator = class {
+  constructor(clientId) {
+    this.counter = 0;
+    let hash = 0;
+    for (let i = 0; i < clientId.length; i++) hash = hash * 31 + clientId.charCodeAt(i) >>> 0;
+    this.base = 1e9 + hash % 1e5 * 1e7;
+  }
+  next() {
+    return this.base + this.counter++;
+  }
+};
 
 // ../collab/src/media.ts
 function mediaAddressesOf(doc) {
@@ -2081,11 +2118,6 @@ var _CollabConnection = class _CollabConnection {
      * the renderer re-mounts on this, but updates in place otherwise (no flash
      * for the common non-conflicting edits). */
     this.docEpoch = 0;
-    /** Per-client id allocator for carried node ids (split/format-range/insert):
-     * a client-specific base block keeps concurrently-allocated ids disjoint
-     * across clients so they never collide. */
-    this.idCounter = 0;
-    this.idBase = -1;
     /** The epoch id of the session this connection joined (from the welcome).
      * The resume layer compares it against the bundle's stored genesisId:
      * same ⇒ seamless rejoin; different ⇒ someone re-seeded while away
@@ -2137,6 +2169,7 @@ var _CollabConnection = class _CollabConnection {
     this.droppedPreReady = 0;
     this.rlRedriveTimer = null;
     this.rlRedriveBackoffMs = 0;
+    this.idAllocator = new CarriedIdAllocator(clientId);
     this.transport.onMessage((msg) => this.onServer(msg));
     if (mediaOpts) {
       this.media = new MediaClient(mediaOpts, () => this.replica?.doc ?? null, {
@@ -2163,13 +2196,11 @@ var _CollabConnection = class _CollabConnection {
   }
   /** Allocate `n` fresh carried node ids in this client's disjoint block. */
   allocIds(n) {
-    if (this.idBase < 0) {
-      let h = 0;
-      for (let i = 0; i < this.clientId.length; i++) h = h * 31 + this.clientId.charCodeAt(i) >>> 0;
-      this.idBase = 1e9 + h % 1e5 * 1e7;
-    }
     const out = [];
-    for (let i = 0; i < n; i++) out.push(this.idBase + this.idCounter++);
+    while (out.length < n) {
+      const id = this.idAllocator.next();
+      if (!this.replica?.doc.stableIds?.elOf(id)) out.push(id);
+    }
     return out;
   }
   /**
@@ -2627,6 +2658,10 @@ function validateIntent(intent, limits = DEFAULT_INTENT_LIMITS) {
     case "splitParagraph":
       if (!nonNegInt(intent.at.offset)) return "splitParagraph: bad offset";
       if (!nonNegInt(intent.newBlockId) || !nonNegInt(intent.newRunId)) return "splitParagraph: bad ids";
+      if (intent.suggest !== void 0) {
+        if (typeof intent.suggest.author !== "string" || intent.suggest.author.length > 100) return "splitParagraph: bad author";
+        if (typeof intent.suggest.date !== "string" || intent.suggest.date.length > 40) return "splitParagraph: bad date";
+      }
       return null;
     case "formatRange":
       if (!nonNegInt(intent.start) || !nonNegInt(intent.end) || intent.end <= intent.start) return "formatRange: bad range";
@@ -2841,6 +2876,7 @@ function validateIntent(intent, limits = DEFAULT_INTENT_LIMITS) {
       if (!nonNegInt(intent.index) || intent.index > 1e5) return `${intent.kind}: bad index`;
       return null;
     case "acceptAllRevisions":
+    case "rejectAllRevisions":
       return null;
     case "insertTable": {
       const okDim = (v) => typeof v === "number" && Number.isInteger(v) && v >= 1 && v <= 50;
@@ -3216,8 +3252,6 @@ var _EncryptedCollabConnection = class _EncryptedCollabConnection {
     /** Envelope processing is async (WebCrypto) but MUST be strictly ordered
      * (seq order is the convergence contract) — a serial promise chain. */
     this.queue = Promise.resolve();
-    this.idCounter = 0;
-    this.idBase = -1;
     /** Own doc hashes at gossip points (seq → hash), a small ring — peers'
      * gossip for a seq we also hashed is comparable; anything else is skipped
      * (clients hash at the SAME seq cadence, so overlap is the common case). */
@@ -3306,6 +3340,7 @@ var _EncryptedCollabConnection = class _EncryptedCollabConnection {
     this.presenceInQueue = Promise.resolve();
     this.presenceLatest = null;
     this.presenceFlushing = false;
+    this.idAllocator = new CarriedIdAllocator(clientId);
     this.transport.onMessage((msg) => this.onServer(msg));
     if (mediaOpts) {
       this.media = new MediaClient(
@@ -3457,13 +3492,11 @@ var _EncryptedCollabConnection = class _EncryptedCollabConnection {
   }
   /** Same disjoint carried-id allocation as the plaintext connection. */
   allocIds(n) {
-    if (this.idBase < 0) {
-      let h = 0;
-      for (let i = 0; i < this.clientId.length; i++) h = h * 31 + this.clientId.charCodeAt(i) >>> 0;
-      this.idBase = 1e9 + h % 1e5 * 1e7;
-    }
     const out = [];
-    for (let i = 0; i < n; i++) out.push(this.idBase + this.idCounter++);
+    while (out.length < n) {
+      const id = this.idAllocator.next();
+      if (!this.replica?.doc.stableIds?.elOf(id)) out.push(id);
+    }
     return out;
   }
   /** Submit a local edit (optimistic canonical apply, like the plaintext
@@ -4151,7 +4184,12 @@ var IndexedDbBundleStore = class {
     await new Promise((resolve, reject) => {
       const t = db.transaction(["bundles", "meta"], "readwrite");
       t.objectStore("bundles").put(bundle);
-      const meta = { docId: bundle.docId, savedAt: bundle.savedAt, byteLength: bundle.confirmedBytes.byteLength };
+      const meta = {
+        docId: bundle.docId,
+        savedAt: bundle.savedAt,
+        byteLength: bundle.confirmedBytes.byteLength,
+        title: bundle.title
+      };
       t.objectStore("meta").put(meta);
       t.oncomplete = () => resolve();
       t.onerror = () => reject(t.error);
@@ -4181,7 +4219,12 @@ var IndexedDbBundleStore = class {
         budget--;
         const bundle = await this.get(key);
         if (!bundle) continue;
-        meta = { docId: key, savedAt: bundle.savedAt, byteLength: bundle.confirmedBytes.byteLength };
+        meta = {
+          docId: key,
+          savedAt: bundle.savedAt,
+          byteLength: bundle.confirmedBytes.byteLength,
+          title: bundle.title
+        };
         await this.tx("meta", "readwrite", (t) => t.objectStore("meta").put(meta));
       }
       out.push({
@@ -4190,7 +4233,8 @@ var IndexedDbBundleStore = class {
         // Unmeasured legacy record: 0 means UNKNOWN. A byte-budget caller must
         // not treat it as free, and must not delete it for being large either.
         savedAt: meta?.savedAt ?? 0,
-        byteLength: meta?.byteLength ?? 0
+        byteLength: meta?.byteLength ?? 0,
+        title: meta?.title
       });
     }
     return out;
@@ -4198,6 +4242,7 @@ var IndexedDbBundleStore = class {
 };
 
 // src/collab.tsx
+var EMPTY_PRESENCE = {};
 var TIMED_OUT = /* @__PURE__ */ Symbol("store-timeout");
 var STORE_DEADLINE_MS = 2e3;
 function withDeadline(p, ms, fallback) {
@@ -4229,13 +4274,22 @@ function withDeadline(p, ms, fallback) {
 }
 function useCollab(opts) {
   const { url, docId, clientId, token, createSocket, store, profile, takeover, docKey, shareCode, ownerToken, httpBase } = opts;
+  const startOffline = Boolean(opts.startOffline);
   const connRef = useRef(null);
+  const carriedIdAllocator = useMemo(() => new CarriedIdAllocator(clientId), [clientId]);
   const [doc, setDoc] = useState(null);
+  const docRef = useRef(null);
+  const offlineActiveRef = useRef(false);
+  const offlineCappedRef = useRef(false);
+  const captureOfflineRef = useRef(() => {
+  });
   const [version, setVersion] = useState(0);
   const [renderVersion, setRenderVersion] = useState(0);
   const lastDocVersionRef = useRef(0);
   const renderScopeRef = useRef(null);
   const [docEpoch, setDocEpoch] = useState(0);
+  const publishedDocRef = useRef(null);
+  const connectionDocEpochRef = useRef(0);
   const [ready, setReady] = useState(false);
   const [presence, setPresence] = useState({});
   const [refused, setRefused] = useState(null);
@@ -4264,11 +4318,18 @@ function useCollab(opts) {
   const persisterRef = useRef(null);
   const tailConnRef = useRef(null);
   const offlinePersistTimerRef = useRef(null);
-  const [connection, setConnection] = useState("live");
+  const [connection, setConnection] = useState(startOffline ? "lost" : "live");
+  const connectionRef = useRef(startOffline ? "lost" : "live");
   const [reconnectNonce, setReconnectNonce] = useState(0);
   const backoffRef = useRef(0);
   const attemptRef = useRef(0);
   const retryTimerRef = useRef(null);
+  const activeSocketRef = useRef(null);
+  const manuallyOfflineRef = useRef(startOffline);
+  const disconnectSeqRef = useRef(null);
+  const manualDraftBankedRef = useRef(false);
+  const manualDraftSnapshotRef = useRef(null);
+  const offlineBaseBundleRef = useRef(null);
   const flushDoneRef = useRef(Promise.resolve());
   const maxRetries = opts.liveness?.maxRetries ?? 6;
   const livenessRef = useRef(opts.liveness);
@@ -4278,9 +4339,41 @@ function useCollab(opts) {
     retryTimerRef.current = null;
     backoffRef.current = 0;
     attemptRef.current = 0;
+    if (manuallyOfflineRef.current) {
+      const currentDoc = docRef.current;
+      const currentBundle = connRef.current?.exportBundle(docId) ?? offlineBaseBundleRef.current;
+      const ids = currentDoc?.stableIds;
+      manualDraftSnapshotRef.current = currentDoc && currentBundle && ids ? {
+        ...currentBundle,
+        confirmedBytes: currentDoc.save(),
+        confirmedSidecar: ids.exportSidecar(currentDoc.editableRoots()),
+        pending: [],
+        offlineTail: void 0,
+        offlineTailEpoch: void 0,
+        offlineBaseSeq: void 0,
+        savedAt: Date.now()
+      } : null;
+    }
+    manuallyOfflineRef.current = false;
+    connectionRef.current = "reconnecting";
     setConnection("reconnecting");
     setReconnectNonce((n) => n + 1);
   };
+  const disconnect = () => {
+    if (manuallyOfflineRef.current) return;
+    disconnectSeqRef.current = connRef.current?.exportBundle(docId)?.confirmedSeq ?? null;
+    manualDraftBankedRef.current = false;
+    manualDraftSnapshotRef.current = null;
+    manuallyOfflineRef.current = true;
+    if (retryTimerRef.current !== null) clearTimeout(retryTimerRef.current);
+    retryTimerRef.current = null;
+    connectionRef.current = "lost";
+    setConnection("lost");
+    try {
+      activeSocketRef.current?.close();
+    } catch {
+    }
+  };
   const persistOfflineTail = () => {
     if (!store) return;
     flushDoneRef.current = flushDoneRef.current.then(async () => {
@@ -4291,9 +4384,11 @@ function useCollab(opts) {
       if (tail.length) {
         next.offlineTail = [...tail];
         next.offlineTailEpoch = offlineEpochRef.current ?? void 0;
+        next.offlineBaseSeq = disconnectSeqRef.current ?? prev.confirmedSeq;
       } else {
         delete next.offlineTail;
         delete next.offlineTailEpoch;
+        delete next.offlineBaseSeq;
       }
       await store.put(next);
     }).catch((err) => {
@@ -4325,7 +4420,13 @@ function useCollab(opts) {
       setRenderVersion((v) => v + 1);
     }
     const tail = offlineTailRef.current ?? [];
-    tail.push(intent);
+    const next = intent;
+    const last = tail[tail.length - 1];
+    if (preApplied && last?.kind === "insertText" && next.kind === "insertText" && !last.suggest && !next.suggest && last.at.blockId === next.at.blockId && last.at.runId === next.at.runId && next.at.offset === last.at.offset + last.text.length) {
+      tail[tail.length - 1] = { ...last, text: last.text + next.text };
+    } else {
+      tail.push(next);
+    }
     offlineTailRef.current = tail;
     offlineEpochRef.current ?? (offlineEpochRef.current = lastGenesisRef.current);
     setOfflineHeld(tail.length);
@@ -4333,11 +4434,12 @@ function useCollab(opts) {
     if (connRef.current?.ready) persisterRef.current?.notify();
     else scheduleOfflinePersist();
   };
+  captureOfflineRef.current = captureOffline;
   const runTailReplay = (conn, kind) => {
     const author = profile?.name || clientId;
     const date = (/* @__PURE__ */ new Date()).toISOString();
     const step = () => {
-      if (connRef.current !== conn || !conn.ready) return;
+      if (connRef.current !== conn || !conn.ready || manuallyOfflineRef.current) return;
       if (conn.pendingCount > 0) {
         setTimeout(step, 25);
         return;
@@ -4348,6 +4450,9 @@ function useCollab(opts) {
         offlineEpochRef.current = null;
         setOfflineHeld(0);
         setArrival(null);
+        disconnectSeqRef.current = null;
+        manualDraftBankedRef.current = false;
+        manualDraftSnapshotRef.current = null;
         return;
       }
       const next = tail[0];
@@ -4366,7 +4471,53 @@ function useCollab(opts) {
   };
   useEffect(() => {
     clearDeadlines();
+    if (startOffline && reconnectNonce === 0) {
+      let disposed2 = false;
+      if (!store) {
+        setRefused("no-session");
+        return;
+      }
+      void store.get(docId).then((bundle) => {
+        if (disposed2) return;
+        if (!bundle) {
+          setRefused("no-session");
+          return;
+        }
+        const replica = new ClientReplica(bundle.confirmedBytes, bundle.confirmedSidecar);
+        for (const intent of bundle.pending) replica.submitLocal(intent);
+        const offlineTail = bundle.offlineTail ?? [];
+        let scope = null;
+        for (const intent of offlineTail) {
+          const result = applyIntentScoped(replica.doc, replica.ids, intent);
+          if (!result.applied) continue;
+          resyncScope(replica.doc, replica.ids, result);
+          scope = scope ? unionScopes(scope, result) : result;
+        }
+        offlineBaseBundleRef.current = bundle;
+        offlineTailRef.current = offlineTail.length ? [...offlineTail] : void 0;
+        offlineEpochRef.current = bundle.offlineTailEpoch ?? bundle.genesisId;
+        disconnectSeqRef.current = bundle.offlineBaseSeq ?? bundle.confirmedSeq;
+        lastGenesisRef.current = bundle.genesisId;
+        docRef.current = replica.doc;
+        publishedDocRef.current = replica.doc;
+        renderScopeRef.current = scope ?? { kind: "doc" };
+        setDoc(replica.doc);
+        setOfflineHeld(offlineTail.length);
+        setReady(true);
+        setVersion((value) => value + 1);
+        setRenderVersion((value) => value + 1);
+        connectionRef.current = "lost";
+        setConnection("lost");
+      }).catch(() => {
+        if (!disposed2) setPersistErrors((count) => count + 1);
+      });
+      return () => {
+        disposed2 = true;
+        flushOfflinePersist();
+      };
+    }
     const socket = (createSocket ?? ((u) => new WebSocket(u)))(url);
+    activeSocketRef.current = socket;
     let disposed = false;
     let dropHandled = false;
     let monitor = null;
@@ -4374,16 +4525,23 @@ function useCollab(opts) {
       if (dropHandled || disposed) return;
       dropHandled = true;
       monitor?.stop();
+      if (manuallyOfflineRef.current) {
+        connectionRef.current = "lost";
+        setConnection("lost");
+        return;
+      }
       try {
         socket.close?.();
       } catch {
       }
       if (attemptRef.current >= maxRetries) {
+        connectionRef.current = "lost";
         setConnection("lost");
         return;
       }
       attemptRef.current += 1;
       backoffRef.current = Math.min(backoffRef.current === 0 ? 300 : backoffRef.current * 2, 5e3);
+      connectionRef.current = "reconnecting";
       setConnection("reconnecting");
       retryTimerRef.current = setTimeout(() => {
         retryTimerRef.current = null;
@@ -4410,7 +4568,12 @@ function useCollab(opts) {
       onChange: () => {
         const c = connRef.current;
         if (!c) return;
-        setDoc(c.doc);
+        const nextDoc = c.doc;
+        const objectChanged = publishedDocRef.current !== null && nextDoc !== publishedDocRef.current;
+        const connectionEpochChanged = c.docEpoch !== connectionDocEpochRef.current;
+        publishedDocRef.current = nextDoc;
+        connectionDocEpochRef.current = c.docEpoch;
+        setDoc(nextDoc);
         setReady(c.ready);
         setVersion((v) => v + 1);
         const dv = c.docVersion;
@@ -4418,24 +4581,43 @@ function useCollab(opts) {
           lastDocVersionRef.current = dv;
           setRenderVersion((v) => v + 1);
         }
-        setDocEpoch(c.docEpoch);
+        if (objectChanged || connectionEpochChanged) setDocEpoch((epoch) => epoch + 1);
         persister?.notify();
-        if (c.ready) {
+        if (c.ready && !manuallyOfflineRef.current) {
           backoffRef.current = 0;
           attemptRef.current = 0;
+          connectionRef.current = "live";
           setConnection((s) => s === "live" ? s : "live");
           lastGenesisRef.current = c.genesisId;
           if (tailConnRef.current !== c) {
             tailConnRef.current = c;
             const tail = offlineTailRef.current ?? [];
             if (tail.length) {
-              if (offlineEpochRef.current === c.genesisId) {
-                runTailReplay(c, "plain");
+              const confirmedSeq = c.exportBundle(docId)?.confirmedSeq ?? null;
+              const roomChangedWhileAway = disconnectSeqRef.current !== null && confirmedSeq !== null && confirmedSeq > disconnectSeqRef.current;
+              if (offlineEpochRef.current === c.genesisId && !roomChangedWhileAway) {
+                if (disconnectSeqRef.current !== null) {
+                  setArrival({ mode: "replay", tailLength: tail.length, structural: 0 });
+                } else {
+                  runTailReplay(c, "plain");
+                }
               } else {
                 const structural = toSuggestions(tail, "", "").dropped.length;
                 const mode = arrivalMode(tail.length, true) === "draft" ? "draft" : "suggest";
                 setArrival({ mode, tailLength: tail.length, structural });
+                if (roomChangedWhileAway && store && !manualDraftBankedRef.current) {
+                  const epoch = offlineEpochRef.current ?? c.genesisId;
+                  const snapshot = manualDraftSnapshotRef.current;
+                  if (epoch && snapshot) {
+                    manualDraftBankedRef.current = true;
+                    void store.put({ ...snapshot, docId: draftKey(docId, epoch) });
+                  }
+                }
               }
+            } else {
+              disconnectSeqRef.current = null;
+              manualDraftBankedRef.current = false;
+              manualDraftSnapshotRef.current = null;
             }
           }
         }
@@ -4515,7 +4697,7 @@ function useCollab(opts) {
           // ERASE a stored tail the user had not reconciled yet.
           offlineTail: () => {
             const tail = offlineTailRef.current ?? [];
-            return tail.length ? { tail: [...tail], epoch: offlineEpochRef.current ?? void 0 } : null;
+            return tail.length ? { tail: [...tail], epoch: offlineEpochRef.current ?? void 0, baseSeq: disconnectSeqRef.current ?? void 0 } : null;
           }
         });
         persisterRef.current = persister;
@@ -4537,6 +4719,7 @@ function useCollab(opts) {
         if (!offlineTailRef.current?.length) {
           offlineTailRef.current = bundle?.offlineTail;
           offlineEpochRef.current = bundle?.offlineTailEpoch ?? null;
+          disconnectSeqRef.current = bundle?.offlineTail?.length && !bundle.pending.length ? bundle.offlineBaseSeq ?? bundle.confirmedSeq : null;
           setOfflineHeld(bundle?.offlineTail?.length ?? 0);
         }
         if (bundle) conn.resume(bundle, token, { profile, codeProof, ownerToken });
@@ -4559,8 +4742,9 @@ function useCollab(opts) {
       persister?.stop();
       if (persisterRef.current === persister) persisterRef.current = null;
       connRef.current = null;
+      if (activeSocketRef.current === socket) activeSocketRef.current = null;
     };
-  }, [url, docId, clientId, token, createSocket, store, takeover, docKey, shareCode, ownerToken, httpBase, reconnectNonce]);
+  }, [url, docId, clientId, token, createSocket, store, takeover, docKey, shareCode, ownerToken, httpBase, reconnectNonce, startOffline]);
   useEffect(() => () => {
     if (retryTimerRef.current !== null) clearTimeout(retryTimerRef.current);
     retryTimerRef.current = null;
@@ -4569,6 +4753,9 @@ function useCollab(opts) {
   const refusalBlocked = refused !== null || (myWrite !== void 0 ? myWrite !== "allowed" : readOnlyBlocked);
   const offlineActive = !refusalBlocked && connection !== "live" && ready;
   const offlineCapped = offlineActive && offlineHeld >= (opts.offlineTailCap ?? OFFLINE_TAIL_CAP);
+  docRef.current = doc;
+  offlineActiveRef.current = offlineActive;
+  offlineCappedRef.current = offlineCapped;
   return {
     doc,
     version,
@@ -4596,7 +4783,7 @@ function useCollab(opts) {
     // that slips to the connection anyway lands in the loud droppedPreReady
     // backstop rather than vanishing.
     submit: (intent) => {
-      if (offlineActive && !offlineCapped) return captureOffline(
+      if (offlineActiveRef.current && !offlineCappedRef.current) return captureOfflineRef.current(
         intent,
         /*preApplied*/
         true
@@ -4608,16 +4795,25 @@ function useCollab(opts) {
     // code before recording, so the local result stays byte-identical to
     // what every replica will derive when the tail replays.
     submitOp: (intent) => {
-      if (offlineActive && !offlineCapped) return captureOffline(
+      if (offlineActiveRef.current && !offlineCappedRef.current) return captureOfflineRef.current(
         intent,
         /*preApplied*/
         false
       );
       connRef.current?.submit(intent);
     },
-    setPresence: (pos) => connRef.current?.setPresence(pos),
-    allocIds: (n) => connRef.current?.allocIds(n) ?? [],
-    uploadMedia: async (bytes) => await connRef.current?.uploadMedia(bytes) ?? null,
+    setPresence: (pos) => {
+      if (connectionRef.current === "live") connRef.current?.setPresence(pos);
+    },
+    allocIds: (n) => {
+      const out = [];
+      while (out.length < n) {
+        const id = carriedIdAllocator.next();
+        if (!docRef.current?.stableIds?.elOf(id)) out.push(id);
+      }
+      return out;
+    },
+    uploadMedia: async (bytes) => connectionRef.current === "live" ? await connRef.current?.uploadMedia(bytes) ?? null : null,
     // Read straight off the connection rather than mirrored into state: it is
     // set once when the welcome lands and never changes for the session, and
     // in the encrypted connection it is assigned OUTSIDE the serial rehydrate
@@ -4633,8 +4829,8 @@ function useCollab(opts) {
     // at construction — a pre-existing modelling wrinkle, not this arc's), so
     // the access is structural. The TYPE is the real one now, so a change to
     // UndoOutcome breaks here rather than silently disagreeing.
-    undoLast: () => connRef.current?.undoLast?.() ?? "unavailable",
-    presence,
+    undoLast: () => connectionRef.current === "live" ? connRef.current?.undoLast?.() ?? "unavailable" : "unavailable",
+    presence: connection === "live" ? presence : EMPTY_PRESENCE,
     refused,
     sessionWarning,
     readOnlyBlocked,
@@ -4681,12 +4877,35 @@ function useCollab(opts) {
     writeStatus: myWrite,
     connection,
     reconnect,
+    disconnect,
+    restoreOfflineView: () => {
+      const current = connRef.current?.doc;
+      const ids = current?.stableIds;
+      const tail = offlineTailRef.current ?? [];
+      if (!current || !ids || tail.length === 0) return;
+      let scope = null;
+      for (const intent of tail) {
+        const result = applyIntentScoped(current, ids, intent);
+        if (!result.applied) continue;
+        resyncScope(current, ids, result);
+        scope = scope ? unionScopes(scope, result) : result;
+      }
+      if (scope) {
+        renderScopeRef.current = scope;
+        setVersion((value) => value + 1);
+        setRenderVersion((value) => value + 1);
+      }
+    },
     retryWrites: () => setReadOnlyBlocked(false),
     epochChanged,
     roster,
-    setProfile: (p) => connRef.current?.setProfile(p),
+    setProfile: (p) => {
+      if (connectionRef.current === "live") connRef.current?.setProfile(p);
+    },
     activity: connRef.current?.activity ?? [],
-    admin: (action) => connRef.current?.admin(action),
+    admin: (action) => {
+      if (connectionRef.current === "live") connRef.current?.admin(action);
+    },
     selfHeals,
     droppedPreReady,
     persistErrors,
@@ -4701,15 +4920,23 @@ function useCollab(opts) {
         offlineEpochRef.current = null;
         setOfflineHeld(0);
         setArrival(null);
+        disconnectSeqRef.current = null;
+        manualDraftBankedRef.current = false;
+        manualDraftSnapshotRef.current = null;
         return;
       }
       setArrival(null);
-      if (mode === "suggest") {
+      if (mode === "replay") {
+        runTailReplay(conn, "plain");
+      } else if (mode === "suggest") {
         runTailReplay(conn, "suggest");
       } else {
         offlineTailRef.current = void 0;
         offlineEpochRef.current = null;
         setOfflineHeld(0);
+        disconnectSeqRef.current = null;
+        manualDraftBankedRef.current = false;
+        manualDraftSnapshotRef.current = null;
         void persisterRef.current?.flush();
       }
     }
@@ -4735,7 +4962,7 @@ function CollabEditor(opts) {
   const session = useCollab(opts);
   useEffect(() => {
     opts.onSession?.(session);
-  }, [session.version, session.ready, session.refused, session.roster, session.epochChanged, session.sessionWarning, session.writesBlocked, session.connection, session.persistErrors]);
+  }, [session.version, session.ready, session.refused, session.roster, session.epochChanged, session.sessionWarning, session.writesBlocked, session.connection, session.persistErrors, session.storeSlow, session.notOwner, session.arrival, session.offline?.editsHeld, session.offline?.capped]);
   const [api, setApi] = useState(null);
   const pendingCaretRef = useRef(null);
   const seenEpochRef = useRef(session.docEpoch);
@@ -4755,7 +4982,7 @@ function CollabEditor(opts) {
       // Legible over a rendered page in the overlay case; inert extra
       // styling on the plain full-screen path costs nothing.
       docVisible ? { style: { margin: 16, padding: "10px 14px", width: "fit-content", background: "rgba(255,255,255,.95)", borderRadius: 8, font: "14px system-ui", boxShadow: "0 2px 8px rgba(0,0,0,.25)" } } : void 0,
-      `Please refresh \u2014 ${session.refused}.`
+      `Server response: ${session.refused}. Reload the page.`
     );
     if (!docVisible) {
       return createElement("div", { className: "dxw-collab-refused" }, content);
@@ -4850,8 +5077,9 @@ function CollabEditor(opts) {
     // and lost it, which is why the read-only banner could be on screen while
     // the user's text appeared and then vanished.
     editable: (opts.editable ?? true) && !session.writesBlocked,
-    // Re-key only on docEpoch (a true-conflict reload) — NOT on every change.
-    // Between reloads the live doc mutates in place and the key stays stable,
+    revisions: opts.revisions,
+    // Re-key only on docEpoch (a document replacement), not on every change.
+    // Between replacements the live doc mutates in place and the key stays stable,
     // so DocxView repaints in place instead of re-mounting (no flash/jump).
     key: session.docEpoch
   });
@@ -4883,7 +5111,7 @@ function ConnectingNotice() {
       "aria-busy": "true"
     },
     createElement("span", { className: "dxw-collab-spinner", "aria-hidden": "true", key: "s" }),
-    slow ? "Still connecting \u2014 is the collab server running? (start it, then reload this page)" : "Connecting\u2026"
+    slow ? "Still connecting. Check your connection, then reload this page." : "Connecting\u2026"
   );
 }
 export {