canva-pptx 1.0.0

package/src/system/smartText.js

@@ -0,0 +1,44 @@
+function addSmartText(slide, text, options = {}) {
+  const {
+    x = 1, y = 1, w = 4, h = 2,
+    maxFontSize = 24,
+    minFontSize = 8,
+    color = "000000"
+  } = options;
+
+  // Heuristic: Area = w * h
+  // Text Area needed ~= charCount * (fontSize * 0.6) * (fontSize * 1.2)
+  // This is an estimation loop.
+  
+  let currentSize = maxFontSize;
+  const chars = text.length;
+  
+  // Reduce font size until it theoretically fits
+  while (currentSize > minFontSize) {
+    // Approx char width ~0.5 of font height (variable width fonts vary, but average)
+    // Approx line height ~1.2 of font height
+    // Max chars per line = w / (currentSize converted to inches approx)
+    // 1 pt = 1/72 inch
+    
+    const charW_inch = (currentSize / 72) * 0.5;
+    const lineH_inch = (currentSize / 72) * 1.2;
+    
+    const charsPerLine = Math.floor(w / charW_inch);
+    const linesNeeded = Math.ceil(chars / charsPerLine);
+    const totalHeightNeeded = linesNeeded * lineH_inch;
+
+    if (totalHeightNeeded <= h) {
+      break; 
+    }
+    
+    currentSize -= 1;
+  }
+
+  slide.addText(text, {
+    x, y, w, h,
+    fontSize: currentSize,
+    color
+  });
+}
+
+module.exports = { addSmartText };

package/src/system/speakerNotes.js

@@ -0,0 +1,12 @@
+/**
+ * Adds speaker notes to a slide.
+ * These are visible in "Presenter View" but not on the main screen.
+ */
+function addSpeakerNotes(slide, notes) {
+  if (!slide || !notes) return;
+  
+  // pptxgenjs has a native addNotes method
+  slide.addNotes(notes);
+}
+
+module.exports = { addSpeakerNotes };

package/src/system/syntaxHighlighter.js

@@ -0,0 +1,71 @@
+/**
+ * Renders a code block with syntax coloring (Basic JS support).
+ */
+function addSyntaxBlock(slide, code, options = {}) {
+  const {
+    x = 1, y = 1, w = 6, h = 3,
+    fontSize = 11,
+    background = "1E1E1E"
+  } = options;
+
+  // Draw Background
+  slide.addShape("rect", { x, y, w, h, fill: background });
+
+  // Simple Tokenizer (Regex based)
+  const tokens = [];
+  const lines = code.split("\n");
+  
+  // Colors (VS Code Dark theme style)
+  const C_KEYWORD = "569CD6"; // Blue
+  const C_STRING = "CE9178";  // Orange
+  const C_COMMENT = "6A9955"; // Green
+  const C_DEFAULT = "D4D4D4"; // Grey
+  const C_FUNCTION = "DCDCAA"; // Yellow
+
+  // Regex Patterns
+  const reKeyword = /\b(const|let|var|function|return|if|else|for|while|import|from|class)\b/g;
+  const reString = /(['"`].*?['"`])/g;
+  const reComment = /(\/\/.*)/g;
+  const reFunction = /\b([a-zA-Z0-9_]+)(?=\()/g; 
+
+  let currentY = y + 0.2;
+  const lineHeight = fontSize * 0.003; // Approximate conversion
+
+  lines.forEach(line => {
+    // We break the line into simple text objects for the slide
+    // Note: To do this perfectly inline is hard in PPTX without rich text array.
+    // We will construct a rich text array for the line.
+    
+    let parts = [];
+    let lastIndex = 0;
+
+    // Very naive parser: Identify the *first* match type for simplicity in this demo.
+    // A real parser would tokenize character by character. 
+    // Here we will just color the whole line if it's a comment, 
+    // otherwise default (Full syntax highlighting requires complex state machine).
+    
+    if (line.trim().startsWith("//")) {
+       slide.addText(line, { x: x+0.2, y: currentY, w: w-0.4, h: lineHeight, fontSize, color: C_COMMENT, fontFace: "Courier New" });
+    } else {
+       // Check for keywords to color (simplified: only highlights if word is isolated)
+       // This is a "Pseudo-Highlighter" for the sake of the library size.
+       const textObjs = [];
+       const words = line.split(/(\s+|[(){},.])/); // Split by delimiters
+       
+       words.forEach(word => {
+         let color = C_DEFAULT;
+         if (reKeyword.test(word)) color = C_KEYWORD;
+         else if (reString.test(word)) color = C_STRING;
+         else if (reFunction.test(word)) color = C_FUNCTION;
+         
+         textObjs.push({ text: word, options: { color: color, fontSize, fontFace: "Courier New" } });
+       });
+
+       slide.addText(textObjs, { x: x+0.2, y: currentY, w: w-0.4, h: lineHeight, align:'left' });
+    }
+    
+    currentY += 0.25; // Line height spacing
+  });
+}
+
+module.exports = { addSyntaxBlock };

package/src/system/themeGenerator.js

@@ -0,0 +1,25 @@
+/**
+ * Generates a tonal palette (Light, Dark, Muted) from a single HEX color.
+ * Useful for auto-generating themes that look consistent.
+ */
+function generateTheme(baseColorHex) {
+  // Simple helper to adjust brightness
+  // (In a prod env, use a library like 'chroma-js' or 'tinycolor2')
+  
+  const adjust = (hex, amount) => {
+    return "#" + hex.replace(/^#/, '').replace(/../g, color => {
+      const val = parseInt(color, 16);
+      return Math.min(255, Math.max(0, val + amount)).toString(16).padStart(2, '0');
+    });
+  };
+
+  return {
+    primary: baseColorHex,
+    light: adjust(baseColorHex, 150), // Tint (Backgrounds)
+    dark: adjust(baseColorHex, -50),  // Shade (Text)
+    muted: adjust(baseColorHex, 80),  // Soft accent
+    border: "E0E0E0"
+  };
+}
+
+module.exports = { generateTheme };

package/src/system/tocGenerator.js

@@ -0,0 +1,68 @@
+/**
+ * TOC Generator System
+ * Tracks sections and generates an Agenda slide.
+ */
+
+// Private storage for the session
+let sections = [];
+
+/**
+ * Registers a section for the Table of Contents.
+ * Call this when adding a new slide that should appear in the TOC.
+ * @param {string} title - The title of the section.
+ * @param {number} slideIndex - The index of the slide (1-based).
+ */
+function addToTOC(title, slideIndex) {
+  sections.push({ title, slide: slideIndex });
+}
+
+/**
+ * Renders the Table of Contents slide.
+ * Usually called at the end of the presentation generation, 
+ * but inserted at the beginning.
+ * @param {object} manager - The PPTManager instance.
+ * @param {object} options - Options { title, x, y, color }.
+ */
+function addTableOfContents(manager, options = {}) {
+  const { 
+    title = "Agenda", 
+    x = 1, 
+    y = 1.5, 
+    color = "007AFF" 
+  } = options;
+
+  const pptx = manager.getPptx();
+  
+  // Create a new slide
+  const slide = pptx.addSlide();
+  
+  // Title
+  slide.addText(title, { 
+    x: 1, y: 0.5, fontSize: 32, bold: true, color: "111111" 
+  });
+
+  // Render List
+  sections.forEach((section, index) => {
+    slide.addText(`${index + 1}. ${section.title}`, {
+      x: x,
+      y: y + index * 0.6,
+      w: 8,
+      h: 0.5,
+      fontSize: 18,
+      color: color,
+      // Hyperlink to the specific slide number
+      hyperlink: { slide: section.slide } 
+    });
+  });
+
+  // Optional: Logic to move this slide to index 1 could go here 
+  // if the underlying library supports reordering.
+  // For now, it appends a slide. Users usually create this first or last.
+}
+
+// Reset function if you need to clear memory between requests
+function resetTOC() {
+  sections = [];
+}
+
+module.exports = { addToTOC, addTableOfContents, resetTOC };

package/src/system/watermark.js

@@ -0,0 +1,26 @@
+/**
+ * Adds a watermark to a slide.
+ */
+function addWatermark(slide, text = "CONFIDENTIAL", options = {}) {
+  const { 
+    color = "CCCCCC", 
+    opacity = 20, // 0-100 transparency
+    rotate = -45,
+    fontSize = 60
+  } = options;
+
+  slide.addText(text, {
+    x: 1, 
+    y: 2, 
+    w: 8, 
+    h: 2,
+    color: color,
+    transparency: 100 - opacity, // PptxGenJS uses 'transparency' %
+    rotate: rotate,
+    align: "center",
+    fontSize: fontSize,
+    bold: true
+  });
+}
+
+module.exports = { addWatermark };

package/src/themes/index.js

@@ -0,0 +1,93 @@
+/**
+ * Theme System
+ * Pre-defined themes and utilities for custom branding.
+ */
+
+const themes = {
+  minimal: {
+    background: "FFFFFF",
+    heading: {
+      fontSize: 28,
+      color: "111111",
+      bold: true,
+      fontFace: "Arial",
+    },
+    body: {
+      fontSize: 16,
+      color: "444444",
+      fontFace: "Arial",
+    },
+    accent: "E5E7EB",
+  },
+
+  brand: {
+    background: "F8FAFC",
+    heading: {
+      fontSize: 30,
+      color: "0F172A",
+      bold: true,
+      fontFace: "Helvetica",
+    },
+    body: {
+      fontSize: 16,
+      color: "334155",
+      fontFace: "Helvetica",
+    },
+    accent: "2563EB",
+  },
+
+  dark: {
+    background: "020617",
+    heading: {
+      fontSize: 30,
+      color: "FFFFFF",
+      bold: true,
+      fontFace: "Verdana",
+    },
+    body: {
+      fontSize: 16,
+      color: "CBD5E1",
+      fontFace: "Verdana",
+    },
+    accent: "38BDF8",
+  },
+};
+
+/**
+ * Register a custom brand theme.
+ * Merges user options with the 'minimal' theme to ensure all properties exist.
+ */
+function registerTheme(name, customOptions) {
+  // Deep merge logic (simplified)
+  themes[name] = {
+    ...themes.minimal,
+    ...customOptions,
+    heading: { ...themes.minimal.heading, ...customOptions.heading },
+    body: { ...themes.minimal.body, ...customOptions.body },
+  };
+}
+
+/**
+ * Retrieves a theme by name OR normalizes a custom theme object.
+ * @param {string|object} nameOrObject - Theme name ("brand") or direct object.
+ */
+function getTheme(nameOrObject = "minimal") {
+  // 1. If user passes an object (ad-hoc theme), merge it with default and return
+  if (typeof nameOrObject === "object") {
+    return {
+      ...themes.minimal,
+      ...nameOrObject,
+      heading: { ...themes.minimal.heading, ...nameOrObject.heading },
+      body: { ...themes.minimal.body, ...nameOrObject.body },
+    };
+  }
+
+  // 2. If user passes a name, return registered theme or default
+  return themes[nameOrObject] || themes.minimal;
+}
+
+module.exports = {
+  getTheme,
+  registerTheme,
+  themes,
+};