loopwind 0.9.1

package/dist/commands/preview.js

@@ -0,0 +1,296 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import express from 'express';
+import { watch } from 'chokidar';
+import { renderToSVG } from '../lib/renderer.js';
+import { getTemplatePathAsync } from '../lib/utils.js';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import fs from 'fs/promises';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+export const previewCommand = new Command('preview')
+    .description('Preview a template with hot module replacement')
+    .argument('<template>', 'Template name to preview')
+    .argument('[props]', 'Template props as JSON string or path to JSON file')
+    .option('-p, --port <port>', 'Port to run the preview server on', '3000')
+    .option('-f, --format <format>', 'Output format (svg or png)', 'png')
+    .option('--no-open', 'Don\'t automatically open the browser')
+    .addHelpText('after', `
+Examples:
+  $ loopwind preview banner-hero
+  $ loopwind preview banner-hero '{"title":"Hello World"}'
+  $ loopwind preview banner-hero props.json
+  $ loopwind preview banner-hero '{"title":"Test"}' --format svg
+  $ loopwind preview banner-hero --port 8080 --no-open
+`)
+    .action(async (templateName, propsArg, options) => {
+    try {
+        console.log(chalk.blue('\n🎨 Starting preview server...\n'));
+        // Get template path
+        const templatePath = await getTemplatePathAsync(templateName);
+        // Validate template exists
+        try {
+            await fs.access(path.join(path.dirname(templatePath), 'template.tsx'));
+        }
+        catch {
+            console.error(chalk.red(`✖ Template "${templateName}" not found`));
+            console.log(chalk.dim(`  Run ${chalk.cyan('loopwind list')} to see available templates`));
+            process.exit(1);
+        }
+        // Parse props
+        let props = {};
+        if (propsArg) {
+            if (propsArg.startsWith('{')) {
+                try {
+                    props = JSON.parse(propsArg);
+                }
+                catch (error) {
+                    console.error(chalk.red('✖ Invalid JSON props'));
+                    process.exit(1);
+                }
+            }
+            else {
+                try {
+                    const propsContent = await fs.readFile(propsArg, 'utf-8');
+                    props = JSON.parse(propsContent);
+                }
+                catch (error) {
+                    console.error(chalk.red(`✖ Could not read props file: ${propsArg}`));
+                    process.exit(1);
+                }
+            }
+        }
+        // Create Express app
+        const app = express();
+        const port = typeof options.port === 'string' ? parseInt(options.port) : (options.port || 3000);
+        const format = options.format || 'png';
+        // Store the latest render
+        let latestRender = '';
+        let lastError = null;
+        let clients = new Set();
+        // Function to render template
+        const renderTemplate = async () => {
+            try {
+                lastError = null;
+                // Load and validate metadata
+                const { loadTemplateMeta } = await import('../lib/utils.js');
+                const meta = await loadTemplateMeta(templateName);
+                // Validate dimensions
+                if (!meta.size || !meta.size.width || !meta.size.height) {
+                    throw new Error('Template metadata is missing size.width or size.height');
+                }
+                if (meta.size.width <= 0 || meta.size.height <= 0) {
+                    throw new Error(`Invalid template dimensions: ${meta.size.width}x${meta.size.height}`);
+                }
+                if (format === 'svg') {
+                    latestRender = await renderToSVG(templateName, props);
+                }
+                else {
+                    // First render to SVG to validate it
+                    const svg = await renderToSVG(templateName, props);
+                    // Validate SVG contains valid dimensions
+                    if (!svg.includes('width=') || !svg.includes('height=')) {
+                        throw new Error('Generated SVG is missing width or height attributes');
+                    }
+                    // Convert to PNG (this is where resvg can crash)
+                    const { renderToPNG } = await import('../lib/renderer.js');
+                    latestRender = await renderToPNG(templateName, props);
+                }
+                console.log(chalk.green('✓ Template rendered'));
+                // Notify all connected clients to refresh
+                clients.forEach(res => {
+                    res.write('data: reload\n\n');
+                });
+            }
+            catch (error) {
+                lastError = error.message || String(error);
+                console.error(chalk.red('✖ Render error:'), lastError);
+                // Provide helpful suggestions
+                if (lastError && (lastError.includes('display: flex') || lastError.includes('Satori'))) {
+                    console.log(chalk.yellow('\n  💡 Common fixes:'));
+                    console.log(chalk.dim('     • Add tw("flex") to containers with multiple children'));
+                    console.log(chalk.dim('     • Ensure all props match the template requirements'));
+                    console.log(chalk.dim('     • Try --format svg to see the raw SVG output\n'));
+                }
+                else if (lastError && lastError.includes('dimensions')) {
+                    console.log(chalk.yellow('\n  💡 Check your template metadata for valid size.width and size.height\n'));
+                }
+            }
+        };
+        // Initial render
+        console.log(chalk.dim('Performing initial render...'));
+        await renderTemplate();
+        // Show helpful tip if using PNG format
+        if (format === 'png') {
+            console.log(chalk.dim('\n💡 Tip: If the preview crashes, try:'));
+            console.log(chalk.dim(`   ${chalk.cyan(`loopwind preview ${templateName} --format svg`)}`));
+            console.log(chalk.dim('   This helps identify template issues without PNG conversion.\n'));
+        }
+        // Serve the preview page
+        app.get('/', (req, res) => {
+            const html = `
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Preview: ${templateName}</title>
+  <style>
+    * {
+      margin: 0;
+      padding: 0;
+      box-sizing: border-box;
+    }
+    body {
+      background: #0a0a0a;
+      color: #ffffff;
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+      min-height: 100vh;
+      display: flex;
+      flex-direction: column;
+    }
+    .header {
+      background: #18181b;
+      border-bottom: 1px solid #27272a;
+      padding: 1rem 2rem;
+      display: flex;
+      justify-content: space-between;
+      align-items: center;
+    }
+    .header h1 {
+      font-size: 1.25rem;
+      font-weight: 600;
+    }
+    .badge {
+      background: #3b82f6;
+      color: white;
+      padding: 0.25rem 0.75rem;
+      border-radius: 0.375rem;
+      font-size: 0.875rem;
+      font-weight: 500;
+    }
+    .container {
+      flex: 1;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      padding: 2rem;
+      overflow: auto;
+    }
+    .image-wrapper {
+      max-width: 100%;
+      max-height: 100%;
+      box-shadow: 0 20px 25px -5px rgba(0, 0, 0, 0.5);
+      border-radius: 0.5rem;
+      overflow: hidden;
+    }
+    img {
+      display: block;
+      max-width: 100%;
+      height: auto;
+    }
+    .error {
+      background: #7f1d1d;
+      border: 1px solid #991b1b;
+      color: #fecaca;
+      padding: 1rem 1.5rem;
+      border-radius: 0.5rem;
+      font-family: 'Courier New', monospace;
+      white-space: pre-wrap;
+      max-width: 800px;
+    }
+  </style>
+</head>
+<body>
+  <div class="header">
+    <h1>loopwind preview: ${templateName}</h1>
+    <span class="badge">${format.toUpperCase()}</span>
+  </div>
+  <div class="container" id="container">
+    ${lastError ? `<div class="error">${lastError}</div>` : `
+      <div class="image-wrapper">
+        <img src="/render.${format}?t=${Date.now()}" alt="Template preview" />
+      </div>
+    `}
+  </div>
+  <script>
+    const eventSource = new EventSource('/events');
+    eventSource.onmessage = (event) => {
+      if (event.data === 'reload') {
+        // Always reload the whole page to ensure metadata changes (like size) are reflected
+        window.location.reload();
+      }
+    };
+  </script>
+</body>
+</html>
+        `;
+            res.send(html);
+        });
+        // Serve the rendered image/svg
+        app.get(`/render.${format}`, (req, res) => {
+            if (lastError) {
+                res.status(500).send(lastError);
+                return;
+            }
+            if (format === 'svg') {
+                res.setHeader('Content-Type', 'image/svg+xml');
+                res.send(latestRender);
+            }
+            else {
+                res.setHeader('Content-Type', 'image/png');
+                res.send(latestRender);
+            }
+        });
+        // Server-sent events for HMR
+        app.get('/events', (req, res) => {
+            res.setHeader('Content-Type', 'text/event-stream');
+            res.setHeader('Cache-Control', 'no-cache');
+            res.setHeader('Connection', 'keep-alive');
+            res.flushHeaders();
+            clients.add(res);
+            req.on('close', () => {
+                clients.delete(res);
+            });
+        });
+        // Start server
+        const server = app.listen(port, () => {
+            console.log(chalk.green('✓ Preview server started\n'));
+            console.log(chalk.cyan('  Local: ') + chalk.underline(`http://localhost:${port}`));
+            console.log(chalk.dim('\n  Press Ctrl+C to stop\n'));
+            // Open browser if requested
+            if (options.open !== false) {
+                import('open').then(({ default: open }) => {
+                    open(`http://localhost:${port}`);
+                }).catch(() => {
+                    // Silently fail if open package is not available
+                });
+            }
+        });
+        // Watch for changes in the template directory
+        const templateDir = path.dirname(templatePath);
+        const watcher = watch(templateDir, {
+            persistent: true,
+            ignoreInitial: true,
+        });
+        watcher.on('change', async (filePath) => {
+            console.log(chalk.blue(`\n📝 ${path.basename(filePath)} changed`));
+            await renderTemplate();
+        });
+        // Handle cleanup
+        const cleanup = () => {
+            console.log(chalk.yellow('\n\n👋 Shutting down preview server...'));
+            watcher.close();
+            server.close();
+            process.exit(0);
+        };
+        process.on('SIGINT', cleanup);
+        process.on('SIGTERM', cleanup);
+    }
+    catch (error) {
+        console.error(chalk.red('✖ Error:'), error.message);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=preview.js.map

package/dist/commands/preview.js.map

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

package/dist/commands/render.d.ts

@@ -0,0 +1,10 @@
+interface RenderOptions {
+    props?: string;
+    out?: string;
+    format?: 'png' | 'svg' | 'webp' | 'jpg' | 'jpeg';
+    framesOnly?: boolean;
+    crf?: number;
+}
+export declare function renderCommand(templateName: string, propsArg: string | undefined, options: RenderOptions): Promise<void>;
+export {};
+//# sourceMappingURL=render.d.ts.map

package/dist/commands/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/commands/render.ts"],"names":[],"mappings":"AAYA,UAAU,aAAa;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;IACjD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CAgOf"}

package/dist/commands/render.js

@@ -0,0 +1,204 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import gradient from 'gradient-string';
+import path from 'path';
+import { isTemplateInstalled, parseProps, ensureOutputDir, loadTemplateMeta } from '../lib/utils.js';
+import { render } from '../lib/renderer.js';
+import { renderVideo, renderVideoFrames } from '../lib/video-renderer.js';
+import { validateTemplateForRendering, enhanceSatoriError } from '../lib/template-validator.js';
+import { getResolvedPaths } from '../lib/config.js';
+import { checkForUpdates } from '../lib/version-check.js';
+export async function renderCommand(templateName, propsArg, options) {
+    // Start version check early (non-blocking)
+    const updateCheck = checkForUpdates();
+    // Helper to show update notification at the end
+    const showUpdateNotification = async () => {
+        const result = await updateCheck;
+        if (result?.isOutdated) {
+            console.log(chalk.dim(`Update available: ${result.currentVersion} → ${chalk.green(result.latestVersion)}`));
+            console.log(chalk.dim(`Run: ${chalk.cyan('npm install -g loopwind@latest')}\n`));
+        }
+    };
+    const purpleIndigo = gradient(['#a855f7', '#6366f1', '#8b5cf6']);
+    console.log('\n' + purpleIndigo(`Rendering template: ${templateName}`) + '\n');
+    const spinner = ora({
+        text: 'Checking template...',
+        color: 'magenta'
+    }).start();
+    try {
+        // Check if template is installed
+        const installed = await isTemplateInstalled(templateName);
+        if (!installed) {
+            spinner.fail(chalk.red(`Template ${templateName} is not installed`));
+            console.log(chalk.dim(`\nInstall it with: ${chalk.cyan(`loopwind add ${templateName}`)}\n`));
+            process.exit(1);
+        }
+        // Ensure output directory exists
+        await ensureOutputDir();
+        // Load template metadata to check type
+        spinner.text = 'Loading template...';
+        const meta = await loadTemplateMeta(templateName);
+        const templateType = meta.type || 'image';
+        // Check for unsupported types
+        if (templateType === 'presentation') {
+            spinner.fail(chalk.yellow('Presentation rendering is not yet implemented'));
+            console.log(chalk.dim(`\nPresentation rendering will be available in a future release.`));
+            console.log(chalk.dim(`Presentations will export multi-page PDFs with React + Tailwind.\n`));
+            process.exit(1);
+        }
+        if (templateType === 'website') {
+            spinner.fail(chalk.yellow('Website rendering is not yet implemented'));
+            console.log(chalk.dim(`\nWebsite rendering will be available in a future release.`));
+            console.log(chalk.dim(`Websites will export static HTML/CSS from React + Tailwind.\n`));
+            process.exit(1);
+        }
+        // Parse props - prioritize positional argument over --props flag
+        spinner.text = 'Loading props...';
+        const propsInput = propsArg || options.props;
+        const props = await parseProps(propsInput);
+        // Validate template and props
+        spinner.text = 'Validating template...';
+        const validation = await validateTemplateForRendering(templateName, props);
+        if (!validation.valid) {
+            spinner.fail(chalk.red('Template validation failed'));
+            console.log();
+            for (const error of validation.errors) {
+                console.log(chalk.red(`  ✗ ${error.field}: ${error.message}`));
+                if (error.suggestion) {
+                    console.log(chalk.dim(`    → ${error.suggestion}`));
+                }
+                console.log();
+            }
+            console.log(chalk.yellow('Fix the errors above and try again.\n'));
+            process.exit(1);
+        }
+        // Determine output path (default to outputs folder)
+        const paths = await getResolvedPaths();
+        // Handle video templates
+        if (templateType === 'video') {
+            const defaultFileName = `${templateName}-${Date.now()}.mp4`;
+            let outputPath = options.out
+                ? options.out
+                : path.join(paths.outputs, defaultFileName);
+            // Auto-correct extension if user provided wrong format
+            if (options.out && !outputPath.endsWith('.mp4')) {
+                const wrongExt = path.extname(outputPath);
+                outputPath = outputPath.replace(/\.[^.]+$/, '.mp4');
+                spinner.warn(chalk.yellow(`Video templates must output to .mp4 (changed ${wrongExt} → .mp4)`));
+                spinner.start();
+            }
+            // Frames-only mode
+            if (options.framesOnly) {
+                const framesDir = options.out || path.join(paths.outputs, `${templateName}-frames-${Date.now()}`);
+                spinner.text = 'Rendering video frames...';
+                let lastUpdate = Date.now();
+                const { totalFrames, fps } = await renderVideoFrames(templateName, props, framesDir, {
+                    format: options.format === 'svg' ? 'svg' : 'png',
+                    onProgress: (frame, total, phase) => {
+                        // Update spinner every 100ms to avoid too many updates
+                        if (Date.now() - lastUpdate > 100) {
+                            if (phase === 'svg') {
+                                spinner.text = `Generating SVGs: ${frame}/${total} (${Math.round((frame / total) * 100)}%)`;
+                            }
+                            else if (phase === 'convert') {
+                                spinner.text = `Converting to PNG: ${frame}/${total} (${Math.round((frame / total) * 100)}%)`;
+                            }
+                            else {
+                                spinner.text = `Rendering frames: ${frame}/${total} (${Math.round((frame / total) * 100)}%)`;
+                            }
+                            lastUpdate = Date.now();
+                        }
+                    },
+                });
+                spinner.succeed(chalk.green(`Successfully rendered ${totalFrames} frames to ${chalk.bold(framesDir)}`));
+                console.log(chalk.dim(`\nTemplate: ${templateName}`));
+                console.log(chalk.dim(`Frames: ${totalFrames} at ${fps}fps`));
+                console.log(chalk.dim(`Format: ${options.format === 'svg' ? 'SVG' : 'PNG'}`));
+                console.log(chalk.dim(`Output: ${path.resolve(framesDir)}`));
+                console.log(chalk.dim(`\nTo encode to video with ffmpeg:`));
+                console.log(chalk.cyan(`  ffmpeg -framerate ${fps} -i ${framesDir}/frame-%04d.${options.format === 'svg' ? 'svg' : 'png'} -c:v libx264 -pix_fmt yuv420p output.mp4`));
+                console.log();
+                return;
+            }
+            // Render video (no ffmpeg required - uses WASM encoder!)
+            spinner.text = 'Rendering video...';
+            let lastUpdate = Date.now();
+            await renderVideo(templateName, props, outputPath, {
+                quality: options.crf ? parseInt(String(options.crf), 10) : undefined,
+                onFrameProgress: (frame, total, phase) => {
+                    if (Date.now() - lastUpdate > 100) {
+                        if (phase === 'svg') {
+                            spinner.text = `Generating SVGs: ${frame}/${total} (${Math.round((frame / total) * 100)}%)`;
+                        }
+                        else if (phase === 'encode') {
+                            spinner.text = `Encoding video: ${frame}/${total} (${Math.round((frame / total) * 100)}%)`;
+                        }
+                        lastUpdate = Date.now();
+                    }
+                },
+            });
+            spinner.succeed(chalk.green(`Successfully rendered video to ${chalk.bold(outputPath)}`));
+            console.log(chalk.dim(`\nTemplate: ${templateName}`));
+            console.log(chalk.dim(`Format: MP4`));
+            console.log(chalk.dim(`Output: ${path.resolve(outputPath)}\n`));
+            await showUpdateNotification();
+            return;
+        }
+        // Handle image templates
+        const format = options.format || 'png';
+        const defaultFileName = `${templateName}-${Date.now()}.${format}`;
+        const outputPath = options.out
+            ? options.out
+            : path.join(paths.outputs, defaultFileName);
+        // Render
+        spinner.text = `Rendering to ${format.toUpperCase()}...`;
+        await render({
+            templateName,
+            props,
+            outputPath,
+            format,
+        });
+        spinner.succeed(chalk.green(`Successfully rendered to ${chalk.bold(outputPath)}`));
+        console.log(chalk.dim(`\nTemplate: ${templateName}`));
+        console.log(chalk.dim(`Format: ${format.toUpperCase()}`));
+        console.log(chalk.dim(`Output: ${path.resolve(outputPath)}\n`));
+        await showUpdateNotification();
+    }
+    catch (error) {
+        spinner.fail(chalk.red('Failed to render template'));
+        const err = error;
+        // Check if it's a props parsing error (from parseProps function)
+        if (err.message.includes('Failed to parse props') ||
+            err.message.includes('Failed to parse JSON props') ||
+            err.message.includes('Props file not found')) {
+            // Props parsing errors already have helpful messages
+            console.log();
+            console.log(chalk.red(err.message));
+            console.log();
+            process.exit(1);
+        }
+        // Check if it's a Satori error and provide enhanced message
+        const enhanced = enhanceSatoriError(err);
+        console.log();
+        console.log(chalk.red(`Error: ${enhanced.message}`));
+        console.log();
+        if (enhanced.suggestions.length > 0) {
+            console.log(chalk.yellow('Suggestions:'));
+            for (const suggestion of enhanced.suggestions) {
+                console.log(chalk.dim(`  • ${suggestion}`));
+            }
+            console.log();
+        }
+        // Show original error for debugging
+        if (process.env.DEBUG) {
+            console.log(chalk.dim('Original error:'));
+            console.error(chalk.dim(err.stack));
+            console.log();
+        }
+        else {
+            console.log(chalk.dim('Run with DEBUG=1 for full error stack trace\n'));
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=render.js.map

package/dist/commands/render.js.map

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

package/dist/commands/validate.d.ts

@@ -0,0 +1,2 @@
+export declare function validateCommand(templateName?: string): Promise<void>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/commands/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AA0DA,wBAAsB,eAAe,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0D1E"}

package/dist/commands/validate.js

@@ -0,0 +1,107 @@
+import chalk from 'chalk';
+import { getInstalledTemplates, loadTemplateMeta, isTemplateInstalled } from '../lib/utils.js';
+/**
+ * Validate a single template's metadata
+ */
+function validateMeta(meta, templateName) {
+    const errors = [];
+    // Check required fields
+    if (!meta.name)
+        errors.push('Missing required field: name');
+    if (!meta.description)
+        errors.push('Missing required field: description');
+    // Check size
+    if (!meta.size) {
+        errors.push('Missing required field: size');
+    }
+    else {
+        if (typeof meta.size.width !== 'number')
+            errors.push('size.width must be a number');
+        if (typeof meta.size.height !== 'number')
+            errors.push('size.height must be a number');
+    }
+    // Check props
+    if (!meta.props || typeof meta.props !== 'object') {
+        errors.push('Missing or invalid field: props (must be an object)');
+    }
+    // Check type (optional, defaults to "image")
+    const validTypes = ['image', 'video', 'presentation', 'website'];
+    if (meta.type && !validTypes.includes(meta.type)) {
+        errors.push(`type must be one of: ${validTypes.join(', ')}`);
+    }
+    // Check type-specific settings
+    if (meta.type === 'video' && !meta.video) {
+        errors.push('video settings required when type is "video"');
+    }
+    if (meta.type === 'presentation' && !meta.presentation) {
+        errors.push('presentation settings required when type is "presentation"');
+    }
+    if (meta.type === 'website' && !meta.website) {
+        errors.push('website settings required when type is "website"');
+    }
+    if (meta.video) {
+        if (typeof meta.video.fps !== 'number') {
+            errors.push('video.fps must be a number');
+        }
+        if (typeof meta.video.duration !== 'number') {
+            errors.push('video.duration must be a number');
+        }
+    }
+    return errors;
+}
+export async function validateCommand(templateName) {
+    console.log(chalk.blue('\nValidating templates...\n'));
+    try {
+        const templatesToValidate = templateName
+            ? [templateName]
+            : await getInstalledTemplates();
+        if (templatesToValidate.length === 0) {
+            console.log(chalk.dim('No templates to validate.\n'));
+            return;
+        }
+        let totalErrors = 0;
+        let totalTemplates = 0;
+        for (const name of templatesToValidate) {
+            totalTemplates++;
+            // Check if installed
+            const installed = await isTemplateInstalled(name);
+            if (!installed) {
+                console.log(chalk.red(`✗ ${name}: Template not found`));
+                totalErrors++;
+                continue;
+            }
+            try {
+                const meta = await loadTemplateMeta(name);
+                const errors = validateMeta(meta, name);
+                if (errors.length === 0) {
+                    console.log(chalk.green(`✓ ${name}: Valid`));
+                }
+                else {
+                    console.log(chalk.red(`✗ ${name}: ${errors.length} error(s)`));
+                    errors.forEach(err => {
+                        console.log(chalk.dim(`  - ${err}`));
+                    });
+                    totalErrors += errors.length;
+                }
+            }
+            catch (error) {
+                console.log(chalk.red(`✗ ${name}: Failed to load metadata`));
+                console.log(chalk.dim(`  - ${error.message}`));
+                totalErrors++;
+            }
+        }
+        console.log();
+        if (totalErrors === 0) {
+            console.log(chalk.green(`All ${totalTemplates} template(s) are valid!\n`));
+        }
+        else {
+            console.log(chalk.yellow(`Found ${totalErrors} error(s) in ${totalTemplates} template(s)\n`));
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error(chalk.red(`\nError: ${error.message}\n`));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=validate.js.map