dom-to-pptx 1.0.0 → 1.0.2

package/src/index.js

@@ -1,181 +1,486 @@
-// src/index.js
-import PptxGenJS from "pptxgenjs";
-import { parseColor, getTextStyle, isTextContainer, getVisibleShadow, generateGradientSVG } from "./utils.js";
-import { getProcessedImage } from "./image-processor.js";
-
-const PPI = 96;
-const PX_TO_INCH = 1 / PPI;
-
-/**
- * Converts a DOM element to a PPTX file.
- * @param {HTMLElement | string} elementOrSelector - The root element to convert.
- * @param {Object} options - { fileName: string }
- */
-export async function exportToPptx(elementOrSelector, options = {}) {
-  const root = typeof elementOrSelector === "string" 
-    ? document.querySelector(elementOrSelector) 
-    : elementOrSelector;
-
-  if (!root) throw new Error("Root element not found");
-
-  const pptx = new PptxGenJS();
-  pptx.layout = "LAYOUT_16x9"; // Default
-  const slide = pptx.addSlide();
-
-  // Use the dimensions of the root element to calculate scaling
-  const rootRect = root.getBoundingClientRect();
-  
-  // Standard PPTX 16:9 dimensions in inches
-  const PPTX_WIDTH_IN = 10;
-  const PPTX_HEIGHT_IN = 5.625;
-
-  const contentWidthIn = rootRect.width * PX_TO_INCH;
-  const contentHeightIn = rootRect.height * PX_TO_INCH;
-  
-  // Scale content to fit within the slide
-  const scale = Math.min(
-    PPTX_WIDTH_IN / contentWidthIn,
-    PPTX_HEIGHT_IN / contentHeightIn
-  );
-
-  const layoutConfig = {
-    rootX: rootRect.x,
-    rootY: rootRect.y,
-    scale: scale,
-    // Center the content
-    offX: (PPTX_WIDTH_IN - contentWidthIn * scale) / 2,
-    offY: (PPTX_HEIGHT_IN - contentHeightIn * scale) / 2,
-  };
-
-  await processNode(root, pptx, slide, layoutConfig);
-  
-  const fileName = options.fileName || "export.pptx";
-  pptx.writeFile({ fileName });
-}
-
-async function processNode(node, pptx, slide, config) {
-  if (node.nodeType !== 1) return; // Element nodes only
-  
-  const style = window.getComputedStyle(node);
-  if (style.display === "none" || style.visibility === "hidden" || style.opacity === "0") return;
-
-  const rect = node.getBoundingClientRect();
-  if (rect.width === 0 || rect.height === 0) return;
-
-  const x = config.offX + (rect.x - config.rootX) * PX_TO_INCH * config.scale;
-  const y = config.offY + (rect.y - config.rootY) * PX_TO_INCH * config.scale;
-  const w = rect.width * PX_TO_INCH * config.scale;
-  const h = rect.height * PX_TO_INCH * config.scale;
-
-  // --- 1. Detect Image Wrapper ---
-  let isImageWrapper = false;
-  const imgChild = Array.from(node.children).find(c => c.tagName === 'IMG');
-  if (imgChild) {
-      const imgRect = imgChild.getBoundingClientRect();
-      if (Math.abs(imgRect.width - rect.width) < 2 && Math.abs(imgRect.height - rect.height) < 2) {
-          isImageWrapper = true;
-      }
-  }
-
-  // --- 2. Backgrounds & Borders ---
-  let bgColor = parseColor(style.backgroundColor);
-  if (isImageWrapper && bgColor) bgColor = null; // Prevent halo
-
-  const hasGradient = style.backgroundImage && style.backgroundImage.includes("linear-gradient");
-  const borderColor = parseColor(style.borderColor);
-  const borderWidth = parseFloat(style.borderWidth);
-  const hasBorder = borderWidth > 0 && borderColor;
-  const shadowStr = style.boxShadow;
-  const hasShadow = shadowStr && shadowStr !== "none";
-  const borderRadius = parseFloat(style.borderRadius) || 0;
-
-  if (hasGradient) {
-    const svgData = generateGradientSVG(rect.width, rect.height, style.backgroundImage, borderRadius, hasBorder ? { color: borderColor, width: borderWidth } : null);
-    if (svgData) slide.addImage({ data: svgData, x, y, w, h });
-  } else if (bgColor || hasBorder || hasShadow) {
-    const isCircle = borderRadius >= Math.min(rect.width, rect.height) / 2 - 1;
-
-    const shapeOpts = {
-      x, y, w, h,
-      fill: bgColor ? { color: bgColor } : null,
-      line: hasBorder ? { color: borderColor, width: borderWidth * 0.75 * config.scale } : null,
-    };
-
-    if (hasShadow) {
-      const shadow = getVisibleShadow(shadowStr, config.scale);
-      if (shadow) shapeOpts.shadow = shadow;
-      
-      // Fix for shadow on transparent background (needed for PPTX to render shadow)
-      if (!bgColor && !hasBorder) {
-        if (style.backgroundColor && style.backgroundColor !== 'rgba(0, 0, 0, 0)') {
-             shapeOpts.fill = { color: parseColor(style.backgroundColor) };
-        }
-      }
-    }
-
-    if (isCircle) {
-      slide.addShape(pptx.ShapeType.ellipse, shapeOpts);
-    } else if (borderRadius > 0) {
-      const radiusFactor = Math.min(1, borderRadius / (Math.min(rect.width, rect.height) / 1.75));
-      shapeOpts.rectRadius = radiusFactor;
-      slide.addShape(pptx.ShapeType.roundRect, shapeOpts);
-    } else {
-      slide.addShape(pptx.ShapeType.rect, shapeOpts);
-    }
-  }
-
-  // --- 3. Process Image ---
-  if (node.tagName === "IMG") {
-    let effectiveRadius = borderRadius;
-    // Check parent clipping if current img has no radius
-    if (effectiveRadius === 0) {
-        const parentStyle = window.getComputedStyle(node.parentElement);
-        if (parentStyle.overflow !== 'visible') {
-            effectiveRadius = parseFloat(parentStyle.borderRadius) || 0;
-        }
-    }
-
-    const processedImage = await getProcessedImage(node.src, rect.width, rect.height, effectiveRadius);
-    if (processedImage) {
-      slide.addImage({ data: processedImage, x, y, w, h });
-    }
-    return; // Don't process children of IMG
-  }
-
-  // --- 4. Process Text ---
-  if (isTextContainer(node)) {
-    const textParts = [];
-    node.childNodes.forEach((child, index) => {
-      let textVal = child.nodeType === 3 ? child.nodeValue : child.textContent;
-      let nodeStyle = child.nodeType === 1 ? window.getComputedStyle(child) : style;
-      
-      textVal = textVal.replace(/[\n\r\t]+/g, " ").replace(/\s{2,}/g, " ");
-      if (index === 0) textVal = textVal.trimStart();
-      if (index === node.childNodes.length - 1) textVal = textVal.trimEnd();
-
-      if (nodeStyle.textTransform === "uppercase") textVal = textVal.toUpperCase();
-      if (nodeStyle.textTransform === "lowercase") textVal = textVal.toLowerCase();
-
-      if (textVal.length > 0) {
-        textParts.push({ text: textVal, options: getTextStyle(nodeStyle, config.scale) });
-      }
-    });
-
-    if (textParts.length > 0) {
-      let align = style.textAlign || "left";
-      if (align === "start") align = "left";
-      if (align === "end") align = "right";
-      
-      let valign = "top";
-      if (style.alignItems === "center") valign = "middle"; // Flex approximation
-      
-      slide.addText(textParts, { x, y, w, h, align, valign, margin: 0, wrap: true, autoFit: false });
-    }
-    return;
-  }
-
-  // Recursive call
-  for (const child of node.children) {
-    await processNode(child, pptx, slide, config);
-  }
-}
+// src/index.js
+import PptxGenJS from 'pptxgenjs';
+import {
+  parseColor,
+  getTextStyle,
+  isTextContainer,
+  getVisibleShadow,
+  generateGradientSVG,
+  getRotation,
+  svgToPng,
+  getPadding,
+  getSoftEdges,
+  generateBlurredSVG,
+  getBorderInfo,
+  generateCompositeBorderSVG,
+} from './utils.js';
+import { getProcessedImage } from './image-processor.js';
+
+const PPI = 96;
+const PX_TO_INCH = 1 / PPI;
+
+/**
+ * Main export function. Accepts single element or an array.
+ * @param {HTMLElement | string | Array<HTMLElement | string>} target - The root element(s) to convert.
+ * @param {Object} options - { fileName: string }
+ */
+export async function exportToPptx(target, options = {}) {
+  const pptx = new PptxGenJS();
+  pptx.layout = 'LAYOUT_16x9';
+
+  // Standardize input to an array, ensuring single or multiple elements are handled consistently
+  const elements = Array.isArray(target) ? target : [target];
+
+  for (const el of elements) {
+    const root = typeof el === 'string' ? document.querySelector(el) : el;
+    if (!root) {
+      console.warn('Element not found, skipping slide:', el);
+      continue;
+    }
+
+    const slide = pptx.addSlide();
+    await processSlide(root, slide, pptx);
+  }
+
+  const fileName = options.fileName || 'export.pptx';
+  pptx.writeFile({ fileName });
+}
+
+/**
+ * Worker function to process a single DOM element into a single PPTX slide.
+ * @param {HTMLElement} root - The root element for this slide.
+ * @param {PptxGenJS.Slide} slide - The PPTX slide object to add content to.
+ * @param {PptxGenJS} pptx - The main PPTX instance.
+ */
+async function processSlide(root, slide, pptx) {
+  const rootRect = root.getBoundingClientRect();
+  const PPTX_WIDTH_IN = 10;
+  const PPTX_HEIGHT_IN = 5.625;
+
+  const contentWidthIn = rootRect.width * PX_TO_INCH;
+  const contentHeightIn = rootRect.height * PX_TO_INCH;
+  const scale = Math.min(PPTX_WIDTH_IN / contentWidthIn, PPTX_HEIGHT_IN / contentHeightIn);
+
+  const layoutConfig = {
+    rootX: rootRect.x,
+    rootY: rootRect.y,
+    scale: scale,
+    offX: (PPTX_WIDTH_IN - contentWidthIn * scale) / 2,
+    offY: (PPTX_HEIGHT_IN - contentHeightIn * scale) / 2,
+  };
+
+  const renderQueue = [];
+  let domOrderCounter = 0;
+
+  async function collect(node) {
+    const order = domOrderCounter++; // Assign a DOM order for z-index tie-breaking
+    const result = await createRenderItem(node, layoutConfig, order, pptx);
+    if (result) {
+      if (result.items) renderQueue.push(...result.items); // Add any generated render items to the queue
+      if (result.stopRecursion) return; // Stop processing children if the item fully consumed the node
+    }
+    for (const child of node.children) await collect(child);
+  }
+
+  await collect(root);
+
+  renderQueue.sort((a, b) => {
+    if (a.zIndex !== b.zIndex) return a.zIndex - b.zIndex;
+    return a.domOrder - b.domOrder;
+  });
+
+  for (const item of renderQueue) {
+    if (item.type === 'shape') slide.addShape(item.shapeType, item.options);
+    if (item.type === 'image') slide.addImage(item.options);
+    if (item.type === 'text') slide.addText(item.textParts, item.options);
+  }
+}
+
+async function createRenderItem(node, config, domOrder, pptx) {
+  if (node.nodeType !== 1) return null;
+  const style = window.getComputedStyle(node);
+  if (style.display === 'none' || style.visibility === 'hidden' || style.opacity === '0')
+    return null;
+
+  const rect = node.getBoundingClientRect();
+  if (rect.width === 0 || rect.height === 0) return null;
+
+  const zIndex = style.zIndex !== 'auto' ? parseInt(style.zIndex) : 0;
+  const rotation = getRotation(style.transform);
+  const elementOpacity = parseFloat(style.opacity);
+
+  const widthPx = node.offsetWidth || rect.width;
+  const heightPx = node.offsetHeight || rect.height;
+  const unrotatedW = widthPx * PX_TO_INCH * config.scale;
+  const unrotatedH = heightPx * PX_TO_INCH * config.scale;
+  const centerX = rect.left + rect.width / 2;
+  const centerY = rect.top + rect.height / 2;
+
+  let x = config.offX + (centerX - config.rootX) * PX_TO_INCH * config.scale - unrotatedW / 2;
+  let y = config.offY + (centerY - config.rootY) * PX_TO_INCH * config.scale - unrotatedH / 2;
+  let w = unrotatedW;
+  let h = unrotatedH;
+
+  const items = [];
+
+  // Image handling for SVG nodes directly
+  if (node.nodeName.toUpperCase() === 'SVG') {
+    const pngData = await svgToPng(node);
+    if (pngData)
+      items.push({
+        type: 'image',
+        zIndex,
+        domOrder,
+        options: { data: pngData, x, y, w, h, rotate: rotation },
+      });
+    return { items, stopRecursion: true };
+  }
+  // Image handling for <img> tags, including rounded corners
+  if (node.tagName === 'IMG') {
+    let borderRadius = parseFloat(style.borderRadius) || 0;
+    if (borderRadius === 0) {
+      const parentStyle = window.getComputedStyle(node.parentElement);
+      if (parentStyle.overflow !== 'visible')
+        borderRadius = parseFloat(parentStyle.borderRadius) || 0;
+    }
+    const processed = await getProcessedImage(node.src, widthPx, heightPx, borderRadius);
+    if (processed)
+      items.push({
+        type: 'image',
+        zIndex,
+        domOrder,
+        options: { data: processed, x, y, w, h, rotate: rotation },
+      });
+    return { items, stopRecursion: true };
+  }
+
+  const bgColorObj = parseColor(style.backgroundColor);
+  const bgClip = style.webkitBackgroundClip || style.backgroundClip;
+  const isBgClipText = bgClip === 'text';
+  const hasGradient =
+    !isBgClipText && style.backgroundImage && style.backgroundImage.includes('linear-gradient');
+
+  const borderColorObj = parseColor(style.borderColor);
+  const borderWidth = parseFloat(style.borderWidth);
+  const hasBorder = borderWidth > 0 && borderColorObj.hex;
+
+  const borderInfo = getBorderInfo(style, config.scale);
+  const hasUniformBorder = borderInfo.type === 'uniform';
+  const hasCompositeBorder = borderInfo.type === 'composite';
+
+  const shadowStr = style.boxShadow;
+  const hasShadow = shadowStr && shadowStr !== 'none';
+  const borderRadius = parseFloat(style.borderRadius) || 0;
+  const softEdge = getSoftEdges(style.filter, config.scale);
+
+  let isImageWrapper = false;
+  const imgChild = Array.from(node.children).find((c) => c.tagName === 'IMG');
+  if (imgChild) {
+    const childW = imgChild.offsetWidth || imgChild.getBoundingClientRect().width;
+    const childH = imgChild.offsetHeight || imgChild.getBoundingClientRect().height;
+    if (childW >= widthPx - 2 && childH >= heightPx - 2) isImageWrapper = true;
+  }
+
+  let textPayload = null;
+  const isText = isTextContainer(node);
+
+  if (isText) {
+    const textParts = [];
+    const isList = style.display === 'list-item';
+    if (isList) {
+      const fontSizePt = parseFloat(style.fontSize) * 0.75 * config.scale;
+      const bulletShift = (parseFloat(style.fontSize) || 16) * PX_TO_INCH * config.scale * 1.5;
+      x -= bulletShift;
+      w += bulletShift;
+      textParts.push({
+        text: '• ',
+        options: {
+          // Default bullet point styling
+          color: parseColor(style.color).hex || '000000',
+          fontSize: fontSizePt,
+        },
+      });
+    }
+
+    node.childNodes.forEach((child, index) => {
+      // Process text content, sanitizing whitespace and applying text transformations
+      let textVal = child.nodeType === 3 ? child.nodeValue : child.textContent;
+      let nodeStyle = child.nodeType === 1 ? window.getComputedStyle(child) : style;
+      textVal = textVal.replace(/[\n\r\t]+/g, ' ').replace(/\s{2,}/g, ' ');
+      if (index === 0 && !isList) textVal = textVal.trimStart();
+      else if (index === 0) textVal = textVal.trimStart();
+      if (index === node.childNodes.length - 1) textVal = textVal.trimEnd();
+      if (nodeStyle.textTransform === 'uppercase') textVal = textVal.toUpperCase();
+      if (nodeStyle.textTransform === 'lowercase') textVal = textVal.toLowerCase();
+
+      if (textVal.length > 0) {
+        textParts.push({
+          text: textVal,
+          options: getTextStyle(nodeStyle, config.scale),
+        });
+      }
+    });
+
+    if (textParts.length > 0) {
+      let align = style.textAlign || 'left';
+      if (align === 'start') align = 'left';
+      if (align === 'end') align = 'right';
+      let valign = 'top';
+      if (style.alignItems === 'center') valign = 'middle';
+      if (style.justifyContent === 'center' && style.display.includes('flex')) align = 'center';
+
+      const pt = parseFloat(style.paddingTop) || 0;
+      const pb = parseFloat(style.paddingBottom) || 0;
+      if (Math.abs(pt - pb) < 2 && bgColorObj.hex) valign = 'middle';
+
+      let padding = getPadding(style, config.scale);
+      if (align === 'center' && valign === 'middle') padding = [0, 0, 0, 0];
+
+      textPayload = { text: textParts, align, valign, inset: padding };
+    }
+  }
+
+  if (hasGradient || (softEdge && bgColorObj.hex && !isImageWrapper)) {
+    let bgData = null;
+    let padIn = 0;
+    if (softEdge) {
+      const svgInfo = generateBlurredSVG(widthPx, heightPx, bgColorObj.hex, borderRadius, softEdge);
+      bgData = svgInfo.data;
+      padIn = svgInfo.padding * PX_TO_INCH * config.scale;
+    } else {
+      bgData = generateGradientSVG(
+        widthPx,
+        heightPx,
+        style.backgroundImage,
+        borderRadius,
+        hasBorder ? { color: borderColorObj.hex, width: borderWidth } : null
+      );
+    }
+
+    if (bgData) {
+      items.push({
+        type: 'image',
+        zIndex,
+        domOrder,
+        options: {
+          data: bgData,
+          x: x - padIn,
+          y: y - padIn,
+          w: w + padIn * 2,
+          h: h + padIn * 2,
+          rotate: rotation,
+        },
+      });
+    }
+
+    if (textPayload) {
+      items.push({
+        type: 'text',
+        zIndex: zIndex + 1,
+        domOrder,
+        textParts: textPayload.text,
+        options: {
+          x,
+          y,
+          w,
+          h,
+          align: textPayload.align,
+          valign: textPayload.valign,
+          inset: textPayload.inset,
+          rotate: rotation,
+          margin: 0,
+          wrap: true,
+          autoFit: false,
+        },
+      });
+    }
+    if (hasCompositeBorder) {
+      // Add border shapes after the main background
+      const borderItems = createCompositeBorderItems(
+        borderInfo.sides,
+        x,
+        y,
+        w,
+        h,
+        config.scale,
+        zIndex,
+        domOrder
+      );
+      items.push(...borderItems);
+    }
+  } else if (
+    (bgColorObj.hex && !isImageWrapper) ||
+    hasUniformBorder ||
+    hasCompositeBorder ||
+    hasShadow ||
+    textPayload
+  ) {
+    const finalAlpha = elementOpacity * bgColorObj.opacity;
+    const transparency = (1 - finalAlpha) * 100;
+
+    const shapeOpts = {
+      x,
+      y,
+      w,
+      h,
+      rotate: rotation,
+      fill:
+        bgColorObj.hex && !isImageWrapper
+          ? { color: bgColorObj.hex, transparency: transparency }
+          : { type: 'none' },
+      // Only apply line if the border is uniform
+      line: hasUniformBorder ? borderInfo.options : null,
+    };
+
+    if (hasShadow) {
+      shapeOpts.shadow = getVisibleShadow(shadowStr, config.scale);
+    }
+
+    const borderRadius = parseFloat(style.borderRadius) || 0;
+    const widthPx = node.offsetWidth || rect.width;
+    const heightPx = node.offsetHeight || rect.height;
+    const isCircle =
+      borderRadius >= Math.min(widthPx, heightPx) / 2 - 1 && Math.abs(widthPx - heightPx) < 2;
+
+    let shapeType = pptx.ShapeType.rect;
+    if (isCircle) shapeType = pptx.ShapeType.ellipse;
+    else if (borderRadius > 0) {
+      shapeType = pptx.ShapeType.roundRect;
+      shapeOpts.rectRadius = Math.min(1, borderRadius / (Math.min(widthPx, heightPx) / 2));
+    }
+
+    // MERGE TEXT INTO SHAPE (if text exists)
+    if (textPayload) {
+      const textOptions = {
+        shape: shapeType,
+        ...shapeOpts,
+        align: textPayload.align,
+        valign: textPayload.valign,
+        inset: textPayload.inset,
+        margin: 0,
+        wrap: true,
+        autoFit: false,
+      };
+      items.push({
+        type: 'text',
+        zIndex,
+        domOrder,
+        textParts: textPayload.text,
+        options: textOptions,
+      });
+      // If no text, just draw the shape
+    } else {
+      items.push({
+        type: 'shape',
+        zIndex,
+        domOrder,
+        shapeType,
+        options: shapeOpts,
+      });
+    }
+
+    // ADD COMPOSITE BORDERS (if they exist)
+    if (hasCompositeBorder) {
+      // Generate a single SVG image that contains all the rounded border sides
+      const borderSvgData = generateCompositeBorderSVG(
+        widthPx,
+        heightPx,
+        borderRadius,
+        borderInfo.sides
+      );
+
+      if (borderSvgData) {
+        items.push({
+          type: 'image',
+          zIndex: zIndex + 1,
+          domOrder,
+          options: {
+            data: borderSvgData,
+            x: x,
+            y: y,
+            w: w,
+            h: h,
+            rotate: rotation,
+          },
+        });
+      }
+    }
+  }
+
+  return { items, stopRecursion: !!textPayload };
+}
+
+/**
+ * Helper function to create individual border shapes
+ */
+function createCompositeBorderItems(sides, x, y, w, h, scale, zIndex, domOrder) {
+  const items = [];
+  const pxToInch = 1 / 96;
+
+  // TOP BORDER
+  if (sides.top.width > 0) {
+    items.push({
+      type: 'shape',
+      zIndex: zIndex + 1,
+      domOrder,
+      shapeType: 'rect',
+      options: {
+        x: x,
+        y: y,
+        w: w,
+        h: sides.top.width * pxToInch * scale,
+        fill: { color: sides.top.color },
+      },
+    });
+  }
+  // RIGHT BORDER
+  if (sides.right.width > 0) {
+    items.push({
+      type: 'shape',
+      zIndex: zIndex + 1,
+      domOrder,
+      shapeType: 'rect',
+      options: {
+        x: x + w - sides.right.width * pxToInch * scale,
+        y: y,
+        w: sides.right.width * pxToInch * scale,
+        h: h,
+        fill: { color: sides.right.color },
+      },
+    });
+  }
+  // BOTTOM BORDER
+  if (sides.bottom.width > 0) {
+    items.push({
+      type: 'shape',
+      zIndex: zIndex + 1,
+      domOrder,
+      shapeType: 'rect',
+      options: {
+        x: x,
+        y: y + h - sides.bottom.width * pxToInch * scale,
+        w: w,
+        h: sides.bottom.width * pxToInch * scale,
+        fill: { color: sides.bottom.color },
+      },
+    });
+  }
+  // LEFT BORDER
+  if (sides.left.width > 0) {
+    items.push({
+      type: 'shape',
+      zIndex: zIndex + 1,
+      domOrder,
+      shapeType: 'rect',
+      options: {
+        x: x,
+        y: y,
+        w: sides.left.width * pxToInch * scale,
+        h: h,
+        fill: { color: sides.left.color },
+      },
+    });
+  }
+
+  return items;
+}