@fileverse-dev/dsheet 2.0.6 → 2.0.7-importExport-fix-1

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

@@ -40,6 +40,32 @@ export type Context = {
     presences?: Presence[];
     showSearch?: boolean;
     showReplace?: boolean;
+    findReplaceHiddenDuringRangePick?: boolean;
+    findReplaceRestoreVisibility?: {
+        showSearch: boolean;
+        showReplace: boolean;
+    };
+    showQuickSearch?: boolean;
+    quickSearchFocusNonce?: number;
+    findReplacePrefill?: string;
+    quickSearchLoading?: boolean;
+    quickSearchHighlight?: {
+        matches: {
+            r: number;
+            c: number;
+        }[];
+        activeIndex: number;
+    } | null;
+    searchRangeScopeHighlight?: {
+        row: number[];
+        column: number[];
+    } | null;
+    /**
+     * When true, render the specific-range scope border in an emphasized style
+     * (e.g. after pressing Find). When false, keep a lighter border after
+     * confirming the range.
+     */
+    searchRangeScopeEmphasis?: boolean;
     linkCard?: LinkCardProps;
     rangeDialog?: RangeDialogProps;
     warnDialog?: string;

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, seedFormulaFuncSelectedRangeFromLastSelection, initFreeze, isInlineStringCell, getInlineStringNoStyle, applyLinkToSelection, getHyperlinksFromInlineSegments, getUniformLinkFromWindowSelectionInEditor, getHyperlinkAtCaretInContentEditable, 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, captureLinkEditorOpenSnapshot, 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, getCellHyperlinks, getHyperlinkDisplayTextInCell, getInlineLinkPlainRange, getUniformLinkCoveringPlainRange, getUniformLinkAtPlainOffset, saveHyperlink, removeHyperlink, removeHyperlinkForLink, updateHyperlinkForLink, syncLinkCardAfterHyperlinkChange, 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, execFunctionGroup, insertUpdateFunctionGroup, remapFormulaReferencesByMap, checkCF, getComputeMap, cancelPaintModel, hideCRCount, getdatabyselection, } from './modules';
+export { getBorderInfoComputeRange, getBorderInfoCompute, normalizedCellAttr, normalizedAttr, getCellValue, setCellValue, getRealCellValue, mergeBorder, cancelNormalSelected, updateCell, getRangetxt, getRangeByTxt, getInlineStringHTML, applyLinkToSelection, getHyperlinksFromInlineSegments, getUniformLinkFromWindowSelectionInEditor, getHyperlinkAtCaretInContentEditable, 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, captureLinkEditorOpenSnapshot, 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, getCellHyperlinks, getHyperlinkDisplayTextInCell, getInlineLinkPlainRange, getUniformLinkCoveringPlainRange, getUniformLinkAtPlainOffset, removeHyperlinkForLink, updateHyperlinkForLink, syncLinkCardAfterHyperlinkChange, expandCellRectForMerge, shouldQuickSearchUseAsync, runQuickSearchIndexArrAsync, QUICK_SEARCH_ASYNC_ROW_THRESHOLD, parseRangeText, getCellRowColumn, getCellHyperlink, saveHyperlink, removeHyperlink, showLinkCard, goToLink, isLinkValid, createFilterOptions, clearFilter, 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, HyperlinkEntry, 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

@@ -467,11 +467,38 @@ declare const _default: {
         locationExample: string;
         lessTwoRowTip: string;
         lessTwoColumnTip: string;
+        searchNoResults: string;
+        searchMatchCountAria: string;
+        quickSearchDialogAria: string;
+        quickSearchPlaceholder: string;
+        quickSearchSearching: string;
+        quickSearchNoResults: string;
+        quickSearchCounterTemplate: string;
+        quickSearchMatchCountAria: string;
+        quickSearchPrevAria: string;
+        quickSearchNextAria: string;
+        quickSearchMoreOptionsTitle: string;
+        quickSearchOpenFindReplaceAria: string;
+        quickSearchCloseAria: string;
         findTextbox: string;
         replaceTextbox: string;
         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;

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

@@ -630,11 +630,28 @@ declare const _default: {
         locationExample: string;
         lessTwoRowTip: string;
         lessTwoColumnTip: string;
+        quickSearchDialogAria: string;
+        quickSearchPlaceholder: string;
+        quickSearchSearching: string;
+        quickSearchNoResults: string;
+        quickSearchCounterTemplate: string;
+        quickSearchMatchCountAria: string;
+        quickSearchPrevAria: string;
+        quickSearchNextAria: string;
+        quickSearchMoreOptionsTitle: string;
+        quickSearchOpenFindReplaceAria: string;
+        quickSearchCloseAria: string;
         findTextbox: string;
         replaceTextbox: string;
         regexTextbox: string;
         wholeTextbox: string;
         distinguishTextbox: string;
+        formulaTextbox: string;
+        linkTextbox: string;
+        allSheetsTextbox: string;
+        searchScopeLabel: string;
+        searchScopeAllSheets: string;
+        searchScopeThisSheet: string;
         allReplaceBtn: string;
         replaceBtn: string;
         allFindBtn: string;

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

@@ -505,11 +505,28 @@ declare const _default: {
         locationExample: string;
         lessTwoRowTip: string;
         lessTwoColumnTip: string;
+        quickSearchDialogAria: string;
+        quickSearchPlaceholder: string;
+        quickSearchSearching: string;
+        quickSearchNoResults: string;
+        quickSearchCounterTemplate: string;
+        quickSearchMatchCountAria: string;
+        quickSearchPrevAria: string;
+        quickSearchNextAria: string;
+        quickSearchMoreOptionsTitle: string;
+        quickSearchOpenFindReplaceAria: string;
+        quickSearchCloseAria: string;
         findTextbox: string;
         replaceTextbox: string;
         regexTextbox: string;
         wholeTextbox: string;
         distinguishTextbox: string;
+        formulaTextbox: string;
+        linkTextbox: string;
+        allSheetsTextbox: string;
+        searchScopeLabel: string;
+        searchScopeAllSheets: string;
+        searchScopeThisSheet: string;
         allReplaceBtn: string;
         replaceBtn: string;
         allFindBtn: string;

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

@@ -523,11 +523,28 @@ declare const _default: {
         locationExample: string;
         lessTwoRowTip: string;
         lessTwoColumnTip: string;
+        quickSearchDialogAria: string;
+        quickSearchPlaceholder: string;
+        quickSearchSearching: string;
+        quickSearchNoResults: string;
+        quickSearchCounterTemplate: string;
+        quickSearchMatchCountAria: string;
+        quickSearchPrevAria: string;
+        quickSearchNextAria: string;
+        quickSearchMoreOptionsTitle: string;
+        quickSearchOpenFindReplaceAria: string;
+        quickSearchCloseAria: string;
         findTextbox: string;
         replaceTextbox: string;
         regexTextbox: string;
         wholeTextbox: string;
         distinguishTextbox: string;
+        formulaTextbox: string;
+        linkTextbox: string;
+        allSheetsTextbox: string;
+        searchScopeLabel: string;
+        searchScopeAllSheets: string;
+        searchScopeThisSheet: string;
         allReplaceBtn: string;
         replaceBtn: string;
         allFindBtn: string;

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

@@ -668,11 +668,28 @@ declare const _default: {
         locationExample: string;
         lessTwoRowTip: string;
         lessTwoColumnTip: string;
+        quickSearchDialogAria: string;
+        quickSearchPlaceholder: string;
+        quickSearchSearching: string;
+        quickSearchNoResults: string;
+        quickSearchCounterTemplate: string;
+        quickSearchMatchCountAria: string;
+        quickSearchPrevAria: string;
+        quickSearchNextAria: string;
+        quickSearchMoreOptionsTitle: string;
+        quickSearchOpenFindReplaceAria: string;
+        quickSearchCloseAria: string;
         findTextbox: string;
         replaceTextbox: string;
         regexTextbox: string;
         wholeTextbox: string;
         distinguishTextbox: string;
+        formulaTextbox: string;
+        linkTextbox: string;
+        allSheetsTextbox: string;
+        searchScopeLabel: string;
+        searchScopeAllSheets: string;
+        searchScopeThisSheet: string;
         allReplaceBtn: string;
         replaceBtn: string;
         allFindBtn: string;

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

@@ -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, getCellHyperlinks, getHyperlinkDisplayTextInCell, getInlineLinkPlainRange, getUniformLinkCoveringPlainRange, getUniformLinkAtPlainOffset, saveHyperlink, removeHyperlink, removeHyperlinkForLink, updateHyperlinkForLink, syncLinkCardAfterHyperlinkChange, 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/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/types.d.ts

@@ -399,6 +399,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?: {

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

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