@fileverse-dev/dsheet 4.1.23 → 4.1.24-stabilise-package-2

package/dist/editor/utils/update-ydoc.d.ts

@@ -17,5 +17,13 @@ export type SheetChangePath = {
 export declare const updateYdocSheetData: (ydoc: Y.Doc | null, dsheetId: string, changes: SheetChangePath[], handleContentPortal: any, onCellFormatRangesCommitted?: (commits: Array<{
     sheetId: string;
     ranges: CellFormatRange[];
-}>) => void) => void;
+}>) => void, 
+/** Transaction origin; omit for user edits. */
+origin?: unknown) => void;
 export declare function ySheetArrayToPlain(sheetArray: Y.Array<Y.Map>): Sheet[];
+/**
+ * One field of one sheet, with the same value ySheetArrayToPlain gives for
+ * it, without converting the rest of the workbook (A3). Shared, read-only
+ * semantics as ySheetArrayToPlain.
+ */
+export declare function readYdocSheetField(ydoc: Y.Doc, dsheetId: string, sheetId: string, field: string): any;

package/dist/editor/utils/wait-for-sync.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Waits for a y-indexeddb provider without trusting it to finish.
+ *
+ * In y-indexeddb 9.0.12 `whenSynced` resolves only on 'synced'. It has no
+ * reject path, and a provider that is destroyed before its first read, or whose
+ * first read never completes, never syncs. Awaiting it directly hangs the
+ * bootstrap, and a rebuild that waits for the bootstrap hangs with it.
+ */
+export declare const INDEXEDDB_SYNC_TIMEOUT_MS = 15000;
+/** How long a rebuild waits for a running bootstrap before it abandons it. */
+export declare const REBUILD_BOOTSTRAP_WAIT_MS = 3000;
+export declare class PersistenceSyncTimeoutError extends Error {
+    constructor(ms: number);
+}
+export declare class PersistenceSupersededError extends Error {
+    constructor();
+}
+/**
+ * Resolves when `whenSynced` does. Rejects with PersistenceSyncTimeoutError
+ * after `timeoutMs`, or with PersistenceSupersededError as soon as
+ * `isCurrent()` turns false (checked every 100 ms): a newer bootstrap or an
+ * unmount owns the provider then, and it may already be destroyed.
+ */
+export declare function waitForPersistenceSynced(persistence: {
+    whenSynced: Promise<unknown>;
+}, options?: {
+    timeoutMs?: number;
+    isCurrent?: () => boolean;
+}): Promise<void>;
+/**
+ * Waits for a running bootstrap for at most `ms`. 'stuck' means it has not
+ * settled; the caller then abandons it (bumps the generation) instead of
+ * waiting for a provider that may never sync.
+ */
+export declare function waitForBootstrapOrAbandon(bootstrap: Promise<unknown>, ms?: number): Promise<'settled' | 'stuck'>;

package/dist/editor/utils/wait-for-sync.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/editor/utils/xlsx-export-impl.d.ts

@@ -3,3 +3,4 @@ import { MutableRefObject } from 'react';
 import * as Y from 'yjs';
 export declare const handleExportToXLSX: (workbookRef: MutableRefObject<WorkbookInstance | null>, ydocRef: MutableRefObject<Y.Doc | null>, dsheetId: string, getDocumentTitle?: (dsheetId: string) => Promise<string>) => Promise<void>;
 export declare const handleExportToODS: (workbookRef: MutableRefObject<WorkbookInstance | null>, ydocRef: MutableRefObject<Y.Doc | null>, dsheetId: string, getDocumentTitle?: (dsheetId: string) => Promise<string>) => Promise<void>;
+export declare const exportToXLSXBytes: (workbookRef: MutableRefObject<WorkbookInstance | null>, ydocRef: MutableRefObject<Y.Doc | null>, dsheetId: string) => Promise<Uint8Array>;

package/dist/editor/utils/xlsx-export.d.ts

@@ -7,3 +7,4 @@ import * as Y from 'yjs';
  */
 export declare const handleExportToXLSX: (workbookRef: MutableRefObject<WorkbookInstance | null>, ydocRef: MutableRefObject<Y.Doc | null>, dsheetId: string, getDocumentTitle?: (dsheetId: string) => Promise<string>) => Promise<void>;
 export declare const handleExportToODS: (workbookRef: MutableRefObject<WorkbookInstance | null>, ydocRef: MutableRefObject<Y.Doc | null>, dsheetId: string, getDocumentTitle?: (dsheetId: string) => Promise<string>) => Promise<void>;
+export declare const exportToXLSXBytes: (workbookRef: MutableRefObject<WorkbookInstance | null>, ydocRef: MutableRefObject<Y.Doc | null>, dsheetId: string) => Promise<Uint8Array>;