docgen-utils 1.0.5

package/dist/packages/slides/convert.js

@@ -0,0 +1,308 @@
+/**
+ * Convert parsed slide data into PptxGenJS slide elements.
+ *
+ * This is a faithful TypeScript port of the `addBackground()`, `addElements()`,
+ * and `fetchImageAsDataUrl()` functions from `dist/html2pptx.js`.
+ *
+ * It consumes the intermediate representation defined in `./common.ts` and calls
+ * the PptxGenJS Slide API to render backgrounds, images, shapes, text, and lists.
+ */
+// ---------------------------------------------------------------------------
+// fetchImageAsDataUrl
+// ---------------------------------------------------------------------------
+/**
+ * Download an external image and convert it to a base64 data URL using fetch.
+ *
+ * Throws on network errors or non-OK responses.
+ */
+export async function fetchImageAsDataUrl(url) {
+    try {
+        const response = await fetch(url, { mode: 'cors' });
+        if (!response.ok) {
+            throw new Error(`Failed to fetch image: ${response.status}`);
+        }
+        const blob = await response.blob();
+        return new Promise((resolve, reject) => {
+            const reader = new FileReader();
+            reader.onloadend = () => resolve(reader.result);
+            reader.onerror = reject;
+            reader.readAsDataURL(blob);
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to fetch image ${url}: ${message}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// applyBackground
+// ---------------------------------------------------------------------------
+/**
+ * Apply a slide background (color, gradient, or image) to a PptxGenJS Slide.
+ */
+export async function applyBackground(background, slide) {
+    if (background.type === 'image' && background.path) {
+        // Fetch the image and convert to data URL
+        try {
+            const dataUrl = await fetchImageAsDataUrl(background.path);
+            slide.background = { data: dataUrl };
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : String(e);
+            console.warn('Could not load background image:', message);
+        }
+    }
+    else if (background.type === 'gradient' && background.gradient) {
+        slide.background = {
+            type: 'gradient',
+            gradient: background.gradient,
+        };
+    }
+    else if (background.type === 'color' && background.value) {
+        slide.background = { color: background.value };
+    }
+}
+// ---------------------------------------------------------------------------
+// addElementsToSlide
+// ---------------------------------------------------------------------------
+/**
+ * Resolve an image source to a PptxGenJS-compatible `{ data: string }` object.
+ *
+ * Data URIs are used directly. External/relative URLs are fetched and converted
+ * to data URLs via {@link fetchImageAsDataUrl}.
+ *
+ * Returns `null` when the fetch fails (e.g. CORS), allowing the caller to skip
+ * the image with a warning.
+ */
+async function getImageSource(src) {
+    if (src.startsWith('data:')) {
+        return { data: src };
+    }
+    else {
+        try {
+            const dataUrl = await fetchImageAsDataUrl(src);
+            return { data: dataUrl };
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : String(e);
+            console.warn(`Could not fetch image ${src}: ${message}`);
+            return null;
+        }
+    }
+}
+/**
+ * Add all slide elements to a PptxGenJS Slide.
+ *
+ * Performs TWO passes over the elements array:
+ *   1. First pass  - adds `slideBackgroundImage` elements (rendered behind everything).
+ *   2. Second pass - adds all other element types (image, backgroundImage, line, shape, list, text).
+ *
+ * @param elements - The parsed slide elements array.
+ * @param slide    - The target PptxGenJS Slide instance.
+ * @param pres     - The PptxGenJS presentation instance (needed for `pres.ShapeType`).
+ *                   Typed as `any` because `ShapeType` is a runtime property.
+ */
+export async function addElementsToSlide(elements, slide, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+pres) {
+    // ---- First pass: slide background images ----
+    for (const el of elements) {
+        if (el.type === 'slideBackgroundImage') {
+            const imgSrc = await getImageSource(el.src);
+            if (!imgSrc) {
+                console.warn(`Skipping slide background image (CORS failure): ${el.src}`);
+                continue;
+            }
+            const imageOptions = {
+                ...imgSrc,
+                x: el.position.x,
+                y: el.position.y,
+                w: el.position.w,
+                h: el.position.h,
+            };
+            if (el.sizing && el.sizing.type) {
+                imageOptions.sizing = { type: el.sizing.type, w: el.position.w, h: el.position.h };
+            }
+            slide.addImage(imageOptions);
+        }
+    }
+    // ---- Second pass: all other elements ----
+    for (const el of elements) {
+        if (el.type === 'slideBackgroundImage') {
+            continue;
+        }
+        else if (el.type === 'image') {
+            const imgSrc = await getImageSource(el.src);
+            if (!imgSrc) {
+                console.warn(`Skipping image (CORS failure): ${el.src}`);
+                continue;
+            }
+            const imageOptions = {
+                ...imgSrc,
+                x: el.position.x,
+                y: el.position.y,
+                w: el.position.w,
+                h: el.position.h,
+            };
+            if (el.sizing && el.sizing.type) {
+                imageOptions.sizing = { type: el.sizing.type, w: el.position.w, h: el.position.h };
+            }
+            if (el.rectRadius) {
+                imageOptions.rectRadius = el.rectRadius;
+            }
+            slide.addImage(imageOptions);
+        }
+        else if (el.type === 'backgroundImage') {
+            const imgSrc = await getImageSource(el.src);
+            if (!imgSrc) {
+                console.warn(`Skipping background image (CORS failure): ${el.src}`);
+                continue;
+            }
+            const imageOptions = {
+                ...imgSrc,
+                x: el.position.x,
+                y: el.position.y,
+                w: el.position.w,
+                h: el.position.h,
+            };
+            if (el.sizing && el.sizing.type) {
+                imageOptions.sizing = { type: el.sizing.type, w: el.position.w, h: el.position.h };
+            }
+            slide.addImage(imageOptions);
+        }
+        else if (el.type === 'line') {
+            slide.addShape(pres.ShapeType.line, {
+                x: el.x1,
+                y: el.y1,
+                w: el.x2 - el.x1,
+                h: el.y2 - el.y1,
+                line: { color: el.color, width: el.width },
+            });
+        }
+        else if (el.type === 'shape') {
+            const shapeOptions = {
+                x: el.position.x,
+                y: el.position.y,
+                w: el.position.w,
+                h: el.position.h,
+                shape: el.shape.rectRadius > 0 ? pres.ShapeType.roundRect : pres.ShapeType.rect,
+            };
+            if (el.shape.gradient) {
+                shapeOptions.fill = { type: 'gradient', gradient: el.shape.gradient };
+            }
+            else if (el.shape.fill) {
+                shapeOptions.fill = { color: el.shape.fill };
+                if (el.shape.transparency != null)
+                    shapeOptions.fill.transparency = el.shape.transparency;
+            }
+            if (el.shape.line)
+                shapeOptions.line = el.shape.line;
+            if (el.shape.rectRadius > 0)
+                shapeOptions.rectRadius = el.shape.rectRadius;
+            if (el.shape.shadow)
+                shapeOptions.shadow = el.shape.shadow;
+            if (el.style) {
+                if (el.style.fontSize)
+                    shapeOptions.fontSize = el.style.fontSize;
+                if (el.style.fontFace)
+                    shapeOptions.fontFace = el.style.fontFace;
+                if (el.style.color)
+                    shapeOptions.color = el.style.color;
+                if (el.style.bold)
+                    shapeOptions.bold = el.style.bold;
+                if (el.style.align)
+                    shapeOptions.align = el.style.align;
+                if (el.style.valign)
+                    shapeOptions.valign = el.style.valign;
+                if (el.style.fontFill)
+                    shapeOptions.fontFill = el.style.fontFill;
+                if (el.style.margin)
+                    shapeOptions.margin = el.style.margin;
+                if (el.style.inset !== undefined)
+                    shapeOptions.inset = el.style.inset;
+                if (el.style.wrap !== undefined)
+                    shapeOptions.wrap = el.style.wrap;
+            }
+            if (el.textRuns && el.textRuns.length > 0) {
+                slide.addText(el.textRuns, shapeOptions);
+            }
+            else {
+                slide.addText(el.text || '', shapeOptions);
+            }
+        }
+        else if (el.type === 'list') {
+            const listOptions = {
+                x: el.position.x,
+                y: el.position.y,
+                w: el.position.w,
+                h: el.position.h,
+                fontSize: el.style.fontSize,
+                fontFace: el.style.fontFace,
+                color: el.style.color ?? undefined,
+                align: el.style.align,
+                valign: 'top',
+                lineSpacing: el.style.lineSpacing,
+                paraSpaceBefore: el.style.paraSpaceBefore,
+                paraSpaceAfter: el.style.paraSpaceAfter,
+                margin: el.style.margin,
+            };
+            if (el.style.margin)
+                listOptions.margin = el.style.margin;
+            slide.addText(el.items, listOptions);
+        }
+        else {
+            // Text elements: p, h1-h6
+            const lineHeightPt = el.style.lineSpacing || ((el.style.fontSize ?? 0) * 1.2);
+            const isSingleLine = el.position.h <= lineHeightPt * 1.5;
+            let adjustedX = el.position.x;
+            let adjustedW = el.position.w;
+            if (isSingleLine) {
+                const widthIncrease = el.position.w * 0.02;
+                const align = el.style.align;
+                if (align === 'center') {
+                    adjustedX = el.position.x - (widthIncrease / 2);
+                    adjustedW = el.position.w + widthIncrease;
+                }
+                else if (align === 'right') {
+                    adjustedX = el.position.x - widthIncrease;
+                    adjustedW = el.position.w + widthIncrease;
+                }
+                else {
+                    adjustedW = el.position.w + widthIncrease;
+                }
+            }
+            const textOptions = {
+                x: adjustedX,
+                y: el.position.y,
+                w: adjustedW,
+                h: el.position.h,
+                fontSize: el.style.fontSize,
+                fontFace: el.style.fontFace,
+                color: el.style.color ?? undefined,
+                bold: el.style.bold,
+                italic: el.style.italic,
+                underline: el.style.underline,
+                valign: el.style.valign || 'top',
+                lineSpacing: el.style.lineSpacing,
+                paraSpaceBefore: el.style.paraSpaceBefore,
+                paraSpaceAfter: el.style.paraSpaceAfter,
+                inset: 0,
+            };
+            if (el.style.align)
+                textOptions.align = el.style.align;
+            if (el.style.margin)
+                textOptions.margin = el.style.margin;
+            if (el.style.rotate !== undefined)
+                textOptions.rotate = el.style.rotate;
+            if (el.style.transparency !== null && el.style.transparency !== undefined) {
+                textOptions.transparency = el.style.transparency;
+            }
+            if (el.style.fontFill) {
+                textOptions.fontFill = el.style.fontFill;
+                delete textOptions.color;
+            }
+            slide.addText(el.text, textOptions);
+        }
+    }
+}
+//# sourceMappingURL=convert.js.map

package/dist/packages/slides/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../../packages/slides/convert.ts"],"names":[],"mappings":"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"}

package/dist/packages/slides/createPresentation.d.ts

@@ -0,0 +1,51 @@
+/**
+ * createPresentation.ts - Assembly module that ties parse → convert together.
+ *
+ * This module mirrors the `html2pptx()` function from dist/html2pptx.js,
+ * using the typed parse and convert layers instead of the monolithic JS.
+ *
+ * Exports:
+ * - `addSlideFromHtml()` — convert a single HTML slide to a PptxGenJS slide
+ * - `createPresentation()` — convert multiple HTML strings into a full PPTX
+ */
+import type { Placeholder } from './common';
+export interface CreatePresentationOptions {
+    title?: string;
+    author?: string;
+    company?: string;
+    subject?: string;
+    /** PptxGenJS layout name. Defaults to 'LAYOUT_16x9'. */
+    layout?: string;
+}
+export interface SlideResult {
+    /** The PptxGenJS Slide object. */
+    slide: any;
+    /** Placeholder regions extracted from the HTML. */
+    placeholders: Placeholder[];
+}
+/**
+ * Convert a single HTML slide (already in a browser DOM context) to a PptxGenJS slide.
+ * This mirrors the `html2pptx()` function from the original JS.
+ *
+ * If `source` is a string, creates a temporary iframe, loads it, and parses.
+ * If `source` is a Document, parses directly.
+ * If `source` is an HTMLIFrameElement, uses its contentDocument.
+ */
+export declare function addSlideFromHtml(source: Document | HTMLIFrameElement | string, pres: any, // PptxGenJS instance
+options?: {
+    slide?: any;
+}): Promise<SlideResult>;
+/**
+ * Convert multiple HTML strings into a complete PPTX presentation.
+ * Each HTML string becomes one slide.
+ *
+ * @param htmlSlides - Array of complete HTML strings, one per slide.
+ * @param PptxGenJS  - The PptxGenJS constructor (passed in so this module
+ *                     stays free of hard dependencies on the vendor bundle).
+ * @param options    - Optional presentation metadata and layout.
+ * @returns The PptxGenJS presentation instance, ready for `.write()` or
+ *          `.writeFile()`.
+ */
+export declare function createPresentation(htmlSlides: string[], PptxGenJS: any, // The PptxGenJS constructor
+options?: CreatePresentationOptions): Promise<any>;
+//# sourceMappingURL=createPresentation.d.ts.map

package/dist/packages/slides/createPresentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPresentation.d.ts","sourceRoot":"","sources":["../../../packages/slides/createPresentation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,WAAW,EAKZ,MAAM,UAAU,CAAC;AAgBlB,MAAM,WAAW,yBAAyB;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAElC,KAAK,EAAE,GAAG,CAAC;IACX,mDAAmD;IACnD,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AA6LD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,QAAQ,GAAG,iBAAiB,GAAG,MAAM,EAE7C,IAAI,EAAE,GAAG,EAAE,qBAAqB;AAChC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,GAAG,CAAA;CAAO,GAC5B,OAAO,CAAC,WAAW,CAAC,CA8EtB;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAAE,EAEpB,SAAS,EAAE,GAAG,EAAE,4BAA4B;AAC5C,OAAO,GAAE,yBAA8B,GAEtC,OAAO,CAAC,GAAG,CAAC,CAuBd"}

package/dist/packages/slides/createPresentation.js

@@ -0,0 +1,265 @@
+/**
+ * createPresentation.ts - Assembly module that ties parse → convert together.
+ *
+ * This module mirrors the `html2pptx()` function from dist/html2pptx.js,
+ * using the typed parse and convert layers instead of the monolithic JS.
+ *
+ * Exports:
+ * - `addSlideFromHtml()` — convert a single HTML slide to a PptxGenJS slide
+ * - `createPresentation()` — convert multiple HTML strings into a full PPTX
+ */
+import { parseSlideHtml } from './parse';
+import { applyBackground, addElementsToSlide } from './convert';
+// ---------------------------------------------------------------------------
+// Constants (same as html2pptx.js)
+// ---------------------------------------------------------------------------
+const PT_PER_PX = 0.75;
+const PX_PER_IN = 96;
+const EMU_PER_IN = 914400;
+/**
+ * Read the <body> computed size and check for content overflow.
+ * Returns dimensions (in CSS px) plus any overflow error messages.
+ */
+function getBodyDimensions(doc) {
+    const body = doc.body;
+    const style = doc.defaultView.getComputedStyle(body);
+    const width = parseFloat(style.width);
+    const height = parseFloat(style.height);
+    const scrollWidth = body.scrollWidth;
+    const scrollHeight = body.scrollHeight;
+    const errors = [];
+    // Skip overflow check if body has overflow:hidden — the content is
+    // intentionally clipped (decorative elements positioned outside the
+    // viewport should not trigger validation errors).
+    const overflow = style.overflow;
+    const overflowX = style.overflowX;
+    const overflowY = style.overflowY;
+    const isHidden = overflow === 'hidden' || (overflowX === 'hidden' && overflowY === 'hidden');
+    if (!isHidden) {
+        const widthOverflowPx = Math.max(0, scrollWidth - width - 1);
+        const heightOverflowPx = Math.max(0, scrollHeight - height - 1);
+        const widthOverflowPt = widthOverflowPx * PT_PER_PX;
+        const heightOverflowPt = heightOverflowPx * PT_PER_PX;
+        // Allow small overflow tolerance (up to 5pt) to handle minor rendering differences
+        const overflowTolerancePt = 5;
+        if (widthOverflowPt > overflowTolerancePt || heightOverflowPt > overflowTolerancePt) {
+            const directions = [];
+            if (widthOverflowPt > overflowTolerancePt) {
+                directions.push(`${widthOverflowPt.toFixed(1)}pt horizontally`);
+            }
+            if (heightOverflowPt > overflowTolerancePt) {
+                directions.push(`${heightOverflowPt.toFixed(1)}pt vertically`);
+            }
+            const reminder = heightOverflowPt > overflowTolerancePt
+                ? ' (Remember: leave 0.5" margin at bottom of slide)'
+                : '';
+            errors.push(`HTML content overflows body by ${directions.join(' and ')}${reminder}`);
+        }
+    }
+    return { width, height, scrollWidth, scrollHeight, errors };
+}
+/**
+ * Validate that the HTML body dimensions match the PptxGenJS presentation layout.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function validateDimensions(bodyDimensions, pres) {
+    const errors = [];
+    const widthInches = bodyDimensions.width / PX_PER_IN;
+    const heightInches = bodyDimensions.height / PX_PER_IN;
+    if (pres.presLayout) {
+        const layoutWidth = pres.presLayout.width / EMU_PER_IN;
+        const layoutHeight = pres.presLayout.height / EMU_PER_IN;
+        if (Math.abs(layoutWidth - widthInches) > 0.1 ||
+            Math.abs(layoutHeight - heightInches) > 0.1) {
+            errors.push(`HTML dimensions (${widthInches.toFixed(1)}" × ${heightInches.toFixed(1)}") ` +
+                `don't match presentation layout (${layoutWidth.toFixed(1)}" × ${layoutHeight.toFixed(1)}")`);
+        }
+    }
+    return errors;
+}
+/**
+ * Validate that text boxes do not end too close to the bottom of the slide.
+ * Text elements with fontSize > 12pt must leave at least 0.5" of bottom margin.
+ */
+function validateTextBoxPosition(slideData, bodyDimensions) {
+    const errors = [];
+    const slideHeightInches = bodyDimensions.height / PX_PER_IN;
+    const minBottomMargin = 0.5;
+    const epsilon = 0.01;
+    const textTypes = new Set(['p', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'list']);
+    for (const el of slideData.elements) {
+        if (!textTypes.has(el.type))
+            continue;
+        // At this point el is a TextElement or ListElement (all have position & style)
+        const textEl = el;
+        const fontSize = textEl.style?.fontSize || 0;
+        const bottomEdge = textEl.position.y + textEl.position.h;
+        const distanceFromBottom = slideHeightInches - bottomEdge;
+        if (fontSize > 12 && distanceFromBottom < minBottomMargin - epsilon) {
+            const getText = () => {
+                if ('text' in textEl) {
+                    if (typeof textEl.text === 'string')
+                        return textEl.text;
+                    if (Array.isArray(textEl.text))
+                        return textEl.text.find((t) => t.text)?.text || '';
+                }
+                if ('items' in textEl && Array.isArray(textEl.items))
+                    return textEl.items.find((item) => item.text)?.text || '';
+                return '';
+            };
+            const rawText = getText();
+            const textPrefix = rawText.substring(0, 50) + (rawText.length > 50 ? '...' : '');
+            errors.push(`Text box "${textPrefix}" ends too close to bottom edge ` +
+                `(${distanceFromBottom.toFixed(2)}" from bottom, minimum ${minBottomMargin}" required)`);
+        }
+    }
+    return errors;
+}
+// ---------------------------------------------------------------------------
+// Iframe creation helper (ported from html2pptx.js lines 1466-1490)
+// ---------------------------------------------------------------------------
+/**
+ * Create a hidden iframe, load the given HTML string via a blob URL,
+ * wait for it to load (or 500ms timeout), and return the iframe and
+ * its content document.
+ */
+async function createIframeFromHtml(html) {
+    const iframe = document.createElement('iframe');
+    iframe.style.cssText =
+        'position:absolute;left:-9999px;width:960px;height:540px;border:none;';
+    const blob = new Blob([html], { type: 'text/html' });
+    const blobUrl = URL.createObjectURL(blob);
+    iframe.src = blobUrl;
+    document.body.appendChild(iframe);
+    // Wait for iframe to load
+    await new Promise((resolve) => {
+        let resolved = false;
+        const resolveOnce = () => {
+            if (resolved)
+                return;
+            resolved = true;
+            URL.revokeObjectURL(blobUrl);
+            resolve();
+        };
+        iframe.onload = resolveOnce;
+        // Fallback timeout in case onload doesn't fire
+        setTimeout(resolveOnce, 500);
+    });
+    const doc = iframe.contentDocument || iframe.contentWindow.document;
+    return { iframe, doc };
+}
+// ---------------------------------------------------------------------------
+// addSlideFromHtml
+// ---------------------------------------------------------------------------
+/**
+ * Convert a single HTML slide (already in a browser DOM context) to a PptxGenJS slide.
+ * This mirrors the `html2pptx()` function from the original JS.
+ *
+ * If `source` is a string, creates a temporary iframe, loads it, and parses.
+ * If `source` is a Document, parses directly.
+ * If `source` is an HTMLIFrameElement, uses its contentDocument.
+ */
+export async function addSlideFromHtml(source, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+pres, // PptxGenJS instance
+options = {}) {
+    const { slide = null } = options;
+    let doc;
+    let cleanupIframe = null;
+    try {
+        // ---- Resolve source to a Document ----
+        if (source instanceof Document) {
+            doc = source;
+        }
+        else if (source instanceof HTMLIFrameElement) {
+            doc =
+                source.contentDocument || source.contentWindow.document;
+        }
+        else if (typeof source === 'string') {
+            const result = await createIframeFromHtml(source);
+            doc = result.doc;
+            cleanupIframe = result.iframe;
+        }
+        else {
+            throw new Error('Source must be a Document, HTMLIFrameElement, or HTML string');
+        }
+        // ---- Validation ----
+        const validationErrors = [];
+        const bodyDimensions = getBodyDimensions(doc);
+        const slideData = parseSlideHtml(doc);
+        // Collect body-dimension overflow errors
+        if (bodyDimensions.errors.length > 0) {
+            validationErrors.push(...bodyDimensions.errors);
+        }
+        // Validate dimensions match presentation layout
+        const dimensionErrors = validateDimensions(bodyDimensions, pres);
+        if (dimensionErrors.length > 0) {
+            validationErrors.push(...dimensionErrors);
+        }
+        // Validate text box positions (bottom margin)
+        const textBoxPositionErrors = validateTextBoxPosition(slideData, bodyDimensions);
+        if (textBoxPositionErrors.length > 0) {
+            validationErrors.push(...textBoxPositionErrors);
+        }
+        // Collect parse-level errors
+        if (slideData.errors.length > 0) {
+            validationErrors.push(...slideData.errors);
+        }
+        // Throw all errors at once if any exist
+        if (validationErrors.length > 0) {
+            const errorMessage = validationErrors.length === 1
+                ? validationErrors[0]
+                : `Multiple validation errors found:\n${validationErrors
+                    .map((e, i) => `  ${i + 1}. ${e}`)
+                    .join('\n')}`;
+            throw new Error(errorMessage);
+        }
+        // ---- Build PptxGenJS slide ----
+        const targetSlide = slide || pres.addSlide();
+        await applyBackground(slideData.background, targetSlide);
+        await addElementsToSlide(slideData.elements, targetSlide, pres);
+        return { slide: targetSlide, placeholders: slideData.placeholders };
+    }
+    finally {
+        // Cleanup temporary iframe if we created one
+        if (cleanupIframe?.parentNode) {
+            cleanupIframe.parentNode.removeChild(cleanupIframe);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// createPresentation
+// ---------------------------------------------------------------------------
+/**
+ * Convert multiple HTML strings into a complete PPTX presentation.
+ * Each HTML string becomes one slide.
+ *
+ * @param htmlSlides - Array of complete HTML strings, one per slide.
+ * @param PptxGenJS  - The PptxGenJS constructor (passed in so this module
+ *                     stays free of hard dependencies on the vendor bundle).
+ * @param options    - Optional presentation metadata and layout.
+ * @returns The PptxGenJS presentation instance, ready for `.write()` or
+ *          `.writeFile()`.
+ */
+export async function createPresentation(htmlSlides, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+PptxGenJS, // The PptxGenJS constructor
+options = {}) {
+    const { title, author, company, subject, layout = 'LAYOUT_16x9', } = options;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const pres = new PptxGenJS();
+    pres.layout = layout;
+    if (title)
+        pres.title = title;
+    if (author)
+        pres.author = author;
+    if (company)
+        pres.company = company;
+    if (subject)
+        pres.subject = subject;
+    for (const html of htmlSlides) {
+        await addSlideFromHtml(html, pres);
+    }
+    return pres;
+}
+//# sourceMappingURL=createPresentation.js.map

package/dist/packages/slides/createPresentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPresentation.js","sourceRoot":"","sources":["../../../packages/slides/createPresentation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEhE,8EAA8E;AAC9E,mCAAmC;AACnC,8EAA8E;AAE9E,MAAM,SAAS,GAAG,IAAI,CAAC;AACvB,MAAM,SAAS,GAAG,EAAE,CAAC;AACrB,MAAM,UAAU,GAAG,MAAM,CAAC;AAmC1B;;;GAGG;AACH,SAAS,iBAAiB,CAAC,GAAa;IACtC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACtB,MAAM,KAAK,GAAG,GAAG,CAAC,WAAY,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAEtD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACrC,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;IAEvC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,mEAAmE;IACnE,oEAAoE;IACpE,kDAAkD;IAClD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IAChC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IAClC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IAClC,MAAM,QAAQ,GAAG,QAAQ,KAAK,QAAQ,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,QAAQ,CAAC,CAAC;IAE7F,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC;QAC7D,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC;QAEhE,MAAM,eAAe,GAAG,eAAe,GAAG,SAAS,CAAC;QACpD,MAAM,gBAAgB,GAAG,gBAAgB,GAAG,SAAS,CAAC;QAEtD,mFAAmF;QACnF,MAAM,mBAAmB,GAAG,CAAC,CAAC;QAE9B,IAAI,eAAe,GAAG,mBAAmB,IAAI,gBAAgB,GAAG,mBAAmB,EAAE,CAAC;YACpF,MAAM,UAAU,GAAa,EAAE,CAAC;YAChC,IAAI,eAAe,GAAG,mBAAmB,EAAE,CAAC;gBAC1C,UAAU,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;YAClE,CAAC;YACD,IAAI,gBAAgB,GAAG,mBAAmB,EAAE,CAAC;gBAC3C,UAAU,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;YACjE,CAAC;YACD,MAAM,QAAQ,GACZ,gBAAgB,GAAG,mBAAmB;gBACpC,CAAC,CAAC,mDAAmD;gBACrD,CAAC,CAAC,EAAE,CAAC;YACT,MAAM,CAAC,IAAI,CACT,kCAAkC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,QAAQ,EAAE,CACxE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,8DAA8D;AAC9D,SAAS,kBAAkB,CAAC,cAA8B,EAAE,IAAS;IACnE,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,GAAG,SAAS,CAAC;IACrD,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,GAAG,SAAS,CAAC;IAEvD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,UAAU,CAAC;QACvD,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,UAAU,CAAC;QAEzD,IACE,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,WAAW,CAAC,GAAG,GAAG;YACzC,IAAI,CAAC,GAAG,CAAC,YAAY,GAAG,YAAY,CAAC,GAAG,GAAG,EAC3C,CAAC;YACD,MAAM,CAAC,IAAI,CACT,oBAAoB,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;gBAC3E,oCAAoC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAC/F,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAS,uBAAuB,CAC9B,SAAsB,EACtB,cAA8B;IAE9B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,iBAAiB,GAAG,cAAc,CAAC,MAAM,GAAG,SAAS,CAAC;IAC5D,MAAM,eAAe,GAAG,GAAG,CAAC;IAC5B,MAAM,OAAO,GAAG,IAAI,CAAC;IAErB,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAE7E,KAAK,MAAM,EAAE,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;QACpC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC;YAAE,SAAS;QAEtC,+EAA+E;QAC/E,MAAM,MAAM,GAAG,EAA+B,CAAC;QAC/C,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,EAAE,QAAQ,IAAI,CAAC,CAAC;QAC7C,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QACzD,MAAM,kBAAkB,GAAG,iBAAiB,GAAG,UAAU,CAAC;QAE1D,IAAI,QAAQ,GAAG,EAAE,IAAI,kBAAkB,GAAG,eAAe,GAAG,OAAO,EAAE,CAAC;YACpE,MAAM,OAAO,GAAG,GAAW,EAAE;gBAC3B,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;oBACrB,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;wBAAE,OAAO,MAAM,CAAC,IAAI,CAAC;oBACxD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;wBAC5B,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;gBACvD,CAAC;gBACD,IAAI,OAAO,IAAI,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;oBAClD,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;gBAC5D,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC;YACF,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC;YAC1B,MAAM,UAAU,GACd,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAEhE,MAAM,CAAC,IAAI,CACT,aAAa,UAAU,kCAAkC;gBACvD,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,eAAe,aAAa,CAC1F,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,oEAAoE;AACpE,8EAA8E;AAE9E;;;;GAIG;AACH,KAAK,UAAU,oBAAoB,CACjC,IAAY;IAEZ,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,CAAC,KAAK,CAAC,OAAO;QAClB,sEAAsE,CAAC;IAEzE,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAE1C,MAAM,CAAC,GAAG,GAAG,OAAO,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAElC,0BAA0B;IAC1B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,MAAM,WAAW,GAAG,GAAS,EAAE;YAC7B,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YAC7B,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QAEF,MAAM,CAAC,MAAM,GAAG,WAAW,CAAC;QAC5B,+CAA+C;QAC/C,UAAU,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,MAAM,GAAG,GACP,MAAM,CAAC,eAAe,IAAI,MAAM,CAAC,aAAc,CAAC,QAAQ,CAAC;IAC3D,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;AACzB,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAA6C;AAC7C,8DAA8D;AAC9D,IAAS,EAAE,qBAAqB;AAChC,UAA2B,EAAE;IAE7B,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAEjC,IAAI,GAAa,CAAC;IAClB,IAAI,aAAa,GAA6B,IAAI,CAAC;IAEnD,IAAI,CAAC;QACH,yCAAyC;QACzC,IAAI,MAAM,YAAY,QAAQ,EAAE,CAAC;YAC/B,GAAG,GAAG,MAAM,CAAC;QACf,CAAC;aAAM,IAAI,MAAM,YAAY,iBAAiB,EAAE,CAAC;YAC/C,GAAG;gBACD,MAAM,CAAC,eAAe,IAAI,MAAM,CAAC,aAAc,CAAC,QAAQ,CAAC;QAC7D,CAAC;aAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,CAAC;YAClD,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;YACjB,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CACb,8DAA8D,CAC/D,CAAC;QACJ,CAAC;QAED,uBAAuB;QACvB,MAAM,gBAAgB,GAAa,EAAE,CAAC;QAEtC,MAAM,cAAc,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAC9C,MAAM,SAAS,GAAgB,cAAc,CAAC,GAAG,CAAC,CAAC;QAEnD,yCAAyC;QACzC,IAAI,cAAc,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,gBAAgB,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QAClD,CAAC;QAED,gDAAgD;QAChD,MAAM,eAAe,GAAG,kBAAkB,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QACjE,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,gBAAgB,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC;QAC5C,CAAC;QAED,8CAA8C;QAC9C,MAAM,qBAAqB,GAAG,uBAAuB,CACnD,SAAS,EACT,cAAc,CACf,CAAC;QACF,IAAI,qBAAqB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,gBAAgB,CAAC,IAAI,CAAC,GAAG,qBAAqB,CAAC,CAAC;QAClD,CAAC;QAED,6BAA6B;QAC7B,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,gBAAgB,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;QAC7C,CAAC;QAED,wCAAwC;QACxC,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,YAAY,GAChB,gBAAgB,CAAC,MAAM,KAAK,CAAC;gBAC3B,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;gBACrB,CAAC,CAAC,sCAAsC,gBAAgB;qBACnD,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;qBACjC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;QAChC,CAAC;QAED,kCAAkC;QAClC,MAAM,WAAW,GAAG,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAE7C,MAAM,eAAe,CAAC,SAAS,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QACzD,MAAM,kBAAkB,CAAC,SAAS,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;QAEhE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,CAAC,YAAY,EAAE,CAAC;IACtE,CAAC;YAAS,CAAC;QACT,6CAA6C;QAC7C,IAAI,aAAa,EAAE,UAAU,EAAE,CAAC;YAC9B,aAAa,CAAC,UAAU,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAAoB;AACpB,8DAA8D;AAC9D,SAAc,EAAE,4BAA4B;AAC5C,UAAqC,EAAE;IAGvC,MAAM,EACJ,KAAK,EACL,MAAM,EACN,OAAO,EACP,OAAO,EACP,MAAM,GAAG,aAAa,GACvB,GAAG,OAAO,CAAC;IAEZ,8DAA8D;IAC9D,MAAM,IAAI,GAAQ,IAAI,SAAS,EAAE,CAAC;IAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IAErB,IAAI,KAAK;QAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IAC9B,IAAI,MAAM;QAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACjC,IAAI,OAAO;QAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACpC,IAAI,OAAO;QAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAEpC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}