aspose.cells 24.6.0 → 24.7.0

package/README.md

@@ -1,17 +1,13 @@
-Aspose.Cells for Node.js via Java is a scalable and feature-rich API to create, process, manipulate & convert Excel & OpenOffice spreadsheets using Node.js. API offers Excel file generation, conversion, worksheets styling, Pivot Table & chart management & rendering, reliable formula calculation engine and much more - all without any dependency on Office Automation or Microsoft Excel®.
-
-## Node.js Spreadsheet API Features 
-- Generate Excel files via API or using templates.
-- Create Pivot Tables, charts, sparklines & conditional formatting rules on-the-fly.
-- Refresh existing charts & convert charts to images or PDF.
-- Create & manipulate comments & hyperlinks.
-- Set complex formulas & calculate results via API.
-- Set protection on workbooks, worksheets, cells, columns or rows.
-- Create & manipulate named ranges.
-- Populate worksheets through Smart Markers.
-- Manipulate & refresh Pivot Tables via API.
-- Convert worksheets to PDF, XPS & SVG formats.
-- Inter-convert files to popular Excel formats.
+Aspose.Cells for Node.js via C++ is a powerful and robust library designed for high-performance spreadsheet manipulation and management within Node.js applications. It offers a comprehensive set of features that enable developers to create, edit, convert, and render Excel files programmatically. Supporting all major Excel formats, including XLS, XLSX, XLSM, and more, it ensures compatibility and flexibility. This makes Aspose.Cells for Node.js via C++ a versatile tool for a wide range of data processing and management tasks, providing developers with a complete and efficient solution for integrating comprehensive Excel functionality into their Node.js applications.
+
+## Key features
+- **File Creation and Editing:** Create new spreadsheets from scratch or edit existing ones with ease. This includes adding or modifying data, formatting cells, managing worksheets, and more.
+- **Data Processing:** Perform complex data manipulations such as sorting, filtering, and validation. The library also supports advanced formulas and functions to facilitate data analysis and calculations.
+- **File Conversion**: Convert Excel files to various formats such as PDF, HTML, ODS, and image formats like PNG and JPEG. This feature is useful for sharing and distributing spreadsheet data in different formats.
+- **Chart and Graphics**: Create and customize a wide range of charts and graphics to visually represent data. The library supports bar charts, line charts, pie charts, and many more, along with customization options for design and layout.
+- **Rendering and Printing**: Render Excel sheets to high-fidelity images and PDFs, ensuring that the visual representation is accurate. The library also provides options for printing spreadsheets with precise control over page layout and formatting.
+- **Advanced Protection and Security**: Protect spreadsheets with passwords, encrypt files, and manage access permissions to ensure data security and integrity.
+- **Performance and Scalability**: Designed to handle large datasets and complex spreadsheets efficiently, Aspose.Cells for Node.js via C++ ensures high performance and scalability for enterprise-level applications.
 
 ## Read & Write Excel Files
 **Microsoft Excel:** XLS, XLSX, XLSB, XLTX, XLTM, XLSM, XML
@@ -24,62 +20,67 @@ Aspose.Cells for Node.js via Java is a scalable and feature-rich API to create,
 **Images:** JPEG, PNG, BMP, SVG, TIFF, GIF, EMF
 **Text:** CSV, Tab-Delimited, JSON, SQL, XML
 
-## Getting Started with Aspose.Cells for Nodejs via Java
+## Support multiple operating systems and CPU architectures, including:
+- **Windows x64**
+- **Linux x64**
+- **macOS x64 & arm64**
+
+## Getting Started with Aspose.Cells for Node.js via C++
 ### Installation
 
 From the command line:
 
 	npm install aspose.cells --save
 	
-### Create Excel XLSX File from Scratch using Node.js
+### Create Excel XLSX File from Scratch
 ``` js
-var aspose = aspose || {};
-aspose.cells = require("aspose.cells");
+const AsposeCells = require("aspose.cells");
 
-var workbook = new aspose.cells.Workbook(aspose.cells.FileFormatType.XLSX);
-workbook.getWorksheets().get(0).getCells().get("A1").putValue("testing...");
-workbook.save("output.xlsx");
+var workbook = new AsposeCells.Workbook(AsposeCells.FileFormatType.Xlsx);
+workbook.getWorksheets().get(0).getCells().get("A1").putValue("Hello World");
+workbook.save("hello-world.xlsx");
 ```
 
-### Convert Excel XLSX File to PDF using Node.js
+### Convert Excel XLSX File to PDF
 ``` js
-var aspose = aspose || {};
-aspose.cells = require("aspose.cells");
+const { Workbook } = require("aspose.cells");
 
-var workbook = new aspose.cells.Workbook("example.xlsx");
-var saveOptions = aspose.cells.PdfSaveOptions();
-saveOptions.setOnePagePerSheet(true);
-workbook.save("example.pdf", saveOptions);
+var workbook = new Workbook("example.xlsx");
+workbook.save("pdf-example.pdf");
 ```
 
-### Format Excel Cells via Node.js
+### Format Excel Cells
 ```js
-var aspose = aspose || {};
-aspose.cells = require("aspose.cells");
+const { Workbook, Color } = require("aspose.cells");
 
-var excel = new aspose.cells.Workbook();
-var style = excel.createStyle();
+var workbook = new Workbook();
+var style = workbook.createStyle();
 style.getFont().setName("Times New Roman");
-style.getFont().setColor(aspose.cells.Color.getBlue());
-for (var i = 0; i < 100; i++)
-{
-    excel.getWorksheets().get(0).getCells().get(0, i).setStyle(style);
+var blue = new Color(0, 0, 0xff);
+style.getFont().setColor(blue);
+for (var i = 0; i < 10; i++) {
+    var cell = workbook.getWorksheets().get(0).getCells().get(0, i);
+    cell.putValue(i);
+    cell.setStyle(style);
 }
+workbook.save("style-example.xlsx");
 ```
 
-### Add Picture to Excel Worksheet with Node.js
+### Add Picture to Excel Worksheet
 ```js
-var aspose = aspose || {};
-aspose.cells = require("aspose.cells");
+const { Workbook, SaveFormat } = require("aspose.cells");
 
-var workbook = new aspose.cells.Workbook();
+var workbook = new Workbook();
 var sheetIndex = workbook.getWorksheets().add();
 var worksheet = workbook.getWorksheets().get(sheetIndex);
 
 // adding a picture at "F6" cell
 worksheet.getPictures().add(5, 5, "image.gif");
 
-workbook.save("output.xls", aspose.cells.SaveFormat.EXCEL_97_TO_2003);
+workbook.save("picture-example.xls", SaveFormat.Excel97To2003);
 ```
 
-[Product Page](https://products.aspose.com/cells/nodejs-java) | [Product Documentation](https://docs.aspose.com/display/cellsnodejsjava/Aspose.Cells+for+Node.js+via+Java+Home) | [Blog](https://blog.aspose.com/category/cells/) |[API Reference](https://apireference.aspose.com/cells/nodejs) | [Source Code Samples](https://github.com/aspose-cells/Aspose.Cells-for-Java) | [Free Support](https://forum.aspose.com/c/cells) | [Temporary License](https://purchase.aspose.com/temporary-license)
+# Note
+Starting from v24.7.0, Aspose.Cells for Node.js via Java has been migrated to [aspose.cells.java](https://www.npmjs.com/package/aspose.cells.java).
+
+[Product Page](https://products.aspose.com/cells/nodejs-cpp) | [Product Documentation](https://docs.aspose.com/cells/nodejs-cpp/) | [Blog](https://blog.aspose.com/categories/aspose.cells-product-family/) |[API Reference](https://reference.aspose.com/cells/nodejs-cpp) | [Free Support](https://forum.aspose.com/c/cells) | [Temporary License](https://purchase.aspose.com/temporary-license)

package/download-aspose.cells.js

@@ -0,0 +1,22 @@
+'use strict';
+
+const { spawnSync } = require('child_process');
+
+const args = ['install', '--fallback-to-build=false'];
+if (process.platform == "linux") {
+    let regex = /^(\d+)\./;
+    let match = process.versions.openssl.match(regex);
+    let major = match ? match[1] : null;
+    if (major == '1') {
+        args.push('--toolset=-legacy');
+    }
+}
+
+let { status } = spawnSync('node-pre-gyp', args, {
+    shell: true,
+    stdio: 'inherit'
+});
+
+if (status) {
+    process.exit(1);
+}

package/package.json

@@ -1,11 +1,20 @@
 {
   "name": "aspose.cells",
-  "version": "24.6.0",
-  "description": "A powerful library for manipulating and converting Excel (XLS, XLSX, XLSB), ODS, CSV and HTML files.",
-  "main": "index.js",
+  "version": "24.7.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": "./lib/aspose.cells.js",
+  "types": "./lib/types.d.ts",
+  "binary": {
+    "module_name": "aspose.cells.nodejs",
+    "module_path": "./lib",
+    "remote_path": "./aspose-cells/aspose.cells-for-nodejs/releases/download/v{version}",
+    "package_name": "{module_name}-v{version}-{platform}{toolset}-{arch}.tar.gz",
+    "host": "https://github.com/"
+  },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "install": "node download-aspose.cells.js"
   },
+  "engines" : { "node" : ">=12" },
   "keywords": [
     "Excel",
     "XLS",
@@ -32,11 +41,9 @@
     "XML"
   ],
   "author": "Aspose",
-  "license": "End User License Agreement.html",
+  "license": "Commercial",
+  "homepage": "https://www.aspose.com",
   "dependencies": {
-    "java": ">=0.14.0"
-  },
-  "directories": {
-    "lib": "lib"
+    "@mapbox/node-pre-gyp": "^1.0.11"
   }
-}
+}

package/index.js

@@ -1,2 +0,0 @@
-
-module.exports = require("./lib/aspose.cells");