@vizalice/codegraph 1.5.0

package/dist/extraction/razor-extractor.js

@@ -0,0 +1,285 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RazorExtractor = void 0;
+const tree_sitter_helpers_1 = require("./tree-sitter-helpers");
+const tree_sitter_1 = require("./tree-sitter");
+const grammars_1 = require("./grammars");
+/**
+ * RazorExtractor — extracts code relationships from ASP.NET Razor (`.cshtml`)
+ * and Blazor (`.razor`) markup.
+ *
+ * Markup-driven code-behind, view-models, components, and DTOs are referenced
+ * only from markup the engine otherwise doesn't parse, so they look like nothing
+ * depends on them. This extractor links the markup → the C# types it names:
+ *
+ *  - `@model Foo` / `@inherits Bar<Foo>`  → the view-model / base type (.cshtml + .razor)
+ *  - `@inject IService svc`               → the injected service type
+ *  - `@typeof(MainLayout)`                → the referenced type
+ *  - `<MyComponent .../>` (Blazor only)   → the component class (.razor or `.cs : ComponentBase`)
+ *  - `<Grid TItem="CatalogItem">`         → the generic type argument
+ *
+ * Risk mitigations (see docs/design/template-markup-parser.md):
+ *  - Only PascalCase (`[A-Z]`-initial) tags are treated as components — HTML
+ *    elements are lowercase, so they never match. Known Blazor framework
+ *    components are skipped (they aren't in-repo, so a ref would just dangle).
+ *  - Exactly ONE `component` node per file; component tags become `references`
+ *    EDGES, never nodes — no per-tag node explosion.
+ *  - Emitted refs are ordinary by-name `references` resolved by the name-matcher;
+ *    `razor` shares the `dotnet` language family with `csharp` (name-matcher.ts)
+ *    so the cross-family gate doesn't drop them.
+ *  - `.cshtml`/`.razor` are registered in grammars.ts so they're indexed.
+ *
+ * Out of scope (data-flow / low-value): `asp-for`/`th:field` property-string
+ * bindings; the C# inside `@code { }` / `@{ }` blocks (noisy regex on embedded C#).
+ */
+/**
+ * Blazor framework-provided components — invoked by the runtime, not defined
+ * in-repo, so a reference to them would never resolve. Skip to avoid dangling refs.
+ */
+const BLAZOR_BUILTIN_COMPONENTS = new Set([
+    'Router', 'Found', 'NotFound', 'RouteView', 'AuthorizeRouteView', 'LayoutView',
+    'CascadingValue', 'CascadingAuthenticationState', 'AuthorizeView', 'Authorized',
+    'NotAuthorized', 'Authorizing', 'EditForm', 'DataAnnotationsValidator',
+    'ValidationSummary', 'ValidationMessage', 'InputText', 'InputNumber',
+    'InputCheckbox', 'InputSelect', 'InputDate', 'InputTextArea', 'InputRadio',
+    'InputRadioGroup', 'InputFile', 'PageTitle', 'HeadContent', 'HeadOutlet',
+    'Virtualize', 'DynamicComponent', 'ErrorBoundary', 'SectionContent',
+    'SectionOutlet', 'FocusOnNavigate', 'NavLink', 'Microsoft',
+]);
+class RazorExtractor {
+    filePath;
+    source;
+    nodes = [];
+    edges = [];
+    unresolvedReferences = [];
+    errors = [];
+    constructor(filePath, source) {
+        this.filePath = filePath;
+        this.source = source;
+    }
+    extract() {
+        const startTime = Date.now();
+        try {
+            const componentId = this.createComponentNode().id;
+            this.extractDirectives(componentId);
+            // Blazor component tags only — `.cshtml` uses HTML + tag helpers, not
+            // PascalCase component elements.
+            if (this.filePath.toLowerCase().endsWith('.razor')) {
+                this.extractComponentTags(componentId);
+            }
+            // Delegate the C# in `@code { }` / `@functions { }` / `@{ }` blocks to the
+            // C# tree-sitter extractor (the Blazor analog of Svelte's <script> block) —
+            // this is where component logic uses services/DTOs, so it covers the types
+            // referenced only from component code.
+            this.processCodeBlocks(componentId);
+        }
+        catch (error) {
+            this.errors.push({
+                message: `Razor extraction error: ${error instanceof Error ? error.message : String(error)}`,
+                severity: 'error',
+                code: 'parse_error',
+            });
+        }
+        return {
+            nodes: this.nodes,
+            edges: this.edges,
+            unresolvedReferences: this.unresolvedReferences,
+            errors: this.errors,
+            durationMs: Date.now() - startTime,
+        };
+    }
+    createComponentNode() {
+        const lines = this.source.split('\n');
+        const fileName = this.filePath.split(/[/\\]/).pop() || this.filePath;
+        const componentName = fileName.replace(/\.(razor|cshtml)$/i, '');
+        const node = {
+            id: (0, tree_sitter_helpers_1.generateNodeId)(this.filePath, 'component', componentName, 1),
+            kind: 'component',
+            name: componentName,
+            qualifiedName: `${this.filePath}::${componentName}`,
+            filePath: this.filePath,
+            language: 'razor',
+            startLine: 1,
+            endLine: lines.length,
+            startColumn: 0,
+            endColumn: lines[lines.length - 1]?.length || 0,
+            isExported: true,
+            updatedAt: Date.now(),
+        };
+        this.nodes.push(node);
+        return node;
+    }
+    /** Last `.`-segment (`App.ViewModels.RegisterModel` → `RegisterModel`). */
+    lastSegment(s) {
+        const i = s.lastIndexOf('.');
+        return i >= 0 ? s.slice(i + 1) : s;
+    }
+    /**
+     * Split a type expression into the capitalized type names it contains — base
+     * type plus any generic arguments (`Bar<Foo, Baz>` → `Bar`, `Foo`, `Baz`),
+     * each reduced to its last namespace segment. Lowercase/keyword tokens drop out.
+     */
+    typeNames(expr) {
+        const out = [];
+        for (const raw of expr.split(/[<>,\s]+/)) {
+            const seg = this.lastSegment(raw.trim());
+            if (/^[A-Z][A-Za-z0-9_]*$/.test(seg))
+                out.push(seg);
+        }
+        return out;
+    }
+    pushRef(componentId, name, line, column) {
+        this.unresolvedReferences.push({
+            fromNodeId: componentId,
+            referenceName: name,
+            referenceKind: 'references',
+            line,
+            column,
+            filePath: this.filePath,
+            language: 'razor',
+        });
+    }
+    extractDirectives(componentId) {
+        const lines = this.source.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // `@model Foo` / `@inherits Bar<Foo>` — directive followed by a type.
+            const dir = line.match(/^\s*@(?:model|inherits)\s+([A-Za-z_][\w.]*(?:\s*<[^>]+>)?)/);
+            if (dir)
+                for (const t of this.typeNames(dir[1]))
+                    this.pushRef(componentId, t, i + 1, 0);
+            // `@inject IService name` — the type is the first token, a name follows.
+            const inj = line.match(/^\s*@inject\s+([A-Za-z_][\w.]*(?:\s*<[^>]+>)?)\s+[A-Za-z_]/);
+            if (inj)
+                for (const t of this.typeNames(inj[1]))
+                    this.pushRef(componentId, t, i + 1, 0);
+            // `@typeof(X)` anywhere on the line.
+            for (const m of line.matchAll(/@typeof\(\s*([A-Za-z_][\w.]*)\s*\)/g)) {
+                const seg = this.lastSegment(m[1]);
+                if (/^[A-Z]/.test(seg))
+                    this.pushRef(componentId, seg, i + 1, m.index ?? 0);
+            }
+        }
+    }
+    extractComponentTags(componentId) {
+        const lines = this.source.split('\n');
+        // PascalCase opening / self-closing tags. Closing tags (`</Foo>`) start with
+        // `</` and are skipped. HTML elements are lowercase → never match.
+        const tagRe = /<([A-Z][A-Za-z0-9_]*)\b([^>]*)>/g;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            let m;
+            while ((m = tagRe.exec(line)) !== null) {
+                const name = m[1];
+                if (BLAZOR_BUILTIN_COMPONENTS.has(name))
+                    continue;
+                this.pushRef(componentId, name, i + 1, m.index + 1);
+                // Generic component type arg: `<Grid TItem="CatalogItem">`.
+                for (const t of (m[2] || '').matchAll(/\bT[A-Za-z]*\s*=\s*"([A-Za-z_][\w.]*)"/g)) {
+                    const seg = this.lastSegment(t[1]);
+                    if (/^[A-Z]/.test(seg))
+                        this.pushRef(componentId, seg, i + 1, 0);
+                }
+            }
+        }
+    }
+    /**
+     * Find the matching `}` for the `{` at `openIdx`, skipping string literals and
+     * comments so a brace inside `"{"` / `// }` doesn't throw off the count.
+     * Returns the index of the closing brace, or -1 if unbalanced.
+     */
+    matchBrace(src, openIdx) {
+        let depth = 0;
+        for (let i = openIdx; i < src.length; i++) {
+            const ch = src[i];
+            if (ch === '"' || ch === "'") {
+                const quote = ch;
+                i++;
+                while (i < src.length && src[i] !== quote) {
+                    if (src[i] === '\\')
+                        i++;
+                    i++;
+                }
+                continue;
+            }
+            if (ch === '/' && src[i + 1] === '/') {
+                while (i < src.length && src[i] !== '\n')
+                    i++;
+                continue;
+            }
+            if (ch === '/' && src[i + 1] === '*') {
+                i += 2;
+                while (i < src.length && !(src[i] === '*' && src[i + 1] === '/'))
+                    i++;
+                i++;
+                continue;
+            }
+            if (ch === '{')
+                depth++;
+            else if (ch === '}') {
+                depth--;
+                if (depth === 0)
+                    return i;
+            }
+        }
+        return -1;
+    }
+    /** `@code { … }` / `@functions { … }` (Blazor) and `@{ … }` (Razor) C# blocks. */
+    extractCodeBlocks() {
+        const blocks = [];
+        const re = /@(?:code|functions)\b\s*\{|@\{/g;
+        let m;
+        while ((m = re.exec(this.source)) !== null) {
+            const openIdx = this.source.indexOf('{', m.index);
+            if (openIdx < 0)
+                continue;
+            const close = this.matchBrace(this.source, openIdx);
+            if (close < 0)
+                continue;
+            const content = this.source.slice(openIdx + 1, close);
+            // newlines before the content's first char → 0-indexed line of content start
+            const lineOffset = (this.source.slice(0, openIdx + 1).match(/\n/g) || []).length;
+            blocks.push({ content, lineOffset });
+            re.lastIndex = close;
+        }
+        return blocks;
+    }
+    /**
+     * Delegate each `@code`/`@functions`/`@{` block's C# to the tree-sitter C#
+     * extractor and attribute the block's external references (service/DTO calls,
+     * `new X()`, type uses) to the component. The block is wrapped in a synthetic
+     * class so tree-sitter parses the component's fields/methods in a class context
+     * (a Blazor `@code` body compiles into the component's partial class). We keep
+     * only the dependency references — coverage just needs the edges to external
+     * types, not per-member nodes. Degrades gracefully if the C# grammar isn't loaded.
+     */
+    processCodeBlocks(componentId) {
+        if (!(0, grammars_1.isLanguageSupported)('csharp'))
+            return;
+        for (const block of this.extractCodeBlocks()) {
+            if (!block.content.trim())
+                continue;
+            let result;
+            try {
+                result = new tree_sitter_1.TreeSitterExtractor(this.filePath, `class __RazorCode__ {\n${block.content}\n}`, 'csharp').extract();
+            }
+            catch {
+                continue; // grammar not loaded / parse failure — skip this block
+            }
+            // The synthetic wrapper adds one line before the block content; map ref
+            // lines back to the .razor file (display only — coverage is line-agnostic).
+            for (const ref of result.unresolvedReferences) {
+                this.unresolvedReferences.push({
+                    ...ref,
+                    fromNodeId: componentId,
+                    line: ref.line + block.lineOffset - 1,
+                    column: ref.column,
+                    filePath: this.filePath,
+                    language: 'razor',
+                });
+            }
+        }
+    }
+}
+exports.RazorExtractor = RazorExtractor;
+//# sourceMappingURL=razor-extractor.js.map

package/dist/extraction/razor-extractor.js.map

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

package/dist/extraction/store-worker.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Store worker — dedicated writer thread for the bulk-index store phase.
+ *
+ * During a fresh full index the main thread's biggest serial cost is executing
+ * the per-file INSERT batches. This worker owns that work on its own SQLite
+ * connection: the orchestrator posts one message per file (in file order) and
+ * the worker applies them in arrival order, which preserves the #1015
+ * insertion-order determinism exactly as if the main thread had run the same
+ * calls. The main thread performs NO database access while the writer is
+ * active (fresh-DB path only), so there is no cross-connection contention.
+ *
+ * Protocol (main → worker):
+ *   {type:'open', dbPath, fastInit}  → open connection, reply {type:'ready'}
+ *   {type:'bundle', bundle}          → apply one file's store bundle
+ *   {type:'drain', id}               → reply {type:'drained', id} (in-order ⇒ all prior bundles applied)
+ *   {type:'close'}                   → close DB and exit
+ * Worker → main: {type:'ready'} | {type:'drained', id} | {type:'error', message}
+ *
+ * A bundle failure does not kill the worker; the first error is reported and
+ * the client surfaces it at drain(), matching the main-thread path where a
+ * store exception propagates out of the ordered-flush chain.
+ */
+export {};
+//# sourceMappingURL=store-worker.d.ts.map

package/dist/extraction/store-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-worker.d.ts","sourceRoot":"","sources":["../../src/extraction/store-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG"}

package/dist/extraction/store-worker.js

@@ -0,0 +1,139 @@
+"use strict";
+/**
+ * Store worker — dedicated writer thread for the bulk-index store phase.
+ *
+ * During a fresh full index the main thread's biggest serial cost is executing
+ * the per-file INSERT batches. This worker owns that work on its own SQLite
+ * connection: the orchestrator posts one message per file (in file order) and
+ * the worker applies them in arrival order, which preserves the #1015
+ * insertion-order determinism exactly as if the main thread had run the same
+ * calls. The main thread performs NO database access while the writer is
+ * active (fresh-DB path only), so there is no cross-connection contention.
+ *
+ * Protocol (main → worker):
+ *   {type:'open', dbPath, fastInit}  → open connection, reply {type:'ready'}
+ *   {type:'bundle', bundle}          → apply one file's store bundle
+ *   {type:'drain', id}               → reply {type:'drained', id} (in-order ⇒ all prior bundles applied)
+ *   {type:'close'}                   → close DB and exit
+ * Worker → main: {type:'ready'} | {type:'drained', id} | {type:'error', message}
+ *
+ * A bundle failure does not kill the worker; the first error is reported and
+ * the client surfaces it at drain(), matching the main-thread path where a
+ * store exception propagates out of the ordered-flush chain.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+// Compile cache FIRST — same worker-boot rationale as parse-worker.ts.
+try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    require('node:module').enableCompileCache?.();
+}
+catch { /* cache is best-effort */ }
+const worker_threads_1 = require("worker_threads");
+const queries_1 = require("../db/queries");
+const sqlite_adapter_1 = require("../db/sqlite-adapter");
+const store_writer_1 = require("./store-writer");
+const decode_1 = require("./kernel/decode");
+if (!worker_threads_1.parentPort) {
+    throw new Error('store-worker must be run as a worker thread');
+}
+const port = worker_threads_1.parentPort;
+let db = null;
+let queries = null;
+// CODEGRAPH_SYNTH_TIMINGS: split the writer lane's busy time into its two
+// halves — kernel-buffer decode+finalize (JS-object materialization, the §4d
+// buffer→bind candidate) vs the SQL bundle store — printed once at close.
+const STORE_TIMINGS = !!process.env.CODEGRAPH_SYNTH_TIMINGS;
+let decodeNs = 0n;
+let storeNs = 0n;
+let bundleCount = 0;
+let kernelBundleCount = 0;
+/** Decode a kernel bundle's buffers into the standard pre-filtered StoreBundle. */
+function decodeKernelBundle(bundle) {
+    const asBuf = (u) => Buffer.from(u.buffer, u.byteOffset, u.byteLength);
+    const decoded = (0, decode_1.decodeExtractBuffers)({
+        meta: asBuf(bundle.buffers.meta),
+        nodes: asBuf(bundle.buffers.nodes),
+        edges: asBuf(bundle.buffers.edges),
+        refs: asBuf(bundle.buffers.refs),
+        arena: asBuf(bundle.buffers.arena),
+    }, bundle.filePath, bundle.language);
+    return (0, store_writer_1.finalizeStoreBundle)(decoded, bundle.filePath, bundle.language, bundle.file);
+}
+port.on('message', (msg) => {
+    try {
+        switch (msg.type) {
+            case 'open': {
+                const created = (0, sqlite_adapter_1.createDatabase)(msg.dbPath);
+                db = created.db;
+                // Mirrors db/index.ts configureConnection, with the same fast-init
+                // durability trade the main connection applies for fresh builds.
+                db.pragma('busy_timeout = 5000');
+                db.pragma('foreign_keys = ON');
+                if (msg.fastInit) {
+                    db.pragma('journal_mode = MEMORY');
+                    db.pragma('synchronous = OFF');
+                }
+                else {
+                    db.pragma('synchronous = NORMAL');
+                }
+                db.pragma('cache_size = -64000');
+                db.pragma('temp_store = MEMORY');
+                queries = new queries_1.QueryBuilder(db);
+                port.postMessage({ type: 'ready' });
+                break;
+            }
+            case 'bundle': {
+                if (!queries)
+                    throw new Error('store-worker: bundle before open');
+                if (STORE_TIMINGS) {
+                    bundleCount++;
+                    const t0 = process.hrtime.bigint();
+                    let bundle;
+                    if ('kernel' in msg.bundle) {
+                        kernelBundleCount++;
+                        bundle = decodeKernelBundle(msg.bundle);
+                    }
+                    else {
+                        bundle = msg.bundle;
+                    }
+                    const t1 = process.hrtime.bigint();
+                    queries.storeFileBundle(bundle);
+                    decodeNs += t1 - t0;
+                    storeNs += process.hrtime.bigint() - t1;
+                    port.postMessage({ type: 'ack' });
+                    break;
+                }
+                const bundle = 'kernel' in msg.bundle ? decodeKernelBundle(msg.bundle) : msg.bundle;
+                queries.storeFileBundle(bundle);
+                port.postMessage({ type: 'ack' });
+                break;
+            }
+            case 'drain': {
+                port.postMessage({ type: 'drained', id: msg.id });
+                break;
+            }
+            case 'close': {
+                if (STORE_TIMINGS && bundleCount > 0) {
+                    console.error(`[store-timing] bundles=${bundleCount} (kernel=${kernelBundleCount}) decode=${(Number(decodeNs / 1000000n) / 1000).toFixed(2)}s store=${(Number(storeNs / 1000000n) / 1000).toFixed(2)}s`);
+                }
+                try {
+                    db?.close();
+                }
+                catch {
+                    /* already closed */
+                }
+                process.exit(0);
+                break;
+            }
+        }
+    }
+    catch (err) {
+        // The error reply doubles as the bundle's ack so the client's outstanding
+        // counter still drains after a failure.
+        port.postMessage({
+            type: 'error',
+            message: err instanceof Error ? err.message : String(err),
+        });
+    }
+});
+//# sourceMappingURL=store-worker.js.map

package/dist/extraction/store-worker.js.map

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

package/dist/extraction/store-writer.d.ts

@@ -0,0 +1,63 @@
+/**
+ * StoreWriter — main-thread client for the store worker (see store-worker.ts).
+ *
+ * Used ONLY on the fresh-DB bulk path: bundles are posted in file order and the
+ * worker applies them in arrival order, so rowid assignment (and therefore
+ * resolution's insertion-order disambiguation) is byte-identical to the
+ * main-thread store. Kill switch: CODEGRAPH_NO_STORE_WORKER=1.
+ */
+import { ExtractionResult, Language, Node, Edge, UnresolvedReference, FileRecord } from '../types';
+/** One file's complete store payload (pre-filtered — see storeFileBundle). */
+export interface StoreBundle {
+    nodes: Node[];
+    edges: Edge[];
+    refs: UnresolvedReference[];
+    file: FileRecord;
+}
+/**
+ * A kernel deferred-decode payload: the file's raw table buffers plus the
+ * FileRecord the main thread built from meta counts. The store WORKER decodes
+ * and finalizes (same filters as the object path), so per-node objects never
+ * exist on the main thread.
+ */
+export interface KernelStoreBundle {
+    kernel: true;
+    filePath: string;
+    language: Language;
+    buffers: NonNullable<ExtractionResult['kernelBuffers']>;
+    file: FileRecord;
+}
+/**
+ * The validation/denormalization every bundle gets before storeFileBundle —
+ * shared by the orchestrator's object path and the store worker's kernel
+ * decode path so the two can never drift:
+ *   - nodes missing identity fields are dropped (#42-class safety),
+ *   - edges must connect inserted nodes (FK integrity),
+ *   - refs must originate from inserted nodes and carry the denormalized
+ *     filePath/language the resolver reads.
+ */
+export declare function finalizeStoreBundle(result: Pick<ExtractionResult, 'nodes' | 'edges' | 'unresolvedReferences'>, filePath: string, language: Language, file: FileRecord): StoreBundle;
+export declare class StoreWriter {
+    private worker;
+    private readyPromise;
+    private firstError;
+    private drainWaiters;
+    private nextDrainId;
+    private exited;
+    /** Bundles posted but not yet acked — the queue-depth backpressure signal. */
+    private outstanding;
+    private belowWaiters;
+    constructor(workerScriptPath: string, dbPath: string, fastInit: boolean);
+    private failAll;
+    private settleOne;
+    ready(): Promise<void>;
+    /** Post one file's bundle. Throws immediately if the writer already failed. */
+    send(bundle: StoreBundle | KernelStoreBundle): void;
+    /** Backpressure: resolves once fewer than `limit` bundles are un-acked. */
+    waitBelow(limit: number): Promise<void>;
+    /** Resolves when every bundle posted before this call has been applied. */
+    drain(): Promise<void>;
+    /** Close the worker's DB connection and join the thread. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=store-writer.d.ts.map

package/dist/extraction/store-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-writer.d.ts","sourceRoot":"","sources":["../../src/extraction/store-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEnG,8EAA8E;AAC9E,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,IAAI,EAAE,mBAAmB,EAAE,CAAC;IAC5B,IAAI,EAAE,UAAU,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,IAAI,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,WAAW,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC,CAAC;IACxD,IAAI,EAAE,UAAU,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,OAAO,GAAG,sBAAsB,CAAC,EAC1E,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,UAAU,GACf,WAAW,CAcb;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,YAAY,CAA0E;IAC9F,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,8EAA8E;IAC9E,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,YAAY,CAAqD;gBAE7D,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO;IA+CvE,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,SAAS;IAWjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,+EAA+E;IAC/E,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,GAAG,IAAI;IAOnD,2EAA2E;IAC3E,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvC,2EAA2E;IAC3E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAWtB,4DAA4D;IACtD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAa7B"}