@heylemon/lemonade 0.1.6 → 0.1.7

package/skills/pptx/scripts/create_pptx.js

@@ -1,218 +1,451 @@
 #!/usr/bin/env node
+/**
+ * Pro Slides — Presentation Creation Engine
+ * Takes a JSON slide spec and produces a polished .pptx file.
+ *
+ * Usage: node create_pptx.js spec.json output.pptx
+ *
+ * JSON spec format: see references/spec-format.md
+ */
+
 import pptxgen from "pptxgenjs";
 import fs from "node:fs";
 
+// ═══════════════════════════════════════════
+// DEFAULT THEME
+// ═══════════════════════════════════════════
 const DEFAULT_THEME = {
-  primary: "1E2761",
-  secondary: "CADCFC",
-  accent: "F5A623",
-  text_dark: "1E293B",
-  text_light: "FFFFFF",
-  text_muted: "64748B",
-  bg_light: "F8FAFC",
-  bg_dark: "1E2761",
-  font_heading: "Arial Black",
-  font_body: "Arial",
-  chart_colors: ["2E86AB", "F5A623", "E74C3C", "2ECC71", "9B59B6", "1ABC9C"],
+    primary: "1E2761",       // Deep navy (backgrounds, title slides)
+    secondary: "CADCFC",     // Ice blue (accents, highlights)
+    accent: "F5A623",        // Gold (callouts, key numbers)
+    text_dark: "1E293B",     // Near-black for body text
+    text_light: "FFFFFF",    // White text on dark backgrounds
+    text_muted: "64748B",    // Slate gray for captions
+    bg_light: "F8FAFC",      // Off-white slide background
+    bg_dark: "1E2761",       // Dark slide background
+    font_heading: "Arial Black",
+    font_body: "Arial",
+    chart_colors: ["2E86AB", "F5A623", "E74C3C", "2ECC71", "9B59B6", "1ABC9C"],
 };
 
+// Typography scale
 const TYPE = {
-  title: 36,
-  subtitle: 18,
-  h1: 28,
-  h2: 20,
-  body: 14,
-  caption: 10,
-  stat: 60,
-  stat_label: 12,
+    title: 36,
+    subtitle: 18,
+    h1: 28,
+    h2: 20,
+    body: 14,
+    caption: 10,
+    stat: 60,
+    stat_label: 12,
 };
 
 function buildPresentation(spec) {
-  const theme = { ...DEFAULT_THEME, ...(spec.theme || {}) };
-  const pres = new pptxgen();
-  pres.layout = "LAYOUT_16x9";
-  pres.author = spec.author || "Lemon AI";
-  pres.title = spec.title || "Presentation";
-
-  const W = 10;
-  const H = 5.625;
-  const M = 0.5;
-  const CW = W - 2 * M;
-  const totalSlides = spec.slides.length;
-
-  const addSlideNumber = (slide, slideNum) => {
-    slide.addText(`${slideNum} / ${totalSlides}`, {
-      x: W - 1.5,
-      y: H - 0.4,
-      w: 1,
-      h: 0.3,
-      fontSize: 8,
-      color: theme.text_muted,
-      align: "right",
-      fontFace: theme.font_body,
+    const theme = { ...DEFAULT_THEME, ...(spec.theme || {}) };
+    const pres = new pptxgen();
+    pres.layout = "LAYOUT_16x9";
+    pres.author = spec.author || "Lemon AI";
+    pres.title = spec.title || "Presentation";
+
+    const W = 10;    // Slide width (inches)
+    const H = 5.625; // Slide height (inches)
+    const M = 0.5;   // Margin
+    const CW = W - 2 * M; // Content width
+
+    // ── Helper: fresh shadow object (PptxGenJS mutates objects) ──
+    const cardShadow = () => ({
+        type: "outer", color: "000000", blur: 6, offset: 2, angle: 135, opacity: 0.1
     });
-  };
-
-  spec.slides.forEach((slideDef, idx) => {
-    const slide = pres.addSlide();
-    const type = slideDef.type || "content";
-    const slideNum = idx + 1;
-
-    if (type === "title") {
-      slide.background = { color: theme.bg_dark };
-      slide.addText(slideDef.title || "Presentation Title", {
-        x: M,
-        y: H * 0.3,
-        w: CW,
-        h: 1.5,
-        fontSize: TYPE.title,
-        fontFace: theme.font_heading,
-        color: theme.text_light,
-        bold: true,
-      });
-      if (slideDef.subtitle) {
-        slide.addText(slideDef.subtitle, {
-          x: M,
-          y: H * 0.3 + 1.5,
-          w: CW,
-          h: 0.6,
-          fontSize: TYPE.subtitle,
-          fontFace: theme.font_body,
-          color: theme.secondary,
-        });
-      }
-    } else if (type === "section") {
-      slide.background = { color: theme.primary };
-      slide.addText(slideDef.title || "Section", {
-        x: M,
-        y: H * 0.35,
-        w: CW,
-        h: 1,
-        fontSize: TYPE.h1,
-        fontFace: theme.font_heading,
-        color: theme.text_light,
-        bold: true,
-      });
-    } else if (type === "stats") {
-      slide.background = { color: theme.bg_light };
-      if (slideDef.title) {
-        slide.addText(slideDef.title, {
-          x: M,
-          y: M,
-          w: CW,
-          h: 0.6,
-          fontSize: TYPE.h2,
-          fontFace: theme.font_heading,
-          color: theme.text_dark,
-          bold: true,
-        });
-      }
-      const stats = slideDef.stats || [];
-      const count = Math.max(1, stats.length);
-      const gap = 0.3;
-      const cardW = (CW - gap * (count - 1)) / count;
-      const yStart = 1.4;
-      stats.forEach((stat, i) => {
-        const x = M + i * (cardW + gap);
-        slide.addShape(pres.shapes.ROUNDED_RECTANGLE, {
-          x,
-          y: yStart,
-          w: cardW,
-          h: 2.5,
-          fill: { color: "FFFFFF" },
+
+    // ── Helper: add slide number ──
+    function addSlideNumber(slide, slideNum, total) {
+        slide.addText(`${slideNum} / ${total}`, {
+            x: W - 1.5, y: H - 0.4, w: 1, h: 0.3,
+            fontSize: 8, color: theme.text_muted, align: "right",
+            fontFace: theme.font_body,
         });
-        slide.addText(stat.value || "0", {
-          x,
-          y: yStart + 0.4,
-          w: cardW,
-          h: 1,
-          fontSize: TYPE.stat,
-          fontFace: theme.font_heading,
-          color: theme.chart_colors[i % theme.chart_colors.length],
-          bold: true,
-          align: "center",
+    }
+
+    // ── Count total slides for numbering ──
+    const totalSlides = spec.slides.length;
+
+    // ── Process each slide ──
+    spec.slides.forEach((slideDef, idx) => {
+        const slide = pres.addSlide();
+        const type = slideDef.type || "content";
+        const slideNum = idx + 1;
+
+        switch (type) {
+            case "title":
+                buildTitleSlide(slide, slideDef, theme, W, H, M, CW, pres);
+                break;
+            case "section":
+                buildSectionSlide(slide, slideDef, theme, W, H, M, CW);
+                break;
+            case "content":
+                buildContentSlide(slide, slideDef, theme, W, H, M, CW, pres, cardShadow);
+                addSlideNumber(slide, slideNum, totalSlides);
+                break;
+            case "two_column":
+                buildTwoColumnSlide(slide, slideDef, theme, W, H, M, CW, pres, cardShadow);
+                addSlideNumber(slide, slideNum, totalSlides);
+                break;
+            case "stats":
+                buildStatsSlide(slide, slideDef, theme, W, H, M, CW, pres);
+                addSlideNumber(slide, slideNum, totalSlides);
+                break;
+            case "comparison":
+                buildComparisonSlide(slide, slideDef, theme, W, H, M, CW, pres, cardShadow);
+                addSlideNumber(slide, slideNum, totalSlides);
+                break;
+            case "closing":
+                buildClosingSlide(slide, slideDef, theme, W, H, M, CW);
+                break;
+            default:
+                buildContentSlide(slide, slideDef, theme, W, H, M, CW, pres, cardShadow);
+                addSlideNumber(slide, slideNum, totalSlides);
+        }
+
+        // Speaker notes
+        if (slideDef.notes) {
+            slide.addNotes(slideDef.notes);
+        }
+    });
+
+    return pres;
+}
+
+// ═══════════════════════════════════════════
+// SLIDE BUILDERS
+// ═══════════════════════════════════════════
+
+function buildTitleSlide(slide, def, theme, W, H, M, CW, pres) {
+    slide.background = { color: theme.bg_dark };
+
+    // Accent bar at top
+    slide.addShape(pres.shapes.RECTANGLE, {
+        x: 0, y: 0, w: W, h: 0.06, fill: { color: theme.accent }
+    });
+
+    // Title
+    slide.addText(def.title || "Presentation Title", {
+        x: M, y: H * 0.3, w: CW, h: 1.5,
+        fontSize: TYPE.title, fontFace: theme.font_heading,
+        color: theme.text_light, bold: true, align: "left", valign: "middle",
+    });
+
+    // Subtitle
+    if (def.subtitle) {
+        slide.addText(def.subtitle, {
+            x: M, y: H * 0.3 + 1.5, w: CW, h: 0.6,
+            fontSize: TYPE.subtitle, fontFace: theme.font_body,
+            color: theme.secondary, align: "left",
         });
-        slide.addText(stat.label || "", {
-          x: x + 0.2,
-          y: yStart + 1.5,
-          w: cardW - 0.4,
-          h: 0.8,
-          fontSize: TYPE.stat_label,
-          fontFace: theme.font_body,
-          color: theme.text_muted,
-          align: "center",
-        });
-      });
-      addSlideNumber(slide, slideNum);
-    } else {
-      slide.background = { color: theme.bg_light };
-      let y = M;
-      if (slideDef.title) {
-        slide.addText(slideDef.title, {
-          x: M,
-          y,
-          w: CW,
-          h: 0.6,
-          fontSize: TYPE.h2,
-          fontFace: theme.font_heading,
-          color: theme.text_dark,
-          bold: true,
-        });
-        y += 0.9;
-      }
-      if (slideDef.content) {
-        const text = Array.isArray(slideDef.content)
-          ? slideDef.content.join("\n\n")
-          : slideDef.content;
+    }
+
+    // Author / date at bottom
+    const meta = [def.author, def.date].filter(Boolean).join("  ·  ");
+    if (meta) {
+        slide.addText(meta, {
+            x: M, y: H - 0.8, w: CW, h: 0.4,
+            fontSize: TYPE.caption, fontFace: theme.font_body,
+            color: theme.text_muted, align: "left",
+        });
+    }
+}
+
+function buildSectionSlide(slide, def, theme, W, H, M, CW) {
+    slide.background = { color: theme.primary };
+
+    slide.addText(def.title || "Section", {
+        x: M, y: H * 0.35, w: CW, h: 1,
+        fontSize: TYPE.h1, fontFace: theme.font_heading,
+        color: theme.text_light, bold: true, align: "left",
+    });
+
+    if (def.subtitle) {
+        slide.addText(def.subtitle, {
+            x: M, y: H * 0.35 + 1.1, w: CW * 0.7, h: 0.8,
+            fontSize: TYPE.body, fontFace: theme.font_body,
+            color: theme.secondary, align: "left",
+        });
+    }
+}
+
+function buildContentSlide(slide, def, theme, W, H, M, CW, pres, cardShadow) {
+    slide.background = { color: theme.bg_light };
+
+    let yPos = M;
+
+    // Title
+    if (def.title) {
+        slide.addText(def.title, {
+            x: M, y: yPos, w: CW, h: 0.6, margin: 0,
+            fontSize: TYPE.h2, fontFace: theme.font_heading,
+            color: theme.text_dark, bold: true, align: "left",
+        });
+        // Accent underline
+        slide.addShape(pres.shapes.RECTANGLE, {
+            x: M, y: yPos + 0.6, w: 0.8, h: 0.04, fill: { color: theme.accent }
+        });
+        yPos += 0.9;
+    }
+
+    // Body text
+    if (def.content) {
+        const text = Array.isArray(def.content) ? def.content.join("\n\n") : def.content;
         slide.addText(text, {
-          x: M,
-          y,
-          w: CW,
-          h: 1.4,
-          fontSize: TYPE.body,
-          fontFace: theme.font_body,
-          color: theme.text_dark,
-        });
-        y += 1.5;
-      }
-      if (slideDef.items?.length) {
-        slide.addText(
-          slideDef.items.map((item, i) => ({
+            x: M, y: yPos, w: CW, h: 1.2,
+            fontSize: TYPE.body, fontFace: theme.font_body,
+            color: theme.text_dark, align: "left", valign: "top",
+            lineSpacingMultiple: 1.3,
+        });
+        yPos += 1.3;
+    }
+
+    // Bullet items
+    if (def.items && def.items.length > 0) {
+        const bulletText = def.items.map((item, i) => ({
             text: item,
-            options: { bullet: true, breakLine: i < slideDef.items.length - 1 },
-          })),
-          {
-            x: M + 0.1,
-            y,
-            w: CW - 0.2,
-            h: H - y - 0.5,
-            fontSize: TYPE.body,
+            options: { bullet: true, breakLine: i < def.items.length - 1 }
+        }));
+        slide.addText(bulletText, {
+            x: M + 0.2, y: yPos, w: CW - 0.4, h: H - yPos - 0.6,
+            fontSize: TYPE.body, fontFace: theme.font_body,
+            color: theme.text_dark, valign: "top",
+            paraSpaceAfter: 6,
+        });
+    }
+
+    // Table
+    if (def.table) {
+        const { headers, rows } = def.table;
+        const tableData = [];
+        if (headers) {
+            tableData.push(headers.map(h => ({
+                text: h, options: { bold: true, color: theme.text_light, fill: { color: theme.primary }, fontSize: 11 }
+            })));
+        }
+        rows.forEach((row, ri) => {
+            tableData.push(row.map(cell => ({
+                text: String(cell), options: {
+                    fontSize: 11,
+                    fill: { color: ri % 2 === 0 ? "F1F5F9" : "FFFFFF" }
+                }
+            })));
+        });
+        const colW = new Array(headers ? headers.length : rows[0].length).fill(CW / (headers ? headers.length : rows[0].length));
+        slide.addTable(tableData, {
+            x: M, y: yPos, w: CW, colW,
+            border: { pt: 0.5, color: "E2E8F0" },
             fontFace: theme.font_body,
-            color: theme.text_dark,
-          },
-        );
-      }
-      addSlideNumber(slide, slideNum);
+        });
+    }
+}
+
+function buildTwoColumnSlide(slide, def, theme, W, H, M, CW, pres, cardShadow) {
+    slide.background = { color: theme.bg_light };
+
+    // Title
+    if (def.title) {
+        slide.addText(def.title, {
+            x: M, y: M, w: CW, h: 0.6, margin: 0,
+            fontSize: TYPE.h2, fontFace: theme.font_heading,
+            color: theme.text_dark, bold: true,
+        });
+        slide.addShape(pres.shapes.RECTANGLE, {
+            x: M, y: M + 0.6, w: 0.8, h: 0.04, fill: { color: theme.accent }
+        });
     }
 
-    if (slideDef.notes) {
-      slide.addNotes(slideDef.notes);
+    const colWidth = (CW - 0.3) / 2;
+    const yStart = 1.2;
+
+    // Left column
+    if (def.left) {
+        const leftContent = Array.isArray(def.left) ? def.left : [def.left];
+        slide.addText(leftContent.map((item, i) => ({
+            text: item,
+            options: { bullet: def.left_bullets !== false, breakLine: i < leftContent.length - 1 }
+        })), {
+            x: M, y: yStart, w: colWidth, h: H - yStart - 0.5,
+            fontSize: TYPE.body, fontFace: theme.font_body,
+            color: theme.text_dark, valign: "top", paraSpaceAfter: 8,
+        });
+    }
+
+    // Right column
+    if (def.right) {
+        const rightContent = Array.isArray(def.right) ? def.right : [def.right];
+        slide.addText(rightContent.map((item, i) => ({
+            text: item,
+            options: { bullet: def.right_bullets !== false, breakLine: i < rightContent.length - 1 }
+        })), {
+            x: M + colWidth + 0.3, y: yStart, w: colWidth, h: H - yStart - 0.5,
+            fontSize: TYPE.body, fontFace: theme.font_body,
+            color: theme.text_dark, valign: "top", paraSpaceAfter: 8,
+        });
     }
-  });
+}
+
+function buildStatsSlide(slide, def, theme, W, H, M, CW, pres) {
+    slide.background = { color: theme.bg_light };
+
+    // Title
+    if (def.title) {
+        slide.addText(def.title, {
+            x: M, y: M, w: CW, h: 0.6, margin: 0,
+            fontSize: TYPE.h2, fontFace: theme.font_heading,
+            color: theme.text_dark, bold: true,
+        });
+    }
+
+    const stats = def.stats || [];
+    const count = stats.length;
+    const gap = 0.3;
+    const cardW = (CW - gap * (count - 1)) / count;
+    const yStart = 1.4;
+
+    stats.forEach((stat, i) => {
+        const xPos = M + i * (cardW + gap);
 
-  return pres;
+        // Card background
+        slide.addShape(pres.shapes.RECTANGLE, {
+            x: xPos, y: yStart, w: cardW, h: 2.5,
+            fill: { color: "FFFFFF" },
+            shadow: { type: "outer", color: "000000", blur: 6, offset: 2, angle: 135, opacity: 0.08 },
+        });
+
+        // Accent bar at top of card
+        slide.addShape(pres.shapes.RECTANGLE, {
+            x: xPos, y: yStart, w: cardW, h: 0.06,
+            fill: { color: theme.chart_colors[i % theme.chart_colors.length] }
+        });
+
+        // Big number
+        slide.addText(stat.value || "0", {
+            x: xPos, y: yStart + 0.4, w: cardW, h: 1,
+            fontSize: TYPE.stat, fontFace: theme.font_heading,
+            color: theme.chart_colors[i % theme.chart_colors.length],
+            bold: true, align: "center", valign: "middle",
+        });
+
+        // Label
+        slide.addText(stat.label || "", {
+            x: xPos + 0.2, y: yStart + 1.5, w: cardW - 0.4, h: 0.8,
+            fontSize: TYPE.stat_label, fontFace: theme.font_body,
+            color: theme.text_muted, align: "center", valign: "top",
+        });
+    });
 }
 
+function buildComparisonSlide(slide, def, theme, W, H, M, CW, pres, cardShadow) {
+    slide.background = { color: theme.bg_light };
+
+    if (def.title) {
+        slide.addText(def.title, {
+            x: M, y: M, w: CW, h: 0.6, margin: 0,
+            fontSize: TYPE.h2, fontFace: theme.font_heading,
+            color: theme.text_dark, bold: true,
+        });
+    }
+
+    const colWidth = (CW - 0.4) / 2;
+    const yStart = 1.2;
+    const colH = H - yStart - 0.5;
+
+    // Left column (option A)
+    slide.addShape(pres.shapes.RECTANGLE, {
+        x: M, y: yStart, w: colWidth, h: colH,
+        fill: { color: "FFFFFF" },
+        shadow: { type: "outer", color: "000000", blur: 4, offset: 1, angle: 135, opacity: 0.08 },
+    });
+    slide.addShape(pres.shapes.RECTANGLE, {
+        x: M, y: yStart, w: colWidth, h: 0.06, fill: { color: theme.chart_colors[0] }
+    });
+    slide.addText(def.option_a_title || "Option A", {
+        x: M + 0.2, y: yStart + 0.2, w: colWidth - 0.4, h: 0.5,
+        fontSize: TYPE.h2 - 2, fontFace: theme.font_heading, color: theme.text_dark, bold: true,
+    });
+    if (def.option_a) {
+        slide.addText(def.option_a.map((item, i) => ({
+            text: item, options: { bullet: true, breakLine: i < def.option_a.length - 1 }
+        })), {
+            x: M + 0.2, y: yStart + 0.8, w: colWidth - 0.4, h: colH - 1,
+            fontSize: TYPE.body - 1, fontFace: theme.font_body, color: theme.text_dark,
+            paraSpaceAfter: 6, valign: "top",
+        });
+    }
+
+    // Right column (option B)
+    const xRight = M + colWidth + 0.4;
+    slide.addShape(pres.shapes.RECTANGLE, {
+        x: xRight, y: yStart, w: colWidth, h: colH,
+        fill: { color: "FFFFFF" },
+        shadow: { type: "outer", color: "000000", blur: 4, offset: 1, angle: 135, opacity: 0.08 },
+    });
+    slide.addShape(pres.shapes.RECTANGLE, {
+        x: xRight, y: yStart, w: colWidth, h: 0.06, fill: { color: theme.chart_colors[1] }
+    });
+    slide.addText(def.option_b_title || "Option B", {
+        x: xRight + 0.2, y: yStart + 0.2, w: colWidth - 0.4, h: 0.5,
+        fontSize: TYPE.h2 - 2, fontFace: theme.font_heading, color: theme.text_dark, bold: true,
+    });
+    if (def.option_b) {
+        slide.addText(def.option_b.map((item, i) => ({
+            text: item, options: { bullet: true, breakLine: i < def.option_b.length - 1 }
+        })), {
+            x: xRight + 0.2, y: yStart + 0.8, w: colWidth - 0.4, h: colH - 1,
+            fontSize: TYPE.body - 1, fontFace: theme.font_body, color: theme.text_dark,
+            paraSpaceAfter: 6, valign: "top",
+        });
+    }
+}
+
+function buildClosingSlide(slide, def, theme, W, H, M, CW) {
+    slide.background = { color: theme.bg_dark };
+
+    slide.addText(def.title || "Thank You", {
+        x: M, y: H * 0.3, w: CW, h: 1,
+        fontSize: TYPE.h1, fontFace: theme.font_heading,
+        color: theme.text_light, bold: true, align: "center",
+    });
+
+    if (def.subtitle) {
+        slide.addText(def.subtitle, {
+            x: M, y: H * 0.3 + 1.2, w: CW, h: 0.6,
+            fontSize: TYPE.body, fontFace: theme.font_body,
+            color: theme.secondary, align: "center",
+        });
+    }
+
+    if (def.contact) {
+        slide.addText(def.contact, {
+            x: M, y: H - 1, w: CW, h: 0.4,
+            fontSize: TYPE.caption, fontFace: theme.font_body,
+            color: theme.text_muted, align: "center",
+        });
+    }
+}
+
+// ═══════════════════════════════════════════
+// MAIN
+// ═══════════════════════════════════════════
+
 if (process.argv.length < 4) {
-  console.log("Usage: node create_pptx.js spec.json output.pptx");
-  process.exit(1);
+    console.log("Usage: node create_pptx.js spec.json output.pptx");
+    process.exit(1);
 }
 
 const specPath = process.argv[2];
 const outputPath = process.argv[3];
+
 const spec = JSON.parse(fs.readFileSync(specPath, "utf8"));
 const pres = buildPresentation(spec);
+
 pres.writeFile({ fileName: outputPath }).then(() => {
-  console.log(`Presentation created: ${outputPath}`);
-  console.log(`  Slides: ${spec.slides.length}`);
+    console.log(`Presentation created: ${outputPath}`);
+    console.log(`  Title: ${spec.title || "Untitled"}`);
+    console.log(`  Slides: ${spec.slides.length}`);
+    console.log(`  Theme: ${spec.theme ? "custom" : "default (Midnight Executive)"}`);
 });