@ginkoai/cli 1.0.0

package/dist/core/simple-pipeline.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @fileType: utility
+ * @status: experimental
+ * @updated: 2025-01-15
+ * @tags: [pipeline, simple, developer-friendly]
+ * @related: [reflection-pattern.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: []
+ */
+/**
+ * SIMPLIFIED PIPELINE PATTERN
+ * Optimized for developer experience and IDE support
+ */
+interface PipelineContext {
+    intent: string;
+    domain?: string;
+    template?: any;
+    context?: any;
+    output?: string;
+    errors: string[];
+    confidence: number;
+}
+/**
+ * Simple, IDE-friendly pipeline for developers
+ * - Full autocomplete support
+ * - Clear method names
+ * - Progressive disclosure of complexity
+ */
+export declare class ReflectionPipeline {
+    protected ctx: PipelineContext;
+    constructor(intent: string);
+    withDomain(domain: string): this;
+    withTemplate(template: any): this;
+    withContext(context: any): this;
+    validate(): this;
+    transform(fn: (ctx: PipelineContext) => PipelineContext): this;
+    generate(): this;
+    execute(): Promise<PipelineContext>;
+    getConfidence(): number;
+    getErrors(): string[];
+    recover(): this;
+}
+export {};
+/**
+ * Complexity Comparison:
+ *
+ * Original Hybrid:
+ * - Learning curve: 8/10 (Result types, monads)
+ * - IDE support: 4/10 (generics confuse autocomplete)
+ * - Power: 10/10 (full railway programming)
+ *
+ * This Simple Version:
+ * - Learning curve: 2/10 (just method chaining)
+ * - IDE support: 10/10 (perfect autocomplete)
+ * - Power: 7/10 (covers 90% of use cases)
+ *
+ * Winner for Developer Experience: Simple Version
+ */
+/**
+ * IDE Features that Work Perfectly:
+ * ✅ Method autocomplete
+ * ✅ Parameter hints
+ * ✅ Type checking
+ * ✅ JSDoc tooltips
+ * ✅ Go to definition
+ * ✅ Refactoring support
+ * ✅ Error squiggles
+ */ 
+//# sourceMappingURL=simple-pipeline.d.ts.map

package/dist/core/simple-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-pipeline.d.ts","sourceRoot":"","sources":["../../src/core/simple-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AAMH,UAAU,eAAe;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,SAAS,CAAC,GAAG,EAAE,eAAe,CAAC;gBAEnB,MAAM,EAAE,MAAM;IAS1B,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAMhC,YAAY,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI;IAMjC,WAAW,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAO/B,QAAQ,IAAI,IAAI;IAqBhB,SAAS,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,eAAe,GAAG,IAAI;IAY9D,QAAQ,IAAI,IAAI;IAYV,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC;IAazC,aAAa,IAAI,MAAM;IAIvB,SAAS,IAAI,MAAM,EAAE;IAKrB,OAAO,IAAI,IAAI;CAqBhB;;AAyHD;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;GASG"}

package/dist/core/simple-pipeline.js

@@ -0,0 +1,241 @@
+/**
+ * @fileType: utility
+ * @status: experimental
+ * @updated: 2025-01-15
+ * @tags: [pipeline, simple, developer-friendly]
+ * @related: [reflection-pattern.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: []
+ */
+/**
+ * Simple, IDE-friendly pipeline for developers
+ * - Full autocomplete support
+ * - Clear method names
+ * - Progressive disclosure of complexity
+ */
+export class ReflectionPipeline {
+    ctx;
+    constructor(intent) {
+        this.ctx = {
+            intent,
+            errors: [],
+            confidence: 1.0
+        };
+    }
+    // Chainable configuration methods (IDE autocompletes these!)
+    withDomain(domain) {
+        this.ctx.domain = domain;
+        console.log(`📁 Domain: ${domain}`);
+        return this;
+    }
+    withTemplate(template) {
+        this.ctx.template = template;
+        console.log(`📄 Template loaded`);
+        return this;
+    }
+    withContext(context) {
+        this.ctx.context = context;
+        console.log(`📊 Context added`);
+        return this;
+    }
+    // Validation with clear feedback
+    validate() {
+        if (!this.ctx.domain) {
+            this.ctx.errors.push('Domain is required');
+            this.ctx.confidence *= 0.5;
+        }
+        if (!this.ctx.template) {
+            this.ctx.errors.push('Template is required');
+            this.ctx.confidence *= 0.7;
+        }
+        if (this.ctx.errors.length === 0) {
+            console.log('✅ Validation passed');
+        }
+        else {
+            console.log(`⚠️ Validation issues: ${this.ctx.errors.join(', ')}`);
+        }
+        return this;
+    }
+    // Transform operations
+    transform(fn) {
+        try {
+            this.ctx = fn(this.ctx);
+            console.log('🔄 Transform applied');
+        }
+        catch (error) {
+            this.ctx.errors.push(`Transform failed: ${error}`);
+            this.ctx.confidence *= 0.3;
+        }
+        return this;
+    }
+    // Generate output
+    generate() {
+        if (this.ctx.errors.length > 0) {
+            console.log('⚠️ Skipping generation due to errors');
+            return this;
+        }
+        this.ctx.output = `Generated ${this.ctx.domain} for: ${this.ctx.intent}`;
+        console.log('✨ Content generated');
+        return this;
+    }
+    // Terminal operations
+    async execute() {
+        if (this.ctx.confidence < 0.6) {
+            console.warn(`⚠️ Low confidence: ${(this.ctx.confidence * 100).toFixed(0)}%`);
+        }
+        if (this.ctx.errors.length > 0 && this.ctx.confidence < 0.3) {
+            throw new Error(`Pipeline failed: ${this.ctx.errors.join(', ')}`);
+        }
+        return this.ctx;
+    }
+    // Utility methods for inspection
+    getConfidence() {
+        return this.ctx.confidence;
+    }
+    getErrors() {
+        return this.ctx.errors;
+    }
+    // Recovery method
+    recover() {
+        if (this.ctx.errors.length > 0) {
+            console.log('🔧 Attempting recovery...');
+            // Auto-fix common issues
+            if (!this.ctx.domain && this.ctx.intent.includes('handoff')) {
+                this.ctx.domain = 'handoff';
+                this.ctx.errors = this.ctx.errors.filter(e => !e.includes('Domain'));
+                console.log('  → Auto-detected domain: handoff');
+            }
+            if (!this.ctx.template) {
+                this.ctx.template = { default: true };
+                this.ctx.errors = this.ctx.errors.filter(e => !e.includes('Template'));
+                console.log('  → Using default template');
+            }
+            this.ctx.confidence = 0.7; // Reset to moderate confidence
+        }
+        return this;
+    }
+}
+// ==================================================
+// USAGE EXAMPLES
+// ==================================================
+// Example 1: Simple usage
+async function example1() {
+    const result = await new ReflectionPipeline('Create handoff')
+        .withDomain('handoff')
+        .withTemplate({ sections: ['summary', 'context'] })
+        .validate()
+        .generate()
+        .execute();
+    console.log('Result:', result);
+}
+// Example 2: With error recovery
+async function example2() {
+    const result = await new ReflectionPipeline('Start session')
+        // Oops, forgot domain!
+        .validate() // Will flag error
+        .recover() // Auto-fixes if possible
+        .generate()
+        .execute();
+    console.log('Confidence:', result.confidence);
+}
+// Example 3: Custom transform
+async function example3() {
+    const result = await new ReflectionPipeline('Complex task')
+        .withDomain('prd')
+        .transform(ctx => ({
+        ...ctx,
+        template: {
+            ...ctx.template,
+            enhanced: true,
+            timestamp: Date.now()
+        }
+    }))
+        .validate()
+        .generate()
+        .execute();
+}
+// ==================================================
+// DEVELOPER EXTENSION EXAMPLE
+// ==================================================
+/**
+ * Developers can easily extend for their domains
+ */
+class CustomPRDPipeline extends ReflectionPipeline {
+    constructor(intent) {
+        super(intent);
+        this.withDomain('prd'); // Auto-set domain
+    }
+    // Add domain-specific methods
+    withUserStories(stories) {
+        return this.withContext({ userStories: stories });
+    }
+    withPainPoints(points) {
+        return this.withContext({
+            ...this.ctx.context,
+            painPoints: points
+        });
+    }
+    // Override generate with PRD-specific logic
+    generate() {
+        super.generate();
+        if (this.ctx.output) {
+            this.ctx.output = `# PRD: ${this.ctx.intent}\n\n${this.ctx.output}`;
+        }
+        return this;
+    }
+}
+// Clean usage:
+async function customExample() {
+    const prd = await new CustomPRDPipeline('User authentication')
+        .withUserStories(['As a user, I want to log in'])
+        .withPainPoints(['Current auth is slow'])
+        .withTemplate({ format: 'detailed' })
+        .validate()
+        .generate()
+        .execute();
+}
+// ==================================================
+// TYPE SAFETY & IDE SUPPORT
+// ==================================================
+// TypeScript gives us full autocomplete:
+function ideDemo() {
+    const pipeline = new ReflectionPipeline('test');
+    // IDE will suggest all these methods:
+    pipeline
+        .withDomain('') // <- autocomplete works!
+        .withTemplate({}) // <- type checking works!
+        .validate() // <- method chaining tracked!
+        .recover() // <- all methods visible!
+        .generate()
+        .execute(); // <- return type known!
+}
+// ==================================================
+// COMPARISON WITH ORIGINAL HYBRID
+// ==================================================
+/**
+ * Complexity Comparison:
+ *
+ * Original Hybrid:
+ * - Learning curve: 8/10 (Result types, monads)
+ * - IDE support: 4/10 (generics confuse autocomplete)
+ * - Power: 10/10 (full railway programming)
+ *
+ * This Simple Version:
+ * - Learning curve: 2/10 (just method chaining)
+ * - IDE support: 10/10 (perfect autocomplete)
+ * - Power: 7/10 (covers 90% of use cases)
+ *
+ * Winner for Developer Experience: Simple Version
+ */
+/**
+ * IDE Features that Work Perfectly:
+ * ✅ Method autocomplete
+ * ✅ Parameter hints
+ * ✅ Type checking
+ * ✅ JSDoc tooltips
+ * ✅ Go to definition
+ * ✅ Refactoring support
+ * ✅ Error squiggles
+ */ 
+//# sourceMappingURL=simple-pipeline.js.map

package/dist/core/simple-pipeline.js.map

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

package/dist/core/utils/paths.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-10-04
+ * @tags: [paths, utilities, ginko]
+ * @related: [../../utils/ginko-root.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: [path, child_process]
+ */
+export interface PathConfig {
+    project: {
+        root: string;
+        worktrees: string;
+        packages: string;
+    };
+    ginko: {
+        root: string;
+        context: string;
+        sessions: string;
+        backlog: string;
+    };
+    docs: {
+        root: string;
+        adr: string;
+        prd: string;
+        sprints: string;
+    };
+}
+/**
+ * Get path configuration
+ */
+export declare function getConfig(): PathConfig;
+/**
+ * Join paths with platform-appropriate separators
+ */
+export declare function joinPaths(...segments: string[]): string;
+/**
+ * Get relative path from project root
+ */
+export declare function getRelativePath(absolutePath: string): string;
+/**
+ * Path manager singleton
+ */
+export declare const pathManager: {
+    getConfig: typeof getConfig;
+    joinPaths: typeof joinPaths;
+    getRelativePath: typeof getRelativePath;
+};
+//# sourceMappingURL=paths.d.ts.map

package/dist/core/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/core/utils/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAiBD;;GAEG;AACH,wBAAgB,SAAS,IAAI,UAAU,CAuBtC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAEvD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;;;;CAIvB,CAAC"}

package/dist/core/utils/paths.js

@@ -0,0 +1,75 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-10-04
+ * @tags: [paths, utilities, ginko]
+ * @related: [../../utils/ginko-root.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: [path, child_process]
+ */
+import path from 'path';
+import { execSync } from 'child_process';
+/**
+ * Get project root by finding git repository root
+ */
+function getProjectRoot() {
+    try {
+        const gitRoot = execSync('git rev-parse --show-toplevel', {
+            encoding: 'utf8',
+            cwd: process.cwd()
+        }).trim();
+        return path.resolve(gitRoot);
+    }
+    catch (error) {
+        return process.cwd();
+    }
+}
+/**
+ * Get path configuration
+ */
+export function getConfig() {
+    const projectRoot = getProjectRoot();
+    const projectName = path.basename(projectRoot);
+    return {
+        project: {
+            root: projectRoot,
+            worktrees: path.join(path.dirname(projectRoot), `${projectName}-worktrees`),
+            packages: path.join(projectRoot, 'packages')
+        },
+        ginko: {
+            root: path.join(projectRoot, '.ginko'),
+            context: path.join(projectRoot, '.ginko', 'context'),
+            sessions: path.join(projectRoot, '.ginko', 'sessions'),
+            backlog: path.join(projectRoot, '.ginko', 'backlog')
+        },
+        docs: {
+            root: path.join(projectRoot, 'docs'),
+            adr: path.join(projectRoot, 'docs', 'adr'),
+            prd: path.join(projectRoot, 'docs', 'PRD'),
+            sprints: path.join(projectRoot, 'docs', 'sprints')
+        }
+    };
+}
+/**
+ * Join paths with platform-appropriate separators
+ */
+export function joinPaths(...segments) {
+    return path.join(...segments);
+}
+/**
+ * Get relative path from project root
+ */
+export function getRelativePath(absolutePath) {
+    const projectRoot = getProjectRoot();
+    return path.relative(projectRoot, absolutePath);
+}
+/**
+ * Path manager singleton
+ */
+export const pathManager = {
+    getConfig,
+    joinPaths,
+    getRelativePath
+};
+//# sourceMappingURL=paths.js.map

package/dist/core/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/core/utils/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAsBzC;;GAEG;AACH,SAAS,cAAc;IACrB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,QAAQ,CAAC,+BAA+B,EAAE;YACxD,QAAQ,EAAE,MAAM;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;SACnB,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAE/C,OAAO;QACL,OAAO,EAAE;YACP,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,GAAG,WAAW,YAAY,CAAC;YAC3E,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;SAC7C;QACD,KAAK,EAAE;YACL,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC;YACtC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAC;YACpD,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,CAAC;YACtD,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAC;SACrD;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC;YACpC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC;YAC1C,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC;YAC1C,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC;SACnD;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,GAAG,QAAkB;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,YAAoB;IAClD,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,SAAS;IACT,SAAS;IACT,eAAe;CAChB,CAAC"}

package/dist/core/validators/command-argument-validator.d.ts

@@ -0,0 +1,102 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-22
+ * @tags: [validation, command-arguments, cli, middleware, security]
+ * @related: [input-validator.ts, command-validator.ts, index.ts]
+ * @priority: critical
+ * @complexity: medium
+ * @dependencies: [commander]
+ */
+import { Command } from 'commander';
+import { InputValidationSchema } from './input-validator.js';
+import { ValidationResult, Validator } from './git-validator.js';
+/**
+ * Command argument configuration for validation
+ */
+export interface CommandArgumentConfig {
+    name: string;
+    description: string;
+    required?: boolean;
+    defaultValue?: any;
+    validation?: InputValidationSchema;
+    aliases?: string[];
+    choices?: string[];
+}
+/**
+ * Command validation configuration
+ */
+export interface CommandValidationConfig {
+    name: string;
+    description: string;
+    arguments?: CommandArgumentConfig[];
+    options?: CommandArgumentConfig[];
+    subcommands?: CommandValidationConfig[];
+    customValidation?: (args: any, options: any) => Promise<ValidationResult>;
+    requiresGit?: boolean;
+    requiresConfig?: boolean;
+    requiresNetwork?: boolean;
+}
+/**
+ * Parsed and validated command data
+ */
+export interface ValidatedCommandData {
+    command: string;
+    arguments: Record<string, any>;
+    options: Record<string, any>;
+    rawArgs: string[];
+    valid: boolean;
+    errors?: string[];
+    suggestions?: string[];
+}
+/**
+ * Command argument validator that provides type-safe validation for CLI commands
+ * Integrates with Commander.js to provide comprehensive argument validation
+ */
+export declare class CommandArgumentValidator implements Validator {
+    private inputValidator;
+    private lastError?;
+    private lastSuggestions;
+    private commandConfigs;
+    constructor();
+    /**
+     * Register a command configuration for validation
+     */
+    registerCommand(config: CommandValidationConfig): void;
+    /**
+     * Validate command arguments and options
+     */
+    validateCommand(commandName: string, args: string[], options: Record<string, any>): Promise<ValidatedCommandData>;
+    /**
+     * Validate command arguments against configuration
+     */
+    private validateArguments;
+    /**
+     * Validate command options against configuration
+     */
+    private validateOptions;
+    /**
+     * Create a Commander.js command with built-in validation
+     */
+    createValidatedCommand(config: CommandValidationConfig): Command;
+    /**
+     * Register built-in ginko commands with validation
+     */
+    private registerBuiltinCommands;
+    /**
+     * Validate common CLI patterns
+     */
+    static validateCommonPatterns(value: string, pattern: 'email' | 'url' | 'semver' | 'uuid'): boolean;
+    validate(): Promise<ValidationResult>;
+    getErrorMessage(): string;
+    getSuggestions(): string[];
+    /**
+     * Get all registered command configurations
+     */
+    getRegisteredCommands(): CommandValidationConfig[];
+    /**
+     * Get command configuration by name
+     */
+    getCommandConfig(name: string): CommandValidationConfig | undefined;
+}
+//# sourceMappingURL=command-argument-validator.d.ts.map

package/dist/core/validators/command-argument-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-argument-validator.d.ts","sourceRoot":"","sources":["../../../src/core/validators/command-argument-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAkB,qBAAqB,EAAyB,MAAM,sBAAsB,CAAC;AACpG,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACpC,OAAO,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAClC,WAAW,CAAC,EAAE,uBAAuB,EAAE,CAAC;IACxC,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC1E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,wBAAyB,YAAW,SAAS;IACxD,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,cAAc,CAAmD;;IAOzE;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI;IAItD;;OAEG;IACG,eAAe,CACnB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC3B,OAAO,CAAC,oBAAoB,CAAC;IAmFhC;;OAEG;YACW,iBAAiB;IA0C/B;;OAEG;YACW,eAAe;IA+B7B;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO;IA+DhE;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAkH/B;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO;IAW7F,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAK3C,eAAe,IAAI,MAAM;IAIzB,cAAc,IAAI,MAAM,EAAE;IAI1B;;OAEG;IACH,qBAAqB,IAAI,uBAAuB,EAAE;IAIlD;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS;CAGpE"}