@ken0106/jsquash

jSquash decoder adapters for @ken0106/core. Lazy WASM loading per format, optional peer dependencies, ~900 bytes of adapter code per codec on top of jSquash's native WASM.

npm install @ken0106/core @ken0106/jsquash
# + the codecs you actually need:
npm install @jsquash/jpeg @jsquash/png @jsquash/webp @jsquash/avif

Why optional peers

JPEG-only consumers shouldn't ship 1.3 MB of PNG/WebP/AVIF WASM. The jSquash codecs are declared as peerDependenciesMeta: optional so your bundler only bundles the ones you install.

Quick start

import { getPalette } from "@ken0106/core";
import { autoDecoders, decodeJPEG } from "@ken0106/jsquash";

// All four formats — WASM loads lazily on first use:
await getPalette(url, { decoders: autoDecoders() });

// Just JPEG — minimal bundle:
await getPalette(url, { decoders: { jpeg: decodeJPEG } });

Named imports (tree-shakeable)

import { decodeJPEG } from "@ken0106/jsquash/jpeg";
import { decodePNG }  from "@ken0106/jsquash/png";
import { decodeWebP } from "@ken0106/jsquash/webp";
import { decodeAVIF } from "@ken0106/jsquash/avif";

Each entry triggers its own jSquash WASM fetch on first call and memoizes the module for subsequent calls.

On Cloudflare Workers

Workers needs WASM modules to be imported with the CompiledWasm rule rather than fetched. See the example in the paleta repo.

License

MIT