@sheetxl/sdk 0.7.5 → 0.7.7

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.
              *
@@ -3788,7 +3788,7 @@ declare module "text/TextBoxAlignment" {
 }
 declare module "text/ITextFrame" {
     import { TextAlign as CSSTextAlign } from 'csstype';
-    import { Dimensions, Bounds, Rectangle } from '@sheetxl/utils';
+    import type { Size, Bounds, Rectangle } from '@sheetxl/utils';
     import { TextVisitor } from "text/TextVisitor";
     import { ITextLine } from "text/TextLine";
     import { ITextParagraph } from "text/TextParagraph";
@@ -3830,7 +3830,7 @@ declare module "text/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
          */
@@ -4801,7 +4801,7 @@ declare module "text/richtext/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): CSSProperties;
+        toCSS(darkMode?: boolean, zoom?: number, ignoreNormal?: boolean): CSSProperties;
         /**
          * Serializes to a JSON object.
          */
@@ -7249,7 +7249,7 @@ declare module "numFmt/index" {
     }
 }
 declare module "style/IStyle" {
-    import { Dimensions, Rectangle } from '@sheetxl/utils';
+    import type { Size, Rectangle } from '@sheetxl/utils';
     import { IProperties } from "type/index";
     import { ITransaction } from "transaction/index";
     import { ICellRange } from "cellRange/index";
@@ -7381,7 +7381,7 @@ declare module "style/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.
@@ -8918,7 +8918,7 @@ declare module "table/ITableCollection" {
              *
              * @defaultValue false
              */
-            excludeHidden?: boolean;
+            ignoreHidden?: boolean;
             /**
              * Only return items that are completely contained with the filter bounds.
              *
@@ -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}
          */
@@ -15217,9 +15218,9 @@ declare module "workbook/IWorkbook" {
         /**
          * 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.
          */
@@ -16183,7 +16184,7 @@ declare module "sheet/_SheetMessages" {
     export const MODEL_CLOSED = "Sheet has been closed. No further operations are allowed.";
     export const ERROR_MODEL_DELETE = "Unable to delete.";
     export const ERROR_ITERATOR_CLOSED = "IteratorContext can only be used during visit.";
-    export const ERROR_ITERATOR_NO_CELL_CONTEXT = "IteratorContext can only return a cell if the forEach excludeCellDetails has not been set to false.";
+    export const ERROR_ITERATOR_NO_CELL_CONTEXT = "IteratorContext can only return a cell if the forEach ignoreCellDetails has not been set to false.";
     export const ERROR_INTERNAL_LISTENER_READ_ONLY = "To write the listener must be registered with the wrTable.IListener option.";
     export const ERROR_ADDRESS_INVALID_SCOPE = "When using addresses directly from the sheet do not include the sheet name.";
     export const ERROR_MAX_VALUES: (max: number) => string;
@@ -16584,7 +16585,7 @@ declare module "autoFill/IAutoFill" {
     }
 }
 declare module "text/TextFrame" {
-    import { Dimensions, Bounds, Rectangle } from '@sheetxl/utils';
+    import { type Size, type Bounds, type Rectangle } from '@sheetxl/utils';
     import { TextVisitor } from "text/TextVisitor";
     import { ITextLine } from "text/TextLine";
     import { ITextParagraph } from "text/TextParagraph";
@@ -16596,14 +16597,14 @@ declare module "text/TextFrame" {
         private _bounds;
         private _textBounds;
         private _lines;
-        private _lastLayoutDims;
+        private _lastLayoutSize;
         private _lastLayout;
         private _defaultFont;
         private _alignment;
         constructor(overrides: Partial<ITextFrame>, defaultFont: IStyledFont, alignment: ITextBoxAlignment, lines?: ITextLine[], bounds?: Bounds, textBounds?: Bounds);
         visitParas(visitor: TextVisitor): void;
         visitLines(visitor: TextVisitor): void;
-        layout(dims?: Partial<Dimensions>): ITextFrame;
+        layout(size?: Partial<Size>): ITextFrame;
         clone(visitor?: TextVisitor): ITextFrame;
         equals(other: ITextParagraph): boolean;
         /** {@inheritDoc ITextFrame.createTemporaryTextFrame} */
@@ -16707,7 +16708,7 @@ declare module "text/TextWrapper" {
     }
 }
 declare module "text/_TextUtils" {
-    import { Dimensions } from '@sheetxl/utils';
+    import { type Size } from '@sheetxl/utils';
     import { IFont } from "font/index";
     import { ITextFrame } from "text/ITextFrame";
     import { ITextBoxAlignment } from "text/TextBoxAlignment";
@@ -16720,7 +16721,7 @@ declare module "text/_TextUtils" {
      * @param dimensions
      * @param textMeasurer This defaults to a canvas context
      */
-    export const layoutTextFrame: (textFrame: ITextFrame, defaultFont: IStyledFont, alignment: ITextBoxAlignment, dimensions?: Partial<Dimensions>, textMeasurer?: IFont.Measurer) => ITextFrame;
+    export const layoutTextFrame: (textFrame: ITextFrame, defaultFont: IStyledFont, alignment: ITextBoxAlignment, dimensions?: Partial<Size>, textMeasurer?: IFont.Measurer) => ITextFrame;
     /**
      * Checks whether a string is entirely uppercase, lowercase, or mixed case.
      *
@@ -17055,7 +17056,7 @@ declare module "movable/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.
             */
@@ -17440,7 +17441,7 @@ declare module "movable/MovableCollection" {
     }
 }
 declare module "picture/IPicture" {
-    import type { Dimensions } from '@sheetxl/utils';
+    import type { Size } from '@sheetxl/utils';
     import type { IListener } from "listener/index";
     import type { IResource } from "resource/index";
     import type { IModel } from "model/index";
@@ -17486,7 +17487,7 @@ declare module "picture/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.
              */
@@ -18343,7 +18344,7 @@ declare module "conditional/IConditionalFormatCollection" {
              *
              * @defaultValue false
              */
-            excludeHidden?: boolean;
+            ignoreHidden?: boolean;
             /**
              * Only return items that are completely contained with the search bounds.
              *
@@ -18838,7 +18839,7 @@ declare module "table/TableCollection" {
         private _add;
         private _get;
         private _getByName;
-        constructor(add: (address: ICellRange.Address, options: ITableCollection.AddOptions) => ITable, get: (address: ICellRanges.Address, excludeHidden: boolean, fullyContained: boolean) => ITable[], getByName: (name: string) => ITable);
+        constructor(add: (address: ICellRange.Address, options: ITableCollection.AddOptions) => ITable, get: (address: ICellRanges.Address, ignoreHidden: boolean, fullyContained: boolean) => ITable[], getByName: (name: string) => ITable);
         /** {@inheritDoc ITableCollection.add} */
         add(address: ICellRange.Address, options?: ITableCollection.AddOptions): ITable;
         /** {@inheritDoc ITableCollection.getItems} */
@@ -19215,7 +19216,7 @@ declare module "conditional/ConditionalFormatCollection" {
     export class ConditionalFormatCollection implements IConditionalFormatCollection {
         private _add;
         private _get;
-        constructor(add: (address: ICellRange.Address, options: IConditionalFormatCollection.AddOptions) => IConditionalFormat, get: (address: ICellRanges.Address, excludeHidden: boolean, fullyContained: boolean) => IConditionalFormat[]);
+        constructor(add: (address: ICellRange.Address, options: IConditionalFormatCollection.AddOptions) => IConditionalFormat, get: (address: ICellRanges.Address, ignoreHidden: boolean, fullyContained: boolean) => IConditionalFormat[]);
         /** {@inheritDoc IConditionalFormatCollection.add} */
         add(address: ICellRange.Address, options?: IConditionalFormatCollection.AddOptions): IConditionalFormat;
         /** {@inheritDoc IConditionalFormatCollection.getItems} */
@@ -19378,7 +19379,7 @@ declare module "sheet/protection/index" {
     export * from "sheet/protection/ISheetProtection";
 }
 declare module "utils/GeomUtils" {
-    import { Point, Dimensions, Bounds } from '@sheetxl/utils';
+    import type { Point, Size, Bounds } from '@sheetxl/utils';
     /**
      * Return the union of to 2 bounds.
      * @remarks
@@ -19412,7 +19413,7 @@ declare module "utils/GeomUtils" {
      * 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.
      */
-    export const clipToOuterRect: (dimInner: Dimensions, dimOuter: Dimensions, rotation?: number) => Dimensions;
+    export const clipToOuterRect: (dimInner: Size, dimOuter: Size, rotation?: number) => Size;
     export const findIntersectMath: (p1: Point, p2: Point, min: number, max: number) => {
         min: number;
         max: number;
@@ -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;
@@ -20254,7 +20255,7 @@ declare module "fill/_BuiltInPatterns" {
 declare module "sheet/style/SheetCellStyle" {
     import { Properties as CSSProperties } from 'csstype';
     import { IRange } from '@sheetxl/primitives';
-    import { Dimensions, Rectangle, Bounds } from '@sheetxl/utils';
+    import { type Size, type Rectangle, type Bounds } from '@sheetxl/utils';
     import { IProperties } from "type/index";
     import { IColor } from "color/index";
     import { IFill } from "fill/index";
@@ -20420,7 +20421,7 @@ declare module "sheet/style/SheetCellStyle" {
     export class CellFont extends Inheritable<IStyledFont.Properties, IStyledFont.JSON> implements IStyledFont {
         isEqualMeasure(other: IStyledFont): boolean;
         /** {@inheritDoc IStyle.toCSS} */
-        toCSS(darkMode?: boolean, zoom?: number, excludeNormal?: boolean): CSSProperties;
+        toCSS(darkMode?: boolean, zoom?: number, ignoreNormal?: boolean): CSSProperties;
         /** {@inheritDoc IStyle.isSuperSub} */
         isSuperSub(): boolean;
         /** {@inheritDoc IStyle.isSuperSub} */
@@ -20572,7 +20573,7 @@ declare module "sheet/style/SheetCellStyle" {
     export class SheetCellStyle implements IStyle {
         protected _o: CreateCellStyleOptions;
         protected _p: InheritableProperties<IStyle.Properties, IStyle.JSON>;
-        protected _bestFit: Partial<Dimensions>;
+        protected _bestFit: Partial<Size>;
         protected _insets: Rectangle;
         protected _hasVisibleStyling: boolean;
         constructor(options: CreateCellStyleOptions);
@@ -20591,7 +20592,7 @@ declare module "sheet/style/SheetCellStyle" {
         /** {@inheritDoc IStyle.update} */
         update(update: IStyle.Update, options?: IStyle.UpdateOptions): IStyle;
         /** {@inheritDoc IStyle.getBestFit} */
-        getBestFit(): Partial<Dimensions> | null;
+        getBestFit(): Partial<Size> | null;
         /** {@inheritDoc IStyle.getInsets} */
         getInsets(): Rectangle;
         /** {@inheritDoc IStyle.getBorder} */
@@ -20915,7 +20916,7 @@ declare module "calculation/spatial/index" {
 }
 declare module "sheet/_SheetTypes" {
     import { ScalarType, Scalar, IRange } from '@sheetxl/primitives';
-    import type { Dimensions, Rectangle } from '@sheetxl/utils';
+    import type { Size, Rectangle } from '@sheetxl/utils';
     import { IProperties } from "type/index";
     import { NumberFormat } from "numFmt/index";
     import type { ITextFrame } from "text/index";
@@ -20967,7 +20968,7 @@ declare module "sheet/_SheetTypes" {
          * @cacheValue
          */
         i?: Readonly<Rectangle>;
-        o?: Readonly<Partial<Dimensions>> | null;
+        o?: Readonly<Partial<Size>> | null;
         w?: readonly string[] | null;
         B?: any;
         b?: any;
@@ -21051,7 +21052,7 @@ declare module "sheet/_SheetTypes" {
         interface IteratorOptions extends OverlappingRange.IteratorOptions {
             includeRangeTypes: boolean | SearchTypes;
             bounds?: IRange.Coords;
-            excludeHidden?: boolean | IRange.Orientation;
+            ignoreHidden?: boolean | IRange.Orientation;
             includeMergeOverflow?: boolean;
         }
         interface Entry {
@@ -21421,7 +21422,7 @@ declare module "numFmt/_FormatCell" {
 }
 declare module "sheet/SheetCell" {
     import { Scalar, ScalarType, IRange, FormulaError } from '@sheetxl/primitives';
-    import { Dimensions, Rectangle } from '@sheetxl/utils';
+    import { type Size, type Rectangle } from '@sheetxl/utils';
     import { IProperties, ITypes } from "type/index";
     import { NumberFormat } from "numFmt/index";
     import { ITextFrame } from "text/index";
@@ -21480,7 +21481,7 @@ declare module "sheet/SheetCell" {
     /** Guaranteed to never return null */
     export const csStyle: (specific: boolean, range: IRange.Coords, intersection: RangeState.Intersection, options: SheetCellOptions) => IStyle;
     export const csBestFit: (type: ScalarType, style: IStyle, value: Scalar, options: SheetCellOptions, colWidth: number, isMinContent: boolean, isRowOnly: boolean, // if true we only measure the height
-    customHash?: string, cache?: Cache<string, Readonly<Partial<Dimensions>>>) => Readonly<Partial<Dimensions>>;
+    customHash?: string, cache?: Cache<string, Readonly<Partial<Size>>>) => Readonly<Partial<Size>>;
     export interface SheetCellOptions {
         resolveRange: (address?: ICellRange.Address) => ICellRange | null;
         sheet: ISheet;
@@ -21540,7 +21541,7 @@ declare module "sheet/SheetCell" {
         /** {@inheritDoc ICell.isContentful} */
         isContentful(): boolean;
         /** {@inheritDoc ICell.getBestFit} */
-        getBestFit(colWidth?: number, minContent?: boolean): Readonly<Partial<Dimensions>> | null;
+        getBestFit(colWidth?: number, minContent?: boolean): Readonly<Partial<Size>> | null;
         /** {@inheritDoc ICell.getInsets} */
         getInsets(): Rectangle;
         /** {@inheritDoc ICell.getTextFrame} */
@@ -21565,7 +21566,7 @@ declare module "sheet/SheetCell" {
         /** {@inheritDoc ICell.toDate} */
         toDate(): Date | null;
         /** {@inheritDoc ICell.toText} */
-        toText(numFmt?: string): string;
+        toText(): string;
         /** {@inheritDoc ICell.toTextUnformatted} */
         toTextUnformatted(showFormula?: boolean): string;
         /** {@inheritDoc ICell.getComments} */
@@ -21577,7 +21578,7 @@ declare module "sheet/SheetCell" {
         /** {@inheritDoc ICell.getWarnings} */
         getWarnings(): readonly string[];
         /** {@inheritDoc ICell.getSpans} */
-        getSpans(): Readonly<Dimensions>;
+        getSpans(): Readonly<Size>;
         /** {@inheritDoc ICell.isTopLeft} */
         isTopLeft(): boolean;
         /** {@inheritDoc ICell.getSpill} */
@@ -21640,7 +21641,7 @@ declare module "sheet/SheetRanges" {
     import type { IStyle } from "style/index";
     import type { ISheet } from "sheet/index";
     export interface SheetRangesOptions {
-        excludeHidden?: boolean;
+        ignoreHidden?: boolean;
         readOnly?: string;
         getOptions: ICellRange.GetRangeOptions;
     }
@@ -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} */
@@ -21780,7 +21781,7 @@ declare module "calculation/graph/_CalcGraphUtils" {
 }
 declare module "sheet/Sheet" {
     import { Scalar, JSScalar, IRange } from '@sheetxl/primitives';
-    import { Dimensions, type Bounds, CoordUtils } from '@sheetxl/utils';
+    import { Size, type Bounds, CoordUtils } from '@sheetxl/utils';
     import { ITypes, ICollection, IProperties } from "type/index";
     import type { IWorkbook } from "workbook/index";
     import type { IListener } from "listener/index";
@@ -21899,7 +21900,7 @@ declare module "sheet/Sheet" {
         options: ICellRange.ListenerOptions;
     }
     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;
@@ -22025,7 +22026,7 @@ declare module "sheet/Sheet" {
         };
         protected _lastGetRangeRead: Record<string, {
             ranges: readonly IRange.Coords[];
-            excludeHidden: boolean | IRange.Orientation;
+            ignoreHidden: boolean | IRange.Orientation;
             results: any[];
         }>;
         protected _lastUsedCoordsRead: {
@@ -22068,7 +22069,7 @@ declare module "sheet/Sheet" {
         protected _closed: boolean;
         protected _defaultColWidthCache: number;
         protected _defaultRowHeightCache: number;
-        protected _defaultFontBoundsCache: Readonly<Dimensions>;
+        protected _defaultFontBoundsCache: Readonly<Size>;
         constructor(options?: ISheet.ConstructorOptions);
         /** @internal */
         protected _createRange(coords: Readonly<IRange.FixableCoords>, getOptions?: ICellRange.GetRangeOptions, readOnly?: string): ICellRange;
@@ -22189,7 +22190,7 @@ declare module "sheet/Sheet" {
         /** @internal */
         protected _unmerge(ranges: readonly IRange.Coords[], options?: ITransaction.OperationOptions): void;
         /** @internal */
-        protected _getMerges(ranges: readonly IRange.Coords[], excludeHidden?: boolean | IRange.Orientation): IRange.Coords[];
+        protected _getMerges(ranges: readonly IRange.Coords[], ignoreHidden?: boolean | IRange.Orientation): IRange.Coords[];
         /** @internal */
         protected _clone(): ISheet;
         /** @internal */
@@ -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.
@@ -22271,17 +22272,17 @@ declare module "sheet/Sheet" {
         /** @internal */
         protected _getUsedCoords(_options?: ICellRange.GetRangeOptions): IRange.Coords | null;
         /** @internal */
-        protected _isContentful(ranges: readonly IRange.Coords[], excludeHidden?: boolean | IRange.Orientation): boolean;
+        protected _isContentful(ranges: readonly IRange.Coords[], ignoreHidden?: boolean | IRange.Orientation): boolean;
         /** @internal */
-        protected _getCount(coords: IRange.Coords[], excludeHidden?: boolean): number;
+        protected _getCount(coords: IRange.Coords[], ignoreHidden?: boolean): number;
         /** @internal */
-        protected _contentCounts(ranges: readonly IRange.Coords[], types: ICell.Content[], excludeHidden: boolean | IRange.Orientation): ICellRange.Counts;
+        protected _contentCounts(ranges: readonly IRange.Coords[], types: ICell.Content[], ignoreHidden: boolean | IRange.Orientation): ICellRange.Counts;
         /** {@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 */
@@ -22289,11 +22290,11 @@ declare module "sheet/Sheet" {
         /** @internal */
         protected _extendRange(direction: IRange.Direction, coords: IRange.CellCoords): Readonly<IRange.Coords>;
         /** @internal */
-        protected _defaultFontDims(): Readonly<Dimensions>;
+        protected _defaultFontDims(): Readonly<Size>;
         /** {@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 _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>): Promise<IRange.Coords[]>;
+        protected _autoSelect(options?: boolean | ICellRange.SelectOptions, selection?: Partial<IRangeSelection.Coords>, orientation?: IRange.Orientation): Promise<IRange.Coords[]>;
         /** {@inheritDoc ISheet.getSelection} */
         getSelection(): IRangeSelection;
         /** {@inheritDoc ISheet.getView} */
@@ -22327,7 +22330,7 @@ declare module "sheet/Sheet" {
         /** {@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} */
@@ -22462,7 +22465,7 @@ declare module "sheet/SheetRange" {
     import type { ISheet } from "sheet/ISheet";
     import { Sheet } from "sheet/Sheet";
     export interface SheetRangeOptions {
-        excludeHidden?: boolean;
+        ignoreHidden?: boolean;
         readOnly?: string;
         getOptions: ICellRange.GetRangeOptions;
     }
@@ -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 */
@@ -22510,6 +22515,8 @@ declare module "sheet/SheetRange" {
         protected _setValueOrValues(value: ICellRange.ValuesUpdate, options?: ICellRange.SetValuesOptions): this;
         /** {@inheritDoc ICellRange.getValues} */
         getValues(options?: ICellRange.GetValuesOptions): Scalar[][];
+        /** {@inheritDoc ICellRange.toText} */
+        toText(options?: ICellRange.ToTextOptions): string;
         /** {@inheritDoc ICellRange.getValues} */
         getValue(options?: ICellRange.GetValuesOptions): Scalar | JSScalar;
         /** {@inheritDoc ICellRange.calculate} */
@@ -22523,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} */
@@ -22625,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} */
@@ -22880,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 */
@@ -22948,7 +22955,7 @@ declare module "workbook/Workbook" {
         /** @internal */
         protected _createScripts(json?: Record<string, IModule.JSON>): IScript;
         /** {@inheritDoc IWorkbook.toJSON} */
-        toJSON(excludeData?: boolean): Promise<IWorkbook.JSON>;
+        toJSON(ignoreData?: boolean): Promise<IWorkbook.JSON>;
         /** {@inheritDoc IWorkbook.isClosed} */
         isClosed(): boolean;
         /** {@inheritDoc IWorkbook.close} */
@@ -23406,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}.
          *
@@ -23610,9 +23617,9 @@ declare module "sheet/ISheet" {
         /**
          * 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.
          *
@@ -23800,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.
@@ -24350,8 +24357,17 @@ declare module "sheet/_SheetUtils" {
      * @internal
      */
     export const mergeRangeStateIntersections: (ranges: readonly ITypes.RangeCoordValue<RangeState.Intersection>[]) => RangeState.Intersection;
-    /** @internal */
+    /**
+     * @internal
+     * * TODO - Use a lower level iterator to avoid cell context?
+     */
     export const cellStateIteratorTo2DArray: (iteratorCallback: (options?: CellState.IteratorOptions) => Iterator<ICellRange.Entry, ICellRange.Entry, IRange.CellCoords>, bounds: IRange.Coords, asCells: boolean, options: ICellRange.GetValuesOptions) => (ICell | JSScalar)[][];
+    /**
+     * @internal
+     * TODO - rationalize this with cellStateIteratorTo2DArray?
+     * TODO - Use a lower level iterator to avoid cell context?
+     */
+    export const cellStateIteratorToString: (iteratorCallback: (options?: CellState.IteratorOptions) => Iterator<ICellRange.Entry, ICellRange.Entry, IRange.CellCoords>, bounds: IRange.Coords, options: ICellRange.ToTextOptions) => string;
     export const isEqualSheetRanges: (a?: IRange.FixableCoords, b?: IRange.FixableCoords) => boolean;
     /**
      * Check if two ranges arrays are equal
@@ -29795,7 +29811,7 @@ declare module "cell/ICellProtection" {
 }
 declare module "cell/ICell" {
     import type { Scalar, JSScalarUpdate, ScalarType, IRange } from '@sheetxl/primitives';
-    import type { Dimensions, Rectangle, Bounds } from '@sheetxl/utils';
+    import type { Size, Rectangle, Bounds } from '@sheetxl/utils';
     import type { ITypes } from "type/index";
     import type { ITextFrame } from "text/index";
     import type { NumberFormat } from "numFmt/index";
@@ -29886,12 +29902,10 @@ declare module "cell/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.
          *
@@ -29938,7 +29952,7 @@ declare module "cell/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.
          */
@@ -29953,7 +29967,7 @@ declare module "cell/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.
          */
@@ -31459,7 +31473,7 @@ declare module "sort/ISort" {
         interface DefaultSortCriteria {
             /**
              * The cords that will be sorted.
-             * This may exclude the header.
+             * This may ignore the header.
              */
             coords: IRange.Coords;
             /**
@@ -31586,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.
          *
@@ -31622,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}
          */
@@ -31630,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}
          */
@@ -32003,7 +32017,7 @@ declare module "cellRange/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.
@@ -32199,7 +32213,7 @@ declare module "cellRange/ICellRange" {
          * Returns the value for the top left `Scalar`.
          *
          * @remarks
-         * The `excludeHidden` option is ignored.
+         * The `ignoreHidden` option is ignored.
          *
          * @see
          * {@link ICellRange.getValues}
@@ -32409,6 +32423,10 @@ declare module "cellRange/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.
          *
@@ -32425,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`.
@@ -32536,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.
          *
@@ -32557,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.
          *
@@ -32809,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.
          *
@@ -32864,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.
          */
@@ -33068,10 +33115,16 @@ declare module "cellRange/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}.
+         */
+        interface ToTextOptions extends ICellRange.GetValuesOptions {
+            ignoreFormatting?: boolean;
+        }
         /**
          * Options for {@link ICellRange.autoFit}.
          */
@@ -33323,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.
              *
@@ -33464,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.
          */
@@ -33477,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.
@@ -33510,7 +33589,7 @@ declare module "cellRange/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.
              *
@@ -33519,7 +33598,7 @@ declare module "cellRange/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.
              *