@fileverse-dev/dsheet 1.2.97-data-validation-fix-1 → 1.2.97-ydoc

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/constants/shared-constants.d.ts

@@ -3,6 +3,7 @@ import { ERROR_MESSAGES_FLAG as ErrorMessagesFlagType, SERVICES_API_KEY as Servi
 export declare const ERROR_MESSAGES_FLAG: ErrorMessagesFlagType;
 export declare const SERVICES_API_KEY: ServicesApiKeyType;
 export declare const DEFAULT_SHEET_DATA: {
+    id: string;
     name: string;
     celldata: never[];
     config: {};

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

@@ -5,6 +5,7 @@ import { DataBlockApiKeyHandlerType, SheetUpdateData } from '../types';
 
 import * as Y from 'yjs';
 export interface EditorContextType {
+    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

@@ -0,0 +1,13 @@
+import { WorkbookInstance } from '@fileverse-dev/fortune-react';
+
+import * as Y from 'yjs';
+/**
+ * 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>;
+    ydocRef: React.RefObject<Y.Doc | null>;
+    dsheetId: string;
+    handleContentPortal?: any;
+}) => void;

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

@@ -0,0 +1,13 @@
+import { WorkbookInstance } from '@fileverse-dev/fortune-react';
+
+import * as Y from 'yjs';
+/**
+ * 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>;
+    ydocRef: React.RefObject<Y.Doc | null>;
+    dsheetId: string;
+    handleContentPortal?: any;
+}) => void;

package/dist/package/utils/csv-import.d.ts

@@ -2,4 +2,4 @@ import { default as React } from 'react';
 import { WorkbookInstance } from '@fileverse-dev/fortune-react';
 
 import * as Y from 'yjs';
-export declare const handleCSVUpload: (event: React.ChangeEventHandler<HTMLInputElement> | undefined, ydoc: Y.Doc | null, setForceSheetRender: React.Dispatch<React.SetStateAction<number>>, dsheetId: string, currentDataRef: React.MutableRefObject<object | null>, sheetEditorRef: React.RefObject<WorkbookInstance | null>, updateDocumentTitle?: (title: string) => void, fileArg?: File, importType?: string) => void;
+export declare const handleCSVUpload: (event: React.ChangeEventHandler<HTMLInputElement> | undefined, ydoc: Y.Doc | null, setForceSheetRender: React.Dispatch<React.SetStateAction<number>>, dsheetId: string, currentDataRef: React.MutableRefObject<object | null>, sheetEditorRef: React.RefObject<WorkbookInstance | null>, updateDocumentTitle?: (title: string) => void, fileArg?: File, importType?: string, handleContentPortal?: any) => void;

package/dist/package/utils/custom-toolbar-item.d.ts

@@ -2,12 +2,13 @@ import { default as React, ChangeEventHandler } from 'react';
 import { WorkbookInstance } from '@fileverse-dev/fortune-react';
 
 import * as Y from 'yjs';
-export declare const getCustomToolbarItems: ({ setShowSmartContractModal, setExportDropdownOpen, handleCSVUpload, handleXLSXUpload, handleExportToXLSX, handleExportToCSV, handleExportToJSON, sheetEditorRef, ydocRef, dsheetId, currentDataRef, setForceSheetRender, toggleTemplateSidebar, getDocumentTitle, updateDocumentTitle, }: {
+export declare const getCustomToolbarItems: ({ handleContentPortal, setShowSmartContractModal, setExportDropdownOpen, handleCSVUpload, handleXLSXUpload, handleExportToXLSX, handleExportToCSV, handleExportToJSON, sheetEditorRef, ydocRef, dsheetId, currentDataRef, setForceSheetRender, toggleTemplateSidebar, getDocumentTitle, updateDocumentTitle, }: {
+    handleContentPortal?: any;
     setShowSmartContractModal?: React.Dispatch<React.SetStateAction<boolean>>;
     getDocumentTitle?: () => string;
     updateDocumentTitle?: (title: string) => void;
     setExportDropdownOpen: React.Dispatch<React.SetStateAction<boolean>>;
-    handleCSVUpload: (event: ChangeEventHandler<HTMLInputElement> | undefined, ydocRef: Y.Doc | null, setForceSheetRender: React.Dispatch<React.SetStateAction<number>>, dsheetId: string, currentDataRef: React.MutableRefObject<object | null>, sheetEditorRef: React.RefObject<WorkbookInstance | null>, updateDocumentTitle?: (title: string) => void, file?: File, importType?: string) => void;
+    handleCSVUpload: (event: ChangeEventHandler<HTMLInputElement> | undefined, ydocRef: Y.Doc | null, setForceSheetRender: React.Dispatch<React.SetStateAction<number>>, dsheetId: string, currentDataRef: React.MutableRefObject<object | null>, sheetEditorRef: React.RefObject<WorkbookInstance | null>, updateDocumentTitle?: (title: string) => void, file?: File, importType?: string, handleContentPortal?: any) => void;
     handleXLSXUpload: (event: ChangeEventHandler<HTMLInputElement> | undefined, file?: File, importType?: string) => void;
     handleExportToXLSX: (sheetEditorRef: React.RefObject<WorkbookInstance | null>, ydocRef: React.RefObject<Y.Doc | null>, dsheetId: string, getDocumentTitle?: () => string) => void;
     handleExportToCSV: (sheetEditorRef: React.RefObject<WorkbookInstance | null>, ydocRef: React.RefObject<Y.Doc | null>, dsheetId: string) => void;

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

@@ -0,0 +1,13 @@
+import { WorkbookInstance } from '@fileverse-dev/fortune-react';
+
+import * as Y from 'yjs';
+/**
+ * Sync dataBlockCalcFunction map for the active sheet to Yjs.
+ */
+export declare const dataBlockListYdocUpdate: ({ sheetEditorRef, ydocRef, dsheetId, handleContentPortal, dataBlockCalcFunction }: {
+    sheetEditorRef: React.RefObject<WorkbookInstance | null>;
+    ydocRef: React.RefObject<Y.Doc | null>;
+    dsheetId: string;
+    handleContentPortal?: any;
+    dataBlockCalcFunction?: any;
+}) => void;

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

@@ -0,0 +1,12 @@
+import { WorkbookInstance } from '@fileverse-dev/fortune-react';
+
+import * as Y from 'yjs';
+/**
+ * Sync current sheet dataVerification object to Yjs.
+ */
+export declare const dataVerificationYdocUpdate: ({ sheetEditorRef, ydocRef, dsheetId, handleContentPortal }: {
+    sheetEditorRef: React.RefObject<WorkbookInstance | null>;
+    ydocRef: React.RefObject<Y.Doc | null>;
+    dsheetId: string;
+    handleContentPortal?: any;
+}) => void;

package/dist/package/utils/diff-sheet.d.ts

@@ -1,9 +1,35 @@
-import { Sheet } from '@fileverse-dev/fortune-react';
-
 /**
  * Compare two spreadsheets' cell data and images, checking if anything changed
  * @param {Array} oldSheets - Original sheets data
  * @param {Array} newSheets - New sheets data
  * @returns {boolean} - true if any cell data or images changed, false if identical
  */
-export declare function isSpreadsheetChanged(oldSheets: Sheet[], newSheets: Sheet[]): boolean;
+type DiffChange<T> = {
+    from: T;
+    to: T;
+};
+type UpdatedItem<T> = {
+    key: string;
+    before: T;
+    after: T;
+    changes: Partial<Record<keyof T, DiffChange<any>>>;
+};
+type DiffResult<T> = {
+    added: T[];
+    removed: T[];
+    updated: UpdatedItem<T>[];
+};
+export declare function diffObjectArrays<T extends Record<string, any>>(oldArr: readonly T[], newArr: readonly T[], getKey?: (item: T) => string): DiffResult<T>;
+type UpdatedEntry<T> = {
+    key: string;
+    before: T;
+    after: T;
+    changes: Partial<Record<keyof T, DiffChange<any>>>;
+};
+type ObjectDiffResult<T> = {
+    added: Record<string, T>;
+    removed: Record<string, T>;
+    updated: UpdatedEntry<T>[];
+};
+export declare function diffObjectMap<T extends Record<string, any>>(oldObj: Record<string, T>, newObj: Record<string, T>): ObjectDiffResult<T>;
+export {};

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

@@ -0,0 +1,12 @@
+import { WorkbookInstance } from '@fileverse-dev/fortune-react';
+
+import * as Y from 'yjs';
+/**
+ * Sync hyperlink map for the active sheet to Yjs.
+ */
+export declare const hyperlinkYdocUpdate: ({ sheetEditorRef, ydocRef, dsheetId, handleContentPortal }: {
+    sheetEditorRef: React.RefObject<WorkbookInstance | null>;
+    ydocRef: React.RefObject<Y.Doc | null>;
+    dsheetId: string;
+    handleContentPortal?: any;
+}) => void;

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

@@ -0,0 +1,12 @@
+import { WorkbookInstance } from '@fileverse-dev/fortune-react';
+
+import * as Y from 'yjs';
+/**
+ * Sync liveQueryList map for the active sheet to Yjs.
+ */
+export declare const liveQueryListYdocUpdate: ({ sheetEditorRef, ydocRef, dsheetId, handleContentPortal }: {
+    sheetEditorRef: React.RefObject<WorkbookInstance | null>;
+    ydocRef: React.RefObject<Y.Doc | null>;
+    dsheetId: string;
+    handleContentPortal?: any;
+}) => void;

package/dist/package/utils/migrate-new-yjs.d.ts

@@ -0,0 +1,6 @@
+import { Sheet } from '@fileverse-dev/fortune-react';
+import * as Y from 'yjs';
+export declare function migrateSheetArrayIfNeeded(ydoc: Y.Doc, sheetArray: Y.Array<any>): void;
+type SheetFactory = () => Y.Map<any>;
+export declare function migrateSheetFactoryForImport(sheet: Sheet | Y.Map<any>): SheetFactory;
+export {};

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/dist/package/utils/update-ydoc.d.ts

@@ -0,0 +1,11 @@
+import { Sheet } from '@fileverse-dev/fortune-react';
+import * as Y from 'yjs';
+export type SheetChangePath = {
+    sheetId: string;
+    path: string[];
+    key?: string;
+    value: any;
+    type?: 'update' | 'delete';
+};
+export declare const updateYdocSheetData: (ydoc: Y.Doc | null, dsheetId: string, changes: SheetChangePath[], handleContentPortal: any) => void;
+export declare function ySheetArrayToPlain(sheetArray: Y.Array<Y.Map>): Sheet[];

package/package.json

@@ -2,7 +2,7 @@
   "name": "@fileverse-dev/dsheet",
   "private": false,
   "description": "DSheet",
-  "version": "1.2.97-data-validation-fix-1",
+  "version": "1.2.97-ydoc",
   "main": "dist/index.es.js",
   "module": "dist/index.es.js",
   "exports": {
@@ -35,12 +35,13 @@
   "dependencies": {
     "@fileverse-dev/dsheets-templates": "^0.0.29",
     "@fileverse-dev/formulajs": "4.4.49",
-    "@fileverse-dev/fortune-react": "^1.2.99-data-validation-fix-1",
+    "@fileverse-dev/fortune-react": "1.2.99-ydoc",
     "@fileverse/ui": "^5.0.0",
     "classnames": "^2.5.1",
     "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",
@@ -79,4 +81,4 @@
     "typescript": "^5.2.2",
     "vite": "^5.0.0"
   }
-}
+}

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

@@ -1,9 +0,0 @@
-import { Sheet } from '@fileverse-dev/fortune-react';
-import { SheetUpdateData } from '../types';
-import * as Y from 'yjs';
-export declare const useSheetData: (ydoc: Y.Doc | null, dsheetId: string, onChange?: (updateData: SheetUpdateData, encodedUpdate?: string) => void) => {
-    sheetData: Sheet[] | null;
-    setSheetData: import('react').Dispatch<import('react').SetStateAction<Sheet[] | null>>;
-    currentDataRef: import('react').MutableRefObject<Sheet[] | null>;
-    remoteUpdateRef: import('react').MutableRefObject<boolean>;
-};

package/dist/package/utils/sheet-operations.d.ts

@@ -1,8 +0,0 @@
-import { Sheet, WorkbookInstance } from '@fileverse-dev/fortune-react';
-import * as Y from 'yjs';
-export declare const updateSheetData: (ydoc: Y.Doc | null, dsheetId: string, data: Sheet[], sheetEditor: WorkbookInstance | null, dataBlockCalcFunction?: {
-    [key: string]: {
-        [key: string]: any;
-    };
-}, isReadOnly?: boolean) => void;
-export declare const formatSheetData: (data: Sheet[], preSheetArray: Sheet[], sheetEditor: WorkbookInstance) => Sheet[];