@takumi-rs/core 1.8.6 → 2.0.0-beta.0

package/dist/export.d.cts

@@ -0,0 +1,329 @@
+import { ContainerNode, ImageNode, Node, NodeMetadata, TextNode, extractResourceUrls } from "@takumi-rs/helpers";
+import { Properties } from "csstype";
+
+//#region index.d.ts
+type ByteBuf = Uint8Array | ArrayBuffer | Buffer;
+interface FontDetails {
+  /**
+   * The name of the font. If not provided, the name in the font file will be used.
+   */
+  name?: string;
+  /**
+   * The font data.
+   */
+  data: ByteBuf;
+  /**
+   * The weight of the font. If not provided, the weight in the font file will be used.
+   */
+  weight?: number;
+  /**
+   * The style of the font. If not provided, the style in the font file will be used.
+   */
+  style?: "normal" | "italic" | "oblique" | `oblique ${number}deg` | (string & {});
+}
+type Font = FontDetails | ByteBuf;
+type KeyframesMap = Record<string, Record<string, Properties>>;
+type KeyframesRuleList = {
+  name: string;
+  keyframes: {
+    offsets: number[];
+    declarations: Record<string, Properties>;
+  }[];
+}[];
+type Keyframes = KeyframesMap | KeyframesRuleList;
+/** Represents a single frame in a precomputed animation sequence. */
+interface AnimationFrameSource {
+  /** The node tree to render for this frame. */
+  node: Node;
+  /** The duration of this frame in milliseconds. */
+  durationMs: number;
+}
+/** Output format for animated images. */
+type AnimationOutputFormat = /** Animated WebP format. */'webp' | /** Animated PNG format. */'apng' | /** Animated GIF format. */'gif';
+/** Represents a single scene in a sequential animation timeline. */
+interface AnimationSceneSource {
+  /** The node tree to render for this scene. */
+  node: Node;
+  /** The duration of this scene in milliseconds. */
+  durationMs: number;
+}
+type DitheringAlgorithm = 'none' | 'ordered-bayer' | 'floyd-steinberg';
+/** Options for encoding a precomputed frame sequence. */
+interface EncodeFramesOptions$1 {
+  /** Whether to draw debug borders around layout elements. */
+  drawDebugBorder?: boolean;
+  /** The width of each frame in pixels. */
+  width: number;
+  /** The height of each frame in pixels. */
+  height: number;
+  /** The output animation format (WebP, APNG, or GIF). */
+  format?: AnimationOutputFormat;
+  /**
+   * The quality of lossy WebP (0-100). Ignored for APNG and GIF, and when
+   * `lossless` is set.
+   */
+  quality?: number;
+  /**
+   * Encode WebP losslessly. Defaults to lossless when neither `quality` nor
+   * `lossless` is given. Ignored for APNG and GIF.
+   */
+  lossless?: boolean;
+  /** Images keyed by `src`, each carrying raw bytes. */
+  images?: Array<ImageSource>;
+  /** CSS stylesheets to apply before rendering. */
+  stylesheets?: Array<string>;
+  /**
+   * The device pixel ratio.
+   * @default 1.0
+   */
+  devicePixelRatio?: number;
+  /**
+   * Per-render font stack: ordered family names used as the fallback chain.
+   * Defaults to all registered families in registration order.
+   */
+  fontFamilies?: Array<string>;
+}
+/** Cache policy for a decoded image. Defaults to `"auto"`. */
+type ImageCacheMode = /** Cache the decoded image for reuse (evictable). */'auto' | /** Skip the decoded-image cache. */'none';
+/** An image source with its URL and raw data. */
+interface ImageSource {
+  /** The source URL of the image. */
+  src: string;
+  /** The raw image data (Uint8Array or ArrayBuffer). */
+  data: Uint8Array | ArrayBuffer;
+  /** Cache policy for the decoded image. Defaults to `"auto"`. */
+  cache?: ImageCacheMode;
+}
+/** Represents a node that has been measured, including its layout information. */
+interface MeasuredNode {
+  /** The measured width of the node. */
+  width: number;
+  /** The measured height of the node. */
+  height: number;
+  /** The transformation matrix of the node. */
+  transform: [number, number, number, number, number, number];
+  /** The children of the node. */
+  children: Array<MeasuredNode>;
+  /** The text runs within the node. */
+  runs: Array<MeasuredTextRun>;
+}
+/** Represents a single run of text in a measured node. */
+interface MeasuredTextRun {
+  /** The text content of the run. */
+  text: string;
+  /** The inline x-coordinate of the run. */
+  x: number;
+  /** The inline y-coordinate of the run. */
+  y: number;
+  /** The width of the run. */
+  width: number;
+  /** The height of the run. */
+  height: number;
+}
+/** Output format for static images. */
+type OutputFormat = /** WebP format. */'webp' | /** PNG format. */'png' | /** JPEG format. */'jpeg' | /** ICO format. */'ico' | /** Raw pixels format. */'raw';
+/** A single face within a `RegisteredFamily`. */
+interface RegisteredFace {
+  /** Weight class, typically `1`–`1000`. */
+  weight: number;
+  /** CSS `font-style` value (`normal`, `italic`, or `oblique [<angle>deg]`). */
+  style: string;
+  /** Width as a percentage of normal (e.g. `100`). */
+  width: number;
+  /** Index of the face within its source collection. */
+  index: number;
+}
+/** A font family produced by `registerFont`, with the faces it contains. */
+interface RegisteredFamily {
+  /** Family name as stored by the font system (normalized; reflects any override). */
+  name: string;
+  /** Faces registered under this family. */
+  faces: Array<RegisteredFace>;
+}
+/** Options for rendering a sequential scene animation. */
+interface RenderAnimationOptions$1 {
+  /** The scenes to render sequentially. */
+  scenes: Array<AnimationSceneSource>;
+  /** Whether to draw debug borders around layout elements. */
+  drawDebugBorder?: boolean;
+  /** The width of each frame in pixels. */
+  width: number;
+  /** The height of each frame in pixels. */
+  height: number;
+  /** The output animation format (WebP, APNG, or GIF). */
+  format?: AnimationOutputFormat;
+  /**
+   * The quality of lossy WebP (0-100). Ignored for APNG and GIF, and when
+   * `lossless` is set.
+   */
+  quality?: number;
+  /**
+   * Encode WebP losslessly. Defaults to lossless when neither `quality` nor
+   * `lossless` is given. Ignored for APNG and GIF.
+   */
+  lossless?: boolean;
+  /** Frames per second for timeline sampling. */
+  fps: number;
+  /** Images keyed by `src`, each carrying raw bytes. */
+  images?: Array<ImageSource>;
+  /** CSS stylesheets to apply before rendering. */
+  stylesheets?: Array<string>;
+  /**
+   * The device pixel ratio.
+   * @default 1.0
+   */
+  devicePixelRatio?: number;
+  /**
+   * Per-render font stack: ordered family names used as the fallback chain.
+   * Defaults to all registered families in registration order.
+   */
+  fontFamilies?: Array<string>;
+}
+/** Options for rendering an image. */
+interface RenderOptions$1 {
+  /** The width of the image. If not provided, the width will be automatically calculated based on the content. */
+  width?: number;
+  /** The height of the image. If not provided, the height will be automatically calculated based on the content. */
+  height?: number;
+  /** The format of the image. */
+  format?: OutputFormat;
+  /**
+   * The quality of lossy formats (0-100). For JPEG; for WebP it selects lossy
+   * encoding unless `lossless` is set.
+   */
+  quality?: number;
+  /**
+   * Encode WebP losslessly. Defaults to lossless when neither `quality` nor
+   * `lossless` is given.
+   */
+  lossless?: boolean;
+  /** Whether to draw debug borders. */
+  drawDebugBorder?: boolean;
+  /** Images keyed by `src`, each carrying raw bytes. */
+  images?: Array<ImageSource>;
+  /** CSS stylesheets to apply before rendering. */
+  stylesheets?: Array<string>;
+  /** Structured keyframes to register alongside stylesheets. */
+  keyframes?: Keyframes;
+  /**
+   * The device pixel ratio.
+   * @default 1.0
+   */
+  devicePixelRatio?: number;
+  /** The animation timeline time in milliseconds. */
+  timeMs?: number;
+  /** The output dithering algorithm. */
+  dithering?: DitheringAlgorithm;
+  /**
+   * Per-render font stack: ordered family names used as the fallback chain.
+   * Defaults to all registered families in registration order.
+   */
+  fontFamilies?: Array<string>;
+}
+/**
+ * Options for rendering a node tree to an SVG document. SVG is a vector
+ * format, so the raster-only knobs (`format`, `quality`, `lossless`,
+ * `dithering`, `drawDebugBorder`, `devicePixelRatio`) do not apply.
+ */
+interface SvgRenderOptions$1 {
+  /** The width of the viewport. If not provided, it is derived from content. */
+  width?: number;
+  /** The height of the viewport. If not provided, it is derived from content. */
+  height?: number;
+  /** Images keyed by `src`, each carrying raw bytes. */
+  images?: Array<ImageSource>;
+  /** CSS stylesheets to apply before rendering. */
+  stylesheets?: Array<string>;
+  /** Structured keyframes to register alongside stylesheets. */
+  keyframes?: Keyframes;
+  /** The animation timeline time in milliseconds. */
+  timeMs?: number;
+  /**
+   * Per-render font stack: ordered family names used as the fallback chain.
+   * Defaults to all registered families in registration order.
+   */
+  fontFamilies?: Array<string>;
+}
+//#endregion
+//#region src/export.d.ts
+type FontLoader = Font | (Omit<FontDetails, "data"> & {
+  data: () => Promise<FontDetails["data"]> | FontDetails["data"];
+} & ({
+  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 PNG/ICO/raw, and `lossless` is WebP-only.
+ * For WebP, `lossless` takes precedence over `quality`; omitting both encodes
+ * losslessly.
+ */
+type OutputFormatOptions = {
+  format?: "png";
+} | {
+  format: "jpeg";
+  quality?: number;
+} | {
+  format: "webp";
+  quality?: number;
+  lossless?: boolean;
+} | {
+  format: "ico";
+} | {
+  format: "raw";
+};
+type RenderOptions = Omit<RenderOptions$1, "images" | "format" | "quality" | "lossless"> & OutputFormatOptions & {
+  fonts?: FontLoader[];
+  signal?: AbortSignal;
+  images?: ImageLoader[];
+};
+/**
+ * Animation output format. `quality` and `lossless` are WebP-only; for WebP,
+ * `lossless` takes precedence over `quality`, and omitting both encodes
+ * losslessly.
+ */
+type AnimationOutputFormatOptions = {
+  format?: "webp";
+  quality?: number;
+  lossless?: boolean;
+} | {
+  format: "apng";
+} | {
+  format: "gif";
+};
+type RenderAnimationOptions = Omit<RenderAnimationOptions$1, "images" | "format" | "quality" | "lossless"> & AnimationOutputFormatOptions & {
+  fonts?: FontLoader[];
+  signal?: AbortSignal;
+  images?: ImageLoader[];
+};
+type EncodeFramesOptions = Omit<EncodeFramesOptions$1, "images" | "format" | "quality" | "lossless"> & AnimationOutputFormatOptions & {
+  fonts?: FontLoader[];
+  signal?: AbortSignal;
+  images?: ImageLoader[];
+};
+type SvgRenderOptions = Omit<SvgRenderOptions$1, "images"> & {
+  fonts?: FontLoader[];
+  signal?: AbortSignal;
+  images?: ImageLoader[];
+};
+declare class Renderer {
+  private fontMapping;
+  private inner;
+  private prepareFonts;
+  /** Registers `fonts` and resolves lazy `images`, yielding the `images`/`fontFamilies`
+   * the napi binding expects. Explicit `fontFamilies` wins over the registered set. */
+  private resolveResources;
+  render(node: Node, options?: RenderOptions): Promise<Buffer>;
+  renderSvg(node: Node, options?: SvgRenderOptions): Promise<string>;
+  measure(node: Node, options?: RenderOptions): Promise<MeasuredNode>;
+  renderAnimation(options: RenderAnimationOptions): Promise<Buffer>;
+  encodeFrames(frames: AnimationFrameSource[], options: EncodeFramesOptions): Promise<Buffer>;
+  registerFont(font: FontLoader): Promise<any>;
+}
+//#endregion
+export { type AnimationFrameSource, type AnimationOutputFormat, AnimationOutputFormatOptions, type AnimationSceneSource, type ByteBuf, type ContainerNode, type DitheringAlgorithm, EncodeFramesOptions, type Font, type FontDetails, FontLoader, type ImageCacheMode, ImageLoader, type ImageNode, type ImageSource, type Keyframes, type KeyframesMap, type KeyframesRuleList, type MeasuredNode, type MeasuredTextRun, type Node, type NodeMetadata, type OutputFormat, OutputFormatOptions, type RegisteredFace, type RegisteredFamily, RenderAnimationOptions, RenderOptions, Renderer, SvgRenderOptions, type TextNode, extractResourceUrls };

package/dist/export.d.mts

@@ -0,0 +1,329 @@
+import { ContainerNode, ImageNode, Node, NodeMetadata, TextNode, extractResourceUrls } from "@takumi-rs/helpers";
+import { Properties } from "csstype";
+
+//#region index.d.ts
+type ByteBuf = Uint8Array | ArrayBuffer | Buffer;
+interface FontDetails {
+  /**
+   * The name of the font. If not provided, the name in the font file will be used.
+   */
+  name?: string;
+  /**
+   * The font data.
+   */
+  data: ByteBuf;
+  /**
+   * The weight of the font. If not provided, the weight in the font file will be used.
+   */
+  weight?: number;
+  /**
+   * The style of the font. If not provided, the style in the font file will be used.
+   */
+  style?: "normal" | "italic" | "oblique" | `oblique ${number}deg` | (string & {});
+}
+type Font = FontDetails | ByteBuf;
+type KeyframesMap = Record<string, Record<string, Properties>>;
+type KeyframesRuleList = {
+  name: string;
+  keyframes: {
+    offsets: number[];
+    declarations: Record<string, Properties>;
+  }[];
+}[];
+type Keyframes = KeyframesMap | KeyframesRuleList;
+/** Represents a single frame in a precomputed animation sequence. */
+interface AnimationFrameSource {
+  /** The node tree to render for this frame. */
+  node: Node;
+  /** The duration of this frame in milliseconds. */
+  durationMs: number;
+}
+/** Output format for animated images. */
+type AnimationOutputFormat = /** Animated WebP format. */'webp' | /** Animated PNG format. */'apng' | /** Animated GIF format. */'gif';
+/** Represents a single scene in a sequential animation timeline. */
+interface AnimationSceneSource {
+  /** The node tree to render for this scene. */
+  node: Node;
+  /** The duration of this scene in milliseconds. */
+  durationMs: number;
+}
+type DitheringAlgorithm = 'none' | 'ordered-bayer' | 'floyd-steinberg';
+/** Options for encoding a precomputed frame sequence. */
+interface EncodeFramesOptions$1 {
+  /** Whether to draw debug borders around layout elements. */
+  drawDebugBorder?: boolean;
+  /** The width of each frame in pixels. */
+  width: number;
+  /** The height of each frame in pixels. */
+  height: number;
+  /** The output animation format (WebP, APNG, or GIF). */
+  format?: AnimationOutputFormat;
+  /**
+   * The quality of lossy WebP (0-100). Ignored for APNG and GIF, and when
+   * `lossless` is set.
+   */
+  quality?: number;
+  /**
+   * Encode WebP losslessly. Defaults to lossless when neither `quality` nor
+   * `lossless` is given. Ignored for APNG and GIF.
+   */
+  lossless?: boolean;
+  /** Images keyed by `src`, each carrying raw bytes. */
+  images?: Array<ImageSource>;
+  /** CSS stylesheets to apply before rendering. */
+  stylesheets?: Array<string>;
+  /**
+   * The device pixel ratio.
+   * @default 1.0
+   */
+  devicePixelRatio?: number;
+  /**
+   * Per-render font stack: ordered family names used as the fallback chain.
+   * Defaults to all registered families in registration order.
+   */
+  fontFamilies?: Array<string>;
+}
+/** Cache policy for a decoded image. Defaults to `"auto"`. */
+type ImageCacheMode = /** Cache the decoded image for reuse (evictable). */'auto' | /** Skip the decoded-image cache. */'none';
+/** An image source with its URL and raw data. */
+interface ImageSource {
+  /** The source URL of the image. */
+  src: string;
+  /** The raw image data (Uint8Array or ArrayBuffer). */
+  data: Uint8Array | ArrayBuffer;
+  /** Cache policy for the decoded image. Defaults to `"auto"`. */
+  cache?: ImageCacheMode;
+}
+/** Represents a node that has been measured, including its layout information. */
+interface MeasuredNode {
+  /** The measured width of the node. */
+  width: number;
+  /** The measured height of the node. */
+  height: number;
+  /** The transformation matrix of the node. */
+  transform: [number, number, number, number, number, number];
+  /** The children of the node. */
+  children: Array<MeasuredNode>;
+  /** The text runs within the node. */
+  runs: Array<MeasuredTextRun>;
+}
+/** Represents a single run of text in a measured node. */
+interface MeasuredTextRun {
+  /** The text content of the run. */
+  text: string;
+  /** The inline x-coordinate of the run. */
+  x: number;
+  /** The inline y-coordinate of the run. */
+  y: number;
+  /** The width of the run. */
+  width: number;
+  /** The height of the run. */
+  height: number;
+}
+/** Output format for static images. */
+type OutputFormat = /** WebP format. */'webp' | /** PNG format. */'png' | /** JPEG format. */'jpeg' | /** ICO format. */'ico' | /** Raw pixels format. */'raw';
+/** A single face within a `RegisteredFamily`. */
+interface RegisteredFace {
+  /** Weight class, typically `1`–`1000`. */
+  weight: number;
+  /** CSS `font-style` value (`normal`, `italic`, or `oblique [<angle>deg]`). */
+  style: string;
+  /** Width as a percentage of normal (e.g. `100`). */
+  width: number;
+  /** Index of the face within its source collection. */
+  index: number;
+}
+/** A font family produced by `registerFont`, with the faces it contains. */
+interface RegisteredFamily {
+  /** Family name as stored by the font system (normalized; reflects any override). */
+  name: string;
+  /** Faces registered under this family. */
+  faces: Array<RegisteredFace>;
+}
+/** Options for rendering a sequential scene animation. */
+interface RenderAnimationOptions$1 {
+  /** The scenes to render sequentially. */
+  scenes: Array<AnimationSceneSource>;
+  /** Whether to draw debug borders around layout elements. */
+  drawDebugBorder?: boolean;
+  /** The width of each frame in pixels. */
+  width: number;
+  /** The height of each frame in pixels. */
+  height: number;
+  /** The output animation format (WebP, APNG, or GIF). */
+  format?: AnimationOutputFormat;
+  /**
+   * The quality of lossy WebP (0-100). Ignored for APNG and GIF, and when
+   * `lossless` is set.
+   */
+  quality?: number;
+  /**
+   * Encode WebP losslessly. Defaults to lossless when neither `quality` nor
+   * `lossless` is given. Ignored for APNG and GIF.
+   */
+  lossless?: boolean;
+  /** Frames per second for timeline sampling. */
+  fps: number;
+  /** Images keyed by `src`, each carrying raw bytes. */
+  images?: Array<ImageSource>;
+  /** CSS stylesheets to apply before rendering. */
+  stylesheets?: Array<string>;
+  /**
+   * The device pixel ratio.
+   * @default 1.0
+   */
+  devicePixelRatio?: number;
+  /**
+   * Per-render font stack: ordered family names used as the fallback chain.
+   * Defaults to all registered families in registration order.
+   */
+  fontFamilies?: Array<string>;
+}
+/** Options for rendering an image. */
+interface RenderOptions$1 {
+  /** The width of the image. If not provided, the width will be automatically calculated based on the content. */
+  width?: number;
+  /** The height of the image. If not provided, the height will be automatically calculated based on the content. */
+  height?: number;
+  /** The format of the image. */
+  format?: OutputFormat;
+  /**
+   * The quality of lossy formats (0-100). For JPEG; for WebP it selects lossy
+   * encoding unless `lossless` is set.
+   */
+  quality?: number;
+  /**
+   * Encode WebP losslessly. Defaults to lossless when neither `quality` nor
+   * `lossless` is given.
+   */
+  lossless?: boolean;
+  /** Whether to draw debug borders. */
+  drawDebugBorder?: boolean;
+  /** Images keyed by `src`, each carrying raw bytes. */
+  images?: Array<ImageSource>;
+  /** CSS stylesheets to apply before rendering. */
+  stylesheets?: Array<string>;
+  /** Structured keyframes to register alongside stylesheets. */
+  keyframes?: Keyframes;
+  /**
+   * The device pixel ratio.
+   * @default 1.0
+   */
+  devicePixelRatio?: number;
+  /** The animation timeline time in milliseconds. */
+  timeMs?: number;
+  /** The output dithering algorithm. */
+  dithering?: DitheringAlgorithm;
+  /**
+   * Per-render font stack: ordered family names used as the fallback chain.
+   * Defaults to all registered families in registration order.
+   */
+  fontFamilies?: Array<string>;
+}
+/**
+ * Options for rendering a node tree to an SVG document. SVG is a vector
+ * format, so the raster-only knobs (`format`, `quality`, `lossless`,
+ * `dithering`, `drawDebugBorder`, `devicePixelRatio`) do not apply.
+ */
+interface SvgRenderOptions$1 {
+  /** The width of the viewport. If not provided, it is derived from content. */
+  width?: number;
+  /** The height of the viewport. If not provided, it is derived from content. */
+  height?: number;
+  /** Images keyed by `src`, each carrying raw bytes. */
+  images?: Array<ImageSource>;
+  /** CSS stylesheets to apply before rendering. */
+  stylesheets?: Array<string>;
+  /** Structured keyframes to register alongside stylesheets. */
+  keyframes?: Keyframes;
+  /** The animation timeline time in milliseconds. */
+  timeMs?: number;
+  /**
+   * Per-render font stack: ordered family names used as the fallback chain.
+   * Defaults to all registered families in registration order.
+   */
+  fontFamilies?: Array<string>;
+}
+//#endregion
+//#region src/export.d.ts
+type FontLoader = Font | (Omit<FontDetails, "data"> & {
+  data: () => Promise<FontDetails["data"]> | FontDetails["data"];
+} & ({
+  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 PNG/ICO/raw, and `lossless` is WebP-only.
+ * For WebP, `lossless` takes precedence over `quality`; omitting both encodes
+ * losslessly.
+ */
+type OutputFormatOptions = {
+  format?: "png";
+} | {
+  format: "jpeg";
+  quality?: number;
+} | {
+  format: "webp";
+  quality?: number;
+  lossless?: boolean;
+} | {
+  format: "ico";
+} | {
+  format: "raw";
+};
+type RenderOptions = Omit<RenderOptions$1, "images" | "format" | "quality" | "lossless"> & OutputFormatOptions & {
+  fonts?: FontLoader[];
+  signal?: AbortSignal;
+  images?: ImageLoader[];
+};
+/**
+ * Animation output format. `quality` and `lossless` are WebP-only; for WebP,
+ * `lossless` takes precedence over `quality`, and omitting both encodes
+ * losslessly.
+ */
+type AnimationOutputFormatOptions = {
+  format?: "webp";
+  quality?: number;
+  lossless?: boolean;
+} | {
+  format: "apng";
+} | {
+  format: "gif";
+};
+type RenderAnimationOptions = Omit<RenderAnimationOptions$1, "images" | "format" | "quality" | "lossless"> & AnimationOutputFormatOptions & {
+  fonts?: FontLoader[];
+  signal?: AbortSignal;
+  images?: ImageLoader[];
+};
+type EncodeFramesOptions = Omit<EncodeFramesOptions$1, "images" | "format" | "quality" | "lossless"> & AnimationOutputFormatOptions & {
+  fonts?: FontLoader[];
+  signal?: AbortSignal;
+  images?: ImageLoader[];
+};
+type SvgRenderOptions = Omit<SvgRenderOptions$1, "images"> & {
+  fonts?: FontLoader[];
+  signal?: AbortSignal;
+  images?: ImageLoader[];
+};
+declare class Renderer {
+  private fontMapping;
+  private inner;
+  private prepareFonts;
+  /** Registers `fonts` and resolves lazy `images`, yielding the `images`/`fontFamilies`
+   * the napi binding expects. Explicit `fontFamilies` wins over the registered set. */
+  private resolveResources;
+  render(node: Node, options?: RenderOptions): Promise<Buffer>;
+  renderSvg(node: Node, options?: SvgRenderOptions): Promise<string>;
+  measure(node: Node, options?: RenderOptions): Promise<MeasuredNode>;
+  renderAnimation(options: RenderAnimationOptions): Promise<Buffer>;
+  encodeFrames(frames: AnimationFrameSource[], options: EncodeFramesOptions): Promise<Buffer>;
+  registerFont(font: FontLoader): Promise<any>;
+}
+//#endregion
+export { type AnimationFrameSource, type AnimationOutputFormat, AnimationOutputFormatOptions, type AnimationSceneSource, type ByteBuf, type ContainerNode, type DitheringAlgorithm, EncodeFramesOptions, type Font, type FontDetails, FontLoader, type ImageCacheMode, ImageLoader, type ImageNode, type ImageSource, type Keyframes, type KeyframesMap, type KeyframesRuleList, type MeasuredNode, type MeasuredTextRun, type Node, type NodeMetadata, type OutputFormat, OutputFormatOptions, type RegisteredFace, type RegisteredFamily, RenderAnimationOptions, RenderOptions, Renderer, SvgRenderOptions, type TextNode, extractResourceUrls };