openlore 2.0.0

package/dist/core/analyzer/env-extractor.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Environment Variable Extractor
+ *
+ * Detects env vars used in a project from two complementary sources:
+ *   1. Declaration files — .env.example, .env.local, .env (with optional comments)
+ *   2. Source code — process.env.X (JS/TS), os.environ["X"] (Python),
+ *      os.Getenv("X") (Go), ENV["X"] (Ruby)
+ *
+ * Variables found in declaration files are marked hasDefault=true when the
+ * declaration line has a non-empty value. Variables found only in source code
+ * are marked required=true (no known default).
+ */
+export interface EnvVar {
+    /** Environment variable name, e.g. DATABASE_URL */
+    name: string;
+    /** Relative path(s) where the variable was found */
+    files: string[];
+    /** True when declared in .env.example with a non-empty value */
+    hasDefault: boolean;
+    /** True when used in source code without a fallback (process.env.X without ?? or ||) */
+    required: boolean;
+    /** Inline comment from .env.example, if present */
+    description?: string;
+}
+/**
+ * Extract all environment variables referenced or declared in the project.
+ */
+export declare function extractEnvVars(filePaths: string[], rootDir: string): Promise<EnvVar[]>;
+/**
+ * Return a compact summary string for LLM prompts.
+ */
+export declare function summarizeEnvVars(vars: EnvVar[]): string;
+//# sourceMappingURL=env-extractor.d.ts.map

package/dist/core/analyzer/env-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-extractor.d.ts","sourceRoot":"","sources":["../../../src/core/analyzer/env-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,MAAM,WAAW,MAAM;IACrB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,gEAAgE;IAChE,UAAU,EAAE,OAAO,CAAC;IACpB,wFAAwF;IACxF,QAAQ,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAmHD;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,EAAE,CAAC,CAwDnB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAWvD"}

package/dist/core/analyzer/env-extractor.js

@@ -0,0 +1,196 @@
+/**
+ * Environment Variable Extractor
+ *
+ * Detects env vars used in a project from two complementary sources:
+ *   1. Declaration files — .env.example, .env.local, .env (with optional comments)
+ *   2. Source code — process.env.X (JS/TS), os.environ["X"] (Python),
+ *      os.Getenv("X") (Go), ENV["X"] (Ruby)
+ *
+ * Variables found in declaration files are marked hasDefault=true when the
+ * declaration line has a non-empty value. Variables found only in source code
+ * are marked required=true (no known default).
+ */
+import { readFile } from 'node:fs/promises';
+import { extname, relative, basename } from 'node:path';
+// ============================================================================
+// ENV FILE PARSER
+// ============================================================================
+function parseEnvFile(content, relPath) {
+    const vars = [];
+    let pendingComment = '';
+    for (const rawLine of content.split('\n')) {
+        const line = rawLine.trim();
+        // Accumulate comment lines as description
+        if (line.startsWith('#')) {
+            pendingComment = line.replace(/^#+\s*/, '');
+            continue;
+        }
+        if (!line) {
+            pendingComment = '';
+            continue;
+        }
+        const eqIdx = line.indexOf('=');
+        if (eqIdx === -1) {
+            pendingComment = '';
+            continue;
+        }
+        const name = line.slice(0, eqIdx).trim();
+        if (!/^[A-Z_][A-Z0-9_]*$/.test(name)) {
+            pendingComment = '';
+            continue;
+        }
+        const rawValue = line.slice(eqIdx + 1).trim();
+        // Strip inline comment from value
+        const valueWithoutComment = rawValue.replace(/#.*$/, '').trim();
+        const inlineComment = rawValue.includes('#')
+            ? rawValue.slice(rawValue.indexOf('#') + 1).trim()
+            : '';
+        const hasDefault = valueWithoutComment.length > 0;
+        const description = inlineComment || pendingComment || undefined;
+        vars.push({ name, files: [relPath], hasDefault, required: false, description });
+        pendingComment = '';
+    }
+    return vars;
+}
+// ============================================================================
+// SOURCE CODE SCANNERS
+// ============================================================================
+// JS/TS: process.env.VAR_NAME or process.env['VAR_NAME'] or process.env["VAR_NAME"]
+const TS_ENV_RE = /process\.env\.([A-Z_][A-Z0-9_]*)|process\.env\[['"]([A-Z_][A-Z0-9_]*)['"]]/g;
+// Fallback detection: process.env.X ?? 'default' or process.env.X || 'default'
+const TS_HAS_FALLBACK_RE = /process\.env\.(?:[A-Z_][A-Z0-9_]*|\[['"][A-Z_][A-Z0-9_]*['"]])\s*(?:\?\?|(?<!\|)\|\|)/;
+// Python: os.environ["X"], os.environ['X'], os.environ.get("X"), os.getenv("X")
+const PY_ENV_RE = /os\.environ\[['"]([A-Z_][A-Z0-9_]*)['"]|os\.environ\.get\(['"]([A-Z_][A-Z0-9_]*)['"]|os\.getenv\(['"]([A-Z_][A-Z0-9_]*)['"]/g;
+// Go: os.Getenv("X")
+const GO_ENV_RE = /os\.Getenv\("([A-Z_][A-Z0-9_]*)"\)/g;
+// Ruby: ENV["X"], ENV['X'], ENV.fetch("X")
+const RUBY_ENV_RE = /ENV\[['"]([A-Z_][A-Z0-9_]*)['"]|ENV\.fetch\(['"]([A-Z_][A-Z0-9_]*)['"]/g;
+function extractFromSource(source, relPath, ext) {
+    const found = [];
+    let re;
+    let hasFallback = false;
+    if (['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'].includes(ext)) {
+        re = new RegExp(TS_ENV_RE.source, 'g');
+        hasFallback = TS_HAS_FALLBACK_RE.test(source);
+        let m;
+        while ((m = re.exec(source)) !== null) {
+            const name = m[1] ?? m[2];
+            if (name)
+                found.push({ name, required: !hasFallback });
+        }
+    }
+    else if (['.py', '.pyw'].includes(ext)) {
+        re = new RegExp(PY_ENV_RE.source, 'g');
+        let m;
+        while ((m = re.exec(source)) !== null) {
+            const name = m[1] ?? m[2] ?? m[3];
+            // os.environ.get and os.getenv have optional defaults → not strictly required
+            const isStrict = m[1] !== undefined; // only os.environ["X"] is strict
+            if (name)
+                found.push({ name, required: isStrict });
+        }
+    }
+    else if (ext === '.go') {
+        re = new RegExp(GO_ENV_RE.source, 'g');
+        let m;
+        while ((m = re.exec(source)) !== null) {
+            if (m[1])
+                found.push({ name: m[1], required: false }); // Go always uses string return, caller checks
+        }
+    }
+    else if (ext === '.rb') {
+        re = new RegExp(RUBY_ENV_RE.source, 'g');
+        let m;
+        while ((m = re.exec(source)) !== null) {
+            const name = m[1] ?? m[2];
+            const isStrict = m[1] !== undefined; // ENV.fetch has optional default
+            if (name)
+                found.push({ name, required: isStrict });
+        }
+    }
+    return found;
+}
+// ============================================================================
+// PUBLIC API
+// ============================================================================
+const ENV_DECLARATION_FILES = new Set(['.env', '.env.example', '.env.local', '.env.test', '.env.production']);
+const SOURCE_EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.py', '.pyw', '.go', '.rb']);
+const SKIP_DIRS = ['/node_modules/', '/.openlore/', '/dist/', '/build/', '/coverage/'];
+/**
+ * Extract all environment variables referenced or declared in the project.
+ */
+export async function extractEnvVars(filePaths, rootDir) {
+    const map = new Map();
+    function upsert(name, relPath, patch) {
+        const existing = map.get(name);
+        if (existing) {
+            if (!existing.files.includes(relPath))
+                existing.files.push(relPath);
+            if (patch.hasDefault)
+                existing.hasDefault = true;
+            if (patch.required)
+                existing.required = true;
+            if (patch.description && !existing.description)
+                existing.description = patch.description;
+        }
+        else {
+            map.set(name, {
+                name,
+                files: [relPath],
+                hasDefault: patch.hasDefault ?? false,
+                required: patch.required ?? false,
+                description: patch.description,
+            });
+        }
+    }
+    await Promise.all(filePaths.map(async (fp) => {
+        if (SKIP_DIRS.some(d => fp.replace(/\\/g, '/').includes(d)))
+            return;
+        const name = basename(fp);
+        const ext = extname(fp).toLowerCase();
+        const rel = relative(rootDir, fp);
+        let source;
+        try {
+            source = await readFile(fp, 'utf-8');
+        }
+        catch {
+            return;
+        }
+        // Env declaration files
+        if (ENV_DECLARATION_FILES.has(name)) {
+            for (const v of parseEnvFile(source, rel)) {
+                upsert(v.name, rel, { hasDefault: v.hasDefault, description: v.description });
+            }
+            return;
+        }
+        // Source files
+        if (!SOURCE_EXTENSIONS.has(ext))
+            return;
+        // Skip test files
+        if (fp.includes('.test.') || fp.includes('.spec.') || fp.includes('_test.') || fp.includes('_spec.'))
+            return;
+        for (const { name: varName, required } of extractFromSource(source, rel, ext)) {
+            upsert(varName, rel, { required });
+        }
+    }));
+    return [...map.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * Return a compact summary string for LLM prompts.
+ */
+export function summarizeEnvVars(vars) {
+    if (vars.length === 0)
+        return '';
+    const lines = vars.map(v => {
+        const flags = [];
+        if (v.required)
+            flags.push('required');
+        if (v.hasDefault)
+            flags.push('has-default');
+        const suffix = flags.length > 0 ? ` [${flags.join(', ')}]` : '';
+        const desc = v.description ? ` — ${v.description}` : '';
+        return `  ${v.name}${suffix}${desc}`;
+    });
+    return `Environment variables (${vars.length}):\n${lines.join('\n')}`;
+}
+//# sourceMappingURL=env-extractor.js.map

package/dist/core/analyzer/env-extractor.js.map

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

package/dist/core/analyzer/external-packages.d.ts

@@ -0,0 +1,20 @@
+/**
+ * External package extractor.
+ *
+ * Parses package manifests (npm, pip, cargo, go) to build a flat list
+ * of direct dependencies. No LLM required — pure filesystem reads.
+ */
+export type PackageEcosystem = 'npm' | 'pypi' | 'cargo' | 'go';
+export interface ExternalPackage {
+    name: string;
+    version: string;
+    ecosystem: PackageEcosystem;
+    isDev: boolean;
+}
+export interface ExternalPackageSummary {
+    total: number;
+    byEcosystem: Partial<Record<PackageEcosystem, number>>;
+    packages: ExternalPackage[];
+}
+export declare function extractExternalPackages(rootDir: string): Promise<ExternalPackageSummary>;
+//# sourceMappingURL=external-packages.d.ts.map

package/dist/core/analyzer/external-packages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-packages.d.ts","sourceRoot":"","sources":["../../../src/core/analyzer/external-packages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,OAAO,CAAC;CAChB;AA+HD,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAyB9F"}

package/dist/core/analyzer/external-packages.js

@@ -0,0 +1,175 @@
+/**
+ * External package extractor.
+ *
+ * Parses package manifests (npm, pip, cargo, go) to build a flat list
+ * of direct dependencies. No LLM required — pure filesystem reads.
+ */
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+// ============================================================================
+// PARSERS
+// ============================================================================
+async function parseNpm(rootDir) {
+    try {
+        const raw = await readFile(join(rootDir, 'package.json'), 'utf-8');
+        const pkg = JSON.parse(raw);
+        const out = [];
+        for (const [name, version] of Object.entries(pkg.dependencies ?? {})) {
+            out.push({ name, version, ecosystem: 'npm', isDev: false });
+        }
+        for (const [name, version] of Object.entries(pkg.devDependencies ?? {})) {
+            out.push({ name, version, ecosystem: 'npm', isDev: true });
+        }
+        for (const [name, version] of Object.entries(pkg.peerDependencies ?? {})) {
+            if (!out.some(p => p.name === name)) {
+                out.push({ name, version, ecosystem: 'npm', isDev: false });
+            }
+        }
+        return out;
+    }
+    catch {
+        return [];
+    }
+}
+async function parsePyproject(rootDir) {
+    try {
+        const raw = await readFile(join(rootDir, 'pyproject.toml'), 'utf-8');
+        const out = [];
+        // PEP 621: [project] dependencies = ["requests>=2.0", ...]
+        const pep621Block = raw.match(/^\[project\]\s*\n([\s\S]*?)(?=^\[)/m);
+        const depsMatch = pep621Block
+            ? pep621Block[1].match(/^dependencies\s*=\s*\[([^\]]*)\]/m)
+            : raw.match(/^dependencies\s*=\s*\[([^\]]*)\]/m);
+        if (depsMatch) {
+            for (const line of depsMatch[1].split('\n')) {
+                const m = line.match(/["']([a-zA-Z0-9_.-]+)([^"']*)?["']/);
+                if (m)
+                    out.push({ name: m[1], version: m[2]?.trim() ?? '*', ecosystem: 'pypi', isDev: false });
+            }
+        }
+        // Poetry: [tool.poetry.dependencies] (prod) and [tool.poetry.dev-dependencies] (dev)
+        for (const [section, isDev] of [
+            ['tool\\.poetry\\.dependencies', false],
+            ['tool\\.poetry\\.dev-dependencies', true],
+            ['tool\\.poetry\\.group\\.dev\\.dependencies', true],
+        ]) {
+            const block = raw.match(new RegExp(`\\[${section}\\]([\\s\\S]*?)(?=\\[|$)`));
+            if (!block)
+                continue;
+            for (const line of block[1].split('\n')) {
+                const m = line.match(/^(\w[\w-]*)\s*=\s*["']([^"']+)["']/);
+                // skip python version constraint line
+                if (m && m[1] !== 'python')
+                    out.push({ name: m[1], version: m[2], ecosystem: 'pypi', isDev });
+            }
+        }
+        return out;
+    }
+    catch {
+        return [];
+    }
+}
+async function parseRequirements(rootDir) {
+    const candidates = ['requirements.txt', 'requirements/base.txt', 'requirements/prod.txt', 'requirements/dev.txt'];
+    const out = [];
+    for (const candidate of candidates) {
+        try {
+            const raw = await readFile(join(rootDir, candidate), 'utf-8');
+            for (const line of raw.split('\n')) {
+                const trimmed = line.trim();
+                if (!trimmed || trimmed.startsWith('#') || trimmed.startsWith('-'))
+                    continue;
+                const m = trimmed.match(/^([a-zA-Z0-9_.-]+)\s*([>=<!][^\s;#]*)?/);
+                if (m)
+                    out.push({ name: m[1], version: m[2]?.trim() ?? '*', ecosystem: 'pypi', isDev: false });
+            }
+        }
+        catch { /* file absent */ }
+    }
+    return out;
+}
+async function parseCargo(rootDir) {
+    try {
+        const raw = await readFile(join(rootDir, 'Cargo.toml'), 'utf-8');
+        const out = [];
+        // [dependencies] and [dev-dependencies]
+        for (const [section, isDev] of [['dependencies', false], ['dev-dependencies', true]]) {
+            const block = raw.match(new RegExp(`\\[${section}\\]([\\s\\S]*?)(?=\\[|$)`));
+            if (!block)
+                continue;
+            for (const line of block[1].split('\n')) {
+                const simple = line.match(/^(\w[\w-]*)\s*=\s*["']([^"']+)["']/);
+                if (simple) {
+                    out.push({ name: simple[1], version: simple[2], ecosystem: 'cargo', isDev });
+                    continue;
+                }
+                const inline = line.match(/^(\w[\w-]*)\s*=\s*\{[^}]*version\s*=\s*["']([^"']+)["']/);
+                if (inline)
+                    out.push({ name: inline[1], version: inline[2], ecosystem: 'cargo', isDev });
+            }
+        }
+        return out;
+    }
+    catch {
+        return [];
+    }
+}
+async function parseGoMod(rootDir) {
+    try {
+        const raw = await readFile(join(rootDir, 'go.mod'), 'utf-8');
+        const out = [];
+        let inRequire = false;
+        for (const line of raw.split('\n')) {
+            if (line.match(/^require\s*\(/)) {
+                inRequire = true;
+                continue;
+            }
+            if (inRequire && line.trim() === ')') {
+                inRequire = false;
+                continue;
+            }
+            const singleReq = line.match(/^require\s+(\S+)\s+(\S+)/);
+            if (singleReq) {
+                out.push({ name: singleReq[1], version: singleReq[2], ecosystem: 'go', isDev: false });
+                continue;
+            }
+            if (inRequire) {
+                const m = line.trim().match(/^(\S+)\s+(\S+)/);
+                if (m && !m[1].startsWith('//')) {
+                    out.push({ name: m[1], version: m[2], ecosystem: 'go', isDev: false });
+                }
+            }
+        }
+        return out;
+    }
+    catch {
+        return [];
+    }
+}
+export async function extractExternalPackages(rootDir) {
+    const results = await Promise.all([
+        parseNpm(rootDir),
+        parsePyproject(rootDir),
+        parseRequirements(rootDir),
+        parseCargo(rootDir),
+        parseGoMod(rootDir),
+    ]);
+    // Deduplicate by name+ecosystem
+    const seen = new Set();
+    const packages = [];
+    for (const batch of results) {
+        for (const pkg of batch) {
+            const key = `${pkg.ecosystem}:${pkg.name}`;
+            if (!seen.has(key)) {
+                seen.add(key);
+                packages.push(pkg);
+            }
+        }
+    }
+    const byEcosystem = {};
+    for (const pkg of packages) {
+        byEcosystem[pkg.ecosystem] = (byEcosystem[pkg.ecosystem] ?? 0) + 1;
+    }
+    return { total: packages.length, byEcosystem, packages };
+}
+//# sourceMappingURL=external-packages.js.map

package/dist/core/analyzer/external-packages.js.map

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

package/dist/core/analyzer/file-walker.d.ts

@@ -0,0 +1,78 @@
+/**
+ * FileWalker Service
+ *
+ * Traverses the codebase intelligently, filtering noise and respecting ignore patterns.
+ * Collects metadata about each file for significance scoring and analysis.
+ */
+import type { FileWalkerResult } from '../../types/index.js';
+/**
+ * Options for the FileWalker
+ */
+export interface FileWalkerOptions {
+    /** Maximum number of files to process */
+    maxFiles?: number;
+    /** Additional glob patterns to include */
+    includePatterns?: string[];
+    /** Additional glob patterns to exclude */
+    excludePatterns?: string[];
+    /** Progress callback for UI updates */
+    onProgress?: (progress: FileWalkerProgress) => void;
+    /** AbortController signal for cancellation */
+    signal?: AbortSignal;
+    /** Maximum concurrent file reads */
+    concurrency?: number;
+}
+/**
+ * Progress information during file walking
+ */
+export interface FileWalkerProgress {
+    filesFound: number;
+    directoriesScanned: number;
+    currentPath: string;
+}
+/**
+ * FileWalker class for traversing codebases
+ */
+export declare class FileWalker {
+    private rootPath;
+    private options;
+    private ig;
+    /** Separate ignore instance used to check if a file matches includePatterns. */
+    private igInclude;
+    private files;
+    private skippedCount;
+    private skippedReasons;
+    private directoriesScanned;
+    private extensionCounts;
+    private directoryCounts;
+    constructor(rootPath: string, options?: FileWalkerOptions);
+    /**
+     * Record a skipped file with reason
+     */
+    private recordSkip;
+    /**
+     * Check if we should skip a directory
+     */
+    private shouldSkipDirectory;
+    /**
+     * Check if we should skip a file
+     */
+    private shouldSkipFile;
+    /**
+     * Walk a directory recursively
+     */
+    private walkDirectory;
+    /**
+     * Process a single file and collect metadata
+     */
+    private processFile;
+    /**
+     * Walk the codebase and collect file metadata
+     */
+    walk(): Promise<FileWalkerResult>;
+}
+/**
+ * Convenience function to walk a directory
+ */
+export declare function walkDirectory(rootPath: string, options?: FileWalkerOptions): Promise<FileWalkerResult>;
+//# sourceMappingURL=file-walker.d.ts.map

package/dist/core/analyzer/file-walker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-walker.d.ts","sourceRoot":"","sources":["../../../src/core/analyzer/file-walker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAgB,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,uCAAuC;IACvC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACpD,8CAA8C;IAC9C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AA8TD;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,EAAE,CAAuB;IACjC,gFAAgF;IAChF,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,eAAe,CAA8B;gBAEzC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB;IAY7D;;OAEG;IACH,OAAO,CAAC,UAAU;IAKlB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAwB3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAsBtB;;OAEG;YACW,aAAa;IAkF3B;;OAEG;YACW,WAAW;IAwCzB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,gBAAgB,CAAC;CAqCxC;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CAG3B"}