@fileverse-dev/dsheet 1.3.7 → 1.3.8-export-fixes-2

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

@@ -7,7 +7,7 @@ type SyncContext = {
     dsheetId: string;
     handleOnChangePortalUpdate: () => void;
 };
-export declare const syncCurrentSheetField: (context: SyncContext, field: "images" | "iframes" | "frozen" | "name" | "config" | "showGridLines") => void;
+export declare const syncCurrentSheetField: (context: SyncContext, field: "images" | "iframes" | "frozen" | "name" | "config" | "showGridLines" | "color" | "hide") => void;
 export declare const createSheetLengthChangeHandler: ({ sheetEditorRef, ydocRef, dsheetId, currentDataRef, handleOnChangePortalUpdate, }: {
     sheetEditorRef: React.MutableRefObject<WorkbookInstance | null>;
     ydocRef: React.MutableRefObject<Y.Doc | null>;
@@ -16,5 +16,8 @@ export declare const createSheetLengthChangeHandler: ({ sheetEditorRef, ydocRef,
     handleOnChangePortalUpdate: () => void;
 }) => () => void;
 export declare const createAfterOrderChangesHandler: ({ sheetEditorRef, ydocRef, dsheetId, handleOnChangePortalUpdate, }: SyncContext) => () => void;
+export declare const createAfterColorChangesHandler: ({ sheetEditorRef, ydocRef, dsheetId, handleOnChangePortalUpdate, }: SyncContext) => () => void;
+export declare const createAfterHideChangesHandler: ({ sheetEditorRef, ydocRef, dsheetId, handleOnChangePortalUpdate, }: SyncContext) => () => void;
 export declare const createAfterColRowChangesHandler: ({ sheetEditorRef, ydocRef, dsheetId, handleOnChangePortalUpdate, }: SyncContext) => () => void;
+export declare const updateAllCell: ({ sheetEditorRef, ydocRef, dsheetId, handleOnChangePortalUpdate, }: SyncContext, subSheetId: string) => void;
 export {};

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: (event: ChangeEventHandler<HTMLInputElement> | undefined, file: any, importType: string) => void;
-    handleXLSXUpload: (event: ChangeEventHandler<HTMLInputElement> | undefined, file: any, importType: string) => void;
+    handleCSVUpload: (event: ChangeEventHandler<HTMLInputElement> | undefined, file: any, importType: string) => void | Promise<void>;
+    handleXLSXUpload: (event: ChangeEventHandler<HTMLInputElement> | undefined, file: any, importType: string) => void | Promise<void>;
     handleExportToXLSX: () => void;
     handleExportToCSV: () => void;
     handleExportToJSON: () => void;

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 {
+    setIsDataLoaded: React.Dispatch<React.SetStateAction<boolean>>;
     handleOnChangePortalUpdate: () => void;
     setSelectedTemplate?: React.Dispatch<React.SetStateAction<string>>;
     setShowSmartContractModal?: React.Dispatch<React.SetStateAction<boolean>>;

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

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

package/dist/package/hooks/use-homepage-redirect.d.ts

@@ -1,7 +1,8 @@
 import { WorkbookInstance } from '@fileverse-dev/fortune-react';
 
 import * as Y from 'yjs';
-export declare const usehandleHomepageRedirect: ({ setSelectedTemplate, handleXLSXUpload, handleCSVUpload, ydocRef, dsheetId, currentDataRef, setForceSheetRender, sheetEditorRef, updateDocumentTitle }: {
+export declare const usehandleHomepageRedirect: ({ setIsDataLoaded, setSelectedTemplate, handleXLSXUpload, handleCSVUpload, ydocRef, dsheetId, currentDataRef, setForceSheetRender, sheetEditorRef, updateDocumentTitle, }: {
+    setIsDataLoaded: React.Dispatch<React.SetStateAction<boolean>>;
     setSelectedTemplate?: React.Dispatch<React.SetStateAction<string>>;
     handleXLSXUpload: any;
     handleCSVUpload: any;

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

@@ -1,4 +1,6 @@
+import { default as React } from 'react';
 import { WorkbookInstance } from '@fileverse-dev/fortune-react';
+
 import * as Y from 'yjs';
 export declare const useXLSXImport: ({ sheetEditorRef, ydocRef, setForceSheetRender, dsheetId, currentDataRef, updateDocumentTitle, }: {
     sheetEditorRef: React.RefObject<WorkbookInstance | null>;

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

@@ -1,4 +1,4 @@
 import { WorkbookInstance } from '@fileverse-dev/fortune-react';
 import { MutableRefObject } from 'react';
 import * as Y from 'yjs';
-export declare const handleExportToCSV: (workbookRef: MutableRefObject<WorkbookInstance | null>, ydocRef: MutableRefObject<Y.Doc | null>) => void;
+export declare const handleExportToCSV: (workbookRef: MutableRefObject<WorkbookInstance | null>, ydocRef: MutableRefObject<Y.Doc | null>, _dsheetId?: string, getDocumentTitle?: () => string) => 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, handleContentPortal?: any) => 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) => Promise<void>;

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

@@ -8,10 +8,10 @@ export declare const getCustomToolbarItems: ({ handleContentPortal, setShowSmart
     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, handleContentPortal?: any) => void;
-    handleXLSXUpload: (event: ChangeEventHandler<HTMLInputElement> | undefined, 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 | Promise<void>;
+    handleXLSXUpload: (event: ChangeEventHandler<HTMLInputElement> | undefined, file?: File, importType?: string) => void | Promise<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;
+    handleExportToCSV: (sheetEditorRef: React.RefObject<WorkbookInstance | null>, ydocRef: React.RefObject<Y.Doc | null>, dsheetId: string, getDocumentTitle?: () => string) => void;
     handleExportToJSON: (sheetEditorRef: React.RefObject<WorkbookInstance | null>, ydocRef: React.RefObject<Y.Doc | null>, dsheetId: string) => void;
     sheetEditorRef: React.RefObject<WorkbookInstance | null>;
     ydocRef: React.RefObject<Y.Doc | null>;

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

@@ -0,0 +1,7 @@
+export declare const sanitizeFilenameBase: (value: string) => string;
+export declare const getExportFilenameBase: ({ getDocumentTitle, documentTitleFallback, sheetNameFallback, defaultBase, }: {
+    getDocumentTitle?: () => string;
+    documentTitleFallback?: string;
+    sheetNameFallback?: string;
+    defaultBase?: string;
+}) => string;

package/dist/package/utils/filter-select-ydoc-update.d.ts

@@ -0,0 +1,13 @@
+import { WorkbookInstance } from '@fileverse-dev/fortune-react';
+
+import * as Y from 'yjs';
+/**
+ * Sync `filter_select` for active sheet.
+ * Stored as a Y.Map for granular updates (keys: "row", "column").
+ */
+export declare const filterSelectYdocUpdate: ({ sheetEditorRef, ydocRef, dsheetId, handleContentPortal, }: {
+    sheetEditorRef: React.RefObject<WorkbookInstance | null>;
+    ydocRef: React.RefObject<Y.Doc | null>;
+    dsheetId: string;
+    handleContentPortal?: any;
+}) => void;

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

@@ -0,0 +1,13 @@
+import { WorkbookInstance } from '@fileverse-dev/fortune-react';
+
+import * as Y from 'yjs';
+/**
+ * Sync `filter` for active sheet.
+ * Stored as one object payload in Yjs (keys like "0", "1", "all" map to objects).
+ */
+export declare const filterYdocUpdate: ({ sheetEditorRef, ydocRef, dsheetId, handleContentPortal, }: {
+    sheetEditorRef: React.RefObject<WorkbookInstance | null>;
+    ydocRef: React.RefObject<Y.Doc | null>;
+    dsheetId: string;
+    handleContentPortal?: any;
+}) => void;

package/dist/package/utils/xlsx-border-utils.d.ts

@@ -0,0 +1,21 @@
+export type BorderSide = {
+    style: number;
+    color?: string;
+};
+export declare const BORDER_STYLE_MAP: Record<number, string>;
+/** Convert a fortune border side descriptor to an xlsx-js-style border entry. */
+export declare const toBorderSide: (style: unknown, color: unknown) => {
+    style: string;
+    color: {
+        rgb: string;
+    };
+} | undefined;
+/**
+ * Reads `borderInfo` from a fortune sheet config and writes the corresponding
+ * border styles into the xlsx-js-style worksheet object.
+ *
+ * Handles two rangeTypes:
+ *  - "cell"  → per-cell border entries produced by luckyexcel on import
+ *  - "range" → range border commands produced when the user draws borders in the UI
+ */
+export declare const applyBordersToWorksheet: (worksheet: Record<string, unknown>, borderInfo: any[]) => void;

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

@@ -0,0 +1,47 @@
+import { Worksheet } from 'exceljs';
+
+type CellRange = {
+    row: [number, number];
+    column: [number, number];
+    [key: string]: unknown;
+};
+export type FortuneFormat = {
+    textColor?: string;
+    cellColor?: string;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    strikethrough?: boolean;
+};
+type FortuneRule = {
+    type: string;
+    cellrange: CellRange[];
+    format?: FortuneFormat;
+    conditionName: string;
+    conditionValue?: string[];
+};
+type Sheet = {
+    luckysheet_conditionformat_save?: FortuneRule[];
+    [key: string]: unknown;
+};
+export type PendingDuplicateRule = {
+    ref: string;
+    format: FortuneFormat;
+    priority: number;
+};
+export type CfExportResult = {
+    nextPriority: number;
+    pendingDuplicateValues: PendingDuplicateRule[];
+};
+/** Convert any CSS color string to an 8-char ARGB hex (e.g. "FFFF0000"). Returns null if unparseable. */
+export declare function colorToArgb(color: string): string | null;
+/**
+ * Writes all luckysheet_conditionformat_save rules from `sheet` into the
+ * ExcelJS worksheet.
+ *
+ * Returns the next available priority integer and any `duplicateValue` rules
+ * that ExcelJS cannot render — those must be injected later via
+ * `patchXlsxCf` in the post-processing step.
+ */
+export declare function exportConditionalFormatting(ws: Worksheet, sheet: Sheet, startPriority: number): CfExportResult;
+export {};

package/dist/package/utils/xlsx-cf-postprocess.d.ts

@@ -0,0 +1,14 @@
+import { PendingDuplicateRule } from './xlsx-cf-export-utils';
+
+export type SheetCfPatch = {
+    duplicateValues: PendingDuplicateRule[];
+};
+/**
+ * Post-process an XLSX buffer produced by ExcelJS to fix conditional
+ * formatting issues that ExcelJS cannot handle natively:
+ *
+ *   1. Adds the `text` attribute to `containsText` cfRules (ExcelJS omits it).
+ *   2. Injects `duplicateValues` cfRules that ExcelJS's renderer skips entirely,
+ *      including their dxf style entries in xl/styles.xml.
+ */
+export declare function patchXlsxCf(buffer: ArrayBuffer | Buffer, sheetPatches: SheetCfPatch[]): Promise<ArrayBuffer>;

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

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

package/dist/package/utils/xlsx-image-utils.d.ts

@@ -0,0 +1,38 @@
+import { Workbook, Worksheet } from 'exceljs';
+import { Sheet } from '@fileverse-dev/fortune-react';
+
+export interface RawSheetImage {
+    src: string;
+    nativeCol: number;
+    nativeColOff: number;
+    nativeRow: number;
+    nativeRowOff: number;
+    width: number;
+    height: number;
+    brNativeCol?: number;
+    brNativeColOff?: number;
+    brNativeRow?: number;
+    brNativeRowOff?: number;
+}
+export declare function extractImagesFromWorksheet(ws: Worksheet, workbook: Workbook): RawSheetImage[];
+/**
+ * Embed Fortune sheet images into an ExcelJS worksheet.
+ * This is the inverse of convertRawImagesToFortuneSheet: converts pixel-based
+ * Image objects back to ExcelJS native cell + EMU positioning.
+ */
+export declare function addFortuneImagesToWorksheet(ws: Worksheet, workbook: Workbook, images: {
+    id: string;
+    src: string;
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}[], sheet: Sheet, defaultColPx: number, defaultRowPx: number): void;
+export declare function convertRawImagesToFortuneSheet(rawImages: RawSheetImage[], sheet: Sheet, defaultColPx: number, defaultRowPx: number): {
+    id: string;
+    src: string;
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}[];

package/dist/package/utils/xlsx-richtext-utils.d.ts

@@ -0,0 +1,16 @@
+import { Worksheet, RichText } from 'exceljs';
+
+export type CellRichTextValue = {
+    richText: RichText[];
+};
+/**
+ * Convert a Fortune/Luckysheet `ct.s` rich text array into an ExcelJS
+ * CellRichTextValue. Returns null if there are no non-empty runs.
+ */
+export declare function buildExcelJsRichText(ctS: any[]): CellRichTextValue | null;
+/**
+ * Apply rich text values collected during Pass 1 to an ExcelJS worksheet.
+ * Cell-level styles (fill, borders, alignment) from xlsx-js-style are preserved
+ * because ExcelJS stores value and style independently.
+ */
+export declare function applyRichTextToWorksheet(ws: Worksheet, richTextMap: Map<string, CellRichTextValue>): void;