wasm-html-to-image 0.1.2 → 0.1.4

package/README.md

@@ -17,7 +17,7 @@ No headless browsers (Chromium, Puppeteer, or Playwright) required. Runs seamles
 
 - ⚡ **Single Unified WASM Binary**: HTML parsing, CSS layout, vector painting, and image encoding execute entirely inside WebAssembly without copying intermediate framebuffers across JS boundaries.
 - 🎨 **Versatile Inputs**: Renders HTML strings, remote Web URLs, multi-page HTML arrays, or raw image buffers (PNG, JPEG, WebP, GIF, AVIF, BMP, Data URLs).
-- 📦 **Rich Output Formats**: Direct SVG vector streams, high-quality PNG, JPEG, WebP, AVIF, uncompressed RAW pixels, ThumbHash placeholders, and multi-page vector PDFs.
+- 📦 **Rich Output Formats**: Direct SVG vector streams, high-quality PNG, JPEG, WebP, AVIF, JXL, uncompressed RAW pixels, ThumbHash placeholders, and multi-page vector PDFs.
 - 🚀 **Zero-Config Single Bundle**: Use `wasm-html-to-image/single` to call `render()` immediately without manual WASM loading or build setup.
 - 🌐 **Edge & Serverless Native**: Dedicated subpaths (`/workerd` for Cloudflare Workers, `/edge-light` for Vercel Edge) tailored for strict serverless constraints.
 - 🧵 **Multi-Threaded Worker Pool**: Process thousands of images in parallel using `wasm-html-to-image/workers` (Node.js worker threads / Web Workers).
@@ -149,6 +149,7 @@ All formats return a `RenderResult<T>` object containing `.data` (`Uint8Array` o
 | `jpeg`      | `Uint8Array`       | Skia render → JPEG encode (`quality`)          | Decodes and compresses JPEG   |
 | `webp`      | `Uint8Array`       | Skia render → WebP encode (`quality`)          | Decodes and compresses WebP   |
 | `avif`      | `Uint8Array`       | Skia render → AVIF encode (`quality`, `speed`) | Decodes and compresses AVIF   |
+| `jxl`       | `Uint8Array`       | Skia render → JXL encode (`quality`, `speed`)  | Decodes and compresses JXL    |
 | `raw`       | `Uint8Array`       | Uncompressed RGBA pixel bytes                  | Uncompressed RGBA pixel bytes |
 | `thumbhash` | `Uint8Array`       | Computes ThumbHash from render                 | Computes ThumbHash from image |
 | `svg`       | `string`           | Skia vector drawing stream                     | Single `<image>` wrapper SVG  |
@@ -207,10 +208,13 @@ app.listen(3000);
 Generate dynamic social preview images at the edge:
 
 ```typescript
-// wrangler.jsonc:
-// { "rules": [{ "type": "CompiledWasm", "globs": ["**/*.wasm"], "fallthrough": false }] }
+// wrangler.jsonc: no "rules" needed on current Wrangler (v3/v4) —
+// `import ... from "*.wasm"` is bundled as WebAssembly.Module by default.
+// Minimal wrangler.jsonc: { "main": "src/index.ts", "compatibility_date": "2026-09-01" }
+// (Only configure "rules" yourself if you customize bundling rules or use a very old Wrangler.
+// Note: @cloudflare/vite-plugin ignores "rules".)
 
-import { render } from "wasm-html-to-image/workerd";
+import { render } from "wasm-html-to-image"; // auto-selects the workerd build on Cloudflare ("wasm-html-to-image/workerd" also works)
 
 export default {
   async fetch(request: Request): Promise<Response> {

package/dist/cli.js

@@ -11,6 +11,7 @@ const OUTPUT_FORMATS = [
     "jpeg",
     "webp",
     "avif",
+    "jxl",
     "raw",
     "thumbhash",
     "none",
@@ -36,7 +37,7 @@ async function readInput(input) {
 }
 program
     .name("wasm-html-to-image")
-    .description("HTML to image converter on the single unified WASM module (svg/pdf direct, png/jpeg/webp/avif/raw/thumbhash via encode or html_to_image)")
+    .description("HTML to image converter on the single unified WASM module (svg/pdf direct, png/jpeg/webp/avif/jxl/raw/thumbhash via encode or html_to_image)")
     .version("0.1.0")
     .argument("<input>", "input HTML/image file path or URL")
     .option("-o, --output <path>", "output file path")

package/dist/core.d.ts

@@ -15,7 +15,7 @@ export type { DiagnosticMessage, FontDiagnostic, RenderDiagnostics, RenderLimits
  *   (`converter_load_image` -> optional crop/resize -> `converter_encode`,
  *   or `converter_encode_svg` / `converter_encode_pdf`).
  */
-export type OutputFormat = "svg" | "png" | "pdf" | "jpeg" | "webp" | "avif" | "raw" | "thumbhash" | "none";
+export type OutputFormat = "svg" | "png" | "pdf" | "jpeg" | "webp" | "avif" | "jxl" | "raw" | "thumbhash" | "none";
 /** Result of rendering an HTML document or converting an image. */
 export interface RenderResult<T = Uint8Array | string> {
     /** Output binary or text (string for svg, Uint8Array for all others). */

package/dist/diagnostics.d.ts

@@ -6,6 +6,7 @@
  * satoru's `RenderDiagnostics` so playground-style consumers can switch
  * imports without reshaping reports.
  */
+import type { OutputFormat } from "./core.js";
 /** Log severity, shared with the WASM `set_log_level` binding. */
 export declare enum LogLevel {
     None = 0,
@@ -47,7 +48,7 @@ export interface DiagnosticMessage {
 /** Full render diagnostics report (satoru-compatible). */
 export interface RenderDiagnostics {
     version: 1;
-    format: "svg" | "png" | "webp" | "pdf";
+    format: OutputFormat;
     width: number;
     height?: number;
     mediaType: "screen" | "print";

package/dist/encode-args.js

@@ -6,6 +6,7 @@ export const FORMAT_INT = {
     pdf: 3,
     jpeg: 4,
     avif: 5,
+    jxl: 8,
     raw: 6,
     thumbhash: 7,
     none: -1,