@winspan/claude-forge 8.54.4 → 9.12.0

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"}

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

@@ -0,0 +1,260 @@
+/**
+ * @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 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 JavaAdapter {
+    name = 'java';
+    fileExtensions = ['.java'];
+    /**
+     * Project is Java iff it has Maven or Gradle manifest.
+     */
+    detect(projectRoot) {
+        return (fs.existsSync(path.join(projectRoot, 'pom.xml')) ||
+            fs.existsSync(path.join(projectRoot, 'build.gradle')) ||
+            fs.existsSync(path.join(projectRoot, 'build.gradle.kts')));
+    }
+    /**
+     * 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) {
+        const roots = [];
+        const check = (dir) => {
+            const candidate = path.join(dir, 'src/main/java');
+            if (fs.existsSync(candidate)) {
+                roots.push(candidate);
+            }
+        };
+        // Check project root
+        check(projectRoot);
+        // Check first-level subdirectories (Maven/Gradle sub-modules)
+        try {
+            const entries = fs.readdirSync(projectRoot, { withFileTypes: true });
+            for (const e of entries) {
+                if (e.isDirectory() && !e.name.startsWith('.') && e.name !== 'target' && e.name !== 'build') {
+                    check(path.join(projectRoot, e.name));
+                }
+            }
+        }
+        catch {
+            // Defensive: if readdirSync fails, continue with what we have
+        }
+        return roots;
+    }
+    /**
+     * Each source root becomes one module.
+     * Module name = subdirectory name (e.g. workbench-api) or root if at project root.
+     */
+    discoverModules(projectRoot) {
+        const roots = this.discoverSourceRoots(projectRoot);
+        return roots.map((r) => {
+            const rel = path.relative(projectRoot, r);
+            const parts = rel.split(path.sep);
+            // If path is `src/main/java` → name = 'root'
+            // If path is `workbench-api/src/main/java` → name = 'workbench-api'
+            const name = parts[0] === 'src' ? 'root' : parts[0];
+            return {
+                name,
+                rootDir: r,
+                refPrefix: name === 'root' ? '' : name,
+            };
+        });
+    }
+    /**
+     * Recursively walk module root, collecting .java files.
+     * Excludes: target/, build/, .mvn/, .gradle/, hidden dirs.
+     */
+    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 build artifacts and hidden dirs
+                    if (['target', 'build', '.mvn', '.gradle'].includes(e.name) || e.name.startsWith('.')) {
+                        continue;
+                    }
+                    walk(full);
+                }
+                else if (e.isFile() && e.name.endsWith('.java')) {
+                    const relPath = toPosix(path.relative(module.rootDir, full));
+                    // For multi-module: projectRelPath = <module-name>/<relPath>
+                    // For single-module: projectRelPath = <relPath>
+                    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 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)
+     */
+    async parseSymbols(file) {
+        // Lazy import to isolate native module dependency
+        let Parser, Java;
+        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 treeSitterJava = await import('tree-sitter-java');
+            Parser = treeSitter.default;
+            Java = treeSitterJava.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(Java);
+        const tree = parser.parse(file.content);
+        const symbols = [];
+        const visit = (node, parentClass) => {
+            // Class/interface/enum declarations
+            if (['class_declaration', 'interface_declaration', 'enum_declaration'].includes(node.type)) {
+                const nameNode = node.childForFieldName('name');
+                if (!nameNode) {
+                    // Recurse children even if no name (defensive)
+                    for (let i = 0; i < node.childCount; i++) {
+                        visit(node.child(i), parentClass);
+                    }
+                    return;
+                }
+                const name = file.content.slice(nameNode.startIndex, nameNode.endIndex);
+                const line = nameNode.startPosition.row + 1;
+                const kind = node.type === 'class_declaration'
+                    ? 'class'
+                    : node.type === 'interface_declaration'
+                        ? 'interface'
+                        : 'enum';
+                symbols.push({
+                    file: file.projectRelPath,
+                    line,
+                    kind,
+                    name,
+                    signature: kind + ' ' + name,
+                    exports: true, // Java public classes are exported by default
+                });
+                // Recurse into class body for methods/fields
+                for (let i = 0; i < node.childCount; i++) {
+                    visit(node.child(i), name);
+                }
+                return;
+            }
+            // Method declarations
+            if (node.type === 'method_declaration') {
+                const nameNode = node.childForFieldName('name');
+                if (!nameNode)
+                    return;
+                const methodName = file.content.slice(nameNode.startIndex, nameNode.endIndex);
+                const line = nameNode.startPosition.row + 1;
+                const fullName = parentClass ? parentClass + '.' + methodName : methodName;
+                symbols.push({
+                    file: file.projectRelPath,
+                    line,
+                    kind: 'method',
+                    name: fullName,
+                    signature: fullName + '(...)', // Simplified: no parameter extraction
+                    exports: false,
+                });
+                return;
+            }
+            // Field declarations (only public static final constants)
+            if (node.type === 'field_declaration') {
+                const modifiers = node.childForFieldName('modifiers');
+                const modText = modifiers ? file.content.slice(modifiers.startIndex, modifiers.endIndex) : '';
+                const isPublicStaticFinal = modText.includes('public') && modText.includes('static') && modText.includes('final');
+                if (!isPublicStaticFinal)
+                    return;
+                // Find declarator node
+                const declarator = node.childForFieldName('declarator');
+                if (!declarator)
+                    return;
+                const nameNode = declarator.childForFieldName('name');
+                if (!nameNode)
+                    return;
+                const fieldName = file.content.slice(nameNode.startIndex, nameNode.endIndex);
+                const line = nameNode.startPosition.row + 1;
+                const fullName = parentClass ? parentClass + '.' + fieldName : fieldName;
+                symbols.push({
+                    file: file.projectRelPath,
+                    line,
+                    kind: 'const',
+                    name: fullName,
+                    signature: fullName,
+                    exports: false,
+                });
+                return;
+            }
+            // Recurse into other nodes
+            for (let i = 0; i < node.childCount; i++) {
+                visit(node.child(i), parentClass);
+            }
+        };
+        visit(tree.rootNode);
+        return symbols;
+    }
+    /**
+     * 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) {
+        const pom = path.join(projectRoot, 'pom.xml');
+        const gradle = path.join(projectRoot, 'build.gradle');
+        const gradleKts = path.join(projectRoot, 'build.gradle.kts');
+        const manifestPath = fs.existsSync(pom)
+            ? pom
+            : fs.existsSync(gradle)
+                ? gradle
+                : fs.existsSync(gradleKts)
+                    ? gradleKts
+                    : null;
+        return { manifestPath, configPaths: [] };
+    }
+}
+//# sourceMappingURL=java-adapter.js.map

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

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

package/dist/knowledge/adapters/js-vue-adapter.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @file adapters/js-vue-adapter.ts
+ * Phase 2b-1 — JavaScript / Vue adapter (file-walk only).
+ *
+ * Targets plain-JS and Vue SFC projects that are NOT TypeScript.  Registered
+ * AFTER `TypeScriptAdapter` in `index.ts`: a real TS project (tsconfig.json or
+ * `.ts` sources) wins via `TypeScriptAdapter.detect`; a pure Vue/JS project
+ * (no tsconfig, no `.ts`) falls through to this adapter — fixing both the
+ * "collapsed to empty-set hash" path (TS claimed it but walked no `.ts`) and the
+ * "dropped from monorepo" path (no adapter matched at all).
+ *
+ * Vue SFC handling (Q4): `.vue` files contribute ONLY their `<script>` block to
+ * `content` (template/style stripped), extracted by regex — no AST, no native
+ * dependency.  Other JS variants (`.js/.jsx/.mjs/.cjs`) are walked whole.
+ *
+ * Phase 2b-1 is file-walk only: NO `parseSymbols` (deferred to Phase 2b-2).
+ */
+import type { LanguageAdapter, ModuleInfo, SourceFile } from './types.js';
+export declare class JsVueAdapter implements LanguageAdapter {
+    readonly name = "javascript";
+    readonly fileExtensions: readonly [".js", ".jsx", ".mjs", ".cjs", ".vue"];
+    /**
+     * Project is JS/Vue iff `package.json` exists AND at least one JS/Vue source
+     * file is reachable.  Because this adapter is registered AFTER
+     * `TypeScriptAdapter`, a real TS project is already claimed upstream; anything
+     * reaching here is, by construction, non-TS.  The source-existence probe also
+     * lets pure-frontend layouts (no `src/`) match, fixing the monorepo-drop path.
+     */
+    detect(projectRoot: string): boolean;
+    /**
+     * Prefer `<root>/src` (conventional); otherwise the project root itself
+     * (front-end apps frequently use `pages/`+`components/` with no `src/`).
+     */
+    discoverSourceRoots(projectRoot: string): string[];
+    /**
+     * With a `src/` layout each first-level subdir is a module (TS-like). Without
+     * `src/`, the whole project is one module (`root`).  Under a monorepo,
+     * `MonorepoAdapter` overrides the module page key with the sub-project dir
+     * name, so the inner `name` here is not user-facing — same as Java.
+     */
+    discoverModules(projectRoot: string): ModuleInfo[];
+    /**
+     * Recursively collect JS/Vue files.  For `.vue`, only the `<script>` block(s)
+     * are stored as `content` (Q4); other extensions are stored whole.
+     */
+    walkModuleFiles(module: ModuleInfo): Promise<SourceFile[]>;
+    /**
+     * Describe project metadata.  Manifest = `package.json`; config paths gather
+     * the well-known build configs when present.
+     */
+    describeProjectMeta(projectRoot: string): {
+        manifestPath: string | null;
+        configPaths: string[];
+    };
+}
+//# sourceMappingURL=js-vue-adapter.d.ts.map

package/dist/knowledge/adapters/js-vue-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"js-vue-adapter.d.ts","sourceRoot":"","sources":["../../../src/knowledge/adapters/js-vue-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAkE1E,qBAAa,YAAa,YAAW,eAAe;IAClD,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,cAAc,mDAAoD;IAE3E;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAKpC;;;OAGG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;IAMlD;;;;;OAKG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,EAAE;IA0BlD;;;OAGG;IACG,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAwChE;;;OAGG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG;QAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,WAAW,EAAE,MAAM,EAAE,CAAA;KAAE;CAcjG"}