@sheetxl/sdk 0.7.19 → 0.7.21

package/types/scripting.d.ts

@@ -8893,12 +8893,14 @@ declare module "table/ITableCollection" {
         interface AddOptions extends ITransaction.OperationOptions {
             /**
              * If not specified then the header status will be determined from the range data.
+             *
              * @defaultValue 'based on initial data set'
              */
             hasHeader?: boolean;
             /**
              * The default style to use. If null than it will not be set
              * If undefined or not provided it will use the.
+             *
              * @defaultValue uses the default table style
              */
             styleName?: string;
@@ -10133,12 +10135,12 @@ declare module "calculation/ICalculation" {
         /** @inheritdoc IFormulaContext.getRuntime */
         getRuntime(): IRuntime;
         /**
-         * Waits for the calculation to finish.
+         * Calculates all items or waits for current calculations to finished
          *
          * @remarks
          * This is useful when needing to ensure that the values in the calculation cycle are up-to-date.
          */
-        waitForFinish(): Promise<void>;
+        calculate(options?: ICalculation.CalculateOptions): Promise<void>;
         /**
          * Add Listeners.
          *
@@ -10155,6 +10157,15 @@ declare module "calculation/ICalculation" {
      * {@link ICalculation}
      */
     export namespace ICalculation {
+        /**
+         * Options for when calculating.
+         */
+        interface CalculateOptions {
+            /**
+             * If true a full calc will be done not just invalid values
+             */
+            full?: boolean;
+        }
         /**
          * Represents a formula that can be evaluated.
          */
@@ -14446,175 +14457,6 @@ declare module "primitives/Range" {
         get isIRange(): true;
     }
 }
-declare module "selection/IRangeSelection" {
-    import type { IRange } from '@sheetxl/primitives';
-    import type { SelectionCoords as WellKnownSelectionCoords } from '@sheetxl/utils';
-    import type { IListener } from "listener/index";
-    import type { ISheet } from "sheet/index";
-    /**
-     * Interface representing a range selection within a sheet.
-     */
-    export interface IRangeSelection {
-        /**
-         * Navigates the entire sheet
-         *
-         * @param direction The direction to navigate.
-         * @param select Whether to select the cell after navigating.
-         * @param contentful Whether to navigate to contentful cells only.
-         * @param incrementAmount The amount to increment.
-         * @returns The current instance.
-         */
-        navigate(direction: IRange.Direction, select?: boolean, contentful?: boolean, incrementAmount?: number): this;
-        /**
-         * Checks if the entire range is selected.
-         * @returns True if the entire range is selected, otherwise false.
-         */
-        isEntire(): boolean;
-        /**
-         * Returns the coordinates of the selection.
-         * @returns The selection coordinates.
-         */
-        getCoords(): IRangeSelection.Coords;
-        /**
-         * Returns the selection as an array of IRange.Coords.
-         *
-         * @param coords Optional coordinates to convert. If not provided, uses the current selection.
-         *
-         * @remarks
-         * The first element is always the active range.
-         */
-        getRangesCoords(coords?: Partial<IRangeSelection.Coords>): IRange.Coords[];
-        /**
-         * Updates the selection coordinates.
-         *
-         * @param coords The new coordinates.
-         * @returns The current instance.
-         */
-        updateCoords(coords: IRangeSelection.Coords): this;
-        /**
-         * Traverses the selection, moving to the next cell based on the orientation.
-         *
-         * @param orientation The orientation to traverse. Default is `ICellRange.Orientation.Row`.
-         * @param reverse Whether to traverse in reverse. Default is false.
-         * @returns The current instance.
-         * @remarks Useful for pressing tab or enter from the UI.
-         */
-        traverse(orientation?: IRange.Orientation, reverse?: boolean): this;
-        /**
-         * Updates the selection using a new start and end.
-         *
-         * @param start The start cell.
-         * @param end The end cell. Default is the start cell.
-         * @param anchor The anchor cell.
-         */
-        clearAndModify(start: Partial<IRange.CellCoords>, end?: Partial<IRange.CellCoords>, anchor?: Partial<IRange.CellCoords>): void;
-        /**
-         * Modifies the selection around the anchor.
-         *
-         * @param cellAnchor The anchor cell.
-         * @param cellPivot The pivot cell.
-         * @param resetAnchor Whether to reset the anchor. Default is false.
-         */
-        modify(cellAnchor: Partial<IRange.CellCoords>, cellPivot?: Partial<IRange.CellCoords>, resetAnchor?: boolean): void;
-        /**
-         * Clears the range selections.
-         *
-         * @remarks This does not affect the cell.
-         */
-        clear(): void;
-        /**
-         * Appends a selection to the current selection.
-         *
-         * @param start The start cell.
-         * @param end The end cell. Default is the start cell.
-         * @param anchor The anchor cell.
-         * @remarks This is used to support the CMD key behavior in the UI.
-         */
-        append(start: IRange.CellCoords, end?: IRange.CellCoords, anchor?: Partial<IRange.CellCoords>): void;
-        /**
-         * A special range used during drag.
-         * @param range The range or null.
-         *
-         * @remarks
-         * This fires an event.
-         */
-        setAdjusting(range: IRangeSelection.Coords | null): void;
-        /**
-         * Returns the adjusting range.
-         */
-        getAdjusting(): IRangeSelection.Coords | null;
-        /**
-         * Adds listeners to the selection.
-         * @param listeners The listeners to add.
-         * @param options Options for the listeners.
-         * @returns A function to remove the listeners.
-         */
-        addListeners(listeners: IRangeSelection.IListeners, options?: IListener.Options): IListener.Remove;
-    }
-    /**
-     * {@inheritDoc IRangeSelection}
-     * @see
-     * ### **Interface**
-     *
-     * {@link IRangeSelection}
-     */
-    export namespace IRangeSelection {
-        /**
-       * Represents a selection of ranges with an active range and an active cell.
-       */
-        type Coords = WellKnownSelectionCoords;
-        /**
-         * Type representing different selection policies.
-         */
-        type SelectionPolicy = 'single' | 'range' | 'multiple';
-        /**
-         * Type representing different new selection modes.
-         */
-        type NewSelectionMode = 'clear' | 'modify' | 'append';
-        /**
-         * Events for {@link IRangeSelection}.
-         */
-        interface Events {
-            /**
-             * Called when the selection changes.
-             *
-             * @param source The source of the event.
-             */
-            onChange?(source: IRangeSelection): void;
-            /**
-             * Called when the selection is adjusting.
-             *
-             * @param source The source of the event.
-             */
-            onAdjustingChange?(source: IRangeSelection): void;
-        }
-        /**
-         * Listeners for IRangeSelection events.
-         */
-        interface IListeners extends IListener.Callbacks<IRangeSelection, Events> {
-        }
-        /**
-         * Options for constructing an IRangeSelection.
-         */
-        interface ConstructorOptions {
-            /**
-             * The sheet to which the selection belongs.
-             */
-            sheet: ISheet;
-            /**
-             * Selection policy.
-             */
-            selectionPolicy?: IRangeSelection.SelectionPolicy;
-            /**
-             * New selection mode.
-             */
-            newSelectionMode?: IRangeSelection.NewSelectionMode;
-        }
-    }
-}
-declare module "selection/index" {
-    export * from "selection/IRangeSelection";
-}
 declare module "protection/IProtection" {
     import type { IListener } from "listener/index";
     /**
@@ -15204,6 +15046,17 @@ declare module "workbook/IWorkbook" {
          * * Does not fire a theme updated event.
          */
         setTheme(theme: ITheme | null): ITheme;
+        /**
+         * Returns the display name for the workbook.
+         *
+         * @remarks
+         * This may be null
+         */
+        getName(): string | null;
+        /**
+         * Set the name for the workbook.
+         */
+        setName(name: string | null): IWorkbook;
         /**
          * Is date resolution 1904 instead of 1900 based.
          *
@@ -15365,6 +15218,10 @@ declare module "workbook/IWorkbook" {
              * @param source {@link IWorkbook}
              */
             onViewChange?(source: IWorkbook): void;
+            /**
+             * Called when the name changes.
+             */
+            onNameChange?(source: IWorkbook): void;
             /**
              * Called when the scripts associated with the workbook have change.
              */
@@ -15469,6 +15326,21 @@ declare module "workbook/IWorkbook" {
              * @defaultValue `Sheet${index+1}`
              */
             createSheetNameCallback?: (index: number) => string;
+            /**
+             * The initial name for the workbook.
+             */
+            name?: string | null;
+            /**
+             * Returns a valid name for the workbook.
+             *
+             * @param name The name to validate.
+             * @returns The valid name. This may be different from the name provided.
+             * @throws Error if the name is not valid.
+             *
+             * @remarks
+             * This is not called if the name is null or for the initialName if provided.
+             */
+            validateWorkbookName?: (name: string) => string | null | void;
             /**
              * A theme for the workbook.
              */
@@ -16358,6 +16230,228 @@ declare module "workbook/_WorkbookUtils" {
      */
     export const findValidSheetName: (str: string, validate: (validating: string) => string) => string;
 }
+declare module "selection/IRangeSelection" {
+    import type { IRange } from '@sheetxl/primitives';
+    import type { SelectionCoords as WellKnownSelectionCoords } from '@sheetxl/utils';
+    import type { IListener } from "listener/index";
+    import type { ISheet } from "sheet/index";
+    /**
+     * Interface representing a range selection within a sheet.
+     */
+    export interface IRangeSelection {
+        /**
+         * Navigates the entire sheet
+         *
+         * @param direction The direction to navigate.
+         * @param select Whether to select the cell after navigating.
+         * @param contentful Whether to navigate to contentful cells only.
+         * @param incrementAmount The amount to increment.
+         * @returns The current instance.
+         */
+        navigate(direction: IRange.Direction, select?: boolean, contentful?: boolean, incrementAmount?: number): this;
+        /**
+         * Checks if the entire range is selected.
+         * @returns True if the entire range is selected, otherwise false.
+         */
+        isEntire(): boolean;
+        /**
+         * Returns the coordinates of the selection.
+         * @returns The selection coordinates.
+         */
+        getCoords(): IRangeSelection.Coords;
+        /**
+         * Returns the selection as an array of IRange.Coords.
+         *
+         * @param coords Optional coordinates to convert. If not provided, uses the current selection.
+         *
+         * @remarks
+         * The first element is always the active range.
+         */
+        getRangesCoords(coords?: Partial<IRangeSelection.Coords>): IRange.Coords[];
+        /**
+         * Updates the selection coordinates.
+         *
+         * @param coords The new coordinates.
+         * @returns The current instance.
+         */
+        updateCoords(coords: IRangeSelection.Coords): this;
+        /**
+         * Traverses the selection, moving to the next cell based on the orientation.
+         *
+         * @param orientation The orientation to traverse. Default is `ICellRange.Orientation.Row`.
+         * @param reverse Whether to traverse in reverse. Default is false.
+         * @returns The current instance.
+         * @remarks Useful for pressing tab or enter from the UI.
+         */
+        traverse(orientation?: IRange.Orientation, reverse?: boolean): this;
+        /**
+         * Updates the selection using a new start and end.
+         *
+         * @param start The start cell.
+         * @param end The end cell. Default is the start cell.
+         * @param anchor The anchor cell.
+         */
+        clearAndModify(start: Partial<IRange.CellCoords>, end?: Partial<IRange.CellCoords>, anchor?: Partial<IRange.CellCoords>): void;
+        /**
+         * Modifies the selection around the anchor.
+         *
+         * @param cellAnchor The anchor cell.
+         * @param cellPivot The pivot cell.
+         * @param resetAnchor Whether to reset the anchor. Default is false.
+         */
+        modify(cellAnchor: Partial<IRange.CellCoords>, cellPivot?: Partial<IRange.CellCoords>, resetAnchor?: boolean): void;
+        /**
+         * Clears the range selections.
+         *
+         * @remarks This does not affect the cell.
+         */
+        clear(): void;
+        /**
+         * Appends a selection to the current selection.
+         *
+         * @param start The start cell.
+         * @param end The end cell. Default is the start cell.
+         * @param anchor The anchor cell.
+         * @remarks This is used to support the CMD key behavior in the UI.
+         */
+        append(start: IRange.CellCoords, end?: IRange.CellCoords, anchor?: Partial<IRange.CellCoords>): void;
+        /**
+         * A special range used during drag.
+         * @param range The range or null.
+         *
+         * @remarks
+         * This fires an event.
+         */
+        setAdjusting(range: IRangeSelection.Coords | null): void;
+        /**
+         * Returns the adjusting range.
+         */
+        getAdjusting(): IRangeSelection.Coords | null;
+        /**
+         * Adds listeners to the selection.
+         * @param listeners The listeners to add.
+         * @param options Options for the listeners.
+         * @returns A function to remove the listeners.
+         */
+        addListeners(listeners: IRangeSelection.IListeners, options?: IListener.Options): IListener.Remove;
+    }
+    /**
+     * {@inheritDoc IRangeSelection}
+     * @see
+     * ### **Interface**
+     *
+     * {@link IRangeSelection}
+     */
+    export namespace IRangeSelection {
+        /**
+       * Represents a selection of ranges with an active range and an active cell.
+       */
+        type Coords = WellKnownSelectionCoords;
+        /**
+         * Type representing different selection policies.
+         */
+        type SelectionPolicy = 'single' | 'range' | 'multiple';
+        /**
+         * Type representing different new selection modes.
+         */
+        type NewSelectionMode = 'clear' | 'modify' | 'append';
+        /**
+         * Events for {@link IRangeSelection}.
+         */
+        interface Events {
+            /**
+             * Called when the selection changes.
+             *
+             * @param source The source of the event.
+             */
+            onChange?(source: IRangeSelection): void;
+            /**
+             * Called when the selection is adjusting.
+             *
+             * @param source The source of the event.
+             */
+            onAdjustingChange?(source: IRangeSelection): void;
+        }
+        /**
+         * Listeners for IRangeSelection events.
+         */
+        interface IListeners extends IListener.Callbacks<IRangeSelection, Events> {
+        }
+        /**
+         * Options for constructing an IRangeSelection.
+         */
+        interface ConstructorOptions {
+            /**
+             * The sheet to which the selection belongs.
+             */
+            sheet: ISheet;
+            /**
+             * Selection policy.
+             */
+            selectionPolicy?: IRangeSelection.SelectionPolicy;
+            /**
+             * New selection mode.
+             */
+            newSelectionMode?: IRangeSelection.NewSelectionMode;
+        }
+    }
+}
+declare module "selection/_RangeSelectionUtils" {
+    import { IRange } from '@sheetxl/primitives';
+    import { IRangeSelection } from "selection/IRangeSelection";
+    /**
+     * Scans until finds a visible (non hidden) header.
+     *
+     * @param hiddenAt Callback
+     * @param index The index to start from
+     * @param direction The direction to scan
+     */
+    export const traverseHiddenHeaders: (hiddenAt: HiddenHeadersAt | undefined, index: number, direction: IRange.Direction) => number;
+    export const getVisibleHeaders: (hiddenAt: HiddenHeadersAt | undefined, startIndex: number, stopIndex: number) => number[];
+    export const EmptyCell: IRange.CellCoords;
+    export const EmptyRanges: IRange.Coords[];
+    /**
+     * Frozen IRangeSelection.Coords for easy comparisons.
+     */
+    export const EmptySelection: IRangeSelection.Coords;
+    export const mergeSelection: (selection: IRangeSelection.Coords, activeSelection: IRangeSelection.Coords, maxRangeCoords: IRange.Coords) => IRangeSelection.Coords;
+    /**
+     * Cycles active cell within selection range. This has slightly different semantics than regular traversal
+     * * wraps
+     * * visits each cell once (skipping merged cells after first step)
+     * * jumps to next range if multiple ranges are selected
+     *
+     * @param selection
+     * @param direction
+     */
+    export const findNextCellWithinSelection: (selection: IRangeSelection.Coords, direction: IRange.Direction, getCellCoordsAsRangeCoords: (coords: IRange.CellCoords) => IRange.Coords, hiddenRowsAt?: HiddenHeadersAt, hiddenColumnsAt?: HiddenHeadersAt, originalSelection?: IRangeSelection.Coords) => IRangeSelection.Coords | null;
+    export interface HiddenHeadersAt {
+        /**
+         * A called back to traverse hidden headers
+         */
+        (index: number, reverse?: boolean): number;
+    }
+    export interface IsContentfulCell {
+        (coords: IRange.CellCoords): boolean;
+    }
+    export type CellFinder = (activeCoords: IRange.CellCoords, isContentfulCell: IsContentfulCell | undefined, hiddenAt: HiddenHeadersAt | undefined, direction: IRange.Direction, first: boolean, limit: number) => number;
+    /**
+     * Returns the cells as an ordered list of ranges.  The first range is the active range.
+     * If there are no ranges then the active coord will be returns as a range.
+     *
+     * @remarks
+     * * Always return at least 1 range unless the selection is null.
+     */
+    export const selectionToRangesCoords: (selection: Partial<IRangeSelection.Coords>) => IRange.Coords[];
+    /**
+     * Creates a IRangeSelection.Coords from an array of ranges.
+     *
+     * @param ranges The ranges to include in the selection.
+     * @param cell If provided will try to fit within the cell
+     * @param rangeIndex *default* `ranges.length 1 unless this is a single cell then -1`.
+     */
+    export const rangesToSelectionCoords: (ranges: readonly IRange.Coords[], cell?: IRange.CellCoords, rangeIndex?: number) => IRangeSelection.Coords;
+}
 declare module "lib/utils/_Utils" {
     export const getBuildVersion: () => string;
     export const getBuildDate: () => string;
@@ -16451,6 +16545,7 @@ declare module "license/LicenseManager" {
         private _validate;
         private _printBanner;
         private _printDetails;
+        private _doPrint;
         private _print;
         getDetails(): Promise<LicenseDetails>;
         /**
@@ -18327,6 +18422,9 @@ declare module "movable/CustomElement" {
         }
     }
 }
+declare module "selection/index" {
+    export * from "selection/IRangeSelection";
+}
 declare module "conditional/IConditionalFormatCollection" {
     import type { ICellRange, ICellRanges } from "cellRange/index";
     import type { ICollection } from "type/index";
@@ -18973,53 +19071,6 @@ declare module "address/index" {
         const resolveRelativeToA1: (tokens: (string | IRange.CellCoords)[], rowIndex: number, colIndex: number) => string;
     }
 }
-declare module "selection/_RangeSelectionUtils" {
-    import { IRange } from '@sheetxl/primitives';
-    import { IRangeSelection } from "selection/IRangeSelection";
-    /**
-     * Scans until finds a visible (non hidden) header.
-     *
-     * @param hiddenAt Callback
-     * @param index The index to start from
-     * @param direction The direction to scan
-     */
-    export const traverseHiddenHeaders: (hiddenAt: HiddenHeadersAt | undefined, index: number, direction: IRange.Direction) => number;
-    export const getVisibleHeaders: (hiddenAt: HiddenHeadersAt | undefined, startIndex: number, stopIndex: number) => number[];
-    export const EmptyCell: IRange.CellCoords;
-    export const EmptyRanges: IRange.Coords[];
-    /**
-     * Frozen IRangeSelection.Coords for easy comparisons.
-     */
-    export const EmptySelection: IRangeSelection.Coords;
-    export const mergeSelection: (selection: IRangeSelection.Coords, activeSelection: IRangeSelection.Coords, maxRangeCoords: IRange.Coords) => IRangeSelection.Coords;
-    /**
-     * Cycles active cell within selection range. This has slightly different semantics than regular traversal
-     * * wraps
-     * * visits each cell once (skipping merged cells after first step)
-     * * jumps to next range if multiple ranges are selected
-     *
-     * @param selection
-     * @param direction
-     */
-    export const findNextCellWithinSelection: (selection: IRangeSelection.Coords, direction: IRange.Direction, getCellCoordsAsRangeCoords: (coords: IRange.CellCoords) => IRange.Coords, hiddenRowsAt?: HiddenHeadersAt, hiddenColumnsAt?: HiddenHeadersAt, originalSelection?: IRangeSelection.Coords) => IRangeSelection.Coords | null;
-    export interface HiddenHeadersAt {
-        /**
-         * A called back to traverse hidden headers
-         */
-        (index: number, reverse?: boolean): number;
-    }
-    export interface IsContentfulCell {
-        (coords: IRange.CellCoords): boolean;
-    }
-    export type CellFinder = (activeCoords: IRange.CellCoords, isContentfulCell: IsContentfulCell | undefined, hiddenAt: HiddenHeadersAt | undefined, direction: IRange.Direction, first: boolean, limit: number) => number;
-    /**
-     * Returns the cells as an ordered list of ranges.  The first range is the active range.
-     * If there are no ranges then the active coord will be returns as a range.
-     * @remarks
-     * * Always return at least 1 range unless the selection is null.
-     */
-    export const selectionToRanges: (selection: Partial<IRangeSelection.Coords>) => IRange.Coords[];
-}
 declare module "selection/RangeSelection" {
     import { IRange } from '@sheetxl/primitives';
     import { IListener } from "listener/index";
@@ -21980,7 +22031,7 @@ declare module "calculation/graph/_CalcGraphUtils" {
 }
 declare module "sheet/Sheet" {
     import { Scalar, JSScalar, IRange } from '@sheetxl/primitives';
-    import { Size, type Bounds, CoordUtils } from '@sheetxl/utils';
+    import { type 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";
@@ -22374,9 +22425,7 @@ declare module "sheet/Sheet" {
         /** @internal */
         protected _realizeCalcedValues(results: ICalcGraph.Results): void;
         /** @internal */
-        protected _calculate(ranges: ICellRanges.Coords, options?: ICalcGraph.CalculateOptions): void;
-        /** @internal */
-        protected _waitForCalcs(): Promise<void>;
+        protected _calculate(ranges: ICellRanges.Coords, options?: ICalculation.CalculateOptions): void;
         /** @internal */
         protected _calculateFull(): void;
         /** @internal */
@@ -22481,6 +22530,8 @@ declare module "sheet/Sheet" {
         /** {@inheritDoc ISheet.find} */
         find(options?: string | ICellRange.FindOptions): Iterator<ICell>;
         /** @internal */
+        protected _setMaxSize(size: Partial<Size> | null, options?: ITransaction.OperationOptions): this;
+        /** @internal */
         protected _find(ranges: readonly IRange.Coords[], options: string | ICellRange.FindOptions): Iterator<ICell>;
         /** {@inheritDoc ISheet.isDate1904} */
         isDate1904(): boolean;
@@ -22720,8 +22771,6 @@ declare module "sheet/SheetRange" {
         getValue(options?: ICellRange.GetValuesOptions): Scalar | JSScalar;
         /** {@inheritDoc ICellRange.calculate} */
         calculate(full: boolean): this;
-        /** {@inheritDoc ICellRange.waitForCalcs} */
-        waitForCalcs(): Promise<this>;
         /** {@inheritDoc ICellRange.getCells} */
         getCells(options?: ICellRange.GetValuesOptions): ICell[][];
         /** {@inheritDoc ICellRange.getCell} */
@@ -22959,6 +23008,7 @@ declare module "workbook/Workbook" {
         lastId: number;
         sheetsCreated: Set<ISheet>;
         listenersSheets: Map<number, IListener.Remove>;
+        name: string | null;
     }
     interface InternalCreateSheet {
         (
@@ -23023,6 +23073,10 @@ declare module "workbook/Workbook" {
         protected _isDate1904: boolean;
         constructor(options?: IWorkbook.ConstructorOptions);
         protected _initState(): void;
+        /** {@inheritDoc IWorkbook.getName} */
+        getName(): string | null;
+        /** {@inheritDoc IWorkbook.setName} */
+        setName(name: string | null): IWorkbook;
         /** {@inheritDoc IWorkbook.getView} */
         getView(): IWorkbookView;
         /** {@inheritDoc IWorkbook.setView} */
@@ -23780,7 +23834,7 @@ declare module "sheet/ISheet" {
          * Returns the {@link IWorkbook} for the sheet.
          *
          * @remarks
-         * This may be null if not created via a workbook
+         * This may be `null` if not created via a workbook.
          */
         getWorkbook(): IWorkbook | null;
         /**
@@ -24479,7 +24533,6 @@ declare module "sheet/_SheetUtils" {
     import { ITypes } from "type/index";
     import type { IStringCollection } from "string/index";
     import { ISort } from "sort/index";
-    import type { IRangeSelection } from "selection/index";
     import { type IStyle } from "style/index";
     import type { ICell, ICellHeader } from "cell/index";
     import type { ICellRange } from "cellRange/index";
@@ -24637,22 +24690,6 @@ declare module "sheet/_SheetUtils" {
      * Expands ranges to include merges.
      */
     export const expandToIncludeMerges: (ranges: readonly IRange.Coords[], mergeSpatial: ISpatialMap<MergeEntry>, entireCoords: IRange.Coords) => IRange.Coords[];
-    /**
-     * Creates a IRangeSelection.Coords from an array of ranges.
-     *
-     * @param ranges
-     * @param cell if provided will try to fit within the cell
-     * @param rangeIndex *default* `ranges.length 1 unless this is a single cell then -1`.
-     */
-    export const toRangeSelectionCoords: (ranges: readonly IRange.Coords[], cell?: IRange.CellCoords, rangeIndex?: number) => IRangeSelection.Coords;
-    /**
-     * Creates a IRangeSelection.Coords from an array of ranges.
-     *
-     * @param ranges
-     * @param rangeIndex @defaultValue ranges.length 1 unless this is a single cell then -1
-     * @deprecated use toRangeSelectionCoords
-     */
-    export const rangesToSelection: (ranges: readonly IRange.Coords[], rangeIndex?: number) => IRangeSelection.Coords;
     export type OrientedStyled = {
         orientations: IRange.Orientations;
         index: number;
@@ -25220,7 +25257,7 @@ declare module "calculation/graph/ICalcGraph" {
          * @remarks
          * For async functions this will return before they are completed.
          */
-        calculate(options?: ICalcGraph.CalculateOptions | boolean): Promise<ICalcGraph.Results>;
+        calculate(options?: ICalculation.CalculateOptions | boolean): Promise<ICalcGraph.Results>;
         /**
          * The the value at a specific cell to a formula.
          *
@@ -25561,23 +25598,6 @@ declare module "calculation/graph/ICalcGraph" {
              */
             isEquals(other: ICalcGraph.IFormulaBlock): boolean;
         }
-        /**
-         * Options for when calculating.
-         */
-        interface CalculateOptions {
-            /**
-             * If true a full calc will be done not just invalid values
-             */
-            full?: boolean;
-            /**
-             * If true the the promise will not result until all pending calculations are complete.
-             *
-             * @remarks
-             * * Useful when wanting all results for a calculation such as a rest API call.
-             * * Streaming functions will return the first value and immediately unsubscribe.
-             */
-            waitForPending?: boolean;
-        }
         /**
          * Options for shifting the calc graph.
          */
@@ -25792,6 +25812,7 @@ declare module "calculation/graph/CalcGraph" {
             graph: CalcGraph;
         };
         _iterationId: number;
+        _uuid: string;
         _options: ICalcGraph.ConstructorOptions;
         _getEntireCoords: () => IRange.Coords;
         _calculation: ICalculation;
@@ -25849,7 +25870,7 @@ declare module "calculation/graph/CalcGraph" {
         /** {@inheritDoc ICalcGraph.autoFill} */
         autoFill(template: IRange.Coords | string, destination: IRange.Coords | string): this;
         protected _scheduleRecalculation(nodes?: CalcNode | CalcNode[]): void;
-        protected _notifyCalculated(options: ICalcGraph.CalculateOptions | boolean): Promise<ICalcGraph.Results>;
+        protected _notifyCalculated(options: ICalculation.CalculateOptions | boolean): Promise<ICalcGraph.Results>;
         _setInputs(values: Tuple.BoundedTuples<Scalar>, formulas: readonly ISpatialMap.Entry<string>[], deleteRange?: IRange.Coords): ISpatialMap.Updates<ICalcGraph.FormulaInsert>;
         protected _invalidate(invalidations: ISpatialMap.Entry[]): void;
         /**
@@ -25870,7 +25891,7 @@ declare module "calculation/graph/CalcGraph" {
         protected _markAndPlan(isFullCalc: boolean, initial: CalcNode[], markId: number): MarkResults;
         protected _evaluate(forceFull: boolean): EvalResults;
         /** {@inheritDoc ICalcGraph.calculate} */
-        calculate(options?: ICalcGraph.CalculateOptions | boolean): Promise<ICalcGraph.Results>;
+        calculate(options?: ICalculation.CalculateOptions | boolean): Promise<ICalcGraph.Results>;
         protected _clearScope(): void;
         protected _resetScope(): ICalcGraphScope;
         /**
@@ -27193,7 +27214,7 @@ declare module ".generated/formulas/impl/financial/Financial" {
     rate: number, pr: number, basis?: number): number;
 }
 declare module ".generated/formulas/impl/information/Information" {
-    import { Scalar, FormulaError, IReferenceRange, IRange } from '@sheetxl/primitives';
+    import { FormulaError, type Scalar, type IReferenceRange, type IRange } from '@sheetxl/primitives';
     /**
      * @summary Returns information about the cell.
      * @param {'address' | 'col' | 'contents' | 'row' | 'type'} infoType The type of information to return.
@@ -29910,6 +29931,8 @@ declare module "calculation/Calculation" {
     export class Calculation extends AbstractModel<State, ICalculation.JSON, CommitView, ICalculation.IListeners> implements ICalculation {
         protected _context: CalculationContext;
         protected _scope: ICalcGraphScope;
+        protected _graphsCalcing: Map<string, ICalcGraph>;
+        protected _graphsAll: Map<string, ICalcGraph>;
         protected _functions: IFunctionCollection;
         protected _runtime: IRuntime;
         protected _formulaParser: IFormulaParser;
@@ -29919,6 +29942,8 @@ declare module "calculation/Calculation" {
         constructor(options?: Calculation.ConstructorOptions);
         protected _getContext(): CalculationContext;
         protected _getScope(): ICalcGraphScope;
+        protected _getCalcingGraphs(): Map<string, ICalcGraph>;
+        protected _getAllGraphs(): Map<string, ICalcGraph>;
         /** @inheritdoc ICalculation.start */
         start(): Promise<void>;
         protected _createGraph(options: ICalcGraph.ConstructorOptions): ICalcGraph;
@@ -29926,8 +29951,8 @@ declare module "calculation/Calculation" {
         stop(): Promise<void>;
         /** @inheritdoc ICalculation.getStatus */
         getStatus(): ICalculation.Status;
-        /** @inheritdoc ICalculation.waitForFinish */
-        waitForFinish(): Promise<void>;
+        /** @inheritdoc ICalculation.calculate */
+        calculate(options?: ICalculation.CalculateOptions): Promise<void>;
         /** @inheritdoc ICalculation.getFunctions */
         getFunctions(): IFunctionCollection;
         /** @inheritdoc IFormulaContext.getRuntime */
@@ -32795,13 +32820,6 @@ declare module "cellRange/ICellRange" {
          * @param full If `true` then all formulas will be recalculated.
          */
         calculate(full?: boolean): this;
-        /**
-         * Waits for all calculations to finish.
-         *
-         * @remarks
-         * Useful for ensuring that all calculations are complete before proceeding.
-         */
-        waitForCalcs(): Promise<this>;
         /**
          * Fill the range to a destination using an array of {@link IAutoFill.Filler}.
          *