specweave 1.0.31 → 1.0.33

package/dist/src/core/living-docs/scaffolding/merger.js

@@ -0,0 +1,523 @@
+/**
+ * Living Docs Merger - Intelligently merges existing documentation
+ *
+ * This module scans for existing documentation in a user project and
+ * offers to merge/import it into the living docs structure.
+ *
+ * Smart features:
+ * - Detects documentation type (README, API docs, guides, etc.)
+ * - Suggests appropriate target folders
+ * - Detects similar/duplicate content
+ * - Preserves original files (copies, doesn't move)
+ *
+ * @module core/living-docs/scaffolding/merger
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { consoleLogger } from '../../../utils/logger.js';
+/**
+ * Common documentation folder patterns
+ */
+const DOC_FOLDER_PATTERNS = [
+    'docs',
+    'doc',
+    'documentation',
+    'wiki',
+    'guides',
+    'tutorials',
+    'api-docs',
+    'notion-export',
+    'confluence-export',
+];
+/**
+ * File patterns for document types
+ */
+const DOC_TYPE_PATTERNS = {
+    readme: [/^readme/i, /^index\.md$/i],
+    api: [/api/i, /endpoint/i, /swagger/i, /openapi/i],
+    guide: [/guide/i, /tutorial/i, /how-to/i, /getting-started/i],
+    architecture: [/architecture/i, /design/i, /system/i, /diagram/i],
+    adr: [/^adr-/i, /^\d{4}-/i, /decision/i],
+    runbook: [/runbook/i, /playbook/i, /incident/i, /sop/i],
+    contributing: [/contributing/i, /contribution/i],
+    changelog: [/changelog/i, /changes/i, /history/i, /release/i],
+    spec: [/spec/i, /requirement/i, /prd/i, /rfc/i],
+    other: [/.*/],
+};
+/**
+ * Target folder mapping
+ */
+const TYPE_TO_TARGET = {
+    readme: 'public/overview',
+    api: 'public/api',
+    guide: 'public/guides',
+    architecture: 'internal/architecture',
+    adr: 'internal/architecture/adr',
+    runbook: 'internal/operations',
+    contributing: 'public/overview',
+    changelog: 'internal/delivery',
+    spec: 'internal/specs',
+    other: 'internal/modules',
+};
+/**
+ * Living Docs Merger class
+ */
+export class LivingDocsMerger {
+    constructor(options) {
+        this.projectPath = options.projectPath;
+        this.logger = options.logger ?? consoleLogger;
+        this.recursive = options.recursive ?? true;
+        this.maxDepth = options.maxDepth ?? 5;
+        this.minConfidence = options.minConfidence ?? 0.3;
+        this.additionalFolders = options.additionalFolders ?? [];
+    }
+    /**
+     * Scan for existing documentation
+     */
+    async scan() {
+        const detected = [];
+        this.logger.info('Scanning for existing documentation...');
+        // Scan root-level markdown files
+        await this.scanDirectory(this.projectPath, detected, 0, false);
+        // Scan common doc folders
+        for (const folder of DOC_FOLDER_PATTERNS) {
+            const folderPath = path.join(this.projectPath, folder);
+            if (fs.existsSync(folderPath) && fs.statSync(folderPath).isDirectory()) {
+                this.logger.info('  Found: ' + folder + '/');
+                await this.scanDirectory(folderPath, detected, 0, true);
+            }
+        }
+        // Scan additional folders
+        for (const folder of this.additionalFolders) {
+            const folderPath = path.isAbsolute(folder)
+                ? folder
+                : path.join(this.projectPath, folder);
+            if (fs.existsSync(folderPath) && fs.statSync(folderPath).isDirectory()) {
+                this.logger.info('  Scanning additional: ' + folder);
+                await this.scanDirectory(folderPath, detected, 0, true);
+            }
+        }
+        // Filter by confidence
+        const filtered = detected.filter(d => d.confidence >= this.minConfidence);
+        this.logger.info('Found ' + filtered.length + ' documentation files');
+        return filtered;
+    }
+    /**
+     * Scan a directory for markdown files
+     */
+    async scanDirectory(dirPath, results, depth, recursive) {
+        if (depth > this.maxDepth)
+            return;
+        // Skip certain directories
+        const dirName = path.basename(dirPath);
+        if (this.shouldSkipDir(dirName))
+            return;
+        try {
+            const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dirPath, entry.name);
+                if (entry.isDirectory() && recursive && this.recursive) {
+                    await this.scanDirectory(fullPath, results, depth + 1, recursive);
+                }
+                else if (entry.isFile() && this.isDocFile(entry.name)) {
+                    const doc = this.analyzeFile(fullPath);
+                    if (doc) {
+                        results.push(doc);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            this.logger.warn('Could not scan ' + dirPath + ': ' + error);
+        }
+    }
+    /**
+     * Check if directory should be skipped
+     */
+    shouldSkipDir(name) {
+        const skipDirs = [
+            'node_modules',
+            '.git',
+            '.specweave',
+            'dist',
+            'build',
+            'coverage',
+            '.next',
+            '.nuxt',
+            'vendor',
+            '__pycache__',
+        ];
+        return skipDirs.includes(name) || name.startsWith('.');
+    }
+    /**
+     * Check if file is a documentation file
+     */
+    isDocFile(fileName) {
+        return /\.(md|mdx|rst|txt)$/i.test(fileName);
+    }
+    /**
+     * Analyze a documentation file
+     */
+    analyzeFile(filePath) {
+        try {
+            const stats = fs.statSync(filePath);
+            const content = fs.readFileSync(filePath, 'utf-8');
+            const fileName = path.basename(filePath);
+            const relativePath = path.relative(this.projectPath, filePath);
+            // Detect type
+            const { type, confidence } = this.detectType(fileName, content);
+            // Extract themes
+            const themes = this.extractThemes(content);
+            // Get preview
+            const preview = content.slice(0, 500).trim();
+            return {
+                sourcePath: relativePath,
+                absolutePath: filePath,
+                fileName,
+                type,
+                confidence,
+                suggestedTarget: TYPE_TO_TARGET[type],
+                size: stats.size,
+                preview,
+                themes,
+            };
+        }
+        catch (error) {
+            this.logger.warn('Could not analyze ' + filePath + ': ' + error);
+            return null;
+        }
+    }
+    /**
+     * Detect document type from filename and content
+     */
+    detectType(fileName, content) {
+        let bestType = 'other';
+        let bestConfidence = 0;
+        const lowerFileName = fileName.toLowerCase();
+        const lowerContent = content.toLowerCase();
+        for (const [type, patterns] of Object.entries(DOC_TYPE_PATTERNS)) {
+            if (type === 'other')
+                continue;
+            for (const pattern of patterns) {
+                // Check filename
+                if (pattern.test(lowerFileName)) {
+                    const confidence = 0.8;
+                    if (confidence > bestConfidence) {
+                        bestType = type;
+                        bestConfidence = confidence;
+                    }
+                }
+                // Check content (lower confidence)
+                if (pattern.test(lowerContent)) {
+                    const confidence = 0.5;
+                    if (confidence > bestConfidence) {
+                        bestType = type;
+                        bestConfidence = confidence;
+                    }
+                }
+            }
+        }
+        // Default confidence for 'other'
+        if (bestType === 'other') {
+            bestConfidence = 0.3;
+        }
+        return { type: bestType, confidence: bestConfidence };
+    }
+    /**
+     * Extract themes/keywords from content
+     */
+    extractThemes(content) {
+        const themes = new Set();
+        const lowerContent = content.toLowerCase();
+        const themeKeywords = {
+            auth: ['authentication', 'authorization', 'login', 'oauth', 'jwt'],
+            api: ['api', 'endpoint', 'rest', 'graphql', 'grpc'],
+            database: ['database', 'sql', 'postgres', 'mysql', 'mongodb', 'redis'],
+            testing: ['test', 'spec', 'jest', 'vitest', 'playwright', 'cypress'],
+            deployment: ['deploy', 'docker', 'kubernetes', 'k8s', 'ci/cd', 'pipeline'],
+            security: ['security', 'encryption', 'secret', 'password', 'https'],
+            performance: ['performance', 'cache', 'optimization', 'lazy', 'bundle'],
+        };
+        for (const [theme, keywords] of Object.entries(themeKeywords)) {
+            for (const keyword of keywords) {
+                if (lowerContent.includes(keyword)) {
+                    themes.add(theme);
+                    break;
+                }
+            }
+        }
+        return Array.from(themes);
+    }
+    /**
+     * Check similarity between two files using TF-IDF weighted cosine similarity
+     *
+     * TF-IDF (Term Frequency-Inverse Document Frequency) weights terms by:
+     * - How often they appear in a document (TF - more = more important)
+     * - How rare they are across all documents (IDF - rarer = more distinctive)
+     */
+    checkSimilarity(doc1, doc2) {
+        // Theme similarity (Jaccard index)
+        const sharedThemes = doc1.themes.filter(t => doc2.themes.includes(t));
+        const unionThemes = new Set([...doc1.themes, ...doc2.themes]);
+        const themeScore = unionThemes.size > 0 ? sharedThemes.length / unionThemes.size : 0;
+        // Size similarity (logarithmic scale for better large file handling)
+        const logSize1 = Math.log(doc1.size + 1);
+        const logSize2 = Math.log(doc2.size + 1);
+        const sizeScore = 1 - Math.abs(logSize1 - logSize2) / Math.max(logSize1, logSize2, 1);
+        // TF-IDF weighted content similarity
+        const contentScore = this.computeTfIdfSimilarity(doc1.preview, doc2.preview);
+        // Filename similarity (Levenshtein-based)
+        const filenameScore = this.computeFilenameSimilarity(doc1.fileName, doc2.fileName);
+        // Weighted combination (TF-IDF content is most important)
+        const score = (contentScore * 0.45) +
+            (themeScore * 0.25) +
+            (filenameScore * 0.15) +
+            (sizeScore * 0.15);
+        // Determine reason based on highest contributing factor
+        let reason;
+        if (score > 0.6) {
+            const reasons = [];
+            if (contentScore > 0.5)
+                reasons.push('similar content');
+            if (themeScore > 0.5)
+                reasons.push('shared themes');
+            if (filenameScore > 0.6)
+                reasons.push('similar filename');
+            reason = reasons.length > 0 ? reasons.join(', ') : 'overall similarity';
+        }
+        return {
+            isSimilar: score > 0.6,
+            score,
+            reason,
+        };
+    }
+    /**
+     * Compute TF-IDF weighted cosine similarity between two texts
+     *
+     * This is a simplified but effective TF-IDF implementation:
+     * - TF: term frequency in document (normalized)
+     * - IDF: inverse document frequency (approximated using both documents as corpus)
+     */
+    computeTfIdfSimilarity(text1, text2) {
+        const tokens1 = this.tokenize(text1);
+        const tokens2 = this.tokenize(text2);
+        if (tokens1.length === 0 || tokens2.length === 0)
+            return 0;
+        // Build term frequency maps
+        const tf1 = this.computeTermFrequency(tokens1);
+        const tf2 = this.computeTermFrequency(tokens2);
+        // Build IDF using both documents as mini-corpus
+        const allTerms = new Set([...tf1.keys(), ...tf2.keys()]);
+        const idf = new Map();
+        const numDocs = 2; // We have 2 documents
+        for (const term of allTerms) {
+            const docsWithTerm = (tf1.has(term) ? 1 : 0) + (tf2.has(term) ? 1 : 0);
+            // IDF = log(N / df) where N = total docs, df = docs containing term
+            idf.set(term, Math.log(numDocs / docsWithTerm) + 1); // +1 to avoid log(1)=0
+        }
+        // Compute TF-IDF vectors
+        const tfidf1 = new Map();
+        const tfidf2 = new Map();
+        for (const [term, freq] of tf1) {
+            tfidf1.set(term, freq * (idf.get(term) || 1));
+        }
+        for (const [term, freq] of tf2) {
+            tfidf2.set(term, freq * (idf.get(term) || 1));
+        }
+        // Compute cosine similarity
+        return this.cosineSimilarity(tfidf1, tfidf2);
+    }
+    /**
+     * Tokenize text into meaningful terms
+     * Filters out common stop words and short tokens
+     */
+    tokenize(text) {
+        const stopWords = new Set([
+            'the', 'a', 'an', 'and', 'or', 'but', 'in', 'on', 'at', 'to', 'for',
+            'of', 'with', 'by', 'from', 'as', 'is', 'was', 'are', 'were', 'been',
+            'be', 'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would',
+            'could', 'should', 'may', 'might', 'must', 'this', 'that', 'these',
+            'those', 'it', 'its', 'you', 'your', 'we', 'our', 'they', 'their',
+            'i', 'me', 'my', 'he', 'she', 'him', 'her', 'his', 'hers',
+        ]);
+        return text
+            .toLowerCase()
+            .replace(/[^a-z0-9\s]/g, ' ') // Remove punctuation
+            .split(/\s+/) // Split on whitespace
+            .filter(token => token.length > 2 && // Min 3 chars
+            !stopWords.has(token) && // Not a stop word
+            !/^\d+$/.test(token) // Not pure numbers
+        );
+    }
+    /**
+     * Compute normalized term frequency
+     */
+    computeTermFrequency(tokens) {
+        const tf = new Map();
+        for (const token of tokens) {
+            tf.set(token, (tf.get(token) || 0) + 1);
+        }
+        // Normalize by document length
+        const maxFreq = Math.max(...tf.values());
+        for (const [term, freq] of tf) {
+            tf.set(term, freq / maxFreq);
+        }
+        return tf;
+    }
+    /**
+     * Compute cosine similarity between two TF-IDF vectors
+     */
+    cosineSimilarity(vec1, vec2) {
+        let dotProduct = 0;
+        let norm1 = 0;
+        let norm2 = 0;
+        // Compute dot product for shared terms
+        for (const [term, weight1] of vec1) {
+            const weight2 = vec2.get(term) || 0;
+            dotProduct += weight1 * weight2;
+            norm1 += weight1 * weight1;
+        }
+        // Add remaining terms from vec2 to norm2
+        for (const [term, weight2] of vec2) {
+            norm2 += weight2 * weight2;
+            if (!vec1.has(term)) {
+                // Already counted in dot product loop
+            }
+        }
+        norm1 = Math.sqrt(norm1);
+        norm2 = Math.sqrt(norm2);
+        if (norm1 === 0 || norm2 === 0)
+            return 0;
+        return dotProduct / (norm1 * norm2);
+    }
+    /**
+     * Compute filename similarity using normalized Levenshtein distance
+     */
+    computeFilenameSimilarity(name1, name2) {
+        // Remove extension for comparison
+        const base1 = name1.replace(/\.[^.]+$/, '').toLowerCase();
+        const base2 = name2.replace(/\.[^.]+$/, '').toLowerCase();
+        if (base1 === base2)
+            return 1;
+        const distance = this.levenshteinDistance(base1, base2);
+        const maxLen = Math.max(base1.length, base2.length);
+        return maxLen === 0 ? 1 : 1 - (distance / maxLen);
+    }
+    /**
+     * Compute Levenshtein edit distance between two strings
+     */
+    levenshteinDistance(s1, s2) {
+        const m = s1.length;
+        const n = s2.length;
+        // Create DP matrix
+        const dp = Array(m + 1).fill(null).map(() => Array(n + 1).fill(0));
+        // Initialize base cases
+        for (let i = 0; i <= m; i++)
+            dp[i][0] = i;
+        for (let j = 0; j <= n; j++)
+            dp[0][j] = j;
+        // Fill the matrix
+        for (let i = 1; i <= m; i++) {
+            for (let j = 1; j <= n; j++) {
+                if (s1[i - 1] === s2[j - 1]) {
+                    dp[i][j] = dp[i - 1][j - 1];
+                }
+                else {
+                    dp[i][j] = 1 + Math.min(dp[i - 1][j], // deletion
+                    dp[i][j - 1], // insertion
+                    dp[i - 1][j - 1] // substitution
+                    );
+                }
+            }
+        }
+        return dp[m][n];
+    }
+    /**
+     * Generate merge suggestions grouped by target folder
+     */
+    generateSuggestions(detected) {
+        const suggestions = new Map();
+        for (const doc of detected) {
+            const target = doc.suggestedTarget;
+            if (!suggestions.has(target)) {
+                suggestions.set(target, []);
+            }
+            suggestions.get(target).push(doc);
+        }
+        return suggestions;
+    }
+    /**
+     * Merge a detected document into living docs
+     */
+    async mergeDoc(doc, targetFolder) {
+        const target = targetFolder || doc.suggestedTarget;
+        const targetDir = path.join(this.projectPath, '.specweave', 'docs', target);
+        const targetPath = path.join(targetDir, doc.fileName);
+        try {
+            // Ensure target directory exists
+            if (!fs.existsSync(targetDir)) {
+                fs.mkdirSync(targetDir, { recursive: true });
+            }
+            // Check if target already exists
+            if (fs.existsSync(targetPath)) {
+                return {
+                    success: false,
+                    targetPath,
+                    error: 'Target file already exists',
+                };
+            }
+            // Copy file
+            fs.copyFileSync(doc.absolutePath, targetPath);
+            this.logger.info('Merged: ' + doc.sourcePath + ' -> ' + target + '/' + doc.fileName);
+            return { success: true, targetPath };
+        }
+        catch (error) {
+            return {
+                success: false,
+                targetPath,
+                error: String(error),
+            };
+        }
+    }
+}
+/**
+ * Scan for existing documentation (convenience function)
+ */
+export async function scanExistingDocs(options) {
+    const merger = new LivingDocsMerger(options);
+    return merger.scan();
+}
+/**
+ * Find similar documentation folders
+ */
+export function findSimilarFolders(projectPath, existingDocs) {
+    const folderThemes = new Map();
+    // Group themes by parent folder
+    for (const doc of existingDocs) {
+        const folder = path.dirname(doc.sourcePath);
+        if (!folderThemes.has(folder)) {
+            folderThemes.set(folder, new Set());
+        }
+        for (const theme of doc.themes) {
+            folderThemes.get(folder).add(theme);
+        }
+    }
+    // Find folders with overlapping themes
+    const similar = new Map();
+    const folders = Array.from(folderThemes.keys());
+    for (let i = 0; i < folders.length; i++) {
+        for (let j = i + 1; j < folders.length; j++) {
+            const themes1 = folderThemes.get(folders[i]);
+            const themes2 = folderThemes.get(folders[j]);
+            const shared = [...themes1].filter(t => themes2.has(t));
+            if (shared.length >= 2) {
+                if (!similar.has(folders[i])) {
+                    similar.set(folders[i], []);
+                }
+                similar.get(folders[i]).push(folders[j]);
+            }
+        }
+    }
+    return similar;
+}
+//# sourceMappingURL=merger.js.map

package/dist/src/core/living-docs/scaffolding/merger.js.map

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

package/dist/src/core/living-docs/scaffolding/scaffold.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Living Docs Scaffold - Creates documentation structure for user projects
+ *
+ * This module creates the .specweave/docs/ directory structure for ANY user project.
+ * It's project-agnostic and uses templates with variable substitution.
+ *
+ * CRITICAL: This runs during `specweave init` to set up the docs structure.
+ *
+ * @module core/living-docs/scaffolding/scaffold
+ */
+import { Logger } from '../../../utils/logger.js';
+import { type TemplateContext } from './template-engine.js';
+/**
+ * Scaffold options
+ */
+export interface ScaffoldOptions {
+    /** Project root path */
+    projectPath: string;
+    /** Project ID (e.g., "my-app") - auto-detected if not provided */
+    projectId?: string;
+    /** Project display name (e.g., "My Application") */
+    projectName?: string;
+    /** Whether to overwrite existing files */
+    overwrite?: boolean;
+    /** Dry run - don't create files, just report what would be created */
+    dryRun?: boolean;
+    /** Logger instance */
+    logger?: Logger;
+    /** Additional template context variables */
+    additionalContext?: Record<string, unknown>;
+}
+/**
+ * Scaffold result
+ */
+export interface ScaffoldResult {
+    /** Whether scaffolding was successful */
+    success: boolean;
+    /** Files that were created */
+    filesCreated: string[];
+    /** Files that were skipped (already exist) */
+    filesSkipped: string[];
+    /** Directories that were created */
+    dirsCreated: string[];
+    /** Any errors that occurred */
+    errors: string[];
+    /** Project context used for scaffolding */
+    context: TemplateContext;
+}
+/**
+ * Scaffold class - creates living docs structure
+ */
+export declare class LivingDocsScaffold {
+    private projectPath;
+    private projectId;
+    private logger;
+    private templateEngine;
+    private overwrite;
+    private dryRun;
+    private context;
+    constructor(options: ScaffoldOptions);
+    /**
+     * Detect project ID from git remote or directory name
+     */
+    private detectProjectId;
+    /**
+     * Create the full living docs structure
+     */
+    scaffold(): Promise<ScaffoldResult>;
+    /**
+     * Create directory structure recursively
+     */
+    private createStructure;
+    /**
+     * Create root README.md
+     */
+    private createRootReadme;
+    /**
+     * Create project-specific specs folder
+     */
+    private createProjectSpecsFolder;
+    /**
+     * Create SUGGESTIONS.md placeholder
+     */
+    private createSuggestionsFile;
+    /**
+     * Ensure directory exists
+     */
+    private ensureDir;
+    /**
+     * Create a file with content
+     */
+    private createFile;
+}
+/**
+ * Scaffold living docs structure (convenience function)
+ */
+export declare function scaffoldLivingDocs(options: ScaffoldOptions): Promise<ScaffoldResult>;
+/**
+ * Check if living docs structure exists
+ */
+export declare function hasLivingDocsStructure(projectPath: string): boolean;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/src/core/living-docs/scaffolding/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../../../src/core/living-docs/scaffolding/scaffold.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,MAAM,EAAiB,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAwC,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAElG;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IAEpB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,sEAAsE;IACtE,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,4CAA4C;IAC5C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IAEjB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB,8CAA8C;IAC9C,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB,oCAAoC;IACpC,WAAW,EAAE,MAAM,EAAE,CAAC;IAEtB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB,2CAA2C;IAC3C,OAAO,EAAE,eAAe,CAAC;CAC1B;AA8FD;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,OAAO,CAAkB;gBAErB,OAAO,EAAE,eAAe;IAgBpC;;OAEG;IACH,OAAO,CAAC,eAAe;IAmBvB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC;IA8CzC;;OAEG;YACW,eAAe;IAwB7B;;OAEG;YACW,gBAAgB;IAoC9B;;OAEG;YACW,wBAAwB;IAsCtC;;OAEG;YACW,qBAAqB;IAkCnC;;OAEG;YACW,SAAS;IAcvB;;OAEG;YACW,UAAU;CAqBzB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAG1F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAGnE"}