@fileverse-dev/dsheet 4.0.4 → 4.0.5

package/dist/index.es.js

@@ -1,5 +1,5 @@
-import { C as s, a as t, b as o, S as r, d as l, i as d, e as n, T as i, f as S, g as c, h, j as m, k as p, l as C, n as u, o as E, p as F, q as g, s as x, t as R, u as f, v as w, w as A, x as I, z as L, A as T, B as v, D as b, E as D } from "./index-DvwJ-8x8.js";
-import { cr as k, cs as V, ct as y, cy as z, bo as P, e as U, f as X, l as _, a as B, d7 as O, d8 as j, b7 as G, d9 as H, da as q, de as J, df as K, dh as N, I as W, dw as Y, dW as Z, b0 as Q } from "./executeStringFunction-CsLQk-dm.js";
+import { C as s, d as t, f as o, S as r, g as l, h as d, j as n, T as i, k as S, l as c, n as h, o as m, p, q as C, t as u, u as E, v as F, w as g, x, z as R, A as I, B as f, D as w, E as A, F as L, G as T, H as v, I as D, J as M } from "./index-BqGOKo9u.js";
+import { cw as k, cx as V, cy as y, cE as z, bq as G, e as P, f as U, l as X, a as _, dg as j, dh as B, b9 as H, di as O, dj as q, dn as J, dp as K, dr as N, I as Y, dG as Z, ed as Q, b2 as W } from "./executeStringFunction-B6fhDKyN.js";
 import { FLVURL as ee } from "@fileverse-dev/formulajs";
 import { E as se, S as te } from "./constants-CRFfbkoQ.js";
 export {
@@ -21,39 +21,39 @@ export {
   y as clearSelectedCellFormat,
   h as createFilter,
   z as deleteRowCol,
-  P as deleteSelectedCellText,
+  G as deleteSelectedCellText,
   m as describeMatchedShortcut,
-  U as executeStringFunction,
-  X as formulaResponseUiSync,
-  _ as getFlowdata,
+  P as executeStringFunction,
+  U as formulaResponseUiSync,
+  X as getFlowdata,
   p as getRemoveDuplicatesErrorMessage,
   C as getRemoveDuplicatesPreview,
-  B as getSheetIndex,
+  _ as getSheetIndex,
   u as handleCSVUpload,
   E as handleCopy,
   F as handleExportToCSV,
   g as handleExportToJSON,
   x as handleExportToXLSX,
-  O as handleFreeze,
-  j as handleHorizontalAlign,
-  G as handleLink,
-  H as handleMerge,
+  j as handleFreeze,
+  B as handleHorizontalAlign,
+  H as handleLink,
+  O as handleMerge,
   R as handlePasteByClick,
   q as handleSort,
   J as handleTextSize,
   K as handleVerticalAlign,
-  f as importSpreadsheetFile,
+  I as importSpreadsheetFile,
   N as insertRowCol,
-  w as isBrowserZoomShortcut,
-  A as isFormulaListShortcut,
-  I as isOpenShortcutsModalShortcut,
-  W as jfrefreshgrid,
-  Y as loadLocale,
+  f as isBrowserZoomShortcut,
+  w as isFormulaListShortcut,
+  A as isOpenShortcutsModalShortcut,
+  Y as jfrefreshgrid,
+  Z as loadLocale,
   L as removeActiveImage,
   T as removeDuplicates,
   v as showImgChooser,
-  Z as toolbarItemClickHandler,
-  Q as updateFormat,
-  b as useEnsStatus,
-  D as useXLSXImport
+  Q as toolbarItemClickHandler,
+  W as updateFormat,
+  D as useEnsStatus,
+  M as useXLSXImport
 };

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

@@ -56,6 +56,7 @@ export declare function getSheetWithLatestCelldata(ctx: Context, options?: Commo
     luckysheet_conditionformat_save?: any[];
     luckysheet_alternateformat_save?: any[];
     dataVerification?: any;
+    dataVerificationDefs?: any[];
     conditionRules?: import('../types').ConditionRulesProps;
     hyperlink?: Record<string, import('..').HyperlinkEntry | import('..').HyperlinkEntry[]>;
     dynamicArray_compute?: any;

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

@@ -1,4 +1,4 @@
-import { SheetConfig, Sheet, Selection, Cell, CommentBox, Rect, Image, Presence, LinkCardProps, FilterOptions, RangeDialogProps, DataRegulationProps, ConditionRulesProps, GlobalCache, CellError } from './types';
+import { SheetConfig, Sheet, Selection, Cell, CommentBox, Rect, Image, Presence, LinkCardProps, FilterOptions, RangeDialogProps, DataRegulationProps, ConditionRulesProps, GlobalCache, CellError, DefinedName } from './types';
 import { FormulaCache } from './modules';
 import { FormulaAsyncEvalJob } from './modules/formula-async-eval';
 import { DateBaseLocale, Hooks } from './settings';
@@ -116,6 +116,8 @@ export type Context = {
     currentSheetId: string;
     calculateSheetId: string;
     config: SheetConfig;
+    /** Workbook-level named ranges (synced via Yjs `${dsheetId}:definedNames`). */
+    definedNames: DefinedName[];
     visibledatarow: number[];
     visibledatacolumn: number[];
     ch_width: number;

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

@@ -7,11 +7,11 @@ 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, 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, copyActiveImage, cutActiveImage, pasteImageItem, loadImageFromFile, getImageClipboard, getImageCutSourceId, 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, ensureFormulaRangeToSheet, shouldPreserveFormulaEditOnSheetSwitch, activateSheetForNavigation, returnToFormulaOriginSheet, 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, copyActiveImage, cutActiveImage, pasteImageItem, loadImageFromFile, getImageClipboard, getImageCutSourceId, 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, refreshFormulasUsingDefinedNames, checkCF, getComputeMap, isValidDefinedNameIdentifier, getDefinedNameDisplayRange, findDefinedNameForSelection, findDefinedNameByName, resolveDefinedNameForFormula, addDefinedName, updateDefinedName, deleteDefinedName, selectDefinedName, openNamedRangesSidebar, scheduleDefinedNamesSync, shiftDefinedNamesOnInsert, shiftDefinedNamesOnDelete, removeDefinedNamesForSheet, 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';
-export type { Op, Cell, CellWithRowAndCol, CellMatrix, HyperlinkEntry, Selection, Presence, Sheet, GlobalCache, SingleRange, Range, SearchResult, LinkCardProps, LiveQueryData, Freezen, } from './types';
+export type { Op, Cell, CellWithRowAndCol, CellMatrix, HyperlinkEntry, Selection, Presence, Sheet, GlobalCache, SingleRange, Range, SearchResult, LinkCardProps, LiveQueryData, Freezen, DefinedName, } from './types';
 export type { RemoveDuplicatesColumnOption, RemoveDuplicatesError, RemoveDuplicatesOptions, RemoveDuplicatesPreview, RemoveDuplicatesResult, } from './modules';
 export type { CheckModes, HyperlinkMap, FindSearchScope, ReplaceScope, SearchHiddenConfig, SearchNextResult, ReplaceAllResult, } from './modules/searchReplace';
 export { cellFadeAnimator, markCellChanged } from './animate';

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

@@ -28,6 +28,17 @@ export type SnapshotEvalInput = {
         f: unknown;
     }>;
     formulas: SnapshotFormulaCell[];
+    /** Workbook-level named ranges for VARIABLE resolution. */
+    definedNames?: Array<{
+        name: string;
+        sheetId: string;
+        range: {
+            row: [number, number];
+            column: [number, number];
+        };
+        scope?: 'workbook' | 'sheet';
+        localSheetId?: string;
+    }>;
 };
 export type SnapshotEvalOutput = {
     execFunctionGlobalData: Record<string, {

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

@@ -31,6 +31,11 @@ export declare class FormulaCache {
     /** True after arrow/Shift+arrow moved `func_selectedrange` without updating yellow selection. */
     formulaKeyboardRefSync?: boolean;
     formulaEditorOwner?: 'cell' | 'fx' | null;
+    /**
+     * Set when switching sheets while a formula edit stays open so InputBox/Fx
+     * can restore focus/caret for continued keyboard ref picking.
+     */
+    refocusFormulaEditorAfterSheetSwitch?: boolean;
     functionRangeIndex?: number[];
     functionRangeGlobalOffset?: number | null;
     functionlistMap: any;
@@ -80,6 +85,11 @@ export declare function groupValuesRefresh(ctx: Context): void;
 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;
+/**
+ * Re-evaluate formula cells that reference the given defined names
+ * (e.g. after a named range was edited, shifted, or deleted).
+ */
+export declare function refreshFormulasUsingDefinedNames(ctx: Context, names: string[]): void;
 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
@@ -102,6 +112,23 @@ export declare function getLastFormulaRangeIndex($editor: HTMLDivElement): numbe
 export declare function getFormulaRangeIndexAtCaret($editor: HTMLDivElement): number | null;
 export declare function setFormulaEditorOwner(ctx: Context, owner: 'cell' | 'fx' | null): void;
 export declare function getFormulaEditorOwner(ctx: Context): 'cell' | 'fx' | null;
+/**
+ * Record the sheet where the formula edit started so cross-sheet picks can emit
+ * `SheetName!A1` via `rangeSetValue` / `getRangetxt`.
+ */
+export declare function ensureFormulaRangeToSheet(ctx: Context): void;
+/** True while an in-cell / fx formula edit should survive sheet-tab switches. */
+export declare function shouldPreserveFormulaEditOnSheetSwitch(ctx: Context): boolean;
+/**
+ * Activate another sheet from tab click or Alt/Option+Arrow navigation.
+ * Returns whether the sheet changed and whether formula edit was preserved.
+ */
+export declare function activateSheetForNavigation(ctx: Context, targetSheetId: string): 'preserved-formula' | 'cancel-edit' | false;
+/**
+ * Switch back to the formula's origin sheet (and restore its scroll/selection)
+ * before commit or cancel. Returns true when a switch happened.
+ */
+export declare function returnToFormulaOriginSheet(ctx: Context): boolean;
 /**
  * True when the formula text looks like a truncated A1-style range: LHS has a row
  * number but RHS after ":" is only column letters (e.g. =A1:A after deleting the

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

@@ -4,7 +4,7 @@ export { default as clipboard } from './clipboard';
 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 { 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, ensureFormulaRangeToSheet, shouldPreserveFormulaEditOnSheetSwitch, activateSheetForNavigation, returnToFormulaOriginSheet, } 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';
@@ -42,6 +42,7 @@ 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, runFormulaEvalChunk, applyWorkerFormulaChunkResults, insertUpdateFunctionGroup, functionCopy, } from './formula';
+export { iscelldata, getcellrange, execfunction, execFunctionGroup, refreshFormulasUsingDefinedNames, runFormulaEvalChunk, applyWorkerFormulaChunkResults, insertUpdateFunctionGroup, functionCopy, } from './formula';
 export { checkCF, getComputeMap } from './ConditionFormat';
+export { isValidDefinedNameIdentifier, getDefinedNameDisplayRange, findDefinedNameForSelection, findDefinedNameByName, resolveDefinedNameForFormula, addDefinedName, updateDefinedName, deleteDefinedName, selectDefinedName, openNamedRangesSidebar, scheduleDefinedNamesSync, shiftDefinedNamesOnInsert, shiftDefinedNamesOnDelete, removeDefinedNamesForSheet, } from './namedRanges';
 export { getdatabyselection, getQKBorder } from './cell';

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

@@ -0,0 +1,53 @@
+import { Context } from '../context';
+import { DefinedName, SingleRange } from '../types';
+
+/** Excel/Google: names must start with letter/underscore; no spaces; not a cell ref. */
+export declare function isValidDefinedNameIdentifier(name: string): boolean;
+export declare function getDefinedNameDisplayRange(ctx: Context, dn: DefinedName): string;
+export declare function findDefinedNameForSelection(ctx: Context): DefinedName | null;
+export declare function findDefinedNameByName(ctx: Context, name: string, excludeId?: string): DefinedName | null;
+/**
+ * Resolve a formula VARIABLE (e.g. `=SUM(Custom)`) to a defined name.
+ * Prefers sheet-scoped names matching `formulaSheetId`, then workbook-scoped.
+ */
+export declare function resolveDefinedNameForFormula(definedNames: DefinedName[] | undefined | null, name: string, formulaSheetId?: string): DefinedName | null;
+export declare function addDefinedName(ctx: Context, input: {
+    name: string;
+    sheetId: string;
+    range: SingleRange;
+    scope?: DefinedName['scope'];
+    localSheetId?: string;
+}): {
+    ok: true;
+    namedRange: DefinedName;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function updateDefinedName(ctx: Context, id: string, patch: {
+    name?: string;
+    sheetId?: string;
+    range?: SingleRange;
+}): {
+    ok: true;
+    namedRange: DefinedName;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function deleteDefinedName(ctx: Context, id: string): boolean;
+/** Jump to a named range (switch sheet if needed) and select its cells. */
+export declare function selectDefinedName(ctx: Context, id: string): boolean;
+export declare function openNamedRangesSidebar(): void;
+/**
+ * Defer Yjs sync until after Immer applies the draft (same pattern as
+ * sheet-metadata-hooks). Capture the hook fn — not `ctx.hooks` — so the
+ * draft proxy is not read after revoke.
+ */
+export declare function scheduleDefinedNamesSync(ctx: Context): void;
+/** Shift named ranges on the given sheet after row/col insert. Returns affected names. */
+export declare function shiftDefinedNamesOnInsert(ctx: Context, sheetId: string, type: 'row' | 'column', index: number, count: number, direction: 'lefttop' | 'rightbottom'): string[];
+/** Shift/remove named ranges on the given sheet after row/col delete. */
+export declare function shiftDefinedNamesOnDelete(ctx: Context, sheetId: string, type: 'row' | 'column', start: number, end: number): string[];
+/** Drop named ranges that pointed at a deleted sheet. */
+export declare function removeDefinedNamesForSheet(ctx: Context, deletedSheetId: string): string[];

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

@@ -21,3 +21,5 @@ export declare function filterMeaningfulBorderSides(sides: {
         color?: string;
     };
 }): typeof sides;
+/** Drop junk borderInfo entries. Returns undefined when unchanged. */
+export declare function compactBorderInfo(borderInfo: any[] | undefined): any[] | undefined;

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

@@ -22,6 +22,8 @@ export type Hooks = {
     filterChange?: () => void;
     cellDataChange?: () => void;
     hyperlinkChange?: () => void;
+    /** Workbook-level named ranges (definedNames) changed — sync to Yjs. */
+    definedNamesChange?: () => void;
     updateCellYdoc?: (changes: SheetChangePath[]) => void;
     updateAllCell?: (sheetId: string, caller?: string) => void;
     beforeUpdateCell?: (r: number, c: number, value: any) => boolean;

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

@@ -143,10 +143,29 @@ export type SheetConfig = {
     borderInfo?: any[];
     /** Range-level cell formatting for empty cells (toolbar bulk format). */
     cellFormatRanges?: CellFormatRange[];
+    /** Background compaction revision (celldata + borderInfo); synced via Yjs. */
+    sheetCompactionRev?: number;
     authority?: any;
     rowReadOnly?: Record<number, number>;
     colReadOnly?: Record<number, number>;
 };
+/**
+ * Workbook-level named range (Google Sheets / Excel definedNames).
+ * Runtime list lives on Context; persisted in Yjs as `${dsheetId}:definedNames`.
+ */
+export type DefinedName = {
+    id: string;
+    name: string;
+    sheetId: string;
+    range: {
+        row: [number, number];
+        column: [number, number];
+    };
+    scope: 'workbook' | 'sheet';
+    /** When scope === 'sheet', which sheet owns the name. */
+    localSheetId?: string;
+    comment?: string;
+};
 export type Image = {
     id: string;
     width: number;
@@ -246,6 +265,8 @@ export type Sheet = {
     luckysheet_conditionformat_save?: any[];
     luckysheet_alternateformat_save?: any[];
     dataVerification?: any;
+    /** Interned dataVerification entries; per-cell map may hold numeric refs into this list. */
+    dataVerificationDefs?: any[];
     conditionRules?: ConditionRulesProps;
     hyperlink?: Record<string, HyperlinkEntry | HyperlinkEntry[]>;
     dynamicArray_compute?: any;

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

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+
+declare const NamedRanges: React.FC;
+export default NamedRanges;

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

@@ -119,6 +119,7 @@ export declare function generateAPIs(context: Context, setContext: (recipe: (ctx
         luckysheet_conditionformat_save?: any[];
         luckysheet_alternateformat_save?: any[];
         dataVerification?: any;
+        dataVerificationDefs?: any[];
         conditionRules?: import('../../../core/types').ConditionRulesProps;
         hyperlink?: Record<string, import('../../../core').HyperlinkEntry | import('../../../core').HyperlinkEntry[]>;
         dynamicArray_compute?: any;

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

@@ -120,6 +120,7 @@ declare const Workbook: React.ForwardRefExoticComponent<Settings & AdditionalPro
         luckysheet_conditionformat_save?: any[];
         luckysheet_alternateformat_save?: any[];
         dataVerification?: any;
+        dataVerificationDefs?: any[];
         conditionRules?: import('../../../core/types').ConditionRulesProps;
         hyperlink?: Record<string, import('../../../core').HyperlinkEntry | import('../../../core').HyperlinkEntry[]>;
         dynamicArray_compute?: any;