aspose.cells.node 25.9.0 → 25.10.0

package/aspose.cells.js

@@ -629,6 +629,12 @@ exports.SqlScriptOperatorType = {
     Delete : 2,
 };
 
+exports.SignificantDigitsType = {
+    Digits15 : 0,
+    G17 : 1,
+    Rounding17 : 2,
+};
+
 exports.Cells.prototype.importCSVAsync = async function(...args) {
     return new Promise((resolve, reject) => {
         queueMicrotask(() => {
@@ -12963,6 +12969,12 @@ Object.assign(exports.MarkdownSaveOptions.prototype, {
     setAlignColumnPadding(value) {
         this.alignColumnPadding = value;
     },
+    getSplitTablesByBlankRow() {
+        return this.splitTablesByBlankRow;
+    },
+    setSplitTablesByBlankRow(value) {
+        this.splitTablesByBlankRow = value;
+    },
     getSaveFormat() {
         return this.saveFormat;
     },
@@ -13776,6 +13788,12 @@ Object.assign(exports.WorkbookSettings.prototype, {
     setHidePivotFieldList(value) {
         this.hidePivotFieldList = value;
     },
+    getMaxUniqueItemsPerField() {
+        return this.maxUniqueItemsPerField;
+    },
+    setMaxUniqueItemsPerField(value) {
+        this.maxUniqueItemsPerField = value;
+    },
     getUpdateLinksType() {
         return this.updateLinksType;
     },
@@ -13872,11 +13890,11 @@ Object.assign(exports.WorkbookSettings.prototype, {
     setUpdateAdjacentCellsBorder(value) {
         this.updateAdjacentCellsBorder = value;
     },
-    getSignificantDigits() {
-        return this.significantDigits;
+    getSignificantDigitsType() {
+        return this.significantDigitsType;
     },
-    setSignificantDigits(value) {
-        this.significantDigits = value;
+    setSignificantDigitsType(value) {
+        this.significantDigitsType = value;
     },
     getCheckCompatibility() {
         return this.checkCompatibility;
@@ -16701,6 +16719,15 @@ Object.assign(exports.CalculationOptions.prototype, {
     setRecursive(value) {
         this.recursive = value;
     },
+    getUserSpecifiedRefreshDynamicArrayFormula() {
+        return this.userSpecifiedRefreshDynamicArrayFormula;
+    },
+    getRefreshDynamicArrayFormula() {
+        return this.refreshDynamicArrayFormula;
+    },
+    setRefreshDynamicArrayFormula(value) {
+        this.refreshDynamicArrayFormula = value;
+    },
     getCustomEngine() {
         return this.customEngine;
     },
@@ -29103,11 +29130,11 @@ Object.assign(exports.GroupShape.prototype, {
 });
 
 Object.assign(exports.CellsHelper, {
-    getSignificantDigits() {
-        return exports.CellsHelper.significantDigits;
+    getSignificantDigitsType() {
+        return exports.CellsHelper.significantDigitsType;
     },
-    setSignificantDigits(value) {
-        exports.CellsHelper.significantDigits = value;
+    setSignificantDigitsType(value) {
+        exports.CellsHelper.significantDigitsType = value;
     },
     getDPI() {
         return exports.CellsHelper.dPI;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aspose.cells.node",
-  "version": "25.9.0",
+  "version": "25.10.0",
   "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.9.0",
-    "aspose.cells.node.linux.x64": "~25.9.0",
-    "aspose.cells.node.linux.arm64": "~25.9.0",
-    "aspose.cells.node.darwin.x64": "~25.9.0",
-    "aspose.cells.node.darwin.arm64": "~25.9.0"
+    "aspose.cells.node.win32.x64": "~25.10.0",
+    "aspose.cells.node.linux.x64": "~25.10.0",
+    "aspose.cells.node.linux.arm64": "~25.10.0",
+    "aspose.cells.node.darwin.x64": "~25.10.0",
+    "aspose.cells.node.darwin.arm64": "~25.10.0"
   }
 }

package/types.d.ts

@@ -11405,6 +11405,40 @@ export class SettablePivotGlobalizationSettings {
     isNull() : boolean;
 }
 
+/**
+ * Represents the type of significant digits for outputing numeric values.
+ */
+export enum SignificantDigitsType {
+    /**
+     * 15-digits
+     */
+    Digits15 = 0,
+    /**
+     * 17-digits by formatting the value with "G17".
+     * 
+     * @remarks
+     * For some double values, "G17" may given different value than the
+     * original/literal one input by user.
+     * For example, double value 0.15 will be output as 0.14999999999999999;
+     * double value 1.0E-16 will be output as 9.9999999999999998E-17.
+     * Ms excel's handles those values inconsistently, it saves 0.15 as 0.15
+     * in the xlsx file, but for 1.0E-16 the saved value in the xlsx file is
+     * 9.9999999999999998E-17.
+     */
+    G17 = 1,
+    /**
+     * 17-digits by rounding the value.
+     * 
+     * @remarks
+     * This type generally outputs the value as the original/literal one input by user.
+     * For 0.15 it produces "0.15" and for 1.0E-16  it produces "1.0E-16".
+     * But there are also some special cases which may give different values than the literal.
+     * For example, when rounding 208435494.96478021 to 17-digits("0.#################"),
+     * the output is 208435494.96478.
+     */
+    Rounding17 = 2,
+}
+
 /**
  * Represents user's custom calculation engine to extend the default calculation engine of Aspose.Cells.
  * 
@@ -14757,30 +14791,36 @@ export class AbstractTextLoadOptions extends LoadOptions {
     /**
      * @deprecated Please use the 'convertNumericData' property instead.
      * Gets or sets a value that indicates whether the string in text file is converted to numeric data.
+     * Default value is true.
      */
     getConvertNumericData() : boolean;
     /**
      * Gets or sets a value that indicates whether the string in text file is converted to numeric data.
+     * Default value is true.
      */
     convertNumericData : boolean;
     /**
      * @deprecated Please use the 'convertNumericData' property instead.
      * Gets or sets a value that indicates whether the string in text file is converted to numeric data.
+     * Default value is true.
      * @param value - The value to set.
      */
     setConvertNumericData(value: boolean) : void;
     /**
      * @deprecated Please use the 'convertDateTimeData' property instead.
      * Gets or sets a value that indicates whether the string in text file is converted to date data.
+     * Default value is true.
      */
     getConvertDateTimeData() : boolean;
     /**
      * Gets or sets a value that indicates whether the string in text file is converted to date data.
+     * Default value is true.
      */
     convertDateTimeData : boolean;
     /**
      * @deprecated Please use the 'convertDateTimeData' property instead.
      * Gets or sets a value that indicates whether the string in text file is converted to date data.
+     * Default value is true.
      * @param value - The value to set.
      */
     setConvertDateTimeData(value: boolean) : void;
@@ -17156,18 +17196,18 @@ export class MarkdownSaveOptions extends SaveOptions {
     setCalculateFormula(value: boolean) : void;
     /**
      * @deprecated Please use the 'exportHyperlinkAsReference' property instead.
-     * Exports hyperlink using reference definitions instead of inline format.
+     * Indicates whether to export hyperlink using reference definitions instead of inline format.
      * The default value is false.
      */
     getExportHyperlinkAsReference() : boolean;
     /**
-     * Exports hyperlink using reference definitions instead of inline format.
+     * Indicates whether to export hyperlink using reference definitions instead of inline format.
      * The default value is false.
      */
     exportHyperlinkAsReference : boolean;
     /**
      * @deprecated Please use the 'exportHyperlinkAsReference' property instead.
-     * Exports hyperlink using reference definitions instead of inline format.
+     * Indicates whether to export hyperlink using reference definitions instead of inline format.
      * The default value is false.
      * @param value - The value to set.
      */
@@ -17193,6 +17233,24 @@ export class MarkdownSaveOptions extends SaveOptions {
      * @param value - The value to set.
      */
     setAlignColumnPadding(value: string) : void;
+    /**
+     * @deprecated Please use the 'splitTablesByBlankRow' property instead.
+     * Indicates whether blank rows in the worksheet should be treated as table separators when exporting to Markdown.
+     * The default value is false.
+     */
+    getSplitTablesByBlankRow() : boolean;
+    /**
+     * Indicates whether blank rows in the worksheet should be treated as table separators when exporting to Markdown.
+     * The default value is false.
+     */
+    splitTablesByBlankRow : boolean;
+    /**
+     * @deprecated Please use the 'splitTablesByBlankRow' property instead.
+     * Indicates whether blank rows in the worksheet should be treated as table separators when exporting to Markdown.
+     * The default value is false.
+     * @param value - The value to set.
+     */
+    setSplitTablesByBlankRow(value: boolean) : void;
     /**
      * Checks whether the implementation object is null.
      */
@@ -19674,6 +19732,10 @@ export class Workbook {
      * @param rawColor - Raw color.
      * @returns
      * Best matching color.
+     * 
+     * @remarks
+     * There are only 56 colors in the color palette in Excel 97-2003.
+     * If the color is not in the palette, the similar color will be set.
      */
     getMatchingColor(rawColor: Color) : Color;
     /**
@@ -20343,6 +20405,27 @@ export class WorkbookSettings {
      * @param value - The value to set.
      */
     setHidePivotFieldList(value: boolean) : void;
+    /**
+     * @deprecated Please use the 'maxUniqueItemsPerField' property instead.
+     * Gets and set the limitation of unique items per field
+     * 
+     * @remarks
+     */
+    getMaxUniqueItemsPerField() : number;
+    /**
+     * Gets and set the limitation of unique items per field
+     * 
+     * @remarks
+     */
+    maxUniqueItemsPerField : number;
+    /**
+     * @deprecated Please use the 'maxUniqueItemsPerField' property instead.
+     * Gets and set the limitation of unique items per field
+     * @param value - The value to set.
+     * 
+     * @remarks
+     */
+    setMaxUniqueItemsPerField(value: number) : void;
     /**
      * @deprecated Please use the 'updateLinksType' property instead.
      * Gets and sets how updates external links when the workbook is opened.
@@ -20623,32 +20706,23 @@ export class WorkbookSettings {
      */
     setUpdateAdjacentCellsBorder(value: boolean) : void;
     /**
-     * @deprecated Please use the 'significantDigits' property instead.
-     * Gets and sets the number of significant digits.
-     * The default value is <see cref="CellsHelper.SignificantDigits"/>.
-     * 
-     * @remarks
-     * Only could be 15 or 17 now.
+     * @deprecated Please use the 'significantDigitsType' property instead.
+     * Gets and sets the type of significant digits for outputing numeric
+     * values in this workbook. Default value is <see cref="CellsHelper.SignificantDigitsType"/>.
      */
-    getSignificantDigits() : number;
+    getSignificantDigitsType() : SignificantDigitsType;
     /**
-     * Gets and sets the number of significant digits.
-     * The default value is <see cref="CellsHelper.SignificantDigits"/>.
-     * 
-     * @remarks
-     * Only could be 15 or 17 now.
+     * Gets and sets the type of significant digits for outputing numeric
+     * values in this workbook. Default value is <see cref="CellsHelper.SignificantDigitsType"/>.
      */
-    significantDigits : number;
+    significantDigitsType : SignificantDigitsType;
     /**
-     * @deprecated Please use the 'significantDigits' property instead.
-     * Gets and sets the number of significant digits.
-     * The default value is <see cref="CellsHelper.SignificantDigits"/>.
+     * @deprecated Please use the 'significantDigitsType' property instead.
+     * Gets and sets the type of significant digits for outputing numeric
+     * values in this workbook. Default value is <see cref="CellsHelper.SignificantDigitsType"/>.
      * @param value - The value to set.
-     * 
-     * @remarks
-     * Only could be 15 or 17 now.
      */
-    setSignificantDigits(value: number) : void;
+    setSignificantDigitsType(value: SignificantDigitsType) : void;
     /**
      * @deprecated Please use the 'checkCompatibility' property instead.
      * Indicates whether check compatibility with earlier versions when saving workbook.
@@ -29230,6 +29304,71 @@ export class CalculationOptions {
      * @param value - The value to set.
      */
     setRecursive(value: boolean) : void;
+    /**
+     * @deprecated Please use the 'userSpecifiedRefreshDynamicArrayFormula' property instead.
+     * Indicates whether user has explicitly specified the behavior of
+     * refreshing dynamic array formulas before calculating specified formulas.
+     */
+    getUserSpecifiedRefreshDynamicArrayFormula() : boolean;
+    /**
+     * Indicates whether user has explicitly specified the behavior of
+     * refreshing dynamic array formulas before calculating specified formulas.
+     */
+    readonly userSpecifiedRefreshDynamicArrayFormula : boolean;
+    /**
+     * @deprecated Please use the 'refreshDynamicArrayFormula' property instead.
+     * Indicates whether dynamic array formulas should be refreshed
+     * before calculating formulas.
+     * 
+     * @remarks
+     * If this property has been specified explicitly, then the specified value
+     * will be used to determine whether refresh dynamic array formulas.
+     * Otherwise(<see cref="UserSpecifiedRefreshDynamicArrayFormula"/> is flase),
+     * the default value of it depends on what kind of formulas need to be calculated:
+     * For calculating formulas for the workbook,
+     * such as <see cref="Workbook.CalculateFormula(CalculationOptions)"/>,
+     * this property will be taken as true.
+     * For other cases, such as <see cref="Cell.Calculate(CalculationOptions)"/>
+     * or <see cref="Worksheet.CalculateFormula(CalculationOptions, bool)"/>,
+     * this property will be taken as false.
+     */
+    getRefreshDynamicArrayFormula() : boolean;
+    /**
+     * Indicates whether dynamic array formulas should be refreshed
+     * before calculating formulas.
+     * 
+     * @remarks
+     * If this property has been specified explicitly, then the specified value
+     * will be used to determine whether refresh dynamic array formulas.
+     * Otherwise(<see cref="UserSpecifiedRefreshDynamicArrayFormula"/> is flase),
+     * the default value of it depends on what kind of formulas need to be calculated:
+     * For calculating formulas for the workbook,
+     * such as <see cref="Workbook.CalculateFormula(CalculationOptions)"/>,
+     * this property will be taken as true.
+     * For other cases, such as <see cref="Cell.Calculate(CalculationOptions)"/>
+     * or <see cref="Worksheet.CalculateFormula(CalculationOptions, bool)"/>,
+     * this property will be taken as false.
+     */
+    refreshDynamicArrayFormula : boolean;
+    /**
+     * @deprecated Please use the 'refreshDynamicArrayFormula' property instead.
+     * Indicates whether dynamic array formulas should be refreshed
+     * before calculating formulas.
+     * @param value - The value to set.
+     * 
+     * @remarks
+     * If this property has been specified explicitly, then the specified value
+     * will be used to determine whether refresh dynamic array formulas.
+     * Otherwise(<see cref="UserSpecifiedRefreshDynamicArrayFormula"/> is flase),
+     * the default value of it depends on what kind of formulas need to be calculated:
+     * For calculating formulas for the workbook,
+     * such as <see cref="Workbook.CalculateFormula(CalculationOptions)"/>,
+     * this property will be taken as true.
+     * For other cases, such as <see cref="Cell.Calculate(CalculationOptions)"/>
+     * or <see cref="Worksheet.CalculateFormula(CalculationOptions, bool)"/>,
+     * this property will be taken as false.
+     */
+    setRefreshDynamicArrayFormula(value: boolean) : void;
     /**
      * @deprecated Please use the 'customEngine' property instead.
      * The custom formula calculation engine to extend the default calculation engine of Aspose.Cells.
@@ -53632,39 +53771,51 @@ export enum AutoShapeType {
      */
     CurvedConnector5 = 40,
     /**
+     * Specifies the "Line Callout 2(No Border)" type of the Ms Excel 97-2003 version or the "Callout: Line with No Border" type of the Ms Excel 2007 version.
      */
     LineCalloutNoBorder2 = 41,
     /**
+     * Specifies the "Line Callout 3(No Border)" type of the Ms Excel 97-2003 version or the "Callout: Bent Line with No Border" type of the Ms Excel 2007 version.
      */
     LineCalloutNoBorder3 = 42,
     /**
+     * Specifies the "Line Callout 4(No Border)" type of the Ms Excel 97-2003 version or the "Callout: Double Bent Line with No Border" type of the Ms Excel 2007 version.
      */
     LineCalloutNoBorder4 = 43,
     /**
+     * Specifies the "Line Callout 2(Accent Bar)" type of the Ms Excel 97-2003 version or the "Callout: Line with Accent Bar" type of the Ms Excel 2007 version.
      */
     LineCalloutWithAccentBar2 = 44,
     /**
+     * Specifies the "Line Callout 3(Accent Bar)" type of the Ms Excel 97-2003 version or the "Callout: Bent Line with Accent Bar" type of the Ms Excel 2007 version.
      */
     LineCalloutWithAccentBar3 = 45,
     /**
+     * Specifies the "Line Callout 4(Accent Bar)" type of the Ms Excel 97-2003 version or the "Callout: Double Bent Line with Accent Bar" type of the Ms Excel 2007 version.
      */
     LineCalloutWithAccentBar4 = 46,
     /**
+     * Specifies the "Line Callout 2" type of the Ms Excel 97-2003 version or the "Callout: Line" type of the Ms Excel 2007 version.
      */
     LineCalloutWithBorder2 = 47,
     /**
+     * Specifies the "Line Callout 3" type of the Ms Excel 97-2003 version or the "Callout: Bent Line" type of the Ms Excel 2007 version.
      */
     LineCalloutWithBorder3 = 48,
     /**
+     * Specifies the "Line Callout 4" type of the Ms Excel 97-2003 version or the "Callout: Double Bent Line" type of the Ms Excel 2007 version.
      */
     LineCalloutWithBorder4 = 49,
     /**
+     * Specifies the "Line Callout 2(Border and Accent Bar)" type of the Ms Excel 97-2003 version or the "Callout: Line with Border and Accent Bar" type of the Ms Excel 2007 version.
      */
     LineCalloutWithBorderAndAccentBar2 = 50,
     /**
+     * Specifies the "Line Callout 3(Border and Accent Bar)" type of the Ms Excel 97-2003 version or the "Callout: Bent Line with Border and Accent Bar" type of the Ms Excel 2007 version.
      */
     LineCalloutWithBorderAndAccentBar3 = 51,
     /**
+     * Specifies the "Line Callout 4(Border and Accent Bar)" type of the Ms Excel 97-2003 version or the "Callout: Double Bent Line with Border and Accent Bar" type of the Ms Excel 2007 version.
      */
     LineCalloutWithBorderAndAccentBar4 = 52,
     /**
@@ -54084,15 +54235,19 @@ export enum AutoShapeType {
      */
     FlowChartOffpageConnector = 177,
     /**
+     * Specifies the "Line Callout 1(No Border)" type of the Ms Excel 97-2003 version.
      */
     LineCalloutNoBorder1 = 178,
     /**
+     * Specifies the "Line Callout 1(Accent Bar)" type of the Ms Excel 97-2003 version.
      */
     LineCalloutWithAccentBar1 = 179,
     /**
+     * Specifies the "Line Callout 1" type of the Ms Excel 97-2003 version.
      */
     LineCalloutWithBorder1 = 180,
     /**
+     * Specifies the "Line Callout 1(Border and Accent Bar)" type of the Ms Excel 97-2003 version.
      */
     LineCalloutWithBorderAndAccentBar1 = 181,
     /**
@@ -61065,11 +61220,13 @@ export class CustomDocumentPropertyCollection extends DocumentPropertyCollection
      */
     addLinkToContent(name: string, source: string) : DocumentProperty;
     /**
-     * Update custom document property value which links to content.
+     * Updates values of all custom properties that are linked to content(use
+     * cell value of linked range to update value of custom property).
      */
     updateLinkedPropertyValue() : void;
     /**
-     * Update custom document property value to linked range.
+     * Updates all ranges that are linked to custom properties(use the value of
+     * custom document property to update cell value of linked range).
      */
     updateLinkedRange() : void;
     /**
@@ -63482,32 +63639,23 @@ export class GroupShape extends Shape {
  */
 export class CellsHelper {
     /**
-     * @deprecated Please use the 'significantDigits' property instead.
-     * Gets and sets the number of significant digits.
-     * The default value is 17.
-     * 
-     * @remarks
-     * Only could be 15 or 17 now.
+     * @deprecated Please use the 'significantDigitsType' property instead.
+     * Gets and sets the default type of significant digits for outputing numeric values.
+     * Default value is <see cref="SignificantDigitsType.G17"/>.
      */
-    static getSignificantDigits() : number;
+    static getSignificantDigitsType() : SignificantDigitsType;
     /**
-     * Gets and sets the number of significant digits.
-     * The default value is 17.
-     * 
-     * @remarks
-     * Only could be 15 or 17 now.
+     * Gets and sets the default type of significant digits for outputing numeric values.
+     * Default value is <see cref="SignificantDigitsType.G17"/>.
      */
-    static significantDigits : number;
+    static significantDigitsType : SignificantDigitsType;
     /**
-     * @deprecated Please use the 'significantDigits' property instead.
-     * Gets and sets the number of significant digits.
-     * The default value is 17.
+     * @deprecated Please use the 'significantDigitsType' property instead.
+     * Gets and sets the default type of significant digits for outputing numeric values.
+     * Default value is <see cref="SignificantDigitsType.G17"/>.
      * @param value - The value to set.
-     * 
-     * @remarks
-     * Only could be 15 or 17 now.
      */
-    static setSignificantDigits(value: number) : void;
+    static setSignificantDigitsType(value: SignificantDigitsType) : void;
     /**
      * @deprecated Please use the 'dPI' property instead.
      * Gets the DPI of the machine.