@fileverse-dev/dsheet 3.0.2 → 3.0.3

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

@@ -0,0 +1,76 @@
+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[];
+/**
+ * Remap format ranges after a row or column permutation, such as header
+ * drag-and-drop. A contiguous source range can become multiple rectangles
+ * when the moved indices are no longer contiguous.
+ */
+export declare function remapCellFormatRanges(ranges: CellFormatRange[] | undefined, axis: "row" | "column", indexMap: Record<number, number>): CellFormatRange[];
+/**
+ * Move format ranges with a cut-and-paste cell block move. Formatting in both
+ * the old source and the overwritten destination is cleared; only the source
+ * intersection is translated to the target rectangle.
+ */
+export declare function moveCellFormatRanges(ranges: CellFormatRange[] | undefined, source: Pick<CellFormatRange, "row" | "column">, target: Pick<CellFormatRange, "row" | "column">): 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;
+};
+/**
+ * When a cell loses meaningful content but keeps style, put that style back
+ * into cellFormatRanges as a 1x1 (normalize merges with neighbours).
+ */
+export declare function migrateFormatOnlyCellIntoRanges(ranges: CellFormatRange[] | undefined, r: number, c: number, cell: Cell | string | number | boolean | null | undefined): {
+    ranges: CellFormatRange[];
+    changed: boolean;
+};
+/**
+ * Scan a dense-data rectangle and move any format-only cells into
+ * cellFormatRanges. Adjacent identical styles merge via normalize.
+ */
+export declare function migrateFormatOnlyCellsFromData(ranges: CellFormatRange[] | undefined, data: CellMatrix | null | undefined, r1: number, r2: number, c1: number, c2: number): {
+    ranges: CellFormatRange[];
+    changed: boolean;
+};
+export declare function punchHoleInCellFormatRanges(ranges: CellFormatRange[] | undefined, r: number, c: number): CellFormatRange[];
+/**
+ * Remove format coverage for a whole rectangle in O(ranges), not O(area × ranges).
+ * Prefer this over punching cell-by-cell (select-all clear must stay cheap).
+ */
+export declare function removeCellFormatRangesInRect(ranges: CellFormatRange[] | undefined, row: [number, number], column: [number, 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/core/utils/ydoc-celldata-changes.d.ts

@@ -0,0 +1,46 @@
+import { Context } from '../context';
+import { Cell, CellWithRowAndCol } from '../types';
+
+export type CelldataYdocChange = {
+    sheetId: string;
+    path: string[];
+    key?: string;
+    value: any;
+    type?: 'update' | 'delete';
+};
+/** Cheap equality before deep compare — hot path for structural diffs. */
+export declare function cellsEqualForYdocPersist(before: unknown, after: unknown): boolean;
+/**
+ * Snapshot persisted cells in a range.
+ * Prefer sparse `celldata` when provided — O(populated cells), not O(range area).
+ */
+export declare function snapshotPersistedCelldataInRange(data: unknown[][] | null | undefined, r1: number, r2: number, c1: number, c2: number, celldata?: CellWithRowAndCol[] | null): Map<string, Cell | string | number | boolean>;
+export declare function appendCelldataDiffChange(changes: CelldataYdocChange[], sheetId: string, r: number, c: number, cell: unknown, beforePersisted?: Map<string, Cell | string | number | boolean>): void;
+export declare function buildCelldataChangesForRange(sheetId: string, data: unknown[][], r1: number, r2: number, c1: number, c2: number, beforePersisted?: Map<string, Cell | string | number | boolean>): CelldataYdocChange[];
+export declare function emitCelldataRangeDiffToYdoc(ctx: Context, sheetId: string, data: unknown[][], r1: number, r2: number, c1: number, c2: number, beforePersisted?: Map<string, Cell | string | number | boolean>): void;
+/**
+ * After delete row/col, emit deletes for persisted keys that now sit past the
+ * shrunken grid. Range diffs only visit coordinates still inside `data`, so
+ * tail keys would otherwise resurrect on peers/reload.
+ */
+export declare function emitCelldataDeletesBeyondGrid(ctx: Context, sheetId: string, beforePersisted: Map<string, Cell | string | number | boolean> | undefined, rowCount: number, colCount: number): void;
+export type MergeBounds = {
+    minR: number;
+    minC: number;
+    maxR: number;
+    maxC: number;
+};
+/** Disturbed range for insert row/col — snapshot only rows/cols that may shift. */
+export declare function getInsertRowColSnapshotBounds(type: 'row' | 'column', index: number, direction: 'lefttop' | 'rightbottom', rowCount: number, colCount: number, mergeBounds: MergeBounds | null): {
+    r1: number;
+    r2: number;
+    c1: number;
+    c2: number;
+};
+/** Disturbed range for delete row/col — from deletion point to sheet edge. */
+export declare function getDeleteRowColSnapshotBounds(type: 'row' | 'column', start: number, rowCount: number, colCount: number, mergeBounds: MergeBounds | null): {
+    r1: number;
+    r2: number;
+    c1: number;
+    c2: number;
+};

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[], merge?: Record<string, any> | null) => CellMatrix | null;
     insertFunction: (selectedFuncIndex: number, filteredFunctionList: any[], callback?: () => void) => void;
     getLocaleContext: () => any;
     getWorkbookContext: () => Context;

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

@@ -150,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;
@@ -168,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[], merge?: Record<string, any> | null) => CellMatrix | null;
     insertFunction: (selectedFuncIndex: number, filteredFunctionList: any[], callback?: () => void) => void;
     getLocaleContext: () => any;
     getWorkbookContext: () => Context;