@fileverse-dev/dsheet 2.0.0-text → 2.0.1-search-1

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/context.d.ts

@@ -40,6 +40,37 @@ export type Context = {
     presences?: Presence[];
     showSearch?: boolean;
     showReplace?: boolean;
+    /**
+     * While picking a range for Find & Replace, the modal is closed (flags false) but
+     * this stays true so `SearchReplace` stays mounted and keeps form state. Restored
+     * when the range dialog closes.
+     */
+    findReplaceHiddenDuringRangePick?: boolean;
+    /** Snapshot of `showSearch` / `showReplace` before hiding for range pick. */
+    findReplaceRestoreVisibility?: {
+        showSearch: boolean;
+        showReplace: boolean;
+    };
+    /** In-sheet find bar (Ctrl/Cmd+F); separate from Find and Replace modal */
+    showQuickSearch?: boolean;
+    /** Bumped when Ctrl/Cmd+F is pressed while Quick Search is already open (refocus + select-all). */
+    quickSearchFocusNonce?: number;
+    /** One-shot prefill when opening Find and Replace from Quick Search; cleared after consume. */
+    findReplacePrefill?: string;
+    quickSearchLoading?: boolean;
+    /** Non-destructive match highlights for Quick Search; null when closed or no query. */
+    quickSearchHighlight?: {
+        matches: {
+            r: number;
+            c: number;
+        }[];
+        activeIndex: number;
+    } | null;
+    /** Highlighted region when Find & Replace scope is "Specific range"; null when not active. */
+    searchRangeScopeHighlight?: {
+        row: number[];
+        column: number[];
+    } | null;
     linkCard?: LinkCardProps;
     rangeDialog?: RangeDialogProps;
     warnDialog?: string;
@@ -192,6 +223,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/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,9 +7,10 @@ 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, 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, 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, getSearchIndexArr, getSearchIndexArrAsync, getFindRangeOnCurrentSheet, getQuickSearchIndexArr, getQuickSearchHiddenConfig, expandCellRectForMerge, shouldQuickSearchUseAsync, runQuickSearchIndexArrAsync, QUICK_SEARCH_ASYNC_ROW_THRESHOLD, parseRangeText, 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';
 export type { Op, Cell, CellWithRowAndCol, CellMatrix, Selection, Presence, Sheet, GlobalCache, SingleRange, Range, SearchResult, LinkCardProps, LiveQueryData, Freezen, } from './types';
+export type { CheckModes, HyperlinkMap, FindSearchScope, SearchHiddenConfig, SearchNextResult, ReplaceAllResult, } from './modules/searchReplace';
 export { cellFadeAnimator, markCellChanged } from './animate';

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

@@ -472,6 +472,20 @@ declare const _default: {
         regexTextbox: string;
         wholeTextbox: string;
         distinguishTextbox: string;
+        formulaTextbox: string;
+        linkTextbox: string;
+        allSheetsTextbox: string;
+        searchScopeLabel: string;
+        searchScopeAllSheets: string;
+        searchScopeThisSheet: string;
+        searchScopeSpecificRange: string;
+        rangeInputPlaceholder: string;
+        rangeInputInvalidError: string;
+        rangeSelectOnSheetTitle: string;
+        selectDataRangeTitle: string;
+        replaceAllWithSkippedTip: string;
+        replaceAllSuccessInfotext: string;
+        replaceAllSuccessWithSkippedInfotext: string;
         allReplaceBtn: string;
         replaceBtn: string;
         allFindBtn: string;
@@ -499,6 +513,17 @@ declare const _default: {
         locationTiplessTwoRow: string;
         locationTiplessTwoColumn: string;
         locationTipNotFindCell: string;
+        quickSearchPlaceholder: string;
+        quickSearchDialogAria: string;
+        quickSearchMoreOptionsTitle: string;
+        quickSearchOpenFindReplaceAria: string;
+        quickSearchNextAria: string;
+        quickSearchPrevAria: string;
+        quickSearchCloseAria: string;
+        quickSearchNoResults: string;
+        quickSearchSearching: string;
+        quickSearchCounterTemplate: string;
+        quickSearchMatchCountAria: string;
     };
     sheetconfig: {
         delete: string;

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

@@ -635,6 +635,20 @@ declare const _default: {
         regexTextbox: string;
         wholeTextbox: string;
         distinguishTextbox: string;
+        formulaTextbox: string;
+        linkTextbox: string;
+        allSheetsTextbox: string;
+        searchScopeLabel: string;
+        searchScopeAllSheets: string;
+        searchScopeThisSheet: string;
+        searchScopeSpecificRange: string;
+        rangeInputPlaceholder: string;
+        rangeInputInvalidError: string;
+        rangeSelectOnSheetTitle: string;
+        selectDataRangeTitle: string;
+        replaceAllWithSkippedTip: string;
+        replaceAllSuccessInfotext: string;
+        replaceAllSuccessWithSkippedInfotext: string;
         allReplaceBtn: string;
         replaceBtn: string;
         allFindBtn: string;
@@ -662,6 +676,17 @@ declare const _default: {
         locationTiplessTwoRow: string;
         locationTiplessTwoColumn: string;
         locationTipNotFindCell: string;
+        quickSearchPlaceholder: string;
+        quickSearchDialogAria: string;
+        quickSearchMoreOptionsTitle: string;
+        quickSearchOpenFindReplaceAria: string;
+        quickSearchNextAria: string;
+        quickSearchPrevAria: string;
+        quickSearchCloseAria: string;
+        quickSearchNoResults: string;
+        quickSearchSearching: string;
+        quickSearchCounterTemplate: string;
+        quickSearchMatchCountAria: string;
     };
     sheetconfig: {
         delete: string;

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

@@ -510,6 +510,20 @@ declare const _default: {
         regexTextbox: string;
         wholeTextbox: string;
         distinguishTextbox: string;
+        formulaTextbox: string;
+        linkTextbox: string;
+        allSheetsTextbox: string;
+        searchScopeLabel: string;
+        searchScopeAllSheets: string;
+        searchScopeThisSheet: string;
+        searchScopeSpecificRange: string;
+        rangeInputPlaceholder: string;
+        rangeInputInvalidError: string;
+        rangeSelectOnSheetTitle: string;
+        selectDataRangeTitle: string;
+        replaceAllWithSkippedTip: string;
+        replaceAllSuccessInfotext: string;
+        replaceAllSuccessWithSkippedInfotext: string;
         allReplaceBtn: string;
         replaceBtn: string;
         allFindBtn: string;
@@ -537,6 +551,17 @@ declare const _default: {
         locationTiplessTwoRow: string;
         locationTiplessTwoColumn: string;
         locationTipNotFindCell: string;
+        quickSearchPlaceholder: string;
+        quickSearchDialogAria: string;
+        quickSearchMoreOptionsTitle: string;
+        quickSearchOpenFindReplaceAria: string;
+        quickSearchNextAria: string;
+        quickSearchPrevAria: string;
+        quickSearchCloseAria: string;
+        quickSearchNoResults: string;
+        quickSearchSearching: string;
+        quickSearchCounterTemplate: string;
+        quickSearchMatchCountAria: string;
     };
     sheetconfig: {
         delete: string;

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

@@ -528,6 +528,20 @@ declare const _default: {
         regexTextbox: string;
         wholeTextbox: string;
         distinguishTextbox: string;
+        formulaTextbox: string;
+        linkTextbox: string;
+        allSheetsTextbox: string;
+        searchScopeLabel: string;
+        searchScopeAllSheets: string;
+        searchScopeThisSheet: string;
+        searchScopeSpecificRange: string;
+        rangeInputPlaceholder: string;
+        rangeInputInvalidError: string;
+        rangeSelectOnSheetTitle: string;
+        selectDataRangeTitle: string;
+        replaceAllWithSkippedTip: string;
+        replaceAllSuccessInfotext: string;
+        replaceAllSuccessWithSkippedInfotext: string;
         allReplaceBtn: string;
         replaceBtn: string;
         allFindBtn: string;
@@ -555,6 +569,17 @@ declare const _default: {
         locationTiplessTwoRow: string;
         locationTiplessTwoColumn: string;
         locationTipNotFindCell: string;
+        quickSearchPlaceholder: string;
+        quickSearchDialogAria: string;
+        quickSearchMoreOptionsTitle: string;
+        quickSearchOpenFindReplaceAria: string;
+        quickSearchNextAria: string;
+        quickSearchPrevAria: string;
+        quickSearchCloseAria: string;
+        quickSearchNoResults: string;
+        quickSearchSearching: string;
+        quickSearchCounterTemplate: string;
+        quickSearchMatchCountAria: string;
     };
     sheetconfig: {
         delete: string;

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

@@ -673,6 +673,20 @@ declare const _default: {
         regexTextbox: string;
         wholeTextbox: string;
         distinguishTextbox: string;
+        formulaTextbox: string;
+        linkTextbox: string;
+        allSheetsTextbox: string;
+        searchScopeLabel: string;
+        searchScopeAllSheets: string;
+        searchScopeThisSheet: string;
+        searchScopeSpecificRange: string;
+        rangeInputPlaceholder: string;
+        rangeInputInvalidError: string;
+        rangeSelectOnSheetTitle: string;
+        selectDataRangeTitle: string;
+        replaceAllWithSkippedTip: string;
+        replaceAllSuccessInfotext: string;
+        replaceAllSuccessWithSkippedInfotext: string;
         allReplaceBtn: string;
         replaceBtn: string;
         allFindBtn: string;
@@ -700,6 +714,17 @@ declare const _default: {
         locationTiplessTwoRow: string;
         locationTiplessTwoColumn: string;
         locationTipNotFindCell: string;
+        quickSearchPlaceholder: string;
+        quickSearchDialogAria: string;
+        quickSearchMoreOptionsTitle: string;
+        quickSearchOpenFindReplaceAria: string;
+        quickSearchNextAria: string;
+        quickSearchPrevAria: string;
+        quickSearchCloseAria: string;
+        quickSearchNoResults: string;
+        quickSearchSearching: string;
+        quickSearchCounterTemplate: string;
+        quickSearchMatchCountAria: string;
     };
     sheetconfig: {
         delete: string;

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

@@ -23,7 +23,9 @@ export declare class FormulaCache {
     rangedrag_row_start?: boolean;
     rangeSelectionActive?: boolean | null;
     keyboardRangeSelectionLock?: boolean;
-    formulaEditorOwner?: "cell" | "fx" | null;
+    /** True after arrow/Shift+arrow moved `func_selectedrange` without updating yellow selection. */
+    formulaKeyboardRefSync?: boolean;
+    formulaEditorOwner?: 'cell' | 'fx' | null;
     functionRangeIndex?: number[];
     functionlistMap: any;
     execFunctionExist?: 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;
@@ -51,8 +60,8 @@ 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;
+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
@@ -86,7 +95,7 @@ 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;
-export declare function functionStrChange(txt: string, type: string, rc: "row" | "col", orient: string | null, stindex: number, step: number): string;
+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;

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';
@@ -17,7 +17,8 @@ export { showImgChooser, insertImage, removeActiveImage, cancelActiveImgItem, on
 export { createDropCellRange, dropCellCache, getTypeItemHide, updateDropCell, } from './dropCell';
 export { mergeCells } from './merge';
 export { sortSelection, spillSortResult } from './sort';
-export { searchAll, searchNext, replace, replaceAll } from './searchReplace';
+export { searchAll, searchNext, replace, replaceAll, getSearchIndexArr, getSearchIndexArrAsync, getFindRangeOnCurrentSheet, getQuickSearchIndexArr, getQuickSearchHiddenConfig, expandCellRectForMerge, shouldQuickSearchUseAsync, runQuickSearchIndexArrAsync, QUICK_SEARCH_ASYNC_ROW_THRESHOLD, parseRangeText, } from './searchReplace';
+export type { CheckModes, HyperlinkMap, FindSearchScope, SearchHiddenConfig, SearchNextResult, ReplaceAllResult, } from './searchReplace';
 export { getCellRowColumn, getCellHyperlink, saveHyperlink, removeHyperlink, showLinkCard, goToLink, isLinkValid, } from './hyperlink';
 export { createFilterOptions, clearFilter, createFilter, getFilterColumnValues, getFilterColumnColors, orderbydatafiler, saveFilter, } from './filter';
 export type { FilterDate, FilterValue, FilterColor } from './filter';

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,10 +10,10 @@ 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;
     /** Pre-insert row index for each inserted row (length must equal count). */
     templateSourceRows?: number[];
@@ -21,7 +21,7 @@ export declare function insertRowCol(ctx: Context, op: {
     templateSourceColumns?: number[];
 }, 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/searchReplace.d.ts

@@ -1,37 +1,129 @@
 import { Context } from '../context';
-import { CellMatrix, SearchResult, GlobalCache } from '../types';
+import { CellMatrix, Selection, SearchResult, GlobalCache } from '../types';
 
+/** Where find/replace scans on the current sheet (workbook-wide only applies to find-all). */
+export type FindSearchScope = 'allSheets' | 'thisSheet' | 'specificRange';
+/**
+ * Return value of {@link searchNext}.
+ *
+ * @remarks
+ * **Semver:** Older releases returned `string | null` from `searchNext` (a localized message, or `null` on success).
+ * The object form is a **breaking change** for callers that still expect `string | null`; update them to read
+ * {@link SearchNextResult.alertMsg} (and optionally {@link SearchNextResult.matchIndex} /
+ * {@link SearchNextResult.matchTotal} for on-sheet scoped search UI).
+ */
+export type SearchNextResult = {
+    /** Localized message for an alert dialog, or `null` when the next/previous hit was selected successfully. */
+    alertMsg: string | null;
+    /**
+     * 0-based index of the selected hit in the current sheet's ordered hit list when
+     * `scope` is `thisSheet` or `specificRange` and navigation succeeded; otherwise `0`.
+     */
+    matchIndex: number;
+    /**
+     * Size of that hit list for `thisSheet` / `specificRange`; `0` when not applicable (e.g. `allSheets`, errors,
+     * or empty search).
+     */
+    matchTotal: number;
+};
+/** Outcome of {@link replaceAll} for UI (inline status vs. error message). */
+export type ReplaceAllResult = {
+    ok: false;
+    message: string;
+} | {
+    ok: true;
+    replaced: number;
+    skipped: number;
+};
+/** Full used grid on the active sheet for find/replace on this sheet; `null` if the sheet has no cells. */
+export declare function getFindRangeOnCurrentSheet(flowdata: CellMatrix): Selection[] | null;
+export type HyperlinkMap = Record<string, {
+    linkType?: string;
+    linkAddress?: string;
+}>;
+export interface CheckModes {
+    regCheck?: boolean;
+    wordCheck?: boolean;
+    caseCheck?: boolean;
+    /** Also search inside formula strings (cell.f) */
+    formulaCheck?: boolean;
+    /** Also search sheet hyperlink address/type for the cell */
+    linkCheck?: boolean;
+}
+/** Skip cells in hidden rows/columns (manual hide + filter). */
+export type SearchHiddenConfig = {
+    rowhidden?: Record<string, number> | null;
+    colhidden?: Record<string, number> | null;
+};
 export declare function getSearchIndexArr(searchText: string, range: {
     row: number[];
     column: number[];
-}[], flowdata: CellMatrix, { regCheck, wordCheck, caseCheck }?: {
-    regCheck: boolean;
-    wordCheck: boolean;
-    caseCheck: boolean;
-}): {
+}[], flowdata: CellMatrix, { regCheck, wordCheck, caseCheck, formulaCheck, linkCheck, }?: CheckModes, hyperlinkMap?: HyperlinkMap, hiddenConfig?: SearchHiddenConfig): {
     r: number;
     c: number;
 }[];
-export declare function searchNext(ctx: Context, searchText: string, checkModes: {
-    regCheck: boolean;
-    wordCheck: boolean;
-    caseCheck: boolean;
-}): any;
-export declare function searchAll(ctx: Context, searchText: string, checkModes: {
-    regCheck: boolean;
-    wordCheck: boolean;
-    caseCheck: boolean;
-}): SearchResult[];
+/** Use chunked async scan when the active sheet has at least this many rows. */
+export declare const QUICK_SEARCH_ASYNC_ROW_THRESHOLD = 50000;
+export declare function getQuickSearchHiddenConfig(ctx: Context): SearchHiddenConfig;
+/** Display-only, case-insensitive substring find; skips hidden rows/columns. */
+export declare function getQuickSearchIndexArr(ctx: Context, searchText: string, flowdata: CellMatrix): {
+    r: number;
+    c: number;
+}[];
+/** Bounding grid rect for overlay (merged region or single cell). */
+export declare function expandCellRectForMerge(ctx: Context, r: number, c: number): {
+    r1: number;
+    r2: number;
+    c1: number;
+    c2: number;
+};
+export declare function shouldQuickSearchUseAsync(flowdata: CellMatrix): boolean;
+/**
+ * Finds the next or previous match, updates selection and scroll, and optionally switches sheet when
+ * `scope` is `allSheets`.
+ *
+ * @param specificRange - When `scope` is `specificRange`, restricts the scan to this rectangle on the active sheet.
+ * @returns Structured result; see {@link SearchNextResult} and semver note on {@link SearchNextResult} remarks.
+ */
+export declare function searchNext(ctx: Context, searchText: string, checkModes: CheckModes, scope?: FindSearchScope, direction?: 'next' | 'prev', specificRange?: Selection): SearchNextResult;
+export declare function searchAll(ctx: Context, searchText: string, checkModes: CheckModes, scope?: FindSearchScope, specificRange?: Selection): SearchResult[];
 export declare function onSearchDialogMoveStart(globalCache: GlobalCache, e: MouseEvent, container: HTMLDivElement): void;
 export declare function onSearchDialogMove(globalCache: GlobalCache, e: MouseEvent): void;
 export declare function onSearchDialogMoveEnd(globalCache: GlobalCache): void;
-export declare function replace(ctx: Context, searchText: string, replaceText: string, checkModes: {
-    regCheck: boolean;
-    wordCheck: boolean;
-    caseCheck: boolean;
-}): any;
-export declare function replaceAll(ctx: Context, searchText: string, replaceText: string, checkModes: {
-    regCheck: boolean;
-    wordCheck: boolean;
-    caseCheck: boolean;
-}): any;
+export declare function replace(ctx: Context, searchText: string, replaceText: string, checkModes: CheckModes, specificRange?: Selection): any;
+export declare function replaceAll(ctx: Context, searchText: string, replaceText: string, checkModes: CheckModes, specificRange?: Selection): ReplaceAllResult;
+/**
+ * Asynchronously scans `flowdata` for `searchText` in chunks, yielding
+ * between chunks so the main thread stays responsive.
+ *
+ * Returns an AbortController — call `.abort()` to cancel an in-flight scan.
+ *
+ * @param onProgress - called with partial results after each chunk
+ * @param onComplete - called once with the full result array when done
+ */
+export declare function getSearchIndexArrAsync(searchText: string, range: {
+    row: number[];
+    column: number[];
+}[], flowdata: CellMatrix, modes: CheckModes, hyperlinkMap?: HyperlinkMap, hiddenConfig?: SearchHiddenConfig, onProgress?: (partial: {
+    r: number;
+    c: number;
+}[]) => void, onComplete?: (all: {
+    r: number;
+    c: number;
+}[]) => void): AbortController;
+/** Chunked quick search with hidden row/column skip (same semantics as `getQuickSearchIndexArr`). */
+export declare function runQuickSearchIndexArrAsync(ctx: Context, searchText: string, flowdata: CellMatrix, onProgress: (partial: {
+    r: number;
+    c: number;
+}[]) => void, onComplete: (all: {
+    r: number;
+    c: number;
+}[]) => void): AbortController;
+/**
+ * Parses an A1-notation range string (e.g. "E10:H14" or "Sheet1!E10:H14")
+ * into a `Selection` suitable for scoping find/replace.
+ *
+ * Returns `null` if the text is empty or cannot be parsed.
+ * The sheet-name prefix is stripped before parsing — the active sheet is always used.
+ */
+export declare function parseRangeText(rangeText: string, ctx: Context): Selection | null;

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

@@ -17,7 +17,7 @@ export declare function seletedHighlistByindex(ctx: Context, r1: number, r2: num
  * 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;
+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;
@@ -32,24 +32,30 @@ 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;
-export declare function normalizeSelection(ctx: Context, selection: SheetType["luckysheet_select_save"]): import('..').Selection[] | undefined;
+/**
+ * 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[][];
-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/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;
@@ -388,6 +388,8 @@ export type GlobalCache = {
             } | undefined;
         };
     };
+    /** Element to restore focus to after closing Quick Search (not stored in Immer context). */
+    quickSearchReturnFocus?: Element | null;
     linkCard?: {
         mouseEnter?: boolean;
         rangeSelectionModal?: {