aspose.cells.node 25.12.0 → 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.0",
+  "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.0",
-    "aspose.cells.node.linux.x64": "~25.12.0",
-    "aspose.cells.node.linux.arm64": "~25.12.0",
-    "aspose.cells.node.darwin.x64": "~25.12.0",
-    "aspose.cells.node.darwin.arm64": "~25.12.0"
+    "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 {
     /**
@@ -24626,6 +24674,20 @@ export class PivotField {
      * @param value - The value to set.
      */
     setShowCompact(value: boolean) : void;
+    /**
+     * Gets the max value of this field.
+     * 
+     * @remarks
+     * Only works for row or column fields which value must be date time, number or blank.
+     */
+    getMaxValue() : CellValue;
+    /**
+     * Gets the max value of this field.
+     * 
+     * @remarks
+     * Only works for row or column fields which value must be date time, number or blank.
+     */
+    getMinValue() : CellValue;
     /**
      * Init the pivot items of the pivot field
      */
@@ -24636,6 +24698,13 @@ export class PivotField {
      * @param newField - Indicates whether adding a new field to the pivottable.
      */
     groupBy(interval: number, newField: boolean) : void;
+    /**
+     * Automatically group the field with internal
+     * @param groups - Group types
+     * @param interval - The internal of group.           /// Automatic value will be assigned if it's zero,
+     * @param newField - Indicates whether adding a new field to the pivottable.
+     */
+    groupBy(groups: PivotGroupByType[], interval: number, newField: boolean) : void;
     /**
      * Group the file by the date group types.
      * @param start - The start datetime
@@ -24647,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
@@ -24655,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.
@@ -32945,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
@@ -33579,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.
      */
@@ -34321,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;
     /**
@@ -36146,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
  */
@@ -36294,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.
@@ -40269,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.
@@ -48530,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;
@@ -49020,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.
@@ -50836,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.
      */
@@ -53124,34 +53226,70 @@ export class Series {
     /**
      * @deprecated Please use the 'values' property instead.
      * Represents the Y values of this chart series.
+     * 
+     * @remarks
+     * To get the actual values(corresponding to every point of this series) defined
+     * by this property, please use <see cref="PointValues"/>.
      */
     getValues() : string;
     /**
      * Represents the Y values of this chart series.
+     * 
+     * @remarks
+     * To get the actual values(corresponding to every point of this series) defined
+     * by this property, please use <see cref="PointValues"/>.
      */
     values : string;
     /**
      * @deprecated Please use the 'values' property instead.
      * Represents the Y values of this chart series.
      * @param value - The value to set.
+     * 
+     * @remarks
+     * To get the actual values(corresponding to every point of this series) defined
+     * by this property, please use <see cref="PointValues"/>.
      */
     setValues(value: string) : void;
     /**
      * @deprecated Please use the 'pointValues' property instead.
-     * Gets the values for the points of the series
+     * Gets the actual values that are used to plot every point
+     * of this series in the chart.
+     * 
+     * @remarks
+     * 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[];
     /**
-     * Gets the values for the points of the series
+     * Gets the actual values that are used to plot every point
+     * of this series in the chart.
+     * 
+     * @remarks
+     * 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.
-     * Gets the category values of the series
+     * Gets the actual category values that are used to plot every point
+     * of this series in the chart.
+     * 
+     * @remarks
+     * 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[][];
     /**
-     * Gets the category values of the series
+     * Gets the actual category values that are used to plot every point
+     * of this series in the chart.
+     * 
+     * @remarks
+     * 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[][];
     /**
@@ -53186,17 +53324,29 @@ export class Series {
     setXValuesFormatCode(value: string) : void;
     /**
      * @deprecated Please use the 'xValues' property instead.
-     * Represents the x values of the chart series.
+     * Represents the X values of this chart series.
+     * 
+     * @remarks
+     * To get the actual values(corresponding to every point of this series) defined
+     * by this property, please use <see cref="CategoryValues"/>.
      */
     getXValues() : string;
     /**
-     * Represents the x values of the chart series.
+     * Represents the X values of this chart series.
+     * 
+     * @remarks
+     * To get the actual values(corresponding to every point of this series) defined
+     * by this property, please use <see cref="CategoryValues"/>.
      */
     xValues : string;
     /**
      * @deprecated Please use the 'xValues' property instead.
-     * Represents the x values of the chart series.
+     * Represents the X values of this chart series.
      * @param value - The value to set.
+     * 
+     * @remarks
+     * To get the actual values(corresponding to every point of this series) defined
+     * by this property, please use <see cref="CategoryValues"/>.
      */
     setXValues(value: string) : void;
     /**
@@ -69973,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.
      */