@takumi-rs/wasm 2.0.0-rc.1 → 2.0.0-rc.11

package/README.md

@@ -1,7 +1,7 @@
 # @takumi-rs/wasm
 
-Takumi is a **image rendering engine** written in Rust and this package provides WebAssembly bindings.
+WebAssembly bindings for [Takumi](https://github.com/kane50613/takumi), a Rust image rendering engine.
 
-Please refer to the [Integration](https://takumi.kane.tw/docs/integration) page in our official documentation for more details.
+See the [Integration guide](https://takumi.kane.tw/docs/integration) for setup.
 
-If you are looking for Node.js bindings, take a look at the [@takumi-rs/core](https://npmjs.com/package/@takumi-rs/core) package.
+For Node.js, use [@takumi-rs/core](https://npmjs.com/package/@takumi-rs/core).

package/dist/export.cjs

@@ -3,6 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 let _takumi_rs_helpers = require("@takumi-rs/helpers");
+let _takumi_rs_helpers_renderer = require("@takumi-rs/helpers/renderer");
 //#region pkg/takumi_wasm.js
 /**
 * The main renderer for Takumi image rendering engine.
@@ -517,148 +518,84 @@ async function __wbg_init(module_or_path) {
 }
 //#endregion
 //#region src/export.ts
-async function resolveImageLoaders(images) {
-	const bySrc = /* @__PURE__ */ new Map();
-	for (const image of images) bySrc.set(image.src, image);
-	return Promise.all([...bySrc.values()].map(async ({ src, data, cache }) => ({
-		src,
-		data: typeof data === "function" ? await data() : data,
-		cache
-	})));
-}
 var Renderer = class {
-	fontsByKey = /* @__PURE__ */ new Map();
-	fontsByData = /* @__PURE__ */ new WeakMap();
 	inner = new Renderer$1();
-	getFont(key) {
-		return typeof key === "string" ? this.fontsByKey.get(key) : this.fontsByData.get(key);
-	}
-	setFont(key, family) {
-		if (typeof key === "string") this.fontsByKey.set(key, family);
-		else this.fontsByData.set(key, family);
-	}
-	deleteFont(key) {
-		if (typeof key === "string") this.fontsByKey.delete(key);
-		else this.fontsByData.delete(key);
-	}
-	async prepareFonts(fonts) {
-		if (!fonts) return;
-		const families = await Promise.all(fonts.map(this.registerFont.bind(this)));
-		return [...new Set(families.flat().map((f) => f.name))];
-	}
+	fonts = new _takumi_rs_helpers_renderer.FontRegistry((font) => this.inner.registerFont(font));
 	async render(node, options) {
-		const { fonts, fontFamilies, images, subset, ...rest } = options ?? {};
-		const registeredFamilies = await this.prepareFonts((0, _takumi_rs_helpers.pickFonts)({
+		const { fonts, fontFamilies, signal, images, ...rest } = options ?? {};
+		signal?.throwIfAborted();
+		const resolved = await this.fonts.resolveResources(fonts && (0, _takumi_rs_helpers.subsetFonts)({
 			fonts,
-			source: node,
-			subset
-		}));
-		const resolvedImages = images ? await resolveImageLoaders(images) : void 0;
+			source: node
+		}), images, fontFamilies);
+		signal?.throwIfAborted();
 		return this.inner.render(node, {
 			...rest,
-			images: resolvedImages,
-			fontFamilies: fontFamilies ?? registeredFamilies
+			...resolved
 		});
 	}
 	async renderAsDataUrl(node, options) {
-		const { fonts, fontFamilies, images, subset, ...rest } = options ?? {};
-		const registeredFamilies = await this.prepareFonts((0, _takumi_rs_helpers.pickFonts)({
+		const { fonts, fontFamilies, signal, images, ...rest } = options ?? {};
+		signal?.throwIfAborted();
+		const resolved = await this.fonts.resolveResources(fonts && (0, _takumi_rs_helpers.subsetFonts)({
 			fonts,
-			source: node,
-			subset
-		}));
-		const resolvedImages = images ? await resolveImageLoaders(images) : void 0;
+			source: node
+		}), images, fontFamilies);
+		signal?.throwIfAborted();
 		return this.inner.renderAsDataUrl(node, {
 			...rest,
-			images: resolvedImages,
-			fontFamilies: fontFamilies ?? registeredFamilies
+			...resolved
 		});
 	}
 	async renderSvg(node, options) {
-		const { fonts, fontFamilies, images, subset, ...rest } = options ?? {};
-		const registeredFamilies = await this.prepareFonts((0, _takumi_rs_helpers.pickFonts)({
+		const { fonts, fontFamilies, signal, images, ...rest } = options ?? {};
+		signal?.throwIfAborted();
+		const resolved = await this.fonts.resolveResources(fonts && (0, _takumi_rs_helpers.subsetFonts)({
 			fonts,
-			source: node,
-			subset
-		}));
-		const resolvedImages = images ? await resolveImageLoaders(images) : void 0;
+			source: node
+		}), images, fontFamilies);
+		signal?.throwIfAborted();
 		return this.inner.renderSvg(node, {
 			...rest,
-			images: resolvedImages,
-			fontFamilies: fontFamilies ?? registeredFamilies
+			...resolved
 		});
 	}
 	async measure(node, options) {
-		const { fonts, fontFamilies, images, subset, ...rest } = options ?? {};
-		const registeredFamilies = await this.prepareFonts((0, _takumi_rs_helpers.pickFonts)({
+		const { fonts, fontFamilies, signal, images, ...rest } = options ?? {};
+		signal?.throwIfAborted();
+		const resolved = await this.fonts.resolveResources(fonts && (0, _takumi_rs_helpers.subsetFonts)({
 			fonts,
-			source: node,
-			subset
-		}));
-		const resolvedImages = images ? await resolveImageLoaders(images) : void 0;
+			source: node
+		}), images, fontFamilies);
+		signal?.throwIfAborted();
 		return this.inner.measure(node, {
 			...rest,
-			images: resolvedImages,
-			fontFamilies: fontFamilies ?? registeredFamilies
+			...resolved
 		});
 	}
 	async renderAnimation(options) {
-		const { fonts, fontFamilies, images, subset, ...rest } = options;
+		const { fonts, fontFamilies, signal, images, ...rest } = options;
+		signal?.throwIfAborted();
 		const nodes = options.scenes.map((scene) => scene.node);
-		const registeredFamilies = await this.prepareFonts((0, _takumi_rs_helpers.pickFonts)({
+		const resolved = await this.fonts.resolveResources(fonts && (0, _takumi_rs_helpers.subsetFonts)({
 			fonts,
-			source: nodes,
-			subset
-		}));
-		const resolvedImages = images ? await resolveImageLoaders(images) : void 0;
+			source: nodes
+		}), images, fontFamilies);
+		signal?.throwIfAborted();
 		return this.inner.renderAnimation({
 			...rest,
-			images: resolvedImages,
-			fontFamilies: fontFamilies ?? registeredFamilies
+			...resolved
 		});
 	}
+	registerFont(font) {
+		return this.fonts.register(font);
+	}
+	/** Releases the underlying wasm renderer's memory. */
 	free() {
 		this.inner.free();
 	}
-	async registerFont(font) {
-		const loader = typeof font === "string" ? (0, _takumi_rs_helpers.fontFromUrl)(font) : font;
-		const key = createFontKey(loader);
-		const cached = this.getFont(key);
-		if (cached) return cached;
-		const extracted = extractFontBuffer(loader);
-		const register = (data) => this.inner.registerFont(isBuffer(loader) ? data : {
-			...loader,
-			data
-		});
-		if (isBuffer(extracted)) {
-			const binded = register(extracted);
-			this.setFont(key, Promise.resolve(binded));
-			return binded;
-		}
-		const promise = extracted.then(register).catch((error) => {
-			this.deleteFont(key);
-			throw error;
-		});
-		this.setFont(key, promise);
-		return promise;
-	}
 };
-function extractFontBuffer(font) {
-	if (isBuffer(font)) return font;
-	if (typeof font.data !== "function") return font.data;
-	return font.data();
-}
-function createFontKey(font) {
-	if (isBuffer(font)) return font;
-	if ("key" in font && font.key) return font.key;
-	if (typeof font.data === "function") return `${font.name ?? ""}:${font.weight ?? ""}:${font.style ?? ""}`;
-	return font.data;
-}
-function isBuffer(data) {
-	return data instanceof Uint8Array || data instanceof ArrayBuffer || typeof Buffer !== "undefined" && Buffer.isBuffer(data);
-}
 //#endregion
 exports.Renderer = Renderer;
 exports.default = __wbg_init;
-exports.extractResourceUrls = _takumi_rs_helpers.extractResourceUrls;
 exports.initSync = initSync;

package/dist/export.d.cts

@@ -1,5 +1,6 @@
-import { ContainerNode, ImageNode, Node, Node as Node$1, NodeMetadata, TextNode, extractResourceUrls } from "@takumi-rs/helpers";
+import { ContainerNode, ImageNode, Node, Node as Node$1, NodeMetadata, TextNode } from "@takumi-rs/helpers";
 import { Properties } from "csstype";
+import { AnimationOutputFormatOptions, AnimationOutputFormatOptions as AnimationOutputFormatOptions$1, FontLoader, FontLoader as FontLoader$1, ImageLoader, ImagesInput, ImagesInput as ImagesInput$1, OutputFormatOptions, OutputFormatOptions as OutputFormatOptions$1 } from "@takumi-rs/helpers/renderer";
 
 //#region pkg/takumi_wasm.d.ts
 type ByteBuf = Uint8Array | ArrayBuffer | Buffer;
@@ -12,6 +13,14 @@ type KeyframesRuleList = {
   }[];
 }[];
 type Keyframes = KeyframesMap | KeyframesRuleList;
+/** Output format for static images. */
+type OutputFormat = "png" | "jpeg" | "webp" | "ico" | "raw";
+/** Output format for animated images. */
+type AnimationOutputFormat = "webp" | "apng" | "gif";
+/** The output dithering algorithm. */
+type DitheringAlgorithm = "none" | "ordered-bayer" | "floyd-steinberg";
+/** Cache policy for a decoded image. Defaults to `"auto"`. */
+type ImageCacheMode = "auto" | "none";
 type RenderOptions$1 = {
   /**
    * The width of the image. If not provided, the width will be automatically calculated based on the content.
@@ -25,11 +34,17 @@ type RenderOptions$1 = {
    * The format of the image.
    * @default "png"
    */
-  format?: "png" | "jpeg" | "webp" | "ico" | "raw";
+  format?: OutputFormat;
   /**
-   * The quality of JPEG format (0-100).
+   * The quality of lossy formats (0-100). For JPEG; on wasm, WebP is always
+   * lossless so this is ignored for WebP.
    */
   quality?: number;
+  /**
+   * Encode WebP losslessly. On wasm, WebP is always lossless, so this is
+   * accepted for parity with the native backend but has no effect.
+   */
+  lossless?: boolean;
   /**
    * Images keyed by `src`, each carrying raw bytes. Provided up front and used
    * in place of fetching external `src` URLs during rendering.
@@ -60,26 +75,33 @@ type RenderOptions$1 = {
    * The output dithering algorithm.
    * @default "none"
    */
-  dithering?: "none" | "ordered-bayer" | "floyd-steinberg";
+  dithering?: DitheringAlgorithm;
   /**
    * Per-render font stack: ordered family names used as the fallback chain.
    * Defaults to all registered families in registration order.
    */
-  fontFamilies?: string[];
+  fontFamilies?: string[]; /** Default BCP-47 language applied to the root, inherited by nodes without their own lang. */
+  lang?: string;
 };
 /**
  * SVG is a vector format, so the raster-only knobs do not apply.
  */
-type SvgRenderOptions$1 = Omit<RenderOptions$1, "format" | "quality" | "drawDebugBorder" | "devicePixelRatio" | "dithering">;
+type SvgRenderOptions$1 = Omit<RenderOptions$1, "format" | "quality" | "lossless" | "drawDebugBorder" | "devicePixelRatio" | "dithering">;
 type RenderAnimationOptions$1 = {
-  scenes: AnimationSceneSource[];
+  scenes: AnimationScene[];
   width: number;
   height: number;
-  format?: "webp" | "apng" | "gif";
+  format?: AnimationOutputFormat;
   /**
-   * The quality of WebP format (0-100). Ignored for APNG and GIF.
+   * The quality of lossy WebP (0-100). Ignored for APNG and GIF; on wasm, WebP
+   * is always lossless so this is ignored for WebP too.
    */
   quality?: number;
+  /**
+   * Encode WebP losslessly. On wasm, animated WebP is always lossless, so this
+   * is accepted for parity with the native backend but has no effect.
+   */
+  lossless?: boolean;
   /**
    * Images keyed by `src`, each carrying raw bytes. Provided up front and used
    * in place of fetching external `src` URLs during rendering.
@@ -90,6 +112,10 @@ type RenderAnimationOptions$1 = {
    * CSS stylesheets to apply before rendering.
    */
   stylesheets?: string[];
+  /**
+   * Structured keyframes to register alongside stylesheets.
+   */
+  keyframes?: Keyframes;
   /**
    * Defines the ratio resolution of the image to the physical pixels.
    * @default 1.0
@@ -103,7 +129,8 @@ type RenderAnimationOptions$1 = {
    * Per-render font stack: ordered family names used as the fallback chain.
    * Defaults to all registered families in registration order.
    */
-  fontFamilies?: string[];
+  fontFamilies?: string[]; /** Default BCP-47 language applied to the root, inherited by nodes without their own lang. */
+  lang?: string;
 };
 type FontDetails = {
   name?: string;
@@ -120,7 +147,7 @@ type FontDetails = {
 type ImageSource = {
   src: string;
   data: ByteBuf; /** Cache policy for the decoded image. Defaults to `"auto"`. */
-  cache?: "auto" | "none";
+  cache?: ImageCacheMode;
 };
 type KeyframeRule = {
   offsets: number[];
@@ -155,7 +182,7 @@ type MeasuredNode = {
   children: MeasuredNode[];
   runs: MeasuredTextRun[];
 };
-type AnimationSceneSource = {
+type AnimationScene = {
   node: Node$1;
   durationMs: number;
 };
@@ -204,80 +231,32 @@ declare function __wbg_init(module_or_path?: {
 } | InitInput | Promise<InitInput>): Promise<InitOutput>;
 //#endregion
 //#region src/export.d.ts
-/**
- * A font to register. Either a URL string (fetched on demand, with name/weight/style read from the
- * file), raw bytes, or a descriptor with a lazy `data()` loader.
- */
-type FontLoader = string | Font | (Omit<FontDetails, "data"> & {
-  data: () => Promise<FontDetails["data"]> | FontDetails["data"]; /** Inclusive codepoint ranges this face covers; lets `render` skip it when unused. */
-  ranges?: [number, number][];
-} & ({
-  key: string;
-} | {
-  name: string;
-}));
-type ImageLoaderData = ImageSource["data"];
-type ImageLoader = Omit<ImageSource, "data"> & {
-  data: ImageLoaderData | (() => ImageLoaderData | Promise<ImageLoaderData>);
-};
-/**
- * Output format. Format-specific options live on the variant that supports them,
- * so `quality` cannot be paired with a lossless format. On wasm, WebP is always
- * lossless (lossy WebP is native-only).
- */
-type OutputFormatOptions = {
-  format?: "png";
-} | {
-  format: "jpeg";
-  quality?: number;
-} | {
-  format: "webp";
-} | {
-  format: "ico";
-} | {
-  format: "raw";
-};
-type RenderOptions = Omit<RenderOptions$1, "images" | "format" | "quality"> & OutputFormatOptions & {
-  fonts?: FontLoader[];
-  images?: ImageLoader[]; /** Register only the `fonts` subsets the content renders. @default true */
-  subset?: boolean;
-};
-/**
- * Animation output format. On wasm, WebP animation is always lossless (lossy
- * WebP is native-only).
- */
-type AnimationOutputFormatOptions = {
-  format?: "webp";
-} | {
-  format: "apng";
-} | {
-  format: "gif";
+type RenderOptions = Omit<RenderOptions$1, "images" | "format" | "quality" | "lossless"> & OutputFormatOptions$1 & {
+  fonts?: FontLoader$1[];
+  signal?: AbortSignal;
+  images?: ImagesInput$1;
 };
-type RenderAnimationOptions = Omit<RenderAnimationOptions$1, "images" | "format"> & AnimationOutputFormatOptions & {
-  fonts?: FontLoader[];
-  images?: ImageLoader[]; /** Register only the `fonts` subsets the content renders. @default true */
-  subset?: boolean;
+type RenderAnimationOptions = Omit<RenderAnimationOptions$1, "images" | "format" | "quality" | "lossless"> & AnimationOutputFormatOptions$1 & {
+  fonts?: FontLoader$1[];
+  signal?: AbortSignal;
+  images?: ImagesInput$1;
 };
 type SvgRenderOptions = Omit<SvgRenderOptions$1, "images"> & {
-  fonts?: FontLoader[];
-  images?: ImageLoader[]; /** Register only the `fonts` subsets the content renders. @default true */
-  subset?: boolean;
+  fonts?: FontLoader$1[];
+  signal?: AbortSignal;
+  images?: ImagesInput$1;
 };
 declare class Renderer {
-  private fontsByKey;
-  private fontsByData;
   private inner;
-  private getFont;
-  private setFont;
-  private deleteFont;
-  private prepareFonts;
+  private fonts;
   render(node: Node, options?: RenderOptions): Promise<Uint8Array<ArrayBufferLike>>;
   renderAsDataUrl(node: Node, options?: RenderOptions): Promise<string>;
   renderSvg(node: Node, options?: SvgRenderOptions): Promise<string>;
   measure(node: Node, options?: RenderOptions): Promise<MeasuredNode>;
   renderAnimation(options: RenderAnimationOptions): Promise<Uint8Array<ArrayBufferLike>>;
+  registerFont(font: FontLoader$1): any;
+  /** Releases the underlying wasm renderer's memory. */
   free(): void;
-  registerFont(font: FontLoader): Promise<RegisteredFamily[]>;
 }
 //#endregion
-export { AnimationOutputFormatOptions, AnimationSceneSource, ByteBuf, ContainerNode, Font, FontDetails, FontLoader, ImageLoader, ImageNode, ImageSource, InitInput, InitOutput, KeyframeRule, Keyframes, KeyframesMap, KeyframesRule, KeyframesRuleList, MeasuredNode, MeasuredTextRun, type Node, NodeMetadata, OutputFormatOptions, RegisteredFace, RegisteredFamily, RenderAnimationOptions, RenderOptions, Renderer, SvgRenderOptions, SyncInitInput, TextNode, __wbg_init as default, extractResourceUrls, initSync };
+export { AnimationOutputFormat, type AnimationOutputFormatOptions, AnimationScene, ByteBuf, ContainerNode, DitheringAlgorithm, Font, FontDetails, type FontLoader, ImageCacheMode, type ImageLoader, ImageNode, ImageSource, type ImagesInput, InitInput, InitOutput, KeyframeRule, Keyframes, KeyframesMap, KeyframesRule, KeyframesRuleList, MeasuredNode, MeasuredTextRun, type Node, NodeMetadata, OutputFormat, type OutputFormatOptions, RegisteredFace, RegisteredFamily, RenderAnimationOptions, RenderOptions, Renderer, SvgRenderOptions, SyncInitInput, TextNode, __wbg_init as default, initSync };

package/dist/export.d.mts

@@ -1,4 +1,5 @@
-import { ContainerNode, ImageNode, Node, Node as Node$1, NodeMetadata, TextNode, extractResourceUrls } from "@takumi-rs/helpers";
+import { ContainerNode, ImageNode, Node, Node as Node$1, NodeMetadata, TextNode } from "@takumi-rs/helpers";
+import { AnimationOutputFormatOptions, AnimationOutputFormatOptions as AnimationOutputFormatOptions$1, FontLoader, FontLoader as FontLoader$1, ImageLoader, ImagesInput, ImagesInput as ImagesInput$1, OutputFormatOptions, OutputFormatOptions as OutputFormatOptions$1 } from "@takumi-rs/helpers/renderer";
 import { Properties } from "csstype";
 
 //#region pkg/takumi_wasm.d.ts
@@ -12,6 +13,14 @@ type KeyframesRuleList = {
   }[];
 }[];
 type Keyframes = KeyframesMap | KeyframesRuleList;
+/** Output format for static images. */
+type OutputFormat = "png" | "jpeg" | "webp" | "ico" | "raw";
+/** Output format for animated images. */
+type AnimationOutputFormat = "webp" | "apng" | "gif";
+/** The output dithering algorithm. */
+type DitheringAlgorithm = "none" | "ordered-bayer" | "floyd-steinberg";
+/** Cache policy for a decoded image. Defaults to `"auto"`. */
+type ImageCacheMode = "auto" | "none";
 type RenderOptions$1 = {
   /**
    * The width of the image. If not provided, the width will be automatically calculated based on the content.
@@ -25,11 +34,17 @@ type RenderOptions$1 = {
    * The format of the image.
    * @default "png"
    */
-  format?: "png" | "jpeg" | "webp" | "ico" | "raw";
+  format?: OutputFormat;
   /**
-   * The quality of JPEG format (0-100).
+   * The quality of lossy formats (0-100). For JPEG; on wasm, WebP is always
+   * lossless so this is ignored for WebP.
    */
   quality?: number;
+  /**
+   * Encode WebP losslessly. On wasm, WebP is always lossless, so this is
+   * accepted for parity with the native backend but has no effect.
+   */
+  lossless?: boolean;
   /**
    * Images keyed by `src`, each carrying raw bytes. Provided up front and used
    * in place of fetching external `src` URLs during rendering.
@@ -60,26 +75,33 @@ type RenderOptions$1 = {
    * The output dithering algorithm.
    * @default "none"
    */
-  dithering?: "none" | "ordered-bayer" | "floyd-steinberg";
+  dithering?: DitheringAlgorithm;
   /**
    * Per-render font stack: ordered family names used as the fallback chain.
    * Defaults to all registered families in registration order.
    */
-  fontFamilies?: string[];
+  fontFamilies?: string[]; /** Default BCP-47 language applied to the root, inherited by nodes without their own lang. */
+  lang?: string;
 };
 /**
  * SVG is a vector format, so the raster-only knobs do not apply.
  */
-type SvgRenderOptions$1 = Omit<RenderOptions$1, "format" | "quality" | "drawDebugBorder" | "devicePixelRatio" | "dithering">;
+type SvgRenderOptions$1 = Omit<RenderOptions$1, "format" | "quality" | "lossless" | "drawDebugBorder" | "devicePixelRatio" | "dithering">;
 type RenderAnimationOptions$1 = {
-  scenes: AnimationSceneSource[];
+  scenes: AnimationScene[];
   width: number;
   height: number;
-  format?: "webp" | "apng" | "gif";
+  format?: AnimationOutputFormat;
   /**
-   * The quality of WebP format (0-100). Ignored for APNG and GIF.
+   * The quality of lossy WebP (0-100). Ignored for APNG and GIF; on wasm, WebP
+   * is always lossless so this is ignored for WebP too.
    */
   quality?: number;
+  /**
+   * Encode WebP losslessly. On wasm, animated WebP is always lossless, so this
+   * is accepted for parity with the native backend but has no effect.
+   */
+  lossless?: boolean;
   /**
    * Images keyed by `src`, each carrying raw bytes. Provided up front and used
    * in place of fetching external `src` URLs during rendering.
@@ -90,6 +112,10 @@ type RenderAnimationOptions$1 = {
    * CSS stylesheets to apply before rendering.
    */
   stylesheets?: string[];
+  /**
+   * Structured keyframes to register alongside stylesheets.
+   */
+  keyframes?: Keyframes;
   /**
    * Defines the ratio resolution of the image to the physical pixels.
    * @default 1.0
@@ -103,7 +129,8 @@ type RenderAnimationOptions$1 = {
    * Per-render font stack: ordered family names used as the fallback chain.
    * Defaults to all registered families in registration order.
    */
-  fontFamilies?: string[];
+  fontFamilies?: string[]; /** Default BCP-47 language applied to the root, inherited by nodes without their own lang. */
+  lang?: string;
 };
 type FontDetails = {
   name?: string;
@@ -120,7 +147,7 @@ type FontDetails = {
 type ImageSource = {
   src: string;
   data: ByteBuf; /** Cache policy for the decoded image. Defaults to `"auto"`. */
-  cache?: "auto" | "none";
+  cache?: ImageCacheMode;
 };
 type KeyframeRule = {
   offsets: number[];
@@ -155,7 +182,7 @@ type MeasuredNode = {
   children: MeasuredNode[];
   runs: MeasuredTextRun[];
 };
-type AnimationSceneSource = {
+type AnimationScene = {
   node: Node$1;
   durationMs: number;
 };
@@ -204,80 +231,32 @@ declare function __wbg_init(module_or_path?: {
 } | InitInput | Promise<InitInput>): Promise<InitOutput>;
 //#endregion
 //#region src/export.d.ts
-/**
- * A font to register. Either a URL string (fetched on demand, with name/weight/style read from the
- * file), raw bytes, or a descriptor with a lazy `data()` loader.
- */
-type FontLoader = string | Font | (Omit<FontDetails, "data"> & {
-  data: () => Promise<FontDetails["data"]> | FontDetails["data"]; /** Inclusive codepoint ranges this face covers; lets `render` skip it when unused. */
-  ranges?: [number, number][];
-} & ({
-  key: string;
-} | {
-  name: string;
-}));
-type ImageLoaderData = ImageSource["data"];
-type ImageLoader = Omit<ImageSource, "data"> & {
-  data: ImageLoaderData | (() => ImageLoaderData | Promise<ImageLoaderData>);
-};
-/**
- * Output format. Format-specific options live on the variant that supports them,
- * so `quality` cannot be paired with a lossless format. On wasm, WebP is always
- * lossless (lossy WebP is native-only).
- */
-type OutputFormatOptions = {
-  format?: "png";
-} | {
-  format: "jpeg";
-  quality?: number;
-} | {
-  format: "webp";
-} | {
-  format: "ico";
-} | {
-  format: "raw";
-};
-type RenderOptions = Omit<RenderOptions$1, "images" | "format" | "quality"> & OutputFormatOptions & {
-  fonts?: FontLoader[];
-  images?: ImageLoader[]; /** Register only the `fonts` subsets the content renders. @default true */
-  subset?: boolean;
-};
-/**
- * Animation output format. On wasm, WebP animation is always lossless (lossy
- * WebP is native-only).
- */
-type AnimationOutputFormatOptions = {
-  format?: "webp";
-} | {
-  format: "apng";
-} | {
-  format: "gif";
+type RenderOptions = Omit<RenderOptions$1, "images" | "format" | "quality" | "lossless"> & OutputFormatOptions$1 & {
+  fonts?: FontLoader$1[];
+  signal?: AbortSignal;
+  images?: ImagesInput$1;
 };
-type RenderAnimationOptions = Omit<RenderAnimationOptions$1, "images" | "format"> & AnimationOutputFormatOptions & {
-  fonts?: FontLoader[];
-  images?: ImageLoader[]; /** Register only the `fonts` subsets the content renders. @default true */
-  subset?: boolean;
+type RenderAnimationOptions = Omit<RenderAnimationOptions$1, "images" | "format" | "quality" | "lossless"> & AnimationOutputFormatOptions$1 & {
+  fonts?: FontLoader$1[];
+  signal?: AbortSignal;
+  images?: ImagesInput$1;
 };
 type SvgRenderOptions = Omit<SvgRenderOptions$1, "images"> & {
-  fonts?: FontLoader[];
-  images?: ImageLoader[]; /** Register only the `fonts` subsets the content renders. @default true */
-  subset?: boolean;
+  fonts?: FontLoader$1[];
+  signal?: AbortSignal;
+  images?: ImagesInput$1;
 };
 declare class Renderer {
-  private fontsByKey;
-  private fontsByData;
   private inner;
-  private getFont;
-  private setFont;
-  private deleteFont;
-  private prepareFonts;
+  private fonts;
   render(node: Node, options?: RenderOptions): Promise<Uint8Array<ArrayBufferLike>>;
   renderAsDataUrl(node: Node, options?: RenderOptions): Promise<string>;
   renderSvg(node: Node, options?: SvgRenderOptions): Promise<string>;
   measure(node: Node, options?: RenderOptions): Promise<MeasuredNode>;
   renderAnimation(options: RenderAnimationOptions): Promise<Uint8Array<ArrayBufferLike>>;
+  registerFont(font: FontLoader$1): any;
+  /** Releases the underlying wasm renderer's memory. */
   free(): void;
-  registerFont(font: FontLoader): Promise<RegisteredFamily[]>;
 }
 //#endregion
-export { AnimationOutputFormatOptions, AnimationSceneSource, ByteBuf, ContainerNode, Font, FontDetails, FontLoader, ImageLoader, ImageNode, ImageSource, InitInput, InitOutput, KeyframeRule, Keyframes, KeyframesMap, KeyframesRule, KeyframesRuleList, MeasuredNode, MeasuredTextRun, type Node, NodeMetadata, OutputFormatOptions, RegisteredFace, RegisteredFamily, RenderAnimationOptions, RenderOptions, Renderer, SvgRenderOptions, SyncInitInput, TextNode, __wbg_init as default, extractResourceUrls, initSync };
+export { AnimationOutputFormat, type AnimationOutputFormatOptions, AnimationScene, ByteBuf, ContainerNode, DitheringAlgorithm, Font, FontDetails, type FontLoader, ImageCacheMode, type ImageLoader, ImageNode, ImageSource, type ImagesInput, InitInput, InitOutput, KeyframeRule, Keyframes, KeyframesMap, KeyframesRule, KeyframesRuleList, MeasuredNode, MeasuredTextRun, type Node, NodeMetadata, OutputFormat, type OutputFormatOptions, RegisteredFace, RegisteredFamily, RenderAnimationOptions, RenderOptions, Renderer, SvgRenderOptions, SyncInitInput, TextNode, __wbg_init as default, initSync };

package/dist/export.mjs

@@ -1,4 +1,5 @@
-import { extractResourceUrls, fontFromUrl, pickFonts } from "@takumi-rs/helpers";
+import { subsetFonts } from "@takumi-rs/helpers";
+import { FontRegistry } from "@takumi-rs/helpers/renderer";
 //#region pkg/takumi_wasm.js
 /**
 * The main renderer for Takumi image rendering engine.
@@ -513,145 +514,82 @@ async function __wbg_init(module_or_path) {
 }
 //#endregion
 //#region src/export.ts
-async function resolveImageLoaders(images) {
-	const bySrc = /* @__PURE__ */ new Map();
-	for (const image of images) bySrc.set(image.src, image);
-	return Promise.all([...bySrc.values()].map(async ({ src, data, cache }) => ({
-		src,
-		data: typeof data === "function" ? await data() : data,
-		cache
-	})));
-}
 var Renderer = class {
-	fontsByKey = /* @__PURE__ */ new Map();
-	fontsByData = /* @__PURE__ */ new WeakMap();
 	inner = new Renderer$1();
-	getFont(key) {
-		return typeof key === "string" ? this.fontsByKey.get(key) : this.fontsByData.get(key);
-	}
-	setFont(key, family) {
-		if (typeof key === "string") this.fontsByKey.set(key, family);
-		else this.fontsByData.set(key, family);
-	}
-	deleteFont(key) {
-		if (typeof key === "string") this.fontsByKey.delete(key);
-		else this.fontsByData.delete(key);
-	}
-	async prepareFonts(fonts) {
-		if (!fonts) return;
-		const families = await Promise.all(fonts.map(this.registerFont.bind(this)));
-		return [...new Set(families.flat().map((f) => f.name))];
-	}
+	fonts = new FontRegistry((font) => this.inner.registerFont(font));
 	async render(node, options) {
-		const { fonts, fontFamilies, images, subset, ...rest } = options ?? {};
-		const registeredFamilies = await this.prepareFonts(pickFonts({
+		const { fonts, fontFamilies, signal, images, ...rest } = options ?? {};
+		signal?.throwIfAborted();
+		const resolved = await this.fonts.resolveResources(fonts && subsetFonts({
 			fonts,
-			source: node,
-			subset
-		}));
-		const resolvedImages = images ? await resolveImageLoaders(images) : void 0;
+			source: node
+		}), images, fontFamilies);
+		signal?.throwIfAborted();
 		return this.inner.render(node, {
 			...rest,
-			images: resolvedImages,
-			fontFamilies: fontFamilies ?? registeredFamilies
+			...resolved
 		});
 	}
 	async renderAsDataUrl(node, options) {
-		const { fonts, fontFamilies, images, subset, ...rest } = options ?? {};
-		const registeredFamilies = await this.prepareFonts(pickFonts({
+		const { fonts, fontFamilies, signal, images, ...rest } = options ?? {};
+		signal?.throwIfAborted();
+		const resolved = await this.fonts.resolveResources(fonts && subsetFonts({
 			fonts,
-			source: node,
-			subset
-		}));
-		const resolvedImages = images ? await resolveImageLoaders(images) : void 0;
+			source: node
+		}), images, fontFamilies);
+		signal?.throwIfAborted();
 		return this.inner.renderAsDataUrl(node, {
 			...rest,
-			images: resolvedImages,
-			fontFamilies: fontFamilies ?? registeredFamilies
+			...resolved
 		});
 	}
 	async renderSvg(node, options) {
-		const { fonts, fontFamilies, images, subset, ...rest } = options ?? {};
-		const registeredFamilies = await this.prepareFonts(pickFonts({
+		const { fonts, fontFamilies, signal, images, ...rest } = options ?? {};
+		signal?.throwIfAborted();
+		const resolved = await this.fonts.resolveResources(fonts && subsetFonts({
 			fonts,
-			source: node,
-			subset
-		}));
-		const resolvedImages = images ? await resolveImageLoaders(images) : void 0;
+			source: node
+		}), images, fontFamilies);
+		signal?.throwIfAborted();
 		return this.inner.renderSvg(node, {
 			...rest,
-			images: resolvedImages,
-			fontFamilies: fontFamilies ?? registeredFamilies
+			...resolved
 		});
 	}
 	async measure(node, options) {
-		const { fonts, fontFamilies, images, subset, ...rest } = options ?? {};
-		const registeredFamilies = await this.prepareFonts(pickFonts({
+		const { fonts, fontFamilies, signal, images, ...rest } = options ?? {};
+		signal?.throwIfAborted();
+		const resolved = await this.fonts.resolveResources(fonts && subsetFonts({
 			fonts,
-			source: node,
-			subset
-		}));
-		const resolvedImages = images ? await resolveImageLoaders(images) : void 0;
+			source: node
+		}), images, fontFamilies);
+		signal?.throwIfAborted();
 		return this.inner.measure(node, {
 			...rest,
-			images: resolvedImages,
-			fontFamilies: fontFamilies ?? registeredFamilies
+			...resolved
 		});
 	}
 	async renderAnimation(options) {
-		const { fonts, fontFamilies, images, subset, ...rest } = options;
+		const { fonts, fontFamilies, signal, images, ...rest } = options;
+		signal?.throwIfAborted();
 		const nodes = options.scenes.map((scene) => scene.node);
-		const registeredFamilies = await this.prepareFonts(pickFonts({
+		const resolved = await this.fonts.resolveResources(fonts && subsetFonts({
 			fonts,
-			source: nodes,
-			subset
-		}));
-		const resolvedImages = images ? await resolveImageLoaders(images) : void 0;
+			source: nodes
+		}), images, fontFamilies);
+		signal?.throwIfAborted();
 		return this.inner.renderAnimation({
 			...rest,
-			images: resolvedImages,
-			fontFamilies: fontFamilies ?? registeredFamilies
+			...resolved
 		});
 	}
+	registerFont(font) {
+		return this.fonts.register(font);
+	}
+	/** Releases the underlying wasm renderer's memory. */
 	free() {
 		this.inner.free();
 	}
-	async registerFont(font) {
-		const loader = typeof font === "string" ? fontFromUrl(font) : font;
-		const key = createFontKey(loader);
-		const cached = this.getFont(key);
-		if (cached) return cached;
-		const extracted = extractFontBuffer(loader);
-		const register = (data) => this.inner.registerFont(isBuffer(loader) ? data : {
-			...loader,
-			data
-		});
-		if (isBuffer(extracted)) {
-			const binded = register(extracted);
-			this.setFont(key, Promise.resolve(binded));
-			return binded;
-		}
-		const promise = extracted.then(register).catch((error) => {
-			this.deleteFont(key);
-			throw error;
-		});
-		this.setFont(key, promise);
-		return promise;
-	}
 };
-function extractFontBuffer(font) {
-	if (isBuffer(font)) return font;
-	if (typeof font.data !== "function") return font.data;
-	return font.data();
-}
-function createFontKey(font) {
-	if (isBuffer(font)) return font;
-	if ("key" in font && font.key) return font.key;
-	if (typeof font.data === "function") return `${font.name ?? ""}:${font.weight ?? ""}:${font.style ?? ""}`;
-	return font.data;
-}
-function isBuffer(data) {
-	return data instanceof Uint8Array || data instanceof ArrayBuffer || typeof Buffer !== "undefined" && Buffer.isBuffer(data);
-}
 //#endregion
-export { Renderer, __wbg_init as default, extractResourceUrls, initSync };
+export { Renderer, __wbg_init as default, initSync };

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@takumi-rs/wasm",
-  "version": "2.0.0-rc.1",
+  "version": "2.0.0-rc.11",
+  "description": "WebAssembly bindings for Takumi, a Rust image rendering engine.",
   "keywords": [
     "css",
     "image",
@@ -116,7 +117,7 @@
     "publish-lint": "attw --pack . && publint --strict ."
   },
   "dependencies": {
-    "@takumi-rs/helpers": "2.0.0-rc.1",
+    "@takumi-rs/helpers": "2.0.0-rc.11",
     "csstype": "^3.2.3"
   },
   "devDependencies": {