@elastic/isomer-image-takumi 0.0.0 → 0.2.0

package/dist/backend.d.ts

@@ -0,0 +1,168 @@
+import { type FontLoader } from '@takumi-rs/core';
+import type { ImagesInput } from 'takumi-pdf';
+/**
+ * The part of a `snapshot` surface result this backend reads: the markup, the
+ * stylesheet it is laid out against, and the viewport it was measured for.
+ *
+ * Declared structurally rather than imported from `@elastic/isomer-runtime`,
+ * so this backend depends on no isomer package. `SnapshotRenderResult` satisfies it.
+ */
+export interface ImageInput {
+    /** Static markup with a single root, as image layout requires. */
+    html: string;
+    /** The stylesheet the markup is laid out against, `light-dark(…)` already resolved. */
+    css: string;
+    /** The viewport, in CSS pixels; the output is this size. */
+    width: number;
+    height: number;
+}
+/**
+ * The part of a `snapshot` surface's `renderPages` result this backend reads:
+ * one page's markup each, all laid out against one stylesheet at one size.
+ * Structural like {@link ImageInput}; `SnapshotPagesResult` satisfies it.
+ */
+export interface PdfInput {
+    /** One page per entry, in order, each static markup with a single root. */
+    pages: readonly {
+        html: string;
+    }[];
+    /** One stylesheet collected across every page. */
+    css: string;
+    /** Every page's size, in CSS pixels. */
+    width: number;
+    height: number;
+}
+/** Options for {@link createTakumiImageBackend}. */
+export interface TakumiImageBackendOptions {
+    /**
+     * Fonts to register, in fallback order. A pack names families in its theme
+     * and this backend holds no opinion about which; nothing is registered by
+     * default, so an unregistered family falls back to takumi's built-in face.
+     *
+     * WOFF and WOFF2 are accepted as well as raw sfnt — `@takumi-rs/core` builds
+     * with takumi's `woff`/`woff2` features, so a `@fontsource/*` file can be
+     * passed as-is, as raw bytes or a lazy `data()`. A `FontLoader` string is a
+     * URL fetched on demand, not a filesystem path.
+     */
+    fonts?: readonly FontLoader[];
+    /** Byte budget for takumi's resource cache. `0` disables it. */
+    cacheMaxBytes?: number;
+}
+/** Per-render overrides. Geometry comes from the input, not from here. */
+export interface TakumiRenderOptions {
+    /**
+     * Raster pixels per CSS pixel: the PNG is `input.width * scale` by
+     * `input.height * scale`, rounded. A layout fixed in CSS pixels is
+     * unchanged; rounding moves the viewport by under half a raster pixel. `2`
+     * gives a 2x raster. Defaults to `1`.
+     */
+    scale?: number;
+    /**
+     * Takumi's zoom at a fixed canvas: the tree is laid out at
+     * `input.width / devicePixelRatio` CSS pixels and magnified to fill the
+     * canvas, so above `1` the PNG keeps its size and shows less of the frame.
+     * For a larger raster, use {@link TakumiRenderOptions.scale}.
+     */
+    devicePixelRatio?: number;
+}
+/** Document properties written into a PDF. */
+export interface TakumiPdfMetadata {
+    title?: string;
+    description?: string;
+    authors?: string[];
+    keywords?: string[];
+    creator?: string;
+    /** UTC, `YYYY-MM-DD` or `YYYY-MM-DDTHH:MM:SS`. Fixing it makes the bytes stable across renders. */
+    creationDate?: string;
+}
+/** Per-document options for {@link TakumiPdfBackend.pdf}. Geometry comes from the input. */
+export interface TakumiPdfOptions {
+    metadata?: TakumiPdfMetadata;
+    /**
+     * What a glyph no registered font covers becomes. The default, `'error'`,
+     * rejects the render naming the code point, where `png` draws takumi's
+     * built-in face instead; `'placeholder'` draws the font's glyph 0 and
+     * `'blank'` draws nothing.
+     */
+    uncoveredText?: 'error' | 'placeholder' | 'blank';
+    /**
+     * Bytes for the `img` sources in the tree. The PDF engine fetches nothing,
+     * so a remote `src` with no entry here draws blank; a `data:` URI needs none.
+     */
+    images?: ImagesInput;
+    /** Writes a document outline from the headings. */
+    outline?: boolean;
+    /** BCP 47 tag for the document's language. */
+    lang?: string;
+    /** Paper color painted under every page; unset leaves the page empty. */
+    backgroundColor?: string;
+}
+/** A laid-out element on the canvas, in pixels, with the elements nested in it. */
+export interface LayoutBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    /** How much the box's x axis is scaled on the canvas, e.g. by `transform: scale()`. */
+    scaleX: number;
+    /** How much the box's y axis is scaled on the canvas. */
+    scaleY: number;
+    /** Whichever of `scaleX` and `scaleY` is further from 1, so any value but 1 means the box is scaled. */
+    scale: number;
+    /** Text laid out in this box, each run positioned on the canvas. */
+    runs: {
+        text: string;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }[];
+    /**
+     * The element's attributes other than `class`, `id`, and `style`, such as
+     * `data-*`. Absent when it has none, or when its parent's laid-out children
+     * do not line up with its elements, as when inline content folds into runs.
+     */
+    attributes?: Record<string, string>;
+    children: LayoutBox[];
+}
+/**
+ * Rasterizes the `snapshot` surface's output.
+ *
+ * Both methods are one call over takumi: the tree is serialized, `fromHtml`
+ * turns it into a takumi node tree and lifts the stylesheet out, and takumi
+ * lays the result out at the input's viewport.
+ */
+export interface TakumiImageBackend {
+    /** Renders to an encoded PNG. */
+    png(input: ImageInput, options?: TakumiRenderOptions): Promise<Buffer>;
+    /** Renders to an SVG document. Vector output, so raster options do not apply. */
+    svg(input: ImageInput): Promise<string>;
+}
+/** Writes the `snapshot` surface's pages as a PDF, one page each. */
+export interface TakumiPdfBackend {
+    /**
+     * Renders one page per entry in `pages`, each the input's size with no
+     * margin, so a frame fills its page. Vector output with selectable text and
+     * the registered fonts subset and embedded. Throws on an empty `pages` list.
+     */
+    pdf(input: PdfInput, options?: TakumiPdfOptions): Promise<Buffer>;
+}
+/** A {@link TakumiImageBackend} that also measures layout. */
+export interface TakumiMeasuringBackend extends TakumiImageBackend {
+    /** Lays the input out as {@link TakumiImageBackend.png} would, and returns every box, e.g. to find content past its area. */
+    measure(input: ImageInput): Promise<LayoutBox>;
+}
+/** The formats a {@link TakumiBackend} writes, for `createIsomerRuntime({ formats })`. */
+export declare const TAKUMI_FORMATS: readonly ["png", "svg", "pdf"];
+/** Everything {@link createTakumiImageBackend} returns: raster, measure, and PDF. */
+export interface TakumiBackend extends TakumiMeasuringBackend, TakumiPdfBackend {
+    /** {@link TAKUMI_FORMATS}: one entry per method that writes a format. */
+    readonly formats: typeof TAKUMI_FORMATS;
+}
+/**
+ * Builds a {@link TakumiBackend} over one takumi renderer. `fonts` are
+ * registered once, in order, before the first render; the PDF engine is
+ * imported and created on the first `pdf`, and registers them again.
+ */
+export declare const createTakumiImageBackend: ({ fonts, cacheMaxBytes, }?: TakumiImageBackendOptions) => TakumiBackend;
+//# sourceMappingURL=backend.d.ts.map

package/dist/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"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"}

package/dist/backend.js

@@ -0,0 +1,170 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+import { Renderer, } from '@takumi-rs/core';
+import { fromHtml } from '@takumi-rs/helpers/html';
+/** The formats a {@link TakumiBackend} writes, for `createIsomerRuntime({ formats })`. */
+export const TAKUMI_FORMATS = ['png', 'svg', 'pdf'];
+/** The canvas rectangle `transform` maps a local `width` × `height` box at `x`, `y` to. */
+const mapRect = ([a, b, c, d, e, f], x, y, width, height) => {
+    const corners = [
+        [x, y],
+        [x + width, y],
+        [x, y + height],
+        [x + width, y + height],
+    ].map(([px = 0, py = 0]) => [a * px + c * py + e, b * px + d * py + f]);
+    const xs = corners.map(([cx = 0]) => cx);
+    const ys = corners.map(([, cy = 0]) => cy);
+    const left = Math.min(...xs);
+    const top = Math.min(...ys);
+    return {
+        x: left,
+        y: top,
+        width: Math.max(...xs) - left,
+        height: Math.max(...ys) - top,
+    };
+};
+/**
+ * Takumi reports each node's size in its own units with its full canvas
+ * transform, and carries no attributes, so those come from the `fromHtml`
+ * node at the same position.
+ */
+const toLayoutBox = ({ width, height, transform, runs, children }, source) => {
+    const [a, b, c, d] = transform;
+    const scaleX = Math.hypot(a, b);
+    const scaleY = Math.hypot(c, d);
+    const sources = source?.type === 'container' ? (source.children ?? []) : [];
+    const paired = sources.length === children.length;
+    return {
+        ...mapRect(transform, 0, 0, width, height),
+        scaleX,
+        scaleY,
+        scale: Math.abs(scaleY - 1) > Math.abs(scaleX - 1) ? scaleY : scaleX,
+        runs: runs.map((run) => ({
+            text: run.text,
+            ...mapRect(transform, run.x, run.y, run.width, run.height),
+        })),
+        ...(source?.attributes && { attributes: { ...source.attributes } }),
+        children: children.map((child, index) => toLayoutBox(child, paired ? sources[index] : undefined)),
+    };
+};
+const escapeStyleEndTags = (css) => css.replace(/<\/style/gi, (tag) => tag.replace('/', '\\/'));
+/**
+ * Inlines the stylesheet ahead of the markup, the form `fromHtml` lifts into
+ * its own `css` list. Passing the stylesheet as a separate `CssInput` entry is
+ * a different path through takumi and changes the committed PNG bytes.
+ */
+const withStylesheet = (css, markup) => `<style>${escapeStyleEndTags(css)}</style>${markup}`;
+const toTakumiSource = ({ html, css }) => fromHtml(withStylesheet(css, html));
+/**
+ * One side of a scaled canvas, in whole pixels. Takumi takes one ratio for
+ * both axes, so the ratio stays `scale` and the canvas absorbs the rounding.
+ */
+const toRasterSide = (side, scale) => scale === 1 ? side : Math.max(1, Math.round(side * scale));
+/** Inline, so no pack class name can collide with it. */
+const PAGE_STYLE = 'overflow:hidden;break-after:page;break-inside:avoid';
+/** Each page in a fixed-size block that ends the page, so a frame never spills onto the next. */
+const toPagedSource = ({ pages, css, width, height }) => {
+    if (pages.length === 0) {
+        throw new Error('pdf: no pages; a document needs at least one');
+    }
+    const markup = pages
+        .map(({ html }) => `<div style="width:${width}px;height:${height}px;${PAGE_STYLE}">${html}</div>`)
+        .join('');
+    return {
+        ...fromHtml(withStylesheet(css, `<div>${markup}</div>`)),
+        width,
+        height,
+    };
+};
+/** Runs `create` once for every caller. A rejection is forgotten, so the next call retries instead of inheriting it. */
+const once = (create) => {
+    let pending;
+    return () => {
+        pending ??= create().catch((error) => {
+            pending = undefined;
+            throw error;
+        });
+        return pending;
+    };
+};
+/**
+ * Builds a {@link TakumiBackend} over one takumi renderer. `fonts` are
+ * registered once, in order, before the first render; the PDF engine is
+ * imported and created on the first `pdf`, and registers them again.
+ */
+export const createTakumiImageBackend = ({ fonts = [], cacheMaxBytes, } = {}) => {
+    const renderer = new Renderer(cacheMaxBytes === undefined ? undefined : { cacheMaxBytes });
+    /**
+     * Registration is async and every render needs it, so each engine registers
+     * once and is awaited. Sequential because the registration order is the
+     * default fallback order.
+     */
+    const registerFonts = async (engine) => {
+        for (const font of fonts) {
+            await engine.registerFont(font);
+        }
+        return engine;
+    };
+    const ready = once(() => registerFonts(renderer));
+    /** A second engine, imported and created on the first PDF, so a raster-only host never loads its wasm. */
+    const pdfReady = once(async () => {
+        const { PdfRenderer } = await import('takumi-pdf');
+        return registerFonts(new PdfRenderer());
+    });
+    return {
+        formats: TAKUMI_FORMATS,
+        png: async (input, { scale = 1, devicePixelRatio } = {}) => {
+            if (!Number.isFinite(scale) || scale <= 0) {
+                throw new RangeError(`png: scale must be a positive finite number, got ${scale}`);
+            }
+            await ready();
+            const { node, css } = toTakumiSource(input);
+            const renderOptions = {
+                width: toRasterSide(input.width, scale),
+                height: toRasterSide(input.height, scale),
+                format: 'png',
+                css,
+            };
+            if (devicePixelRatio !== undefined || scale !== 1) {
+                renderOptions.devicePixelRatio = (devicePixelRatio ?? 1) * scale;
+            }
+            return renderer.render(node, renderOptions);
+        },
+        svg: async (input) => {
+            await ready();
+            const { node, css } = toTakumiSource(input);
+            return renderer.renderSvg(node, {
+                width: input.width,
+                height: input.height,
+                css,
+            });
+        },
+        measure: async (input) => {
+            await ready();
+            const { node, css } = toTakumiSource(input);
+            const measured = await renderer.measure(node, {
+                width: input.width,
+                height: input.height,
+                css,
+            });
+            return toLayoutBox(measured, node);
+        },
+        pdf: async (input, options = {}) => {
+            const engine = await pdfReady();
+            const { node, css, width, height } = toPagedSource(input);
+            const renderOptions = {
+                ...options,
+                size: { width, height },
+                margin: 0,
+                css,
+            };
+            // Copied out of wasm memory, which a later render can move.
+            return Buffer.from(await engine.render(node, renderOptions));
+        },
+    };
+};
+//# sourceMappingURL=backend.js.map

package/dist/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport {\n  type FontLoader,\n  type MeasuredNode,\n  Renderer,\n  type RenderOptions,\n} from '@takumi-rs/core';\nimport { fromHtml } from '@takumi-rs/helpers/html';\nimport type {\n  ImagesInput,\n  RenderOptions as PdfRenderOptions,\n} from 'takumi-pdf';\n\n/**\n * The part of a `snapshot` surface result this backend reads: the markup, the\n * stylesheet it is laid out against, and the viewport it was measured for.\n *\n * Declared structurally rather than imported from `@elastic/isomer-runtime`,\n * so this backend depends on no isomer package. `SnapshotRenderResult` satisfies it.\n */\nexport interface ImageInput {\n  /** Static markup with a single root, as image layout requires. */\n  html: string;\n  /** The stylesheet the markup is laid out against, `light-dark(…)` already resolved. */\n  css: string;\n  /** The viewport, in CSS pixels; the output is this size. */\n  width: number;\n  height: number;\n}\n\n/**\n * The part of a `snapshot` surface's `renderPages` result this backend reads:\n * one page's markup each, all laid out against one stylesheet at one size.\n * Structural like {@link ImageInput}; `SnapshotPagesResult` satisfies it.\n */\nexport interface PdfInput {\n  /** One page per entry, in order, each static markup with a single root. */\n  pages: readonly { html: string }[];\n  /** One stylesheet collected across every page. */\n  css: string;\n  /** Every page's size, in CSS pixels. */\n  width: number;\n  height: number;\n}\n\n/** Options for {@link createTakumiImageBackend}. */\nexport interface TakumiImageBackendOptions {\n  /**\n   * Fonts to register, in fallback order. A pack names families in its theme\n   * and this backend holds no opinion about which; nothing is registered by\n   * default, so an unregistered family falls back to takumi's built-in face.\n   *\n   * WOFF and WOFF2 are accepted as well as raw sfnt — `@takumi-rs/core` builds\n   * with takumi's `woff`/`woff2` features, so a `@fontsource/*` file can be\n   * passed as-is, as raw bytes or a lazy `data()`. A `FontLoader` string is a\n   * URL fetched on demand, not a filesystem path.\n   */\n  fonts?: readonly FontLoader[];\n  /** Byte budget for takumi's resource cache. `0` disables it. */\n  cacheMaxBytes?: number;\n}\n\n/** Per-render overrides. Geometry comes from the input, not from here. */\nexport interface TakumiRenderOptions {\n  /**\n   * Raster pixels per CSS pixel: the PNG is `input.width * scale` by\n   * `input.height * scale`, rounded. A layout fixed in CSS pixels is\n   * unchanged; rounding moves the viewport by under half a raster pixel. `2`\n   * gives a 2x raster. Defaults to `1`.\n   */\n  scale?: number;\n  /**\n   * Takumi's zoom at a fixed canvas: the tree is laid out at\n   * `input.width / devicePixelRatio` CSS pixels and magnified to fill the\n   * canvas, so above `1` the PNG keeps its size and shows less of the frame.\n   * For a larger raster, use {@link TakumiRenderOptions.scale}.\n   */\n  devicePixelRatio?: number;\n}\n\n/** Document properties written into a PDF. */\nexport interface TakumiPdfMetadata {\n  title?: string;\n  description?: string;\n  authors?: string[];\n  keywords?: string[];\n  creator?: string;\n  /** UTC, `YYYY-MM-DD` or `YYYY-MM-DDTHH:MM:SS`. Fixing it makes the bytes stable across renders. */\n  creationDate?: string;\n}\n\n/** Per-document options for {@link TakumiPdfBackend.pdf}. Geometry comes from the input. */\nexport interface TakumiPdfOptions {\n  metadata?: TakumiPdfMetadata;\n  /**\n   * What a glyph no registered font covers becomes. The default, `'error'`,\n   * rejects the render naming the code point, where `png` draws takumi's\n   * built-in face instead; `'placeholder'` draws the font's glyph 0 and\n   * `'blank'` draws nothing.\n   */\n  uncoveredText?: 'error' | 'placeholder' | 'blank';\n  /**\n   * Bytes for the `img` sources in the tree. The PDF engine fetches nothing,\n   * so a remote `src` with no entry here draws blank; a `data:` URI needs none.\n   */\n  images?: ImagesInput;\n  /** Writes a document outline from the headings. */\n  outline?: boolean;\n  /** BCP 47 tag for the document's language. */\n  lang?: string;\n  /** Paper color painted under every page; unset leaves the page empty. */\n  backgroundColor?: string;\n}\n\n/** A laid-out element on the canvas, in pixels, with the elements nested in it. */\nexport interface LayoutBox {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n  /** How much the box's x axis is scaled on the canvas, e.g. by `transform: scale()`. */\n  scaleX: number;\n  /** How much the box's y axis is scaled on the canvas. */\n  scaleY: number;\n  /** Whichever of `scaleX` and `scaleY` is further from 1, so any value but 1 means the box is scaled. */\n  scale: number;\n  /** Text laid out in this box, each run positioned on the canvas. */\n  runs: { text: string; x: number; y: number; width: number; height: number }[];\n  /**\n   * The element's attributes other than `class`, `id`, and `style`, such as\n   * `data-*`. Absent when it has none, or when its parent's laid-out children\n   * do not line up with its elements, as when inline content folds into runs.\n   */\n  attributes?: Record<string, string>;\n  children: LayoutBox[];\n}\n\n/**\n * Rasterizes the `snapshot` surface's output.\n *\n * Both methods are one call over takumi: the tree is serialized, `fromHtml`\n * turns it into a takumi node tree and lifts the stylesheet out, and takumi\n * lays the result out at the input's viewport.\n */\nexport interface TakumiImageBackend {\n  /** Renders to an encoded PNG. */\n  png(input: ImageInput, options?: TakumiRenderOptions): Promise<Buffer>;\n  /** Renders to an SVG document. Vector output, so raster options do not apply. */\n  svg(input: ImageInput): Promise<string>;\n}\n\n/** Writes the `snapshot` surface's pages as a PDF, one page each. */\nexport interface TakumiPdfBackend {\n  /**\n   * Renders one page per entry in `pages`, each the input's size with no\n   * margin, so a frame fills its page. Vector output with selectable text and\n   * the registered fonts subset and embedded. Throws on an empty `pages` list.\n   */\n  pdf(input: PdfInput, options?: TakumiPdfOptions): Promise<Buffer>;\n}\n\n/** A {@link TakumiImageBackend} that also measures layout. */\nexport interface TakumiMeasuringBackend extends TakumiImageBackend {\n  /** Lays the input out as {@link TakumiImageBackend.png} would, and returns every box, e.g. to find content past its area. */\n  measure(input: ImageInput): Promise<LayoutBox>;\n}\n\n/** The formats a {@link TakumiBackend} writes, for `createIsomerRuntime({ formats })`. */\nexport const TAKUMI_FORMATS = ['png', 'svg', 'pdf'] as const;\n\n/** Everything {@link createTakumiImageBackend} returns: raster, measure, and PDF. */\nexport interface TakumiBackend\n  extends TakumiMeasuringBackend, TakumiPdfBackend {\n  /** {@link TAKUMI_FORMATS}: one entry per method that writes a format. */\n  readonly formats: typeof TAKUMI_FORMATS;\n}\n\ntype Matrix = MeasuredNode['transform'];\n\ntype SourceNode = ReturnType<typeof fromHtml>['node'];\n\n/** The canvas rectangle `transform` maps a local `width` × `height` box at `x`, `y` to. */\nconst mapRect = (\n  [a, b, c, d, e, f]: Matrix,\n  x: number,\n  y: number,\n  width: number,\n  height: number\n): { x: number; y: number; width: number; height: number } => {\n  const corners = [\n    [x, y],\n    [x + width, y],\n    [x, y + height],\n    [x + width, y + height],\n  ].map(([px = 0, py = 0]) => [a * px + c * py + e, b * px + d * py + f]);\n  const xs = corners.map(([cx = 0]) => cx);\n  const ys = corners.map(([, cy = 0]) => cy);\n  const left = Math.min(...xs);\n  const top = Math.min(...ys);\n  return {\n    x: left,\n    y: top,\n    width: Math.max(...xs) - left,\n    height: Math.max(...ys) - top,\n  };\n};\n\n/**\n * Takumi reports each node's size in its own units with its full canvas\n * transform, and carries no attributes, so those come from the `fromHtml`\n * node at the same position.\n */\nconst toLayoutBox = (\n  { width, height, transform, runs, children }: MeasuredNode,\n  source: SourceNode | undefined\n): LayoutBox => {\n  const [a, b, c, d] = transform;\n  const scaleX = Math.hypot(a, b);\n  const scaleY = Math.hypot(c, d);\n  const sources = source?.type === 'container' ? (source.children ?? []) : [];\n  const paired = sources.length === children.length;\n  return {\n    ...mapRect(transform, 0, 0, width, height),\n    scaleX,\n    scaleY,\n    scale: Math.abs(scaleY - 1) > Math.abs(scaleX - 1) ? scaleY : scaleX,\n    runs: runs.map((run) => ({\n      text: run.text,\n      ...mapRect(transform, run.x, run.y, run.width, run.height),\n    })),\n    ...(source?.attributes && { attributes: { ...source.attributes } }),\n    children: children.map((child, index) =>\n      toLayoutBox(child, paired ? sources[index] : undefined)\n    ),\n  };\n};\n\nconst escapeStyleEndTags = (css: string) =>\n  css.replace(/<\\/style/gi, (tag) => tag.replace('/', '\\\\/'));\n\n/**\n * Inlines the stylesheet ahead of the markup, the form `fromHtml` lifts into\n * its own `css` list. Passing the stylesheet as a separate `CssInput` entry is\n * a different path through takumi and changes the committed PNG bytes.\n */\nconst withStylesheet = (css: string, markup: string) =>\n  `<style>${escapeStyleEndTags(css)}</style>${markup}`;\n\nconst toTakumiSource = ({ html, css }: ImageInput) =>\n  fromHtml(withStylesheet(css, html));\n\n/**\n * One side of a scaled canvas, in whole pixels. Takumi takes one ratio for\n * both axes, so the ratio stays `scale` and the canvas absorbs the rounding.\n */\nconst toRasterSide = (side: number, scale: number) =>\n  scale === 1 ? side : Math.max(1, Math.round(side * scale));\n\n/** Inline, so no pack class name can collide with it. */\nconst PAGE_STYLE = 'overflow:hidden;break-after:page;break-inside:avoid';\n\n/** Each page in a fixed-size block that ends the page, so a frame never spills onto the next. */\nconst toPagedSource = ({ pages, css, width, height }: PdfInput) => {\n  if (pages.length === 0) {\n    throw new Error('pdf: no pages; a document needs at least one');\n  }\n  const markup = pages\n    .map(\n      ({ html }) =>\n        `<div style=\"width:${width}px;height:${height}px;${PAGE_STYLE}\">${html}</div>`\n    )\n    .join('');\n  return {\n    ...fromHtml(withStylesheet(css, `<div>${markup}</div>`)),\n    width,\n    height,\n  };\n};\n\n/** Runs `create` once for every caller. A rejection is forgotten, so the next call retries instead of inheriting it. */\nconst once = <T>(create: () => Promise<T>): (() => Promise<T>) => {\n  let pending: Promise<T> | undefined;\n  return () => {\n    pending ??= create().catch((error: unknown) => {\n      pending = undefined;\n      throw error;\n    });\n    return pending;\n  };\n};\n\n/**\n * Builds a {@link TakumiBackend} over one takumi renderer. `fonts` are\n * registered once, in order, before the first render; the PDF engine is\n * imported and created on the first `pdf`, and registers them again.\n */\nexport const createTakumiImageBackend = ({\n  fonts = [],\n  cacheMaxBytes,\n}: TakumiImageBackendOptions = {}): TakumiBackend => {\n  const renderer = new Renderer(\n    cacheMaxBytes === undefined ? undefined : { cacheMaxBytes }\n  );\n\n  /**\n   * Registration is async and every render needs it, so each engine registers\n   * once and is awaited. Sequential because the registration order is the\n   * default fallback order.\n   */\n  const registerFonts = async <\n    TEngine extends { registerFont(font: FontLoader): Promise<unknown> },\n  >(\n    engine: TEngine\n  ): Promise<TEngine> => {\n    for (const font of fonts) {\n      await engine.registerFont(font);\n    }\n    return engine;\n  };\n  const ready = once(() => registerFonts(renderer));\n  /** A second engine, imported and created on the first PDF, so a raster-only host never loads its wasm. */\n  const pdfReady = once(async () => {\n    const { PdfRenderer } = await import('takumi-pdf');\n    return registerFonts(new PdfRenderer());\n  });\n\n  return {\n    formats: TAKUMI_FORMATS,\n    png: async (input, { scale = 1, devicePixelRatio } = {}) => {\n      if (!Number.isFinite(scale) || scale <= 0) {\n        throw new RangeError(\n          `png: scale must be a positive finite number, got ${scale}`\n        );\n      }\n      await ready();\n      const { node, css } = toTakumiSource(input);\n      const renderOptions: RenderOptions = {\n        width: toRasterSide(input.width, scale),\n        height: toRasterSide(input.height, scale),\n        format: 'png',\n        css,\n      };\n      if (devicePixelRatio !== undefined || scale !== 1) {\n        renderOptions.devicePixelRatio = (devicePixelRatio ?? 1) * scale;\n      }\n      return renderer.render(node, renderOptions);\n    },\n    svg: async (input) => {\n      await ready();\n      const { node, css } = toTakumiSource(input);\n      return renderer.renderSvg(node, {\n        width: input.width,\n        height: input.height,\n        css,\n      });\n    },\n    measure: async (input) => {\n      await ready();\n      const { node, css } = toTakumiSource(input);\n      const measured = await renderer.measure(node, {\n        width: input.width,\n        height: input.height,\n        css,\n      });\n      return toLayoutBox(measured, node);\n    },\n    pdf: async (input, options = {}) => {\n      const engine = await pdfReady();\n      const { node, css, width, height } = toPagedSource(input);\n      const renderOptions: PdfRenderOptions = {\n        ...options,\n        size: { width, height },\n        margin: 0,\n        css,\n      };\n      // Copied out of wasm memory, which a later render can move.\n      return Buffer.from(await engine.render(node, renderOptions));\n    },\n  };\n};\n"]}

package/dist/cjs/backend.js

@@ -0,0 +1,207 @@
+"use strict";
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTakumiImageBackend = exports.TAKUMI_FORMATS = void 0;
+const core_1 = require("@takumi-rs/core");
+const html_1 = require("@takumi-rs/helpers/html");
+/** The formats a {@link TakumiBackend} writes, for `createIsomerRuntime({ formats })`. */
+exports.TAKUMI_FORMATS = ['png', 'svg', 'pdf'];
+/** The canvas rectangle `transform` maps a local `width` × `height` box at `x`, `y` to. */
+const mapRect = ([a, b, c, d, e, f], x, y, width, height) => {
+    const corners = [
+        [x, y],
+        [x + width, y],
+        [x, y + height],
+        [x + width, y + height],
+    ].map(([px = 0, py = 0]) => [a * px + c * py + e, b * px + d * py + f]);
+    const xs = corners.map(([cx = 0]) => cx);
+    const ys = corners.map(([, cy = 0]) => cy);
+    const left = Math.min(...xs);
+    const top = Math.min(...ys);
+    return {
+        x: left,
+        y: top,
+        width: Math.max(...xs) - left,
+        height: Math.max(...ys) - top,
+    };
+};
+/**
+ * Takumi reports each node's size in its own units with its full canvas
+ * transform, and carries no attributes, so those come from the `fromHtml`
+ * node at the same position.
+ */
+const toLayoutBox = ({ width, height, transform, runs, children }, source) => {
+    const [a, b, c, d] = transform;
+    const scaleX = Math.hypot(a, b);
+    const scaleY = Math.hypot(c, d);
+    const sources = source?.type === 'container' ? (source.children ?? []) : [];
+    const paired = sources.length === children.length;
+    return {
+        ...mapRect(transform, 0, 0, width, height),
+        scaleX,
+        scaleY,
+        scale: Math.abs(scaleY - 1) > Math.abs(scaleX - 1) ? scaleY : scaleX,
+        runs: runs.map((run) => ({
+            text: run.text,
+            ...mapRect(transform, run.x, run.y, run.width, run.height),
+        })),
+        ...(source?.attributes && { attributes: { ...source.attributes } }),
+        children: children.map((child, index) => toLayoutBox(child, paired ? sources[index] : undefined)),
+    };
+};
+const escapeStyleEndTags = (css) => css.replace(/<\/style/gi, (tag) => tag.replace('/', '\\/'));
+/**
+ * Inlines the stylesheet ahead of the markup, the form `fromHtml` lifts into
+ * its own `css` list. Passing the stylesheet as a separate `CssInput` entry is
+ * a different path through takumi and changes the committed PNG bytes.
+ */
+const withStylesheet = (css, markup) => `<style>${escapeStyleEndTags(css)}</style>${markup}`;
+const toTakumiSource = ({ html, css }) => (0, html_1.fromHtml)(withStylesheet(css, html));
+/**
+ * One side of a scaled canvas, in whole pixels. Takumi takes one ratio for
+ * both axes, so the ratio stays `scale` and the canvas absorbs the rounding.
+ */
+const toRasterSide = (side, scale) => scale === 1 ? side : Math.max(1, Math.round(side * scale));
+/** Inline, so no pack class name can collide with it. */
+const PAGE_STYLE = 'overflow:hidden;break-after:page;break-inside:avoid';
+/** Each page in a fixed-size block that ends the page, so a frame never spills onto the next. */
+const toPagedSource = ({ pages, css, width, height }) => {
+    if (pages.length === 0) {
+        throw new Error('pdf: no pages; a document needs at least one');
+    }
+    const markup = pages
+        .map(({ html }) => `<div style="width:${width}px;height:${height}px;${PAGE_STYLE}">${html}</div>`)
+        .join('');
+    return {
+        ...(0, html_1.fromHtml)(withStylesheet(css, `<div>${markup}</div>`)),
+        width,
+        height,
+    };
+};
+/** Runs `create` once for every caller. A rejection is forgotten, so the next call retries instead of inheriting it. */
+const once = (create) => {
+    let pending;
+    return () => {
+        pending ??= create().catch((error) => {
+            pending = undefined;
+            throw error;
+        });
+        return pending;
+    };
+};
+/**
+ * Builds a {@link TakumiBackend} over one takumi renderer. `fonts` are
+ * registered once, in order, before the first render; the PDF engine is
+ * imported and created on the first `pdf`, and registers them again.
+ */
+const createTakumiImageBackend = ({ fonts = [], cacheMaxBytes, } = {}) => {
+    const renderer = new core_1.Renderer(cacheMaxBytes === undefined ? undefined : { cacheMaxBytes });
+    /**
+     * Registration is async and every render needs it, so each engine registers
+     * once and is awaited. Sequential because the registration order is the
+     * default fallback order.
+     */
+    const registerFonts = async (engine) => {
+        for (const font of fonts) {
+            await engine.registerFont(font);
+        }
+        return engine;
+    };
+    const ready = once(() => registerFonts(renderer));
+    /** A second engine, imported and created on the first PDF, so a raster-only host never loads its wasm. */
+    const pdfReady = once(async () => {
+        const { PdfRenderer } = await Promise.resolve().then(() => __importStar(require('takumi-pdf')));
+        return registerFonts(new PdfRenderer());
+    });
+    return {
+        formats: exports.TAKUMI_FORMATS,
+        png: async (input, { scale = 1, devicePixelRatio } = {}) => {
+            if (!Number.isFinite(scale) || scale <= 0) {
+                throw new RangeError(`png: scale must be a positive finite number, got ${scale}`);
+            }
+            await ready();
+            const { node, css } = toTakumiSource(input);
+            const renderOptions = {
+                width: toRasterSide(input.width, scale),
+                height: toRasterSide(input.height, scale),
+                format: 'png',
+                css,
+            };
+            if (devicePixelRatio !== undefined || scale !== 1) {
+                renderOptions.devicePixelRatio = (devicePixelRatio ?? 1) * scale;
+            }
+            return renderer.render(node, renderOptions);
+        },
+        svg: async (input) => {
+            await ready();
+            const { node, css } = toTakumiSource(input);
+            return renderer.renderSvg(node, {
+                width: input.width,
+                height: input.height,
+                css,
+            });
+        },
+        measure: async (input) => {
+            await ready();
+            const { node, css } = toTakumiSource(input);
+            const measured = await renderer.measure(node, {
+                width: input.width,
+                height: input.height,
+                css,
+            });
+            return toLayoutBox(measured, node);
+        },
+        pdf: async (input, options = {}) => {
+            const engine = await pdfReady();
+            const { node, css, width, height } = toPagedSource(input);
+            const renderOptions = {
+                ...options,
+                size: { width, height },
+                margin: 0,
+                css,
+            };
+            // Copied out of wasm memory, which a later render can move.
+            return Buffer.from(await engine.render(node, renderOptions));
+        },
+    };
+};
+exports.createTakumiImageBackend = createTakumiImageBackend;
+//# sourceMappingURL=backend.js.map

package/dist/cjs/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../src/backend.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport {\n  type FontLoader,\n  type MeasuredNode,\n  Renderer,\n  type RenderOptions,\n} from '@takumi-rs/core';\nimport { fromHtml } from '@takumi-rs/helpers/html';\nimport type {\n  ImagesInput,\n  RenderOptions as PdfRenderOptions,\n} from 'takumi-pdf';\n\n/**\n * The part of a `snapshot` surface result this backend reads: the markup, the\n * stylesheet it is laid out against, and the viewport it was measured for.\n *\n * Declared structurally rather than imported from `@elastic/isomer-runtime`,\n * so this backend depends on no isomer package. `SnapshotRenderResult` satisfies it.\n */\nexport interface ImageInput {\n  /** Static markup with a single root, as image layout requires. */\n  html: string;\n  /** The stylesheet the markup is laid out against, `light-dark(…)` already resolved. */\n  css: string;\n  /** The viewport, in CSS pixels; the output is this size. */\n  width: number;\n  height: number;\n}\n\n/**\n * The part of a `snapshot` surface's `renderPages` result this backend reads:\n * one page's markup each, all laid out against one stylesheet at one size.\n * Structural like {@link ImageInput}; `SnapshotPagesResult` satisfies it.\n */\nexport interface PdfInput {\n  /** One page per entry, in order, each static markup with a single root. */\n  pages: readonly { html: string }[];\n  /** One stylesheet collected across every page. */\n  css: string;\n  /** Every page's size, in CSS pixels. */\n  width: number;\n  height: number;\n}\n\n/** Options for {@link createTakumiImageBackend}. */\nexport interface TakumiImageBackendOptions {\n  /**\n   * Fonts to register, in fallback order. A pack names families in its theme\n   * and this backend holds no opinion about which; nothing is registered by\n   * default, so an unregistered family falls back to takumi's built-in face.\n   *\n   * WOFF and WOFF2 are accepted as well as raw sfnt — `@takumi-rs/core` builds\n   * with takumi's `woff`/`woff2` features, so a `@fontsource/*` file can be\n   * passed as-is, as raw bytes or a lazy `data()`. A `FontLoader` string is a\n   * URL fetched on demand, not a filesystem path.\n   */\n  fonts?: readonly FontLoader[];\n  /** Byte budget for takumi's resource cache. `0` disables it. */\n  cacheMaxBytes?: number;\n}\n\n/** Per-render overrides. Geometry comes from the input, not from here. */\nexport interface TakumiRenderOptions {\n  /**\n   * Raster pixels per CSS pixel: the PNG is `input.width * scale` by\n   * `input.height * scale`, rounded. A layout fixed in CSS pixels is\n   * unchanged; rounding moves the viewport by under half a raster pixel. `2`\n   * gives a 2x raster. Defaults to `1`.\n   */\n  scale?: number;\n  /**\n   * Takumi's zoom at a fixed canvas: the tree is laid out at\n   * `input.width / devicePixelRatio` CSS pixels and magnified to fill the\n   * canvas, so above `1` the PNG keeps its size and shows less of the frame.\n   * For a larger raster, use {@link TakumiRenderOptions.scale}.\n   */\n  devicePixelRatio?: number;\n}\n\n/** Document properties written into a PDF. */\nexport interface TakumiPdfMetadata {\n  title?: string;\n  description?: string;\n  authors?: string[];\n  keywords?: string[];\n  creator?: string;\n  /** UTC, `YYYY-MM-DD` or `YYYY-MM-DDTHH:MM:SS`. Fixing it makes the bytes stable across renders. */\n  creationDate?: string;\n}\n\n/** Per-document options for {@link TakumiPdfBackend.pdf}. Geometry comes from the input. */\nexport interface TakumiPdfOptions {\n  metadata?: TakumiPdfMetadata;\n  /**\n   * What a glyph no registered font covers becomes. The default, `'error'`,\n   * rejects the render naming the code point, where `png` draws takumi's\n   * built-in face instead; `'placeholder'` draws the font's glyph 0 and\n   * `'blank'` draws nothing.\n   */\n  uncoveredText?: 'error' | 'placeholder' | 'blank';\n  /**\n   * Bytes for the `img` sources in the tree. The PDF engine fetches nothing,\n   * so a remote `src` with no entry here draws blank; a `data:` URI needs none.\n   */\n  images?: ImagesInput;\n  /** Writes a document outline from the headings. */\n  outline?: boolean;\n  /** BCP 47 tag for the document's language. */\n  lang?: string;\n  /** Paper color painted under every page; unset leaves the page empty. */\n  backgroundColor?: string;\n}\n\n/** A laid-out element on the canvas, in pixels, with the elements nested in it. */\nexport interface LayoutBox {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n  /** How much the box's x axis is scaled on the canvas, e.g. by `transform: scale()`. */\n  scaleX: number;\n  /** How much the box's y axis is scaled on the canvas. */\n  scaleY: number;\n  /** Whichever of `scaleX` and `scaleY` is further from 1, so any value but 1 means the box is scaled. */\n  scale: number;\n  /** Text laid out in this box, each run positioned on the canvas. */\n  runs: { text: string; x: number; y: number; width: number; height: number }[];\n  /**\n   * The element's attributes other than `class`, `id`, and `style`, such as\n   * `data-*`. Absent when it has none, or when its parent's laid-out children\n   * do not line up with its elements, as when inline content folds into runs.\n   */\n  attributes?: Record<string, string>;\n  children: LayoutBox[];\n}\n\n/**\n * Rasterizes the `snapshot` surface's output.\n *\n * Both methods are one call over takumi: the tree is serialized, `fromHtml`\n * turns it into a takumi node tree and lifts the stylesheet out, and takumi\n * lays the result out at the input's viewport.\n */\nexport interface TakumiImageBackend {\n  /** Renders to an encoded PNG. */\n  png(input: ImageInput, options?: TakumiRenderOptions): Promise<Buffer>;\n  /** Renders to an SVG document. Vector output, so raster options do not apply. */\n  svg(input: ImageInput): Promise<string>;\n}\n\n/** Writes the `snapshot` surface's pages as a PDF, one page each. */\nexport interface TakumiPdfBackend {\n  /**\n   * Renders one page per entry in `pages`, each the input's size with no\n   * margin, so a frame fills its page. Vector output with selectable text and\n   * the registered fonts subset and embedded. Throws on an empty `pages` list.\n   */\n  pdf(input: PdfInput, options?: TakumiPdfOptions): Promise<Buffer>;\n}\n\n/** A {@link TakumiImageBackend} that also measures layout. */\nexport interface TakumiMeasuringBackend extends TakumiImageBackend {\n  /** Lays the input out as {@link TakumiImageBackend.png} would, and returns every box, e.g. to find content past its area. */\n  measure(input: ImageInput): Promise<LayoutBox>;\n}\n\n/** The formats a {@link TakumiBackend} writes, for `createIsomerRuntime({ formats })`. */\nexport const TAKUMI_FORMATS = ['png', 'svg', 'pdf'] as const;\n\n/** Everything {@link createTakumiImageBackend} returns: raster, measure, and PDF. */\nexport interface TakumiBackend\n  extends TakumiMeasuringBackend, TakumiPdfBackend {\n  /** {@link TAKUMI_FORMATS}: one entry per method that writes a format. */\n  readonly formats: typeof TAKUMI_FORMATS;\n}\n\ntype Matrix = MeasuredNode['transform'];\n\ntype SourceNode = ReturnType<typeof fromHtml>['node'];\n\n/** The canvas rectangle `transform` maps a local `width` × `height` box at `x`, `y` to. */\nconst mapRect = (\n  [a, b, c, d, e, f]: Matrix,\n  x: number,\n  y: number,\n  width: number,\n  height: number\n): { x: number; y: number; width: number; height: number } => {\n  const corners = [\n    [x, y],\n    [x + width, y],\n    [x, y + height],\n    [x + width, y + height],\n  ].map(([px = 0, py = 0]) => [a * px + c * py + e, b * px + d * py + f]);\n  const xs = corners.map(([cx = 0]) => cx);\n  const ys = corners.map(([, cy = 0]) => cy);\n  const left = Math.min(...xs);\n  const top = Math.min(...ys);\n  return {\n    x: left,\n    y: top,\n    width: Math.max(...xs) - left,\n    height: Math.max(...ys) - top,\n  };\n};\n\n/**\n * Takumi reports each node's size in its own units with its full canvas\n * transform, and carries no attributes, so those come from the `fromHtml`\n * node at the same position.\n */\nconst toLayoutBox = (\n  { width, height, transform, runs, children }: MeasuredNode,\n  source: SourceNode | undefined\n): LayoutBox => {\n  const [a, b, c, d] = transform;\n  const scaleX = Math.hypot(a, b);\n  const scaleY = Math.hypot(c, d);\n  const sources = source?.type === 'container' ? (source.children ?? []) : [];\n  const paired = sources.length === children.length;\n  return {\n    ...mapRect(transform, 0, 0, width, height),\n    scaleX,\n    scaleY,\n    scale: Math.abs(scaleY - 1) > Math.abs(scaleX - 1) ? scaleY : scaleX,\n    runs: runs.map((run) => ({\n      text: run.text,\n      ...mapRect(transform, run.x, run.y, run.width, run.height),\n    })),\n    ...(source?.attributes && { attributes: { ...source.attributes } }),\n    children: children.map((child, index) =>\n      toLayoutBox(child, paired ? sources[index] : undefined)\n    ),\n  };\n};\n\nconst escapeStyleEndTags = (css: string) =>\n  css.replace(/<\\/style/gi, (tag) => tag.replace('/', '\\\\/'));\n\n/**\n * Inlines the stylesheet ahead of the markup, the form `fromHtml` lifts into\n * its own `css` list. Passing the stylesheet as a separate `CssInput` entry is\n * a different path through takumi and changes the committed PNG bytes.\n */\nconst withStylesheet = (css: string, markup: string) =>\n  `<style>${escapeStyleEndTags(css)}</style>${markup}`;\n\nconst toTakumiSource = ({ html, css }: ImageInput) =>\n  fromHtml(withStylesheet(css, html));\n\n/**\n * One side of a scaled canvas, in whole pixels. Takumi takes one ratio for\n * both axes, so the ratio stays `scale` and the canvas absorbs the rounding.\n */\nconst toRasterSide = (side: number, scale: number) =>\n  scale === 1 ? side : Math.max(1, Math.round(side * scale));\n\n/** Inline, so no pack class name can collide with it. */\nconst PAGE_STYLE = 'overflow:hidden;break-after:page;break-inside:avoid';\n\n/** Each page in a fixed-size block that ends the page, so a frame never spills onto the next. */\nconst toPagedSource = ({ pages, css, width, height }: PdfInput) => {\n  if (pages.length === 0) {\n    throw new Error('pdf: no pages; a document needs at least one');\n  }\n  const markup = pages\n    .map(\n      ({ html }) =>\n        `<div style=\"width:${width}px;height:${height}px;${PAGE_STYLE}\">${html}</div>`\n    )\n    .join('');\n  return {\n    ...fromHtml(withStylesheet(css, `<div>${markup}</div>`)),\n    width,\n    height,\n  };\n};\n\n/** Runs `create` once for every caller. A rejection is forgotten, so the next call retries instead of inheriting it. */\nconst once = <T>(create: () => Promise<T>): (() => Promise<T>) => {\n  let pending: Promise<T> | undefined;\n  return () => {\n    pending ??= create().catch((error: unknown) => {\n      pending = undefined;\n      throw error;\n    });\n    return pending;\n  };\n};\n\n/**\n * Builds a {@link TakumiBackend} over one takumi renderer. `fonts` are\n * registered once, in order, before the first render; the PDF engine is\n * imported and created on the first `pdf`, and registers them again.\n */\nexport const createTakumiImageBackend = ({\n  fonts = [],\n  cacheMaxBytes,\n}: TakumiImageBackendOptions = {}): TakumiBackend => {\n  const renderer = new Renderer(\n    cacheMaxBytes === undefined ? undefined : { cacheMaxBytes }\n  );\n\n  /**\n   * Registration is async and every render needs it, so each engine registers\n   * once and is awaited. Sequential because the registration order is the\n   * default fallback order.\n   */\n  const registerFonts = async <\n    TEngine extends { registerFont(font: FontLoader): Promise<unknown> },\n  >(\n    engine: TEngine\n  ): Promise<TEngine> => {\n    for (const font of fonts) {\n      await engine.registerFont(font);\n    }\n    return engine;\n  };\n  const ready = once(() => registerFonts(renderer));\n  /** A second engine, imported and created on the first PDF, so a raster-only host never loads its wasm. */\n  const pdfReady = once(async () => {\n    const { PdfRenderer } = await import('takumi-pdf');\n    return registerFonts(new PdfRenderer());\n  });\n\n  return {\n    formats: TAKUMI_FORMATS,\n    png: async (input, { scale = 1, devicePixelRatio } = {}) => {\n      if (!Number.isFinite(scale) || scale <= 0) {\n        throw new RangeError(\n          `png: scale must be a positive finite number, got ${scale}`\n        );\n      }\n      await ready();\n      const { node, css } = toTakumiSource(input);\n      const renderOptions: RenderOptions = {\n        width: toRasterSide(input.width, scale),\n        height: toRasterSide(input.height, scale),\n        format: 'png',\n        css,\n      };\n      if (devicePixelRatio !== undefined || scale !== 1) {\n        renderOptions.devicePixelRatio = (devicePixelRatio ?? 1) * scale;\n      }\n      return renderer.render(node, renderOptions);\n    },\n    svg: async (input) => {\n      await ready();\n      const { node, css } = toTakumiSource(input);\n      return renderer.renderSvg(node, {\n        width: input.width,\n        height: input.height,\n        css,\n      });\n    },\n    measure: async (input) => {\n      await ready();\n      const { node, css } = toTakumiSource(input);\n      const measured = await renderer.measure(node, {\n        width: input.width,\n        height: input.height,\n        css,\n      });\n      return toLayoutBox(measured, node);\n    },\n    pdf: async (input, options = {}) => {\n      const engine = await pdfReady();\n      const { node, css, width, height } = toPagedSource(input);\n      const renderOptions: PdfRenderOptions = {\n        ...options,\n        size: { width, height },\n        margin: 0,\n        css,\n      };\n      // Copied out of wasm memory, which a later render can move.\n      return Buffer.from(await engine.render(node, renderOptions));\n    },\n  };\n};\n"]}