codesift-mcp 0.3.0 → 0.5.0

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

package/dist/utils/nextjs-audit-cache.js

@@ -0,0 +1,116 @@
+/**
+ * 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 { parseFile } from "../parser/parser-manager.js";
+import { walkDirectory } from "./walk.js";
+const DEFAULT_TTL_MS = 60000;
+// ---------------------------------------------------------------------------
+// Module-level singleton for framework_audit to share across sub-tools
+// ---------------------------------------------------------------------------
+let _globalCache = null;
+/** Activate the shared cache (called by frameworkAudit at start). */
+export function activateGlobalCache() {
+    _globalCache = new NextjsAuditCache();
+    return _globalCache;
+}
+/** Deactivate and clear (called by frameworkAudit at end). */
+export function deactivateGlobalCache() {
+    _globalCache?.clear();
+    _globalCache = null;
+}
+/** Get the active cache, or null if not in a framework_audit context. */
+export function getGlobalCache() {
+    return _globalCache;
+}
+/**
+ * Proxy for walkDirectory that uses global cache when active.
+ * Drop-in replacement — same signature as walkDirectory.
+ */
+export async function cachedWalkDirectory(root, options) {
+    if (_globalCache)
+        return _globalCache.getWalk(root, options);
+    return walkDirectory(root, options);
+}
+/**
+ * Proxy for parseFile that uses global cache when active.
+ * Drop-in replacement — same signature as parseFile.
+ */
+export async function cachedParseFile(path, source) {
+    if (_globalCache)
+        return _globalCache.getParsedFile(path, source);
+    return parseFile(path, source);
+}
+export class NextjsAuditCache {
+    parseFileCache = new Map();
+    walkCache = new Map();
+    ttl;
+    constructor() {
+        const envTtl = process.env.NEXTJS_AST_CACHE_TTL_MS;
+        if (envTtl !== undefined) {
+            const parsed = Number(envTtl);
+            this.ttl = Number.isFinite(parsed) && parsed > 0 ? parsed : DEFAULT_TTL_MS;
+        }
+        else {
+            this.ttl = DEFAULT_TTL_MS;
+        }
+    }
+    /**
+     * 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, source) {
+        const now = Date.now();
+        this.evictExpired(now);
+        const cached = this.parseFileCache.get(path);
+        if (cached && cached.expires > now) {
+            return cached.promise;
+        }
+        const promise = parseFile(path, source);
+        this.parseFileCache.set(path, { promise, expires: now + this.ttl });
+        return promise;
+    }
+    /** Walk and cache a directory. Concurrent calls share the same promise. */
+    getWalk(root, options) {
+        const key = `${root}::${JSON.stringify(options ?? {})}`;
+        const now = Date.now();
+        this.evictExpired(now);
+        const cached = this.walkCache.get(key);
+        if (cached && cached.expires > now) {
+            return cached.promise;
+        }
+        const promise = walkDirectory(root, options);
+        this.walkCache.set(key, { promise, expires: now + this.ttl });
+        return promise;
+    }
+    /** Clear all entries. */
+    clear() {
+        this.parseFileCache.clear();
+        this.walkCache.clear();
+    }
+    /** Total cached entries. */
+    size() {
+        return this.parseFileCache.size + this.walkCache.size;
+    }
+    /** Evict entries whose TTL has passed. */
+    evictExpired(now) {
+        for (const [key, entry] of this.parseFileCache) {
+            if (entry.expires <= now)
+                this.parseFileCache.delete(key);
+        }
+        for (const [key, entry] of this.walkCache) {
+            if (entry.expires <= now)
+                this.walkCache.delete(key);
+        }
+    }
+}
+//# sourceMappingURL=nextjs-audit-cache.js.map

package/dist/utils/nextjs-audit-cache.js.map

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

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

@@ -0,0 +1,65 @@
+import type Parser from "web-tree-sitter";
+export interface MetadataFields {
+    title?: string;
+    description?: string;
+    openGraph?: {
+        title?: string;
+        description?: string;
+        images?: string[];
+    };
+    twitter?: {
+        card?: string;
+        title?: string;
+        description?: string;
+    };
+    alternates?: {
+        canonical?: string;
+    };
+    robots?: string;
+    other?: Record<string, unknown>;
+    /** Set when the metadata export references an identifier or a non-literal expression. */
+    _non_literal?: boolean;
+}
+/** Unwrap a tree-sitter string node (e.g. `"foo"`, `'foo'`, `` `foo` ``) to its literal content, or null. */
+export declare function readStringLiteral(node: Parser.SyntaxNode | null | undefined): string | null;
+/**
+ * Parse a Next.js page/layout for `metadata` or `generateMetadata` exports.
+ *
+ * Supports two shapes:
+ *   - `export const metadata = { title: "...", ... }`
+ *   - `export async function generateMetadata() { return { ... }; }`
+ *
+ * Returns an empty object when no metadata export is present, and sets
+ * `_non_literal: true` when the export exists but is not a parseable object
+ * literal (e.g. `export const metadata = someExternal`).
+ */
+export declare function parseMetadataExport(tree: Parser.Tree, _source: string): MetadataFields;
+export type FetchCallee = "fetch" | "cookies" | "headers" | "unstable_noStore";
+export interface FetchCall {
+    callee: FetchCallee;
+    line: number;
+    /**
+     * Parsed cache directive from fetch() options:
+     *   - `"force-cache"` / `"no-store"` / `"default"` / ...
+     *   - `"isr-60"` for `next: { revalidate: 60 }`
+     *   - `null` when no options or fetch callee
+     */
+    cacheOption: string | null;
+    /** True if this awaited call is sequential w.r.t. a previous await in the same block. */
+    isSequential: boolean;
+    /** True if this call forces SSR (cookies/headers, fetch no-store, unstable_noStore). */
+    isSsrTrigger: boolean;
+}
+/**
+ * Read all fetch/cookies/headers/unstable_noStore calls out of a tree.
+ *
+ * `isSequential` is set when two awaited fetches live in the same statement_block
+ * with no identifier overlap between the earlier statement's bindings and the
+ * later statement's argument expression. Callers wanting waterfall detection
+ * use this flag directly.
+ *
+ * `// sequential intentional` comments on the line preceding an await suppress
+ * the flag for that await.
+ */
+export declare function extractFetchCalls(tree: Parser.Tree, source: string): FetchCall[];
+//# sourceMappingURL=nextjs-metadata-readers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs-metadata-readers.d.ts","sourceRoot":"","sources":["../../src/utils/nextjs-metadata-readers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAC;AAM1C,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE;QACV,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,UAAU,CAAC,EAAE;QACX,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,yFAAyF;IACzF,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,6GAA6G;AAC7G,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAmB3F;AA8HD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CA6DtF;AAMD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,kBAAkB,CAAC;AAE/E,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,yFAAyF;IACzF,YAAY,EAAE,OAAO,CAAC;IACtB,wFAAwF;IACxF,YAAY,EAAE,OAAO,CAAC;CACvB;AAoGD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CA0HhF"}