@fileverse-dev/dsheet 2.0.0 → 2.0.1

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

@@ -192,6 +192,11 @@ export type Context = {
     luckysheetPaintSingle: boolean;
     defaultCell: Cell;
     groupValuesRefreshData: any[];
+    /**
+     * Incremented when formula `func_selectedrange` moves via keyboard (`rangeOfFormula`)
+     * so React re-renders — `FormulaCache` is a class and Immer does not track it.
+     */
+    formulaRangeNavRevision: number;
     formulaCache: FormulaCache;
     hooks: Hooks;
     showSheetList?: boolean;

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, getFormulaEditorOwner, rangeHightlightselected, handleFormulaInput, israngeseleciton, createRangeHightlight, maybeRecoverDirtyRangeSelection, getFormulaRangeIndexAtCaret, isCaretAtValidFormulaRangeInsertionPoint, isLegacyFormulaRangeMode, markRangeSelectionDirty, setFormulaEditorOwner, functionHTMLGenerate, suppressFormulaRangeSelectionForInitialEdit, rangeSetValue, getFormulaRangeIndexForKeyboardSync, createFormulaRangeSelect, isFormulaReferenceInputMode, initFreeze, isInlineStringCell, getInlineStringNoStyle, rowLocation, rowLocationByIndex, colLocation, colLocationByIndex, insertRowCol, deleteRowCol, hideSelected, showSelected, isShowHidenCR, scrollToHighlightCell, selectTitlesMap, selectTitlesRange, normalizeSelection, syncPrimaryCellActiveFromSelection, setPrimaryCellActive, advancePrimaryCellInLastMultiSelection, 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 { 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, 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, scrollToHighlightCell, selectTitlesMap, selectTitlesRange, normalizeSelection, syncPrimaryCellActiveFromSelection, 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, 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, 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/locale/en.d.ts

@@ -379,6 +379,14 @@ declare const _default: {
         cannotDeleteColumnReadOnly: string;
         cannotInsertOnRowReadOnly: string;
         cannotInsertOnColumnReadOnly: string;
+        insertRowAboveOne: string;
+        insertRowsAboveN: string;
+        insertRowBelowOne: string;
+        insertRowsBelowN: string;
+        insertColumnLeftOne: string;
+        insertColumnsLeftN: string;
+        insertColumnRightOne: string;
+        insertColumnsRightN: string;
         rowOverLimit: string;
         columnOverLimit: string;
         conditionFormat: string;

package/dist/sheet-engine/core/locale/es.d.ts

@@ -548,6 +548,14 @@ declare const _default: {
         cannotDeleteColumnReadOnly: string;
         cannotInsertOnRowReadOnly: string;
         cannotInsertOnColumnReadOnly: string;
+        insertRowAboveOne: string;
+        insertRowsAboveN: string;
+        insertRowBelowOne: string;
+        insertRowsBelowN: string;
+        insertColumnLeftOne: string;
+        insertColumnsLeftN: string;
+        insertColumnRightOne: string;
+        insertColumnsRightN: string;
         rowOverLimit: string;
         columnOverLimit: string;
     };

package/dist/sheet-engine/core/locale/hi.d.ts

@@ -418,6 +418,14 @@ declare const _default: {
         cannotDeleteColumnReadOnly: string;
         cannotInsertOnRowReadOnly: string;
         cannotInsertOnColumnReadOnly: string;
+        insertRowAboveOne: string;
+        insertRowsAboveN: string;
+        insertRowBelowOne: string;
+        insertRowsBelowN: string;
+        insertColumnLeftOne: string;
+        insertColumnsLeftN: string;
+        insertColumnRightOne: string;
+        insertColumnsRightN: string;
         rowOverLimit: string;
         columnOverLimit: string;
     };

package/dist/sheet-engine/core/locale/zh.d.ts

@@ -435,6 +435,14 @@ declare const _default: {
         cannotDeleteColumnReadOnly: string;
         cannotInsertOnRowReadOnly: string;
         cannotInsertOnColumnReadOnly: string;
+        insertRowAboveOne: string;
+        insertRowsAboveN: string;
+        insertRowBelowOne: string;
+        insertRowsBelowN: string;
+        insertColumnLeftOne: string;
+        insertColumnsLeftN: string;
+        insertColumnRightOne: string;
+        insertColumnsRightN: string;
         rowOverLimit: string;
         columnOverLimit: string;
         conditionFormat: string;

package/dist/sheet-engine/core/locale/zh_tw.d.ts

@@ -581,6 +581,14 @@ declare const _default: {
         cannotDeleteColumnReadOnly: string;
         cannotInsertOnRowReadOnly: string;
         cannotInsertOnColumnReadOnly: string;
+        insertRowAboveOne: string;
+        insertRowsAboveN: string;
+        insertRowBelowOne: string;
+        insertRowsBelowN: string;
+        insertColumnLeftOne: string;
+        insertColumnsLeftN: string;
+        insertColumnRightOne: string;
+        insertColumnsRightN: string;
         rowOverLimit: string;
         columnOverLimit: string;
     };

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

@@ -1,6 +1,11 @@
 import { Context } from '../context';
 import { Cell, CellMatrix, Range, Selection, SingleRange } from '../types';
 
+/**
+ * Recompute auto row height for one row from wrap/inline cells; updates cfg.rowlen and ctx.config.
+ * Used from updateCell and deleteSelectedCellText (bulk clear).
+ */
+export declare function recalcAutoRowHeightForRow(ctx: Context, r: number, d: CellMatrix, canvas: CanvasRenderingContext2D | null | undefined): void;
 export declare function normalizedCellAttr(cell: Cell, attr: keyof Cell, defaultFontSize?: number): any;
 export declare function normalizedAttr(data: CellMatrix, r: number, c: number, attr: keyof Cell): any;
 export declare function getCellValue(r: number, c: number, data: CellMatrix, attr?: keyof Cell): any;

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

@@ -23,6 +23,8 @@ export declare class FormulaCache {
     rangedrag_row_start?: boolean;
     rangeSelectionActive?: boolean | null;
     keyboardRangeSelectionLock?: boolean;
+    /** True after arrow/Shift+arrow moved `func_selectedrange` without updating yellow selection. */
+    formulaKeyboardRefSync?: boolean;
     formulaEditorOwner?: "cell" | "fx" | null;
     functionRangeIndex?: number[];
     functionlistMap: any;
@@ -39,6 +41,13 @@ export declare function insertUpdateFunctionGroup(ctx: Context, r: number, c: nu
 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;
 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
+ * a formula, copy the current yellow selection into `func_selectedrange` so
+ * keyboard navigation updates only the blue formula overlay (like mouse drag),
+ * without resizing `luckysheet_select_save`.
+ */
+export declare function seedFormulaFuncSelectedRangeFromLastSelection(ctx: Context): boolean;
 export declare function createFormulaRangeSelect(ctx: Context, select: {
     rangeIndex: number;
 } & Rect): void;

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

@@ -3,12 +3,12 @@ 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, getFormulaEditorOwner, rangeHightlightselected, handleFormulaInput, israngeseleciton, createRangeHightlight, createFormulaRangeSelect, maybeRecoverDirtyRangeSelection, delFunctionGroup, functionHTMLGenerate, onFormulaRangeDragEnd, rangeDrag, rangeSetValue, remapFormulaReferencesByMap, getFormulaRangeIndexAtCaret, isCaretAtValidFormulaRangeInsertionPoint, isLegacyFormulaRangeMode, markRangeSelectionDirty, getFormulaRangeIndexForKeyboardSync, isFormulaReferenceInputMode, 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, execFunctionGroup, suppressFormulaRangeSelectionForInitialEdit, } from './formula';
 export { initFreeze } from './freeze';
 export { isInlineStringCell, getInlineStringNoStyle } from './inline-string';
 export { rowLocation, rowLocationByIndex, colLocation, colLocationByIndex, } from './location';
 export { insertRowCol, deleteRowCol, hideSelected, showSelected, isShowHidenCR, hideCRCount, } from './rowcol';
-export { scrollToHighlightCell, seletedHighlistByindex, selectTitlesMap, selectTitlesRange, normalizeSelection, syncPrimaryCellActiveFromSelection, setPrimaryCellActive, advancePrimaryCellInLastMultiSelection, moveHighlightCell, deleteSelectedCellText, selectAll, fixRowStyleOverflowInFreeze, fixColumnStyleOverflowInFreeze, calcSelectionInfo, rangeValueToHtml, } from './selection';
+export { scrollToHighlightCell, seletedHighlistByindex, selectTitlesMap, selectTitlesRange, normalizeSelection, syncPrimaryCellActiveFromSelection, setPrimaryCellActive, advancePrimaryCellInLastMultiSelection, snapSheetSelectionFocusToCellPreserveMultiRange, moveHighlightCell, deleteSelectedCellText, selectAll, fixRowStyleOverflowInFreeze, fixColumnStyleOverflowInFreeze, calcSelectionInfo, rangeValueToHtml, } from './selection';
 export { addSheet, deleteSheet, editSheetName, changeSheet, updateSheet, } from './sheet';
 export { updateFormat, autoSelectionFormula, handleBold, handleItalic, handleStrikeThrough, handleUnderline, handleHorizontalAlign, handleVerticalAlign, handleTextColor, handleTextBackground, handleBorder, handleMerge, handleSort, handleFreeze, handleTextSize, handleSum, handleLink, toolbarItemClickHandler, toolbarItemSelectedFunc, updateFormatCell, cancelPaintModel, } from './toolbar';
 export { handleScreenShot } from './screenshot';
@@ -34,7 +34,7 @@ export { jfrefreshgrid } from './refresh';
 export { sanitizeDuneUrl, insertDuneChart, onIframeMoveStart, onIframeResizeStart, onIframeMove, onIframeMoveEnd, onIframeResize, onIframeResizeEnd, } from './iframe';
 export { setCellError, clearCellError, overShowError, } from './error-state-helpers';
 export { checkCellIsLocked } from './protection';
-export { isdatatypemulti, diff, isdatetime, isRealNull, isRealNum, } from './validation';
+export { isdatatypemulti, diff, isdatetime, isRealNull, isRealNum, isNumericCellType, } from './validation';
 export { iscelldata, getcellrange, execfunction, insertUpdateFunctionGroup, functionCopy, } from './formula';
 export { checkCF, getComputeMap } from './ConditionFormat';
 export { getdatabyselection, getQKBorder } from './cell';

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

@@ -15,6 +15,10 @@ export declare function insertRowCol(ctx: Context, op: {
     count: number;
     direction: "lefttop" | "rightbottom";
     id: string;
+    /** Pre-insert row index for each inserted row (length must equal count). */
+    templateSourceRows?: number[];
+    /** Pre-insert column index for each inserted column (length must equal count). */
+    templateSourceColumns?: number[];
 }, changeSelection?: boolean): void;
 export declare function deleteRowCol(ctx: Context, op: {
     type: "row" | "column";

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

@@ -32,6 +32,12 @@ export declare function advancePrimaryCellInLastMultiSelection(ctx: Context, for
  * selection that runs `normalizeSelection` will re-sync from the new range.
  */
 export declare function setPrimaryCellActive(ctx: Context, r: number, c: number): void;
+/**
+ * After formula segment / delete handling, move selection focus to the edited cell
+ * (r,c). If the sheet already has a multi-cell range and (r,c) is inside it, keep
+ * that range so Enter-primary navigation + typing do not collapse the yellow box.
+ */
+export declare function snapSheetSelectionFocusToCellPreserveMultiRange(ctx: Context, r: number, c: number): void;
 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[][];

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

@@ -16,6 +16,17 @@ export declare function valueIsError(value: string): boolean;
 export declare function isRealNull(val: any): boolean;
 export declare function isHexValue(str: string): boolean;
 export declare function isRealNum(val: any): boolean;
+/**
+ * Explicit number format (`t === 'n'`) or General/Automatic with a numeric stored value (`t === 'g'`).
+ * Use wherever logic previously required `ct.t === 'n'` so Automatic numeric cells behave the same.
+ */
+export declare function isNumericCellType(cell: {
+    ct?: {
+        t?: string;
+        fa?: string;
+    };
+    v?: unknown;
+} | null | undefined): boolean;
 export type DateFormatInfo = {
     year: number;
     month: number;

package/dist/sheet-engine/core/utils/patch.d.ts

@@ -15,6 +15,8 @@ export type PatchOptions = {
         count: number;
         direction: 'lefttop' | 'rightbottom';
         id: string;
+        templateSourceRows?: number[];
+        templateSourceColumns?: number[];
     };
     deleteRowColOp?: {
         type: 'row' | 'column';

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

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

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

@@ -6,6 +6,8 @@ import { useDialog } from '../../hooks/useDialog';
 export declare function generateAPIs(context: Context, setContext: (recipe: (ctx: Context) => void, options?: SetContextOptions) => void, handleUndo: () => void, handleRedo: () => void, settings: Required<Settings>, cellInput: HTMLDivElement | null, scrollbarX: HTMLDivElement | null, scrollbarY: HTMLDivElement | null, globalCache: GlobalCache | null, refs: any): {
     applyOp: (ops: Op[]) => void;
     getCryptoPrice: typeof getCryptoPrice;
+    /** Runs the formula engine on every cell in calcChain (all sheets). Use after XLSX import so values are computed, not cached from the file. */
+    recalculateAllFormulas: () => void;
     getCellValue: (row: number, column: number, options?: api.CommonOptions & {
         type?: keyof Cell;
     }) => any;

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

@@ -12,6 +12,7 @@ type AdditionalProps = {
 declare const Workbook: React.ForwardRefExoticComponent<Settings & AdditionalProps & React.RefAttributes<{
     applyOp: (ops: Op[]) => void;
     getCryptoPrice: typeof getCryptoPrice;
+    recalculateAllFormulas: () => void;
     getCellValue: (row: number, column: number, options?: api.CommonOptions & {
         type?: keyof import('../../../core').Cell;
     }) => any;