@ai-matrx/office 0.8.26 → 0.8.28

package/dist/docs.d.cts

@@ -816,8 +816,15 @@ declare const COMMENT_ANCHOR_LABEL_MAX = 200;
 /** A fresh anchor id: 16 random base-36 characters (custom-range ids are plain strings). */
 declare function newCommentAnchorId(): string;
 declare function commentAnchorPartKey(anchorId: string): string;
-/** The anchor id a `part_anchor` names, or null when it is not one of ours. */
+/**
+ * The anchor id a thread's `anchor` names, or null when it is not one of ours. A new thread is a `part_anchor` keyed
+ * `anchor:<id>`. At each save the door projects the live anchor onto the thread (COLLAB-DESIGN §8): a sheet thread's key
+ * becomes `cell:<sheetId>!R<r>C<c>` and a docs thread becomes a `text_anchor` holding the quoted text; both keep the id in
+ * `anchor_id`, so the thread stays joined to its anchor after the rewrite.
+ */
 declare function anchorIdOfPartAnchor(anchor: unknown): string | null;
+/** The quoted text a thread carries: a new thread's label, or the frozen `exact` of a projected docs thread. */
+declare function quoteOfCommentAnchor(anchor: unknown): string;
 /** The `part_anchor` a new thread on this anchor carries. */
 declare function commentPartAnchor(anchorId: string, quote: string): {
     __kind: "part_anchor";
@@ -843,5 +850,12 @@ declare function addCommentAnchorActions(body: unknown, start: number, end: numb
  * its text. Null when the anchor is not there.
  */
 declare function removeCommentAnchorActions(documentDataModel: unknown, anchorId: string): unknown[] | null;
+/**
+ * A Docs op that only ADDS comment anchors: `["body", { et: "text-x", e: [...] }]` whose every component is a plain
+ * retain, carrying (when it carries a body) nothing but COMMENT custom ranges. No insert, no delete, no text, no style,
+ * no other range type. A seat that may comment but not edit sends exactly these; the door `content.collab_append`
+ * checks the same rule. Taking a range out is NOT included: it reads the same as removing a link, so it is an edit.
+ */
+declare function isDocsAnchorOnlyOp(op: unknown): boolean;
 
-export { type BodyEdit, type BodyText, CARET_HEARTBEAT_MS, CARET_MAX_RANGES, CARET_STALE_MS, COMMENT_ANCHOR_LABEL_MAX, COMMENT_ANCHOR_PART_PREFIX, COMMENT_ANCHOR_RANGE_TYPE, type CaretRange, type CommentAnchorSpan, type CreateDocumentArgs, DOCUMENT_BODY_MAX_LENGTH, DOCUMENT_DESCRIPTION_MAX_LENGTH, DOCUMENT_NAME_MAX_LENGTH, DOCUMENT_SAVE_DELAY_MS, type DocsHostPorts, type DocsSupabase, type DocumentAwareness, type DocumentBodyPort, type DocumentBodyWriteHandler, type DocumentCollabBase, type DocumentCollabFactory, type DocumentCollabHandle, DocumentModel, type DocumentModelDeps, type DocumentOtFactory, type DocumentOtHandle, type DocumentSnapshotData, type DocumentViewPort, EMOJI_GROUPS, type Glyph, MIN_FIT_ZOOM, type ParkedDocumentEditor, type PublishedCaret, type RemoteCaret, RemoteCaretBook, SPECIAL_GROUPS, type SaveDocumentSnapshotArgs, addCommentAnchorActions, anchorIdOfPartAnchor, bodyTextOf, commentAnchorPartKey, commentAnchorsOf, commentPartAnchor, configureDocsHost, copyDocument, createDocument, deleteDocument, discardFailedDocument, documentBodyWriteHandler, documentSourceLabel, fitZoomRatio, getDocsHost, getDocument, getLatestDocumentSnapshot, listAccessibleDocuments, listDocumentSnapshots, listTrashedDocuments, moveDocument, movePeerRangesThroughBodyEdit, moveRangesThroughBodyEdit, newCommentAnchorId, planBodyEdit, publishedCaretFromSelection, removeCommentAnchorActions, renameDocument, restoreDocument, sanitizeUniverDocSnapshot, saveDocumentSnapshot, searchSymbols, updateDocumentDescription, validateDocumentBody, validateDocumentDescription, validateDocumentName, writeBodyText };
+export { type BodyEdit, type BodyText, CARET_HEARTBEAT_MS, CARET_MAX_RANGES, CARET_STALE_MS, COMMENT_ANCHOR_LABEL_MAX, COMMENT_ANCHOR_PART_PREFIX, COMMENT_ANCHOR_RANGE_TYPE, type CaretRange, type CommentAnchorSpan, type CreateDocumentArgs, DOCUMENT_BODY_MAX_LENGTH, DOCUMENT_DESCRIPTION_MAX_LENGTH, DOCUMENT_NAME_MAX_LENGTH, DOCUMENT_SAVE_DELAY_MS, type DocsHostPorts, type DocsSupabase, type DocumentAwareness, type DocumentBodyPort, type DocumentBodyWriteHandler, type DocumentCollabBase, type DocumentCollabFactory, type DocumentCollabHandle, DocumentModel, type DocumentModelDeps, type DocumentOtFactory, type DocumentOtHandle, type DocumentSnapshotData, type DocumentViewPort, EMOJI_GROUPS, type Glyph, MIN_FIT_ZOOM, type ParkedDocumentEditor, type PublishedCaret, type RemoteCaret, RemoteCaretBook, SPECIAL_GROUPS, type SaveDocumentSnapshotArgs, addCommentAnchorActions, anchorIdOfPartAnchor, bodyTextOf, commentAnchorPartKey, commentAnchorsOf, commentPartAnchor, configureDocsHost, copyDocument, createDocument, deleteDocument, discardFailedDocument, documentBodyWriteHandler, documentSourceLabel, fitZoomRatio, getDocsHost, getDocument, getLatestDocumentSnapshot, isDocsAnchorOnlyOp, listAccessibleDocuments, listDocumentSnapshots, listTrashedDocuments, moveDocument, movePeerRangesThroughBodyEdit, moveRangesThroughBodyEdit, newCommentAnchorId, planBodyEdit, publishedCaretFromSelection, quoteOfCommentAnchor, removeCommentAnchorActions, renameDocument, restoreDocument, sanitizeUniverDocSnapshot, saveDocumentSnapshot, searchSymbols, updateDocumentDescription, validateDocumentBody, validateDocumentDescription, validateDocumentName, writeBodyText };

package/dist/docs.d.ts

@@ -816,8 +816,15 @@ declare const COMMENT_ANCHOR_LABEL_MAX = 200;
 /** A fresh anchor id: 16 random base-36 characters (custom-range ids are plain strings). */
 declare function newCommentAnchorId(): string;
 declare function commentAnchorPartKey(anchorId: string): string;
-/** The anchor id a `part_anchor` names, or null when it is not one of ours. */
+/**
+ * The anchor id a thread's `anchor` names, or null when it is not one of ours. A new thread is a `part_anchor` keyed
+ * `anchor:<id>`. At each save the door projects the live anchor onto the thread (COLLAB-DESIGN §8): a sheet thread's key
+ * becomes `cell:<sheetId>!R<r>C<c>` and a docs thread becomes a `text_anchor` holding the quoted text; both keep the id in
+ * `anchor_id`, so the thread stays joined to its anchor after the rewrite.
+ */
 declare function anchorIdOfPartAnchor(anchor: unknown): string | null;
+/** The quoted text a thread carries: a new thread's label, or the frozen `exact` of a projected docs thread. */
+declare function quoteOfCommentAnchor(anchor: unknown): string;
 /** The `part_anchor` a new thread on this anchor carries. */
 declare function commentPartAnchor(anchorId: string, quote: string): {
     __kind: "part_anchor";
@@ -843,5 +850,12 @@ declare function addCommentAnchorActions(body: unknown, start: number, end: numb
  * its text. Null when the anchor is not there.
  */
 declare function removeCommentAnchorActions(documentDataModel: unknown, anchorId: string): unknown[] | null;
+/**
+ * A Docs op that only ADDS comment anchors: `["body", { et: "text-x", e: [...] }]` whose every component is a plain
+ * retain, carrying (when it carries a body) nothing but COMMENT custom ranges. No insert, no delete, no text, no style,
+ * no other range type. A seat that may comment but not edit sends exactly these; the door `content.collab_append`
+ * checks the same rule. Taking a range out is NOT included: it reads the same as removing a link, so it is an edit.
+ */
+declare function isDocsAnchorOnlyOp(op: unknown): boolean;
 
-export { type BodyEdit, type BodyText, CARET_HEARTBEAT_MS, CARET_MAX_RANGES, CARET_STALE_MS, COMMENT_ANCHOR_LABEL_MAX, COMMENT_ANCHOR_PART_PREFIX, COMMENT_ANCHOR_RANGE_TYPE, type CaretRange, type CommentAnchorSpan, type CreateDocumentArgs, DOCUMENT_BODY_MAX_LENGTH, DOCUMENT_DESCRIPTION_MAX_LENGTH, DOCUMENT_NAME_MAX_LENGTH, DOCUMENT_SAVE_DELAY_MS, type DocsHostPorts, type DocsSupabase, type DocumentAwareness, type DocumentBodyPort, type DocumentBodyWriteHandler, type DocumentCollabBase, type DocumentCollabFactory, type DocumentCollabHandle, DocumentModel, type DocumentModelDeps, type DocumentOtFactory, type DocumentOtHandle, type DocumentSnapshotData, type DocumentViewPort, EMOJI_GROUPS, type Glyph, MIN_FIT_ZOOM, type ParkedDocumentEditor, type PublishedCaret, type RemoteCaret, RemoteCaretBook, SPECIAL_GROUPS, type SaveDocumentSnapshotArgs, addCommentAnchorActions, anchorIdOfPartAnchor, bodyTextOf, commentAnchorPartKey, commentAnchorsOf, commentPartAnchor, configureDocsHost, copyDocument, createDocument, deleteDocument, discardFailedDocument, documentBodyWriteHandler, documentSourceLabel, fitZoomRatio, getDocsHost, getDocument, getLatestDocumentSnapshot, listAccessibleDocuments, listDocumentSnapshots, listTrashedDocuments, moveDocument, movePeerRangesThroughBodyEdit, moveRangesThroughBodyEdit, newCommentAnchorId, planBodyEdit, publishedCaretFromSelection, removeCommentAnchorActions, renameDocument, restoreDocument, sanitizeUniverDocSnapshot, saveDocumentSnapshot, searchSymbols, updateDocumentDescription, validateDocumentBody, validateDocumentDescription, validateDocumentName, writeBodyText };
+export { type BodyEdit, type BodyText, CARET_HEARTBEAT_MS, CARET_MAX_RANGES, CARET_STALE_MS, COMMENT_ANCHOR_LABEL_MAX, COMMENT_ANCHOR_PART_PREFIX, COMMENT_ANCHOR_RANGE_TYPE, type CaretRange, type CommentAnchorSpan, type CreateDocumentArgs, DOCUMENT_BODY_MAX_LENGTH, DOCUMENT_DESCRIPTION_MAX_LENGTH, DOCUMENT_NAME_MAX_LENGTH, DOCUMENT_SAVE_DELAY_MS, type DocsHostPorts, type DocsSupabase, type DocumentAwareness, type DocumentBodyPort, type DocumentBodyWriteHandler, type DocumentCollabBase, type DocumentCollabFactory, type DocumentCollabHandle, DocumentModel, type DocumentModelDeps, type DocumentOtFactory, type DocumentOtHandle, type DocumentSnapshotData, type DocumentViewPort, EMOJI_GROUPS, type Glyph, MIN_FIT_ZOOM, type ParkedDocumentEditor, type PublishedCaret, type RemoteCaret, RemoteCaretBook, SPECIAL_GROUPS, type SaveDocumentSnapshotArgs, addCommentAnchorActions, anchorIdOfPartAnchor, bodyTextOf, commentAnchorPartKey, commentAnchorsOf, commentPartAnchor, configureDocsHost, copyDocument, createDocument, deleteDocument, discardFailedDocument, documentBodyWriteHandler, documentSourceLabel, fitZoomRatio, getDocsHost, getDocument, getLatestDocumentSnapshot, isDocsAnchorOnlyOp, listAccessibleDocuments, listDocumentSnapshots, listTrashedDocuments, moveDocument, movePeerRangesThroughBodyEdit, moveRangesThroughBodyEdit, newCommentAnchorId, planBodyEdit, publishedCaretFromSelection, quoteOfCommentAnchor, removeCommentAnchorActions, renameDocument, restoreDocument, sanitizeUniverDocSnapshot, saveDocumentSnapshot, searchSymbols, updateDocumentDescription, validateDocumentBody, validateDocumentDescription, validateDocumentName, writeBodyText };

package/dist/docs.js

@@ -979,11 +979,17 @@ function commentAnchorPartKey(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 } : {} };
@@ -1022,6 +1028,32 @@ function removeCommentAnchorActions(documentDataModel, anchorId) {
   if (!textX) return null;
   return 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;
+}
 export {
   CARET_HEARTBEAT_MS,
   CARET_MAX_RANGES,
@@ -1055,6 +1087,7 @@ export {
   getDocsHost,
   getDocument,
   getLatestDocumentSnapshot,
+  isDocsAnchorOnlyOp,
   listAccessibleDocuments,
   listDocumentSnapshots,
   listTrashedDocuments,
@@ -1064,6 +1097,7 @@ export {
   newCommentAnchorId,
   planBodyEdit,
   publishedCaretFromSelection,
+  quoteOfCommentAnchor,
   removeCommentAnchorActions,
   renameDocument,
   restoreDocument,