@fileverse-dev/dsheet 1.3.18-patch.6 → 2.0.0-insert

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

@@ -110,6 +110,15 @@ export type Context = {
     sheetScrollRecord: Record<string, any>;
     luckysheet_select_status: boolean;
     luckysheet_select_save: Sheet['luckysheet_select_save'];
+    /**
+     * Sheet row/column (0-based) for the extra primary-cell outline. Kept in context so
+     * features can move it via `setPrimaryCellActive`; it is auto-synced from the
+     * top-left of the last multi-cell selection whenever `normalizeSelection` runs.
+     */
+    primaryCellActive: {
+        r: number;
+        c: number;
+    } | null;
     luckysheet_selection_range: Sheet['luckysheet_selection_range'];
     formulaRangeHighlight: ({
         rangeIndex: number;

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, 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 { 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 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/formula.d.ts

@@ -81,6 +81,8 @@ export declare function markRangeSelectionDirty(ctx: Context): void;
  */
 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;
+/** True while picking a range for a formula (sheet selection drives references). */
+export declare function isLegacyFormulaRangeMode(ctx: Context): boolean;
 export declare function israngeseleciton(ctx: Context, istooltip?: boolean): boolean;
 export declare function isFormulaReferenceInputMode(ctx: Context): boolean;
 export declare function maybeRecoverDirtyRangeSelection(ctx: Context): boolean;

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, 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, functionStrChange, setFormulaEditorOwner, getAllFunctionGroup, 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, moveHighlightCell, deleteSelectedCellText, selectAll, fixRowStyleOverflowInFreeze, fixColumnStyleOverflowInFreeze, calcSelectionInfo, rangeValueToHtml, } from './selection';
+export { scrollToHighlightCell, seletedHighlistByindex, selectTitlesMap, selectTitlesRange, normalizeSelection, syncPrimaryCellActiveFromSelection, setPrimaryCellActive, advancePrimaryCellInLastMultiSelection, 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';

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

@@ -12,6 +12,26 @@ export declare function seletedHighlistByindex(ctx: Context, r1: number, r2: num
     top: number;
     height: number;
 } | null;
+/**
+ * Updates `ctx.primaryCellActive` from a selection list (multi-cell → active focus cell;
+ * else null). Pass `selection` explicitly when normalizing a **new** array that is not
+ * yet assigned to `ctx.luckysheet_select_save`.
+ */
+export declare function syncPrimaryCellActiveFromSelection(ctx: Context, selection?: SheetType["luckysheet_select_save"] | null): void;
+/**
+ * Multi-cell range only: move `row_focus` / `column_focus` (and primary) in
+ * column-major order — forward: down then next column right, wrapping top-left;
+ * backward (Shift+Enter): up then previous column left, wrapping bottom-right.
+ * Does not enter edit mode. Returns false if not a multi-cell selection.
+ */
+export declare function advancePrimaryCellInLastMultiSelection(ctx: Context, forward?: boolean): boolean;
+/**
+ * Pin the primary-cell highlight to a sheet cell. Prefer calling inside the same
+ * `setContext` (draft) as your selection update, after `normalizeSelection`, so a
+ * later normalize in the same commit does not overwrite it. The next user-driven
+ * selection that runs `normalizeSelection` will re-sync from the new range.
+ */
+export declare function setPrimaryCellActive(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/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/formula-parser/helper/number.d.ts

@@ -1,14 +1,15 @@
 /**
- * Convert value into number.
+ * Convert value into number for arithmetic (+ - * / ^, unary +/-, numeric literals).
+ * Strings that are not strictly numeric (no parseFloat prefix tricks) become NaN.
  *
- * @param {String|Number} number
- * @returns {*}
+ * @param {*} number
+ * @returns {number|NaN}
  */
-export function toNumber(number: string | number): any;
+export function toNumber(number: any): number | number;
 /**
- * Invert provided number.
+ * Invert provided number (unary minus).
  *
- * @param {Number} number
- * @returns {Number} Returns inverted number.
+ * @param {*} number
+ * @returns {number}
  */
-export function invertNumber(number: number): number;
+export function invertNumber(number: any): number;

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;