@nazarkalytiuk/rusc-xlsx 1.0.6 → 1.0.8

package/index.d.ts

@@ -438,14 +438,14 @@ 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.
-   * Batches all writes into a single NAPI call with one lock acquisition.
+   * Uses lazy iteration — reads one cell at a time from JS, null/undefined skipped.
    */
-  writeRow(row: number, startCol: number, values: Array<string | number | boolean>, format?: RuscFormat | undefined | null): void
+  writeRow(row: number, startCol: number, values: Array<string | number | boolean | null | undefined>, format?: RuscFormat | undefined | null): void
   /**
    * Write a 2D array of values starting at the given position.
-   * Batches all writes into a single NAPI call with one lock acquisition.
+   * Uses lazy iteration — never materializes the entire grid in Rust memory.
    */
-  writeRows(startRow: number, startCol: number, rows: Array<Array<string | number | boolean>>, format?: RuscFormat | undefined | null): void
+  writeRows(startRow: number, startCol: number, rows: Array<Array<string | number | boolean | null | undefined>>, 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 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nazarkalytiuk/rusc-xlsx",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "Fast Excel XLSX library for Node.js powered by rust_xlsxwriter",
   "main": "wrapper.js",
   "types": "wrapper.d.ts",
@@ -69,12 +69,12 @@
     "node": ">=16"
   },
   "optionalDependencies": {
-    "@nazarkalytiuk/rusc-xlsx-win32-x64-msvc": "1.0.6",
-    "@nazarkalytiuk/rusc-xlsx-win32-ia32-msvc": "1.0.6",
-    "@nazarkalytiuk/rusc-xlsx-win32-arm64-msvc": "1.0.6",
-    "@nazarkalytiuk/rusc-xlsx-darwin-universal": "1.0.6",
-    "@nazarkalytiuk/rusc-xlsx-linux-x64-gnu": "1.0.6",
-    "@nazarkalytiuk/rusc-xlsx-linux-arm64-gnu": "1.0.6",
-    "@nazarkalytiuk/rusc-xlsx-linux-x64-musl": "1.0.6"
+    "@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"
   }
 }

package/wrapper.d.ts

@@ -2332,5 +2332,26 @@ export declare class Workbook {
   setProperties(properties: DocProperties): void;
 }
 
+/**
+ * Returns [currentBytes, peakBytes] of Rust allocator usage.
+ * Useful for profiling memory consumption of the native layer.
+ *
+ * @example
+ * const [current, peak] = rustMemoryStats();
+ * console.log(`Rust heap: ${(current / 1024 / 1024).toFixed(2)} MB (peak: ${(peak / 1024 / 1024).toFixed(2)} MB)`);
+ */
+export declare function rustMemoryStats(): [number, number];
+
+/**
+ * Resets peak memory tracking to the current allocation level.
+ * Call before a section you want to measure.
+ *
+ * @example
+ * rustMemoryResetPeak();
+ * // ... do work ...
+ * const [current, peak] = rustMemoryStats();
+ */
+export declare function rustMemoryResetPeak(): void;
+
 // Re-export native bindings for advanced use
 export { RuscFormat, RuscNote, RuscFormula, RuscDataValidation, RuscChart, RuscWorkbook, RuscWorksheet, RuscProtectionOptions, RuscRichText, RuscImage, RuscTable, RuscTableColumn, RuscSparkline, RuscDocProperties, RuscButton, RuscShape } from './index';

package/wrapper.js

@@ -497,33 +497,11 @@ class Worksheet {
   }
 
   writeRow(row, startCol, values, format) {
-    const fmt = format ? format._native : undefined
-    const clean = values.filter(v => v !== null && v !== undefined)
-    if (clean.length === values.length) {
-      return this._native.writeRow(row, startCol, clean, fmt)
-    }
-    for (let i = 0; i < values.length; i++) {
-      if (values[i] !== null && values[i] !== undefined) {
-        this._native.write(row, startCol + i, values[i], fmt)
-      }
-    }
+    return this._native.writeRow(row, startCol, values, format ? format._native : undefined)
   }
 
   writeRows(startRow, startCol, rows, format) {
-    const fmt = format ? format._native : undefined
-    for (let r = 0; r < rows.length; r++) {
-      const values = rows[r]
-      const clean = values.filter(v => v !== null && v !== undefined)
-      if (clean.length === values.length) {
-        this._native.writeRow(startRow + r, startCol, clean, fmt)
-      } else {
-        for (let i = 0; i < values.length; i++) {
-          if (values[i] !== null && values[i] !== undefined) {
-            this._native.write(startRow + r, startCol + i, values[i], fmt)
-          }
-        }
-      }
-    }
+    return this._native.writeRows(startRow, startCol, rows, format ? format._native : undefined)
   }
 
   writeString(row, col, value) {
@@ -1364,4 +1342,7 @@ module.exports = {
   RuscDocProperties: nativeBinding.RuscDocProperties,
   RuscButton: nativeBinding.RuscButton,
   RuscShape: nativeBinding.RuscShape,
+  // Memory tracking
+  rustMemoryStats: nativeBinding.rustMemoryStats,
+  rustMemoryResetPeak: nativeBinding.rustMemoryResetPeak,
 }