@ai-matrx/office 0.8.29 → 0.8.30

package/CHANGELOG.md

@@ -1,10 +1,20 @@
 # Changelog
 
-## 0.8.29
+## 0.8.30
 
 UNVERIFIED: this release has no Unreleased entry and the source comparison could not be made (the caller supplied no source comparison). Whether source changed is unknown; consumer action is unknown.
 Check the package's gitHead on npm against this version's gitHead: `git diff <previous gitHead> <this gitHead> -- apps/shared/office/src`.
 
+## 0.8.29
+
+SOURCE CHANGED WITH NO RELEASE NOTE. This release shipped source changes that nobody described in an Unreleased entry,
+so they may include breaking API changes. Consumer action is UNKNOWN: read the diff before upgrading.
+Diff: `git diff 01daf620b4 acce3dd470 -- apps/shared/office/src`
+
+Changed shipped source files (2):
+- `apps/shared/office/src/collab/sheets/transform/fuzz/seats.ts`
+- `apps/shared/office/src/univer/collab/sheets-ot/univer-port.ts`
+
 ## 0.8.28
 
 Automatic changed-only republish (docs/metadata drift since the last published version; verified: `git diff 0c69bc7f5b 01daf620b4 -- apps/shared/office/src`

package/dist/docs.cjs

@@ -50,11 +50,111 @@ function takeCovered(snapshot) {
   };
 }
 
+// src/docs/comment-anchors.ts
+
+var COMMENT_ANCHOR_RANGE_TYPE = _core.CustomRangeType.COMMENT;
+var COMMENT_ANCHOR_PART_PREFIX = "anchor:";
+var COMMENT_ANCHOR_LABEL_MAX = 200;
+var ID_ALPHABET = "abcdefghijklmnopqrstuvwxyz0123456789";
+function newCommentAnchorId() {
+  const bytes = new Uint8Array(16);
+  globalThis.crypto.getRandomValues(bytes);
+  let out = "c";
+  for (const b of bytes) out += ID_ALPHABET[b % ID_ALPHABET.length];
+  return out;
+}
+function commentAnchorPartKey(anchorId) {
+  return `${COMMENT_ANCHOR_PART_PREFIX}${anchorId}`;
+}
+function anchorIdOfPartAnchor(anchor) {
+  if (!anchor || typeof anchor !== "object") return null;
+  const a = anchor;
+  if ((a.__kind === "part_anchor" || a.__kind === "text_anchor") && typeof a.anchor_id === "string" && a.anchor_id.length > 0) return a.anchor_id;
+  if (a.__kind !== "part_anchor" || typeof a.part_key !== "string") return null;
+  if (!a.part_key.startsWith(COMMENT_ANCHOR_PART_PREFIX)) return null;
+  const id = a.part_key.slice(COMMENT_ANCHOR_PART_PREFIX.length);
+  return id.length > 0 ? id : null;
+}
+function quoteOfCommentAnchor(anchor) {
+  if (!anchor || typeof anchor !== "object") return "";
+  const a = anchor;
+  return typeof a.label === "string" ? a.label : typeof a.exact === "string" ? a.exact : "";
+}
+function commentPartAnchor(anchorId, quote) {
+  const label = quote.replace(/\s+/g, " ").trim().slice(0, COMMENT_ANCHOR_LABEL_MAX);
+  return { __kind: "part_anchor", part_key: commentAnchorPartKey(anchorId), ...label ? { label } : {} };
+}
+var CONTROL = /[\u0000-\u001f\u007f]/g;
+function commentAnchorsOf(body) {
+  const out = /* @__PURE__ */ new Map();
+  const b = _nullishCoalesce(body, () => ( {}));
+  const stream = typeof b.dataStream === "string" ? b.dataStream : "";
+  for (const r of _nullishCoalesce(b.customRanges, () => ( []))) {
+    if (!r || r.rangeType !== COMMENT_ANCHOR_RANGE_TYPE || typeof r.rangeId !== "string") continue;
+    const start = r.startIndex;
+    const end = r.endIndex + 1;
+    if (!(end > start)) continue;
+    const had = out.get(r.rangeId);
+    const s2 = had ? Math.min(had.start, start) : start;
+    const e2 = had ? Math.max(had.end, end) : end;
+    out.set(r.rangeId, { id: r.rangeId, start: s2, end: e2, text: "" });
+  }
+  for (const span of out.values()) span.text = stream.slice(span.start, span.end).replace(CONTROL, " ");
+  return out;
+}
+function addCommentAnchorActions(body, start, end, anchorId) {
+  if (!(end > start) || start < 0) return null;
+  const textX = _core.BuildTextUtils.customRange.add({
+    body,
+    ranges: [{ startOffset: start, endOffset: end, collapsed: false }],
+    rangeId: anchorId,
+    rangeType: COMMENT_ANCHOR_RANGE_TYPE
+  });
+  if (!textX) return null;
+  return _core.JSONX.getInstance().editOp(textX.serialize(), ["body"]);
+}
+function removeCommentAnchorActions(documentDataModel, anchorId) {
+  const textX = _core.BuildTextUtils.customRange.delete({ documentDataModel, rangeId: anchorId });
+  if (!textX) return null;
+  return _core.JSONX.getInstance().editOp(textX.serialize(), ["body"]);
+}
+var RETAIN_KEYS = /* @__PURE__ */ new Set(["t", "len", "body", "coverType"]);
+var RANGE_KEYS = /* @__PURE__ */ new Set(["rangeId", "rangeType", "startIndex", "endIndex", "properties"]);
+var isObj = (v) => !!v && typeof v === "object" && !Array.isArray(v);
+var keysOf = (o) => Object.keys(o).filter((k) => o[k] !== void 0);
+function isDocsAnchorOnlyOp(op) {
+  if (!Array.isArray(op) || op.length !== 2 || op[0] !== "body") return false;
+  const x = op[1];
+  if (!isObj(x) || x.et !== "text-x" || !Array.isArray(x.e) || x.e.length === 0) return false;
+  if (keysOf(x).some((k) => k !== "et" && k !== "e")) return false;
+  for (const c of x.e) {
+    if (!isObj(c) || c.t !== "r" || typeof c.len !== "number") return false;
+    if (keysOf(c).some((k) => !RETAIN_KEYS.has(k))) return false;
+    if ("coverType" in c && typeof c.coverType !== "number") return false;
+    if ("body" in c) {
+      const b = c.body;
+      if (!isObj(b) || keysOf(b).some((k) => k !== "dataStream" && k !== "customRanges")) return false;
+      if (b.dataStream !== void 0 && b.dataStream !== "") return false;
+      if (!Array.isArray(b.customRanges) || b.customRanges.length === 0) return false;
+      for (const r of b.customRanges) {
+        if (!isObj(r) || r.rangeType !== COMMENT_ANCHOR_RANGE_TYPE) return false;
+        if (keysOf(r).some((k) => !RANGE_KEYS.has(k))) return false;
+      }
+    }
+  }
+  return true;
+}
+
 // src/docs/document-model.ts
 var RICH_TEXT_EDITING_ID = "doc.mutation.rich-text-editing";
 var COMMAND_TYPE = 0;
 var DEPTH_GUARDED = /* @__PURE__ */ Symbol.for("ai-matrx.office.docs.command-depth-guard");
 var DOCUMENT_SAVE_DELAY_MS = 2500;
+function isCommentAnchorMutation(info) {
+  if (info.id !== RICH_TEXT_EDITING_ID) return false;
+  const params = info.params;
+  return !!params && !params.segmentId && isDocsAnchorOnlyOp(params.actions);
+}
 var viewIds = 0;
 var DocumentModel = (_class = class {
   
@@ -193,11 +293,13 @@ var DocumentModel = (_class = class {
   onViewMutation(viewId, info, options) {
     if (this.relaying || _optionalChain([options, 'optionalAccess', _19 => _19.fromCollab]) || _optionalChain([options, 'optionalAccess', _20 => _20.fromChangeset])) return;
     const view = this.views.get(viewId);
-    if (!view || !view.port.editable()) return;
+    if (!view) return;
+    const editable = view.port.editable();
+    if (!editable && !(_optionalChain([view, 'access', _21 => _21.port, 'access', _22 => _22.commentOnly, 'optionalCall', _23 => _23()]) === true && isCommentAnchorMutation(info))) return;
     this.lastEditedView = viewId;
     this.relay(info, viewId);
     for (const listener of this.collabListeners) listener(info, options);
-    if (this.otListeners.size && !_optionalChain([options, 'optionalAccess', _21 => _21.onlyLocal])) {
+    if (this.otListeners.size && !_optionalChain([options, 'optionalAccess', _24 => _24.onlyLocal])) {
       const m = {
         id: info.id,
         params: info.params,
@@ -208,7 +310,7 @@ var DocumentModel = (_class = class {
       view.pre = null;
       for (const listener of Array.from(this.otListeners)) listener(m);
     }
-    if (isContentMutation(info)) this.markDirty();
+    if (editable && isContentMutation(info)) this.markDirty();
   }
   /**
    * Per view: the outermost command running (a mutation's group label) and, while a room listens, the document
@@ -257,7 +359,7 @@ var DocumentModel = (_class = class {
   /** The unit id a view's document has (what a replayed mutation must be addressed to). */
   unitIdOf(view) {
     try {
-      return _nullishCoalesce(_nullishCoalesce(_optionalChain([view, 'access', _22 => _22.port, 'access', _23 => _23.unitId, 'optionalCall', _24 => _24()]), () => ( _optionalChain([view, 'access', _25 => _25.port, 'access', _26 => _26.snapshot, 'call', _27 => _27(), 'optionalAccess', _28 => _28.id]))), () => ( null));
+      return _nullishCoalesce(_nullishCoalesce(_optionalChain([view, 'access', _25 => _25.port, 'access', _26 => _26.unitId, 'optionalCall', _27 => _27()]), () => ( _optionalChain([view, 'access', _28 => _28.port, 'access', _29 => _29.snapshot, 'call', _30 => _30(), 'optionalAccess', _31 => _31.id]))), () => ( null));
     } catch (e6) {
       return null;
     }
@@ -291,7 +393,7 @@ var DocumentModel = (_class = class {
   /** A view could not follow an edit: say so, then show the saved version (unless this tab has unsaved edits of its own). */
   applyFailed(mutationId, error) {
     try {
-      _optionalChain([this, 'access', _29 => _29.deps, 'access', _30 => _30.onApplyFailed, 'optionalCall', _31 => _31(this.documentId, mutationId, error)]);
+      _optionalChain([this, 'access', _32 => _32.deps, 'access', _33 => _33.onApplyFailed, 'optionalCall', _34 => _34(this.documentId, mutationId, error)]);
     } catch (notifyError) {
       console.warn(`[document-model] the notice for ${this.documentId}'s failed apply also failed`, notifyError);
     }
@@ -319,7 +421,7 @@ var DocumentModel = (_class = class {
   async write(reason) {
     if (this.ot) {
       const wrote = await this.ot.write(reason);
-      if (wrote) _optionalChain([this, 'access', _32 => _32.deps, 'access', _33 => _33.onSaved, 'optionalCall', _34 => _34(this.documentId, reason === "manual" ? "manual" : "autosave")]);
+      if (wrote) _optionalChain([this, 'access', _35 => _35.deps, 'access', _36 => _36.onSaved, 'optionalCall', _37 => _37(this.documentId, reason === "manual" ? "manual" : "autosave")]);
       return wrote;
     }
     const snapshot = this.latest();
@@ -344,7 +446,7 @@ var DocumentModel = (_class = class {
       this.saving = false;
     }
     if (this.views.size === 0) this.stored = snapshot;
-    _optionalChain([this, 'access', _35 => _35.deps, 'access', _36 => _36.onSaved, 'optionalCall', _37 => _37(this.documentId, origin)]);
+    _optionalChain([this, 'access', _38 => _38.deps, 'access', _39 => _39.onSaved, 'optionalCall', _40 => _40(this.documentId, origin)]);
     return true;
   }
   hasUnsaved() {
@@ -387,7 +489,7 @@ var DocumentModel = (_class = class {
   replaceContent(row) {
     if (this.ot) return this.ot.replace(row.snapshot);
     this.show(row);
-    _optionalChain([this, 'access', _38 => _38.collab, 'optionalAccess', _39 => _39.announceReplaced, 'call', _40 => _40(row.id)]);
+    _optionalChain([this, 'access', _41 => _41.collab, 'optionalAccess', _42 => _42.announceReplaced, 'call', _43 => _43(row.id)]);
   }
   /** A peer replaced the document: show the newest save (once). */
   async onPeerReplaced() {
@@ -410,7 +512,7 @@ var DocumentModel = (_class = class {
     this.relaying = true;
     try {
       for (const view of this.views.values()) view.port.remount(snapshot);
-      _optionalChain([this, 'access', _41 => _41.parked, 'optionalAccess', _42 => _42.remount, 'call', _43 => _43(snapshot)]);
+      _optionalChain([this, 'access', _44 => _44.parked, 'optionalAccess', _45 => _45.remount, 'call', _46 => _46(snapshot)]);
     } finally {
       this.relaying = false;
     }
@@ -484,7 +586,7 @@ var DocumentModel = (_class = class {
           const input = Array.isArray(params.actions) ? params.actions.length : 0;
           let sel = null;
           try {
-            sel = _nullishCoalesce(_optionalChain([view, 'access', _44 => _44.port, 'access', _45 => _45.selection, 'optionalAccess', _46 => _46.get, 'call', _47 => _47()]), () => ( null));
+            sel = _nullishCoalesce(_optionalChain([view, 'access', _47 => _47.port, 'access', _48 => _48.selection, 'optionalAccess', _49 => _49.get, 'call', _50 => _50()]), () => ( null));
           } catch (e7) {
             sel = null;
           }
@@ -495,7 +597,7 @@ var DocumentModel = (_class = class {
           const moved = sel && sel.length && sel.every((r) => !r.segmentId) ? moveRangesThroughBodyEdit(sel, params.actions) : null;
           if (moved) {
             try {
-              _optionalChain([view, 'access', _48 => _48.port, 'access', _49 => _49.selection, 'optionalAccess', _50 => _50.set, 'call', _51 => _51(moved)]);
+              _optionalChain([view, 'access', _51 => _51.port, 'access', _52 => _52.selection, 'optionalAccess', _53 => _53.set, 'call', _54 => _54(moved)]);
             } catch (error) {
               console.warn(`[document-model] could not move this view's caret past a collaborator's edit`, error);
             }
@@ -514,7 +616,7 @@ var DocumentModel = (_class = class {
       this.relaying = true;
       try {
         for (const view of this.views.values()) view.port.remount(s2);
-        _optionalChain([this, 'access', _52 => _52.parked, 'optionalAccess', _53 => _53.remount, 'call', _54 => _54(s2)]);
+        _optionalChain([this, 'access', _55 => _55.parked, 'optionalAccess', _56 => _56.remount, 'call', _57 => _57(s2)]);
       } finally {
         this.relaying = false;
       }
@@ -523,7 +625,7 @@ var DocumentModel = (_class = class {
       const out = [];
       for (const view of this.views.values()) {
         const unitId = this.unitIdOf(view);
-        const service = _optionalChain([view, 'access', _55 => _55.port, 'access', _56 => _56.undoRedo, 'optionalCall', _57 => _57()]);
+        const service = _optionalChain([view, 'access', _58 => _58.port, 'access', _59 => _59.undoRedo, 'optionalCall', _60 => _60()]);
         if (unitId && service) out.push({ service, unitId });
       }
       return out;
@@ -532,7 +634,7 @@ var DocumentModel = (_class = class {
     selection: () => {
       for (const view of this.views.values()) {
         try {
-          const sel = _optionalChain([view, 'access', _58 => _58.port, 'access', _59 => _59.selection, 'optionalAccess', _60 => _60.get, 'call', _61 => _61()]);
+          const sel = _optionalChain([view, 'access', _61 => _61.port, 'access', _62 => _62.selection, 'optionalAccess', _63 => _63.get, 'call', _64 => _64()]);
           if (sel) return sel;
         } catch (e8) {
         }
@@ -591,9 +693,9 @@ var DocumentModel = (_class = class {
    * so a collaborator's save still reaches the body a returning view boots from.
    */
   rest() {
-    _optionalChain([this, 'access', _62 => _62.collab, 'optionalAccess', _63 => _63.stop, 'call', _64 => _64()]);
+    _optionalChain([this, 'access', _65 => _65.collab, 'optionalAccess', _66 => _66.stop, 'call', _67 => _67()]);
     this.collab = null;
-    _optionalChain([this, 'access', _65 => _65.ot, 'optionalAccess', _66 => _66.stop, 'call', _67 => _67()]);
+    _optionalChain([this, 'access', _68 => _68.ot, 'optionalAccess', _69 => _69.stop, 'call', _70 => _70()]);
     this.ot = null;
     this.awareness = null;
   }
@@ -609,9 +711,9 @@ var DocumentModel = (_class = class {
         console.warn(`[document-model] could not dispose ${this.documentId}'s kept editor`, error);
       }
     }
-    _optionalChain([this, 'access', _68 => _68.realtimeClose, 'optionalCall', _69 => _69()]);
+    _optionalChain([this, 'access', _71 => _71.realtimeClose, 'optionalCall', _72 => _72()]);
     this.realtimeClose = null;
-    _optionalChain([this, 'access', _70 => _70.pageClose, 'optionalCall', _71 => _71()]);
+    _optionalChain([this, 'access', _73 => _73.pageClose, 'optionalCall', _74 => _74()]);
     this.pageClose = null;
   }
 }, _class);
@@ -889,12 +991,12 @@ function movePeerRangesThroughBodyEdit(ranges, actions) {
 }
 var sameRanges = (a, b) => a.length === b.length && a.every((r, i) => r.start === b[i].start && r.end === b[i].end);
 function readCaret(raw) {
-  const c = _optionalChain([raw, 'optionalAccess', _72 => _72.caret]);
+  const c = _optionalChain([raw, 'optionalAccess', _75 => _75.caret]);
   if (!c || !Array.isArray(c.ranges) || typeof c.at !== "number") return null;
   const ranges = [];
   for (const r of c.ranges.slice(0, CARET_MAX_RANGES)) {
-    const s2 = _optionalChain([r, 'optionalAccess', _73 => _73.start]);
-    const e2 = _optionalChain([r, 'optionalAccess', _74 => _74.end]);
+    const s2 = _optionalChain([r, 'optionalAccess', _76 => _76.start]);
+    const e2 = _optionalChain([r, 'optionalAccess', _77 => _77.end]);
     if (typeof s2 !== "number" || typeof e2 !== "number" || !Number.isFinite(s2) || !Number.isFinite(e2) || s2 < 0 || e2 < 0) return null;
     ranges.push({ start: s2, end: e2 });
   }
@@ -960,101 +1062,6 @@ var RemoteCaretBook = (_class2 = class {
   }
 }, _class2);
 
-// src/docs/comment-anchors.ts
-
-var COMMENT_ANCHOR_RANGE_TYPE = _core.CustomRangeType.COMMENT;
-var COMMENT_ANCHOR_PART_PREFIX = "anchor:";
-var COMMENT_ANCHOR_LABEL_MAX = 200;
-var ID_ALPHABET = "abcdefghijklmnopqrstuvwxyz0123456789";
-function newCommentAnchorId() {
-  const bytes = new Uint8Array(16);
-  globalThis.crypto.getRandomValues(bytes);
-  let out = "c";
-  for (const b of bytes) out += ID_ALPHABET[b % ID_ALPHABET.length];
-  return out;
-}
-function commentAnchorPartKey(anchorId) {
-  return `${COMMENT_ANCHOR_PART_PREFIX}${anchorId}`;
-}
-function anchorIdOfPartAnchor(anchor) {
-  if (!anchor || typeof anchor !== "object") return null;
-  const a = anchor;
-  if ((a.__kind === "part_anchor" || a.__kind === "text_anchor") && typeof a.anchor_id === "string" && a.anchor_id.length > 0) return a.anchor_id;
-  if (a.__kind !== "part_anchor" || typeof a.part_key !== "string") return null;
-  if (!a.part_key.startsWith(COMMENT_ANCHOR_PART_PREFIX)) return null;
-  const id = a.part_key.slice(COMMENT_ANCHOR_PART_PREFIX.length);
-  return id.length > 0 ? id : null;
-}
-function quoteOfCommentAnchor(anchor) {
-  if (!anchor || typeof anchor !== "object") return "";
-  const a = anchor;
-  return typeof a.label === "string" ? a.label : typeof a.exact === "string" ? a.exact : "";
-}
-function commentPartAnchor(anchorId, quote) {
-  const label = quote.replace(/\s+/g, " ").trim().slice(0, COMMENT_ANCHOR_LABEL_MAX);
-  return { __kind: "part_anchor", part_key: commentAnchorPartKey(anchorId), ...label ? { label } : {} };
-}
-var CONTROL = /[\u0000-\u001f\u007f]/g;
-function commentAnchorsOf(body) {
-  const out = /* @__PURE__ */ new Map();
-  const b = _nullishCoalesce(body, () => ( {}));
-  const stream = typeof b.dataStream === "string" ? b.dataStream : "";
-  for (const r of _nullishCoalesce(b.customRanges, () => ( []))) {
-    if (!r || r.rangeType !== COMMENT_ANCHOR_RANGE_TYPE || typeof r.rangeId !== "string") continue;
-    const start = r.startIndex;
-    const end = r.endIndex + 1;
-    if (!(end > start)) continue;
-    const had = out.get(r.rangeId);
-    const s2 = had ? Math.min(had.start, start) : start;
-    const e2 = had ? Math.max(had.end, end) : end;
-    out.set(r.rangeId, { id: r.rangeId, start: s2, end: e2, text: "" });
-  }
-  for (const span of out.values()) span.text = stream.slice(span.start, span.end).replace(CONTROL, " ");
-  return out;
-}
-function addCommentAnchorActions(body, start, end, anchorId) {
-  if (!(end > start) || start < 0) return null;
-  const textX = _core.BuildTextUtils.customRange.add({
-    body,
-    ranges: [{ startOffset: start, endOffset: end, collapsed: false }],
-    rangeId: anchorId,
-    rangeType: COMMENT_ANCHOR_RANGE_TYPE
-  });
-  if (!textX) return null;
-  return _core.JSONX.getInstance().editOp(textX.serialize(), ["body"]);
-}
-function removeCommentAnchorActions(documentDataModel, anchorId) {
-  const textX = _core.BuildTextUtils.customRange.delete({ documentDataModel, rangeId: anchorId });
-  if (!textX) return null;
-  return _core.JSONX.getInstance().editOp(textX.serialize(), ["body"]);
-}
-var RETAIN_KEYS = /* @__PURE__ */ new Set(["t", "len", "body", "coverType"]);
-var RANGE_KEYS = /* @__PURE__ */ new Set(["rangeId", "rangeType", "startIndex", "endIndex", "properties"]);
-var isObj = (v) => !!v && typeof v === "object" && !Array.isArray(v);
-var keysOf = (o) => Object.keys(o).filter((k) => o[k] !== void 0);
-function isDocsAnchorOnlyOp(op) {
-  if (!Array.isArray(op) || op.length !== 2 || op[0] !== "body") return false;
-  const x = op[1];
-  if (!isObj(x) || x.et !== "text-x" || !Array.isArray(x.e) || x.e.length === 0) return false;
-  if (keysOf(x).some((k) => k !== "et" && k !== "e")) return false;
-  for (const c of x.e) {
-    if (!isObj(c) || c.t !== "r" || typeof c.len !== "number") return false;
-    if (keysOf(c).some((k) => !RETAIN_KEYS.has(k))) return false;
-    if ("coverType" in c && typeof c.coverType !== "number") return false;
-    if ("body" in c) {
-      const b = c.body;
-      if (!isObj(b) || keysOf(b).some((k) => k !== "dataStream" && k !== "customRanges")) return false;
-      if (b.dataStream !== void 0 && b.dataStream !== "") return false;
-      if (!Array.isArray(b.customRanges) || b.customRanges.length === 0) return false;
-      for (const r of b.customRanges) {
-        if (!isObj(r) || r.rangeType !== COMMENT_ANCHOR_RANGE_TYPE) return false;
-        if (keysOf(r).some((k) => !RANGE_KEYS.has(k))) return false;
-      }
-    }
-  }
-  return true;
-}
-