@sheetxl/sdk 0.7.4 → 0.7.6

package/types/scripting.d.ts

@@ -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.
              *
@@ -15217,9 +15217,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 +16183,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 +16584,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 +16596,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 +16707,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 +16720,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 +17055,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 +17440,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 +17486,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 +18343,7 @@ declare module "conditional/IConditionalFormatCollection" {
              *
              * @defaultValue false
              */
-            excludeHidden?: boolean;
+            ignoreHidden?: boolean;
             /**
              * Only return items that are completely contained with the search bounds.
              *
@@ -18838,7 +18838,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 +19215,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 +19378,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 +19412,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;
@@ -20254,7 +20254,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 +20420,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 +20572,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 +20591,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 +20915,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 +20967,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 +21051,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 +21421,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 +21480,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 +21540,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 +21565,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 +21577,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 +21640,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;
     }
@@ -21780,7 +21780,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 +21899,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 +22025,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 +22068,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 +22189,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 */
@@ -22271,11 +22271,11 @@ 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} */
@@ -22289,7 +22289,7 @@ 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;
         /**
@@ -22327,7 +22327,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 +22462,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;
     }
@@ -22510,6 +22510,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} */
@@ -22948,7 +22950,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} */
@@ -23610,9 +23612,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.
          *
@@ -24350,8 +24352,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 +29806,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 +29897,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 +29947,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 +29962,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 +31468,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;
             /**
@@ -32003,7 +32012,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 +32208,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 +32418,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.
          *
@@ -33068,10 +33081,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}.
          */
@@ -33510,7 +33529,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 +33538,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.
              *