@sheetxl/sdk 0.6.1 → 0.6.3

package/node/esm/{DjBIhbf2dwY_NeUt.mjs → reTbqkUQn_8r1Gjg.mjs}

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

package/{browser/esm/DyLXzieM66-sKSqC.mjs → node/esm/tAdsxJ6GZTOjbZaj.mjs}

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

package/{browser/esm/CQSkpKe1fVXBNmeZ.mjs → node/esm/zaWM4ZhyMWMFvdi0.mjs}

@@ -1,5 +1,5 @@
 /**
- * @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.6.1
+ * @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.6.3
  *
  * (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.6.1",
+  "version": "0.6.3",
   "license": "SEE LICENSE IN <LICENSE>",
   "type": "module",
   "exports": {
@@ -31,9 +31,9 @@
     "automation"
   ],
   "dependencies": {
-    "@sheetxl/primitives": "^0.6.1",
-    "@sheetxl/scripting": "^0.6.1",
-    "@sheetxl/utils": "^0.6.1",
+    "@sheetxl/primitives": "^0.6.3",
+    "@sheetxl/scripting": "^0.6.3",
+    "@sheetxl/utils": "^0.6.3",
     "bahttext": "^2.3.0",
     "bessel": "^1.0.2",
     "chalk": "^5.5.0",

package/types/index.d.ts

@@ -3162,6 +3162,14 @@ export declare namespace ICalculation {
  * A single unit of data and meta data within an `ICellRange`, located at a specific row and column.
  */
 export declare interface ICell {
+    /**
+     * Returns the range of the cell.
+     *
+     * @remarks
+     * Returns a range for a single cell.
+     * Temporary cells will have to return InvalidRange
+     */
+    getRange(): ICellRange;
     /**
      * Returns the value of the cell.
      *
@@ -3393,9 +3401,8 @@ export declare interface ICell {
     select(options?: ITypes.SelectOptions): Promise<boolean>;
     /**
      * Returns the Sheet.
-     * @template  S - The callback return type.
      */
-    getSource<S>(): S;
+    getSheet(): ISheet;
     /**
      * For runtime type checking.
      */
@@ -4282,12 +4289,14 @@ export declare interface ICellRange {
      */
     getMerges(): IRange.Coords[];
     /**
-     * A convenience method to get the top left `ICell`.
+     * Returns a cell in the range.
+     *
+     * @param address The address of the cell to retrieve. This must be within the range bounds. Default Value the 'top left'
      *
      * @see
      * {@link ICellRange.getCells}
      */
-    getCell(): ICell;
+    getCell(address?: ICell.Address): ICell;
     /**
      * Return a 2D array of {@link ICell | cells} in the shape of the range.
      *
@@ -4542,6 +4551,15 @@ export declare interface ICellRange {
      * {@link ICellRange.setValues}
      */
     setValue(value: ICellRange.ValuesUpdateOrCallback, options?: ICellRange.SetValuesOptions): this;
+    /**
+     * Set the formula for a range.
+     *
+     * @remarks
+     * Identical behavior to setValue. Exists for ergonomics
+     * @see
+     * {@link ICellRange.setValue}
+     */
+    setFormula(value: ICellRange.ValuesUpdateOrCallback, options?: ICellRange.SetValuesOptions): this;
     /**
      * Re-evaluates and formulas within the range.
      * @param full If `true` then all formulas will be recalculated.
@@ -4851,9 +4869,8 @@ export declare interface ICellRange {
     isEmpty(): boolean;
     /**
      * Returns the Sheet.
-     * @template  S - The callback return type.
      */
-    getSource<S>(): S;
+    getSheet(): ISheet;
     /**
      * The IRange.Coords.
      */
@@ -5784,9 +5801,9 @@ export declare interface ICellRanges {
      */
     getMerges(): IRange.Coords[];
     /**
-     * {@inheritDoc ICellRange.getSource}
+     * {@inheritDoc ICellRange.getSheet}
      */
-    getSource<S>(): S;
+    getSheet(): ISheet;
     /**
      * {@inheritDoc ICellRange.getStyleUpdater}
      */
@@ -11453,6 +11470,12 @@ export declare interface ISheet extends ITransaction.ITransactional, IListener.I
      * @param options Options for the ranges.
      */
     getRange(address: ICellRange.Address, options?: ICellRange.GetRangeOptions): ICellRange;
+    /**
+     * Returns a {@link ICell} at the specified address.
+     *
+     * @param address Address of the cell.
+     */
+    getCell(address: ICell.Address): ICell;
     /**
      * Returns an {@link ICellRanges}. An {@link ICellRanges} is an ordered list of
      * {@link ICellRange}s. These are used to interact with a set of contiguous 2D ranges.
@@ -12160,7 +12183,7 @@ export declare interface ISheetCollection extends ICollection<ISheet> {
     /**
      * Add an `ISheet` to the collection.
      */
-    add(options?: ISheetCollection.AddOptions): ISheet;
+    add(options?: ISheetCollection.AddOptions | string | number): ISheet;
     /**
      * Returns sheets that match the filter criteria.
      *
@@ -16805,6 +16828,13 @@ export declare interface IWorkbook extends ITransaction.ITransactional, IListene
      * Returns the collection of sheets within the workbook.
      */
     getSheets(): ISheetCollection;
+    /**
+     * Adds a new sheet to the workbook.
+     *
+     * @remarks
+     * This is a convenience method that wraps `getSheets().add`.
+     */
+    addSheet(options?: ISheetCollection.AddOptions | string | number): ISheet;
     /**
      * Returns the sheet at the given offset.
      *
@@ -18371,6 +18401,8 @@ export declare class Sheet implements ISheet {
     /* Excluded from this release type: _createRanges */
     /** {@inheritDoc ISheet.getRange} */
     getRange(address: ICellRange.Address, options?: ICellRange.GetRangeOptions): ICellRange;
+    /** {@inheritDoc ISheet.getCell} */
+    getCell(address: ICell.Address): ICell;
     /** {@inheritDoc ISheet.getRange} */
     getRanges(address: ICellRanges.Address, options?: ICellRange.GetRangeOptions): ICellRanges;
     /** {@inheritDoc ISheet.getSelectedRange} */
@@ -20539,6 +20571,8 @@ export declare class Workbook implements IWorkbook {
     getSheetAt(index: number, visibility?: ISheet.Visibility): ISheet;
     /** {@inheritDoc IWorkbook.getSheets} */
     getSheets(): ISheetCollection;
+    /** {@inheritDoc IWorkbook.addSheet} */
+    addSheet(options?: ISheetCollection.AddOptions | string | number): ISheet;
     protected _getSheets(visibility?: ISheet.Visibility): ISheet[];
     protected _getSheetRefs(visibility?: ISheet.Visibility): SheetRef[];
     /* Excluded from this release type: _getSheetRef */

package/types/scripting.d.ts

@@ -15519,6 +15519,12 @@ declare module "sheet/ISheet" {
          * @param options Options for the ranges.
          */
         getRange(address: ICellRange.Address, options?: ICellRange.GetRangeOptions): ICellRange;
+        /**
+         * Returns a {@link ICell} at the specified address.
+         *
+         * @param address Address of the cell.
+            */
+        getCell(address: ICell.Address): ICell;
         /**
          * Returns an {@link ICellRanges}. An {@link ICellRanges} is an ordered list of
          * {@link ICellRange}s. These are used to interact with a set of contiguous 2D ranges.
@@ -17944,13 +17950,16 @@ declare module "sheet/SheetCell" {
         protected _styleConditional: IStyle;
         constructor(options: SheetCellOptions, coords: IRange.CellCoords, type?: ScalarType, value?: Scalar, rs?: RangeState.Intersection, p?: IRange.CellCoords, // prev
         n?: IRange.CellCoords);
+        /** {@inheritDoc ICell.getRange} */
+        getRange(): ICellRange;
+        /** {@inheritDoc ICell.isEqual} */
         isEqual(other: ICell): boolean;
         /** {@inheritDoc ICell.getCoords} */
         getCoords(): IRange.CellCoords;
         /** {@inheritDoc ICell.getA1} */
         getA1(): string;
-        /** {@inheritDoc ICell.getSource} */
-        getSource<ISheet>(): ISheet;
+        /** {@inheritDoc ICell.getSheet} */
+        getSheet(): ISheet;
         /** {@inheritDoc ICell.select} */
         select(options?: ITypes.SelectOptions): Promise<boolean>;
         /** {@inheritDoc ICell.getColumnFilter} */
@@ -23982,11 +23991,20 @@ declare module "cell/ICell" {
     import type { IStyle } from "style/index";
     import type { ICellRange } from "cellRange/index";
     import type { ICalculation } from "calculation/index";
+    import type { ISheet } from "sheet/index";
     import type { ICellProtection } from "cell/ICellProtection";
     /**
      * A single unit of data and meta data within an `ICellRange`, located at a specific row and column.
      */
     export interface ICell {
+        /**
+         * Returns the range of the cell.
+         *
+         * @remarks
+         * Returns a range for a single cell.
+         * Temporary cells will have to return InvalidRange
+         */
+        getRange(): ICellRange;
         /**
          * Returns the value of the cell.
          *
@@ -24218,9 +24236,8 @@ declare module "cell/ICell" {
         select(options?: ITypes.SelectOptions): Promise<boolean>;
         /**
          * Returns the Sheet.
-         * @template  S - The callback return type.
          */
-        getSource<S>(): S;
+        getSheet(): ISheet;
         /**
          * For runtime type checking.
          */
@@ -26240,6 +26257,7 @@ declare module "cellRange/ICellRanges" {
     import type { ITransaction } from "transaction/index";
     import type { IStyle } from "style/index";
     import type { ICell } from "cell/index";
+    import type { ISheet } from "sheet/index";
     import type { ICellRange } from "cellRange/ICellRange";
     /**
      * An `ICellRanges` is a collection of {@link ICellRange}s.
@@ -26252,9 +26270,9 @@ declare module "cellRange/ICellRanges" {
          */
         getMerges(): IRange.Coords[];
         /**
-         * {@inheritDoc ICellRange.getSource}
+         * {@inheritDoc ICellRange.getSheet}
          */
-        getSource<S>(): S;
+        getSheet(): ISheet;
         /**
          * {@inheritDoc ICellRange.getStyleUpdater}
          */
@@ -26834,6 +26852,7 @@ declare module "cellRange/ICellRange" {
     import type { ISort } from "sort/index";
     import type { IAutoFill } from "autoFill/index";
     import type { IStyle } from "style/index";
+    import { ISheet } from "sheet/index";
     import { ICell } from "cell/index";
     import type { ICellRanges } from "cellRange/ICellRanges";
     import type { ICellHeaderRange } from "cellRange/ICellHeaderRange";
@@ -26879,12 +26898,14 @@ declare module "cellRange/ICellRange" {
          */
         getMerges(): IRange.Coords[];
         /**
-         * A convenience method to get the top left `ICell`.
+         * Returns a cell in the range.
+         *
+         * @param address The address of the cell to retrieve. This must be within the range bounds. Default Value the 'top left'
          *
          * @see
          * {@link ICellRange.getCells}
          */
-        getCell(): ICell;
+        getCell(address?: ICell.Address): ICell;
         /**
          * Return a 2D array of {@link ICell | cells} in the shape of the range.
          *
@@ -27139,6 +27160,15 @@ declare module "cellRange/ICellRange" {
          * {@link ICellRange.setValues}
          */
         setValue(value: ICellRange.ValuesUpdateOrCallback, options?: ICellRange.SetValuesOptions): this;
+        /**
+         * Set the formula for a range.
+         *
+         * @remarks
+         * Identical behavior to setValue. Exists for ergonomics
+         * @see
+         * {@link ICellRange.setValue}
+         */
+        setFormula(value: ICellRange.ValuesUpdateOrCallback, options?: ICellRange.SetValuesOptions): this;
         /**
          * Re-evaluates and formulas within the range.
          * @param full If `true` then all formulas will be recalculated.
@@ -27448,9 +27478,8 @@ declare module "cellRange/ICellRange" {
         isEmpty(): boolean;
         /**
          * Returns the Sheet.
-         * @template  S - The callback return type.
          */
-        getSource<S>(): S;
+        getSheet(): ISheet;
         /**
          * The IRange.Coords.
          */
@@ -29587,7 +29616,7 @@ declare module "sheet/ISheetCollection" {
         /**
          * Add an `ISheet` to the collection.
          */
-        add(options?: ISheetCollection.AddOptions): ISheet;
+        add(options?: ISheetCollection.AddOptions | string | number): ISheet;
         /**
          * Returns sheets that match the filter criteria.
          *
@@ -31929,11 +31958,12 @@ declare module "sheet/protection/SheetProtection" {
 }
 declare module "sheet/SheetRanges" {
     import { Scalar, IRange } from '@sheetxl/primitives';
-    import { ITransaction } from "transaction/index";
-    import { IListener } from "listener/index";
-    import { ICell } from "cell/index";
-    import { ICellRanges, ICellRange } from "cellRange/index";
-    import { IStyle } from "style/index";
+    import type { ITransaction } from "transaction/index";
+    import type { IListener } from "listener/index";
+    import type { ICell } from "cell/index";
+    import type { ICellRanges, ICellRange } from "cellRange/index";
+    import type { IStyle } from "style/index";
+    import type { ISheet } from "sheet/index";
     export interface SheetRangesOptions {
         excludeHidden?: boolean;
         readOnly?: string;
@@ -32030,8 +32060,8 @@ declare module "sheet/SheetRanges" {
         isInvalid(): boolean;
         /** {@inheritDoc ICellRanges.getA1} */
         getA1(): string;
-        /** {@inheritDoc ICellRanges.getSource} */
-        getSource<S>(): S;
+        /** {@inheritDoc ICellRanges.getSheet} */
+        getSheet(): ISheet;
         /** {@inheritDoc ICellRanges.doBatch} */
         doBatch<R>(callback: (commit: ITransaction.ICommit) => R | Promise<R>, options?: string | ITransaction.OperationOptions): R | Promise<R>;
         get [Symbol.toStringTag](): string;
@@ -32045,12 +32075,13 @@ declare module "sheet/SheetRange" {
     import { Scalar, ScalarUpdate, JSScalar, IRange } from '@sheetxl/primitives';
     import { ITransaction } from "transaction/index";
     import { IListener } from "listener/index";
-    import { ICell } from "cell/index";
-    import { ICellRange, ICellRanges, ICellHeaderRange } from "cellRange/index";
-    import { IComment } from "comment/index";
-    import { IStyle } from "style/index";
-    import { IHyperlink } from "hyperlink/index";
-    import { ISort } from "sort/index";
+    import type { ICell } from "cell/index";
+    import type { ICellRange, ICellRanges, ICellHeaderRange } from "cellRange/index";
+    import type { IComment } from "comment/index";
+    import type { IStyle } from "style/index";
+    import type { IHyperlink } from "hyperlink/index";
+    import type { ISort } from "sort/index";
+    import type { ISheet } from "sheet/ISheet";
     import { Sheet } from "sheet/Sheet";
     export interface SheetRangeOptions {
         excludeHidden?: boolean;
@@ -32091,10 +32122,12 @@ declare module "sheet/SheetRange" {
         protected _validateWrite(): void;
         /** {@inheritDoc ICellRange.updateCells} */
         updateCells(value: ICellRange.Update, options?: ICellRange.UpdateCellsOptions, updateCoords?: IRange.Coords): this;
-        /** {@inheritDoc ICellRange.setValue} */
-        setValue(value: ScalarUpdate, options?: ICellRange.SetValuesOptions): this;
         /** {@inheritDoc ICellRange.setValues} */
         setValues(value: ICellRange.ValuesUpdate, options?: ICellRange.SetValuesOptions): this;
+        /** {@inheritDoc ICellRange.setValue} */
+        setValue(value: ScalarUpdate, options?: ICellRange.SetValuesOptions): this;
+        /** {@inheritDoc ICellRange.setFormula} */
+        setFormula(value: ScalarUpdate, options?: ICellRange.SetValuesOptions): this;
         /** @internal */
         protected _setValueOrValues(value: ICellRange.ValuesUpdate, options?: ICellRange.SetValuesOptions): this;
         /** {@inheritDoc ICellRange.getValues} */
@@ -32106,7 +32139,7 @@ declare module "sheet/SheetRange" {
         /** {@inheritDoc ICellRange.getCells} */
         getCells(options?: ICellRange.GetValuesOptions): ICell[][];
         /** {@inheritDoc ICellRange.getCell} */
-        getCell(): ICell;
+        getCell(address?: ICell.Address): ICell;
         /** {@inheritDoc ICellRange.select} */
         select(options?: ICellRange.SelectOptions): Promise<this>;
         /** {@inheritDoc ICellRange.find} */
@@ -32193,8 +32226,8 @@ declare module "sheet/SheetRange" {
         addListener2(listener: ICellRange.Listener, options?: ICellRange.ListenerOptions): IListener.Remove;
         /** {@inheritDoc ICellRange.addListener} */
         addListener(listener: ICellRange.Listener, options?: ICellRange.ListenerOptions): IListener.Remove;
-        /** {@inheritDoc ICellRange.getSource} */
-        getSource<S>(): S;
+        /** {@inheritDoc ICellRange.getSheet} */
+        getSheet(): ISheet;
         /** {@inheritDoc ICellRange.autoFill} */
         autoFill(destination: ICellRange.Address, options?: ICellRange.AutoFillOptions): this;
         /** {@inheritDoc ICellRange.autoFit} */
@@ -32205,8 +32238,6 @@ declare module "sheet/SheetRange" {
         setHyperlink(hyperlink: IHyperlink.Update, options?: ITransaction.OperationOptions): this;
         /** {@inheritDoc ICellRange.setComments} */
         setComments(comments: IComment.Properties, options?: ITransaction.OperationOptions): this;
-        /** {@inheritDoc ICellRange.setFormula} */
-        setFormula(formula: string, options?: ITransaction.OperationOptions): this;
         /** {@inheritDoc ICellRange.updateStyle} */
         updateStyle(style: IStyle.Update, options?: IStyle.UpdateOptions): this;
         /** {@inheritDoc ICellRange.getStyleUpdater} */
@@ -32240,7 +32271,7 @@ declare module "sheet/SheetRange" {
 }
 declare module "sheet/Sheet" {
     import { Scalar, JSScalar, IRange } from '@sheetxl/primitives';
-    import { Dimensions, Bounds, CoordUtils } from '@sheetxl/utils';
+    import { Dimensions, type Bounds, CoordUtils } from '@sheetxl/utils';
     import { ITypes, ICollection, IProperties } from "type/index";
     import type { IListener } from "listener/index";
     import { type ITransaction } from "transaction/index";
@@ -32523,6 +32554,8 @@ declare module "sheet/Sheet" {
         protected _createRanges(coords: readonly IRange.Coords[], getOptions?: ICellRange.GetRangeOptions, readOnly?: string): ICellRanges;
         /** {@inheritDoc ISheet.getRange} */
         getRange(address: ICellRange.Address, options?: ICellRange.GetRangeOptions): ICellRange;
+        /** {@inheritDoc ISheet.getCell} */
+        getCell(address: ICell.Address): ICell;
         /** {@inheritDoc ISheet.getRange} */
         getRanges(address: ICellRanges.Address, options?: ICellRange.GetRangeOptions): ICellRanges;
         /** {@inheritDoc ISheet.getSelectedRange} */
@@ -33153,6 +33186,13 @@ declare module "workbook/IWorkbook" {
          * Returns the collection of sheets within the workbook.
          */
         getSheets(): ISheetCollection;
+        /**
+         * Adds a new sheet to the workbook.
+         *
+         * @remarks
+         * This is a convenience method that wraps `getSheets().add`.
+         */
+        addSheet(options?: ISheetCollection.AddOptions | string | number): ISheet;
         /**
          * Returns the sheet at the given offset.
          *
@@ -33776,7 +33816,7 @@ declare module "sheet/SheetCollection" {
         private _get;
         constructor(add: (options: ISheetCollection.AddOptions) => ISheet, get: (name?: string, visibility?: ISheet.Visibility) => ISheet[]);
         /** {@inheritDoc ISheetCollection.add} */
-        add(options?: ISheetCollection.AddOptions): ISheet;
+        add(options?: ISheetCollection.AddOptions | string | number): ISheet;
         /** {@inheritDoc ISheetCollection.getItems} */
         getItems(options?: ISheetCollection.GetItemsOptions): ISheet[];
         /** {@inheritDoc ISheetCollection.getByName} */
@@ -34023,6 +34063,8 @@ declare module "workbook/Workbook" {
         getSheetAt(index: number, visibility?: ISheet.Visibility): ISheet;
         /** {@inheritDoc IWorkbook.getSheets} */
         getSheets(): ISheetCollection;
+        /** {@inheritDoc IWorkbook.addSheet} */
+        addSheet(options?: ISheetCollection.AddOptions | string | number): ISheet;
         protected _getSheets(visibility?: ISheet.Visibility): ISheet[];
         protected _getSheetRefs(visibility?: ISheet.Visibility): SheetRef[];
         /** @internal */
@@ -34034,7 +34076,7 @@ declare module "workbook/Workbook" {
         /** {@inheritDoc IWorkbook.isValidSheetNameCharacter} */
         isValidSheetNameCharacter(character: string): boolean;
         /** @internal */
-        protected _addSheetOptions(options?: ISheetCollection.AddOptions): ISheet;
+        protected _addSheetOptions(options?: ISheetCollection.AddOptions | string | number): ISheet;
         /** @internal */
         protected _nextSheetName(sheetName?: string): string;
         /** @internal */