@json-to-office/core-docx 0.28.0 → 0.29.0

package/dist/components/visual.d.ts

@@ -12,6 +12,8 @@ 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';
+export declare const DEFAULT_RASTERIZE_SERVER_URL = "http://localhost:7802";
 /**
  * Build a single-slide pptx presentation component definition from visual props.
  * The shape mirrors a normal `.pptx.json` document so the pptx engine renders
@@ -35,6 +37,31 @@ export declare function visualToImageOptions(props: VisualProps): ImageOptions;
  * `flattenVisuals` transform to produce a portable, service-free document).
  */
 export declare function visualToImageProps(props: VisualProps, base64DataUri: string): Record<string, unknown>;
+/**
+ * Identity of one visual rasterization: content + resolution + (for HTTP
+ * 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.
+ */
+export declare function visualRasterKey(presentation: unknown, dpi: number, serverUrl?: string): string;
+/**
+ * The serverUrl that actually differentiates a visual's rasterization. An
+ * in-process `render` callback takes precedence over any serverUrl —
+ * per-visual or config — so overrides only matter when rasterization would
+ * go over HTTP. Deliberately keyed on `render` alone (NOT `renderBatch`):
+ * per-visual fallbacks always go through `rasterizeVisualSlide`, which only
+ * consults `render`, and pre-pass inclusion must match what a fallback would
+ * actually do or the same visual could rasterize against two different
+ * services depending on cache luck.
+ */
+export declare function effectiveVisualServerUrl(props: VisualProps, serviceConfig: PptxServiceConfig | undefined): string | undefined;
+/**
+ * Rasterize a single-slide presentation to a PNG via the configured service.
+ * An in-process `render` callback takes precedence over an HTTP `serverUrl`.
+ * 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>;
 /**
  * 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;AAEH,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;AAY/D;;;;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;AA2DD;;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,CA+BhC"}
+{"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"}

package/dist/core/flattenVisuals.d.ts

@@ -13,10 +13,16 @@
  * just `children`: section `props.header`/`props.footer`, and table
  * `props.columns[].cells[].content` / `props.columns[].header.content`.
  */
-import { type PptxRasterizer } from '@json-to-office/shared';
+import { type PptxRasterizer, type PptxBatchRasterizer } from '@json-to-office/shared';
 export interface FlattenVisualsOptions {
     /** Rasterizer that turns a single-slide pptx presentation into a PNG. */
     rasterize: PptxRasterizer;
+    /**
+     * Batch rasterizer (#153). When provided, all visuals are collected and
+     * rasterized together up front; `rasterize` remains the per-visual
+     * fallback for batch failures and anything the collection missed.
+     */
+    rasterizeBatch?: PptxBatchRasterizer;
     /** Default DPI applied when a `visual` does not specify one (default 200). */
     dpi?: number;
     /** Max concurrent rasterizations (default 4). */
@@ -29,7 +35,9 @@ export interface FlattenVisualsOptions {
 }
 /**
  * Return a deep copy of `doc` with every `visual` node replaced by the `image`
- * node it rasterizes to. Visuals rasterize with bounded concurrency. A
+ * node it rasterizes to. With `rasterizeBatch`, visuals are pre-rasterized in
+ * batches and the tree walk resolves from the batch results; otherwise (and
+ * for any batch miss) visuals rasterize per-node with bounded concurrency. A
  * `visual` with `enabled: false` is left untouched (it's filtered out at render
  * anyway, so rasterizing it would be wasted work). Non-visual nodes are copied
  * structurally and otherwise unchanged.

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,EACpB,MAAM,wBAAwB,CAAC;AAShC,MAAM,WAAW,qBAAqB;IACpC,yEAAyE;IACzE,SAAS,EAAE,cAAc,CAAC;IAC1B,8EAA8E;IAC9E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA6BD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,CAAC,GAAG,OAAO,EAC9C,GAAG,EAAE,CAAC,EACN,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,CAAC,CAAC,CAUZ"}
+{"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"}

package/dist/core/prerasterizeVisuals.d.ts

@@ -0,0 +1,44 @@
+/**
+ * prerasterizeVisuals — per-document visual rasterization pre-pass (#153).
+ *
+ * The renderer walks components strictly in order, so each `visual` used to
+ * await its own rasterization round trip: one HTTP call + one LibreOffice
+ * launch per visual, ~25 of each for the bundled annual-report templates.
+ * This pass runs once per document before rendering: it collects every
+ * enabled visual, dedupes identical ones, and rasterizes them together —
+ * through an in-process batch rasterizer, a batched HTTP call, or (failing
+ * both) bounded-concurrency per-visual calls.
+ *
+ * Results land in a map keyed by `visualRasterKey`; `renderVisualComponent`
+ * consults the map first and falls back to per-visual rasterization on any
+ * miss. The pre-pass is therefore purely an accelerator: over-collection
+ * 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 { 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;
+}
+/**
+ * Collect the props of every enabled `visual` component reachable from
+ * `root`. The walk is generic — every array element and object value is
+ * visited — so visuals nested anywhere (columns, table cells, section
+ * headers/footers, plugin containers) are found without enumerating
+ * container shapes. Disabled component subtrees are pruned: they never
+ * render, so rasterizing them is wasted work. Over-collection is harmless
+ * (an unused map entry); under-collection is harmless (render-time
+ * fallback) — which is what makes the generic walk safe.
+ */
+export declare function collectVisualProps(root: unknown): VisualProps[];
+/**
+ * Batch-rasterize a document's visuals ahead of rendering. Returns a map of
+ * `visualRasterKey` → per-visual result (pixels or a recorded error). Never
+ * throws for per-visual problems; a thrown error here indicates a pre-pass
+ * bug and the caller should continue without the map.
+ */
+export declare function prerasterizeVisuals(root: unknown, serviceConfig: PptxServiceConfig | undefined, options?: PrerasterizeOptions): Promise<Map<string, PptxRasterizeBatchSlideResult>>;
+//# sourceMappingURL=prerasterizeVisuals.d.ts.map

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

@@ -0,0 +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;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,CAmJrD"}

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;AA6B7D,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,CAYnB;AA6XD;;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,CAiH1B;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,MAAM,wBAAwB,CAAC;AA+B7D,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,CAYnB;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,CAiH1B;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

@@ -7013,6 +7013,7 @@ async function renderHighchartsComponent(component, theme, themeName, context) {
 }
 
 // src/components/visual.ts
+import { createHash as createHash4 } from "crypto";
 import {
   clampVisualDpi,
   DEFAULT_VISUAL_DPI
@@ -7062,7 +7063,14 @@ function visualToImageProps(props, base64DataUri) {
     ...props.alt !== void 0 && { alt: props.alt }
   };
 }
-async function rasterize(presentation, dpi, propsServerUrl, serviceConfig, baseDir) {
+function visualRasterKey(presentation, dpi, serverUrl) {
+  return createHash4("sha256").update(JSON.stringify({ p: presentation, d: dpi, u: serverUrl ?? null })).digest("hex");
+}
+function effectiveVisualServerUrl(props, serviceConfig) {
+  if (serviceConfig?.render) return void 0;
+  return props.serverUrl;
+}
+async function rasterizeVisualSlide(presentation, dpi, propsServerUrl, serviceConfig, baseDir) {
   if (!isNodeEnvironment()) {
     throw new Error(
       "Visual rasterization requires a Node.js environment. It is not available in browser environments."
@@ -7108,13 +7116,26 @@ async function renderVisualComponent(component, theme, themeName, context) {
   const dpi = clampVisualDpi(
     props.dpi ?? serviceConfig?.dpi ?? DEFAULT_VISUAL_DPI
   );
-  const result = await rasterize(
-    presentation,
-    dpi,
-    props.serverUrl,
-    serviceConfig,
-    getBaseDir()
+  const preRasterized = context?.visualRasterResults?.get(
+    visualRasterKey(
+      presentation,
+      dpi,
+      effectiveVisualServerUrl(props, serviceConfig)
+    )
   );
+  let result;
+  if (preRasterized) {
+    if (!preRasterized.ok) throw new Error(preRasterized.error);
+    result = preRasterized;
+  } else {
+    result = await rasterizeVisualSlide(
+      presentation,
+      dpi,
+      props.serverUrl,
+      serviceConfig,
+      getBaseDir()
+    );
+  }
   return await createImage(
     result.base64DataUri,
     theme,
@@ -7176,6 +7197,203 @@ var textSpaceAfterComponent = createComponent({
 
 // src/core/render.ts
 init_docxImagePositioning();
+
+// src/core/prerasterizeVisuals.ts
+import {
+  clampVisualDpi as clampVisualDpi2,
+  DEFAULT_VISUAL_DPI as DEFAULT_VISUAL_DPI2,
+  MAX_RASTERIZE_BATCH_SLIDES
+} from "@json-to-office/shared";
+
+// src/utils/promiseLimiter.ts
+function createLimiter(max) {
+  let active = 0;
+  const queue = [];
+  const release = () => {
+    active--;
+    queue.shift()?.();
+  };
+  return async function limit(fn) {
+    while (active >= max)
+      await new Promise((resolve4) => queue.push(resolve4));
+    active++;
+    try {
+      return await fn();
+    } finally {
+      release();
+    }
+  };
+}
+
+// src/core/prerasterizeVisuals.ts
+var DEFAULT_FALLBACK_CONCURRENCY = 4;
+var BATCH_TIMEOUT_BASE_MS = 3e4;
+var BATCH_TIMEOUT_PER_SLIDE_MS = 1e4;
+function collectVisualProps(root) {
+  const found = [];
+  const seen = /* @__PURE__ */ new WeakSet();
+  const visit = (node) => {
+    if (!node || typeof node !== "object") return;
+    if (seen.has(node)) return;
+    seen.add(node);
+    if (Array.isArray(node)) {
+      for (const item of node) visit(item);
+      return;
+    }
+    const obj = node;
+    if (typeof obj.name === "string" && obj.enabled === false) return;
+    if (obj.name === "visual" && obj.props && typeof obj.props === "object") {
+      found.push(obj.props);
+      return;
+    }
+    for (const value of Object.values(obj)) visit(value);
+  };
+  visit(root);
+  return found;
+}
+function toErrorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function* chunksOf(items, size) {
+  for (let i = 0; i < items.length; i += size) yield items.slice(i, i + size);
+}
+function applyBatchResponse(chunk, response, map) {
+  const results = response?.results;
+  if (!Array.isArray(results) || results.length !== chunk.length) return false;
+  const entries = [];
+  for (let i = 0; i < chunk.length; i++) {
+    const item = results[i];
+    if (item && item.ok === true && typeof item.base64DataUri === "string" && item.base64DataUri.length > 0 && typeof item.width === "number" && typeof item.height === "number") {
+      entries.push([
+        chunk[i].key,
+        {
+          ok: true,
+          base64DataUri: item.base64DataUri,
+          width: item.width,
+          height: item.height
+        }
+      ]);
+    } else if (item && item.ok === false && typeof item.error === "string") {
+      entries.push([chunk[i].key, { ok: false, error: item.error }]);
+    } else {
+      return false;
+    }
+  }
+  for (const [key, value] of entries) map.set(key, value);
+  return true;
+}
+async function prerasterizeVisuals(root, serviceConfig, options = {}) {
+  const map = /* @__PURE__ */ new Map();
+  if (!isNodeEnvironment() && !serviceConfig?.renderBatch && !serviceConfig?.render) {
+    return map;
+  }
+  const visuals = collectVisualProps(root);
+  if (visuals.length === 0) return map;
+  const targets = /* @__PURE__ */ new Map();
+  for (const props of visuals) {
+    try {
+      const serverUrl2 = effectiveVisualServerUrl(props, serviceConfig);
+      if (serverUrl2 !== void 0) continue;
+      const presentation = buildVisualPresentation(props);
+      const dpi = clampVisualDpi2(
+        props.dpi ?? serviceConfig?.dpi ?? DEFAULT_VISUAL_DPI2
+      );
+      const key = visualRasterKey(presentation, dpi, serverUrl2);
+      if (!targets.has(key)) targets.set(key, { key, presentation, dpi });
+    } catch {
+      continue;
+    }
+  }
+  if (targets.size === 0) return map;
+  const unique = [...targets.values()];
+  const limit = createLimiter(
+    Math.max(1, options.concurrency ?? DEFAULT_FALLBACK_CONCURRENCY)
+  );
+  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) });
+          }
+        })
+      )
+    );
+  };
+  if (serviceConfig?.renderBatch) {
+    for (const chunk of chunksOf(unique, MAX_RASTERIZE_BATCH_SLIDES)) {
+      try {
+        const response = await serviceConfig.renderBatch({
+          slides: chunk.map((target) => ({
+            presentation: target.presentation,
+            dpi: target.dpi
+          })),
+          ...options.baseDir !== void 0 && { baseDir: options.baseDir }
+        });
+        if (!applyBatchResponse(chunk, response, map)) {
+          throw new Error(
+            "batch rasterizer returned a malformed result (expected index-aligned results[])"
+          );
+        }
+      } catch (error) {
+        if (serviceConfig.render || serviceConfig.serverUrl) {
+          await rasterizeIndividually(chunk);
+        } else {
+          const message = toErrorMessage(error);
+          for (const target of chunk) {
+            map.set(target.key, { ok: false, error: message });
+          }
+        }
+      }
+    }
+    return map;
+  }
+  if (serviceConfig?.render) {
+    await rasterizeIndividually(unique);
+    return map;
+  }
+  const serverUrl = resolveServiceUrl(
+    void 0,
+    serviceConfig?.serverUrl,
+    DEFAULT_RASTERIZE_SERVER_URL
+  );
+  for (const chunk of chunksOf(unique, MAX_RASTERIZE_BATCH_SLIDES)) {
+    let applied = false;
+    try {
+      const response = await postJsonToService({
+        url: serverUrl,
+        path: "/rasterize/batch",
+        body: {
+          slides: chunk.map((target) => ({
+            presentation: target.presentation,
+            dpi: target.dpi
+          })),
+          ...options.baseDir !== void 0 && { baseDir: options.baseDir }
+        },
+        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 {
+      applied = false;
+    }
+    if (!applied) await rasterizeIndividually(chunk);
+  }
+  return map;
+}
+
+// src/core/render.ts
 function getAlignment3(alignment) {
   switch (alignment) {
     case "center":
@@ -7232,6 +7450,21 @@ async function renderDocumentScoped(structure, layout, options) {
     structure.themeName
   );
   context.services = options?.services;
+  try {
+    const visualRasterResults = await prerasterizeVisuals(
+      layout.sections,
+      options?.services?.pptx,
+      { baseDir: getBaseDir() }
+    );
+    if (visualRasterResults.size > 0) {
+      context.visualRasterResults = visualRasterResults;
+    }
+  } catch (error) {
+    console.warn(
+      "[core-docx] Visual pre-rasterization failed; falling back to per-visual rasterization:",
+      error instanceof Error ? error.message : error
+    );
+  }
   let sectionBookmarkCounter = 0;
   let previousHeader = void 0;
   let previousFooter = void 0;
@@ -8015,31 +8248,39 @@ var DocumentGenerator = {
 
 // src/core/flattenVisuals.ts
 import {
-  clampVisualDpi as clampVisualDpi2,
-  DEFAULT_VISUAL_DPI as DEFAULT_VISUAL_DPI2
+  clampVisualDpi as clampVisualDpi3,
+  DEFAULT_VISUAL_DPI as DEFAULT_VISUAL_DPI3
 } from "@json-to-office/shared";
 var DEFAULT_CONCURRENCY = 4;
-function createLimiter(max) {
-  let active = 0;
-  const queue = [];
-  const release = () => {
-    active--;
-    queue.shift()?.();
-  };
-  return async function limit(fn) {
-    if (active >= max)
-      await new Promise((resolve4) => queue.push(resolve4));
-    active++;
-    try {
-      return await fn();
-    } finally {
-      release();
-    }
-  };
-}
 async function flattenVisuals(doc, options) {
+  let rasterize = options.rasterize;
+  if (options.rasterizeBatch) {
+    const preRasterized = await prerasterizeVisuals(
+      doc,
+      {
+        render: options.rasterize,
+        renderBatch: options.rasterizeBatch,
+        dpi: options.dpi
+      },
+      { baseDir: options.baseDir, concurrency: options.concurrency }
+    ).catch(() => /* @__PURE__ */ new Map());
+    rasterize = async (request) => {
+      const hit = preRasterized.get(
+        visualRasterKey(request.presentation, request.dpi)
+      );
+      if (hit) {
+        if (!hit.ok) throw new Error(hit.error);
+        return {
+          base64DataUri: hit.base64DataUri,
+          width: hit.width,
+          height: hit.height
+        };
+      }
+      return options.rasterize(request);
+    };
+  }
   const ctx = {
-    rasterize: options.rasterize,
+    rasterize,
     dpi: options.dpi,
     baseDir: options.baseDir,
     limit: createLimiter(
@@ -8050,7 +8291,7 @@ async function flattenVisuals(doc, options) {
 }
 async function rasterizeVisual(obj, ctx) {
   const props = obj.props;
-  const dpi = clampVisualDpi2(props.dpi ?? ctx.dpi ?? DEFAULT_VISUAL_DPI2);
+  const dpi = clampVisualDpi3(props.dpi ?? ctx.dpi ?? DEFAULT_VISUAL_DPI3);
   const result = await ctx.limit(
     () => ctx.rasterize({
       presentation: buildVisualPresentation(props),