@fileverse-dev/dsheet 1.3.18-patch.1 → 1.3.18-patch.2

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { default as DsheetEditor } from './editor/dsheet-editor';
+export { default as DSheetEditor } from './editor/dsheet-editor';
 export { formulaResponseUiSync } from './editor/utils/formula-ui-sync';
 export { executeStringFunction } from './editor/utils/executeStringFunction';
 export { FLVURL } from '@fileverse-dev/formulajs';

package/dist/index.es.js

@@ -1,8 +1,8 @@
-import { S as s, E as l, i as o, a as r, b as t, c as n, d, e as h, f as i, g as S, h as c, j as C, k as m, l as p, m as E, n as F, o as x, p as g, q as R, r as u, s as A, t as I, u as L, v as f, w as T, x as w, y as V, z as k, A as y, B as z, C as X, D as _, G as v, H as G, I as H, J as M, K as P } from "./index-ZCAfF51b.js";
+import { S as s, E as l, i as o, a as r, b as t, c as n, d, e as S, f as h, g as i, h as c, j as C, k as m, l as p, m as E, n as F, o as x, p as g, q as R, r as u, s as A, t as I, u as L, v as f, w as T, x as w, y as V, z as k, A as y, B as z, C as X, D as _, G as v, H as G, I as H, J as M, K as P } from "./index-DpB-ebeF.js";
 import { FLVURL as b } from "@fileverse-dev/formulajs";
 import { TEMPLATES as B } from "@fileverse-dev/dsheets-templates";
 export {
-  s as DsheetEditor,
+  s as DSheetEditor,
   l as ERROR_MESSAGES_FLAG,
   b as FLVURL,
   o as FortuneCore,
@@ -11,9 +11,9 @@ export {
   t as api,
   n as clearColumnsCellsFormat,
   d as clearFilter,
-  h as clearRowsCellsFormat,
-  i as clearSelectedCellFormat,
-  S as createFilter,
+  S as clearRowsCellsFormat,
+  h as clearSelectedCellFormat,
+  i as createFilter,
   c as deleteRowCol,
   C as deleteSelectedCellText,
   m as executeStringFunction,

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

@@ -8,4 +8,4 @@ export declare function getCellValue(ctx: Context, row: number, column: number,
 export declare function setCellValue(ctx: Context, row: number, column: number, value: any, cellInput: HTMLDivElement | null, options?: CommonOptions, callAfterUpdate?: boolean): 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;
-export declare function autoFillCell(ctx: Context, copyRange: SingleRange, applyRange: SingleRange, direction: 'up' | 'down' | 'left' | 'right'): void;
+export declare function autoFillCell(ctx: Context, copyRange: SingleRange, applyRange: SingleRange, direction: "up" | "down" | "left" | "right"): void;

package/dist/sheet-engine/core/events/keyboard.d.ts

@@ -1,7 +1,7 @@
 import { Context } from '../context';
 import { GlobalCache } from '../types';
 
-export declare function handleGlobalEnter(ctx: Context, cellInput: HTMLDivElement, e: KeyboardEvent, canvas?: CanvasRenderingContext2D): void;
-export declare function handleWithCtrlOrMetaKey(ctx: Context, cache: GlobalCache, e: KeyboardEvent, cellInput: HTMLDivElement, fxInput: HTMLDivElement | null | undefined, handleUndo: () => void, handleRedo: () => void): void;
+export declare function handleGlobalEnter(ctx: Context, cellInput: HTMLDivElement, e: KeyboardEvent, cache: GlobalCache, canvas?: CanvasRenderingContext2D): void;
+export declare function handleWithCtrlOrMetaKey(ctx: Context, cache: GlobalCache, e: KeyboardEvent, cellInput: HTMLDivElement, fxInput: HTMLDivElement | null | undefined, handleUndo: () => void, handleRedo: () => void, canvas?: CanvasRenderingContext2D): void;
 export declare function handleArrowKey(ctx: Context, e: KeyboardEvent): void;
 export declare function handleGlobalKeyDown(ctx: Context, cellInput: HTMLDivElement, fxInput: HTMLDivElement | null | undefined, e: KeyboardEvent, cache: GlobalCache, handleUndo: () => void, handleRedo: () => void, canvas?: CanvasRenderingContext2D): Promise<void>;

package/dist/sheet-engine/core/events/mouse.d.ts

@@ -12,7 +12,7 @@ export declare function fixPositionOnFrozenCells(freeze: Freezen | undefined, x:
 };
 export declare function handleCellAreaMouseDown(ctx: Context, globalCache: GlobalCache, e: MouseEvent, cellInput: HTMLDivElement, container: HTMLDivElement, fxInput?: HTMLDivElement | null, canvas?: CanvasRenderingContext2D): void;
 export declare function handleCellAreaDoubleClick(ctx: Context, globalCache: GlobalCache, settings: Settings, e: MouseEvent, container: HTMLElement): void;
-export declare function handleContextMenu(ctx: Context, settings: Settings, e: MouseEvent, workbookContainer: HTMLDivElement, container: HTMLDivElement, area: 'cell' | 'rowHeader' | 'columnHeader'): void;
+export declare function handleContextMenu(ctx: Context, settings: Settings, e: MouseEvent, workbookContainer: HTMLDivElement, container: HTMLDivElement, area: "cell" | "rowHeader" | "columnHeader"): void;
 export declare function mouseRender(ctx: Context, globalCache: GlobalCache, e: MouseEvent, cellInput: HTMLDivElement, scrollX: HTMLDivElement, scrollY: HTMLDivElement, container: HTMLDivElement, fxInput?: HTMLDivElement | null): void;
 export declare function handleOverlayMouseMove(ctx: Context, globalCache: GlobalCache, e: MouseEvent, cellInput: HTMLDivElement, scrollX: HTMLDivElement, scrollY: HTMLDivElement, container: HTMLDivElement, fxInput?: HTMLDivElement | null): void;
 export declare function handleOverlayMouseUp(ctx: Context, globalCache: GlobalCache, settings: Settings, e: MouseEvent, scrollbarX: HTMLDivElement, scrollbarY: HTMLDivElement, container: HTMLDivElement, cellInput: HTMLDivElement | null, fxInput: HTMLDivElement | null): void;

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

@@ -7,7 +7,7 @@ export { defaultSettings } from './settings';
 export type { Settings, Hooks } from './settings';
 export { handleCopy, handleGlobalKeyDown, handlePaste, handlePasteByClick, fixPositionOnFrozenCells, handleCellAreaMouseDown, handleCellAreaDoubleClick, handleContextMenu, mouseRender, handleOverlayMouseMove, handleOverlayMouseUp, handleRowHeaderMouseDown, handleColumnHeaderMouseDown, handleColSizeHandleMouseDown, handleColSizeHandleDoubleClick, handleRowSizeHandleMouseDown, handleColFreezeHandleMouseDown, handleRowFreezeHandleMouseDown, } from './events';
 export * from './locale';
-export { getBorderInfoComputeRange, getBorderInfoCompute, normalizedCellAttr, normalizedAttr, getCellValue, setCellValue, getRealCellValue, mergeBorder, cancelNormalSelected, updateCell, getRangetxt, getRangeByTxt, getInlineStringHTML, getStyleByCell, clearSelectedCellFormat, clearRowsCellsFormat, clearColumnsCellsFormat, clipboard, moveToEnd, getRangeRectsByCharacterOffset, update, is_date, valueShowEs, FormulaCache, groupValuesRefresh, setCaretPosition, getrangeseleciton, rangeHightlightselected, handleFormulaInput, israngeseleciton, createRangeHightlight, initFreeze, isInlineStringCell, getInlineStringNoStyle, rowLocation, rowLocationByIndex, colLocation, colLocationByIndex, insertRowCol, deleteRowCol, hideSelected, showSelected, isShowHidenCR, scrollToHighlightCell, selectTitlesMap, selectTitlesRange, normalizeSelection, moveHighlightCell, deleteSelectedCellText, selectAll, fixRowStyleOverflowInFreeze, fixColumnStyleOverflowInFreeze, calcSelectionInfo, addSheet, deleteSheet, editSheetName, changeSheet, updateFormat, autoSelectionFormula, handleBold, handleItalic, handleStrikeThrough, handleUnderline, handleHorizontalAlign, handleVerticalAlign, handleTextColor, handleTextBackground, handleBorder, handleMerge, handleSort, handleFreeze, handleTextSize, handleSum, handleLink, toolbarItemClickHandler, toolbarItemSelectedFunc, handleScreenShot, insertImage, showImgChooser, drawArrow, setEditingComment, removeEditingComment, newComment, editComment, deleteComment, showComments, showHideComment, showHideAllComments, onCommentBoxMoveStart, removeActiveImage, cancelActiveImgItem, onImageMoveStart, onImageResizeStart, createDropCellRange, sortSelection, searchAll, searchNext, replace, replaceAll, getCellRowColumn, getCellHyperlink, saveHyperlink, removeHyperlink, showLinkCard, goToLink, isLinkValid, createFilterOptions, clearFilter, createFilter, getFilterColumnValues, getFilterColumnColors, orderbydatafiler, saveFilter, onCellsMoveStart, cfSplitRange, updateMoreCell, getRegStr, getDataArr, applyLocation, getOptionValue, getSelectRange, getDropdownList, setDropdownValue, confirmMessage, setConditionRules, handleOverlayTouchStart, handleOverlayTouchEnd, MAX_ZOOM_RATIO, MIN_ZOOM_RATIO, handleKeydownForZoom, jfrefreshgrid, sanitizeDuneUrl, insertDuneChart, onIframeMoveStart, onIframeResizeStart, onIframeMove, onIframeMoveEnd, onIframeResize, onIframeResizeEnd, setCellError, clearCellError, isdatatypemulti, diff, isdatetime, isRealNull, isRealNum, iscelldata, getcellrange, cancelFunctionrangeSelected, seletedHighlistByindex, spillSortResult, execfunction, insertUpdateFunctionGroup, checkCF, getComputeMap, cancelPaintModel, hideCRCount, getdatabyselection, } from './modules';
+export { getBorderInfoComputeRange, getBorderInfoCompute, normalizedCellAttr, normalizedAttr, getCellValue, setCellValue, getRealCellValue, mergeBorder, cancelNormalSelected, updateCell, getRangetxt, getRangeByTxt, getInlineStringHTML, getStyleByCell, clearSelectedCellFormat, clearRowsCellsFormat, clearColumnsCellsFormat, clipboard, moveToEnd, getRangeRectsByCharacterOffset, update, is_date, valueShowEs, FormulaCache, groupValuesRefresh, setCaretPosition, getrangeseleciton, getFormulaEditorOwner, rangeHightlightselected, handleFormulaInput, israngeseleciton, createRangeHightlight, maybeRecoverDirtyRangeSelection, getFormulaRangeIndexAtCaret, isCaretAtValidFormulaRangeInsertionPoint, markRangeSelectionDirty, setFormulaEditorOwner, functionHTMLGenerate, suppressFormulaRangeSelectionForInitialEdit, rangeSetValue, getFormulaRangeIndexForKeyboardSync, createFormulaRangeSelect, isFormulaReferenceInputMode, initFreeze, isInlineStringCell, getInlineStringNoStyle, rowLocation, rowLocationByIndex, colLocation, colLocationByIndex, insertRowCol, deleteRowCol, hideSelected, showSelected, isShowHidenCR, scrollToHighlightCell, selectTitlesMap, selectTitlesRange, normalizeSelection, moveHighlightCell, deleteSelectedCellText, selectAll, fixRowStyleOverflowInFreeze, fixColumnStyleOverflowInFreeze, calcSelectionInfo, addSheet, deleteSheet, editSheetName, changeSheet, updateFormat, autoSelectionFormula, handleBold, handleItalic, handleStrikeThrough, handleUnderline, handleHorizontalAlign, handleVerticalAlign, handleTextColor, handleTextBackground, handleBorder, handleMerge, handleSort, handleFreeze, handleTextSize, handleSum, handleLink, toolbarItemClickHandler, toolbarItemSelectedFunc, handleScreenShot, insertImage, showImgChooser, drawArrow, setEditingComment, removeEditingComment, newComment, editComment, deleteComment, showComments, showHideComment, showHideAllComments, onCommentBoxMoveStart, removeActiveImage, cancelActiveImgItem, onImageMoveStart, onImageResizeStart, createDropCellRange, sortSelection, searchAll, searchNext, replace, replaceAll, getCellRowColumn, getCellHyperlink, saveHyperlink, removeHyperlink, showLinkCard, goToLink, isLinkValid, createFilterOptions, clearFilter, createFilter, getFilterColumnValues, getFilterColumnColors, orderbydatafiler, saveFilter, onCellsMoveStart, cfSplitRange, updateMoreCell, getRegStr, getDataArr, applyLocation, getOptionValue, getSelectRange, getDropdownList, setDropdownValue, confirmMessage, setConditionRules, handleOverlayTouchStart, handleOverlayTouchEnd, MAX_ZOOM_RATIO, MIN_ZOOM_RATIO, handleKeydownForZoom, jfrefreshgrid, sanitizeDuneUrl, insertDuneChart, onIframeMoveStart, onIframeResizeStart, onIframeMove, onIframeMoveEnd, onIframeResize, onIframeResizeEnd, setCellError, clearCellError, isdatatypemulti, diff, isdatetime, isRealNull, isRealNum, 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/cell.d.ts

@@ -26,7 +26,11 @@ export declare function getRangeByTxt(ctx: Context, txt: string): any[];
 export declare function isAllSelectedCellsInStatus(ctx: Context, attr: keyof Cell, status: any): boolean;
 export declare function getFontStyleByCell(cell: Cell | null | undefined, checksAF?: any[], checksCF?: any, isCheck?: boolean): any;
 export declare function getStyleByCell(ctx: Context, d: CellMatrix, r: number, c: number): any;
-export declare function getInlineStringHTML(r: number, c: number, data: CellMatrix): string;
+export declare function getInlineStringHTML(r: number, c: number, data: CellMatrix, options?: {
+    useSemanticMarkup?: boolean;
+    isRichTextCopy?: boolean;
+    inheritedStyle?: Record<string, string>;
+}): string;
 export declare function getQKBorder(width: string, type: string, color: string): (string | number)[];
 /**
  * 计算范围行高

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

@@ -21,6 +21,9 @@ export declare class FormulaCache {
     rangetosheet?: string;
     rangedrag_column_start?: boolean;
     rangedrag_row_start?: boolean;
+    rangeSelectionActive?: boolean | null;
+    keyboardRangeSelectionLock?: boolean;
+    formulaEditorOwner?: "cell" | "fx" | null;
     functionRangeIndex?: number[];
     functionlistMap: any;
     execFunctionExist?: any[];
@@ -45,12 +48,58 @@ export declare function setCaretPosition(ctx: Context, textDom: HTMLElement, chi
 export declare function getrangeseleciton(): ParentNode | ChildNode | null | undefined;
 export declare function rangeHightlightselected(ctx: Context, $editor: HTMLDivElement): void;
 export declare function functionHTMLGenerate(txt: string): string;
+export declare function getLastFormulaRangeIndex($editor: HTMLDivElement): number | null;
+/** Range cell that contains the caret, if any (inside #luckysheet-rich-text-editor tree). */
+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;
+/**
+ * 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
+ * row digit from A2). Those states should not allow range recovery / keyboard ref nav.
+ */
+export declare function hasIncompleteTruncatedCellRangeSyntax(formulaText: string): boolean;
+/**
+ * True when the formula is only "=" plus a single cell or range token (no parentheses,
+ * so no function call). Same UX as =A1: do not use arrow keys to drive sheet refs until
+ * the user changes the formula shape (e.g. adds a function).
+ */
+export declare function isBareCellOrRangeOnlyFormula(formulaText: string): boolean;
+/**
+ * When opening in-cell / FX edit on a cell that already stores a formula (`cell.f`),
+ * disable sheet-driven range selection until the caret reaches a fresh insertion slot
+ * (comma, open paren, operator, etc.) or the user starts an active range drag.
+ */
+export declare function suppressFormulaRangeSelectionForInitialEdit(ctx: Context): void;
+export declare function isCaretAtValidFormulaRangeInsertionPoint(editor: HTMLElement | null): boolean;
+export declare function markRangeSelectionDirty(ctx: Context): void;
+/**
+ * Which `rangeindex` keyboard selection sync should update: caret's cell if any;
+ * else the last range cell when the caret is editing that ref — not when the caret
+ * is before it (`=,A4` between `=` and `,`) or **past** it into a following comma /
+ * next argument (`=SUM(A1,` after the comma must not replace `A1`).
+ */
+export declare function getFormulaRangeIndexForKeyboardSync($editor: HTMLDivElement): number | null;
 export declare function handleFormulaInput(ctx: Context, $copyTo: HTMLDivElement | null | undefined, $editor: HTMLDivElement, kcode: number, preText?: string, refreshRangeSelect?: boolean): void;
 export declare function israngeseleciton(ctx: Context, istooltip?: boolean): boolean;
-export declare function functionStrChange(txt: string, type: string, rc: 'row' | 'col', orient: string | null, stindex: number, step: number): string;
+export declare function isFormulaReferenceInputMode(ctx: Context): boolean;
+export declare function maybeRecoverDirtyRangeSelection(ctx: Context): boolean;
+export declare function functionStrChange(txt: string, type: string, rc: "row" | "col", orient: string | null, stindex: number, step: number): string;
 export declare function rangeSetValue(ctx: Context, cellInput: HTMLDivElement, selected: any, fxInput?: HTMLDivElement | null): void;
 export declare function onFormulaRangeDragEnd(ctx: Context): void;
 export declare function rangeDrag(ctx: Context, e: MouseEvent, cellInput: HTMLDivElement, scrollLeft: number, scrollTop: number, container: HTMLDivElement, fxInput?: HTMLDivElement | null): void;
 export declare function rangeDragColumn(ctx: Context, e: MouseEvent, cellInput: HTMLDivElement, scrollLeft: number, scrollTop: number, container: HTMLDivElement, fxInput?: HTMLDivElement | null): void;
 export declare function rangeDragRow(ctx: Context, e: MouseEvent, cellInput: HTMLDivElement, scrollLeft: number, scrollTop: number, container: HTMLDivElement, fxInput?: HTMLDivElement | null): void;
 export declare function functionCopy(ctx: Context, txt: string, mode: string, step: number): string;
+type MoveReferenceRect = {
+    rowStart: number;
+    rowEnd: number;
+    colStart: number;
+    colEnd: number;
+};
+export declare function remapFormulaReferencesByMap(formula: string, formulaSheetName: string, movedSheetName: string, maps: {
+    rowMap?: Record<number, number>;
+    colMap?: Record<number, number>;
+}): string;
+export declare function functionMoveReference(txt: string, formulaSheetName: string, movedSheetName: string, sourceRect: MoveReferenceRect, targetRowStart: number, targetColStart: number): string;
+export {};

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

@@ -3,7 +3,7 @@ export { normalizedCellAttr, normalizedAttr, getCellValue, setCellValue, getReal
 export { default as clipboard } from './clipboard';
 export { moveToEnd, getRangeRectsByCharacterOffset } from './cursor';
 export { update, is_date, valueShowEs } from './format';
-export { FormulaCache, groupValuesRefresh, setCaretPosition, getrangeseleciton, rangeHightlightselected, handleFormulaInput, israngeseleciton, createRangeHightlight, createFormulaRangeSelect, delFunctionGroup, functionHTMLGenerate, onFormulaRangeDragEnd, rangeDrag, rangeSetValue, } from './formula';
+export { FormulaCache, groupValuesRefresh, setCaretPosition, getrangeseleciton, getFormulaEditorOwner, rangeHightlightselected, handleFormulaInput, israngeseleciton, createRangeHightlight, createFormulaRangeSelect, maybeRecoverDirtyRangeSelection, delFunctionGroup, functionHTMLGenerate, onFormulaRangeDragEnd, rangeDrag, rangeSetValue, remapFormulaReferencesByMap, getFormulaRangeIndexAtCaret, isCaretAtValidFormulaRangeInsertionPoint, markRangeSelectionDirty, getFormulaRangeIndexForKeyboardSync, isFormulaReferenceInputMode, functionStrChange, setFormulaEditorOwner, getAllFunctionGroup, suppressFormulaRangeSelectionForInitialEdit, } from './formula';
 export { initFreeze } from './freeze';
 export { isInlineStringCell, getInlineStringNoStyle } from './inline-string';
 export { rowLocation, rowLocationByIndex, colLocation, colLocationByIndex, } from './location';

package/dist/sheet-engine/core/modules/inline-string.d.ts

@@ -20,12 +20,12 @@ export declare const inlineStyleAffectAttribute: {
     fc: number;
 };
 export declare const inlineStyleAffectCssName: {
-    'font-weight': number;
-    'font-style': number;
-    'font-family': number;
-    'text-decoration': number;
-    'border-bottom': number;
-    'font-size': number;
+    "font-weight": number;
+    "font-style": number;
+    "font-family": number;
+    "text-decoration": number;
+    "border-bottom": number;
+    "font-size": number;
     color: number;
 };
 export declare function isInlineStringCell(cell: any): boolean;

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

@@ -10,14 +10,14 @@ import { Context } from '../context';
  * @returns
  */
 export declare function insertRowCol(ctx: Context, op: {
-    type: 'row' | 'column';
+    type: "row" | "column";
     index: number;
     count: number;
-    direction: 'lefttop' | 'rightbottom';
+    direction: "lefttop" | "rightbottom";
     id: string;
 }, changeSelection?: boolean): void;
 export declare function deleteRowCol(ctx: Context, op: {
-    type: 'row' | 'column';
+    type: "row" | "column";
     start: number;
     end: number;
     id?: string;

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

@@ -3,6 +3,7 @@ import { Context } from '../context';
 
 export declare const selectionCache: {
     isPasteAction: boolean;
+    isPasteValuesOnly: boolean;
 };
 export declare function scrollToHighlightCell(ctx: Context, r: number, c: number): void;
 export declare function seletedHighlistByindex(ctx: Context, r1: number, r2: number, c1: number, c2: number): {
@@ -11,24 +12,24 @@ export declare function seletedHighlistByindex(ctx: Context, r1: number, r2: num
     top: number;
     height: number;
 } | null;
-export declare function normalizeSelection(ctx: Context, selection: SheetType['luckysheet_select_save']): import('..').Selection[] | undefined;
+export declare function normalizeSelection(ctx: Context, selection: SheetType["luckysheet_select_save"]): import('..').Selection[] | undefined;
 export declare function selectTitlesMap(rangeMap: Record<string, number>, range1: number, range2: number): Record<string, number>;
 export declare function selectTitlesRange(map: Record<string, number>): number[][];
-export declare function pasteHandlerOfPaintModel(ctx: Context, copyRange: Context['luckysheet_copy_save']): void;
+export declare function pasteHandlerOfPaintModel(ctx: Context, copyRange: Context["luckysheet_copy_save"]): void;
 export declare function selectionCopyShow(range: any, ctx: Context): void;
 export declare function rowHasMerged(ctx: Context, r: number, c1: number, c2: number): boolean;
 export declare function colHasMerged(ctx: Context, c: number, r1: number, r2: number): boolean;
 export declare function getRowMerge(ctx: Context, rIndex: number, c1: number, c2: number): (number | null)[];
 export declare function getColMerge(ctx: Context, cIndex: number, r1: number, r2: number): (number | null)[];
-export declare function moveHighlightCell(ctx: Context, postion: 'down' | 'right', index: number, type: 'rangeOfSelect' | 'rangeOfFormula'): void;
-export declare function moveHighlightRange(ctx: Context, postion: 'down' | 'right', index: number, type: 'rangeOfSelect' | 'rangeOfFormula'): void;
+export declare function moveHighlightCell(ctx: Context, postion: "down" | "right", index: number, type: "rangeOfSelect" | "rangeOfFormula"): void;
+export declare function moveHighlightRange(ctx: Context, postion: "down" | "right", index: number, type: "rangeOfSelect" | "rangeOfFormula"): void;
 export declare function rangeValueToHtml(ctx: Context, sheetId: string, ranges?: Range): string | null;
 export declare function copy(ctx: Context): void;
 export declare function deleteSelectedCellText(ctx: Context): string;
 export declare function deleteSelectedCellFormat(ctx: Context): string;
 export declare function fillRightData(ctx: Context): string;
 export declare function fillDownData(ctx: Context): string;
-export declare function textFormat(ctx: Context, type: 'left' | 'center' | 'right'): string;
+export declare function textFormat(ctx: Context, type: "left" | "center" | "right"): string;
 export declare function fillDate(ctx: Context): string;
 export declare function fillTime(ctx: Context): string;
 export declare function selectIsOverlap(ctx: Context, range?: any): boolean;

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

@@ -2,7 +2,7 @@ import { Cell, CellMatrix, Context } from '..';
 
 export declare function orderbydata(isAsc: boolean, index: number, data: (Cell | null)[][]): {
     sortedData: (Cell | null)[][];
-    rowOffsets: number[];
+    rowMap: Record<number, number>;
 };
 export declare function sortDataRange(ctx: Context, sheetData: CellMatrix, dataRange: CellMatrix, index: number, isAsc: boolean, str: number, edr: number, stc: number, edc: number): void;
 export declare function sortSelection(ctx: Context, isAsc: boolean, colIndex?: number): void;

package/dist/sheet-engine/core/paste-table-helpers.d.ts

@@ -1,4 +1,4 @@
 import { Context } from './context';
 
-export declare const DEFAULT_FONT_SIZE = 12;
+export declare const DEFAULT_FONT_SIZE = 10;
 export declare function handlePastedTable(ctx: Context, html: string, pasteHandler: (context: Context, data: any, borderInfo?: any) => void): void;

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

@@ -2,7 +2,7 @@ import { Patch as ImmerPatch } from 'immer';
 import { PatchOptions } from './utils';
 
 export type Op = {
-    op: 'replace' | 'remove' | 'add' | 'insertRowCol' | 'deleteRowCol' | 'addSheet' | 'deleteSheet';
+    op: "replace" | "remove" | "add" | "insertRowCol" | "deleteRowCol" | "addSheet" | "deleteSheet";
     id?: string;
     path: (string | number)[];
     value?: any;
@@ -227,7 +227,7 @@ export type Sheet = {
     dynamicArray_compute?: any;
     dynamicArray?: any[];
     frozen?: {
-        type: 'row' | 'column' | 'both' | 'rangeRow' | 'rangeColumn' | 'rangeBoth';
+        type: "row" | "column" | "both" | "rangeRow" | "rangeColumn" | "rangeBoth";
         range?: {
             row_focus: number;
             column_focus: number;
@@ -328,12 +328,14 @@ export type Freezen = {
     };
 };
 export type GlobalCache = {
+    /** True when the current edit session was started by typing into the sheet (not F2 / double-click / Enter-to-edit). */
+    enteredEditByTyping?: boolean;
+    /** When set, in-cell / formula-bar hydration from sheet data is skipped for this cell (type-to-edit replacement). */
+    pendingTypeOverCell?: [number, number];
     verticalScrollLock?: boolean;
     horizontalScrollLock?: boolean;
     overwriteCell?: boolean;
     overwriteCellFirstChar?: string;
-    /** True when current cell was opened for edit by typing (not double-click). Used so arrow keys commit+move only in that case. */
-    enteredEditByTyping?: boolean;
     ignoreWriteCell?: boolean;
     doNotFocus?: boolean;
     doNotUpdateCell?: boolean;

package/dist/sheet-engine/react/components/FormulaSearch/constant.d.ts

@@ -0,0 +1,63 @@
+export declare const UNFilter: ({
+    API_KEY: string;
+    LOGO: string;
+    BRAND_COLOR: string;
+    BRAND_SECONDARY_COLOR: string;
+    n: string;
+    t: number;
+    d: string;
+    a: string;
+    p: {
+        name: string;
+        detail: string;
+        example: string;
+        require: string;
+        type: string;
+    }[];
+} | {
+    API_KEY: string;
+    LOGO: string;
+    BRAND_COLOR: string;
+    BRAND_SECONDARY_COLOR: string;
+    n: string;
+    t: number;
+    d: string;
+    a: string;
+    p: ({
+        name: string;
+        detail: string;
+        example: string;
+        require: string;
+        repeat?: undefined;
+    } | {
+        name: string;
+        detail: string;
+        example: string;
+        require: string;
+        repeat: string;
+    })[];
+} | {
+    LOGO: string;
+    BRAND_COLOR: string;
+    BRAND_SECONDARY_COLOR: string;
+    n: string;
+    t: number;
+    d: string;
+    a: string;
+    p: ({
+        name: string;
+        detail: string;
+        example: string;
+        require: string;
+        type: string;
+        repeat?: undefined;
+    } | {
+        name: string;
+        detail: string;
+        example: string;
+        require: string;
+        repeat: string;
+        type: string;
+    })[];
+    API_KEY?: undefined;
+})[];

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

@@ -1,5 +1,6 @@
 import { default as React } from 'react';
 
-export declare const FormulaSearch: React.FC<{
-    onCancel: () => void;
+declare const FormulaSearch: React.FC<React.HTMLAttributes<HTMLDivElement> & {
+    from?: string;
 }>;
+export default FormulaSearch;

package/dist/sheet-engine/react/components/SheetOverlay/formula-segment-boundary.d.ts

@@ -0,0 +1 @@
+export declare function isFormulaSegmentBoundaryKey(key: string): boolean;

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

@@ -1,6 +1,40 @@
 export declare function moveCursorToEnd(editableDiv: HTMLDivElement): void;
 export declare function getCursorPosition(editableDiv: HTMLDivElement): number;
+export declare function getSelectionOffsets(editableDiv: HTMLDivElement): {
+    start: number;
+    end: number;
+};
+/**
+ * Cmd/Ctrl+Z / Shift+Cmd+Z / Ctrl+Y redo — `onChange` must not run
+ * `handleFormulaInput` or history append for these (Mac uses metaKey, not ctrlKey).
+ */
+export declare function isEditorUndoRedoKeyEvent(e: KeyboardEvent): boolean;
+/**
+ * Use the same rule for cell input and fx bar: custom stack when the line is a
+ * formula (=…) or the stack already has snapshots (plain/rich text edits).
+ */
+export declare function shouldUseCustomEditorHistory(editorInnerTextTrimmed: string, historyActive: boolean): boolean;
+export declare function setCursorPosition(editableDiv: HTMLDivElement, targetOffset: number): void;
+export declare function setSelectionOffsets(editableDiv: HTMLDivElement, startOffset: number, endOffset: number): void;
+export declare function buildFormulaSuggestionText(editableDiv: HTMLDivElement, formulaName: string): {
+    text: string;
+    caretOffset: number;
+};
 export declare function isLetterNumberPattern(str: string): boolean;
+/** Same rule as InputBox/Fx onChange: show function list while typing a name after `=`. */
+export declare function shouldShowFormulaFunctionList(editor: HTMLDivElement | null): boolean;
+/**
+ * When the caret sits on a function name span or its opening-paren span, return
+ * that function's name (uppercase). Used so nested formulas like `SUM(MIN(`
+ * show the inner function's hint when the caret is inside `MIN` / `MIN(`.
+ *
+ * Rules (match generated formula HTML):
+ * - Caret inside/outside a `luckysheet-formula-text-func` span whose immediate
+ *   next element sibling is `luckysheet-formula-text-lpar` → that function.
+ * - Caret inside a `luckysheet-formula-text-lpar` span whose immediate previous
+ *   element sibling is `luckysheet-formula-text-func` → that function.
+ */
+export declare function getFunctionNameFromFormulaCaretSpans(editor: HTMLDivElement | null): string | null;
 export declare function removeLastSpan(htmlString: string): string;
 export declare function numberToColumn(colNumber: number): string;
 export declare function incrementColumn(cell: string): string;

package/dist/sheet-engine/react/hooks/useFormulaEditorHistory.d.ts

@@ -0,0 +1,30 @@
+import { RefObject } from 'react';
+import { Context } from '../../core';
+import { SetContextOptions } from '../context';
+
+export type FormulaHistoryEntry = {
+    html: string;
+    caret: number;
+};
+/** Which editor receives caret placement and drives history snapshots. */
+export type FormulaEditorHistoryPrimary = "cell" | "fx";
+type SetContext = (recipe: (ctx: Context) => void, options?: SetContextOptions) => void;
+/**
+ * Custom undo/redo for the cell overlay and Fx bar — **one code path** for
+ * formulas (=…) and plain/rich text (same snapshot shape: text, html, spans).
+ */
+export declare function useFormulaEditorHistory(primaryRef: RefObject<HTMLDivElement | null>, cellInputRef: RefObject<HTMLDivElement | null>, fxInputRef: RefObject<HTMLDivElement | null>, _setContext: SetContext, primary: FormulaEditorHistoryPrimary): {
+    formulaHistoryRef: import('react').MutableRefObject<{
+        active: boolean;
+        entries: FormulaHistoryEntry[];
+        index: number;
+    }>;
+    preTextRef: import('react').MutableRefObject<string>;
+    resetFormulaHistory: () => void;
+    handleFormulaHistoryUndoRedo: (isRedo: boolean) => boolean;
+    capturePreEditorHistoryState: () => void;
+    appendEditorHistoryFromPrimaryEditor: (getCaret: () => number) => void;
+    capturePreFormulaState: () => void;
+    appendFormulaHistoryFromPrimaryEditor: (getCaret: () => number) => void;
+};
+export {};

package/dist/sheet-engine/react/hooks/useRerenderOnFormulaCaret.d.ts

@@ -0,0 +1,11 @@
+import { RefObject } from 'react';
+
+/**
+ * Subscribes to `selectionchange` while editing a formula so components that
+ * derive UI from caret position (e.g. nested function hints) re-render when
+ * the user only moves the caret without changing React state.
+ *
+ * `onAfterCaretMove` runs after the bump (e.g. refresh `formulaRangeHighlight`
+ * — `input` does not fire on caret-only clicks).
+ */
+export declare function useRerenderOnFormulaCaret(editorRef: RefObject<HTMLDivElement | null>, editSessionActive: boolean, onAfterCaretMove?: () => void): void;