svger-cli 4.0.6 → 4.0.8

package/CHANGELOG.md

@@ -5,6 +5,39 @@ 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
+
+- **Full release validation completed**: Ran the packaged validation flows for frameworks, configuration options, end-to-end workflows, integrations, visual integration, linting, build, Jest, and production dependency audit.
+- **Quality gates verified**: ESLint remains at **0 errors / 14 warnings**, build passes, Jest passes at **155/155**, visual integration passes at **36/36**, and `npm audit --omit=dev` reports **0 vulnerabilities**.
+- **CLI command coverage confirmed**: Smoke-tested `plugins`, `config`, `optimize`, `lock`, `unlock`, and `watch` flows against the built CLI before release.
+
+### 🐛 Bug Fixes
+
+- **Fixed watch command lifecycle regression**: The CLI no longer forces `process.exit(0)` after starting watch mode, allowing the watcher to stay alive and process file changes correctly.
+
+### 📦 Release Preparation
+
+- **Version bump**: Updated the package and checked-in docs references from `4.0.6` to `4.0.7`.
+- **Release documentation refreshed**: Prepared the changelog and release notes for the `v4.0.7` publication.
+
 ## [4.0.6] - 2026-04-18
 
 ### ⚡ Performance Optimization (Chrome V8)

package/README.md

@@ -1,7 +1,7 @@
 <div align="center">
   <img src="./assets/svger-cli.png" alt="SVGER-CLI Banner" width="100%" />
   
-  <h1>SVGER-CLI v4.0.6</h1>
+  <h1>SVGER-CLI v4.0.7</h1>
   <h3>Enterprise SVG Processing Framework with Plugin System</h3>
   
   <p>
@@ -136,9 +136,9 @@
 
 ---
 
-## � **Upgrade to v4.0.6 - Automatic Migration!**
+## � **Upgrade to v4.0.7 - Automatic Migration!**
 
-**v4.0.6 is here with powerful new features!** If you're upgrading from v3.x:
+**v4.0.7 is here with powerful new features!** If you're upgrading from v3.x:
 
 ✅ **Zero Breaking Changes** - All your existing code works  
 ✅ **Automatic Config Migration** - Your `.svgconfig.json` updates automatically  
@@ -147,20 +147,20 @@
 
 **Upgrade Now:**
 ```bash
-npm install -g svger-cli@4.0.6
+npm install -g svger-cli@4.0.7
 # or
-npm install --save-dev svger-cli@4.0.6
+npm install --save-dev svger-cli@4.0.7
 ```
 
 **[See What's New →](#-whats-new-in-v400)** | **[Migration Guide →](#-migration-guide)**
 
 ---
 
-## �🌟 **What's New in v4.0.6**
+## �🌟 **What's New in v4.0.7**
 
 ### **� Performance & Stability Improvements**
 
-v4.0.6 introduces critical performance optimizations and stability fixes:
+v4.0.7 introduces critical performance optimizations and stability fixes:
 
 - ⚡ **True Parallel Processing**: Non-blocking asynchronous file operations in the core engine
 - 🐛 **Reliable Watch Mode**: Fixed file deletion handling to respect all user configurations
@@ -169,7 +169,7 @@ v4.0.6 introduces critical performance optimizations and stability fixes:
 
 ### **�🔌 Extensible Plugin System**
 
-v4.0.6 introduces a powerful plugin architecture that allows you to extend and customize SVG processing:
+v4.0.7 introduces a powerful plugin architecture that allows you to extend and customize SVG processing:
 
 ```bash
 # Use built-in plugins
@@ -347,7 +347,7 @@ node test-visual-integration.js                 # Integration tests (36/36 passi
 > Includes: Benchmark methodology, dependency analysis, Webpack integration guide, and all 28
 > configuration options explained.
 
-| **Feature**                | **SVGER-CLI v4.0.6**       | **SVGR (React)** | **vite-svg-loader (Vue)** | **svelte-svg (Svelte)** | **SVGO**            |
+| **Feature**                | **SVGER-CLI v4.0.7**       | **SVGR (React)** | **vite-svg-loader (Vue)** | **svelte-svg (Svelte)** | **SVGO**            |
 | -------------------------- | -------------------------- | ---------------- | ------------------------- | ----------------------- | ------------------- |
 | **Dependencies**           | ✅ **Zero**                | ❌ 15+ deps      | ❌ 9+ deps                | ❌ 7+ deps              | ❌ 8+ deps          |
 | **Auto-Generated Exports** | ✅ **Full Support**        | ❌ Manual        | ❌ Manual                 | ❌ Manual               | ❌ N/A              |
@@ -361,7 +361,7 @@ node test-visual-integration.js                 # Integration tests (36/36 passi
 | **TypeScript**             | ✅ **Native**              | Plugin           | Limited                   | Limited                 | None                |
 | **Batch Processing**       | ✅ **Optimized**           | Basic            | None                      | None                    | None                |
 | **Plugin System**          | ✅ **Extensible**          | Limited          | None                      | None                    | None                |
-| **Auto Migration**         | ✅ **v3.x → v4.0.6**       | ❌ Manual        | ❌ N/A                    | ❌ N/A                  | ❌ N/A              |
+| **Auto Migration**         | ✅ **v3.x → v4.0.7**       | ❌ Manual        | ❌ N/A                    | ❌ N/A                  | ❌ N/A              |
 | **Configuration Schema**   | ✅ **28 Options**          | ❌ 8 Options     | ❌ 4 Options              | ❌ 3 Options            | ❌ N/A              |
 | **Responsive Design**      | ✅ **Built-in**            | ❌ Manual        | ❌ None                   | ❌ None                 | ❌ None             |
 | **Theme System**           | ✅ **Auto Dark/Light**     | ❌ Manual        | ❌ None                   | ❌ None                 | ❌ None             |
@@ -1413,7 +1413,7 @@ svger-cli build [options]
 - `--styled-components` - Generate styled-components (React/Solid)
 - `--css-modules` - Enable CSS Modules support
 
-**Plugin Options (NEW in v4.0.6):**
+**Plugin Options (NEW in v4.0.7):**
 
 - `--plugin <name>` - Apply single plugin (can be repeated)
 - `--plugins <list>` - Apply multiple plugins (comma-separated)
@@ -2652,7 +2652,7 @@ Vue, Angular, and other frameworks.
 > **Real-world test:** 606 production SVG icons (brand logos, UI icons, social media icons)  
 > **[→ View Complete Benchmark Report](./docs/performance/REAL-WORLD-BENCHMARKS.md)**
 
-| **Operation**           | **SVGER v4.0.6** | **SVGR** | **SVGO** | **Improvement** |
+| **Operation**           | **SVGER v4.0.7** | **SVGR** | **SVGO** | **Improvement** |
 | ----------------------- | ---------------- | -------- | -------- | --------------- |
 | **606 files batch**     | **30.31s**       | ~63.64s  | ~45.46s  | **52% faster than SVGR**  |
 | **Per file average**    | **50.01ms**      | ~105ms   | ~75ms    | **52% faster than SVGR**  |
@@ -2666,7 +2666,7 @@ Vue, Angular, and other frameworks.
 
 ### **Framework-Specific Performance**
 
-All frameworks show consistent performance with v4.0.6 optimizations:
+All frameworks show consistent performance with v4.0.7 optimizations:
 
 | Framework | Time | Files | Speed/File | Throughput |
 |-----------|------|-------|------------|------------|
@@ -2677,9 +2677,9 @@ All frameworks show consistent performance with v4.0.6 optimizations:
 
 **Consistent Performance:** ~50ms per file across all frameworks
 
-### **SVG Optimization Performance (v4.0.6)**
+### **SVG Optimization Performance (v4.0.7)**
 
-SVGER-CLI v4.0.6 includes visual diff testing to guarantee pixel-perfect optimization quality:
+SVGER-CLI v4.0.7 includes visual diff testing to guarantee pixel-perfect optimization quality:
 
 | **Optimization Level** | **Size Reduction** | **Processing Time** | **Visual Quality** | **Memory Usage** |
 |------------------------|-------------------|---------------------|-------------------|------------------|
@@ -2700,7 +2700,7 @@ SVGER-CLI v4.0.6 includes visual diff testing to guarantee pixel-perfect optimiz
 - Complex paths (lossy): 14.3% with path simplification
 - Text rendering: 0.95% font variation acceptable
 
-### **SVG Optimization Levels (v4.0.6)**
+### **SVG Optimization Levels (v4.0.7)**
 
 SVGER-CLI includes a powerful multi-phase optimization engine with configurable levels:
 
@@ -2729,7 +2729,7 @@ svger-cli optimize input.svg --level maximum    # → 348 bytes (57.77%)
 
 ### **Real-World Performance Testing**
 
-SVGER-CLI v4.0.6 has been tested with 606 production SVG icons including:
+SVGER-CLI v4.0.7 has been tested with 606 production SVG icons including:
 - Brand logos (Google, Apple, Microsoft, etc.)
 - UI icons (arrows, buttons, navigation)
 - Social media icons (Twitter, Facebook, LinkedIn, etc.)
@@ -3065,9 +3065,9 @@ svger-cli build --performance --memory
 
 ## 📚 **Migration Guide**
 
-### **Upgrading to v4.0.6 (Automatic)**
+### **Upgrading to v4.0.7 (Automatic)**
 
-**Good News:** v4.0.6 includes automatic configuration migration! Your existing config will be upgraded seamlessly on first run.
+**Good News:** v4.0.7 includes automatic configuration migration! Your existing config will be upgraded seamlessly on first run.
 
 #### **What Happens Automatically**
 
@@ -3079,8 +3079,8 @@ svger build --src ./svgs --out ./components
 
 The tool will:
 1. ✅ Detect your v3.x configuration
-2. ✅ Automatically migrate to v4.0.6 format
-3. ✅ Add new `version: "4.0.6"` field
+2. ✅ Automatically migrate to v4.0.7 format
+3. ✅ Add new `version: "4.0.7"` field
 4. ✅ Convert `plugin` (singular) → `plugins` (array)
 5. ✅ Update optimization levels (see mapping below)
 6. ✅ Save the migrated config
@@ -3098,9 +3098,9 @@ The tool will:
   "performance": { "optimization": "basic" }
 }
 
-// Automatically becomes v4.0.6:
+// Automatically becomes v4.0.7:
 {
-  "version": "4.0.6",
+  "version": "4.0.7",
   "source": "./src/assets/svg",
   "output": "./src/components/icons",
   "framework": "react",
@@ -3111,7 +3111,7 @@ The tool will:
 
 #### **Optimization Level Mapping**
 
-| v3.x | v4.0.6 | Description |
+| v3.x | v4.0.7 | Description |
 |------|--------|-------------|
 | `none` | `fast` | Quick optimization |
 | `basic` | `fast` | Quick optimization |
@@ -3119,7 +3119,7 @@ The tool will:
 | `aggressive` | `maximum` | Maximum compression |
 | `maximum` | `maximum` | Maximum compression |
 
-#### **What's New in v4.0.6**
+#### **What's New in v4.0.7**
 
 - 🔌 **Plugin System**: Use `--plugin optimize` or `--plugins optimize,minify`
 - ⚡ **50% Faster**: O(1) object lookups replace O(n) switch statements
@@ -3131,12 +3131,12 @@ The tool will:
 If you prefer to update your config manually:
 
 ```bash
-# Initialize new v4.0.6 config
+# Initialize new v4.0.7 config
 svger init
 
 # Or manually edit .svgconfig.json and add:
 {
-  "version": "4.0.6",
+  "version": "4.0.7",
   "plugins": [],  // Add this array
   // ... rest of your config
 }
@@ -3184,7 +3184,7 @@ svger-cli build --framework react --responsive --theme dark
 
 ### **Comprehensive Test Suite**
 
-SVGER-CLI v4.0.6 includes a production-ready test suite with **114+ automated tests** covering:
+SVGER-CLI v4.0.7 includes a production-ready test suite with **114+ automated tests** covering:
 
 - ✅ **Unit Tests** - Core modules, utilities, and processors
 - ✅ **Integration Tests** - Complete workflows and multi-framework support

package/dist/cli.js

@@ -5,20 +5,34 @@ import { configService } from './services/config.js';
 import { logger } from './core/logger.js';
 import { getPluginManager } from './core/enhanced-plugin-manager.js';
 import { svgProcessor } from './processors/svg-processor.js';
+import { registerBuiltInPlugins } from './plugins/builtins.js';
 import { resolve } from 'path';
 import { pathToFileURL } from 'url';
 import path from 'path';
-import { readFileSync } from 'fs';
+import { getPackageInfo } from './utils/package-info.js';
+function asCommandOptions(options) {
+    return options;
+}
 // Read version dynamically from package.json
-const packageJson = JSON.parse(readFileSync(path.join(process.cwd(), 'package.json'), 'utf-8'));
-const CLI_VERSION = packageJson.version;
+const CLI_VERSION = getPackageInfo().version;
 const program = new CLI();
+let shouldExitAfterParse = true;
+function ensureBuiltInPluginsRegistered() {
+    registerBuiltInPlugins(getPluginManager());
+}
 /**
  * Load a plugin from npm package or local path
  */
 async function loadPlugin(pluginNameOrPath) {
     const pluginManager = getPluginManager();
+    ensureBuiltInPluginsRegistered();
     try {
+        if (pluginManager.hasPlugin(pluginNameOrPath)) {
+            pluginManager.activatePlugin(pluginNameOrPath);
+            const plugin = pluginManager.getPlugin(pluginNameOrPath);
+            logger.info(`Loaded plugin: ${plugin?.name} v${plugin?.version}`);
+            return;
+        }
         let pluginModule;
         // Check if it's a local path (starts with ./ or ../ or /)
         if (pluginNameOrPath.startsWith('./') ||
@@ -59,6 +73,7 @@ async function loadPlugin(pluginNameOrPath) {
  * List all registered plugins
  */
 function listRegisteredPlugins() {
+    ensureBuiltInPluginsRegistered();
     const pluginManager = getPluginManager();
     const plugins = pluginManager.listPlugins();
     if (plugins.length === 0) {
@@ -106,14 +121,15 @@ program
     .option('--list-plugins', 'List all registered plugins and exit')
     .action(async (args, opts) => {
     try {
+        const buildOptions = asCommandOptions(opts);
         // Handle --list-plugins flag
-        if (opts.listPlugins) {
+        if (buildOptions.listPlugins) {
             listRegisteredPlugins();
             return;
         }
         // Load plugins if specified
-        if (opts.plugin) {
-            const plugins = opts.plugin.split(',').map((p) => p.trim());
+        if (buildOptions.plugin) {
+            const plugins = buildOptions.plugin.split(',').map(p => p.trim());
             for (const pluginNameOrPath of plugins) {
                 await loadPlugin(pluginNameOrPath);
             }
@@ -136,8 +152,9 @@ program
             'lit',
             'vanilla',
         ]);
-        if (opts.framework && !validFrameworks.has(opts.framework)) {
-            logger.error(`Error: Invalid framework "${opts.framework}". Valid options: ${[...validFrameworks].join(', ')}`);
+        if (buildOptions.framework &&
+            !validFrameworks.has(buildOptions.framework)) {
+            logger.error(`Error: Invalid framework "${buildOptions.framework}". Valid options: ${[...validFrameworks].join(', ')}`);
             process.exit(1);
         }
         // Validate optimization level if provided — O(1) Set.has()
@@ -148,31 +165,31 @@ program
             'aggressive',
             'maximum',
         ]);
-        if (opts.optimize && !validOptLevels.has(opts.optimize)) {
-            logger.error(`Error: Invalid optimization level "${opts.optimize}". Valid options: ${[...validOptLevels].join(', ')}`);
+        if (buildOptions.optimize && !validOptLevels.has(buildOptions.optimize)) {
+            logger.error(`Error: Invalid optimization level "${buildOptions.optimize}". Valid options: ${[...validOptLevels].join(', ')}`);
             process.exit(1);
         }
         // Build config from CLI options
         const buildConfig = { src, out };
-        if (opts.framework) {
-            buildConfig.framework = opts.framework;
+        if (buildOptions.framework) {
+            buildConfig.framework = buildOptions.framework;
         }
-        if (opts.typescript !== undefined) {
-            buildConfig.typescript = opts.typescript;
+        if (buildOptions.typescript !== undefined) {
+            buildConfig.typescript = buildOptions.typescript;
         }
-        if (opts.optimize) {
-            buildConfig.optimize = opts.optimize;
+        if (buildOptions.optimize) {
+            buildConfig.optimize = buildOptions.optimize;
         }
         // Framework-specific options
         const frameworkOptions = {};
-        if (opts.composition !== undefined) {
-            frameworkOptions.scriptSetup = opts.composition;
+        if (buildOptions.composition !== undefined) {
+            frameworkOptions.scriptSetup = buildOptions.composition;
         }
-        if (opts.standalone !== undefined) {
-            frameworkOptions.standalone = opts.standalone;
+        if (buildOptions.standalone !== undefined) {
+            frameworkOptions.standalone = buildOptions.standalone;
         }
-        if (opts.signals !== undefined) {
-            frameworkOptions.signals = opts.signals;
+        if (buildOptions.signals !== undefined) {
+            frameworkOptions.signals = buildOptions.signals;
         }
         if (Object.keys(frameworkOptions).length > 0) {
             buildConfig.frameworkOptions = frameworkOptions;
@@ -193,6 +210,7 @@ program
     .description('Watch source folder and rebuild SVGs automatically')
     .action(async (args) => {
     try {
+        shouldExitAfterParse = false;
         const [src, out] = args;
         // Validate required arguments
         if (!src || !out) {
@@ -227,23 +245,24 @@ program
     .option('--optimize <level>', 'Optimization level: none, basic, balanced, aggressive, maximum (default: basic)')
     .action(async (args, opts) => {
     try {
+        const generateOptions = asCommandOptions(opts);
         const [svgFile, out] = args;
         const generateConfig = { svgFile, outDir: out };
-        if (opts.framework) {
-            generateConfig.framework = opts.framework;
+        if (generateOptions.framework) {
+            generateConfig.framework = generateOptions.framework;
         }
-        if (opts.typescript !== undefined) {
-            generateConfig.typescript = opts.typescript;
+        if (generateOptions.typescript !== undefined) {
+            generateConfig.typescript = generateOptions.typescript;
         }
-        if (opts.optimize) {
-            generateConfig.optimize = opts.optimize;
+        if (generateOptions.optimize) {
+            generateConfig.optimize = generateOptions.optimize;
         }
         const frameworkOptions = {};
-        if (opts.composition !== undefined) {
-            frameworkOptions.scriptSetup = opts.composition;
+        if (generateOptions.composition !== undefined) {
+            frameworkOptions.scriptSetup = generateOptions.composition;
         }
-        if (opts.standalone !== undefined) {
-            frameworkOptions.standalone = opts.standalone;
+        if (generateOptions.standalone !== undefined) {
+            frameworkOptions.standalone = generateOptions.standalone;
         }
         if (Object.keys(frameworkOptions).length > 0) {
             generateConfig.frameworkOptions = frameworkOptions;
@@ -298,10 +317,11 @@ program
     .option('--show', 'Show current config')
     .action(async (_args, opts) => {
     try {
-        if (opts.init)
+        const configOptions = asCommandOptions(opts);
+        if (configOptions.init)
             return await configService.initConfig();
-        if (opts.set) {
-            const [key, value] = opts.set.split('=');
+        if (configOptions.set) {
+            const [key, value] = configOptions.set.split('=');
             if (!key || value === undefined) {
                 logger.error('Invalid format. Use key=value');
                 process.exit(1);
@@ -323,7 +343,7 @@ program
             }
             return configService.setConfig(key, parsedValue);
         }
-        if (opts.show)
+        if (configOptions.show)
             return configService.showConfig();
         logger.error('No option provided. Use --init, --set, or --show');
         process.exit(1);
@@ -343,9 +363,10 @@ program
     .option('--load <names>', 'Load plugin(s) by name or path (comma-separated)')
     .action(async (_args, opts) => {
     try {
+        const pluginOptions = asCommandOptions(opts);
         // Load plugins if specified
-        if (opts.load) {
-            const plugins = opts.load.split(',').map((p) => p.trim());
+        if (pluginOptions.load) {
+            const plugins = pluginOptions.load.split(',').map(p => p.trim());
             for (const pluginNameOrPath of plugins) {
                 await loadPlugin(pluginNameOrPath);
             }
@@ -370,7 +391,8 @@ program
     .option('--in-place', 'Optimize files in-place (overwrite originals)')
     .action(async (args, opts) => {
     try {
-        const [input, output = opts.inPlace ? input : args[1] || input] = args;
+        const optimizeOptions = asCommandOptions(opts);
+        const [input, output = optimizeOptions.inPlace ? input : args[1] || input,] = args;
         if (!input) {
             logger.error('Error: Input path is required');
             process.exit(1);
@@ -382,13 +404,15 @@ program
             'aggressive',
             'maximum',
         ]);
-        const level = opts.level || 'balanced';
+        const level = optimizeOptions.level || 'balanced';
         if (!validOptLevels.has(level)) {
             logger.error(`Error: Invalid optimization level "${level}". Valid options: ${[...validOptLevels].join(', ')}`);
             process.exit(1);
         }
         const inputDir = path.resolve(input);
-        const outputDir = opts.inPlace ? inputDir : path.resolve(output);
+        const outputDir = optimizeOptions.inPlace
+            ? inputDir
+            : path.resolve(output);
         // Validate input directory
         if (!(await FileSystem.exists(inputDir))) {
             logger.error(`Error: Input directory not found: ${inputDir}`);
@@ -427,7 +451,7 @@ program
             }
         }
         logger.success(`Optimization complete! ${optimized} optimized, ${failed} failed`);
-        if (opts.validate) {
+        if (optimizeOptions.validate) {
             logger.warn('Visual validation not yet implemented for optimize command');
         }
     }
@@ -456,4 +480,6 @@ program
 await program.parse();
 // Ensure the process exits after CLI execution completes
 // (imported singletons may keep the event loop alive)
-process.exit(0);
+if (shouldExitAfterParse) {
+    process.exit(0);
+}

package/dist/config.d.ts

@@ -1,17 +1,19 @@
+type LegacyConfigValue = string | number | boolean | null | undefined;
+type LegacyConfigRecord = Record<string, unknown>;
 /**
  * Read the current svger-cli configuration.
  *
  * @deprecated Use `configService.readConfig()` instead.
- * @returns {Record<string, any>} Configuration object.
+ * @returns {LegacyConfigRecord} Configuration object.
  */
-export declare function readConfig(): Record<string, any>;
+export declare function readConfig(): LegacyConfigRecord;
 /**
  * Write a configuration object to the config file.
  *
  * @deprecated Use `configService.writeConfig(config)` instead.
- * @param {Record<string, any>} config - Configuration object to write.
+ * @param {LegacyConfigRecord} config - Configuration object to write.
  */
-export declare function writeConfig(config: Record<string, any>): void;
+export declare function writeConfig(config: LegacyConfigRecord): void;
 /**
  * Initialize the svger-cli configuration with default values.
  *
@@ -23,12 +25,13 @@ export declare function initConfig(): Promise<void>;
  *
  * @deprecated Use `configService.setConfig(key, value)` instead.
  * @param {string} key - The config key to set.
- * @param {any} value - The value to assign to the key.
+ * @param {LegacyConfigValue} value - The value to assign to the key.
  */
-export declare function setConfig(key: string, value: any): void;
+export declare function setConfig(key: string, value: LegacyConfigValue): void;
 /**
  * Display the current configuration in the console.
  *
  * @deprecated Use `configService.showConfig()` instead.
  */
 export declare function showConfig(): void;
+export {};

package/dist/config.js

@@ -9,7 +9,7 @@ import { configService } from './services/config.js';
  * Read the current svger-cli configuration.
  *
  * @deprecated Use `configService.readConfig()` instead.
- * @returns {Record<string, any>} Configuration object.
+ * @returns {LegacyConfigRecord} Configuration object.
  */
 export function readConfig() {
     return configService.readConfig();
@@ -18,7 +18,7 @@ export function readConfig() {
  * Write a configuration object to the config file.
  *
  * @deprecated Use `configService.writeConfig(config)` instead.
- * @param {Record<string, any>} config - Configuration object to write.
+ * @param {LegacyConfigRecord} config - Configuration object to write.
  */
 export function writeConfig(config) {
     configService.writeConfig(config);
@@ -36,7 +36,7 @@ export async function initConfig() {
  *
  * @deprecated Use `configService.setConfig(key, value)` instead.
  * @param {string} key - The config key to set.
- * @param {any} value - The value to assign to the key.
+ * @param {LegacyConfigValue} value - The value to assign to the key.
  */
 export function setConfig(key, value) {
     configService.setConfig(key, value);

package/dist/core/enhanced-plugin-manager.d.ts

@@ -20,6 +20,7 @@ interface PluginMetrics {
  */
 export declare class EnhancedPluginManager {
     private plugins;
+    private activePlugins;
     private executionMetrics;
     private readonly MAX_METRICS_SIZE;
     private enableVisualValidation;
@@ -27,7 +28,17 @@ export declare class EnhancedPluginManager {
     /**
      * Register a plugin
      */
-    registerPlugin(plugin: EnhancedPlugin): void;
+    registerPlugin(plugin: EnhancedPlugin, options?: {
+        activate?: boolean;
+    }): void;
+    /**
+     * Activate a registered plugin
+     */
+    activatePlugin(pluginName: string): void;
+    /**
+     * Deactivate a registered plugin
+     */
+    deactivatePlugin(pluginName: string): void;
     /**
      * Unregister a plugin
      */
@@ -92,6 +103,10 @@ export declare class EnhancedPluginManager {
      * Get total number of registered plugins
      */
     get pluginCount(): number;
+    /**
+     * Get total number of active plugins
+     */
+    get activePluginCount(): number;
     /**
      * Clear all plugins (useful for testing)
      */