@sheetxl/sdk 0.7.8 → 0.7.10

package/{browser/esm/CKYWp9D6b8445Qyx.mjs → node/esm/kV8uXcO0eq-dKVP6.mjs}

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

package/{browser/esm/CGre_shdAXilyAJI.mjs → node/esm/pFiDhbuMy42dhPsi.mjs}

@@ -1,5 +1,5 @@
 /**
- * @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.7.8
+ * @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.7.10
  *
  * (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.8",
+  "version": "0.7.10",
   "license": "SEE LICENSE IN <LICENSE>",
   "type": "module",
   "exports": {
@@ -43,9 +43,9 @@
     "automation"
   ],
   "dependencies": {
-    "@sheetxl/primitives": "^0.7.8",
-    "@sheetxl/scripting": "^0.7.8",
-    "@sheetxl/utils": "^0.7.8",
+    "@sheetxl/primitives": "^0.7.10",
+    "@sheetxl/scripting": "^0.7.10",
+    "@sheetxl/utils": "^0.7.10",
     "bahttext": "^2.3.0",
     "bessel": "^1.0.2",
     "chalk": "^5.6.2",

package/types/index.d.ts

@@ -623,6 +623,8 @@ export declare class Calculation extends AbstractModel<State_2, ICalculation.JSO
     getRuntime(): IRuntime;
     protected _checkReady(): void;
     protected _statusMessage(): string;
+    get [Symbol.toStringTag](): string;
+    toString(): string;
 }
 
 /**
@@ -3955,11 +3957,6 @@ export declare namespace ICellHeader {
          * Style id
          */
         s?: number;
-        /**
-         * Custom style
-         * @deprecated - Was for backward compatibility with Excel but no longer used.
-         */
-        cs?: boolean;
         /**
          * Header level
          */
@@ -5771,9 +5768,18 @@ export declare namespace ICellRange {
          * @remarks
          * This may change shape due to insert/delete/move of cells or sheets.
          */
-        getSource<T = any>(): T;
-        getFrom?<T = any>(): T;
-        getTo?<T = any>(): T;
+        getSource<T = ICellRange | ICellRanges>(): T;
+        /**
+         * This is the range of data that has been changed.
+         *
+         * @remarks
+         * This is different than the source range as that is the entire range area that was listened to.
+         */
+        getFrom(): ICellRanges;
+        /**
+         * Used for moves. Represents the new location of the data that has changed.
+         */
+        getTo?(): ICellRange;
         /**
          * Indicates the type of change that triggered the event.
          *
@@ -18069,7 +18075,7 @@ declare namespace OverlappingRange {
          *   but it will modify the original range data.
          * - **Safety:**  If you need to preserve the original range data, set this to `false`.
          */
-        reuseIterator?: IteratorResult<OverlappingRange.Intersection>;
+        reuseIterator?: boolean | IteratorResult<OverlappingRange.Intersection>;
     }
     /**
      * When iterating a cursor is used to track the
@@ -18960,7 +18966,8 @@ declare class SheetDirectStyle implements ISpatialMap.IUpdatableEntry, IProperti
     protected _p: IStyle.Properties;
     protected _t: IRange.Coords;
     protected _e: boolean;
-    constructor(styles: IStyleCollection, range: IRange.Coords, properties?: IStyle.Properties, tile?: IRange.Coords);
+    protected _o: IRange.Orientations;
+    constructor(styles: IStyleCollection, range: IRange.Coords, properties?: IStyle.Properties, tile?: IRange.Coords, orientations?: IRange.Orientations);
     isEmpty(): boolean;
     getProperties(): IStyle.Properties;
     /** {@inheritDoc IProperties.ICellRanged.getCoords} */
@@ -19123,6 +19130,8 @@ declare class SheetHeader implements ISheetHeader {
     fromJSON(json: ISheetHeader.JSON): void;
     /** {@inheritDoc ISheetHeader.toJSON} */
     toJSON(): ISheetHeader.JSON;
+    get [Symbol.toStringTag](): string;
+    toString(): string;
 }
 
 /**
@@ -19249,6 +19258,8 @@ declare class SheetProtection extends DefaultProtection<ISheetProtection, ISheet
     protected _clearProperties(): void;
     protected _fromJSON(json: ISheetProtection.JSON | null): void;
     protected _toJSON(json: ISheetProtection.JSON): ISheetProtection.JSON;
+    get [Symbol.toStringTag](): string;
+    toString(): string;
 }
 
 /**
@@ -20324,6 +20335,9 @@ export declare class Table extends AbstractAnchored<State_3, CommitView_2> imple
     addListeners(listeners: ITable.IListeners, options?: IListener.Options): IListener.Remove;
     /* Excluded from this release type: _processStateChange */
     /* Excluded from this release type: _processHeaderListener */
+    get [Symbol.toStringTag](): string;
+    /** {@inheritDoc ICellRanges.toString} */
+    toString(): string;
     /** {@inheritDoc ITable.toJSON} */
     toJSON(): ITable.JSON | null;
     private _createNamed;

package/types/scripting.d.ts

@@ -13040,7 +13040,7 @@ declare module "collections/OverlappingRangeIterator" {
              *   but it will modify the original range data.
              * - **Safety:**  If you need to preserve the original range data, set this to `false`.
              */
-            reuseIterator?: IteratorResult<OverlappingRange.Intersection>;
+            reuseIterator?: boolean | IteratorResult<OverlappingRange.Intersection>;
         }
         /**
          * When iterating a cursor is used to track the
@@ -15944,6 +15944,8 @@ declare module "named/NamedReference" {
         toJSON(): INamed.JSON | null;
         protected _getDescription(): string;
         protected _processDelete(): void;
+        get [Symbol.toStringTag](): string;
+        toString(): string;
     }
 }
 declare module "named/_NamedMessages" {
@@ -18193,6 +18195,8 @@ declare module "shape/Shape" {
         toJSON(_toResourceId?: (resource: IResource) => number): IShape.JSON;
         /** {@inheritDoc Movable.Content.getTypeDescription} */
         getTypeDescription(): string;
+        get [Symbol.toStringTag](): string;
+        toString(): string;
     }
     /**
      * Interfaces for creating `Chart` items.
@@ -19034,6 +19038,7 @@ declare module "selection/RangeSelection" {
         protected _cellToRangeActual(start: IRange.CellCoords, end: IRange.CellCoords): IRange.Coords;
         protected _rangesFromCellOptional(selection: IRangeSelection.Coords, cell: Partial<IRange.CellCoords>, cellPivot: Partial<IRange.CellCoords>): IRange.Coords;
         protected _getMaxRange(): IRange.Coords;
+        get [Symbol.toStringTag](): string;
         toString(): string;
     }
 }
@@ -19891,6 +19896,8 @@ declare module "sheet/header/SheetCellHeader" {
         isEqual(other: ICellHeader): boolean;
         /** {@inheritDoc ICellHeader.isEmpty} */
         isEmpty(): boolean;
+        get [Symbol.toStringTag](): string;
+        toString(): string;
         /** {@inheritDoc ICellHeader.isICellHeader} */
         get isICellHeader(): true;
     }
@@ -19905,6 +19912,63 @@ declare module "sheet/header/_SheetHeaderMessage" {
     export const DESC_ROW_HEADERS: string;
     export const DESC_COL_HEADERS: string;
 }
+declare module "sheet/header/SheetCellHeaderRange" {
+    import { IRange } from '@sheetxl/primitives';
+    import { RunCoords } from '@sheetxl/utils';
+    import { ITypes } from "type/index";
+    import { ITransaction } from "transaction/index";
+    import { ICellHeader } from "cell/index";
+    import { ICellHeaderRange } from "cellRange/index";
+    import { CreateCellHeaderCallback } from "sheet/header/SheetCellHeader";
+    import * as _Utils from "sheet/header/_HeaderUtils";
+    import { SheetHeader } from "sheet/header/SheetHeader";
+    export class SheetCellHeaderRange implements ICellHeaderRange {
+        protected _header: any;
+        protected _coords: RunCoords;
+        constructor(header: SheetHeader, coords: RunCoords);
+        protected _forEachSpan<T = any>(callback: ICellHeaderRange.ForEachSpanCallback<T>, optionsVisitor: ICellHeaderRange.IteratorOptions, headersToScan: ITypes.RunCoordValue<_Utils.CellHeaderState>[], createCellHeader?: CreateCellHeaderCallback): T | void;
+        /** {@inheritDoc ICellHeaderRange.forEachSpan} */
+        forEachSpan<T = any>(callback: ICellHeaderRange.ForEachSpanCallback<T>, options?: ICellHeaderRange.IteratorOptions): T | void;
+        /** {@inheritDoc ICellHeaderRange.forEachVisibleSpan} */
+        forEachVisibleSpan<T = any>(callback: ICellHeaderRange.ForEachVisibleSpanCallback<T>, options?: ICellHeaderRange.ForEachVisibleSpanOptions): T | void;
+        /** {@inheritDoc ICellHeaderRange.forEach} */
+        forEach<T>(callback: ICellHeaderRange.ForEachCallback<T>, options?: ICellHeaderRange.IteratorOptions): T | void;
+        /** {@inheritDoc ICellHeaderRange.updateHeaders} */
+        updateHeaders(update: ICellHeader.Update, options?: ICellHeaderRange.UpdateHeadersOptions): this;
+        /** {@inheritDoc ICellHeaderRange.getCoords} */
+        getCoords(): RunCoords;
+        /** {@inheritDoc ICellHeaderRange.setHidden} */
+        setHidden(hidden?: boolean): this;
+        /** {@inheritDoc ICellHeaderRange.getUsedRange} */
+        getUsedRange(options?: ICellHeaderRange.GetRangeOptions): this;
+        /** {@inheritDoc ICellHeaderRange.getCount} */
+        getCount(): number;
+        /** {@inheritDoc ICellHeaderRange.getVisibleCount} */
+        getVisibleCount(): number;
+        /** {@inheritDoc ICellHeaderRange.isEntireHeaders} */
+        isEntireHeaders(): boolean;
+        /** {@inheritDoc ICellHeaderRange.getSnapshot} */
+        getSnapshot(options?: ICellHeaderRange.CopyOptions): ICellHeaderRange.ISnapshot;
+        /** {@inheritDoc ICellHeaderRange.clear} */
+        clear(): this;
+        /** {@inheritDoc ICellHeaderRange.setSize} */
+        setSize(size?: number | string, options?: ICellHeaderRange.SetSizeOptions): this;
+        /** {@inheritDoc ICellHeaderRange.at} */
+        at(index: number): ICellHeader;
+        /** {@inheritDoc ICellHeaderRange.getOrientation} */
+        getOrientation(): IRange.Orientation;
+        /** {@inheritDoc ICellHeaderRange.doBatch} */
+        doBatch<R>(callback: (commit: ITransaction.ICommit) => R | Promise<R>, options?: string | ICellHeaderRange.UpdateHeadersOptions): R | Promise<R>;
+        /** {@inheritDoc ICellHeaderRange.getSheetHeader} */
+        getSheetHeader<S>(): S;
+        /** {@inheritDoc ICellHeaderRange.getA1} */
+        getA1(): string;
+        get [Symbol.toStringTag](): string;
+        toString(): string;
+        /** {@inheritDoc ICellHeaderRange.isICellHeaderRange} */
+        get isICellHeaderRange(): true;
+    }
+}
 declare module "sheet/header/SheetHeader" {
     import { IRange } from '@sheetxl/primitives';
     import { RunCoords } from '@sheetxl/utils';
@@ -20051,6 +20115,8 @@ declare module "sheet/header/SheetHeader" {
         fromJSON(json: ISheetHeader.JSON): void;
         /** {@inheritDoc ISheetHeader.toJSON} */
         toJSON(): ISheetHeader.JSON;
+        get [Symbol.toStringTag](): string;
+        toString(): string;
     }
     /**
      * {@inheritDoc SheetHeader}
@@ -20186,7 +20252,8 @@ declare module "sheet/style/SheetDirectStyle" {
         protected _p: IStyle.Properties;
         protected _t: IRange.Coords;
         protected _e: boolean;
-        constructor(styles: IStyleCollection, range: IRange.Coords, properties?: IStyle.Properties, tile?: IRange.Coords);
+        protected _o: IRange.Orientations;
+        constructor(styles: IStyleCollection, range: IRange.Coords, properties?: IStyle.Properties, tile?: IRange.Coords, orientations?: IRange.Orientations);
         isEmpty(): boolean;
         getProperties(): IStyle.Properties;
         /** {@inheritDoc IProperties.ICellRanged.getCoords} */
@@ -20345,6 +20412,8 @@ declare module "sheet/style/SheetCellStyle" {
         isNone(): boolean;
         /** {@inheritDoc IBorder.IStroke.toCSS} */
         toCSS(): Partial<CSSStyleDeclaration>;
+        get [Symbol.toStringTag](): string;
+        toString(): string;
         /** {@inheritDoc IBorder.IStroke.isIStroke} */
         get isIStroke(): true;
     }
@@ -20375,12 +20444,12 @@ declare module "sheet/style/SheetCellStyle" {
         setDiagonalDown(edge: IBorder.IStroke | IProperties.ResolvableProperties<IBorder.StrokeProperties> | string | null, options?: IStyle.UpdateOptions): IBorder;
         /** {@inheritDoc IBorder.IStroke.isEmpty} */
         isEmpty(): boolean;
+        get [Symbol.toStringTag](): string;
+        toString(): string;
         /** {@inheritDoc IBorder.IStroke.isIBorder} */
         get isIBorder(): true;
     }
     export class CellAlignment extends Inheritable<ITextFrame.IAlignment.Properties, ITextFrame.IAlignment.JSON> implements ITextFrame.IAlignment {
-        /** {@inheritDoc ITextBoxAlignment.isITextBoxAlignment} */
-        get isITextBoxAlignment(): true;
         /** {@inheritDoc ITextBoxAlignment.getHorizontal} */
         getHorizontal(): ITextFrame.HorizontalAlignment;
         /** {@inheritDoc ITextBoxAlignment.setHorizontal} */
@@ -20417,8 +20486,13 @@ declare module "sheet/style/SheetCellStyle" {
         getReadingDirection(): ITextFrame.ReadingDirection;
         /** {@inheritDoc ITextBoxAlignment.setReadingDirection} */
         setReadingDirection(readingDirection: ITextFrame.ReadingDirection | null, options?: IStyle.UpdateOptions): ITextFrame.IAlignment;
+        get [Symbol.toStringTag](): string;
+        toString(): string;
+        /** {@inheritDoc ITextBoxAlignment.isITextBoxAlignment} */
+        get isITextBoxAlignment(): true;
     }
     export class CellFont extends Inheritable<IStyledFont.Properties, IStyledFont.JSON> implements IStyledFont {
+        /** {@inheritDoc IStyle.isEqualMeasure} */
         isEqualMeasure(other: IStyledFont): boolean;
         /** {@inheritDoc IStyle.toCSS} */
         toCSS(darkMode?: boolean, zoom?: number, ignoreNormal?: boolean): CSSProperties;
@@ -20486,6 +20560,9 @@ declare module "sheet/style/SheetCellStyle" {
         getExtend(): boolean;
         /** {@inheritDoc IStyle.setExtend} */
         setExtend(extend: boolean | null, options?: IStyle.UpdateOptions): IStyledFont;
+        get [Symbol.toStringTag](): string;
+        /** {@inheritDoc ICellRanges.toString} */
+        toString(): string;
         /** {@inheritDoc IStyle.isIStyledFont} */
         get isIStyledFont(): true;
     }
@@ -20496,6 +20573,8 @@ declare module "sheet/style/SheetCellStyle" {
         toCSS(_darkMode?: boolean): CSSProperties;
         /** {@inheritDoc IFill.INone.toJSON} */
         toJSON(): IFill.NoneJSON;
+        get [Symbol.toStringTag](): string;
+        toString(): string;
         /** {@inheritDoc IFill.isIFill} */
         get isIFill(): true;
     }
@@ -20510,6 +20589,8 @@ declare module "sheet/style/SheetCellStyle" {
         toCSS(darkMode?: boolean): CSSProperties;
         /** {@inheritDoc IFill.ISolid.toJSON} */
         toJSON(): IFill.SolidJSON;
+        get [Symbol.toStringTag](): string;
+        toString(): string;
         /** {@inheritDoc IFill.isIFill} */
         get isIFill(): true;
     }
@@ -20545,6 +20626,8 @@ declare module "sheet/style/SheetCellStyle" {
         toCSS(darkMode?: boolean, bounds?: Bounds): CSSProperties;
         /** {@inheritDoc IFill.IGradient.toJSON} */
         toJSON(): IFill.GradientJSON;
+        get [Symbol.toStringTag](): string;
+        toString(): string;
         /** {@inheritDoc IFill.isIFill} */
         get isIFill(): true;
     }
@@ -20567,6 +20650,8 @@ declare module "sheet/style/SheetCellStyle" {
         toCSS(darkMode?: boolean): CSSProperties;
         /** {@inheritDoc IFill.IPattern.toJSON} */
         toJSON(): IFill.PatternJSON;
+        get [Symbol.toStringTag](): string;
+        toString(): string;
         /** {@inheritDoc IFill.isIFill} */
         get isIFill(): true;
     }
@@ -20623,6 +20708,8 @@ declare module "sheet/style/SheetCellStyle" {
         getNamed(): IStyle.INamed;
         /** {@inheritDoc IStyle.setNamed} */
         setNamed(named: string | IStyle.INamed | null, options?: IStyle.UpdateOptions): IStyle;
+        get [Symbol.toStringTag](): string;
+        toString(): string;
         /** {@inheritDoc IStyle.isIStyle} */
         get isIStyle(): true;
     }
@@ -21379,6 +21466,8 @@ declare module "sheet/protection/SheetProtection" {
         protected _clearProperties(): void;
         protected _fromJSON(json: ISheetProtection.JSON | null): void;
         protected _toJSON(json: ISheetProtection.JSON): ISheetProtection.JSON;
+        get [Symbol.toStringTag](): string;
+        toString(): string;
     }
 }
 declare module "hyperlink/_HyperlinkMessages" {
@@ -22241,7 +22330,7 @@ declare module "sheet/Sheet" {
          */
         protected _autoFit(ranges: readonly IRange.Coords[], options?: ICellRange.AutoFitOptions): void;
         /** @internal */
-        protected _createRangeEvent(coords: (readonly IRange.FixableCoords[]) | IRange.FixableCoords, options: NotifierOptions): ICellRange.Event;
+        protected _createRangeEvent(coords: (readonly IRange.FixableCoords[]) | IRange.FixableCoords, options: NotifierOptions, coordsFrom?: (readonly IRange.FixableCoords[]) | IRange.FixableCoords): ICellRange.Event;
         /**
          * Notifies listeners with a range.
          * @internal
@@ -22697,13 +22786,11 @@ declare module "workbook/WorkbookRange" {
         constructor(coords: IRange.FixableCoords, sheet: any, workbook: IWorkbook, options: WorkbookRangeOptions);
         protected _createRanges(coords: readonly IRange.FixableCoords[], getOptions?: ICellRange.GetRangeOptions): ICellRanges;
         protected _createRange(coords: Readonly<IRange.FixableCoords>, getOptions?: ICellRange.GetRangeOptions): this;
-        /** {@inheritDoc ICellRange.getSource} */
-        getSource<S>(): S;
+        /** {@inheritDoc ICellRange.addListener} */
+        addListener(listener: ICellRange.Listener, options?: ICellRange.ListenerOptions): IListener.Remove;
         get [Symbol.toStringTag](): string;
         /** {@inheritDoc ICellRange.toString} */
         toString(): string;
-        /** {@inheritDoc ICellRange.addListener} */
-        addListener(listener: ICellRange.Listener, options?: ICellRange.ListenerOptions): IListener.Remove;
     }
 }
 declare module "workbook/Workbook" {
@@ -24292,7 +24379,7 @@ declare module "sheet/_SheetUtils" {
     import { ISort } from "sort/index";
     import type { IRangeSelection } from "selection/index";
     import { type IStyle } from "style/index";
-    import type { ICell } from "cell/index";
+    import type { ICell, ICellHeader } from "cell/index";
     import type { ICellRange } from "cellRange/index";
     import type { ISheetHeader } from "sheet/header/index";
     import type { ISheet } from "sheet/ISheet";
@@ -24470,6 +24557,11 @@ declare module "sheet/_SheetUtils" {
      * @param rangeIndex @defaultValue ranges.length 1 unless this is a single cell then -1
      */
     export const rangesToSelection: (ranges: readonly IRange.Coords[], rangeIndex?: number) => IRangeSelection.Coords;
+    export type OrientedStyled = {
+        orientations: IRange.Orientations;
+        index: number;
+    };
+    export const headerToRangedStyles: (headers: ICellHeader.JSON[], orientation: IRange.Orientation, entireCoords: IRange.Coords) => ITypes.RangeCoordValue<OrientedStyled>[] | null;
 }
 declare module "primitives/_PrimitiveUtils" {
     import { Scalar, JSScalar, ScalarType, FormulaError, IRange, IFormulaContext } from '@sheetxl/primitives';
@@ -29746,6 +29838,8 @@ declare module "calculation/Calculation" {
         getRuntime(): IRuntime;
         protected _checkReady(): void;
         protected _statusMessage(): string;
+        get [Symbol.toStringTag](): string;
+        toString(): string;
     }
     /**
      * Interfaces for creating `Calculation` items.
@@ -30490,11 +30584,6 @@ declare module "cell/ICellHeader" {
              * Style id
              */
             s?: number;
-            /**
-             * Custom style
-             * @deprecated - Was for backward compatibility with Excel but no longer used.
-             */
-            cs?: boolean;
             /**
              * Header level
              */
@@ -30816,6 +30905,9 @@ declare module "table/Table" {
         protected _processStateChange(state: State, view: CommitView, commit: ITransaction.ICommit): void;
         /** @internal */
         protected _processHeaderListener(): void;
+        get [Symbol.toStringTag](): string;
+        /** {@inheritDoc ICellRanges.toString} */
+        toString(): string;
         /** {@inheritDoc ITable.toJSON} */
         toJSON(): ITable.JSON | null;
         private _createNamed;
@@ -33628,9 +33720,18 @@ declare module "cellRange/ICellRange" {
              * @remarks
              * This may change shape due to insert/delete/move of cells or sheets.
              */
-            getSource<T = any>(): T;
-            getFrom?<T = any>(): T;
-            getTo?<T = any>(): T;
+            getSource<T = ICellRange | ICellRanges>(): T;
+            /**
+             * This is the range of data that has been changed.
+             *
+             * @remarks
+             * This is different than the source range as that is the entire range area that was listened to.
+             */
+            getFrom(): ICellRanges;
+            /**
+             * Used for moves. Represents the new location of the data that has changed.
+             */
+            getTo?(): ICellRange;
             /**
              * Indicates the type of change that triggered the event.
              *