@fileverse-dev/dsheet 3.0.1-yjs-15 → 3.0.2-29July-1

package/package.json

@@ -2,7 +2,7 @@
   "name": "@fileverse-dev/dsheet",
   "private": false,
   "description": "DSheet",
-  "version": "3.0.1-yjs-15",
+  "version": "3.0.2-29July-1",
   "main": "dist/index.es.js",
   "module": "dist/index.es.js",
   "exports": {
@@ -112,4 +112,4 @@
     "typescript": "^5.2.2",
     "vite": "^5.0.0"
   }
-}
+}

package/dist/editor/hooks/use-celldata-compaction.d.ts

@@ -1,23 +0,0 @@
-import { MutableRefObject, RefObject } from 'react';
-import { WorkbookInstance, Sheet } from '../../sheet-engine/react';
-
-import type * as Y from 'yjs';
-type UseCelldataCompactionArgs = {
-    dsheetId: string;
-    ydocRef: RefObject<Y.Doc | null>;
-    sheetEditorRef: RefObject<WorkbookInstance | null>;
-    currentDataRef: MutableRefObject<Sheet[]>;
-    handleOnChangePortalUpdate: () => void;
-    syncStatus: 'initializing' | 'syncing' | 'synced' | 'error';
-    isDataLoaded: boolean;
-    isReadOnly: boolean;
-    remoteUpdateRef: MutableRefObject<boolean>;
-    collabSyncing: boolean;
-};
-/**
- * One-shot background compaction: remove committed celldata entries that copy/paste
- * would never write (`shouldPersistCelldataCell` === false). Runs once per dsheetId
- * after the editor is synced and idle so it does not compete with load or edits.
- */
-export declare function useCelldataCompaction({ dsheetId, ydocRef, sheetEditorRef, currentDataRef, handleOnChangePortalUpdate, syncStatus, isDataLoaded, isReadOnly, remoteUpdateRef, collabSyncing, }: UseCelldataCompactionArgs): void;
-export {};

package/dist/editor/utils/compact-committed-celldata.d.ts

@@ -1,28 +0,0 @@
-import { CellMatrix, CellWithRowAndCol, Sheet } from '../../sheet-engine/core/types';
-import { SheetChangePath } from './update-ydoc';
-import * as Y from 'yjs';
-export declare const CELLDATA_COMPACT_STORAGE_KEY_PREFIX = "dsheet-celldata-compact-v1:";
-export type CelldataCompactionResult = {
-    removedFromYdoc: number;
-    clearedInMemory: number;
-    changes: SheetChangePath[];
-};
-export declare function celldataCompactStorageKey(dsheetId: string): string;
-export declare function hasCelldataCompactionCompleted(dsheetId: string): boolean;
-export declare function markCelldataCompactionCompleted(dsheetId: string): void;
-/** Collect Yjs celldata keys that should not be persisted (format-only / empty ghosts). */
-export declare function collectStaleCelldataKeys(celldataMap: Y.Map<unknown> | Record<string, unknown> | null | undefined): string[];
-export declare function buildCelldataDeleteChanges(sheetId: string, keys: string[]): SheetChangePath[];
-/** Null out dense-grid cells that should not be persisted. */
-export declare function compactSheetDataMatrix(data: CellMatrix | null | undefined): number;
-/** Drop sparse celldata entries that should not be persisted. */
-export declare function compactSheetCelldataArray(celldata: CellWithRowAndCol[] | null | undefined): {
-    next: CellWithRowAndCol[];
-    removed: number;
-};
-export declare function compactInMemorySheets(sheets: Sheet[] | null | undefined): number;
-/**
- * Scan Y.Doc for committed celldata ghosts. Does not mutate — caller applies
- * `changes` via `updateYdocSheetData`.
- */
-export declare function planYdocCelldataCompaction(ydoc: Y.Doc, dsheetId: string): CelldataCompactionResult;

package/dist/editor/utils/config-ydoc-update.d.ts

@@ -1,20 +0,0 @@
-import { WorkbookInstance } from '../../sheet-engine/react';
-import { SheetChangePath } from './update-ydoc';
-
-import * as Y from 'yjs';
-/** Diff top-level config sub-keys and emit granular Yjs updates. */
-export declare function buildConfigSubKeyChanges({ sheetId, oldConfig, newConfig, }: {
-    sheetId: string;
-    oldConfig: Record<string, any>;
-    newConfig: Record<string, any>;
-}): SheetChangePath[];
-/**
- * Sync active sheet config sub-keys to Yjs (borderInfo, merge, rowlen, …).
- * Replaces whole-config writes so only changed sub-keys are broadcast.
- */
-export declare const configYdocUpdate: ({ sheetEditorRef, ydocRef, dsheetId, handleContentPortal, }: {
-    sheetEditorRef: React.RefObject<WorkbookInstance | null>;
-    ydocRef: React.RefObject<Y.Doc | null>;
-    dsheetId: string;
-    handleContentPortal?: any;
-}) => void;

package/dist/sheet-engine/core/api/sheet-flowdata-lifecycle.d.ts

@@ -1,17 +0,0 @@
-import { Context } from '../context';
-
-/** Drop cached dense-sheet set (e.g. after structural workbook changes). */
-export declare function invalidateSheetsRequiredDenseCache(): void;
-/**
- * Sheets that must keep dense `data` while `activeSheetId` is active:
- * the active tab, tabs its formulas read, and tabs with formulas that read it.
- */
-export declare function getSheetsRequiredDense(ctx: Context, activeSheetId: string): Set<string>;
-/** Sheets the formula worker needs dense — active refs plus any tab with formulas. */
-export declare function getSheetsNeededForWorkerSnapshot(ctx: Context): Set<string>;
-export declare function demoteSheetToCelldata(ctx: Context, sheetId: string): void;
-/**
- * On tab switch: persist outgoing config, demote tabs not needed dense,
- * hydrate active tab + cross-sheet references.
- */
-export declare function syncAndDemoteInactiveFlowdata(ctx: Context, activeSheetId: string, previousSheetId: string | null): Set<string>;

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

@@ -1,23 +0,0 @@
-export declare function isTransparentBorderColor(color: string): boolean;
-export declare function isMeaningfulBorderSide(side: {
-    style?: number;
-    color?: string;
-} | undefined): boolean;
-export declare function filterMeaningfulBorderSides(sides: {
-    l?: {
-        style?: number;
-        color?: string;
-    };
-    r?: {
-        style?: number;
-        color?: string;
-    };
-    t?: {
-        style?: number;
-        color?: string;
-    };
-    b?: {
-        style?: number;
-        color?: string;
-    };
-}): typeof sides;

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

@@ -1,16 +0,0 @@
-import { Context } from '../context';
-
-export type BorderSelection = {
-    row: [number, number];
-    column: [number, number];
-};
-/**
- * Remap borderInfo after a row/column reorder (header drag).
- * Uses the same old→new index map as remapCellFormatRanges.
- * O(border entries × span) — only runs on drag drop, not per-frame.
- */
-export declare function remapBorderInfo(borderInfo: any[] | undefined, axis: 'row' | 'column', indexMap: Record<number, number>): any[];
-/** 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

@@ -1,10 +0,0 @@
-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;
-/** Pull only present format attrs from a format-only empty cell (cheap, no clone). */
-export declare function extractCellFormatAttrs(cell: Cell | string | number | boolean | null | undefined): Partial<Record<CellFormatAttr, unknown>> | null;
-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

@@ -1,71 +0,0 @@
-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[];
-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

@@ -1,40 +0,0 @@
-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;
-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;
-};