@winspan/claude-forge 8.54.3 → 9.2.0

package/dist/knowledge/adapters/go-adapter.js

@@ -0,0 +1,294 @@
+/**
+ * @file adapters/go-adapter.ts
+ * v10.3 — Go adapter (cmd/pkg layout support).
+ *
+ * Uses tree-sitter-go for AST parsing. Native module dependency is declared
+ * as optionalDependencies in package.json; if installation fails, parseSymbols
+ * throws a friendly error.
+ *
+ * Supports:
+ * - Standard Go project layout (cmd/<app>/ and pkg/<lib>/)
+ * - Single-module projects (all .go files at root)
+ * - go.mod detection
+ *
+ * Module discovery:
+ * - If cmd/ or pkg/ exist: each subdirectory becomes a module
+ * - Otherwise: single 'root' module
+ *
+ * Limitations (v10.3):
+ * - Does NOT parse go.mod for module path
+ * - Method signatures simplified (no parameter types extracted)
+ * - Generics/complex AST nodes may be skipped
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Normalise a filesystem path to POSIX-style for storage inside the KB.
+ */
+function toPosix(p) {
+    return p.split(path.sep).join('/');
+}
+export class GoAdapter {
+    name = 'go';
+    fileExtensions = ['.go'];
+    /**
+     * Project is Go iff it has go.mod.
+     */
+    detect(projectRoot) {
+        return fs.existsSync(path.join(projectRoot, 'go.mod'));
+    }
+    /**
+     * Discover source roots.
+     * For Go, the entire repository is the source root (excluding vendor/).
+     */
+    discoverSourceRoots(projectRoot) {
+        return [projectRoot];
+    }
+    /**
+     * Discover Go modules.
+     * Strategy:
+     * 1. If cmd/ exists: each cmd/<app>/ is a module
+     * 2. If pkg/ exists: each pkg/<lib>/ is a module
+     * 3. Otherwise: single 'root' module at project root
+     */
+    discoverModules(projectRoot) {
+        const modules = [];
+        const cmdDir = path.join(projectRoot, 'cmd');
+        const pkgDir = path.join(projectRoot, 'pkg');
+        // Check cmd/
+        if (fs.existsSync(cmdDir)) {
+            try {
+                const entries = fs.readdirSync(cmdDir, { withFileTypes: true });
+                for (const e of entries) {
+                    if (e.isDirectory() && !e.name.startsWith('.')) {
+                        modules.push({
+                            name: `cmd-${e.name}`,
+                            rootDir: path.join(cmdDir, e.name),
+                            refPrefix: `cmd/${e.name}`,
+                        });
+                    }
+                }
+            }
+            catch {
+                // Defensive: if readdirSync fails, continue
+            }
+        }
+        // Check pkg/
+        if (fs.existsSync(pkgDir)) {
+            try {
+                const entries = fs.readdirSync(pkgDir, { withFileTypes: true });
+                for (const e of entries) {
+                    if (e.isDirectory() && !e.name.startsWith('.')) {
+                        modules.push({
+                            name: `pkg-${e.name}`,
+                            rootDir: path.join(pkgDir, e.name),
+                            refPrefix: `pkg/${e.name}`,
+                        });
+                    }
+                }
+            }
+            catch {
+                // Defensive
+            }
+        }
+        // If no cmd/ or pkg/, treat entire project as single module
+        if (modules.length === 0) {
+            modules.push({
+                name: 'root',
+                rootDir: projectRoot,
+                refPrefix: '',
+            });
+        }
+        return modules;
+    }
+    /**
+     * Recursively walk module root, collecting .go files.
+     * Excludes: vendor/, _test.go, hidden dirs, .git
+     */
+    async walkModuleFiles(module) {
+        const files = [];
+        const walk = (dir) => {
+            let entries;
+            try {
+                entries = fs.readdirSync(dir, { withFileTypes: true });
+            }
+            catch {
+                return;
+            }
+            for (const e of entries) {
+                const full = path.join(dir, e.name);
+                if (e.isDirectory()) {
+                    // Skip vendor, hidden dirs, .git
+                    if (['vendor', '.git'].includes(e.name) || e.name.startsWith('.')) {
+                        continue;
+                    }
+                    walk(full);
+                }
+                else if (e.isFile() && e.name.endsWith('.go') && !e.name.endsWith('_test.go')) {
+                    const relPath = toPosix(path.relative(module.rootDir, full));
+                    const projectRelPath = module.refPrefix ? toPosix(path.join(module.refPrefix, relPath)) : relPath;
+                    files.push({
+                        relPath,
+                        projectRelPath,
+                        content: fs.readFileSync(full, 'utf-8'),
+                    });
+                }
+            }
+        };
+        walk(module.rootDir);
+        return files;
+    }
+    /**
+     * Extract symbols from Go source using tree-sitter-go.
+     * Lazy-imports tree-sitter to avoid breaking the entire adapter when native
+     * module installation fails.
+     */
+    async parseSymbols(file) {
+        let Parser;
+        let Go;
+        try {
+            // @ts-ignore - optional native module, may not be installed
+            const treeSitter = await import('tree-sitter');
+            // @ts-ignore - optional native module, may not be installed
+            const treeSitterGo = await import('tree-sitter-go');
+            Parser = treeSitter.default;
+            Go = treeSitterGo.default;
+        }
+        catch (err) {
+            // Graceful degradation: return empty symbols when tree-sitter is not available
+            // This allows KB build to continue in degraded mode (no symbol references)
+            return [];
+        }
+        const parser = new Parser();
+        parser.setLanguage(Go);
+        const tree = parser.parse(file.content);
+        const symbols = [];
+        const visit = (node) => {
+            if (!node)
+                return;
+            // Struct declaration: type Name struct { ... }
+            if (node.type === 'type_declaration') {
+                const typeSpec = node.childForFieldName('type_spec');
+                if (!typeSpec)
+                    return;
+                const nameNode = typeSpec.childForFieldName('name');
+                const typeNode = typeSpec.childForFieldName('type');
+                if (nameNode && typeNode && typeNode.type === 'struct_type') {
+                    const structName = file.content.slice(nameNode.startIndex, nameNode.endIndex);
+                    const line = nameNode.startPosition.row + 1;
+                    symbols.push({
+                        file: file.projectRelPath,
+                        line,
+                        kind: 'class', // Map Go struct to 'class' kind
+                        name: structName,
+                        signature: `type ${structName} struct`,
+                        exports: true, // Go exports are determined by capitalization, assume exported
+                    });
+                }
+                // Interface declaration: type Name interface { ... }
+                if (nameNode && typeNode && typeNode.type === 'interface_type') {
+                    const interfaceName = file.content.slice(nameNode.startIndex, nameNode.endIndex);
+                    const line = nameNode.startPosition.row + 1;
+                    symbols.push({
+                        file: file.projectRelPath,
+                        line,
+                        kind: 'interface',
+                        name: interfaceName,
+                        signature: `type ${interfaceName} interface`,
+                        exports: true,
+                    });
+                }
+                return;
+            }
+            // Function declaration: func Name(...) { ... }
+            if (node.type === 'function_declaration') {
+                const nameNode = node.childForFieldName('name');
+                if (!nameNode)
+                    return;
+                const funcName = file.content.slice(nameNode.startIndex, nameNode.endIndex);
+                const line = nameNode.startPosition.row + 1;
+                symbols.push({
+                    file: file.projectRelPath,
+                    line,
+                    kind: 'function',
+                    name: funcName,
+                    signature: `func ${funcName}()`,
+                    exports: true,
+                });
+                return;
+            }
+            // Method declaration: func (receiver) Name(...) { ... }
+            if (node.type === 'method_declaration') {
+                const receiverNode = node.childForFieldName('receiver');
+                const nameNode = node.childForFieldName('name');
+                if (!receiverNode || !nameNode)
+                    return;
+                const methodName = file.content.slice(nameNode.startIndex, nameNode.endIndex);
+                const line = nameNode.startPosition.row + 1;
+                // Extract receiver type
+                let receiverType = '';
+                const paramList = receiverNode.childForFieldName('parameters');
+                if (paramList) {
+                    const param = paramList.namedChild(0);
+                    if (param) {
+                        const typeNode = param.childForFieldName('type');
+                        if (typeNode) {
+                            receiverType = file.content.slice(typeNode.startIndex, typeNode.endIndex).replace(/^\*/, '');
+                        }
+                    }
+                }
+                const fullName = receiverType ? `${receiverType}.${methodName}` : methodName;
+                symbols.push({
+                    file: file.projectRelPath,
+                    line,
+                    kind: 'method',
+                    name: fullName,
+                    signature: `func ${fullName}()`,
+                    exports: true,
+                });
+                return;
+            }
+            // Const declaration: const Name = value
+            if (node.type === 'const_declaration') {
+                const specList = node.childForFieldName('spec');
+                if (!specList)
+                    return;
+                for (let i = 0; i < specList.namedChildCount; i++) {
+                    const spec = specList.namedChild(i);
+                    if (!spec || spec.type !== 'const_spec')
+                        continue;
+                    const nameNode = spec.childForFieldName('name');
+                    if (!nameNode)
+                        continue;
+                    const constName = file.content.slice(nameNode.startIndex, nameNode.endIndex);
+                    const line = nameNode.startPosition.row + 1;
+                    symbols.push({
+                        file: file.projectRelPath,
+                        line,
+                        kind: 'const',
+                        name: constName,
+                        signature: constName,
+                        exports: true,
+                    });
+                }
+                return;
+            }
+            // Recurse into other nodes
+            for (let i = 0; i < node.childCount; i++) {
+                visit(node.child(i));
+            }
+        };
+        visit(tree.rootNode);
+        return symbols;
+    }
+    /**
+     * Describe project metadata files.
+     * Returns go.mod as manifestPath and no config paths.
+     */
+    describeProjectMeta(projectRoot) {
+        const goMod = path.join(projectRoot, 'go.mod');
+        const manifestPath = fs.existsSync(goMod) ? goMod : null;
+        return { manifestPath, configPaths: [] };
+    }
+}
+//# sourceMappingURL=go-adapter.js.map

package/dist/knowledge/adapters/go-adapter.js.map

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

package/dist/knowledge/adapters/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @file adapters/index.ts
+ * v10.0 — Adapter registry + factory.
+ *
+ * In v10.0 only `TypeScriptAdapter` is registered.  Future v10.1+ adapters
+ * (Java, Python, Go, Rust) will be added to `builtinAdapters` and selected
+ * via {@link getAdapter}.
+ *
+ * Selection is deterministic: the first adapter whose `detect()` returns
+ * `true` wins.  When no adapter matches (e.g. a Java project today), `null`
+ * is returned so callers can render a friendly "unsupported" message.
+ */
+import { TypeScriptAdapter } from './typescript-adapter.js';
+import { JsVueAdapter } from './js-vue-adapter.js';
+import { JavaAdapter } from './java-adapter.js';
+import { KotlinAdapter } from './kotlin-adapter.js';
+import { PythonAdapter } from './python-adapter.js';
+import { GoAdapter } from './go-adapter.js';
+import { RustAdapter } from './rust-adapter.js';
+import type { LanguageAdapter } from './types.js';
+/**
+ * Pick the first registered adapter whose `detect()` returns `true` for
+ * `projectRoot`, or `null` when none match.
+ */
+export declare function getAdapter(projectRoot: string): LanguageAdapter | null;
+/**
+ * Error thrown when the user invokes a v10.0 KB command on a project the
+ * current build does not yet support (Java/Python/Go/Rust today, custom
+ * layouts that don't match any adapter, etc.).
+ *
+ * CLI commands catch this and render a tailored multi-line message; tests
+ * assert on `kind` to keep that message free-form.
+ */
+export declare class UnsupportedProjectError extends Error {
+    readonly kind: string;
+    constructor(message: string, kind: string);
+}
+export { TypeScriptAdapter, JsVueAdapter, JavaAdapter, KotlinAdapter, PythonAdapter, GoAdapter, RustAdapter, };
+export { MonorepoAdapter } from './monorepo-adapter.js';
+export type { LanguageAdapter, ModuleInfo, SourceFile } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/knowledge/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/knowledge/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAoBlD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAStE;AAED;;;;;;;GAOG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAK1C;AAED,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,aAAa,EACb,SAAS,EACT,WAAW,GACZ,CAAC;AACF,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/knowledge/adapters/index.js

@@ -0,0 +1,71 @@
+/**
+ * @file adapters/index.ts
+ * v10.0 — Adapter registry + factory.
+ *
+ * In v10.0 only `TypeScriptAdapter` is registered.  Future v10.1+ adapters
+ * (Java, Python, Go, Rust) will be added to `builtinAdapters` and selected
+ * via {@link getAdapter}.
+ *
+ * Selection is deterministic: the first adapter whose `detect()` returns
+ * `true` wins.  When no adapter matches (e.g. a Java project today), `null`
+ * is returned so callers can render a friendly "unsupported" message.
+ */
+import { TypeScriptAdapter } from './typescript-adapter.js';
+import { JsVueAdapter } from './js-vue-adapter.js';
+import { JavaAdapter } from './java-adapter.js';
+import { KotlinAdapter } from './kotlin-adapter.js';
+import { PythonAdapter } from './python-adapter.js';
+import { GoAdapter } from './go-adapter.js';
+import { RustAdapter } from './rust-adapter.js';
+// Order is priority: `getAdapter` returns the FIRST adapter whose `detect`
+// matches. Phase 2b-1 ordering rationale:
+//   - Kotlin BEFORE Java: a Gradle-Kotlin project carrying `.kt` sources is
+//     reclaimed from JavaAdapter (which would otherwise match `build.gradle.kts`).
+//     KotlinAdapter.detect only fires when real `.kt` exists, so a pure-Java
+//     project on the Kotlin DSL still falls through to Java.
+//   - TypeScript BEFORE JsVue: a genuine TS project (tsconfig or `.ts`) wins;
+//     a pure Vue/JS project (no tsconfig, no `.ts`) falls through to JsVue.
+const builtinAdapters = [
+    new KotlinAdapter(), // Phase 2b-1 — before Java
+    new JavaAdapter(), // v10.1
+    new TypeScriptAdapter(),
+    new JsVueAdapter(), // Phase 2b-1 — after TS
+    new PythonAdapter(), // v10.2
+    new GoAdapter(), // v10.3
+    new RustAdapter(), // v10.4
+];
+/**
+ * Pick the first registered adapter whose `detect()` returns `true` for
+ * `projectRoot`, or `null` when none match.
+ */
+export function getAdapter(projectRoot) {
+    for (const a of builtinAdapters) {
+        try {
+            if (a.detect(projectRoot))
+                return a;
+        }
+        catch {
+            // Defensive: misbehaving adapter shouldn't break the whole registry.
+        }
+    }
+    return null;
+}
+/**
+ * Error thrown when the user invokes a v10.0 KB command on a project the
+ * current build does not yet support (Java/Python/Go/Rust today, custom
+ * layouts that don't match any adapter, etc.).
+ *
+ * CLI commands catch this and render a tailored multi-line message; tests
+ * assert on `kind` to keep that message free-form.
+ */
+export class UnsupportedProjectError extends Error {
+    kind;
+    constructor(message, kind) {
+        super(message);
+        this.name = 'UnsupportedProjectError';
+        this.kind = kind;
+    }
+}
+export { TypeScriptAdapter, JsVueAdapter, JavaAdapter, KotlinAdapter, PythonAdapter, GoAdapter, RustAdapter, };
+export { MonorepoAdapter } from './monorepo-adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/knowledge/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/knowledge/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,2EAA2E;AAC3E,0CAA0C;AAC1C,4EAA4E;AAC5E,mFAAmF;AACnF,6EAA6E;AAC7E,6DAA6D;AAC7D,8EAA8E;AAC9E,4EAA4E;AAC5E,MAAM,eAAe,GAAsB;IACzC,IAAI,aAAa,EAAE,EAAE,2BAA2B;IAChD,IAAI,WAAW,EAAE,EAAE,QAAQ;IAC3B,IAAI,iBAAiB,EAAE;IACvB,IAAI,YAAY,EAAE,EAAE,wBAAwB;IAC5C,IAAI,aAAa,EAAE,EAAE,QAAQ;IAC7B,IAAI,SAAS,EAAE,EAAE,QAAQ;IACzB,IAAI,WAAW,EAAE,EAAE,QAAQ;CAC5B,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,WAAmB;IAC5C,KAAK,MAAM,CAAC,IAAI,eAAe,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,IAAI,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;gBAAE,OAAO,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,qEAAqE;QACvE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACvC,IAAI,CAAS;IAEtB,YAAY,OAAe,EAAE,IAAY;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,aAAa,EACb,SAAS,EACT,WAAW,GACZ,CAAC;AACF,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/knowledge/adapters/java-adapter.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @file adapters/java-adapter.ts
+ * v10.1 — Java adapter (Maven/Gradle multi-module support).
+ *
+ * Uses tree-sitter-java for AST parsing. Native module dependency is declared
+ * as optionalDependencies in package.json; if installation fails (e.g. Node
+ * v24 without C++20 compiler), parseSymbols throws a friendly error.
+ *
+ * Supports:
+ * - Maven multi-module projects (discovers star/src/main/java)
+ * - Gradle multi-module projects (discovers star/src/main/java)
+ * - Single-module projects (discovers src/main/java)
+ *
+ * Limitations (v10.1):
+ * - Module discovery uses glob pattern (does NOT parse pom.xml/build.gradle XML)
+ * - Method signatures simplified (no parameter types extracted)
+ * - Generics/lambdas/complex AST nodes may be skipped
+ */
+import type { LanguageAdapter, ModuleInfo, SourceFile } from './types.js';
+import type { RepoMapSymbol } from '../types.js';
+export declare class JavaAdapter implements LanguageAdapter {
+    readonly name = "java";
+    readonly fileExtensions: readonly [".java"];
+    /**
+     * Project is Java iff it has Maven or Gradle manifest.
+     */
+    detect(projectRoot: string): boolean;
+    /**
+     * Discover all src/main/java directories (Maven/Gradle convention).
+     * Checks:
+     * 1. Project root's src/main/java (single-module)
+     * 2. First-level subdirectories' src/main/java (multi-module)
+     */
+    discoverSourceRoots(projectRoot: string): string[];
+    /**
+     * Each source root becomes one module.
+     * Module name = subdirectory name (e.g. workbench-api) or root if at project root.
+     */
+    discoverModules(projectRoot: string): ModuleInfo[];
+    /**
+     * Recursively walk module root, collecting .java files.
+     * Excludes: target/, build/, .mvn/, .gradle/, hidden dirs.
+     */
+    walkModuleFiles(module: ModuleInfo): Promise<SourceFile[]>;
+    /**
+     * Extract symbols from Java source using tree-sitter-java.
+     * Lazy-imports tree-sitter to avoid breaking the entire adapter when native
+     * module installation fails.
+     *
+     * Extracts:
+     * - class/interface/enum declarations
+     * - public methods (as ClassName.methodName)
+     * - public static final fields (as ClassName.FIELD_NAME)
+     */
+    parseSymbols(file: SourceFile): Promise<RepoMapSymbol[]>;
+    /**
+     * Describe project metadata files.
+     * Returns the primary manifest (pom.xml or build.gradle) and no config paths
+     * (Java projects don't have a single config file like tsconfig.json).
+     */
+    describeProjectMeta(projectRoot: string): {
+        manifestPath: string | null;
+        configPaths: string[];
+    };
+}
+//# sourceMappingURL=java-adapter.d.ts.map

package/dist/knowledge/adapters/java-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"java-adapter.d.ts","sourceRoot":"","sources":["../../../src/knowledge/adapters/java-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AASjD,qBAAa,WAAY,YAAW,eAAe;IACjD,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,cAAc,qBAAsB;IAE7C;;OAEG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAQpC;;;;;OAKG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;IA2BlD;;;OAGG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,EAAE;IAgBlD;;;OAGG;IACG,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAqChE;;;;;;;;;OASG;IACG,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAuH9D;;;;OAIG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG;QAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,WAAW,EAAE,MAAM,EAAE,CAAA;KAAE;CAejG"}