@fileverse-dev/dsheet 2.1.5 → 3.0.1-yjs-1

package/dist/sheet-engine/core/types.d.ts

@@ -1,5 +1,6 @@
 import { Patch as ImmerPatch } from 'immer';
 import { PatchOptions } from './utils';
+import { CellFormatRange } from './utils/range-format';
 
 export type Op = {
     op: 'replace' | 'remove' | 'add' | 'insertRowCol' | 'deleteRowCol' | 'addSheet' | 'deleteSheet';
@@ -140,6 +141,8 @@ export type SheetConfig = {
     customHeight?: Record<string, number>;
     customWidth?: Record<string, number>;
     borderInfo?: any[];
+    /** Range-level cell formatting for empty cells (toolbar bulk format). */
+    cellFormatRanges?: CellFormatRange[];
     authority?: any;
     rowReadOnly?: Record<number, number>;
     colReadOnly?: Record<number, number>;

package/dist/sheet-engine/core/utils/border-config-utils.d.ts

@@ -0,0 +1,10 @@
+import { Context } from '../context';
+
+export type BorderSelection = {
+    row: [number, number];
+    column: [number, number];
+};
+/** Remove border entries overlapping a single selection (cell + range types). */
+export declare function removeBorderInfoForSelection(borderInfo: any[], rowSt: number, rowEd: number, colSt: number, colEd: number): any[];
+export declare function removeBorderInfoInSelections(borderInfo: any[] | undefined, selections: BorderSelection[]): any[];
+export declare function syncBorderInfoToYdoc(ctx: Context, borderInfo: any[]): void;

package/dist/sheet-engine/core/utils/cell-persist-utils.d.ts

@@ -0,0 +1,8 @@
+import { Cell } from '../types';
+
+export declare const CELL_FORMAT_ATTRS: readonly ["tb", "ht", "vt", "tr", "fs", "ff", "fc", "bl", "it", "un", "cl", "bg", "ct"];
+export type CellFormatAttr = (typeof CELL_FORMAT_ATTRS)[number];
+export declare function hasCellMeaningfulContent(cell: Cell | string | number | boolean | null | undefined): boolean;
+export declare function isFormatOnlyEmptyCell(cell: Cell | string | number | boolean | null | undefined): boolean;
+export declare function shouldPersistCelldataCell(cell: Cell | string | number | boolean | null | undefined): boolean;
+export declare function celldataEntryEqual(existing: unknown, next: unknown): boolean;

package/dist/sheet-engine/core/utils/range-format.d.ts

@@ -0,0 +1,43 @@
+import { Cell, CellMatrix, CellWithRowAndCol, Sheet } from '../types';
+
+export type CellFormatRange = {
+    row: [number, number];
+    column: [number, number];
+    tb?: string;
+    ht?: number | string;
+    vt?: number | string;
+    tr?: string;
+    fs?: number;
+    ff?: number | string;
+    fc?: string;
+    bl?: number;
+    it?: number;
+    un?: number;
+    cl?: number;
+    bg?: string;
+    ct?: Cell['ct'];
+};
+declare function rangesEqual(a: CellFormatRange[] | undefined, b: CellFormatRange[] | undefined): boolean;
+/** Merge overlapping/adjacent ranges that carry identical format attrs. */
+export declare function normalizeCellFormatRanges(ranges: CellFormatRange[] | undefined): CellFormatRange[];
+export declare function getCellFormatRangeGridBounds(ranges: CellFormatRange[] | undefined): {
+    maxRow: number;
+    maxCol: number;
+} | null;
+export declare function upsertCellFormatRange(ranges: CellFormatRange[] | undefined, rowSt: number, rowEd: number, colSt: number, colEd: number, attrs: Partial<CellFormatRange>): {
+    ranges: CellFormatRange[];
+    changed: boolean;
+};
+export declare function punchHoleInCellFormatRanges(ranges: CellFormatRange[] | undefined, r: number, c: number): CellFormatRange[];
+export declare function punchRectHoleInCellFormatRanges(ranges: CellFormatRange[] | undefined, rowSt: number, rowEd: number, colSt: number, colEd: number): CellFormatRange[];
+export declare function shiftCellFormatRangesOnInsert(ranges: CellFormatRange[] | undefined, type: 'row' | 'column', index: number, count: number, direction: 'lefttop' | 'rightbottom'): CellFormatRange[];
+export declare function shiftCellFormatRangesOnDelete(ranges: CellFormatRange[] | undefined, type: 'row' | 'column', start: number, end: number): CellFormatRange[];
+export declare function applyCellFormatRangesToData(data: CellMatrix | null | undefined, ranges: CellFormatRange[] | undefined): void;
+export declare function buildSheetDataMatrixForExport(sheet: {
+    data?: CellMatrix | null;
+    celldata?: CellWithRowAndCol[];
+    row?: number;
+    column?: number;
+    config?: Sheet['config'];
+}): CellMatrix;
+export { rangesEqual };

package/dist/sheet-engine/react/components/SheetOverlay/Icon.d.ts

@@ -1,3 +1,4 @@
+import { default as React } from 'react';
 import { LucideIconProps } from './LucideIcon';
 
 export declare const LucideIcons: {
@@ -11,10 +12,10 @@ export declare const LucideIcons: {
     Farcaster: ({ width, height, ...props }: LucideIconProps) => import("react/jsx-runtime").JSX.Element;
     Warpcast: ({ width, height, ...props }: LucideIconProps) => import("react/jsx-runtime").JSX.Element;
     DSheetTextDisabled: ({ width, height, ...props }: LucideIconProps) => import("react/jsx-runtime").JSX.Element;
-    AddColLeft: () => import("react/jsx-runtime").JSX.Element;
-    AddColRight: () => import("react/jsx-runtime").JSX.Element;
-    AddRowBelowLocal: () => import("react/jsx-runtime").JSX.Element;
-    AddRowAboveLocal: () => import("react/jsx-runtime").JSX.Element;
+    AddColLeft: ({ className, ...props }: React.SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;
+    AddColRight: ({ className, ...props }: React.SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;
+    AddRowBelowLocal: ({ className, ...props }: React.SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;
+    AddRowAboveLocal: ({ className, ...props }: React.SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;
     DSheetOnlyText: () => import("react/jsx-runtime").JSX.Element;
     Orb: ({ width, height, ...props }: LucideIconProps) => import("react/jsx-runtime").JSX.Element;
     Lens: ({ width, height, ...props }: LucideIconProps) => import("react/jsx-runtime").JSX.Element;

package/dist/sheet-engine/react/components/SheetOverlay/LucideIcon.d.ts

@@ -11,10 +11,10 @@ export declare const UltimateIcons: {
     Farcaster: ({ width, height, ...props }: LucideIconProps) => import("react/jsx-runtime").JSX.Element;
     Warpcast: ({ width, height, ...props }: LucideIconProps) => import("react/jsx-runtime").JSX.Element;
     DSheetTextDisabled: ({ width, height, ...props }: LucideIconProps) => import("react/jsx-runtime").JSX.Element;
-    AddColLeft: () => import("react/jsx-runtime").JSX.Element;
-    AddColRight: () => import("react/jsx-runtime").JSX.Element;
-    AddRowBelowLocal: () => import("react/jsx-runtime").JSX.Element;
-    AddRowAboveLocal: () => import("react/jsx-runtime").JSX.Element;
+    AddColLeft: ({ className, ...props }: React.SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;
+    AddColRight: ({ className, ...props }: React.SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;
+    AddRowBelowLocal: ({ className, ...props }: React.SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;
+    AddRowAboveLocal: ({ className, ...props }: React.SVGProps<SVGSVGElement>) => import("react/jsx-runtime").JSX.Element;
     DSheetOnlyText: () => import("react/jsx-runtime").JSX.Element;
     Orb: ({ width, height, ...props }: LucideIconProps) => import("react/jsx-runtime").JSX.Element;
     Lens: ({ width, height, ...props }: LucideIconProps) => import("react/jsx-runtime").JSX.Element;

package/dist/sheet-engine/react/components/SidebarPanelPortals/index.d.ts

@@ -0,0 +1,17 @@
+import { default as React } from 'react';
+import { Context } from '../../../core';
+import { default as WorkbookContext } from '../../context';
+
+export type SidebarPortalTargets = Record<string, HTMLElement | undefined>;
+export type SidebarPortalRegistryHandle = {
+    getTargets: () => SidebarPortalTargets;
+    subscribe: (onStoreChange: () => void) => () => void;
+};
+export type SidebarPortalRenderer = (workbook: React.ContextType<typeof WorkbookContext>) => React.ReactNode;
+interface SidebarPanelPortalsProps {
+    activePanel: string | null;
+    portalRegistry?: SidebarPortalRegistryHandle | null;
+    extraPortals?: Record<string, SidebarPortalRenderer>;
+}
+export declare function SidebarPanelPortals({ activePanel, portalRegistry, extraPortals, }: Readonly<SidebarPanelPortalsProps>): React.ReactPortal | null;
+export type { Context };

package/dist/sheet-engine/react/components/Workbook/api.d.ts

@@ -1,3 +1,4 @@
+import { CellFormatRange } from '../../../core/utils/range-format';
 import { api, Cell, Context, Op, Range, Selection, Presence, Settings, SingleRange, Sheet, CellMatrix, CellWithRowAndCol, GlobalCache, LiveQueryData } from '../../../core';
 import { getCryptoPrice } from '../../utils/cryptoApi';
 import { SetContextOptions } from '../../context';
@@ -148,6 +149,12 @@ export declare function generateAPIs(context: Context, setContext: (recipe: (ctx
         } | null;
     }, options?: api.CommonOptions) => void;
     setSheetMapField: (field: string, value: Record<string, any> | null | undefined, options?: api.CommonOptions) => void;
+    /** Merge keys into a map-backed sheet field without replacing the whole map. */
+    patchSheetMapField: (field: string, updates: Record<string, any>, deleteKeys?: string[], options?: api.CommonOptions) => void;
+    /** Merge sub-keys into sheet.config without replacing the whole config object. */
+    setSheetConfigFields: (partial: Record<string, any>, options?: api.CommonOptions & {
+        deleteKeys?: string[];
+    }) => void;
     setSheetConditionFormatRules: (rules: any[], options?: api.CommonOptions) => void;
     scroll: (options: {
         scrollLeft?: number;
@@ -166,7 +173,7 @@ export declare function generateAPIs(context: Context, setContext: (recipe: (ctx
     calculateSubSheetFormula: (id: string) => void;
     calculateCellReferencedSubSheetFormula: (id: string, refCell?: string[]) => void;
     dataToCelldata: (data: CellMatrix | undefined) => CellWithRowAndCol[];
-    celldataToData: (celldata: CellWithRowAndCol[], rowCount?: number, colCount?: number) => CellMatrix | null;
+    celldataToData: (celldata: CellWithRowAndCol[], rowCount?: number, colCount?: number, cellFormatRanges?: CellFormatRange[]) => CellMatrix | null;
     insertFunction: (selectedFuncIndex: number, filteredFunctionList: any[], callback?: () => void) => void;
     getLocaleContext: () => any;
     getWorkbookContext: () => Context;

package/dist/sheet-engine/react/components/Workbook/index.d.ts

@@ -1,12 +1,18 @@
 import { Settings, Context, CellWithRowAndCol, Sheet as SheetType, Op, CellMatrix, api } from '../../../core';
+import { ThemeKey } from '../../../core/theme';
 import { default as React } from 'react';
 import { getCryptoPrice } from '../../utils/cryptoApi';
 import { SetContextOptions } from '../../context';
 import { generateAPIs } from './api';
+import { SidebarPortalRegistryHandle, SidebarPortalRenderer } from '../SidebarPanelPortals';
 
 export type WorkbookInstance = ReturnType<typeof generateAPIs>;
 type AdditionalProps = {
     onOp?: (op: Op[]) => void;
+    sidebarActivePanel?: string | null;
+    sidebarPortalRegistry?: SidebarPortalRegistryHandle | null;
+    sidebarPortalRenderers?: Record<string, SidebarPortalRenderer>;
+    theme?: ThemeKey;
 };
 declare const Workbook: React.ForwardRefExoticComponent<Settings & AdditionalProps & React.RefAttributes<{
     applyOp: (ops: Op[]) => void;
@@ -144,6 +150,10 @@ declare const Workbook: React.ForwardRefExoticComponent<Settings & AdditionalPro
         } | null;
     }, options?: api.CommonOptions) => void;
     setSheetMapField: (field: string, value: Record<string, any> | null | undefined, options?: api.CommonOptions) => void;
+    patchSheetMapField: (field: string, updates: Record<string, any>, deleteKeys?: string[], options?: api.CommonOptions) => void;
+    setSheetConfigFields: (partial: Record<string, any>, options?: api.CommonOptions & {
+        deleteKeys?: string[];
+    }) => void;
     setSheetConditionFormatRules: (rules: any[], options?: api.CommonOptions) => void;
     scroll: (options: {
         scrollLeft?: number;
@@ -162,7 +172,7 @@ declare const Workbook: React.ForwardRefExoticComponent<Settings & AdditionalPro
     calculateSubSheetFormula: (id: string) => void;
     calculateCellReferencedSubSheetFormula: (id: string, refCell?: string[]) => void;
     dataToCelldata: (data: CellMatrix | undefined) => CellWithRowAndCol[];
-    celldataToData: (celldata: CellWithRowAndCol[], rowCount?: number, colCount?: number) => CellMatrix | null;
+    celldataToData: (celldata: CellWithRowAndCol[], rowCount?: number, colCount?: number, cellFormatRanges?: import('../../../core/utils/range-format').CellFormatRange[]) => CellMatrix | null;
     insertFunction: (selectedFuncIndex: number, filteredFunctionList: any[], callback?: () => void) => void;
     getLocaleContext: () => any;
     getWorkbookContext: () => Context;

package/dist/sheet-engine/react/components/index.d.ts

@@ -3,5 +3,6 @@ import { default as Workbook } from './Workbook';
 export { ERROR_MESSAGES_FLAG, SERVICES_API_KEY, } from '@fileverse-dev/formulajs/crypto-constants';
 export { Workbook };
 export type { WorkbookInstance } from './Workbook';
+export type { SidebarPortalRenderer, SidebarPortalRegistryHandle, SidebarPortalTargets, } from './SidebarPanelPortals';
 export type { Cell, Sheet, LiveQueryData } from '../../core';
 export { markCellChanged as animateChangedCell } from '../../core';

package/dist/sheet-engine/react/utils/datepickerStyles.d.ts

@@ -1,2 +1,2 @@
-export declare const datepickerStyles = "\n  .datepicker-toggle {\n    display: inline-block;\n    position: relative;\n    width: 100%;\n  }\n  \n  .datepicker-toggle-button {\n    opacity: 0.3;\n    position: absolute;\n    right: 12px;\n    top: 50%;\n    transform: translateY(-50%);\n    width: 16px;\n    height: 16px;\n    background-image: url('data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgdmlld0JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9ImN1cnJlbnRDb2xvciIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiPjxyZWN0IHg9IjMiIHk9IjQiIHdpZHRoPSIxOCIgaGVpZ2h0PSIxOCIgcng9IjIiIHJ5PSIyIj48L3JlY3Q+PGxpbmUgeDE9IjE2IiB5MT0iMiIgeDI9IjE2IiB5Mj0iNiI+PC9saW5lPjxsaW5lIHgxPSI4IiB5MT0iMiIgeDI9IjgiIHkyPSI2Ij48L2xpbmU+PGxpbmUgeDE9IjMiIHkxPSIxMCIgeDI9IjIxIiB5Mj0iMTAiPjwvbGluZT48L3N2Zz4=');\n    background-repeat: no-repeat;\n    background-position: center;\n    pointer-events: none;\n  }\n  \n  .datepicker-input {\n    width: 100%;\n    padding: 8px 12px;\n    border: 1px solid #e2e8f0;\n    border-radius: 6px;\n    font-size: 14px;\n    line-height: 1.5;\n    color: #1a202c;\n    background-color: #fff;\n    cursor: pointer;\n  }\n  \n  .datepicker-input::-webkit-calendar-picker-indicator {\n    position: absolute;\n    left: 0;\n    top: 0;\n    width: 100%;\n    height: 100%;\n    margin: 0;\n    padding: 0;\n    cursor: pointer;\n    opacity: 0;\n  }\n  \n  .datepicker-input:focus {\n    outline: none;\n    border-color: #4299e1;\n    box-shadow: 0 0 0 3px rgba(66, 153, 225, 0.1);\n  }\n";
+export declare const datepickerStyles = "\n  .datepicker-toggle {\n    display: inline-block;\n    position: relative;\n    width: 100%;\n  }\n  \n  .datepicker-toggle-button {\n    opacity: 0.3;\n    position: absolute;\n    right: 12px;\n    top: 50%;\n    transform: translateY(-50%);\n    width: 16px;\n    height: 16px;\n    background-image: url('data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgdmlld0JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9ImN1cnJlbnRDb2xvciIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiPjxyZWN0IHg9IjMiIHk9IjQiIHdpZHRoPSIxOCIgaGVpZ2h0PSIxOCIgcng9IjIiIHJ5PSIyIj48L3JlY3Q+PGxpbmUgeDE9IjE2IiB5MT0iMiIgeDI9IjE2IiB5Mj0iNiI+PC9saW5lPjxsaW5lIHgxPSI4IiB5MT0iMiIgeDI9IjgiIHkyPSI2Ij48L2xpbmU+PGxpbmUgeDE9IjMiIHkxPSIxMCIgeDI9IjIxIiB5Mj0iMTAiPjwvbGluZT48L3N2Zz4=');\n    background-repeat: no-repeat;\n    background-position: center;\n    pointer-events: none;\n  }\n  \n  .datepicker-input {\n    width: 100%;\n    padding: 8px 12px;\n    border: 1px solid hsl(var(--color-border-default));\n    border-radius: 6px;\n    font-size: 14px;\n    line-height: 1.5;\n    color: hsl(var(--color-text-default));\n    background-color: hsl(var(--color-bg-default));\n    cursor: pointer;\n    color: hsl(var(--color-text-secondary));\n  }\n  \n  .datepicker-input::-webkit-calendar-picker-indicator {\n    position: absolute;\n    left: 0;\n    top: 0;\n    width: 100%;\n    height: 100%;\n    margin: 0;\n    padding: 0;\n    cursor: pointer;\n    opacity: 0;\n  }\n  \n  .datepicker-input:focus {\n    outline: none;\n    border-color: #0188fb;\n    box-shadow: 0 0 0 3px rgba(0, 0, 0, 0.1);\n  }\n";
 export declare const injectDatepickerStyles: () => void;