djvu-rs 0.30.2 → 0.32.0

package/README.md

@@ -199,8 +199,13 @@ Layered `quality` / `archival` encodes default to fixed BT.601 thresholding.
 `--binarization sauvola` opts into adaptive local thresholding for mixed or
 uneven lighting; tune it with `--sauvola-window` and `--sauvola-k`.
 `--bg-inpaint` fills fully masked background blocks from neighbouring unmasked
-pixels, which can reduce dark boxes under heavy text strokes. These knobs are
-opt-in, only affect layered profiles, and do not change lossless JB2 defaults.
+pixels, which can reduce dark boxes under heavy text strokes.
+`--block-classify` routes photo and halftone blocks wholly to the background
+layer instead of shredding them into mask speckle (mixed text+photo layouts);
+pair it with `--adaptive-bg-subsample`, which densifies the background grid
+where unmasked detail warrants it, so routed photos keep their detail. These
+knobs are opt-in, only affect layered profiles, and do not change lossless
+JB2 defaults.
 Library callers can use the same controls with `PageEncoder::with_segment_options`.
 For newly encoded pages, `PageEncoder::with_metadata` emits a `METz` chunk;
 for existing documents, `DjVuDocumentMut::page_mut(...).set_metadata(...)`

package/djvu_rs.d.ts

@@ -23,16 +23,16 @@ export class WasmDocument {
      * Throws a JavaScript `Error` if the bytes are not a valid DjVu file.
      */
     static from_bytes(data: Uint8Array): WasmDocument;
+    /**
+     * Total number of pages in the document.
+     */
+    page_count(): number;
     /**
      * Return a handle to page `index` (0-based).
      *
      * Throws if `index >= page_count()`.
      */
     page(index: number): WasmPage;
-    /**
-     * Total number of pages in the document.
-     */
-    page_count(): number;
     /**
      * Render a contiguous batch of pages at `target_dpi`, returning one
      * [`WasmPixmap`] per page in input order (#610).
@@ -72,13 +72,6 @@ export class WasmPage {
      * Output height in pixels when rendered at `target_dpi`.
      */
     height_at(target_dpi: number): number;
-    /**
-     * Render the page at `target_dpi` and return raw RGBA pixels
-     * (`Uint8ClampedArray`, suitable for `new ImageData(pixels, w, h)`).
-     *
-     * Throws on decode error.
-     */
-    render(target_dpi: number): Uint8ClampedArray;
     /**
      * Fast coarse render — decodes only the first BG44 chunk (~5 ms for a
      * typical color page).
@@ -91,6 +84,13 @@ export class WasmPage {
      * Throws on decode error.
      */
     render_coarse(target_dpi: number): Uint8ClampedArray | undefined;
+    /**
+     * Render the page at `target_dpi` and return raw RGBA pixels
+     * (`Uint8ClampedArray`, suitable for `new ImageData(pixels, w, h)`).
+     *
+     * Throws on decode error.
+     */
+    render(target_dpi: number): Uint8ClampedArray;
     /**
      * Render into a caller-owned [`WasmPixmap`], reusing its Rust-side
      * allocation (#611). No JS-side allocation, no wasm→JS copy — consume

package/package.json

@@ -2,7 +2,7 @@
   "name": "djvu-rs",
   "type": "module",
   "description": "Read, render, convert, and create DjVu files. Pure-Rust DjVu decoder/encoder with CLI, WebAssembly, and Python bindings. DjVu to PDF, EPUB, TIFF, PNG, and text. MIT licensed, no GPL dependencies.",
-  "version": "0.30.2",
+  "version": "0.32.0",
   "license": "MIT",
   "repository": {
     "type": "git",

package/scalar/README.md

@@ -199,8 +199,13 @@ Layered `quality` / `archival` encodes default to fixed BT.601 thresholding.
 `--binarization sauvola` opts into adaptive local thresholding for mixed or
 uneven lighting; tune it with `--sauvola-window` and `--sauvola-k`.
 `--bg-inpaint` fills fully masked background blocks from neighbouring unmasked
-pixels, which can reduce dark boxes under heavy text strokes. These knobs are
-opt-in, only affect layered profiles, and do not change lossless JB2 defaults.
+pixels, which can reduce dark boxes under heavy text strokes.
+`--block-classify` routes photo and halftone blocks wholly to the background
+layer instead of shredding them into mask speckle (mixed text+photo layouts);
+pair it with `--adaptive-bg-subsample`, which densifies the background grid
+where unmasked detail warrants it, so routed photos keep their detail. These
+knobs are opt-in, only affect layered profiles, and do not change lossless
+JB2 defaults.
 Library callers can use the same controls with `PageEncoder::with_segment_options`.
 For newly encoded pages, `PageEncoder::with_metadata` emits a `METz` chunk;
 for existing documents, `DjVuDocumentMut::page_mut(...).set_metadata(...)`

package/scalar/djvu_rs.d.ts

@@ -23,16 +23,16 @@ export class WasmDocument {
      * Throws a JavaScript `Error` if the bytes are not a valid DjVu file.
      */
     static from_bytes(data: Uint8Array): WasmDocument;
+    /**
+     * Total number of pages in the document.
+     */
+    page_count(): number;
     /**
      * Return a handle to page `index` (0-based).
      *
      * Throws if `index >= page_count()`.
      */
     page(index: number): WasmPage;
-    /**
-     * Total number of pages in the document.
-     */
-    page_count(): number;
     /**
      * Render a contiguous batch of pages at `target_dpi`, returning one
      * [`WasmPixmap`] per page in input order (#610).
@@ -72,13 +72,6 @@ export class WasmPage {
      * Output height in pixels when rendered at `target_dpi`.
      */
     height_at(target_dpi: number): number;
-    /**
-     * Render the page at `target_dpi` and return raw RGBA pixels
-     * (`Uint8ClampedArray`, suitable for `new ImageData(pixels, w, h)`).
-     *
-     * Throws on decode error.
-     */
-    render(target_dpi: number): Uint8ClampedArray;
     /**
      * Fast coarse render — decodes only the first BG44 chunk (~5 ms for a
      * typical color page).
@@ -91,6 +84,13 @@ export class WasmPage {
      * Throws on decode error.
      */
     render_coarse(target_dpi: number): Uint8ClampedArray | undefined;
+    /**
+     * Render the page at `target_dpi` and return raw RGBA pixels
+     * (`Uint8ClampedArray`, suitable for `new ImageData(pixels, w, h)`).
+     *
+     * Throws on decode error.
+     */
+    render(target_dpi: number): Uint8ClampedArray;
     /**
      * Render into a caller-owned [`WasmPixmap`], reusing its Rust-side
      * allocation (#611). No JS-side allocation, no wasm→JS copy — consume

package/scalar/djvu_rs.js

@@ -45,6 +45,14 @@ export class WasmDocument {
         }
         return WasmDocument.__wrap(ret[0]);
     }
+    /**
+     * Total number of pages in the document.
+     * @returns {number}
+     */
+    page_count() {
+        const ret = wasm.wasmdocument_page_count(this.__wbg_ptr);
+        return ret >>> 0;
+    }
     /**
      * Return a handle to page `index` (0-based).
      *
@@ -59,14 +67,6 @@ export class WasmDocument {
         }
         return WasmPage.__wrap(ret[0]);
     }
-    /**
-     * Total number of pages in the document.
-     * @returns {number}
-     */
-    page_count() {
-        const ret = wasm.wasmdocument_page_count(this.__wbg_ptr);
-        return ret >>> 0;
-    }
     /**
      * Render a contiguous batch of pages at `target_dpi`, returning one
      * [`WasmPixmap`] per page in input order (#610).
@@ -145,21 +145,6 @@ export class WasmPage {
         const ret = wasm.wasmpage_height_at(this.__wbg_ptr, target_dpi);
         return ret >>> 0;
     }
-    /**
-     * Render the page at `target_dpi` and return raw RGBA pixels
-     * (`Uint8ClampedArray`, suitable for `new ImageData(pixels, w, h)`).
-     *
-     * Throws on decode error.
-     * @param {number} target_dpi
-     * @returns {Uint8ClampedArray}
-     */
-    render(target_dpi) {
-        const ret = wasm.wasmpage_render(this.__wbg_ptr, target_dpi);
-        if (ret[2]) {
-            throw takeFromExternrefTable0(ret[1]);
-        }
-        return takeFromExternrefTable0(ret[0]);
-    }
     /**
      * Fast coarse render — decodes only the first BG44 chunk (~5 ms for a
      * typical color page).
@@ -180,6 +165,21 @@ export class WasmPage {
         }
         return takeFromExternrefTable0(ret[0]);
     }
+    /**
+     * Render the page at `target_dpi` and return raw RGBA pixels
+     * (`Uint8ClampedArray`, suitable for `new ImageData(pixels, w, h)`).
+     *
+     * Throws on decode error.
+     * @param {number} target_dpi
+     * @returns {Uint8ClampedArray}
+     */
+    render(target_dpi) {
+        const ret = wasm.wasmpage_render(this.__wbg_ptr, target_dpi);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * Render into a caller-owned [`WasmPixmap`], reusing its Rust-side
      * allocation (#611). No JS-side allocation, no wasm→JS copy — consume
@@ -479,29 +479,29 @@ if (Symbol.dispose) WasmPixmap.prototype[Symbol.dispose] = WasmPixmap.prototype.
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
-        __wbg_Error_408e67f47ca7b58b: function(arg0, arg1) {
+        __wbg_Error_67e7344beaa85059: function(arg0, arg1) {
             const ret = Error(getStringFromWasm0(arg0, arg1));
             return ret;
         },
-        __wbg___wbindgen_throw_bb96b2010945f0bc: function(arg0, arg1) {
+        __wbg___wbindgen_throw_5d9e815e6fdf150f: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
-        __wbg_length_13032799523c5735: function(arg0) {
+        __wbg_length_ff98c95d19109ba4: function(arg0) {
             const ret = arg0.length;
             return ret;
         },
-        __wbg_new_with_length_5d351ffdb6e3397d: function(arg0) {
+        __wbg_new_with_length_ac9c609232fb2d1d: function(arg0) {
             const ret = new Uint8ClampedArray(arg0 >>> 0);
             return ret;
         },
-        __wbg_set_5c15d3c5973de97a: function(arg0, arg1, arg2) {
+        __wbg_set_0488601468e80715: function(arg0, arg1, arg2) {
             arg0.set(getArrayU8FromWasm0(arg1, arg2));
         },
         __wbg_wasmpixmap_new: function(arg0) {
             const ret = WasmPixmap.__wrap(arg0);
             return ret;
         },
-        __wbindgen_cast_0000000000000001: function(arg0, arg1) {
+        __wbindgen_generic_0000000000000001: function(arg0, arg1) {
             // Cast intrinsic for `Ref(Slice(U8)) -> NamedExternref("Uint8ClampedArray")`.
             const ret = getArrayU8FromWasm0(arg0, arg1);
             return ret;

package/simd128/README.md

@@ -199,8 +199,13 @@ Layered `quality` / `archival` encodes default to fixed BT.601 thresholding.
 `--binarization sauvola` opts into adaptive local thresholding for mixed or
 uneven lighting; tune it with `--sauvola-window` and `--sauvola-k`.
 `--bg-inpaint` fills fully masked background blocks from neighbouring unmasked
-pixels, which can reduce dark boxes under heavy text strokes. These knobs are
-opt-in, only affect layered profiles, and do not change lossless JB2 defaults.
+pixels, which can reduce dark boxes under heavy text strokes.
+`--block-classify` routes photo and halftone blocks wholly to the background
+layer instead of shredding them into mask speckle (mixed text+photo layouts);
+pair it with `--adaptive-bg-subsample`, which densifies the background grid
+where unmasked detail warrants it, so routed photos keep their detail. These
+knobs are opt-in, only affect layered profiles, and do not change lossless
+JB2 defaults.
 Library callers can use the same controls with `PageEncoder::with_segment_options`.
 For newly encoded pages, `PageEncoder::with_metadata` emits a `METz` chunk;
 for existing documents, `DjVuDocumentMut::page_mut(...).set_metadata(...)`

package/simd128/djvu_rs.d.ts

@@ -23,16 +23,16 @@ export class WasmDocument {
      * Throws a JavaScript `Error` if the bytes are not a valid DjVu file.
      */
     static from_bytes(data: Uint8Array): WasmDocument;
+    /**
+     * Total number of pages in the document.
+     */
+    page_count(): number;
     /**
      * Return a handle to page `index` (0-based).
      *
      * Throws if `index >= page_count()`.
      */
     page(index: number): WasmPage;
-    /**
-     * Total number of pages in the document.
-     */
-    page_count(): number;
     /**
      * Render a contiguous batch of pages at `target_dpi`, returning one
      * [`WasmPixmap`] per page in input order (#610).
@@ -72,13 +72,6 @@ export class WasmPage {
      * Output height in pixels when rendered at `target_dpi`.
      */
     height_at(target_dpi: number): number;
-    /**
-     * Render the page at `target_dpi` and return raw RGBA pixels
-     * (`Uint8ClampedArray`, suitable for `new ImageData(pixels, w, h)`).
-     *
-     * Throws on decode error.
-     */
-    render(target_dpi: number): Uint8ClampedArray;
     /**
      * Fast coarse render — decodes only the first BG44 chunk (~5 ms for a
      * typical color page).
@@ -91,6 +84,13 @@ export class WasmPage {
      * Throws on decode error.
      */
     render_coarse(target_dpi: number): Uint8ClampedArray | undefined;
+    /**
+     * Render the page at `target_dpi` and return raw RGBA pixels
+     * (`Uint8ClampedArray`, suitable for `new ImageData(pixels, w, h)`).
+     *
+     * Throws on decode error.
+     */
+    render(target_dpi: number): Uint8ClampedArray;
     /**
      * Render into a caller-owned [`WasmPixmap`], reusing its Rust-side
      * allocation (#611). No JS-side allocation, no wasm→JS copy — consume

package/simd128/djvu_rs.js

@@ -45,6 +45,14 @@ export class WasmDocument {
         }
         return WasmDocument.__wrap(ret[0]);
     }
+    /**
+     * Total number of pages in the document.
+     * @returns {number}
+     */
+    page_count() {
+        const ret = wasm.wasmdocument_page_count(this.__wbg_ptr);
+        return ret >>> 0;
+    }
     /**
      * Return a handle to page `index` (0-based).
      *
@@ -59,14 +67,6 @@ export class WasmDocument {
         }
         return WasmPage.__wrap(ret[0]);
     }
-    /**
-     * Total number of pages in the document.
-     * @returns {number}
-     */
-    page_count() {
-        const ret = wasm.wasmdocument_page_count(this.__wbg_ptr);
-        return ret >>> 0;
-    }
     /**
      * Render a contiguous batch of pages at `target_dpi`, returning one
      * [`WasmPixmap`] per page in input order (#610).
@@ -145,21 +145,6 @@ export class WasmPage {
         const ret = wasm.wasmpage_height_at(this.__wbg_ptr, target_dpi);
         return ret >>> 0;
     }
-    /**
-     * Render the page at `target_dpi` and return raw RGBA pixels
-     * (`Uint8ClampedArray`, suitable for `new ImageData(pixels, w, h)`).
-     *
-     * Throws on decode error.
-     * @param {number} target_dpi
-     * @returns {Uint8ClampedArray}
-     */
-    render(target_dpi) {
-        const ret = wasm.wasmpage_render(this.__wbg_ptr, target_dpi);
-        if (ret[2]) {
-            throw takeFromExternrefTable0(ret[1]);
-        }
-        return takeFromExternrefTable0(ret[0]);
-    }
     /**
      * Fast coarse render — decodes only the first BG44 chunk (~5 ms for a
      * typical color page).
@@ -180,6 +165,21 @@ export class WasmPage {
         }
         return takeFromExternrefTable0(ret[0]);
     }
+    /**
+     * Render the page at `target_dpi` and return raw RGBA pixels
+     * (`Uint8ClampedArray`, suitable for `new ImageData(pixels, w, h)`).
+     *
+     * Throws on decode error.
+     * @param {number} target_dpi
+     * @returns {Uint8ClampedArray}
+     */
+    render(target_dpi) {
+        const ret = wasm.wasmpage_render(this.__wbg_ptr, target_dpi);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
     /**
      * Render into a caller-owned [`WasmPixmap`], reusing its Rust-side
      * allocation (#611). No JS-side allocation, no wasm→JS copy — consume
@@ -479,29 +479,29 @@ if (Symbol.dispose) WasmPixmap.prototype[Symbol.dispose] = WasmPixmap.prototype.
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
-        __wbg_Error_408e67f47ca7b58b: function(arg0, arg1) {
+        __wbg_Error_67e7344beaa85059: function(arg0, arg1) {
             const ret = Error(getStringFromWasm0(arg0, arg1));
             return ret;
         },
-        __wbg___wbindgen_throw_bb96b2010945f0bc: function(arg0, arg1) {
+        __wbg___wbindgen_throw_5d9e815e6fdf150f: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
-        __wbg_length_13032799523c5735: function(arg0) {
+        __wbg_length_ff98c95d19109ba4: function(arg0) {
             const ret = arg0.length;
             return ret;
         },
-        __wbg_new_with_length_5d351ffdb6e3397d: function(arg0) {
+        __wbg_new_with_length_ac9c609232fb2d1d: function(arg0) {
             const ret = new Uint8ClampedArray(arg0 >>> 0);
             return ret;
         },
-        __wbg_set_5c15d3c5973de97a: function(arg0, arg1, arg2) {
+        __wbg_set_0488601468e80715: function(arg0, arg1, arg2) {
             arg0.set(getArrayU8FromWasm0(arg1, arg2));
         },
         __wbg_wasmpixmap_new: function(arg0) {
             const ret = WasmPixmap.__wrap(arg0);
             return ret;
         },
-        __wbindgen_cast_0000000000000001: function(arg0, arg1) {
+        __wbindgen_generic_0000000000000001: function(arg0, arg1) {
             // Cast intrinsic for `Ref(Slice(U8)) -> NamedExternref("Uint8ClampedArray")`.
             const ret = getArrayU8FromWasm0(arg0, arg1);
             return ret;