@elastic/isomer-image-takumi 0.0.0 → 0.2.0

package/dist/cjs/index.js

@@ -0,0 +1,17 @@
+"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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderPng = exports.renderPdf = exports.createTakumiImageBackend = exports.TAKUMI_FORMATS = void 0;
+var backend_1 = require("./backend");
+Object.defineProperty(exports, "TAKUMI_FORMATS", { enumerable: true, get: function () { return backend_1.TAKUMI_FORMATS; } });
+Object.defineProperty(exports, "createTakumiImageBackend", { enumerable: true, get: function () { return backend_1.createTakumiImageBackend; } });
+var render_pdf_1 = require("./render_pdf");
+Object.defineProperty(exports, "renderPdf", { enumerable: true, get: function () { return render_pdf_1.renderPdf; } });
+var render_png_1 = require("./render_png");
+Object.defineProperty(exports, "renderPng", { enumerable: true, get: function () { return render_png_1.renderPng; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,qCAcmB;AAFjB,yGAAA,cAAc,OAAA;AACd,mHAAA,wBAAwB,OAAA;AAE1B,2CAKsB;AADpB,uGAAA,SAAS,OAAA;AAEX,2CAQsB;AADpB,uGAAA,SAAS,OAAA","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\nexport {\n  type ImageInput,\n  type LayoutBox,\n  type PdfInput,\n  type TakumiBackend,\n  type TakumiImageBackend,\n  type TakumiImageBackendOptions,\n  type TakumiMeasuringBackend,\n  type TakumiPdfBackend,\n  type TakumiPdfMetadata,\n  type TakumiPdfOptions,\n  type TakumiRenderOptions,\n  TAKUMI_FORMATS,\n  createTakumiImageBackend,\n} from './backend';\nexport {\n  type PdfRuntime,\n  type RenderPdfOptions,\n  type RenderPdfResult,\n  renderPdf,\n} from './render_pdf';\nexport {\n  type PngCheckedValidationResult,\n  type PngRuntime,\n  type PngValidationResult,\n  type RenderPngOptions,\n  type RenderPngResult,\n  type SnapshotOptions,\n  renderPng,\n} from './render_png';\nexport type { Font, FontDetails, FontLoader } from '@takumi-rs/core';\nexport type { ImagesInput } from 'takumi-pdf';\n"]}

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/cjs/render_pdf.js

@@ -0,0 +1,38 @@
+"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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderPdf = void 0;
+const render_png_1 = require("./render_png");
+/**
+ * Validates, renders, and writes a deck as one PDF in one call, a page per
+ * composition.
+ *
+ * Every composition is rendered, even an invalid one: `validations` is how a
+ * caller finds out, rather than a thrown error. What is drawn is the copy
+ * validation checked. Validation runs twice, once here and once inside
+ * `renderPages`, which discards its own result. An empty deck throws the
+ * runtime's `EMPTY_PAGES`.
+ */
+const renderPdf = async (runtime, deck, backend, { snapshot, ...options } = {}) => {
+    const pages = deck.map((composition) => (0, render_png_1.checkedForDrawing)('renderPdf', runtime.validate(composition)));
+    const validations = pages.map(({ validation }) => validation);
+    const rendered = runtime.surfaces.snapshot.renderPages(pages.map(({ checked }) => checked), {
+        ...snapshot,
+        onValidationError: 'collect',
+    });
+    const pdf = await backend.pdf(rendered, options);
+    return {
+        pdf,
+        pageCount: rendered.pages.length,
+        width: rendered.width,
+        height: rendered.height,
+        validations,
+    };
+};
+exports.renderPdf = renderPdf;
+//# sourceMappingURL=render_pdf.js.map

package/dist/cjs/render_pdf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render_pdf.js","sourceRoot":"","sources":["../../src/render_pdf.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,6CAKsB;AAkCtB;;;;;;;;;GASG;AACI,MAAM,SAAS,GAAG,KAAK,EAC5B,OAAmB,EACnB,IAAwB,EACxB,OAAyB,EACzB,EAAE,QAAQ,EAAE,GAAG,OAAO,KAAuB,EAAE,EACrB,EAAE;IAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CACrC,IAAA,8BAAiB,EAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAC9D,CAAC;IACF,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CACpD,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,EACnC;QACE,GAAG,QAAQ;QACX,iBAAiB,EAAE,SAAS;KAC7B,CACF,CAAC;IACF,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACjD,OAAO;QACL,GAAG;QACH,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM;QAChC,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,WAAW;KACZ,CAAC;AACJ,CAAC,CAAC;AAzBW,QAAA,SAAS,aAyBpB","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 type { PdfInput, TakumiPdfBackend, TakumiPdfOptions } from './backend';\nimport {\n  checkedForDrawing,\n  type PngCheckedValidationResult,\n  type PngValidationResult,\n  type SnapshotOptions,\n} from './render_png';\n\n/**\n * The slice of `IsomerRuntime` this helper needs, declared structurally like\n * {@link PdfInput}. A runtime built with `frames` satisfies it.\n */\nexport interface PdfRuntime {\n  validate(composition: unknown): PngCheckedValidationResult;\n  surfaces: {\n    snapshot: {\n      renderPages(\n        compositions: readonly unknown[],\n        options?: SnapshotOptions & { onValidationError?: 'collect' | 'throw' }\n      ): PdfInput;\n    };\n  };\n}\n\n/** Options for {@link renderPdf}. */\nexport interface RenderPdfOptions extends TakumiPdfOptions {\n  /** Forwarded to `runtime.surfaces.snapshot.renderPages`, so every page shares one frame. */\n  snapshot?: SnapshotOptions;\n}\n\n/** What {@link renderPdf} resolves to: the bytes, the page count and size, and one finding set per composition. */\nexport interface RenderPdfResult {\n  pdf: Buffer;\n  pageCount: number;\n  width: number;\n  height: number;\n  /** One per composition, in order. */\n  validations: PngValidationResult[];\n}\n\n/**\n * Validates, renders, and writes a deck as one PDF in one call, a page per\n * composition.\n *\n * Every composition is rendered, even an invalid one: `validations` is how a\n * caller finds out, rather than a thrown error. What is drawn is the copy\n * validation checked. Validation runs twice, once here and once inside\n * `renderPages`, which discards its own result. An empty deck throws the\n * runtime's `EMPTY_PAGES`.\n */\nexport const renderPdf = async (\n  runtime: PdfRuntime,\n  deck: readonly unknown[],\n  backend: TakumiPdfBackend,\n  { snapshot, ...options }: RenderPdfOptions = {}\n): Promise<RenderPdfResult> => {\n  const pages = deck.map((composition) =>\n    checkedForDrawing('renderPdf', runtime.validate(composition))\n  );\n  const validations = pages.map(({ validation }) => validation);\n  const rendered = runtime.surfaces.snapshot.renderPages(\n    pages.map(({ checked }) => checked),\n    {\n      ...snapshot,\n      onValidationError: 'collect',\n    }\n  );\n  const pdf = await backend.pdf(rendered, options);\n  return {\n    pdf,\n    pageCount: rendered.pages.length,\n    width: rendered.width,\n    height: rendered.height,\n    validations,\n  };\n};\n"]}

package/dist/cjs/render_png.js

@@ -0,0 +1,50 @@
+"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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderPng = exports.checkedForDrawing = void 0;
+/**
+ * Splits a {@link PngCheckedValidationResult} into the copy to draw and the findings to report.
+ *
+ * Throws rather than draw the caller's value: shaped as the SDK's
+ * `CompositionValidationError` when the runtime refused the input, and a plain
+ * `Error` when the runtime returned no copy at all.
+ */
+const checkedForDrawing = (caller, { composition, ...validation }) => {
+    if (composition !== undefined) {
+        return { checked: composition, validation };
+    }
+    if (validation.valid) {
+        throw new Error(`${caller}: runtime.validate returned no checked composition to draw`);
+    }
+    throw Object.assign(new Error(`${caller}: the runtime refused the composition before parsing`), {
+        name: 'CompositionValidationError',
+        code: 'COMPOSITION_INVALID',
+        errors: validation.errors,
+    });
+};
+exports.checkedForDrawing = checkedForDrawing;
+/**
+ * Validates, renders, and rasterizes a composition in one call.
+ *
+ * The composition is rendered even when invalid: `validation` is how a caller
+ * finds out, rather than a thrown error. What is drawn is the copy validation
+ * checked, and input refused before parsing, which has none, throws
+ * `CompositionValidationError`. Validation runs twice, once here and once inside `render`, which
+ * discards its own result.
+ */
+const renderPng = async (runtime, composition, backend, { snapshot, ...options } = {}) => {
+    const { checked, validation } = (0, exports.checkedForDrawing)('renderPng', runtime.validate(composition));
+    const rendered = runtime.surfaces.snapshot.render(checked, {
+        ...snapshot,
+        onValidationError: 'collect',
+    });
+    const png = await backend.png(rendered, options);
+    return { png, width: rendered.width, height: rendered.height, validation };
+};
+exports.renderPng = renderPng;
+//# sourceMappingURL=render_png.js.map

package/dist/cjs/render_png.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render_png.js","sourceRoot":"","sources":["../../src/render_png.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAmBH;;;;;;GAMG;AACI,MAAM,iBAAiB,GAAG,CAC/B,MAAc,EACd,EAAE,WAAW,EAAE,GAAG,UAAU,EAA8B,EACH,EAAE;IACzD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;IAC9C,CAAC;IACD,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,GAAG,MAAM,4DAA4D,CACtE,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,CAAC,MAAM,CACjB,IAAI,KAAK,CAAC,GAAG,MAAM,sDAAsD,CAAC,EAC1E;QACE,IAAI,EAAE,4BAA4B;QAClC,IAAI,EAAE,qBAAqB;QAC3B,MAAM,EAAE,UAAU,CAAC,MAAM;KAC1B,CACF,CAAC;AACJ,CAAC,CAAC;AApBW,QAAA,iBAAiB,qBAoB5B;AAkDF;;;;;;;;GAQG;AACI,MAAM,SAAS,GAAG,KAAK,EAC5B,OAAmB,EACnB,WAAoB,EACpB,OAA2B,EAC3B,EAAE,QAAQ,EAAE,GAAG,OAAO,KAAuB,EAAE,EACrB,EAAE;IAC5B,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,IAAA,yBAAiB,EAC/C,WAAW,EACX,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAC9B,CAAC;IACF,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE;QACzD,GAAG,QAAQ;QACX,iBAAiB,EAAE,SAAS;KAC7B,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACjD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;AAC7E,CAAC,CAAC;AAhBW,QAAA,SAAS,aAgBpB","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 type {\n  ImageInput,\n  TakumiImageBackend,\n  TakumiRenderOptions,\n} from './backend';\n\n/** A validation result shaped like the SDK's `ValidationResult`, declared structurally. */\nexport interface PngValidationResult {\n  valid: boolean;\n  errors: readonly unknown[];\n}\n\n/** What `runtime.validate` returns: findings, and the copy they describe, `undefined` only for refused input. */\nexport type PngCheckedValidationResult = PngValidationResult & {\n  composition: unknown;\n};\n\n/**\n * Splits a {@link PngCheckedValidationResult} into the copy to draw and the findings to report.\n *\n * Throws rather than draw the caller's value: shaped as the SDK's\n * `CompositionValidationError` when the runtime refused the input, and a plain\n * `Error` when the runtime returned no copy at all.\n */\nexport const checkedForDrawing = (\n  caller: string,\n  { composition, ...validation }: PngCheckedValidationResult\n): { checked: unknown; validation: PngValidationResult } => {\n  if (composition !== undefined) {\n    return { checked: composition, validation };\n  }\n  if (validation.valid) {\n    throw new Error(\n      `${caller}: runtime.validate returned no checked composition to draw`\n    );\n  }\n  throw Object.assign(\n    new Error(`${caller}: the runtime refused the composition before parsing`),\n    {\n      name: 'CompositionValidationError',\n      code: 'COMPOSITION_INVALID',\n      errors: validation.errors,\n    }\n  );\n};\n\n/**\n * The `snapshot` surface's per-render options, mirroring the runtime's\n * `SnapshotRenderOptions` so a caller gets completion without importing it.\n */\nexport interface SnapshotOptions {\n  /** Which of the runtime's frames this render uses; defaults to its `defaultFrame`. */\n  frame?: string;\n  /** Overrides the frame's `defaultWidth`. */\n  width?: number;\n  /** Overrides the frame's estimated height. */\n  height?: number;\n  /** Theme mode; falls back to the composition's own `theme`. `auto` resolves light. */\n  theme?: 'light' | 'dark' | 'auto';\n}\n\n/**\n * The slice of `IsomerRuntime` this helper needs, declared structurally like\n * {@link ImageInput} so this package depends on no isomer package. `surfaces.snapshot`\n * is required where the runtime's generic form has `SnapshotSurface | undefined`; a\n * runtime built with `frames` carries `SnapshotSurface` there and satisfies this.\n */\nexport interface PngRuntime {\n  validate(composition: unknown): PngCheckedValidationResult;\n  surfaces: {\n    snapshot: {\n      render(\n        composition: unknown,\n        options?: SnapshotOptions & { onValidationError?: 'collect' | 'throw' }\n      ): ImageInput;\n    };\n  };\n}\n\n/** Options for {@link renderPng}. */\nexport interface RenderPngOptions extends TakumiRenderOptions {\n  /** Forwarded to `runtime.surfaces.snapshot.render`. */\n  snapshot?: SnapshotOptions;\n}\n\n/** What {@link renderPng} resolves to: the bytes, their size, and the findings on the composition drawn. */\nexport interface RenderPngResult {\n  png: Buffer;\n  /** The viewport, in CSS pixels; the raster is this times `scale`, rounded. */\n  width: number;\n  height: number;\n  validation: PngValidationResult;\n}\n\n/**\n * Validates, renders, and rasterizes a composition in one call.\n *\n * The composition is rendered even when invalid: `validation` is how a caller\n * finds out, rather than a thrown error. What is drawn is the copy validation\n * checked, and input refused before parsing, which has none, throws\n * `CompositionValidationError`. Validation runs twice, once here and once inside `render`, which\n * discards its own result.\n */\nexport const renderPng = async (\n  runtime: PngRuntime,\n  composition: unknown,\n  backend: TakumiImageBackend,\n  { snapshot, ...options }: RenderPngOptions = {}\n): Promise<RenderPngResult> => {\n  const { checked, validation } = checkedForDrawing(\n    'renderPng',\n    runtime.validate(composition)\n  );\n  const rendered = runtime.surfaces.snapshot.render(checked, {\n    ...snapshot,\n    onValidationError: 'collect',\n  });\n  const png = await backend.png(rendered, options);\n  return { png, width: rendered.width, height: rendered.height, validation };\n};\n"]}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { type ImageInput, type LayoutBox, type PdfInput, type TakumiBackend, type TakumiImageBackend, type TakumiImageBackendOptions, type TakumiMeasuringBackend, type TakumiPdfBackend, type TakumiPdfMetadata, type TakumiPdfOptions, type TakumiRenderOptions, TAKUMI_FORMATS, createTakumiImageBackend, } from './backend.js';
+export { type PdfRuntime, type RenderPdfOptions, type RenderPdfResult, renderPdf, } from './render_pdf.js';
+export { type PngCheckedValidationResult, type PngRuntime, type PngValidationResult, type RenderPngOptions, type RenderPngResult, type SnapshotOptions, renderPng, } from './render_png.js';
+export type { Font, FontDetails, FontLoader } from '@takumi-rs/core';
+export type { ImagesInput } from 'takumi-pdf';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,cAAc,EACd,wBAAwB,GACzB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,SAAS,GACV,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,SAAS,GACV,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACrE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/*
+ * 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.
+ */
+export { TAKUMI_FORMATS, createTakumiImageBackend, } from './backend.js';
+export { renderPdf, } from './render_pdf.js';
+export { renderPng, } from './render_png.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAYL,cAAc,EACd,wBAAwB,GACzB,MAAM,WAAW,CAAC;AACnB,OAAO,EAIL,SAAS,GACV,MAAM,cAAc,CAAC;AACtB,OAAO,EAOL,SAAS,GACV,MAAM,cAAc,CAAC","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\nexport {\n  type ImageInput,\n  type LayoutBox,\n  type PdfInput,\n  type TakumiBackend,\n  type TakumiImageBackend,\n  type TakumiImageBackendOptions,\n  type TakumiMeasuringBackend,\n  type TakumiPdfBackend,\n  type TakumiPdfMetadata,\n  type TakumiPdfOptions,\n  type TakumiRenderOptions,\n  TAKUMI_FORMATS,\n  createTakumiImageBackend,\n} from './backend';\nexport {\n  type PdfRuntime,\n  type RenderPdfOptions,\n  type RenderPdfResult,\n  renderPdf,\n} from './render_pdf';\nexport {\n  type PngCheckedValidationResult,\n  type PngRuntime,\n  type PngValidationResult,\n  type RenderPngOptions,\n  type RenderPngResult,\n  type SnapshotOptions,\n  renderPng,\n} from './render_png';\nexport type { Font, FontDetails, FontLoader } from '@takumi-rs/core';\nexport type { ImagesInput } from 'takumi-pdf';\n"]}

package/dist/render_pdf.d.ts

@@ -0,0 +1,42 @@
+import type { PdfInput, TakumiPdfBackend, TakumiPdfOptions } from './backend.js';
+import { type PngCheckedValidationResult, type PngValidationResult, type SnapshotOptions } from './render_png.js';
+/**
+ * The slice of `IsomerRuntime` this helper needs, declared structurally like
+ * {@link PdfInput}. A runtime built with `frames` satisfies it.
+ */
+export interface PdfRuntime {
+    validate(composition: unknown): PngCheckedValidationResult;
+    surfaces: {
+        snapshot: {
+            renderPages(compositions: readonly unknown[], options?: SnapshotOptions & {
+                onValidationError?: 'collect' | 'throw';
+            }): PdfInput;
+        };
+    };
+}
+/** Options for {@link renderPdf}. */
+export interface RenderPdfOptions extends TakumiPdfOptions {
+    /** Forwarded to `runtime.surfaces.snapshot.renderPages`, so every page shares one frame. */
+    snapshot?: SnapshotOptions;
+}
+/** What {@link renderPdf} resolves to: the bytes, the page count and size, and one finding set per composition. */
+export interface RenderPdfResult {
+    pdf: Buffer;
+    pageCount: number;
+    width: number;
+    height: number;
+    /** One per composition, in order. */
+    validations: PngValidationResult[];
+}
+/**
+ * Validates, renders, and writes a deck as one PDF in one call, a page per
+ * composition.
+ *
+ * Every composition is rendered, even an invalid one: `validations` is how a
+ * caller finds out, rather than a thrown error. What is drawn is the copy
+ * validation checked. Validation runs twice, once here and once inside
+ * `renderPages`, which discards its own result. An empty deck throws the
+ * runtime's `EMPTY_PAGES`.
+ */
+export declare const renderPdf: (runtime: PdfRuntime, deck: readonly unknown[], backend: TakumiPdfBackend, { snapshot, ...options }?: RenderPdfOptions) => Promise<RenderPdfResult>;
+//# sourceMappingURL=render_pdf.d.ts.map

package/dist/render_pdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render_pdf.d.ts","sourceRoot":"","sources":["../src/render_pdf.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC9E,OAAO,EAEL,KAAK,0BAA0B,EAC/B,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACrB,MAAM,cAAc,CAAC;AAEtB;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,WAAW,EAAE,OAAO,GAAG,0BAA0B,CAAC;IAC3D,QAAQ,EAAE;QACR,QAAQ,EAAE;YACR,WAAW,CACT,YAAY,EAAE,SAAS,OAAO,EAAE,EAChC,OAAO,CAAC,EAAE,eAAe,GAAG;gBAAE,iBAAiB,CAAC,EAAE,SAAS,GAAG,OAAO,CAAA;aAAE,GACtE,QAAQ,CAAC;SACb,CAAC;KACH,CAAC;CACH;AAED,qCAAqC;AACrC,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED,mHAAmH;AACnH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,WAAW,EAAE,mBAAmB,EAAE,CAAC;CACpC;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,GACpB,SAAS,UAAU,EACnB,MAAM,SAAS,OAAO,EAAE,EACxB,SAAS,gBAAgB,EACzB,2BAA0B,gBAAqB,KAC9C,OAAO,CAAC,eAAe,CAoBzB,CAAC"}

package/dist/render_pdf.js

@@ -0,0 +1,34 @@
+/*
+ * 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 { checkedForDrawing, } from './render_png.js';
+/**
+ * Validates, renders, and writes a deck as one PDF in one call, a page per
+ * composition.
+ *
+ * Every composition is rendered, even an invalid one: `validations` is how a
+ * caller finds out, rather than a thrown error. What is drawn is the copy
+ * validation checked. Validation runs twice, once here and once inside
+ * `renderPages`, which discards its own result. An empty deck throws the
+ * runtime's `EMPTY_PAGES`.
+ */
+export const renderPdf = async (runtime, deck, backend, { snapshot, ...options } = {}) => {
+    const pages = deck.map((composition) => checkedForDrawing('renderPdf', runtime.validate(composition)));
+    const validations = pages.map(({ validation }) => validation);
+    const rendered = runtime.surfaces.snapshot.renderPages(pages.map(({ checked }) => checked), {
+        ...snapshot,
+        onValidationError: 'collect',
+    });
+    const pdf = await backend.pdf(rendered, options);
+    return {
+        pdf,
+        pageCount: rendered.pages.length,
+        width: rendered.width,
+        height: rendered.height,
+        validations,
+    };
+};
+//# sourceMappingURL=render_pdf.js.map

package/dist/render_pdf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render_pdf.js","sourceRoot":"","sources":["../src/render_pdf.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,iBAAiB,GAIlB,MAAM,cAAc,CAAC;AAkCtB;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAC5B,OAAmB,EACnB,IAAwB,EACxB,OAAyB,EACzB,EAAE,QAAQ,EAAE,GAAG,OAAO,KAAuB,EAAE,EACrB,EAAE;IAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CACrC,iBAAiB,CAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAC9D,CAAC;IACF,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CACpD,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,EACnC;QACE,GAAG,QAAQ;QACX,iBAAiB,EAAE,SAAS;KAC7B,CACF,CAAC;IACF,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACjD,OAAO;QACL,GAAG;QACH,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM;QAChC,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,WAAW;KACZ,CAAC;AACJ,CAAC,CAAC","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 type { PdfInput, TakumiPdfBackend, TakumiPdfOptions } from './backend';\nimport {\n  checkedForDrawing,\n  type PngCheckedValidationResult,\n  type PngValidationResult,\n  type SnapshotOptions,\n} from './render_png';\n\n/**\n * The slice of `IsomerRuntime` this helper needs, declared structurally like\n * {@link PdfInput}. A runtime built with `frames` satisfies it.\n */\nexport interface PdfRuntime {\n  validate(composition: unknown): PngCheckedValidationResult;\n  surfaces: {\n    snapshot: {\n      renderPages(\n        compositions: readonly unknown[],\n        options?: SnapshotOptions & { onValidationError?: 'collect' | 'throw' }\n      ): PdfInput;\n    };\n  };\n}\n\n/** Options for {@link renderPdf}. */\nexport interface RenderPdfOptions extends TakumiPdfOptions {\n  /** Forwarded to `runtime.surfaces.snapshot.renderPages`, so every page shares one frame. */\n  snapshot?: SnapshotOptions;\n}\n\n/** What {@link renderPdf} resolves to: the bytes, the page count and size, and one finding set per composition. */\nexport interface RenderPdfResult {\n  pdf: Buffer;\n  pageCount: number;\n  width: number;\n  height: number;\n  /** One per composition, in order. */\n  validations: PngValidationResult[];\n}\n\n/**\n * Validates, renders, and writes a deck as one PDF in one call, a page per\n * composition.\n *\n * Every composition is rendered, even an invalid one: `validations` is how a\n * caller finds out, rather than a thrown error. What is drawn is the copy\n * validation checked. Validation runs twice, once here and once inside\n * `renderPages`, which discards its own result. An empty deck throws the\n * runtime's `EMPTY_PAGES`.\n */\nexport const renderPdf = async (\n  runtime: PdfRuntime,\n  deck: readonly unknown[],\n  backend: TakumiPdfBackend,\n  { snapshot, ...options }: RenderPdfOptions = {}\n): Promise<RenderPdfResult> => {\n  const pages = deck.map((composition) =>\n    checkedForDrawing('renderPdf', runtime.validate(composition))\n  );\n  const validations = pages.map(({ validation }) => validation);\n  const rendered = runtime.surfaces.snapshot.renderPages(\n    pages.map(({ checked }) => checked),\n    {\n      ...snapshot,\n      onValidationError: 'collect',\n    }\n  );\n  const pdf = await backend.pdf(rendered, options);\n  return {\n    pdf,\n    pageCount: rendered.pages.length,\n    width: rendered.width,\n    height: rendered.height,\n    validations,\n  };\n};\n"]}

package/dist/render_png.d.ts

@@ -0,0 +1,75 @@
+import type { ImageInput, TakumiImageBackend, TakumiRenderOptions } from './backend.js';
+/** A validation result shaped like the SDK's `ValidationResult`, declared structurally. */
+export interface PngValidationResult {
+    valid: boolean;
+    errors: readonly unknown[];
+}
+/** What `runtime.validate` returns: findings, and the copy they describe, `undefined` only for refused input. */
+export type PngCheckedValidationResult = PngValidationResult & {
+    composition: unknown;
+};
+/**
+ * Splits a {@link PngCheckedValidationResult} into the copy to draw and the findings to report.
+ *
+ * Throws rather than draw the caller's value: shaped as the SDK's
+ * `CompositionValidationError` when the runtime refused the input, and a plain
+ * `Error` when the runtime returned no copy at all.
+ */
+export declare const checkedForDrawing: (caller: string, { composition, ...validation }: PngCheckedValidationResult) => {
+    checked: unknown;
+    validation: PngValidationResult;
+};
+/**
+ * The `snapshot` surface's per-render options, mirroring the runtime's
+ * `SnapshotRenderOptions` so a caller gets completion without importing it.
+ */
+export interface SnapshotOptions {
+    /** Which of the runtime's frames this render uses; defaults to its `defaultFrame`. */
+    frame?: string;
+    /** Overrides the frame's `defaultWidth`. */
+    width?: number;
+    /** Overrides the frame's estimated height. */
+    height?: number;
+    /** Theme mode; falls back to the composition's own `theme`. `auto` resolves light. */
+    theme?: 'light' | 'dark' | 'auto';
+}
+/**
+ * The slice of `IsomerRuntime` this helper needs, declared structurally like
+ * {@link ImageInput} so this package depends on no isomer package. `surfaces.snapshot`
+ * is required where the runtime's generic form has `SnapshotSurface | undefined`; a
+ * runtime built with `frames` carries `SnapshotSurface` there and satisfies this.
+ */
+export interface PngRuntime {
+    validate(composition: unknown): PngCheckedValidationResult;
+    surfaces: {
+        snapshot: {
+            render(composition: unknown, options?: SnapshotOptions & {
+                onValidationError?: 'collect' | 'throw';
+            }): ImageInput;
+        };
+    };
+}
+/** Options for {@link renderPng}. */
+export interface RenderPngOptions extends TakumiRenderOptions {
+    /** Forwarded to `runtime.surfaces.snapshot.render`. */
+    snapshot?: SnapshotOptions;
+}
+/** What {@link renderPng} resolves to: the bytes, their size, and the findings on the composition drawn. */
+export interface RenderPngResult {
+    png: Buffer;
+    /** The viewport, in CSS pixels; the raster is this times `scale`, rounded. */
+    width: number;
+    height: number;
+    validation: PngValidationResult;
+}
+/**
+ * Validates, renders, and rasterizes a composition in one call.
+ *
+ * The composition is rendered even when invalid: `validation` is how a caller
+ * finds out, rather than a thrown error. What is drawn is the copy validation
+ * checked, and input refused before parsing, which has none, throws
+ * `CompositionValidationError`. Validation runs twice, once here and once inside `render`, which
+ * discards its own result.
+ */
+export declare const renderPng: (runtime: PngRuntime, composition: unknown, backend: TakumiImageBackend, { snapshot, ...options }?: RenderPngOptions) => Promise<RenderPngResult>;
+//# sourceMappingURL=render_png.d.ts.map

package/dist/render_png.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render_png.d.ts","sourceRoot":"","sources":["../src/render_png.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,WAAW,CAAC;AAEnB,2FAA2F;AAC3F,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;CAC5B;AAED,iHAAiH;AACjH,MAAM,MAAM,0BAA0B,GAAG,mBAAmB,GAAG;IAC7D,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,MAAM,EACd,gCAAgC,0BAA0B,KACzD;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,mBAAmB,CAAA;CAiBrD,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;CACnC;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,WAAW,EAAE,OAAO,GAAG,0BAA0B,CAAC;IAC3D,QAAQ,EAAE;QACR,QAAQ,EAAE;YACR,MAAM,CACJ,WAAW,EAAE,OAAO,EACpB,OAAO,CAAC,EAAE,eAAe,GAAG;gBAAE,iBAAiB,CAAC,EAAE,SAAS,GAAG,OAAO,CAAA;aAAE,GACtE,UAAU,CAAC;SACf,CAAC;KACH,CAAC;CACH;AAED,qCAAqC;AACrC,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D,uDAAuD;IACvD,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED,4GAA4G;AAC5G,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,mBAAmB,CAAC;CACjC;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,GACpB,SAAS,UAAU,EACnB,aAAa,OAAO,EACpB,SAAS,kBAAkB,EAC3B,2BAA0B,gBAAqB,KAC9C,OAAO,CAAC,eAAe,CAWzB,CAAC"}

package/dist/render_png.js

@@ -0,0 +1,45 @@
+/*
+ * 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.
+ */
+/**
+ * Splits a {@link PngCheckedValidationResult} into the copy to draw and the findings to report.
+ *
+ * Throws rather than draw the caller's value: shaped as the SDK's
+ * `CompositionValidationError` when the runtime refused the input, and a plain
+ * `Error` when the runtime returned no copy at all.
+ */
+export const checkedForDrawing = (caller, { composition, ...validation }) => {
+    if (composition !== undefined) {
+        return { checked: composition, validation };
+    }
+    if (validation.valid) {
+        throw new Error(`${caller}: runtime.validate returned no checked composition to draw`);
+    }
+    throw Object.assign(new Error(`${caller}: the runtime refused the composition before parsing`), {
+        name: 'CompositionValidationError',
+        code: 'COMPOSITION_INVALID',
+        errors: validation.errors,
+    });
+};
+/**
+ * Validates, renders, and rasterizes a composition in one call.
+ *
+ * The composition is rendered even when invalid: `validation` is how a caller
+ * finds out, rather than a thrown error. What is drawn is the copy validation
+ * checked, and input refused before parsing, which has none, throws
+ * `CompositionValidationError`. Validation runs twice, once here and once inside `render`, which
+ * discards its own result.
+ */
+export const renderPng = async (runtime, composition, backend, { snapshot, ...options } = {}) => {
+    const { checked, validation } = checkedForDrawing('renderPng', runtime.validate(composition));
+    const rendered = runtime.surfaces.snapshot.render(checked, {
+        ...snapshot,
+        onValidationError: 'collect',
+    });
+    const png = await backend.png(rendered, options);
+    return { png, width: rendered.width, height: rendered.height, validation };
+};
+//# sourceMappingURL=render_png.js.map

package/dist/render_png.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render_png.js","sourceRoot":"","sources":["../src/render_png.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmBH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,MAAc,EACd,EAAE,WAAW,EAAE,GAAG,UAAU,EAA8B,EACH,EAAE;IACzD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;IAC9C,CAAC;IACD,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,GAAG,MAAM,4DAA4D,CACtE,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,CAAC,MAAM,CACjB,IAAI,KAAK,CAAC,GAAG,MAAM,sDAAsD,CAAC,EAC1E;QACE,IAAI,EAAE,4BAA4B;QAClC,IAAI,EAAE,qBAAqB;QAC3B,MAAM,EAAE,UAAU,CAAC,MAAM;KAC1B,CACF,CAAC;AACJ,CAAC,CAAC;AAkDF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAC5B,OAAmB,EACnB,WAAoB,EACpB,OAA2B,EAC3B,EAAE,QAAQ,EAAE,GAAG,OAAO,KAAuB,EAAE,EACrB,EAAE;IAC5B,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,iBAAiB,CAC/C,WAAW,EACX,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAC9B,CAAC;IACF,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE;QACzD,GAAG,QAAQ;QACX,iBAAiB,EAAE,SAAS;KAC7B,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACjD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;AAC7E,CAAC,CAAC","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 type {\n  ImageInput,\n  TakumiImageBackend,\n  TakumiRenderOptions,\n} from './backend';\n\n/** A validation result shaped like the SDK's `ValidationResult`, declared structurally. */\nexport interface PngValidationResult {\n  valid: boolean;\n  errors: readonly unknown[];\n}\n\n/** What `runtime.validate` returns: findings, and the copy they describe, `undefined` only for refused input. */\nexport type PngCheckedValidationResult = PngValidationResult & {\n  composition: unknown;\n};\n\n/**\n * Splits a {@link PngCheckedValidationResult} into the copy to draw and the findings to report.\n *\n * Throws rather than draw the caller's value: shaped as the SDK's\n * `CompositionValidationError` when the runtime refused the input, and a plain\n * `Error` when the runtime returned no copy at all.\n */\nexport const checkedForDrawing = (\n  caller: string,\n  { composition, ...validation }: PngCheckedValidationResult\n): { checked: unknown; validation: PngValidationResult } => {\n  if (composition !== undefined) {\n    return { checked: composition, validation };\n  }\n  if (validation.valid) {\n    throw new Error(\n      `${caller}: runtime.validate returned no checked composition to draw`\n    );\n  }\n  throw Object.assign(\n    new Error(`${caller}: the runtime refused the composition before parsing`),\n    {\n      name: 'CompositionValidationError',\n      code: 'COMPOSITION_INVALID',\n      errors: validation.errors,\n    }\n  );\n};\n\n/**\n * The `snapshot` surface's per-render options, mirroring the runtime's\n * `SnapshotRenderOptions` so a caller gets completion without importing it.\n */\nexport interface SnapshotOptions {\n  /** Which of the runtime's frames this render uses; defaults to its `defaultFrame`. */\n  frame?: string;\n  /** Overrides the frame's `defaultWidth`. */\n  width?: number;\n  /** Overrides the frame's estimated height. */\n  height?: number;\n  /** Theme mode; falls back to the composition's own `theme`. `auto` resolves light. */\n  theme?: 'light' | 'dark' | 'auto';\n}\n\n/**\n * The slice of `IsomerRuntime` this helper needs, declared structurally like\n * {@link ImageInput} so this package depends on no isomer package. `surfaces.snapshot`\n * is required where the runtime's generic form has `SnapshotSurface | undefined`; a\n * runtime built with `frames` carries `SnapshotSurface` there and satisfies this.\n */\nexport interface PngRuntime {\n  validate(composition: unknown): PngCheckedValidationResult;\n  surfaces: {\n    snapshot: {\n      render(\n        composition: unknown,\n        options?: SnapshotOptions & { onValidationError?: 'collect' | 'throw' }\n      ): ImageInput;\n    };\n  };\n}\n\n/** Options for {@link renderPng}. */\nexport interface RenderPngOptions extends TakumiRenderOptions {\n  /** Forwarded to `runtime.surfaces.snapshot.render`. */\n  snapshot?: SnapshotOptions;\n}\n\n/** What {@link renderPng} resolves to: the bytes, their size, and the findings on the composition drawn. */\nexport interface RenderPngResult {\n  png: Buffer;\n  /** The viewport, in CSS pixels; the raster is this times `scale`, rounded. */\n  width: number;\n  height: number;\n  validation: PngValidationResult;\n}\n\n/**\n * Validates, renders, and rasterizes a composition in one call.\n *\n * The composition is rendered even when invalid: `validation` is how a caller\n * finds out, rather than a thrown error. What is drawn is the copy validation\n * checked, and input refused before parsing, which has none, throws\n * `CompositionValidationError`. Validation runs twice, once here and once inside `render`, which\n * discards its own result.\n */\nexport const renderPng = async (\n  runtime: PngRuntime,\n  composition: unknown,\n  backend: TakumiImageBackend,\n  { snapshot, ...options }: RenderPngOptions = {}\n): Promise<RenderPngResult> => {\n  const { checked, validation } = checkedForDrawing(\n    'renderPng',\n    runtime.validate(composition)\n  );\n  const rendered = runtime.surfaces.snapshot.render(checked, {\n    ...snapshot,\n    onValidationError: 'collect',\n  });\n  const png = await backend.png(rendered, options);\n  return { png, width: rendered.width, height: rendered.height, validation };\n};\n"]}

package/package.json

@@ -1,6 +1,45 @@
 {
-   "name": "@elastic/isomer-image-takumi",
-   "version": "0.0.0",
-   "description": "Placeholder to enable Trusted Publisher configuration.",
-   "repository": { "type": "git", "url": "https://github.com/elastic/isomer" }
-}
+  "name": "@elastic/isomer-image-takumi",
+  "version": "0.2.0",
+  "description": "Takumi image backend for Isomer: rasterizes the snapshot surface's output to PNG, SVG, or PDF.",
+  "license": "Elastic-2.0",
+  "author": "Elastic",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/elastic/isomer.git",
+    "directory": "packages/isomer-image-takumi"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/cjs/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "NOTICE.txt",
+    "THIRD_PARTY_LICENSES.md",
+    "LICENSE.txt"
+  ],
+  "dependencies": {
+    "@takumi-rs/core": "2.14.0",
+    "@takumi-rs/helpers": "2.14.0",
+    "takumi-pdf": "0.15.0"
+  },
+  "devDependencies": {
+    "@fontsource/inter": "^5.3.0",
+    "@types/react": "^18.2.14",
+    "@types/react-dom": "^18.2.6",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "scripts": {
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}