@nazarkalytiuk/rusc-xlsx 2.0.0 → 2.1.0

package/README.md

@@ -68,7 +68,7 @@ npm install @nazarkalytiuk/rusc-xlsx
 ### Requirements
 
 - Node.js >= 22.13
-- Rust >= 1.88 (only when building from source)
+- Rust >= 1.95 (only when building from source)
 
 ## Quick Start
 
@@ -171,6 +171,9 @@ workbook.save('output.xlsx');
 - `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
+- `setCalculationMode(mode)` - Formula recalculation: `'automatic'`, `'manual'` or `'partial'`
+- `setZipCompressionLevel(level)` - Trade file size for speed (1-9, default 6)
+- `setTabRatio(ratio)` - Width of the sheet tab bar vs. the horizontal scroll bar (0-100)
 - `save(filename)` - Save to file
 - `saveToBuffer()` - Save to Buffer
 - `saveToStream(writable)` - Save through a temp file and await stream completion
@@ -187,7 +190,7 @@ workbook.save('output.xlsx');
 - **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()`
+- **View**: `autofilter()`, `setFreezePanes()`, `setZoom()`, `setTabColor()`, `setHiddenZeroes()`, `setHidden()`
 - **Hyperlinks**: `writeUrl()`
 - **Protection**: `protect()`, `protectWithPassword()`
 - **Rich Text**: `writeRichString()`
@@ -247,14 +250,31 @@ See the `examples/` directory for complete examples:
 git clone https://github.com/NazarKalytiuk/napi_rust_xlsxwrighter.git
 cd napi_rust_xlsxwrighter
 
-# Install dependencies
+# Install dependencies (also builds wrapper.js + wrapper.d.ts from wrapper.ts via tsdown)
 npm install
 
 # Build native module
 npm run build
 
-# Run tests (577 tests)
+# Rebuild the JavaScript wrapper after editing wrapper.ts
+npm run build:wrapper
+
+# Run tests (Vitest)
 npm test
+npm run test:watch      # re-run on change
+npm run test:coverage   # V8 coverage report for wrapper.ts
+npm run test:coverage:rust  # line coverage of src/*.rs via an instrumented addon;
+                            # needs cargo-llvm-cov and `rustup component add llvm-tools`
+
+# Format, lint (oxfmt, oxlint, rustfmt, clippy) and typecheck — same as CI
+npm run check
+npm run fmt             # apply oxfmt + rustfmt
+
+# rust_xlsxwriter coverage checklist (rust-xlsxwriter-coverage-checklist.md)
+npm run coverage:check  # verify test call sites, counts and the pinned version
+npm run coverage:sync   # refresh them after editing tests or row statuses; after a
+                        # rust_xlsxwriter upgrade it documents the new release with
+                        # rustdoc JSON (`rustup toolchain install nightly-2026-11-13`)
 
 # Run examples
 node examples/basic.js
@@ -267,7 +287,7 @@ node examples/basic.js
 Built with Rust and NAPI-RS for native-level performance:
 - **Fast execution**: Native Rust performance via NAPI bindings
 - **Low memory usage**: Optimized memory footprint across all modes
-- **Test performance**: All 577 tests complete in < 1 second
+- **Test performance**: All 601 tests complete in < 1 second
 
 ### Memory Modes
 
@@ -337,6 +357,49 @@ for await (const item of cursor) {
 This keeps memory bounded to the current cursor item while retaining
 constant-memory worksheet generation.
 
+### Node.js vs Bun Benchmarks
+
+The runtime benchmark executes the same package workload through the same
+release N-API binary on Node.js and Bun:
+
+```bash
+npm run benchmark:runtimes
+```
+
+Bun must be installed and available in `PATH`. The default workload generates
+200,000 rows × 20 columns through `writeRow()` in constant-memory mode. The
+runner alternates runtime order across three runs, reports both in-process
+generation time and end-to-end process wall time, and verifies identical
+worksheet XML size and CRC for every Node.js/Bun pair.
+
+Override the workload or package API, or reuse the existing release build:
+
+```bash
+npm run benchmark:runtimes -- --rows 100000 --columns 20 --runs 5
+npm run benchmark:runtimes -- --write-mode cell
+npm run benchmark:runtimes -- --write-mode batch --batch-rows 1000
+npm run benchmark:runtimes -- --skip-build
+```
+
+#### ExcelJS runtime comparison
+
+To isolate the runtime difference for a JavaScript XLSX implementation, run the
+same dataset through the ExcelJS streaming writer:
+
+```bash
+npm run benchmark:runtimes:exceljs
+```
+
+This profile uses ExcelJS `stream.xlsx.WorkbookWriter`, disables styles and
+shared strings, fixes ZIP DEFLATE compression at level 6, and commits every
+row. It uses the same alternating order, timing and memory metrics, and
+worksheet-equivalence checks as the native-package profile. Override the
+default workload when needed:
+
+```bash
+npm run benchmark:runtimes:exceljs -- --rows 100000 --columns 20 --runs 5
+```
+
 ### Node.js vs Go, C#, and Python Benchmark
 
 The cross-language benchmark compares concrete streaming XLSX libraries, not

package/index.d.ts

@@ -1,5 +1,14 @@
 /* auto-generated by NAPI-RS */
 /* eslint-disable */
+
+/**
+ * Which binding artifact the generated loader actually loaded: `'native'` for
+ * a native addon, otherwise the `platformArchABI` of the WASI flavor. Every
+ * flavor napi-rs can build is listed, because `NAPI_RS_NATIVE_LIBRARY_PATH`
+ * can point the loader at a WASI artifact this package does not build itself.
+ */
+export declare const __napiBindingTarget: 'native' | 'wasm32-wasi' | 'wasm32-wasip1'
+
 export declare class RuscButton {
   /** Create a new Button */
   static new(): RuscButton
@@ -277,10 +286,10 @@ export declare class RuscRichText {
   /** Create a new empty rich text string */
   constructor()
   /**
-   * Add a text segment with formatting
-   * The format is cloned internally for storage
+   * Add a text segment, optionally formatted; without a format the segment uses
+   * the default cell font. The format is cloned internally for storage.
    */
-  addSegment(text: string, format: RuscFormat): this
+  addSegment(text: string, format?: RuscFormat | undefined | null): this
 }
 
 export declare class RuscShape {
@@ -301,7 +310,10 @@ export declare class RuscShape {
 export declare class RuscSparkline {
   /** Create a new Sparkline */
   static new(): RuscSparkline
-  /** Set the data range for the sparkline (e.g., "Sheet1!A1:E1") */
+  /**
+   * Set the data range for the sparkline, e.g. "Sheet1!A1:E1", or "A1:E1"
+   * for a range on the worksheet the sparkline is added to
+   */
   setRange(range: string): this
   /** Set the type of sparkline: 'line', 'column', or 'winLose' */
   setType(sparklineType: string): this
@@ -374,7 +386,10 @@ export declare class RuscTable {
   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) */
+  /**
+   * Set the style of the table: 0 for no style, 1-21 for light styles,
+   * 22-49 for medium styles and 50-60 for dark styles
+   */
   setStyle(styleId: number): this
   /** Add columns to the table */
   setColumns(columns: Array<RuscTableColumn>): this
@@ -410,6 +425,21 @@ export declare class RuscWorkbook {
    * Must be called before adding worksheets.
    */
   setDefaultFormat(format: RuscFormat, rowHeight: number, columnWidth: number): void
+  /**
+   * Set the zip compression level of the xlsx container (1-9, default 6).
+   * Lower levels are faster, higher levels produce smaller files.
+   */
+  setZipCompressionLevel(level: number): void
+  /**
+   * Set when Excel recalculates formulas: "automatic" (default), "manual",
+   * or "partial" (automatic except for data tables).
+   */
+  setCalculationMode(mode: string): void
+  /**
+   * Set the width of the worksheet tab bar as a percentage (0-100, default
+   * 60) of the space it shares with the horizontal scroll bar.
+   */
+  setTabRatio(ratio: number): void
   /**
    * Use the Excel 2023 Office theme with the Aptos default font.
    * Must be called before adding worksheets.
@@ -452,20 +482,25 @@ export declare class RuscWorkbook {
 
 /** Worksheet wrapper for Excel sheet manipulation */
 export declare class RuscWorksheet {
-  /** Write a value to a cell (auto-detects type) */
-  write(row: number, col: number, value: string | number | boolean, format?: RuscFormat | undefined | null): void
+  /**
+   * Write a value to a cell (auto-detects type). `null` or `undefined`
+   * writes nothing, or a blank cell with the format when one is given.
+   */
+  write(row: number, col: number, value: string | number | boolean | null | undefined, format?: RuscFormat | undefined | null): void
   /**
    * Write an array of values as a row starting at the given column.
    * 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).
+   * Values are written as `write` writes them: `null`, `undefined` and
+   * holes leave the cell empty, or write a blank cell with the format.
    */
   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 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).
+   * Values are written as `write` writes them: `null`, `undefined` and
+   * holes leave the cell empty, or write a blank cell with the format.
    */
   writeRows(startRow: number, startCol: number, rows: unknown[], format?: RuscFormat | undefined | null): void
   /** Write a string to a cell */
@@ -488,8 +523,11 @@ export declare class RuscWorksheet {
   writeDatetimeFromYmdHms(row: number, col: number, year: number, month: number, day: number, hour: number, min: number, sec: number, format?: RuscFormat | undefined | null): void
   /** Write a datetime from an ISO 8601 string (e.g., "2023-01-25T12:30:00") */
   writeDatetimeFromString(row: number, col: number, datetimeStr: string, format?: RuscFormat | undefined | null): void
-  /** Write a value with formatting to a cell */
-  writeWithFormat(row: number, col: number, value: string | number | boolean, format: RuscFormat): void
+  /**
+   * Write a value with formatting to a cell; `null` or `undefined` writes
+   * a blank cell with the format
+   */
+  writeWithFormat(row: number, col: number, value: string | number | boolean | null | undefined, format: RuscFormat): void
   /** Set the width of a column */
   setColumnWidth(col: number, width: number): void
   /** Set the height of a row */
@@ -600,6 +638,11 @@ export declare class RuscWorksheet {
   setHidden(enable: boolean): void
   /** Set the worksheet zoom level (10-400) */
   setZoom(zoom: number): void
+  /**
+   * Hide zero values in worksheet cells, the equivalent of turning off the
+   * Excel option "Show a zero in cells that have zero value"
+   */
+  setHiddenZeroes(enable: boolean): void
   /** Set the default cell selection when opening the worksheet */
   setSelection(firstRow: number, firstCol: number, lastRow: number, lastCol: number): void
   /** Set which cell appears in the top-left corner when opening the worksheet */
@@ -640,8 +683,23 @@ export declare class RuscWorksheet {
   insertShapeWithOffset(row: number, col: number, shape: RuscShape, xOffset: number, yOffset: number): void
 }
 
-/** Resets peak memory tracking to current usage */
+/**
+ * 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
 
-/** Returns [currentBytes, peakBytes] of Rust allocator usage */
-export declare function rustMemoryStats(): Array<number>
+/**
+ * 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]

package/index.js

@@ -1,10 +1,18 @@
-// prettier-ignore
 /* eslint-disable */
 // @ts-nocheck
 /* auto-generated by NAPI-RS */
 
 const { readFileSync } = require('fs')
 let nativeBinding = null
+// Which artifact actually loaded. The WASI fallback chain overwrites it with
+// the flavor it resolved; the late native retry below leaves it alone because
+// it only runs while no WASI candidate has been loaded. The take-over check
+// after the load-failure block can also set it.
+let __napiLoadedBindingTarget = 'native'
+// What this loader's own `requireNative()` calls returned. The check after
+// the load-failure block compares it with `nativeBinding` to tell a binding
+// this loader loaded from one that code outside it put in its place.
+let __napiRequiredNativeBinding = null
 const loadErrors = []
 
 const isMusl = () => {
@@ -63,7 +71,16 @@ const isMuslFromChildProcess = () => {
 function requireNative() {
   if (process.env.NAPI_RS_NATIVE_LIBRARY_PATH) {
     try {
-      return require(process.env.NAPI_RS_NATIVE_LIBRARY_PATH);
+      const overrideBinding = require(process.env.NAPI_RS_NATIVE_LIBRARY_PATH)
+      // The override may be a generated WASI loader, which already reports its
+      // own flavor. Adopt it: `module.exports` aliases this object, so claiming
+      // 'native' would both misreport the artifact and overwrite the loader's
+      // marker through the alias.
+      __napiLoadedBindingTarget =
+        overrideBinding && typeof overrideBinding.__napiBindingTarget === 'string'
+          ? overrideBinding.__napiBindingTarget
+          : 'native'
+      return overrideBinding
     } catch (err) {
       loadErrors.push(err)
     }
@@ -107,36 +124,36 @@ function requireNative() {
     if (process.arch === 'x64') {
       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) {
-        loadErrors.push(e)
-      }
-      try {
-        const binding = require('@nazarkalytiuk/rusc-xlsx-win32-x64-gnu')
-        const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-win32-x64-gnu/package.json').version
-        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 require('./rusc_xlsx.win32-x64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@nazarkalytiuk/rusc-xlsx-win32-x64-gnu')
+          const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-win32-x64-gnu/package.json').version
+          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) {
+          loadErrors.push(e)
         }
-        return binding
-      } catch (e) {
-        loadErrors.push(e)
-      }
       } else {
         try {
-        return require('./rusc_xlsx.win32-x64-msvc.node')
-      } catch (e) {
-        loadErrors.push(e)
-      }
-      try {
-        const binding = require('@nazarkalytiuk/rusc-xlsx-win32-x64-msvc')
-        const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-win32-x64-msvc/package.json').version
-        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 require('./rusc_xlsx.win32-x64-msvc.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@nazarkalytiuk/rusc-xlsx-win32-x64-msvc')
+          const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-win32-x64-msvc/package.json').version
+          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) {
+          loadErrors.push(e)
         }
-        return binding
-      } catch (e) {
-        loadErrors.push(e)
-      }
       }
     } else if (process.arch === 'ia32') {
       try {
@@ -257,6 +274,22 @@ function requireNative() {
       } catch (e) {
         loadErrors.push(e)
       }
+    } else if (process.arch === 'ppc64') {
+      try {
+        return require('./rusc_xlsx.freebsd-ppc64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@nazarkalytiuk/rusc-xlsx-freebsd-ppc64')
+        const bindingPackageVersion = require('@nazarkalytiuk/rusc-xlsx-freebsd-ppc64/package.json').version
+        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) {
+        loadErrors.push(e)
+      }
     } else {
       loadErrors.push(new Error(`Unsupported architecture on FreeBSD: ${process.arch}`))
     }
@@ -550,7 +583,7 @@ function createLoadErrorChain(errors) {
 //
 // 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 __napiWasiFlavors = ['wasm32-wasi']
 const __napiWasiFlavor = process.env.NAPI_RS_WASI_FLAVOR
 const __napiWasiFlavorRequested =
   typeof __napiWasiFlavor === 'string' && __napiWasiFlavor.length > 0
@@ -573,6 +606,7 @@ const forceWasi =
 
 if (!forceWasi) {
   nativeBinding = requireNative()
+  __napiRequiredNativeBinding = nativeBinding
 }
 
 if (!nativeBinding || forceWasi) {
@@ -619,15 +653,16 @@ if (!nativeBinding || forceWasi) {
     }
     return null
   }
-  if (!wasiBindingLoaded && (!__napiWasiFlavorRequested || __napiWasiFlavor === "wasm32-wasi")) {
+  if (!wasiBindingLoaded && (!__napiWasiFlavorRequested || __napiWasiFlavor === 'wasm32-wasi')) {
     let candidateError = null
     let candidateFailed = false
     try {
-      candidateError = __napiWasiResolveCandidate('./rusc_xlsx.wasi.cjs', false, ["./rusc_xlsx.wasm32-wasi.debug.wasm","./rusc_xlsx.wasm32-wasi.wasm"])
+      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
+        __napiLoadedBindingTarget = 'wasm32-wasi'
         wasiBindingLoaded = true
       }
     } catch (err) {
@@ -639,7 +674,7 @@ if (!nativeBinding || forceWasi) {
       loadErrors.push(candidateError)
     }
   }
-  if (!wasiBindingLoaded && (!__napiWasiFlavorRequested || __napiWasiFlavor === "wasm32-wasi")) {
+  if (!wasiBindingLoaded && (!__napiWasiFlavorRequested || __napiWasiFlavor === 'wasm32-wasi')) {
     let candidateError = null
     let candidateFailed = false
     try {
@@ -654,6 +689,7 @@ if (!nativeBinding || forceWasi) {
         }
         wasiBinding = require('@nazarkalytiuk/rusc-xlsx-wasm32-wasi')
         nativeBinding = wasiBinding
+        __napiLoadedBindingTarget = 'wasm32-wasi'
         wasiBindingLoaded = true
       }
     } catch (err) {
@@ -672,6 +708,7 @@ if (!nativeBinding || forceWasi) {
     !__napiWasiFlavorRequested
   ) {
     nativeBinding = requireNative()
+    __napiRequiredNativeBinding = nativeBinding
   }
   if ((forceWasiError || __napiWasiFlavorRequested) && !wasiBindingLoaded) {
     const error = new Error(
@@ -699,6 +736,104 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
+// A package can patch its own fallback in front of the load-failure check
+// above, e.g. a WebContainer download through `napi-postinstall/fallback`.
+// That fallback swaps `nativeBinding` for a generated WASI loader, which has
+// already stamped its own flavor, while the target above still says 'native'.
+// Take that flavor over, or the CommonJS stamp throws a conflict and the ESM
+// export reports the wrong artifact. Three limits keep the conflict check:
+// - only a binding this loader did not load itself, so a native addon whose
+//   `#[napi(module_exports)]` hook claims the name is still rejected;
+// - only an own data property, read through its descriptor, so no addon
+//   getter runs here, and it must read back the same, as the stamp reads it;
+// - only a flavor in `__napiWasiFlavors`, the ones this loader's own WASI
+//   chain can report ('wasm32-wasi' for a package without a WASI target).
+// This is metadata and never fails a load: a throwing Proxy trap keeps 'native'.
+if (
+  __napiLoadedBindingTarget === 'native' &&
+  nativeBinding !== __napiRequiredNativeBinding
+) {
+  try {
+    const __napiBindingTargetDescriptor = Object.getOwnPropertyDescriptor(
+      nativeBinding,
+      '__napiBindingTarget',
+    )
+    if (
+      __napiBindingTargetDescriptor &&
+      __napiWasiFlavors.indexOf(__napiBindingTargetDescriptor.value) !== -1 &&
+      nativeBinding.__napiBindingTarget === __napiBindingTargetDescriptor.value
+    ) {
+      __napiLoadedBindingTarget = __napiBindingTargetDescriptor.value
+    }
+  } catch {
+    // keep 'native'
+  }
+}
+
+function __napiStampBindingTarget(exportsObject, target) {
+  if (
+    Object.prototype.hasOwnProperty.call(exportsObject, '__napiBindingTarget')
+  ) {
+    if (exportsObject.__napiBindingTarget === target) {
+      // Already ours: the root entry aliases the object it loaded, so a WASI
+      // fallback candidate — or a `NAPI_RS_NATIVE_LIBRARY_PATH` override that
+      // is a generated loader — arrives already stamped with this same value.
+      return target
+    }
+    const error = new Error(
+      '`__napiBindingTarget` is reserved by the generated binding loader, but the loaded binding already exports it. Rename the export, e.g. #[napi(js_name = "...")].',
+    )
+    error.code = 'ERR_NAPI_BINDING_TARGET_CONFLICT'
+    throw error
+  }
+  if (!Object.isExtensible(exportsObject)) {
+    // A `#[napi(module_exports)]` hook may seal or freeze this object
+    // (`Object::seal` / `Object::freeze`). Reporting the artifact is metadata,
+    // never a reason to fail an otherwise successful load, so the stamp is
+    // skipped. What a consumer still sees then follows the entry point: the
+    // browser and deferred loaders declare `__napiBindingTarget` at module
+    // level and go on reporting it, while the CommonJS entries hand back this
+    // very object as `module.exports`, so there the value is absent.
+    return target
+  }
+  try {
+    // [[Define]], not [[Set]]: an ordinary assignment walks the prototype
+    // chain, so an inherited accessor could swallow the value or throw and
+    // fail an otherwise successful load. The descriptor is what a successful
+    // assignment would have produced.
+    Object.defineProperty(exportsObject, '__napiBindingTarget', {
+      configurable: true,
+      enumerable: true,
+      value: target,
+      writable: true,
+    })
+  } catch {
+    // Same rule as the non-extensible skip above: reporting the artifact is
+    // metadata, never a reason to fail an otherwise successful load. An exotic
+    // object (a Proxy whose defineProperty trap refuses) is skipped, not
+    // thrown over.
+  }
+  // The CommonJS loaders assign this return value so `cjs-module-lexer` — and
+  // therefore Node's CJS -> ESM named export detection — can see
+  // `__napiBindingTarget` statically.
+  return target
+}
+// Stamp before the alias, not after. The guard only reads `nativeBinding`
+// (`hasOwnProperty` plus a comparison), which is safe against any addon
+// accessor; an assignment is not, because a `#[napi(module_exports)]` hook can
+// expose a getter reporting this very value and a setter that throws. So the
+// assignment lands on the loader's own `module.exports`, still the original
+// object here, and the alias below replaces it.
+//
+// The assignment is what keeps the marker a statically visible CommonJS export:
+// `cjs-module-lexer` is Node's CJS -> ESM named export detection, it cannot see
+// a bare call, and the later `module.exports = nativeBinding` does not undo the
+// detection. The assignment itself always succeeds — its target is this
+// loader's own, still extensible `module.exports` — and the alias below then
+// discards the value it wrote. What a consumer reads is whatever the guard put
+// on `nativeBinding`, so on a frozen binding, where the guard skips, the
+// linked import resolves to `undefined`.
+module.exports.__napiBindingTarget = __napiStampBindingTarget(nativeBinding, __napiLoadedBindingTarget)
 module.exports = nativeBinding
 module.exports.RuscButton = nativeBinding.RuscButton
 module.exports.RuscChart = nativeBinding.RuscChart

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@nazarkalytiuk/rusc-xlsx",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Fast Excel XLSX library for Node.js powered by rust_xlsxwriter",
+  "type": "commonjs",
   "main": "wrapper.js",
   "types": "wrapper.d.ts",
   "repository": {
@@ -32,14 +33,29 @@
     "artifacts": "napi artifacts",
     "build": "napi build --platform --release",
     "build:debug": "napi build --platform",
+    "build:wrapper": "tsdown",
+    "prepare": "tsdown",
     "benchmark": "node benchmarks/compare-generation.js",
     "benchmark:languages": "node benchmarks/compare-languages.js",
-    "prepublishOnly": "napi prepublish -t npm",
-    "test": "jest",
+    "benchmark:runtimes": "node benchmarks/compare-runtimes.js",
+    "benchmark:runtimes:exceljs": "node benchmarks/compare-runtimes.js --library exceljs",
+    "prepublishOnly": "napi prepublish -t npm --no-gh-release",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:coverage:rust": "bash scripts/rust-coverage.sh",
+    "lint": "oxlint --deny-warnings",
+    "lint:rust": "cargo clippy --locked --all-targets -- -D warnings",
+    "fmt": "oxfmt && cargo fmt --all",
+    "fmt:check": "oxfmt --check && cargo fmt --all -- --check",
+    "lint:package": "publint --strict && attw --pack .",
     "typecheck": "tsc --project tsconfig.json",
+    "check": "npm run fmt:check && npm run lint && npm run lint:rust && npm run lint:package && npm run typecheck && npm run coverage:check",
     "universal": "napi universalize",
     "version": "napi version",
-    "clean": "cargo clean && rm -rf *.node"
+    "clean": "cargo clean && rm -rf *.node",
+    "coverage:sync": "node scripts/coverage-checklist/cli.mts",
+    "coverage:check": "node scripts/coverage-checklist/cli.mts --check"
   },
   "keywords": [
     "xlsx",
@@ -61,22 +77,33 @@
     "LICENSE"
   ],
   "devDependencies": {
-    "@napi-rs/cli": "^3.8.2",
-    "@types/node": "^24.13.3",
-    "adm-zip": "^0.6.0",
-    "jest": "^30.4.2",
-    "typescript": "^7.0.2"
+    "@arethetypeswrong/cli": "^0.18.5",
+    "@napi-rs/cli": "^3.10.12",
+    "@types/node": "^26.6.6",
+    "@vitest/coverage-v8": "^5.1.0",
+    "adm-zip": "^0.6.1",
+    "exceljs": "^4.4.0",
+    "oxc-parser": "^0.158.0",
+    "oxfmt": "^0.78.0",
+    "oxlint": "^1.93.0",
+    "publint": "^0.3.25",
+    "tsdown": "^0.23.7",
+    "typescript": "^7.0.2",
+    "vitest": "^5.1.0"
   },
   "engines": {
     "node": ">=22.13.0"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "optionalDependencies": {
-    "@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"
+    "@nazarkalytiuk/rusc-xlsx-win32-x64-msvc": "2.1.0",
+    "@nazarkalytiuk/rusc-xlsx-win32-ia32-msvc": "2.1.0",
+    "@nazarkalytiuk/rusc-xlsx-win32-arm64-msvc": "2.1.0",
+    "@nazarkalytiuk/rusc-xlsx-darwin-universal": "2.1.0",
+    "@nazarkalytiuk/rusc-xlsx-linux-x64-gnu": "2.1.0",
+    "@nazarkalytiuk/rusc-xlsx-linux-arm64-gnu": "2.1.0",
+    "@nazarkalytiuk/rusc-xlsx-linux-x64-musl": "2.1.0"
   }
-}
+}