@wundr.io/cli 1.0.11 → 1.0.13

package/dist/framework/help-generator.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Help Generator - Generates structured help text from command metadata.
+ *
+ * Produces:
+ * - Categorized command listings
+ * - Per-command detailed help with examples
+ * - Man-page style output for documentation
+ * - Markdown help for README generation
+ * - Search across all commands
+ *
+ * @module framework/help-generator
+ */
+import type { CommandDefinition } from './command-interface';
+import type { CommandRegistry } from './command-registry';
+/**
+ * Options for help text generation.
+ */
+export interface HelpGeneratorOptions {
+    /** Program name. Defaults to 'wundr'. */
+    programName?: string;
+    /** Maximum line width. Defaults to terminal width or 80. */
+    maxWidth?: number;
+    /** Whether to use colors. Defaults to TTY detection. */
+    color?: boolean;
+    /** Output format. */
+    format?: 'terminal' | 'markdown' | 'plain';
+}
+/**
+ * Result of a command search.
+ */
+export interface SearchResult {
+    command: CommandDefinition;
+    matchType: 'name' | 'alias' | 'description' | 'category';
+    score: number;
+}
+export declare class HelpGenerator {
+    private registry;
+    private programName;
+    private maxWidth;
+    private useColor;
+    private format;
+    constructor(registry: CommandRegistry, options?: HelpGeneratorOptions);
+    /**
+     * Generate the main help text showing all commands grouped by category.
+     */
+    generateMainHelp(): string;
+    /**
+     * Generate detailed help for a specific command.
+     */
+    generateCommandHelp(command: CommandDefinition): string;
+    /**
+     * Search for commands matching a query string.
+     */
+    search(query: string): SearchResult[];
+    /**
+     * Generate the main help as Markdown.
+     */
+    private generateMarkdownMainHelp;
+    /**
+     * Generate per-command help as Markdown.
+     */
+    private generateMarkdownCommandHelp;
+    /**
+     * Build a usage line from command definition.
+     */
+    private buildUsageLine;
+    /**
+     * Simple fuzzy matching score between query and target.
+     * Returns 0-1 where 1 is an exact match.
+     */
+    private fuzzyScore;
+    private heading;
+    private sectionTitle;
+    private highlight;
+    private dim;
+    private warn;
+}
+//# sourceMappingURL=help-generator.d.ts.map

package/dist/framework/help-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-generator.d.ts","sourceRoot":"","sources":["../../src/framework/help-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAmB,MAAM,qBAAqB,CAAC;AAE9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAM1D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,wDAAwD;IACxD,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,qBAAqB;IACrB,MAAM,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,aAAa,GAAG,UAAU,CAAC;IACzD,KAAK,EAAE,MAAM,CAAC;CACf;AAMD,qBAAa,aAAa;IAOtB,OAAO,CAAC,QAAQ;IANlB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,MAAM,CAAoC;gBAGxC,QAAQ,EAAE,eAAe,EACjC,OAAO,GAAE,oBAAyB;IAYpC;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAkF1B;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM;IAwGvD;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE;IAiErC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAwDhC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAmEnC;;OAEG;IACH,OAAO,CAAC,cAAc;IAoBtB;;;OAGG;IACH,OAAO,CAAC,UAAU;IA0BlB,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,IAAI;CAIb"}

package/dist/framework/help-generator.js

@@ -0,0 +1,414 @@
+"use strict";
+/**
+ * Help Generator - Generates structured help text from command metadata.
+ *
+ * Produces:
+ * - Categorized command listings
+ * - Per-command detailed help with examples
+ * - Man-page style output for documentation
+ * - Markdown help for README generation
+ * - Search across all commands
+ *
+ * @module framework/help-generator
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HelpGenerator = void 0;
+const tslib_1 = require("tslib");
+const chalk_1 = tslib_1.__importDefault(require("chalk"));
+const command_interface_1 = require("./command-interface");
+// ---------------------------------------------------------------------------
+// Help Generator
+// ---------------------------------------------------------------------------
+class HelpGenerator {
+    registry;
+    programName;
+    maxWidth;
+    useColor;
+    format;
+    constructor(registry, options = {}) {
+        this.registry = registry;
+        this.programName = options.programName ?? 'wundr';
+        this.maxWidth = options.maxWidth ?? process.stdout.columns ?? 80;
+        this.useColor = options.color ?? process.stdout.isTTY === true;
+        this.format = options.format ?? 'terminal';
+    }
+    // -------------------------------------------------------------------------
+    // Main Help
+    // -------------------------------------------------------------------------
+    /**
+     * Generate the main help text showing all commands grouped by category.
+     */
+    generateMainHelp() {
+        if (this.format === 'markdown') {
+            return this.generateMarkdownMainHelp();
+        }
+        const lines = [];
+        // Header
+        lines.push('');
+        lines.push(this.heading(`${this.programName} - CLI Tool`));
+        lines.push('');
+        // Usage
+        lines.push(this.sectionTitle('Usage'));
+        lines.push(`  ${this.programName} <command> [options]`);
+        lines.push('');
+        // Commands by category
+        const grouped = this.registry.grouped();
+        const categories = Array.from(grouped.keys()).sort();
+        for (const category of categories) {
+            const commands = grouped.get(category);
+            if (!commands || commands.length === 0)
+                continue;
+            // Skip hidden commands
+            const visible = commands.filter(cmd => !cmd.hidden && !cmd.name.includes(':'));
+            if (visible.length === 0)
+                continue;
+            const label = category === 'uncategorized'
+                ? 'Other Commands'
+                : (command_interface_1.CATEGORY_LABELS[category] ?? category);
+            lines.push(this.sectionTitle(label));
+            // Find max name width for alignment
+            const maxNameWidth = Math.max(...visible.map(cmd => {
+                const aliases = cmd.aliases ? `, ${cmd.aliases.join(', ')}` : '';
+                return cmd.name.length + aliases.length;
+            }));
+            for (const cmd of visible) {
+                const aliases = cmd.aliases ? `, ${cmd.aliases.join(', ')}` : '';
+                const nameCol = (cmd.name + aliases).padEnd(maxNameWidth + 2);
+                lines.push(`  ${this.highlight(nameCol)}  ${cmd.description}`);
+            }
+            lines.push('');
+        }
+        // Global options
+        lines.push(this.sectionTitle('Global Options'));
+        lines.push('  --verbose          Enable verbose logging');
+        lines.push('  --quiet            Suppress output');
+        lines.push('  --json             Output as JSON');
+        lines.push('  --no-color         Disable colored output');
+        lines.push('  --dry-run          Show what would be done');
+        lines.push('  --config <path>    Specify config file');
+        lines.push('  -h, --help         Show help');
+        lines.push('  -v, --version      Show version');
+        lines.push('');
+        // Footer
+        lines.push(this.dim(`Run '${this.programName} <command> --help' for detailed help on a command.`));
+        lines.push('');
+        return lines.join('\n');
+    }
+    // -------------------------------------------------------------------------
+    // Command Help
+    // -------------------------------------------------------------------------
+    /**
+     * Generate detailed help for a specific command.
+     */
+    generateCommandHelp(command) {
+        if (this.format === 'markdown') {
+            return this.generateMarkdownCommandHelp(command);
+        }
+        const lines = [];
+        // Header
+        lines.push('');
+        lines.push(this.heading(command.name));
+        lines.push(`  ${command.description}`);
+        lines.push('');
+        // Aliases
+        if (command.aliases && command.aliases.length > 0) {
+            lines.push(this.sectionTitle('Aliases'));
+            lines.push(`  ${command.aliases.join(', ')}`);
+            lines.push('');
+        }
+        // Usage
+        lines.push(this.sectionTitle('Usage'));
+        const usage = this.buildUsageLine(command);
+        lines.push(`  ${usage}`);
+        lines.push('');
+        // Arguments
+        if (command.arguments && command.arguments.length > 0) {
+            lines.push(this.sectionTitle('Arguments'));
+            const maxArgWidth = Math.max(...command.arguments.map(a => a.name.length));
+            for (const arg of command.arguments) {
+                const nameCol = arg.name.padEnd(maxArgWidth + 2);
+                const required = arg.required
+                    ? this.warn('(required)')
+                    : this.dim('(optional)');
+                const defaultVal = arg.defaultValue
+                    ? this.dim(` [default: ${arg.defaultValue}]`)
+                    : '';
+                lines.push(`  ${this.highlight(nameCol)}  ${arg.description} ${required}${defaultVal}`);
+            }
+            lines.push('');
+        }
+        // Options
+        if (command.options && command.options.length > 0) {
+            lines.push(this.sectionTitle('Options'));
+            const maxFlagWidth = Math.max(...command.options.map(o => o.flags.length));
+            for (const opt of command.options) {
+                const flagCol = opt.flags.padEnd(maxFlagWidth + 2);
+                const required = opt.required ? this.warn('(required)') : '';
+                const choices = opt.choices
+                    ? this.dim(` [${opt.choices.join('|')}]`)
+                    : '';
+                const defaultVal = opt.defaultValue !== undefined
+                    ? this.dim(` [default: ${opt.defaultValue}]`)
+                    : '';
+                const envVar = opt.envVar ? this.dim(` [env: ${opt.envVar}]`) : '';
+                lines.push(`  ${this.highlight(flagCol)}  ${opt.description}${required}${choices}${defaultVal}${envVar}`);
+            }
+            lines.push('');
+        }
+        // Subcommands
+        if (command.subcommands && command.subcommands.length > 0) {
+            lines.push(this.sectionTitle('Subcommands'));
+            const maxSubWidth = Math.max(...command.subcommands.map(s => s.name.length));
+            for (const sub of command.subcommands) {
+                const nameCol = sub.name.padEnd(maxSubWidth + 2);
+                lines.push(`  ${this.highlight(nameCol)}  ${sub.description}`);
+            }
+            lines.push('');
+        }
+        // Examples
+        if (command.examples && command.examples.length > 0) {
+            lines.push(this.sectionTitle('Examples'));
+            for (const ex of command.examples) {
+                lines.push(`  ${this.highlight(`$ ${ex.command}`)}`);
+                lines.push(`    ${this.dim(ex.description)}`);
+                lines.push('');
+            }
+        }
+        return lines.join('\n');
+    }
+    // -------------------------------------------------------------------------
+    // Search
+    // -------------------------------------------------------------------------
+    /**
+     * Search for commands matching a query string.
+     */
+    search(query) {
+        const normalizedQuery = query.toLowerCase();
+        const results = [];
+        for (const command of this.registry.list()) {
+            if (command.hidden)
+                continue;
+            let bestScore = 0;
+            let matchType = 'name';
+            // Name match
+            const nameScore = this.fuzzyScore(normalizedQuery, command.name.toLowerCase());
+            if (nameScore > bestScore) {
+                bestScore = nameScore;
+                matchType = 'name';
+            }
+            // Alias match
+            if (command.aliases) {
+                for (const alias of command.aliases) {
+                    const aliasScore = this.fuzzyScore(normalizedQuery, alias.toLowerCase());
+                    if (aliasScore > bestScore) {
+                        bestScore = aliasScore;
+                        matchType = 'alias';
+                    }
+                }
+            }
+            // Description match
+            const descScore = this.fuzzyScore(normalizedQuery, command.description.toLowerCase()) *
+                0.6;
+            if (descScore > bestScore) {
+                bestScore = descScore;
+                matchType = 'description';
+            }
+            // Category match
+            if (command.category) {
+                const catLabel = command_interface_1.CATEGORY_LABELS[command.category]?.toLowerCase() ?? '';
+                const catScore = this.fuzzyScore(normalizedQuery, catLabel) * 0.4;
+                if (catScore > bestScore) {
+                    bestScore = catScore;
+                    matchType = 'category';
+                }
+            }
+            if (bestScore > 0.3) {
+                results.push({ command, matchType, score: bestScore });
+            }
+        }
+        return results.sort((a, b) => b.score - a.score);
+    }
+    // -------------------------------------------------------------------------
+    // Markdown Output
+    // -------------------------------------------------------------------------
+    /**
+     * Generate the main help as Markdown.
+     */
+    generateMarkdownMainHelp() {
+        const lines = [];
+        lines.push(`# ${this.programName} CLI`);
+        lines.push('');
+        lines.push('## Usage');
+        lines.push('');
+        lines.push('```');
+        lines.push(`${this.programName} <command> [options]`);
+        lines.push('```');
+        lines.push('');
+        const grouped = this.registry.grouped();
+        const categories = Array.from(grouped.keys()).sort();
+        for (const category of categories) {
+            const commands = grouped.get(category);
+            if (!commands || commands.length === 0)
+                continue;
+            const visible = commands.filter(cmd => !cmd.hidden && !cmd.name.includes(':'));
+            if (visible.length === 0)
+                continue;
+            const label = category === 'uncategorized'
+                ? 'Other Commands'
+                : (command_interface_1.CATEGORY_LABELS[category] ?? category);
+            lines.push(`## ${label}`);
+            lines.push('');
+            lines.push('| Command | Description |');
+            lines.push('|---------|-------------|');
+            for (const cmd of visible) {
+                const aliases = cmd.aliases ? ` (${cmd.aliases.join(', ')})` : '';
+                lines.push(`| \`${cmd.name}\`${aliases} | ${cmd.description} |`);
+            }
+            lines.push('');
+        }
+        lines.push('## Global Options');
+        lines.push('');
+        lines.push('| Option | Description |');
+        lines.push('|--------|-------------|');
+        lines.push('| `--verbose` | Enable verbose logging |');
+        lines.push('| `--quiet` | Suppress output |');
+        lines.push('| `--json` | Output as JSON |');
+        lines.push('| `--no-color` | Disable colored output |');
+        lines.push('| `--dry-run` | Show what would be done |');
+        lines.push('| `--config <path>` | Specify config file |');
+        lines.push('');
+        return lines.join('\n');
+    }
+    /**
+     * Generate per-command help as Markdown.
+     */
+    generateMarkdownCommandHelp(command) {
+        const lines = [];
+        lines.push(`# ${command.name}`);
+        lines.push('');
+        lines.push(command.description);
+        lines.push('');
+        if (command.aliases && command.aliases.length > 0) {
+            lines.push(`**Aliases:** ${command.aliases.join(', ')}`);
+            lines.push('');
+        }
+        lines.push('## Usage');
+        lines.push('');
+        lines.push('```');
+        lines.push(this.buildUsageLine(command));
+        lines.push('```');
+        lines.push('');
+        if (command.arguments && command.arguments.length > 0) {
+            lines.push('## Arguments');
+            lines.push('');
+            lines.push('| Name | Description | Required | Default |');
+            lines.push('|------|-------------|----------|---------|');
+            for (const arg of command.arguments) {
+                lines.push(`| \`${arg.name}\` | ${arg.description} | ${arg.required ? 'Yes' : 'No'} | ${arg.defaultValue ?? '-'} |`);
+            }
+            lines.push('');
+        }
+        if (command.options && command.options.length > 0) {
+            lines.push('## Options');
+            lines.push('');
+            lines.push('| Flag | Description | Required | Default |');
+            lines.push('|------|-------------|----------|---------|');
+            for (const opt of command.options) {
+                const defaultVal = opt.defaultValue !== undefined ? String(opt.defaultValue) : '-';
+                lines.push(`| \`${opt.flags}\` | ${opt.description} | ${opt.required ? 'Yes' : 'No'} | ${defaultVal} |`);
+            }
+            lines.push('');
+        }
+        if (command.examples && command.examples.length > 0) {
+            lines.push('## Examples');
+            lines.push('');
+            for (const ex of command.examples) {
+                lines.push(`**${ex.description}:**`);
+                lines.push('```');
+                lines.push(ex.command);
+                lines.push('```');
+                lines.push('');
+            }
+        }
+        return lines.join('\n');
+    }
+    // -------------------------------------------------------------------------
+    // Private Helpers
+    // -------------------------------------------------------------------------
+    /**
+     * Build a usage line from command definition.
+     */
+    buildUsageLine(command) {
+        const parts = [this.programName, command.name];
+        if (command.arguments) {
+            for (const arg of command.arguments) {
+                if (arg.required) {
+                    parts.push(arg.variadic ? `<${arg.name}...>` : `<${arg.name}>`);
+                }
+                else {
+                    parts.push(arg.variadic ? `[${arg.name}...]` : `[${arg.name}]`);
+                }
+            }
+        }
+        if (command.options && command.options.length > 0) {
+            parts.push('[options]');
+        }
+        return parts.join(' ');
+    }
+    /**
+     * Simple fuzzy matching score between query and target.
+     * Returns 0-1 where 1 is an exact match.
+     */
+    fuzzyScore(query, target) {
+        if (query === target)
+            return 1;
+        if (target.startsWith(query))
+            return 0.9;
+        if (target.includes(query))
+            return 0.7;
+        // Character-by-character fuzzy
+        let qi = 0;
+        let ti = 0;
+        let matched = 0;
+        while (qi < query.length && ti < target.length) {
+            if (query[qi] === target[ti]) {
+                matched++;
+                qi++;
+            }
+            ti++;
+        }
+        if (qi < query.length)
+            return 0;
+        return matched / target.length;
+    }
+    // -------------------------------------------------------------------------
+    // Text formatting helpers
+    // -------------------------------------------------------------------------
+    heading(text) {
+        if (!this.useColor)
+            return text;
+        return chalk_1.default.cyan.bold(text);
+    }
+    sectionTitle(text) {
+        if (!this.useColor)
+            return `${text}:`;
+        return chalk_1.default.white.bold(`${text}:`);
+    }
+    highlight(text) {
+        if (!this.useColor)
+            return text;
+        return chalk_1.default.green(text);
+    }
+    dim(text) {
+        if (!this.useColor)
+            return text;
+        return chalk_1.default.gray(text);
+    }
+    warn(text) {
+        if (!this.useColor)
+            return text;
+        return chalk_1.default.yellow(text);
+    }
+}
+exports.HelpGenerator = HelpGenerator;
+//# sourceMappingURL=help-generator.js.map

package/dist/framework/help-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-generator.js","sourceRoot":"","sources":["../../src/framework/help-generator.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;AAEH,0DAA0B;AAG1B,2DAAsD;AAiCtD,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,MAAa,aAAa;IAOd;IANF,WAAW,CAAS;IACpB,QAAQ,CAAS;IACjB,QAAQ,CAAU;IAClB,MAAM,CAAoC;IAElD,YACU,QAAyB,EACjC,UAAgC,EAAE;QAD1B,aAAQ,GAAR,QAAQ,CAAiB;QAGjC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC;QAClD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;QACjE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC;QAC/D,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU,CAAC;IAC7C,CAAC;IAED,4EAA4E;IAC5E,YAAY;IACZ,4EAA4E;IAE5E;;OAEG;IACH,gBAAgB;QACd,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,wBAAwB,EAAE,CAAC;QACzC,CAAC;QAED,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,SAAS;QACT,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,aAAa,CAAC,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,QAAQ;QACR,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,WAAW,sBAAsB,CAAC,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,uBAAuB;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACxC,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAErD,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;YAClC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACvC,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAEjD,uBAAuB;YACvB,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAC7B,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAC9C,CAAC;YACF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAEnC,MAAM,KAAK,GACT,QAAQ,KAAK,eAAe;gBAC1B,CAAC,CAAC,gBAAgB;gBAClB,CAAC,CAAC,CAAC,mCAAe,CAAC,QAA2B,CAAC,IAAI,QAAQ,CAAC,CAAC;YAEjE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;YAErC,oCAAoC;YACpC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAC3B,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;gBACnB,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjE,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAC1C,CAAC,CAAC,CACH,CAAC;YAEF,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;gBAC1B,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjE,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;gBAC9D,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YACjE,CAAC;YAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,iBAAiB;QACjB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,SAAS;QACT,KAAK,CAAC,IAAI,CACR,IAAI,CAAC,GAAG,CACN,QAAQ,IAAI,CAAC,WAAW,oDAAoD,CAC7E,CACF,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,4EAA4E;IAC5E,eAAe;IACf,4EAA4E;IAE5E;;OAEG;IACH,mBAAmB,CAAC,OAA0B;QAC5C,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,SAAS;QACT,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,UAAU;QACV,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,QAAQ;QACR,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,YAAY;QACZ,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC;YAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAC1B,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAC7C,CAAC;YAEF,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;gBACpC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;gBACjD,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ;oBAC3B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;oBACzB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;gBAC3B,MAAM,UAAU,GAAG,GAAG,CAAC,YAAY;oBACjC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,YAAY,GAAG,CAAC;oBAC7C,CAAC,CAAC,EAAE,CAAC;gBACP,KAAK,CAAC,IAAI,CACR,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC,WAAW,IAAI,QAAQ,GAAG,UAAU,EAAE,CAC5E,CAAC;YACJ,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,UAAU;QACV,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC;YACzC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAC3B,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAC5C,CAAC;YAEF,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBAClC,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;gBACnD,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7D,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO;oBACzB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;oBACzC,CAAC,CAAC,EAAE,CAAC;gBACP,MAAM,UAAU,GACd,GAAG,CAAC,YAAY,KAAK,SAAS;oBAC5B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,YAAY,GAAG,CAAC;oBAC7C,CAAC,CAAC,EAAE,CAAC;gBACT,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnE,KAAK,CAAC,IAAI,CACR,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,EAAE,CAC9F,CAAC;YACJ,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,cAAc;QACd,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC;YAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAC1B,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAC/C,CAAC;YAEF,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;gBACtC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;gBACjD,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YACjE,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,WAAW;QACX,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC;YAC1C,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBAClC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;gBACrD,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;gBAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,4EAA4E;IAC5E,SAAS;IACT,4EAA4E;IAE5E;;OAEG;IACH,MAAM,CAAC,KAAa;QAClB,MAAM,eAAe,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAmB,EAAE,CAAC;QAEnC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;YAC3C,IAAI,OAAO,CAAC,MAAM;gBAAE,SAAS;YAE7B,IAAI,SAAS,GAAG,CAAC,CAAC;YAClB,IAAI,SAAS,GAA8B,MAAM,CAAC;YAElD,aAAa;YACb,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAC/B,eAAe,EACf,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAC3B,CAAC;YACF,IAAI,SAAS,GAAG,SAAS,EAAE,CAAC;gBAC1B,SAAS,GAAG,SAAS,CAAC;gBACtB,SAAS,GAAG,MAAM,CAAC;YACrB,CAAC;YAED,cAAc;YACd,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACpB,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;oBACpC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAChC,eAAe,EACf,KAAK,CAAC,WAAW,EAAE,CACpB,CAAC;oBACF,IAAI,UAAU,GAAG,SAAS,EAAE,CAAC;wBAC3B,SAAS,GAAG,UAAU,CAAC;wBACvB,SAAS,GAAG,OAAO,CAAC;oBACtB,CAAC;gBACH,CAAC;YACH,CAAC;YAED,oBAAoB;YACpB,MAAM,SAAS,GACb,IAAI,CAAC,UAAU,CAAC,eAAe,EAAE,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;gBACnE,GAAG,CAAC;YACN,IAAI,SAAS,GAAG,SAAS,EAAE,CAAC;gBAC1B,SAAS,GAAG,SAAS,CAAC;gBACtB,SAAS,GAAG,aAAa,CAAC;YAC5B,CAAC;YAED,iBAAiB;YACjB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACrB,MAAM,QAAQ,GAAG,mCAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;gBACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,eAAe,EAAE,QAAQ,CAAC,GAAG,GAAG,CAAC;gBAClE,IAAI,QAAQ,GAAG,SAAS,EAAE,CAAC;oBACzB,SAAS,GAAG,QAAQ,CAAC;oBACrB,SAAS,GAAG,UAAU,CAAC;gBACzB,CAAC;YACH,CAAC;YAED,IAAI,SAAS,GAAG,GAAG,EAAE,CAAC;gBACpB,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC;IAED,4EAA4E;IAC5E,kBAAkB;IAClB,4EAA4E;IAE5E;;OAEG;IACK,wBAAwB;QAC9B,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,WAAW,MAAM,CAAC,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,WAAW,sBAAsB,CAAC,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACxC,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAErD,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;YAClC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACvC,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAEjD,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAC7B,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAC9C,CAAC;YACF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAEnC,MAAM,KAAK,GACT,QAAQ,KAAK,eAAe;gBAC1B,CAAC,CAAC,gBAAgB;gBAClB,CAAC,CAAC,CAAC,mCAAe,CAAC,QAA2B,CAAC,IAAI,QAAQ,CAAC,CAAC;YAEjE,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;YAExC,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;gBAC1B,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClE,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,KAAK,OAAO,MAAM,GAAG,CAAC,WAAW,IAAI,CAAC,CAAC;YACnE,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,2BAA2B,CAAC,OAA0B;QAC5D,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,gBAAgB,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtD,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;YAC1D,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;YAC1D,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;gBACpC,KAAK,CAAC,IAAI,CACR,OAAO,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC,WAAW,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,GAAG,CAAC,YAAY,IAAI,GAAG,IAAI,CACzG,CAAC;YACJ,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;YAC1D,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;YAC1D,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBAClC,MAAM,UAAU,GACd,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;gBAClE,KAAK,CAAC,IAAI,CACR,OAAO,GAAG,CAAC,KAAK,QAAQ,GAAG,CAAC,WAAW,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,UAAU,IAAI,CAC7F,CAAC;YACJ,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBAClC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,WAAW,KAAK,CAAC,CAAC;gBACrC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;gBACvB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,4EAA4E;IAC5E,kBAAkB;IAClB,4EAA4E;IAE5E;;OAEG;IACK,cAAc,CAAC,OAA0B;QAC/C,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAE/C,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;gBACpC,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;oBACjB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;gBAClE,CAAC;qBAAM,CAAC;oBACN,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;gBAClE,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC1B,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED;;;OAGG;IACK,UAAU,CAAC,KAAa,EAAE,MAAc;QAC9C,IAAI,KAAK,KAAK,MAAM;YAAE,OAAO,CAAC,CAAC;QAC/B,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC;QACzC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC;QAEvC,+BAA+B;QAC/B,IAAI,EAAE,GAAG,CAAC,CAAC;QACX,IAAI,EAAE,GAAG,CAAC,CAAC;QACX,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,IAAI,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YAC/C,IAAI,KAAK,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC7B,OAAO,EAAE,CAAC;gBACV,EAAE,EAAE,CAAC;YACP,CAAC;YACD,EAAE,EAAE,CAAC;QACP,CAAC;QAED,IAAI,EAAE,GAAG,KAAK,CAAC,MAAM;YAAE,OAAO,CAAC,CAAC;QAChC,OAAO,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;IACjC,CAAC;IAED,4EAA4E;IAC5E,0BAA0B;IAC1B,4EAA4E;IAEpE,OAAO,CAAC,IAAY;QAC1B,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAChC,OAAO,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAEO,YAAY,CAAC,IAAY;QAC/B,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,GAAG,IAAI,GAAG,CAAC;QACtC,OAAO,eAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;IACtC,CAAC;IAEO,SAAS,CAAC,IAAY;QAC5B,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAChC,OAAO,eAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAEO,GAAG,CAAC,IAAY;QACtB,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAChC,OAAO,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAEO,IAAI,CAAC,IAAY;QACvB,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAChC,OAAO,eAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;CACF;AAteD,sCAseC"}

package/dist/framework/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Wundr CLI Framework - Public API
+ *
+ * This module provides the core framework for building CLI commands:
+ *
+ * - **CommandDefinition**: The interface every command implements
+ * - **CommandRegistry**: Auto-discovery and Commander.js integration
+ * - **OutputFormatter**: Consistent table, JSON, YAML, status, progress output
+ * - **CliErrorHandler**: Typed errors with classification and recovery
+ * - **InteractiveRepl**: REPL loop with history, aliases, and tab completion
+ * - **HelpGenerator**: Structured help text from command metadata
+ * - **CompletionExporter**: Shell completion script generation
+ * - **DebugLogger**: Verbose/debug logging with TTY detection
+ * - **ProgressBar / StepTracker**: Progress tracking for long operations
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   CommandDefinition,
+ *   CommandRegistry,
+ *   OutputFormatter,
+ *   CliErrorHandler,
+ *   InteractiveRepl,
+ *   HelpGenerator,
+ *   CompletionExporter,
+ *   DebugLogger,
+ *   ProgressBar,
+ *   StepTracker,
+ *   commandSuccess,
+ *   commandFailure,
+ *   validationOk,
+ *   validationFail,
+ * } from './framework';
+ *
+ * const myCommand: CommandDefinition = {
+ *   name: 'status',
+ *   description: 'Show system status',
+ *   category: 'daemon',
+ *   async execute(args, options, context) {
+ *     const data = await getStatus();
+ *     const formatter = new OutputFormatter();
+ *     const message = formatter.keyValue(data);
+ *     return commandSuccess(data, message);
+ *   },
+ * };
+ *
+ * const registry = new CommandRegistry();
+ * registry.register(myCommand);
+ * ```
+ *
+ * @module framework
+ */
+export { type CommandDefinition, type CommandModule, type CommandHook, type ArgumentDefinition, type OptionDefinition, type CommandExample, type CommandCategory, CATEGORY_LABELS, type ValidationResult, type ValidationError, validationOk, validationFail, type CommandContext, type GlobalOptions, type ContextLogger, type OutputFormatterInterface, type ConfigManagerInterface, type CommandResult, commandSuccess, commandFailure, wrapLegacyCommand, } from './command-interface';
+export { CommandRegistry, type RegistryOptions, type RegisteredCommand, } from './command-registry';
+export { OutputFormatter, type TableOptions, type ColumnDefinition, type JsonOptions, type KeyValueOptions, type ListOptions, type TreeNode, type TreeOptions, type ProgressOptions, type StatusState, } from './output-formatter';
+export { CliErrorHandler, CliError, type ErrorCode, type ErrorDetails, type RecoverySuggestion, type ErrorRecoveryHandler, type ErrorClassification, type ClassifiedError, classifyError, classifyAnyError, } from './error-handler';
+export { InteractiveRepl, type ReplOptions, type HistoryEntry, } from './interactive-repl';
+export { HelpGenerator, type HelpGeneratorOptions, type SearchResult, } from './help-generator';
+export { CompletionExporter, type ShellType, type CompletionData, type CompletionCommand, type CompletionArgument, type CompletionOption, } from './completion-exporter';
+export { DebugLogger, TaggedLogger, type LogLevel, type LogEntry, type DebugLoggerOptions, } from './debug-logger';
+export { ProgressBar, MultiProgressManager, StepTracker, type ProgressBarOptions, type ProgressState, type ProgressStep, type StepTrackerOptions, } from './progress-manager';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/framework/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAGH,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,WAAW,EAGhB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EAGnB,KAAK,eAAe,EACpB,eAAe,EAGf,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,YAAY,EACZ,cAAc,EAGd,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAG3B,KAAK,aAAa,EAClB,cAAc,EACd,cAAc,EAGd,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,eAAe,EACf,QAAQ,EACR,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,aAAa,EACb,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,YAAY,GAClB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,kBAAkB,EAClB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,WAAW,EACX,YAAY,EACZ,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAC"}