@alcyone-labs/arg-parser 2.1.0 → 2.2.0

package/README.md

@@ -257,6 +257,44 @@ yarn unlink
 
 ArgParser's `parse()` method is async and automatically handles both synchronous and asynchronous handlers:
 
+### Automatic Argument Detection
+
+`parse()` can now be called without arguments for improved developer experience:
+
+```typescript
+const cli = ArgParser.withMcp({
+  appName: "My CLI",
+  appCommandName: "my-cli",
+  handler: async (ctx) => ({ success: true, data: ctx.args }),
+});
+
+// NEW: Call parse() without arguments
+// Automatically detects Node.js environment and uses process.argv.slice(2)
+async function main() {
+  try {
+    const result = await cli.parse(); // No arguments needed!
+    console.log("Success:", result);
+  } catch (error) {
+    console.error("Error:", error.message);
+    process.exit(1);
+  }
+}
+```
+
+**How it works:**
+
+- ✅ **Auto-detection**: When `parse()` is called without arguments, ArgParser automatically detects if it's running in Node.js
+- ✅ **Smart fallback**: Uses `process.argv.slice(2)` automatically in Node.js environments
+- ✅ **User-friendly warning**: Shows a helpful warning in CLI mode to inform users about the behavior
+- ✅ **Error handling**: Throws a clear error in non-Node.js environments when arguments are required
+- ✅ **Backward compatible**: Explicit arguments still work exactly as before
+
+**When warnings are shown:**
+
+- ✅ CLI mode (when `appCommandName` is set)
+- ❌ Library/programmatic usage (no `appCommandName`)
+- ❌ MCP mode (warnings suppressed for clean MCP output)
+
 ### Cannonical Usage Pattern
 
 ```typescript
@@ -272,7 +310,12 @@ const cli = ArgParser.withMcp({
 // parse() is async and works with both sync and async handlers
 async function main() {
   try {
-    const result = await cli.parse(process.argv.slice(2));
+    // Option 1: Auto-detection (NEW) - convenient for simple scripts
+    const result = await cli.parse();
+
+    // Option 2: Explicit arguments - full control
+    // const result = await cli.parse(process.argv.slice(2));
+
     // Handler results are automatically awaited and merged
     console.log(result.success); // true
   } catch (error) {
@@ -288,7 +331,12 @@ Works in ES modules or Node.js >=18 with top-level await
 
 ```javascript
 try {
-  const result = await cli.parse(process.argv.slice(2));
+  // Auto-detection approach (recommended for simple scripts)
+  const result = await cli.parse();
+
+  // Or explicit approach for full control
+  // const result = await cli.parse(process.argv.slice(2));
+
   console.log("Success:", result);
 } catch (error) {
   console.error("Error:", error.message);
@@ -301,8 +349,9 @@ try {
 If you need synchronous contexts, you can simply rely on promise-based APIs
 
 ```javascript
+// Auto-detection approach
 cli
-  .parse(process.argv.slice(2))
+  .parse()
   .then((result) => {
     console.log("Success:", result);
   })
@@ -310,6 +359,17 @@ cli
     console.error("Error:", error.message);
     process.exit(1);
   });
+
+// Or explicit approach
+// cli
+//   .parse(process.argv.slice(2))
+//   .then((result) => {
+//     console.log("Success:", result);
+//   })
+//   .catch((error) => {
+//     console.error("Error:", error.message);
+//     process.exit(1);
+//   });
 ```
 
 ---
@@ -428,7 +488,9 @@ ArgParser provides **strong typing** for flag definitions with comprehensive val
 You can define flag types using either **constructor functions** or **string literals**:
 
 ```typescript
-const parser = new ArgParser({ /* ... */ }).addFlags([
+const parser = new ArgParser({
+  /* ... */
+}).addFlags([
   // Constructor functions (recommended for TypeScript)
   { name: "count", options: ["--count"], type: Number },
   { name: "enabled", options: ["--enabled"], type: Boolean, flagOnly: true },
@@ -441,12 +503,30 @@ const parser = new ArgParser({ /* ... */ }).addFlags([
   { name: "tags", options: ["--tags"], type: "array", allowMultiple: true },
   { name: "config", options: ["--config"], type: "object" },
 
-  // Custom parser functions
+  // Custom parser functions (sync)
   {
     name: "date",
     options: ["--date"],
-    type: (value: string) => new Date(value)
-  }
+    type: (value: string) => new Date(value),
+  },
+
+  // Async custom parser functions
+  {
+    name: "config",
+    options: ["--config"],
+    type: async (filePath: string) => {
+      const content = await fs.readFile(filePath, "utf8");
+      return JSON.parse(content);
+    },
+  },
+  {
+    name: "user",
+    options: ["--user-id"],
+    type: async (userId: string) => {
+      const response = await fetch(`/api/users/${userId}`);
+      return response.json();
+    },
+  },
 ]);
 ```
 
@@ -470,9 +550,49 @@ The type system validates flag definitions at runtime and throws descriptive err
 
 - **String literals** are automatically converted to constructor functions internally
 - **Constructor functions** are preserved as-is
-- **Custom parser functions** allow complex transformations
+- **Custom parser functions** (sync and async) allow complex transformations
 - **undefined** falls back to the default `"string"` type
 
+#### Async Custom Parser Support
+
+Custom parser functions can be **asynchronous**, enabling powerful use cases like file I/O, API calls, and database lookups:
+
+```typescript
+const parser = new ArgParser({
+  /* ... */
+}).addFlags([
+  {
+    name: "config",
+    options: ["--config"],
+    type: async (filePath: string) => {
+      const content = await fs.readFile(filePath, "utf8");
+      return JSON.parse(content);
+    },
+  },
+  {
+    name: "user",
+    options: ["--user-id"],
+    type: async (userId: string) => {
+      const response = await fetch(`/api/users/${userId}`);
+      if (!response.ok) throw new Error(`User not found: ${userId}`);
+      return response.json();
+    },
+  },
+]);
+
+// Usage: --config ./settings.json --user-id 123
+const result = await parser.parse(process.argv.slice(2));
+// result.config contains parsed JSON from file
+// result.user contains user data from API
+```
+
+**Key Features:**
+
+- ✅ **Backward compatible** - existing sync parsers continue to work
+- ✅ **Automatic detection** - no configuration needed, just return a Promise
+- ✅ **Error handling** - async errors are properly propagated
+- ✅ **Performance** - parsers run concurrently when possible
+
 #### Type Conversion Examples
 
 ```typescript
@@ -492,9 +612,13 @@ The type system validates flag definitions at runtime and throws descriptive err
 --tags tag1,tag2,tag3           → ["tag1", "tag2", "tag3"]
 --file file1.txt --file file2.txt → ["file1.txt", "file2.txt"]
 
-// Custom parser functions
+// Custom parser functions (sync)
 --date "2023-01-01"  → Date object
 --json '{"key":"val"}' → parsed JSON object
+
+// Async custom parser functions
+--config "./settings.json" → parsed JSON from file (async)
+--user-id "123"            → user data from API (async)
 ```
 
 ### Hierarchical CLIs (Sub-Commands)
@@ -958,7 +1082,7 @@ ArgParser includes built-in `--s-*` flags for development, debugging, and config
 | --------------------------- | ---------------------------------------------------------------------------------------------- |
 | **MCP & DXT**               |                                                                                                |
 | `--s-mcp-serve`             | Starts the application in MCP server mode, exposing all tools.                                 |
-| `--s-build-dxt [dir]`       | Generates a complete, autonomous DXT package for Claude Desktop.                               |
+| `--s-build-dxt [dir]`       | Generates a complete, autonomous DXT package for Claude Desktop in the specified directory.    |
 | `--s-mcp-transport <type>`  | Overrides the MCP transport (`stdio`, `sse`, `streamable-http`).                               |
 | `--s-mcp-transports <json>` | Overrides transports with a JSON array for multi-transport setups.                             |
 | `--s-mcp-port <number>`     | Sets the port for HTTP-based transports (`sse`, `streamable-http`).                            |
@@ -975,6 +1099,24 @@ ArgParser includes built-in `--s-*` flags for development, debugging, and config
 
 ## Changelog
 
+### v2.2.0
+
+**Feat**
+
+- IFlag function-based `type` now supports async methods such as `type: async () => Promise<string>`.
+
+**Fixes and changes**
+
+- `.parse()` can now work without arguments, it will try to infer that if you are in CLI mode and on a Node environment, it should use `process.argv` as the input. You can still pass parameters to control more granularly.
+- `--s-build-dxt` now takes an optional path to specify where to prepare the assets prior to packing, the path you pass is in relation to process.cwd() (current working directory).
+- `--s-build-dxt` logo detection now resolves paths more accurately...
+
+### v2.1.1
+
+**Fixes and changes**
+
+- Fix missing missing types fr
+
 ### v2.1.0
 
 **Feat**
@@ -983,8 +1125,8 @@ ArgParser includes built-in `--s-*` flags for development, debugging, and config
 - Add support for MCP output_schema field for clients that support it, CLI isn't impacted by it, this helps a lot the interactivity, self-documentation, and improves the API guarantees
 
 **Fixes and changes**
-- Fix missing missing types
-- Improved MCP version compliance 
+
+- Improved MCP version compliance
 
 ### v2.0.0
 
@@ -1018,10 +1160,10 @@ ArgParser includes built-in `--s-*` flags for development, debugging, and config
 - [x] Rename --LIB-\* flags to --s-\*
 - [x] Make it possible to pass a `--s-save-to-env /path/to/file` parameter that saves all the parameters to a file (works with Bash-style .env, JSON, YAML, TOML)
 - [x] Make it possible to pass a `--s-with-env /path/to/file` parameter that loads all the parameters from a file (works with Bash-style .env, JSON, YAML, TOML)
+- [x] Add support for async type function to enable more flexibility
 - [ ] Add System flags to args.systemArgs
 - [ ] Improve flag options collision prevention
 - [ ] Add support for locales / translations
-- [ ] Add support for async type function to enable more flexibility
 - [ ] (potentially) add support for fully typed parsed output, this has proven very challenging
 - [ ] Upgrade to Zod/V4 (V4 does not support functions well, this will take more time, not a priority)
 

package/dist/config/ConfigurationManager.d.ts

@@ -0,0 +1,74 @@
+import type { ProcessedFlag, TParsedArgs } from "../core/types";
+/**
+ * ConfigurationManager handles environment file operations, format conversion,
+ * and configuration merging for ArgParser instances.
+ */
+export declare class ConfigurationManager {
+    private argParserInstance;
+    constructor(argParserInstance: any);
+    /**
+     * Generates a default environment file name based on app configuration
+     */
+    generateDefaultEnvFileName(): string;
+    /**
+     * Handles the --s-save-to-env system flag at the final parser level
+     */
+    handleSaveToEnvFlag(processArgs: string[], parserChain: any[]): boolean;
+    /**
+     * Saves current configuration to an environment file
+     */
+    saveToEnvFile(filePath: string, _processArgs: string[], parserChain: any[]): void;
+    /**
+     * Loads configuration from an environment file
+     */
+    loadEnvFile(filePath: string, parserChain: any[]): Record<string, any>;
+    /**
+     * Parses environment file content
+     */
+    parseEnvFile(content: string): Record<string, any>;
+    /**
+     * Parses YAML file content (legacy method - now uses plugin system)
+     */
+    parseYamlFile(content: string): Record<string, any>;
+    /**
+     * Parses JSON file content
+     */
+    parseJsonFile(content: string): Record<string, any>;
+    /**
+     * Parses TOML file content (legacy method - now uses plugin system)
+     */
+    parseTomlFile(content: string): Record<string, any>;
+    /**
+     * Converts raw configuration to flag values with proper type conversion
+     */
+    convertConfigToFlagValues(rawConfig: Record<string, any>, parserChain: any[]): Record<string, any>;
+    /**
+     * Converts a value to the appropriate flag type
+     */
+    convertValueToFlagType(value: any, flag: ProcessedFlag): any;
+    /**
+     * Merges environment configuration with command line arguments
+     */
+    mergeEnvConfigWithArgs(envConfig: Record<string, any>, processArgs: string[]): string[];
+    /**
+     * Generates environment file format
+     */
+    generateEnvFormat(flags: ProcessedFlag[], parsedArgs: TParsedArgs<any>): string;
+    /**
+     * Generates YAML file format (legacy method - now uses plugin system)
+     */
+    generateYamlFormat(flags: ProcessedFlag[], parsedArgs: TParsedArgs<any>): string;
+    /**
+     * Generates JSON file format
+     */
+    generateJsonFormat(flags: ProcessedFlag[], parsedArgs: TParsedArgs<any>): string;
+    /**
+     * Generates TOML file format (legacy method - now uses plugin system)
+     */
+    generateTomlFormat(flags: ProcessedFlag[], parsedArgs: TParsedArgs<any>): string;
+    /**
+     * Gets a string representation of a flag type
+     */
+    private getTypeString;
+}
+//# sourceMappingURL=ConfigurationManager.d.ts.map

package/dist/config/ConfigurationManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigurationManager.d.ts","sourceRoot":"","sources":["../../src/config/ConfigurationManager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGhE;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,iBAAiB,CAAM;gBAEnB,iBAAiB,EAAE,GAAG;IAOlC;;OAEG;IACI,0BAA0B,IAAI,MAAM;IAqB3C;;OAEG;IACI,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,OAAO;IAyB9E;;OAEG;IACI,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,IAAI;IAyDxF;;OAEG;IACI,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IA2C7E;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IA0BzD;;OAEG;IACI,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAwE1D;;OAEG;IACI,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAQ1D;;OAEG;IACI,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAiC1D;;OAEG;IACI,yBAAyB,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IA8BzG;;OAEG;IACI,sBAAsB,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,aAAa,GAAG,GAAG;IAyEnE;;OAEG;IACI,sBAAsB,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IA2B9F;;OAEG;IACI,iBAAiB,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,UAAU,EAAE,WAAW,CAAC,GAAG,CAAC,GAAG,MAAM;IA0BtF;;OAEG;IACI,kBAAkB,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,UAAU,EAAE,WAAW,CAAC,GAAG,CAAC,GAAG,MAAM;IAmCvF;;OAEG;IACI,kBAAkB,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,UAAU,EAAE,WAAW,CAAC,GAAG,CAAC,GAAG,MAAM;IAavF;;OAEG;IACI,kBAAkB,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,UAAU,EAAE,WAAW,CAAC,GAAG,CAAC,GAAG,MAAM;IAmCvF;;OAEG;IACH,OAAO,CAAC,aAAa;CAStB"}

package/dist/config/plugins/ConfigPlugin.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Plugin interface for configuration file format support
+ */
+export interface IConfigPlugin {
+    /**
+     * File extensions this plugin supports (e.g., ['.toml', '.tml'])
+     */
+    readonly supportedExtensions: string[];
+    /**
+     * Plugin name for identification
+     */
+    readonly name: string;
+    /**
+     * Parse configuration file content
+     * @param content File content as string
+     * @returns Parsed configuration object
+     */
+    parse(content: string): Record<string, any>;
+    /**
+     * Generate configuration file content
+     * @param config Configuration object
+     * @param flags Flag definitions for metadata
+     * @param parsedArgs Parsed arguments for values
+     * @returns Generated file content
+     */
+    generate(config: Record<string, any>, flags: any[], parsedArgs: any): string;
+}
+/**
+ * Base class for configuration plugins
+ */
+export declare abstract class ConfigPlugin implements IConfigPlugin {
+    abstract readonly supportedExtensions: string[];
+    abstract readonly name: string;
+    abstract parse(content: string): Record<string, any>;
+    abstract generate(config: Record<string, any>, flags: any[], parsedArgs: any): string;
+    /**
+     * Check if this plugin supports a given file extension
+     */
+    supportsExtension(extension: string): boolean;
+}
+/**
+ * Built-in JSON configuration plugin (no external dependencies)
+ */
+export declare class JsonConfigPlugin extends ConfigPlugin {
+    readonly supportedExtensions: string[];
+    readonly name = "json";
+    parse(content: string): Record<string, any>;
+    generate(_config: Record<string, any>, flags: any[], parsedArgs: any): string;
+}
+/**
+ * Built-in ENV configuration plugin (no external dependencies)
+ */
+export declare class EnvConfigPlugin extends ConfigPlugin {
+    readonly supportedExtensions: string[];
+    readonly name = "env";
+    parse(content: string): Record<string, any>;
+    generate(_config: Record<string, any>, flags: any[], parsedArgs: any): string;
+    private getTypeString;
+}
+//# sourceMappingURL=ConfigPlugin.d.ts.map

package/dist/config/plugins/ConfigPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigPlugin.d.ts","sourceRoot":"","sources":["../../../src/config/plugins/ConfigPlugin.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE5C;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,GAAG,GAAG,MAAM,CAAC;CAC9E;AAED;;GAEG;AACH,8BAAsB,YAAa,YAAW,aAAa;IACzD,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAChD,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACpD,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,GAAG,GAAG,MAAM;IAErF;;OAEG;IACI,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;CAGrD;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,QAAQ,CAAC,mBAAmB,WAAuB;IACnD,QAAQ,CAAC,IAAI,UAAU;IAEvB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAc3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,GAAG,GAAG,MAAM;CA4B9E;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,QAAQ,CAAC,mBAAmB,WAAY;IACxC,QAAQ,CAAC,IAAI,SAAS;IAEtB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IA0B3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,GAAG,GAAG,MAAM;IAmC7E,OAAO,CAAC,aAAa;CAMtB"}

package/dist/config/plugins/ConfigPluginRegistry.d.ts

@@ -0,0 +1,72 @@
+import type { IConfigPlugin } from './ConfigPlugin';
+/**
+ * Registry for configuration plugins
+ * Manages available config format plugins and provides plugin lookup
+ */
+export declare class ConfigPluginRegistry {
+    private plugins;
+    private extensionMap;
+    constructor();
+    /**
+     * Register a configuration plugin
+     */
+    registerPlugin(plugin: IConfigPlugin): void;
+    /**
+     * Get plugin by name
+     */
+    getPlugin(name: string): IConfigPlugin | undefined;
+    /**
+     * Get plugin by file extension
+     */
+    getPluginByExtension(extension: string): IConfigPlugin | undefined;
+    /**
+     * Check if a file extension is supported
+     */
+    isExtensionSupported(extension: string): boolean;
+    /**
+     * Get all registered plugin names
+     */
+    getRegisteredPlugins(): string[];
+    /**
+     * Get all supported extensions
+     */
+    getSupportedExtensions(): string[];
+    /**
+     * Unregister a plugin
+     */
+    unregisterPlugin(name: string): boolean;
+    /**
+     * Clear all plugins (useful for testing)
+     */
+    clear(): void;
+    /**
+     * Auto-register optional plugins if their dependencies are available
+     * This method attempts to load TOML and YAML plugins without throwing errors
+     */
+    autoRegisterOptionalPlugins(): void;
+    /**
+     * Async version of auto-register optional plugins with ESM support
+     * This method attempts to load TOML and YAML plugins without throwing errors
+     */
+    autoRegisterOptionalPluginsAsync(): Promise<void>;
+}
+/**
+ * Global plugin registry instance
+ * This can be used throughout the application
+ */
+export declare const globalConfigPluginRegistry: ConfigPluginRegistry;
+/**
+ * Convenience function to register optional plugins
+ * Call this once at application startup if you want TOML/YAML support
+ */
+export declare function enableOptionalConfigPlugins(): void;
+/**
+ * Async convenience function to register optional plugins with ESM support
+ * Call this once at application startup if you want TOML/YAML support in ESM environments
+ */
+export declare function enableOptionalConfigPluginsAsync(): Promise<void>;
+/**
+ * Convenience function to register only specific plugins
+ */
+export declare function enableConfigPlugins(pluginNames: string[]): void;
+//# sourceMappingURL=ConfigPluginRegistry.d.ts.map

package/dist/config/plugins/ConfigPluginRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigPluginRegistry.d.ts","sourceRoot":"","sources":["../../../src/config/plugins/ConfigPluginRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,YAAY,CAAyC;;IAQ7D;;OAEG;IACI,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IASlD;;OAEG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIzD;;OAEG;IACI,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIzE;;OAEG;IACI,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIvD;;OAEG;IACI,oBAAoB,IAAI,MAAM,EAAE;IAIvC;;OAEG;IACI,sBAAsB,IAAI,MAAM,EAAE;IAIzC;;OAEG;IACI,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAiB9C;;OAEG;IACI,KAAK,IAAI,IAAI;IAKpB;;;OAGG;IACI,2BAA2B,IAAI,IAAI;IAwB1C;;;OAGG;IACU,gCAAgC,IAAI,OAAO,CAAC,IAAI,CAAC;CAuB/D;AAED;;;GAGG;AACH,eAAO,MAAM,0BAA0B,sBAA6B,CAAC;AAErE;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AAED;;;GAGG;AACH,wBAAsB,gCAAgC,IAAI,OAAO,CAAC,IAAI,CAAC,CAEtE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,CA+B/D"}

package/dist/config/plugins/TomlConfigPlugin.d.ts

@@ -0,0 +1,30 @@
+import { ConfigPlugin } from './ConfigPlugin';
+/**
+ * TOML configuration plugin (requires smol-toml dependency)
+ * This plugin is optional and only loaded when TOML support is needed
+ */
+export declare class TomlConfigPlugin extends ConfigPlugin {
+    readonly supportedExtensions: string[];
+    readonly name = "toml";
+    private tomlModule;
+    constructor(tomlModule?: any);
+    private loadTomlModule;
+    parse(content: string): Record<string, any>;
+    generate(_config: Record<string, any>, flags: any[], parsedArgs: any): string;
+    /**
+     * Simple TOML parsing fallback for basic key-value pairs
+     */
+    private parseTomlSimple;
+    private getTypeString;
+}
+/**
+ * Factory function to create TOML plugin safely
+ * Returns null if TOML dependency is not available
+ */
+export declare function createTomlPlugin(): TomlConfigPlugin | null;
+/**
+ * Async factory function to create TOML plugin with ESM support
+ * Returns null if TOML dependency is not available
+ */
+export declare function createTomlPluginAsync(): Promise<TomlConfigPlugin | null>;
+//# sourceMappingURL=TomlConfigPlugin.d.ts.map

package/dist/config/plugins/TomlConfigPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TomlConfigPlugin.d.ts","sourceRoot":"","sources":["../../../src/config/plugins/TomlConfigPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,QAAQ,CAAC,mBAAmB,WAAqB;IACjD,QAAQ,CAAC,IAAI,UAAU;IAEvB,OAAO,CAAC,UAAU,CAAa;gBAEnB,UAAU,CAAC,EAAE,GAAG;IAS5B,OAAO,CAAC,cAAc;IAkBtB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAiB3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,GAAG,GAAG,MAAM;IAmD7E;;OAEG;IACH,OAAO,CAAC,eAAe;IA0BvB,OAAO,CAAC,aAAa;CAMtB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,gBAAgB,GAAG,IAAI,CAO1D;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAmB9E"}

package/dist/config/plugins/YamlConfigPlugin.d.ts

@@ -0,0 +1,29 @@
+import { ConfigPlugin } from './ConfigPlugin';
+/**
+ * YAML configuration plugin (requires js-yaml dependency)
+ * This plugin is optional and only loaded when YAML support is needed
+ */
+export declare class YamlConfigPlugin extends ConfigPlugin {
+    readonly supportedExtensions: string[];
+    readonly name = "yaml";
+    private yamlModule;
+    constructor(yamlModule?: any);
+    private loadYamlModule;
+    parse(content: string): Record<string, any>;
+    generate(_config: Record<string, any>, flags: any[], parsedArgs: any): string;
+    /**
+     * Simple YAML parsing fallback for basic key-value pairs
+     */
+    private parseYamlSimple;
+}
+/**
+ * Factory function to create YAML plugin safely
+ * Returns null if YAML dependency is not available
+ */
+export declare function createYamlPlugin(): YamlConfigPlugin | null;
+/**
+ * Async factory function to create YAML plugin with ESM support
+ * Returns null if YAML dependency is not available
+ */
+export declare function createYamlPluginAsync(): Promise<YamlConfigPlugin | null>;
+//# sourceMappingURL=YamlConfigPlugin.d.ts.map

package/dist/config/plugins/YamlConfigPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"YamlConfigPlugin.d.ts","sourceRoot":"","sources":["../../../src/config/plugins/YamlConfigPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,QAAQ,CAAC,mBAAmB,WAAqB;IACjD,QAAQ,CAAC,IAAI,UAAU;IAEvB,OAAO,CAAC,UAAU,CAAa;gBAEnB,UAAU,CAAC,EAAE,GAAG;IAS5B,OAAO,CAAC,cAAc;IAgBtB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAiB3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,GAAG,GAAG,MAAM;IA0C7E;;OAEG;IACH,OAAO,CAAC,eAAe;CAyBxB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,gBAAgB,GAAG,IAAI,CAO1D;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAmB9E"}

package/dist/config/plugins/index.d.ts

@@ -0,0 +1,5 @@
+export { type IConfigPlugin, ConfigPlugin, JsonConfigPlugin, EnvConfigPlugin } from './ConfigPlugin';
+export { ConfigPluginRegistry, globalConfigPluginRegistry, enableOptionalConfigPlugins, enableOptionalConfigPluginsAsync, enableConfigPlugins } from './ConfigPluginRegistry';
+export { TomlConfigPlugin, createTomlPlugin, createTomlPluginAsync } from './TomlConfigPlugin';
+export { YamlConfigPlugin, createYamlPlugin, createYamlPluginAsync } from './YamlConfigPlugin';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/plugins/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,aAAa,EAClB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EAChB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,gCAAgC,EAChC,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC/F,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}