configforge 1.0.0-beta.1 → 1.0.0-beta.11

package/dist/errors/SuggestionEngine.js

@@ -0,0 +1,328 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SuggestionEngine = void 0;
+/**
+ * Suggestion engine for providing helpful error messages and corrections
+ */
+class SuggestionEngine {
+    /**
+     * Calculate Levenshtein distance between two strings
+     */
+    static levenshteinDistance(str1, str2) {
+        const matrix = [];
+        for (let i = 0; i <= str2.length; i++) {
+            matrix[i] = [i];
+        }
+        for (let j = 0; j <= str1.length; j++) {
+            matrix[0][j] = j;
+        }
+        for (let i = 1; i <= str2.length; i++) {
+            for (let j = 1; j <= str1.length; j++) {
+                if (str2.charAt(i - 1) === str1.charAt(j - 1)) {
+                    matrix[i][j] = matrix[i - 1][j - 1];
+                }
+                else {
+                    matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, // substitution
+                    matrix[i][j - 1] + 1, // insertion
+                    matrix[i - 1][j] + 1 // deletion
+                    );
+                }
+            }
+        }
+        return matrix[str2.length][str1.length];
+    }
+    /**
+     * Calculate similarity score between two strings (0-1, where 1 is identical)
+     */
+    static calculateSimilarity(str1, str2) {
+        if (str1 === str2)
+            return 1;
+        if (str1.length === 0 || str2.length === 0)
+            return 0;
+        const s1 = str1.toLowerCase();
+        const s2 = str2.toLowerCase();
+        // Check for exact prefix/suffix matches (bonus points)
+        let bonus = 0;
+        if (s1.startsWith(s2) || s2.startsWith(s1)) {
+            bonus = 0.1; // Prefix match bonus
+        }
+        else if (s1.endsWith(s2) || s2.endsWith(s1)) {
+            bonus = 0.05; // Suffix match bonus
+        }
+        const maxLength = Math.max(str1.length, str2.length);
+        const distance = this.levenshteinDistance(s1, s2);
+        const baseSimilarity = 1 - distance / maxLength;
+        return Math.min(1, baseSimilarity + bonus);
+    }
+    /**
+     * Find similar strings from a list of candidates
+     */
+    static findSimilar(target, candidates, threshold = SuggestionEngine.SIMILARITY_THRESHOLD) {
+        const similarities = candidates
+            .map(candidate => ({
+            value: candidate,
+            similarity: this.calculateSimilarity(target, candidate),
+        }))
+            .filter(item => item.similarity >= threshold)
+            .sort((a, b) => {
+            // First sort by similarity (descending)
+            if (b.similarity !== a.similarity) {
+                return b.similarity - a.similarity;
+            }
+            // If similarity is equal, prefer shorter strings
+            if (a.value.length !== b.value.length) {
+                return a.value.length - b.value.length;
+            }
+            // If length is also equal, prefer reverse alphabetical order (apply before apple)
+            return b.value.localeCompare(a.value);
+        })
+            .slice(0, this.MAX_SUGGESTIONS);
+        return similarities;
+    }
+    /**
+     * Suggest field names for mapping errors
+     */
+    static suggestFieldNames(invalidField, availableFields) {
+        // First, try exact substring matches
+        const substringMatches = availableFields.filter(field => field.toLowerCase().includes(invalidField.toLowerCase()) ||
+            invalidField.toLowerCase().includes(field.toLowerCase()));
+        // If we have substring matches, prioritize them
+        if (substringMatches.length > 0) {
+            return substringMatches.slice(0, this.MAX_SUGGESTIONS);
+        }
+        // Otherwise, use similarity matching with a lower threshold for field names
+        const suggestions = this.findSimilar(invalidField, availableFields, 0.4);
+        return suggestions.map(s => s.value);
+    }
+    /**
+     * Suggest property paths for nested object access
+     */
+    static suggestPropertyPaths(invalidPath, availablePaths) {
+        // Split path into segments for better matching
+        const pathSegments = invalidPath.split('.');
+        const lastSegment = pathSegments[pathSegments.length - 1] || '';
+        // Calculate scores for each available path
+        const pathScores = availablePaths.map(path => {
+            const segments = path.split('.');
+            const lastAvailableSegment = segments[segments.length - 1] || '';
+            // Score based on last segment similarity
+            const lastSegmentSimilarity = this.calculateSimilarity(lastSegment, lastAvailableSegment);
+            // Score based on full path similarity
+            const fullPathSimilarity = this.calculateSimilarity(invalidPath, path);
+            // Score based on substring matches in path segments
+            let segmentMatchScore = 0;
+            pathSegments.forEach(inputSegment => {
+                if (segments.some(pathSegment => pathSegment.toLowerCase().includes(inputSegment.toLowerCase()) ||
+                    inputSegment.toLowerCase().includes(pathSegment.toLowerCase()))) {
+                    segmentMatchScore += 0.5;
+                }
+            });
+            // Combine scores with weights
+            const combinedScore = lastSegmentSimilarity * 0.4 +
+                fullPathSimilarity * 0.3 +
+                segmentMatchScore * 0.3;
+            return { path, score: combinedScore };
+        });
+        // Sort by combined score and return top matches
+        const sortedPaths = pathScores
+            .filter(item => item.score >= 0.3)
+            .sort((a, b) => b.score - a.score)
+            .slice(0, this.MAX_SUGGESTIONS);
+        if (sortedPaths.length > 0) {
+            return sortedPaths.map(item => item.path);
+        }
+        // Fallback to simple similarity matching
+        const suggestions = this.findSimilar(invalidPath, availablePaths, 0.4);
+        return suggestions.map(s => s.value);
+    }
+    /**
+     * Suggest configuration values
+     */
+    static suggestConfigValues(invalidValue, validValues) {
+        // First, try substring matches (both directions)
+        const substringMatches = validValues.filter(value => value.toLowerCase().includes(invalidValue.toLowerCase()) ||
+            invalidValue.toLowerCase().includes(value.toLowerCase()));
+        // If we have substring matches, prioritize them
+        if (substringMatches.length > 0) {
+            return substringMatches.slice(0, this.MAX_SUGGESTIONS);
+        }
+        // Otherwise, use similarity matching with lower threshold
+        const suggestions = this.findSimilar(invalidValue, validValues, 0.3);
+        return suggestions.map(s => s.value);
+    }
+    /**
+     * Generate helpful error message for missing fields
+     */
+    static generateMissingFieldMessage(missingField, availableFields) {
+        const suggestions = this.suggestFieldNames(missingField, availableFields);
+        let message = `Field '${missingField}' not found in source data.`;
+        if (suggestions.length > 0) {
+            message += ` Did you mean: ${suggestions
+                .slice(0, 3)
+                .map(s => `'${s}'`)
+                .join(', ')}?`;
+        }
+        else if (availableFields.length > 0) {
+            const topFields = availableFields.slice(0, 5);
+            message += ` Available fields: ${topFields.map(f => `'${f}'`).join(', ')}${availableFields.length > 5 ? '...' : ''}.`;
+        }
+        return message;
+    }
+    /**
+     * Generate helpful error message for invalid paths
+     */
+    static generateInvalidPathMessage(invalidPath, availablePaths) {
+        const suggestions = this.suggestPropertyPaths(invalidPath, availablePaths);
+        let message = `Invalid path '${invalidPath}'.`;
+        if (suggestions.length > 0) {
+            message += ` Did you mean: ${suggestions
+                .slice(0, 3)
+                .map(s => `'${s}'`)
+                .join(', ')}?`;
+        }
+        else if (availablePaths.length > 0) {
+            const topPaths = availablePaths.slice(0, 5);
+            message += ` Available paths: ${topPaths.map(p => `'${p}'`).join(', ')}${availablePaths.length > 5 ? '...' : ''}.`;
+        }
+        return message;
+    }
+    /**
+     * Generate helpful error message for invalid configuration
+     */
+    static generateInvalidConfigMessage(configKey, invalidValue, validValues) {
+        const suggestions = this.suggestConfigValues(invalidValue, validValues);
+        let message = `Invalid value '${invalidValue}' for configuration '${configKey}'.`;
+        if (suggestions.length > 0) {
+            message += ` Did you mean: ${suggestions
+                .slice(0, 3)
+                .map(s => `'${s}'`)
+                .join(', ')}?`;
+        }
+        if (validValues.length > 0) {
+            message += ` Valid values: ${validValues.map(v => `'${v}'`).join(', ')}.`;
+        }
+        return message;
+    }
+    /**
+     * Generate suggestions for transform function errors
+     */
+    static suggestTransformFix(error, inputValue, expectedType) {
+        const inputType = typeof inputValue;
+        let suggestion = 'Check the transform function implementation.';
+        if (expectedType && inputType !== expectedType) {
+            suggestion = `Expected ${expectedType} but got ${inputType}. `;
+            switch (expectedType) {
+                case 'string':
+                    suggestion += 'Consider using String(value) or value.toString().';
+                    break;
+                case 'number':
+                    suggestion += 'Consider using Number(value) or parseFloat(value).';
+                    break;
+                case 'boolean':
+                    suggestion += 'Consider using Boolean(value) or !!value.';
+                    break;
+                default:
+                    suggestion += 'Add type checking in your transform function.';
+            }
+        }
+        else if (error.message.includes('undefined')) {
+            suggestion =
+                'Check for undefined values before processing. Consider using optional chaining (?.) or default values.';
+        }
+        else if (error.message.includes('null')) {
+            suggestion =
+                'Check for null values before processing. Consider using nullish coalescing (??) operator.';
+        }
+        return suggestion;
+    }
+    /**
+     * Generate suggestions for validation errors
+     */
+    static suggestValidationFix(fieldPath, value, validationRule) {
+        const valueType = typeof value;
+        let suggestion = `Validation failed for field '${fieldPath}'.`;
+        switch (validationRule.toLowerCase()) {
+            case 'required':
+                suggestion += ' This field is required and cannot be empty.';
+                break;
+            case 'email':
+                suggestion +=
+                    ' Please provide a valid email address (e.g., user@example.com).';
+                break;
+            case 'url':
+                suggestion +=
+                    ' Please provide a valid URL (e.g., https://example.com).';
+                break;
+            case 'number':
+                suggestion += ` Expected a number but got ${valueType}. Consider converting the value to a number.`;
+                break;
+            case 'string':
+                suggestion += ` Expected a string but got ${valueType}. Consider converting the value to a string.`;
+                break;
+            case 'boolean':
+                suggestion += ` Expected a boolean but got ${valueType}. Consider using true/false values.`;
+                break;
+            default:
+                suggestion += ` Check the validation rule: ${validationRule}.`;
+        }
+        return suggestion;
+    }
+    /**
+     * Extract all possible paths from an object for suggestions
+     */
+    static extractPaths(obj, prefix = '') {
+        const paths = [];
+        if (obj === null || typeof obj !== 'object') {
+            return paths;
+        }
+        if (Array.isArray(obj)) {
+            obj.forEach((item, index) => {
+                const arrayPath = prefix ? `${prefix}[${index}]` : `[${index}]`;
+                paths.push(arrayPath);
+                paths.push(...this.extractPaths(item, arrayPath));
+            });
+        }
+        else {
+            Object.keys(obj).forEach(key => {
+                const currentPath = prefix ? `${prefix}.${key}` : key;
+                paths.push(currentPath);
+                paths.push(...this.extractPaths(obj[key], currentPath));
+            });
+        }
+        return paths;
+    }
+    /**
+     * Extract field names from an object (top-level and nested)
+     */
+    static extractFieldNames(obj, includeNested = true) {
+        const fields = new Set();
+        const traverse = (current, path = '') => {
+            if (current === null || typeof current !== 'object') {
+                return;
+            }
+            if (Array.isArray(current)) {
+                current.forEach((item, index) => {
+                    if (includeNested) {
+                        traverse(item, path ? `${path}[${index}]` : `[${index}]`);
+                    }
+                });
+            }
+            else {
+                Object.keys(current).forEach(key => {
+                    const currentPath = path ? `${path}.${key}` : key;
+                    fields.add(key); // Add the key itself
+                    if (includeNested) {
+                        fields.add(currentPath); // Add the full path
+                        traverse(current[key], currentPath);
+                    }
+                });
+            }
+        };
+        traverse(obj);
+        return Array.from(fields);
+    }
+}
+exports.SuggestionEngine = SuggestionEngine;
+SuggestionEngine.SIMILARITY_THRESHOLD = 0.6;
+SuggestionEngine.MAX_SUGGESTIONS = 5;
+//# sourceMappingURL=SuggestionEngine.js.map

package/dist/errors/SuggestionEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SuggestionEngine.js","sourceRoot":"","sources":["../../src/errors/SuggestionEngine.ts"],"names":[],"mappings":"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"}

package/dist/errors/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Error handling and reporting system for ConfigForge
+ */
+export * from './ErrorTypes';
+export * from './SpecificErrors';
+export * from './ErrorCollector';
+export * from './ErrorReporter';
+export * from './ErrorRecovery';
+export * from './ErrorContext';
+export * from './SuggestionEngine';
+export { ConfigForgeError, ParseError, MappingError, ValidationError, TransformError, GenericConfigForgeError, } from '../types';
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AAGnC,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,uBAAuB,GACxB,MAAM,UAAU,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Error handling and reporting system for ConfigForge
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenericConfigForgeError = exports.TransformError = exports.ValidationError = exports.MappingError = exports.ParseError = exports.ConfigForgeError = void 0;
+// Export error types
+__exportStar(require("./ErrorTypes"), exports);
+__exportStar(require("./SpecificErrors"), exports);
+// Export error management
+__exportStar(require("./ErrorCollector"), exports);
+__exportStar(require("./ErrorReporter"), exports);
+__exportStar(require("./ErrorRecovery"), exports);
+// Export error context and utilities
+__exportStar(require("./ErrorContext"), exports);
+__exportStar(require("./SuggestionEngine"), exports);
+// Re-export base error types from main types
+var types_1 = require("../types");
+Object.defineProperty(exports, "ConfigForgeError", { enumerable: true, get: function () { return types_1.ConfigForgeError; } });
+Object.defineProperty(exports, "ParseError", { enumerable: true, get: function () { return types_1.ParseError; } });
+Object.defineProperty(exports, "MappingError", { enumerable: true, get: function () { return types_1.MappingError; } });
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return types_1.ValidationError; } });
+Object.defineProperty(exports, "TransformError", { enumerable: true, get: function () { return types_1.TransformError; } });
+Object.defineProperty(exports, "GenericConfigForgeError", { enumerable: true, get: function () { return types_1.GenericConfigForgeError; } });
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;AAEH,qBAAqB;AACrB,+CAA6B;AAC7B,mDAAiC;AAEjC,0BAA0B;AAC1B,mDAAiC;AACjC,kDAAgC;AAChC,kDAAgC;AAEhC,qCAAqC;AACrC,iDAA+B;AAC/B,qDAAmC;AAEnC,6CAA6C;AAC7C,kCAOkB;AANhB,yGAAA,gBAAgB,OAAA;AAChB,mGAAA,UAAU,OAAA;AACV,qGAAA,YAAY,OAAA;AACZ,wGAAA,eAAe,OAAA;AACf,uGAAA,cAAc,OAAA;AACd,gHAAA,uBAAuB,OAAA"}

package/dist/index.d.ts

@@ -2,6 +2,10 @@ export { forge } from './core/Forge';
 export { Converter } from './core/Converter';
 export { Mapper } from './core/Mapper';
 export * as transforms from './transformers/built-in';
+export * as validators from './validators/built-in';
+export { ValidatorRegistry, validatorRegistry, } from './validators/ValidatorRegistry';
 export * from './types';
+export * from './errors';
+export { CLIGenerator, CLIUtils, CommandBuilder, createCLI, createCommand, quickCLI, } from './scripts';
 export { parsePath, setPath, mergePaths, detectFormat } from './utils';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,KAAK,UAAU,MAAM,yBAAyB,CAAC;AAEtD,cAAc,SAAS,CAAC;AAMxB,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,KAAK,UAAU,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,EACL,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,gCAAgC,CAAC;AACxC,cAAc,SAAS,CAAC;AAGxB,cAAc,UAAU,CAAC;AAGzB,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,SAAS,EACT,aAAa,EACb,QAAQ,GACT,MAAM,WAAW,CAAC;AAMnB,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -36,7 +36,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.detectFormat = exports.mergePaths = exports.setPath = exports.parsePath = exports.transforms = exports.Mapper = exports.Converter = exports.forge = void 0;
+exports.detectFormat = exports.mergePaths = exports.setPath = exports.parsePath = exports.quickCLI = exports.createCommand = exports.createCLI = exports.CommandBuilder = exports.CLIUtils = exports.CLIGenerator = exports.validatorRegistry = exports.ValidatorRegistry = exports.validators = exports.transforms = exports.Mapper = exports.Converter = exports.forge = void 0;
 // Main exports
 var Forge_1 = require("./core/Forge");
 Object.defineProperty(exports, "forge", { enumerable: true, get: function () { return Forge_1.forge; } });
@@ -45,8 +45,21 @@ Object.defineProperty(exports, "Converter", { enumerable: true, get: function ()
 var Mapper_1 = require("./core/Mapper");
 Object.defineProperty(exports, "Mapper", { enumerable: true, get: function () { return Mapper_1.Mapper; } });
 exports.transforms = __importStar(require("./transformers/built-in"));
-// export * as validators from './validators/built-in'; // TODO: Implement validators module
+exports.validators = __importStar(require("./validators/built-in"));
+var ValidatorRegistry_1 = require("./validators/ValidatorRegistry");
+Object.defineProperty(exports, "ValidatorRegistry", { enumerable: true, get: function () { return ValidatorRegistry_1.ValidatorRegistry; } });
+Object.defineProperty(exports, "validatorRegistry", { enumerable: true, get: function () { return ValidatorRegistry_1.validatorRegistry; } });
 __exportStar(require("./types"), exports);
+// Error handling exports
+__exportStar(require("./errors"), exports);
+// CLI exports
+var scripts_1 = require("./scripts");
+Object.defineProperty(exports, "CLIGenerator", { enumerable: true, get: function () { return scripts_1.CLIGenerator; } });
+Object.defineProperty(exports, "CLIUtils", { enumerable: true, get: function () { return scripts_1.CLIUtils; } });
+Object.defineProperty(exports, "CommandBuilder", { enumerable: true, get: function () { return scripts_1.CommandBuilder; } });
+Object.defineProperty(exports, "createCLI", { enumerable: true, get: function () { return scripts_1.createCLI; } });
+Object.defineProperty(exports, "createCommand", { enumerable: true, get: function () { return scripts_1.createCommand; } });
+Object.defineProperty(exports, "quickCLI", { enumerable: true, get: function () { return scripts_1.quickCLI; } });
 // Plugin exports
 // export { Plugin, PluginContext } from './plugins/Plugin'; // TODO: Implement plugin system
 // Utility exports

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,eAAe;AACf,sCAAqC;AAA5B,8FAAA,KAAK,OAAA;AACd,8CAA6C;AAApC,sGAAA,SAAS,OAAA;AAClB,wCAAuC;AAA9B,gGAAA,MAAM,OAAA;AACf,sEAAsD;AACtD,4FAA4F;AAC5F,0CAAwB;AAExB,iBAAiB;AACjB,6FAA6F;AAE7F,kBAAkB;AAClB,iCAAuE;AAA9D,kGAAA,SAAS,OAAA;AAAE,gGAAA,OAAO,OAAA;AAAE,mGAAA,UAAU,OAAA;AAAE,qGAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,eAAe;AACf,sCAAqC;AAA5B,8FAAA,KAAK,OAAA;AACd,8CAA6C;AAApC,sGAAA,SAAS,OAAA;AAClB,wCAAuC;AAA9B,gGAAA,MAAM,OAAA;AACf,sEAAsD;AACtD,oEAAoD;AACpD,oEAGwC;AAFtC,sHAAA,iBAAiB,OAAA;AACjB,sHAAA,iBAAiB,OAAA;AAEnB,0CAAwB;AAExB,yBAAyB;AACzB,2CAAyB;AAEzB,cAAc;AACd,qCAOmB;AANjB,uGAAA,YAAY,OAAA;AACZ,mGAAA,QAAQ,OAAA;AACR,yGAAA,cAAc,OAAA;AACd,oGAAA,SAAS,OAAA;AACT,wGAAA,aAAa,OAAA;AACb,mGAAA,QAAQ,OAAA;AAGV,iBAAiB;AACjB,6FAA6F;AAE7F,kBAAkB;AAClB,iCAAuE;AAA9D,kGAAA,SAAS,OAAA;AAAE,gGAAA,OAAO,OAAA;AAAE,mGAAA,UAAU,OAAA;AAAE,qGAAA,YAAY,OAAA"}

package/dist/scripts/CLIGenerator.d.ts

@@ -0,0 +1,109 @@
+import { Command } from 'commander';
+/**
+ * CLI command configuration
+ */
+export interface CLICommand {
+    name: string;
+    description: string;
+    options?: CLIOption[];
+    action: (args: any, options: any) => Promise<void> | void;
+}
+/**
+ * CLI option configuration
+ */
+export interface CLIOption {
+    flags: string;
+    description: string;
+    defaultValue?: any;
+}
+/**
+ * CLI generation options
+ */
+export interface CLIGeneratorOptions {
+    name?: string;
+    version?: string;
+    description?: string;
+    commands?: CLICommand[];
+    globalOptions?: CLIOption[];
+}
+/**
+ * Profile configuration for saving converter setups
+ */
+export interface ConverterProfile {
+    name: string;
+    description?: string;
+    converter: any;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * CLI Generator for creating command-line interfaces for ConfigForge converters
+ */
+export declare class CLIGenerator {
+    private program;
+    private options;
+    private profiles;
+    private profilesPath;
+    constructor(options?: CLIGeneratorOptions);
+    /**
+     * Set up the main program configuration
+     */
+    private setupProgram;
+    /**
+     * Add built-in commands for common operations
+     */
+    private addBuiltInCommands;
+    /**
+     * Add a custom command to the CLI
+     */
+    addCommand(command: CLICommand): void;
+    /**
+     * Handle the convert command
+     */
+    private handleConvertCommand;
+    /**
+     * Handle the validate command
+     */
+    private handleValidateCommand;
+    /**
+     * Handle profile list command
+     */
+    private handleProfileListCommand;
+    /**
+     * Handle profile save command
+     */
+    private handleProfileSaveCommand;
+    /**
+     * Handle profile delete command
+     */
+    private handleProfileDeleteCommand;
+    /**
+     * Handle profile show command
+     */
+    private handleProfileShowCommand;
+    /**
+     * Load profiles from disk
+     */
+    private loadProfiles;
+    /**
+     * Save profiles to disk
+     */
+    private saveProfiles;
+    /**
+     * Deserialize a converter from configuration
+     */
+    private deserializeConverter;
+    /**
+     * Parse command line arguments and execute
+     */
+    parse(argv?: string[]): Promise<void>;
+    /**
+     * Get the commander program instance
+     */
+    getProgram(): Command;
+    /**
+     * Create a CLI for a specific converter
+     */
+    static forConverter(_converter: any, options?: Partial<CLIGeneratorOptions>): CLIGenerator;
+}
+//# sourceMappingURL=CLIGenerator.d.ts.map

package/dist/scripts/CLIGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CLIGenerator.d.ts","sourceRoot":"","sources":["../../src/scripts/CLIGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC3D;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,SAAS,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,GAAG,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,QAAQ,CAA4C;IAC5D,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,GAAE,mBAAwB;IAgB7C;;OAEG;IACH,OAAO,CAAC,YAAY;IAwBpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyE1B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAuBrC;;OAEG;YACW,oBAAoB;IAmGlC;;OAEG;YACW,qBAAqB;IAiFnC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAyBhC;;OAEG;YACW,wBAAwB;IAuCtC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAWlC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAsBhC;;OAEG;IACH,OAAO,CAAC,YAAY;IAYpB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;OAEG;IACG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,UAAU,EAAE,GAAG,EACf,OAAO,GAAE,OAAO,CAAC,mBAAmB,CAAM,GACzC,YAAY;CA2BhB"}