@fileverse-dev/dsheet 4.1.22 → 4.1.23-stabilise-package-3

package/dist/editor/utils/sheet-ydoc-sync-utils.d.ts

@@ -2,19 +2,29 @@ import { WorkbookInstance } from '../../sheet-engine/react';
 import { SheetChangePath } from './update-ydoc';
 
 import * as Y from 'yjs';
+export { readYdocSheetField } from './update-ydoc';
+/** Sheet fields the per-feature Yjs hooks sync. */
+export declare const SYNCED_SHEET_FIELDS: readonly ["calcChain", "config", "dataVerification", "luckysheet_conditionformat_save", "hyperlink", "filter", "filter_select", "liveQueryList", "dataBlockCalcFunction"];
 type SyncContext = {
     currentSheetId: string;
+    /** Only `field` is populated: the value stored in Yjs. */
     oldSheet: Record<string, any>;
+    /** The engine's current value of `field` for the active sheet. */
+    newValue: any;
+    /** The engine's active sheet, for checks against its cells. */
+    engineSheet: Record<string, any> | undefined;
     ydoc: Y.Doc;
 };
 /**
- * Build a stable sync context from current editor sheet and Yjs snapshot.
- * This keeps all field-level sync handlers aligned on the same baseline.
+ * Old (Yjs) and new (engine) value of one field of the active sheet (A3).
+ * Reads only that field: no whole-workbook conversion, and no getSheet(),
+ * which rebuilds celldata from the dense grid.
  */
-export declare const getSheetYdocSyncContext: ({ sheetEditorRef, ydocRef, dsheetId, }: {
+export declare const getSheetYdocSyncContext: ({ sheetEditorRef, ydocRef, dsheetId, field, }: {
     sheetEditorRef: React.RefObject<WorkbookInstance | null>;
     ydocRef: React.RefObject<Y.Doc | null>;
     dsheetId: string;
+    field: string;
 }) => SyncContext | null;
 export declare const buildMapFieldChanges: ({ sheetId, fieldPath, oldData, newData, }: {
     sheetId: string;
@@ -28,4 +38,3 @@ export declare const applyYdocSheetChanges: ({ ydoc, dsheetId, changes, handleCo
     changes: SheetChangePath[];
     handleContentPortal?: any;
 }) => void;
-export {};

package/dist/editor/utils/sheet-ydoc-sync-utils.test.d.ts

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

package/dist/editor/utils/structural-edit-formula-sync.test.d.ts

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

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/{es-S4GKlN-t.js → es-BlDQ6jCL.js}

@@ -11198,6 +11198,7 @@ If the value is FALSE, return the accrued interest from the first interest accru
     cancelText: "Cancelar",
     chooseText: "Confirmar color",
     focus: "Enfocar",
+    copyLink: "Copiar enlace a la hoja",
     tipNameRepeat: "¡El nombre de la página de la pestaña no se puede repetir! Revísalo",
     noMoreSheet: "El libro de trabajo contiene al menos una hoja de trabajo visual. Para eliminar la hoja de trabajo seleccionada, inserta una nueva hoja de trabajo o muestra una hoja de trabajo oculta",
     confirmDelete: "¿Estás seguro de eliminar",