@medicomind/rolldown-compression 2.1.1 → 2.1.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @medicomind/rolldown-compression
 
+## 2.1.2
+
+### Patch Changes
+
+- [`6e0b693`](https://github.com/Medico-Mind/rolldown-compression/commit/6e0b693fd24338102876ecb4bb605ed37e1a3804) Thanks [@Mnwa](https://github.com/Mnwa)! - Default brotli `sectionSize` to one window (`2^windowBits` bytes) instead of a fixed 4 MiB, so a custom `windowBits` gets a matching section size. Unchanged at the default window of 22, where both are 4 MiB.
+
 ## 2.1.1
 
 ### Patch Changes

package/README.md

@@ -104,7 +104,7 @@ All options are validated when `compression()` is called — invalid levels (e.g
 | `gzip`    | `level`       | 0–9         | 6       |
 | `brotli`  | `quality`     | 0–11        | 11      |
 | `brotli`  | `windowBits`  | 10–24       | 22      |
-| `brotli`  | `sectionSize` | ≥ 1 (bytes) | 4 MiB   |
+| `brotli`  | `sectionSize` | ≥ 1 (bytes) | `2^windowBits` B |
 | `zstd`    | `level`       | 1–22        | 19      |
 
 ```ts
@@ -113,7 +113,7 @@ defineAlgorithm('brotli', { quality: 7, windowBits: 22 })
 defineAlgorithm('zstd', { level: 12 })
 ```
 
-`sectionSize` is the target number of bytes each brotli worker thread compresses when a large input is split across the native worker pool; inputs at least four times `sectionSize` take the multithreaded path (16 MiB at the default). Smaller sections finish large files faster at a slight cost in compression ratio — sections much smaller than the window (`2^windowBits` bytes) lose too many cross-section matches.
+`sectionSize` is the target number of bytes each brotli worker thread compresses when a large input is split across the native worker pool; inputs at least four times `sectionSize` take the multithreaded path. It defaults to one window (`2^windowBits` bytes) — 4 MiB and multithreading from 16 MiB at the default window — because sections much smaller than the window lose too many cross-section matches. Smaller sections finish large files faster at a slight cost in compression ratio.
 
 ## How it works
 

package/dist/index.d.cts

@@ -12,9 +12,9 @@ interface GzipOptions {
  * Brotli options. `quality`: 0-11, default 11. `windowBits`: 10-24, default 22.
  * `sectionSize`: target bytes per worker thread when large inputs are split
  * across the native brotli worker pool; inputs at least four times this size
- * take the multithreaded path. Default 4 MiB (multithreading from 16 MiB).
- * Smaller sections finish large files faster at a slight cost in compression
- * ratio.
+ * take the multithreaded path. Defaults to one window (`2^windowBits` bytes),
+ * i.e. 4 MiB and multithreading from 16 MiB at the default window. Smaller
+ * sections finish large files faster at a slight cost in compression ratio.
  */
 interface BrotliOptions {
   quality?: number;

package/dist/index.d.mts

@@ -12,9 +12,9 @@ interface GzipOptions {
  * Brotli options. `quality`: 0-11, default 11. `windowBits`: 10-24, default 22.
  * `sectionSize`: target bytes per worker thread when large inputs are split
  * across the native brotli worker pool; inputs at least four times this size
- * take the multithreaded path. Default 4 MiB (multithreading from 16 MiB).
- * Smaller sections finish large files faster at a slight cost in compression
- * ratio.
+ * take the multithreaded path. Defaults to one window (`2^windowBits` bytes),
+ * i.e. 4 MiB and multithreading from 16 MiB at the default window. Smaller
+ * sections finish large files faster at a slight cost in compression ratio.
  */
 interface BrotliOptions {
   quality?: number;

package/index.d.ts

@@ -56,8 +56,9 @@ export interface CompressTask {
   /**
    * Brotli only: target section size in bytes per worker thread when
    * large inputs are split across the brotli worker pool; inputs at
-   * least four times this size take the multithreaded path
-   * (default 4 MiB, i.e. multithreading from 16 MiB).
+   * least four times this size take the multithreaded path. Defaults
+   * to one window (`2^windowBits` bytes), i.e. 4 MiB and
+   * multithreading from 16 MiB at the default window.
    */
   sectionSize?: number
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@medicomind/rolldown-compression",
-  "version": "2.1.1",
+  "version": "2.1.2",
   "description": "Fast native (Rust) gzip / brotli / zstd compression plugin for Rolldown, powered by napi-rs",
   "keywords": [
     "rolldown",
@@ -91,13 +91,13 @@
     "rolldown": "^1.0.0"
   },
   "optionalDependencies": {
-    "@medicomind/rolldown-compression-darwin-arm64": "2.1.1",
-    "@medicomind/rolldown-compression-darwin-x64": "2.1.1",
-    "@medicomind/rolldown-compression-linux-arm64-gnu": "2.1.1",
-    "@medicomind/rolldown-compression-linux-x64-gnu": "2.1.1",
-    "@medicomind/rolldown-compression-linux-x64-musl": "2.1.1",
-    "@medicomind/rolldown-compression-wasm32-wasi": "2.1.1",
-    "@medicomind/rolldown-compression-win32-x64-msvc": "2.1.1"
+    "@medicomind/rolldown-compression-darwin-arm64": "2.1.2",
+    "@medicomind/rolldown-compression-darwin-x64": "2.1.2",
+    "@medicomind/rolldown-compression-linux-arm64-gnu": "2.1.2",
+    "@medicomind/rolldown-compression-linux-x64-gnu": "2.1.2",
+    "@medicomind/rolldown-compression-linux-x64-musl": "2.1.2",
+    "@medicomind/rolldown-compression-wasm32-wasi": "2.1.2",
+    "@medicomind/rolldown-compression-win32-x64-msvc": "2.1.2"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.3",