@fileverse-dev/dsheet 2.0.6 → 2.0.7-percent

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, isTypedCurrencyDisplayFormat, isCurrencyLikeNumberFormat, 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/format.d.ts

@@ -1,7 +1,66 @@
-import { CellMatrix } from '../types';
+import { Cell, CellMatrix } from '../types';
 
+/** Below this absolute value, never use automatic scientific (Sheets-like). */
+export declare const GS_PLAIN_MAX_ABS = 999999999999997;
+/** Smallest 16-digit positive integer — use plain / text, not E-notation. */
+export declare const GS_SIXTEEN_DIGIT_MIN_ABS = 1000000000000000;
+/** Scientific only in (GS_PLAIN_MAX_ABS, 1e15) — 999…997 itself stays plain. */
+export declare function gsAllowsScientificMagnitude(av: number): boolean;
+/** Integer string (optional `-`, optional `,`) with ≥16 digits — store literally under General/Auto. */
+export declare function isSixteenPlusDigitIntegerString(value: unknown): boolean;
+/**
+ * Display string for a JS number when `toString()` may use `e` notation.
+ * Applies Sheets-like rules: no E below GS_PLAIN_MAX_ABS or at/above 16-digit scale.
+ */
+export declare function formatMForNumericCellAvoidingGsRules(v: number): string;
+/**
+ * Numeric safety gate for formula-computed numbers:
+ * - integer beyond MAX_SAFE_INTEGER => scientific
+ * - significant digits > 15 => scientific
+ */
+export declare function shouldUseScientificForComputedNumber(v: number): boolean;
+export declare function formatScientificForComputedNumber(v: number): string;
+export declare function formatCompactScientific(v: number, fractionDigits?: number): string;
+/**
+ * Sheets-like Auto decimal display:
+ * keep about 10 visible digits total (integer digits + decimal digits), with rounding.
+ * Examples:
+ * - 999999999.478 -> 999999999.5
+ * - 123456.123456 -> 123456.1235
+ */
+export declare function formatGeneralAutoDecimalWithTenDigitRule(v: number): string | null;
 export declare function datenum_local(v: Date, date1904?: number): number;
 export declare function genarate(value: string | number | boolean): any[] | null;
+/** Crypto tickers for typed prefix (e.g. BTC123) — keep aligned with toolbar CRYPTO_OPTIONS. */
+export declare const TYPED_CRYPTO_CURRENCY_PREFIXES: readonly ["BTC", "ETH", "SOL"];
+/**
+ * True when `fa` matches formats produced by typed currency/crypto prefix (or the same shape).
+ * Used so the format dropdown shows "Currency" instead of mislabeling `#,##0` masks as "Number".
+ */
+export declare function isTypedCurrencyDisplayFormat(fa: string | undefined, currencyDetail: unknown): boolean;
+/**
+ * True for currency / accounting / crypto number formats where we should keep `fa` when the user
+ * types plain text, so a later numeric entry still formats like Google Sheets.
+ */
+export declare function isCurrencyLikeNumberFormat(fa: string | undefined, currencyDetail: unknown): boolean;
+/**
+ * If the user types a known currency/crypto prefix immediately followed by a parseable number
+ * (e.g. `$1,234.5`, `€100`, `BTC1.5`), return numeric cell value + matching currency format.
+ * Uses locale `currencyDetail` (fiat symbols); object-shaped locales yield no fiat prefixes.
+ */
+export declare function parseCurrencyPrefixedInput(raw: string, currencyDetail: unknown): [string, {
+    fa: string;
+    t: string;
+}, number] | null;
+export declare function genarateOrCurrencyPrefixed(vupdateStr: string, vupdate: any, currencyDetail: unknown): ReturnType<typeof genarate>;
 export declare function update(fmt: string, v: any): string;
+/** Max decimal places for toolbar +/- on General (Auto) without switching to a numeric `fa`. */
+export declare const MAX_GENERAL_AUTO_DP = 15;
+/**
+ * Recompute `m` for numeric cells with `fa === "General"`.
+ * When `ct.dp` is set (1..MAX), uses fixed decimals like Sheets Auto + decimal buttons.
+ * Otherwise uses the usual `genarate` General display.
+ */
+export declare function refreshGeneralNumericDisplay(cell: Cell): void;
 export declare function is_date(fmt: string, v?: any): boolean;
 export declare function valueShowEs(r: number, c: number, d: CellMatrix): any;

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

@@ -2,7 +2,7 @@ export { getBorderInfoComputeRange, getBorderInfoCompute } from './border';
 export { normalizedCellAttr, normalizedAttr, getCellValue, setCellValue, getRealCellValue, mergeBorder, cancelNormalSelected, updateCell, getRangetxt, getRangeByTxt, getInlineStringHTML, getStyleByCell, clearSelectedCellFormat, clearRowsCellsFormat, clearColumnsCellsFormat, cancelFunctionrangeSelected, } from './cell';
 export { default as clipboard } from './clipboard';
 export { moveToEnd, getRangeRectsByCharacterOffset } from './cursor';
-export { update, is_date, valueShowEs } from './format';
+export { update, is_date, valueShowEs, isTypedCurrencyDisplayFormat, isCurrencyLikeNumberFormat, } 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, seedFormulaFuncSelectedRangeFromLastSelection, functionStrChange, setFormulaEditorOwner, getAllFunctionGroup, suppressFormulaRangeSelectionForInitialEdit, } from './formula';
 export { initFreeze } from './freeze';
 export { isInlineStringCell, getInlineStringNoStyle, applyLinkToSelection, getHyperlinksFromInlineSegments, getUniformLinkFromWindowSelectionInEditor, getHyperlinkAtCaretInContentEditable, } from './inline-string';
@@ -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

@@ -43,11 +43,13 @@ export type Cell = {
         cs?: number;
     };
     f?: string;
+    /** `dp`: fixed decimal places for display when `fa` is General (Auto); does not change `fa`/`t`. */
     ct?: {
         fa?: string;
         t?: string;
         tb?: string;
         s?: any;
+        dp?: number;
     };
     qp?: number;
     spl?: any;
@@ -399,6 +401,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;