@json-to-office/core-docx 0.15.0 → 0.16.0

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

@@ -1 +1 @@
-{"version":3,"file":"highcharts.d.ts","sourceRoot":"","sources":["../../src/components/highcharts.ts"],"names":[],"mappings":"AAAA;;;GAGG;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;AASxC,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AA4ED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,mBAAmB,EAC9B,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC,EAAE,CAAC,CA+BhC"}
+{"version":3,"file":"highcharts.d.ts","sourceRoot":"","sources":["../../src/components/highcharts.ts"],"names":[],"mappings":"AAAA;;;GAGG;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;AAUxC,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAwDD;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,mBAAmB,EAC9B,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC,EAAE,CAAC,CA+BhC"}

package/dist/components/index.d.ts

@@ -13,5 +13,6 @@ export { renderColumnsComponent } from './columns';
 export { renderStatisticComponent } from './statistic';
 export { renderTocComponent } from './toc';
 export { renderHighchartsComponent } from './highcharts';
+export { renderVisualComponent } from './visual';
 export { textSpaceAfterComponent } from './text-space-after';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAGzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAGjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/components/visual.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Visual Component
+ *
+ * Renders a free-canvas graphic authored as a single pptx slide and embeds it
+ * as a rasterized PNG. The slide is rendered to an image by an injected
+ * rasterization service (`services.pptx`) — exactly the way the `highcharts`
+ * component offloads chart rendering to an export server — then desugars to a
+ * plain `image`.
+ */
+import { Paragraph, Table } from 'docx';
+import { ComponentDefinition, RenderContext } from '../types';
+import { ThemeConfig } from '../styles';
+import { type ImageOptions } from '../core/content';
+import type { VisualProps } from '@json-to-office/shared-docx';
+/**
+ * Build a single-slide pptx presentation component definition from visual props.
+ * The shape mirrors a normal `.pptx.json` document so the pptx engine renders
+ * it unchanged. Exported for reuse by the `flattenVisuals` transform.
+ */
+export declare function buildVisualPresentation(props: VisualProps): Record<string, unknown>;
+/**
+ * Default rendered width (px) for a visual: its physical canvas inches, so a
+ * 6×4 canvas prints 6×4 unless `width` overrides.
+ */
+export declare function defaultVisualWidthPx(props: VisualProps): number;
+/**
+ * Shared image-placement options derived from a visual's props. Used by BOTH
+ * the render-time createImage call and the flatten transform so the two
+ * desugaring paths can't drift (width default, alignment default, caption,
+ * spacing, floating, keepNext/keepLines all live here once).
+ */
+export declare function visualToImageOptions(props: VisualProps): ImageOptions;
+/**
+ * Map visual props to the `image` props they desugar to (used by the
+ * `flattenVisuals` transform to produce a portable, service-free document).
+ */
+export declare function visualToImageProps(props: VisualProps, base64DataUri: string): Record<string, unknown>;
+/**
+ * Render visual component
+ */
+export declare function renderVisualComponent(component: ComponentDefinition, theme: ThemeConfig, themeName?: string, context?: RenderContext): Promise<(Paragraph | Table)[]>;
+//# sourceMappingURL=visual.d.ts.map

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

@@ -0,0 +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;AAIjE,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;AA0DD;;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,CA2BhC"}

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

@@ -1 +1 @@
-{"version":3,"file":"cached-render.d.ts","sourceRoot":"","sources":["../../src/core/cached-render.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EACL,WAAW,EAIZ,MAAM,UAAU,CAAC;AAmBlB;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CA4BlE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,GAAG,IAAI,CAEtD;AAED;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAIzD;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,mBAAmB,EAC9B,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,EACtB,WAAW,UAAQ,GAClB,OAAO,CAAC,CAAC,SAAS,GAAG,KAAK,GAAG,eAAe,GAAG,OAAO,CAAC,EAAE,CAAC,CAmF5D;AAKD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,KAAK,CAAC;IAChB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,aAAa,CAAC;CACxB,CAAC,GACD,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED;;GAEG;AACH,wBAAgB,sBAAsB,kEAMrC;AAED;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,GAAG,CACvD,MAAM,EACN,OAAO,CACR,GAAG,IAAI,CAAC,CAgBR;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GACzB,OAAO,CAAC,IAAI,CAAC,CAQf"}
+{"version":3,"file":"cached-render.d.ts","sourceRoot":"","sources":["../../src/core/cached-render.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EACL,WAAW,EAIZ,MAAM,UAAU,CAAC;AAmBlB;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CA4BlE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,GAAG,IAAI,CAEtD;AAED;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAIzD;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,mBAAmB,EAC9B,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,EACtB,WAAW,UAAQ,GAClB,OAAO,CAAC,CAAC,SAAS,GAAG,KAAK,GAAG,eAAe,GAAG,OAAO,CAAC,EAAE,CAAC,CAyF5D;AAKD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,KAAK,CAAC;IAChB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,aAAa,CAAC;CACxB,CAAC,GACD,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED;;GAEG;AACH,wBAAgB,sBAAsB,kEAMrC;AAED;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,GAAG,CACvD,MAAM,EACN,OAAO,CACR,GAAG,IAAI,CAAC,CAgBR;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GACzB,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/core/flattenVisuals.d.ts

@@ -0,0 +1,33 @@
+/**
+ * flattenVisuals — desugar `visual` components to plain `image` components ahead
+ * of time, producing a portable, service-free `.docx.json`.
+ *
+ * The normal pipeline rasterizes `visual` nodes at render time via
+ * `services.pptx`. This transform does the same desugaring offline: walk the
+ * document tree, rasterize each `visual` with the supplied rasterizer, and
+ * replace it with `{ name: 'image', props: { base64, ... } }`. The result builds
+ * with no rasterization service configured — handy for shipping documents that
+ * generate on hosts without LibreOffice/poppler.
+ *
+ * The walk covers every place the docx model can hold a child component, not
+ * 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';
+export interface FlattenVisualsOptions {
+    /** Rasterizer that turns a single-slide pptx presentation into a PNG. */
+    rasterize: PptxRasterizer;
+    /** Default DPI applied when a `visual` does not specify one (default 200). */
+    dpi?: number;
+    /** Max concurrent rasterizations (default 4). */
+    concurrency?: number;
+}
+/**
+ * Return a deep copy of `doc` with every `visual` node replaced by the `image`
+ * node it rasterizes to. Visuals rasterize 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.
+ */
+export declare function flattenVisuals<T = unknown>(doc: T, options: FlattenVisualsOptions): Promise<T>;
+//# sourceMappingURL=flattenVisuals.d.ts.map

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

@@ -0,0 +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;CACtB;AA4BD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,CAAC,GAAG,OAAO,EAC9C,GAAG,EAAE,CAAC,EACN,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,CAAC,CAAC,CASZ"}

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,EACf,eAAe,EAKf,OAAO,EACR,MAAM,MAAM,CAAC;AAad,OAAO,EACL,mBAAmB,EACnB,aAAa,EAcd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAMxC,OAAO,EAAE,iBAAiB,EAAuB,MAAM,aAAa,CAAC;AACrE,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;AAmC7D;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE;IACR,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B,GACA,OAAO,CAAC,QAAQ,CAAC,CAwJnB;AAwND;;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,GACtB,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,CAiC5D"}
+{"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,EACf,eAAe,EAKf,OAAO,EACR,MAAM,MAAM,CAAC;AAad,OAAO,EACL,mBAAmB,EACnB,aAAa,EAed,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAMxC,OAAO,EAAE,iBAAiB,EAAuB,MAAM,aAAa,CAAC;AACrE,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;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE;IACR,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B,GACA,OAAO,CAAC,QAAQ,CAAC,CAwJnB;AAiOD;;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,GACtB,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.d.ts

@@ -1,8 +1,9 @@
 export declare function getCoreVersion(): string;
 export { generateDocument, generateFromConfig, generateDocumentFromJson, generateDocumentFromFile, generateBufferFromJson, generateBufferFromFile, generateAndSaveFromJson, generateAndSaveFromFile, validateJsonSchema, isReportComponentDefinition, saveDocument, generateAndSave, DocumentGenerator as CoreDocumentGenerator, } from './core/generator';
+export { flattenVisuals, type FlattenVisualsOptions, } from './core/flattenVisuals';
 export { MemoryCache, CacheKeyGenerator, DEFAULT_CACHE_CONFIG, getCacheConfigFromEnv, mergeConfigs, ComponentCacheAnalytics, type CacheConfiguration, type CachedComponent, type CacheStatistics, type CacheKeyOptions, type CacheEvents, type CacheAnalyticsReport, type ComponentPerformanceMetrics, type ComponentCacheTrends, type CacheOptimizationRecommendation, type TimeSeriesPoint, } from './cache/index';
 export { initializeComponentCache, getComponentCache, clearComponentCache, getComponentCacheStats, warmComponentCache, } from './core/cached-render';
-export { isReportComponent, isSectionComponent, isHeadingComponent, isParagraphComponent, isColumnsComponent, isImageComponent, isStatisticComponent, isTableComponent, isListComponent, isHighchartsComponent, } from './types/index';
+export { isReportComponent, isSectionComponent, isHeadingComponent, isParagraphComponent, isColumnsComponent, isImageComponent, isStatisticComponent, isTableComponent, isListComponent, isHighchartsComponent, isVisualComponent, } from './types/index';
 export type { ImageContent, StatisticContent, TableData, SectionProperties, ColumnSettings, PageSizeOptions, PageMarginOptions, PageNumberOptions, PageBorderOptions, RenderContext, } from './types/index';
 export * from './utils/formatters';
 export { parseTextWithDecorators } from './utils/textParser';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1954,7 +1954,8 @@ import {
   isTableComponent,
   isListComponent,
   isTocComponent,
-  isHighchartsComponent
+  isHighchartsComponent,
+  isVisualComponent
 } from "@json-to-office/shared-docx";
 
 // src/core/generator.ts
@@ -2050,6 +2051,9 @@ function resolveListProps(props, theme) {
 function resolveHighchartsProps(props, _theme) {
   return props;
 }
+function resolveVisualProps(props, _theme) {
+  return props;
+}
 function getCustomComponentDefaults(theme, componentName) {
   const defaults = getComponentDefaults(theme);
   return defaults?.[componentName] || {};
@@ -2079,7 +2083,8 @@ var RESOLVER_MAP = {
   section: resolveSectionProps,
   columns: resolveColumnsProps,
   list: resolveListProps,
-  highcharts: resolveHighchartsProps
+  highcharts: resolveHighchartsProps,
+  visual: resolveVisualProps
 };
 function resolveComponentDefaults(component, theme) {
   if (!component.props) return component;
@@ -4068,7 +4073,7 @@ async function clearComponentCache() {
   }
 }
 async function renderComponentWithCache(component, theme, themeName, context, bypassCache = false) {
-  const forceBypassForType = component.name === "toc" || component.name === "section" || componentHasRevision(component);
+  const forceBypassForType = component.name === "toc" || component.name === "section" || component.name === "visual" || componentHasRevision(component);
   if (!componentCache) {
     initializeComponentCache();
   }
@@ -6350,21 +6355,61 @@ function hasNodeBuiltins() {
   }
 }
 
+// src/utils/serviceClient.ts
+var DEFAULT_TIMEOUT_MS = 3e4;
+function resolveServiceUrl(propsUrl, servicesUrl, defaultUrl) {
+  const raw = (propsUrl || servicesUrl || defaultUrl).trim();
+  const withScheme = /^https?:\/\//i.test(raw) ? raw : `http://${raw}`;
+  return withScheme.replace(/\/+$/, "");
+}
+async function postJsonToService(opts) {
+  const resolvedHeaders = typeof opts.headers === "function" ? await opts.headers(opts.body) : opts.headers;
+  const headers = {
+    "Content-Type": "application/json",
+    ...resolvedHeaders
+  };
+  const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  let response;
+  try {
+    response = await fetch(`${opts.url}${opts.path}`, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(opts.body),
+      signal: controller.signal
+    });
+  } catch (error) {
+    if (error?.name === "AbortError") {
+      throw new Error(
+        `${opts.serviceLabel} timed out after ${timeoutMs}ms at ${opts.url}.`
+      );
+    }
+    const cause = error instanceof Error ? error.message : String(error);
+    throw new Error(opts.onUnreachable(opts.url, cause));
+  } finally {
+    clearTimeout(timer);
+  }
+  if (!response.ok) {
+    throw new Error(
+      `${opts.serviceLabel} returned ${response.status}: ${response.statusText}`
+    );
+  }
+  return response;
+}
+
 // src/components/highcharts.ts
 var DEFAULT_EXPORT_SERVER_URL = "http://localhost:7801";
-function getExportServerUrl(propsUrl, servicesUrl) {
-  const raw = propsUrl || servicesUrl || DEFAULT_EXPORT_SERVER_URL;
-  return raw.startsWith("http") ? raw : `http://${raw}`;
-}
 async function generateChart(config, servicesConfig) {
   if (!isNodeEnvironment()) {
     throw new Error(
       "Highcharts export server requires a Node.js environment. Chart generation is not available in browser environments."
     );
   }
-  const serverUrl = getExportServerUrl(
+  const serverUrl = resolveServiceUrl(
     config.serverUrl,
-    servicesConfig?.serverUrl
+    servicesConfig?.serverUrl,
+    DEFAULT_EXPORT_SERVER_URL
   );
   const requestBody = {
     infile: config.options,
@@ -6372,26 +6417,15 @@ async function generateChart(config, servicesConfig) {
     b64: true,
     scale: config.scale
   };
-  const resolvedHeaders = typeof servicesConfig?.headers === "function" ? await servicesConfig.headers(requestBody) : servicesConfig?.headers;
-  const headers = {
-    "Content-Type": "application/json",
-    ...resolvedHeaders
-  };
-  const response = await fetch(`${serverUrl}/export`, {
-    method: "POST",
-    headers,
-    body: JSON.stringify(requestBody)
-  }).catch((error) => {
-    throw new Error(
-      `Highcharts Export Server is not running at ${serverUrl}. Start it with: npx highcharts-export-server --enableServer true
-Cause: ${error instanceof Error ? error.message : String(error)}`
-    );
+  const response = await postJsonToService({
+    url: serverUrl,
+    path: "/export",
+    body: requestBody,
+    headers: servicesConfig?.headers,
+    serviceLabel: "Highcharts export server",
+    onUnreachable: (url, cause) => `Highcharts Export Server is not running at ${url}. Start it with: npx highcharts-export-server --enableServer true
+Cause: ${cause}`
   });
-  if (!response.ok) {
-    throw new Error(
-      `Highcharts export server returned ${response.status}: ${response.statusText}`
-    );
-  }
   const base64Data = await response.text();
   const base64DataUri = `data:image/png;base64,${base64Data}`;
   const width = config.options.chart.width;
@@ -6425,6 +6459,116 @@ async function renderHighchartsComponent(component, theme, themeName, context) {
   return imageParagraphs;
 }
 
+// src/components/visual.ts
+import {
+  clampVisualDpi,
+  DEFAULT_VISUAL_DPI
+} from "@json-to-office/shared";
+var DEFAULT_RASTERIZE_SERVER_URL = "http://localhost:7802";
+var PIXELS_PER_INCH = 96;
+function buildVisualPresentation(props) {
+  const { canvas, elements } = props;
+  const presentationProps = {
+    slideWidth: canvas.width,
+    slideHeight: canvas.height
+  };
+  if (canvas.theme) presentationProps.theme = canvas.theme;
+  const slideProps = {};
+  if (canvas.background) slideProps.background = canvas.background;
+  return {
+    name: "pptx",
+    props: presentationProps,
+    children: [
+      {
+        name: "slide",
+        props: slideProps,
+        children: elements ?? []
+      }
+    ]
+  };
+}
+function defaultVisualWidthPx(props) {
+  return Math.round(props.canvas.width * PIXELS_PER_INCH);
+}
+function visualToImageOptions(props) {
+  return {
+    width: props.width ?? defaultVisualWidthPx(props),
+    ...props.height !== void 0 && { height: props.height },
+    alignment: props.alignment ?? "center",
+    ...props.caption !== void 0 && { caption: props.caption },
+    ...props.spacing !== void 0 && { spacing: props.spacing },
+    ...props.floating !== void 0 && { floating: props.floating },
+    ...props.keepNext !== void 0 && { keepNext: props.keepNext },
+    ...props.keepLines !== void 0 && { keepLines: props.keepLines }
+  };
+}
+function visualToImageProps(props, base64DataUri) {
+  return {
+    base64: base64DataUri,
+    ...visualToImageOptions(props),
+    ...props.alt !== void 0 && { alt: props.alt }
+  };
+}
+async function rasterize(presentation, dpi, propsServerUrl, serviceConfig) {
+  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 });
+  }
+  const serverUrl = resolveServiceUrl(
+    propsServerUrl,
+    serviceConfig?.serverUrl,
+    DEFAULT_RASTERIZE_SERVER_URL
+  );
+  const response = await postJsonToService({
+    url: serverUrl,
+    path: "/rasterize",
+    body: { presentation, dpi },
+    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\`.
+Cause: ${cause}`
+  });
+  let result;
+  try {
+    result = await response.json();
+  } catch {
+    throw new Error(
+      "PPTX rasterization service returned a non-JSON response (expected { base64DataUri, width, height })."
+    );
+  }
+  if (!result?.base64DataUri) {
+    throw new Error(
+      "PPTX rasterization service returned a malformed response (missing base64DataUri)."
+    );
+  }
+  return result;
+}
+async function renderVisualComponent(component, theme, themeName, context) {
+  if (!isVisualComponent(component)) return [];
+  const props = component.props;
+  const serviceConfig = context?.services?.pptx;
+  const presentation = buildVisualPresentation(props);
+  const dpi = clampVisualDpi(
+    props.dpi ?? serviceConfig?.dpi ?? DEFAULT_VISUAL_DPI
+  );
+  const result = await rasterize(
+    presentation,
+    dpi,
+    props.serverUrl,
+    serviceConfig
+  );
+  return await createImage(
+    result.base64DataUri,
+    theme,
+    themeName,
+    visualToImageOptions(props)
+  );
+}
+
 // src/components/text-space-after.ts
 import { Type } from "@sinclair/typebox";
 
@@ -6581,7 +6725,7 @@ async function renderDocument(structure, layout, options) {
     }
   });
 }
-async function renderHeaderFooterComponents(components, theme, themeName, _context) {
+async function renderHeaderFooterComponents(components, theme, themeName, context) {
   if (!components || components.length === 0) {
     return [];
   }
@@ -6713,6 +6857,14 @@ async function renderHeaderFooterComponents(components, theme, themeName, _conte
     } else if (isTableComponent(component)) {
       const tables = await renderTableComponent(component, theme, themeName);
       elements.push(...tables);
+    } else if (isVisualComponent(component)) {
+      const visualEls = await renderVisualComponent(
+        component,
+        theme,
+        themeName,
+        context
+      );
+      elements.push(...visualEls);
     }
   }
   return elements;
@@ -6833,6 +6985,8 @@ async function renderComponent(component, theme, themeName, context) {
       themeName,
       context
     );
+  } else if (isVisualComponent(component)) {
+    return await renderVisualComponent(component, theme, themeName, context);
   } else if (isSectionComponent(component)) {
     return await renderSectionComponent(component, theme, themeName, context);
   }
@@ -7204,6 +7358,112 @@ var DocumentGenerator = {
   isReportComponentDefinition
 };
 
+// src/core/flattenVisuals.ts
+import {
+  clampVisualDpi as clampVisualDpi2,
+  DEFAULT_VISUAL_DPI as DEFAULT_VISUAL_DPI2
+} 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((resolve2) => queue.push(resolve2));
+    active++;
+    try {
+      return await fn();
+    } finally {
+      release();
+    }
+  };
+}
+async function flattenVisuals(doc, options) {
+  const ctx = {
+    rasterize: options.rasterize,
+    dpi: options.dpi,
+    limit: createLimiter(
+      Math.max(1, options.concurrency ?? DEFAULT_CONCURRENCY)
+    )
+  };
+  return await flattenNode(doc, ctx);
+}
+async function rasterizeVisual(obj, ctx) {
+  const props = obj.props;
+  const dpi = clampVisualDpi2(props.dpi ?? ctx.dpi ?? DEFAULT_VISUAL_DPI2);
+  const result = await ctx.limit(
+    () => ctx.rasterize({ presentation: buildVisualPresentation(props), dpi })
+  );
+  const image = {
+    name: "image",
+    props: visualToImageProps(props, result.base64DataUri)
+  };
+  if (obj.id !== void 0) image.id = obj.id;
+  if (obj.enabled !== void 0) image.enabled = obj.enabled;
+  return image;
+}
+async function flattenNode(node, ctx) {
+  if (Array.isArray(node)) {
+    return Promise.all(node.map((n) => flattenNode(n, ctx)));
+  }
+  if (!node || typeof node !== "object") return node;
+  const obj = node;
+  if (obj.name === "visual" && obj.props && obj.enabled !== false) {
+    return rasterizeVisual(obj, ctx);
+  }
+  const next = { ...obj };
+  if (Array.isArray(obj.children)) {
+    next.children = await flattenNode(obj.children, ctx);
+  }
+  if (obj.props && typeof obj.props === "object") {
+    const props = obj.props;
+    let propsChanged = false;
+    const nextProps = { ...props };
+    for (const key of ["header", "footer"]) {
+      if (Array.isArray(props[key])) {
+        nextProps[key] = await flattenNode(props[key], ctx);
+        propsChanged = true;
+      }
+    }
+    if (Array.isArray(props.columns)) {
+      nextProps.columns = await Promise.all(
+        props.columns.map((col) => flattenColumn(col, ctx))
+      );
+      propsChanged = true;
+    }
+    if (propsChanged) next.props = nextProps;
+  }
+  return next;
+}
+async function flattenColumn(col, ctx) {
+  if (!col || typeof col !== "object") return col;
+  const column = col;
+  const nextCol = { ...column };
+  const header = column.header;
+  if (header && typeof header === "object" && "content" in header) {
+    nextCol.header = {
+      ...header,
+      content: await flattenNode(header.content, ctx)
+    };
+  }
+  if (Array.isArray(column.cells)) {
+    nextCol.cells = await Promise.all(
+      column.cells.map(async (cell) => {
+        if (cell && typeof cell === "object" && "content" in cell) {
+          const c = cell;
+          return { ...c, content: await flattenNode(c.content, ctx) };
+        }
+        return cell;
+      })
+    );
+  }
+  return nextCol;
+}
+
 // src/utils/warningsDocument.ts
 function generateWarningsDocument(warnings) {
   if (!warnings || warnings.length === 0) {
@@ -8023,6 +8283,7 @@ export {
   examples,
   exportPluginSchema,
   exportThemeToJson,
+  flattenVisuals,
   formatDate,
   formatWarningsText,
   generateAndSave,
@@ -8057,6 +8318,7 @@ export {
   isSectionComponent,
   isStatisticComponent,
   isTableComponent,
+  isVisualComponent,
   loadJsonExample,
   loadThemeFromFile,
   loadThemeFromJson,