@office-kit/pptx-preview 0.6.2

package/README.md

@@ -0,0 +1,103 @@
+# @office-kit/pptx-preview
+
+Preview renderer for [`@office-kit/pptx`](https://github.com/office-kit/pptx).
+Turns a `@office-kit/pptx` slide model into an **SVG** (browser + Node) or rasterizes
+it to a **PNG / RGBA image in Node — with no headless browser**.
+
+> **Experimental (0.x).** This package lives in the `@office-kit/pptx` monorepo and
+> also powers the docs-site playground and the fidelity harness. The renderer
+> is an _approximation_ of PowerPoint / LibreOffice output and is still
+> evolving; the API may change between minor versions, and `0.x` semver applies
+> (a minor bump may break). See [fidelity](#fidelity) below.
+
+## Why
+
+`@office-kit/pptx` core does not render — by design. But "show me this deck" comes up
+constantly: a docs playground, a thumbnail service, a visual-diff test. The
+hard requirement is that rendering must work **in Node and rasterize to an
+image without spawning a browser**, so it fits CI and serverless. This package
+lays text out as pure SVG `<text>` (no `<foreignObject>`) and paints it with
+[resvg](https://github.com/yisibl/resvg-js), which has no browser dependency.
+
+## Entry points
+
+| Import                          | Runtime        | Use                                                 |
+| ------------------------------- | -------------- | --------------------------------------------------- |
+| `@office-kit/pptx-preview`      | browser + Node | `renderSlideToSvg` → an SVG string                  |
+| `@office-kit/pptx-preview/node` | Node only      | `renderSlideToImage` / `renderSlideToRgba` → pixels |
+
+The browser entry pulls in **no** Node built-ins (no `node:fs`, resvg, or
+fontkit), so it bundles cleanly for the web.
+
+## Usage
+
+### SVG (browser or Node)
+
+```ts
+import { renderSlideToSvg } from '@office-kit/pptx-preview';
+import { loadPresentation, getSlides } from '@office-kit/pptx';
+
+const pres = await loadPresentation(bytes);
+const svg = renderSlideToSvg(pres, getSlides(pres)[0]);
+// → '<svg …>…</svg>'  (text laid out via <foreignObject> — the browser wraps it)
+```
+
+### PNG / RGBA (Node, no browser)
+
+```ts
+import { renderSlideToImage, renderSlideToRgba } from '@office-kit/pptx-preview/node';
+import { loadPresentationFile, getSlides } from '@office-kit/pptx/node';
+
+const pres = await loadPresentationFile('deck.pptx');
+const slide = getSlides(pres)[0];
+
+// PNG-encoded bytes:
+const png = renderSlideToImage(pres, slide, { width: 1280 });
+
+// Raw RGBA pixels (+ the same frame PNG-encoded), for SSIM / diffing:
+const { image, png: png2 } = renderSlideToRgba(pres, slide, { width: 1280 });
+// image: { width, height, data: Uint8Array }  // row-major RGBA
+```
+
+The Node path lays text out as pure `<text>` and measures it with a fontkit
+measurer over **bundled** metric-compatible fonts (Carlito ≈ Calibri, Caladea ≈
+Cambria, Liberation ≈ Arial/Times/Courier; OFL / Apache-2.0, see
+`fonts/LICENSES.md`). The measurer, resvg's font set, and the SVG family names
+all reference the same fonts, so wrap/positioning math agrees with the painted
+glyphs and the result is deterministic (no system fonts).
+
+## Fidelity
+
+This is a high-fidelity preview, not a spec-complete PowerPoint renderer.
+Preset and custom geometry, solid/gradient/pattern/image fills (including the
+placeholder layout/master cascade), strokes, rotation, effects (shadow, glow,
+soft edge, reflection), images with adjustments, charts (column, bar, line,
+area, pie, doughnut, scatter, radar, bubble), tables with per-run cell text,
+vertical and multi-column text in both text-layout modes, picture bullets, and
+template (layout/master) decoration all render. SmartArt, animations, 3D, and
+EMF/WMF fall back to labelled placeholders carrying a machine-readable marker
+(below). Per-slide closeness to a LibreOffice baseline is measured and gated
+in CI by the fidelity harness in the monorepo (`site/fidelity`) — mean
+fg-SSIM ≈ 0.78 across the corpus, with the residual gaps documented there.
+
+### Fallback markers
+
+When a shape cannot be rendered (unsupported format, missing bytes, or
+unrecognised content type), the renderer emits a labelled placeholder rectangle.
+The placeholder's top-level `<g>` element carries a `data-pptx-fallback`
+attribute so automated tooling can detect partial renders without string-parsing
+the label text:
+
+| Value            | Trigger                                                     |
+| ---------------- | ----------------------------------------------------------- |
+| `"image"`        | Image bytes missing (external link) or format not decodable |
+| `"chart"`        | Chart kind not modelled by this renderer                    |
+| `"graphicFrame"` | Graphic frame with no recognised content (SmartArt, etc.)   |
+| `"custGeom"`     | Shape uses custom geometry (`<a:custGeom>`)                 |
+
+Example: `svg.querySelectorAll('[data-pptx-fallback]')` lists every shape that
+did not fully render.
+
+## License
+
+MIT (code). Bundled fonts: OFL-1.1 / Apache-2.0 — see `fonts/LICENSES.md`.

package/dist/index-BNnucizH.d.ts

@@ -0,0 +1,45 @@
+import { PresentationData, SlideData } from "@office-kit/pptx";
+
+//#region src/text-layout.d.ts
+/** What a measurer needs to size one run. Pixels at 96 DPI; the caller has
+ *  already applied EMU→px, pt→px and the autofit fontScale. `family` is the
+ *  resolved internal family name (see `substituteFamily`), not a CSS list. */
+interface FontSpec {
+  readonly family: string;
+  readonly sizePx: number;
+  readonly bold: boolean;
+  readonly italic: boolean;
+  readonly letterSpacingPx: number;
+}
+/** Advance width of `text` in px, plus optional vertical metrics. A real
+ *  measurer returns ascent/descent/lineGap so line height matches the font;
+ *  the heuristic returns width only and the engine falls back to a ratio. */
+interface MeasureResult {
+  readonly widthPx: number;
+  readonly ascentPx?: number;
+  readonly descentPx?: number;
+  readonly lineGapPx?: number;
+}
+type TextMeasurer = (text: string, spec: FontSpec) => MeasureResult;
+type TextLayoutMode = 'foreignObject' | 'svg';
+interface RenderSlideOptions {
+  /** Measurer used by the pure-SVG text path. Required when `textLayout` is
+   *  'svg'; ignored otherwise. */
+  readonly measureText?: TextMeasurer;
+  /** Which text path to use. Defaults to 'foreignObject' (the browser path)
+   *  so existing callers are unaffected; the harness opts into 'svg'. */
+  readonly textLayout?: TextLayoutMode;
+}
+declare const SANS = "Carlito";
+declare const SERIF = "Caladea";
+declare const ARIAL = "Liberation Sans";
+declare const TIMES = "Liberation Serif";
+declare const MONO = "Liberation Mono";
+declare const substituteFamily: (family: string | null | undefined) => string;
+declare const defaultMeasurer: TextMeasurer;
+//#endregion
+//#region src/render-slide.d.ts
+declare const renderSlideSvg: (pres: PresentationData, slide: SlideData, opts?: RenderSlideOptions) => string;
+//#endregion
+export { MeasureResult as a, SERIF as c, TextMeasurer as d, defaultMeasurer as f, MONO as i, TIMES as l, ARIAL as n, RenderSlideOptions as o, substituteFamily as p, FontSpec as r, SANS as s, renderSlideSvg as t, TextLayoutMode as u };
+//# sourceMappingURL=index-BNnucizH.d.ts.map

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import { a as MeasureResult, c as SERIF, d as TextMeasurer, f as defaultMeasurer, i as MONO, l as TIMES, n as ARIAL, o as RenderSlideOptions, p as substituteFamily, r as FontSpec, s as SANS, t as renderSlideSvg, u as TextLayoutMode } from "./index-BNnucizH.js";
+export { ARIAL, type FontSpec, MONO, type MeasureResult, type RenderSlideOptions, SANS, SERIF, TIMES, type TextLayoutMode, type TextMeasurer, defaultMeasurer, renderSlideSvg as renderSlideToSvg, substituteFamily };

package/dist/index.js

@@ -0,0 +1,2 @@
+import { a as SERIF, c as substituteFamily, i as SANS, n as ARIAL, o as TIMES, r as MONO, s as defaultMeasurer, t as renderSlideSvg } from "./src-CVYeIBFN.js";
+export { ARIAL, MONO, SANS, SERIF, TIMES, defaultMeasurer, renderSlideSvg as renderSlideToSvg, substituteFamily };

package/dist/node.d.ts

@@ -0,0 +1,44 @@
+import { a as MeasureResult, c as SERIF, d as TextMeasurer, f as defaultMeasurer, i as MONO, l as TIMES, n as ARIAL, o as RenderSlideOptions, p as substituteFamily, r as FontSpec, s as SANS, t as renderSlideSvg, u as TextLayoutMode } from "./index-BNnucizH.js";
+import { PresentationData, SlideData } from "@office-kit/pptx";
+
+//#region src/measure.d.ts
+declare const FONT_DIR: string;
+/** Absolute paths of every bundled face — passed to resvg's `fontFiles`. */
+declare const FONT_FILES: string[];
+declare const buildFontkitMeasurer: () => TextMeasurer;
+//#endregion
+//#region src/node.d.ts
+/** Raw, un-encoded raster: RGBA bytes in row-major order. */
+interface RgbaImage {
+  readonly width: number;
+  readonly height: number;
+  /** `width * height * 4` bytes, R,G,B,A per pixel. */
+  readonly data: Uint8Array;
+}
+interface RenderImageOptions {
+  /**
+   * Target raster width in pixels. Height follows the slide's aspect ratio.
+   * Defaults to 1280 (matches the fidelity harness baseline).
+   */
+  readonly width?: number;
+  /**
+   * Text measurer used for wrap/positioning. Defaults to a shared fontkit
+   * measurer over the bundled fonts. Pass {@link buildFontkitMeasurer}'s
+   * result to control its lifetime, or a custom measurer to swap fonts.
+   */
+  readonly measureText?: TextMeasurer;
+}
+/** Render one slide to PNG-encoded bytes. */
+declare const renderSlideToImage: (pres: PresentationData, slide: SlideData, opts?: RenderImageOptions) => Uint8Array;
+/**
+ * Render one slide to raw RGBA pixels plus the PNG encoding of the same frame.
+ * Both come from a single rasterization, so callers needing pixel access (SSIM,
+ * diffing) and a saveable file don't pay to render twice.
+ */
+declare const renderSlideToRgba: (pres: PresentationData, slide: SlideData, opts?: RenderImageOptions) => {
+  readonly image: RgbaImage;
+  readonly png: Uint8Array;
+};
+//#endregion
+export { ARIAL, FONT_DIR, FONT_FILES, type FontSpec, MONO, type MeasureResult, RenderImageOptions, type RenderSlideOptions, RgbaImage, SANS, SERIF, TIMES, type TextLayoutMode, type TextMeasurer, buildFontkitMeasurer, defaultMeasurer, renderSlideToImage, renderSlideToRgba, renderSlideSvg as renderSlideToSvg, substituteFamily };
+//# sourceMappingURL=node.d.ts.map

package/dist/node.js

@@ -0,0 +1,133 @@
+import { a as SERIF, c as substituteFamily, i as SANS, n as ARIAL, o as TIMES, r as MONO, s as defaultMeasurer, t as renderSlideSvg } from "./src-CVYeIBFN.js";
+import { getSlideSize } from "@office-kit/pptx";
+import { Resvg } from "@resvg/resvg-js";
+import * as fontkit from "fontkit";
+import { existsSync, readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+//#region src/measure.ts
+const FONT_DIR = fileURLToPath(new URL("../fonts/", import.meta.url));
+const FAMILY_TO_PREFIX = {
+	[SANS]: "Carlito",
+	[SERIF]: "Caladea",
+	[ARIAL]: "LiberationSans",
+	[TIMES]: "LiberationSerif",
+	[MONO]: "LiberationMono"
+};
+const STYLES = [
+	"Regular",
+	"Bold",
+	"Italic",
+	"BoldItalic"
+];
+const facePath = (prefix, style) => `${FONT_DIR}${prefix}-${style}.ttf`;
+/** Absolute paths of every bundled face — passed to resvg's `fontFiles`. */
+const FONT_FILES = Object.values(FAMILY_TO_PREFIX).flatMap((prefix) => STYLES.map((s) => facePath(prefix, s)));
+const openFont = (path) => {
+	const font = fontkit.create(readFileSync(path));
+	if (!("layout" in font)) throw new Error(`Expected a single font in ${path}, got a collection`);
+	return font;
+};
+const styleSuffix = (spec) => {
+	if (spec.bold && spec.italic) return "BoldItalic";
+	if (spec.bold) return "Bold";
+	if (spec.italic) return "Italic";
+	return "Regular";
+};
+const buildFontkitMeasurer = () => {
+	const cache = /* @__PURE__ */ new Map();
+	for (const [family, prefix] of Object.entries(FAMILY_TO_PREFIX)) for (const style of STYLES) {
+		const path = facePath(prefix, style);
+		if (!existsSync(path)) throw new Error(`Missing bundled font: ${path}`);
+		const font = openFont(path);
+		if (style === "Regular" && font.familyName !== family) throw new Error(`Font family mismatch: ${path} reports "${font.familyName}", expected "${family}". The substitution map and resvg matching rely on this name.`);
+		cache.set(`${prefix}-${style}`, font);
+	}
+	const pick = (spec) => {
+		const prefix = FAMILY_TO_PREFIX[spec.family] ?? "Carlito";
+		const style = styleSuffix(spec);
+		return cache.get(`${prefix}-${style}`) ?? cache.get(`${prefix}-Regular`) ?? cache.get("Carlito-Regular");
+	};
+	return (text, spec) => {
+		const font = pick(spec);
+		const scale = spec.sizePx / font.unitsPerEm;
+		const run = font.layout(text);
+		const glyphCount = [...text].length;
+		const tracking = glyphCount > 1 ? spec.letterSpacingPx * (glyphCount - 1) : 0;
+		const vm = verticalMetrics(font);
+		return {
+			widthPx: run.advanceWidth * scale + tracking,
+			ascentPx: vm.ascent * scale,
+			descentPx: vm.descent * scale,
+			lineGapPx: vm.lineGap * scale
+		};
+	};
+};
+const verticalMetrics = (font) => {
+	const os2 = font["OS/2"];
+	if (os2 && typeof os2 === "object") {
+		const o = os2;
+		if (o.fsSelection?.useTypoMetrics && o.typoAscender !== void 0) return {
+			ascent: o.typoAscender,
+			descent: Math.abs(o.typoDescender ?? 0),
+			lineGap: o.typoLineGap ?? 0
+		};
+		if (o.winAscent !== void 0 && o.winDescent !== void 0) return {
+			ascent: o.winAscent,
+			descent: Math.abs(o.winDescent),
+			lineGap: 0
+		};
+	}
+	return {
+		ascent: font.ascent,
+		descent: Math.abs(font.descent),
+		lineGap: font.lineGap
+	};
+};
+//#endregion
+//#region src/node.ts
+const DEFAULT_WIDTH = 1280;
+let sharedMeasurer;
+const getSharedMeasurer = () => sharedMeasurer ??= buildFontkitMeasurer();
+const rasterize = (pres, slide, opts) => {
+	getSlideSize(pres);
+	const width = opts.width ?? DEFAULT_WIDTH;
+	return new Resvg(renderSlideSvg(pres, slide, {
+		measureText: opts.measureText ?? getSharedMeasurer(),
+		textLayout: "svg"
+	}), {
+		fitTo: {
+			mode: "width",
+			value: width
+		},
+		font: {
+			loadSystemFonts: false,
+			fontFiles: FONT_FILES,
+			defaultFontFamily: SANS,
+			sansSerifFamily: SANS,
+			serifFamily: SERIF,
+			monospaceFamily: MONO
+		}
+	}).render();
+};
+/** Render one slide to PNG-encoded bytes. */
+const renderSlideToImage = (pres, slide, opts = {}) => new Uint8Array(rasterize(pres, slide, opts).asPng());
+/**
+* Render one slide to raw RGBA pixels plus the PNG encoding of the same frame.
+* Both come from a single rasterization, so callers needing pixel access (SSIM,
+* diffing) and a saveable file don't pay to render twice.
+*/
+const renderSlideToRgba = (pres, slide, opts = {}) => {
+	const rendered = rasterize(pres, slide, opts);
+	return {
+		image: {
+			width: rendered.width,
+			height: rendered.height,
+			data: new Uint8Array(rendered.pixels)
+		},
+		png: new Uint8Array(rendered.asPng())
+	};
+};
+//#endregion
+export { ARIAL, FONT_DIR, FONT_FILES, MONO, SANS, SERIF, TIMES, buildFontkitMeasurer, defaultMeasurer, renderSlideToImage, renderSlideToRgba, renderSlideSvg as renderSlideToSvg, substituteFamily };
+
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","names":[],"sources":["../src/measure.ts","../src/node.ts"],"sourcesContent":["// Node-only fontkit-backed TextMeasurer. NEVER imported by render-slide.ts /\n// text-layout.ts (which must stay browser-safe) — only by the node entry. It\n// measures advance widths and vertical metrics from the same bundled TTFs that\n// resvg rasterizes with (and that LibreOffice renders ground truth with), so\n// the engine's wrap/positioning math agrees with the painted pixels.\n\nimport * as fontkit from 'fontkit';\nimport { existsSync, readFileSync } from 'node:fs';\nimport { fileURLToPath } from 'node:url';\nimport {\n  ARIAL,\n  MONO,\n  SANS,\n  SERIF,\n  TIMES,\n  type FontSpec,\n  type TextMeasurer,\n} from './text-layout.ts';\n\nexport const FONT_DIR = fileURLToPath(new URL('../fonts/', import.meta.url));\n\n// Internal family name (what the emitter writes + resvg matches) → file prefix.\nconst FAMILY_TO_PREFIX: Record<string, string> = {\n  [SANS]: 'Carlito',\n  [SERIF]: 'Caladea',\n  [ARIAL]: 'LiberationSans',\n  [TIMES]: 'LiberationSerif',\n  [MONO]: 'LiberationMono',\n};\n\nconst STYLES = ['Regular', 'Bold', 'Italic', 'BoldItalic'] as const;\n\nconst facePath = (prefix: string, style: string): string => `${FONT_DIR}${prefix}-${style}.ttf`;\n\n/** Absolute paths of every bundled face — passed to resvg's `fontFiles`. */\nexport const FONT_FILES: string[] = Object.values(FAMILY_TO_PREFIX).flatMap((prefix) =>\n  STYLES.map((s) => facePath(prefix, s)),\n);\n\n// fontkit.create returns Font | FontCollection; our TTFs are single fonts.\nconst openFont = (path: string): fontkit.Font => {\n  const font = fontkit.create(readFileSync(path));\n  if (!('layout' in font)) {\n    throw new Error(`Expected a single font in ${path}, got a collection`);\n  }\n  return font;\n};\n\nconst styleSuffix = (spec: FontSpec): (typeof STYLES)[number] => {\n  if (spec.bold && spec.italic) return 'BoldItalic';\n  if (spec.bold) return 'Bold';\n  if (spec.italic) return 'Italic';\n  return 'Regular';\n};\n\nexport const buildFontkitMeasurer = (): TextMeasurer => {\n  const cache = new Map<string, fontkit.Font>();\n  // Load + verify every face up front. The familyName assertion guarantees the\n  // emit-side family === resvg match === the face we measure, which is the load-\n  // bearing invariant for \"x= is where glyphs land\".\n  for (const [family, prefix] of Object.entries(FAMILY_TO_PREFIX)) {\n    for (const style of STYLES) {\n      const path = facePath(prefix, style);\n      if (!existsSync(path)) throw new Error(`Missing bundled font: ${path}`);\n      const font = openFont(path);\n      if (style === 'Regular' && font.familyName !== family) {\n        throw new Error(\n          `Font family mismatch: ${path} reports \"${font.familyName}\", expected \"${family}\". ` +\n            `The substitution map and resvg matching rely on this name.`,\n        );\n      }\n      cache.set(`${prefix}-${style}`, font);\n    }\n  }\n\n  const pick = (spec: FontSpec): fontkit.Font => {\n    const prefix = FAMILY_TO_PREFIX[spec.family] ?? 'Carlito';\n    const style = styleSuffix(spec);\n    return (\n      cache.get(`${prefix}-${style}`) ??\n      cache.get(`${prefix}-Regular`) ??\n      cache.get('Carlito-Regular')!\n    );\n  };\n\n  return (text, spec) => {\n    const font = pick(spec);\n    const scale = spec.sizePx / font.unitsPerEm;\n    const run = font.layout(text); // applies the font's kerning / GPOS\n    const glyphCount = [...text].length;\n    const tracking = glyphCount > 1 ? spec.letterSpacingPx * (glyphCount - 1) : 0;\n    const vm = verticalMetrics(font);\n    return {\n      widthPx: run.advanceWidth * scale + tracking,\n      ascentPx: vm.ascent * scale,\n      descentPx: vm.descent * scale,\n      lineGapPx: vm.lineGap * scale,\n    };\n  };\n};\n\n// Which vertical-metric set a renderer uses depends on the OS/2 fsSelection\n// USE_TYPO_METRICS bit. When it's clear (the common case, incl. Carlito /\n// Liberation), GDI / LibreOffice place the baseline at usWinAscent and size the\n// line box as usWinAscent + usWinDescent (no extra gap). When set, they use the\n// sTypo* metrics plus typoLineGap. fontkit's `.ascent`/`.descent` expose the\n// hhea values, which for these fonts differ from usWinAscent by ~12px at 44pt —\n// exactly the baseline offset that otherwise mismatches ground truth. Returns\n// font-unit values; the caller scales to px.\ninterface VMetrics {\n  readonly ascent: number;\n  readonly descent: number;\n  readonly lineGap: number;\n}\nconst verticalMetrics = (font: fontkit.Font): VMetrics => {\n  const os2: unknown = (font as { 'OS/2'?: unknown })['OS/2'];\n  if (os2 && typeof os2 === 'object') {\n    const o = os2 as {\n      fsSelection?: { useTypoMetrics?: boolean };\n      typoAscender?: number;\n      typoDescender?: number;\n      typoLineGap?: number;\n      winAscent?: number;\n      winDescent?: number;\n    };\n    if (o.fsSelection?.useTypoMetrics && o.typoAscender !== undefined) {\n      return {\n        ascent: o.typoAscender,\n        descent: Math.abs(o.typoDescender ?? 0),\n        lineGap: o.typoLineGap ?? 0,\n      };\n    }\n    if (o.winAscent !== undefined && o.winDescent !== undefined) {\n      return { ascent: o.winAscent, descent: Math.abs(o.winDescent), lineGap: 0 };\n    }\n  }\n  // Fall back to hhea metrics if OS/2 is absent.\n  return { ascent: font.ascent, descent: Math.abs(font.descent), lineGap: font.lineGap };\n};\n","// `@office-kit/pptx-preview/node` — Node entry: rasterize a slide to a PNG or raw\n// RGBA image, with no browser binary.\n//\n// Pipeline: `renderSlideToSvg(..., { textLayout: 'svg', measureText })` lays\n// text out as pure `<text>`, then resvg paints the SVG to pixels. The fontkit\n// measurer, resvg's `fontFiles`, and the SVG's family names all reference the\n// SAME bundled fonts, so the wrap/positioning math agrees with the rasterized\n// glyphs.\n\nimport { Resvg } from '@resvg/resvg-js';\nimport { getSlideSize, type PresentationData, type SlideData } from '@office-kit/pptx';\nimport { renderSlideSvg } from './render-slide.ts';\nimport { MONO, SANS, SERIF, type TextMeasurer } from './text-layout.ts';\nimport { buildFontkitMeasurer, FONT_FILES } from './measure.ts';\n\n// Re-export the browser-safe surface so a Node consumer gets everything from\n// one import.\nexport * from './index.ts';\n\n// Advanced: pre-build / share a fontkit measurer, or locate the bundled fonts.\nexport { buildFontkitMeasurer, FONT_FILES, FONT_DIR } from './measure.ts';\n\n/** Raw, un-encoded raster: RGBA bytes in row-major order. */\nexport interface RgbaImage {\n  readonly width: number;\n  readonly height: number;\n  /** `width * height * 4` bytes, R,G,B,A per pixel. */\n  readonly data: Uint8Array;\n}\n\nexport interface RenderImageOptions {\n  /**\n   * Target raster width in pixels. Height follows the slide's aspect ratio.\n   * Defaults to 1280 (matches the fidelity harness baseline).\n   */\n  readonly width?: number;\n  /**\n   * Text measurer used for wrap/positioning. Defaults to a shared fontkit\n   * measurer over the bundled fonts. Pass {@link buildFontkitMeasurer}'s\n   * result to control its lifetime, or a custom measurer to swap fonts.\n   */\n  readonly measureText?: TextMeasurer;\n}\n\nconst DEFAULT_WIDTH = 1280;\n\n// The fontkit measurer reads + verifies every bundled face on construction.\n// Build it once and reuse across calls; do it lazily so importing this module\n// (e.g. just for the types) doesn't touch the filesystem.\nlet sharedMeasurer: TextMeasurer | undefined;\nconst getSharedMeasurer = (): TextMeasurer => (sharedMeasurer ??= buildFontkitMeasurer());\n\nconst rasterize = (pres: PresentationData, slide: SlideData, opts: RenderImageOptions) => {\n  // `getSlideSize` is only consulted to fail fast on a malformed deck; the SVG\n  // carries its own viewBox and resvg fits to the requested width.\n  getSlideSize(pres);\n  const width = opts.width ?? DEFAULT_WIDTH;\n  const measureText = opts.measureText ?? getSharedMeasurer();\n  const svg = renderSlideSvg(pres, slide, { measureText, textLayout: 'svg' });\n  const resvg = new Resvg(svg, {\n    fitTo: { mode: 'width', value: width },\n    font: {\n      loadSystemFonts: false, // deterministic: only the bundled fonts\n      fontFiles: FONT_FILES,\n      defaultFontFamily: SANS,\n      sansSerifFamily: SANS,\n      serifFamily: SERIF,\n      monospaceFamily: MONO,\n    },\n  });\n  return resvg.render();\n};\n\n/** Render one slide to PNG-encoded bytes. */\nexport const renderSlideToImage = (\n  pres: PresentationData,\n  slide: SlideData,\n  opts: RenderImageOptions = {},\n): Uint8Array => new Uint8Array(rasterize(pres, slide, opts).asPng());\n\n/**\n * Render one slide to raw RGBA pixels plus the PNG encoding of the same frame.\n * Both come from a single rasterization, so callers needing pixel access (SSIM,\n * diffing) and a saveable file don't pay to render twice.\n */\nexport const renderSlideToRgba = (\n  pres: PresentationData,\n  slide: SlideData,\n  opts: RenderImageOptions = {},\n): { readonly image: RgbaImage; readonly png: Uint8Array } => {\n  const rendered = rasterize(pres, slide, opts);\n  return {\n    image: {\n      width: rendered.width,\n      height: rendered.height,\n      data: new Uint8Array(rendered.pixels),\n    },\n    png: new Uint8Array(rendered.asPng()),\n  };\n};\n"],"mappings":";;;;;;;AAmBA,MAAa,WAAW,cAAc,IAAI,IAAI,aAAa,OAAO,KAAK,GAAG,CAAC;AAG3E,MAAM,mBAA2C;EAC9C,OAAO;EACP,QAAQ;EACR,QAAQ;EACR,QAAQ;EACR,OAAO;AACV;AAEA,MAAM,SAAS;CAAC;CAAW;CAAQ;CAAU;AAAY;AAEzD,MAAM,YAAY,QAAgB,UAA0B,GAAG,WAAW,OAAO,GAAG,MAAM;;AAG1F,MAAa,aAAuB,OAAO,OAAO,gBAAgB,CAAC,CAAC,SAAS,WAC3E,OAAO,KAAK,MAAM,SAAS,QAAQ,CAAC,CAAC,CACvC;AAGA,MAAM,YAAY,SAA+B;CAC/C,MAAM,OAAO,QAAQ,OAAO,aAAa,IAAI,CAAC;CAC9C,IAAI,EAAE,YAAY,OAChB,MAAM,IAAI,MAAM,6BAA6B,KAAK,mBAAmB;CAEvE,OAAO;AACT;AAEA,MAAM,eAAe,SAA4C;CAC/D,IAAI,KAAK,QAAQ,KAAK,QAAQ,OAAO;CACrC,IAAI,KAAK,MAAM,OAAO;CACtB,IAAI,KAAK,QAAQ,OAAO;CACxB,OAAO;AACT;AAEA,MAAa,6BAA2C;CACtD,MAAM,wBAAQ,IAAI,IAA0B;CAI5C,KAAK,MAAM,CAAC,QAAQ,WAAW,OAAO,QAAQ,gBAAgB,GAC5D,KAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,OAAO,SAAS,QAAQ,KAAK;EACnC,IAAI,CAAC,WAAW,IAAI,GAAG,MAAM,IAAI,MAAM,yBAAyB,MAAM;EACtE,MAAM,OAAO,SAAS,IAAI;EAC1B,IAAI,UAAU,aAAa,KAAK,eAAe,QAC7C,MAAM,IAAI,MACR,yBAAyB,KAAK,YAAY,KAAK,WAAW,eAAe,OAAO,8DAElF;EAEF,MAAM,IAAI,GAAG,OAAO,GAAG,SAAS,IAAI;CACtC;CAGF,MAAM,QAAQ,SAAiC;EAC7C,MAAM,SAAS,iBAAiB,KAAK,WAAW;EAChD,MAAM,QAAQ,YAAY,IAAI;EAC9B,OACE,MAAM,IAAI,GAAG,OAAO,GAAG,OAAO,KAC9B,MAAM,IAAI,GAAG,OAAO,SAAS,KAC7B,MAAM,IAAI,iBAAiB;CAE/B;CAEA,QAAQ,MAAM,SAAS;EACrB,MAAM,OAAO,KAAK,IAAI;EACtB,MAAM,QAAQ,KAAK,SAAS,KAAK;EACjC,MAAM,MAAM,KAAK,OAAO,IAAI;EAC5B,MAAM,aAAa,CAAC,GAAG,IAAI,CAAC,CAAC;EAC7B,MAAM,WAAW,aAAa,IAAI,KAAK,mBAAmB,aAAa,KAAK;EAC5E,MAAM,KAAK,gBAAgB,IAAI;EAC/B,OAAO;GACL,SAAS,IAAI,eAAe,QAAQ;GACpC,UAAU,GAAG,SAAS;GACtB,WAAW,GAAG,UAAU;GACxB,WAAW,GAAG,UAAU;EAC1B;CACF;AACF;AAeA,MAAM,mBAAmB,SAAiC;CACxD,MAAM,MAAgB,KAA8B;CACpD,IAAI,OAAO,OAAO,QAAQ,UAAU;EAClC,MAAM,IAAI;EAQV,IAAI,EAAE,aAAa,kBAAkB,EAAE,iBAAiB,KAAA,GACtD,OAAO;GACL,QAAQ,EAAE;GACV,SAAS,KAAK,IAAI,EAAE,iBAAiB,CAAC;GACtC,SAAS,EAAE,eAAe;EAC5B;EAEF,IAAI,EAAE,cAAc,KAAA,KAAa,EAAE,eAAe,KAAA,GAChD,OAAO;GAAE,QAAQ,EAAE;GAAW,SAAS,KAAK,IAAI,EAAE,UAAU;GAAG,SAAS;EAAE;CAE9E;CAEA,OAAO;EAAE,QAAQ,KAAK;EAAQ,SAAS,KAAK,IAAI,KAAK,OAAO;EAAG,SAAS,KAAK;CAAQ;AACvF;;;AC9FA,MAAM,gBAAgB;AAKtB,IAAI;AACJ,MAAM,0BAAyC,mBAAmB,qBAAqB;AAEvF,MAAM,aAAa,MAAwB,OAAkB,SAA6B;CAGxF,aAAa,IAAI;CACjB,MAAM,QAAQ,KAAK,SAAS;CAc5B,OAAO,IAXW,MADN,eAAe,MAAM,OAAO;EAAE,aADtB,KAAK,eAAe,kBAAkB;EACH,YAAY;CAAM,CAC/C,GAAG;EAC3B,OAAO;GAAE,MAAM;GAAS,OAAO;EAAM;EACrC,MAAM;GACJ,iBAAiB;GACjB,WAAW;GACX,mBAAmB;GACnB,iBAAiB;GACjB,aAAa;GACb,iBAAiB;EACnB;CACF,CACW,CAAC,CAAC,OAAO;AACtB;;AAGA,MAAa,sBACX,MACA,OACA,OAA2B,CAAC,MACb,IAAI,WAAW,UAAU,MAAM,OAAO,IAAI,CAAC,CAAC,MAAM,CAAC;;;;;;AAOpE,MAAa,qBACX,MACA,OACA,OAA2B,CAAC,MACgC;CAC5D,MAAM,WAAW,UAAU,MAAM,OAAO,IAAI;CAC5C,OAAO;EACL,OAAO;GACL,OAAO,SAAS;GAChB,QAAQ,SAAS;GACjB,MAAM,IAAI,WAAW,SAAS,MAAM;EACtC;EACA,KAAK,IAAI,WAAW,SAAS,MAAM,CAAC;CACtC;AACF"}