specweave 0.6.8 → 0.7.0

package/dist/utils/env-file.js

@@ -0,0 +1,180 @@
+/**
+ * Environment File Utilities
+ *
+ * Parse, update, and validate .env files
+ *
+ * @module utils/env-file
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Parse .env file content into key-value pairs
+ *
+ * @param content - Content of .env file
+ * @returns Record of key-value pairs
+ */
+export function parseEnvFile(content) {
+    const result = {};
+    const lines = content.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Skip empty lines and comments
+        if (!trimmed || trimmed.startsWith('#')) {
+            continue;
+        }
+        // Parse KEY=VALUE
+        const equalsIndex = trimmed.indexOf('=');
+        if (equalsIndex > 0) {
+            const key = trimmed.substring(0, equalsIndex).trim();
+            const value = trimmed.substring(equalsIndex + 1).trim();
+            // Remove quotes if present
+            const unquotedValue = value.replace(/^["']|["']$/g, '');
+            result[key] = unquotedValue;
+        }
+    }
+    return result;
+}
+/**
+ * Update or add environment variable in .env content
+ *
+ * @param envContent - Current .env file content
+ * @param key - Environment variable key
+ * @param value - Environment variable value
+ * @returns Updated .env content
+ */
+export function updateEnvVar(envContent, key, value) {
+    const regex = new RegExp(`^${key}=.*$`, 'm');
+    if (regex.test(envContent)) {
+        // Update existing variable
+        return envContent.replace(regex, `${key}=${value}`);
+    }
+    else {
+        // Add new variable (append)
+        const trimmed = envContent.trim();
+        return trimmed ? `${trimmed}\n${key}=${value}\n` : `${key}=${value}\n`;
+    }
+}
+/**
+ * Update multiple environment variables
+ *
+ * @param envContent - Current .env file content
+ * @param vars - Array of environment variables to update
+ * @returns Updated .env content
+ */
+export function updateEnvVars(envContent, vars) {
+    let result = envContent;
+    for (const { key, value } of vars) {
+        result = updateEnvVar(result, key, value);
+    }
+    return result;
+}
+/**
+ * Read .env file from project directory
+ *
+ * @param projectPath - Path to project root
+ * @returns Content of .env file, or empty string if not found
+ */
+export function readEnvFile(projectPath) {
+    const envPath = path.join(projectPath, '.env');
+    if (fs.existsSync(envPath)) {
+        return fs.readFileSync(envPath, 'utf-8');
+    }
+    return '';
+}
+/**
+ * Write .env file to project directory
+ *
+ * @param projectPath - Path to project root
+ * @param content - Content to write
+ */
+export function writeEnvFile(projectPath, content) {
+    const envPath = path.join(projectPath, '.env');
+    fs.writeFileSync(envPath, content, 'utf-8');
+    // Set user-only read/write permissions (0o600) for security
+    // This prevents other users on the system from reading sensitive credentials
+    try {
+        fs.chmodSync(envPath, 0o600);
+    }
+    catch (error) {
+        // Non-critical error - log but continue (Windows doesn't support chmod)
+        if (process.env.DEBUG) {
+            console.error(`Warning: Could not set .env permissions: ${error}`);
+        }
+    }
+}
+/**
+ * Create .env file from .env.example template
+ *
+ * @param projectPath - Path to project root
+ * @returns Content of .env file (from template or empty)
+ */
+export function createEnvFromTemplate(projectPath) {
+    const envExamplePath = path.join(projectPath, '.env.example');
+    if (fs.existsSync(envExamplePath)) {
+        return fs.readFileSync(envExamplePath, 'utf-8');
+    }
+    return '';
+}
+/**
+ * Verify .env is in .gitignore
+ *
+ * @param projectPath - Path to project root
+ * @returns True if .env is gitignored, false otherwise
+ */
+export function isEnvGitignored(projectPath) {
+    const gitignorePath = path.join(projectPath, '.gitignore');
+    if (!fs.existsSync(gitignorePath)) {
+        return false;
+    }
+    const gitignoreContent = fs.readFileSync(gitignorePath, 'utf-8');
+    return gitignoreContent.includes('.env');
+}
+/**
+ * Add .env to .gitignore if not already present
+ *
+ * @param projectPath - Path to project root
+ */
+export function ensureEnvGitignored(projectPath) {
+    const gitignorePath = path.join(projectPath, '.gitignore');
+    if (!isEnvGitignored(projectPath)) {
+        // Append .env to .gitignore
+        const existingContent = fs.existsSync(gitignorePath)
+            ? fs.readFileSync(gitignorePath, 'utf-8')
+            : '';
+        const updatedContent = existingContent.trim()
+            ? `${existingContent}\n.env\n`
+            : '.env\n';
+        fs.writeFileSync(gitignorePath, updatedContent, 'utf-8');
+    }
+}
+/**
+ * Validate required environment variables are present
+ *
+ * @param envContent - Content of .env file
+ * @param requiredKeys - Array of required keys
+ * @returns Object with validation result and missing keys
+ */
+export function validateEnvVars(envContent, requiredKeys) {
+    const parsed = parseEnvFile(envContent);
+    const missing = [];
+    for (const key of requiredKeys) {
+        if (!parsed[key] || parsed[key].trim() === '') {
+            missing.push(key);
+        }
+    }
+    return {
+        valid: missing.length === 0,
+        missing
+    };
+}
+/**
+ * Check if .env file exists in project
+ *
+ * @param projectPath - Path to project root
+ * @returns True if .env exists, false otherwise
+ */
+export function envFileExists(projectPath) {
+    const envPath = path.join(projectPath, '.env');
+    return fs.existsSync(envPath);
+}
+//# sourceMappingURL=env-file.js.map

package/dist/utils/env-file.js.map

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

package/dist/utils/plugin-detection.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Plugin Detection Utility
+ *
+ * Maps project tech stack signals to SpecWeave plugins.
+ * Used by:
+ * - specweave init (scan project structure)
+ * - plugin-detector skill (runtime detection)
+ */
+/**
+ * Plugin detection result
+ */
+export interface DetectedPlugin {
+    name: string;
+    reason: string;
+    confidence: 'high' | 'medium' | 'low';
+    signals: string[];
+}
+/**
+ * Project tech stack signals
+ */
+interface TechStackSignals {
+    hasPackageJson: boolean;
+    hasPyProject: boolean;
+    hasRequirementsTxt: boolean;
+    hasCsproj: boolean;
+    hasGemfile: boolean;
+    dependencies: string[];
+    devDependencies: string[];
+    files: string[];
+    folders: string[];
+    gitRemote: string | null;
+}
+/**
+ * Scan project directory for tech stack signals
+ */
+export declare function scanProjectStructure(projectDir: string): Promise<TechStackSignals>;
+/**
+ * Detect required plugins based on tech stack signals
+ */
+export declare function detectPlugins(signals: TechStackSignals): DetectedPlugin[];
+/**
+ * Format detected plugins for CLI output
+ */
+export declare function formatDetectedPlugins(plugins: DetectedPlugin[]): string;
+/**
+ * Generate install commands for detected plugins
+ */
+export declare function generateInstallCommands(plugins: DetectedPlugin[]): string[];
+export {};
+//# sourceMappingURL=plugin-detection.d.ts.map

package/dist/utils/plugin-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-detection.d.ts","sourceRoot":"","sources":["../../src/utils/plugin-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,UAAU,gBAAgB;IAExB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IAGpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;IAG1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAGlB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkExF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,cAAc,EAAE,CAwLzE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CAoCvE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,EAAE,CAQ3E"}

package/dist/utils/plugin-detection.js

@@ -0,0 +1,229 @@
+/**
+ * Plugin Detection Utility
+ *
+ * Maps project tech stack signals to SpecWeave plugins.
+ * Used by:
+ * - specweave init (scan project structure)
+ * - plugin-detector skill (runtime detection)
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Scan project directory for tech stack signals
+ */
+export async function scanProjectStructure(projectDir) {
+    const signals = {
+        hasPackageJson: false,
+        hasPyProject: false,
+        hasRequirementsTxt: false,
+        hasCsproj: false,
+        hasGemfile: false,
+        dependencies: [],
+        devDependencies: [],
+        files: [],
+        folders: [],
+        gitRemote: null,
+    };
+    // Check package.json
+    const packageJsonPath = path.join(projectDir, 'package.json');
+    if (fs.existsSync(packageJsonPath)) {
+        signals.hasPackageJson = true;
+        try {
+            const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+            signals.dependencies = Object.keys(pkg.dependencies || {});
+            signals.devDependencies = Object.keys(pkg.devDependencies || {});
+        }
+        catch (e) {
+            // Ignore parse errors
+        }
+    }
+    // Check Python files
+    signals.hasPyProject = fs.existsSync(path.join(projectDir, 'pyproject.toml'));
+    signals.hasRequirementsTxt = fs.existsSync(path.join(projectDir, 'requirements.txt'));
+    // Check .NET files
+    const csprojFiles = fs.readdirSync(projectDir).filter(f => f.endsWith('.csproj'));
+    signals.hasCsproj = csprojFiles.length > 0;
+    // Check Ruby
+    signals.hasGemfile = fs.existsSync(path.join(projectDir, 'Gemfile'));
+    // Scan folders (top-level only to avoid deep recursion)
+    try {
+        const entries = fs.readdirSync(projectDir, { withFileTypes: true });
+        signals.folders = entries
+            .filter(e => e.isDirectory() && !e.name.startsWith('.'))
+            .map(e => e.name);
+        signals.files = entries
+            .filter(e => e.isFile())
+            .map(e => e.name);
+    }
+    catch (e) {
+        // Ignore permission errors
+    }
+    // Check git remote
+    const gitConfigPath = path.join(projectDir, '.git', 'config');
+    if (fs.existsSync(gitConfigPath)) {
+        try {
+            const gitConfig = fs.readFileSync(gitConfigPath, 'utf-8');
+            const remoteMatch = gitConfig.match(/url\s*=\s*(.+)/);
+            if (remoteMatch) {
+                signals.gitRemote = remoteMatch[1].trim();
+            }
+        }
+        catch (e) {
+            // Ignore errors
+        }
+    }
+    return signals;
+}
+/**
+ * Detect required plugins based on tech stack signals
+ */
+export function detectPlugins(signals) {
+    const detected = [];
+    // Helper to add detection
+    const addPlugin = (name, reason, confidence, signals) => {
+        detected.push({ name, reason, confidence, signals });
+    };
+    // Frontend detection
+    const frontendDeps = ['react', 'next', 'vue', 'angular', 'svelte', '@angular/core', 'vue-router', 'react-router-dom'];
+    const hasFrontend = signals.dependencies.some(dep => frontendDeps.some(fd => dep.includes(fd)));
+    if (hasFrontend) {
+        const matchedDeps = signals.dependencies.filter(dep => frontendDeps.some(fd => dep.includes(fd)));
+        addPlugin('specweave-frontend', 'Frontend framework detected', 'high', matchedDeps);
+    }
+    // Backend detection - Node.js
+    const backendNodeDeps = ['express', 'fastify', 'nestjs', 'koa', '@nestjs/core', 'hapi'];
+    const hasNodeBackend = signals.dependencies.some(dep => backendNodeDeps.some(bd => dep.includes(bd)));
+    if (hasNodeBackend) {
+        const matchedDeps = signals.dependencies.filter(dep => backendNodeDeps.some(bd => dep.includes(bd)));
+        addPlugin('specweave-backend', 'Node.js backend framework detected', 'high', matchedDeps);
+    }
+    // Backend detection - .NET
+    if (signals.hasCsproj) {
+        addPlugin('specweave-backend', '.NET project detected', 'high', ['*.csproj files']);
+    }
+    // Backend detection - Python
+    if (signals.hasPyProject || signals.hasRequirementsTxt) {
+        addPlugin('specweave-backend', 'Python project detected', 'medium', signals.hasPyProject ? ['pyproject.toml'] : ['requirements.txt']);
+    }
+    // Kubernetes detection
+    const k8sFolders = ['k8s', 'kubernetes', '.kube', 'helm'];
+    const hasK8s = signals.folders.some(f => k8sFolders.includes(f.toLowerCase()));
+    if (hasK8s) {
+        const matchedFolders = signals.folders.filter(f => k8sFolders.includes(f.toLowerCase()));
+        addPlugin('specweave-kubernetes', 'Kubernetes configuration detected', 'high', matchedFolders);
+    }
+    // Infrastructure detection
+    const infraFiles = ['docker-compose.yml', 'docker-compose.yaml', 'Dockerfile'];
+    const hasInfra = signals.files.some(f => infraFiles.includes(f));
+    const infraFolders = ['terraform', 'infrastructure'];
+    const hasInfraFolders = signals.folders.some(f => infraFolders.includes(f.toLowerCase()));
+    if (hasInfra || hasInfraFolders) {
+        const matchedSignals = [
+            ...signals.files.filter(f => infraFiles.includes(f)),
+            ...signals.folders.filter(f => infraFolders.includes(f.toLowerCase()))
+        ];
+        addPlugin('specweave-infrastructure', 'Infrastructure as Code detected', 'high', matchedSignals);
+    }
+    // GitHub detection
+    if (signals.gitRemote && signals.gitRemote.includes('github.com')) {
+        addPlugin('specweave-github', 'GitHub repository detected', 'high', [signals.gitRemote]);
+    }
+    // Payment processing detection
+    const paymentDeps = ['stripe', '@stripe/stripe-js', 'paypal', 'braintree'];
+    const hasPayments = signals.dependencies.some(dep => paymentDeps.some(pd => dep.includes(pd)));
+    if (hasPayments) {
+        const matchedDeps = signals.dependencies.filter(dep => paymentDeps.some(pd => dep.includes(pd)));
+        addPlugin('specweave-payments', 'Payment processing library detected', 'high', matchedDeps);
+    }
+    // Machine Learning detection
+    const mlDeps = ['tensorflow', '@tensorflow/tfjs', 'torch', 'pytorch', 'sklearn', 'keras'];
+    const hasML = signals.dependencies.some(dep => mlDeps.some(md => dep.includes(md)));
+    if (hasML) {
+        const matchedDeps = signals.dependencies.filter(dep => mlDeps.some(md => dep.includes(md)));
+        addPlugin('specweave-ml', 'Machine learning library detected', 'high', matchedDeps);
+    }
+    // Testing detection
+    const testingDeps = ['playwright', '@playwright/test', 'cypress', 'selenium-webdriver', '@testing-library/react'];
+    const hasTesting = signals.devDependencies.some(dep => testingDeps.some(td => dep.includes(td)));
+    if (hasTesting) {
+        const matchedDeps = signals.devDependencies.filter(dep => testingDeps.some(td => dep.includes(td)));
+        addPlugin('specweave-testing', 'E2E testing framework detected', 'medium', matchedDeps);
+    }
+    // Documentation detection
+    const docsDeps = ['docusaurus', '@docusaurus/core', 'vuepress', 'docsify'];
+    const hasDocs = signals.dependencies.some(dep => docsDeps.some(dd => dep.includes(dd)));
+    const docsFolders = ['docs', 'documentation', 'doc'];
+    const hasDocsFolders = signals.folders.some(f => docsFolders.includes(f.toLowerCase()));
+    if (hasDocs || hasDocsFolders) {
+        const matchedSignals = [
+            ...signals.dependencies.filter(dep => docsDeps.some(dd => dep.includes(dd))),
+            ...signals.folders.filter(f => docsFolders.includes(f.toLowerCase()))
+        ];
+        addPlugin('specweave-docs', 'Documentation site detected', hasDocs ? 'high' : 'medium', matchedSignals);
+    }
+    // Figma detection
+    const figmaDeps = ['figma-api', '@figma/rest-api', 'figma-js'];
+    const hasFigma = signals.dependencies.some(dep => figmaDeps.some(fd => dep.includes(fd)));
+    const figmaFiles = ['.figmarc', 'figma.config.js'];
+    const hasFigmaFiles = signals.files.some(f => figmaFiles.includes(f));
+    if (hasFigma || hasFigmaFiles) {
+        const matchedSignals = [
+            ...signals.dependencies.filter(dep => figmaDeps.some(fd => dep.includes(fd))),
+            ...signals.files.filter(f => figmaFiles.includes(f))
+        ];
+        addPlugin('specweave-figma', 'Figma integration detected', 'high', matchedSignals);
+    }
+    // Diagrams detection (low confidence - common folder names)
+    const diagramsFolders = ['diagrams', 'architecture'];
+    const hasDiagrams = signals.folders.some(f => diagramsFolders.includes(f.toLowerCase()));
+    if (hasDiagrams) {
+        const matchedFolders = signals.folders.filter(f => diagramsFolders.includes(f.toLowerCase()));
+        addPlugin('specweave-diagrams', 'Architecture diagrams folder detected', 'low', matchedFolders);
+    }
+    return detected;
+}
+/**
+ * Format detected plugins for CLI output
+ */
+export function formatDetectedPlugins(plugins) {
+    if (plugins.length === 0) {
+        return '   No additional plugins recommended for this project.';
+    }
+    // Group by confidence
+    const high = plugins.filter(p => p.confidence === 'high');
+    const medium = plugins.filter(p => p.confidence === 'medium');
+    const low = plugins.filter(p => p.confidence === 'low');
+    let output = '';
+    if (high.length > 0) {
+        output += '   Recommended (high confidence):\n';
+        high.forEach(p => {
+            output += `   • ${p.name} - ${p.reason}\n`;
+            output += `     Signals: ${p.signals.join(', ')}\n`;
+        });
+    }
+    if (medium.length > 0) {
+        output += '\n   Suggested (medium confidence):\n';
+        medium.forEach(p => {
+            output += `   • ${p.name} - ${p.reason}\n`;
+            output += `     Signals: ${p.signals.join(', ')}\n`;
+        });
+    }
+    if (low.length > 0) {
+        output += '\n   Optional (low confidence):\n';
+        low.forEach(p => {
+            output += `   • ${p.name} - ${p.reason}\n`;
+        });
+    }
+    return output;
+}
+/**
+ * Generate install commands for detected plugins
+ */
+export function generateInstallCommands(plugins) {
+    // Only include high and medium confidence
+    const toInstall = plugins.filter(p => p.confidence === 'high' || p.confidence === 'medium');
+    // Deduplicate by name
+    const uniquePlugins = Array.from(new Set(toInstall.map(p => p.name)));
+    return uniquePlugins.map(name => `/plugin install ${name}@specweave`);
+}
+//# sourceMappingURL=plugin-detection.js.map

package/dist/utils/plugin-detection.js.map

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

package/dist/utils/secrets-loader.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Secrets Loader Utility
+ *
+ * Loads secrets from .specweave/secrets.env file
+ * Provides clear validation and helpful error messages
+ *
+ * DESIGN PHILOSOPHY:
+ * - Secrets are OPTIONAL (framework works without them)
+ * - Clear error messages tell users WHERE to put secrets
+ * - Template file provides step-by-step instructions
+ * - Security by default (gitignored)
+ *
+ * @see .specweave/secrets.env.template
+ */
+/**
+ * Supported secret keys
+ */
+export type SecretKey = 'ANTHROPIC_API_KEY' | 'OPENAI_API_KEY' | 'GITHUB_TOKEN' | 'JIRA_API_TOKEN' | 'JIRA_DOMAIN' | 'JIRA_EMAIL' | 'AZURE_DEVOPS_PAT' | 'AZURE_DEVOPS_ORG';
+/**
+ * Secret configuration
+ */
+export interface SecretConfig {
+    key: SecretKey;
+    description: string;
+    required: boolean;
+    validation?: (value: string) => boolean;
+    setupInstructions: string;
+}
+/**
+ * Load secrets from .specweave/secrets.env file
+ *
+ * @param projectRoot - Project root directory (auto-detected if not provided)
+ * @returns Map of loaded secrets
+ */
+export declare function loadSecrets(projectRoot?: string): Map<SecretKey, string>;
+/**
+ * Get a specific secret
+ *
+ * Priority order:
+ * 1. Environment variable (process.env)
+ * 2. .specweave/secrets.env file
+ * 3. null (not found)
+ *
+ * @param key - Secret key
+ * @param projectRoot - Project root (auto-detected if not provided)
+ * @returns Secret value or null
+ */
+export declare function getSecret(key: SecretKey, projectRoot?: string): string | null;
+/**
+ * Validate a secret value
+ *
+ * @param key - Secret key
+ * @param value - Secret value
+ * @returns true if valid, false otherwise
+ */
+export declare function validateSecret(key: SecretKey, value: string): boolean;
+/**
+ * Get setup instructions for a secret
+ *
+ * @param key - Secret key
+ * @returns Setup instructions
+ */
+export declare function getSetupInstructions(key: SecretKey): string;
+/**
+ * Display helpful error message when a secret is missing
+ *
+ * @param key - Secret key
+ * @param context - Context message (what failed)
+ */
+export declare function displaySecretMissingError(key: SecretKey, context?: string): void;
+/**
+ * Check if template file exists, create if missing
+ *
+ * @param projectRoot - Project root
+ */
+export declare function ensureSecretsTemplate(projectRoot?: string): void;
+/**
+ * Validate all secrets in secrets.env file
+ *
+ * @param projectRoot - Project root
+ * @returns Validation results
+ */
+export declare function validateAllSecrets(projectRoot?: string): {
+    valid: string[];
+    invalid: string[];
+    missing: string[];
+};
+//# sourceMappingURL=secrets-loader.d.ts.map

package/dist/utils/secrets-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets-loader.d.ts","sourceRoot":"","sources":["../../src/utils/secrets-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,mBAAmB,GACnB,gBAAgB,GAChB,cAAc,GACd,gBAAgB,GAChB,aAAa,GACb,YAAY,GACZ,kBAAkB,GAClB,kBAAkB,CAAC;AAEvB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,SAAS,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IACxC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAyGD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CA2CxE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS7E;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAMrE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAmBhF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAchE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG;IACxD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAwBA"}