@ginkoai/cli 1.0.0

package/dist/core/documents/index.js

@@ -0,0 +1,119 @@
+/**
+ * @fileType: config
+ * @status: current
+ * @updated: 2025-09-19
+ * @tags: [document, management, export, api]
+ * @related: [sequence-manager.ts, document-namer.ts, document-migrator.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: [all document management components]
+ */
+// Core components
+export { SequenceManager, createSequenceManager } from './sequence-manager.js';
+export { DocumentNamer, createDocumentNamer } from './document-namer.js';
+export { DocumentMigrator, createDocumentMigrator } from './document-migrator.js';
+// Convenience factory for complete document management system
+import { createSequenceManager } from './sequence-manager.js';
+import { createDocumentNamer } from './document-namer.js';
+import { createDocumentMigrator } from './document-migrator.js';
+/**
+ * Create a complete document management system with all components configured
+ */
+export async function createDocumentManagementSystem(config) {
+    const docsRoot = config.docsRoot || `${config.ginkoRoot}/docs`;
+    // Create sequence manager
+    const sequenceManager = createSequenceManager(config.ginkoRoot, config.startingNumbers);
+    // Create document namer
+    const documentNamer = createDocumentNamer(sequenceManager, docsRoot);
+    // Create document migrator
+    const documentMigrator = createDocumentMigrator(documentNamer, sequenceManager, docsRoot, {
+        updateReferences: config.updateReferences ?? true,
+        backupDir: config.backupDir
+    });
+    return {
+        sequenceManager,
+        documentNamer,
+        documentMigrator,
+        initialize: async () => {
+            await sequenceManager.initialize();
+        }
+    };
+}
+/**
+ * Quick factory for basic document naming without migration
+ */
+export async function createBasicDocumentNamer(ginkoRoot) {
+    const docsRoot = `${ginkoRoot}/docs`;
+    const sequenceManager = createSequenceManager(ginkoRoot);
+    await sequenceManager.initialize();
+    const namer = createDocumentNamer(sequenceManager, docsRoot);
+    return { namer, sequenceManager };
+}
+/**
+ * Utility function to validate document naming compliance across project
+ */
+export async function validateDocumentNaming(ginkoRoot) {
+    const { documentMigrator } = await createDocumentManagementSystem({ ginkoRoot });
+    try {
+        const migrationPlan = await documentMigrator.generateMigrationPlan();
+        const validation = await documentMigrator.validateMigration();
+        return {
+            isCompliant: migrationPlan.operations.length === 0 && validation.isValid,
+            nonCompliantFiles: migrationPlan.operations.map(op => op.originalFilename),
+            issues: validation.issues
+        };
+    }
+    catch (error) {
+        return {
+            isCompliant: false,
+            nonCompliantFiles: [],
+            issues: [`Validation failed: ${error instanceof Error ? error.message : 'Unknown error'}`]
+        };
+    }
+}
+/**
+ * Utility function to standardize all documents in a project
+ */
+export async function standardizeProjectDocuments(ginkoRoot, options) {
+    const { documentMigrator } = await createDocumentManagementSystem({
+        ginkoRoot,
+        updateReferences: options?.updateReferences,
+        backupDir: options?.backupDir
+    });
+    return documentMigrator.executeMigration(options?.dryRun ?? false);
+}
+n; // Import enhanced utilities for factory functions
+import { DocumentManager } from "./document-manager.js";
+import { MarkdownProcessor } from "./markdown-processor.js";
+import { DocumentFileSystem } from "./file-system.js";
+import { TemplateEngine } from "./template-engine.js";
+// Enhanced Document Management Utilities (2025-09-22)
+export { DocumentManager } from './document-manager.js';
+export { MarkdownProcessor } from './markdown-processor.js';
+export { DocumentFileSystem } from './file-system.js';
+export { TemplateEngine } from './template-engine.js';
+/**
+ * Enhanced factory function to get complete document manager with all capabilities
+ */
+export function createEnhancedDocumentManager() {
+    return DocumentManager.getInstance();
+}
+/**
+ * Enhanced factory function to get markdown processor
+ */
+export function createMarkdownProcessor() {
+    return MarkdownProcessor.getInstance();
+}
+/**
+ * Enhanced factory function to get file system utilities
+ */
+export function createDocumentFileSystem() {
+    return DocumentFileSystem.getInstance();
+}
+/**
+ * Enhanced factory function to get template engine
+ */
+export function createTemplateEngine() {
+    return TemplateEngine.getInstance();
+}
+//# sourceMappingURL=index.js.map

package/dist/core/documents/index.js.map

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

package/dist/core/documents/markdown-processor.d.ts

@@ -0,0 +1,84 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-22
+ * @tags: [markdown, parser, frontmatter, processing, content]
+ * @related: [document-manager.ts, template-engine.ts, ../../types/documents.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [marked, gray-matter, fs-extra]
+ */
+import { MarkdownFrontmatter, DocumentResult, DocumentOptions } from '../../types/documents.js';
+/**
+ * Markdown processing and manipulation utilities
+ */
+export declare class MarkdownProcessor {
+    private static instance;
+    private constructor();
+    static getInstance(): MarkdownProcessor;
+    /**
+     * Configure marked parser with safe defaults
+     */
+    private configureMarked;
+    /**
+     * Parse markdown file with frontmatter
+     */
+    parseFile(filePath: string, options?: DocumentOptions): Promise<DocumentResult>;
+    /**
+     * Parse markdown content string
+     */
+    parseContent(content: string, filePath?: string, options?: DocumentOptions): DocumentResult;
+    /**
+     * Convert markdown to HTML
+     */
+    toHtml(content: string): Promise<string>;
+    /**
+     * Extract and normalize metadata from frontmatter
+     */
+    private extractMetadata;
+    /**
+     * Validate frontmatter structure
+     */
+    validateFrontmatter(frontmatter: any): {
+        valid: boolean;
+        errors: string[];
+        warnings: string[];
+    };
+    /**
+     * Generate markdown with frontmatter
+     */
+    generateMarkdown(metadata: MarkdownFrontmatter, content: string): string;
+    /**
+     * Generate frontmatter string
+     */
+    generateFrontmatter(metadata: MarkdownFrontmatter): string;
+    /**
+     * Update frontmatter in existing markdown
+     */
+    updateFrontmatter(content: string, updates: Partial<MarkdownFrontmatter>): string;
+    /**
+     * Extract table of contents from markdown
+     */
+    extractTableOfContents(content: string): Array<{
+        level: number;
+        title: string;
+        anchor: string;
+    }>;
+    /**
+     * Extract links from markdown content
+     */
+    extractLinks(content: string): Array<{
+        text: string;
+        url: string;
+        type: 'internal' | 'external';
+    }>;
+    /**
+     * Validate markdown syntax
+     */
+    validateMarkdown(content: string): {
+        valid: boolean;
+        errors: string[];
+        warnings: string[];
+    };
+}
+//# sourceMappingURL=markdown-processor.d.ts.map

package/dist/core/documents/markdown-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-processor.d.ts","sourceRoot":"","sources":["../../../src/core/documents/markdown-processor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,EAA8B,mBAAmB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE5H;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAoB;IAE3C,OAAO;WAIO,WAAW,IAAI,iBAAiB;IAO9C;;OAEG;IACH,OAAO,CAAC,eAAe;IAWvB;;OAEG;IACU,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IAqBhG;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,cAAc;IAoCtG;;OAEG;IACU,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIrD;;OAEG;IACH,OAAO,CAAC,eAAe;IAmCvB;;OAEG;IACI,mBAAmB,CAAC,WAAW,EAAE,GAAG,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE;IAgDtG;;OAEG;IACI,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAK/E;;OAEG;IACI,mBAAmB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM;IAyBjE;;OAEG;IACI,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,MAAM;IAOxF;;OAEG;IACI,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAqBvG;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAAA;KAAE,CAAC;IAkBzG;;OAEG;IACI,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE;CAwCnG"}

package/dist/core/documents/markdown-processor.js

@@ -0,0 +1,302 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-22
+ * @tags: [markdown, parser, frontmatter, processing, content]
+ * @related: [document-manager.ts, template-engine.ts, ../../types/documents.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [marked, gray-matter, fs-extra]
+ */
+import { marked } from 'marked';
+import * as matter from 'gray-matter';
+import * as fs from 'fs-extra';
+/**
+ * Markdown processing and manipulation utilities
+ */
+export class MarkdownProcessor {
+    static instance;
+    constructor() {
+        this.configureMarked();
+    }
+    static getInstance() {
+        if (!MarkdownProcessor.instance) {
+            MarkdownProcessor.instance = new MarkdownProcessor();
+        }
+        return MarkdownProcessor.instance;
+    }
+    /**
+     * Configure marked parser with safe defaults
+     */
+    configureMarked() {
+        marked.setOptions({
+            gfm: true,
+            breaks: false,
+            pedantic: false,
+        });
+    }
+    /**
+     * Parse markdown file with frontmatter
+     */
+    async parseFile(filePath, options = {}) {
+        try {
+            if (!await fs.pathExists(filePath)) {
+                return {
+                    success: false,
+                    error: `File not found: ${filePath}`
+                };
+            }
+            const encoding = options.encoding || 'utf8';
+            const raw = await fs.readFile(filePath, encoding);
+            return this.parseContent(raw, filePath, options);
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to parse file ${filePath}: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    /**
+     * Parse markdown content string
+     */
+    parseContent(content, filePath, options = {}) {
+        try {
+            const parsed = matter(content);
+            // Validate frontmatter if requested
+            if (options.validateFrontmatter) {
+                const validation = this.validateFrontmatter(parsed.data);
+                if (!validation.valid) {
+                    return {
+                        success: false,
+                        error: `Invalid frontmatter: ${validation.errors.join(', ')}`,
+                        warnings: validation.warnings
+                    };
+                }
+            }
+            const document = {
+                path: filePath || '',
+                format: 'md',
+                metadata: this.extractMetadata(parsed.data),
+                content: parsed.content.trim(),
+                raw: content
+            };
+            return {
+                success: true,
+                document
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to parse content: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    /**
+     * Convert markdown to HTML
+     */
+    async toHtml(content) {
+        return marked(content);
+    }
+    /**
+     * Extract and normalize metadata from frontmatter
+     */
+    extractMetadata(frontmatter) {
+        const metadata = {};
+        // Standard fields
+        if (frontmatter.title)
+            metadata.title = String(frontmatter.title);
+        if (frontmatter.description)
+            metadata.description = String(frontmatter.description);
+        if (frontmatter.author)
+            metadata.author = String(frontmatter.author);
+        // Date fields
+        if (frontmatter.created) {
+            metadata.created = new Date(frontmatter.created);
+        }
+        if (frontmatter.updated) {
+            metadata.updated = new Date(frontmatter.updated);
+        }
+        // Array fields
+        if (Array.isArray(frontmatter.tags)) {
+            metadata.tags = frontmatter.tags.map((tag) => String(tag));
+        }
+        // Template field
+        if (frontmatter.template)
+            metadata.template = String(frontmatter.template);
+        if (frontmatter.version)
+            metadata.version = String(frontmatter.version);
+        // Copy all other fields
+        for (const [key, value] of Object.entries(frontmatter)) {
+            if (!metadata.hasOwnProperty(key)) {
+                metadata[key] = value;
+            }
+        }
+        return metadata;
+    }
+    /**
+     * Validate frontmatter structure
+     */
+    validateFrontmatter(frontmatter) {
+        const errors = [];
+        const warnings = [];
+        // Check for required ginko frontmatter fields
+        if (!frontmatter.fileType) {
+            warnings.push('Missing @fileType field');
+        }
+        else {
+            const validFileTypes = ['component', 'page', 'api-route', 'hook', 'utility', 'provider', 'model', 'config'];
+            if (!validFileTypes.includes(frontmatter.fileType)) {
+                warnings.push(`Unusual fileType: ${frontmatter.fileType}`);
+            }
+        }
+        if (!frontmatter.status) {
+            warnings.push('Missing @status field');
+        }
+        else {
+            const validStatuses = ['current', 'deprecated', 'draft'];
+            if (!validStatuses.includes(frontmatter.status)) {
+                errors.push(`Invalid status: ${frontmatter.status}. Must be one of: ${validStatuses.join(', ')}`);
+            }
+        }
+        if (!frontmatter.updated) {
+            warnings.push('Missing @updated field');
+        }
+        if (frontmatter.priority) {
+            const validPriorities = ['critical', 'high', 'medium', 'low'];
+            if (!validPriorities.includes(frontmatter.priority)) {
+                errors.push(`Invalid priority: ${frontmatter.priority}. Must be one of: ${validPriorities.join(', ')}`);
+            }
+        }
+        if (frontmatter.complexity) {
+            const validComplexities = ['low', 'medium', 'high'];
+            if (!validComplexities.includes(frontmatter.complexity)) {
+                errors.push(`Invalid complexity: ${frontmatter.complexity}. Must be one of: ${validComplexities.join(', ')}`);
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings
+        };
+    }
+    /**
+     * Generate markdown with frontmatter
+     */
+    generateMarkdown(metadata, content) {
+        const frontmatterString = this.generateFrontmatter(metadata);
+        return `${frontmatterString}\n\n${content}`;
+    }
+    /**
+     * Generate frontmatter string
+     */
+    generateFrontmatter(metadata) {
+        const lines = ['/**'];
+        if (metadata.fileType)
+            lines.push(` * @fileType: ${metadata.fileType}`);
+        if (metadata.status)
+            lines.push(` * @status: ${metadata.status}`);
+        if (metadata.updated) {
+            const date = metadata.updated instanceof Date ? metadata.updated : new Date(metadata.updated);
+            lines.push(` * @updated: ${date.toISOString().split('T')[0]}`);
+        }
+        if (metadata.tags && metadata.tags.length > 0) {
+            lines.push(` * @tags: [${metadata.tags.join(', ')}]`);
+        }
+        if (metadata.related && metadata.related.length > 0) {
+            lines.push(` * @related: [${metadata.related.join(', ')}]`);
+        }
+        if (metadata.priority)
+            lines.push(` * @priority: ${metadata.priority}`);
+        if (metadata.complexity)
+            lines.push(` * @complexity: ${metadata.complexity}`);
+        if (metadata.dependencies && metadata.dependencies.length > 0) {
+            lines.push(` * @dependencies: [${metadata.dependencies.join(', ')}]`);
+        }
+        lines.push(' */');
+        return lines.join('\n');
+    }
+    /**
+     * Update frontmatter in existing markdown
+     */
+    updateFrontmatter(content, updates) {
+        const parsed = matter(content);
+        const updatedData = { ...parsed.data, ...updates };
+        return matter.stringify(parsed.content, updatedData);
+    }
+    /**
+     * Extract table of contents from markdown
+     */
+    extractTableOfContents(content) {
+        const toc = [];
+        const lines = content.split('\n');
+        for (const line of lines) {
+            const match = line.match(/^(#{1,6})\s+(.+)$/);
+            if (match) {
+                const level = match[1].length;
+                const title = match[2].trim();
+                const anchor = title
+                    .toLowerCase()
+                    .replace(/[^\w\s-]/g, '')
+                    .replace(/\s+/g, '-');
+                toc.push({ level, title, anchor });
+            }
+        }
+        return toc;
+    }
+    /**
+     * Extract links from markdown content
+     */
+    extractLinks(content) {
+        const links = [];
+        // Match markdown links [text](url)
+        const linkRegex = /\[([^\]]+)\]\(([^)]+)\)/g;
+        let match;
+        while ((match = linkRegex.exec(content)) !== null) {
+            const text = match[1];
+            const url = match[2];
+            const type = url.startsWith('http') || url.startsWith('//') ? 'external' : 'internal';
+            links.push({ text, url, type });
+        }
+        return links;
+    }
+    /**
+     * Validate markdown syntax
+     */
+    validateMarkdown(content) {
+        const errors = [];
+        const warnings = [];
+        try {
+            // Try to parse with marked
+            marked(content);
+            // Check for common issues
+            const lines = content.split('\n');
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                const lineNum = i + 1;
+                // Check for unbalanced brackets
+                const openBrackets = (line.match(/\[/g) || []).length;
+                const closeBrackets = (line.match(/\]/g) || []).length;
+                if (openBrackets !== closeBrackets) {
+                    warnings.push(`Line ${lineNum}: Unbalanced brackets`);
+                }
+                // Check for unbalanced parentheses in links
+                const openParens = (line.match(/\(/g) || []).length;
+                const closeParens = (line.match(/\)/g) || []).length;
+                if (openParens !== closeParens) {
+                    warnings.push(`Line ${lineNum}: Unbalanced parentheses`);
+                }
+            }
+        }
+        catch (error) {
+            errors.push(`Markdown parsing error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings
+        };
+    }
+}
+//# sourceMappingURL=markdown-processor.js.map

package/dist/core/documents/markdown-processor.js.map

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

package/dist/core/documents/sequence-manager.d.ts

@@ -0,0 +1,107 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-19
+ * @tags: [document, sequence, numbering, persistence]
+ * @related: [document-namer.ts, document-migrator.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [fs-extra, path]
+ */
+/**
+ * Document types supported by the ginko system
+ */
+export type DocumentType = 'ADR' | 'PRD' | 'SPRINT' | 'STRATEGY';
+/**
+ * Interface for sequence data storage
+ */
+export interface SequenceData {
+    version: string;
+    sequences: Record<DocumentType, number>;
+    lastUpdated: string;
+}
+/**
+ * Configuration for the sequence manager
+ */
+export interface SequenceManagerConfig {
+    /** Directory where .ginko folder is located */
+    ginkoRoot: string;
+    /** Custom starting numbers for document types */
+    startingNumbers?: Partial<Record<DocumentType, number>>;
+}
+/**
+ * Manages document sequence numbers for consistent naming convention.
+ * Ensures thread-safe allocation and persistent storage of document numbers.
+ */
+export declare class SequenceManager {
+    private readonly sequencePath;
+    private readonly lockPath;
+    private data;
+    private config;
+    constructor(config: SequenceManagerConfig);
+    /**
+     * Initialize the sequence manager by loading existing data or creating defaults
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get the next sequence number for a document type
+     */
+    getNext(type: DocumentType): Promise<number>;
+    /**
+     * Get the current sequence number for a document type without incrementing
+     */
+    getCurrent(type: DocumentType): Promise<number>;
+    /**
+     * Set a specific sequence number for a document type
+     */
+    setSequence(type: DocumentType, number: number): Promise<void>;
+    /**
+     * Reset sequences based on existing documents in the filesystem
+     */
+    rescanDocuments(): Promise<void>;
+    /**
+     * Get all current sequence numbers
+     */
+    getAllSequences(): Promise<Record<DocumentType, number>>;
+    /**
+     * Load sequence data from persistent storage
+     */
+    private loadSequenceData;
+    /**
+     * Save sequence data to persistent storage
+     */
+    private saveSequenceData;
+    /**
+     * Scan existing documents to determine current sequence numbers
+     */
+    private scanExistingDocuments;
+    /**
+     * Acquire a lock for thread-safe operations
+     */
+    private acquireLock;
+    /**
+     * Release the lock
+     */
+    private releaseLock;
+    /**
+     * Simple delay utility
+     */
+    private delay;
+    /**
+     * Get default sequence data
+     */
+    private getDefaultData;
+    /**
+     * Validate and migrate sequence data from storage
+     */
+    private validateSequenceData;
+    /**
+     * Validate a sequence number
+     */
+    private validateSequenceNumber;
+}
+/**
+ * Create a sequence manager instance with default configuration
+ */
+export declare function createSequenceManager(ginkoRoot: string, startingNumbers?: Partial<Record<DocumentType, number>>): SequenceManager;
+//# sourceMappingURL=sequence-manager.d.ts.map

package/dist/core/documents/sequence-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence-manager.d.ts","sourceRoot":"","sources":["../../../src/core/documents/sequence-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,eAAe,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;CACzD;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,MAAM,CAAwB;gBAE1B,MAAM,EAAE,qBAAqB;IAOzC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAejC;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBlD;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAKrD;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBpE;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAWtC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAK9D;;OAEG;YACW,gBAAgB;IAY9B;;OAEG;YACW,gBAAgB;IAI9B;;OAEG;YACW,qBAAqB;IAgCnC;;OAEG;YACW,WAAW;IAmBzB;;OAEG;YACW,WAAW;IAQzB;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,OAAO,CAAC,cAAc;IAatB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmB5B;;OAEG;IACH,OAAO,CAAC,sBAAsB;CAM/B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,GAAG,eAAe,CAEjI"}