@ai-matrx/office 0.8.13 → 0.8.14

package/dist/docs.d.cts

@@ -240,10 +240,19 @@ interface DocsOtPort {
     }> | null;
 }
 
+declare const CARET_HEARTBEAT_MS = 2000;
+declare const CARET_STALE_MS = 12000;
+/** Most ranges one seat publishes (a multi-range selection is rare; the rest is dropped, never the first). */
+declare const CARET_MAX_RANGES = 4;
 interface CaretRange {
     start: number;
     end: number;
 }
+/** The `caret` field of a seat's awareness state. */
+interface PublishedCaret {
+    ranges: CaretRange[];
+    at: number;
+}
 /** One other seat's caret, ready to draw. */
 interface RemoteCaret {
     /** The seat (Yjs client id as a string): two tabs of one person are two carets. */
@@ -253,6 +262,25 @@ interface RemoteCaret {
     color: string;
     ranges: CaretRange[];
 }
+type SelectionRange = {
+    startOffset: number;
+    endOffset: number;
+    segmentId?: string;
+};
+/** What a seat publishes for its selection, or null when there is nothing to show (header/footer, no selection). */
+declare function publishedCaretFromSelection(sel: SelectionRange[] | null | undefined, now: number): PublishedCaret | null;
+declare class RemoteCaretBook {
+    private readonly selfClientId;
+    private readonly now;
+    private readonly carets;
+    constructor(selfClientId: number, now?: () => number);
+    /** Take the room's awareness states: new or republished carets replace ours, seats that left are dropped. Returns whether anything changed. */
+    ingest(states: Map<number, unknown>): boolean;
+    /** Move every caret through one body edit that was just applied (`actions` of a rich-text mutation). Returns whether any moved. */
+    shiftThrough(actions: unknown): boolean;
+    /** The carets to draw now (stale ones left out). */
+    list(): RemoteCaret[];
+}
 
 /**
  * THE DOCUMENT MODEL — the engine of one cloud document per tab.
@@ -746,4 +774,4 @@ declare function documentBodyWriteHandler(deps: {
     assertWritable: (whatItBlocks: string) => void;
 }): DocumentBodyWriteHandler;
 
-export { type BodyEdit, type BodyText, 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, SPECIAL_GROUPS, type SaveDocumentSnapshotArgs, bodyTextOf, configureDocsHost, copyDocument, createDocument, deleteDocument, discardFailedDocument, documentBodyWriteHandler, documentSourceLabel, fitZoomRatio, getDocsHost, getDocument, getLatestDocumentSnapshot, listAccessibleDocuments, listDocumentSnapshots, listTrashedDocuments, moveDocument, moveRangesThroughBodyEdit, planBodyEdit, renameDocument, restoreDocument, sanitizeUniverDocSnapshot, saveDocumentSnapshot, searchSymbols, updateDocumentDescription, validateDocumentBody, validateDocumentDescription, validateDocumentName, writeBodyText };
+export { type BodyEdit, type BodyText, CARET_HEARTBEAT_MS, CARET_MAX_RANGES, CARET_STALE_MS, type CaretRange, 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, bodyTextOf, configureDocsHost, copyDocument, createDocument, deleteDocument, discardFailedDocument, documentBodyWriteHandler, documentSourceLabel, fitZoomRatio, getDocsHost, getDocument, getLatestDocumentSnapshot, listAccessibleDocuments, listDocumentSnapshots, listTrashedDocuments, moveDocument, moveRangesThroughBodyEdit, planBodyEdit, publishedCaretFromSelection, renameDocument, restoreDocument, sanitizeUniverDocSnapshot, saveDocumentSnapshot, searchSymbols, updateDocumentDescription, validateDocumentBody, validateDocumentDescription, validateDocumentName, writeBodyText };

package/dist/docs.d.ts

@@ -240,10 +240,19 @@ interface DocsOtPort {
     }> | null;
 }
 
+declare const CARET_HEARTBEAT_MS = 2000;
+declare const CARET_STALE_MS = 12000;
+/** Most ranges one seat publishes (a multi-range selection is rare; the rest is dropped, never the first). */
+declare const CARET_MAX_RANGES = 4;
 interface CaretRange {
     start: number;
     end: number;
 }
+/** The `caret` field of a seat's awareness state. */
+interface PublishedCaret {
+    ranges: CaretRange[];
+    at: number;
+}
 /** One other seat's caret, ready to draw. */
 interface RemoteCaret {
     /** The seat (Yjs client id as a string): two tabs of one person are two carets. */
@@ -253,6 +262,25 @@ interface RemoteCaret {
     color: string;
     ranges: CaretRange[];
 }
+type SelectionRange = {
+    startOffset: number;
+    endOffset: number;
+    segmentId?: string;
+};
+/** What a seat publishes for its selection, or null when there is nothing to show (header/footer, no selection). */
+declare function publishedCaretFromSelection(sel: SelectionRange[] | null | undefined, now: number): PublishedCaret | null;
+declare class RemoteCaretBook {
+    private readonly selfClientId;
+    private readonly now;
+    private readonly carets;
+    constructor(selfClientId: number, now?: () => number);
+    /** Take the room's awareness states: new or republished carets replace ours, seats that left are dropped. Returns whether anything changed. */
+    ingest(states: Map<number, unknown>): boolean;
+    /** Move every caret through one body edit that was just applied (`actions` of a rich-text mutation). Returns whether any moved. */
+    shiftThrough(actions: unknown): boolean;
+    /** The carets to draw now (stale ones left out). */
+    list(): RemoteCaret[];
+}
 
 /**
  * THE DOCUMENT MODEL — the engine of one cloud document per tab.
@@ -746,4 +774,4 @@ declare function documentBodyWriteHandler(deps: {
     assertWritable: (whatItBlocks: string) => void;
 }): DocumentBodyWriteHandler;
 
-export { type BodyEdit, type BodyText, 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, SPECIAL_GROUPS, type SaveDocumentSnapshotArgs, bodyTextOf, configureDocsHost, copyDocument, createDocument, deleteDocument, discardFailedDocument, documentBodyWriteHandler, documentSourceLabel, fitZoomRatio, getDocsHost, getDocument, getLatestDocumentSnapshot, listAccessibleDocuments, listDocumentSnapshots, listTrashedDocuments, moveDocument, moveRangesThroughBodyEdit, planBodyEdit, renameDocument, restoreDocument, sanitizeUniverDocSnapshot, saveDocumentSnapshot, searchSymbols, updateDocumentDescription, validateDocumentBody, validateDocumentDescription, validateDocumentName, writeBodyText };
+export { type BodyEdit, type BodyText, CARET_HEARTBEAT_MS, CARET_MAX_RANGES, CARET_STALE_MS, type CaretRange, 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, bodyTextOf, configureDocsHost, copyDocument, createDocument, deleteDocument, discardFailedDocument, documentBodyWriteHandler, documentSourceLabel, fitZoomRatio, getDocsHost, getDocument, getLatestDocumentSnapshot, listAccessibleDocuments, listDocumentSnapshots, listTrashedDocuments, moveDocument, moveRangesThroughBodyEdit, planBodyEdit, publishedCaretFromSelection, renameDocument, restoreDocument, sanitizeUniverDocSnapshot, saveDocumentSnapshot, searchSymbols, updateDocumentDescription, validateDocumentBody, validateDocumentDescription, validateDocumentName, writeBodyText };

package/dist/docs.js

@@ -863,7 +863,94 @@ function documentBodyWriteHandler(deps) {
     }
   };
 }
+
+// src/docs/remote-carets.ts
+var CARET_HEARTBEAT_MS = 2e3;
+var CARET_STALE_MS = 12e3;
+var CARET_MAX_RANGES = 4;
+function publishedCaretFromSelection(sel, now) {
+  if (!sel || sel.length === 0) return null;
+  if (sel.some((r) => r.segmentId)) return null;
+  const ranges = sel.slice(0, CARET_MAX_RANGES).map((r) => ({ start: Math.min(r.startOffset, r.endOffset), end: Math.max(r.startOffset, r.endOffset) }));
+  return { ranges, at: now };
+}
+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 = raw?.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 = r?.start;
+    const e2 = r?.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 });
+  }
+  return ranges.length ? { ranges, at: c.at } : null;
+}
+var RemoteCaretBook = class {
+  constructor(selfClientId, now = Date.now) {
+    this.selfClientId = selfClientId;
+    this.now = now;
+  }
+  selfClientId;
+  now;
+  carets = /* @__PURE__ */ new Map();
+  /** Take the room's awareness states: new or republished carets replace ours, seats that left are dropped. Returns whether anything changed. */
+  ingest(states) {
+    let changed = false;
+    const seen = /* @__PURE__ */ new Set();
+    states.forEach((raw, id) => {
+      if (id === this.selfClientId) return;
+      const s2 = raw;
+      const caret = readCaret(raw);
+      if (!s2 || typeof s2.uid !== "string" || !caret) return;
+      const key = String(id);
+      seen.add(key);
+      const prev = this.carets.get(key);
+      const name = typeof s2.name === "string" && s2.name ? s2.name : "Someone";
+      const color = typeof s2.color === "string" && s2.color ? s2.color : "#3b82f6";
+      if (prev && prev.at === caret.at && prev.name === name && prev.color === color) return;
+      this.carets.set(key, { key, uid: s2.uid, name, color, ranges: caret.ranges, at: caret.at, seenAt: this.now() });
+      changed = true;
+    });
+    for (const key of [...this.carets.keys()]) {
+      if (!seen.has(key)) {
+        this.carets.delete(key);
+        changed = true;
+      }
+    }
+    return changed;
+  }
+  /** Move every caret through one body edit that was just applied (`actions` of a rich-text mutation). Returns whether any moved. */
+  shiftThrough(actions) {
+    let moved = false;
+    for (const c of this.carets.values()) {
+      const next = moveRangesThroughBodyEdit(c.ranges.map((r) => ({ startOffset: r.start, endOffset: r.end })), actions);
+      if (!next) return false;
+      const ranges = next.map((r) => ({ start: r.startOffset, end: r.endOffset }));
+      if (!sameRanges(ranges, c.ranges)) {
+        c.ranges = ranges;
+        moved = true;
+      }
+    }
+    return moved;
+  }
+  /** The carets to draw now (stale ones left out). */
+  list() {
+    const t = this.now();
+    const out = [];
+    for (const c of this.carets.values()) {
+      if (t - c.seenAt > CARET_STALE_MS) continue;
+      out.push({ key: c.key, uid: c.uid, name: c.name, color: c.color, ranges: c.ranges.map((r) => ({ ...r })) });
+    }
+    out.sort((a, b) => a.key.localeCompare(b.key));
+    return out;
+  }
+};
 export {
+  CARET_HEARTBEAT_MS,
+  CARET_MAX_RANGES,
+  CARET_STALE_MS,
   DOCUMENT_BODY_MAX_LENGTH,
   DOCUMENT_DESCRIPTION_MAX_LENGTH,
   DOCUMENT_NAME_MAX_LENGTH,
@@ -871,6 +958,7 @@ export {
   DocumentModel,
   EMOJI_GROUPS,
   MIN_FIT_ZOOM,
+  RemoteCaretBook,
   SPECIAL_GROUPS,
   bodyTextOf,
   configureDocsHost,
@@ -890,6 +978,7 @@ export {
   moveDocument,
   moveRangesThroughBodyEdit,
   planBodyEdit,
+  publishedCaretFromSelection,
   renameDocument,
   restoreDocument,
   sanitizeUniverDocSnapshot,