@pep/term-deck 1.0.14 → 1.0.16

package/dist/index.js

@@ -0,0 +1,159 @@
+import { z } from 'zod';
+import { parse } from 'yaml';
+import deepmerge from 'deepmerge';
+import 'gradient-string';
+
+// src/schemas/config.ts
+var HexColorSchema = z.string().regex(/^#[0-9a-fA-F]{6}$/, {
+  message: "Color must be a valid hex color (e.g., #ff0066)"
+});
+var GradientSchema = z.array(HexColorSchema).min(2, {
+  message: "Gradient must have at least 2 colors"
+});
+var ThemeSchema = z.object({
+  // Theme metadata
+  name: z.string().min(1, { message: "Theme name is required" }),
+  description: z.string().optional(),
+  author: z.string().optional(),
+  version: z.string().optional(),
+  // Color palette
+  colors: z.object({
+    primary: HexColorSchema,
+    secondary: HexColorSchema.optional(),
+    accent: HexColorSchema,
+    background: HexColorSchema,
+    text: HexColorSchema,
+    muted: HexColorSchema,
+    success: HexColorSchema.optional(),
+    warning: HexColorSchema.optional(),
+    error: HexColorSchema.optional()
+  }),
+  // Named gradients for bigText
+  gradients: z.record(z.string(), GradientSchema).refine(
+    (g) => Object.keys(g).length >= 1,
+    { message: "At least one gradient must be defined" }
+  ),
+  // Glyph set for matrix rain background
+  glyphs: z.string().min(10, {
+    message: "Glyph set must have at least 10 characters"
+  }),
+  // Animation settings
+  animations: z.object({
+    // Speed multiplier (1.0 = normal, 0.5 = half speed, 2.0 = double speed)
+    revealSpeed: z.number().min(0.1).max(5).default(1),
+    // Matrix rain density (number of drops)
+    matrixDensity: z.number().min(10).max(200).default(50),
+    // Glitch effect iterations
+    glitchIterations: z.number().min(1).max(20).default(5),
+    // Delay between lines during reveal (ms)
+    lineDelay: z.number().min(0).max(500).default(30),
+    // Matrix rain update interval (ms)
+    matrixInterval: z.number().min(20).max(200).default(80)
+  }),
+  // Window appearance
+  window: z.object({
+    // Border style
+    borderStyle: z.enum(["line", "double", "rounded", "none"]).default("line"),
+    // Shadow effect
+    shadow: z.boolean().default(true),
+    // Padding inside windows
+    padding: z.object({
+      top: z.number().min(0).max(5).default(1),
+      bottom: z.number().min(0).max(5).default(1),
+      left: z.number().min(0).max(10).default(2),
+      right: z.number().min(0).max(10).default(2)
+    }).optional()
+  }).optional()
+});
+ThemeSchema.deepPartial();
+
+// src/schemas/config.ts
+var SettingsSchema = z.object({
+  // Start slide (0-indexed)
+  startSlide: z.number().min(0).default(0),
+  // Loop back to first slide after last
+  loop: z.boolean().default(false),
+  // Auto-advance slides (ms, 0 = disabled)
+  autoAdvance: z.number().min(0).default(0),
+  // Show slide numbers
+  showSlideNumbers: z.boolean().default(false),
+  // Show progress bar
+  showProgress: z.boolean().default(false)
+});
+var ExportSettingsSchema = z.object({
+  // Output width in characters (min 80, max 400)
+  width: z.number().min(80).max(400).default(120),
+  // Output height in characters (min 24, max 100)
+  height: z.number().min(24).max(100).default(40),
+  // Frames per second for video (min 10, max 60)
+  fps: z.number().min(10).max(60).default(30)
+});
+var DeckConfigSchema = z.object({
+  // Presentation metadata
+  title: z.string().optional(),
+  author: z.string().optional(),
+  date: z.string().optional(),
+  // Theme (already validated Theme object)
+  theme: ThemeSchema,
+  // Presentation settings
+  settings: SettingsSchema.optional(),
+  // Export settings
+  export: ExportSettingsSchema.optional()
+});
+
+// src/schemas/validation.ts
+var ValidationError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ValidationError";
+  }
+};
+function formatZodError(error, context) {
+  const issues = error.issues.map((issue) => {
+    const path = issue.path.join(".");
+    return `  - ${path ? `${path}: ` : ""}${issue.message}`;
+  });
+  return `Invalid ${context}:
+${issues.join("\n")}`;
+}
+function safeParse(schema, data, context) {
+  const result = schema.safeParse(data);
+  if (!result.success) {
+    throw new ValidationError(formatZodError(result.error, context));
+  }
+  return result.data;
+}
+
+// src/core/theme.ts
+function createThemeFromMerge(base, overrides) {
+  const merged = deepmerge(base, overrides, {
+    // Arrays should be replaced, not concatenated
+    arrayMerge: (_, source) => source
+  });
+  const validated = safeParse(ThemeSchema, merged, "merged theme");
+  return {
+    ...validated,
+    extend(newOverrides) {
+      return createThemeFromMerge(validated, newOverrides);
+    }
+  };
+}
+function createTheme(yaml) {
+  const parsed = parse(yaml);
+  const validated = safeParse(ThemeSchema, parsed, "theme");
+  return {
+    ...validated,
+    extend(overrides) {
+      return createThemeFromMerge(validated, overrides);
+    }
+  };
+}
+
+// src/index.ts
+function defineConfig(config) {
+  return DeckConfigSchema.parse(config);
+}
+
+export { createTheme, defineConfig };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schemas/theme.ts","../src/schemas/config.ts","../src/schemas/validation.ts","../src/core/theme.ts","../src/index.ts"],"names":["z","parseYaml"],"mappings":"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","file":"index.js","sourcesContent":["import { z } from 'zod'\n\n/**\n * Schema for validating hex color strings.\n * Accepts 6-digit hex colors with # prefix (e.g., #ff0066)\n */\nexport const HexColorSchema = z.string().regex(/^#[0-9a-fA-F]{6}$/, {\n  message: 'Color must be a valid hex color (e.g., #ff0066)',\n})\n\nexport type HexColor = z.infer<typeof HexColorSchema>\n\n/**\n * Schema for validating gradient color arrays.\n * A gradient requires at least 2 hex colors.\n */\nexport const GradientSchema = z.array(HexColorSchema).min(2, {\n  message: 'Gradient must have at least 2 colors',\n})\n\nexport type Gradient = z.infer<typeof GradientSchema>\n\n/**\n * Schema for validating theme objects.\n * Defines the visual appearance of the presentation deck.\n */\nexport const ThemeSchema = z.object({\n  // Theme metadata\n  name: z.string().min(1, { message: 'Theme name is required' }),\n  description: z.string().optional(),\n  author: z.string().optional(),\n  version: z.string().optional(),\n\n  // Color palette\n  colors: z.object({\n    primary: HexColorSchema,\n    secondary: HexColorSchema.optional(),\n    accent: HexColorSchema,\n    background: HexColorSchema,\n    text: HexColorSchema,\n    muted: HexColorSchema,\n    success: HexColorSchema.optional(),\n    warning: HexColorSchema.optional(),\n    error: HexColorSchema.optional(),\n  }),\n\n  // Named gradients for bigText\n  gradients: z.record(z.string(), GradientSchema).refine(\n    (g) => Object.keys(g).length >= 1,\n    { message: 'At least one gradient must be defined' }\n  ),\n\n  // Glyph set for matrix rain background\n  glyphs: z.string().min(10, {\n    message: 'Glyph set must have at least 10 characters',\n  }),\n\n  // Animation settings\n  animations: z.object({\n    // Speed multiplier (1.0 = normal, 0.5 = half speed, 2.0 = double speed)\n    revealSpeed: z.number().min(0.1).max(5.0).default(1.0),\n    // Matrix rain density (number of drops)\n    matrixDensity: z.number().min(10).max(200).default(50),\n    // Glitch effect iterations\n    glitchIterations: z.number().min(1).max(20).default(5),\n    // Delay between lines during reveal (ms)\n    lineDelay: z.number().min(0).max(500).default(30),\n    // Matrix rain update interval (ms)\n    matrixInterval: z.number().min(20).max(200).default(80),\n  }),\n\n  // Window appearance\n  window: z.object({\n    // Border style\n    borderStyle: z.enum(['line', 'double', 'rounded', 'none']).default('line'),\n    // Shadow effect\n    shadow: z.boolean().default(true),\n    // Padding inside windows\n    padding: z.object({\n      top: z.number().min(0).max(5).default(1),\n      bottom: z.number().min(0).max(5).default(1),\n      left: z.number().min(0).max(10).default(2),\n      right: z.number().min(0).max(10).default(2),\n    }).optional(),\n  }).optional(),\n})\n\nexport type Theme = z.infer<typeof ThemeSchema>\n\n// ============================================================================\n// Color Token System\n// ============================================================================\n\n/**\n * Valid color tokens for inline styling in slide body content.\n * Tokens can be either:\n * - Built-in colors: GREEN, ORANGE, CYAN, PINK, WHITE, GRAY\n * - Theme-mapped colors: PRIMARY, SECONDARY, ACCENT, MUTED, TEXT, BACKGROUND\n *\n * Usage in slides: {GREEN}colored text{/}\n */\nexport const ColorTokens = [\n  'GREEN',\n  'ORANGE',\n  'CYAN',\n  'PINK',\n  'WHITE',\n  'GRAY',\n  'PRIMARY',    // Maps to theme.colors.primary\n  'SECONDARY',  // Maps to theme.colors.secondary\n  'ACCENT',     // Maps to theme.colors.accent\n  'MUTED',      // Maps to theme.colors.muted\n  'TEXT',       // Maps to theme.colors.text\n  'BACKGROUND', // Maps to theme.colors.background\n] as const\n\n/**\n * Type for valid color token names.\n */\nexport type ColorToken = typeof ColorTokens[number]\n\n/**\n * Pattern for matching color tokens in slide content.\n * Matches: {GREEN}, {ORANGE}, {CYAN}, {PINK}, {WHITE}, {GRAY},\n *          {PRIMARY}, {SECONDARY}, {ACCENT}, {MUTED}, {TEXT}, {BACKGROUND}, {/}\n *\n * The {/} token closes any open color tag.\n */\nexport const COLOR_TOKEN_PATTERN = /\\{(GREEN|ORANGE|CYAN|PINK|WHITE|GRAY|PRIMARY|SECONDARY|ACCENT|MUTED|TEXT|BACKGROUND|\\/)\\}/g\n\n// ============================================================================\n// Partial Theme for Extension\n// ============================================================================\n\n/**\n * Deep partial utility type that makes all nested properties optional.\n * Used for theme extension where only specific fields need to be overridden.\n */\nexport type DeepPartial<T> = T extends object ? {\n  [P in keyof T]?: DeepPartial<T[P]>\n} : T\n\n/**\n * Partial theme type for use with theme.extend() functionality.\n * All fields (including nested) become optional.\n */\nexport type PartialTheme = DeepPartial<Theme>\n\n/**\n * Schema for validating partial theme objects.\n * All fields become optional recursively, allowing partial overrides.\n * Used for theme extension validation.\n */\nexport const PartialThemeSchema = ThemeSchema.deepPartial()\n\n// ============================================================================\n// Default Theme\n// ============================================================================\n\n/**\n * Default matrix/cyberpunk theme.\n * Used when no theme is specified or as a base for theme extension.\n */\nexport const DEFAULT_THEME: Theme = {\n  name: 'matrix',\n  description: 'Default cyberpunk/matrix theme',\n\n  colors: {\n    primary: '#00cc66',\n    accent: '#ff6600',\n    background: '#0a0a0a',\n    text: '#ffffff',\n    muted: '#666666',\n  },\n\n  gradients: {\n    fire: ['#ff6600', '#ff3300', '#ff0066'],\n    cool: ['#00ccff', '#0066ff', '#6600ff'],\n    pink: ['#ff0066', '#ff0099', '#cc00ff'],\n    hf: ['#99cc00', '#00cc66', '#00cccc'],\n  },\n\n  glyphs: 'ｱｲｳｴｵｶｷｸｹｺｻｼｽｾｿﾀﾁﾂﾃﾄﾅﾆﾇﾈﾉﾊﾋﾌﾍﾎﾏﾐﾑﾒﾓﾔﾕﾖﾗﾘﾙﾚﾛﾜﾝ0123456789',\n\n  animations: {\n    revealSpeed: 1.0,\n    matrixDensity: 50,\n    glitchIterations: 5,\n    lineDelay: 30,\n    matrixInterval: 80,\n  },\n\n  window: {\n    borderStyle: 'line',\n    shadow: true,\n    padding: {\n      top: 1,\n      bottom: 1,\n      left: 2,\n      right: 2,\n    },\n  },\n}\n","import { z } from 'zod'\nimport { ThemeSchema } from './theme'\n\n/**\n * Schema for presentation settings.\n * Controls how the presentation behaves during runtime.\n */\nexport const SettingsSchema = z.object({\n  // Start slide (0-indexed)\n  startSlide: z.number().min(0).default(0),\n  // Loop back to first slide after last\n  loop: z.boolean().default(false),\n  // Auto-advance slides (ms, 0 = disabled)\n  autoAdvance: z.number().min(0).default(0),\n  // Show slide numbers\n  showSlideNumbers: z.boolean().default(false),\n  // Show progress bar\n  showProgress: z.boolean().default(false),\n})\n\nexport type Settings = z.infer<typeof SettingsSchema>\n\n/**\n * Schema for export settings.\n * Controls the output dimensions and quality of exported videos/GIFs.\n */\nexport const ExportSettingsSchema = z.object({\n  // Output width in characters (min 80, max 400)\n  width: z.number().min(80).max(400).default(120),\n  // Output height in characters (min 24, max 100)\n  height: z.number().min(24).max(100).default(40),\n  // Frames per second for video (min 10, max 60)\n  fps: z.number().min(10).max(60).default(30),\n})\n\nexport type ExportSettings = z.infer<typeof ExportSettingsSchema>\n\n/**\n * Schema for validating deck configuration (deck.config.ts).\n * Defines the complete configuration for a presentation deck.\n */\nexport const DeckConfigSchema = z.object({\n  // Presentation metadata\n  title: z.string().optional(),\n  author: z.string().optional(),\n  date: z.string().optional(),\n\n  // Theme (already validated Theme object)\n  theme: ThemeSchema,\n\n  // Presentation settings\n  settings: SettingsSchema.optional(),\n\n  // Export settings\n  export: ExportSettingsSchema.optional(),\n})\n\nexport type DeckConfig = z.infer<typeof DeckConfigSchema>\n","import { z, ZodError } from 'zod'\n\n/**\n * Custom error class for validation failures.\n * Extends Error with a specific name for easy identification.\n */\nexport class ValidationError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = 'ValidationError'\n  }\n}\n\n/**\n * Format Zod errors into user-friendly messages.\n * Formats each issue with its field path and message.\n *\n * @param error - The ZodError to format\n * @param context - A description of what was being validated (e.g., \"theme\", \"slide frontmatter\")\n * @returns A formatted string with all validation issues\n *\n * @example\n * const error = new ZodError([...])\n * formatZodError(error, 'theme')\n * // Returns:\n * // \"Invalid theme:\n * //   - colors.primary: Color must be a valid hex color (e.g., #ff0066)\n * //   - name: Theme name is required\"\n */\nexport function formatZodError(error: ZodError, context: string): string {\n  const issues = error.issues.map((issue) => {\n    const path = issue.path.join('.')\n    return `  - ${path ? `${path}: ` : ''}${issue.message}`\n  })\n\n  return `Invalid ${context}:\\n${issues.join('\\n')}`\n}\n\n/**\n * Parse data with a Zod schema and throw a ValidationError with friendly messages on failure.\n *\n * @param schema - The Zod schema to validate against\n * @param data - The data to validate\n * @param context - A description of what's being validated (e.g., \"theme\", \"slide frontmatter\")\n * @returns The parsed and validated data\n * @throws {ValidationError} If validation fails\n *\n * @example\n * const theme = safeParse(ThemeSchema, rawData, 'theme')\n * // Throws ValidationError with formatted message if invalid\n */\nexport function safeParse<T>(\n  schema: z.ZodSchema<T>,\n  data: unknown,\n  context: string\n): T {\n  const result = schema.safeParse(data)\n\n  if (!result.success) {\n    throw new ValidationError(formatZodError(result.error, context))\n  }\n\n  return result.data\n}\n","import { parse as parseYaml } from 'yaml'\nimport deepmerge from 'deepmerge'\nimport type { Theme, PartialTheme } from '../schemas/theme'\nimport { ThemeSchema } from '../schemas/theme'\nimport { safeParse } from '../schemas/validation'\n\n/**\n * Theme object with extension capability.\n * Extends the base Theme type with an extend() method that allows\n * Tailwind-style theme customization.\n */\nexport interface ThemeObject extends Theme {\n  /**\n   * Create a new theme by merging overrides into this theme.\n   * Uses deep merge with array replacement strategy.\n   *\n   * @param overrides - Partial theme object with values to override\n   * @returns A new ThemeObject with the merged values\n   *\n   * @example\n   * const custom = matrix.extend({\n   *   colors: { primary: '#ff0066' }\n   * })\n   *\n   * @example\n   * // Chained extensions\n   * const custom = matrix\n   *   .extend({ colors: { primary: '#ff0066' } })\n   *   .extend({ animations: { revealSpeed: 0.5 } })\n   */\n  extend(overrides: PartialTheme): ThemeObject\n}\n\n/**\n * Create a ThemeObject from validated Theme and overrides.\n * Internal helper that merges themes and adds the extend() method.\n *\n * @param base - A validated Theme object\n * @param overrides - Partial theme with values to override\n * @returns A ThemeObject with extension capability\n */\nexport function createThemeFromMerge(base: Theme, overrides: PartialTheme): ThemeObject {\n  // Deep merge, with overrides taking precedence\n  const merged = deepmerge(base, overrides, {\n    // Arrays should be replaced, not concatenated\n    arrayMerge: (_, source) => source,\n  }) as Theme\n\n  // Re-validate the merged result\n  const validated = safeParse(ThemeSchema, merged, 'merged theme')\n\n  return {\n    ...validated,\n    extend(newOverrides: PartialTheme): ThemeObject {\n      return createThemeFromMerge(validated, newOverrides)\n    },\n  }\n}\n\n/**\n * Create a theme from a YAML string.\n * Parses the YAML, validates it against ThemeSchema, and returns a ThemeObject\n * with extension capability.\n *\n * @param yaml - The YAML string containing the theme definition\n * @returns A validated ThemeObject with extend() method\n * @throws {Error} If the YAML syntax is invalid\n * @throws {ValidationError} If the parsed data doesn't match ThemeSchema\n *\n * @example\n * const theme = createTheme(`\n * name: custom\n * colors:\n *   primary: \"#ff0066\"\n *   accent: \"#00ff66\"\n *   background: \"#000000\"\n *   text: \"#ffffff\"\n *   muted: \"#666666\"\n * gradients:\n *   main:\n *     - \"#ff0066\"\n *     - \"#00ff66\"\n * glyphs: \"0123456789ABCDEF\"\n * animations:\n *   revealSpeed: 1.0\n *   matrixDensity: 30\n *   glitchIterations: 3\n *   lineDelay: 20\n *   matrixInterval: 100\n * `)\n */\nexport function createTheme(yaml: string): ThemeObject {\n  const parsed = parseYaml(yaml)\n  const validated = safeParse(ThemeSchema, parsed, 'theme')\n\n  return {\n    ...validated,\n    extend(overrides: PartialTheme): ThemeObject {\n      return createThemeFromMerge(validated, overrides)\n    },\n  }\n}\n\n// Re-export commonly used functions for convenience\nexport { ThemeError, formatThemeError } from './theme-errors'\nexport {\n  createGradients,\n  applyGradient,\n  resolveColorToken,\n  colorTokensToBlessedTags,\n  BUILTIN_COLORS,\n} from './theme-colors'\nexport type { GradientFunction } from './theme-colors'\n","/**\n * Public API for term-deck\n *\n * Exports functions and types for use in deck.config.ts files\n * and external integrations.\n */\n\nimport { DeckConfigSchema, type DeckConfig } from './schemas/config.js';\nimport { type Theme } from './schemas/theme.js';\nimport { type Slide, type SlideFrontmatter } from './schemas/slide.js';\nimport { createTheme, type ThemeObject } from './core/theme.js';\n\n/**\n * Define deck configuration with validation\n *\n * Usage in deck.config.ts:\n * ```typescript\n * import { defineConfig } from 'term-deck'\n * import matrix from '@term-deck/theme-matrix'\n *\n * export default defineConfig({\n *   title: 'My Presentation',\n *   theme: matrix,\n * })\n * ```\n */\nexport function defineConfig(config: DeckConfig): DeckConfig {\n  return DeckConfigSchema.parse(config);\n}\n\n// Re-export theme creation\nexport { createTheme };\nexport type { ThemeObject };\n\n// Re-export types for consumers\nexport type { DeckConfig, Theme, Slide, SlideFrontmatter };\n"]}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@pep/term-deck",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "description": "Terminal presentation tool with a cyberpunk aesthetic",
   "type": "module",
   "bin": {
-    "term-deck": "./bin/term-deck.js"
+    "term-deck": "./dist/bin/term-deck.js"
   },
-  "main": "src/index.ts",
-  "types": "src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "keywords": [
     "presentation",
     "terminal",
@@ -32,34 +32,37 @@
     "node": ">=18.0.0"
   },
   "files": [
-    "src/",
-    "bin/",
+    "dist/",
     "themes/",
     "examples/",
     "LICENSE",
     "README.md"
   ],
   "dependencies": {
+    "canvas": "^3.2.1",
     "commander": "^14.0.2",
-    "neo-blessed": "^0.2.0",
+    "deepmerge": "^4.3.1",
+    "execa": "^9.6.1",
+    "fast-glob": "^3.3.3",
     "figlet": "^1.9.4",
     "gradient-string": "^3.0.0",
     "gray-matter": "^4.0.3",
-    "yaml": "^2.7.0",
-    "zod": "^3.22.4",
-    "deepmerge": "^4.3.1",
     "mermaid-ascii": "^1.0.0",
-    "canvas": "^3.2.1",
-    "tsx": "^4.19.2"
+    "neo-blessed": "^0.2.0",
+    "yaml": "^2.7.0",
+    "zod": "^3.22.4"
   },
   "devDependencies": {
-    "@types/node": "^22.0.0",
     "@types/figlet": "^1.5.8",
+    "@types/node": "^22.0.0",
+    "tsup": "^8.5.1",
+    "tsx": "^4.19.2",
     "typescript": "^5.9.3",
     "vitest": "^2.1.8"
   },
   "scripts": {
     "dev": "tsx bin/term-deck.ts",
+    "build": "tsup",
     "test": "vitest",
     "typecheck": "tsc --noEmit"
   }

package/bin/term-deck.js

@@ -1,14 +0,0 @@
-#!/usr/bin/env node
-/**
- * JavaScript wrapper for term-deck CLI
- * Uses tsx to execute the TypeScript entry point
- */
-
-import { register } from 'node:module';
-import { pathToFileURL } from 'node:url';
-
-// Register tsx for TypeScript execution
-register('tsx/esm', pathToFileURL('./'));
-
-// Import and run the TypeScript CLI
-await import('./term-deck.ts');

package/bin/term-deck.ts

@@ -1,45 +0,0 @@
-#!/usr/bin/env node
-/**
- * CLI Entry Point for term-deck
- *
- * Terminal presentation tool with a cyberpunk aesthetic.
- * Provides commands for presenting, exporting, and initializing decks.
- */
-
-import { Command } from 'commander';
-import { version } from '../package.json';
-import { presentCommand } from '../src/cli/commands/present.js';
-import { exportCommand } from '../src/cli/commands/export.js';
-import { initCommand } from '../src/cli/commands/init.js';
-import { handleError } from '../src/cli/errors.js';
-
-const program = new Command();
-
-program
-  .name('term-deck')
-  .description('Terminal presentation tool with a cyberpunk aesthetic')
-  .version(version);
-
-// Register commands
-program.addCommand(presentCommand);
-program.addCommand(exportCommand);
-program.addCommand(initCommand);
-
-// Default action: present if directory given, else show help
-program
-  .argument('[dir]', 'Slides directory to present')
-  .action(async (dir) => {
-    if (dir) {
-      // Default action: present the deck
-      try {
-        const { present } = await import('../src/presenter/main.js');
-        await present(dir, {});
-      } catch (error) {
-        handleError(error);
-      }
-    } else {
-      program.help();
-    }
-  });
-
-program.parse();

package/src/cli/__tests__/errors.test.ts

@@ -1,201 +0,0 @@
-/**
- * Tests for CLI error handling
- */
-
-import { describe, test, expect, mock, spyOn, beforeEach, afterEach } from 'bun:test';
-import { handleError } from '../errors.js';
-import { ValidationError } from '../../schemas/validation.js';
-import { SlideParseError, DeckLoadError } from '../../core/slide.js';
-import { ThemeError } from '../../core/theme.js';
-
-describe('handleError', () => {
-  let consoleErrorSpy: ReturnType<typeof spyOn>;
-  let processExitSpy: ReturnType<typeof spyOn>;
-  let originalDebug: string | undefined;
-
-  beforeEach(() => {
-    consoleErrorSpy = spyOn(console, 'error').mockImplementation(() => {});
-    processExitSpy = spyOn(process, 'exit').mockImplementation(
-      (() => {}) as never,
-    );
-    originalDebug = process.env.DEBUG;
-  });
-
-  afterEach(() => {
-    consoleErrorSpy.mockRestore();
-    processExitSpy.mockRestore();
-    process.env.DEBUG = originalDebug;
-  });
-
-  test('handles ValidationError', () => {
-    const error = new ValidationError('Invalid theme configuration');
-
-    handleError(error);
-
-    expect(consoleErrorSpy).toHaveBeenCalledWith(
-      expect.stringContaining('Invalid theme configuration'),
-    );
-    expect(processExitSpy).toHaveBeenCalledWith(1);
-  });
-
-  test('handles SlideParseError', () => {
-    const cause = new Error('Missing title field');
-    const error = new SlideParseError('Invalid frontmatter', 'slides/01.md', cause);
-
-    handleError(error);
-
-    expect(consoleErrorSpy).toHaveBeenCalledWith(
-      expect.stringContaining('slides/01.md'),
-    );
-    expect(consoleErrorSpy).toHaveBeenCalledWith(
-      expect.stringContaining('Invalid frontmatter'),
-    );
-    expect(consoleErrorSpy).toHaveBeenCalledWith(
-      expect.stringContaining('Missing title field'),
-    );
-    expect(processExitSpy).toHaveBeenCalledWith(1);
-  });
-
-  test('handles SlideParseError without cause', () => {
-    const error = new SlideParseError('Invalid frontmatter', 'slides/02.md');
-
-    handleError(error);
-
-    expect(consoleErrorSpy).toHaveBeenCalledWith(
-      expect.stringContaining('slides/02.md'),
-    );
-    expect(processExitSpy).toHaveBeenCalledWith(1);
-  });
-
-  test('handles DeckLoadError', () => {
-    const error = new DeckLoadError('No slides found', './slides');
-
-    handleError(error);
-
-    expect(consoleErrorSpy).toHaveBeenCalledWith(
-      expect.stringContaining('./slides'),
-    );
-    expect(consoleErrorSpy).toHaveBeenCalledWith(
-      expect.stringContaining('No slides found'),
-    );
-    expect(processExitSpy).toHaveBeenCalledWith(1);
-  });
-
-  test('handles ThemeError', () => {
-    const error = new ThemeError('Invalid color format', 'custom-theme');
-
-    handleError(error);
-
-    expect(consoleErrorSpy).toHaveBeenCalledWith(
-      expect.stringContaining('Theme error'),
-    );
-    expect(consoleErrorSpy).toHaveBeenCalledWith(
-      expect.stringContaining('Invalid color format'),
-    );
-    expect(processExitSpy).toHaveBeenCalledWith(1);
-  });
-
-  test('handles ENOENT errors', () => {
-    const error = new Error('ENOENT: no such file or directory');
-
-    handleError(error);
-
-    expect(consoleErrorSpy).toHaveBeenCalledWith(
-      expect.stringContaining('File or directory not found'),
-    );
-    expect(processExitSpy).toHaveBeenCalledWith(1);
-  });
-
-  test('handles ffmpeg errors', () => {
-    const error = new Error('ffmpeg not found in PATH');
-
-    handleError(error);
-
-    expect(consoleErrorSpy).toHaveBeenCalledWith(
-      expect.stringContaining('ffmpeg error'),
-    );
-    expect(consoleErrorSpy).toHaveBeenCalledWith(
-      expect.stringContaining('Make sure ffmpeg is installed'),
-    );
-    expect(consoleErrorSpy).toHaveBeenCalledWith(
-      expect.stringContaining('brew install ffmpeg'),
-    );
-    expect(processExitSpy).toHaveBeenCalledWith(1);
-  });
-
-  test('handles generic errors', () => {
-    const error = new Error('Something went wrong');
-
-    handleError(error);
-
-    expect(consoleErrorSpy).toHaveBeenCalledWith(
-      expect.stringContaining('Something went wrong'),
-    );
-    expect(processExitSpy).toHaveBeenCalledWith(1);
-  });
-
-  test('shows stack trace when DEBUG is set', () => {
-    process.env.DEBUG = '1';
-    const error = new Error('Debug error');
-    error.stack = 'Error: Debug error\n  at test.ts:10:20';
-
-    handleError(error);
-
-    expect(consoleErrorSpy).toHaveBeenCalledWith(
-      expect.stringContaining('at test.ts'),
-    );
-    expect(processExitSpy).toHaveBeenCalledWith(1);
-  });
-
-  test('hides stack trace when DEBUG is not set', () => {
-    delete process.env.DEBUG;
-    const error = new Error('Regular error');
-    error.stack = 'Error: Regular error\n  at test.ts:10:20';
-
-    handleError(error);
-
-    // Should show error message
-    expect(consoleErrorSpy).toHaveBeenCalledWith(
-      expect.stringContaining('Regular error'),
-    );
-
-    // Should NOT show stack trace
-    const calls = consoleErrorSpy.mock.calls;
-    const hasStackTrace = calls.some((call) =>
-      call.some((arg) => String(arg).includes('at test.ts')),
-    );
-    expect(hasStackTrace).toBe(false);
-
-    expect(processExitSpy).toHaveBeenCalledWith(1);
-  });
-
-  test('handles unknown errors', () => {
-    const error = 'string error';
-
-    handleError(error);
-
-    expect(consoleErrorSpy).toHaveBeenCalledWith(
-      expect.stringContaining('Unknown error'),
-    );
-    expect(processExitSpy).toHaveBeenCalledWith(1);
-  });
-
-  test('exits with code 1 for all errors', () => {
-    const errors = [
-      new ValidationError('test'),
-      new SlideParseError('test', 'test.md'),
-      new DeckLoadError('test', './slides'),
-      new ThemeError('test', 'theme'),
-      new Error('ENOENT'),
-      new Error('ffmpeg'),
-      new Error('generic'),
-      'unknown',
-    ];
-
-    for (const error of errors) {
-      processExitSpy.mockClear();
-      handleError(error);
-      expect(processExitSpy).toHaveBeenCalledWith(1);
-    }
-  });
-});