aspose.cells.node 25.12.1 → 25.12.2

package/aspose.cells.js

@@ -1528,12 +1528,6 @@ exports.SlicerCacheCrossFilterType = {
     ShowItemsWithNoData : 2,
 };
 
-exports.SlicerCacheItemSortType = {
-    Natural : 0,
-    Ascending : 1,
-    Descending : 2,
-};
-
 exports.SlicerStyleType = {
     SlicerStyleLight1 : 0,
     SlicerStyleLight2 : 1,
@@ -6227,6 +6221,12 @@ Object.assign(exports.EbookLoadOptions.prototype, {
     },
     getTableLoadOptions() {
         return this.tableLoadOptions;
+    },
+    getDetectLaTeX() {
+        return this.detectLaTeX;
+    },
+    setDetectLaTeX(value) {
+        this.detectLaTeX = value;
     }
 });
 
@@ -7986,6 +7986,12 @@ Object.assign(exports.HtmlLoadOptions.prototype, {
     getTableLoadOptions() {
         return this.tableLoadOptions;
     },
+    getDetectLaTeX() {
+        return this.detectLaTeX;
+    },
+    setDetectLaTeX(value) {
+        this.detectLaTeX = value;
+    },
     getLoadFormat() {
         return this.loadFormat;
     },
@@ -19083,6 +19089,12 @@ Object.assign(exports.SlicerCacheItemCollection.prototype, {
 });
 
 Object.assign(exports.Slicer.prototype, {
+    getSortOrderType() {
+        return this.sortOrderType;
+    },
+    setSortOrderType(value) {
+        this.sortOrderType = value;
+    },
     getTitle() {
         return this.title;
     },
@@ -22020,6 +22032,12 @@ Object.assign(exports.PasteOptions.prototype, {
     setPasteType(value) {
         this.pasteType = value;
     },
+    getShiftFormulasOfShapes() {
+        return this.shiftFormulasOfShapes;
+    },
+    setShiftFormulasOfShapes(value) {
+        this.shiftFormulasOfShapes = value;
+    },
     getSkipBlanks() {
         return this.skipBlanks;
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aspose.cells.node",
-  "version": "25.12.1",
+  "version": "25.12.2",
   "description": "Aspose.Cells for Node.js via C++ is a high-performance and powerful library for manipulating and converting Excel (XLS, XLSX, XLSB), ODS, CSV, and HTML files, offering a comprehensive set of features for creating, editing, converting, and rendering spreadsheets within Node.js applications.",
   "main": "aspose.cells.js",
   "types": "types.d.ts",
@@ -35,10 +35,10 @@
   "license": "Commercial",
   "homepage": "https://www.aspose.com",
   "optionalDependencies": {
-    "aspose.cells.node.win32.x64": "~25.12.1",
-    "aspose.cells.node.linux.x64": "~25.12.1",
-    "aspose.cells.node.linux.arm64": "~25.12.1",
-    "aspose.cells.node.darwin.x64": "~25.12.1",
-    "aspose.cells.node.darwin.arm64": "~25.12.1"
+    "aspose.cells.node.win32.x64": "~25.12.2",
+    "aspose.cells.node.linux.x64": "~25.12.2",
+    "aspose.cells.node.linux.arm64": "~25.12.2",
+    "aspose.cells.node.darwin.x64": "~25.12.2",
+    "aspose.cells.node.darwin.arm64": "~25.12.2"
   }
 }

package/types.d.ts

@@ -2939,6 +2939,14 @@ export class HtmlTableLoadOptionCollection {
      * @param item - one HtmlTableLoadOption
      * @returns
      * the index of the added item
+     * 
+     * @remarks
+     * NOTE: This member is now obsolete. Instead,
+     * please use AddTableLoadOption() method.
+     * This method will be removed 6 months later since December 2025.
+     * Aspose apologizes for any inconvenience you may have experienced.
+     * @deprecated
+     * Use HtmlTableLoadOptionCollection.AddTableLoadOption(HtmlTableLoadOption) method instead.
      */
     add(item: HtmlTableLoadOption) : number;
     /**
@@ -2977,6 +2985,13 @@ export class HtmlTableLoadOptionCollection {
      * @param originalSheetIndex - The original index of worksheet in the html
      */
     add(tableId: string, targetSheetIndex: number, originalSheetIndex: number) : number;
+    /**
+     * Adds one HtmlTableLoadOption into this collection.
+     * @param item - one HtmlTableLoadOption
+     * @returns
+     * the index of the added item
+     */
+    addTableLoadOption(item: HtmlTableLoadOption) : number;
     /**
      * Gets the number of elements contained in.
      */
@@ -4467,6 +4482,14 @@ export class PivotAreaCollection {
     /**
      * Adds pivot area.
      * @param pivotArea - The pivot area.
+     * 
+     * @remarks
+     * NOTE: This member is now obsolete. Instead,
+     * please use AddPivotArea() method.
+     * This method will be removed 6 months later since December 2025.
+     * Aspose apologizes for any inconvenience you may have experienced.
+     * @deprecated
+     * Use PivotAreaCollection.AddPivotArea(PivotArea) method instead.
      */
     add(pivotArea: PivotArea) : number;
     /**
@@ -4474,6 +4497,13 @@ export class PivotAreaCollection {
      * @param cellArea - The area based on pivot table view.
      */
     add(cellArea: CellArea) : void;
+    /**
+     * Adds pivot area into this collection.
+     * @param pivotArea - 
+     * @returns
+     * index of the added pivot area in this collection
+     */
+    addPivotArea(pivotArea: PivotArea) : number;
     /**
      * Remove one pivot conditional formatted area setting.
      * @param index - The index
@@ -6785,6 +6815,24 @@ export class HtmlLoadOptions extends AbstractTextLoadOptions {
      * Get the HtmlTableLoadOptionCollection instance
      */
     readonly tableLoadOptions : HtmlTableLoadOptionCollection;
+    /**
+     * @deprecated Please use the 'detectLaTeX' property instead.
+     * Indicates whether to detect LaTeX formula in the HTML file.
+     * The default value is false.
+     */
+    getDetectLaTeX() : boolean;
+    /**
+     * Indicates whether to detect LaTeX formula in the HTML file.
+     * The default value is false.
+     */
+    detectLaTeX : boolean;
+    /**
+     * @deprecated Please use the 'detectLaTeX' property instead.
+     * Indicates whether to detect LaTeX formula in the HTML file.
+     * The default value is false.
+     * @param value - The value to set.
+     */
+    setDetectLaTeX(value: boolean) : void;
     /**
      * Checks whether the implementation object is null.
      */
@@ -15770,7 +15818,7 @@ export class ConversionUtility {
 }
 
 /**
- * Represents type of exporting hyperlinks to json.
+ * Represents type how to export hyperlinks to json.
  */
 export enum JsonExportHyperlinkType {
     /**
@@ -24668,6 +24716,19 @@ export class PivotField {
      * False means this field could not be grouped by date time.
      */
     groupBy(start: Date, end: Date, groups: PivotGroupByType[], interval: number, firstAsNewField: boolean) : boolean;
+    /**
+     * Group the file by the date group types.
+     * @param isAutoStart - Indicates whether to auto detect the start date time value.
+     * @param start - The start datetime
+     * @param isAutoEnd - Indicates whether to auto detect the end date time value.
+     * @param end - The end of datetime
+     * @param groups - Group types
+     * @param interval - The interval
+     * @param firstAsNewField - Indicates whether adding a new field to the pivottable.         /// Only for the first group item.
+     * @returns
+     * False means this field could not be grouped by date time.
+     */
+    groupBy(isAutoStart: boolean, start: Date, isAutoEnd: boolean, end: Date, groups: PivotGroupByType[], interval: number, firstAsNewField: boolean) : boolean;
     /**
      * Group the file by number.
      * @param start - The start value
@@ -24676,8 +24737,22 @@ export class PivotField {
      * @param newField - Indicates whether adding a new field to the pivottable
      * @returns
      * False means this field could not be grouped by date time.
+     * 
+     * @remarks
      */
     groupBy(start: number, end: number, interval: number, newField: boolean) : boolean;
+    /**
+     * Group the file by number.
+     * @param isAutoStart - Indicates whether to auto detect the start value.
+     * @param start - The start value
+     * @param isAutoEnd - Indicates whether to auto detect the end value.
+     * @param end - The end of value
+     * @param interval - The interval
+     * @param newField - Indicates whether adding a new field to the pivottable
+     * @returns
+     * False means this field could not be grouped by date time.
+     */
+    groupBy(isAutoStart: boolean, start: number, isAutoEnd: boolean, end: number, interval: number, newField: boolean) : boolean;
     /**
      * Custom group the field.
      * @param customGroupItems - The custom group items.
@@ -32966,14 +33041,6 @@ export class ExternalConnectionCollection {
      * The element with the specified name.
      */
     get(connectionName: string) : ExternalConnection;
-    /**
-     * Gets the <see cref="ExternalConnection"/> element at the specified index.
-     * @param value - The value to set.
-     * @param index - The zero based index of the element.
-     * @returns
-     * The element at the specified index.
-     */
-    set(value: ExternalConnection, index: number) : void;
     /**
      * Gets the <see cref="ExternalConnection"/> element with the specified id.
      * @param connId - external connection id
@@ -33600,14 +33667,6 @@ export class ConnectionParameterCollection {
      * The element with the specified name.
      */
     get(connParamName: string) : ConnectionParameter;
-    /**
-     * Gets the <see cref="ConnectionParameter"/> element at the specified index.
-     * @param value - The value to set.
-     * @param index - The zero based index of the element.
-     * @returns
-     * The element at the specified index.
-     */
-    set(value: ConnectionParameter, index: number) : void;
     /**
      * Gets the number of elements contained in.
      */
@@ -34342,6 +34401,14 @@ export class ConditionalFormattingIconCollection {
     /**
      * Adds <see cref="ConditionalFormattingIcon"/> object.
      * @param cficon - Returns the index of new object in the list.
+     * 
+     * @remarks
+     * NOTE: This member is now obsolete. Instead,
+     * please use Add(IconSetType, int) method.
+     * This method will be removed 6 months later since December 2025.
+     * Aspose apologizes for any inconvenience you may have experienced.
+     * @deprecated
+     * Use ConditionalFormattingIconCollection.Add(IconSetType, int) method instead.
      */
     add(cficon: ConditionalFormattingIcon) : number;
     /**
@@ -36167,24 +36234,6 @@ export enum SlicerCacheCrossFilterType {
     ShowItemsWithNoData = 2,
 }
 
-/**
- * Specify the sort type of SlicerCacheItem
- */
-export enum SlicerCacheItemSortType {
-    /**
-     * Original data order.
-     */
-    Natural = 0,
-    /**
-     * Ascending sort type
-     */
-    Ascending = 1,
-    /**
-     * Descending sort type
-     */
-    Descending = 2,
-}
-
 /**
  * Represent slicer data source item
  */
@@ -36315,6 +36364,21 @@ export enum SlicerStyleType {
  * summary description of Slicer View
  */
 export class Slicer {
+    /**
+     * @deprecated Please use the 'sortOrderType' property instead.
+     * Indicates the type of sorting items.
+     */
+    getSortOrderType() : SortOrder;
+    /**
+     * Indicates the type of sorting items.
+     */
+    sortOrderType : SortOrder;
+    /**
+     * @deprecated Please use the 'sortOrderType' property instead.
+     * Indicates the type of sorting items.
+     * @param value - The value to set.
+     */
+    setSortOrderType(value: SortOrder) : void;
     /**
      * @deprecated Please use the 'title' property instead.
      * Specifies the title of the current Slicer object.
@@ -40290,14 +40354,6 @@ export class GradientStopCollection {
      * The gradient stop.
      */
     get(index: number) : GradientStop;
-    /**
-     * Gets the gradient stop by the index.
-     * @param value - The value to set.
-     * @param index - The index.
-     * @returns
-     * The gradient stop.
-     */
-    set(value: GradientStop, index: number) : void;
     /**
      * Add a gradient stop.
      * @param position - The position of the stop,in unit of percentage.
@@ -48551,40 +48607,37 @@ export class HtmlSaveOptions extends SaveOptions {
     setEmbeddedFontType(value: HtmlEmbeddedFontType) : void;
     /**
      * @deprecated Please use the 'exportNamedRangeAnchors' property instead.
-     * Indicates whether to export anchor elements  generated for named ranges when saving to HTML.
+     * Indicates whether to export anchor elements for named ranges when saving as HTML.
      * Default value is true.
      */
     getExportNamedRangeAnchors() : boolean;
     /**
-     * Indicates whether to export anchor elements  generated for named ranges when saving to HTML.
+     * Indicates whether to export anchor elements for named ranges when saving as HTML.
      * Default value is true.
      */
     exportNamedRangeAnchors : boolean;
     /**
      * @deprecated Please use the 'exportNamedRangeAnchors' property instead.
-     * Indicates whether to export anchor elements  generated for named ranges when saving to HTML.
+     * Indicates whether to export anchor elements for named ranges when saving as HTML.
      * Default value is true.
      * @param value - The value to set.
      */
     setExportNamedRangeAnchors(value: boolean) : void;
     /**
      * @deprecated Please use the 'dataBarRenderMode' property instead.
-     * Indicates whether to display the DataBar as an image when saving to HTML..
-     * Default value is <see cref="DataBarRenderMode.BackgroundColor">.
-     * </summary>
+     * Represents the mode of how to render DataBar when converting Excel files to html files.
+     * Default value is <see cref="DataBarRenderMode.BackgroundColor"/>.
      */
     getDataBarRenderMode() : DataBarRenderMode;
     /**
-     * Indicates whether to display the DataBar as an image when saving to HTML..
-     * Default value is <see cref="DataBarRenderMode.BackgroundColor">.
-     * </summary>
+     * Represents the mode of how to render DataBar when converting Excel files to html files.
+     * Default value is <see cref="DataBarRenderMode.BackgroundColor"/>.
      */
     dataBarRenderMode : DataBarRenderMode;
     /**
      * @deprecated Please use the 'dataBarRenderMode' property instead.
-     * Indicates whether to display the DataBar as an image when saving to HTML..
-     * Default value is <see cref="DataBarRenderMode.BackgroundColor">.
-     * </summary>
+     * Represents the mode of how to render DataBar when converting Excel files to html files.
+     * Default value is <see cref="DataBarRenderMode.BackgroundColor"/>.
      * @param value - The value to set.
      */
     setDataBarRenderMode(value: DataBarRenderMode) : void;
@@ -49041,6 +49094,21 @@ export class PasteOptions {
      * @param value - The value to set.
      */
     setPasteType(value: PasteType) : void;
+    /**
+     * @deprecated Please use the 'shiftFormulasOfShapes' property instead.
+     * Indicates whether to shift formulas of the shapes when copying ranges.
+     */
+    getShiftFormulasOfShapes() : boolean;
+    /**
+     * Indicates whether to shift formulas of the shapes when copying ranges.
+     */
+    shiftFormulasOfShapes : boolean;
+    /**
+     * @deprecated Please use the 'shiftFormulasOfShapes' property instead.
+     * Indicates whether to shift formulas of the shapes when copying ranges.
+     * @param value - The value to set.
+     */
+    setShiftFormulasOfShapes(value: boolean) : void;
     /**
      * @deprecated Please use the 'skipBlanks' property instead.
      * Indicates whether skips blank cells.
@@ -50857,8 +50925,21 @@ export class SparklineCollection {
     /**
      * Removes the sparkline
      * @param o - 
+     * 
+     * @remarks
+     * NOTE: This member is now obsolete. Instead,
+     * please use RemoveSparkline() method.
+     * This method will be removed 6 months later since December 2025.
+     * Aspose apologizes for any inconvenience you may have experienced.
+     * @deprecated
+     * Use SparklineCollection.RemoveSparkline(Sparkline) method instead.
      */
     remove(o: Object) : void;
+    /**
+     * Removes the sparkline
+     * @param o - 
+     */
+    removeSparkline(o: Sparkline) : void;
     /**
      * Gets the number of elements contained in.
      */
@@ -53171,104 +53252,44 @@ export class Series {
     setValues(value: string) : void;
     /**
      * @deprecated Please use the 'pointValues' property instead.
-     * Represents the actual values that are used to plot every point in the chart.
-     * corresponding to <see cref="Series.Values"/>
-     * When Series.Values is a link, you can use this attribute to get specific data.
-     * <example>
-     * <code>
-     * [C#]
-     * Workbook workbook = new Workbook("YourFilePathName");
-     * Worksheet worksheet = workbook.Worksheets[0];
-     * Chart chart = worksheet.Charts[0];
-     * chart.Calculate();
-     * Values could be like "[External.xlsx]Sheet1!$A$1:$A$6",
-     * string Values = chart.NSeries[0].Values;
-     * But when you can't get point values from "[External.xlsx]Sheet1!$A$1:$A$6",
-     * For example, "External.xlsx" does not exist, then you can use PointValues,
-     * It will return the values actually displayed in the Excel interface in the form of an array.
-     * ChartDataValue[] v1 = chart.NSeries[0].PointValues;
-     * </code>
-     * </example>
+     * Gets the actual values that are used to plot every point
+     * of this series in the chart.
      * 
      * @remarks
-     * For user's convenience, this property provides the actual values corresponding
-     * to the data defined by <see cref="Series.Values"/>.
+     * This property provides one convenient way to get the actual values corresponding
+     * to the data defined by <see cref="Series.Values"/>,
+     * especially when the specified data source is external link, formula, ...etc.
      */
     getPointValues() : ChartDataValue[];
     /**
-     * Represents the actual values that are used to plot every point in the chart.
-     * corresponding to <see cref="Series.Values"/>
-     * When Series.Values is a link, you can use this attribute to get specific data.
-     * <example>
-     * <code>
-     * [C#]
-     * Workbook workbook = new Workbook("YourFilePathName");
-     * Worksheet worksheet = workbook.Worksheets[0];
-     * Chart chart = worksheet.Charts[0];
-     * chart.Calculate();
-     * Values could be like "[External.xlsx]Sheet1!$A$1:$A$6",
-     * string Values = chart.NSeries[0].Values;
-     * But when you can't get point values from "[External.xlsx]Sheet1!$A$1:$A$6",
-     * For example, "External.xlsx" does not exist, then you can use PointValues,
-     * It will return the values actually displayed in the Excel interface in the form of an array.
-     * ChartDataValue[] v1 = chart.NSeries[0].PointValues;
-     * </code>
-     * </example>
+     * Gets the actual values that are used to plot every point
+     * of this series in the chart.
      * 
      * @remarks
-     * For user's convenience, this property provides the actual values corresponding
-     * to the data defined by <see cref="Series.Values"/>.
+     * This property provides one convenient way to get the actual values corresponding
+     * to the data defined by <see cref="Series.Values"/>,
+     * especially when the specified data source is external link, formula, ...etc.
      */
     readonly pointValues : ChartDataValue[];
     /**
      * @deprecated Please use the 'categoryValues' property instead.
-     * Represents the actual category values that are used in the chart.
-     * corresponding to <see cref="Series.XValues"/>
-     * When Series.XValues is a link, you can use this attribute to get specific data.
-     * <example>
-     * <code>
-     * [C#]
-     * Workbook workbook = new Workbook("YourFilePathName");
-     * Worksheet worksheet = workbook.Worksheets[0];
-     * Chart chart = worksheet.Charts[0];
-     * chart.Calculate();
-     * XValues could be like "[External.xlsx]Sheet1!$B$2:$C$6",
-     * string XValues = chart.NSeries[0].XValues;
-     * But when you can't get category values from "[External.xlsx]Sheet1!$B$2:$C$6",
-     * For example, "External.xlsx" does not exist, then you can use CategoryValues,
-     * It will return the category values actually displayed in the Excel interface in the form of a two-dimensional array.
-     * ChartDataValue[][] v1 = chart.NSeries[0].CategoryValues;
-     * </code>
-     * </example>
+     * Gets the actual category values that are used to plot every point
+     * of this series in the chart.
      * 
      * @remarks
-     * For user's convenience, this property provides the actual values corresponding
-     * to the data defined by <see cref="Series.XValues"/>.
+     * This property provides one convenient way to get the actual values corresponding
+     * to the data defined by <see cref="Series.XValues"/>,
+     * especially when the specified data source is external link, formula, ...etc.
      */
     getCategoryValues() : ChartDataValue[][];
     /**
-     * Represents the actual category values that are used in the chart.
-     * corresponding to <see cref="Series.XValues"/>
-     * When Series.XValues is a link, you can use this attribute to get specific data.
-     * <example>
-     * <code>
-     * [C#]
-     * Workbook workbook = new Workbook("YourFilePathName");
-     * Worksheet worksheet = workbook.Worksheets[0];
-     * Chart chart = worksheet.Charts[0];
-     * chart.Calculate();
-     * XValues could be like "[External.xlsx]Sheet1!$B$2:$C$6",
-     * string XValues = chart.NSeries[0].XValues;
-     * But when you can't get category values from "[External.xlsx]Sheet1!$B$2:$C$6",
-     * For example, "External.xlsx" does not exist, then you can use CategoryValues,
-     * It will return the category values actually displayed in the Excel interface in the form of a two-dimensional array.
-     * ChartDataValue[][] v1 = chart.NSeries[0].CategoryValues;
-     * </code>
-     * </example>
+     * Gets the actual category values that are used to plot every point
+     * of this series in the chart.
      * 
      * @remarks
-     * For user's convenience, this property provides the actual values corresponding
-     * to the data defined by <see cref="Series.XValues"/>.
+     * This property provides one convenient way to get the actual values corresponding
+     * to the data defined by <see cref="Series.XValues"/>,
+     * especially when the specified data source is external link, formula, ...etc.
      */
     readonly categoryValues : ChartDataValue[][];
     /**
@@ -70102,8 +70123,23 @@ export class RangeCollection {
     /**
      * Adds a <see cref="Range"/> item to the collection.
      * @param range - Range object
+     * 
+     * @remarks
+     * NOTE: This member is now obsolete. Instead,
+     * please use AddRange() method.
+     * This method will be removed 6 months later since December 2025.
+     * Aspose apologizes for any inconvenience you may have experienced.
+     * @deprecated
+     * Use RangeCollection.AddRange(Range) method instead.
      */
     add(range: Range) : number;
+    /**
+     * Adds a <see cref="Range"/> item to the collection.
+     * @param range - the range to be added
+     * @returns
+     * index of the added range in this collection
+     */
+    addRange(range: Range) : number;
     /**
      * Gets the number of elements contained in.
      */