@json-to-office/core-docx 0.34.0 → 0.35.0

package/dist/components/visual.d.ts

@@ -12,7 +12,7 @@ import { ComponentDefinition, RenderContext } from '../types';
 import { ThemeConfig } from '../styles';
 import { type ImageOptions } from '../core/content';
 import type { VisualProps } from '@json-to-office/shared-docx';
-import { type PptxServiceConfig, type PptxRasterizeResult } from '@json-to-office/shared';
+import { type PptxServiceConfig, type PptxRasterizeResult, type RasterizeFontFace } from '@json-to-office/shared';
 export declare const DEFAULT_RASTERIZE_SERVER_URL = "http://localhost:7802";
 /**
  * Build a single-slide pptx presentation component definition from visual props.
@@ -42,6 +42,13 @@ export declare function visualToImageProps(props: VisualProps, base64DataUri: st
  * services) the target server. Keys the per-document pre-rasterization map
  * (#153); the pre-pass and the render-time lookup MUST use this one function
  * so the two sides cannot drift.
+ *
+ * FONTS ARE DELIBERATELY NOT PART OF THIS KEY. The map is built and consumed
+ * inside a single `renderDocument` call, which has exactly one font set, so
+ * the pre-pass and the render-time lookup can never disagree about fonts.
+ * The load-bearing font key is the RASTERIZER's on-disk cache key, which is
+ * process-wide and shared across documents and users — see `fontsDigest` in
+ * jto-cli's pptx-rasterizer.ts.
  */
 export declare function visualRasterKey(presentation: unknown, dpi: number, serverUrl?: string): string;
 /**
@@ -61,7 +68,13 @@ export declare function effectiveVisualServerUrl(props: VisualProps, serviceConf
  * Exported for the pre-rasterization pass, whose per-visual fallback must
  * behave exactly like render-time rasterization.
  */
-export declare function rasterizeVisualSlide(presentation: Record<string, unknown>, dpi: number, propsServerUrl: string | undefined, serviceConfig: PptxServiceConfig | undefined, baseDir: string | undefined): Promise<PptxRasterizeResult>;
+export declare function rasterizeVisualSlide(presentation: Record<string, unknown>, dpi: number, propsServerUrl: string | undefined, serviceConfig: PptxServiceConfig | undefined, baseDir: string | undefined, 
+/**
+ * Document fonts staged for the rasterizer's LibreOffice launch. Added
+ * conditionally below so a fontless document's request body stays exactly
+ * what it was before fonts existed.
+ */
+fonts?: readonly RasterizeFontFace[]): Promise<PptxRasterizeResult>;
 /**
  * Render visual component
  */

package/dist/components/visual.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"visual.d.ts","sourceRoot":"","sources":["../../src/components/visual.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EACL,mBAAmB,EACnB,aAAa,EAEd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAKjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACzB,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,4BAA4B,0BAA0B,CAAC;AAIpE;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,WAAW,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuBzB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAWrE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,aAAa,EAAE,MAAM,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,OAAO,EACrB,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAIR;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,WAAW,EAClB,aAAa,EAAE,iBAAiB,GAAG,SAAS,GAC3C,MAAM,GAAG,SAAS,CAGpB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,aAAa,EAAE,iBAAiB,GAAG,SAAS,EAC5C,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CA6C9B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,mBAAmB,EAC9B,KAAK,EAAE,WAAW,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC,EAAE,CAAC,CAkDhC"}
+{"version":3,"file":"visual.d.ts","sourceRoot":"","sources":["../../src/components/visual.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EACL,mBAAmB,EACnB,aAAa,EAEd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAKjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,4BAA4B,0BAA0B,CAAC;AAIpE;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,WAAW,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuBzB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAWrE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,aAAa,EAAE,MAAM,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,OAAO,EACrB,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAIR;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,WAAW,EAClB,aAAa,EAAE,iBAAiB,GAAG,SAAS,GAC3C,MAAM,GAAG,SAAS,CAGpB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,aAAa,EAAE,iBAAiB,GAAG,SAAS,EAC5C,OAAO,EAAE,MAAM,GAAG,SAAS;AAC3B;;;;GAIG;AACH,KAAK,CAAC,EAAE,SAAS,iBAAiB,EAAE,GACnC,OAAO,CAAC,mBAAmB,CAAC,CAuD9B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,mBAAmB,EAC9B,KAAK,EAAE,WAAW,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC,EAAE,CAAC,CAmDhC"}

package/dist/core/flattenVisuals.d.ts

@@ -13,7 +13,7 @@
  * just `children`: section `props.header`/`props.footer`, and table
  * `props.columns[].cells[].content` / `props.columns[].header.content`.
  */
-import { type PptxRasterizer, type PptxBatchRasterizer } from '@json-to-office/shared';
+import { type PptxRasterizer, type PptxBatchRasterizer, type RasterizeFontFace } from '@json-to-office/shared';
 export interface FlattenVisualsOptions {
     /** Rasterizer that turns a single-slide pptx presentation into a PNG. */
     rasterize: PptxRasterizer;
@@ -32,6 +32,13 @@ export interface FlattenVisualsOptions {
      * the document's own directory. Absent → the rasterizer's cwd (#142).
      */
     baseDir?: string;
+    /**
+     * Font faces staged for each visual's LibreOffice render. Without these a
+     * flattened document bakes in fontless PNGs permanently — the flatten
+     * output is a portable, service-free `.docx.json`, so there is no second
+     * chance to re-rasterize with the right fonts.
+     */
+    fonts?: readonly RasterizeFontFace[];
 }
 /**
  * Return a deep copy of `doc` with every `visual` node replaced by the `image`

package/dist/core/flattenVisuals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flattenVisuals.d.ts","sourceRoot":"","sources":["../../src/core/flattenVisuals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACzB,MAAM,wBAAwB,CAAC;AAYhC,MAAM,WAAW,qBAAqB;IACpC,yEAAyE;IACzE,SAAS,EAAE,cAAc,CAAC;IAC1B;;;;OAIG;IACH,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,8EAA8E;IAC9E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AASD;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,CAAC,GAAG,OAAO,EAC9C,GAAG,EAAE,CAAC,EACN,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,CAAC,CAAC,CA0CZ"}
+{"version":3,"file":"flattenVisuals.d.ts","sourceRoot":"","sources":["../../src/core/flattenVisuals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAYhC,MAAM,WAAW,qBAAqB;IACpC,yEAAyE;IACzE,SAAS,EAAE,cAAc,CAAC;IAC1B;;;;OAIG;IACH,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,8EAA8E;IAC9E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACtC;AAUD;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,CAAC,GAAG,OAAO,EAC9C,GAAG,EAAE,CAAC,EACN,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,CAAC,CAAC,CA+CZ"}

package/dist/core/fontResolution.d.ts

@@ -7,9 +7,23 @@
  * Keeping it in one place ensures the two paths behave identically around
  * validation, SAFE_FONTS awareness, Google Fonts materialization, and the
  * `onResolved` side-channel consumed by the LibreOffice preview font stager.
+ *
+ * Materialization has two triggers: an `onResolved` listener, or the
+ * caller's `forceMaterialize` flag (set when the document contains a
+ * `visual`, whose PNG is produced by an out-of-process LibreOffice that
+ * needs real font files). Both entry paths return the resolved fonts so the
+ * caller can forward them to the rasterizer.
  */
 import type { FontRuntimeOpts, ResolvedFont, GenerationWarning } from '@json-to-office/shared';
 import type { ThemeConfig } from '../styles';
 import type { ReportComponentDefinition } from '../types';
-export declare function resolveDocumentFonts(document: ReportComponentDefinition, theme: ThemeConfig, fonts?: FontRuntimeOpts, warnings?: GenerationWarning[]): Promise<ResolvedFont[]>;
+export declare function resolveDocumentFonts(document: ReportComponentDefinition, theme: ThemeConfig, fonts?: FontRuntimeOpts, warnings?: GenerationWarning[], 
+/**
+ * Materialize font bytes even when no `onResolved` listener is registered.
+ * Set by the callers when the document contains at least one `visual`,
+ * whose PNG is rendered by an out-of-process LibreOffice that needs the
+ * actual font files — there is no listener on the plain CLI path, so
+ * without this a visual-bearing build silently renders with fallbacks.
+ */
+forceMaterialize?: boolean): Promise<ResolvedFont[]>;
 //# sourceMappingURL=fontResolution.d.ts.map

package/dist/core/fontResolution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fontResolution.d.ts","sourceRoot":"","sources":["../../src/core/fontResolution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAWhC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAE1D,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,yBAAyB,EACnC,KAAK,EAAE,WAAW,EAClB,KAAK,CAAC,EAAE,eAAe,EACvB,QAAQ,CAAC,EAAE,iBAAiB,EAAE,GAC7B,OAAO,CAAC,YAAY,EAAE,CAAC,CAmEzB"}
+{"version":3,"file":"fontResolution.d.ts","sourceRoot":"","sources":["../../src/core/fontResolution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAchC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAE1D,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,yBAAyB,EACnC,KAAK,EAAE,WAAW,EAClB,KAAK,CAAC,EAAE,eAAe,EACvB,QAAQ,CAAC,EAAE,iBAAiB,EAAE;AAC9B;;;;;;GAMG;AACH,gBAAgB,UAAQ,GACvB,OAAO,CAAC,YAAY,EAAE,CAAC,CAkFzB"}

package/dist/core/generator.d.ts.map

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

package/dist/core/prerasterizeVisuals.d.ts

@@ -15,13 +15,20 @@
  * wastes a little work, under-collection and every failure mode degrade to
  * the sequential status quo, never to a broken render.
  */
-import { type PptxServiceConfig, type PptxRasterizeBatchSlideResult } from '@json-to-office/shared';
+import { type PptxServiceConfig, type PptxRasterizeBatchSlideResult, type RasterizeFontFace } from '@json-to-office/shared';
 import type { VisualProps } from '@json-to-office/shared-docx';
 export interface PrerasterizeOptions {
     /** Directory relative asset paths resolve against (#142). */
     baseDir?: string;
     /** Max concurrent per-visual fallback rasterizations (default 4). */
     concurrency?: number;
+    /**
+     * Font faces staged for every slide's LibreOffice render. Request-level,
+     * like `baseDir` — never per-slide: the batch schema validates each slide
+     * object with `additionalProperties: false`, and a uniform slide shape is
+     * what lets the server share one disk-cache key with the single path.
+     */
+    fonts?: readonly RasterizeFontFace[];
 }
 /** Cumulative pre-pass counters for cache observability (#156). */
 export interface VisualPrepassStats {

package/dist/core/prerasterizeVisuals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prerasterizeVisuals.d.ts","sourceRoot":"","sources":["../../src/core/prerasterizeVisuals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAIL,KAAK,iBAAiB,EAEtB,KAAK,6BAA6B,EACnC,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAkB/D,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;CAChB;AAQD;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,kBAAkB,CAE1D;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAI9C;AASD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,EAAE,CA4B/D;AAsDD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,OAAO,EACb,aAAa,EAAE,iBAAiB,GAAG,SAAS,EAC5C,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAC,CAuJrD"}
+{"version":3,"file":"prerasterizeVisuals.d.ts","sourceRoot":"","sources":["../../src/core/prerasterizeVisuals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAIL,KAAK,iBAAiB,EAEtB,KAAK,6BAA6B,EAClC,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAkB/D,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACtC;AAED,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;CAChB;AAQD;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,kBAAkB,CAE1D;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAI9C;AAkBD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,EAAE,CA4B/D;AA6ED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,OAAO,EACb,aAAa,EAAE,iBAAiB,GAAG,SAAS,EAC5C,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAC,CAiOrD"}

package/dist/core/render.d.ts

@@ -8,7 +8,7 @@ import { ThemeConfig } from '../styles';
 import { ProcessedDocument } from './structure';
 import { LayoutPlan, SectionLayout } from './layout';
 import { MemoryCache } from '../cache';
-import type { ServicesConfig } from '@json-to-office/shared';
+import type { ServicesConfig, RasterizeFontFace } from '@json-to-office/shared';
 interface RenderDocumentOptions {
     cache?: MemoryCache;
     bypassCache?: boolean;
@@ -18,6 +18,13 @@ interface RenderDocumentOptions {
      * against. Defaults to `process.cwd()` when absent (#142).
      */
     baseDir?: string;
+    /**
+     * Font faces (base64) shipped with every `visual` rasterization so the
+     * out-of-process LibreOffice renders the slide with the document's real
+     * fonts instead of a system fallback. Produced by the caller from
+     * `resolveDocumentFonts` via `toRasterizeFontFaces`.
+     */
+    visualFonts?: RasterizeFontFace[];
 }
 /**
  * Render a complete document from structure and layout

package/dist/core/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/core/render.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,QAAQ,EACR,SAAS,EACT,KAAK,EACL,eAAe,EAEf,eAAe,EAKf,OAAO,EACR,MAAM,MAAM,CAAC;AAcd,OAAO,EACL,mBAAmB,EACnB,aAAa,EAed,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAIxC,OAAO,EAEL,iBAAiB,EAElB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAKrD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAoC7D,UAAU,qBAAqB;IAC7B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA8DD;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,QAAQ,CAAC,CAwBnB;AAiZD;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,EACtB,cAAc,CAAC,EAAE,MAAM,EACvB,aAAa,CAAC,EAAE,OAAO,EACvB,WAAW,UAAQ,GAClB,OAAO,CAAC,eAAe,CAAC,CAkH1B;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,mBAAmB,EAC9B,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,CAAC,SAAS,GAAG,KAAK,GAAG,eAAe,GAAG,OAAO,CAAC,EAAE,CAAC,CAmC5D"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/core/render.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,QAAQ,EACR,SAAS,EACT,KAAK,EACL,eAAe,EAEf,eAAe,EAKf,OAAO,EACR,MAAM,MAAM,CAAC;AAcd,OAAO,EACL,mBAAmB,EACnB,aAAa,EAed,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAIxC,OAAO,EAEL,iBAAiB,EAElB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAKrD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAoChF,UAAU,qBAAqB;IAC7B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACnC;AA8DD;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,QAAQ,CAAC,CAwBnB;AAkZD;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,EACtB,cAAc,CAAC,EAAE,MAAM,EACvB,aAAa,CAAC,EAAE,OAAO,EACvB,WAAW,UAAQ,GAClB,OAAO,CAAC,eAAe,CAAC,CAkH1B;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,mBAAmB,EAC9B,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,CAAC,SAAS,GAAG,KAAK,GAAG,eAAe,GAAG,OAAO,CAAC,EAAE,CAAC,CAmC5D"}

package/dist/index.js

@@ -7610,14 +7610,19 @@ function effectiveVisualServerUrl(props, serviceConfig) {
   if (serviceConfig?.render) return void 0;
   return props.serverUrl;
 }
-async function rasterizeVisualSlide(presentation, dpi, propsServerUrl, serviceConfig, baseDir) {
+async function rasterizeVisualSlide(presentation, dpi, propsServerUrl, serviceConfig, baseDir, fonts) {
   if (!isNodeEnvironment()) {
     throw new Error(
       "Visual rasterization requires a Node.js environment. It is not available in browser environments."
     );
   }
   if (serviceConfig?.render) {
-    return serviceConfig.render({ presentation, dpi, baseDir });
+    return serviceConfig.render({
+      presentation,
+      dpi,
+      baseDir,
+      ...fonts?.length ? { fonts: [...fonts] } : {}
+    });
   }
   const serverUrl = resolveServiceUrl(
     propsServerUrl,
@@ -7627,7 +7632,12 @@ async function rasterizeVisualSlide(presentation, dpi, propsServerUrl, serviceCo
   const response = await postJsonToService({
     url: serverUrl,
     path: "/rasterize",
-    body: { presentation, dpi, ...baseDir !== void 0 && { baseDir } },
+    body: {
+      presentation,
+      dpi,
+      ...baseDir !== void 0 && { baseDir },
+      ...fonts?.length ? { fonts } : {}
+    },
     headers: serviceConfig?.headers,
     serviceLabel: "PPTX rasterization service",
     onUnreachable: (url, cause) => `PPTX rasterization service is not reachable at ${url}. Configure services.pptx with a \`render\` callback or a running \`serverUrl\`.
@@ -7673,7 +7683,8 @@ async function renderVisualComponent(component, theme, themeName, context) {
       dpi,
       props.serverUrl,
       serviceConfig,
-      getBaseDir()
+      getBaseDir(),
+      context?.visualFonts
     );
   }
   return await createImage(
@@ -7807,6 +7818,11 @@ function collectVisualProps(root) {
 function toErrorMessage(error) {
   return error instanceof Error ? error.message : String(error);
 }
+var HTTP_STATUS_IN_MESSAGE = /\breturned (\d{3})\b/;
+function isSchemaRejection(error) {
+  const match = HTTP_STATUS_IN_MESSAGE.exec(toErrorMessage(error));
+  return match !== null && match[1] === "400";
+}
 function* chunksOf(items, size) {
   for (let i = 0; i < items.length; i += size) yield items.slice(i, i + size);
 }
@@ -7865,22 +7881,38 @@ async function prerasterizeVisuals(root, serviceConfig, options = {}) {
   const limit = createLimiter(
     Math.max(1, options.concurrency ?? DEFAULT_FALLBACK_CONCURRENCY)
   );
+  let fontsRejected = false;
+  const requestFonts = () => fontsRejected || !options.fonts?.length ? void 0 : options.fonts;
+  const rasterizeOne = async (target) => {
+    const fonts = requestFonts();
+    const call = (withFonts) => rasterizeVisualSlide(
+      target.presentation,
+      target.dpi,
+      void 0,
+      serviceConfig,
+      options.baseDir,
+      withFonts
+    );
+    try {
+      return { ok: true, ...await call(fonts) };
+    } catch (error) {
+      if (!fonts || !isSchemaRejection(error)) {
+        return { ok: false, error: toErrorMessage(error) };
+      }
+      try {
+        const result = await call(void 0);
+        fontsRejected = true;
+        return { ok: true, ...result };
+      } catch {
+        return { ok: false, error: toErrorMessage(error) };
+      }
+    }
+  };
   const rasterizeIndividually = async (chunk) => {
     await Promise.all(
       chunk.map(
         (target) => limit(async () => {
-          try {
-            const result = await rasterizeVisualSlide(
-              target.presentation,
-              target.dpi,
-              void 0,
-              serviceConfig,
-              options.baseDir
-            );
-            map.set(target.key, { ok: true, ...result });
-          } catch (error) {
-            map.set(target.key, { ok: false, error: toErrorMessage(error) });
-          }
+          map.set(target.key, await rasterizeOne(target));
         })
       )
     );
@@ -7893,7 +7925,8 @@ async function prerasterizeVisuals(root, serviceConfig, options = {}) {
             presentation: target.presentation,
             dpi: target.dpi
           })),
-          ...options.baseDir !== void 0 && { baseDir: options.baseDir }
+          ...options.baseDir !== void 0 && { baseDir: options.baseDir },
+          ...options.fonts?.length ? { fonts: [...options.fonts] } : {}
         });
         if (!applyBatchResponse(chunk, response, map)) {
           throw new Error(
@@ -7922,10 +7955,10 @@ async function prerasterizeVisuals(root, serviceConfig, options = {}) {
     serviceConfig?.serverUrl,
     DEFAULT_RASTERIZE_SERVER_URL
   );
-  for (const chunk of chunksOf(unique, MAX_RASTERIZE_BATCH_SLIDES)) {
-    let applied = false;
+  const postBatch = async (chunk, fonts) => {
+    let response;
     try {
-      const response = await postJsonToService({
+      response = await postJsonToService({
         url: serverUrl,
         path: "/rasterize/batch",
         body: {
@@ -7933,18 +7966,36 @@ async function prerasterizeVisuals(root, serviceConfig, options = {}) {
             presentation: target.presentation,
             dpi: target.dpi
           })),
-          ...options.baseDir !== void 0 && { baseDir: options.baseDir }
+          ...options.baseDir !== void 0 && { baseDir: options.baseDir },
+          ...fonts?.length ? { fonts } : {}
         },
         headers: serviceConfig?.headers,
         timeoutMs: BATCH_TIMEOUT_BASE_MS + BATCH_TIMEOUT_PER_SLIDE_MS * chunk.length,
         serviceLabel: "PPTX batch rasterization service",
         onUnreachable: (url, cause) => `PPTX rasterization service is not reachable at ${url}. Cause: ${cause}`
       });
-      applied = applyBatchResponse(chunk, await response.json(), map);
+    } catch (error) {
+      return { applied: false, schemaRejected: isSchemaRejection(error) };
+    }
+    try {
+      if (applyBatchResponse(chunk, await response.json(), map)) {
+        return { applied: true };
+      }
     } catch {
-      applied = false;
     }
-    if (!applied) await rasterizeIndividually(chunk);
+    return { applied: false, schemaRejected: false };
+  };
+  for (const chunk of chunksOf(unique, MAX_RASTERIZE_BATCH_SLIDES)) {
+    const fonts = requestFonts();
+    let outcome = await postBatch(chunk, fonts);
+    if (!outcome.applied && fonts && outcome.schemaRejected) {
+      const retry = await postBatch(chunk, void 0);
+      if (retry.applied) {
+        fontsRejected = true;
+        outcome = retry;
+      }
+    }
+    if (!outcome.applied) await rasterizeIndividually(chunk);
   }
   return map;
 }
@@ -8094,11 +8145,12 @@ async function renderDocumentScoped(structure, layout, options) {
     structure.themeName
   );
   context.services = options?.services;
+  context.visualFonts = options?.visualFonts;
   try {
     const visualRasterResults = await prerasterizeVisuals(
       layout.sections,
       options?.services?.pptx,
-      { baseDir: getBaseDir() }
+      { baseDir: getBaseDir(), fonts: options?.visualFonts }
     );
     if (visualRasterResults.size > 0) {
       context.visualRasterResults = visualRasterResults;
@@ -8468,14 +8520,17 @@ async function renderComponent(component, theme, themeName, context) {
 import {
   collectFontNamesFromDocx,
   validateFontReferences,
-  FontRegistry
+  FontRegistry,
+  documentFontRegistry,
+  themeFontRegistry,
+  mergeFontRegistries
 } from "@json-to-office/shared";
 import {
   loadFileFontSource,
   FontDiskCache,
   fetchVariableFontSource
 } from "@json-to-office/shared/fonts/node";
-async function resolveDocumentFonts(document, theme, fonts, warnings) {
+async function resolveDocumentFonts(document, theme, fonts, warnings, forceMaterialize = false) {
   const emit = (code, message) => {
     if (warnings) {
       warnings.push({
@@ -8492,9 +8547,14 @@ async function resolveDocumentFonts(document, theme, fonts, warnings) {
   for (const n of collectFontNamesFromDocx(document)) names.add(n);
   for (const n of collectFontNamesFromDocx(theme)) names.add(n);
   if (names.size === 0) return [];
+  const registryEntries = mergeFontRegistries(
+    themeFontRegistry(theme),
+    documentFontRegistry(document),
+    fonts?.extraEntries
+  );
   const validation = validateFontReferences({
     referencedNames: names,
-    registeredEntries: fonts?.extraEntries
+    registeredEntries: registryEntries
   });
   if (validation.warnings.length > 0) {
     if (fonts?.strict) {
@@ -8507,9 +8567,11 @@ async function resolveDocumentFonts(document, theme, fonts, warnings) {
       emit(w.code, w.message);
     }
   }
-  if (!fonts?.onResolved) return [];
+  if (!fonts?.onResolved && !forceMaterialize) return [];
   const registry = new FontRegistry({
-    opts: fonts,
+    // Spread keeps baseDir/googleFonts/mode/substitution intact for
+    // materializeSource; extraEntries carries the merged registry.
+    opts: { ...fonts, extraEntries: registryEntries },
     fileLoader: loadFileFontSource,
     variableLoader: fetchVariableFontSource,
     diskCache: fonts?.googleFonts?.cacheDir ? new FontDiskCache(fonts.googleFonts.cacheDir) : void 0
@@ -8520,10 +8582,13 @@ async function resolveDocumentFonts(document, theme, fonts, warnings) {
       emit("FONT_UNRESOLVED", msg);
     }
   }
-  fonts.onResolved(resolved);
+  fonts?.onResolved?.(resolved);
   return resolved;
 }
 
+// src/core/generator.ts
+import { toRasterizeFontFaces } from "@json-to-office/shared/fonts/node";
+
 // src/utils/packageDocument.ts
 import AdmZip2 from "adm-zip";
 import { Packer } from "docx";
@@ -8783,7 +8848,15 @@ async function generateDocumentWithCustomThemes(documentIn, customThemes, servic
     fonts,
     warnings
   });
-  await resolveDocumentFonts(document, theme, fonts, warnings);
+  const hasVisual = collectVisualProps(document).length > 0;
+  const resolvedFonts = await resolveDocumentFonts(
+    document,
+    theme,
+    fonts,
+    warnings,
+    hasVisual
+  );
+  const visualFonts = hasVisual ? toRasterizeFontFaces(resolvedFonts, warnings) : [];
   const structure = await processDocument(
     document,
     theme,
@@ -8794,7 +8867,8 @@ async function generateDocumentWithCustomThemes(documentIn, customThemes, servic
   const renderedDocument = await renderDocument(structure, layout, {
     bypassCache: false,
     services,
-    baseDir
+    baseDir,
+    ...visualFonts.length > 0 && { visualFonts }
   });
   return renderedDocument;
 }
@@ -8908,7 +8982,11 @@ async function flattenVisuals(doc, options) {
         renderBatch: options.rasterizeBatch,
         dpi: options.dpi
       },
-      { baseDir: options.baseDir, concurrency: options.concurrency }
+      {
+        baseDir: options.baseDir,
+        concurrency: options.concurrency,
+        fonts: options.fonts
+      }
     ).catch(() => /* @__PURE__ */ new Map());
     rasterize = async (request) => {
       const hit = preRasterized.get(
@@ -8929,6 +9007,7 @@ async function flattenVisuals(doc, options) {
     rasterize,
     dpi: options.dpi,
     baseDir: options.baseDir,
+    fonts: options.fonts,
     limit: createLimiter(
       Math.max(1, options.concurrency ?? DEFAULT_CONCURRENCY)
     )
@@ -8942,7 +9021,8 @@ async function rasterizeVisual(obj, ctx) {
     () => ctx.rasterize({
       presentation: buildVisualPresentation(props),
       dpi,
-      baseDir: ctx.baseDir
+      baseDir: ctx.baseDir,
+      ...ctx.fonts?.length ? { fonts: [...ctx.fonts] } : {}
     })
   );
   const image = {
@@ -9218,6 +9298,7 @@ async function runExample(example, options = {}) {
 
 // src/plugin/createDocumentGenerator.ts
 init_themes();
+import { toRasterizeFontFaces as toRasterizeFontFaces2 } from "@json-to-office/shared/fonts/node";
 
 // src/plugin/version-resolver.ts
 import { resolveComponentVersion } from "@json-to-office/shared/plugin";
@@ -9745,7 +9826,15 @@ function createBuilderImpl(state) {
         warnings,
         preserveSet
       } = await expandDocument(document, options);
-      await resolveDocumentFonts(modedDoc, modedTheme, state.fonts, warnings);
+      const hasVisual = collectVisualProps(modedDoc).length > 0;
+      const resolvedFonts = await resolveDocumentFonts(
+        modedDoc,
+        modedTheme,
+        state.fonts,
+        warnings,
+        hasVisual
+      );
+      const visualFonts = hasVisual ? toRasterizeFontFaces2(resolvedFonts, warnings) : [];
       const packageOptions = {
         deterministic: options?.deterministic ?? state.deterministic,
         generatedAt: options?.generatedAt ?? state.generatedAt
@@ -9760,7 +9849,8 @@ function createBuilderImpl(state) {
       const generatedDocument = await renderDocument(structure, layout, {
         services: state.services,
         bypassCache: !state.enableCache,
-        baseDir: options?.baseDir ?? state.baseDir
+        baseDir: options?.baseDir ?? state.baseDir,
+        ...visualFonts.length > 0 && { visualFonts }
       });
       const preservedDefinition = preserveSet ? {
         ...modedRoot,