@fileverse-dev/dsheet 1.2.93-ydoc-8 → 1.2.93-ydoc-10

package/dist/package/components/editor-workbook-sync.d.ts

@@ -0,0 +1,20 @@
+import { WorkbookInstance } from '@fileverse-dev/fortune-react';
+
+import * as Y from 'yjs';
+type SyncContext = {
+    sheetEditorRef: React.MutableRefObject<WorkbookInstance | null>;
+    ydocRef: React.MutableRefObject<Y.Doc | null>;
+    dsheetId: string;
+    handleOnChangePortalUpdate: () => void;
+};
+export declare const syncCurrentSheetField: (context: SyncContext, field: "images" | "iframes" | "frozen" | "name" | "config" | "showGridLines") => void;
+export declare const createSheetLengthChangeHandler: ({ sheetEditorRef, ydocRef, dsheetId, currentDataRef, handleOnChangePortalUpdate, }: {
+    sheetEditorRef: React.MutableRefObject<WorkbookInstance | null>;
+    ydocRef: React.MutableRefObject<Y.Doc | null>;
+    dsheetId: string;
+    currentDataRef: React.MutableRefObject<any>;
+    handleOnChangePortalUpdate: () => void;
+}) => () => void;
+export declare const createAfterOrderChangesHandler: ({ sheetEditorRef, ydocRef, dsheetId, handleOnChangePortalUpdate, }: SyncContext) => () => void;
+export declare const createAfterColRowChangesHandler: ({ sheetEditorRef, ydocRef, dsheetId, handleOnChangePortalUpdate, }: SyncContext) => () => void;
+export {};

package/dist/package/contexts/editor-context.d.ts

@@ -5,7 +5,7 @@ import { DataBlockApiKeyHandlerType, SheetUpdateData } from '../types';
 
 import * as Y from 'yjs';
 export interface EditorContextType {
-    handleOnChangePortalUpdate: (data: any[]) => void;
+    handleOnChangePortalUpdate: () => void;
     setSelectedTemplate?: React.Dispatch<React.SetStateAction<string>>;
     setShowSmartContractModal?: React.Dispatch<React.SetStateAction<boolean>>;
     getDocumentTitle?: () => string;

package/dist/package/hooks/use-editor-data.d.ts

@@ -20,7 +20,7 @@ export declare const useEditorData: (ydocRef: React.MutableRefObject<Y.Doc | nul
     currentDataRef: import('react').MutableRefObject<Sheet[]>;
     remoteUpdateRef: import('react').MutableRefObject<boolean>;
     isDataLoaded: boolean;
-    handleChange: (data: Sheet[]) => void;
+    handleChange: (_data: Sheet[]) => void;
     handleLiveQuery: (subsheetIndex: number, queryData: import('@fileverse-dev/fortune-core').LiveQueryData) => void;
     initialiseLiveQueryData: (sheets: Sheet[]) => void;
 };

package/dist/package/utils/calc-chain-ydoc-update.d.ts

@@ -2,12 +2,8 @@ import { WorkbookInstance } from '@fileverse-dev/fortune-react';
 
 import * as Y from 'yjs';
 /**
- * Verifies the integrity of sheet data in a YDoc against a given sheet editor instance.
- * This function is used to verify that the sheet data in a YDoc matches the data in a sheet editor instance.
- * @param {Object} options
- * @param {React.RefObject<WorkbookInstance | null>} options.sheetEditorRef - Reference to the sheet editor instance
- * @param {React.RefObject<Y.Doc | null>} options.ydocRef - Reference to the YDoc instance
- * @returns {void}
+ * Sync calcChain array for active sheet.
+ * calcChain is keyed by `r_c` while stored in Yjs.
  */
 export declare const calcChainYdocUpdate: ({ sheetEditorRef, ydocRef, dsheetId, handleContentPortal }: {
     sheetEditorRef: React.RefObject<WorkbookInstance | null>;

package/dist/package/utils/condition-format-ydoc-update.d.ts

@@ -2,12 +2,8 @@ import { WorkbookInstance } from '@fileverse-dev/fortune-react';
 
 import * as Y from 'yjs';
 /**
- * Verifies the integrity of sheet data in a YDoc against a given sheet editor instance.
- * This function is used to verify that the sheet data in a YDoc matches the data in a sheet editor instance.
- * @param {Object} options
- * @param {React.RefObject<WorkbookInstance | null>} options.sheetEditorRef - Reference to the sheet editor instance
- * @param {React.RefObject<Y.Doc | null>} options.ydocRef - Reference to the YDoc instance
- * @returns {void}
+ * Sync condition format rules for active sheet.
+ * This field is stored as one array payload in Yjs.
  */
 export declare const conditionFormatYdocUpdate: ({ sheetEditorRef, ydocRef, dsheetId, handleContentPortal }: {
     sheetEditorRef: React.RefObject<WorkbookInstance | null>;

package/dist/package/utils/data-block-list-ydoc-update.d.ts

@@ -2,12 +2,7 @@ import { WorkbookInstance } from '@fileverse-dev/fortune-react';
 
 import * as Y from 'yjs';
 /**
- * Verifies the integrity of sheet data in a YDoc against a given sheet editor instance.
- * This function is used to verify that the sheet data in a YDoc matches the data in a sheet editor instance.
- * @param {Object} options
- * @param {React.RefObject<WorkbookInstance | null>} options.sheetEditorRef - Reference to the sheet editor instance
- * @param {React.RefObject<Y.Doc | null>} options.ydocRef - Reference to the YDoc instance
- * @returns {void}
+ * Sync dataBlockCalcFunction map for the active sheet to Yjs.
  */
 export declare const dataBlockListYdocUpdate: ({ sheetEditorRef, ydocRef, dsheetId, handleContentPortal, dataBlockCalcFunction }: {
     sheetEditorRef: React.RefObject<WorkbookInstance | null>;

package/dist/package/utils/data-verification-ydoc-update.d.ts

@@ -2,12 +2,7 @@ import { WorkbookInstance } from '@fileverse-dev/fortune-react';
 
 import * as Y from 'yjs';
 /**
- * Verifies the integrity of sheet data in a YDoc against a given sheet editor instance.
- * This function is used to verify that the sheet data in a YDoc matches the data in a sheet editor instance.
- * @param {Object} options
- * @param {React.RefObject<WorkbookInstance | null>} options.sheetEditorRef - Reference to the sheet editor instance
- * @param {React.RefObject<Y.Doc | null>} options.ydocRef - Reference to the YDoc instance
- * @returns {void}
+ * Sync current sheet dataVerification object to Yjs.
  */
 export declare const dataVerificationYdocUpdate: ({ sheetEditorRef, ydocRef, dsheetId, handleContentPortal }: {
     sheetEditorRef: React.RefObject<WorkbookInstance | null>;

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

@@ -2,12 +2,7 @@ import { WorkbookInstance } from '@fileverse-dev/fortune-react';
 
 import * as Y from 'yjs';
 /**
- * Verifies the integrity of sheet data in a YDoc against a given sheet editor instance.
- * This function is used to verify that the sheet data in a YDoc matches the data in a sheet editor instance.
- * @param {Object} options
- * @param {React.RefObject<WorkbookInstance | null>} options.sheetEditorRef - Reference to the sheet editor instance
- * @param {React.RefObject<Y.Doc | null>} options.ydocRef - Reference to the YDoc instance
- * @returns {void}
+ * Sync hyperlink map for the active sheet to Yjs.
  */
 export declare const hyperlinkYdocUpdate: ({ sheetEditorRef, ydocRef, dsheetId, handleContentPortal }: {
     sheetEditorRef: React.RefObject<WorkbookInstance | null>;

package/dist/package/utils/json-export.d.ts

@@ -1,4 +1,4 @@
 import { WorkbookInstance } from '@fileverse-dev/fortune-react';
 
 import * as Y from 'yjs';
-export declare const handleExportToJSON: (sheetEditorRef: React.MutableRefObject<WorkbookInstance | null>, ydocRef: React.RefObject<Y.Doc | null>, dsheetId: string) => void;
+export declare const handleExportToJSON: (sheetEditorRef: React.MutableRefObject<WorkbookInstance | null>, ydocRef: React.RefObject<Y.Doc | null>, _dsheetId: string) => void;

package/dist/package/utils/live-query-list-ydoc-update.d.ts

@@ -2,12 +2,7 @@ import { WorkbookInstance } from '@fileverse-dev/fortune-react';
 
 import * as Y from 'yjs';
 /**
- * Verifies the integrity of sheet data in a YDoc against a given sheet editor instance.
- * This function is used to verify that the sheet data in a YDoc matches the data in a sheet editor instance.
- * @param {Object} options
- * @param {React.RefObject<WorkbookInstance | null>} options.sheetEditorRef - Reference to the sheet editor instance
- * @param {React.RefObject<Y.Doc | null>} options.ydocRef - Reference to the YDoc instance
- * @returns {void}
+ * Sync liveQueryList map for the active sheet to Yjs.
  */
 export declare const liveQueryListYdocUpdate: ({ sheetEditorRef, ydocRef, dsheetId, handleContentPortal }: {
     sheetEditorRef: React.RefObject<WorkbookInstance | null>;

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

@@ -0,0 +1,31 @@
+import { WorkbookInstance } from '@fileverse-dev/fortune-react';
+import { SheetChangePath } from './update-ydoc';
+
+import * as Y from 'yjs';
+type SyncContext = {
+    currentSheetId: string;
+    oldSheet: Record<string, any>;
+    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.
+ */
+export declare const getSheetYdocSyncContext: ({ sheetEditorRef, ydocRef, dsheetId, }: {
+    sheetEditorRef: React.RefObject<WorkbookInstance | null>;
+    ydocRef: React.RefObject<Y.Doc | null>;
+    dsheetId: string;
+}) => SyncContext | null;
+export declare const buildMapFieldChanges: ({ sheetId, fieldPath, oldData, newData, }: {
+    sheetId: string;
+    fieldPath: string;
+    oldData: Record<string, any>;
+    newData: Record<string, any>;
+}) => SheetChangePath[];
+export declare const applyYdocSheetChanges: ({ ydoc, dsheetId, changes, handleContentPortal, }: {
+    ydoc: Y.Doc;
+    dsheetId: string;
+    changes: SheetChangePath[];
+    handleContentPortal?: any;
+}) => void;
+export {};

package/package.json

@@ -2,7 +2,7 @@
   "name": "@fileverse-dev/dsheet",
   "private": false,
   "description": "DSheet",
-  "version": "1.2.93-ydoc-8",
+  "version": "1.2.93-ydoc-10",
   "main": "dist/index.es.js",
   "module": "dist/index.es.js",
   "exports": {
@@ -41,6 +41,7 @@
     "exceljs": "^4.4.0",
     "js-base64": "^3.7.7",
     "katex": "^0.16.11",
+    "lodash": "^4.17.23",
     "luckyexcel": "^1.0.1",
     "papaparse": "^5.5.2",
     "react": "^18.2.0",
@@ -56,6 +57,7 @@
     "yjs": "^13.6.15"
   },
   "devDependencies": {
+    "@types/lodash": "^4.17.23",
     "@types/node": "^20.10.0",
     "@types/papaparse": "^5.3.15",
     "@types/react": "^18.2.37",