squidclaw 2.8.0 → 3.1.0

package/lib/tools/pptx-pro.js

@@ -0,0 +1,686 @@
+/**
+ * 🦑 PPTX PRO — Smart Presentation Engine
+ * 
+ * Takes raw content and auto-generates professional multi-slide decks.
+ * AI just says what it wants → engine handles layout, design, charts, animations.
+ * 
+ * Smart features:
+ * - Auto-detects content type (stats, table, chart, quote, timeline, comparison)
+ * - Markdown → proper slides conversion
+ * - Professional layouts with consistent branding
+ * - Master slide designs with gradients, shapes, accents
+ * - Auto icon assignment
+ * - Smart color palettes
+ */
+
+import PptxGenJS from 'pptxgenjs';
+import { mkdirSync, existsSync } from 'fs';
+import { join } from 'path';
+import { logger } from '../core/logger.js';
+
+const OUTPUT_DIR = '/tmp/squidclaw-pptx';
+
+// ── Professional Themes ──
+
+const THEMES = {
+  executive: {
+    bg: '0D1117', accent: '58A6FF', accent2: '3FB950', text: 'FFFFFF', subtle: '8B949E',
+    gradStart: '0D1117', gradEnd: '161B22', cardBg: '161B22', border: '30363D',
+  },
+  corporate: {
+    bg: 'FFFFFF', accent: '1B4F72', accent2: '2E86C1', text: '2C3E50', subtle: '7F8C8D',
+    gradStart: '1B4F72', gradEnd: '2E86C1', cardBg: 'F8F9FA', border: 'DEE2E6',
+  },
+  saudi: {
+    bg: 'FFFFFF', accent: '006C35', accent2: 'C8A951', text: '1A1A2E', subtle: '6B7280',
+    gradStart: '006C35', gradEnd: '004D25', cardBg: 'F0FDF4', border: 'BBF7D0',
+  },
+  modern: {
+    bg: '1A1A2E', accent: 'E94560', accent2: '0F3460', text: 'EAEAEA', subtle: '9CA3AF',
+    gradStart: '16213E', gradEnd: '1A1A2E', cardBg: '16213E', border: '374151',
+  },
+  ocean: {
+    bg: '0A192F', accent: '64FFDA', accent2: '5EEAD4', text: 'CCD6F6', subtle: '8892B0',
+    gradStart: '0A192F', gradEnd: '112240', cardBg: '112240', border: '1E3A5F',
+  },
+  gradient: {
+    bg: '0F0C29', accent: 'F7971E', accent2: 'FFD200', text: 'FFFFFF', subtle: 'B0B0B0',
+    gradStart: '302B63', gradEnd: '24243E', cardBg: '1E1E3F', border: '4A4A7A',
+  },
+  minimal: {
+    bg: 'FAFAFA', accent: '111111', accent2: '555555', text: '111111', subtle: '999999',
+    gradStart: '111111', gradEnd: '333333', cardBg: 'FFFFFF', border: 'E5E5E5',
+  },
+  fire: {
+    bg: '1A0000', accent: 'FF4500', accent2: 'FF8C00', text: 'FFFFFF', subtle: 'CC9999',
+    gradStart: '8B0000', gradEnd: '1A0000', cardBg: '2D0000', border: '661111',
+  },
+};
+
+// ── Auto Icons ──
+const TOPIC_ICONS = {
+  revenue: '💰', money: '💰', gdp: '💰', profit: '💰', income: '💰', cost: '💰', price: '💰', budget: '💰', finance: '💰',
+  growth: '📈', increase: '📈', rise: '📈', trend: '📈', up: '📈',
+  users: '👥', people: '👥', team: '👥', employees: '👥', population: '👥', workforce: '👥',
+  time: '⏱️', speed: '⚡', fast: '⚡', performance: '⚡',
+  global: '🌍', world: '🌍', international: '🌍', country: '🌍',
+  tech: '💻', software: '💻', digital: '💻', ai: '🤖', data: '📊',
+  security: '🔒', safe: '🔒', protect: '🛡️',
+  health: '🏥', medical: '🏥', hospital: '🏥',
+  education: '🎓', school: '🎓', university: '🎓', training: '🎓',
+  oil: '⛽', energy: '⚡', power: '⚡',
+  tourism: '✈️', travel: '✈️', visitors: '✈️',
+  construction: '🏗️', building: '🏗️', infrastructure: '🏗️',
+  investment: '📊', fdi: '📊', invest: '📊',
+  target: '🎯', goal: '🎯', objective: '🎯',
+  success: '✅', complete: '✅', done: '✅', achievement: '🏆',
+};
+
+function autoIcon(text) {
+  const lower = text.toLowerCase();
+  for (const [key, icon] of Object.entries(TOPIC_ICONS)) {
+    if (lower.includes(key)) return icon;
+  }
+  return '📌';
+}
+
+// ── Smart Content Parser ──
+
+function parseMarkdownToSlides(content) {
+  const slides = [];
+  const lines = content.split('\n').map(l => l.trim()).filter(Boolean);
+  
+  let currentSlide = null;
+  let currentSection = null;
+  
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    
+    // H1/H2 = new slide
+    if (line.startsWith('# ') || line.startsWith('## ')) {
+      if (currentSlide) slides.push(currentSlide);
+      const title = line.replace(/^#+\s*/, '').replace(/\*\*/g, '');
+      currentSlide = { title, type: 'content', body: [], stats: [], table: [], chart: [], bullets: [], timeline: [], comparisons: [], quote: null };
+      currentSection = 'body';
+      continue;
+    }
+    
+    if (!currentSlide) {
+      currentSlide = { title: 'Overview', type: 'content', body: [], stats: [], table: [], chart: [], bullets: [], timeline: [], comparisons: [], quote: null };
+    }
+    
+    // [stats] marker
+    if (line.match(/^\[stats?\]/i)) { currentSection = 'stats'; continue; }
+    if (line.match(/^\[table\]/i)) { currentSection = 'table'; continue; }
+    if (line.match(/^\[chart\]/i)) { currentSection = 'chart'; continue; }
+    if (line.match(/^\[timeline\]/i)) { currentSection = 'timeline'; continue; }
+    if (line.match(/^\[compare|comparison\]/i)) { currentSection = 'comparison'; continue; }
+    if (line.match(/^\[quote\]/i)) { currentSection = 'quote'; continue; }
+    
+    // Stats: - icon value — label OR - label: value
+    if (currentSection === 'stats' && line.startsWith('-')) {
+      const m = line.match(/^-\s*(.+?)\s+(.+?)\s*[—–-]\s*(.+)/) || line.match(/^-\s*(.+?):\s*(.+)/);
+      if (m) {
+        if (m[3]) {
+          currentSlide.stats.push({ icon: m[1].trim(), value: m[2].trim(), label: m[3].trim() });
+        } else {
+          currentSlide.stats.push({ icon: autoIcon(m[1]), value: m[2].trim(), label: m[1].trim() });
+        }
+      }
+      continue;
+    }
+    
+    // Table: | col | col |
+    if (line.startsWith('|') && line.endsWith('|')) {
+      if (line.match(/^\|[\s-:|]+\|$/)) continue; // separator row
+      const cells = line.split('|').filter(c => c.trim()).map(c => c.trim());
+      currentSlide.table.push(cells);
+      currentSection = 'table';
+      continue;
+    }
+    
+    // Chart: - label: value
+    if (currentSection === 'chart' && line.startsWith('-')) {
+      const m = line.match(/^-\s*(.+?):\s*(\d+)/);
+      if (m) currentSlide.chart.push({ label: m[1].trim(), value: parseInt(m[2]) });
+      continue;
+    }
+    
+    // Timeline: N. Title — description
+    if (currentSection === 'timeline' && line.match(/^\d+\./)) {
+      const m = line.match(/^(\d+)\.\s*\*?\*?(.+?)\*?\*?\s*[—–-]\s*(.+)/);
+      if (m) currentSlide.timeline.push({ year: m[1], title: m[2].trim(), desc: m[3].trim() });
+      continue;
+    }
+    
+    // Quote
+    if (line.startsWith('>') || currentSection === 'quote') {
+      const q = line.replace(/^>\s*/, '').replace(/\*\*/g, '');
+      if (q) currentSlide.quote = (currentSlide.quote || '') + q + ' ';
+      currentSection = 'quote';
+      continue;
+    }
+    
+    // Bullets
+    if (line.startsWith('-') || line.startsWith('•') || line.startsWith('*')) {
+      const bullet = line.replace(/^[-•*]\s*/, '').replace(/\*\*/g, '');
+      currentSlide.bullets.push(bullet);
+      continue;
+    }
+    
+    // H3 = subsection title, add as body
+    if (line.startsWith('### ')) {
+      currentSlide.body.push({ type: 'heading', text: line.replace(/^###\s*/, '') });
+      continue;
+    }
+    
+    // Plain text
+    currentSlide.body.push({ type: 'text', text: line.replace(/\*\*/g, '') });
+  }
+  
+  if (currentSlide) slides.push(currentSlide);
+  
+  // Auto-detect best slide type
+  for (const slide of slides) {
+    if (slide.stats.length >= 3) slide.type = 'stats';
+    else if (slide.table.length >= 2) slide.type = 'table';
+    else if (slide.chart.length >= 2) slide.type = 'chart';
+    else if (slide.timeline.length >= 2) slide.type = 'timeline';
+    else if (slide.quote) slide.type = 'quote';
+    else if (slide.bullets.length >= 3 && slide.stats.length >= 2) slide.type = 'stats-bullets';
+    else if (slide.bullets.length >= 2) slide.type = 'bullets';
+  }
+  
+  // Split oversized slides
+  const final = [];
+  for (const slide of slides) {
+    if (slide.stats.length > 6) {
+      // Split stats across slides
+      for (let j = 0; j < slide.stats.length; j += 4) {
+        final.push({ ...slide, stats: slide.stats.slice(j, j + 4), type: 'stats', title: j === 0 ? slide.title : slide.title + ' (cont.)' });
+      }
+    } else if (slide.type === 'content' && slide.body.length > 8) {
+      // Split long content
+      const mid = Math.ceil(slide.body.length / 2);
+      final.push({ ...slide, body: slide.body.slice(0, mid) });
+      final.push({ ...slide, body: slide.body.slice(mid), title: slide.title + ' (cont.)' });
+    } else {
+      final.push(slide);
+    }
+    
+    // Also break out table/chart as separate slides if they exist alongside stats
+    if (slide.table.length >= 2 && slide.type !== 'table') {
+      final.push({ title: slide.title + ' — Data', type: 'table', table: slide.table, body: [], stats: [], chart: [], bullets: [], timeline: [], comparisons: [], quote: null });
+    }
+    if (slide.chart.length >= 2 && slide.type !== 'chart') {
+      final.push({ title: slide.title + ' — Chart', type: 'chart', chart: slide.chart, body: [], stats: [], table: [], bullets: [], timeline: [], comparisons: [], quote: null });
+    }
+  }
+  
+  return final;
+}
+
+// ── Slide Renderers ──
+
+function addTitleSlide(pptx, title, subtitle, theme) {
+  const slide = pptx.addSlide();
+  const t = THEMES[theme] || THEMES.executive;
+  
+  slide.background = { fill: t.gradStart };
+  
+  // Accent bar top
+  slide.addShape(pptx.ShapeType.rect, { x: 0, y: 0, w: '100%', h: 0.06, fill: { color: t.accent } });
+  
+  // Decorative circle
+  slide.addShape(pptx.ShapeType.ellipse, {
+    x: 7.5, y: 2, w: 3.5, h: 3.5,
+    fill: { color: t.accent, transparency: 90 },
+    line: { color: t.accent, width: 2, transparency: 50 },
+  });
+  slide.addShape(pptx.ShapeType.ellipse, {
+    x: 8, y: 2.5, w: 2.5, h: 2.5,
+    fill: { color: t.accent2, transparency: 92 },
+    line: { color: t.accent2, width: 1, transparency: 60 },
+  });
+
+  slide.addText(title, {
+    x: 0.8, y: 1.5, w: 7, h: 2,
+    fontSize: 40, fontFace: 'Arial', color: t.text, bold: true,
+    lineSpacingMultiple: 1.1,
+  });
+  
+  if (subtitle) {
+    slide.addText(subtitle, {
+      x: 0.8, y: 3.5, w: 6, h: 0.6,
+      fontSize: 16, fontFace: 'Arial', color: t.subtle,
+    });
+  }
+  
+  // Bottom accent line
+  slide.addShape(pptx.ShapeType.rect, { x: 0.8, y: 3.2, w: 2, h: 0.05, fill: { color: t.accent } });
+  
+  // Footer
+  addFooter(slide, pptx, t, null, null);
+}
+
+function addStatsSlide(pptx, slideData, theme, slideNum, total) {
+  const slide = pptx.addSlide();
+  const t = THEMES[theme] || THEMES.executive;
+  
+  slide.background = { fill: t.bg };
+  addSlideHeader(slide, pptx, slideData.title, t);
+  
+  const stats = slideData.stats.slice(0, 6);
+  const cols = Math.min(stats.length, 3);
+  const rows = Math.ceil(stats.length / cols);
+  const cardW = 2.6;
+  const cardH = 1.6;
+  const gap = 0.3;
+  const startX = (10 - (cols * cardW + (cols - 1) * gap)) / 2;
+  const startY = rows > 1 ? 1.8 : 2.2;
+  
+  stats.forEach((stat, i) => {
+    const col = i % cols;
+    const row = Math.floor(i / cols);
+    const x = startX + col * (cardW + gap);
+    const y = startY + row * (cardH + gap);
+    
+    // Card background
+    slide.addShape(pptx.ShapeType.roundRect, {
+      x, y, w: cardW, h: cardH, rectRadius: 0.15,
+      fill: { color: t.cardBg },
+      line: { color: t.border, width: 1 },
+      shadow: { type: 'outer', blur: 6, offset: 2, color: '000000', opacity: 0.15 },
+    });
+    
+    // Icon
+    slide.addText(stat.icon || '📊', {
+      x, y: y + 0.15, w: cardW, h: 0.45,
+      fontSize: 24, align: 'center',
+    });
+    
+    // Value
+    slide.addText(stat.value, {
+      x, y: y + 0.55, w: cardW, h: 0.5,
+      fontSize: 26, fontFace: 'Arial', color: t.accent, bold: true, align: 'center',
+    });
+    
+    // Label
+    slide.addText(stat.label, {
+      x, y: y + 1.05, w: cardW, h: 0.35,
+      fontSize: 11, fontFace: 'Arial', color: t.subtle, align: 'center',
+    });
+  });
+  
+  // Add bullets below if they exist
+  if (slideData.bullets.length > 0) {
+    const bulletY = startY + rows * (cardH + gap) + 0.2;
+    const bulletText = slideData.bullets.map(b => ({ text: '  •  ' + b + '\n', options: { fontSize: 12, color: t.text } }));
+    slide.addText(bulletText, {
+      x: 0.8, y: bulletY, w: 8.4, h: 5 - bulletY,
+      fontFace: 'Arial', valign: 'top', lineSpacingMultiple: 1.4,
+    });
+  }
+  
+  addFooter(slide, pptx, t, slideNum, total);
+}
+
+function addTableSlide(pptx, slideData, theme, slideNum, total) {
+  const slide = pptx.addSlide();
+  const t = THEMES[theme] || THEMES.executive;
+  
+  slide.background = { fill: t.bg };
+  addSlideHeader(slide, pptx, slideData.title, t);
+  
+  if (slideData.table.length < 2) return;
+  
+  const headers = slideData.table[0];
+  const rows = slideData.table.slice(1);
+  const tableData = [headers, ...rows];
+  
+  const colW = Math.min(8.4 / headers.length, 3);
+  
+  slide.addTable(tableData.map((row, ri) => 
+    row.map(cell => ({
+      text: cell,
+      options: {
+        fontSize: ri === 0 ? 12 : 11,
+        fontFace: 'Arial',
+        color: ri === 0 ? 'FFFFFF' : t.text,
+        bold: ri === 0,
+        fill: { color: ri === 0 ? t.accent : (ri % 2 === 0 ? t.cardBg : t.bg) },
+        border: { type: 'solid', color: t.border, pt: 0.5 },
+        valign: 'middle',
+        align: 'center',
+        margin: [4, 6, 4, 6],
+      }
+    }))
+  ), {
+    x: 0.8, y: 1.8, w: 8.4,
+    autoPage: true,
+    autoPageRepeatHeader: true,
+  });
+  
+  addFooter(slide, pptx, t, slideNum, total);
+}
+
+function addChartSlide(pptx, slideData, theme, slideNum, total) {
+  const slide = pptx.addSlide();
+  const t = THEMES[theme] || THEMES.executive;
+  
+  slide.background = { fill: t.bg };
+  addSlideHeader(slide, pptx, slideData.title, t);
+  
+  const items = slideData.chart;
+  if (items.length === 0) return;
+  
+  const chartColors = [t.accent, t.accent2, 'D29922', 'F85149', 'BC8CFF', 'F778BA', 'A5D6FF', '7EE787'];
+  
+  // Determine chart type
+  const useDonut = items.length <= 6;
+  
+  if (useDonut) {
+    slide.addChart(pptx.charts.DOUGHNUT, [{
+      name: slideData.title,
+      labels: items.map(i => i.label),
+      values: items.map(i => i.value),
+    }], {
+      x: 0.8, y: 1.6, w: 5, h: 3.5,
+      showLegend: true, legendPos: 'r', legendFontSize: 11, legendColor: t.text,
+      chartColors: chartColors.slice(0, items.length),
+      dataLabelColor: 'FFFFFF', showPercent: true, dataLabelFontSize: 10,
+      holeSize: 55,
+    });
+  } else {
+    slide.addChart(pptx.charts.BAR, [{
+      name: slideData.title,
+      labels: items.map(i => i.label),
+      values: items.map(i => i.value),
+    }], {
+      x: 0.8, y: 1.6, w: 8.4, h: 3.5,
+      showLegend: false,
+      chartColors: [t.accent],
+      catAxisLabelColor: t.text, valAxisLabelColor: t.subtle,
+      catAxisLabelFontSize: 10, valAxisLabelFontSize: 9,
+      gridLineColor: t.border,
+      dataLabelColor: t.text, showValue: true, dataLabelFontSize: 9,
+      barDir: 'bar',
+    });
+  }
+  
+  addFooter(slide, pptx, t, slideNum, total);
+}
+
+function addBulletsSlide(pptx, slideData, theme, slideNum, total) {
+  const slide = pptx.addSlide();
+  const t = THEMES[theme] || THEMES.executive;
+  
+  slide.background = { fill: t.bg };
+  addSlideHeader(slide, pptx, slideData.title, t);
+  
+  const bullets = slideData.bullets;
+  
+  // Two-column layout if > 6 bullets
+  if (bullets.length > 6) {
+    const mid = Math.ceil(bullets.length / 2);
+    const left = bullets.slice(0, mid);
+    const right = bullets.slice(mid);
+    
+    [left, right].forEach((col, ci) => {
+      const x = ci === 0 ? 0.8 : 5.2;
+      col.forEach((b, bi) => {
+        const y = 1.8 + bi * 0.55;
+        slide.addShape(pptx.ShapeType.roundRect, {
+          x, y, w: 0.3, h: 0.3, rectRadius: 0.05,
+          fill: { color: t.accent, transparency: 80 },
+        });
+        slide.addText('✦', { x, y, w: 0.3, h: 0.3, fontSize: 10, align: 'center', color: t.accent });
+        slide.addText(b, { x: x + 0.4, y, w: 3.8, h: 0.5, fontSize: 12, fontFace: 'Arial', color: t.text, valign: 'middle' });
+      });
+    });
+  } else {
+    bullets.forEach((b, i) => {
+      const y = 1.8 + i * 0.65;
+      
+      // Accent dot
+      slide.addShape(pptx.ShapeType.ellipse, {
+        x: 1, y: y + 0.12, w: 0.16, h: 0.16,
+        fill: { color: t.accent },
+      });
+      
+      slide.addText(b, {
+        x: 1.4, y, w: 7.5, h: 0.5,
+        fontSize: 14, fontFace: 'Arial', color: t.text, valign: 'middle',
+      });
+    });
+  }
+  
+  addFooter(slide, pptx, t, slideNum, total);
+}
+
+function addQuoteSlide(pptx, slideData, theme, slideNum, total) {
+  const slide = pptx.addSlide();
+  const t = THEMES[theme] || THEMES.executive;
+  
+  slide.background = { fill: t.gradStart };
+  
+  // Big quote mark
+  slide.addText('"', {
+    x: 1, y: 1, w: 1.5, h: 1.5,
+    fontSize: 120, fontFace: 'Georgia', color: t.accent, transparency: 50,
+  });
+  
+  slide.addText(slideData.quote.trim(), {
+    x: 1.5, y: 2, w: 7, h: 2.5,
+    fontSize: 22, fontFace: 'Georgia', color: t.text, italic: true,
+    lineSpacingMultiple: 1.5, valign: 'middle',
+  });
+  
+  // Attribution line
+  slide.addShape(pptx.ShapeType.rect, { x: 1.5, y: 4.5, w: 1.5, h: 0.04, fill: { color: t.accent } });
+  
+  addFooter(slide, pptx, t, slideNum, total);
+}
+
+function addContentSlide(pptx, slideData, theme, slideNum, total) {
+  const slide = pptx.addSlide();
+  const t = THEMES[theme] || THEMES.executive;
+  
+  slide.background = { fill: t.bg };
+  addSlideHeader(slide, pptx, slideData.title, t);
+  
+  let y = 1.8;
+  for (const item of slideData.body) {
+    if (item.type === 'heading') {
+      slide.addText(item.text, {
+        x: 0.8, y, w: 8.4, h: 0.5,
+        fontSize: 18, fontFace: 'Arial', color: t.accent, bold: true,
+      });
+      y += 0.6;
+    } else {
+      slide.addText(item.text, {
+        x: 0.8, y, w: 8.4, h: 0.45,
+        fontSize: 12, fontFace: 'Arial', color: t.text, lineSpacingMultiple: 1.4,
+      });
+      y += 0.5;
+    }
+    if (y > 4.8) break;
+  }
+  
+  addFooter(slide, pptx, t, slideNum, total);
+}
+
+function addTimelineSlide(pptx, slideData, theme, slideNum, total) {
+  const slide = pptx.addSlide();
+  const t = THEMES[theme] || THEMES.executive;
+  
+  slide.background = { fill: t.bg };
+  addSlideHeader(slide, pptx, slideData.title, t);
+  
+  const items = slideData.timeline.slice(0, 5);
+  const stepW = 8 / items.length;
+  
+  // Horizontal line
+  slide.addShape(pptx.ShapeType.rect, {
+    x: 1, y: 2.8, w: 8, h: 0.04, fill: { color: t.accent },
+  });
+  
+  items.forEach((item, i) => {
+    const x = 1 + i * stepW + stepW / 2 - 0.5;
+    
+    // Circle node
+    slide.addShape(pptx.ShapeType.ellipse, {
+      x: x + 0.25, y: 2.6, w: 0.5, h: 0.5,
+      fill: { color: t.accent },
+      shadow: { type: 'outer', blur: 4, offset: 1, color: t.accent, opacity: 0.3 },
+    });
+    slide.addText(item.year, {
+      x: x + 0.25, y: 2.6, w: 0.5, h: 0.5,
+      fontSize: 10, fontFace: 'Arial', color: 'FFFFFF', bold: true, align: 'center', valign: 'middle',
+    });
+    
+    // Title + desc below
+    slide.addText(item.title, {
+      x: x - 0.2, y: 3.3, w: 1.4, h: 0.4,
+      fontSize: 11, fontFace: 'Arial', color: t.accent, bold: true, align: 'center',
+    });
+    slide.addText(item.desc, {
+      x: x - 0.3, y: 3.7, w: 1.6, h: 0.8,
+      fontSize: 9, fontFace: 'Arial', color: t.subtle, align: 'center', lineSpacingMultiple: 1.2,
+    });
+  });
+  
+  addFooter(slide, pptx, t, slideNum, total);
+}
+
+function addThankYouSlide(pptx, theme, brandName) {
+  const slide = pptx.addSlide();
+  const t = THEMES[theme] || THEMES.executive;
+  
+  slide.background = { fill: t.gradStart };
+  
+  // Decorative circles
+  slide.addShape(pptx.ShapeType.ellipse, {
+    x: 6.5, y: 0.5, w: 4, h: 4,
+    fill: { color: t.accent, transparency: 92 },
+    line: { color: t.accent, width: 2, transparency: 60 },
+  });
+  
+  slide.addText('Thank You', {
+    x: 0, y: 1.8, w: '100%', h: 1.2,
+    fontSize: 48, fontFace: 'Arial', color: t.text, bold: true, align: 'center',
+  });
+  
+  slide.addShape(pptx.ShapeType.rect, { x: 4.2, y: 3.1, w: 1.6, h: 0.05, fill: { color: t.accent } });
+  
+  slide.addText('Created with ' + (brandName || 'Squidclaw AI 🦑'), {
+    x: 0, y: 3.5, w: '100%', h: 0.5,
+    fontSize: 14, fontFace: 'Arial', color: t.subtle, align: 'center',
+  });
+}
+
+// ── Helpers ──
+
+function addSlideHeader(slide, pptx, title, t) {
+  // Top accent bar
+  slide.addShape(pptx.ShapeType.rect, { x: 0, y: 0, w: '100%', h: 0.05, fill: { color: t.accent } });
+  
+  // Title
+  slide.addText(title || '', {
+    x: 0.8, y: 0.3, w: 8.4, h: 0.8,
+    fontSize: 24, fontFace: 'Arial', color: t.text, bold: true,
+  });
+  
+  // Title underline
+  slide.addShape(pptx.ShapeType.rect, { x: 0.8, y: 1.15, w: 1.5, h: 0.04, fill: { color: t.accent } });
+}
+
+function addFooter(slide, pptx, t, num, total) {
+  const footerY = 5.15;
+  
+  // Footer line
+  slide.addShape(pptx.ShapeType.rect, { x: 0.5, y: footerY, w: 9, h: 0.01, fill: { color: t.border } });
+  
+  // Brand
+  slide.addText('Squidclaw AI 🦑', {
+    x: 0.5, y: footerY + 0.05, w: 3, h: 0.35,
+    fontSize: 9, fontFace: 'Arial', color: t.subtle,
+  });
+  
+  // Page number
+  if (num && total) {
+    slide.addText(num + ' / ' + total, {
+      x: 7.5, y: footerY + 0.05, w: 2, h: 0.35,
+      fontSize: 9, fontFace: 'Arial', color: t.subtle, align: 'right',
+    });
+  }
+}
+
+// ── Main Export ──
+
+export async function generatePresentation(input) {
+  mkdirSync(OUTPUT_DIR, { recursive: true });
+  
+  const {
+    title = 'Presentation',
+    subtitle = '',
+    content = '',
+    slides: rawSlides = null,
+    theme = 'executive',
+    brand = 'Squidclaw AI 🦑',
+  } = typeof input === 'string' ? { content: input, title: 'Presentation' } : input;
+  
+  const pptx = new PptxGenJS();
+  pptx.layout = 'LAYOUT_WIDE'; // 16:9
+  pptx.author = brand;
+  pptx.title = title;
+  
+  // Parse content into slides
+  const parsedSlides = rawSlides || parseMarkdownToSlides(content);
+  const totalSlides = parsedSlides.length + 2; // +title +thankyou
+  
+  // Title slide
+  addTitleSlide(pptx, title, subtitle || new Date().toLocaleDateString('en-US', { month: 'long', day: 'numeric', year: 'numeric' }), theme);
+  
+  // Content slides
+  parsedSlides.forEach((slideData, i) => {
+    const num = i + 2;
+    switch (slideData.type) {
+      case 'stats':
+      case 'stats-bullets':
+        addStatsSlide(pptx, slideData, theme, num, totalSlides); break;
+      case 'table':
+        addTableSlide(pptx, slideData, theme, num, totalSlides); break;
+      case 'chart':
+        addChartSlide(pptx, slideData, theme, num, totalSlides); break;
+      case 'bullets':
+        addBulletsSlide(pptx, slideData, theme, num, totalSlides); break;
+      case 'quote':
+        addQuoteSlide(pptx, slideData, theme, num, totalSlides); break;
+      case 'timeline':
+        addTimelineSlide(pptx, slideData, theme, num, totalSlides); break;
+      default:
+        addContentSlide(pptx, slideData, theme, num, totalSlides); break;
+    }
+  });
+  
+  // Thank you slide
+  addThankYouSlide(pptx, theme, brand);
+  
+  const filename = title.replace(/[^a-zA-Z0-9 ]/g, '').replace(/\s+/g, '_').slice(0, 50) + '.pptx';
+  const filepath = join(OUTPUT_DIR, filename);
+  
+  await pptx.writeFile({ fileName: filepath });
+  
+  logger.info('pptx-pro', `Generated: ${filepath} (${parsedSlides.length + 2} slides, theme: ${theme})`);
+  
+  return {
+    filepath,
+    filename,
+    slides: parsedSlides.length + 2,
+    theme,
+    types: [...new Set(parsedSlides.map(s => s.type))],
+  };
+}
+
+export { parseMarkdownToSlides, THEMES };