@fileverse-dev/dsheet 2.0.0 → 2.0.1-search-2

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

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

package/dist/sheet-engine/core/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?: {

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

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

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

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

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

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

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

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

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

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

package/dist/sheet-engine/react/hooks/useFormulaEditorHistory.d.ts

@@ -7,7 +7,7 @@ export type FormulaHistoryEntry = {
     caret: number;
 };
 /** Which editor receives caret placement and drives history snapshots. */
-export type FormulaEditorHistoryPrimary = "cell" | "fx";
+export type FormulaEditorHistoryPrimary = 'cell' | 'fx';
 type SetContext = (recipe: (ctx: Context) => void, options?: SetContextOptions) => void;
 /**
  * Custom undo/redo for the cell overlay and Fx bar — **one code path** for