@specverse/engines 6.0.7 → 6.0.9

package/dist/analyse-prepass/backends/grep-only.js

@@ -0,0 +1,377 @@
+/**
+ * Grep-only backend — minimum-viable fallback for `StructuralPrepass`.
+ *
+ * Walks the source tree with regex per language. No external tools, no
+ * indexer, no SQLite. Useful for:
+ *   - Tests / CI environments where CodeGraph isn't installed
+ *   - Bootstrapping the adapter layer before CodeGraph is wired
+ *   - Sanity-check baseline (a real backend should at least equal this)
+ *
+ * Capabilities: only the bare minimum (no call graph, no cross-file
+ * resolution, no clustering). Adapters that need more should select a
+ * richer backend.
+ */
+import { readFileSync } from 'fs';
+import { extname } from 'path';
+import { walkSourceTree, globToRegex } from './walk.js';
+import { extractEmits, extractDbWrites, extractExternalCalls, extractThrows, extractAsyncBoundaries, countBranchPoints, extractCallNames, sliceBody, } from './method-patterns.js';
+const LANG_PATTERNS = {
+    typescript: {
+        fileExtensions: ['.ts', '.tsx'],
+        classRegex: /^(?:export\s+)?(?:default\s+)?(?:abstract\s+)?class\s+(\w+)/gm,
+        methodRegex: /^\s+(?:public|private|protected|static|async)?\s*(?:async\s+)?(\w+)\s*\(/gm,
+        interfaceRegex: /^(?:export\s+)?interface\s+(\w+)/gm,
+        importRegex: /^import\s+(?:type\s+)?(?:\{([^}]+)\}|(\w+))\s+from\s+["']([^"']+)["']/gm,
+    },
+    javascript: {
+        fileExtensions: ['.js', '.jsx', '.mjs', '.cjs'],
+        classRegex: /^(?:export\s+)?(?:default\s+)?class\s+(\w+)/gm,
+        methodRegex: /^\s+(?:async\s+)?(\w+)\s*\(/gm,
+        importRegex: /^import\s+(?:\{([^}]+)\}|(\w+))\s+from\s+["']([^"']+)["']/gm,
+    },
+    python: {
+        fileExtensions: ['.py'],
+        classRegex: /^class\s+(\w+)/gm,
+        methodRegex: /^\s+def\s+(\w+)\s*\(/gm,
+        importRegex: /^(?:from\s+(\S+)\s+)?import\s+(.+)$/gm,
+    },
+    go: {
+        fileExtensions: ['.go'],
+        classRegex: /^type\s+(\w+)\s+struct/gm,
+        methodRegex: /^func\s+\([^)]*\)\s+(\w+)\s*\(/gm,
+        importRegex: /^import\s+(?:\(([\s\S]*?)\)|"([^"]+)")/gm,
+    },
+};
+/**
+ * Detect a language using grep-only's own per-language pattern set.
+ * (Matches against fileExtensions inside LANG_PATTERNS — different from
+ * walk.ts's `detectLanguage` which uses a broader extension set without
+ * regex patterns.)
+ */
+function detectGrepLanguage(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    for (const [lang, patterns] of Object.entries(LANG_PATTERNS)) {
+        if (patterns.fileExtensions.includes(ext))
+            return lang;
+    }
+    return null;
+}
+export class GrepOnlyBackend {
+    sourceDir = '';
+    files = [];
+    /** Cache file→content to avoid re-reading on multiple calls. */
+    fileCache = new Map();
+    capabilities = {
+        callGraph: false,
+        crossFileResolution: false,
+        componentClustering: false,
+        fullTextSearch: false,
+        fileWatching: false,
+    };
+    async init(sourceDir) {
+        this.sourceDir = sourceDir;
+        this.files = [];
+        this.fileCache.clear();
+    }
+    async index() {
+        const start = Date.now();
+        // Walk the full filesystem; downstream listClasses / listMethods filter by
+        // language, but listFiles needs to expose all files (e.g. schema.prisma).
+        this.files = walkSourceTree(this.sourceDir);
+        return {
+            files: this.files.length,
+            symbols: 0, // we don't pre-index symbols; queries scan on demand
+            durationMs: Date.now() - start,
+        };
+    }
+    async listFiles(filter) {
+        let result = [...this.files];
+        if (filter?.dir) {
+            result = result.filter((f) => f.startsWith(filter.dir));
+        }
+        if (filter?.lang) {
+            result = result.filter((f) => detectGrepLanguage(f) === filter.lang);
+        }
+        if (filter?.glob) {
+            const re = globToRegex(filter.glob);
+            result = result.filter((f) => re.test(f));
+        }
+        return result;
+    }
+    async listClasses(filter) {
+        const out = [];
+        for (const file of this.files) {
+            if (filter?.dir && !file.startsWith(filter.dir))
+                continue;
+            const lang = detectGrepLanguage(file);
+            if (!lang)
+                continue;
+            const patterns = LANG_PATTERNS[lang];
+            const text = await this.fileSourceText(file);
+            const lines = text.split('\n');
+            const matches = [...text.matchAll(patterns.classRegex)];
+            for (const m of matches) {
+                const name = m[1];
+                if (filter?.namePattern && !filter.namePattern.test(name))
+                    continue;
+                const idx = m.index ?? 0;
+                const startLine = text.slice(0, idx).split('\n').length;
+                // Crude end-line: scan forward for matching brace depth
+                const endLine = this.findClassEnd(lines, startLine - 1, lang);
+                out.push({
+                    kind: 'class',
+                    name,
+                    qualifiedName: name, // grep-only doesn't track namespacing
+                    filePath: file,
+                    startLine,
+                    endLine,
+                    isExported: m[0].includes('export'),
+                    language: lang,
+                });
+            }
+        }
+        return out;
+    }
+    async listMethods(filter) {
+        const out = [];
+        const classes = await this.listClasses();
+        const targetClasses = filter?.class ? classes.filter((c) => c.qualifiedName === filter.class) : classes;
+        for (const cls of targetClasses) {
+            const lang = cls.language;
+            const patterns = LANG_PATTERNS[lang];
+            if (!patterns.methodRegex)
+                continue;
+            const text = await this.fileSourceText(cls.filePath);
+            const lines = text.split('\n');
+            // Slice the class body
+            const bodyLines = lines.slice(cls.startLine - 1, cls.endLine);
+            const body = bodyLines.join('\n');
+            const matches = [...body.matchAll(patterns.methodRegex)];
+            for (const m of matches) {
+                const name = m[1];
+                // Skip pseudo-methods like 'constructor', 'if', 'for', etc. (heuristic — keyword filter)
+                if (['if', 'for', 'while', 'switch', 'catch', 'return'].includes(name))
+                    continue;
+                if (filter?.nameIn && !filter.nameIn.includes(name))
+                    continue;
+                const lineOffset = body.slice(0, m.index ?? 0).split('\n').length;
+                out.push({
+                    kind: 'method',
+                    name,
+                    qualifiedName: `${cls.name}.${name}`,
+                    filePath: cls.filePath,
+                    startLine: cls.startLine + lineOffset - 1,
+                    endLine: cls.startLine + lineOffset - 1, // grep-only doesn't trace function ends
+                    language: lang,
+                });
+            }
+        }
+        return out;
+    }
+    async listInterfaces(filter) {
+        const out = [];
+        for (const file of this.files) {
+            if (filter?.dir && !file.startsWith(filter.dir))
+                continue;
+            const lang = detectGrepLanguage(file);
+            if (!lang)
+                continue;
+            const patterns = LANG_PATTERNS[lang];
+            if (!patterns.interfaceRegex)
+                continue;
+            const text = await this.fileSourceText(file);
+            const matches = [...text.matchAll(patterns.interfaceRegex)];
+            for (const m of matches) {
+                const name = m[1];
+                if (filter?.namePattern && !filter.namePattern.test(name))
+                    continue;
+                const idx = m.index ?? 0;
+                const startLine = text.slice(0, idx).split('\n').length;
+                out.push({
+                    kind: 'interface',
+                    name,
+                    qualifiedName: name,
+                    filePath: file,
+                    startLine,
+                    endLine: startLine,
+                    isExported: m[0].includes('export'),
+                    language: lang,
+                });
+            }
+        }
+        return out;
+    }
+    async listImports(file) {
+        const lang = detectGrepLanguage(file);
+        if (!lang)
+            return [];
+        const patterns = LANG_PATTERNS[lang];
+        if (!patterns.importRegex)
+            return [];
+        const text = await this.fileSourceText(file);
+        const out = [];
+        for (const m of text.matchAll(patterns.importRegex)) {
+            // TS/JS: groups are (named imports, default import, module path)
+            // Python: (from-module, names) or (names) for plain imports
+            // Go: (block content, single-line module)
+            if (lang === 'typescript' || lang === 'javascript') {
+                const named = m[1] ? m[1].split(',').map((s) => s.trim()) : [];
+                const def = m[2] ? [m[2]] : [];
+                const mod = m[3];
+                out.push({ fromFile: file, toModule: mod, symbols: [...named, ...def] });
+            }
+            else if (lang === 'python') {
+                const fromMod = m[1] || '';
+                const names = (m[2] || '').split(',').map((s) => s.trim());
+                out.push({ fromFile: file, toModule: fromMod, symbols: names });
+            }
+            else if (lang === 'go') {
+                const mod = m[2] || (m[1] || '').replace(/"/g, '').trim();
+                if (mod)
+                    out.push({ fromFile: file, toModule: mod, symbols: [] });
+            }
+        }
+        return out;
+    }
+    async fileSourceText(file) {
+        if (this.fileCache.has(file))
+            return this.fileCache.get(file);
+        const text = readFileSync(file, 'utf8');
+        this.fileCache.set(file, text);
+        return text;
+    }
+    /**
+     * Extract per-method facts via regex over the method body.
+     *
+     * Locates the method (parses class containing `qualifiedName`'s class part,
+     * scans for the method by name), pulls the body via brace-depth tracking,
+     * runs each pattern extractor on it.
+     */
+    async getMethodDetails(qualifiedName) {
+        // Parse "ClassName.methodName" — we only support single-level qualified
+        // names for v1; namespaced classes (e.g. SomeModule.ClassName.method) fall
+        // through as if `ClassName.methodName`.
+        const lastDot = qualifiedName.lastIndexOf('.');
+        if (lastDot < 0)
+            return null;
+        const className = qualifiedName.slice(0, lastDot);
+        const methodName = qualifiedName.slice(lastDot + 1);
+        const classes = await this.listClasses({ namePattern: new RegExp(`^${className}$`) });
+        if (classes.length === 0)
+            return null;
+        const cls = classes[0];
+        const text = await this.fileSourceText(cls.filePath);
+        const lines = text.split('\n');
+        // Find the method declaration line within the class body
+        const classBody = lines.slice(cls.startLine - 1, cls.endLine);
+        let methodStartIdx = -1;
+        let methodSig = '';
+        for (let i = 0; i < classBody.length; i++) {
+            const line = classBody[i];
+            // Match: `[modifiers] [async] methodName(...)` — capture the method's name
+            const re = new RegExp(`^\\s+(?:public|private|protected|static|async)?\\s*(?:async\\s+)?${methodName}\\s*\\(`);
+            if (re.test(line)) {
+                methodStartIdx = i;
+                // Capture the signature line (single-line approximation; multi-line
+                // signatures roll up to the next `{`)
+                let sig = line.trim();
+                let j = i;
+                while (!sig.includes('{') && j + 1 < classBody.length) {
+                    j++;
+                    sig += ' ' + classBody[j].trim();
+                }
+                methodSig = sig.replace(/\s*\{\s*$/, '').trim();
+                break;
+            }
+        }
+        if (methodStartIdx < 0)
+            return null;
+        // Find body via brace depth — scan from the first `{` after methodStartIdx
+        const bodyStartFileLineIdx = cls.startLine - 1 + methodStartIdx;
+        let depth = 0;
+        let started = false;
+        let bodyEndFileLineIdx = bodyStartFileLineIdx;
+        for (let i = bodyStartFileLineIdx; i < lines.length; i++) {
+            for (const ch of lines[i]) {
+                if (ch === '{') {
+                    depth++;
+                    started = true;
+                }
+                else if (ch === '}') {
+                    depth--;
+                    if (started && depth === 0) {
+                        bodyEndFileLineIdx = i;
+                        i = lines.length; // break outer loop
+                        break;
+                    }
+                }
+            }
+        }
+        const bodyLines = lines.slice(bodyStartFileLineIdx, bodyEndFileLineIdx + 1);
+        const body = bodyLines.join('\n');
+        // Resolve called names → Symbol[] when possible (look up in our class index)
+        const callNames = extractCallNames(body);
+        const allMethods = await this.listMethods();
+        const calls = [];
+        for (const name of callNames) {
+            const match = allMethods.find((m) => m.name === name);
+            if (match)
+                calls.push(match);
+        }
+        return {
+            qualifiedName,
+            signature: methodSig,
+            body,
+            filePath: cls.filePath,
+            startLine: bodyStartFileLineIdx + 1,
+            endLine: bodyEndFileLineIdx + 1,
+            language: cls.language,
+            calls,
+            emits: extractEmits(body),
+            dbWrites: extractDbWrites(body),
+            externalCalls: extractExternalCalls(body),
+            throws: extractThrows(body),
+            asyncBoundaries: extractAsyncBoundaries(body),
+            branchPoints: countBranchPoints(body),
+            bodyTextSliced: sliceBody(body),
+        };
+    }
+    // ────────────────────────────────────────────────────────────────────
+    // Internals
+    // ────────────────────────────────────────────────────────────────────
+    /** Find the closing line of a class block by tracking brace depth. */
+    findClassEnd(lines, startLineIdx, lang) {
+        if (lang === 'python') {
+            // Indentation-based: find the next line at the SAME or LESS indent than the class line.
+            const classLine = lines[startLineIdx];
+            const baseIndent = classLine.match(/^(\s*)/)?.[1].length ?? 0;
+            for (let i = startLineIdx + 1; i < lines.length; i++) {
+                const line = lines[i];
+                if (line.trim() === '')
+                    continue;
+                const indent = line.match(/^(\s*)/)?.[1].length ?? 0;
+                if (indent <= baseIndent)
+                    return i; // 1-indexed, but i is 0-indexed; this is the first line AFTER the class
+            }
+            return lines.length;
+        }
+        // C-style: track brace depth
+        let depth = 0;
+        let started = false;
+        for (let i = startLineIdx; i < lines.length; i++) {
+            for (const char of lines[i]) {
+                if (char === '{') {
+                    depth++;
+                    started = true;
+                }
+                else if (char === '}') {
+                    depth--;
+                    if (started && depth === 0)
+                        return i + 1; // 1-indexed line number
+                }
+            }
+        }
+        return lines.length;
+    }
+}
+//# sourceMappingURL=grep-only.js.map

package/dist/analyse-prepass/backends/grep-only.js.map

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

package/dist/analyse-prepass/backends/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Backend selector — picks the best available `StructuralPrepass`.
+ *
+ * Order: gitnexus (if available + opted-in) → codegraph (if available)
+ *        → grep-only (always works).
+ *
+ * GitNexus is more invasive (heavier stack, longer index time) but provides
+ * Leiden community detection (clusterFiles capability) which can help with
+ * multi-component codebases. Default `auto` prefers CodeGraph for the
+ * smaller-footprint case; explicitly request `gitnexus` for clustering.
+ */
+import type { StructuralPrepass } from '../interface.js';
+import { GrepOnlyBackend } from './grep-only.js';
+import { CodeGraphBackend } from './codegraph.js';
+import { GitNexusBackend } from './gitnexus.js';
+export { GrepOnlyBackend, CodeGraphBackend, GitNexusBackend };
+export type BackendName = 'codegraph' | 'gitnexus' | 'grep-only' | 'auto';
+/**
+ * Select a backend by name, or auto-pick a sensible default.
+ *
+ * `auto` semantics:
+ *   - CodeGraph + sqlite3 both available → CodeGraph (lighter; richest baseline)
+ *   - Otherwise → grep-only (always works, no external tools)
+ *   - Note: GitNexus is NOT auto-selected even when available, because its
+ *     index overhead is significant. Explicit opt-in via name='gitnexus'.
+ */
+export declare function selectBackend(name?: BackendName): StructuralPrepass;
+//# sourceMappingURL=index.d.ts.map

package/dist/analyse-prepass/backends/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analyse-prepass/backends/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAE9D,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,CAAC;AAE1E;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,WAAoB,GAAG,iBAAiB,CAyB3E"}

package/dist/analyse-prepass/backends/index.js

@@ -0,0 +1,36 @@
+import { GrepOnlyBackend } from './grep-only.js';
+import { CodeGraphBackend } from './codegraph.js';
+import { GitNexusBackend } from './gitnexus.js';
+export { GrepOnlyBackend, CodeGraphBackend, GitNexusBackend };
+/**
+ * Select a backend by name, or auto-pick a sensible default.
+ *
+ * `auto` semantics:
+ *   - CodeGraph + sqlite3 both available → CodeGraph (lighter; richest baseline)
+ *   - Otherwise → grep-only (always works, no external tools)
+ *   - Note: GitNexus is NOT auto-selected even when available, because its
+ *     index overhead is significant. Explicit opt-in via name='gitnexus'.
+ */
+export function selectBackend(name = 'auto') {
+    if (name === 'codegraph') {
+        if (!CodeGraphBackend.isAvailable()) {
+            throw new Error('CodeGraph backend requested but not available. Install with `npm i -g @colbymchenry/codegraph` and ensure sqlite3 is on PATH.');
+        }
+        return new CodeGraphBackend();
+    }
+    if (name === 'gitnexus') {
+        if (!GitNexusBackend.isAvailable()) {
+            throw new Error('GitNexus backend requested but not available. Install with `npm i -g gitnexus`.');
+        }
+        return new GitNexusBackend();
+    }
+    if (name === 'grep-only') {
+        return new GrepOnlyBackend();
+    }
+    // auto — prefer CodeGraph (lighter, fast); GitNexus stays opt-in.
+    if (CodeGraphBackend.isAvailable()) {
+        return new CodeGraphBackend();
+    }
+    return new GrepOnlyBackend();
+}
+//# sourceMappingURL=index.js.map

package/dist/analyse-prepass/backends/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analyse-prepass/backends/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAI9D;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,OAAoB,MAAM;IACtD,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,+HAA+H,CAChI,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,gBAAgB,EAAE,CAAC;IAChC,CAAC;IACD,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,eAAe,EAAE,CAAC;IAC/B,CAAC;IACD,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,OAAO,IAAI,eAAe,EAAE,CAAC;IAC/B,CAAC;IACD,kEAAkE;IAClE,IAAI,gBAAgB,CAAC,WAAW,EAAE,EAAE,CAAC;QACnC,OAAO,IAAI,gBAAgB,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,eAAe,EAAE,CAAC;AAC/B,CAAC"}

package/dist/analyse-prepass/backends/method-patterns.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Method-body pattern extraction — shared between grep-only and CodeGraph
+ * backends. CodeGraph provides the call-graph piece via SQL; everything
+ * else (event emission, DB writes, throws, async boundaries, branch points,
+ * region slicing) is regex over raw source text. These patterns are
+ * deliberately broad — adapters can refine per framework.
+ *
+ * Patterns covered for v1: TypeScript / JavaScript. Python / Go / Java
+ * adapters add their own pattern sets per language.
+ */
+import type { MethodFactSheet } from '../interface.js';
+/** Slice a method body into the canonical PRECONDITIONS/EXECUTE/POSTCONDITIONS/EVENTS regions. */
+export declare function sliceBody(body: string): MethodFactSheet['bodyTextSliced'];
+/** Extract event names emitted from a TS/JS method body. */
+export declare function extractEmits(body: string): string[];
+/** Extract Prisma-style DB writes from a TS/JS method body. */
+export declare function extractDbWrites(body: string): MethodFactSheet['dbWrites'];
+/** Extract external system calls from a TS/JS method body. */
+export declare function extractExternalCalls(body: string): MethodFactSheet['externalCalls'];
+/** Extract throw statements (the type of error being thrown). */
+export declare function extractThrows(body: string): string[];
+/** Find async boundaries (await / Promise.all / Promise.race). */
+export declare function extractAsyncBoundaries(body: string): MethodFactSheet['asyncBoundaries'];
+/** Count branch points — if / else if / switch case / catch / ternary. */
+export declare function countBranchPoints(body: string): number;
+export declare function extractCallNames(body: string): string[];
+//# sourceMappingURL=method-patterns.d.ts.map

package/dist/analyse-prepass/backends/method-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"method-patterns.d.ts","sourceRoot":"","sources":["../../../src/analyse-prepass/backends/method-patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAUvD,kGAAkG;AAClG,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAAC,gBAAgB,CAAC,CAmBzE;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBnD;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAAC,UAAU,CAAC,CAqCzE;AAED,8DAA8D;AAC9D,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAAC,eAAe,CAAC,CAmBnF;AAED,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAQpD;AAED,kEAAkE;AAClE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAAC,iBAAiB,CAAC,CAkBvF;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAStD;AAcD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAWvD"}