@sheetxl/sdk 0.7.5 → 0.7.7

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sheetxl/sdk",
   "description": "SDK - A high-performance, embeddable spreadsheet engine.",
-  "version": "0.7.5",
+  "version": "0.7.7",
   "license": "SEE LICENSE IN <LICENSE>",
   "type": "module",
   "exports": {
@@ -43,20 +43,20 @@
     "automation"
   ],
   "dependencies": {
-    "@sheetxl/primitives": "^0.7.5",
-    "@sheetxl/scripting": "^0.7.5",
-    "@sheetxl/utils": "^0.7.5",
+    "@sheetxl/primitives": "^0.7.7",
+    "@sheetxl/scripting": "^0.7.7",
+    "@sheetxl/utils": "^0.7.7",
     "bahttext": "^2.3.0",
     "bessel": "^1.0.2",
-    "chalk": "^5.5.0",
+    "chalk": "^5.6.2",
     "chevrotain": "^11.0.3",
-    "configstore": "^7.0.0",
+    "configstore": "^7.1.0",
     "css-font-parser": "^2.0.0",
     "csstype": "^3.1.3",
     "fontkit": "^2.0.4",
     "jstat": "^1.9.6",
     "linebreak": "^1.1.0",
-    "lru-cache": "^11.0.2",
+    "lru-cache": "^11.2.2",
     "papaparse": "^5.5.3"
   },
   "devDependencies": {

package/types/index.d.ts

@@ -5,7 +5,6 @@ import { CompiledModule } from '@sheetxl/scripting';
 import { CompileOptions } from '@sheetxl/scripting';
 import { CompileResults } from '@sheetxl/scripting';
 import { CoordUtils } from '@sheetxl/utils';
-import { Dimensions } from '@sheetxl/utils';
 import { Direction } from '@sheetxl/utils';
 import { EditMode } from '@sheetxl/utils';
 import { FetchArgs } from '@sheetxl/utils';
@@ -29,6 +28,7 @@ import { RunCoords } from '@sheetxl/utils';
 import { Scalar } from '@sheetxl/primitives';
 import { ScalarType } from '@sheetxl/primitives';
 import { SelectionCoords } from '@sheetxl/utils';
+import { Size } from '@sheetxl/utils';
 import { TextAlign } from 'csstype';
 import { TopLeft } from '@sheetxl/utils';
 import { UndoManager } from '@sheetxl/utils';
@@ -805,7 +805,7 @@ declare const clampString: (str: string, maxLength?: number) => string;
  * Takes an an inner un-rotated dimension and an outer un-rotated dimension and then will return
  * an un-rotated rectangle that if rotated will fit inside the outer rectangle.
  */
-declare const clipToOuterRect: (dimInner: Dimensions, dimOuter: Dimensions, rotation?: number) => Dimensions;
+declare const clipToOuterRect: (dimInner: Size, dimOuter: Size, rotation?: number) => Size;
 
 /**
  * Capabilities for working with {@link IColor | colors}.
@@ -1321,7 +1321,7 @@ declare const getFileNameExtension: (path: string) => string;
 declare function getFontList(): readonly FontHandle[];
 
 declare interface GetRangeEntriesOptions<T = any, E = any> {
-    excludeHidden?: boolean | IRange.Orientation;
+    ignoreHidden?: boolean | IRange.Orientation;
     fullyContained?: boolean;
     onEntry?: (value: E, entry: ISpatialMap.Entry<T>) => T | void;
     noCache?: boolean;
@@ -3302,12 +3302,10 @@ export declare interface ICell {
     /**
      * Returns the cell's value as a formatted string, applying any number formatting.
      *
-     * @param numFmt A custom number format to apply (optional).
-     *
      * @see
      * {@link toTextUnformatted}
      */
-    toText(numFmt?: string): string;
+    toText(): string;
     /**
      * Returns the cell's value as an unformatted string.
      *
@@ -3354,7 +3352,7 @@ export declare interface ICell {
      * Returns `null` if this cell should be ignored for sizing purposes.
      * Either dimension can also be `null`, indicating that the specific direction should not be used.
      */
-    getBestFit(colWidth?: number, minContent?: boolean): Readonly<Partial<Dimensions>> | null;
+    getBestFit(colWidth?: number, minContent?: boolean): Readonly<Partial<Size>> | null;
     /**
      * Returns protection information.
      */
@@ -3369,7 +3367,7 @@ export declare interface ICell {
     /**
      * Returns the span dimensions for merged cells.
      */
-    getSpans(): Readonly<Dimensions>;
+    getSpans(): Readonly<Size>;
     /**
      * Returns `true` if the cell is the top-left cell of a merged region, or if it is not part of a merged region.
      */
@@ -4134,7 +4132,7 @@ export declare namespace ICellHeaderRange {
          * optionally a header orientation for skipping case be passed in.
          * An example of this is for sorting where the sort direction (row) skips hidden rows but the column direction does not.
          */
-        excludeHidden?: boolean;
+        ignoreHidden?: boolean;
     }
     /**
      * Context for Iterators to provide access to the `IRange.CellCoords`, the `ICellHeader`, and additional operators.
@@ -4357,7 +4355,7 @@ export declare interface ICellRange {
      * Returns the value for the top left `Scalar`.
      *
      * @remarks
-     * The `excludeHidden` option is ignored.
+     * The `ignoreHidden` option is ignored.
      *
      * @see
      * {@link ICellRange.getValues}
@@ -4567,6 +4565,10 @@ export declare interface ICellRange {
      * * Setting {@link ICellRange.GetValuesOptions.asJSDate} to `true` will add make slower.
      */
     getValues(options?: ICellRange.GetValuesOptions): Scalar[][];
+    /**
+     * Returns the range value as a string.
+     */
+    toText(options?: ICellRange.ToTextOptions): string;
     /**
      * Set the value(s) of one or more cells within a range.
      *
@@ -4583,6 +4585,7 @@ export declare interface ICellRange {
     setValues(values: ICellRange.ValuesUpdate, options?: ICellRange.SetValuesOptions): this;
     /**
      * Provides a convenient method for setting values with a range of calls.
+     *
      * @param update {@link ICellRange.Update}
      * @param options {@link ICellRange.UpdateCellsOptions}
      * @returns The current `ICellRange`.
@@ -4694,10 +4697,9 @@ export declare interface ICellRange {
     /**
      * Returns an iterator of ICells that match the results.
      *
-     * @param text The text to search for.
-     * @param options {@link FindOptions}
+     * @param options The text to search for or {@link FindOptions}
      */
-    find(text: string, options?: ICellRange.FindOptions): Iterator<ICell>;
+    find(options: string | ICellRange.FindOptions): Iterator<ICell>;
     /**
      * Sort the given range.
      *
@@ -4715,28 +4717,28 @@ export declare interface ICellRange {
      * By default the values will direction in whichever direction the selection shape is smaller.
      * For example a selection with a 5 column by 1 row will direction Down (rows).
      * Note - This will error if direction data will fall outsize of the max sheet size.
-     * @param orientation The direction in which to shift existing cells.
+     * @param options The orientation or The direction in which to shift existing cells.
      *   Defaults to the orientation where the range's dimension is smaller (e.g., shifts down if the range is wider than it is tall).
      *   See {@link ICellRange.getDefaultShiftOrientation} for details on the default behavior.
-     * @param options {@link ITransaction.OperationOptions}
+     *   See {@link ITransaction.OperationOptions}
      * @throws `Error` If the insertion would cause data to exceed the maximum sheet size.
      * @returns Current `ICellRange`.
      */
-    insert(orientation?: IRange.Orientation, options?: ITransaction.OperationOptions): this;
+    insert(options?: IRange.Orientation | ICellRange.InsertOptions): this;
     /**
      * Delete the cells within the range and shifts the remaining cells to fill the gap.
      *
-     * @param orientation The direction in which to shift the remaining cells.
-     *   Defaults to the orientation where the range's dimension is smaller (e.g., shifts left if the range is taller than it is wide).
+     * @param options The orientation or The direction in which to shift existing cells.
+     *   Defaults to the orientation where the range's dimension is smaller (e.g., shifts down if the range is wider than it is tall).
      *   See {@link ICellRange.getDefaultShiftOrientation} for details on the default behavior.
-     * @param options {@link ITransaction.OperationOptions}
+     *   See {@link ITransaction.OperationOptions}
      * @returns Current `ICellRange`.
      *
      * @remarks
      * This is different from clearing cells, which removes their content but doesn't affect the
      * overall sheet structure. Deleting cells results in a shift of the remaining data.
      */
-    delete(orientation?: IRange.Orientation, options?: ITransaction.OperationOptions): this;
+    delete(options?: IRange.Orientation | ICellRange.DeleteOptions): this;
     /**
      * Returns a snapshot of the current range's data and formatting suitable for copying or archiving.
      *
@@ -4967,6 +4969,13 @@ export declare interface ICellRange {
      * @returns An iterator that yields `[ICell.IteratorContext, Value]` tuples for each value within the range.
      */
     entries(options?: ICellRange.IteratorOptions): IterableIterator<ICellRange.Entry>;
+    /**
+     * Returns the values within the range, yielding each value.
+     *
+     * @param options Configuration options for the iterator, such as filtering or sorting.
+     * @returns An iterator that yields `[ICell.IteratorContext, Value]` tuples for each value within the range.
+     */
+    values(options?: ICellRange.IteratorOptions): IterableIterator<Scalar>;
     /**
      * Iterates over the cells within the range, applying the provided callback function to each cell.
      *
@@ -5023,6 +5032,28 @@ export declare namespace ICellRange {
      */
     export interface GetRangeOptions {
     }
+    /**
+     * Options for `ICellRange.delete`.
+     */
+    export interface InsertOptions extends ITransaction.OperationOptions {
+        /**
+         * The direction in which to shift existing cells.
+         *   Defaults to the orientation where the range's dimension is smaller (e.g., shifts down if the range is wider than it is tall).
+         *   See {@link ICellRange.getDefaultShiftOrientation}
+         */
+        orientation?: IRange.Orientation;
+    }
+    /**
+     * Options for `ICellRange.delete`.
+     */
+    export interface DeleteOptions extends ITransaction.OperationOptions {
+        /**
+         * The direction in which to shift existing cells.
+         *   Defaults to the orientation where the range's dimension is smaller (e.g., shifts down if the range is wider than it is tall).
+         *   See {@link ICellRange.getDefaultShiftOrientation}
+         */
+        orientation?: IRange.Orientation;
+    }
     /**
      * Shorthand for persisting.
      */
@@ -5227,10 +5258,16 @@ export declare namespace ICellRange {
          * - Optionally, you can specify a `IRange.Orientation` to indicate the header orientation for skipping cases.
          *   For example, in sorting, you might want to skip hidden rows but not hidden columns.
          */
-        excludeHidden?: boolean | IRange.Orientation;
+        ignoreHidden?: boolean | IRange.Orientation;
         /** {@inheritDoc ICellRange.IteratorOptions.includeMergeOverflow} */
         includeMergeOverflow?: boolean;
     }
+    /**
+     * Options for {@link ICellRange.toText}.
+     */
+    export interface ToTextOptions extends ICellRange.GetValuesOptions {
+        ignoreFormatting?: boolean;
+    }
     /**
      * Options for {@link ICellRange.autoFit}.
      */
@@ -5482,6 +5519,12 @@ export declare namespace ICellRange {
      * Options for {@link ICellRange.find}.
      */
     export interface FindOptions extends FindCriteria {
+        /**
+         * The text to search for.
+         *
+         * @required
+         */
+        text: string;
         /**
          * Provides custom logic for matching values during the find operation.
          *
@@ -5623,6 +5666,15 @@ export declare namespace ICellRange {
      * Alias type for count results by type.
      */
     export type Counts = Partial<Record<ICell.Content, number>>;
+    export interface ScrollIntoViewOptions extends globalThis.ScrollIntoViewOptions {
+        /**
+         * If provided then will only scroll in the provided orientation.
+         *
+         * @remarks
+         * This is useful for only scrolling vertically or horizontally for insert/deleteCells
+         */
+        orientation?: IRange.Orientation;
+    }
     /**
      * Extends SelectionOptions to include the option to adjust the anchor cell.
      */
@@ -5636,6 +5688,17 @@ export declare namespace ICellRange {
          * If the current anchor is not within the current range this will be forced to `true`.
          */
         anchor?: boolean | Partial<IRange.CellCoords>;
+        /**
+         * If `true` or if a valid `ScrollIntoViewOptions` object is provided,
+         * the selected element will be scrolled into view.
+         *
+         * @remarks
+         * - If a `ScrollIntoViewOptions` object is provided, it will control the exact scrolling behavior.
+         * - If `false` (or omitted), the selected element will not be scrolled into view.
+         *
+         * @defaultValue false
+         */
+        scrollIntoView?: boolean | ICellRange.ScrollIntoViewOptions;
     }
     /**
      * Options for customizing how values are retrieved from a range and returned as a 2D array.
@@ -5669,7 +5732,7 @@ export declare namespace ICellRange {
          * Optionally a header orientation for skipping case be passed in.
          * An example of this is for sorting where the sort direction (row) skips hidden rows but the column direction does not.
          */
-        excludeHidden?: boolean | IRange.Orientation;
+        ignoreHidden?: boolean | IRange.Orientation;
         /**
          * If set to true the only the raw values will be visited.
          *
@@ -5678,7 +5741,7 @@ export declare namespace ICellRange {
          * @remarks
          * This allows for much faster reading when only the value is needed.
          */
-        excludeCellDetails?: boolean;
+        ignoreCellDetails?: boolean;
         /**
          * Includes any merge overflow in first element visited.
          *
@@ -5866,7 +5929,7 @@ export declare interface ICellRanges {
     /**
      * {@inheritDoc ICellRange.find}
      */
-    find(findText: string, options?: ICellRange.FindOptions): Iterator<ICell>;
+    find(options: string | ICellRange.FindOptions): Iterator<ICell>;
     /**
      * Iterates over the values, yielding each values in the collection.
      *
@@ -5902,7 +5965,7 @@ export declare interface ICellRanges {
     /**
      * {@inheritDoc ICellRange.merge}
      */
-    merge(options?: ICellRange.MergeOptions | IRange.Orientations): this;
+    merge(options?: IRange.Orientations | ICellRange.MergeOptions): this;
     /**
      * {@inheritDoc ICellRange.unmerge}
      */
@@ -5910,11 +5973,11 @@ export declare interface ICellRanges {
     /**
      * {@inheritDoc ICellRange.insert}
      */
-    insert(orientation?: IRange.Orientation, options?: ITransaction.OperationOptions): this;
+    insert(options?: IRange.Orientation | ICellRange.InsertOptions): this;
     /**
      * {@inheritDoc ICellRange.delete}
      */
-    delete(orientation?: IRange.Orientation, options?: ITransaction.OperationOptions): this;
+    delete(options?: IRange.Orientation | ICellRange.DeleteOptions): this;
     /**
      * {@inheritDoc ICellRange.insertFrom}
      */
@@ -7901,7 +7964,7 @@ export declare namespace IConditionalFormatCollection {
          *
          * @defaultValue false
          */
-        excludeHidden?: boolean;
+        ignoreHidden?: boolean;
         /**
          * Only return items that are completely contained with the search bounds.
          *
@@ -10094,7 +10157,7 @@ export declare namespace IMovableCollection {
          * Indicate if items that are in hidden headers or marked as hidden should be returned.
          * @defaultValue false
          */
-        excludeHidden?: boolean;
+        ignoreHidden?: boolean;
         /**
          * The type to search for. If not provided all items will be returned.
          */
@@ -10660,7 +10723,7 @@ export declare namespace IPicture {
         /**
          * The size of the image without any constraints. This info is determined by the file.
          */
-        getNaturalDimensions(): Dimensions;
+        getNaturalSize(): Size;
         /**
          * As a url that can be attached to the dom.
          */
@@ -11684,7 +11747,7 @@ export declare interface ISheet extends ITransaction.ITransactional, IListener.I
      * @see
      * {@link ICellRange.find}
      */
-    find(text: string, options?: ICellRange.FindOptions): Iterator<ICell>;
+    find(options: string | ICellRange.FindOptions): Iterator<ICell>;
     /**
      * Enable and return an {@link IAutoFilter}.
      *
@@ -11888,9 +11951,9 @@ export declare interface ISheet extends ITransaction.ITransactional, IListener.I
     /**
      * Returns a JSON representation of the sheet.
      *
-     * @param excludeData If `true` only meta data about the sheet will be saved.
+     * @param ignoreData If `true` only meta data about the sheet will be saved.
      */
-    toJSON(excludeData?: boolean): Promise<ISheet.JSON>;
+    toJSON(ignoreData?: boolean): Promise<ISheet.JSON>;
     /**
      * Free all resources associated with the sheet.
      *
@@ -12079,7 +12142,7 @@ export declare namespace ISheet {
          * @remarks
          * This should only be handled by one consumer.
          */
-        onRequestScrollIntoView?(source: ISheet, options: ScrollToOptions): Promise<boolean>;
+        onRequestScrollIntoView?(source: ISheet, options: ISheet.ScrollToOptions): Promise<boolean>;
         /**
          * Request that the sheet become focused.
          * @returns A promise indicating if the focus was honored.
@@ -13206,7 +13269,7 @@ export declare namespace ISort {
     export interface DefaultSortCriteria {
         /**
          * The cords that will be sorted.
-         * This may exclude the header.
+         * This may ignore the header.
          */
         coords: IRange.Coords;
         /**
@@ -14139,7 +14202,7 @@ export declare interface IStyle {
     /**
      * Returns the best fit size assuming no content.
      */
-    getBestFit(): Partial<Dimensions> | null;
+    getBestFit(): Partial<Size> | null;
     /**
      * Returns insets used for content. This does not taking into account indent because
      * this is alignment and type specific.
@@ -14884,7 +14947,7 @@ export declare interface IStyledFont {
      * Additionally due to the nature of css having different properties for the same logic value
      * (for example color, backgroundColor)
      */
-    toCSS(darkMode?: boolean, zoom?: number, excludeNormal?: boolean): Properties;
+    toCSS(darkMode?: boolean, zoom?: number, ignoreNormal?: boolean): Properties;
     /**
      * Serializes to a JSON object.
      */
@@ -15406,7 +15469,7 @@ export declare namespace ITableCollection {
          *
          * @defaultValue false
          */
-        excludeHidden?: boolean;
+        ignoreHidden?: boolean;
         /**
          * Only return items that are completely contained with the filter bounds.
          *
@@ -15968,7 +16031,7 @@ export declare interface ITextFrame {
      *
      * @param dimensions will cause the text to wrap. If bounds are not specified or only a dimension then it will not wrap.
      */
-    layout(dimensions?: Partial<Dimensions>): ITextFrame;
+    layout(dimensions?: Partial<Size>): ITextFrame;
     /**
      * This is the bound of a textfield include any whitespace
      */
@@ -17062,7 +17125,7 @@ export declare namespace ITypes {
          *
          * @defaultValue false
          */
-        scrollIntoView?: globalThis.ScrollIntoViewOptions | boolean;
+        scrollIntoView?: boolean | globalThis.ScrollIntoViewOptions;
         /**
          * If `true`, the selected element will automatically receive focus after being selected.
          *
@@ -17167,8 +17230,7 @@ export declare interface IWorkbook extends ITransaction.ITransactional, IListene
     /**
      * Search the entire Workbook.
      *
-     * @param text The text to search for.
-     * @param options {@link ICellRange.FindOptions}
+     * @param options The text to search for or {@link ICellRange.FindOptions}
      *
      * @remarks
      * Searches all sheets.
@@ -17176,7 +17238,7 @@ export declare interface IWorkbook extends ITransaction.ITransactional, IListene
      * @see
      * {@link ICellRange.find}
      */
-    find(text: string, options?: ICellRange.FindOptions): Iterator<ICell>;
+    find(options: string | ICellRange.FindOptions): Iterator<ICell>;
     /**
      * Replace all items in the iterator
      *
@@ -17207,6 +17269,7 @@ export declare interface IWorkbook extends ITransaction.ITransactional, IListene
     findValidSheetName(sheetName: string): string;
     /**
      * Indicate if the current character is a valid character for a sheetName.
+     *
      * @param character The string to validate.
      */
     isValidSheetNameCharacter(character: string): boolean;
@@ -17250,6 +17313,7 @@ export declare interface IWorkbook extends ITransaction.ITransactional, IListene
     setTheme(theme: ITheme | null): ITheme;
     /**
      * Is date resolution 1904 instead of 1900 based.
+     *
      * @see
      * {@link https://support.microsoft.com/en-us/office/date-systems-in-excel-e7fe7167-48a9-4b96-bb53-5612a800b487}
      */
@@ -17291,9 +17355,9 @@ export declare interface IWorkbook extends ITransaction.ITransactional, IListene
     /**
      * Serialize the workbook to a JSON.
      *
-     * @param excludeData If `true` only meta data about the workbook will be saved.
+     * @param ignoreData If `true` only meta data about the workbook will be saved.
      */
-    toJSON(excludeData?: boolean): Promise<IWorkbook.JSON>;
+    toJSON(ignoreData?: boolean): Promise<IWorkbook.JSON>;
     /**
      * Returns any custom workbook options that are provided in constructor.
      */
@@ -18397,7 +18461,7 @@ declare namespace RangeState {
     interface IteratorOptions extends OverlappingRange.IteratorOptions {
         includeRangeTypes: boolean | SearchTypes;
         bounds?: IRange.Coords;
-        excludeHidden?: boolean | IRange.Orientation;
+        ignoreHidden?: boolean | IRange.Orientation;
         includeMergeOverflow?: boolean;
     }
     interface Entry {
@@ -18626,7 +18690,7 @@ export declare class Sheet implements ISheet {
     };
     protected _lastGetRangeRead: Record<string, {
         ranges: readonly IRange.Coords[];
-        excludeHidden: boolean | IRange.Orientation;
+        ignoreHidden: boolean | IRange.Orientation;
         results: any[];
     }>;
     protected _lastUsedCoordsRead: {
@@ -18669,7 +18733,7 @@ export declare class Sheet implements ISheet {
     protected _closed: boolean;
     protected _defaultColWidthCache: number;
     protected _defaultRowHeightCache: number;
-    protected _defaultFontBoundsCache: Readonly<Dimensions>;
+    protected _defaultFontBoundsCache: Readonly<Size>;
     constructor(options?: ISheet.ConstructorOptions);
     /* Excluded from this release type: _createRange */
     /* Excluded from this release type: _createRanges */
@@ -18753,7 +18817,7 @@ export declare class Sheet implements ISheet {
     /** {@inheritDoc ISheet.getSelectedCell} */
     getSelectedCell(): ICell;
     /** {@inheritDoc ISheet.find} */
-    find(text: string, options?: ICellRange.FindOptions): Iterator<ICell>;
+    find(options?: string | ICellRange.FindOptions): Iterator<ICell>;
     /* Excluded from this release type: _find */
     /** {@inheritDoc ISheet.isDate1904} */
     isDate1904(): boolean;
@@ -18769,6 +18833,7 @@ export declare class Sheet implements ISheet {
     /* Excluded from this release type: _selectSheet */
     /** {@inheritDoc ISheet.scrollTo} */
     scrollTo(coords: Partial<IRange.Coords>, options?: ISheet.ScrollToOptions): Promise<boolean>;
+    /* Excluded from this release type: _resolveSelectOptions */
     /* Excluded from this release type: _commitAndAutoSelect */
     /* Excluded from this release type: _autoSelect */
     /** {@inheritDoc ISheet.getSelection} */
@@ -18786,7 +18851,7 @@ export declare class Sheet implements ISheet {
     /** {@inheritDoc ISheet.getColumnHeaders} */
     getColumnHeaders(): ISheetHeader;
     /** {@inheritDoc ISheet.toJSON} */
-    toJSON(excludeData?: boolean): Promise<ISheet.JSON>;
+    toJSON(ignoreData?: boolean): Promise<ISheet.JSON>;
     /** {@inheritDoc ISheet.getStyles} */
     getStyles(): IStyleCollection;
     /** {@inheritDoc ISheet.getResources} */
@@ -18972,7 +19037,7 @@ declare class SheetHeader implements ISheetHeader {
     constructor(options: SheetHeader.ConstructorOptions);
     /** {@inheritDoc IListener.ISource.addListeners} */
     addListeners(listeners: ISheetHeader.IListeners, options?: IListener.Options): IListener.Remove;
-    protected _invalidSizes(): void;
+    protected _invalidSizes(force?: boolean): void;
     protected _onHeaderChange(): void;
     /** {@inheritDoc ISheetHeader.getSheet} */
     getSheet(): ISheet;
@@ -20882,7 +20947,7 @@ export declare class Workbook implements IWorkbook {
     /* Excluded from this release type: _validateDeleteSheet */
     /* Excluded from this release type: _findOffsetForId */
     /** {@inheritDoc IWorkbook.find} */
-    find(text: string, options?: ICellRange.FindOptions): Iterator<ICell>;
+    find(options: string | ICellRange.FindOptions): Iterator<ICell>;
     /** {@inheritDoc IWorkbook.replace} */
     replace(cells: Iterator<ICell>, replace: ICell.Update | ((original: ICell) => ICell.Update), options?: IWorkbook.ReplaceOptions): IWorkbook.ReplaceResults;
     /* Excluded from this release type: _nextSheetIndex */
@@ -20927,7 +20992,7 @@ export declare class Workbook implements IWorkbook {
     /* Excluded from this release type: _fromJSON */
     /* Excluded from this release type: _createScripts */
     /** {@inheritDoc IWorkbook.toJSON} */
-    toJSON(excludeData?: boolean): Promise<IWorkbook.JSON>;
+    toJSON(ignoreData?: boolean): Promise<IWorkbook.JSON>;
     /** {@inheritDoc IWorkbook.isClosed} */
     isClosed(): boolean;
     /** {@inheritDoc IWorkbook.close} */