@ginkoai/cli 1.0.0

package/dist/core/config/project-detector.js

@@ -0,0 +1,310 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-20
+ * @tags: [project, detection, existing, integration, paths]
+ * @related: [config-loader.ts, init.ts, config.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [fs-extra, path, glob]
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { glob } from 'glob';
+/**
+ * Detects existing project structure and recommends configuration
+ */
+export class ProjectDetector {
+    /**
+     * Analyze existing project structure
+     */
+    async analyzeProject(projectRoot = process.cwd()) {
+        const hasDocsFolder = await fs.pathExists(path.join(projectRoot, 'docs'));
+        const hasExistingAdr = await this.hasExistingDocuments(projectRoot, 'adr');
+        const hasExistingPrd = await this.hasExistingDocuments(projectRoot, 'prd');
+        const existingPaths = await this.findExistingDocumentPaths(projectRoot);
+        const recommendedConfig = await this.generateRecommendedConfig(projectRoot, {
+            hasDocsFolder,
+            hasExistingAdr,
+            hasExistingPrd,
+            existingPaths
+        });
+        return {
+            hasDocsFolder,
+            hasExistingAdr,
+            hasExistingPrd,
+            existingPaths,
+            recommendedConfig
+        };
+    }
+    /**
+     * Generate configuration options for interactive setup
+     */
+    async generateConfigOptions(projectRoot = process.cwd()) {
+        const analysis = await this.analyzeProject(projectRoot);
+        const options = [];
+        if (analysis.hasDocsFolder) {
+            // Option 1: Use existing docs structure
+            options.push({
+                name: 'Use existing docs/ folder structure (recommended)',
+                value: 'existing-docs',
+                description: 'Works with your current documentation layout'
+            });
+            // Option 2: Create ginko subdirectory
+            options.push({
+                name: 'Create docs/ginko/ subdirectory (safe)',
+                value: {
+                    paths: {
+                        docs: {
+                            root: 'docs/ginko',
+                            adr: '${docs.root}/adr',
+                            prd: '${docs.root}/PRD',
+                            sprints: '${docs.root}/sprints'
+                        }
+                    }
+                },
+                description: 'Avoids conflicts with existing documentation'
+            });
+        }
+        else {
+            // Option 1: Standard docs layout
+            options.push({
+                name: 'Create standard docs/ structure (recommended)',
+                value: 'standard-docs',
+                description: 'Creates docs/adr, docs/PRD, docs/sprints'
+            });
+        }
+        // Option 3: Custom paths
+        options.push({
+            name: 'Custom paths...',
+            value: 'custom',
+            description: 'Configure custom documentation paths'
+        });
+        // Option 4: Minimal setup
+        options.push({
+            name: 'Minimal setup (no documentation paths)',
+            value: {
+                features: {
+                    autoCapture: true,
+                    gitIntegration: true,
+                    aiEnhancement: true,
+                    documentNaming: false
+                }
+            },
+            description: 'Only session and context tracking'
+        });
+        return options;
+    }
+    /**
+     * Check for existing document types
+     */
+    async hasExistingDocuments(projectRoot, type) {
+        const patterns = this.getDocumentPatterns(type);
+        for (const pattern of patterns) {
+            const files = await glob(pattern, { cwd: projectRoot, ignore: ['node_modules/**'] });
+            if (files.length > 0) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Find all existing document paths
+     */
+    async findExistingDocumentPaths(projectRoot) {
+        const paths = [];
+        const commonPaths = [
+            'docs', 'documentation', 'doc',
+            'adr', 'adrs', 'architecture', 'decisions',
+            'prd', 'requirements', 'specs', 'specifications',
+            'sprints', 'iterations', 'planning'
+        ];
+        for (const pathName of commonPaths) {
+            const fullPath = path.join(projectRoot, pathName);
+            if (await fs.pathExists(fullPath)) {
+                const stat = await fs.stat(fullPath);
+                if (stat.isDirectory()) {
+                    paths.push(pathName);
+                }
+            }
+        }
+        return paths;
+    }
+    /**
+     * Get file patterns for document types
+     */
+    getDocumentPatterns(type) {
+        switch (type.toLowerCase()) {
+            case 'adr':
+                return [
+                    '**/adr/**/*.md',
+                    '**/adrs/**/*.md',
+                    '**/architecture/**/*.md',
+                    '**/decisions/**/*.md',
+                    '**/*adr*.md',
+                    '**/*decision*.md'
+                ];
+            case 'prd':
+                return [
+                    '**/prd/**/*.md',
+                    '**/prds/**/*.md',
+                    '**/requirements/**/*.md',
+                    '**/specs/**/*.md',
+                    '**/*prd*.md',
+                    '**/*requirement*.md',
+                    '**/*spec*.md'
+                ];
+            case 'sprint':
+                return [
+                    '**/sprints/**/*.md',
+                    '**/sprint/**/*.md',
+                    '**/iterations/**/*.md',
+                    '**/planning/**/*.md',
+                    '**/*sprint*.md',
+                    '**/*iteration*.md'
+                ];
+            default:
+                return [];
+        }
+    }
+    /**
+     * Generate recommended configuration based on analysis
+     */
+    async generateRecommendedConfig(projectRoot, analysis) {
+        const config = {
+            version: "1.0.0",
+            features: {
+                autoCapture: true,
+                gitIntegration: true,
+                aiEnhancement: true,
+                documentNaming: true,
+                crossPlatform: true
+            }
+        };
+        // Configure paths based on existing structure
+        if (analysis.hasDocsFolder) {
+            // Use existing docs folder
+            config.paths = {
+                docs: {
+                    root: 'docs',
+                    adr: analysis.hasExistingAdr ? await this.findBestAdrPath(projectRoot) : '${docs.root}/adr',
+                    prd: analysis.hasExistingPrd ? await this.findBestPrdPath(projectRoot) : '${docs.root}/PRD',
+                    sprints: '${docs.root}/sprints'
+                },
+                ginko: {
+                    root: '.ginko',
+                    context: '${ginko.root}/context',
+                    sessions: '${ginko.root}/sessions',
+                    backlog: '${ginko.root}/backlog',
+                    patterns: '${ginko.root}/patterns',
+                    bestPractices: '${ginko.root}/best-practices'
+                }
+            };
+        }
+        else {
+            // Standard setup
+            config.paths = {
+                docs: {
+                    root: 'docs',
+                    adr: '${docs.root}/adr',
+                    prd: '${docs.root}/PRD',
+                    sprints: '${docs.root}/sprints'
+                },
+                ginko: {
+                    root: '.ginko',
+                    context: '${ginko.root}/context',
+                    sessions: '${ginko.root}/sessions',
+                    backlog: '${ginko.root}/backlog',
+                    patterns: '${ginko.root}/patterns',
+                    bestPractices: '${ginko.root}/best-practices'
+                }
+            };
+        }
+        return config;
+    }
+    /**
+     * Find the best existing ADR path
+     */
+    async findBestAdrPath(projectRoot) {
+        const possiblePaths = [
+            'docs/adr',
+            'docs/adrs',
+            'docs/architecture',
+            'docs/decisions',
+            'adr',
+            'adrs',
+            'architecture/decisions'
+        ];
+        for (const pathStr of possiblePaths) {
+            const fullPath = path.join(projectRoot, pathStr);
+            if (await fs.pathExists(fullPath)) {
+                const files = await glob('**/*.md', { cwd: fullPath });
+                if (files.length > 0) {
+                    return pathStr;
+                }
+            }
+        }
+        return '${docs.root}/adr'; // Default
+    }
+    /**
+     * Find the best existing PRD path
+     */
+    async findBestPrdPath(projectRoot) {
+        const possiblePaths = [
+            'docs/PRD',
+            'docs/prd',
+            'docs/requirements',
+            'docs/specs',
+            'requirements',
+            'specs',
+            'specifications'
+        ];
+        for (const pathStr of possiblePaths) {
+            const fullPath = path.join(projectRoot, pathStr);
+            if (await fs.pathExists(fullPath)) {
+                const files = await glob('**/*.md', { cwd: fullPath });
+                if (files.length > 0) {
+                    return pathStr;
+                }
+            }
+        }
+        return '${docs.root}/PRD'; // Default
+    }
+    /**
+     * Validate that a project can support ginko integration
+     */
+    async validateProjectCompatibility(projectRoot = process.cwd()) {
+        const issues = [];
+        const recommendations = [];
+        // Check if it's a git repository
+        const gitDir = path.join(projectRoot, '.git');
+        if (!await fs.pathExists(gitDir)) {
+            issues.push('Not a git repository');
+            recommendations.push('Run: git init');
+        }
+        // Check for existing .ginko directory
+        const ginkoDir = path.join(projectRoot, '.ginko');
+        if (await fs.pathExists(ginkoDir)) {
+            issues.push('Ginko already initialized');
+            recommendations.push('Use ginko config to modify settings');
+        }
+        // Check write permissions
+        try {
+            const testFile = path.join(projectRoot, '.ginko-test');
+            await fs.writeFile(testFile, 'test');
+            await fs.remove(testFile);
+        }
+        catch (error) {
+            issues.push('No write permissions to project directory');
+            recommendations.push('Check directory permissions');
+        }
+        return {
+            compatible: issues.length === 0,
+            issues,
+            recommendations
+        };
+    }
+}
+// Export singleton instance
+export const projectDetector = new ProjectDetector();
+//# sourceMappingURL=project-detector.js.map

package/dist/core/config/project-detector.js.map

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

package/dist/core/config-backup/config-aware-reflection.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-21
+ * @tags: [reflection, config-aware, paths, documents, base-class]
+ * @related: [reflection-pattern.ts, config-loader.ts, reflectors]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [reflection-pattern, config-loader, fs-extra, path, path-config]
+ */
+import { ReflectionCommand } from '../reflection-pattern.js';
+import { GinkoConfig } from '../../types/config.js';
+/**
+ * Configuration-aware reflection base class
+ * Handles path resolution and document naming using pathManager
+ */
+export declare abstract class ConfigAwareReflectionCommand extends ReflectionCommand {
+    protected config: GinkoConfig | null;
+    constructor(domain: string);
+    /**
+     * Load configuration before executing
+     */
+    execute(intent: string, options?: any): Promise<void>;
+    /**
+     * Save artifact using configuration-based paths
+     */
+    saveArtifact(content: string, filename?: string): Promise<string>;
+    /**
+     * Get document path for this domain using pathManager
+     */
+    protected getDocumentPath(): Promise<string>;
+    /**
+     * Get fallback path when configuration fails - now using pathManager
+     */
+    protected getFallbackPath(): string;
+}
+//# sourceMappingURL=config-aware-reflection.d.ts.map

package/dist/core/config-backup/config-aware-reflection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-aware-reflection.d.ts","sourceRoot":"","sources":["../../../src/core/config-backup/config-aware-reflection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAMpD;;;GAGG;AACH,8BAAsB,4BAA6B,SAAQ,iBAAiB;IAC1E,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAQ;gBAEhC,MAAM,EAAE,MAAM;IAI1B;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,GAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/D;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBvE;;OAEG;cACa,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IA2BlD;;OAEG;IACH,SAAS,CAAC,eAAe,IAAI,MAAM;CAgBpC"}

package/dist/core/config-backup/config-aware-reflection.js

@@ -0,0 +1,97 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-21
+ * @tags: [reflection, config-aware, paths, documents, base-class]
+ * @related: [reflection-pattern.ts, config-loader.ts, reflectors]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [reflection-pattern, config-loader, fs-extra, path, path-config]
+ */
+import { ReflectionCommand } from '../reflection-pattern.js';
+import { configLoader } from './config-loader.js';
+import { pathManager } from './path-config.js';
+import fs from 'fs-extra';
+import path from 'path';
+import chalk from 'chalk';
+/**
+ * Configuration-aware reflection base class
+ * Handles path resolution and document naming using pathManager
+ */
+export class ConfigAwareReflectionCommand extends ReflectionCommand {
+    config = null;
+    constructor(domain) {
+        super(domain);
+    }
+    /**
+     * Load configuration before executing
+     */
+    async execute(intent, options = {}) {
+        // Load configuration
+        this.config = await configLoader.loadConfig();
+        // Call parent execute
+        await super.execute(intent, options);
+    }
+    /**
+     * Save artifact using configuration-based paths
+     */
+    async saveArtifact(content, filename) {
+        if (!this.config) {
+            throw new Error('Configuration not loaded');
+        }
+        // Get the configured path for this domain
+        const documentPath = await this.getDocumentPath();
+        await fs.ensureDir(documentPath);
+        // Generate filename if not provided
+        if (!filename) {
+            filename = await this.generateDocumentName(content);
+        }
+        const filePath = path.join(documentPath, filename);
+        await fs.writeFile(filePath, content, 'utf8');
+        console.log(chalk.green(`✓ Saved to: ${filePath}`));
+        return filePath;
+    }
+    /**
+     * Get document path for this domain using pathManager
+     */
+    async getDocumentPath() {
+        try {
+            // Map domain to configuration path using pathManager
+            const pathConfig = pathManager.getConfig();
+            const pathMapping = {
+                'prd': pathConfig.docs.prd,
+                'architecture': pathConfig.docs.adr,
+                'adr': pathConfig.docs.adr,
+                'sprint': pathConfig.docs.sprints,
+                'backlog': pathConfig.ginko.backlog,
+                'documentation': pathConfig.docs.root
+            };
+            const documentPath = pathMapping[this.domain];
+            if (!documentPath) {
+                throw new Error(`No path configured for domain: ${this.domain}`);
+            }
+            return documentPath;
+        }
+        catch (error) {
+            // Fallback to default paths if configuration fails
+            console.warn(chalk.yellow(`Warning: Using fallback path for ${this.domain}`));
+            return this.getFallbackPath();
+        }
+    }
+    /**
+     * Get fallback path when configuration fails - now using pathManager
+     */
+    getFallbackPath() {
+        const pathConfig = pathManager.getConfig();
+        const fallbackPaths = {
+            'prd': pathConfig.docs.prd,
+            'architecture': pathConfig.docs.adr,
+            'adr': pathConfig.docs.adr,
+            'sprint': pathConfig.docs.sprints,
+            'backlog': pathConfig.ginko.backlog,
+            'documentation': pathConfig.docs.root
+        };
+        return fallbackPaths[this.domain] || pathConfig.docs.root;
+    }
+}
+//# sourceMappingURL=config-aware-reflection.js.map

package/dist/core/config-backup/config-aware-reflection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-aware-reflection.js","sourceRoot":"","sources":["../../../src/core/config-backup/config-aware-reflection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;GAGG;AACH,MAAM,OAAgB,4BAA6B,SAAQ,iBAAiB;IAChE,MAAM,GAAuB,IAAI,CAAC;IAE5C,YAAY,MAAc;QACxB,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,UAAe,EAAE;QAC7C,qBAAqB;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,CAAC;QAE9C,sBAAsB;QACtB,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,OAAe,EAAE,QAAiB;QACnD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QAED,0CAA0C;QAC1C,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAClD,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAEjC,oCAAoC;QACpC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QACnD,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAE9C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,QAAQ,EAAE,CAAC,CAAC,CAAC;QACpD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,eAAe;QAC7B,IAAI,CAAC;YACH,qDAAqD;YACrD,MAAM,UAAU,GAAG,WAAW,CAAC,SAAS,EAAE,CAAC;YAE3C,MAAM,WAAW,GAA2B;gBAC1C,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG;gBAC1B,cAAc,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG;gBACnC,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG;gBAC1B,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC,OAAO;gBACjC,SAAS,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO;gBACnC,eAAe,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI;aACtC,CAAC;YAEF,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC9C,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YACnE,CAAC;YAED,OAAO,YAAY,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,mDAAmD;YACnD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,oCAAoC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAC9E,OAAO,IAAI,CAAC,eAAe,EAAE,CAAC;QAChC,CAAC;IACH,CAAC;IAED;;OAEG;IACO,eAAe;QACvB,MAAM,UAAU,GAAG,WAAW,CAAC,SAAS,EAAE,CAAC;QAE3C,MAAM,aAAa,GAA2B;YAC5C,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG;YAC1B,cAAc,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG;YACnC,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG;YAC1B,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC,OAAO;YACjC,SAAS,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO;YACnC,eAAe,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI;SACtC,CAAC;QAEF,OAAO,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;IAC5D,CAAC;CAGF"}

package/dist/core/config-backup/config-loader.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-20
+ * @tags: [config, loader, paths, variables, resolution]
+ * @related: [config.ts, init.ts, project-detector.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [fs-extra, path]
+ */
+import { GinkoConfig } from '../../types/config.js';
+import { PlatformAdapter } from '../platform/platform-adapter.js';
+/**
+ * Configuration loader with path resolution and variable substitution
+ */
+export declare class ConfigLoader {
+    private cachedConfig;
+    private configPath;
+    private platformAdapter;
+    constructor();
+    /**
+     * Load ginko configuration from ginko.json or defaults
+     */
+    loadConfig(projectRoot?: string): Promise<GinkoConfig>;
+    /**
+     * Save configuration to ginko.json
+     */
+    saveConfig(config: GinkoConfig, projectRoot?: string): Promise<void>;
+    /**
+     * Resolve path variables like ${docs.root}/adr
+     */
+    private resolvePathVariables;
+    /**
+     * Convert resolved paths back to variables for saving
+     */
+    private unresolvePathVariables;
+    /**
+     * Substitute variables in a path string
+     */
+    private substituteVariables;
+    /**
+     * Apply platform-specific configuration defaults
+     */
+    private applyPlatformDefaults;
+    /**
+     * Get platform adapter for external access
+     */
+    getPlatformAdapter(): PlatformAdapter;
+    /**
+     * Merge user config with defaults
+     */
+    private mergeWithDefaults;
+    /**
+     * Find project root (git root or current directory)
+     */
+    private findProjectRoot;
+    /**
+     * Get resolved path for a specific type
+     */
+    getPath(type: string, subpath?: string): Promise<string>;
+    /**
+     * Ensure all configured paths exist
+     */
+    ensurePaths(): Promise<void>;
+    /**
+     * Clear cached configuration (for testing)
+     */
+    clearCache(): void;
+}
+export declare const configLoader: ConfigLoader;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/core/config-backup/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../../src/core/config-backup/config-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,WAAW,EAA+C,MAAM,uBAAuB,CAAC;AAEjG,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,eAAe,CAAkB;;IAMzC;;OAEG;IACG,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAiC5D;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe1E;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAyC5B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAqB9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqB3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA0B7B;;OAEG;IACH,kBAAkB,IAAI,eAAe;IAIrC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;OAEG;YACW,eAAe;IAa7B;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiC9D;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAclC;;OAEG;IACH,UAAU,IAAI,IAAI;CAInB;AAGD,eAAO,MAAM,YAAY,cAAqB,CAAC"}