svger-cli 4.0.1 → 4.0.3

package/dist/utils/native.js

@@ -62,7 +62,6 @@ export class FileSystem {
     static _readdir = promisify(fs.readdir);
     static _stat = promisify(fs.stat);
     static _mkdir = promisify(fs.mkdir);
-    static _rmdir = promisify(fs.rmdir);
     static _unlink = promisify(fs.unlink);
     static async exists(path) {
         try {
@@ -94,18 +93,7 @@ export class FileSystem {
     }
     static async removeDir(dirPath) {
         try {
-            const files = await this._readdir(dirPath);
-            for (const file of files) {
-                const filePath = `${dirPath}/${file}`;
-                const stats = await this._stat(filePath);
-                if (stats.isDirectory()) {
-                    await this.removeDir(filePath);
-                }
-                else {
-                    await this._unlink(filePath);
-                }
-            }
-            await this._rmdir(dirPath);
+            await fs.promises.rm(dirPath, { recursive: true, force: true });
         }
         catch (error) {
             if (error.code !== 'ENOENT') {
@@ -311,10 +299,14 @@ export class FileWatcher {
                     this.emit(eventType, `${path}/${filename}`);
                 }
             });
+            watcher.on('error', error => {
+                this.emit('error', error);
+            });
             this.watchers.push(watcher);
         }
         catch (error) {
-            console.error(`Failed to watch ${path}:`, error);
+            // Emit error event so consumers can handle it
+            this.emit('error', error);
         }
         return this;
     }

package/dist/utils/visual-diff.js

@@ -81,17 +81,22 @@ export class VisualDiffError extends Error {
 export async function renderSVG(svgContent, config) {
     await loadVisualDiffDependencies();
     const renderConfig = { ...DEFAULT_RENDER_CONFIG, ...config };
+    const RENDER_TIMEOUT_MS = 30000; // 30 seconds
     try {
         // Create SVG buffer
         const svgBuffer = Buffer.from(svgContent, 'utf-8');
-        // Render to PNG using sharp
-        const pngBuffer = await sharp(svgBuffer, { density: renderConfig.density })
+        // Render to PNG using sharp with timeout protection
+        const renderPromise = sharp(svgBuffer, { density: renderConfig.density })
             .resize(renderConfig.width, renderConfig.height, {
             fit: 'contain',
             background: renderConfig.background,
         })
             .png()
             .toBuffer();
+        const timeoutPromise = new Promise((_resolve, reject) => {
+            setTimeout(() => reject(new Error(`Render timeout after ${RENDER_TIMEOUT_MS}ms`)), RENDER_TIMEOUT_MS);
+        });
+        const pngBuffer = await Promise.race([renderPromise, timeoutPromise]);
         return pngBuffer;
     }
     catch (error) {

package/dist/watch.js

@@ -1,7 +1,7 @@
 import path from 'path';
 import { generateSVG } from './builder.js';
 import { isLocked } from './lock.js';
-import { FileSystem, FileWatcher } from './utils/native.js';
+import { FileSystem, FileWatcher, toPascalCase } from './utils/native.js';
 /**
  * Watches a source folder for changes to SVG files and automatically
  * rebuilds React components when SVGs are added, modified, or deleted.
@@ -59,8 +59,9 @@ export async function watchSVGs(config) {
             await generateSVG({ svgFile: filePath, outDir });
         }
         else {
-            // File was deleted
-            const componentName = path.basename(filePath, '.svg');
+            // File was deleted — use PascalCase to match the generated component filename
+            const baseName = path.basename(filePath, '.svg');
+            const componentName = toPascalCase(baseName);
             const outFile = path.join(outDir, `${componentName}.tsx`);
             if (await FileSystem.exists(outFile)) {
                 await FileSystem.unlink(outFile);

package/docs/ERROR-HANDLING-STANDARD.md

@@ -0,0 +1,111 @@
+# Error Handling Standards
+
+## Purpose
+This document establishes standardized error handling patterns for SVGER-CLI v4.0.3+ to ensure consistency, proper error propagation, and appropriate user feedback.
+
+## Standard Patterns
+
+### 1. CLI Command Error Handling (Process Exit Required)
+**Pattern:** Log error + exit with code 1
+```typescript
+try {
+  await someOperation();
+} catch (error) {
+  logger.error('Operation failed:', error);
+  process.exit(1);
+}
+```
+
+### 2. Service Method Error Handling (Propagate to Caller)
+**Pattern:** Log error + throw
+```typescript
+try {
+  const result = await operation();
+  return result;
+} catch (error) {
+  logger.error('Failed to perform operation:', error);
+  throw error;
+}
+```
+
+### 3. Background/Async Error Handling (Non-blocking)
+**Pattern:** Log error + return error state
+```typescript
+try {
+  await backgroundTask();
+} catch (error) {
+  logger.error('Background task failed:', error);
+  return { success: false, error };
+}
+```
+
+### 4. Batch Processing Error Handling (Continue on Individual Failures)
+**Pattern:** Log individual errors + collect results
+```typescript
+const results = [];
+for (const item of items) {
+  try {
+    const result = await processItem(item);
+    results.push({ success: true, data: result });
+  } catch (error) {
+    logger.error(`Failed to process ${item}:`, error);
+    results.push({ success: false, error });
+  }
+}
+```
+
+### 5. Plugin Error Handling (Isolated Failure)
+**Pattern:** Log error + skip plugin + continue pipeline
+```typescript
+try {
+  await plugin.execute();
+} catch (error) {
+  logger.error(`Plugin "${plugin.name}" failed:`, (error as Error).message);
+  // Continue with next plugin
+}
+```
+
+## Error Types by Severity
+
+### Critical (Process Exit)
+- Configuration file corruption
+- Permission denied for required directories
+- Invalid CLI arguments
+
+### High (Throw Error)
+- File not found for specific operation
+- Invalid SVG syntax
+- Build failures
+
+### Medium (Log + Return Error State)
+- Individual file processing failures in batch
+- Plugin execution failures
+- Optional feature failures (visual validation)
+
+### Low (Log Warning + Continue)
+- Missing optional configuration
+- Deprecation warnings
+- Non-critical file operations
+
+## Implementation Status
+
+### ✅ Completed
+- CLI commands properly exit on error
+- Service methods properly propagate errors
+- Batch processing collects individual failures
+
+### 🔄 Needs Review
+- Ensure all catch blocks follow appropriate pattern for their context
+- Verify error messages are clear and actionable
+- Check that error context is preserved in stack traces
+
+## Related Fixes
+- Bug #2: Added process.exit(1) in config command
+- Bug #12: Plugin registration now throws on duplicate names
+- Bug #17: Added CLI argument validation with early exit
+
+## Next Steps
+1. Audit all catch blocks for consistency
+2. Ensure error messages are user-friendly
+3. Add error codes for common scenarios
+4. Consider using error-handler.ts more consistently

package/docs/OPTIONAL-DEPENDENCIES.md

@@ -158,4 +158,4 @@ If you encounter any issues with optional dependencies:
 
 ---
 
-**Last Updated**: January 28, 2026 (v4.0.1)
+**Last Updated**: January 28, 2026 (v4.0.3)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svger-cli",
-  "version": "4.0.1",
+  "version": "4.0.3",
   "description": "Enterprise-grade SVG to component converter with advanced plugin system, visual diff testing, and official framework integrations. Supporting React, React Native, Vue, Angular, Svelte, Solid, Lit, Preact & Vanilla. Features TypeScript, HMR, optimization pipeline, and extensible architecture.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",