lazyslides 0.1.0

package/lib/renumber.js

@@ -0,0 +1,181 @@
+import fs from "node:fs";
+import path from "node:path";
+
+function extractSlideTitle(lines, templateIdx) {
+  let title = null;
+  let subtitle = null;
+  let templateType = null;
+
+  const templateMatch = lines[templateIdx].match(/template:\s*(\w+)/);
+  if (templateMatch) templateType = templateMatch[1];
+
+  for (let idx = templateIdx + 1; idx < lines.length; idx++) {
+    const line = lines[idx];
+    if (/^\s*-\s*template:/.test(line)) break;
+
+    const titleMatch = line.match(/^\s+title:\s*(.+)$/);
+    if (titleMatch) {
+      title = titleMatch[1].trim();
+      if ((title.startsWith('"') && title.endsWith('"')) || (title.startsWith("'") && title.endsWith("'"))) {
+        title = title.slice(1, -1);
+      }
+      title = title.replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
+    }
+
+    const subtitleMatch = line.match(/^\s+subtitle:\s*(.+)$/);
+    if (subtitleMatch) {
+      subtitle = subtitleMatch[1].trim();
+      if ((subtitle.startsWith('"') && subtitle.endsWith('"')) || (subtitle.startsWith("'") && subtitle.endsWith("'"))) {
+        subtitle = subtitle.slice(1, -1);
+      }
+    }
+  }
+
+  if (templateType === "section" && title && subtitle) {
+    return `${title} \u2014 ${subtitle}`;
+  }
+  return title || "Untitled";
+}
+
+export function renumberFile(file) {
+  let lines = fs.readFileSync(file, "utf-8").split("\n");
+
+  // First pass: find all template line positions and their slide numbers
+  let templateLines = {};
+  let slideCounter = 0;
+
+  lines.forEach((line, idx) => {
+    if (/^\s*-\s*template:/.test(line)) {
+      slideCounter++;
+      templateLines[idx] = slideCounter;
+    }
+  });
+
+  if (slideCounter === 0) {
+    console.log(`  No slides found in ${file}`);
+    return false;
+  }
+
+  // Second pass: find which slides have comments
+  const slidesWithComments = {};
+  lines.forEach((line, idx) => {
+    if (/^(\s*#\s*Slide)\s*(\d*):\s*(.*)$/.test(line)) {
+      for (let futureIdx = idx + 1; futureIdx < lines.length; futureIdx++) {
+        if (templateLines[futureIdx] !== undefined) {
+          slidesWithComments[futureIdx] = idx;
+          break;
+        }
+      }
+    }
+  });
+
+  // Third pass: add missing comments (work backwards to preserve line indices)
+  let insertions = 0;
+  const sortedKeys = Object.keys(templateLines).map(Number).sort((a, b) => b - a);
+
+  for (const templateIdx of sortedKeys) {
+    const slideNum = templateLines[templateIdx];
+    if (slidesWithComments[templateIdx] === undefined) {
+      const title = extractSlideTitle(lines, templateIdx);
+      const comment = `# Slide ${slideNum}: ${title}`;
+      lines.splice(templateIdx, 0, comment);
+      insertions++;
+      console.log(`  Added: # Slide ${slideNum}: ${title}`);
+    }
+  }
+
+  // Fourth pass: rebuild templateLines if insertions happened
+  if (insertions > 0) {
+    templateLines = {};
+    slideCounter = 0;
+    lines.forEach((line, idx) => {
+      if (/^\s*-\s*template:/.test(line)) {
+        slideCounter++;
+        templateLines[idx] = slideCounter;
+      }
+    });
+  }
+
+  // Fifth pass: renumber all comments
+  let changes = 0;
+  lines.forEach((line, idx) => {
+    const match = line.match(/^(\s*#\s*Slide)\s*(\d*):\s*(.*)$/);
+    if (match) {
+      const prefix = match[1];
+      const oldNum = match[2];
+      const rest = match[3];
+
+      let nextSlideNum = null;
+      for (let futureIdx = idx + 1; futureIdx < lines.length; futureIdx++) {
+        if (templateLines[futureIdx] !== undefined) {
+          nextSlideNum = templateLines[futureIdx];
+          break;
+        }
+      }
+
+      if (nextSlideNum !== null) {
+        const newLine = `${prefix} ${nextSlideNum}: ${rest}`;
+        if (lines[idx] !== newLine) {
+          console.log(`  Line ${idx + 1}: '# Slide ${oldNum}:' -> '# Slide ${nextSlideNum}:'`);
+          lines[idx] = newLine;
+          changes++;
+        }
+      }
+    }
+  });
+
+  if (changes > 0 || insertions > 0) {
+    fs.writeFileSync(file, lines.join("\n"));
+    console.log(`  \u2713 Updated ${file}: ${insertions} comment(s) added, ${changes} renumbered`);
+    return true;
+  } else {
+    console.log(`  No changes needed in ${file}`);
+    return false;
+  }
+}
+
+/**
+ * Renumber slide comments in presentation YAML files.
+ * @param {object} [opts]
+ * @param {string} [opts.cwd] - working directory (defaults to process.cwd())
+ * @param {string[]} [opts.files] - specific files to process
+ */
+export async function run(opts = {}) {
+  const cwd = opts.cwd || process.cwd();
+
+  if (opts.files && opts.files.length > 0) {
+    for (const file of opts.files) {
+      if (!fs.existsSync(file)) {
+        throw new Error(`File not found: ${file}`);
+      }
+      console.log(`Renumbering: ${file}`);
+      renumberFile(file);
+    }
+    return;
+  }
+
+  const dir = path.join(cwd, "presentations");
+  if (!fs.existsSync(dir)) {
+    console.log(`No presentations directory found at ${dir}`);
+    return;
+  }
+
+  const files = fs.readdirSync(dir, { withFileTypes: true })
+    .filter((e) => e.isDirectory() && e.name !== "_template")
+    .map((e) => path.join(dir, e.name, "index.md"))
+    .filter((f) => fs.existsSync(f));
+
+  if (files.length === 0) {
+    console.log(`No presentation files found in ${dir}`);
+    return;
+  }
+
+  let totalUpdated = 0;
+  for (const file of files) {
+    console.log(`Renumbering: ${file}`);
+    if (renumberFile(file)) totalUpdated++;
+  }
+
+  console.log("\n" + "=".repeat(50));
+  console.log(`Renumbering complete: ${files.length} file(s) processed, ${totalUpdated} updated`);
+}

package/lib/validate.js

@@ -0,0 +1,196 @@
+import fs from "node:fs";
+import path from "node:path";
+import yaml from "js-yaml";
+
+const REQUIRED_FIELDS = ["title", "slides"];
+const VALID_TEMPLATES = [
+  "title", "section", "content", "metrics", "comparison", "columns",
+  "quote", "center", "hero", "image-overlay", "code", "timeline",
+  "funnel", "split", "split-wide", "table", "agenda",
+];
+
+function findPresentations(dir) {
+  const results = [];
+  if (!fs.existsSync(dir)) return results;
+
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (!entry.isDirectory() || entry.name === "_template") continue;
+    const indexPath = path.join(dir, entry.name, "index.md");
+    if (fs.existsSync(indexPath)) {
+      results.push(indexPath);
+    }
+  }
+  return results;
+}
+
+/**
+ * Validate all presentation YAML files.
+ * @param {object} [opts]
+ * @param {string} [opts.cwd] - working directory (defaults to process.cwd())
+ * @param {boolean} [opts.renumber] - run renumber before validating
+ * @returns {{ errors: string[], warnings: string[], validated: number }}
+ */
+export async function run(opts = {}) {
+  const cwd = opts.cwd || process.cwd();
+  const presentationsDir = path.join(cwd, "presentations");
+
+  if (opts.renumber) {
+    const { run: renumber } = await import("./renumber.js");
+    await renumber({ cwd });
+  }
+
+  const errors = [];
+  const warnings = [];
+  let validated = 0;
+
+  const files = findPresentations(presentationsDir);
+
+  for (const file of files) {
+    console.log(`Validating: ${file}`);
+    validated++;
+
+    try {
+      const content = fs.readFileSync(file, "utf-8");
+
+      // Check: Comment-hidden slide detection
+      content.split("\n").forEach((line, idx) => {
+        if (/#.*-\s*template:/.test(line)) {
+          warnings.push(`${file}:${idx + 1}: Possible slide definition hidden in comment`);
+        }
+      });
+
+      // Extract front matter
+      const match = content.match(/^---\s*\n([\s\S]*?)\n---/);
+      if (!match) {
+        errors.push(`${file}: No valid YAML front matter found`);
+        continue;
+      }
+
+      const data = yaml.load(match[1]);
+
+      // Check required fields
+      for (const field of REQUIRED_FIELDS) {
+        if (!(field in data)) {
+          errors.push(`${file}: Missing required field '${field}'`);
+        }
+      }
+
+      // Validate slides array
+      if (data.slides) {
+        if (!Array.isArray(data.slides)) {
+          errors.push(`${file}: 'slides' must be an array`);
+          continue;
+        }
+
+        const sections = [];
+
+        data.slides.forEach((slide, idx) => {
+          const slideNum = idx + 1;
+
+          if (!slide.template) {
+            errors.push(`${file}: Slide ${slideNum} missing 'template' field`);
+            return;
+          }
+
+          if (!VALID_TEMPLATES.includes(slide.template)) {
+            warnings.push(`${file}: Slide ${slideNum} has unknown template '${slide.template}'`);
+          }
+
+          if (slide.template === "section") {
+            sections.push({ title: slide.title, start: slideNum });
+          }
+
+          if (!slide.title && !["quote"].includes(slide.template)) {
+            warnings.push(`${file}: Slide ${slideNum} (${slide.template}) missing 'title'`);
+          }
+
+          // Comparison template structure validation
+          if (slide.template === "comparison") {
+            if (!slide.rows) {
+              errors.push(`${file}: Slide ${slideNum} (comparison) missing 'rows:' - comparison template requires rows format`);
+            }
+            if ((slide.left && typeof slide.left === "object") || (slide.right && typeof slide.right === "object")) {
+              errors.push(`${file}: Slide ${slideNum} (comparison) uses wrong format - use 'rows:' with left/right pairs, not nested left:/right: objects`);
+            }
+          }
+
+          // Image path validation
+          if (slide.image) {
+            const imagePath = slide.image;
+            if (imagePath.includes("../")) {
+              warnings.push(`${file}: Slide ${slideNum} image path contains '../'`);
+            }
+            const presentationDir = path.dirname(file);
+            const fullImagePath = path.join(presentationDir, imagePath);
+            if (!fs.existsSync(fullImagePath)) {
+              warnings.push(`${file}: Slide ${slideNum} missing image '${imagePath}'`);
+            }
+          }
+        });
+
+        // Expected slide count
+        if (data.expected_slides && data.slides.length !== data.expected_slides) {
+          warnings.push(`${file}: Expected ${data.expected_slides} slides, found ${data.slides.length}`);
+        }
+
+        // Section index output
+        if (sections.length > 0) {
+          console.log("");
+          console.log("  SECTIONS:");
+          console.log("  " + "\u2500".repeat(50));
+
+          sections.forEach((section, idx) => {
+            const endSlide = idx + 1 < sections.length
+              ? sections[idx + 1].start - 1
+              : data.slides.length;
+
+            const title = section.title || "(untitled section)";
+            const range = `[slides ${section.start}-${endSlide}]`;
+            console.log(`  ${title.padEnd(42)} ${range}`);
+          });
+        }
+
+        // Slide listing output
+        console.log("");
+        console.log("  SLIDES:");
+        console.log("  " + "\u2500".repeat(50));
+
+        data.slides.forEach((slide, idx) => {
+          const slideNum = idx + 1;
+          const template = slide.template || "???";
+          let title = slide.title || slide.text || slide.headline || "(no title)";
+          if (title.length > 48) title = title.substring(0, 45) + "...";
+          console.log(`  ${String(slideNum).padStart(3)}. [${template}] ${title}`);
+        });
+
+        console.log("");
+        console.log(`  \u2713 ${data.slides.length} slides validated`);
+      }
+    } catch (e) {
+      if (e.name === "YAMLException") {
+        errors.push(`${file}: YAML syntax error - ${e.message}`);
+      } else {
+        errors.push(`${file}: ${e.constructor.name} - ${e.message}`);
+      }
+    }
+  }
+
+  console.log("\n" + "=".repeat(50));
+  console.log(`Validation complete: ${validated} presentation(s)`);
+
+  if (warnings.length > 0) {
+    console.log(`\n\u26A0\uFE0F  Warnings (${warnings.length}):`);
+    warnings.forEach((w) => console.log(`   ${w}`));
+  }
+
+  if (errors.length > 0) {
+    console.log(`\n\u274C Errors (${errors.length}):`);
+    errors.forEach((e) => console.log(`   ${e}`));
+    console.log("\nBuild may fail or skip files with errors!");
+  } else {
+    console.log("\n\u2705 All presentations valid");
+  }
+
+  return { errors, warnings, validated };
+}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "lazyslides",
+  "version": "0.1.0",
+  "description": "AI-native presentations from YAML — Eleventy plugin with Reveal.js",
+  "license": "MIT",
+  "author": "Chris Tietz",
+  "keywords": [
+    "presentations",
+    "slides",
+    "reveal.js",
+    "eleventy",
+    "yaml",
+    "tailwind",
+    "ai",
+    "claude",
+    "slide-deck"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Chrisissorry/lazyslides.git"
+  },
+  "homepage": "https://github.com/Chrisissorry/lazyslides",
+  "bugs": {
+    "url": "https://github.com/Chrisissorry/lazyslides/issues"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "type": "module",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js",
+    "./styles.css": "./src/styles.css"
+  },
+  "bin": {
+    "lazyslides": "./cli.js"
+  },
+  "files": [
+    "index.js",
+    "cli.js",
+    "lib/",
+    "_layouts/",
+    "_includes/",
+    "assets/",
+    "src/",
+    "scaffold/",
+    "data/"
+  ],
+  "peerDependencies": {
+    "@11ty/eleventy": "^3.0.0"
+  },
+  "dependencies": {
+    "js-yaml": "^4.1.0"
+  },
+  "devDependencies": {
+    "@11ty/eleventy": "^3.0.0",
+    "@tailwindcss/cli": "^4.0.0",
+    "concurrently": "^9.0.0",
+    "decktape": "^3.14.0",
+    "tailwindcss": "^4.1.18",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "dev": "node cli.js validate && concurrently \"pnpm:watch:*\"",
+    "watch:css": "pnpm exec tailwindcss -i src/styles.css -o _site/assets/css/styles.css --watch",
+    "watch:11ty": "pnpm exec eleventy --serve",
+    "build": "node cli.js validate && pnpm run build:css && pnpm run build:11ty",
+    "build:css": "pnpm exec tailwindcss -i src/styles.css -o _site/assets/css/styles.css",
+    "build:11ty": "pnpm exec eleventy",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "validate": "node cli.js validate",
+    "renumber": "node cli.js renumber",
+    "pdf": "node cli.js pdf"
+  }
+}