@alcyone-labs/arg-parser 2.1.0 → 2.1.1

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"}