@nazarkalytiuk/rusc-xlsx 1.0.8 → 1.0.10

package/README.md

@@ -116,12 +116,13 @@ const worksheet = workbook.addWorksheetWithConstantMemory('Large');
 - **Memory**: Constant ~0.02 MB (regardless of size!)
 - **Limitations**: Sequential row writing only, no tables
 
-> **Important:** For large exports, use `addWorksheetWithConstantMemory()` with `save(filename)` — not `saveToBuffer()`. The constant memory mode flushes rows to temp files as they're written, but `saveToBuffer()` would load the entire result back into memory, defeating the purpose. Use `saveToStream()` if you need to pipe the output without disk I/O overhead.
+> **Important:** For large exports, use `save(filename)` or `await saveToStream(writable)` instead of `saveToBuffer()`. `saveToStream()` is temp-file-backed: it saves to the operating system's temporary directory, pipes the file into the writable, waits for completion, and removes the temporary file. It avoids buffering the entire XLSX file in JavaScript memory, but it does use temporary disk I/O.
 
 **Example: 1 million rows**
 ```javascript
 const workbook = new Workbook();
 const worksheet = workbook.addWorksheetWithConstantMemory('Data');
+worksheet.setDefaultRowHeight(15.001); // Set once instead of once per row
 
 for (let row = 0; row < 1000000; row++) {
   worksheet.write(row, 0, `Row ${row}`);
@@ -170,16 +171,17 @@ workbook.save('output.xlsx');
 - `setTempdir(path)` - Set temp directory for memory modes
 - `save(filename)` - Save to file
 - `saveToBuffer()` - Save to Buffer
+- `saveToStream(writable)` - Save through a temp file and await stream completion
 - `defineName(name, formula)` - Define named range
 - `readOnlyRecommended()` - Mark as read-only recommended
 - `addVbaProject(path)` - Add VBA macros
 - `setProperties(props)` - Set document metadata
 
-### Worksheet (96 methods)
+### Worksheet
 - **Writing**: `write()`, `writeString()`, `writeNumber()`, `writeBoolean()`, `writeBlank()`
 - **DateTime**: `writeDatetime()`, `writeDatetimeFromTimestamp()`, `writeDatetimeFromYmd()`, etc.
 - **Formulas**: `writeFormula()`, `writeArrayFormula()`, `writeDynamicFormula()`
-- **Layout**: `setColumnWidth()`, `setRowHeight()`, `mergeRange()`, `setName()`
+- **Layout**: `setColumnWidth()`, `setRowHeight()`, `setDefaultRowHeight()`, `mergeRange()`, `setName()`
 - **Features**: `insertNote()`, `addDataValidation()`, `insertChart()`, `insertImage()`, `addTable()`, `insertButton()`, `insertShape()`
 - **Conditional Formatting**: 14 methods for all rule types
 - **Page Setup**: 26 methods for printing, margins, headers, etc.
@@ -281,6 +283,58 @@ Built with Rust and NAPI-RS for native-level performance:
 - **> 100K rows**: Constant memory mode (minimal footprint)
 - **Serverless/Cloud**: Low or constant memory modes
 
+### Pure Rust vs Node.js Benchmark
+
+Run an apples-to-apples comparison between direct `rust_xlsxwriter` calls and
+this package through N-API:
+
+```bash
+npm run benchmark
+```
+
+The default workload generates exactly 200,000 rows × 20 columns (4 million
+cells), split evenly between strings and numbers, in constant-memory mode. It
+builds both implementations in release mode, alternates their execution order
+across three runs, reports median throughput and peak RSS, and verifies that
+both worksheets have identical XML size and CRC.
+
+Override the workload or reuse existing release builds:
+
+```bash
+npm run benchmark -- --rows 100000 --columns 20 --runs 5
+npm run benchmark -- --skip-build
+```
+
+The default comparison uses `worksheet.write()` once per cell. To measure the
+lower-overhead bulk APIs, use row-by-row or bounded batches:
+
+```bash
+npm run benchmark -- --node-write-mode row
+npm run benchmark -- --node-write-mode batch --batch-rows 1000
+```
+
+`writeRows()` in bounded batches is the fastest option for large datasets.
+Larger batches reduce JavaScript-to-Rust calls but temporarily retain more
+JavaScript values, so tune `--batch-rows` for the available memory.
+
+For database cursors and other row-by-row streams, use `writeRow()` so each
+cursor item crosses the JavaScript-to-Rust boundary once:
+
+```javascript
+let rowIndex = 0
+for await (const item of cursor) {
+  worksheet.writeRow(rowIndex++, 0, [
+    item.id,
+    item.name,
+    item.amount,
+    item.status,
+  ])
+}
+```
+
+This keeps memory bounded to the current cursor item while retaining
+constant-memory worksheet generation.
+
 ## Limitations
 
 - ❌ **Read-only**: Cannot read existing Excel files (rust_xlsxwriter is write-only)

package/index.d.ts

@@ -438,14 +438,18 @@ export declare class RuscWorksheet {
   write(row: number, col: number, value: string | number | boolean, format?: RuscFormat | undefined | null): void
   /**
    * Write an array of values as a row starting at the given column.
-   * Uses lazy iteration — reads one cell at a time from JS, null/undefined skipped.
+   * Uses lazy Array iteration — reads one cell at a time from the JS array
+   * instead of deserializing the entire row into Rust memory.
+   * Null/undefined values are skipped (preserving column positions).
    */
-  writeRow(row: number, startCol: number, values: Array<string | number | boolean | null | undefined>, format?: RuscFormat | undefined | null): void
+  writeRow(row: number, startCol: number, values: unknown[], format?: RuscFormat | undefined | null): void
   /**
    * Write a 2D array of values starting at the given position.
-   * Uses lazy iteration — never materializes the entire grid in Rust memory.
+   * Uses lazy Array iteration — reads one row/cell at a time from JS,
+   * never materializing the entire grid in Rust memory.
+   * Null/undefined values are skipped (preserving column positions).
    */
-  writeRows(startRow: number, startCol: number, rows: Array<Array<string | number | boolean | null | undefined>>, format?: RuscFormat | undefined | null): void
+  writeRows(startRow: number, startCol: number, rows: unknown[], format?: RuscFormat | undefined | null): void
   /** Write a string to a cell */
   writeString(row: number, col: number, value: string): void
   /** Write a number to a cell */
@@ -472,6 +476,8 @@ export declare class RuscWorksheet {
   setColumnWidth(col: number, width: number): void
   /** Set the height of a row */
   setRowHeight(row: number, height: number): void
+  /** Set the default height for all worksheet rows efficiently */
+  setDefaultRowHeight(height: number): void
   /** Set the name of the worksheet */
   setName(name: string): void
   /** Merge a range of cells */
@@ -607,3 +613,9 @@ export declare class RuscWorksheet {
   /** Insert a shape (textbox) at the specified cell position with pixel offsets */
   insertShapeWithOffset(row: number, col: number, shape: RuscShape, xOffset: number, yOffset: number): void
 }
+
+/** Resets peak memory tracking to current usage */
+export declare function rustMemoryResetPeak(): void
+
+/** Returns [currentBytes, peakBytes] of Rust allocator usage */
+export declare function rustMemoryStats(): Array<number>

package/index.js

@@ -77,8 +77,8 @@ function requireNative() {
       try {
         const binding = require('@nazarkalytiuk/rusc-xlsx-android-arm64')
         const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-android-arm64/package.json').version
-        if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -93,8 +93,8 @@ function requireNative() {
       try {
         const binding = require('@nazarkalytiuk/rusc-xlsx-android-arm-eabi')
         const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -114,8 +114,8 @@ function requireNative() {
       try {
         const binding = require('@nazarkalytiuk/rusc-xlsx-win32-x64-gnu')
         const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -130,8 +130,8 @@ function requireNative() {
       try {
         const binding = require('@nazarkalytiuk/rusc-xlsx-win32-x64-msvc')
         const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -147,8 +147,8 @@ function requireNative() {
       try {
         const binding = require('@nazarkalytiuk/rusc-xlsx-win32-ia32-msvc')
         const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -163,8 +163,8 @@ function requireNative() {
       try {
         const binding = require('@nazarkalytiuk/rusc-xlsx-win32-arm64-msvc')
         const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -182,8 +182,8 @@ function requireNative() {
     try {
       const binding = require('@nazarkalytiuk/rusc-xlsx-darwin-universal')
       const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -198,8 +198,8 @@ function requireNative() {
       try {
         const binding = require('@nazarkalytiuk/rusc-xlsx-darwin-x64')
         const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -214,8 +214,8 @@ function requireNative() {
       try {
         const binding = require('@nazarkalytiuk/rusc-xlsx-darwin-arm64')
         const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -234,8 +234,8 @@ function requireNative() {
       try {
         const binding = require('@nazarkalytiuk/rusc-xlsx-freebsd-x64')
         const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -250,8 +250,8 @@ function requireNative() {
       try {
         const binding = require('@nazarkalytiuk/rusc-xlsx-freebsd-arm64')
         const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -271,8 +271,8 @@ function requireNative() {
         try {
           const binding = require('@nazarkalytiuk/rusc-xlsx-linux-x64-musl')
           const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -287,8 +287,8 @@ function requireNative() {
         try {
           const binding = require('@nazarkalytiuk/rusc-xlsx-linux-x64-gnu')
           const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -305,8 +305,8 @@ function requireNative() {
         try {
           const binding = require('@nazarkalytiuk/rusc-xlsx-linux-arm64-musl')
           const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -321,8 +321,8 @@ function requireNative() {
         try {
           const binding = require('@nazarkalytiuk/rusc-xlsx-linux-arm64-gnu')
           const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -339,8 +339,8 @@ function requireNative() {
         try {
           const binding = require('@nazarkalytiuk/rusc-xlsx-linux-arm-musleabihf')
           const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -355,8 +355,8 @@ function requireNative() {
         try {
           const binding = require('@nazarkalytiuk/rusc-xlsx-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -373,8 +373,8 @@ function requireNative() {
         try {
           const binding = require('@nazarkalytiuk/rusc-xlsx-linux-loong64-musl')
           const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -389,8 +389,8 @@ function requireNative() {
         try {
           const binding = require('@nazarkalytiuk/rusc-xlsx-linux-loong64-gnu')
           const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -407,8 +407,8 @@ function requireNative() {
         try {
           const binding = require('@nazarkalytiuk/rusc-xlsx-linux-riscv64-musl')
           const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -423,8 +423,8 @@ function requireNative() {
         try {
           const binding = require('@nazarkalytiuk/rusc-xlsx-linux-riscv64-gnu')
           const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -440,8 +440,8 @@ function requireNative() {
       try {
         const binding = require('@nazarkalytiuk/rusc-xlsx-linux-ppc64-gnu')
         const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -456,8 +456,8 @@ function requireNative() {
       try {
         const binding = require('@nazarkalytiuk/rusc-xlsx-linux-s390x-gnu')
         const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -476,8 +476,8 @@ function requireNative() {
       try {
         const binding = require('@nazarkalytiuk/rusc-xlsx-openharmony-arm64')
         const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -492,8 +492,8 @@ function requireNative() {
       try {
         const binding = require('@nazarkalytiuk/rusc-xlsx-openharmony-x64')
         const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -508,8 +508,8 @@ function requireNative() {
       try {
         const binding = require('@nazarkalytiuk/rusc-xlsx-openharmony-arm')
         const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '1.0.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 1.0.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '1.0.10' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 1.0.10 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -588,3 +588,5 @@ module.exports.RuscTable = nativeBinding.RuscTable
 module.exports.RuscTableColumn = nativeBinding.RuscTableColumn
 module.exports.RuscWorkbook = nativeBinding.RuscWorkbook
 module.exports.RuscWorksheet = nativeBinding.RuscWorksheet
+module.exports.rustMemoryResetPeak = nativeBinding.rustMemoryResetPeak
+module.exports.rustMemoryStats = nativeBinding.rustMemoryStats

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nazarkalytiuk/rusc-xlsx",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "Fast Excel XLSX library for Node.js powered by rust_xlsxwriter",
   "main": "wrapper.js",
   "types": "wrapper.d.ts",
@@ -32,6 +32,7 @@
     "artifacts": "napi artifacts",
     "build": "napi build --platform --release",
     "build:debug": "napi build --platform",
+    "benchmark": "node benchmarks/compare-generation.js",
     "prepublishOnly": "napi prepublish -t npm",
     "test": "jest",
     "universal": "napi universalize",
@@ -61,6 +62,7 @@
     "@napi-rs/cli": "^3.0.0",
     "@types/jest": "^29.5.12",
     "@types/node": "^20.11.19",
+    "adm-zip": "^0.6.0",
     "jest": "^29.7.0",
     "ts-jest": "^29.1.2",
     "typescript": "^5.3.3"
@@ -69,12 +71,12 @@
     "node": ">=16"
   },
   "optionalDependencies": {
-    "@nazarkalytiuk/rusc-xlsx-win32-x64-msvc": "1.0.8",
-    "@nazarkalytiuk/rusc-xlsx-win32-ia32-msvc": "1.0.8",
-    "@nazarkalytiuk/rusc-xlsx-win32-arm64-msvc": "1.0.8",
-    "@nazarkalytiuk/rusc-xlsx-darwin-universal": "1.0.8",
-    "@nazarkalytiuk/rusc-xlsx-linux-x64-gnu": "1.0.8",
-    "@nazarkalytiuk/rusc-xlsx-linux-arm64-gnu": "1.0.8",
-    "@nazarkalytiuk/rusc-xlsx-linux-x64-musl": "1.0.8"
+    "@nazarkalytiuk/rusc-xlsx-win32-x64-msvc": "1.0.10",
+    "@nazarkalytiuk/rusc-xlsx-win32-ia32-msvc": "1.0.10",
+    "@nazarkalytiuk/rusc-xlsx-win32-arm64-msvc": "1.0.10",
+    "@nazarkalytiuk/rusc-xlsx-darwin-universal": "1.0.10",
+    "@nazarkalytiuk/rusc-xlsx-linux-x64-gnu": "1.0.10",
+    "@nazarkalytiuk/rusc-xlsx-linux-arm64-gnu": "1.0.10",
+    "@nazarkalytiuk/rusc-xlsx-linux-x64-musl": "1.0.10"
   }
 }

package/wrapper.d.ts

@@ -1,6 +1,8 @@
 // TypeScript definitions for wrapper.js
 // These provide the fluent API with method chaining
 
+import type { Writable } from 'stream';
+
 /** Color value - can be a named color or hex code */
 export type Color =
   | 'black' | 'blue' | 'brown' | 'cyan' | 'gray' | 'green'
@@ -844,6 +846,12 @@ export declare class Worksheet {
    */
   setRowHeight(row: number, height: number): void;
 
+  /**
+   * Set the default height for all worksheet rows without per-row metadata
+   * @param height - Height in points
+   */
+  setDefaultRowHeight(height: number): void;
+
   /**
    * Set the worksheet name
    * @param name - Worksheet name
@@ -2278,22 +2286,24 @@ export declare class Workbook {
   /**
    * Save the workbook to a Writable stream
    *
-   * Streams XLSX data directly to the writable without buffering the entire
-   * file in memory. Combines the speed of `saveToBuffer()` with the low
-   * memory footprint of `save(filename)`.
+   * Saves the workbook to a temporary file, then pipes that file into the
+   * writable without buffering the entire XLSX file in JavaScript memory.
+   * The temporary file is removed after the pipeline succeeds or fails.
+   * The promise rejects on native save, read, writable, pipeline, or cleanup errors.
    *
    * @param writable - A Node.js Writable stream (e.g., fs.createWriteStream, HTTP response)
+   * @returns A promise that settles after streaming and temporary-file cleanup complete
    * @example
    * const fs = require('fs');
    * const stream = fs.createWriteStream('output.xlsx');
-   * workbook.saveToStream(stream);
+   * await workbook.saveToStream(stream);
    *
    * @example
    * // HTTP response
    * res.setHeader('Content-Type', 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
-   * workbook.saveToStream(res);
+   * await workbook.saveToStream(res);
    */
-  saveToStream(writable: import('stream').Writable): void;
+  saveToStream(writable: Writable): Promise<void>;
 
   /**
    * Define a named range or formula

package/wrapper.js

@@ -493,7 +493,20 @@ class Worksheet {
   }
 
   write(row, col, value, format) {
-    return this._native.write(row, col, value, format ? format._native : undefined)
+    if (format) {
+      return this._native.write(row, col, value, format._native)
+    }
+
+    switch (typeof value) {
+      case 'string':
+        return this._native.writeString(row, col, value)
+      case 'number':
+        return this._native.writeNumber(row, col, value)
+      case 'boolean':
+        return this._native.writeBoolean(row, col, value)
+      default:
+        return this._native.write(row, col, value)
+    }
   }
 
   writeRow(row, startCol, values, format) {
@@ -577,6 +590,10 @@ class Worksheet {
     return this._native.setRowHeight(row, height)
   }
 
+  setDefaultRowHeight(height) {
+    return this._native.setDefaultRowHeight(height)
+  }
+
   setName(name) {
     return this._native.setName(name)
   }
@@ -1271,23 +1288,40 @@ class Workbook {
     return this._native.saveToBuffer()
   }
 
-  saveToStream(writable) {
+  async saveToStream(writable) {
     const os = require('os')
     const path = require('path')
     const fs = require('fs')
     const crypto = require('crypto')
+    const { pipeline } = require('stream/promises')
 
     const tmpFile = path.join(os.tmpdir(), `rusc-xlsx-${crypto.randomBytes(8).toString('hex')}.xlsx`)
-    this._native.save(tmpFile)
-
-    const readable = fs.createReadStream(tmpFile)
-    readable.on('end', () => {
-      fs.unlink(tmpFile, () => {})
-    })
-    readable.on('error', () => {
-      fs.unlink(tmpFile, () => {})
-    })
-    readable.pipe(writable)
+    let operationError
+
+    try {
+      this._native.save(tmpFile)
+      await pipeline(fs.createReadStream(tmpFile), writable)
+    } catch (error) {
+      operationError = error
+    }
+
+    try {
+      await fs.promises.unlink(tmpFile)
+    } catch (cleanupError) {
+      if (cleanupError.code !== 'ENOENT') {
+        if (operationError) {
+          throw new AggregateError(
+            [operationError, cleanupError],
+            'Failed to save workbook to stream and remove the temporary file'
+          )
+        }
+        throw cleanupError
+      }
+    }
+
+    if (operationError) {
+      throw operationError
+    }
   }
 
   defineName(name, formula) {