@sheetxl/sdk 0.7.18 → 0.7.20

package/node/esm/{CnJrv00wG4BRe9p4.mjs → jFS4R2N5M_oHpYxW.mjs}

@@ -1,5 +1,5 @@
 /**
- * @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.7.18
+ * @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.7.20
  *
  * (C) 2025-present SheetXL Inc. & Michael T. Ford
  * License: The license can be found at https://www.sheetxl.com/license.

package/node/esm/{B6Tf7OHoZzcRj-hn.mjs → tiAu9ELmXJ2JhLvH.mjs}

@@ -1,5 +1,5 @@
 /**
- * @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.7.18
+ * @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.7.20
  *
  * (C) 2025-present SheetXL Inc. & Michael T. Ford
  * License: The license can be found at https://www.sheetxl.com/license.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sheetxl/sdk",
   "description": "SDK - A high-performance, embeddable spreadsheet engine.",
-  "version": "0.7.18",
+  "version": "0.7.20",
   "license": "SEE LICENSE IN <LICENSE>",
   "type": "module",
   "exports": {
@@ -43,9 +43,9 @@
     "automation"
   ],
   "dependencies": {
-    "@sheetxl/primitives": "^0.7.18",
-    "@sheetxl/scripting": "^0.7.18",
-    "@sheetxl/utils": "^0.7.18",
+    "@sheetxl/primitives": "^0.7.20",
+    "@sheetxl/scripting": "^0.7.20",
+    "@sheetxl/utils": "^0.7.20",
     "bahttext": "^2.3.0",
     "bessel": "^1.0.2",
     "chalk": "^5.6.2",

package/types/index.d.ts

@@ -552,6 +552,11 @@ declare interface BeforeAfterRange {
  */
 declare const boundsToPoints: (bounds: Bounds) => Point[];
 
+/**
+ * The build date of the SDK.
+ */
+export declare const BUILD_DATE: string;
+
 declare interface CacheSearchRunData<T = any> {
     runs: readonly ITypes.RunCoordValue<T>[];
     run: ITypes.RunCoordValue<T | null>;
@@ -599,6 +604,8 @@ declare interface CalcNode {
 export declare class Calculation extends AbstractModel<State_2, 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;
@@ -608,6 +615,8 @@ export declare class Calculation extends AbstractModel<State_2, ICalculation.JSO
     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;
@@ -615,8 +624,8 @@ export declare class Calculation extends AbstractModel<State_2, ICalculation.JSO
     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 */
@@ -2392,7 +2401,7 @@ declare interface 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.
      *
@@ -2734,23 +2743,6 @@ declare namespace 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.
      */
@@ -2909,12 +2901,12 @@ export declare interface ICalculation extends IModel {
     /** @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.
      *
@@ -2932,6 +2924,15 @@ export declare interface ICalculation extends IModel {
  * {@link ICalculation}
  */
 export declare namespace ICalculation {
+    /**
+     * Options for when calculating.
+     */
+    export interface CalculateOptions {
+        /**
+         * If true a full calc will be done not just invalid values
+         */
+        full?: boolean;
+    }
     /**
      * Represents a formula that can be evaluated.
      */
@@ -4759,13 +4760,6 @@ export declare interface 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}.
      *
@@ -12072,7 +12066,7 @@ export declare interface ISheet extends ITransaction.ITransactional, IListener.I
      * 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;
     /**
@@ -17462,6 +17456,17 @@ export declare interface IWorkbook extends ITransaction.ITransactional, IListene
      * * 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.
      *
@@ -17624,6 +17629,10 @@ export declare namespace 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.
          */
@@ -17728,6 +17737,21 @@ export declare namespace 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.
          */
@@ -18017,6 +18041,7 @@ declare class LM {
     private _validate;
     private _printBanner;
     private _printDetails;
+    private _doPrint;
     private _print;
     getDetails(): Promise<LicenseDetails>;
     /**
@@ -18943,7 +18968,6 @@ export declare class Sheet implements ISheet {
     /* Excluded from this release type: _updateFormulaSpatial */
     /* Excluded from this release type: _realizeCalcedValues */
     /* Excluded from this release type: _calculate */
-    /* Excluded from this release type: _waitForCalcs */
     /* Excluded from this release type: _calculateFull */
     /* Excluded from this release type: _setComments */
     /* Excluded from this release type: _clear */
@@ -20233,6 +20257,7 @@ declare interface State_6 {
     lastId: number;
     sheetsCreated: Set<ISheet>;
     listenersSheets: Map<number, IListener.Remove>;
+    name: string | null;
 }
 
 export declare class StringCollection implements IStringCollection {
@@ -21031,6 +21056,11 @@ declare namespace _Utils {
  */
 declare const validateRuns: (runs: RunCoords[]) => boolean;
 
+/**
+ * The current version of the SDK.
+ */
+export declare const VERSION: string;
+
 declare interface ViewEdgeEntry {
     rowIndex: number;
     colIndex: number;
@@ -21086,6 +21116,10 @@ export declare class Workbook implements IWorkbook {
     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} */