codesift-mcp 0.3.0 → 0.4.0

package/dist/utils/language-detect.js

@@ -0,0 +1,183 @@
+/**
+ * Quick language detection for a project directory — runs BEFORE indexing.
+ *
+ * Used by registerTools() to gate language-specific tools behind language
+ * presence: PHP tools only surface if the project has .php files, Python
+ * tools only surface if the project has .py files, etc.
+ *
+ * Performance: fast file-tree walk with early-exit per language. Caps at
+ * ~2000 files to avoid slow startup on huge monorepos.
+ */
+import { readdir, stat } from "node:fs/promises";
+import { join } from "node:path";
+const IGNORE_DIRS = new Set([
+    "node_modules",
+    ".git",
+    "dist",
+    "build",
+    "target",
+    ".venv",
+    "venv",
+    "__pycache__",
+    ".pytest_cache",
+    ".mypy_cache",
+    ".next",
+    ".nuxt",
+    "vendor", // PHP composer deps
+    "site-packages", // inside .venv
+    ".tox",
+    "coverage",
+    ".idea",
+    ".vscode",
+]);
+const EXTENSION_MAP = {
+    ".py": "python",
+    ".php": "php",
+    ".ts": "typescript",
+    ".tsx": "typescript",
+    ".js": "javascript",
+    ".jsx": "javascript",
+    ".mjs": "javascript",
+    ".cjs": "javascript",
+    ".kt": "kotlin",
+    ".kts": "kotlin",
+    ".go": "go",
+    ".rs": "rust",
+    ".rb": "ruby",
+};
+const MAX_FILES_SCANNED = 2000;
+/**
+ * Scan a directory for source file extensions, returning which languages
+ * are present. Short-circuits once all tracked languages are found.
+ */
+export async function detectProjectLanguages(root) {
+    const found = {
+        python: false,
+        php: false,
+        typescript: false,
+        javascript: false,
+        kotlin: false,
+        go: false,
+        rust: false,
+        ruby: false,
+    };
+    let filesScanned = 0;
+    async function walk(dir) {
+        if (filesScanned >= MAX_FILES_SCANNED)
+            return;
+        if (allDetected(found))
+            return;
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (filesScanned >= MAX_FILES_SCANNED)
+                return;
+            if (allDetected(found))
+                return;
+            if (entry.name.startsWith(".") && entry.name !== ".github")
+                continue;
+            if (IGNORE_DIRS.has(entry.name))
+                continue;
+            const fullPath = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                await walk(fullPath);
+            }
+            else if (entry.isFile()) {
+                filesScanned++;
+                const dot = entry.name.lastIndexOf(".");
+                if (dot === -1)
+                    continue;
+                const ext = entry.name.slice(dot);
+                const lang = EXTENSION_MAP[ext];
+                if (lang)
+                    found[lang] = true;
+            }
+        }
+    }
+    try {
+        const rootStat = await stat(root);
+        if (!rootStat.isDirectory())
+            return found;
+    }
+    catch {
+        return found;
+    }
+    await walk(root);
+    return found;
+}
+function allDetected(found) {
+    return found.python && found.php && found.typescript && found.javascript
+        && found.kotlin && found.go && found.rust && found.ruby;
+}
+/**
+ * Synchronous variant for use during server startup where top-level await
+ * isn't convenient. Uses readdirSync. Caps at MAX_FILES_SCANNED.
+ */
+export function detectProjectLanguagesSync(root) {
+    const found = {
+        python: false,
+        php: false,
+        typescript: false,
+        javascript: false,
+        kotlin: false,
+        go: false,
+        rust: false,
+        ruby: false,
+    };
+    // Dynamic require to avoid import-order issues in ESM
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const { readdirSync, statSync } = require("node:fs");
+    let filesScanned = 0;
+    function walk(dir) {
+        if (filesScanned >= MAX_FILES_SCANNED)
+            return;
+        if (allDetected(found))
+            return;
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (filesScanned >= MAX_FILES_SCANNED)
+                return;
+            if (allDetected(found))
+                return;
+            if (entry.name.startsWith(".") && entry.name !== ".github")
+                continue;
+            if (IGNORE_DIRS.has(entry.name))
+                continue;
+            const fullPath = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                walk(fullPath);
+            }
+            else if (entry.isFile()) {
+                filesScanned++;
+                const dot = entry.name.lastIndexOf(".");
+                if (dot === -1)
+                    continue;
+                const ext = entry.name.slice(dot);
+                const lang = EXTENSION_MAP[ext];
+                if (lang)
+                    found[lang] = true;
+            }
+        }
+    }
+    try {
+        if (!statSync(root).isDirectory())
+            return found;
+    }
+    catch {
+        return found;
+    }
+    walk(root);
+    return found;
+}
+//# sourceMappingURL=language-detect.js.map

package/dist/utils/language-detect.js.map

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

package/dist/utils/nextjs-ast-readers.d.ts

@@ -0,0 +1,44 @@
+import type Parser from "web-tree-sitter";
+export interface ZodFieldType {
+    type: string;
+    constraints?: string[];
+    nested?: Record<string, ZodFieldType>;
+    optional?: boolean;
+    nullable?: boolean;
+}
+export interface ZodShape {
+    fields: Record<string, ZodFieldType>;
+    partial: boolean;
+}
+/**
+ * Extract the shape of a top-level Zod schema from a source tree.
+ *
+ * Walks `variable_declarator` nodes and tries each one's initializer. Returns
+ * the first successfully parsed Zod schema, or `null` when no z.object(...) is
+ * found. Other validation libraries (Yup, Joi, etc.) intentionally return null
+ * — downstream tools wrap this and add `schema_lib: "unknown"` at their own
+ * aggregation level.
+ */
+export declare function extractZodSchema(tree: Parser.Tree, _source: string): ZodShape | null;
+export type LinkRefKind = "link" | "router_push" | "router_replace";
+export interface LinkRef {
+    /** Literal href value when isDynamic=false; raw expression text otherwise. */
+    href: string;
+    /** True if the href is a template literal with substitutions or a non-literal expression. */
+    isDynamic: boolean;
+    /** 1-indexed line number of the attribute / call site. */
+    line: number;
+    /** The kind of navigation source. */
+    kind: LinkRefKind;
+}
+/**
+ * Extract navigation target references from a parsed tree:
+ *   - `<Link href="/path">` JSX components
+ *   - `router.push("/path")` / `router.replace("/path")` call sites
+ *
+ * Literal string values populate `href` with the unquoted content and
+ * `isDynamic: false`. Template literals with substitutions and identifier
+ * references populate `href` with the raw expression text and `isDynamic: true`.
+ */
+export declare function extractLinkHrefs(tree: Parser.Tree, _source: string): LinkRef[];
+//# sourceMappingURL=nextjs-ast-readers.d.ts.map

package/dist/utils/nextjs-ast-readers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs-ast-readers.d.ts","sourceRoot":"","sources":["../../src/utils/nextjs-ast-readers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAC;AAgF1C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrC,OAAO,EAAE,OAAO,CAAC;CAClB;AAkHD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAqBpF;AAMD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,aAAa,GAAG,gBAAgB,CAAC;AAEpE,MAAM,WAAW,OAAO;IACtB,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,6FAA6F;IAC7F,SAAS,EAAE,OAAO,CAAC;IACnB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,IAAI,EAAE,WAAW,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,CAgG9E"}

package/dist/utils/nextjs-ast-readers.js

@@ -0,0 +1,341 @@
+import { readStringLiteral } from "./nextjs-metadata-readers.js";
+// ---------------------------------------------------------------------------
+// Zod schema extraction (T2, T3 helper)
+// ---------------------------------------------------------------------------
+/** Allowed top-level Zod field methods. */
+const ZOD_FIELD_METHODS = new Set([
+    "object",
+    "string",
+    "number",
+    "boolean",
+    "array",
+    "union",
+    "enum",
+    "literal",
+    "optional",
+    "nullable",
+    "record",
+    "tuple",
+    "discriminatedUnion",
+    "date",
+    "any",
+    "unknown",
+    "bigint",
+    "void",
+    "never",
+    "null",
+    "undefined",
+]);
+/** Allowed chained refinement methods (non-structural). */
+const ZOD_CHAIN_METHODS = new Set([
+    "extend",
+    "merge",
+    "omit",
+    "pick",
+    "strict",
+    "refine",
+    "superRefine",
+    "transform",
+    "brand",
+    "describe",
+    "default",
+    "catch",
+    "readonly",
+    "optional",
+    "nullable",
+    "nullish",
+]);
+/** Per-type constraint methods that we record (not exhaustive — tracks common cases). */
+const ZOD_CONSTRAINT_METHODS = new Set([
+    "int",
+    "min",
+    "max",
+    "length",
+    "email",
+    "url",
+    "uuid",
+    "regex",
+    "startsWith",
+    "endsWith",
+    "positive",
+    "negative",
+    "nonnegative",
+    "nonpositive",
+    "gt",
+    "gte",
+    "lt",
+    "lte",
+    "multipleOf",
+    "finite",
+    "safe",
+    "trim",
+    "toLowerCase",
+    "toUpperCase",
+]);
+/**
+ * Unwrap a call expression like `z.object({...}).strict().refine(...)` down to
+ * the root z.<method>(...) invocation. Returns the underlying call node, the
+ * captured field method, and any collected chain modifiers.
+ */
+function unwrapZodChain(call) {
+    const chain = [];
+    let partial = false;
+    let cur = call;
+    while (cur.type === "call_expression") {
+        const fn = cur.childForFieldName("function") ?? cur.namedChild(0);
+        if (!fn)
+            return null;
+        // z.<method>(...) — base case
+        if (fn.type === "member_expression") {
+            const obj = fn.childForFieldName("object") ?? fn.namedChild(0);
+            const prop = fn.childForFieldName("property") ?? fn.namedChild(1);
+            if (obj?.type === "identifier" && (obj.text === "z" || obj.text === "zod")) {
+                if (prop?.type !== "property_identifier")
+                    return null;
+                const method = prop.text;
+                if (!ZOD_FIELD_METHODS.has(method))
+                    return null;
+                return { rootCall: cur, rootMethod: method, chain, partial };
+            }
+            // Chained: <inner>.<chainMethod>(...)
+            if (prop?.type === "property_identifier") {
+                const method = prop.text;
+                if (ZOD_CHAIN_METHODS.has(method)) {
+                    chain.unshift(method);
+                    if (method === "extend" || method === "merge")
+                        partial = true;
+                    if (!obj)
+                        return null;
+                    if (obj.type === "call_expression") {
+                        cur = obj;
+                        continue;
+                    }
+                    // Identifier base (e.g. `BaseSchema.extend(...)`)
+                    return null;
+                }
+                if (ZOD_CONSTRAINT_METHODS.has(method)) {
+                    chain.unshift(method);
+                    if (!obj)
+                        return null;
+                    if (obj.type === "call_expression") {
+                        cur = obj;
+                        continue;
+                    }
+                    return null;
+                }
+                // Unknown chain method on unknown base
+                return null;
+            }
+        }
+        // Not a Zod chain
+        return null;
+    }
+    return null;
+}
+/** Recursively parse a single field call like `z.string()` into a ZodFieldType. */
+function parseZodField(call) {
+    const unwrapped = unwrapZodChain(call);
+    if (!unwrapped)
+        return null;
+    const { rootCall, rootMethod, chain } = unwrapped;
+    const field = { type: rootMethod };
+    const constraints = chain.filter((c) => ZOD_CONSTRAINT_METHODS.has(c));
+    if (constraints.length > 0)
+        field.constraints = constraints;
+    if (chain.includes("optional"))
+        field.optional = true;
+    if (chain.includes("nullable") || chain.includes("nullish"))
+        field.nullable = true;
+    if (rootMethod === "object") {
+        const args = rootCall.childForFieldName("arguments") ?? rootCall.namedChild(1);
+        if (args) {
+            const objArg = args.namedChildren.find((c) => c.type === "object");
+            if (objArg) {
+                const nested = parseZodObjectArg(objArg);
+                if (nested)
+                    field.nested = nested;
+            }
+        }
+    }
+    return field;
+}
+/** Walk an `{ key: z.<method>(), ... }` object literal into a fields map. */
+function parseZodObjectArg(objNode) {
+    if (objNode.type !== "object")
+        return null;
+    const out = {};
+    for (const pair of objNode.namedChildren) {
+        if (pair.type !== "pair")
+            continue;
+        const key = pair.childForFieldName("key") ?? pair.namedChild(0);
+        if (!key)
+            continue;
+        let keyText = null;
+        if (key.type === "property_identifier" || key.type === "identifier") {
+            keyText = key.text;
+        }
+        else if (key.type === "string") {
+            keyText = readStringLiteral(key);
+        }
+        if (!keyText)
+            continue;
+        const value = pair.childForFieldName("value") ?? pair.namedChild(1);
+        if (!value || value.type !== "call_expression")
+            continue;
+        const field = parseZodField(value);
+        if (field)
+            out[keyText] = field;
+    }
+    return out;
+}
+/**
+ * Extract the shape of a top-level Zod schema from a source tree.
+ *
+ * Walks `variable_declarator` nodes and tries each one's initializer. Returns
+ * the first successfully parsed Zod schema, or `null` when no z.object(...) is
+ * found. Other validation libraries (Yup, Joi, etc.) intentionally return null
+ * — downstream tools wrap this and add `schema_lib: "unknown"` at their own
+ * aggregation level.
+ */
+export function extractZodSchema(tree, _source) {
+    const root = tree.rootNode;
+    for (const decl of root.descendantsOfType("variable_declarator")) {
+        const value = decl.childForFieldName("value");
+        if (!value || value.type !== "call_expression")
+            continue;
+        const unwrapped = unwrapZodChain(value);
+        if (!unwrapped)
+            continue;
+        if (unwrapped.rootMethod !== "object")
+            continue;
+        const args = unwrapped.rootCall.childForFieldName("arguments") ?? unwrapped.rootCall.namedChild(1);
+        if (!args)
+            continue;
+        const objArg = args.namedChildren.find((c) => c.type === "object");
+        if (!objArg)
+            continue;
+        const fields = parseZodObjectArg(objArg);
+        if (!fields)
+            continue;
+        return { fields, partial: unwrapped.partial };
+    }
+    return null;
+}
+/**
+ * Extract navigation target references from a parsed tree:
+ *   - `<Link href="/path">` JSX components
+ *   - `router.push("/path")` / `router.replace("/path")` call sites
+ *
+ * Literal string values populate `href` with the unquoted content and
+ * `isDynamic: false`. Template literals with substitutions and identifier
+ * references populate `href` with the raw expression text and `isDynamic: true`.
+ */
+export function extractLinkHrefs(tree, _source) {
+    const refs = [];
+    const root = tree.rootNode;
+    // <Link href="...">
+    for (const opening of root.descendantsOfType("jsx_opening_element")) {
+        const name = opening.childForFieldName("name") ?? opening.namedChild(0);
+        if (name?.type !== "identifier" || name.text !== "Link")
+            continue;
+        for (const attr of opening.namedChildren) {
+            if (attr.type !== "jsx_attribute")
+                continue;
+            const attrName = attr.namedChild(0);
+            if (!attrName)
+                continue;
+            const attrNameText = attrName.type === "property_identifier" || attrName.type === "identifier"
+                ? attrName.text
+                : null;
+            if (attrNameText !== "href")
+                continue;
+            const value = attr.namedChild(1);
+            if (!value)
+                continue;
+            const line = attr.startPosition.row + 1;
+            if (value.type === "string") {
+                const s = readStringLiteral(value);
+                refs.push({
+                    href: s ?? value.text,
+                    isDynamic: false,
+                    line,
+                    kind: "link",
+                });
+            }
+            else if (value.type === "jsx_expression") {
+                const inner = value.namedChildren[0];
+                if (!inner)
+                    continue;
+                if (inner.type === "string") {
+                    const s = readStringLiteral(inner);
+                    refs.push({ href: s ?? inner.text, isDynamic: false, line, kind: "link" });
+                }
+                else if (inner.type === "template_string") {
+                    // template literal — dynamic unless fully literal
+                    const hasSubs = inner.namedChildren.some((c) => c.type === "template_substitution");
+                    if (!hasSubs) {
+                        const literal = readStringLiteral(inner);
+                        refs.push({
+                            href: literal ?? inner.text,
+                            isDynamic: false,
+                            line,
+                            kind: "link",
+                        });
+                    }
+                    else {
+                        refs.push({ href: inner.text, isDynamic: true, line, kind: "link" });
+                    }
+                }
+                else {
+                    // identifier, call, etc. — dynamic
+                    refs.push({ href: inner.text, isDynamic: true, line, kind: "link" });
+                }
+            }
+        }
+    }
+    // router.push(...) / router.replace(...)
+    for (const call of root.descendantsOfType("call_expression")) {
+        const fn = call.childForFieldName("function") ?? call.namedChild(0);
+        if (!fn || fn.type !== "member_expression")
+            continue;
+        const obj = fn.childForFieldName("object") ?? fn.namedChild(0);
+        const prop = fn.childForFieldName("property") ?? fn.namedChild(1);
+        if (obj?.type !== "identifier" || obj.text !== "router")
+            continue;
+        if (prop?.type !== "property_identifier")
+            continue;
+        const method = prop.text;
+        if (method !== "push" && method !== "replace")
+            continue;
+        const args = call.childForFieldName("arguments") ?? call.namedChild(1);
+        const firstArg = args?.namedChildren[0];
+        if (!firstArg)
+            continue;
+        const line = call.startPosition.row + 1;
+        const kind = method === "push" ? "router_push" : "router_replace";
+        if (firstArg.type === "string") {
+            const s = readStringLiteral(firstArg);
+            refs.push({
+                href: s ?? firstArg.text,
+                isDynamic: false,
+                line,
+                kind,
+            });
+        }
+        else if (firstArg.type === "template_string") {
+            const hasSubs = firstArg.namedChildren.some((c) => c.type === "template_substitution");
+            if (!hasSubs) {
+                const literal = readStringLiteral(firstArg);
+                refs.push({ href: literal ?? firstArg.text, isDynamic: false, line, kind });
+            }
+            else {
+                refs.push({ href: firstArg.text, isDynamic: true, line, kind });
+            }
+        }
+        else {
+            refs.push({ href: firstArg.text, isDynamic: true, line, kind });
+        }
+    }
+    return refs;
+}
+//# sourceMappingURL=nextjs-ast-readers.js.map

package/dist/utils/nextjs-ast-readers.js.map

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

package/dist/utils/nextjs-audit-cache.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Shared cache for the Next.js framework audit (T11).
+ *
+ * Sub-tools called by `frameworkAudit` re-walk the same files and re-parse
+ * the same trees. This cache shares parsed tree promises and walk results
+ * across sub-tools, with a TTL eviction policy so long-running servers don't
+ * grow unbounded.
+ *
+ * Pattern: promise-sharing (not result caching). Concurrent calls for the
+ * same key reuse the in-flight promise. After resolution, the result stays
+ * in cache until the TTL expires.
+ */
+import type Parser from "web-tree-sitter";
+import { type WalkOptions } from "./walk.js";
+/** Activate the shared cache (called by frameworkAudit at start). */
+export declare function activateGlobalCache(): NextjsAuditCache;
+/** Deactivate and clear (called by frameworkAudit at end). */
+export declare function deactivateGlobalCache(): void;
+/** Get the active cache, or null if not in a framework_audit context. */
+export declare function getGlobalCache(): NextjsAuditCache | null;
+/**
+ * Proxy for walkDirectory that uses global cache when active.
+ * Drop-in replacement — same signature as walkDirectory.
+ */
+export declare function cachedWalkDirectory(root: string, options?: WalkOptions): Promise<string[]>;
+/**
+ * Proxy for parseFile that uses global cache when active.
+ * Drop-in replacement — same signature as parseFile.
+ */
+export declare function cachedParseFile(path: string, source: string): Promise<Parser.Tree | null>;
+export declare class NextjsAuditCache {
+    private parseFileCache;
+    private walkCache;
+    private readonly ttl;
+    constructor();
+    /**
+     * Parse and cache a file. Concurrent calls share the same promise.
+     * Synchronous (returns the cached/in-flight Promise directly) so that
+     * `cache.getParsedFile(p) === cache.getParsedFile(p)` for concurrent calls.
+     */
+    getParsedFile(path: string, source: string): Promise<Parser.Tree | null>;
+    /** Walk and cache a directory. Concurrent calls share the same promise. */
+    getWalk(root: string, options?: WalkOptions): Promise<string[]>;
+    /** Clear all entries. */
+    clear(): void;
+    /** Total cached entries. */
+    size(): number;
+    /** Evict entries whose TTL has passed. */
+    private evictExpired;
+}
+//# sourceMappingURL=nextjs-audit-cache.d.ts.map

package/dist/utils/nextjs-audit-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs-audit-cache.d.ts","sourceRoot":"","sources":["../../src/utils/nextjs-audit-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAC;AAE1C,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAc5D,qEAAqE;AACrE,wBAAgB,mBAAmB,IAAI,gBAAgB,CAGtD;AAED,8DAA8D;AAC9D,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AAED,yEAAyE;AACzE,wBAAgB,cAAc,IAAI,gBAAgB,GAAG,IAAI,CAExD;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGhG;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,CAG/F;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,cAAc,CAA0D;IAChF,OAAO,CAAC,SAAS,CAAgD;IACjE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;;IAY7B;;;;OAIG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;IAcxE,2EAA2E;IAC3E,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAe/D,yBAAyB;IACzB,KAAK,IAAI,IAAI;IAKb,4BAA4B;IAC5B,IAAI,IAAI,MAAM;IAId,0CAA0C;IAC1C,OAAO,CAAC,YAAY;CAQrB"}