@bytechain.cn/colamd-themes 0.3.0 → 0.3.1

package/dist/utils/cli-utils.js

@@ -0,0 +1,80 @@
+/**
+ * Shared utility functions for CLI commands.
+ * Provides consistent file path resolution and error handling.
+ */
+import { existsSync } from "node:fs";
+import { resolve, isAbsolute, basename } from "node:path";
+/**
+ * Resolve input file path with validation.
+ * Converts relative paths to absolute and checks existence.
+ *
+ * @param input  File path provided by user
+ * @returns Resolved absolute path
+ * @throws Error if file does not exist
+ */
+export function resolveInputPath(input) {
+    const path = isAbsolute(input) ? input : resolve(process.cwd(), input);
+    if (!existsSync(path)) {
+        throw new Error(`File not found: ${path}`);
+    }
+    return path;
+}
+/**
+ * Resolve output file path with sensible defaults.
+ * If output path is not specified, derives it from input path by replacing extension.
+ *
+ * @param inputPath  Resolved absolute input path
+ * @param output  Optional explicit output path
+ * @param ext  Target extension (default: ".html")
+ * @returns Resolved absolute output path
+ */
+export function resolveOutputPath(inputPath, output, ext = ".html") {
+    if (output) {
+        return isAbsolute(output) ? output : resolve(process.cwd(), output);
+    }
+    return inputPath.replace(/\.md$/i, ext);
+}
+/**
+ * Get base filename without extension for use as document title.
+ *
+ * @param filePath  Absolute or relative file path
+ * @returns Filename without extension
+ */
+export function getDocumentTitle(filePath) {
+    return basename(filePath, ".md");
+}
+/**
+ * Standard error codes for CLI operations.
+ * Enables consistent error handling across all commands.
+ */
+export var ErrorCode;
+(function (ErrorCode) {
+    /** Input file not found */
+    ErrorCode[ErrorCode["FILE_NOT_FOUND"] = 1] = "FILE_NOT_FOUND";
+    /** Theme resolution failed */
+    ErrorCode[ErrorCode["THEME_ERROR"] = 2] = "THEME_ERROR";
+    /** Rendering/export failed */
+    ErrorCode[ErrorCode["RENDER_ERROR"] = 3] = "RENDER_ERROR";
+    /** Invalid arguments or configuration */
+    ErrorCode[ErrorCode["INVALID_INPUT"] = 4] = "INVALID_INPUT";
+    /** Unknown/unexpected error */
+    ErrorCode[ErrorCode["UNKNOWN"] = 99] = "UNKNOWN";
+})(ErrorCode || (ErrorCode = {}));
+/**
+ * Custom error class for CLI operations with structured error codes.
+ * Replaces direct process.exit() calls for better error propagation.
+ */
+export class CLIError extends Error {
+    code;
+    cause;
+    constructor(message, code = ErrorCode.UNKNOWN, cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+        this.name = "CLIError";
+        if (cause) {
+            this.stack = `${this.message}\nCaused by: ${cause.stack}`;
+        }
+    }
+}
+//# sourceMappingURL=cli-utils.js.map

package/dist/utils/cli-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-utils.js","sourceRoot":"","sources":["../../src/utils/cli-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;IACvE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,MAAe,EAAE,GAAG,GAAG,OAAO;IACjF,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,SAWX;AAXD,WAAY,SAAS;IACnB,2BAA2B;IAC3B,6DAAkB,CAAA;IAClB,8BAA8B;IAC9B,uDAAe,CAAA;IACf,8BAA8B;IAC9B,yDAAgB,CAAA;IAChB,yCAAyC;IACzC,2DAAiB,CAAA;IACjB,+BAA+B;IAC/B,gDAAY,CAAA;AACd,CAAC,EAXW,SAAS,KAAT,SAAS,QAWpB;AAED;;;GAGG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGxB;IACA;IAHT,YACE,OAAe,EACR,OAAkB,SAAS,CAAC,OAAO,EACnC,KAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,SAAI,GAAJ,IAAI,CAA+B;QACnC,UAAK,GAAL,KAAK,CAAQ;QAGpB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,KAAK,GAAG,GAAG,IAAI,CAAC,OAAO,gBAAgB,KAAK,CAAC,KAAK,EAAE,CAAC;QAC5D,CAAC;IACH,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytechain.cn/colamd-themes",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Theme development & export tool for ColaMD — extract formatting, generate themes, and export Markdown to HTML/PDF",
   "type": "module",
   "main": "dist/index.js",

package/src/cli.ts

@@ -2,7 +2,8 @@
 
 import { Command } from "commander";
 import { existsSync, readdirSync, readFileSync } from "node:fs";
-import { join, isAbsolute } from "node:path";
+import { join, isAbsolute, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
 import chalk from "chalk";
 import ora from "ora";
 import { UrlExtractor } from "./extractors/url-extractor.js";
@@ -16,12 +17,28 @@ import { validateSeedPalette, summarizeIssues } from "./validators.js";
 import type { ThemeStyle } from "./models.js";
 import { registerExportCommands } from "./export-cli.js";
 
+/**
+ * Dynamically read version from package.json to avoid hardcoding.
+ * This ensures CLI --version always matches the published package version.
+ */
+function getPackageVersion(): string {
+  try {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    const pkgPath = join(__dirname, "../package.json");
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+    return pkg.version ?? "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
+
 const program = new Command();
 
 program
   .name("colamd-themes")
   .description("ColaMD Theme Development Tool — extract formatting and generate v3.0 paradigm CSS themes")
-  .version("0.2.0");
+  .version(getPackageVersion());
 
 // ── Shared extract options builder ──
 

package/src/export-cli.ts

@@ -2,11 +2,12 @@
  * Export CLI commands: set-theme, export-html, export-pdf, export (batch).
  *
  * These are registered onto the main Commander program in cli.ts.
+ * Uses unified error handling via CLIError and shared utility functions.
  */
 
 import { Command } from "commander";
-import { existsSync, readFileSync, readdirSync, statSync, mkdirSync } from "node:fs";
-import { join, isAbsolute, resolve, basename } from "node:path";
+import { readFileSync, readdirSync, statSync, mkdirSync } from "node:fs";
+import { join, resolve } from "node:path";
 import chalk from "chalk";
 import ora from "ora";
 import {
@@ -18,6 +19,13 @@ import {
   resolveTheme,
 } from "./theme-store.js";
 import { ColamdRenderer, type RenderInput } from "./renderer.js";
+import {
+  resolveInputPath,
+  resolveOutputPath,
+  getDocumentTitle,
+  CLIError,
+  ErrorCode,
+} from "./utils/cli-utils.js";
 
 // ── set-theme ──
 
@@ -29,54 +37,62 @@ function registerSetTheme(program: Command): void {
     .option("--css <file>", "Register as custom theme using this CSS file")
     .option("--default", "Set as the default export theme")
     .option("--remove", "Unregister a custom theme")
-    .action((name: string, options: { css?: string; default?: boolean; remove?: boolean }) => {
-      // Remove
-      if (options.remove) {
-        if (storeUnregister(name)) {
-          console.log(chalk.green(`✔ Unregistered custom theme "${name}"`));
-        } else {
-          console.log(chalk.yellow(`Theme "${name}" is not registered.`));
+    .action(async (name: string, options: { css?: string; default?: boolean; remove?: boolean }) => {
+      try {
+        // Remove
+        if (options.remove) {
+          const removed = await storeUnregister(name);
+          if (removed) {
+            console.log(chalk.green(`✔ Unregistered custom theme "${name}"`));
+          } else {
+            console.log(chalk.yellow(`Theme "${name}" is not registered.`));
+          }
+          return;
         }
-        return;
-      }
 
-      // Register custom theme
-      if (options.css) {
-        const cssPath = isAbsolute(options.css) ? options.css : resolve(process.cwd(), options.css);
-        if (!existsSync(cssPath)) {
-          console.error(chalk.red(`CSS file not found: ${cssPath}`));
-          process.exit(1);
+        // Register custom theme
+        if (options.css) {
+          const cssPath = resolveInputPath(options.css);
+          await storeRegister(name, cssPath);
+          console.log(chalk.green(`✔ Registered custom theme "${name}" → ${cssPath}`));
+          if (options.default) {
+            await storeSetDefault(name);
+            console.log(chalk.green(`✔ Set "${name}" as default theme`));
+          }
+          return;
         }
-        storeRegister(name, cssPath);
-        console.log(chalk.green(`✔ Registered custom theme "${name}" → ${cssPath}`));
-        if (options.default) {
-          storeSetDefault(name);
-          console.log(chalk.green(`✔ Set "${name}" as default theme`));
+
+        // Set as default (built-in or already registered)
+        if (!BUILTIN_THEMES.includes(name as any)) {
+          const config = await getConfig();
+          if (!(name in config.themes)) {
+            throw new CLIError(
+              `Unknown theme "${name}". ` +
+              chalk.dim(`Built-in: ${BUILTIN_THEMES.join(", ")}. `) +
+              chalk.dim("Or register a custom theme with --css <file>."),
+              ErrorCode.THEME_ERROR
+            );
+          }
         }
-        return;
-      }
 
-      // Set as default (built-in or already registered)
-      if (!BUILTIN_THEMES.includes(name as any)) {
-        const config = getConfig();
-        if (!(name in config.themes)) {
-          console.error(
-            chalk.red(`Unknown theme "${name}". `) +
-            chalk.dim(`Built-in: ${BUILTIN_THEMES.join(", ")}. `) +
-            chalk.dim("Or register a custom theme with --css <file>.")
-          );
-          process.exit(1);
+        await storeSetDefault(name);
+        console.log(chalk.green(`✔ Default theme set to "${name}"`));
+
+        // Show current config
+        const config = await getConfig();
+        console.log(chalk.dim(`\n  Default: ${config.defaultTheme}`));
+        const customs = Object.keys(config.themes);
+        if (customs.length) {
+          console.log(chalk.dim(`  Custom themes: ${customs.join(", ")}`));
+        }
+      } catch (err) {
+        if (err instanceof CLIError) {
+          console.error(chalk.red(err.message));
+          process.exit(err.code);
+        } else {
+          console.error(chalk.red(`Unexpected error: ${(err as Error).message}`));
+          process.exit(ErrorCode.UNKNOWN);
         }
-      }
-      storeSetDefault(name);
-      console.log(chalk.green(`✔ Default theme set to "${name}"`));
-
-      // Show current config
-      const config = getConfig();
-      console.log(chalk.dim(`\n  Default: ${config.defaultTheme}`));
-      const customs = Object.keys(config.themes);
-      if (customs.length) {
-        console.log(chalk.dim(`  Custom themes: ${customs.join(", ")}`));
       }
     });
 }
@@ -91,42 +107,47 @@ function registerExportHTML(program: Command): void {
     .option("-t, --theme <name>", "Theme name (built-in, custom, or CSS file path)")
     .option("-o, --output <path>", "Output HTML file path")
     .action(async (input: string, options: { theme?: string; output?: string }) => {
-      const inputPath = isAbsolute(input) ? input : resolve(process.cwd(), input);
-      if (!existsSync(inputPath)) {
-        console.error(chalk.red(`File not found: ${inputPath}`));
-        process.exit(1);
-      }
-
-      const md = readFileSync(inputPath, "utf-8");
-      const title = basename(inputPath, ".md");
-      const outputPath = options.output
-        ? (isAbsolute(options.output) ? options.output : resolve(process.cwd(), options.output))
-        : inputPath.replace(/\.md$/i, ".html");
-
-      let theme;
-      try {
-        theme = resolveTheme(options.theme);
-      } catch (err) {
-        console.error(chalk.red((err as Error).message));
-        process.exit(1);
-      }
-
-      const spinner = ora(`Rendering ${basename(inputPath)} → HTML (${theme.themeName})...`).start();
       try {
-        const { renderMarkdown } = await import("./renderer.js");
-        const result = await renderMarkdown({
-          markdown: md,
-          themeName: theme.themeName,
-          customCSS: theme.customCSS,
-          title,
-        });
-
-        const { writeFileSync } = await import("node:fs");
-        writeFileSync(outputPath, result.html, "utf-8");
-        spinner.succeed(chalk.green(`Exported: ${outputPath}`));
+        // Resolve paths using shared utilities
+        const inputPath = resolveInputPath(input);
+        const title = getDocumentTitle(inputPath);
+        const outputPath = resolveOutputPath(inputPath, options.output, ".html");
+
+        // Read markdown content
+        const md = readFileSync(inputPath, "utf-8");
+
+        // Resolve theme with async API
+        const theme = await resolveTheme(options.theme);
+
+        // Render with progress indicator
+        const spinner = ora(`Rendering ${title} → HTML (${theme.themeName})...`).start();
+        try {
+          const { renderMarkdown } = await import("./renderer.js");
+          const result = await renderMarkdown({
+            markdown: md,
+            themeName: theme.themeName,
+            customCSS: theme.customCSS,
+            title,
+          });
+
+          const { writeFileSync } = await import("node:fs");
+          writeFileSync(outputPath, result.html, "utf-8");
+          spinner.succeed(chalk.green(`Exported: ${outputPath}`));
+        } catch (renderErr) {
+          spinner.fail(chalk.red(`Export failed: ${(renderErr as Error).message}`));
+          throw new CLIError(
+            `HTML rendering failed: ${(renderErr as Error).message}`,
+            ErrorCode.RENDER_ERROR,
+            renderErr as Error
+          );
+        }
       } catch (err) {
-        spinner.fail(chalk.red(`Export failed: ${(err as Error).message}`));
-        process.exit(1);
+        if (err instanceof CLIError) {
+          process.exit(err.code);
+        } else {
+          console.error(chalk.red((err as Error).message));
+          process.exit(ErrorCode.FILE_NOT_FOUND);
+        }
       }
     });
 }
@@ -142,45 +163,59 @@ function registerExportPDF(program: Command): void {
     .option("-o, --output <path>", "Output PDF file path")
     .option("--format <size>", "Page format: A4, Letter, A3", "A4")
     .action(async (input: string, options: { theme?: string; output?: string; format?: string }) => {
-      const inputPath = isAbsolute(input) ? input : resolve(process.cwd(), input);
-      if (!existsSync(inputPath)) {
-        console.error(chalk.red(`File not found: ${inputPath}`));
-        process.exit(1);
-      }
-
-      const md = readFileSync(inputPath, "utf-8");
-      const title = basename(inputPath, ".md");
-      const outputPath = options.output
-        ? (isAbsolute(options.output) ? options.output : resolve(process.cwd(), options.output))
-        : inputPath.replace(/\.md$/i, ".pdf");
-
-      let theme;
       try {
-        theme = resolveTheme(options.theme);
-      } catch (err) {
-        console.error(chalk.red((err as Error).message));
-        process.exit(1);
-      }
+        // Resolve paths using shared utilities
+        const inputPath = resolveInputPath(input);
+        const title = getDocumentTitle(inputPath);
+        const outputPath = resolveOutputPath(inputPath, options.output, ".pdf");
+
+        // Read markdown content
+        const md = readFileSync(inputPath, "utf-8");
+
+        // Validate format option
+        const validFormats = ["A4", "Letter", "A3"];
+        if (!validFormats.includes(options.format ?? "")) {
+          throw new CLIError(
+            `Invalid page format: "${options.format}". Valid formats: ${validFormats.join(", ")}`,
+            ErrorCode.INVALID_INPUT
+          );
+        }
 
-      const spinner = ora(`Rendering ${basename(inputPath)} → PDF (${theme.themeName})...`).start();
-      try {
-        const { renderPDF } = await import("./renderer.js");
-        const pdfBuffer = await renderPDF(
-          {
-            markdown: md,
-            themeName: theme.themeName,
-            customCSS: theme.customCSS,
-            title,
-          },
-          { format: options.format as any }
-        );
+        // Resolve theme with async API
+        const theme = await resolveTheme(options.theme);
 
-        const { writeFileSync } = await import("node:fs");
-        writeFileSync(outputPath, pdfBuffer);
-        spinner.succeed(chalk.green(`Exported: ${outputPath}`));
+        // Render PDF with progress indicator
+        const spinner = ora(`Rendering ${title} → PDF (${theme.themeName})...`).start();
+        try {
+          const { renderPDF } = await import("./renderer.js");
+          const pdfBuffer = await renderPDF(
+            {
+              markdown: md,
+              themeName: theme.themeName,
+              customCSS: theme.customCSS,
+              title,
+            },
+            { format: options.format as any }
+          );
+
+          const { writeFileSync } = await import("node:fs");
+          writeFileSync(outputPath, pdfBuffer);
+          spinner.succeed(chalk.green(`Exported: ${outputPath}`));
+        } catch (renderErr) {
+          spinner.fail(chalk.red(`Export failed: ${(renderErr as Error).message}`));
+          throw new CLIError(
+            `PDF rendering failed: ${(renderErr as Error).message}`,
+            ErrorCode.RENDER_ERROR,
+            renderErr as Error
+          );
+        }
       } catch (err) {
-        spinner.fail(chalk.red(`Export failed: ${(err as Error).message}`));
-        process.exit(1);
+        if (err instanceof CLIError) {
+          process.exit(err.code);
+        } else {
+          console.error(chalk.red((err as Error).message));
+          process.exit(ErrorCode.FILE_NOT_FOUND);
+        }
       }
     });
 }
@@ -196,97 +231,117 @@ function registerExport(program: Command): void {
     .option("-t, --theme <name>", "Theme name")
     .option("-d, --output-dir <dir>", "Output directory", ".")
     .action(async (inputs: string[], options: { format?: string; theme?: string; outputDir?: string }) => {
-      // Resolve glob inputs (shell usually expands, but handle edge cases)
-      const files: string[] = [];
-      for (const input of inputs) {
-        const p = isAbsolute(input) ? input : resolve(process.cwd(), input);
-        if (existsSync(p)) {
-          if (statSync(p).isDirectory()) {
-            // Directory: include all .md files
-            const dirFiles = readdirSync(p)
-              .filter((f) => f.endsWith(".md"))
-              .map((f) => join(p, f));
-            files.push(...dirFiles);
-          } else {
-            files.push(p);
+      try {
+        // Resolve glob inputs (shell usually expands, but handle edge cases)
+        const files: string[] = [];
+        for (const input of inputs) {
+          try {
+            const p = resolveInputPath(input);
+            if (statSync(p).isDirectory()) {
+              // Directory: include all .md files
+              const dirFiles = readdirSync(p)
+                .filter((f) => f.endsWith(".md"))
+                .map((f) => join(p, f));
+              files.push(...dirFiles);
+            } else {
+              files.push(p);
+            }
+          } catch {
+            console.log(chalk.yellow(`Skipping (not found): ${input}`));
           }
-        } else {
-          console.log(chalk.yellow(`Skipping (not found): ${input}`));
         }
-      }
-
-      if (files.length === 0) {
-        console.error(chalk.red("No valid input files found."));
-        process.exit(1);
-      }
-
-      let theme;
-      try {
-        theme = resolveTheme(options.theme);
-      } catch (err) {
-        console.error(chalk.red((err as Error).message));
-        process.exit(1);
-      }
 
-      const outDir = isAbsolute(options.outputDir ?? ".")
-        ? (options.outputDir ?? ".")
-        : resolve(process.cwd(), options.outputDir ?? ".");
-      const fmt = options.format ?? "html";
-
-      // Ensure output directory exists
-      if (!existsSync(outDir)) mkdirSync(outDir, { recursive: true });
-
-      console.log(chalk.bold(`\nBatch export: ${files.length} file(s) → ${fmt.toUpperCase()}`));
-      console.log(chalk.dim(`  Theme: ${theme.themeName}`));
-      console.log(chalk.dim(`  Output: ${outDir}/\n`));
-
-      const renderer = new ColamdRenderer();
-      let success = 0;
-      let failed = 0;
+        if (files.length === 0) {
+          throw new CLIError("No valid input files found.", ErrorCode.FILE_NOT_FOUND);
+        }
 
-      try {
-        await renderer.init();
+        // Resolve theme with async API
+        const theme = await resolveTheme(options.theme);
 
-        for (const file of files) {
-          const name = basename(file, ".md");
-          const md = readFileSync(file, "utf-8");
-          const outPath = join(outDir, `${name}.${fmt === "pdf" ? "pdf" : "html"}`);
-          const spinner = ora(`  ${name}.md`).start();
+        // Setup output directory
+        const outDir = resolve(process.cwd(), options.outputDir ?? ".");
+        const fmt = options.format ?? "html";
 
-          try {
-            const input: RenderInput = {
-              markdown: md,
-              themeName: theme.themeName,
-              customCSS: theme.customCSS,
-              title: name,
-            };
+        if (!["html", "pdf"].includes(fmt)) {
+          throw new CLIError(
+            `Invalid format: "${fmt}". Supported formats: html, pdf`,
+            ErrorCode.INVALID_INPUT
+          );
+        }
 
-            if (fmt === "pdf") {
-              const pdfBuffer = await renderer.exportPDF(input);
-              const { writeFileSync } = await import("node:fs");
-              writeFileSync(outPath, pdfBuffer);
-            } else {
-              const result = await renderer.render(input);
-              const { writeFileSync } = await import("node:fs");
-              writeFileSync(outPath, result.html, "utf-8");
+        // Ensure output directory exists
+        const { existsSync: dirExists } = await import("node:fs");
+        if (!dirExists(outDir)) mkdirSync(outDir, { recursive: true });
+
+        console.log(chalk.bold(`\nBatch export: ${files.length} file(s) → ${fmt.toUpperCase()}`));
+        console.log(chalk.dim(`  Theme: ${theme.themeName}`));
+        console.log(chalk.dim(`  Output: ${outDir}/\n`));
+
+        // Initialize renderer for batch processing
+        const renderer = new ColamdRenderer();
+        let success = 0;
+        let failed = 0;
+
+        try {
+          await renderer.init();
+
+          for (const file of files) {
+            const name = getDocumentTitle(file);
+            const md = readFileSync(file, "utf-8");
+            const outPath = join(outDir, `${name}.${fmt === "pdf" ? "pdf" : "html"}`);
+            const spinner = ora(`  ${name}.md`).start();
+
+            try {
+              const input: RenderInput = {
+                markdown: md,
+                themeName: theme.themeName,
+                customCSS: theme.customCSS,
+                title: name,
+              };
+
+              if (fmt === "pdf") {
+                const pdfBuffer = await renderer.exportPDF(input);
+                const { writeFileSync } = await import("node:fs");
+                writeFileSync(outPath, pdfBuffer);
+              } else {
+                const result = await renderer.render(input);
+                const { writeFileSync } = await import("node:fs");
+                writeFileSync(outPath, result.html, "utf-8");
+              }
+
+              spinner.succeed(`${name}.${fmt === "pdf" ? "pdf" : "html"}`);
+              success++;
+            } catch (fileErr) {
+              spinner.fail(`${name}.md — ${(fileErr as Error).message}`);
+              failed++;
             }
-
-            spinner.succeed(`${name}.${fmt === "pdf" ? "pdf" : "html"}`);
-            success++;
-          } catch (err) {
-            spinner.fail(`${name}.md — ${(err as Error).message}`);
-            failed++;
           }
+        } finally {
+          await renderer.close();
         }
-      } finally {
-        await renderer.close();
-      }
 
-      console.log(
-        chalk.bold(`\nDone: ${chalk.green(`${success} exported`)}`) +
-        (failed ? chalk.red(`, ${failed} failed`) : "") +
-        "\n"
-      );
+        // Summary
+        console.log(
+          chalk.bold(`\nDone: ${chalk.green(`${success} exported`)}`) +
+          (failed ? chalk.red(`, ${failed} failed`) : "") +
+          "\n"
+        );
+
+        if (failed > 0) {
+          throw new CLIError(
+            `${failed} file(s) failed to export`,
+            ErrorCode.RENDER_ERROR
+          );
+        }
+      } catch (err) {
+        if (err instanceof CLIError) {
+          console.error(chalk.red(err.message));
+          process.exit(err.code);
+        } else {
+          console.error(chalk.red((err as Error).message));
+          process.exit(ErrorCode.UNKNOWN);
+        }
+      }
     });
 }