@clidey/dory 0.23.0 → 0.24.0

package/bin/dist/dory.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=dory.d.ts.map

package/bin/dist/dory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dory.d.ts","sourceRoot":"","sources":["../dory.ts"],"names":[],"mappings":""}

package/bin/dist/dory.js

@@ -0,0 +1,337 @@
+#!/usr/bin/env node
+import { execSync } from 'child_process';
+import { existsSync, rmSync, mkdirSync, cpSync, readFileSync, readdirSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { createServer } from 'http';
+import sirv from 'sirv';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Get the root directory of the Dory package
+const getDoryRoot = () => {
+    // In development: bin/dory.ts -> root is parent
+    // In production: bin/dist/dory.js -> root is parent of parent
+    const isDevelopment = __dirname.endsWith('bin');
+    return isDevelopment ? resolve(__dirname, '..') : resolve(__dirname, '..', '..');
+};
+// Get the user's current working directory
+const getUserRoot = () => process.cwd();
+const validateDoryConfig = (config) => {
+    if (!config || typeof config !== 'object') {
+        throw new Error('Configuration must be a valid object');
+    }
+    // Add more validation as needed
+};
+const commands = {
+    build: () => {
+        console.log('🐟 Dory is ready to build your docs!');
+        const userRoot = getUserRoot();
+        const doryRoot = getDoryRoot();
+        const doryConfigPath = resolve(userRoot, 'dory.json');
+        const tempDocsDir = resolve(doryRoot, 'docs');
+        const doryDistDir = resolve(doryRoot, 'dist');
+        const userDistDir = resolve(userRoot, 'dist');
+        // Step 1: Validate prerequisites before making any changes
+        console.log('🔍 Validating project structure...');
+        if (!existsSync(doryConfigPath)) {
+            console.error('❌ dory.json not found in current directory');
+            console.error(`   Looking for: ${doryConfigPath}`);
+            console.error('   Create a dory.json file to configure your documentation site');
+            process.exit(1);
+        }
+        // Read and validate dory.json
+        let config;
+        try {
+            const configContent = readFileSync(doryConfigPath, 'utf8');
+            config = JSON.parse(configContent);
+            validateDoryConfig(config);
+            console.log(`📋 Building: ${config.name || 'Documentation'}`);
+        }
+        catch (error) {
+            console.error('❌ Failed to parse dory.json:');
+            if (error instanceof Error) {
+                console.error(`   ${error.message}`);
+            }
+            process.exit(1);
+        }
+        // Check if pnpm is available
+        try {
+            execSync('pnpm --version', { stdio: 'ignore' });
+        }
+        catch {
+            console.error('❌ pnpm is not installed');
+            console.error('   Install it with: npm install -g pnpm');
+            process.exit(1);
+        }
+        // Step 2: Clean up temp directories
+        console.log('🧹 Preparing workspace...');
+        if (existsSync(tempDocsDir)) {
+            rmSync(tempDocsDir, { recursive: true, force: true });
+        }
+        try {
+            // Step 3: Copy user files to temp docs directory
+            mkdirSync(tempDocsDir, { recursive: true });
+            console.log('📁 Gathering project files...');
+            // Define files/dirs to exclude
+            const excludeItems = new Set([
+                'node_modules',
+                'dist',
+                '.git',
+                '.github',
+                'docs',
+                '.DS_Store',
+                '.env',
+                '.env.local',
+                'pnpm-lock.yaml',
+                'package-lock.json',
+                'yarn.lock'
+            ]);
+            const items = readdirSync(userRoot);
+            let copiedCount = 0;
+            for (const item of items) {
+                if (excludeItems.has(item)) {
+                    continue;
+                }
+                const srcPath = resolve(userRoot, item);
+                const destPath = resolve(tempDocsDir, item);
+                try {
+                    cpSync(srcPath, destPath, { recursive: true, force: true });
+                    copiedCount++;
+                }
+                catch (error) {
+                    console.warn(`⚠️  Could not copy ${item}: ${error instanceof Error ? error.message : 'unknown error'}`);
+                }
+            }
+            console.log(`✅ Copied ${copiedCount} items`);
+            // Step 4: Run the build
+            console.log('⚡ Building documentation...');
+            try {
+                execSync('pnpm run build', {
+                    stdio: 'inherit',
+                    cwd: doryRoot,
+                    env: { ...process.env }
+                });
+            }
+            catch (error) {
+                console.error('❌ Build failed');
+                console.error('   Check the error messages above for details');
+                throw error;
+            }
+            // Step 5: Verify build output
+            console.log('🔍 Verifying build output...');
+            if (!existsSync(doryDistDir)) {
+                console.error('❌ Build completed but dist folder was not created');
+                console.error(`   Expected: ${doryDistDir}`);
+                process.exit(1);
+            }
+            const indexHtml = resolve(doryDistDir, 'index.html');
+            if (!existsSync(indexHtml)) {
+                console.error('❌ Build incomplete: index.html not found');
+                console.error('   The build may have failed silently');
+                process.exit(1);
+            }
+            // Check if dist has content
+            const distFiles = readdirSync(doryDistDir);
+            if (distFiles.length === 0) {
+                console.error('❌ Build completed but dist folder is empty');
+                process.exit(1);
+            }
+            console.log('🎉 Build completed successfully!');
+            // Step 6: Copy dist to user's directory
+            console.log('📦 Copying build output...');
+            // Only copy if they're different directories
+            if (doryDistDir !== userDistDir) {
+                if (existsSync(userDistDir)) {
+                    rmSync(userDistDir, { recursive: true, force: true });
+                }
+                cpSync(doryDistDir, userDistDir, { recursive: true, force: true });
+            }
+            console.log('✨ Documentation ready in dist/');
+        }
+        finally {
+            // Step 7: Always clean up temp directories
+            console.log('🧹 Cleaning up...');
+            try {
+                if (existsSync(tempDocsDir)) {
+                    rmSync(tempDocsDir, { recursive: true, force: true });
+                }
+                // Only clean up doryDistDir if it's different from userDistDir
+                // (in production they're different, in dev they might be the same)
+                if (doryDistDir !== userDistDir && existsSync(doryDistDir)) {
+                    rmSync(doryDistDir, { recursive: true, force: true });
+                }
+            }
+            catch (error) {
+                console.warn('⚠️  Could not clean up temp directories');
+            }
+            console.log('✅ Done!');
+        }
+    },
+    preview: () => {
+        console.log('👀 Starting docs preview...');
+        const userRoot = getUserRoot();
+        const distDir = resolve(userRoot, 'dist');
+        let port = parseInt(process.env.PORT || '3000', 10);
+        // Validate dist folder exists
+        if (!existsSync(distDir)) {
+            console.error('❌ dist folder not found');
+            console.error(`   Looking for: ${distDir}`);
+            console.error('   Run "dory build" first to generate the documentation');
+            process.exit(1);
+        }
+        // Check if dist has content
+        const distFiles = readdirSync(distDir);
+        if (distFiles.length === 0) {
+            console.error('❌ dist folder is empty');
+            console.error('   Run "dory build" to generate documentation');
+            process.exit(1);
+        }
+        const serve = sirv(distDir, {
+            dev: false,
+            single: true,
+            etag: true,
+            gzip: true,
+            brotli: true,
+        });
+        const server = createServer((req, res) => {
+            serve(req, res);
+        });
+        const tryPort = (currentPort) => {
+            server.listen(currentPort)
+                .on('listening', () => {
+                console.log(`🚀 Documentation live at http://localhost:${currentPort}`);
+                console.log('   Press Ctrl+C to stop the server');
+            })
+                .on('error', (err) => {
+                if (err.code === 'EADDRINUSE') {
+                    console.log(`⚠️  Port ${currentPort} in use, trying ${currentPort + 1}...`);
+                    tryPort(currentPort + 1);
+                }
+                else {
+                    console.error('❌ Failed to start server:', err.message);
+                    process.exit(1);
+                }
+            });
+        };
+        tryPort(port);
+    },
+    'verify:content': async () => {
+        const args = process.argv.slice(3);
+        let content = '';
+        let fileName = '';
+        // Parse arguments
+        for (let i = 0; i < args.length; i++) {
+            if (args[i] === '--content' && i + 1 < args.length) {
+                content = args[i + 1];
+                break;
+            }
+            else if (args[i] === '--file' && i + 1 < args.length) {
+                const filePath = resolve(getUserRoot(), args[i + 1]);
+                if (!existsSync(filePath)) {
+                    console.error(`❌ File not found: ${filePath}`);
+                    process.exit(1);
+                }
+                content = readFileSync(filePath, 'utf8');
+                fileName = filePath;
+                break;
+            }
+        }
+        if (!content) {
+            console.error('❌ --content or --file argument is required');
+            console.log('Usage:');
+            console.log('  dory verify:content --content "<mdx-content>"');
+            console.log('  dory verify:content --file <path-to-mdx-file>');
+            process.exit(1);
+        }
+        try {
+            const doryRoot = getDoryRoot();
+            const processorPath = resolve(doryRoot, 'src', 'mdx', 'processor.ts');
+            if (!existsSync(processorPath)) {
+                console.error('❌ MDX processor not found');
+                console.error('   This feature requires Dory source files');
+                process.exit(1);
+            }
+            // Use the shared MDX processor that matches the main build exactly
+            const { verifyMdxContent } = await import(processorPath);
+            const result = await verifyMdxContent(content, fileName);
+            if (!result.valid) {
+                throw result.error;
+            }
+            // Silent success - no output means no errors
+        }
+        catch (error) {
+            console.error('❌ MDX compilation failed:');
+            if (error instanceof Error) {
+                console.error(`   ${error.message}`);
+                // Provide more detailed error information if available
+                const errorWithPosition = error;
+                if (errorWithPosition.line !== undefined && errorWithPosition.column !== undefined) {
+                    console.error(`   at line ${errorWithPosition.line}, column ${errorWithPosition.column}`);
+                }
+                if (errorWithPosition.source) {
+                    console.error('   Source:', errorWithPosition.source);
+                }
+            }
+            process.exit(1);
+        }
+    },
+    help: () => {
+        console.log(`
+🐟 Dory CLI - Documentation Builder
+
+Usage:
+  dory <command> [options]
+
+Commands:
+  build            Build your documentation site
+                   Requirements: dory.json in current directory
+                   Output: dist/ folder with static site
+
+  preview          Preview built documentation
+                   Requirements: dist/ folder (run build first)
+                   Starts local server on port 3000
+
+  verify:content   Verify MDX content compilation
+                   Options: --content "<mdx>" or --file <path>
+                   Silent on success, shows errors on failure
+
+  help             Show this help message
+
+Examples:
+  dory build
+  dory preview
+  dory verify:content --content "# Hello World"
+  dory verify:content --file docs/intro.mdx
+
+For more information, visit: https://github.com/clidey/dory
+`);
+    }
+};
+// Parse command line arguments
+const command = process.argv[2];
+async function runCommand() {
+    if (!command || command === 'help' || command === '--help' || command === '-h') {
+        commands.help();
+        return;
+    }
+    if (command in commands) {
+        await commands[command]();
+    }
+    else {
+        console.error(`❌ Unknown command: ${command}`);
+        console.log('   Run "dory help" for available commands');
+        process.exit(1);
+    }
+}
+runCommand().catch((error) => {
+    console.error('❌ Command failed');
+    if (error instanceof Error) {
+        console.error(`   ${error.message}`);
+        if (error.stack && process.env.DEBUG) {
+            console.error('\nStack trace:');
+            console.error(error.stack);
+        }
+    }
+    process.exit(1);
+});
+//# sourceMappingURL=dory.js.map

package/bin/dist/dory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dory.js","sourceRoot":"","sources":["../dory.ts"],"names":[],"mappings":"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"}

package/bin/dory.ts

@@ -1,6 +1,5 @@
-#!/usr/bin/env -S npx tsx
+#!/usr/bin/env node
 
-// @ts-nocheck - gang
 import { execSync } from 'child_process';
 import { existsSync, rmSync, mkdirSync, cpSync, readFileSync, readdirSync } from 'fs';
 import { resolve, dirname } from 'path';
@@ -11,96 +10,221 @@ import sirv from 'sirv';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
+// Get the root directory of the Dory package
+const getDoryRoot = (): string => {
+  // In development: bin/dory.ts -> root is parent
+  // In production: bin/dist/dory.js -> root is parent of parent
+  const isDevelopment = __dirname.endsWith('bin');
+  return isDevelopment ? resolve(__dirname, '..') : resolve(__dirname, '..', '..');
+};
+
+// Get the user's current working directory
+const getUserRoot = (): string => process.cwd();
+
+interface DoryConfig {
+  name?: string;
+  description?: string;
+  navigation?: unknown;
+  [key: string]: unknown;
+}
+
+const validateDoryConfig = (config: DoryConfig): void => {
+  if (!config || typeof config !== 'object') {
+    throw new Error('Configuration must be a valid object');
+  }
+  // Add more validation as needed
+};
+
 const commands = {
   build: () => {
     console.log('🐟 Dory is ready to build your docs!');
-    
-    // Clear the docs folder if it exists
-    const docsDir = resolve(__dirname, '..', 'docs');
-    if (existsSync(docsDir)) {
-      console.log('🧹 Tidying up the workspace...');
-      rmSync(docsDir, { recursive: true, force: true });
-    }
-    
-    // Check if dory.json exists in current directory
-    const currentDir = process.cwd();
-    const doryConfigPath = resolve(currentDir, 'dory.json');
-    
+
+    const userRoot = getUserRoot();
+    const doryRoot = getDoryRoot();
+    const doryConfigPath = resolve(userRoot, 'dory.json');
+    const tempDocsDir = resolve(doryRoot, 'docs');
+    const doryDistDir = resolve(doryRoot, 'dist');
+    const userDistDir = resolve(userRoot, 'dist');
+
+    // Step 1: Validate prerequisites before making any changes
+    console.log('🔍 Validating project structure...');
+
     if (!existsSync(doryConfigPath)) {
-      console.error('❌ Oops! dory.json is missing from your project');
+      console.error('❌ dory.json not found in current directory');
+      console.error(`   Looking for: ${doryConfigPath}`);
+      console.error('   Create a dory.json file to configure your documentation site');
       process.exit(1);
     }
-    
+
     // Read and validate dory.json
+    let config: DoryConfig;
     try {
-      const config = JSON.parse(readFileSync(doryConfigPath, 'utf8'));
-      console.log(`📋 Building: ${config.name || 'Your awesome project'}`);
+      const configContent = readFileSync(doryConfigPath, 'utf8');
+      config = JSON.parse(configContent) as DoryConfig;
+      validateDoryConfig(config);
+      console.log(`📋 Building: ${config.name || 'Documentation'}`);
     } catch (error) {
-      console.error('❌ Your dory.json seems to have some issues:', error.message);
-      process.exit(1);
-    }
-    
-    mkdirSync(docsDir, { recursive: true });
-    
-    console.log('📁 Gathering your project files...');
-    cpSync(doryConfigPath, resolve(docsDir, 'dory.json'));
-    
-    const copyFiles = (src, dest) => {
-      if (existsSync(src)) {
-        if (existsSync(dest)) {
-          rmSync(dest, { recursive: true, force: true });
-        }
-        cpSync(src, dest, { recursive: true });
-      }
-    };
-    
-    // Copy all files and directories except node_modules, dist, and .git
-    const excludeDirs = ['node_modules', 'dist', '.git', 'docs', 'pnpm-lock.yaml'];
-    
-    const items = readdirSync(currentDir);
-    for (const item of items) {
-      if (!excludeDirs.includes(item)) {
-        const srcPath = resolve(currentDir, item);
-        const destPath = resolve(docsDir, item);
-        copyFiles(srcPath, destPath);
+      console.error('❌ Failed to parse dory.json:');
+      if (error instanceof Error) {
+        console.error(`   ${error.message}`);
       }
+      process.exit(1);
     }
-    
-    console.log('✅ All files gathered successfully!');
-    
-    // Run the build command
-    console.log('⚡ Magic is happening...');
+
+    // Check if pnpm is available
     try {
-      execSync('npm run build', { stdio: 'inherit', cwd: __dirname });
-    } catch (error) {
-      console.error('❌ Build failed:', error.message);
+      execSync('pnpm --version', { stdio: 'ignore' });
+    } catch {
+      console.error('❌ pnpm is not installed');
+      console.error('   Install it with: npm install -g pnpm');
       process.exit(1);
     }
-    
-    // Check if dist folder was created
-    const distDir = resolve(__dirname, '..', 'dist');
-    if (existsSync(distDir)) {
+
+    // Step 2: Clean up temp directories
+    console.log('🧹 Preparing workspace...');
+    if (existsSync(tempDocsDir)) {
+      rmSync(tempDocsDir, { recursive: true, force: true });
+    }
+
+    try {
+      // Step 3: Copy user files to temp docs directory
+      mkdirSync(tempDocsDir, { recursive: true });
+
+      console.log('📁 Gathering project files...');
+
+      // Define files/dirs to exclude
+      const excludeItems = new Set([
+        'node_modules',
+        'dist',
+        '.git',
+        '.github',
+        'docs',
+        '.DS_Store',
+        '.env',
+        '.env.local',
+        'pnpm-lock.yaml',
+        'package-lock.json',
+        'yarn.lock'
+      ]);
+
+      const items = readdirSync(userRoot);
+      let copiedCount = 0;
+
+      for (const item of items) {
+        if (excludeItems.has(item)) {
+          continue;
+        }
+
+        const srcPath = resolve(userRoot, item);
+        const destPath = resolve(tempDocsDir, item);
+
+        try {
+          cpSync(srcPath, destPath, { recursive: true, force: true });
+          copiedCount++;
+        } catch (error) {
+          console.warn(`⚠️  Could not copy ${item}: ${error instanceof Error ? error.message : 'unknown error'}`);
+        }
+      }
+
+      console.log(`✅ Copied ${copiedCount} items`);
+
+      // Step 4: Run the build
+      console.log('⚡ Building documentation...');
+
+      try {
+        execSync('pnpm run build', {
+          stdio: 'inherit',
+          cwd: doryRoot,
+          env: { ...process.env }
+        });
+      } catch (error) {
+        console.error('❌ Build failed');
+        console.error('   Check the error messages above for details');
+        throw error;
+      }
+
+      // Step 5: Verify build output
+      console.log('🔍 Verifying build output...');
+
+      if (!existsSync(doryDistDir)) {
+        console.error('❌ Build completed but dist folder was not created');
+        console.error(`   Expected: ${doryDistDir}`);
+        process.exit(1);
+      }
+
+      const indexHtml = resolve(doryDistDir, 'index.html');
+      if (!existsSync(indexHtml)) {
+        console.error('❌ Build incomplete: index.html not found');
+        console.error('   The build may have failed silently');
+        process.exit(1);
+      }
+
+      // Check if dist has content
+      const distFiles = readdirSync(doryDistDir);
+      if (distFiles.length === 0) {
+        console.error('❌ Build completed but dist folder is empty');
+        process.exit(1);
+      }
+
       console.log('🎉 Build completed successfully!');
-      console.log('📦 Moving your docs to the right place...');
-      cpSync(distDir, resolve(currentDir, 'dist'), { recursive: true });
-      console.log('✨ Your docs are ready in the dist folder!');
-    } else {
-      console.log('⚠️  Build completed but no output found');
+
+      // Step 6: Copy dist to user's directory
+      console.log('📦 Copying build output...');
+
+      // Only copy if they're different directories
+      if (doryDistDir !== userDistDir) {
+        if (existsSync(userDistDir)) {
+          rmSync(userDistDir, { recursive: true, force: true });
+        }
+        cpSync(doryDistDir, userDistDir, { recursive: true, force: true });
+      }
+
+      console.log('✨ Documentation ready in dist/');
+
+    } finally {
+      // Step 7: Always clean up temp directories
+      console.log('🧹 Cleaning up...');
+
+      try {
+        if (existsSync(tempDocsDir)) {
+          rmSync(tempDocsDir, { recursive: true, force: true });
+        }
+        // Only clean up doryDistDir if it's different from userDistDir
+        // (in production they're different, in dev they might be the same)
+        if (doryDistDir !== userDistDir && existsSync(doryDistDir)) {
+          rmSync(doryDistDir, { recursive: true, force: true });
+        }
+      } catch (error) {
+        console.warn('⚠️  Could not clean up temp directories');
+      }
+
+      console.log('✅ Done!');
     }
-    rmSync(distDir, { recursive: true, force: true });
-    
-    // Revert docs folder back to original state
-    console.log('🧹 Cleaning up...');
-    rmSync(docsDir, { recursive: true, force: true });
-    console.log('✅ All done!');
   },
 
   preview: () => {
-    console.log('👀 Starting your docs preview...');
-    const currentDir = process.cwd();
-    const distDir = resolve(currentDir, 'dist');
+    console.log('👀 Starting docs preview...');
+
+    const userRoot = getUserRoot();
+    const distDir = resolve(userRoot, 'dist');
     let port = parseInt(process.env.PORT || '3000', 10);
 
+    // Validate dist folder exists
+    if (!existsSync(distDir)) {
+      console.error('❌ dist folder not found');
+      console.error(`   Looking for: ${distDir}`);
+      console.error('   Run "dory build" first to generate the documentation');
+      process.exit(1);
+    }
+
+    // Check if dist has content
+    const distFiles = readdirSync(distDir);
+    if (distFiles.length === 0) {
+      console.error('❌ dist folder is empty');
+      console.error('   Run "dory build" to generate documentation');
+      process.exit(1);
+    }
+
     const serve = sirv(distDir, {
       dev: false,
       single: true,
@@ -113,14 +237,15 @@ const commands = {
       serve(req, res);
     });
 
-    const tryPort = (currentPort: number) => {
+    const tryPort = (currentPort: number): void => {
       server.listen(currentPort)
         .on('listening', () => {
-          console.log(`🚀 Your docs are live at http://localhost:${currentPort}`);
+          console.log(`🚀 Documentation live at http://localhost:${currentPort}`);
+          console.log('   Press Ctrl+C to stop the server');
         })
-        .on('error', (err: any) => {
+        .on('error', (err: NodeJS.ErrnoException) => {
           if (err.code === 'EADDRINUSE') {
-            console.log(`⚠️  Port ${currentPort} is busy, trying ${currentPort + 1}...`);
+            console.log(`⚠️  Port ${currentPort} in use, trying ${currentPort + 1}...`);
             tryPort(currentPort + 1);
           } else {
             console.error('❌ Failed to start server:', err.message);
@@ -136,16 +261,16 @@ const commands = {
     const args = process.argv.slice(3);
     let content = '';
     let fileName = '';
-    
+
     // Parse arguments
     for (let i = 0; i < args.length; i++) {
       if (args[i] === '--content' && i + 1 < args.length) {
         content = args[i + 1];
         break;
       } else if (args[i] === '--file' && i + 1 < args.length) {
-        const filePath = args[i + 1];
+        const filePath = resolve(getUserRoot(), args[i + 1]);
         if (!existsSync(filePath)) {
-          console.error(`❌ Error: File not found: ${filePath}`);
+          console.error(`❌ File not found: ${filePath}`);
           process.exit(1);
         }
         content = readFileSync(filePath, 'utf8');
@@ -153,88 +278,115 @@ const commands = {
         break;
       }
     }
-    
+
     if (!content) {
-      console.error('❌ Error: --content or --file argument is required');
-      console.log('Usage: dory verify:content --content "<mdx-content>" | --file <path-to-mdx-file>');
+      console.error('❌ --content or --file argument is required');
+      console.log('Usage:');
+      console.log('  dory verify:content --content "<mdx-content>"');
+      console.log('  dory verify:content --file <path-to-mdx-file>');
       process.exit(1);
     }
-    
+
     try {
+      const doryRoot = getDoryRoot();
+      const processorPath = resolve(doryRoot, 'src', 'mdx', 'processor.ts');
+
+      if (!existsSync(processorPath)) {
+        console.error('❌ MDX processor not found');
+        console.error('   This feature requires Dory source files');
+        process.exit(1);
+      }
+
       // Use the shared MDX processor that matches the main build exactly
-      const { verifyMdxContent } = await import('../src/mdx/processor.ts');
+      const { verifyMdxContent } = await import(processorPath);
       const result = await verifyMdxContent(content, fileName);
-      
+
       if (!result.valid) {
         throw result.error;
       }
-      
+
       // Silent success - no output means no errors
-      
+
     } catch (error) {
       console.error('❌ MDX compilation failed:');
-      console.error(error.message);
-      
-      // Provide more detailed error information if available
-      if (error.line !== undefined && error.column !== undefined) {
-        console.error(`   at line ${error.line}, column ${error.column}`);
-      }
-      if (error.source) {
-        console.error('   Source:', error.source);
+      if (error instanceof Error) {
+        console.error(`   ${error.message}`);
+
+        // Provide more detailed error information if available
+        const errorWithPosition = error as Error & { line?: number; column?: number; source?: string };
+        if (errorWithPosition.line !== undefined && errorWithPosition.column !== undefined) {
+          console.error(`   at line ${errorWithPosition.line}, column ${errorWithPosition.column}`);
+        }
+        if (errorWithPosition.source) {
+          console.error('   Source:', errorWithPosition.source);
+        }
       }
-      
+
       process.exit(1);
     }
   },
 
   help: () => {
     console.log(`
-🐟 Dory CLI - Your Friendly Documentation Builder
+🐟 Dory CLI - Documentation Builder
 
 Usage:
-  dory <command>
+  dory <command> [options]
 
 Commands:
-  build         Build your documentation site
-                - Needs dory.json in your project
-                - Creates a beautiful dist folder
-                
-  verify:content  Verify that MDX content compiles without errors
-                  - Silent on success, shows errors on failure
-                  - Uses the same preprocessing as the main build
-                  - Accepts --content or --file arguments
-                
-  preview       Preview your built documentation
-                - Shows your docs in the browser
-                - Run build first!
-                
-  help          Show this help message
+  build            Build your documentation site
+                   Requirements: dory.json in current directory
+                   Output: dist/ folder with static site
+
+  preview          Preview built documentation
+                   Requirements: dist/ folder (run build first)
+                   Starts local server on port 3000
+
+  verify:content   Verify MDX content compilation
+                   Options: --content "<mdx>" or --file <path>
+                   Silent on success, shows errors on failure
+
+  help             Show this help message
 
 Examples:
-  dory build                                      # Build your docs
-  dory verify:content --content "# Hello World"  # Verify MDX content
-  dory verify:content --file content.mdx         # Verify MDX from file
-  dory preview                                    # Preview your docs
+  dory build
+  dory preview
+  dory verify:content --content "# Hello World"
+  dory verify:content --file docs/intro.mdx
+
+For more information, visit: https://github.com/clidey/dory
 `);
   }
 };
 
+type CommandName = keyof typeof commands;
+
 // Parse command line arguments
 const command = process.argv[2];
 
-async function runCommand() {
+async function runCommand(): Promise<void> {
   if (!command || command === 'help' || command === '--help' || command === '-h') {
     commands.help();
-  } else if (commands[command]) {
-    await commands[command]();
+    return;
+  }
+
+  if (command in commands) {
+    await commands[command as CommandName]();
   } else {
     console.error(`❌ Unknown command: ${command}`);
-    console.log('Run "dory help" for usage information');
+    console.log('   Run "dory help" for available commands');
     process.exit(1);
   }
 }
 
-runCommand().catch((error) => {
-  console.error('❌ Command failed:', error.message);
+runCommand().catch((error: unknown) => {
+  console.error('❌ Command failed');
+  if (error instanceof Error) {
+    console.error(`   ${error.message}`);
+    if (error.stack && process.env.DEBUG) {
+      console.error('\nStack trace:');
+      console.error(error.stack);
+    }
+  }
   process.exit(1);
 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@clidey/dory",
   "private": false,
-  "version": "0.23.0",
+  "version": "0.24.0",
   "type": "module",
   "description": "A CLI tool for building and previewing documentation sites",
   "keywords": [
@@ -12,7 +12,7 @@
     "static-site"
   ],
   "bin": {
-    "dory": "./bin/dory.ts"
+    "dory": "./bin/dist/dory.js"
   },
   "repository": {
     "type": "git",
@@ -26,9 +26,11 @@
   },
   "scripts": {
     "dev": "vite",
-    "build": "tsc -b && vite build",
+    "build": "npm run build:cli && tsc -b && vite build",
+    "build:cli": "tsc -p tsconfig.bin.json",
     "preview": "vite preview",
-    "publish": "npm publish --access public"
+    "publish": "npm run build && npm publish --access public",
+    "prepublishOnly": "npm run build"
   },
   "dependencies": {
     "@algolia/autocomplete-core": "^1.19.2",

package/tsconfig.app.json

@@ -28,5 +28,6 @@
     "noFallthroughCasesInSwitch": true,
     "noUncheckedSideEffectImports": true
   },
-  "include": ["src"]
+  "include": ["src"],
+  "exclude": ["src/plugins"]
 }

package/tsconfig.bin.json

@@ -4,17 +4,21 @@
     "lib": ["ES2023"],
     "module": "ESNext",
     "moduleResolution": "node",
-    "allowImportingTsExtensions": true,
     "skipLibCheck": true,
-    "strict": false,
+    "strict": true,
     "esModuleInterop": true,
     "allowSyntheticDefaultImports": true,
-    "noEmit": true,
-    "noImplicitAny": false,
-    "noImplicitReturns": false,
-    "noImplicitThis": false
+    "noEmit": false,
+    "outDir": "./bin/dist",
+    "rootDir": "./bin",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
   },
   "include": [
-    "bin/dory.ts"
+    "bin/**/*.ts"
+  ],
+  "exclude": [
+    "bin/dist"
   ]
 }

package/tsconfig.node.json

@@ -5,6 +5,7 @@
     "lib": ["ES2023"],
     "module": "ESNext",
     "skipLibCheck": true,
+    "types": ["node"],
 
     /* Bundler mode */
     "moduleResolution": "bundler",
@@ -21,5 +22,5 @@
     "noFallthroughCasesInSwitch": true,
     "noUncheckedSideEffectImports": true
   },
-  "include": ["vite.config.ts"]
+  "include": ["vite.config.ts", "src/plugins/**/*.ts", "bin/**/*.ts"]
 }