svger-cli 4.0.7 → 4.0.8

package/CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [4.0.8] - 2026-05-20
+
+### 🐛 Bug Fixes
+
+- **Fixed subcommand help handling**: `svger-cli build --help` and other subcommand help flags now display command-specific help text instead of failing with "Both <src> and <out> paths are required" error. The CLI parser now correctly intercepts `--help` and `-h` flags after subcommand resolution.
+- **Fixed false Vue/Svelte index generation warning**: Builds for Vue and Svelte frameworks no longer emit the misleading "No component files found in output directory for index generation" warning. Index generation is now framework-aware and silently skipped for frameworks that use non-standard extensions (`.vue`, `.svelte`).
+
+### 🔧 Improvements
+
+- **Enhanced CLI help system**: Added per-command help display showing command-specific options and global options separately.
+- **Framework-aware index generation**: Index file generation now intelligently detects framework type and skips for frameworks where barrel exports are not applicable.
+
+### 📝 Documentation
+
+- Bug fixes address issues reported in upstream issue report dated 2026-05-19 for version 4.0.7.
+
 ## [4.0.7] - 2026-05-07
 
 ### ✅ Release Readiness & Validation

package/dist/services/svg-service.js

@@ -320,6 +320,13 @@ export class SVGService {
      */
     async generateIndexFile(outDir, config) {
         try {
+            // Skip index generation for frameworks that use non-standard extensions
+            const framework = config?.framework;
+            const frameworksWithoutIndexSupport = new Set(['vue', 'svelte']);
+            if (framework && frameworksWithoutIndexSupport.has(framework)) {
+                logger.debug(`Skipping index generation for ${framework} framework (components use .${framework} extension)`);
+                return;
+            }
             // Scan output directory for all component files
             const files = await FileSystem.readDir(outDir);
             // Get the file extension based on typescript setting

package/dist/utils/native.d.ts

@@ -86,6 +86,7 @@ export declare class CLI {
     parse(): Promise<void>;
     private parseArgs;
     private showHelp;
+    private showCommandHelp;
 }
 declare class CommandBuilder {
     private signature;

package/dist/utils/native.js

@@ -219,6 +219,11 @@ export class CLI {
             this.showHelp();
             process.exit(1);
         }
+        // Check for subcommand help before parsing args
+        if (remainingArgs.includes('--help') || remainingArgs.includes('-h')) {
+            this.showCommandHelp(commandName, command);
+            return;
+        }
         const { parsedArgs, options } = this.parseArgs(remainingArgs, command.options);
         try {
             await command.action(parsedArgs, options);
@@ -277,6 +282,19 @@ export class CLI {
         writeStdout('  --help, -h      Show help');
         writeStdout('  --version, -v   Show version');
     }
+    showCommandHelp(commandName, command) {
+        writeStdout(`${this.programName} ${commandName}`);
+        writeStdout(`\n${command.description}\n`);
+        if (command.options.size > 0) {
+            writeStdout('Options:');
+            for (const [name, opt] of command.options) {
+                const flag = opt.hasValue ? `--${name} <value>` : `--${name}`;
+                writeStdout(`  ${flag.padEnd(25)} ${opt.description}`);
+            }
+        }
+        writeStdout('\nGlobal Options:');
+        writeStdout('  --help, -h                Show help');
+    }
 }
 class CommandBuilder {
     signature;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svger-cli",
-  "version": "4.0.7",
+  "version": "4.0.8",
   "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",