@pbk20191/icodec 0.7.0 → 0.9.0

package/lib/jxl.d.ts

@@ -1,4 +1,4 @@
-import { EnumValue, ImageDataLike, WasmSource } from "./common.js";
+import { EnumValue, ImageDataLike, WasmSource } from "./common.ts";
 export declare enum Override {
     Default = -1,
     False = 0,
@@ -173,8 +173,8 @@ export declare const defaultOptions: Required<Options>;
 export declare const mimeType = "image/jxl";
 export declare const extension = "jxl";
 export declare const bitDepth: number[];
-export declare function loadEncoder(input?: WasmSource): Promise<any>;
-export declare function loadDecoder(input?: WasmSource): Promise<any>;
+export declare function loadEncoder(input?: WasmSource): Promise<import("../dist/jxl-enc.ts").MainModule>;
+export declare function loadDecoder(input?: WasmSource): Promise<import("../dist/jxl-dec.ts").MainModule>;
 export declare function encode(image: ImageDataLike, options?: Options): Uint8Array<ArrayBufferLike>;
 export declare function decode(input: BufferSource): ImageData;
 export declare function unloadDecoder(): void;

package/lib/node.d.ts

@@ -0,0 +1,16 @@
+/// <reference types="node" preserve="true" />
+import { WasmSource } from "./common.ts";
+type NodeCodecModule<D, E> = {
+    loadEncoder(input?: WasmSource): Promise<D>;
+    loadDecoder(input?: WasmSource): Promise<E>;
+};
+export declare const avif: NodeCodecModule<import("../dist/avif-enc").MainModule, import("../dist/avif-dec").MainModule>;
+export declare const png: NodeCodecModule<import("../dist/pngquant").InitOutput, import("../dist/pngquant").InitOutput>;
+export declare const jpeg: NodeCodecModule<import("../dist/mozjpeg").MainModule, import("../dist/mozjpeg").MainModule>;
+export declare const jxl: NodeCodecModule<import("../dist/jxl-enc").MainModule, import("../dist/jxl-dec").MainModule>;
+export declare const webp: NodeCodecModule<import("../dist/webp-enc").MainModule, import("../dist/webp-dec").MainModule>;
+export declare const qoi: NodeCodecModule<import("../dist/qoi").MainModule, import("../dist/qoi").MainModule>;
+export declare const wp2: NodeCodecModule<import("../dist/wp2-enc").MainModule, import("../dist/wp2-dec").MainModule>;
+export declare const vvic: NodeCodecModule<import("../dist/vvic-enc").MainModule, import("../dist/vvic-dec").MainModule>;
+export declare const heic: NodeCodecModule<import("../dist/heic-enc").MainModule, import("../dist/heic-dec").MainModule>;
+export {};

package/lib/node.js

@@ -1,8 +1,8 @@
+/// <reference types="node" preserve="true" />
 import { readFileSync } from "node:fs";
-import { join } from "node:path";
-
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 import { PureImageData } from "./common.js";
-
 import * as avifRaw from "./avif.js";
 import * as pngRaw from "./png.js";
 import * as jpegRaw from "./jpeg.js";
@@ -11,38 +11,36 @@ import * as webpRaw from "./webp.js";
 import * as heicRaw from "./heic.js";
 import * as qoiRaw from "./qoi.js";
 import * as wp2Raw from "./wp2.js";
-
+import * as vvicRaw from "./vvic.js";
+const distDir = join(dirname(fileURLToPath(import.meta.url)), "../dist");
 globalThis._icodec_ImageData = (data, w, h, depth) => {
-	return new PureImageData(data, w, h, depth);
+    return new PureImageData(data, w, h, depth);
 };
-
 function wrapLoaders(original, e, d = e) {
-	let loadedEnc;
-	let loadedDec;
-
-	const loadEncoder = input => {
-		if (loadedEnc) return loadedEnc;
-
-		input ??= join(import.meta.dirname, "../dist", e);
-		if (typeof input === "string") {
-			input = readFileSync(input);
-		}
-		return loadedEnc = original.loadEncoder(input);
-	};
-
-	const loadDecoder = input => {
-		if (loadedDec) return loadedDec;
-
-		input ??= join(import.meta.dirname, "../dist", d);
-		if (typeof input === "string") {
-			input = readFileSync(input);
-		}
-		return loadedDec = original.loadDecoder(input);
-	};
-
-	return { ...original, loadEncoder, loadDecoder };
+    let loadedEnc;
+    let loadedDec;
+    const loadEncoder = (input) => {
+        if (loadedEnc)
+            return loadedEnc;
+        let source = input ?? join(distDir, e);
+        if (typeof source === "string") {
+            source = readFileSync(source);
+        }
+        loadedEnc = original.loadEncoder(source);
+        return loadedEnc;
+    };
+    const loadDecoder = (input) => {
+        if (loadedDec)
+            return loadedDec;
+        let source = input ?? join(distDir, d);
+        if (typeof source === "string") {
+            source = readFileSync(source);
+        }
+        loadedDec = original.loadDecoder(source);
+        return loadedDec;
+    };
+    return { ...original, loadEncoder, loadDecoder };
 }
-
 export const avif = wrapLoaders(avifRaw, "avif-enc.wasm", "avif-dec.wasm");
 export const png = wrapLoaders(pngRaw, "pngquant_bg.wasm");
 export const jpeg = wrapLoaders(jpegRaw, "mozjpeg.wasm");
@@ -50,9 +48,5 @@ export const jxl = wrapLoaders(jxlRaw, "jxl-enc.wasm", "jxl-dec.wasm");
 export const webp = wrapLoaders(webpRaw, "webp-enc.wasm", "webp-dec.wasm");
 export const qoi = wrapLoaders(qoiRaw, "qoi.wasm");
 export const wp2 = wrapLoaders(wp2Raw, "wp2-enc.wasm", "wp2-dec.wasm");
-
-/*
- * Web Workers that require special handling of Node, but if we add "node" to build target,
- * it will require the bundler to add additional config to exclude node modules.
- */
-export const heic = wrapLoaders(heicRaw,"heic-enc.wasm", "heic-dec.wasm");
+export const vvic = wrapLoaders(vvicRaw, "vvic-enc.wasm", "vvic-dec.wasm");
+export const heic = wrapLoaders(heicRaw, "heic-enc.wasm", "heic-dec.wasm");

package/lib/png.d.ts

@@ -1,4 +1,4 @@
-import { ImageDataLike, WasmSource } from "./common.js";
+import { ImageDataLike, WasmSource } from "./common.ts";
 export interface QuantizeOptions {
     /**
      * Range: [1, 10], bigger is faster and generate images of lower quality,
@@ -59,8 +59,8 @@ export declare const defaultOptions: Required<Options>;
 export declare const bitDepth: number[];
 export declare const mimeType = "image/png";
 export declare const extension = "png";
-export declare const loadEncoder: (module_or_path?: WasmSource) => Promise<any>;
-export declare const loadDecoder: (module_or_path?: WasmSource) => Promise<any>;
+export declare const loadEncoder: (module_or_path?: WasmSource) => Promise<import("../dist/pngquant.ts").InitOutput>;
+export declare const loadDecoder: (module_or_path?: WasmSource) => Promise<import("../dist/pngquant.ts").InitOutput>;
 /**
  * Reduces the colors used in the image at a slight loss, using a combination
  * of vector quantization algorithms.

package/lib/qoi.d.ts

@@ -1,4 +1,4 @@
-import { ImageDataLike, WasmSource } from "./common.js";
+import { ImageDataLike, WasmSource } from "./common.ts";
 /**
  * QOI encoder does not have options, it's always lossless.
  */
@@ -7,8 +7,9 @@ export declare const defaultOptions: never;
 export declare const bitDepth: number[];
 export declare const mimeType = "image/qoi";
 export declare const extension = "qoi";
-export declare function loadEncoder(input?: WasmSource): Promise<any>;
+export declare function loadEncoder(input?: WasmSource): Promise<import("../dist/qoi.ts").MainModule>;
 export declare const loadDecoder: typeof loadEncoder;
 export declare function encode(image: ImageDataLike): Uint8Array<ArrayBufferLike>;
 export declare function decode(input: BufferSource): ImageData;
-export declare function unloadCoder(): void;
+export declare function unloadDecoder(): void;
+export declare const unloadEncoder: typeof unloadDecoder;

package/lib/qoi.js

@@ -17,6 +17,7 @@ export function encode(image) {
 export function decode(input) {
     return check(codecWASM.decode(input), "QOI Decode");
 }
-export function unloadCoder() {
+export function unloadDecoder() {
     codecWASM = undefined;
 }
+export const unloadEncoder = unloadDecoder;

package/lib/vvic.d.ts

@@ -0,0 +1,25 @@
+import { ImageDataLike, WasmSource } from "./common.ts";
+export interface Options {
+    /**
+     * If true, encode the image without any loss.
+     *
+     * @default false
+     */
+    lossless?: boolean;
+    /**
+     * The quality of the encoded image, from 0 to 100.
+     *
+     * @default 75
+     */
+    quality?: number;
+}
+export declare const defaultOptions: Required<Options>;
+export declare const mimeType = "image/vvic";
+export declare const extension = "vvic";
+export declare const bitDepth: number[];
+export declare function loadEncoder(input?: WasmSource): Promise<import("../dist/vvic-enc.ts").MainModule>;
+export declare function loadDecoder(input?: WasmSource): Promise<import("../dist/vvic-dec.ts").MainModule>;
+export declare function encode(image: ImageDataLike, options?: Options): Uint8Array<ArrayBufferLike>;
+export declare function decode(input: BufferSource): ImageData;
+export declare function unloadDecoder(): void;
+export declare function unloadEncoder(): void;

package/lib/vvic.js

@@ -0,0 +1,30 @@
+import wasmFactoryEnc from "../dist/vvic-enc.js";
+import wasmFactoryDec from "../dist/vvic-dec.js";
+import { check, encodeES, loadES } from "./common.js";
+export const defaultOptions = {
+    lossless: false,
+    quality: 75,
+};
+let encoderWASM;
+let decoderWASM;
+export const mimeType = "image/vvic";
+export const extension = "vvic";
+export const bitDepth = [8];
+export async function loadEncoder(input) {
+    return encoderWASM ??= await loadES(wasmFactoryEnc, input);
+}
+export async function loadDecoder(input) {
+    return decoderWASM ??= await loadES(wasmFactoryDec, input);
+}
+export function encode(image, options) {
+    return encodeES("VVIC Encode", encoderWASM, defaultOptions, image, options);
+}
+export function decode(input) {
+    return check(decoderWASM.decode(input), "VVIC Decode");
+}
+export function unloadDecoder() {
+    decoderWASM = undefined;
+}
+export function unloadEncoder() {
+    encoderWASM = undefined;
+}

package/lib/webp.d.ts

@@ -1,4 +1,5 @@
-import { EnumValue, ImageDataLike, WasmSource } from "./common.js";
+import { WebPConfig } from "../dist/webp-enc.ts";
+import { EnumValue, ImageDataLike, WasmSource } from "./common.ts";
 export declare enum Preprocess {
     None = 0,
     SegmentSmooth = 1,
@@ -221,10 +222,10 @@ export declare const defaultOptions: Required<Options> & Record<string, any>;
 export declare const bitDepth: number[];
 export declare const mimeType = "image/webp";
 export declare const extension = "webp";
-export declare function loadEncoder(input?: WasmSource): Promise<any>;
-export declare function loadDecoder(input?: WasmSource): Promise<any>;
+export declare function loadEncoder(input?: WasmSource): Promise<import("../dist/webp-enc.ts").MainModule>;
+export declare function loadDecoder(input?: WasmSource): Promise<import("../dist/webp-dec.ts").MainModule>;
 export declare function encode(image: ImageDataLike, options?: Options): Uint8Array<ArrayBufferLike>;
-export declare function preset(config: Options, preset: EnumValue<typeof WebPPreset>): Options | null;
+export declare function preset(config: Options, preset: EnumValue<typeof WebPPreset>): WebPConfig | undefined;
 export declare function decode(input: BufferSource): ImageData;
 export declare function unloadDecoder(): void;
 export declare function unloadEncoder(): void;

package/lib/wp2.d.ts

@@ -1,4 +1,4 @@
-import { EnumValue, ImageDataLike, WasmSource } from "./common.js";
+import { EnumValue, ImageDataLike, WasmSource } from "./common.ts";
 export declare enum UVMode {
     UVAdapt = 0,
     UV420 = 1,
@@ -60,13 +60,14 @@ export interface Options {
      */
     errorDiffusion?: number;
     useRandomMatrix?: boolean;
+    lossless?: boolean;
 }
 export declare const defaultOptions: Required<Options>;
 export declare const bitDepth: number[];
 export declare const mimeType = "image/webp2";
 export declare const extension = "wp2";
-export declare function loadEncoder(input?: WasmSource): Promise<any>;
-export declare function loadDecoder(input?: WasmSource): Promise<any>;
+export declare function loadEncoder(input?: WasmSource): Promise<import("../dist/wp2-enc.ts").MainModule>;
+export declare function loadDecoder(input?: WasmSource): Promise<import("../dist/wp2-dec.ts").MainModule>;
 export declare function encode(image: ImageDataLike, options?: Options): Uint8Array<ArrayBufferLike>;
 export declare function decode(input: BufferSource): ImageData;
 export declare function unloadDecoder(): void;

package/lib/wp2.js

@@ -25,6 +25,7 @@ export const defaultOptions = {
     cspType: Csp.YCoCg,
     errorDiffusion: 0,
     useRandomMatrix: false,
+    lossless: false,
 };
 export const bitDepth = [8];
 // WebP 2 will not be released as an image format, but wee need define these properties.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pbk20191/icodec",
-	"version": "0.7.0",
+	"version": "0.9.0",
 	"private": false,
 	"description": "Image encoders & decoders built with WebAssembly",
 	"license": "MIT",
@@ -12,9 +12,11 @@
 	"type": "module",
 	"scripts": {
 		"wasm": "node scripts/build.js",
-		"types": "tsc -p tsconfig.json --emitDeclarationOnly && tsc -p tsconfig.json",
+		"types": "tsc -p tsconfig.json",
 		"build": "npm run wasm && npm run types",
 		"test-convert": "tsx --test test/test-convert.js",
+		"test-leak": "tsx --test test/test-leak.js",
+		"test-lossless": "tsx --test test/test-lossless.js",
 		"demo": "node scripts/start-demo.js"
 	},
 	"keywords": [
@@ -30,12 +32,15 @@
 		"jxl",
 		"wp2",
 		"mozjpeg",
+		"vvic",
 		"pngquant"
 	],
 	"files": [
 		"versions.json",
-		"dist/*.{js,wasm}",
-		"lib/*.{js,d.ts}"
+		"dist/*.{js,wasm,d.ts}",
+		"lib/*.{js,d.ts}",
+		"types/*.{d.ts}",
+		"types/wasm_type.d.ts"
 	],
 	"exports": {
 		"./versions.json": "./versions.json",
@@ -57,14 +62,16 @@
 		"@kaciras/eslint-config-typescript": "^3.4.1",
 		"@kaciras/utilities": "^1.0.5",
 		"@types/emscripten": "^1.41.5",
-		"@types/node": "^24.10.1",
-		"esbench": "^0.8.0",
+		"@types/node": "^24.12.0",
+		"esbench": "^0.8.1",
 		"eslint": "^9.39.1",
+		"node-addon-api": "^8.6.0",
+		"node-gyp": "^12.2.0",
 		"pixelmatch": "^7.1.0",
 		"sharp": "^0.34.5",
 		"smol-toml": "^1.5.2",
+		"tsx": "^4.21.0",
 		"typescript": "^5.9.3",
-		"version-compare": "^3.12.0",
-		"tsx": "^4.21.0"
+		"version-compare": "^3.12.0"
 	}
 }

package/types/wasm_type.d.ts

@@ -0,0 +1,57 @@
+/// <reference types="emscripten" preserve="true" />
+import "emscripten"
+declare module "../dist/avif-dec.ts" {
+    interface WasmModule extends EmscriptenModule {}
+}
+
+declare module "../dist/avif-enc.ts" {
+    interface WasmModule extends EmscriptenModule {}
+}
+
+declare module "../dist/jxl-dec.ts" {
+    interface WasmModule extends EmscriptenModule {}
+}
+
+declare module "../dist/jxl-enc.ts" {
+    interface WasmModule extends EmscriptenModule {}
+}
+
+declare module "../dist/webp-dec.ts" {
+    interface WasmModule extends EmscriptenModule {}
+}
+
+declare module "../dist/webp-enc.ts" {
+    interface WasmModule extends EmscriptenModule {}
+}
+
+declare module "../dist/heic-dec.ts" {
+    interface WasmModule extends EmscriptenModule {}
+}
+
+declare module "../dist/heic-enc.ts" {
+    interface WasmModule extends EmscriptenModule {}
+}
+
+declare module "../dist/wp2-dec.ts" {
+    interface WasmModule extends EmscriptenModule {}
+} 
+
+declare module "../dist/wp2-enc.ts" {
+    interface WasmModule extends EmscriptenModule {}
+}
+
+declare module "../dist/qoi.ts" {
+    interface WasmModule extends EmscriptenModule {}
+}
+
+declare module "../dist/vvic-dec.ts" {
+    interface WasmModule extends EmscriptenModule {}
+}
+
+declare module "../dist/vvic-enc.ts" {
+    interface WasmModule extends EmscriptenModule {}
+}
+
+declare module "../dist/mozjpeg.ts" {
+    interface WasmModule extends EmscriptenModule {}
+}

package/versions.json

@@ -1 +1 @@
-[{"name":"mozjpeg","version":"v4.1.5","repository":"https://github.com/mozilla/mozjpeg","date":"2023-10-12"},{"name":"qoi","version":"6fff9b7","repository":"https://github.com/phoboslab/qoi","date":"2026-02-14"},{"name":"libwebp","version":"v1.6.0","repository":"https://github.com/webmproject/libwebp","date":"2025-07-08"},{"name":"libjxl","version":"v0.11.2","repository":"https://github.com/libjxl/libjxl","date":"2026-02-09"},{"name":"libavif","version":"v1.4.0","repository":"https://github.com/AOMediaCodec/libavif","date":"2026-02-27"},{"name":"aom","version":"v3.13.1","repository":"https://aomedia.googlesource.com/aom","date":"2025-09-05"},{"name":"libwebp2","version":"8720150","repository":"https://chromium.googlesource.com/codecs/libwebp2","date":"2026-03-16"},{"name":"x265","version":"4.1","repository":"https://bitbucket.org/multicoreware/x265_git","date":"2024-11-22"},{"name":"libde265","version":"v1.0.18","repository":"https://github.com/strukturag/libde265","date":"2026-03-19"},{"name":"libheif","version":"v1.21.2","repository":"https://github.com/strukturag/libheif","date":"2026-01-15"}]
+[{"name":"mozjpeg","version":"v4.1.5","repository":"https://github.com/mozilla/mozjpeg","date":"2023-10-12"},{"name":"qoi","version":"6fff9b7","repository":"https://github.com/phoboslab/qoi","date":"2026-02-14"},{"name":"libwebp","version":"v1.6.0","repository":"https://github.com/webmproject/libwebp","date":"2025-07-08"},{"name":"libjxl","version":"v0.11.2","repository":"https://github.com/libjxl/libjxl","date":"2026-02-09"},{"name":"libavif","version":"v1.4.1","repository":"https://github.com/AOMediaCodec/libavif","date":"2026-03-20"},{"name":"aom","version":"v3.13.2","repository":"https://aomedia.googlesource.com/aom","date":"2026-03-17"},{"name":"libwebp2","version":"8720150","repository":"https://chromium.googlesource.com/codecs/libwebp2","date":"2026-03-16"},{"name":"x265","version":"4.1","repository":"https://bitbucket.org/multicoreware/x265_git","date":"2024-11-22"},{"name":"libde265","version":"v1.0.18","repository":"https://github.com/strukturag/libde265","date":"2026-03-19"},{"name":"libheif","version":"v1.21.2","repository":"https://github.com/strukturag/libheif","date":"2026-01-15"},{"name":"vvenc","version":"v1.14.0","repository":"https://github.com/fraunhoferhhi/vvenc","date":"2026-01-21"},{"name":"vvdec","version":"v3.1.0","repository":"https://github.com/fraunhoferhhi/vvdec","date":"2025-11-18"}]