@sheetxl/sdk 0.7.6 → 0.7.8

package/types/scripting.d.ts

@@ -1396,7 +1396,7 @@ declare module "type/ITypes" {
              *
              * @defaultValue false
              */
-            scrollIntoView?: globalThis.ScrollIntoViewOptions | boolean;
+            scrollIntoView?: boolean | globalThis.ScrollIntoViewOptions;
             /**
              * If `true`, the selected element will automatically receive focus after being selected.
              *
@@ -14115,7 +14115,7 @@ declare module "calculation/formula/IFormulaParser" {
     }
 }
 declare module "utils/_RangeCoordUtils" {
-    import { CellCoords, RangeCoords, RangeOrientation } from '@sheetxl/utils';
+    import { IRange } from '@sheetxl/primitives';
     /**
      * This is a more advanced use case of ranges that takes an array of ranges and uses an r-tree algo to
      * determine if the ranges intersects.
@@ -14123,7 +14123,7 @@ declare module "utils/_RangeCoordUtils" {
      * @param ranges
      * @returns A flag indicating if any of the ranges intersect.
      */
-    export const rangesArrayIntersect: (ranges: readonly RangeCoords[]) => boolean;
+    export const rangesArrayIntersect: (ranges: readonly IRange.Coords[]) => boolean;
     /**
      * Rolls a potential 2d array into a single array.
      * @param array
@@ -14137,7 +14137,7 @@ declare module "utils/_RangeCoordUtils" {
      * Additional this takes an onVisit callback.
      */
     export const build2DArray: <T>(values: T[], width: number, onVisit?: (val: T) => T) => T[][];
-    export const removeRangesWithOffsets: (ranges: RangeCoords[], set: Set<number>) => RangeCoords[];
+    export const removeRangesWithOffsets: (ranges: IRange.Coords[], set: Set<number>) => IRange.Coords[];
     /**
      * Returns true if the outer span intersects the inner span.
      * @remarks
@@ -14153,7 +14153,7 @@ declare module "utils/_RangeCoordUtils" {
     /**
      * Returns true if the range intersections in an orientation.
      */
-    export const isSplitRangeSpan: (outerRange: RangeCoords, innerRange: RangeCoords, isColumn: boolean) => boolean;
+    export const isSplitRangeSpan: (outerRange: IRange.Coords, innerRange: IRange.Coords, isColumn: boolean) => boolean;
     /**
      * Subtract Range b from from a.
      *
@@ -14166,27 +14166,27 @@ declare module "utils/_RangeCoordUtils" {
      * * If no interaction then b will be returned.
      * * If beforeSplit === rangeToRemove then empty array is returned.
      */
-    export const subtractRange: (beforeSplit: RangeCoords, rangeToRemove: RangeCoords, orientation?: RangeOrientation) => RangeCoords[];
+    export const subtractRange: (beforeSplit: IRange.Coords, rangeToRemove: IRange.Coords, orientation?: IRange.Orientation) => IRange.Coords[];
     /**
      * Visit ranges looking to see if range intersects. If so then onOverlap will be called.
      * @param range
      * @param ranges
      * @param onOverlap
      */
-    export const visitRangeIntersects: (ranges: RangeCoords[], range: RangeCoords, onOverlap: (range: RangeCoords, isSplit: boolean, index: number) => void) => void;
+    export const visitRangeIntersects: (ranges: IRange.Coords[], range: IRange.Coords, onOverlap: (range: IRange.Coords, isSplit: boolean, index: number) => void) => void;
     /**
      * Returns a CellCoords that is the top left.
      * @param range A RangeCoord to check.
      */
-    export const topLeft: (range: RangeCoords | undefined) => CellCoords;
-    export const createColOffsetComparator: (aRange: RangeCoords, bRange: RangeCoords) => ((a: CellCoords, b: CellCoords) => number);
-    export const createRowOffsetComparator: (aRange: RangeCoords, bRange: RangeCoords) => ((a: CellCoords, b: CellCoords) => number);
+    export const topLeft: (range: IRange.Coords | undefined) => IRange.CellCoords;
+    export const createColOffsetComparator: (aRange: IRange.Coords, bRange: IRange.Coords) => ((a: IRange.CellCoords, b: IRange.CellCoords) => number);
+    export const createRowOffsetComparator: (aRange: IRange.Coords, bRange: IRange.Coords) => ((a: IRange.CellCoords, b: IRange.CellCoords) => number);
     /**
      * Determines the copy coordinates trying to find the lcm.
      */
-    export const coordsLCM: (dest: RangeCoords, // destination (for top,left)
-    size: RangeCoords, // source (for sizing)
-    fit?: boolean, transpose?: boolean) => RangeCoords;
+    export const coordsLCM: (dest: IRange.Coords, // destination (for top,left)
+    size: IRange.Coords, // source (for sizing)
+    fit?: boolean, transpose?: boolean) => IRange.Coords;
 }
 declare module "collections/RepeatingList" {
     import { IList, IListLike } from "collections/IList";
@@ -15093,8 +15093,7 @@ declare module "workbook/IWorkbook" {
         /**
          * 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.
@@ -15102,7 +15101,7 @@ declare module "workbook/IWorkbook" {
          * @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
          *
@@ -15133,6 +15132,7 @@ declare module "workbook/IWorkbook" {
         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;
@@ -15176,6 +15176,7 @@ declare module "workbook/IWorkbook" {
         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}
          */
@@ -19539,7 +19540,7 @@ declare module "sheet/clipboard/_ClipboardUtils" {
      */
     export const parseAsTable: (htmlDoc: Document, plainTextArray: string[][], parser: IHTMLParser.TableParser) => boolean;
 }
-declare module "utils/CSSUtils" {
+declare module "utils/_CSSUtils" {
     import { TextDecoration as CSSTextDecoration } from 'csstype';
     import { Bounds } from '@sheetxl/utils';
     import { IColor } from "color/index";
@@ -19840,7 +19841,7 @@ declare module "sheet/header/_HeaderUtils" {
     export const createRunsFromSelection: (header: ISheetHeader, selection: IRangeSelection.Coords, maxRange: IRange.Coords) => ITypes.RunCoordValue<ISheetHeader.SelectedRun>[];
 }
 declare module "sheet/header/SheetCellHeader" {
-    import { RangeOrientation } from '@sheetxl/utils';
+    import { IRange } from '@sheetxl/primitives';
     import { IStyle, IStyleCollection } from "style/index";
     import { ICell, ICellHeader } from "cell/index";
     import { ISheetHeader } from "sheet/header/ISheetHeader";
@@ -19871,7 +19872,7 @@ declare module "sheet/header/SheetCellHeader" {
         /** {@inheritDoc ICellHeader.getDisplayText} */
         getDisplayText(): string;
         /** {@inheritDoc ICellHeader.getOrientation} */
-        getOrientation(): RangeOrientation;
+        getOrientation(): IRange.Orientation;
         /** {@inheritDoc ICellHeader.isHidden} */
         isHidden(): boolean;
         /** {@inheritDoc ICellHeader.isCustomSize} */
@@ -19964,7 +19965,7 @@ declare module "sheet/header/SheetHeader" {
         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;
@@ -21668,7 +21669,7 @@ declare module "sheet/SheetRanges" {
         /** {@inheritDoc ICellRanges.addListener} */
         addListener(listener: ICellRange.Listener, options?: ICellRange.ListenerOptions): IListener.Remove;
         /** {@inheritDoc ICellRanges.find} */
-        find(findText: string, options?: ICellRange.FindOptions): Iterator<ICell>;
+        find(options: string | ICellRange.FindOptions): Iterator<ICell>;
         /** {@inheritDoc ICellRanges.getFlattened} */
         getFlattened(options?: ICellRange.GetFlattenOptions): this;
         /** {@inheritDoc ICellRanges.getVisible} */
@@ -21682,15 +21683,15 @@ declare module "sheet/SheetRanges" {
         /** {@inheritDoc ICellRanges.getStyle} */
         getStyle(): IStyle;
         /** {@inheritDoc ICellRanges.merge} */
-        merge(options?: ICellRange.MergeOptions | IRange.Orientations): this;
+        merge(options?: IRange.Orientations | ICellRange.MergeOptions): this;
         /** {@inheritDoc ICellRanges.unmerge} */
         unmerge(options?: ITransaction.OperationOptions): this;
         /** {@inheritDoc ICellRanges.getMerges} */
         getMerges(): IRange.Coords[];
         /** {@inheritDoc ICellRanges.insert} */
-        insert(orientation?: IRange.Orientation, options?: ITransaction.OperationOptions): this;
+        insert(options?: IRange.Orientation | ICellRange.InsertOptions): this;
         /** {@inheritDoc ICellRanges.delete} */
-        delete(orientation?: IRange.Orientation, options?: ITransaction.OperationOptions): this;
+        delete(options?: IRange.Orientation | ICellRange.DeleteOptions): this;
         /** {@inheritDoc ICellRanges.insertFrom} */
         insertFrom(source: ICellRange.Address | ICellRange.ISnapshot, options?: ICellRange.InsertFromOptions): Promise<this | null>;
         /** {@inheritDoc ICellRanges.copyFrom} */
@@ -22223,9 +22224,9 @@ declare module "sheet/Sheet" {
         /** @internal */
         protected _insertFrom(ranges: readonly IRange.Coords[], source: ICellRange.Address | ICellRange.ISnapshot, options?: ICellRange.InsertFromOptions): Promise<IRange.Coords>;
         /** @internal */
-        protected _insertCells(ranges: readonly IRange.Coords[], orientation: IRange.Orientation, options?: ITransaction.OperationOptions, coordValidator?: CoordUtils.CoordValidator): void;
+        protected _insertCells(ranges: readonly IRange.Coords[], options?: IRange.Orientation | ICellRange.InsertOptions, coordValidator?: CoordUtils.CoordValidator): void;
         /** @internal */
-        protected _deleteCells(ranges: readonly IRange.Coords[], orientation?: IRange.Orientation, options?: ITransaction.OperationOptions): void;
+        protected _deleteCells(ranges: readonly IRange.Coords[], options?: IRange.Orientation | ICellRange.DeleteOptions): void;
         /**
          * Automatically adjusts row heights and column widths to fit cell content and styles.
          * - Merges and sorts input ranges for efficient processing.
@@ -22279,9 +22280,9 @@ declare module "sheet/Sheet" {
         /** {@inheritDoc ISheet.getSelectedCell} */
         getSelectedCell(): ICell;
         /** {@inheritDoc ISheet.find} */
-        find(text: string, options?: ICellRange.FindOptions): Iterator<ICell>;
+        find(options?: string | ICellRange.FindOptions): Iterator<ICell>;
         /** @internal */
-        protected _find(ranges: readonly IRange.Coords[], findText: string, options?: ICellRange.FindOptions): Iterator<ICell>;
+        protected _find(ranges: readonly IRange.Coords[], options: string | ICellRange.FindOptions): Iterator<ICell>;
         /** {@inheritDoc ISheet.isDate1904} */
         isDate1904(): boolean;
         /** @internal */
@@ -22293,7 +22294,7 @@ declare module "sheet/Sheet" {
         /** {@inheritDoc ISheet.getColumnWidthAsFontUnit} */
         getColumnWidthAsFontUnit(pixelWidth: number): number;
         /**
-         * col width in pixels
+         * col width in character units
          * @internal
          */
         protected _defaultColWidth(): number;
@@ -22305,13 +22306,15 @@ declare module "sheet/Sheet" {
         /** {@inheritDoc ISheet.getProtection} */
         getProtection(): ISheetProtection;
         /** @internal */
-        protected _selectSheet(coords: IRange.Coords, scrollIntoView?: globalThis.ScrollIntoViewOptions | boolean): Promise<boolean>;
+        protected _selectSheet(coords: IRange.Coords, scrollIntoView?: boolean | ICellRange.ScrollIntoViewOptions): Promise<boolean>;
         /** {@inheritDoc ISheet.scrollTo} */
         scrollTo(coords: Partial<IRange.Coords>, options?: ISheet.ScrollToOptions): Promise<boolean>;
         /** @internal */
-        protected _commitAndAutoSelect(trans: ITransaction, selection: Partial<IRangeSelection.Coords>, selectOptions?: boolean | ICellRange.SelectOptions, commitOptions?: ITransaction.StoreOperationOptions<CommitView>): Promise<IRange.Coords[]>;
+        protected _resolveSelectOptions(selectOptions: boolean | ICellRange.SelectOptions, orientation: IRange.Orientation): ICellRange.SelectOptions;
         /** @internal */
-        protected _autoSelect(options?: boolean | ICellRange.SelectOptions, selection?: Partial<IRangeSelection.Coords>): Promise<IRange.Coords[]>;
+        protected _commitAndAutoSelect(trans: ITransaction, selection: Partial<IRangeSelection.Coords>, selectOptions?: boolean | ICellRange.SelectOptions, commitOptions?: ITransaction.StoreOperationOptions<CommitView>, orientation?: IRange.Orientation): Promise<IRange.Coords[]>;
+        /** @internal */
+        protected _autoSelect(options?: boolean | ICellRange.SelectOptions, selection?: Partial<IRangeSelection.Coords>, orientation?: IRange.Orientation): Promise<IRange.Coords[]>;
         /** {@inheritDoc ISheet.getSelection} */
         getSelection(): IRangeSelection;
         /** {@inheritDoc ISheet.getView} */
@@ -22490,10 +22493,12 @@ declare module "sheet/SheetRange" {
         protected _deriveRange(address: ICellRange.Address, options: ICellRange.GetRangeOptions, callback?: (newCoords: IRange.Coords, origCoords: IRange.Coords) => IRange.Coords): this;
         /** @internal */
         protected _validateMaxSize(maxSize?: number): void;
-        /** {@inheritDoc ICellRange[Symbol.iterator]} */
-        [Symbol.iterator](): IterableIterator<Scalar>;
         /** {@inheritDoc ICellRange.entries} */
         entries(options?: ICellRange.IteratorOptions): IterableIterator<ICellRange.Entry>;
+        /** {@inheritDoc ICellRange[Symbol.iterator]} */
+        [Symbol.iterator](): IterableIterator<Scalar>;
+        /** {@inheritDoc ICellRange.values} */
+        values(options?: ICellRange.IteratorOptions): IterableIterator<Scalar>;
         /** {@inheritDoc ICellRange.forEach} */
         forEach<T>(callback: ICellRange.ForEachCallback, optionsIterator?: ICellRange.IteratorOptions): T | void;
         /** @internal */
@@ -22525,7 +22530,7 @@ declare module "sheet/SheetRange" {
         /** {@inheritDoc ICellRange.select} */
         select(options?: ICellRange.SelectOptions): Promise<this>;
         /** {@inheritDoc ICellRange.find} */
-        find(findText: string, options?: ICellRange.FindOptions): Iterator<ICell>;
+        find(options: string | ICellRange.FindOptions): Iterator<ICell>;
         /** {@inheritDoc ICellRange.getFixed} */
         getFixed(options: ICellRange.GetFixedOptions): this;
         /** {@inheritDoc ICellRange.getSurrounding} */
@@ -22627,13 +22632,13 @@ declare module "sheet/SheetRange" {
         /** {@inheritDoc ICellRange.unmerge} */
         unmerge(options?: ITransaction.OperationOptions): this;
         /** {@inheritDoc ICellRange.insert} */
-        insert(orientation?: IRange.Orientation, options?: ITransaction.OperationOptions): this;
+        insert(options?: IRange.Orientation | ICellRange.InsertOptions): this;
         /** {@inheritDoc ICellRange.insertFrom} */
         insertFrom(source: ICellRange.Address | ICellRange.ISnapshot, options?: ICellRange.InsertFromOptions): Promise<this | null>;
         /** {@inheritDoc ICellRange.copyFrom} */
         copyFrom(source: ICellRange.Address | ICellRange.ISnapshot, options?: ICellRange.CopyOptions): Promise<this | null>;
         /** {@inheritDoc ICellRange.delete} */
-        delete(orientation?: IRange.Orientation, options?: ITransaction.OperationOptions): this;
+        delete(options?: IRange.Orientation | ICellRange.DeleteOptions): this;
         /** {@inheritDoc ICellRange.sort} */
         sort(options?: boolean | (ISort.RangeOptions & ITransaction.OperationOptions)): this;
         /** {@inheritDoc ICellRange.doBatch} */
@@ -22882,7 +22887,7 @@ declare module "workbook/Workbook" {
         /** @internal */
         protected _findOffsetForId(id: number, refs: SheetRef[]): number;
         /** {@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;
         /** @internal */
@@ -23408,7 +23413,7 @@ declare module "sheet/ISheet" {
          * @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}.
          *
@@ -23802,7 +23807,7 @@ declare module "sheet/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.
@@ -31595,7 +31600,7 @@ declare module "cellRange/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.
          *
@@ -31631,7 +31636,7 @@ declare module "cellRange/ICellRanges" {
         /**
          * {@inheritDoc ICellRange.merge}
          */
-        merge(options?: ICellRange.MergeOptions | IRange.Orientations): this;
+        merge(options?: IRange.Orientations | ICellRange.MergeOptions): this;
         /**
          * {@inheritDoc ICellRange.unmerge}
          */
@@ -31639,11 +31644,11 @@ declare module "cellRange/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}
          */
@@ -32438,6 +32443,7 @@ declare module "cellRange/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`.
@@ -32549,10 +32555,9 @@ declare module "cellRange/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.
          *
@@ -32570,28 +32575,28 @@ declare module "cellRange/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.
          *
@@ -32822,6 +32827,13 @@ declare module "cellRange/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.
          *
@@ -32877,6 +32889,28 @@ declare module "cellRange/ICellRange" {
          */
         interface GetRangeOptions {
         }
+        /**
+         * Options for `ICellRange.delete`.
+         */
+        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`.
+         */
+        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.
          */
@@ -33342,6 +33376,12 @@ declare module "cellRange/ICellRange" {
          * Options for {@link ICellRange.find}.
          */
         interface FindOptions extends FindCriteria {
+            /**
+             * The text to search for.
+             *
+             * @required
+             */
+            text: string;
             /**
              * Provides custom logic for matching values during the find operation.
              *
@@ -33483,6 +33523,15 @@ declare module "cellRange/ICellRange" {
          * Alias type for count results by type.
          */
         type Counts = Partial<Record<ICell.Content, number>>;
+        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.
          */
@@ -33496,6 +33545,17 @@ declare module "cellRange/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.