@office-kit/pptx-preview 0.6.2 → 0.8.0

package/README.md

@@ -66,6 +66,57 @@ Cambria, Liberation ≈ Arial/Times/Courier; OFL / Apache-2.0, see
 all reference the same fonts, so wrap/positioning math agrees with the painted
 glyphs and the result is deterministic (no system fonts).
 
+### Text-layout audit (overflow / soft-wrap detection)
+
+```ts
+import { auditTextLayout } from '@office-kit/pptx-preview';
+import { buildFontkitMeasurer } from '@office-kit/pptx-preview/node';
+
+// Register the fonts the deck actually uses (especially CJK) for accurate widths.
+const measureText = buildFontkitMeasurer({
+  fonts: [{ family: '游ゴシック', source: 'fonts/YuGothic.ttf' }],
+});
+
+const issues = auditTextLayout(pres, { measureText, reportSoftWraps: true });
+// → [{ kind: 'overflow-y', slideIndex: 2, shapeName: 'Title 1', overflowPx: 14.3, approximate: false }, …]
+```
+
+`auditTextLayout` measures every shape's text body — placeholders, text boxes,
+autoshapes, shapes inside groups — with the same engine the preview renders
+with, honouring the effective bodyPr cascade (insets, wrap, anchor, vertical
+text, columns) and `normAutofit` shrinking. It returns one issue per finding:
+
+| `kind`       | Meaning                                                                       | Extra fields                   |
+| ------------ | ----------------------------------------------------------------------------- | ------------------------------ |
+| `overflow-x` | Text ink escapes the box horizontally (typically `wrap="none"`)               | `overflowPx`                   |
+| `overflow-y` | Wrapped text is taller than the box (or escapes the top when bottom-anchored) | `overflowPx`                   |
+| `soft-wrap`  | A paragraph wrapped onto more lines than its authored `<a:br>` count (段落ち) | `paragraphIndex`, `extraLines` |
+
+Every issue also carries `slideIndex`, `shapeName`, and `approximate` —
+`true` when a width had to be estimated (the heuristic measurer, or glyphs the
+available fonts don't cover), in which case treat borderline verdicts as
+advisory.
+
+Options:
+
+- `measureText` — the measurer. Defaults to the browser-safe heuristic
+  (≈0.55 em per Latin glyph, 1 em per CJK glyph, always `approximate`); pass
+  `buildFontkitMeasurer()` in Node for real glyph metrics.
+- `tolerancePx` — overflow at or below this many px (96 DPI) is ignored.
+  Default `1`; raise it if you only care about visibly broken slides.
+- `reportSoftWraps` — opt into `soft-wrap` issues. Off by default because
+  wrapping is normal for body text; turn it on when auditing titles or labels
+  meant to stay on one line.
+
+Accuracy: the bundled fonts are metric-compatible with the Office defaults, so
+verdicts for Calibri / Cambria / Arial / Times / Courier decks match real glyph
+widths; for any other font (custom brand fonts, Japanese fonts), register the
+real files via `buildFontkitMeasurer({ fonts })` — a registered font is used
+both for runs that name it and as a glyph fallback for CJK text in runs that
+resolve to a Latin face. Line-break positions can differ from PowerPoint by a
+few characters in edge cases (kinsoku, hyphenation), which is what the default
+1 px tolerance absorbs. Table cell text is not audited yet.
+
 ## Fidelity
 
 This is a high-fidelity preview, not a spec-complete PowerPoint renderer.

package/dist/index-B6ISDjnu.d.ts

@@ -0,0 +1,93 @@
+import { PresentationData, SlideData, getParagraphBullet, getParagraphBulletStyle, getParagraphIndent, getShapeBodyPrEffective, getShapeTextAutoFitParams, getShapeTextDirection } 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;
+  /** True when the width is an estimate rather than a glyph measurement —
+   *  the heuristic measurer always, the fontkit measurer when the resolved
+   *  font lacks a glyph and per-character ratios filled the gap. The audit
+   *  API surfaces this so borderline verdicts can be treated as advisory. */
+  readonly approximate?: boolean;
+}
+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
+//#region src/audit.d.ts
+interface IssueBase {
+  /** 0-based deck position of the slide the shape sits on. */
+  readonly slideIndex: number;
+  readonly shapeName: string | null;
+  /** True when any run was measured by estimate rather than real glyph
+   *  metrics (heuristic measurer, or a font without the needed glyphs).
+   *  Treat borderline overflows as advisory when set. */
+  readonly approximate: boolean;
+}
+type TextAuditIssue = (IssueBase & {
+  readonly kind: 'overflow-x' | 'overflow-y'; /** How far the text ink escapes the box, in px at 96 DPI. */
+  readonly overflowPx: number;
+}) | (IssueBase & {
+  readonly kind: 'soft-wrap';
+  readonly paragraphIndex: number;
+  /** Lines beyond the paragraph's authored line count (1 + explicit
+   *  breaks) — i.e. how many times the text wrapped on its own. */
+  readonly extraLines: number;
+});
+interface AuditTextLayoutOptions {
+  /** Measurer for run widths / vertical metrics. Defaults to the heuristic
+   *  measurer (browser-safe, approximate); pass the fontkit measurer from
+   *  `@office-kit/pptx-preview/node` for real glyph metrics. */
+  readonly measureText?: TextMeasurer;
+  /** Overflow at or below this many px (96 DPI) is ignored. Default 1 —
+   *  measurement and PowerPoint disagree by sub-pixel amounts routinely. */
+  readonly tolerancePx?: number;
+  /** Also report paragraphs that wrap onto more lines than their explicit
+   *  breaks author (段落ち). Off by default: wrapping is normal for body
+   *  text, so this is opt-in for single-line-intent content like titles. */
+  readonly reportSoftWraps?: boolean;
+}
+/**
+ * Measures every text body in the deck and reports text that escapes its box
+ * (`overflow-x` / `overflow-y`) and, opt-in, paragraphs that soft-wrap
+ * (`soft-wrap`, 段落ち).
+ *
+ * Table cell text is not audited (v1 covers shape text bodies, including
+ * placeholders and shapes inside groups).
+ */
+declare const auditTextLayout: (pres: PresentationData, options?: AuditTextLayoutOptions) => ReadonlyArray<TextAuditIssue>;
+//#endregion
+export { ARIAL as a, MeasureResult as c, SERIF as d, TIMES as f, substituteFamily as g, defaultMeasurer as h, renderSlideSvg as i, RenderSlideOptions as l, TextMeasurer as m, TextAuditIssue as n, FontSpec as o, TextLayoutMode as p, auditTextLayout as r, MONO as s, AuditTextLayoutOptions as t, SANS as u };
+//# sourceMappingURL=index-B6ISDjnu.d.ts.map

package/dist/index.d.ts

@@ -1,2 +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 };
+import { a as ARIAL, c as MeasureResult, d as SERIF, f as TIMES, g as substituteFamily, h as defaultMeasurer, i as renderSlideSvg, l as RenderSlideOptions, m as TextMeasurer, n as TextAuditIssue, o as FontSpec, p as TextLayoutMode, r as auditTextLayout, s as MONO, t as AuditTextLayoutOptions, u as SANS } from "./index-B6ISDjnu.js";
+export { ARIAL, type AuditTextLayoutOptions, type FontSpec, MONO, type MeasureResult, type RenderSlideOptions, SANS, SERIF, TIMES, type TextAuditIssue, type TextLayoutMode, type TextMeasurer, auditTextLayout, defaultMeasurer, renderSlideSvg as renderSlideToSvg, substituteFamily };

package/dist/index.js

@@ -1,2 +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 };
+import { a as MONO, c as TIMES, d as substituteFamily, l as defaultMeasurer, n as renderSlideSvg, o as SANS, r as ARIAL, s as SERIF, t as auditTextLayout } from "./src-D95l1T9U.js";
+export { ARIAL, MONO, SANS, SERIF, TIMES, auditTextLayout, defaultMeasurer, renderSlideSvg as renderSlideToSvg, substituteFamily };

package/dist/node.d.ts

@@ -1,11 +1,28 @@
-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 { a as ARIAL, c as MeasureResult, d as SERIF, f as TIMES, g as substituteFamily, h as defaultMeasurer, i as renderSlideSvg, l as RenderSlideOptions, m as TextMeasurer, n as TextAuditIssue, o as FontSpec, p as TextLayoutMode, r as auditTextLayout, s as MONO, t as AuditTextLayoutOptions, u as SANS } from "./index-B6ISDjnu.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;
+/** A font the caller supplies for measurement, keyed by the AUTHORED family
+ *  name (`<a:latin typeface>` / `<a:ea typeface>` — e.g. "游ゴシック",
+ *  "Montserrat"), which routinely differs from the file's internal name. */
+interface RegisteredFont {
+  readonly family: string;
+  /** Path to a ttf/otf file, or its bytes. */
+  readonly source: string | Uint8Array;
+  readonly bold?: boolean;
+  readonly italic?: boolean;
+}
+interface FontkitMeasurerOptions {
+  /** Fonts the deck actually uses. A run whose family matches a registered
+   *  font measures with it; any registered font also serves as a fallback
+   *  for glyphs the resolved font lacks (the bundled faces are Latin-only,
+   *  so this is how CJK text gets real metrics). */
+  readonly fonts?: ReadonlyArray<RegisteredFont>;
+}
+declare const buildFontkitMeasurer: (options?: FontkitMeasurerOptions) => TextMeasurer;
 //#endregion
 //#region src/node.d.ts
 /** Raw, un-encoded raster: RGBA bytes in row-major order. */
@@ -27,6 +44,22 @@ interface RenderImageOptions {
    * result to control its lifetime, or a custom measurer to swap fonts.
    */
   readonly measureText?: TextMeasurer;
+  /**
+   * Extra font files (ttf / otf / ttc paths) loaded into the rasterizer in
+   * addition to the bundled Latin faces. The bundled set has no CJK
+   * coverage, so decks with Japanese / Chinese / Korean text render as
+   * missing-glyph boxes unless the caller supplies a face here (pair it with
+   * a {@link buildFontkitMeasurer} `fonts` registration so wrap math uses the
+   * same metrics).
+   */
+  readonly fontFiles?: ReadonlyArray<string>;
+  /**
+   * Also let the rasterizer discover OS-installed fonts as a fallback for
+   * families the bundled + `fontFiles` faces don't cover. Defaults to
+   * `false`: system fonts vary per machine, so the default keeps output
+   * deterministic.
+   */
+  readonly loadSystemFonts?: boolean;
 }
 /** Render one slide to PNG-encoded bytes. */
 declare const renderSlideToImage: (pres: PresentationData, slide: SlideData, opts?: RenderImageOptions) => Uint8Array;
@@ -40,5 +73,5 @@ declare const renderSlideToRgba: (pres: PresentationData, slide: SlideData, opts
   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 };
+export { ARIAL, type AuditTextLayoutOptions, FONT_DIR, FONT_FILES, type FontSpec, type FontkitMeasurerOptions, MONO, type MeasureResult, type RegisteredFont, RenderImageOptions, type RenderSlideOptions, RgbaImage, SANS, SERIF, TIMES, type TextAuditIssue, type TextLayoutMode, type TextMeasurer, auditTextLayout, buildFontkitMeasurer, defaultMeasurer, renderSlideToImage, renderSlideToRgba, renderSlideSvg as renderSlideToSvg, substituteFamily };
 //# sourceMappingURL=node.d.ts.map

package/dist/node.js

@@ -1,4 +1,4 @@
-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 { a as MONO, c as TIMES, d as substituteFamily, i as AVG_GLYPH_W_RATIO, l as defaultMeasurer, n as renderSlideSvg, o as SANS, r as ARIAL, s as SERIF, t as auditTextLayout, u as isCjk } from "./src-D95l1T9U.js";
 import { getSlideSize } from "@office-kit/pptx";
 import { Resvg } from "@resvg/resvg-js";
 import * as fontkit from "fontkit";
@@ -33,7 +33,14 @@ const styleSuffix = (spec) => {
 	if (spec.italic) return "Italic";
 	return "Regular";
 };
-const buildFontkitMeasurer = () => {
+const openFontSource = (source) => {
+	if (typeof source === "string") return openFont(source);
+	const font = fontkit.create(Buffer.from(source));
+	if (!("layout" in font)) throw new Error("Expected a single font, got a collection");
+	return font;
+};
+const estimateCharWidth = (ch, sizePx) => sizePx * (isCjk(ch.codePointAt(0) ?? 0) ? 1 : AVG_GLYPH_W_RATIO);
+const buildFontkitMeasurer = (options = {}) => {
 	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);
@@ -42,25 +49,65 @@ const buildFontkitMeasurer = () => {
 		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 registered = /* @__PURE__ */ new Map();
+	const fallbackFonts = [];
+	for (const reg of options.fonts ?? []) {
+		const font = openFontSource(reg.source);
+		const style = styleSuffix({
+			bold: reg.bold ?? false,
+			italic: reg.italic ?? false
+		});
+		registered.set(`${reg.family.toLowerCase()}-${style}`, font);
+		fallbackFonts.push(font);
+	}
 	const pick = (spec) => {
-		const prefix = FAMILY_TO_PREFIX[spec.family] ?? "Carlito";
 		const style = styleSuffix(spec);
+		const regKey = spec.family.toLowerCase();
+		const reg = registered.get(`${regKey}-${style}`) ?? registered.get(`${regKey}-Regular`);
+		if (reg) return reg;
+		const prefix = FAMILY_TO_PREFIX[spec.family] ?? FAMILY_TO_PREFIX[substituteFamily(spec.family)];
 		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 measureWithFallback = (text, spec, primary) => {
+		const chain = [primary, ...fallbackFonts.filter((f) => f !== primary)];
+		let widthPx = 0;
+		let approximate = false;
+		let metricsFont = null;
+		let segment = "";
+		let segmentFont = null;
+		const flush = () => {
+			if (segment === "" || segmentFont === null) return;
+			const scale = spec.sizePx / segmentFont.unitsPerEm;
+			widthPx += segmentFont.layout(segment).advanceWidth * scale;
+			metricsFont ??= segmentFont;
+			segment = "";
+		};
+		for (const ch of text) {
+			const cp = ch.codePointAt(0) ?? 0;
+			const font = chain.find((f) => f.hasGlyphForCodePoint(cp)) ?? null;
+			if (font !== segmentFont) {
+				flush();
+				segmentFont = font;
+			}
+			if (font === null) {
+				widthPx += estimateCharWidth(ch, spec.sizePx);
+				approximate = true;
+			} else segment += ch;
+		}
+		flush();
+		const vm = verticalMetrics(metricsFont ?? primary);
+		const vmScale = spec.sizePx / (metricsFont ?? primary).unitsPerEm;
 		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
+			widthPx: widthPx + tracking,
+			ascentPx: vm.ascent * vmScale,
+			descentPx: vm.descent * vmScale,
+			lineGapPx: vm.lineGap * vmScale,
+			...approximate ? { approximate } : {}
 		};
 	};
+	return (text, spec) => measureWithFallback(text, spec, pick(spec));
 };
 const verticalMetrics = (font) => {
 	const os2 = font["OS/2"];
@@ -100,8 +147,8 @@ const rasterize = (pres, slide, opts) => {
 			value: width
 		},
 		font: {
-			loadSystemFonts: false,
-			fontFiles: FONT_FILES,
+			loadSystemFonts: opts.loadSystemFonts ?? false,
+			fontFiles: [...FONT_FILES, ...opts.fontFiles ?? []],
 			defaultFontFamily: SANS,
 			sansSerifFamily: SANS,
 			serifFamily: SERIF,
@@ -128,6 +175,6 @@ const renderSlideToRgba = (pres, slide, opts = {}) => {
 	};
 };
 //#endregion
-export { ARIAL, FONT_DIR, FONT_FILES, MONO, SANS, SERIF, TIMES, buildFontkitMeasurer, defaultMeasurer, renderSlideToImage, renderSlideToRgba, renderSlideSvg as renderSlideToSvg, substituteFamily };
+export { ARIAL, FONT_DIR, FONT_FILES, MONO, SANS, SERIF, TIMES, auditTextLayout, buildFontkitMeasurer, defaultMeasurer, renderSlideToImage, renderSlideToRgba, renderSlideSvg as renderSlideToSvg, substituteFamily };
 
 //# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -1 +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":"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"}
+{"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  AVG_GLYPH_W_RATIO,\n  isCjk,\n  MONO,\n  SANS,\n  SERIF,\n  substituteFamily,\n  TIMES,\n  type FontSpec,\n  type MeasureResult,\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: { bold: boolean; italic: boolean }): (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\n/** A font the caller supplies for measurement, keyed by the AUTHORED family\n *  name (`<a:latin typeface>` / `<a:ea typeface>` — e.g. \"游ゴシック\",\n *  \"Montserrat\"), which routinely differs from the file's internal name. */\nexport interface RegisteredFont {\n  readonly family: string;\n  /** Path to a ttf/otf file, or its bytes. */\n  readonly source: string | Uint8Array;\n  readonly bold?: boolean;\n  readonly italic?: boolean;\n}\n\nexport interface FontkitMeasurerOptions {\n  /** Fonts the deck actually uses. A run whose family matches a registered\n   *  font measures with it; any registered font also serves as a fallback\n   *  for glyphs the resolved font lacks (the bundled faces are Latin-only,\n   *  so this is how CJK text gets real metrics). */\n  readonly fonts?: ReadonlyArray<RegisteredFont>;\n}\n\nconst openFontSource = (source: string | Uint8Array): fontkit.Font => {\n  if (typeof source === 'string') return openFont(source);\n  const font = fontkit.create(Buffer.from(source));\n  if (!('layout' in font)) {\n    throw new Error('Expected a single font, got a collection');\n  }\n  return font;\n};\n\n// Per-character width estimate for glyphs no available font covers — the same\n// ratios as the heuristic measurer, so estimates and defaultMeasurer agree.\nconst estimateCharWidth = (ch: string, sizePx: number): number =>\n  sizePx * (isCjk(ch.codePointAt(0) ?? 0) ? 1 : AVG_GLYPH_W_RATIO);\n\nexport const buildFontkitMeasurer = (options: FontkitMeasurerOptions = {}): 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  // Registered fonts, keyed by lowercased authored family + style. No\n  // familyName assertion here: the registration key is the DECK's name for\n  // the font, which legitimately differs from the file's internal name.\n  const registered = new Map<string, fontkit.Font>();\n  const fallbackFonts: fontkit.Font[] = [];\n  for (const reg of options.fonts ?? []) {\n    const font = openFontSource(reg.source);\n    const style = styleSuffix({ bold: reg.bold ?? false, italic: reg.italic ?? false });\n    registered.set(`${reg.family.toLowerCase()}-${style}`, font);\n    fallbackFonts.push(font);\n  }\n\n  const pick = (spec: FontSpec): fontkit.Font => {\n    const style = styleSuffix(spec);\n    const regKey = spec.family.toLowerCase();\n    const reg = registered.get(`${regKey}-${style}`) ?? registered.get(`${regKey}-Regular`);\n    if (reg) return reg;\n    // The render path pre-substitutes families (spec.family is a bundled\n    // internal name); the audit path passes the authored name through, so\n    // resolve it with the same map before keying the bundled faces.\n    const prefix =\n      FAMILY_TO_PREFIX[spec.family] ?? FAMILY_TO_PREFIX[substituteFamily(spec.family)]!;\n    return (\n      cache.get(`${prefix}-${style}`) ??\n      cache.get(`${prefix}-Regular`) ??\n      cache.get('Carlito-Regular')!\n    );\n  };\n\n  // Splits `text` into maximal segments coverable by one font: the resolved\n  // font first, then each registered font in registration order. Characters\n  // no font covers fall back to the per-character estimate (approximate).\n  const measureWithFallback = (\n    text: string,\n    spec: FontSpec,\n    primary: fontkit.Font,\n  ): MeasureResult => {\n    const chain = [primary, ...fallbackFonts.filter((f) => f !== primary)];\n    let widthPx = 0;\n    let approximate = false;\n    let metricsFont: fontkit.Font | null = null;\n    let segment = '';\n    let segmentFont: fontkit.Font | null = null;\n    const flush = (): void => {\n      if (segment === '' || segmentFont === null) return;\n      const scale = spec.sizePx / segmentFont.unitsPerEm;\n      widthPx += segmentFont.layout(segment).advanceWidth * scale;\n      metricsFont ??= segmentFont;\n      segment = '';\n    };\n    for (const ch of text) {\n      const cp = ch.codePointAt(0) ?? 0;\n      const font = chain.find((f) => f.hasGlyphForCodePoint(cp)) ?? null;\n      if (font !== segmentFont) {\n        flush();\n        segmentFont = font;\n      }\n      if (font === null) {\n        widthPx += estimateCharWidth(ch, spec.sizePx);\n        approximate = true;\n      } else {\n        segment += ch;\n      }\n    }\n    flush();\n    const vm = verticalMetrics(metricsFont ?? primary);\n    const vmScale = spec.sizePx / (metricsFont ?? primary).unitsPerEm;\n    const glyphCount = [...text].length;\n    const tracking = glyphCount > 1 ? spec.letterSpacingPx * (glyphCount - 1) : 0;\n    return {\n      widthPx: widthPx + tracking,\n      ascentPx: vm.ascent * vmScale,\n      descentPx: vm.descent * vmScale,\n      lineGapPx: vm.lineGap * vmScale,\n      ...(approximate ? { approximate } : {}),\n    };\n  };\n\n  return (text, spec) => measureWithFallback(text, spec, pick(spec));\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';\nexport type { FontkitMeasurerOptions, RegisteredFont } 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   * Extra font files (ttf / otf / ttc paths) loaded into the rasterizer in\n   * addition to the bundled Latin faces. The bundled set has no CJK\n   * coverage, so decks with Japanese / Chinese / Korean text render as\n   * missing-glyph boxes unless the caller supplies a face here (pair it with\n   * a {@link buildFontkitMeasurer} `fonts` registration so wrap math uses the\n   * same metrics).\n   */\n  readonly fontFiles?: ReadonlyArray<string>;\n  /**\n   * Also let the rasterizer discover OS-installed fonts as a fallback for\n   * families the bundled + `fontFiles` faces don't cover. Defaults to\n   * `false`: system fonts vary per machine, so the default keeps output\n   * deterministic.\n   */\n  readonly loadSystemFonts?: boolean;\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: opts.loadSystemFonts ?? false, // default: deterministic bundled set\n      fontFiles: [...FONT_FILES, ...(opts.fontFiles ?? [])],\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":"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"}