lazyslides 0.1.0

package/cli.js

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+const HELP = `
+Usage: lazyslides <command> [options]
+
+Commands:
+  init [dir]       Scaffold a new LazySlides project
+  validate         Validate presentation YAML files
+  renumber [file]  Renumber slide comments
+  pdf [name]       Export presentations to PDF
+
+Options:
+  --help           Show this help message
+  --version        Show version number
+`;
+
+async function main() {
+  if (!command || command === "--help" || command === "-h") {
+    console.log(HELP.trim());
+    process.exit(0);
+  }
+
+  if (command === "--version" || command === "-v") {
+    const { createRequire } = await import("node:module");
+    const require = createRequire(import.meta.url);
+    const pkg = require("./package.json");
+    console.log(pkg.version);
+    process.exit(0);
+  }
+
+  switch (command) {
+    case "init": {
+      const dir = args[1];
+      if (!dir) {
+        console.error("Error: Please specify a project directory.\n");
+        console.error("  lazyslides init my-deck");
+        process.exit(1);
+      }
+      const { run } = await import("./lib/init.js");
+      await run({ dir });
+      break;
+    }
+
+    case "validate": {
+      const { run } = await import("./lib/validate.js");
+      const result = await run({
+        renumber: args.includes("--renumber"),
+      });
+      if (result.errors.length > 0) process.exit(1);
+      break;
+    }
+
+    case "renumber": {
+      const { run } = await import("./lib/renumber.js");
+      const files = args.slice(1).filter((a) => !a.startsWith("--"));
+      await run({ files: files.length > 0 ? files : undefined });
+      break;
+    }
+
+    case "pdf": {
+      const { run } = await import("./lib/export-pdf.js");
+      const name = args[1];
+      await run({ name });
+      break;
+    }
+
+    default:
+      console.error(`Unknown command: ${command}\n`);
+      console.log(HELP.trim());
+      process.exit(1);
+  }
+}
+
+main().catch((err) => {
+  console.error(err.message);
+  process.exit(1);
+});

package/data/site.json

@@ -0,0 +1,3 @@
+{
+  "title": "LazySlides"
+}

package/index.js

@@ -0,0 +1,153 @@
+import path from "node:path";
+import fs from "node:fs";
+import { fileURLToPath } from "node:url";
+
+const pkgRoot = path.dirname(fileURLToPath(import.meta.url));
+
+/**
+ * LazySlides Eleventy plugin.
+ *
+ * Registers layouts, templates, assets, filters, and a virtual
+ * presentations index page so that a user project only needs a
+ * six-line eleventy.config.js to get the full engine.
+ */
+export default function lazyslides(eleventyConfig, options = {}) {
+  // ---------------------------------------------------------------
+  // 1. Filters & Nunjucks test (unchanged logic from .eleventy.js)
+  // ---------------------------------------------------------------
+  eleventyConfig.addFilter("resolveImage", (src) => {
+    if (!src || src.includes("://") || src.startsWith("/")) return src;
+    return "../" + src;
+  });
+
+  eleventyConfig.addFilter("isMapping", (val) => {
+    return val !== null && typeof val === "object" && !Array.isArray(val);
+  });
+
+  // ---------------------------------------------------------------
+  // 2. Nunjucks search paths — makes {% include "slides/…" %} and
+  //    layout: presentation.njk resolve to files inside the package.
+  //    User-local paths are searched first (Eleventy default) so
+  //    users can override any template.
+  // ---------------------------------------------------------------
+  eleventyConfig.amendLibrary("njk", (env) => {
+    // Register the "mapping" test
+    env.addTest("mapping", (val) => {
+      return val !== null && typeof val === "object" && !Array.isArray(val);
+    });
+
+    // Add package paths *after* the user's local paths
+    env.loaders[0].searchPaths.push(path.join(pkgRoot, "_includes"));
+    env.loaders[0].searchPaths.push(path.join(pkgRoot, "_layouts"));
+  });
+
+  // ---------------------------------------------------------------
+  // 3. Passthrough copies — map engine assets to output
+  // ---------------------------------------------------------------
+  const realPkgRoot = fs.realpathSync(pkgRoot);
+
+  eleventyConfig.addPassthroughCopy({
+    [path.join(realPkgRoot, "assets/reveal.js")]: "assets/reveal.js",
+  });
+  eleventyConfig.addPassthroughCopy({
+    [path.join(realPkgRoot, "assets/css/themes")]: "assets/css/themes",
+  });
+  eleventyConfig.addPassthroughCopy({
+    [path.join(realPkgRoot, "assets/css/vendor")]: "assets/css/vendor",
+  });
+  eleventyConfig.addPassthroughCopy({
+    [path.join(realPkgRoot, "assets/js/vendor")]: "assets/js/vendor",
+  });
+
+  // User's local theme overrides
+  eleventyConfig.addPassthroughCopy({
+    "themes/": "assets/css/themes/",
+  });
+
+  // Per-presentation images
+  eleventyConfig.addPassthroughCopy("presentations/*/images");
+
+  // ---------------------------------------------------------------
+  // 3b. Collection — only index.md files are presentations
+  // ---------------------------------------------------------------
+  eleventyConfig.addCollection("presentations", (collectionApi) => {
+    return collectionApi.getFilteredByGlob("presentations/*/index.md");
+  });
+
+  // ---------------------------------------------------------------
+  // 4. Global data — site.title with option override
+  // ---------------------------------------------------------------
+  const siteData = JSON.parse(
+    fs.readFileSync(path.join(realPkgRoot, "data/site.json"), "utf-8")
+  );
+  eleventyConfig.addGlobalData("site", {
+    title: options.siteTitle || siteData.title,
+    ...options.siteData,
+  });
+
+  // ---------------------------------------------------------------
+  // 5. Virtual layouts — loaded from the package so users don't
+  //    need _layouts/ locally (but can override by creating one)
+  // ---------------------------------------------------------------
+  const layoutsDir = path.join(realPkgRoot, "_layouts");
+  for (const file of fs.readdirSync(layoutsDir)) {
+    if (!file.endsWith(".njk")) continue;
+    const content = fs.readFileSync(path.join(layoutsDir, file), "utf-8");
+    eleventyConfig.addTemplate(`_layouts/${file}`, content);
+  }
+
+  // ---------------------------------------------------------------
+  // 6. Virtual template — presentations index page
+  // ---------------------------------------------------------------
+  eleventyConfig.addTemplate("presentations-index.njk", `---
+layout: default.njk
+title: Presentations
+permalink: /presentations/
+---
+
+<div style="text-align: center; margin-bottom: 2rem;">
+  <h1 style="font-family: 'Source Serif 4', Georgia, serif; font-size: 2rem; font-weight: 700; color: #0f172a; margin-bottom: 0.5rem;">LazySlides</h1>
+  <p style="color: #64748b; font-size: 1rem;">AI-native presentations from YAML. Powered by Eleventy + Reveal.js + Tailwind CSS.</p>
+</div>
+
+<div style="display: grid; grid-template-columns: repeat(auto-fill, minmax(280px, 1fr)); gap: 1.5rem; margin-bottom: 3rem;">
+  {% for presentation in collections.presentations %}
+  <a href="{{ presentation.url | url }}" style="display: block; padding: 1.5rem; border: 1px solid #e2e8f0; border-radius: 8px; text-decoration: none; transition: all 0.2s ease; background: white;">
+    <h2 style="font-family: 'Source Serif 4', Georgia, serif; font-size: 1.1rem; font-weight: 600; color: #0f172a; margin: 0 0 0.5rem 0;">{{ presentation.data.title }}</h2>
+    {% if presentation.data.description %}
+    <p style="font-size: 0.85rem; color: #64748b; margin: 0;">{{ presentation.data.description }}</p>
+    {% endif %}
+  </a>
+  {% endfor %}
+</div>
+`);
+
+  // ---------------------------------------------------------------
+  // 6b. Virtual template — root redirect to presentations index
+  // ---------------------------------------------------------------
+  eleventyConfig.addTemplate("root-redirect.njk", `---
+permalink: /index.html
+eleventyExcludeFromCollections: true
+---
+<!DOCTYPE html>
+<html>
+<head><meta http-equiv="refresh" content="0; url={{ '/presentations/example/' | url }}"></head>
+<body></body>
+</html>
+`);
+
+  // ---------------------------------------------------------------
+  // 7. Ignores
+  // ---------------------------------------------------------------
+  eleventyConfig.ignores.add("node_modules/**");
+  eleventyConfig.ignores.add("README.md");
+  eleventyConfig.ignores.add("CONTRIBUTING.md");
+  eleventyConfig.ignores.add("CLAUDE.md");
+  eleventyConfig.ignores.add("LICENSE");
+  eleventyConfig.ignores.add(".claude/**");
+  eleventyConfig.ignores.add("presentations/_template/**");
+  eleventyConfig.ignores.add("pages/**");
+  eleventyConfig.ignores.add("scaffold/**");
+  eleventyConfig.ignores.add("docs/**");
+  eleventyConfig.ignores.add("bin/**");
+}

package/lib/export-pdf.js

@@ -0,0 +1,137 @@
+import { execSync, spawn } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import http from "node:http";
+
+const PORT = 4100;
+const BASE_URL = `http://127.0.0.1:${PORT}`;
+const OUTPUT_DIR = "_pdfs";
+const TIMEOUT_SECONDS = 30;
+
+let serverProcess = null;
+
+function cleanup() {
+  if (serverProcess) {
+    console.log("\n  Stopping server...");
+    serverProcess.kill();
+    serverProcess = null;
+  }
+}
+
+function waitForServer() {
+  return new Promise((resolve, reject) => {
+    let elapsed = 0;
+    const interval = setInterval(() => {
+      const req = http.get(BASE_URL, (res) => {
+        res.resume();
+        clearInterval(interval);
+        resolve();
+      });
+      req.on("error", () => {
+        elapsed++;
+        if (elapsed >= TIMEOUT_SECONDS) {
+          clearInterval(interval);
+          reject(new Error(`Server failed to start within ${TIMEOUT_SECONDS}s`));
+        }
+      });
+      req.end();
+    }, 1000);
+  });
+}
+
+function runDecktape(name) {
+  const url = `${BASE_URL}/presentations/${name}/?pdf`;
+  const output = path.join(OUTPUT_DIR, `${name}.pdf`);
+
+  console.log(`  → Exporting: ${name}`);
+  try {
+    execSync(
+      `npx decktape reveal --size 1920x1080 --pause 1000 --load-pause 2000 "${url}" "${output}"`,
+      { stdio: ["ignore", "pipe", "pipe"] }
+    );
+    console.log(`  \u2713 ${output}`);
+    return true;
+  } catch {
+    console.log(`  \u2717 Failed: ${name}`);
+    return false;
+  }
+}
+
+function getAvailablePresentations(cwd) {
+  const dir = path.join(cwd, "presentations");
+  return fs
+    .readdirSync(dir, { withFileTypes: true })
+    .filter((d) => d.isDirectory() && d.name !== "_template")
+    .map((d) => d.name);
+}
+
+/**
+ * Export presentations to PDF using DeckTape.
+ * @param {object} [opts]
+ * @param {string} [opts.cwd] - working directory (defaults to process.cwd())
+ * @param {string} [opts.name] - specific presentation name to export
+ */
+export async function run(opts = {}) {
+  const cwd = opts.cwd || process.cwd();
+  const requestedName = opts.name;
+  const available = getAvailablePresentations(cwd);
+
+  if (requestedName) {
+    if (!available.includes(requestedName)) {
+      console.error(`Presentation not found: ${requestedName}`);
+      console.error("   Available presentations:");
+      for (const name of available) {
+        console.error(`     - ${name}`);
+      }
+      process.exit(1);
+    }
+  }
+
+  const presentations = requestedName ? [requestedName] : available;
+
+  // Build the site
+  console.log("Building site...");
+  execSync("pnpm run build", { stdio: "inherit", cwd });
+
+  // Start server
+  console.log(`\nStarting server on port ${PORT}...`);
+  serverProcess = spawn("npx", ["eleventy", "--serve", "--port", String(PORT)], {
+    stdio: "ignore",
+    cwd,
+  });
+
+  process.on("exit", cleanup);
+  process.on("SIGINT", () => { cleanup(); process.exit(1); });
+  process.on("SIGTERM", () => { cleanup(); process.exit(1); });
+
+  // Wait for server
+  console.log("Waiting for server...");
+  await waitForServer();
+  console.log("Server ready");
+
+  // Create output directory
+  fs.mkdirSync(path.join(cwd, OUTPUT_DIR), { recursive: true });
+
+  // Export presentations
+  let success = 0;
+  let failure = 0;
+  console.log(`\nExporting ${presentations.length} presentation(s) to PDF...\n`);
+
+  for (const name of presentations) {
+    if (runDecktape(name)) {
+      success++;
+    } else {
+      failure++;
+    }
+    console.log();
+  }
+
+  cleanup();
+
+  // Summary
+  console.log("\u2501".repeat(30));
+  console.log(`Exported: ${success}  Failed: ${failure}`);
+  if (failure > 0) {
+    process.exit(1);
+  }
+}

package/lib/init.js

@@ -0,0 +1,154 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const pkgRoot = path.dirname(path.dirname(fileURLToPath(import.meta.url)));
+const scaffoldDir = path.join(pkgRoot, "scaffold");
+
+/**
+ * Copy a directory recursively.
+ */
+function copyDir(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+/**
+ * Scaffold a new LazySlides project.
+ * @param {object} opts
+ * @param {string} opts.dir - target directory path
+ */
+export async function run(opts) {
+  const targetDir = path.resolve(opts.dir);
+  const projectName = path.basename(targetDir);
+
+  // Check if directory already has files
+  if (fs.existsSync(targetDir)) {
+    const existing = fs.readdirSync(targetDir);
+    if (existing.length > 0) {
+      throw new Error(`Directory "${targetDir}" is not empty.`);
+    }
+  }
+
+  fs.mkdirSync(targetDir, { recursive: true });
+
+  console.log(`\nCreating a new LazySlides project in ${targetDir}\n`);
+
+  // 1. Copy scaffold/eleventy.config.js
+  fs.copyFileSync(
+    path.join(scaffoldDir, "eleventy.config.js"),
+    path.join(targetDir, "eleventy.config.js")
+  );
+  console.log("  Created eleventy.config.js");
+
+  // 2. Create src/styles.css from scaffold
+  fs.mkdirSync(path.join(targetDir, "src"), { recursive: true });
+  fs.copyFileSync(
+    path.join(scaffoldDir, "styles.css"),
+    path.join(targetDir, "src", "styles.css")
+  );
+  console.log("  Created src/styles.css");
+
+  // 3. Create presentations/ with template and starter deck
+  const presentationsDir = path.join(targetDir, "presentations");
+  fs.mkdirSync(presentationsDir, { recursive: true });
+
+  // presentations.11tydata.js
+  fs.copyFileSync(
+    path.join(scaffoldDir, "presentations.11tydata.js"),
+    path.join(presentationsDir, "presentations.11tydata.js")
+  );
+  console.log("  Created presentations/presentations.11tydata.js");
+
+  // _template/
+  copyDir(
+    path.join(scaffoldDir, "_template"),
+    path.join(presentationsDir, "_template")
+  );
+  console.log("  Created presentations/_template/");
+
+  // my-first-deck/
+  copyDir(
+    path.join(scaffoldDir, "my-first-deck"),
+    path.join(presentationsDir, "my-first-deck")
+  );
+  console.log("  Created presentations/my-first-deck/");
+
+  // 4. Create themes/ directory (empty, for user overrides)
+  fs.mkdirSync(path.join(targetDir, "themes"), { recursive: true });
+  // Add a .gitkeep so git tracks the empty directory
+  fs.writeFileSync(path.join(targetDir, "themes", ".gitkeep"), "");
+  console.log("  Created themes/");
+
+  // 5. package.json from template
+  const pkgTemplate = fs.readFileSync(
+    path.join(scaffoldDir, "package.json.tmpl"),
+    "utf-8"
+  );
+  const pkgContent = pkgTemplate.replace(/\{\{name\}\}/g, projectName);
+  fs.writeFileSync(path.join(targetDir, "package.json"), pkgContent);
+  console.log("  Created package.json");
+
+  // 6. Rename-on-copy files (.gitignore, .nvmrc)
+  fs.copyFileSync(
+    path.join(scaffoldDir, "gitignore"),
+    path.join(targetDir, ".gitignore")
+  );
+  console.log("  Created .gitignore");
+
+  fs.copyFileSync(
+    path.join(scaffoldDir, "nvmrc"),
+    path.join(targetDir, ".nvmrc")
+  );
+  console.log("  Created .nvmrc");
+
+  // 7. README.md
+  const readmeTemplate = fs.readFileSync(
+    path.join(scaffoldDir, "README.md"),
+    "utf-8"
+  );
+  const readmeContent = readmeTemplate.replace(/\{\{name\}\}/g, projectName);
+  fs.writeFileSync(path.join(targetDir, "README.md"), readmeContent);
+  console.log("  Created README.md");
+
+  // 8. CLAUDE.md (Claude Code integration)
+  fs.copyFileSync(
+    path.join(scaffoldDir, "CLAUDE.md"),
+    path.join(targetDir, "CLAUDE.md")
+  );
+  console.log("  Created CLAUDE.md");
+
+  // 9. .claude/ directory (commands + settings)
+  const claudeDir = path.join(targetDir, ".claude");
+  const commandsDir = path.join(claudeDir, "commands");
+  fs.mkdirSync(commandsDir, { recursive: true });
+  const scaffoldCommandsDir = path.join(scaffoldDir, "claude-commands");
+  for (const file of fs.readdirSync(scaffoldCommandsDir)) {
+    fs.copyFileSync(
+      path.join(scaffoldCommandsDir, file),
+      path.join(commandsDir, file)
+    );
+  }
+  fs.copyFileSync(
+    path.join(scaffoldDir, "claude-settings.json"),
+    path.join(claudeDir, "settings.json")
+  );
+  console.log("  Created .claude/ (Claude Code integration)");
+
+  // Done!
+  console.log(`
+Done! To get started:
+
+  cd ${projectName}
+  pnpm install
+  pnpm run dev
+`);
+}