@ai-matrx/office 0.8.25 → 0.8.27

package/dist/docs.d.ts

@@ -25,6 +25,14 @@ interface DocsHostPorts {
         method: "POST";
         body: FormData;
     }): Promise<Response>;
+    /**
+     * The record's CURRENT content, including what people are typing in a live co-editing room and have not saved
+     * (the app folds the room; the package owns no server). Optional: a host without co-editing leaves it out and
+     * a copy takes the newest saved snapshot. It may throw; the copy then fails with its message, never silently.
+     */
+    readCurrentSnapshot?(documentId: string): Promise<{
+        snapshot: unknown | null;
+    }>;
 }
 declare function configureDocsHost(ports: DocsHostPorts): void;
 declare function getDocsHost(): DocsHostPorts;
@@ -145,7 +153,7 @@ type SaveDocumentSnapshotArgs = {
 };
 declare function saveDocumentSnapshot(args: SaveDocumentSnapshotArgs): Promise<ServiceResult<DocumentSnapshot>>;
 /**
- * An independent copy of a document: its own row, with the latest snapshot copied over, so editing the copy never
+ * An independent copy of a document: its own row, with the CURRENT content copied over (the live room when people are co-editing), so editing the copy never
  * touches the original. The copy lives in the original's organization and project. Used by a board-template use.
  */
 declare function copyDocument(documentId: string, name?: string): Promise<ServiceResult<DocumentRow>>;
@@ -808,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";
@@ -835,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

@@ -16,7 +16,7 @@ import {
   sanitizeUniverDocSnapshot,
   saveDocumentSnapshot,
   updateDocumentDescription
-} from "./chunk-TRA2BTPL.js";
+} from "./chunk-CAWDEHVL.js";
 import {
   looksLikeMarkdown
 } from "./chunk-DY5TGHBI.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,