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

package/dist/index.d.ts

@@ -4,12 +4,22 @@ export { formulaResponseUiSync } from './editor/utils/formula-ui-sync';
 export { executeStringFunction } from './editor/utils/executeStringFunction';
 export { FLVURL } from '@fileverse-dev/formulajs';
 export { loadLocale } from './sheet-engine/core';
-export type { ErrorMessageHandlerReturnType } from './editor/types';
+export type { ErrorMessageHandlerReturnType, DataBlockEvent, DataBlockEventType, ApiKeyStorage } from './editor/types';
+export type { PanelConfig, PanelId, BuiltInPanelType } from './editor/types';
+export type { CommentThread, CommentReply, CommentActionParams, CommentsConfig, } from './editor/types/comments';
+export { CommentAction } from './editor/types/comments';
+export { CommentsContent } from './editor/components/comments/comment-sidebar';
+export { CommentCellUI } from './editor/components/comments/comment-cell-popup';
+export { useEnsStatus } from './editor/components/comments/ens/use-ens-status';
+export type { EnsStatus } from './editor/components/comments/ens/ens-cache';
+export type { SmartContractConfig, SmartContractEvent, SmartContractEventType, ContractConfig, ContractRegistry, NewContractInput, } from './editor/types/smart-contract';
+export { SupportedChain } from './editor/types/smart-contract';
 export type { WorkbookInstance } from './sheet-engine/react';
 export type { CollaborationProps, CollabConnectionConfig, CollabSessionMeta, CollabServices, CollabCallbacks, CollabState, CollabStatus, CollabError, CollabErrorCode, CollabUser, } from './sync-local/types';
 export { ERROR_MESSAGES_FLAG, SERVICES_API_KEY, } from './editor/constants/shared-constants';
 export { TEMPLATES } from '@fileverse-dev/dsheets-templates/template-metadata-list';
 export { handleCSVUpload } from './editor/utils/csv-import';
+export { importSpreadsheetFile, type ImportSpreadsheetFileOptions, type ImportSpreadsheetFileResult, type SpreadsheetImportFileType, } from './editor/utils/spreadsheet-import';
 export { handleExportToXLSX } from './editor/utils/xlsx-export';
 export { handleExportToCSV } from './editor/utils/csv-export';
 export { handleExportToJSON } from './editor/utils/json-export';

package/dist/index.es.js

@@ -1,53 +1,59 @@
-import { S as s, a as o, i as t, T as r, b as l, d as n, e as d, f as i, g as S, h as c, j as h, k as m, l as p, n as u, o as C, p as E, q as g, r as F, s as x, t as R, u as f, v as L, w as b, x as w, z as A, A as T, B as v, C as I, D, E as M, F as V, G as k } from "./index-Drl8OuI3.js";
-import { bP as z, bQ as X, bR as _, bV as y, bg as B, e as G, f as O, h as U, a as j, cf as q, aq as H, cm as J } from "./executeStringFunction-BkmJj04p.js";
-import { FLVURL as N } from "@fileverse-dev/formulajs";
-import { E as Y, S as Z } from "./constants-yStXQJiK.js";
+import { C as s, a as t, b as o, S as l, d as r, i as n, e as d, T as c, f as i, g as S, h, j as m, k as p, l as C, n as u, o as E, p as g, q as F, s as x, t as R, u as f, v as A, w as L, x as w, z as I, A as T, B as v, D, E as M } from "./index-C7kCuqoG.js";
+import { ce as V, cf as X, cg as b, cl as z, bd as P, e as U, f as _, l as y, a as B, cW as O, cX as Y, aY as j, cY as G, cZ as H, d1 as J, d2 as Z, d4 as q, D as K, di as N, dJ as W, aR as Q } from "./executeStringFunction-B2qjYgmE.js";
+import { FLVURL as ee } from "@fileverse-dev/formulajs";
+import { E as se, S as te } from "./constants-Cdz6oSCq.js";
 export {
-  s as DSheetEditor,
-  o as DSheetSkeleton,
-  Y as ERROR_MESSAGES_FLAG,
-  N as FLVURL,
-  t as FortuneCore,
-  Z as SERVICES_API_KEY,
-  r as TEMPLATES,
-  l as api,
-  z as clearColumnsCellsFormat,
-  n as clearFilter,
+  s as CommentAction,
+  t as CommentCellUI,
+  o as CommentsContent,
+  l as DSheetEditor,
+  r as DSheetSkeleton,
+  se as ERROR_MESSAGES_FLAG,
+  ee as FLVURL,
+  n as FortuneCore,
+  te as SERVICES_API_KEY,
+  d as SupportedChain,
+  c as TEMPLATES,
+  i as api,
+  V as clearColumnsCellsFormat,
+  S as clearFilter,
   X as clearRowsCellsFormat,
-  _ as clearSelectedCellFormat,
-  d as createFilter,
-  y as deleteRowCol,
-  B as deleteSelectedCellText,
-  i as describeMatchedShortcut,
-  G as executeStringFunction,
-  O as formulaResponseUiSync,
-  U as getFlowdata,
-  S as getRemoveDuplicatesErrorMessage,
-  c as getRemoveDuplicatesPreview,
-  j as getSheetIndex,
-  h as handleCSVUpload,
-  m as handleCopy,
-  p as handleExportToCSV,
-  u as handleExportToJSON,
-  C as handleExportToXLSX,
-  E as handleFreeze,
-  g as handleHorizontalAlign,
-  F as handleLink,
-  x as handleMerge,
+  b as clearSelectedCellFormat,
+  h as createFilter,
+  z as deleteRowCol,
+  P as deleteSelectedCellText,
+  m as describeMatchedShortcut,
+  U as executeStringFunction,
+  _ as formulaResponseUiSync,
+  y as getFlowdata,
+  p as getRemoveDuplicatesErrorMessage,
+  C as getRemoveDuplicatesPreview,
+  B as getSheetIndex,
+  u as handleCSVUpload,
+  E as handleCopy,
+  g as handleExportToCSV,
+  F as handleExportToJSON,
+  x as handleExportToXLSX,
+  O as handleFreeze,
+  Y as handleHorizontalAlign,
+  j as handleLink,
+  G as handleMerge,
   R as handlePasteByClick,
-  f as handleSort,
-  L as handleTextSize,
-  b as handleVerticalAlign,
+  H as handleSort,
+  J as handleTextSize,
+  Z as handleVerticalAlign,
+  f as importSpreadsheetFile,
   q as insertRowCol,
-  w as isBrowserZoomShortcut,
-  A as isFormulaListShortcut,
-  T as isOpenShortcutsModalShortcut,
-  H as jfrefreshgrid,
-  J as loadLocale,
-  v as removeActiveImage,
-  I as removeDuplicates,
-  D as showImgChooser,
-  M as toolbarItemClickHandler,
-  V as updateFormat,
-  k as useXLSXImport
+  A as isBrowserZoomShortcut,
+  L as isFormulaListShortcut,
+  w as isOpenShortcutsModalShortcut,
+  K as jfrefreshgrid,
+  N as loadLocale,
+  I as removeActiveImage,
+  T as removeDuplicates,
+  v as showImgChooser,
+  W as toolbarItemClickHandler,
+  Q as updateFormat,
+  D as useEnsStatus,
+  M as useXLSXImport
 };

package/dist/observability/publish-trace.d.ts

@@ -0,0 +1,26 @@
+export type PackagePublishTraceEvent = {
+    kind: 'package-onChange';
+    dsheetId: string;
+    traceId: number;
+    step: string;
+    ms: number;
+    heapMB: number | null;
+    meta?: Record<string, unknown>;
+    outcome?: 'complete' | 'skipped';
+};
+declare global {
+    interface Window {
+        __publishTraceEnabled?: () => boolean;
+        __publishTraceSink?: (event: PackagePublishTraceEvent) => void;
+    }
+}
+export declare class PackagePublishTrace {
+    private readonly dsheetId;
+    private last;
+    private traceId;
+    private finished;
+    constructor(dsheetId: string);
+    mark(step: string, meta?: Record<string, unknown>): void;
+    finish(meta?: Record<string, unknown>): void;
+    skip(reason: string, meta?: Record<string, unknown>): void;
+}

package/dist/sheet-engine/core/api/cell.d.ts

@@ -6,26 +6,6 @@ export declare function getCellValue(ctx: Context, row: number, column: number,
     type?: keyof Cell;
 }): any;
 export declare function setCellValue(ctx: Context, row: number, column: number, value: any, cellInput: HTMLDivElement | null, options?: CommonOptions, callAfterUpdate?: boolean): void;
-/**
- * Apply a cell value coming from a remote RTC peer, verbatim.
- *
- * This differs from `setCellValue` in two important ways and must be used for
- * every Yjs-driven remote apply:
- *
- * 1. It NEVER runs the formula engine and NEVER fires the local-edit hooks
- *    (`onLocalCellEdit` / `afterUpdateCell`). The peer already computed the
- *    value, so we use the synced `v`/`m`/`f` as-is. This avoids both
- *    recomputation divergence and an update loop back into Yjs.
- *
- * 2. It PRESERVES the formula calc list. The regular `setCellValue` object
- *    branch calls `delFunctionGroup`, which removes the cell from `calcChain`
- *    and strips its dependency edges. Because `execFunctionGroup` walks
- *    `calcChain` to decide what to recompute, dropping a formula cell there
- *    permanently breaks its reactivity on that client (even after RTC stops).
- *    Here we instead keep formula cells registered via
- *    `insertUpdateFunctionGroup`, so they stay reactive to future local edits
- *    on both owner and peer.
- */
 export declare function applyRemoteCellValue(ctx: Context, row: number, column: number, value: any, options?: CommonOptions): void;
 export declare function clearCell(ctx: Context, row: number, column: number, options?: CommonOptions): void;
 export declare function setCellFormat(ctx: Context, row: number, column: number, attr: keyof Cell, value: any, options?: CommonOptions): void;

package/dist/sheet-engine/core/api/common.d.ts

@@ -1,12 +1,13 @@
 import { Context } from '../context';
 import { CellMatrix, CellWithRowAndCol, Sheet } from '../types';
+import { CellFormatRange } from '../utils/range-format';
 
 export type CommonOptions = {
     index?: number;
     id?: string;
 };
 export declare const dataToCelldata: (data: CellMatrix | undefined) => CellWithRowAndCol[];
-export declare const celldataToData: (celldata: CellWithRowAndCol[], rowCount?: number, colCount?: number) => CellMatrix | null;
+export declare const celldataToData: (celldata: CellWithRowAndCol[], rowCount?: number, colCount?: number, cellFormatRanges?: CellFormatRange[]) => CellMatrix | null;
 export declare function getSheet(ctx: Context, options?: CommonOptions): Sheet;
 export declare function getSheetWithLatestCelldata(ctx: Context, options?: CommonOptions): {
     celldata: CellWithRowAndCol[];

package/dist/sheet-engine/core/api/index.d.ts

@@ -7,5 +7,6 @@ export * from './rowcol';
 export * from './range';
 export * from './merge';
 export * from './sheet';
+export * from './sheet-flowdata-lifecycle';
 export * from './workbook';
 export * from '../modules/error-state-helpers';

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

@@ -0,0 +1,15 @@
+import { Context } from '../context';
+
+/**
+ * Sheets that must keep dense `data` while `activeSheetId` is active:
+ * the active tab plus any tab referenced by its formulas (deps graph + text scan).
+ */
+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/api/sheet.d.ts

@@ -5,6 +5,11 @@ import { CellMatrix, Sheet } from '../types';
 export declare function getAllSheets(ctx: Context): Sheet[];
 export { getSheet };
 export declare function initSheetData(draftCtx: Context, index: number, newData: Sheet): CellMatrix | null;
+/** Build dense `data` from sparse `celldata` when a sheet is activated or referenced. */
+export declare function ensureSheetFlowdata(ctx: Context, options?: {
+    index?: number;
+    id?: string;
+}): CellMatrix | null;
 export declare function hideSheet(ctx: Context, sheetId: string): void;
 export declare function showSheet(ctx: Context, sheetId: string): void;
 export declare function copySheet(ctx: Context, sheetId: string): void;

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

@@ -1,5 +1,6 @@
 import { SheetConfig, Sheet, Selection, Cell, CommentBox, Rect, Image, Presence, LinkCardProps, FilterOptions, RangeDialogProps, DataRegulationProps, ConditionRulesProps, GlobalCache, CellError } from './types';
 import { FormulaCache } from './modules';
+import { FormulaAsyncEvalJob } from './modules/formula-async-eval';
 import { DateBaseLocale, Hooks } from './settings';
 
 interface MutableRefObject<T> {
@@ -239,6 +240,10 @@ export type Context = {
     luckysheetPaintSingle: boolean;
     defaultCell: Cell;
     groupValuesRefreshData: any[];
+    /** Chunked async formula recalc queue (Step 1 perf). Cleared when job completes. */
+    formulaAsyncEval?: FormulaAsyncEvalJob | null;
+    /** True while `formulaAsyncEval` is draining on the main thread in chunks. */
+    isFormulaCalculating?: boolean;
     /**
      * Incremented when formula `func_selectedrange` moves via keyboard (`rangeOfFormula`)
      * so React re-renders — `FormulaCache` is a class and Immer does not track it.

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

@@ -7,7 +7,7 @@ export { defaultSettings } from './settings';
 export type { Settings, Hooks, DateBaseLocale } from './settings';
 export { handleCopy, handleGlobalKeyDown, handlePaste, handlePasteByClick, fixPositionOnFrozenCells, handleCellAreaMouseDown, handleCellAreaDoubleClick, handleContextMenu, mouseRender, handleOverlayMouseMove, handleOverlayMouseUp, handleRowHeaderMouseDown, handleColumnHeaderMouseDown, handleColSizeHandleMouseDown, handleColSizeHandleDoubleClick, handleRowSizeHandleMouseDown, handleColFreezeHandleMouseDown, handleRowFreezeHandleMouseDown, describeMatchedShortcut, isBrowserZoomShortcut, isOpenShortcutsModalShortcut, isFormulaListShortcut, } from './events';
 export * from './locale';
-export { getBorderInfoComputeRange, getBorderInfoCompute, normalizedCellAttr, normalizedAttr, getCellValue, setCellValue, getRealCellValue, mergeBorder, cancelNormalSelected, updateCell, getRangetxt, getRangeByTxt, isValidRangeText, getInlineStringHTML, applyLinkToSelection, getHyperlinksFromInlineSegments, getUniformLinkFromWindowSelectionInEditor, getHyperlinkAtCaretInContentEditable, getStyleByCell, clearSelectedCellFormat, clearRowsCellsFormat, clearColumnsCellsFormat, clipboard, moveToEnd, getRangeRectsByCharacterOffset, getDateBaseLocale, getCanonicalDateEditFormat, getDateEditFormatForCell, isUsDateBaseLocale, normalizeDateBaseLocale, shouldPreserveDateFormatForEdit, setDateBaseLocale, update, is_date, valueShowEs, isTypedCurrencyDisplayFormat, isCurrencyLikeNumberFormat, buildFiatCurrencyFormat, quoteSsfLiteral, FormulaCache, groupValuesRefresh, execFunctionGroup, setCaretPosition, getrangeseleciton, getFormulaEditorOwner, rangeHightlightselected, handleFormulaInput, israngeseleciton, createRangeHightlight, maybeRecoverDirtyRangeSelection, getFormulaRangeIndexAtCaret, isCaretAtValidFormulaRangeInsertionPoint, isLegacyFormulaRangeMode, markRangeSelectionDirty, setFormulaEditorOwner, functionHTMLGenerate, suppressFormulaRangeSelectionForInitialEdit, rangeSetValue, getFormulaRangeIndexForKeyboardSync, createFormulaRangeSelect, isFormulaReferenceInputMode, seedFormulaFuncSelectedRangeFromLastSelection, initFreeze, isInlineStringCell, getInlineStringNoStyle, rowLocation, rowLocationByIndex, colLocation, colLocationByIndex, insertRowCol, deleteRowCol, hideSelected, showSelected, isShowHidenCR, getFilterHiddenRowsUnionFromFilterMap, getFilterHiddenRowsUnion, ensureManualHiddenInitialized, rebuildRowHiddenUnion, scrollToHighlightCell, selectTitlesMap, selectTitlesRange, defaultLuckysheetSelectRanges, normalizeSelection, syncPrimaryCellActiveFromSelection, selectionIsExactlyOneMergeBlock, setPrimaryCellActive, advancePrimaryCellInLastMultiSelection, snapSheetSelectionFocusToCellPreserveMultiRange, moveHighlightCell, deleteSelectedCellText, selectAll, fixRowStyleOverflowInFreeze, fixColumnStyleOverflowInFreeze, calcSelectionInfo, addSheet, deleteSheet, editSheetName, changeSheet, updateFormat, autoSelectionFormula, handleBold, handleItalic, handleStrikeThrough, handleUnderline, handleHorizontalAlign, handleVerticalAlign, handleTextColor, handleTextBackground, handleBorder, handleMerge, mergeSelectionHasValues, handleSort, getRemoveDuplicatesPreview, removeDuplicates, getRemoveDuplicatesErrorMessage, handleFreeze, handleTextSize, handleSum, handleLink, captureLinkEditorOpenSnapshot, isHyperlinkCreationBlocked, toolbarItemClickHandler, toolbarItemSelectedFunc, handleScreenShot, insertImage, showImgChooser, drawArrow, setEditingComment, removeEditingComment, removeOverShowComment, newComment, editComment, deleteComment, showComments, showHideComment, showHideAllComments, onCommentBoxMoveStart, removeActiveImage, cancelActiveImgItem, onImageMoveStart, onImageResizeStart, createDropCellRange, sortSelection, sortSheetBySelectedColumn, searchAll, searchNext, replace, replaceAll, replaceAllScoped, getSearchIndexArr, getSearchIndexArrAsync, getFindRangeOnCurrentSheet, getQuickSearchIndexArr, getQuickSearchHiddenConfig, getCellHyperlinks, getHyperlinkDisplayTextInCell, getInlineLinkPlainRange, getUniformLinkCoveringPlainRange, getUniformLinkAtPlainOffset, removeHyperlinkForLink, updateHyperlinkForLink, syncLinkCardAfterHyperlinkChange, expandCellRectForMerge, shouldQuickSearchUseAsync, runQuickSearchIndexArrAsync, QUICK_SEARCH_ASYNC_ROW_THRESHOLD, parseRangeText, getCellRowColumn, getCellHyperlink, saveHyperlink, removeHyperlink, showLinkCard, goToLink, isLinkValid, createFilterOptions, clearFilter, clearFilterForColumn, toggleViewerFilter, createFilter, applySheetFilterState, getFilterColumnValues, getFilterColumnColors, orderbydatafiler, saveFilter, onCellsMoveStart, cfSplitRange, updateMoreCell, getRegStr, getDataArr, applyLocation, getOptionValue, getSelectRange, getDropdownList, setDropdownValue, confirmMessage, setConditionRules, CF_DATE_DEFAULT_FORMAT, parseCfDateConditionForUi, formatCfDatePresetSnapshot, parseDdMmYyyyToSerial, handleOverlayTouchStart, handleOverlayTouchEnd, MAX_ZOOM_RATIO, MIN_ZOOM_RATIO, jfrefreshgrid, sanitizeDuneUrl, insertDuneChart, onIframeMoveStart, onIframeResizeStart, onIframeMove, onIframeMoveEnd, onIframeResize, onIframeResizeEnd, setCellError, clearCellError, detectDateFormat, isdatatypemulti, diff, isdatetime, isRealNull, isRealNum, isNumericCellType, iscelldata, getcellrange, cancelFunctionrangeSelected, seletedHighlistByindex, spillSortResult, execfunction, insertUpdateFunctionGroup, remapFormulaReferencesByMap, checkCF, getComputeMap, cancelPaintModel, hideCRCount, getdatabyselection, } from './modules';
+export { getBorderInfoComputeRange, getBorderInfoCompute, normalizedCellAttr, normalizedAttr, getCellValue, setCellValue, getRealCellValue, mergeBorder, cancelNormalSelected, updateCell, getRangetxt, getRangeByTxt, isValidRangeText, getInlineStringHTML, applyLinkToSelection, getHyperlinksFromInlineSegments, getUniformLinkFromWindowSelectionInEditor, getHyperlinkAtCaretInContentEditable, getStyleByCell, clearSelectedCellFormat, clearRowsCellsFormat, clearColumnsCellsFormat, clipboard, moveToEnd, getRangeRectsByCharacterOffset, getDateBaseLocale, getCanonicalDateEditFormat, getDateEditFormatForCell, isUsDateBaseLocale, normalizeDateBaseLocale, shouldPreserveDateFormatForEdit, setDateBaseLocale, update, is_date, valueShowEs, isTypedCurrencyDisplayFormat, isCurrencyLikeNumberFormat, buildFiatCurrencyFormat, quoteSsfLiteral, FormulaCache, groupValuesRefresh, execFunctionGroup, runFormulaEvalChunk, applyWorkerFormulaChunkResults, isFormulaEvalPending, FORMULA_ASYNC_CHUNK_SIZE, FORMULA_ASYNC_EVAL_THRESHOLD, FORMULA_WORKER_CHUNK_SIZE, FORMULA_WORKER_THRESHOLD, setCaretPosition, getrangeseleciton, getFormulaEditorOwner, rangeHightlightselected, handleFormulaInput, israngeseleciton, createRangeHightlight, maybeRecoverDirtyRangeSelection, getFormulaRangeIndexAtCaret, isCaretAtValidFormulaRangeInsertionPoint, isLegacyFormulaRangeMode, markRangeSelectionDirty, setFormulaEditorOwner, functionHTMLGenerate, suppressFormulaRangeSelectionForInitialEdit, rangeSetValue, getFormulaRangeIndexForKeyboardSync, createFormulaRangeSelect, isFormulaReferenceInputMode, seedFormulaFuncSelectedRangeFromLastSelection, initFreeze, isInlineStringCell, getInlineStringNoStyle, rowLocation, rowLocationByIndex, colLocation, colLocationByIndex, insertRowCol, deleteRowCol, hideSelected, showSelected, isShowHidenCR, getFilterHiddenRowsUnionFromFilterMap, getFilterHiddenRowsUnion, ensureManualHiddenInitialized, rebuildRowHiddenUnion, scrollToHighlightCell, selectTitlesMap, selectTitlesRange, defaultLuckysheetSelectRanges, normalizeSelection, syncPrimaryCellActiveFromSelection, selectionIsExactlyOneMergeBlock, setPrimaryCellActive, advancePrimaryCellInLastMultiSelection, snapSheetSelectionFocusToCellPreserveMultiRange, moveHighlightCell, deleteSelectedCellText, selectAll, fixRowStyleOverflowInFreeze, fixColumnStyleOverflowInFreeze, calcSelectionInfo, addSheet, deleteSheet, editSheetName, changeSheet, updateFormat, autoSelectionFormula, handleBold, handleItalic, handleStrikeThrough, handleUnderline, handleHorizontalAlign, handleVerticalAlign, handleTextColor, handleTextBackground, handleBorder, handleMerge, mergeSelectionHasValues, handleSort, getRemoveDuplicatesPreview, removeDuplicates, getRemoveDuplicatesErrorMessage, handleFreeze, handleTextSize, handleSum, handleLink, captureLinkEditorOpenSnapshot, isHyperlinkCreationBlocked, toolbarItemClickHandler, toolbarItemSelectedFunc, handleScreenShot, insertImage, showImgChooser, drawArrow, setEditingComment, removeEditingComment, removeOverShowComment, newComment, editComment, deleteComment, showComments, showHideComment, showHideAllComments, onCommentBoxMoveStart, removeActiveImage, cancelActiveImgItem, onImageMoveStart, onImageResizeStart, createDropCellRange, sortSelection, sortSheetBySelectedColumn, searchAll, searchNext, replace, replaceAll, replaceAllScoped, getSearchIndexArr, getSearchIndexArrAsync, getFindRangeOnCurrentSheet, getQuickSearchIndexArr, getQuickSearchHiddenConfig, getCellHyperlinks, getHyperlinkDisplayTextInCell, getInlineLinkPlainRange, getUniformLinkCoveringPlainRange, getUniformLinkAtPlainOffset, removeHyperlinkForLink, updateHyperlinkForLink, syncLinkCardAfterHyperlinkChange, expandCellRectForMerge, shouldQuickSearchUseAsync, runQuickSearchIndexArrAsync, QUICK_SEARCH_ASYNC_ROW_THRESHOLD, parseRangeText, getCellRowColumn, getCellHyperlink, saveHyperlink, removeHyperlink, showLinkCard, goToLink, isLinkValid, createFilterOptions, clearFilter, clearFilterForColumn, toggleViewerFilter, createFilter, applySheetFilterState, getFilterColumnValues, getFilterColumnColors, orderbydatafiler, saveFilter, onCellsMoveStart, cfSplitRange, updateMoreCell, getRegStr, getDataArr, applyLocation, getOptionValue, getSelectRange, getDropdownList, setDropdownValue, confirmMessage, setConditionRules, CF_DATE_DEFAULT_FORMAT, parseCfDateConditionForUi, formatCfDatePresetSnapshot, parseDdMmYyyyToSerial, handleOverlayTouchStart, handleOverlayTouchEnd, MAX_ZOOM_RATIO, MIN_ZOOM_RATIO, jfrefreshgrid, sanitizeDuneUrl, insertDuneChart, onIframeMoveStart, onIframeResizeStart, onIframeMove, onIframeMoveEnd, onIframeResize, onIframeResizeEnd, setCellError, clearCellError, detectDateFormat, isdatatypemulti, diff, isdatetime, isRealNull, isRealNum, isNumericCellType, iscelldata, getcellrange, cancelFunctionrangeSelected, seletedHighlistByindex, spillSortResult, execfunction, insertUpdateFunctionGroup, remapFormulaReferencesByMap, checkCF, getComputeMap, cancelPaintModel, hideCRCount, getdatabyselection, } from './modules';
 export type { FilterDate, FilterValue, FilterColor } from './modules';
 export { getFreezeState, toggleFreeze, indexToColumnChar, escapeScriptTag, escapeHTMLTag, getSheetIndex, replaceHtml, isAllowEdit, isAllowEditReadOnly, filterPatch, patchToOp, opToPatch, inverseRowColOptions, } from './utils';
 export type { PatchOptions, ChangedSheet } from './utils';

package/dist/sheet-engine/core/modules/formula-async-eval.d.ts

@@ -0,0 +1,53 @@
+/** Minimum formula count before deferring eval to chunked async (Step 1). */
+export declare const FORMULA_ASYNC_EVAL_THRESHOLD = 15;
+/** Formulas evaluated per animation frame during async recalc. */
+export declare const FORMULA_ASYNC_CHUNK_SIZE = 50;
+/** Use a Web Worker when the async job has at least this many formulas. */
+export declare const FORMULA_WORKER_THRESHOLD = 100;
+/** Formulas evaluated per worker message (larger — runs off main thread). */
+export declare const FORMULA_WORKER_CHUNK_SIZE = 300;
+/** Maximum time to wait for a worker chunk before falling back to the real engine. */
+export declare const FORMULA_WORKER_CHUNK_TIMEOUT_MS = 30000;
+/** localStorage key for the optional formula execution debug panel. */
+export declare const FORMULA_EXEC_DEBUG_STORAGE_KEY = "fortune-formula-execution-debug";
+export declare function isFormulaExecutionDebugEnabled(): boolean;
+export type FormulaEvalDebugMode = 'worker' | 'main-thread' | 'fallback';
+export type FormulaEvalDebug = {
+    mode: FormulaEvalDebugMode;
+    lastChunkMs: number;
+    lastChunkSize: number;
+    completedChunks: number;
+    fallbackChunks: number;
+    workerAvailable: boolean;
+    unsafeFormulaCount: number;
+    workerFormulaCount: number;
+    totalWorkerFormulas: number;
+    totalMainThreadFormulas: number;
+    lastError: string | null;
+};
+export type FormulaAsyncEvalJob = {
+    formulaRunList: Array<{
+        r: number;
+        c: number;
+        id: string;
+        calc_funcStr: string;
+        level?: number;
+    }>;
+    calcChainKeys: string[];
+    impactedByCircular: string[];
+    cycleNodes: string[];
+    workerSnapshotKey: string;
+    nextIndex: number;
+    total: number;
+    debug?: FormulaEvalDebug;
+};
+export declare function isFormulaEvalPending(ctx: {
+    isFormulaCalculating?: boolean;
+    formulaAsyncEval?: FormulaAsyncEvalJob | null;
+}): boolean;
+/**
+ * The worker snapshot evaluator intentionally handles only scalar formulas that
+ * mirror the main engine well. Dynamic/spill/range-indirection formulas stay on
+ * the main thread so `spillSortResult` and special range logic remain authoritative.
+ */
+export declare function isFormulaWorkerUnsafe(calcFuncStr: string): boolean;

package/dist/sheet-engine/core/modules/formula-eval.worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/sheet-engine/core/modules/formula-range-cache.d.ts

@@ -0,0 +1,20 @@
+export type RangePassCacheEntry = {
+    fragment: any[][];
+    cryptoDenomination: string;
+    cryptoDecimal: number;
+    globalDataKeysFingerprint: string;
+};
+export declare function makeRangePassCacheKey(sheetId: string, startRow: number, endRow: number, startCol: number, endCol: number): string;
+export declare function collectGlobalDataKeysInRange(execFunctionGlobalData: Record<string, unknown>, sheetId: string, startRow: number, endRow: number, startCol: number, endCol: number): string;
+/** Remove the formula origin cell from a full rectangular range fragment. */
+export declare function sliceRangeFragmentForOrigin(full: any[][], startRow: number, startCol: number, originRow: number | null | undefined, originCol: number | null | undefined): any[][];
+type RangeCacheHost = {
+    rangeValuePassCache?: Map<string, RangePassCacheEntry>;
+    rangeValuePassCacheStats?: {
+        hits: number;
+        misses: number;
+    };
+};
+export declare function beginRangeValuePassCache(cache: RangeCacheHost): void;
+export declare function clearRangeValuePassCache(cache: RangeCacheHost): void;
+export {};

package/dist/sheet-engine/core/modules/formula-snapshot-eval.d.ts

@@ -0,0 +1,40 @@
+import { CellMatrix } from '../types';
+
+export type SnapshotSheet = {
+    id: string;
+    name: string;
+    data: CellMatrix | null | undefined;
+};
+export type SnapshotFormulaCell = {
+    r: number;
+    c: number;
+    id: string;
+    calc_funcStr: string;
+};
+export type SnapshotFormulaResult = {
+    r: number;
+    c: number;
+    id: string;
+    v: unknown;
+    f: string;
+    spe?: unknown;
+    deps: string[];
+    isError: boolean;
+};
+export type SnapshotEvalInput = {
+    sheets: SnapshotSheet[];
+    execFunctionGlobalData: Record<string, {
+        v: unknown;
+        f: unknown;
+    }>;
+    formulas: SnapshotFormulaCell[];
+};
+export type SnapshotEvalOutput = {
+    execFunctionGlobalData: Record<string, {
+        v: unknown;
+        f: unknown;
+    }>;
+    results: SnapshotFormulaResult[];
+};
+/** Worker-safe formula evaluation against plain sheet snapshots (no React/immer). */
+export declare function evalFormulasInSnapshot(input: SnapshotEvalInput): SnapshotEvalOutput;

package/dist/sheet-engine/core/modules/formula-transitive-deps.d.ts

@@ -0,0 +1,7 @@
+/** Cell / formula key format used in depsByCell and revDepsByCell. */
+export declare function toFormulaDepCellKey(sheetId: string, r: number, c: number): string;
+/**
+ * Walk revDepsByCell from a changed cell to collect every formula cell that
+ * must recalculate (direct + transitive dependents).
+ */
+export declare function collectTransitiveFormulaDependents(originCellKey: string, revDepsByCell: Map<string, Set<string>>): Set<string>;

package/dist/sheet-engine/core/modules/formula-worker-bridge.d.ts

@@ -0,0 +1,17 @@
+import { Context } from '../context';
+import { SnapshotEvalInput, SnapshotEvalOutput, SnapshotFormulaCell, evalFormulasInSnapshot } from './formula-snapshot-eval';
+import { FORMULA_WORKER_CHUNK_SIZE } from './formula-async-eval';
+
+export declare function invalidateFormulaWorkerSnapshot(): void;
+export declare function buildSnapshotEvalInput(ctx: Context, formulas: SnapshotFormulaCell[]): SnapshotEvalInput;
+export declare function buildWorkerEvalInput(ctx: Context, formulas: SnapshotFormulaCell[]): Omit<SnapshotEvalInput, 'sheets'>;
+export declare function initFormulaWorkerSnapshot(ctx: Context, snapshotKey: string): boolean;
+/**
+ * Evaluate a formula chunk off the critical UI path when possible.
+ * Uses an inline Web Worker. Callers should fall back to the real engine on
+ * rejection so the worker cannot silently leave a recalculation job hanging.
+ */
+export declare function evalFormulasInBackground(snapshotKey: string, input: Omit<SnapshotEvalInput, 'sheets'>): Promise<SnapshotEvalOutput>;
+/** @deprecated Use evalFormulasInBackground */
+export declare const evalFormulasInWorker: typeof evalFormulasInBackground;
+export { FORMULA_WORKER_CHUNK_SIZE, evalFormulasInSnapshot };

package/dist/sheet-engine/core/modules/formula-worker-types.d.ts

@@ -0,0 +1,24 @@
+import { SnapshotEvalInput, SnapshotEvalOutput, SnapshotSheet } from './formula-snapshot-eval';
+
+export type WorkerInitSnapshotRequest = {
+    type: 'init-snapshot';
+    snapshotKey: string;
+    sheets: SnapshotSheet[];
+};
+export type WorkerEvalRequest = {
+    type: 'eval';
+    requestId: number;
+    snapshotKey: string;
+    input: Omit<SnapshotEvalInput, 'sheets'>;
+};
+export type WorkerRequest = WorkerInitSnapshotRequest | WorkerEvalRequest;
+export type WorkerEvalResponse = {
+    type: 'eval-result';
+    requestId: number;
+    output: SnapshotEvalOutput;
+};
+export type WorkerEvalError = {
+    type: 'eval-error';
+    requestId: number;
+    message: string;
+};

package/dist/sheet-engine/core/modules/formula.d.ts

@@ -1,5 +1,8 @@
-import { Cell, Rect, Selection } from '../types';
+import { Cell, CellMatrix, Rect, Selection } from '../types';
 import { Context } from '../context';
+import { FormulaAsyncEvalJob } from './formula-async-eval';
+import { RangePassCacheEntry } from './formula-range-cache';
+import { SnapshotEvalOutput } from './formula-snapshot-eval';
 
 /** True when the formula is only numeric ops on TODAY()/NOW() (incl. unary +/−); used to display serials as dates. */
 export declare function isTodayNowPureArithmeticDateResult(formula: string, value: number): boolean;
@@ -37,6 +40,12 @@ export declare class FormulaCache {
     depsByCell: Map<string, Set<string>>;
     /** Reverse dependency graph: referenced cell -> dependent formula cells. */
     revDepsByCell: Map<string, Set<string>>;
+    /**
+     * Formulas that referenced a range too large to fully expand into `revDepsByCell`.
+     * These must be included on incremental recalcs because a single-cell edit may
+     * affect them even when no precise reverse edge exists.
+     */
+    formulasWithWideRangeDeps: Set<string>;
     /**
      * Dependency collection state for the currently-parsed formula, set by `execfunction`.
      * When null, dependency recording is disabled.
@@ -44,8 +53,20 @@ export declare class FormulaCache {
     activeDepCollection: null | {
         originKey: string;
         deps: Set<string>;
+        hasWideRangeDep: boolean;
+    };
+    /** Step 2: per execFunctionGroup pass cache for materialized range reads. */
+    rangeValuePassCache?: Map<string, RangePassCacheEntry>;
+    rangeValuePassCacheStats?: {
+        hits: number;
+        misses: number;
     };
     constructor();
+    materializeFullRangeFragment(context: Context, sheetId: string, flowdata: CellMatrix | null | undefined, startRow: number, endRow: number, startCol: number, endCol: number): {
+        fragment: any[][];
+        cryptoDenomination: string;
+        cryptoDecimal: number;
+    };
     tryGetCellAsNumber(cell: Cell): string | number | boolean | undefined;
 }
 export declare function iscelldata(txt: string): boolean;
@@ -55,6 +76,10 @@ export declare function delFunctionGroup(ctx: Context, r: number, c: number, id?
 export declare function insertUpdateFunctionGroup(ctx: Context, r: number, c: number, id?: string, calcChainSet?: Set<string>): void;
 export declare function execfunction(ctx: Context, txt: string, r: number, c: number, id?: string, calcChainSet?: Set<string>, isrefresh?: boolean, notInsertFunc?: boolean): any[];
 export declare function groupValuesRefresh(ctx: Context): void;
+/** Apply worker chunk output onto the live context (main thread only). */
+export declare function applyWorkerFormulaChunkResults(ctx: Context, output: SnapshotEvalOutput, impactedByCircular: Set<string>, cycleNodes: Set<string>, calcChainKeys?: string[], data?: CellMatrix | null): void;
+/** Run up to `chunkSize` formulas from an async job. Returns true when job is complete. */
+export declare function runFormulaEvalChunk(ctx: Context, job: FormulaAsyncEvalJob, chunkSize?: number): boolean;
 export declare function execFunctionGroup(ctx: Context, origin_r: number, origin_c: number, value: any, id?: string, data?: any, isForce?: boolean): void;
 /**
  * Before the first `moveHighlightCell/Range(..., "rangeOfFormula")` while editing

package/dist/sheet-engine/core/modules/index.d.ts

@@ -5,6 +5,8 @@ export { moveToEnd, getRangeRectsByCharacterOffset } from './cursor';
 export { getDateBaseLocale, getCanonicalDateEditFormat, getDateEditFormatForCell, isUsDateBaseLocale, normalizeDateBaseLocale, shouldPreserveDateFormatForEdit, setDateBaseLocale, } from './date-base-locale';
 export { update, is_date, valueShowEs, isTypedCurrencyDisplayFormat, isCurrencyLikeNumberFormat, buildFiatCurrencyFormat, quoteSsfLiteral, } from './format';
 export { FormulaCache, groupValuesRefresh, setCaretPosition, getrangeseleciton, getFormulaEditorOwner, rangeHightlightselected, handleFormulaInput, israngeseleciton, createRangeHightlight, createFormulaRangeSelect, maybeRecoverDirtyRangeSelection, delFunctionGroup, functionHTMLGenerate, onFormulaRangeDragEnd, rangeDrag, rangeSetValue, remapFormulaReferencesByMap, getFormulaRangeIndexAtCaret, isCaretAtValidFormulaRangeInsertionPoint, isLegacyFormulaRangeMode, markRangeSelectionDirty, getFormulaRangeIndexForKeyboardSync, isFormulaReferenceInputMode, seedFormulaFuncSelectedRangeFromLastSelection, functionStrChange, setFormulaEditorOwner, getAllFunctionGroup, suppressFormulaRangeSelectionForInitialEdit, } from './formula';
+export { FORMULA_ASYNC_CHUNK_SIZE, FORMULA_ASYNC_EVAL_THRESHOLD, FORMULA_WORKER_CHUNK_SIZE, FORMULA_WORKER_THRESHOLD, isFormulaEvalPending, } from './formula-async-eval';
+export type { FormulaAsyncEvalJob } from './formula-async-eval';
 export { initFreeze } from './freeze';
 export { isInlineStringCell, getInlineStringNoStyle, applyLinkToSelection, getHyperlinksFromInlineSegments, getUniformLinkFromWindowSelectionInEditor, getHyperlinkAtCaretInContentEditable, } from './inline-string';
 export { rowLocation, rowLocationByIndex, colLocation, colLocationByIndex, } from './location';
@@ -40,6 +42,6 @@ export { sanitizeDuneUrl, insertDuneChart, onIframeMoveStart, onIframeResizeStar
 export { setCellError, clearCellError, overShowError, } from './error-state-helpers';
 export { checkCellIsLocked } from './protection';
 export { detectDateFormat, isdatatypemulti, diff, isdatetime, isRealNull, isRealNum, isNumericCellType, } from './validation';
-export { iscelldata, getcellrange, execfunction, execFunctionGroup, insertUpdateFunctionGroup, functionCopy, } from './formula';
+export { iscelldata, getcellrange, execfunction, execFunctionGroup, runFormulaEvalChunk, applyWorkerFormulaChunkResults, insertUpdateFunctionGroup, functionCopy, } from './formula';
 export { checkCF, getComputeMap } from './ConditionFormat';
 export { getdatabyselection, getQKBorder } from './cell';

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

@@ -0,0 +1,23 @@
+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/theme.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Grid (canvas) theming — the single source of truth for the JS-painted grid's per-theme colors.
+ *
+ * The chrome (toolbar, sidebars, comments) themes passively via `@fileverse/ui` `.color-*`
+ * utilities + the `<html>` class. The canvas grid cannot read CSS variables, so `canvas.ts`
+ * resolves its colors from `activePalette` here. On theme change the host threads a `theme` prop
+ * to the engine, which calls `setActiveGridPalette` and repaints via `jfrefreshgrid`.
+ *
+ * `ThemeKey` is copied verbatim from `fileverse-ddoc` `package/types.ts` so the dsheet `theme`
+ * prop is type-identical to ddoc's and a host app can pass the same value to both editors.
+ *
+ * See docs/DROP-IN-PACKAGE-AND-THEMING.md §7 (Theming)
+ */
+export type ThemeKey = 'light' | 'dark' | 'theme-sepia' | 'theme-pink' | 'theme-green';
+export declare const DEFAULT_THEME: ThemeKey;
+/**
+ * dsheet selection-accent brand color. Constant across all five themes (readable on every
+ * background) — intentionally NOT a per-theme palette slot. Used for the fill handle, selection
+ * border, and marching ants.
+ */
+export declare const SELECTION_ACCENT = "#EFC703";
+/**
+ * One slot per neutral grid-chrome color role painted in `canvas.ts`. User-authored cell colors
+ * (cell `bg`/`fc`/border, conditional-format colors) are NOT here — they render literally in every
+ * theme and are read straight from cell data.
+ */
+export interface GridPalette {
+    /** Unset cell background + main-area canvas clear (the `!fillStyle` fallback branch). */
+    cellBg: string;
+    /** Gridlines. */
+    gridLine: string;
+    /** Default cell text (cells with no user `fc`). */
+    cellText: string;
+    /** Row/column header background. */
+    headerBg: string;
+    /** Row/column header text. */
+    headerText: string;
+    /** Secondary fill for on-canvas chips (e.g. data-verification dropdown). */
+    secondaryFill: string;
+    /** Frozen-pane divider line. */
+    freezeLine: string;
+}
+/**
+ * Per-theme grid palettes.
+ *
+ * `light` holds the EXACT pre-theming hex from `canvas.ts`, so the default theme renders
+ * pixel-identical to before this change (regression guard).
+ *
+ * [Unverified] The four non-light palettes are reasonable design-guess values derived from each
+ * theme's surface swatch — NOT final brand colors; they need design sign-off. The mechanism is
+ * independent of the exact values.
+ */
+export declare const GRID_THEMES: Record<ThemeKey, GridPalette>;
+export declare const resolveGridPalette: (theme?: ThemeKey) => GridPalette;
+/**
+ * The palette the canvas paints from. Module-level so the imperative canvas reads it on every
+ * repaint without prop threading inside the engine. `canvas.ts` imports this as a live binding and
+ * reads `activePalette.<slot>` at paint time; reassigning it here updates every reader.
+ *
+ * NOTE: this is a module singleton — multiple workbooks with different themes on one page would
+ * share it. dsheet renders one editor per page (like ddoc), so this is acceptable. If multi-instance
+ * is ever needed, move the palette onto `sheetCtx`.
+ */
+export declare let activePalette: GridPalette;
+/** Swap the active grid palette. Returns true if it actually changed (caller decides to repaint). */
+export declare const setActiveGridPalette: (theme?: ThemeKey) => boolean;
+export declare const getActiveTheme: () => ThemeKey;