@fileverse-dev/dsheet 1.2.0 → 1.2.2

package/dist/package/components/import-button-ui.d.ts

@@ -2,8 +2,8 @@ import { ChangeEventHandler } from 'react';
 
 export declare const CustomButton: ({ setExportDropdownOpen, handleCSVUpload, handleXLSXUpload, handleExportToXLSX, handleExportToCSV, handleExportToJSON, }: {
     setExportDropdownOpen: React.Dispatch<React.SetStateAction<boolean>>;
-    handleCSVUpload: ChangeEventHandler<HTMLInputElement>;
-    handleXLSXUpload: ChangeEventHandler<HTMLInputElement>;
+    handleCSVUpload: (event: ChangeEventHandler<HTMLInputElement> | undefined, file: any, importType: string) => void;
+    handleXLSXUpload: (event: ChangeEventHandler<HTMLInputElement> | undefined, file: any, importType: string) => void;
     handleExportToXLSX: () => void;
     handleExportToCSV: () => void;
     handleExportToJSON: () => void;

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

@@ -1,7 +1,7 @@
 import { default as React } from 'react';
-import { Sheet, WorkbookInstance } from '@fileverse-dev/fortune-react';
+import { LiveQueryData, Sheet, WorkbookInstance } from '@fileverse-dev/fortune-react';
 import { IndexeddbPersistence } from 'y-indexeddb';
-import { SheetUpdateData } from '../types';
+import { DataBlockApiKeyHandlerType, SheetUpdateData } from '../types';
 
 import * as Y from 'yjs';
 export interface EditorContextType {
@@ -36,6 +36,7 @@ export interface EditorContextType {
     collaborationStatus: 'disconnected' | 'connecting' | 'connected' | 'error';
     syncStatus: 'initializing' | 'syncing' | 'synced' | 'error';
     isCollaborative?: boolean;
+    handleLiveQuery: (subsheetIndex: number, data: LiveQueryData) => void;
 }
 interface EditorProviderProps {
     setSelectedTemplate?: React.Dispatch<React.SetStateAction<string>>;
@@ -57,6 +58,9 @@ interface EditorProviderProps {
     editorStateRef?: React.MutableRefObject<{
         refreshIndexedDB: () => Promise<void>;
     } | null>;
+    enableLiveQuery?: boolean;
+    liveQueryRefreshRate?: number;
+    dataBlockApiKeyHandler?: DataBlockApiKeyHandlerType;
 }
 export declare const EditorProvider: React.FC<EditorProviderProps>;
 export declare const useEditor: () => EditorContextType;

package/dist/package/dsheet-editor.d.ts

@@ -7,5 +7,5 @@ import { DsheetProps } from './types';
  * @param props - Component properties
  * @returns The SpreadsheetEditor component
  */
-declare const SpreadsheetEditor: ({ isCollaborative, isReadOnly, allowComments, renderNavbar, enableIndexeddbSync, dsheetId, portalContent, onChange, username, selectedTemplate, toggleTemplateSidebar, isTemplateOpen, enableWebrtc, onboardingComplete, onboardingHandler, commentData, getCommentCellUI, dataBlockApiKeyHandler, setFetchingURLData, setShowFetchURLModal, setInputFetchURLDataBlock, sheetEditorRef: externalSheetEditorRef, storeApiKey, onDuneChartEmbed, onSheetCountChange, onDataBlockApiResponse, isAuthorized, getDocumentTitle, updateDocumentTitle, setShowSmartContractModal, editorStateRef, handleSmartContractQuery, setSelectedTemplate, isNewSheet, }: DsheetProps) => JSX.Element;
+declare const SpreadsheetEditor: ({ isCollaborative, isReadOnly, allowComments, renderNavbar, enableIndexeddbSync, dsheetId, portalContent, onChange, username, selectedTemplate, toggleTemplateSidebar, isTemplateOpen, enableWebrtc, onboardingComplete, onboardingHandler, commentData, getCommentCellUI, dataBlockApiKeyHandler, setFetchingURLData, setShowFetchURLModal, setInputFetchURLDataBlock, sheetEditorRef: externalSheetEditorRef, storeApiKey, onDuneChartEmbed, onSheetCountChange, onDataBlockApiResponse, isAuthorized, getDocumentTitle, updateDocumentTitle, setShowSmartContractModal, editorStateRef, handleSmartContractQuery, setSelectedTemplate, isNewSheet, liveQueryRefreshRate, enableLiveQuery, }: DsheetProps) => JSX.Element;
 export default SpreadsheetEditor;

package/dist/package/hooks/live-query/constants.d.ts

@@ -0,0 +1 @@
+export declare const SUPPORTED_LIVE_QUERY_FUNCTIONS: string[];

package/dist/package/hooks/live-query/helpers.d.ts

@@ -0,0 +1,2 @@
+export declare function getFirstArgument(formula: string): string | null;
+export declare const isSupported: (functionName: string, formula: string) => boolean;

package/dist/package/hooks/live-query/use-live-query.d.ts

@@ -0,0 +1,8 @@
+import { LiveQueryData, Sheet, WorkbookInstance } from '@fileverse-dev/fortune-react';
+import { DataBlockApiKeyHandlerType } from '../../types';
+
+export declare const LIVE_QUERY_ERROR = "LIVE_QUERY_ERROR";
+export declare const useLiveQuery: (sheetEditorRef: React.MutableRefObject<WorkbookInstance | null>, dataBlockApiKeyHandler?: DataBlockApiKeyHandlerType, enableLiveQuery?: boolean, refreshRate?: number) => {
+    handleLiveQuery: (subsheetIndex: number, queryData: LiveQueryData) => void;
+    initialiseLiveQueryData: (sheets: Sheet[]) => void;
+};

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

@@ -1,4 +1,5 @@
 import { Sheet, WorkbookInstance } from '@fileverse-dev/fortune-react';
+import { DataBlockApiKeyHandlerType } from '../types';
 
 import * as Y from 'yjs';
 /**
@@ -13,11 +14,12 @@ export declare const useEditorData: (ydocRef: React.MutableRefObject<Y.Doc | nul
     [key: string]: {
         [key: string]: any;
     };
-}>>) => {
+}>>, enableLiveQuery?: boolean, liveQueryRefreshRate?: number, dataBlockApiKeyHandler?: DataBlockApiKeyHandlerType) => {
     sheetData: Sheet[];
     setSheetData: import('react').Dispatch<import('react').SetStateAction<Sheet[]>>;
     currentDataRef: import('react').MutableRefObject<Sheet[]>;
     remoteUpdateRef: import('react').MutableRefObject<boolean>;
     isDataLoaded: boolean;
     handleChange: (data: Sheet[]) => void;
+    handleLiveQuery: (subsheetIndex: number, queryData: import('@fileverse-dev/fortune-core').LiveQueryData) => void;
 };

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

@@ -7,7 +7,7 @@ import * as Y from 'yjs';
 export declare const useEditorSync: (dsheetId: string, enableIndexeddbSync?: boolean, isReadOnly?: boolean) => {
     ydocRef: import('react').MutableRefObject<Y.Doc | null>;
     persistenceRef: import('react').MutableRefObject<IndexeddbPersistence | null>;
-    syncStatus: "initializing" | "syncing" | "synced" | "error";
+    syncStatus: "error" | "initializing" | "syncing" | "synced";
     isSyncedRef: import('react').MutableRefObject<boolean>;
     refreshIndexedDB: () => Promise<void>;
 };

package/dist/package/hooks/use-xlsx-import.d.ts

@@ -1,11 +1,12 @@
 import { WorkbookInstance } from '@fileverse-dev/fortune-react';
 import * as Y from 'yjs';
-export declare const useXLSXImport: ({ sheetEditorRef, ydocRef, setForceSheetRender, dsheetId, currentDataRef, }: {
+export declare const useXLSXImport: ({ sheetEditorRef, ydocRef, setForceSheetRender, dsheetId, currentDataRef, updateDocumentTitle, }: {
     sheetEditorRef: React.RefObject<WorkbookInstance | null>;
     ydocRef: React.RefObject<Y.Doc | null>;
     setForceSheetRender: React.Dispatch<React.SetStateAction<number>>;
     dsheetId: string;
     currentDataRef: React.MutableRefObject<object | null>;
+    updateDocumentTitle?: (title: string) => void;
 }) => {
-    handleXLSXUpload: (event: React.ChangeEvent<HTMLInputElement> | undefined, fileArg: File) => Promise<void>;
+    handleXLSXUpload: (event: React.ChangeEvent<HTMLInputElement> | undefined, fileArg: File, importType?: "new-dsheet" | "merge-current-dsheet" | "new-current-dsheet") => Promise<void>;
 };

package/dist/package/types.d.ts

@@ -75,6 +75,8 @@ export interface DsheetProps {
         refreshIndexedDB: () => Promise<void>;
     } | null>;
     handleSmartContractQuery?: SmartContractQueryHandler;
+    enableLiveQuery?: boolean;
+    liveQueryRefreshRate?: number;
 }
 export type BaseError = {
     message: string;

package/dist/package/utils/after-update-cell.d.ts

@@ -1,5 +1,6 @@
 import { Cell, WorkbookInstance } from '@fileverse-dev/fortune-react';
 import { OnboardingHandlerType, DataBlockApiKeyHandlerType } from '../types';
+import { LiveQueryData } from '@fileverse-dev/fortune-core';
 
 export type SmartContractResponse = {
     callSignature: unknown[];
@@ -25,7 +26,8 @@ interface AfterUpdateCellParams {
     setFetchingURLData: (fetching: boolean) => void;
     onboardingHandler: OnboardingHandlerType | undefined;
     dataBlockApiKeyHandler: DataBlockApiKeyHandlerType | undefined;
-    handleSmartContractQuery: SmartContractQueryHandler | undefined;
+    handleSmartContractQuery?: SmartContractQueryHandler | undefined;
+    handleLiveQueryData?: (subsheetIndex: number, queryData: LiveQueryData) => void;
     setInputFetchURLDataBlock: React.Dispatch<React.SetStateAction<string>> | undefined;
     storeApiKey?: (apiKeyName: string) => void;
     onDataBlockApiResponse?: (dataBlockName: string) => void;
@@ -40,6 +42,7 @@ interface AfterUpdateCellParams {
         };
     };
 }
+export declare const isDatablockError: (value: any) => boolean;
 /**
  * Handles logic after a cell is updated, including processing formula results
  *

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.ChangeEvent<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) => 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) => void;

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

@@ -1,4 +1,4 @@
-import { default as React, ChangeEvent } from 'react';
+import { default as React, ChangeEventHandler } from 'react';
 import { WorkbookInstance } from '@fileverse-dev/fortune-react';
 
 import * as Y from 'yjs';
@@ -7,8 +7,8 @@ export declare const getCustomToolbarItems: ({ setShowSmartContractModal, setExp
     getDocumentTitle?: () => string;
     updateDocumentTitle?: (title: string) => void;
     setExportDropdownOpen: React.Dispatch<React.SetStateAction<boolean>>;
-    handleCSVUpload: (event: ChangeEvent<HTMLInputElement>, 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) => void;
-    handleXLSXUpload: React.ChangeEventHandler<HTMLInputElement>;
+    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;
+    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;
     handleExportToJSON: (sheetEditorRef: React.RefObject<WorkbookInstance | null>, ydocRef: React.RefObject<Y.Doc | null>, dsheetId: string) => void;

package/dist/package/utils/formula-ui-sync.d.ts

@@ -1,4 +1,4 @@
-import { WorkbookInstance } from '@fileverse-dev/fortune-react';
+import { Cell, WorkbookInstance } from '@fileverse-dev/fortune-react';
 
 export type FormulaSyncType = {
     row: number;
@@ -8,3 +8,118 @@ export type FormulaSyncType = {
     sheetEditorRef: React.RefObject<WorkbookInstance | null>;
 };
 export declare const formulaResponseUiSync: ({ row, column, newValue, apiData, sheetEditorRef, }: FormulaSyncType) => void;
+export declare const getCellClone: (r: number, c: number, sheetEditorRef: React.RefObject<WorkbookInstance | null>) => {
+    v?: string | number | boolean;
+    m?: string | number;
+    mc?: {
+        r: number;
+        c: number;
+        rs?: number;
+        cs?: number;
+    };
+    f?: string;
+    ct?: {
+        fa?: string;
+        t?: string;
+        s?: any;
+    };
+    qp?: number;
+    spl?: any;
+    bg?: string;
+    lo?: number;
+    rt?: number;
+    baseValue?: number | string;
+    baseCurrency?: string;
+    baseCurrencyPrice?: string | number;
+    isDataBlockFormula?: boolean;
+    ps?: {
+        left: number | null;
+        top: number | null;
+        width: number | null;
+        height: number | null;
+        value: string;
+        isShow: boolean;
+    };
+    hl?: {
+        r: number;
+        c: number;
+        id: string;
+    };
+    error?: import('@fileverse-dev/fortune-core').CellError;
+    bl?: number;
+    it?: number;
+    ff?: number | string;
+    fs?: number;
+    fc?: string;
+    ht?: number;
+    vt?: number;
+    tb?: string;
+    cl?: number;
+    un?: number;
+    tr?: string;
+};
+export declare const isNumValue: (v: any) => boolean;
+export declare const cloneInlineStyles: (styles: any) => any;
+export declare const buildCellFormat: (value: any, existingCt: Cell["ct"]) => {
+    t: string;
+    fa: string;
+} | {
+    t: string;
+    fa: string;
+    s: any;
+};
+export declare const preserveTextColorFromInlineStyle: (existing: any, nextIsNum: boolean) => {
+    fc?: undefined;
+} | {
+    fc: any;
+};
+export declare const cloneCellStyles: (cell: Cell) => {
+    v?: string | number | boolean;
+    m?: string | number;
+    mc?: {
+        r: number;
+        c: number;
+        rs?: number;
+        cs?: number;
+    };
+    f?: string;
+    ct?: {
+        fa?: string;
+        t?: string;
+        s?: any;
+    };
+    qp?: number;
+    spl?: any;
+    bg?: string;
+    lo?: number;
+    rt?: number;
+    baseValue?: number | string;
+    baseCurrency?: string;
+    baseCurrencyPrice?: string | number;
+    isDataBlockFormula?: boolean;
+    ps?: {
+        left: number | null;
+        top: number | null;
+        width: number | null;
+        height: number | null;
+        value: string;
+        isShow: boolean;
+    };
+    hl?: {
+        r: number;
+        c: number;
+        id: string;
+    };
+    error?: import('@fileverse-dev/fortune-core').CellError;
+    bl?: number;
+    it?: number;
+    ff?: number | string;
+    fs?: number;
+    fc?: string;
+    ht?: number;
+    vt?: number;
+    tb?: string;
+    cl?: number;
+    un?: number;
+    tr?: string;
+};

package/dist/package/utils/generic.d.ts

@@ -0,0 +1,2 @@
+export declare function isNumericOnly(value: string | number): boolean;
+export declare function isHexValue(str: string): boolean;

package/dist/package/utils/update-index-after-drag.d.ts

@@ -0,0 +1,20 @@
+interface FormulaCell {
+    formulaName: string;
+    row: number;
+    column: number;
+    rowRefrenced: number[];
+    columnRefrenced: number[];
+}
+interface FormulaCells {
+    [key: string]: FormulaCell;
+}
+export declare function updateRowIndices(data: FormulaCells, sourceIndex: number, targetIndex: number): FormulaCells;
+interface FormulaCell {
+    formulaName: string;
+    row: number;
+    column: number;
+    rowRefrenced: number[];
+    columnRefrenced: number[];
+}
+export declare function updateColumnIndices(data: FormulaCells, sourceIndex: number, targetIndex: number): FormulaCells;
+export {};