@nazarkalytiuk/rusc-xlsx 1.0.9 → 2.0.0

package/README.md

@@ -67,8 +67,8 @@ npm install @nazarkalytiuk/rusc-xlsx
 
 ### Requirements
 
-- Node.js >= 16
-- Rust toolchain (for building from source)
+- Node.js >= 22.13
+- Rust >= 1.88 (only when building from source)
 
 ## Quick Start
 
@@ -169,6 +169,8 @@ workbook.save('output.xlsx');
 - `addWorksheetWithConstantMemory([name])` - Constant memory mode
 - `addWorksheetWithLowMemory([name])` - Low memory mode
 - `setTempdir(path)` - Set temp directory for memory modes
+- `setDefaultFormat(format, rowHeight, columnWidth)` - Set workbook-wide default formatting before adding worksheets
+- `useExcel2023Theme()` / `useCustomTheme(path)` - Select the workbook theme before adding worksheets
 - `save(filename)` - Save to file
 - `saveToBuffer()` - Save to Buffer
 - `saveToStream(writable)` - Save through a temp file and await stream completion
@@ -181,8 +183,8 @@ workbook.save('output.xlsx');
 - **Writing**: `write()`, `writeString()`, `writeNumber()`, `writeBoolean()`, `writeBlank()`
 - **DateTime**: `writeDatetime()`, `writeDatetimeFromTimestamp()`, `writeDatetimeFromYmd()`, etc.
 - **Formulas**: `writeFormula()`, `writeArrayFormula()`, `writeDynamicFormula()`
-- **Layout**: `setColumnWidth()`, `setRowHeight()`, `setDefaultRowHeight()`, `mergeRange()`, `setName()`
-- **Features**: `insertNote()`, `addDataValidation()`, `insertChart()`, `insertImage()`, `addTable()`, `insertButton()`, `insertShape()`
+- **Layout**: `setColumnWidth()`, `setRowHeight()`, `setDefaultRowHeight()`, `mergeRange()`, `setName()`, `autofit()`, `setAutofitMaxRow()`, `setAutofitMaxWidth()`
+- **Features**: `insertNote()`, `addDataValidation()`, `insertChart()`, `insertImage()`, `insertImageFitToCellCentered()`, `addTable()`, `insertButton()`, `insertShape()`
 - **Conditional Formatting**: 14 methods for all rule types
 - **Page Setup**: 26 methods for printing, margins, headers, etc.
 - **View**: `autofilter()`, `setFreezePanes()`, `setZoom()`, `setTabColor()`, `hideSheet()`
@@ -190,8 +192,8 @@ workbook.save('output.xlsx');
 - **Protection**: `protect()`, `protectWithPassword()`
 - **Rich Text**: `writeRichString()`
 
-### Format (39 methods)
-- **Font**: `setBold()`, `setItalic()`, `setFontSize()`, `setFontColor()`, `setFontName()`, `setUnderline()`, `setStrikethrough()`, `setFontScript()`
+### Format (40 methods)
+- **Font**: `setBold()`, `setItalic()`, `setFontSize()`, `setFontColor()`, `setFontName()`, `setFontScheme()`, `setUnderline()`, `setStrikethrough()`, `setFontScript()`
 - **Alignment**: `setAlign()`, `setVerticalAlign()`, `setRotation()`, `setIndent()`, `setTextWrap()`, `setShrink()`
 - **Borders**: `setBorder()`, `setBorderTop/Bottom/Left/Right()`, `setBorderColor()`, `setBorderDiagonal()`
 - **Fill**: `setBackgroundColor()`, `setForegroundColor()`, `setPattern()`
@@ -202,7 +204,7 @@ workbook.save('output.xlsx');
 ### Supporting Classes
 - **Chart**: 25 chart types with series, titles, legends, 48 styles
 - **Image**: Insert with scaling, positioning, alt text, URLs
-- **Table**: Custom columns, total rows, 60 styles
+- **Table**: Custom columns, total rows, alternative text, 60 styles
 - **Sparkline**: 3 types, markers, colors, 36 styles
 - **DataValidation**: All validation types with custom messages
 - **Note**: Comments with author, size, color, visibility
@@ -283,6 +285,97 @@ 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.
+
+### Node.js vs Go, C#, and Python Benchmark
+
+The cross-language benchmark compares concrete streaming XLSX libraries, not
+language runtimes in isolation:
+
+| Runtime | XLSX implementation | Bounded-memory API |
+|---------|---------------------|--------------------|
+| Node.js | `@nazarkalytiuk/rusc-xlsx` | Constant-memory `writeRow()` |
+| Go | Excelize 2.11.0 | `StreamWriter.SetRow()` |
+| C# | Open XML SDK 3.5.1 | Forward-only worksheet XML writer |
+| Python | XlsxWriter 3.2.9 | `constant_memory` + `write_row()` |
+
+Install Rust, Go 1.25+, the .NET 8 SDK, and Python 3.10+, then run:
+
+```bash
+npm run benchmark:languages
+```
+
+The runner builds release artifacts and creates an isolated Python virtual
+environment under `benchmarks/python-xlsxwriter/.venv`. The default workload is
+the same 200,000 rows × 20 columns, 50/50 string-and-number dataset used by the
+Rust comparison. Before measurement, each implementation generates a small
+workbook that is checked for its worksheet name, complete row/cell shape, and
+representative values. Measured execution order is balanced across runs, and
+the report includes median generation time, end-to-end process wall time,
+throughput, peak RSS, and XLSX size.
+
+Override the workload, select available runtimes, or reuse existing artifacts:
+
+```bash
+npm run benchmark:languages -- --rows 100000 --columns 20 --runs 5
+npm run benchmark:languages -- --implementations node,go,python
+npm run benchmark:languages -- --skip-build
+```
+
+Use `--node-write-mode cell|row|batch` to measure a different Node.js API;
+`row` is the cross-language default because all four implementations consume
+the workload sequentially by row.
+
 ## Limitations
 
 - ❌ **Read-only**: Cannot read existing Excel files (rust_xlsxwriter is write-only)

package/index.d.ts

@@ -122,6 +122,8 @@ export declare class RuscFormat {
   setNumFormat(numFormat: string): void
   /** Set font name (e.g., 'Arial', 'Calibri', 'Times New Roman') */
   setFontName(fontName: string): void
+  /** Set whether the font uses a body, headings, or custom font scheme. */
+  setFontScheme(scheme: string): void
   /** Set text underline style */
   setUnderline(underline: string): void
   /** Set strikethrough text */
@@ -368,6 +370,10 @@ export declare class RuscTable {
   setLastColumn(show: boolean): this
   /** Set the name of the table */
   setName(name: string): this
+  /** Set alternative text for screen readers. */
+  setAltText(altText: string): this
+  /** Set the alternative text title for screen readers. */
+  setAltTextTitle(title: string): this
   /** Set the style of the table (1-21 for light styles, 22-49 for medium styles, 50-61 for dark styles) */
   setStyle(styleId: number): this
   /** Add columns to the table */
@@ -399,6 +405,18 @@ export declare class RuscWorkbook {
   addWorksheetWithLowMemory(name?: string | undefined | null): RuscWorksheet
   /** Set a custom temporary directory for constant memory mode */
   setTempdir(dir: string): void
+  /**
+   * Set the default workbook format and row/column dimensions in pixels.
+   * Must be called before adding worksheets.
+   */
+  setDefaultFormat(format: RuscFormat, rowHeight: number, columnWidth: number): void
+  /**
+   * Use the Excel 2023 Office theme with the Aptos default font.
+   * Must be called before adding worksheets.
+   */
+  useExcel2023Theme(): void
+  /** Load a custom theme from a .thmx, .xlsx, or theme XML file. */
+  useCustomTheme(path: string): void
   /** Save the workbook to a file */
   save(filename: string): void
   /** Save the workbook to a buffer */
@@ -478,6 +496,12 @@ export declare class RuscWorksheet {
   setRowHeight(row: number, height: number): void
   /** Set the default height for all worksheet rows efficiently */
   setDefaultRowHeight(height: number): void
+  /** Set the exclusive upper row bound inspected by autofit. */
+  setAutofitMaxRow(maxRow: number): void
+  /** Limit the autofitted column width in pixels. */
+  setAutofitMaxWidth(maxWidth: number): void
+  /** Autofit worksheet columns based on their cell contents. */
+  autofit(): void
   /** Set the name of the worksheet */
   setName(name: string): void
   /** Merge a range of cells */
@@ -598,6 +622,8 @@ export declare class RuscWorksheet {
   insertImageWithOffset(row: number, col: number, image: RuscImage, xOffset: number, yOffset: number): void
   /** Insert an image that fits to a cell */
   insertImageFitToCell(row: number, col: number, image: RuscImage, keepAspectRatio: boolean): void
+  /** Insert an image scaled proportionally and centered within a cell. */
+  insertImageFitToCellCentered(row: number, col: number, image: RuscImage): void
   /** Add a table to the worksheet */
   addTable(firstRow: number, firstCol: number, lastRow: number, lastCol: number, table: RuscTable): void
   /** Add a sparkline to a single cell */

package/index.js

@@ -3,7 +3,7 @@
 // @ts-nocheck
 /* auto-generated by NAPI-RS */
 
-const { readFileSync } = require('node:fs')
+const { readFileSync } = require('fs')
 let nativeBinding = null
 const loadErrors = []
 
@@ -33,7 +33,7 @@ const isMuslFromFilesystem = () => {
 
 const isMuslFromReport = () => {
   let report = null
-  if (typeof process.report?.getReport === 'function') {
+  if (process.report && typeof process.report.getReport === 'function') {
     process.report.excludeNetwork = true
     report = process.report.getReport()
   }
@@ -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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -105,7 +105,7 @@ function requireNative() {
     }
   } else if (process.platform === 'win32') {
     if (process.arch === 'x64') {
-      if (process.config?.variables?.shlib_suffix === 'dll.a' || process.config?.variables?.node_target_type === 'shared_library') {
+      if ((process.config && process.config.variables && process.config.variables.shlib_suffix === 'dll.a') || (process.config && process.config.variables && process.config.variables.node_target_type === 'shared_library')) {
         try {
         return require('./rusc_xlsx.win32-x64-gnu.node')
       } 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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 2.0.0 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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0 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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0 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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0 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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0 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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0 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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0 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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0 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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0 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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0 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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0 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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 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.9' && 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.9 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -523,50 +523,178 @@ function requireNative() {
   }
 }
 
-nativeBinding = requireNative()
+function createLoadErrorChain(errors) {
+  return errors.reduce((previous, current) => {
+    let message
+    try {
+      message =
+        current && typeof current.message === 'string'
+          ? current.message
+          : String(current)
+    } catch {
+      message = 'Unknown error'
+    }
+    const error = new Error(message)
+    error.cause = previous
+    return error
+  }, null)
+}
+
+// NAPI_RS_FORCE_WASI is a tri-state flag:
+//   unset / any other value → native binding preferred, WASI is only a fallback
+//   'true'                   → prefer WASI, but retain native as a lazy fallback
+//   'error'                  → require WASI without initializing a native fallback
+// Treating any non-empty string as truthy (the historical behavior) meant
+// NAPI_RS_FORCE_WASI=false, NAPI_RS_FORCE_WASI=0, etc. inadvertently triggered
+// the WASI path, causing ENOENT for packages shipped without a .wasi.cjs file.
+//
+// NAPI_RS_WASI_FLAVOR selects one exact generated flavor and implies strict
+// WASI loading. It never crosses into another flavor or falls back to native.
+const __napiWasiFlavors = ["wasm32-wasi"]
+const __napiWasiFlavor = process.env.NAPI_RS_WASI_FLAVOR
+const __napiWasiFlavorRequested =
+  typeof __napiWasiFlavor === 'string' && __napiWasiFlavor.length > 0
+if (
+  __napiWasiFlavorRequested &&
+  __napiWasiFlavors.indexOf(__napiWasiFlavor) === -1
+) {
+  throw new Error(
+    'Unsupported WASI flavor "' +
+      __napiWasiFlavor +
+      '". Available flavors: ' +
+      __napiWasiFlavors.join(', '),
+  )
+}
+const forceWasiError = process.env.NAPI_RS_FORCE_WASI === 'error'
+const forceWasi =
+  process.env.NAPI_RS_FORCE_WASI === 'true' ||
+  forceWasiError ||
+  __napiWasiFlavorRequested
+
+if (!forceWasi) {
+  nativeBinding = requireNative()
+}
 
-if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+if (!nativeBinding || forceWasi) {
   let wasiBinding = null
-  let wasiBindingError = null
-  try {
-    wasiBinding = require('./rusc_xlsx.wasi.cjs')
-    nativeBinding = wasiBinding
-  } catch (err) {
-    if (process.env.NAPI_RS_FORCE_WASI) {
-      wasiBindingError = err
+  let wasiBindingLoaded = false
+  const wasiBindingErrors = []
+  const __napiWasiResolveCandidate = (specifier, isPackage, localArtifacts) => {
+    try {
+      require.resolve(specifier)
+    } catch (resolveError) {
+      if (!resolveError || resolveError.code !== 'MODULE_NOT_FOUND') {
+        throw resolveError
+      }
+      if (isPackage) {
+        try {
+          require.resolve(specifier + '/package.json')
+        } catch (packageError) {
+          if (packageError && packageError.code === 'MODULE_NOT_FOUND') {
+            return resolveError
+          }
+          // An exports restriction proves the package exists even when its
+          // package.json is not public. Preserve the root resolution failure.
+          throw resolveError
+        }
+        // The package exists but its main/export target is broken.
+        throw resolveError
+      }
+      return resolveError
+    }
+    if (localArtifacts) {
+      let artifactError = null
+      for (let i = 0; i < localArtifacts.length; i++) {
+        try {
+          require.resolve(localArtifacts[i])
+          return null
+        } catch (resolveError) {
+          if (!resolveError || resolveError.code !== 'MODULE_NOT_FOUND') {
+            throw resolveError
+          }
+          artifactError = resolveError
+        }
+      }
+      return artifactError
     }
+    return null
   }
-  if (!nativeBinding) {
+  if (!wasiBindingLoaded && (!__napiWasiFlavorRequested || __napiWasiFlavor === "wasm32-wasi")) {
+    let candidateError = null
+    let candidateFailed = false
     try {
-      wasiBinding = require('@nazarkalytiuk/rusc-xlsx-wasm32-wasi')
-      nativeBinding = wasiBinding
+      candidateError = __napiWasiResolveCandidate('./rusc_xlsx.wasi.cjs', false, ["./rusc_xlsx.wasm32-wasi.debug.wasm","./rusc_xlsx.wasm32-wasi.wasm"])
+      candidateFailed = candidateError !== null
+      if (!candidateFailed) {
+        wasiBinding = require('./rusc_xlsx.wasi.cjs')
+        nativeBinding = wasiBinding
+        wasiBindingLoaded = true
+      }
     } catch (err) {
-      if (process.env.NAPI_RS_FORCE_WASI) {
-        wasiBindingError.cause = err
-        loadErrors.push(err)
+      candidateError = err
+      candidateFailed = true
+    }
+    if (candidateFailed) {
+      wasiBindingErrors.push(candidateError)
+      loadErrors.push(candidateError)
+    }
+  }
+  if (!wasiBindingLoaded && (!__napiWasiFlavorRequested || __napiWasiFlavor === "wasm32-wasi")) {
+    let candidateError = null
+    let candidateFailed = false
+    try {
+      candidateError = __napiWasiResolveCandidate('@nazarkalytiuk/rusc-xlsx-wasm32-wasi', true, undefined)
+      candidateFailed = candidateError !== null
+      if (!candidateFailed) {
+        if (process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-wasm32-wasi/package.json').version
+          if (bindingPackageVersion !== '2.0.0') {
+            throw new Error(`WASI binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+        }
+        wasiBinding = require('@nazarkalytiuk/rusc-xlsx-wasm32-wasi')
+        nativeBinding = wasiBinding
+        wasiBindingLoaded = true
       }
+    } catch (err) {
+      candidateError = err
+      candidateFailed = true
     }
+    if (candidateFailed) {
+      wasiBindingErrors.push(candidateError)
+      loadErrors.push(candidateError)
+    }
+  }
+  if (
+    !wasiBindingLoaded &&
+    forceWasi &&
+    !forceWasiError &&
+    !__napiWasiFlavorRequested
+  ) {
+    nativeBinding = requireNative()
   }
-  if (process.env.NAPI_RS_FORCE_WASI === 'error' && !wasiBinding) {
-    const error = new Error('WASI binding not found and NAPI_RS_FORCE_WASI is set to error')
-    error.cause = wasiBindingError
+  if ((forceWasiError || __napiWasiFlavorRequested) && !wasiBindingLoaded) {
+    const error = new Error(
+      __napiWasiFlavorRequested
+        ? 'WASI binding for flavor "' + __napiWasiFlavor + '" not found'
+        : 'WASI binding not found and NAPI_RS_FORCE_WASI is set to error',
+    )
+    error.cause = createLoadErrorChain(wasiBindingErrors)
     throw error
   }
 }
 
 if (!nativeBinding) {
   if (loadErrors.length > 0) {
-    throw new Error(
+    const error = new Error(
       `Cannot find native binding. ` +
         `npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828). ` +
         'Please try `npm i` again after removing both package-lock.json and node_modules directory.',
-      {
-        cause: loadErrors.reduce((err, cur) => {
-          cur.cause = err
-          return cur
-        }),
-      },
     )
+    // assign instead of the `new Error(message, { cause })` options form,
+    // which Node < 16.9 silently ignores
+    error.cause = createLoadErrorChain(loadErrors)
+    throw error
   }
   throw new Error(`Failed to load native binding`)
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nazarkalytiuk/rusc-xlsx",
-  "version": "1.0.9",
+  "version": "2.0.0",
   "description": "Fast Excel XLSX library for Node.js powered by rust_xlsxwriter",
   "main": "wrapper.js",
   "types": "wrapper.d.ts",
@@ -32,8 +32,11 @@
     "artifacts": "napi artifacts",
     "build": "napi build --platform --release",
     "build:debug": "napi build --platform",
+    "benchmark": "node benchmarks/compare-generation.js",
+    "benchmark:languages": "node benchmarks/compare-languages.js",
     "prepublishOnly": "napi prepublish -t npm",
     "test": "jest",
+    "typecheck": "tsc --project tsconfig.json",
     "universal": "napi universalize",
     "version": "napi version",
     "clean": "cargo clean && rm -rf *.node"
@@ -58,24 +61,22 @@
     "LICENSE"
   ],
   "devDependencies": {
-    "@napi-rs/cli": "^3.0.0",
-    "@types/jest": "^29.5.12",
-    "@types/node": "^20.11.19",
+    "@napi-rs/cli": "^3.8.2",
+    "@types/node": "^24.13.3",
     "adm-zip": "^0.6.0",
-    "jest": "^29.7.0",
-    "ts-jest": "^29.1.2",
-    "typescript": "^5.3.3"
+    "jest": "^30.4.2",
+    "typescript": "^7.0.2"
   },
   "engines": {
-    "node": ">=16"
+    "node": ">=22.13.0"
   },
   "optionalDependencies": {
-    "@nazarkalytiuk/rusc-xlsx-win32-x64-msvc": "1.0.9",
-    "@nazarkalytiuk/rusc-xlsx-win32-ia32-msvc": "1.0.9",
-    "@nazarkalytiuk/rusc-xlsx-win32-arm64-msvc": "1.0.9",
-    "@nazarkalytiuk/rusc-xlsx-darwin-universal": "1.0.9",
-    "@nazarkalytiuk/rusc-xlsx-linux-x64-gnu": "1.0.9",
-    "@nazarkalytiuk/rusc-xlsx-linux-arm64-gnu": "1.0.9",
-    "@nazarkalytiuk/rusc-xlsx-linux-x64-musl": "1.0.9"
+    "@nazarkalytiuk/rusc-xlsx-win32-x64-msvc": "2.0.0",
+    "@nazarkalytiuk/rusc-xlsx-win32-ia32-msvc": "2.0.0",
+    "@nazarkalytiuk/rusc-xlsx-win32-arm64-msvc": "2.0.0",
+    "@nazarkalytiuk/rusc-xlsx-darwin-universal": "2.0.0",
+    "@nazarkalytiuk/rusc-xlsx-linux-x64-gnu": "2.0.0",
+    "@nazarkalytiuk/rusc-xlsx-linux-arm64-gnu": "2.0.0",
+    "@nazarkalytiuk/rusc-xlsx-linux-x64-musl": "2.0.0"
   }
 }

package/wrapper.d.ts

@@ -33,6 +33,9 @@ export type FillPattern =
   | 'lightDown' | 'lightUp' | 'lightGrid' | 'lightTrellis'
   | 'gray125' | 'gray0625';
 
+/** Font theme scheme */
+export type FontScheme = 'body' | 'headings' | 'none';
+
 /** Data validation rule type */
 export type ValidationRule = 'equal' | 'notEqual' | 'greaterThan' | 'lessThan' | 'greaterThanOrEqual' | 'lessThanOrEqual';
 
@@ -65,6 +68,8 @@ export declare class Format {
   setFontSize(size: number): this;
   /** Set font name (e.g., 'Arial', 'Calibri', 'Times New Roman') */
   setFontName(fontName: string): this;
+  /** Set whether the font belongs to the body, headings, or no theme scheme */
+  setFontScheme(scheme: FontScheme): this;
   /** Set font color using named color or hex code */
   setFontColor(color: Color): this;
   /** Set text underline style */
@@ -852,6 +857,21 @@ export declare class Worksheet {
    */
   setDefaultRowHeight(height: number): void;
 
+  /**
+   * Set the exclusive upper row bound inspected by autofit
+   * @param maxRow - Rows at or above this zero-indexed bound are skipped
+   */
+  setAutofitMaxRow(maxRow: number): void;
+
+  /**
+   * Limit the maximum autofitted column width
+   * @param maxWidth - Maximum width in pixels
+   */
+  setAutofitMaxWidth(maxWidth: number): void;
+
+  /** Autofit worksheet columns based on cell contents */
+  autofit(): void;
+
   /**
    * Set the worksheet name
    * @param name - Worksheet name
@@ -1448,6 +1468,14 @@ export declare class Worksheet {
    */
   insertImageFitToCell(row: number, col: number, image: Image, keepAspectRatio?: boolean): void;
 
+  /**
+   * Insert an image scaled proportionally and centered within a cell
+   * @param row - Row number (0-indexed)
+   * @param col - Column number (0-indexed)
+   * @param image - Image instance
+   */
+  insertImageFitToCellCentered(row: number, col: number, image: Image): void;
+
   /**
    * Add a table to the worksheet
    * @param firstRow - First row of the table (0-indexed)
@@ -1818,6 +1846,12 @@ export declare class Table {
    */
   setName(name: string): this;
 
+  /** Set alternative text for screen readers */
+  setAltText(altText: string): this;
+
+  /** Set the alternative text title for screen readers */
+  setAltTextTitle(title: string): this;
+
   /**
    * Set the style of the table
    * @param styleId - Table style ID (1-21: light, 22-49: medium, 50-60: dark)
@@ -2271,6 +2305,27 @@ export declare class Workbook {
    */
   setTempdir(dir: string): void;
 
+  /**
+   * Set the default workbook format and row/column dimensions.
+   * Must be called before adding worksheets.
+   * @param format - Default cell format
+   * @param rowHeight - Default row height in pixels
+   * @param columnWidth - Supported default column width in pixels: 56, 64, 72, 80, 96, 104, or 120
+   */
+  setDefaultFormat(format: Format, rowHeight: number, columnWidth: number): void;
+
+  /**
+   * Use the Excel 2023 Office theme with the Aptos default font.
+   * Must be called before adding worksheets.
+   */
+  useExcel2023Theme(): void;
+
+  /**
+   * Load a custom theme from a .thmx, .xlsx, or theme XML file.
+   * Must be called before adding worksheets.
+   */
+  useCustomTheme(path: string): void;
+
   /**
    * Save the workbook to a file
    * @param filename - Path where the file should be saved

package/wrapper.js

@@ -57,6 +57,11 @@ class Format {
     return this
   }
 
+  setFontScheme(scheme) {
+    this._native.setFontScheme(scheme)
+    return this
+  }
+
   setUnderline(underline) {
     this._native.setUnderline(underline)
     return this
@@ -493,7 +498,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) {
@@ -581,6 +599,18 @@ class Worksheet {
     return this._native.setDefaultRowHeight(height)
   }
 
+  setAutofitMaxRow(maxRow) {
+    return this._native.setAutofitMaxRow(maxRow)
+  }
+
+  setAutofitMaxWidth(maxWidth) {
+    return this._native.setAutofitMaxWidth(maxWidth)
+  }
+
+  autofit() {
+    return this._native.autofit()
+  }
+
   setName(name) {
     return this._native.setName(name)
   }
@@ -836,6 +866,10 @@ class Worksheet {
     return this._native.insertImageFitToCell(row, col, image._native, keepAspectRatio)
   }
 
+  insertImageFitToCellCentered(row, col, image) {
+    return this._native.insertImageFitToCellCentered(row, col, image._native)
+  }
+
   addTable(firstRow, firstCol, lastRow, lastCol, table) {
     return this._native.addTable(firstRow, firstCol, lastRow, lastCol, table._native)
   }
@@ -943,6 +977,16 @@ class Table {
     return this
   }
 
+  setAltText(altText) {
+    this._native.setAltText(altText)
+    return this
+  }
+
+  setAltTextTitle(title) {
+    this._native.setAltTextTitle(title)
+    return this
+  }
+
   setStyle(styleId) {
     this._native.setStyle(styleId)
     return this
@@ -1267,6 +1311,18 @@ class Workbook {
     return this._native.setTempdir(dir)
   }
 
+  setDefaultFormat(format, rowHeight, columnWidth) {
+    return this._native.setDefaultFormat(format._native, rowHeight, columnWidth)
+  }
+
+  useExcel2023Theme() {
+    return this._native.useExcel2023Theme()
+  }
+
+  useCustomTheme(path) {
+    return this._native.useCustomTheme(path)
+  }
+
   save(filename) {
     return this._native.save(filename)
   }