@pep/term-deck 1.0.26 → 1.0.28

package/dist/bin/term-deck.js

@@ -12,8 +12,10 @@ import 'deepmerge';
 import { mermaidToAscii as mermaidToAscii$1 } from 'mermaid-ascii';
 import figlet from 'figlet';
 import { Command } from 'commander';
+import { intro, log, outro, spinner } from '@clack/prompts';
 import { tmpdir } from 'os';
 import { execa } from 'execa';
+import pc from 'picocolors';
 
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -1397,7 +1399,7 @@ var init_main = __esm({
 init_esm_shims();
 
 // package.json
-var version = "1.0.26";
+var version = "1.0.28";
 
 // src/cli/commands/present.ts
 init_esm_shims();
@@ -1409,56 +1411,52 @@ init_validation();
 init_slide2();
 init_deck_loader();
 init_theme2();
-function handleError(error) {
-  if (error instanceof ValidationError) {
-    console.error(`
-${error.message}`);
+function handleError(errorObj) {
+  if (errorObj instanceof ValidationError) {
+    log.error(errorObj.message);
     process.exit(1);
   }
-  if (error instanceof SlideParseError) {
-    console.error(`
-Slide error in ${error.filePath}:`);
-    console.error(`  ${error.message}`);
-    if (error.cause) {
-      const causeMessage = error.cause instanceof Error ? error.cause.message : String(error.cause);
-      console.error(`  Caused by: ${causeMessage}`);
+  if (errorObj instanceof SlideParseError) {
+    log.error(`Slide error in ${errorObj.filePath}`);
+    log.message(`  ${errorObj.message}`);
+    if (errorObj.cause) {
+      const causeMessage = errorObj.cause instanceof Error ? errorObj.cause.message : String(errorObj.cause);
+      log.message(`  \u2192 ${causeMessage}`);
     }
     process.exit(1);
   }
-  if (error instanceof DeckLoadError) {
-    console.error(`
-Failed to load deck from ${error.slidesDir}:`);
-    console.error(`  ${error.message}`);
+  if (errorObj instanceof DeckLoadError) {
+    log.error(`Failed to load deck from ${errorObj.slidesDir}`);
+    log.message(`  ${errorObj.message}`);
     process.exit(1);
   }
-  if (error instanceof ThemeError) {
-    console.error("\nTheme error:");
-    console.error(`  ${error.message}`);
+  if (errorObj instanceof ThemeError) {
+    log.error("Theme error");
+    log.message(`  ${errorObj.message}`);
     process.exit(1);
   }
-  if (error instanceof Error) {
-    if (error.message.includes("ENOENT")) {
-      console.error("\nFile or directory not found.");
-      console.error(`  ${error.message}`);
+  if (errorObj instanceof Error) {
+    if (errorObj.message.includes("ENOENT")) {
+      log.error("File not found");
+      log.message(`  ${errorObj.message}`);
       process.exit(1);
     }
-    if (error.message.includes("ffmpeg")) {
-      console.error("\nffmpeg error:");
-      console.error(`  ${error.message}`);
-      console.error("\nMake sure ffmpeg is installed:");
-      console.error("  macOS: brew install ffmpeg");
-      console.error("  Ubuntu: sudo apt install ffmpeg");
+    if (errorObj.message.includes("ffmpeg")) {
+      log.error("ffmpeg not found");
+      log.message(`  ${errorObj.message}`);
+      log.info("Installation:");
+      log.message("  macOS:  brew install ffmpeg");
+      log.message("  Ubuntu: sudo apt install ffmpeg");
       process.exit(1);
     }
-    console.error(`
-Error: ${error.message}`);
+    log.error(errorObj.message);
     if (process.env.DEBUG) {
-      console.error(error.stack);
+      console.error("\n" + errorObj.stack);
     }
     process.exit(1);
   }
-  console.error("\nUnknown error occurred");
-  console.error(error);
+  log.error("Unknown error occurred");
+  console.error(String(errorObj));
   process.exit(1);
 }
 
@@ -1763,11 +1761,13 @@ async function encodeFramesToVideo(tempDir, output, format, fps, quality) {
   });
 }
 async function exportPresentation(slidesDir, options) {
+  intro("term-deck export");
   await checkFfmpeg();
   const format = detectFormat(options.output);
   const deck = await loadDeck(slidesDir);
   if (deck.slides.length === 0) {
-    throw new Error(`No slides found in ${slidesDir}`);
+    log.error(`No slides found in ${slidesDir}`);
+    process.exit(1);
   }
   const session = await createRecordingSession(options);
   const vt = new VirtualTerminal(session.width, session.height);
@@ -1775,11 +1775,12 @@ async function exportPresentation(slidesDir, options) {
   setScreenDimensions(renderer.screen, session.width, session.height);
   const slideTime = options.slideTime ?? 3;
   const framesPerSlide = session.fps * slideTime;
-  console.log(`Exporting ${deck.slides.length} slides...`);
+  const s = spinner();
+  s.start(`Exporting ${deck.slides.length} slides`);
   try {
     for (let i = 0; i < deck.slides.length; i++) {
       const slide = deck.slides[i];
-      console.log(`  Slide ${i + 1}/${deck.slides.length}: ${slide.frontmatter.title}`);
+      s.message(`Slide ${i + 1}/${deck.slides.length}: ${slide.frontmatter.title}`);
       await renderSlide2(renderer, slide);
       for (let f = 0; f < framesPerSlide; f++) {
         renderer.screen.render();
@@ -1788,7 +1789,9 @@ async function exportPresentation(slidesDir, options) {
         await saveFrame(session, png);
       }
     }
-    console.log("Encoding video...");
+    s.stop("Slides processed");
+    const encodeSpinner = spinner();
+    encodeSpinner.start("Encoding video");
     await encodeFramesToVideo(
       session.tempDir,
       options.output,
@@ -1796,7 +1799,8 @@ async function exportPresentation(slidesDir, options) {
       session.fps,
       options.quality
     );
-    console.log(`Exported to ${options.output}`);
+    encodeSpinner.stop(`Exported to ${options.output}`);
+    outro("Export complete");
   } finally {
     destroyRenderer(renderer);
     await cleanupSession(session);
@@ -1828,11 +1832,12 @@ var exportCommand = new Command("export").description("Export presentation to GI
 init_esm_shims();
 var initCommand = new Command("init").description("Create a new presentation deck").argument("<name>", "Deck name (will create directory)").option("-t, --theme <name>", "Theme to use", "matrix").action(async (name, options) => {
   try {
+    intro(`Creating ${name}`);
     await initDeck(name, options.theme);
-    console.log(`Created deck: ${name}/`);
-    console.log("\nNext steps:");
-    console.log(`  cd ${name}`);
-    console.log("  term-deck present .");
+    log.success(`Created ${name}/`);
+    log.step("cd " + name);
+    log.step("term-deck present .");
+    outro("Ready to present!");
   } catch (error) {
     handleError(error);
   }
@@ -1937,9 +1942,95 @@ term-deck export . -o ${name}.gif
   await writeFile(join(deckDir, "README.md"), readme);
 }
 
+// src/cli/help.ts
+init_esm_shims();
+function showHelp() {
+  console.log("");
+  const boxTop = pc.bold(pc.green("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510"));
+  const boxTitle = pc.bold(pc.green("\u2502")) + pc.bold("                       ") + pc.bold(pc.cyan("term-deck")) + pc.bold("                          ") + pc.bold(pc.green("\u2502"));
+  const boxLine1 = `${pc.bold(pc.green("\u2502"))}  ${pc.dim("Terminal presentation tool with a cyberpunk aesthetic")}  ${pc.bold(pc.green("\u2502"))}`;
+  const boxBottom = pc.bold(pc.green("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518"));
+  console.log(boxTop);
+  console.log(boxTitle);
+  console.log(boxLine1);
+  console.log(boxBottom);
+  console.log("");
+  console.log(pc.bold(pc.magenta("\u25B6 QUICK START:")));
+  console.log("");
+  console.log(pc.cyan("  \u26A1  Create a new deck"));
+  console.log(pc.dim("      term-deck init my-talk"));
+  console.log("");
+  console.log(pc.cyan("  \u{1F3AC}  Start presenting"));
+  console.log(pc.dim("      cd my-talk && term-deck present ."));
+  console.log("");
+  console.log(pc.cyan("  \u{1F4F9}  Export to video"));
+  console.log(pc.dim("      term-deck export . -o presentation.mp4"));
+  console.log("");
+  console.log(pc.bold(pc.yellow("\u25B6 COMMANDS:")));
+  console.log("");
+  console.log(pc.green("  present") + pc.dim(" <dir>        ") + pc.white("Start a presentation"));
+  console.log(pc.dim("    -s, --start <n>       ") + pc.white("Start at slide number"));
+  console.log(pc.dim("    -n, --notes           ") + pc.white("Show presenter notes"));
+  console.log(pc.dim("    -l, --loop            ") + pc.white("Loop back after last slide"));
+  console.log("");
+  console.log(pc.green("  export") + pc.dim(" <dir>         ") + pc.white("Export to GIF or MP4"));
+  console.log(pc.dim("    -o, --output <file>   ") + pc.white("Output file (.mp4 or .gif)"));
+  console.log(pc.dim("    -w, --width <n>       ") + pc.white("Terminal width (default: 120)"));
+  console.log(pc.dim("    -h, --height <n>      ") + pc.white("Terminal height (default: 40)"));
+  console.log(pc.dim("    --fps <n>             ") + pc.white("Frames per second (default: 30)"));
+  console.log(pc.dim("    -t, --slide-time <n>  ") + pc.white("Seconds per slide (default: 3)"));
+  console.log(pc.dim("    -q, --quality <n>     ") + pc.white("Quality 1-100 (default: 80)"));
+  console.log("");
+  console.log(pc.green("  init") + pc.dim(" <name>          ") + pc.white("Create a new presentation deck"));
+  console.log(pc.dim("    -t, --theme <name>    ") + pc.white("Theme preset (default: matrix)"));
+  console.log("");
+  console.log(pc.bold(pc.cyan("\u25B6 HOTKEYS:")));
+  console.log("");
+  console.log(pc.dim("  Space / \u2192   ") + pc.white("Next slide"));
+  console.log(pc.dim("  \u2190           ") + pc.white("Previous slide"));
+  console.log(pc.dim("  0-9         ") + pc.white("Jump to slide"));
+  console.log(pc.dim("  l           ") + pc.white("Show slide list"));
+  console.log(pc.dim("  q           ") + pc.white("Quit"));
+  console.log("");
+  console.log(pc.bold(pc.blue("\u25B6 SLIDE FORMAT:")));
+  console.log("");
+  console.log(pc.dim("  Slides are Markdown files with YAML frontmatter:"));
+  console.log("");
+  console.log(pc.green("  ---"));
+  console.log(pc.yellow("  title: ") + pc.white("MY SLIDE"));
+  console.log(pc.yellow("  bigText: ") + pc.white("HELLO"));
+  console.log(pc.yellow("  gradient: ") + pc.white("fire"));
+  console.log(pc.green("  ---"));
+  console.log(pc.dim("  Your slide content here..."));
+  console.log("");
+  console.log(pc.bold(pc.red("\u25B6 TEXT COLORS:")));
+  console.log("");
+  console.log(pc.dim("  Use tags in your slides:"));
+  console.log(`  ${pc.green("{GREEN}")}text${pc.green("{/}")}  ${pc.cyan("{CYAN}")}text${pc.cyan("{/}")}  ${pc.red("{RED}")}text${pc.red("{/}")}  ${pc.yellow("{ORANGE}")}text${pc.yellow("{/}")}`);
+  console.log("");
+  console.log(pc.green("\u2728") + pc.dim(" Happy presenting!"));
+  console.log("");
+}
+function showVersion(version2) {
+  console.log("");
+  console.log(pc.bold(pc.cyan("term-deck")) + pc.dim(` v${version2}`));
+  console.log("");
+}
+
 // bin/term-deck.ts
+var args = process.argv.slice(2);
+if (args.includes("-h") || args.includes("--help") || args.length === 0) {
+  if (!args.some((arg) => ["present", "export", "init"].includes(arg))) {
+    showHelp();
+    process.exit(0);
+  }
+}
+if (args.includes("-V") || args.includes("--version")) {
+  showVersion(version);
+  process.exit(0);
+}
 var program = new Command();
-program.name("term-deck").description("Terminal presentation tool with a cyberpunk aesthetic").version(version);
+program.name("term-deck").description("Terminal presentation tool with a cyberpunk aesthetic").version(version, "-V, --version", "output the version number").helpOption("-h, --help", "display help for command");
 program.addCommand(presentCommand);
 program.addCommand(exportCommand);
 program.addCommand(initCommand);
@@ -1952,7 +2043,7 @@ program.argument("[dir]", "Slides directory to present").action(async (dir) => {
       handleError(error);
     }
   } else {
-    program.help();
+    showHelp();
   }
 });
 program.parse();