@ai-matrx/office 0.8.25 → 0.8.26

package/dist/docs-io.js

@@ -4,7 +4,7 @@ import {
   getDocsHost,
   sanitizeUniverDocSnapshot,
   saveDocumentSnapshot
-} from "./chunk-TRA2BTPL.js";
+} from "./chunk-CAWDEHVL.js";
 import {
   deriveDocumentName,
   markdownToUniverDoc

package/dist/docs.cjs

@@ -16,7 +16,7 @@
 
 
 
-var _chunkJMVPAJJAcjs = require('./chunk-JMVPAJJA.cjs');
+var _chunkLHTG72LScjs = require('./chunk-LHTG72LS.cjs');
 
 
 var _chunkNSU6EVJKcjs = require('./chunk-NSU6EVJK.cjs');
@@ -1075,5 +1075,5 @@ function removeCommentAnchorActions(documentDataModel, anchorId) {
 
 
 
-exports.CARET_HEARTBEAT_MS = CARET_HEARTBEAT_MS; exports.CARET_MAX_RANGES = CARET_MAX_RANGES; exports.CARET_STALE_MS = CARET_STALE_MS; exports.COMMENT_ANCHOR_LABEL_MAX = COMMENT_ANCHOR_LABEL_MAX; exports.COMMENT_ANCHOR_PART_PREFIX = COMMENT_ANCHOR_PART_PREFIX; exports.COMMENT_ANCHOR_RANGE_TYPE = COMMENT_ANCHOR_RANGE_TYPE; exports.DOCUMENT_BODY_MAX_LENGTH = DOCUMENT_BODY_MAX_LENGTH; exports.DOCUMENT_DESCRIPTION_MAX_LENGTH = DOCUMENT_DESCRIPTION_MAX_LENGTH; exports.DOCUMENT_NAME_MAX_LENGTH = DOCUMENT_NAME_MAX_LENGTH; exports.DOCUMENT_SAVE_DELAY_MS = DOCUMENT_SAVE_DELAY_MS; exports.DocumentModel = DocumentModel; exports.EMOJI_GROUPS = EMOJI_GROUPS; exports.MIN_FIT_ZOOM = MIN_FIT_ZOOM; exports.RemoteCaretBook = RemoteCaretBook; exports.SPECIAL_GROUPS = SPECIAL_GROUPS; exports.addCommentAnchorActions = addCommentAnchorActions; exports.anchorIdOfPartAnchor = anchorIdOfPartAnchor; exports.bodyTextOf = bodyTextOf; exports.commentAnchorPartKey = commentAnchorPartKey; exports.commentAnchorsOf = commentAnchorsOf; exports.commentPartAnchor = commentPartAnchor; exports.configureDocsHost = _chunkJMVPAJJAcjs.configureDocsHost; exports.copyDocument = _chunkJMVPAJJAcjs.copyDocument; exports.createDocument = _chunkJMVPAJJAcjs.createDocument; exports.deleteDocument = _chunkJMVPAJJAcjs.deleteDocument; exports.discardFailedDocument = _chunkJMVPAJJAcjs.discardFailedDocument; exports.documentBodyWriteHandler = documentBodyWriteHandler; exports.documentSourceLabel = documentSourceLabel; exports.fitZoomRatio = fitZoomRatio; exports.getDocsHost = _chunkJMVPAJJAcjs.getDocsHost; exports.getDocument = _chunkJMVPAJJAcjs.getDocument; exports.getLatestDocumentSnapshot = _chunkJMVPAJJAcjs.getLatestDocumentSnapshot; exports.listAccessibleDocuments = _chunkJMVPAJJAcjs.listAccessibleDocuments; exports.listDocumentSnapshots = _chunkJMVPAJJAcjs.listDocumentSnapshots; exports.listTrashedDocuments = _chunkJMVPAJJAcjs.listTrashedDocuments; exports.moveDocument = _chunkJMVPAJJAcjs.moveDocument; exports.movePeerRangesThroughBodyEdit = movePeerRangesThroughBodyEdit; exports.moveRangesThroughBodyEdit = moveRangesThroughBodyEdit; exports.newCommentAnchorId = newCommentAnchorId; exports.planBodyEdit = planBodyEdit; exports.publishedCaretFromSelection = publishedCaretFromSelection; exports.removeCommentAnchorActions = removeCommentAnchorActions; exports.renameDocument = _chunkJMVPAJJAcjs.renameDocument; exports.restoreDocument = _chunkJMVPAJJAcjs.restoreDocument; exports.sanitizeUniverDocSnapshot = _chunkJMVPAJJAcjs.sanitizeUniverDocSnapshot; exports.saveDocumentSnapshot = _chunkJMVPAJJAcjs.saveDocumentSnapshot; exports.searchSymbols = searchSymbols; exports.updateDocumentDescription = _chunkJMVPAJJAcjs.updateDocumentDescription; exports.validateDocumentBody = validateDocumentBody; exports.validateDocumentDescription = validateDocumentDescription; exports.validateDocumentName = validateDocumentName; exports.writeBodyText = writeBodyText;
+exports.CARET_HEARTBEAT_MS = CARET_HEARTBEAT_MS; exports.CARET_MAX_RANGES = CARET_MAX_RANGES; exports.CARET_STALE_MS = CARET_STALE_MS; exports.COMMENT_ANCHOR_LABEL_MAX = COMMENT_ANCHOR_LABEL_MAX; exports.COMMENT_ANCHOR_PART_PREFIX = COMMENT_ANCHOR_PART_PREFIX; exports.COMMENT_ANCHOR_RANGE_TYPE = COMMENT_ANCHOR_RANGE_TYPE; exports.DOCUMENT_BODY_MAX_LENGTH = DOCUMENT_BODY_MAX_LENGTH; exports.DOCUMENT_DESCRIPTION_MAX_LENGTH = DOCUMENT_DESCRIPTION_MAX_LENGTH; exports.DOCUMENT_NAME_MAX_LENGTH = DOCUMENT_NAME_MAX_LENGTH; exports.DOCUMENT_SAVE_DELAY_MS = DOCUMENT_SAVE_DELAY_MS; exports.DocumentModel = DocumentModel; exports.EMOJI_GROUPS = EMOJI_GROUPS; exports.MIN_FIT_ZOOM = MIN_FIT_ZOOM; exports.RemoteCaretBook = RemoteCaretBook; exports.SPECIAL_GROUPS = SPECIAL_GROUPS; exports.addCommentAnchorActions = addCommentAnchorActions; exports.anchorIdOfPartAnchor = anchorIdOfPartAnchor; exports.bodyTextOf = bodyTextOf; exports.commentAnchorPartKey = commentAnchorPartKey; exports.commentAnchorsOf = commentAnchorsOf; exports.commentPartAnchor = commentPartAnchor; exports.configureDocsHost = _chunkLHTG72LScjs.configureDocsHost; exports.copyDocument = _chunkLHTG72LScjs.copyDocument; exports.createDocument = _chunkLHTG72LScjs.createDocument; exports.deleteDocument = _chunkLHTG72LScjs.deleteDocument; exports.discardFailedDocument = _chunkLHTG72LScjs.discardFailedDocument; exports.documentBodyWriteHandler = documentBodyWriteHandler; exports.documentSourceLabel = documentSourceLabel; exports.fitZoomRatio = fitZoomRatio; exports.getDocsHost = _chunkLHTG72LScjs.getDocsHost; exports.getDocument = _chunkLHTG72LScjs.getDocument; exports.getLatestDocumentSnapshot = _chunkLHTG72LScjs.getLatestDocumentSnapshot; exports.listAccessibleDocuments = _chunkLHTG72LScjs.listAccessibleDocuments; exports.listDocumentSnapshots = _chunkLHTG72LScjs.listDocumentSnapshots; exports.listTrashedDocuments = _chunkLHTG72LScjs.listTrashedDocuments; exports.moveDocument = _chunkLHTG72LScjs.moveDocument; exports.movePeerRangesThroughBodyEdit = movePeerRangesThroughBodyEdit; exports.moveRangesThroughBodyEdit = moveRangesThroughBodyEdit; exports.newCommentAnchorId = newCommentAnchorId; exports.planBodyEdit = planBodyEdit; exports.publishedCaretFromSelection = publishedCaretFromSelection; exports.removeCommentAnchorActions = removeCommentAnchorActions; exports.renameDocument = _chunkLHTG72LScjs.renameDocument; exports.restoreDocument = _chunkLHTG72LScjs.restoreDocument; exports.sanitizeUniverDocSnapshot = _chunkLHTG72LScjs.sanitizeUniverDocSnapshot; exports.saveDocumentSnapshot = _chunkLHTG72LScjs.saveDocumentSnapshot; exports.searchSymbols = searchSymbols; exports.updateDocumentDescription = _chunkLHTG72LScjs.updateDocumentDescription; exports.validateDocumentBody = validateDocumentBody; exports.validateDocumentDescription = validateDocumentDescription; exports.validateDocumentName = validateDocumentName; exports.writeBodyText = writeBodyText;
 //# sourceMappingURL=docs.cjs.map

package/dist/docs.d.cts

@@ -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>>;

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>>;

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";

package/dist/sheets-xlsx.cjs

@@ -3,7 +3,7 @@
 
 
 
-var _chunkZDZCCOUBcjs = require('./chunk-ZDZCCOUB.cjs');
+var _chunkIJNET5TTcjs = require('./chunk-IJNET5TT.cjs');
 
 
 
@@ -455,7 +455,7 @@ function unsupportedFileReason(file) {
   return `"${file.name}" isn't a spreadsheet file. Supported: .xlsx, .xls, .csv. For a Google Sheet, use Import from Google Sheets.`;
 }
 async function importWorkbookFile(file, organizationId) {
-  const capturedOrganizationId = await _chunkZDZCCOUBcjs.getSheetsHost.call(void 0, ).ensureOrgId(organizationId);
+  const capturedOrganizationId = await _chunkIJNET5TTcjs.getSheetsHost.call(void 0, ).ensureOrgId(organizationId);
   const { xlsxToUniverWorkbook: xlsxToUniverWorkbook2 } = await Promise.resolve().then(() => _interopRequireWildcard(require("./xlsx-to-univer-NWCHAWJC.cjs")));
   const droppedOnImport = [];
   const { uploadImportedImage } = await Promise.resolve().then(() => _interopRequireWildcard(require("./matrxImagePorts-46SGQTLN.cjs")));
@@ -465,7 +465,7 @@ async function importWorkbookFile(file, organizationId) {
   });
   let originalFileId;
   try {
-    const uploaded = await _chunkZDZCCOUBcjs.getSheetsHost.call(void 0, ).uploadOriginalFile(file, { folderPath: "Workbooks/Imports" });
+    const uploaded = await _chunkIJNET5TTcjs.getSheetsHost.call(void 0, ).uploadOriginalFile(file, { folderPath: "Workbooks/Imports" });
     originalFileId = uploaded.fileId;
   } catch (uploadErr) {
     console.warn(
@@ -474,7 +474,7 @@ async function importWorkbookFile(file, organizationId) {
     );
   }
   const cleanName = file.name.replace(/\.[^.]+$/, "") || "Imported workbook";
-  const created = await _chunkZDZCCOUBcjs.createWorkbook.call(void 0, {
+  const created = await _chunkIJNET5TTcjs.createWorkbook.call(void 0, {
     name: cleanName,
     description: `Imported from ${file.name}`,
     source: file.name.toLowerCase().endsWith(".csv") ? "imported_csv" : "imported_xlsx",
@@ -482,14 +482,14 @@ async function importWorkbookFile(file, organizationId) {
     ...originalFileId ? { originalFileId } : {}
   });
   if (_core.isServiceFailure.call(void 0, created)) throw new Error(created.error);
-  const saved = await _chunkZDZCCOUBcjs.saveSnapshot.call(void 0, {
+  const saved = await _chunkIJNET5TTcjs.saveSnapshot.call(void 0, {
     workbookId: created.data.id,
     snapshot,
     origin: "imported",
     label: file.name
   });
   if (_core.isServiceFailure.call(void 0, saved)) {
-    await _chunkZDZCCOUBcjs.discardFailedWorkbook.call(void 0, created.data.id);
+    await _chunkIJNET5TTcjs.discardFailedWorkbook.call(void 0, created.data.id);
     throw new Error(saved.error);
   }
   return { id: created.data.id, name: cleanName, notCarried: droppedOnImport };

package/dist/sheets-xlsx.js

@@ -3,7 +3,7 @@ import {
   discardFailedWorkbook,
   getSheetsHost,
   saveSnapshot
-} from "./chunk-WKBWRG7N.js";
+} from "./chunk-RREOARR4.js";
 import {
   H_ALIGN_IN,
   H_ALIGN_OUT,

package/dist/sheets.cjs

@@ -16,7 +16,7 @@
 
 
 
-var _chunkZDZCCOUBcjs = require('./chunk-ZDZCCOUB.cjs');
+var _chunkIJNET5TTcjs = require('./chunk-IJNET5TT.cjs');
 
 // src/sheets/univer-snapshot-rows.ts
 function univerSheetIds(snapshot) {
@@ -658,7 +658,7 @@ function planSheetPrint(rows, setup, frozen = { rows: 0, cols: 0 }) {
 
 // src/sheets/sheet-page-setup-service.ts
 var _db = require('@ai-matrx/data/db');
-var db = () => _chunkZDZCCOUBcjs.getSheetsHost.call(void 0, ).getSupabase();
+var db = () => _chunkIJNET5TTcjs.getSheetsHost.call(void 0, ).getSupabase();
 async function readSheetPageSetup(workbookId) {
   const { data, error } = await db().schema("workbench").from("udt_workbooks").select("metadata").eq("id", workbookId).maybeSingle();
   if (error) return { ok: false, error: error.message };
@@ -917,5 +917,5 @@ function readWorkbookScopeSource(workbookId) {
 
 
 
-exports.DEFAULT_SHEET_PAGE_SETUP = DEFAULT_SHEET_PAGE_SETUP; exports.GRID_MAX_COLUMNS = GRID_MAX_COLUMNS; exports.GRID_MAX_ROWS = GRID_MAX_ROWS; exports.MARGIN_PRESET_INCHES = MARGIN_PRESET_INCHES; exports.PRINT_ROW_HEIGHT = PRINT_ROW_HEIGHT; exports.SHEET_MARGIN_PRESETS = SHEET_MARGIN_PRESETS; exports.SHEET_PRINT_SCOPES = SHEET_PRINT_SCOPES; exports.SHEET_SCALES = SHEET_SCALES; exports.THUMB_HEIGHT = THUMB_HEIGHT; exports.THUMB_WIDTH = THUMB_WIDTH; exports.buildSheetPrintDocument = buildSheetPrintDocument; exports.cfMatch = cfMatch; exports.collectPrintSheets = collectPrintSheets; exports.configureSheetsHost = _chunkZDZCCOUBcjs.configureSheetsHost; exports.copyWorkbook = _chunkZDZCCOUBcjs.copyWorkbook; exports.createWorkbook = _chunkZDZCCOUBcjs.createWorkbook; exports.deleteWorkbook = _chunkZDZCCOUBcjs.deleteWorkbook; exports.discardFailedWorkbook = _chunkZDZCCOUBcjs.discardFailedWorkbook; exports.documentPreviewSvg = documentPreviewSvg; exports.downloadSheetAsCsv = downloadSheetAsCsv; exports.downloadSheetAsHtml = downloadSheetAsHtml; exports.downloadSheetAsPdf = downloadSheetAsPdf; exports.downloadSheetAsTsv = downloadSheetAsTsv; exports.formatCellValue = formatCellValue; exports.getLatestSnapshot = _chunkZDZCCOUBcjs.getLatestSnapshot; exports.getSheetsHost = _chunkZDZCCOUBcjs.getSheetsHost; exports.getWorkbook = _chunkZDZCCOUBcjs.getWorkbook; exports.listAccessibleWorkbooks = _chunkZDZCCOUBcjs.listAccessibleWorkbooks; exports.listSnapshots = _chunkZDZCCOUBcjs.listSnapshots; exports.listTrashedWorkbooks = _chunkZDZCCOUBcjs.listTrashedWorkbooks; exports.moveWorkbook = _chunkZDZCCOUBcjs.moveWorkbook; exports.normalizeSheetPageSetup = normalizeSheetPageSetup; exports.pageSetupFromMetadata = pageSetupFromMetadata; exports.parseResource = parseResource; exports.planSheetPrint = planSheetPrint; exports.printColumnWidths = printColumnWidths; exports.printDocumentHtml = printDocumentHtml; exports.printGeometry = printGeometry; exports.printSheet = printSheet; exports.readSheetPageSetup = readSheetPageSetup; exports.readWorkbookScopeSource = readWorkbookScopeSource; exports.registerWorkbookScopeSource = registerWorkbookScopeSource; exports.renameWorkbook = _chunkZDZCCOUBcjs.renameWorkbook; exports.restoreWorkbook = _chunkZDZCCOUBcjs.restoreWorkbook; exports.saveSnapshot = _chunkZDZCCOUBcjs.saveSnapshot; exports.sheetGridToCsv = sheetGridToCsv; exports.sheetGridToMarkdownTable = sheetGridToMarkdownTable; exports.snapshotPreviewSvg = snapshotPreviewSvg; exports.snapshotToGridSheets = snapshotToGridSheets; exports.univerSheetIds = univerSheetIds; exports.univerSnapshotToRows = univerSnapshotToRows; exports.updateWorkbookDescription = _chunkZDZCCOUBcjs.updateWorkbookDescription; exports.workbookPreviewSvg = workbookPreviewSvg; exports.workbookSourceLabel = _chunkZDZCCOUBcjs.workbookSourceLabel; exports.writeSheetPageSetup = writeSheetPageSetup;
+exports.DEFAULT_SHEET_PAGE_SETUP = DEFAULT_SHEET_PAGE_SETUP; exports.GRID_MAX_COLUMNS = GRID_MAX_COLUMNS; exports.GRID_MAX_ROWS = GRID_MAX_ROWS; exports.MARGIN_PRESET_INCHES = MARGIN_PRESET_INCHES; exports.PRINT_ROW_HEIGHT = PRINT_ROW_HEIGHT; exports.SHEET_MARGIN_PRESETS = SHEET_MARGIN_PRESETS; exports.SHEET_PRINT_SCOPES = SHEET_PRINT_SCOPES; exports.SHEET_SCALES = SHEET_SCALES; exports.THUMB_HEIGHT = THUMB_HEIGHT; exports.THUMB_WIDTH = THUMB_WIDTH; exports.buildSheetPrintDocument = buildSheetPrintDocument; exports.cfMatch = cfMatch; exports.collectPrintSheets = collectPrintSheets; exports.configureSheetsHost = _chunkIJNET5TTcjs.configureSheetsHost; exports.copyWorkbook = _chunkIJNET5TTcjs.copyWorkbook; exports.createWorkbook = _chunkIJNET5TTcjs.createWorkbook; exports.deleteWorkbook = _chunkIJNET5TTcjs.deleteWorkbook; exports.discardFailedWorkbook = _chunkIJNET5TTcjs.discardFailedWorkbook; exports.documentPreviewSvg = documentPreviewSvg; exports.downloadSheetAsCsv = downloadSheetAsCsv; exports.downloadSheetAsHtml = downloadSheetAsHtml; exports.downloadSheetAsPdf = downloadSheetAsPdf; exports.downloadSheetAsTsv = downloadSheetAsTsv; exports.formatCellValue = formatCellValue; exports.getLatestSnapshot = _chunkIJNET5TTcjs.getLatestSnapshot; exports.getSheetsHost = _chunkIJNET5TTcjs.getSheetsHost; exports.getWorkbook = _chunkIJNET5TTcjs.getWorkbook; exports.listAccessibleWorkbooks = _chunkIJNET5TTcjs.listAccessibleWorkbooks; exports.listSnapshots = _chunkIJNET5TTcjs.listSnapshots; exports.listTrashedWorkbooks = _chunkIJNET5TTcjs.listTrashedWorkbooks; exports.moveWorkbook = _chunkIJNET5TTcjs.moveWorkbook; exports.normalizeSheetPageSetup = normalizeSheetPageSetup; exports.pageSetupFromMetadata = pageSetupFromMetadata; exports.parseResource = parseResource; exports.planSheetPrint = planSheetPrint; exports.printColumnWidths = printColumnWidths; exports.printDocumentHtml = printDocumentHtml; exports.printGeometry = printGeometry; exports.printSheet = printSheet; exports.readSheetPageSetup = readSheetPageSetup; exports.readWorkbookScopeSource = readWorkbookScopeSource; exports.registerWorkbookScopeSource = registerWorkbookScopeSource; exports.renameWorkbook = _chunkIJNET5TTcjs.renameWorkbook; exports.restoreWorkbook = _chunkIJNET5TTcjs.restoreWorkbook; exports.saveSnapshot = _chunkIJNET5TTcjs.saveSnapshot; exports.sheetGridToCsv = sheetGridToCsv; exports.sheetGridToMarkdownTable = sheetGridToMarkdownTable; exports.snapshotPreviewSvg = snapshotPreviewSvg; exports.snapshotToGridSheets = snapshotToGridSheets; exports.univerSheetIds = univerSheetIds; exports.univerSnapshotToRows = univerSnapshotToRows; exports.updateWorkbookDescription = _chunkIJNET5TTcjs.updateWorkbookDescription; exports.workbookPreviewSvg = workbookPreviewSvg; exports.workbookSourceLabel = _chunkIJNET5TTcjs.workbookSourceLabel; exports.writeSheetPageSetup = writeSheetPageSetup;
 //# sourceMappingURL=sheets.cjs.map

package/dist/sheets.d.cts

@@ -25,6 +25,14 @@ interface SheetsHostPorts {
     }): Promise<{
         fileId: string;
     }>;
+    /**
+     * 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?(workbookId: string): Promise<{
+        snapshot: unknown | null;
+    }>;
 }
 declare function configureSheetsHost(ports: SheetsHostPorts): void;
 declare function getSheetsHost(): SheetsHostPorts;
@@ -143,7 +151,7 @@ declare function restoreWorkbook(workbookId: string): Promise<ServiceResult<true
 declare function listTrashedWorkbooks(): Promise<ServiceResult<Workbook$1[]>>;
 /**
  * An independent copy of a workbook: its own row in the original's organization
- * and project, with the latest snapshot copied over. Editing the copy never
+ * and project, with the CURRENT content copied over (the live room when people are co-editing). Editing the copy never
  * touches the original.
  */
 declare function copyWorkbook(workbookId: string, name?: string): Promise<ServiceResult<Workbook$1>>;

package/dist/sheets.d.ts

@@ -25,6 +25,14 @@ interface SheetsHostPorts {
     }): Promise<{
         fileId: string;
     }>;
+    /**
+     * 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?(workbookId: string): Promise<{
+        snapshot: unknown | null;
+    }>;
 }
 declare function configureSheetsHost(ports: SheetsHostPorts): void;
 declare function getSheetsHost(): SheetsHostPorts;
@@ -143,7 +151,7 @@ declare function restoreWorkbook(workbookId: string): Promise<ServiceResult<true
 declare function listTrashedWorkbooks(): Promise<ServiceResult<Workbook$1[]>>;
 /**
  * An independent copy of a workbook: its own row in the original's organization
- * and project, with the latest snapshot copied over. Editing the copy never
+ * and project, with the CURRENT content copied over (the live room when people are co-editing). Editing the copy never
  * touches the original.
  */
 declare function copyWorkbook(workbookId: string, name?: string): Promise<ServiceResult<Workbook$1>>;

package/dist/sheets.js

@@ -16,7 +16,7 @@ import {
   saveSnapshot,
   updateWorkbookDescription,
   workbookSourceLabel
-} from "./chunk-WKBWRG7N.js";
+} from "./chunk-RREOARR4.js";
 
 // src/sheets/univer-snapshot-rows.ts
 function univerSheetIds(snapshot) {