npm - decklight - Versions diffs - 0.1.0 - Mend

decklight 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (82) hide show

package/LICENSE +21 -0
package/README.md +257 -0
package/SPEC.md +372 -0
package/cli/bundle.mjs +388 -0
package/cli/decklight.mjs +95 -0
package/cli/edit.mjs +142 -0
package/cli/init.mjs +215 -0
package/cli/rec.mjs +538 -0
package/dist/decklight.css +1068 -0
package/dist/decklight.js +239 -0
package/dist/decklight.js.map +7 -0
package/docs/architecture.svg +94 -0
package/docs/demo.svg +124 -0
package/package.json +54 -0
package/themes/README.md +61 -0
package/themes/aliens.css +84 -0
package/themes/apple2.css +126 -0
package/themes/aurora.css +84 -0
package/themes/berry.css +80 -0
package/themes/blade-runner.css +83 -0
package/themes/c64.css +85 -0
package/themes/carbon.css +82 -0
package/themes/citrus.css +80 -0
package/themes/coastal.css +80 -0
package/themes/cosmos.css +86 -0
package/themes/dune.css +80 -0
package/themes/eclipse.css +82 -0
package/themes/ember.css +80 -0
package/themes/fjord.css +80 -0
package/themes/friends.css +82 -0
package/themes/gallery.html +203 -0
package/themes/gameboy.css +118 -0
package/themes/genesis.css +84 -0
package/themes/glacier.css +82 -0
package/themes/godfather.css +82 -0
package/themes/graphite.css +80 -0
package/themes/harvest.css +80 -0
package/themes/ibm-modern.css +83 -0
package/themes/ibm-oldschool.css +84 -0
package/themes/ink.css +82 -0
package/themes/latte.css +80 -0
package/themes/linen.css +80 -0
package/themes/meadow.css +80 -0
package/themes/metropolis.css +85 -0
package/themes/miami-vice.css +84 -0
package/themes/midnight.css +80 -0
package/themes/mint.css +82 -0
package/themes/moss.css +82 -0
package/themes/obsidian.css +82 -0
package/themes/orchid.css +82 -0
package/themes/packs.json +89 -0
package/themes/paper.css +83 -0
package/themes/peony.css +84 -0
package/themes/porcelain.css +82 -0
package/themes/pulp-fiction.css +84 -0
package/themes/reveal-beige.css +87 -0
package/themes/reveal-black.css +83 -0
package/themes/reveal-blood.css +84 -0
package/themes/reveal-dracula.css +83 -0
package/themes/reveal-league.css +88 -0
package/themes/reveal-moon.css +83 -0
package/themes/reveal-night.css +86 -0
package/themes/reveal-serif.css +82 -0
package/themes/reveal-simple.css +84 -0
package/themes/reveal-sky.css +85 -0
package/themes/reveal-solarized.css +83 -0
package/themes/reveal-white.css +82 -0
package/themes/sepia.css +81 -0
package/themes/seriph.css +82 -0
package/themes/severance.css +82 -0
package/themes/slate.css +80 -0
package/themes/snes.css +82 -0
package/themes/star-wars.css +85 -0
package/themes/storm.css +80 -0
package/themes/stranger-things.css +84 -0
package/themes/synthwave.css +90 -0
package/themes/terminator.css +84 -0
package/themes/velvet.css +80 -0
package/tools/gemini-tts.mjs +140 -0
package/tools/publish-site-voices.mjs +71 -0
package/tools/voiceover-server.mjs +0 -0
package/tools/voiceover.mjs +155 -0

package/cli/init.mjs ADDED Viewed

@@ -0,0 +1,215 @@
+#!/usr/bin/env node
+/**
+ * decklight init — scaffold a starter deck, plus an agent skill so Claude
+ * Code (and any AGENTS.md-reading agent) knows the authoring contract
+ * without a web search or a guess from Reveal.js memory.
+ *
+ *   decklight init ["My Deck"] [-o deck.html] [--dir path] [--force] [--no-skill]
+ *
+ * The deck is fully self-contained (runtime + theme inlined, like
+ * `decklight bundle` produces) — double-click it, it presents, no sibling
+ * files. The skill is regenerated every run (it's derived, not authored
+ * content) so re-running after an upgrade refreshes it; the deck file is
+ * only touched with --force.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const here = path.dirname(fileURLToPath(import.meta.url));
+const PKG_ROOT = path.resolve(here, '..');
+const PKG = JSON.parse(fs.readFileSync(path.join(PKG_ROOT, 'package.json'), 'utf8'));
+function fail(msg) {
+  process.stderr.write(`decklight init: ${msg}\n`);
+  process.exit(1);
+}
+const scriptSafe = (s) => s.replace(/<\/script/gi, '<\\/script').replace(/<!--/g, '<\\u0021--');
+const STARTER_THEME = 'aurora';
+function starterDeck(title) {
+  const css = fs.readFileSync(path.join(PKG_ROOT, 'dist/decklight.css'), 'utf8');
+  const theme = fs.readFileSync(path.join(PKG_ROOT, 'themes', `${STARTER_THEME}.css`), 'utf8');
+  return `<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <title>${title}</title>
+  <style>
+${css}
+  </style>
+  <style data-theme="${STARTER_THEME}">
+${theme}
+  </style>
+</head>
+<body>
+  <div class="decklight">
+    <section>
+      <h1>${title}</h1>
+      <p>Made with Decklight — press → to advance, ? for every key</p>
+      <aside class="notes">
+        <p>Welcome. This is the title slide — say a line or two about what this deck covers.</p>
+      </aside>
+    </section>
+    <section>
+      <h2>A slide with a build</h2>
+      <ul data-build="fade-up">
+        <li>One attribute on the container: <code>data-build</code></li>
+        <li>Each direct child becomes one build step, in document order</li>
+        <li>Speaker notes segment with ⟨CLICK⟩ to match — see below</li>
+      </ul>
+      <aside class="notes">
+        <p>The container opts in and the engine does the rest — not a single class on the items themselves.</p>
+        <p>⟨CLICK⟩</p>
+        <p>Every press of the arrow reveals the next one, in order.</p>
+        <p>⟨CLICK⟩</p>
+        <p>And that's it — replace this slide's content, duplicate the section for more, and you have a deck.</p>
+      </aside>
+    </section>
+  </div>
+  <script>${scriptSafe(fs.readFileSync(path.join(PKG_ROOT, 'dist/decklight.js'), 'utf8').replace(/\/\/# sourceMappingURL=.*$/m, ''))}</script>
+  <script>Decklight.init({});</script>
+</body>
+</html>
+`;
+}
+function specSlice() {
+  const spec = fs.readFileSync(path.join(PKG_ROOT, 'SPEC.md'), 'utf8');
+  const cut = spec.indexOf('\n## 10. Repository layout & tooling');
+  return (cut > 0 ? spec.slice(0, cut) : spec).trimEnd() + '\n';
+}
+function skillMd() {
+  return `---
+name: decklight
+description: Author and edit Decklight presentations — single-file HTML decks with Keynote-style builds, theme-aware SVG diagrams, 61 built-in themes, truthful terminal recordings, and live TTS narration. Use whenever creating or editing a Decklight deck (a .html file with a <div class="decklight"> of <section> slides) in this project.
+---
+Decklight decks are one HTML file: no build step, no bundler, no server to
+author. A deck is \`<div class="decklight">\` containing \`<section>\` slides;
+the runtime is one JS file + one CSS file + one theme CSS file.
+**Full authoring contract**: read [reference.md](reference.md) in this same
+skill directory before authoring or editing a slide — it covers builds,
+speaker notes segmentation (⟨CLICK⟩), SVG diagrams, theming, motion, code
+blocks, terminal recordings, narration, and the public JS API. It's sliced
+straight from Decklight's SPEC.md (v${PKG.version}), so it won't drift from
+the installed runtime's actual behavior — trust it over prior training.
+**Minimal skeleton** (see \`deck.html\` in this project for a worked example
+with a build and notes already wired):
+\`\`\`html
+<div class="decklight">
+  <section>
+    <h1>Title</h1>
+    <aside class="notes"><p>What you'd say on this slide.</p></aside>
+  </section>
+</div>
+\`\`\`
+**CLI** (\`npx decklight <command>\`, no install needed):
+- \`decklight edit deck.html\` — serve with live reload; **E** in the browser edits speaker notes back into the file
+- \`decklight rec script.term.yaml\` — record a truthful terminal cast in a real PTY, for \`<div class="terminal">\`
+- \`decklight bundle deck.html --themes all\` — flatten into one self-contained file to hand off or publish
+- \`decklight tts\` — live voice bridge so the deck can narrate itself on the fly
+- \`decklight init\` — regenerate this skill after upgrading Decklight (deck file untouched unless \`--force\`)
+Speaker notes drive both live narration and the transcript/caption
+features, so write them even for decks that will only ever be read: split
+multi-beat notes with a bare \`⟨CLICK⟩\` line so narration and build steps
+stay in sync (§8 in the reference).
+`;
+}
+const AGENTS_MARKER = '<!-- decklight:skill -->';
+function agentsSection() {
+  return `${AGENTS_MARKER}
+## Decklight decks
+This project contains a Decklight presentation (a single-file HTML deck —
+see \`.claude/skills/decklight/reference.md\` for the full authoring
+contract: builds, notes, SVG diagrams, themes, terminals, narration).
+Read that file before adding or editing slides.
+${AGENTS_MARKER}
+`;
+}
+export async function initMain(argv = process.argv.slice(2)) {
+  if (argv.includes('--help') || argv.includes('-h')) {
+    process.stdout.write(`decklight init — scaffold a starter deck + agent skill
+Usage:
+  decklight init ["Deck Title"] [-o deck.html] [--dir path] [--force] [--no-skill]
+Options:
+  -o <file>     deck output path (default: deck.html)
+  --dir <path>  target directory (default: current directory)
+  --force       overwrite an existing deck file (default: refuses)
+  --no-skill    skip .claude/skills/decklight/ and AGENTS.md
+Always writes/refreshes the skill files (they're generated from the
+installed version's SPEC.md, so re-running after an upgrade updates them)
+unless --no-skill is given. The deck file is only touched with --force.
+`);
+    process.exit(0);
+  }
+  let title = null, outFile = 'deck.html', dir = '.', force = false, withSkill = true;
+  const args = [...argv];
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i];
+    if (a === '-o') outFile = args[++i];
+    else if (a === '--dir') dir = args[++i];
+    else if (a === '--force') force = true;
+    else if (a === '--no-skill') withSkill = false;
+    else if (!a.startsWith('-')) title = title ?? a;
+    else fail(`unknown argument: ${a}`);
+  }
+  title = title || 'My Deck';
+  const root = path.resolve(dir);
+  fs.mkdirSync(root, { recursive: true });
+  const deckPath = path.resolve(root, outFile);
+  if (fs.existsSync(deckPath) && !force) {
+    fail(`${path.relative('.', deckPath) || outFile} already exists — pass --force to overwrite`);
+  }
+  fs.writeFileSync(deckPath, starterDeck(title));
+  process.stdout.write(`created ${path.relative('.', deckPath) || outFile}\n`);
+  if (!withSkill) return;
+  const skillDir = path.join(root, '.claude', 'skills', 'decklight');
+  fs.mkdirSync(skillDir, { recursive: true });
+  fs.writeFileSync(path.join(skillDir, 'SKILL.md'), skillMd());
+  fs.writeFileSync(path.join(skillDir, 'reference.md'), specSlice());
+  process.stdout.write(`wrote .claude/skills/decklight/{SKILL.md,reference.md} (v${PKG.version})\n`);
+  const agentsPath = path.join(root, 'AGENTS.md');
+  const section = agentsSection();
+  if (!fs.existsSync(agentsPath)) {
+    fs.writeFileSync(agentsPath, `# Agent notes\n\n${section}`);
+    process.stdout.write('created AGENTS.md\n');
+  } else {
+    const existing = fs.readFileSync(agentsPath, 'utf8');
+    const markerRe = new RegExp(`${AGENTS_MARKER}[\\s\\S]*?${AGENTS_MARKER}\\n?`);
+    if (markerRe.test(existing)) {
+      fs.writeFileSync(agentsPath, existing.replace(markerRe, section));
+      process.stdout.write('refreshed the Decklight section in AGENTS.md\n');
+    } else {
+      fs.writeFileSync(agentsPath, existing.replace(/\n*$/, '\n\n') + section);
+      process.stdout.write('appended a Decklight section to AGENTS.md\n');
+    }
+  }
+}
+if (import.meta.url === `file://${process.argv[1]}`) await initMain();