codesift-mcp 0.3.0 → 0.4.0

package/dist/tools/architecture-tools.js

@@ -0,0 +1,140 @@
+import { getCodeIndex } from "./index-tools.js";
+import { analyzeProject } from "./project-tools.js";
+import { detectCommunities } from "./community-tools.js";
+import { findCircularDeps } from "./graph-tools.js";
+import { fanInFanOut } from "./coupling-tools.js";
+function withTimeout(promise, ms) {
+    return Promise.race([
+        promise,
+        new Promise((resolve) => setTimeout(() => resolve({ status: "timeout" }), ms)),
+    ]);
+}
+function isTimeout(v) {
+    return v != null && typeof v === "object" && "status" in v && v.status === "timeout";
+}
+// ---------------------------------------------------------------------------
+// LOC distribution (from index, no external calls)
+// ---------------------------------------------------------------------------
+function computeLocDistribution(files, focus) {
+    const dirMap = new Map();
+    for (const file of files) {
+        if (focus && !file.path.startsWith(focus))
+            continue;
+        // Extract top-level directory (or root for flat files)
+        const parts = file.path.split("/");
+        const dir = parts.length > 1 ? parts.slice(0, 2).join("/") : ".";
+        const entry = dirMap.get(dir) ?? { file_count: 0, symbol_count: 0 };
+        entry.file_count++;
+        entry.symbol_count += file.symbol_count;
+        dirMap.set(dir, entry);
+    }
+    return [...dirMap.entries()]
+        .map(([dir, stats]) => ({ dir, ...stats }))
+        .sort((a, b) => b.symbol_count - a.symbol_count);
+}
+// ---------------------------------------------------------------------------
+// Mermaid diagram generation
+// ---------------------------------------------------------------------------
+function generateMermaid(communities, hubFiles, circularDeps) {
+    const lines = ["graph TD"];
+    // Community subgraphs
+    for (const community of communities.slice(0, 10)) {
+        const id = `c${community.id}`;
+        lines.push(`  subgraph ${id}["${community.name} (${community.files.length} files)"]`);
+        // Show up to 5 representative files
+        for (const file of community.files.slice(0, 5)) {
+            const nodeId = file.replace(/[^a-zA-Z0-9]/g, "_");
+            const shortName = file.split("/").pop() ?? file;
+            lines.push(`    ${nodeId}["${shortName}"]`);
+        }
+        if (community.files.length > 5) {
+            lines.push(`    ${id}_more["... +${community.files.length - 5} more"]`);
+        }
+        lines.push("  end");
+    }
+    // Hub files (coupling hotspots)
+    for (const hub of hubFiles.slice(0, 5)) {
+        const nodeId = hub.file.replace(/[^a-zA-Z0-9]/g, "_");
+        lines.push(`  ${nodeId}:::hub`);
+    }
+    // Circular dependency arrows
+    for (const cycle of circularDeps.slice(0, 5)) {
+        for (let i = 0; i < cycle.length; i++) {
+            const from = cycle[i].replace(/[^a-zA-Z0-9]/g, "_");
+            const to = cycle[(i + 1) % cycle.length].replace(/[^a-zA-Z0-9]/g, "_");
+            lines.push(`  ${from} -->|cycle| ${to}`);
+        }
+    }
+    lines.push("  classDef hub fill:#f96,stroke:#333");
+    return lines.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Tool implementation
+// ---------------------------------------------------------------------------
+const CHECK_TIMEOUT_MS = 15000;
+export async function architectureSummary(repo, options) {
+    const startMs = Date.now();
+    const index = await getCodeIndex(repo);
+    if (!index) {
+        throw new Error(`Repository "${repo}" not found. Index it first with index_folder.`);
+    }
+    const focus = options?.focus;
+    // Build options carefully to avoid passing undefined with exactOptionalPropertyTypes
+    const fanOpts = { top_n: 10 };
+    if (focus)
+        fanOpts.path = focus;
+    const circOpts = { max_cycles: 10 };
+    if (focus)
+        circOpts.file_pattern = focus;
+    // Fan-out 5 analyses in parallel
+    const [stackResult, commResult, fanResult, circResult] = await Promise.allSettled([
+        withTimeout(analyzeProject(repo), CHECK_TIMEOUT_MS),
+        withTimeout(detectCommunities(repo, focus), CHECK_TIMEOUT_MS),
+        withTimeout(fanInFanOut(repo, fanOpts), CHECK_TIMEOUT_MS),
+        withTimeout(findCircularDeps(repo, circOpts), CHECK_TIMEOUT_MS),
+    ]);
+    // Extract results (gracefully handle timeouts/failures)
+    const stack = stackResult.status === "fulfilled" && !isTimeout(stackResult.value)
+        ? stackResult.value
+        : null;
+    const communities = commResult.status === "fulfilled" && !isTimeout(commResult.value)
+        ? commResult.value.communities ?? []
+        : [];
+    const couplingHotspots = fanResult.status === "fulfilled" && !isTimeout(fanResult.value)
+        ? fanResult.value.hub_files ?? []
+        : [];
+    const fanInTop = fanResult.status === "fulfilled" && !isTimeout(fanResult.value)
+        ? fanResult.value.fan_in_top ?? []
+        : [];
+    const fanOutTop = fanResult.status === "fulfilled" && !isTimeout(fanResult.value)
+        ? fanResult.value.fan_out_top ?? []
+        : [];
+    const circularDeps = circResult.status === "fulfilled" && !isTimeout(circResult.value)
+        ? (circResult.value.cycles ?? []).map((c) => c.cycle)
+        : [];
+    // LOC distribution from index (no async needed)
+    const locDistribution = computeLocDistribution(index.files, focus);
+    // Entry points: high fan-in, low fan-out
+    const entryPoints = [];
+    for (const item of fanInTop) {
+        const outCount = fanOutTop.find((f) => f.file === item.file)?.count ?? 0;
+        if (item.count >= 5 && outCount <= 3) {
+            entryPoints.push(item.file);
+        }
+    }
+    // Optional Mermaid
+    const mermaid = options?.output_format === "mermaid"
+        ? generateMermaid(communities, couplingHotspots, circularDeps)
+        : undefined;
+    return {
+        stack,
+        communities,
+        coupling_hotspots: couplingHotspots,
+        circular_deps: circularDeps,
+        loc_distribution: locDistribution,
+        entry_points: entryPoints,
+        mermaid,
+        duration_ms: Date.now() - startMs,
+    };
+}
+//# sourceMappingURL=architecture-tools.js.map

package/dist/tools/architecture-tools.js.map

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

package/dist/tools/astro-config.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Astro config analysis tool.
+ *
+ * Parses `astro.config.{mjs,ts,cjs}` using tree-sitter-javascript AST walker
+ * to extract project conventions (output mode, adapter, integrations, i18n, etc.).
+ *
+ * Exports:
+ * - `extractAstroConventions(files, projectRoot)` — consumed by analyzeProject
+ * - `astroConfigAnalyze(args)` — MCP tool handler
+ */
+export interface AstroConventions {
+    output_mode: "static" | "server" | "hybrid" | null;
+    adapter: string | null;
+    integrations: string[];
+    site: string | null;
+    base: string | null;
+    i18n: {
+        default_locale: string;
+        locales: string[];
+    } | null;
+    redirects: Record<string, string>;
+    config_resolution: "static" | "partial" | "dynamic";
+    config_file: string | null;
+}
+export interface AstroConfigResult {
+    conventions: AstroConventions;
+    issues: string[];
+}
+export declare function extractAstroConventions(files: string[], projectRoot: string): Promise<AstroConfigResult>;
+export declare function astroConfigAnalyze(args: {
+    project_root: string;
+}): Promise<AstroConfigResult>;
+//# sourceMappingURL=astro-config.d.ts.map

package/dist/tools/astro-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"astro-config.d.ts","sourceRoot":"","sources":["../../src/tools/astro-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAAC;IACnD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3D,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,iBAAiB,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IACpD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,gBAAgB,CAAC;IAC9B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAoLD,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,MAAM,EAAE,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,CAAC,CA0C5B;AAMD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAE7B"}

package/dist/tools/astro-config.js

@@ -0,0 +1,260 @@
+/**
+ * Astro config analysis tool.
+ *
+ * Parses `astro.config.{mjs,ts,cjs}` using tree-sitter-javascript AST walker
+ * to extract project conventions (output mode, adapter, integrations, i18n, etc.).
+ *
+ * Exports:
+ * - `extractAstroConventions(files, projectRoot)` — consumed by analyzeProject
+ * - `astroConfigAnalyze(args)` — MCP tool handler
+ */
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { getParser, initParser } from "../parser/parser-manager.js";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const CONFIG_CANDIDATES = ["astro.config.mjs", "astro.config.ts", "astro.config.cjs"];
+function dynamicResult(configFile, issue) {
+    return {
+        conventions: {
+            output_mode: null, adapter: null, integrations: [], site: null,
+            base: null, i18n: null, redirects: {}, config_resolution: "dynamic", config_file: configFile,
+        },
+        issues: [issue],
+    };
+}
+async function findConfigFile(root, files) {
+    for (const name of CONFIG_CANDIDATES) {
+        const full = join(root, name);
+        if (files) {
+            if (files.includes(name) || files.includes(full))
+                return full;
+        }
+        else {
+            try {
+                await readFile(full, "utf-8");
+                return full;
+            }
+            catch { /* next */ }
+        }
+    }
+    return null;
+}
+function stripQuotes(s) {
+    return (s[0] === '"' || s[0] === "'") && s[s.length - 1] === s[0] ? s.slice(1, -1) : s;
+}
+function isLiteral(n) {
+    return n.type === "string" || n.type === "number" || n.type === "true"
+        || n.type === "false" || n.type === "null" || n.type === "undefined";
+}
+function getProperty(obj, name) {
+    for (const p of obj.namedChildren) {
+        if (p.type !== "pair")
+            continue;
+        const k = p.childForFieldName("key");
+        if (k?.text === name)
+            return p.childForFieldName("value") ?? null;
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// AST walking
+// ---------------------------------------------------------------------------
+/** Build import specifier -> module source map from top-level imports. */
+function buildImportMap(root) {
+    const map = new Map();
+    for (const child of root.namedChildren) {
+        if (child.type !== "import_statement")
+            continue;
+        const src = child.childForFieldName("source");
+        if (!src)
+            continue;
+        const mod = stripQuotes(src.text);
+        // Default import: import vercel from "@astrojs/vercel"
+        const def = child.namedChildren.find((n) => n.type === "identifier");
+        if (def)
+            map.set(def.text, mod);
+        // import { x } from "y" — import_clause wrapper
+        const clause = child.namedChildren.find((n) => n.type === "import_clause");
+        if (clause) {
+            const id = clause.namedChildren.find((n) => n.type === "identifier");
+            if (id)
+                map.set(id.text, mod);
+            const named = clause.namedChildren.find((n) => n.type === "named_imports");
+            if (named) {
+                for (const spec of named.namedChildren) {
+                    const nm = spec.childForFieldName("alias") ?? spec.childForFieldName("name") ?? spec.namedChildren[0];
+                    if (nm)
+                        map.set(nm.text, mod);
+                }
+            }
+        }
+    }
+    return map;
+}
+/** Find the object literal passed to `defineConfig(...)`. */
+function findConfigObject(root) {
+    for (const child of root.namedChildren) {
+        if (child.type !== "export_statement")
+            continue;
+        const call = child.namedChildren.find((n) => n.type === "call_expression");
+        if (!call)
+            continue;
+        const fn = call.childForFieldName("function");
+        if (fn?.text !== "defineConfig")
+            continue;
+        const args = call.childForFieldName("arguments");
+        return args?.namedChildren.find((n) => n.type === "object") ?? null;
+    }
+    return null;
+}
+/** Extract config properties from the defineConfig object. */
+function extractFromAST(root, importMap) {
+    const obj = findConfigObject(root);
+    if (!obj)
+        return { conv: {}, nonLiteralCount: 0 };
+    let nlc = 0; // non-literal counter
+    const conv = {};
+    // --- Simple string fields ---
+    for (const field of ["output", "site", "base"]) {
+        const node = getProperty(obj, field);
+        if (!node)
+            continue;
+        const key = field === "output" ? "output_mode" : field;
+        if (isLiteral(node)) {
+            const val = stripQuotes(node.text);
+            conv[key] = field === "output"
+                ? (val === "static" || val === "server" || val === "hybrid" ? val : null)
+                : val;
+        }
+        else {
+            conv[key] = null;
+            nlc++;
+        }
+    }
+    // --- Adapter (call expression resolved via imports) ---
+    const adN = getProperty(obj, "adapter");
+    if (adN) {
+        if (adN.type === "call_expression") {
+            const fn = adN.childForFieldName("function");
+            if (fn)
+                conv.adapter = importMap.get(fn.text) ?? fn.text;
+        }
+        else if (isLiteral(adN)) {
+            conv.adapter = stripQuotes(adN.text);
+        }
+        else {
+            conv.adapter = null;
+            nlc++;
+        }
+    }
+    // --- Integrations (array of call expressions) ---
+    const intN = getProperty(obj, "integrations");
+    if (intN) {
+        if (intN.type === "array") {
+            conv.integrations = intN.namedChildren.flatMap((el) => {
+                if (el.type === "call_expression") {
+                    const fn = el.childForFieldName("function");
+                    return fn ? [importMap.get(fn.text) ?? fn.text] : [];
+                }
+                return isLiteral(el) ? [stripQuotes(el.text)] : [];
+            });
+        }
+        else {
+            conv.integrations = [];
+            nlc++;
+        }
+    }
+    // --- i18n ---
+    const i18n = getProperty(obj, "i18n");
+    if (i18n) {
+        if (i18n.type === "object") {
+            const dlN = getProperty(i18n, "defaultLocale");
+            const lN = getProperty(i18n, "locales");
+            const dl = dlN && isLiteral(dlN) ? stripQuotes(dlN.text) : null;
+            const locales = lN?.type === "array"
+                ? lN.namedChildren.filter(isLiteral).map((e) => stripQuotes(e.text))
+                : [];
+            if (dl)
+                conv.i18n = { default_locale: dl, locales };
+            else
+                nlc++;
+        }
+        else
+            nlc++;
+    }
+    // --- Redirects ---
+    const redN = getProperty(obj, "redirects");
+    if (redN) {
+        if (redN.type === "object") {
+            const r = {};
+            for (const p of redN.namedChildren) {
+                if (p.type !== "pair")
+                    continue;
+                const k = p.childForFieldName("key"), v = p.childForFieldName("value");
+                if (k && v && isLiteral(v))
+                    r[stripQuotes(k.text)] = stripQuotes(v.text);
+            }
+            conv.redirects = r;
+        }
+        else
+            nlc++;
+    }
+    return { conv, nonLiteralCount: nlc };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export async function extractAstroConventions(files, projectRoot) {
+    const configPath = await findConfigFile(projectRoot, files.length > 0 ? files : undefined);
+    if (!configPath)
+        return dynamicResult(null, "No astro.config.{mjs,ts,cjs} found");
+    let source;
+    try {
+        source = await readFile(configPath, "utf-8");
+    }
+    catch {
+        return dynamicResult(configPath, "Failed to read config file");
+    }
+    await initParser();
+    const parser = await getParser("javascript");
+    if (!parser)
+        return dynamicResult(configPath, "JavaScript parser unavailable");
+    let tree;
+    try {
+        tree = parser.parse(source);
+    }
+    catch {
+        return dynamicResult(configPath, "AST parse error");
+    }
+    const importMap = buildImportMap(tree.rootNode);
+    const { conv, nonLiteralCount } = extractFromAST(tree.rootNode, importMap);
+    const issues = [];
+    if (conv.site === undefined)
+        issues.push("Missing site URL in config");
+    const configFile = configPath.startsWith(projectRoot)
+        ? configPath.slice(projectRoot.length + 1)
+        : configPath;
+    return {
+        conventions: {
+            output_mode: conv.output_mode ?? null,
+            adapter: conv.adapter ?? null,
+            integrations: conv.integrations ?? [],
+            site: conv.site ?? null,
+            base: conv.base ?? null,
+            i18n: conv.i18n ?? null,
+            redirects: conv.redirects ?? {},
+            config_resolution: nonLiteralCount === 0 ? "static" : "partial",
+            config_file: configFile,
+        },
+        issues,
+    };
+}
+// ---------------------------------------------------------------------------
+// MCP tool handler
+// ---------------------------------------------------------------------------
+export async function astroConfigAnalyze(args) {
+    return extractAstroConventions([], args.project_root);
+}
+//# sourceMappingURL=astro-config.js.map

package/dist/tools/astro-config.js.map

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

package/dist/tools/astro-islands.d.ts

@@ -0,0 +1,61 @@
+import { type Island } from "../parser/astro-template.js";
+import type { CodeIndex } from "../types.js";
+export interface BundleEstimate {
+    estimated_bundle_kb: number;
+    framework_cost_kb: number;
+    marginal_cost_kb: number;
+}
+export interface ServerIsland {
+    file: string;
+    line: number;
+    component: string;
+    has_fallback: boolean;
+}
+export interface IslandWithBundle extends Island {
+    bundle?: BundleEstimate | undefined;
+    file: string;
+}
+export interface BudgetSummary {
+    total_js_budget_kb: number;
+    framework_overhead: Record<string, number>;
+    unique_component_cost_kb: number;
+}
+export interface AnalyzeIslandsResult {
+    islands: IslandWithBundle[];
+    summary: {
+        total_islands: number;
+        by_directive: Record<string, number>;
+        by_framework: Record<string, number>;
+        warnings: string[];
+        budget?: BudgetSummary | undefined;
+    };
+    server_islands: ServerIsland[];
+}
+export declare function astroAnalyzeIslands(args: {
+    repo?: string;
+    path_prefix?: string;
+    include_recommendations?: boolean;
+}): Promise<AnalyzeIslandsResult>;
+export declare function analyzeIslandsFromIndex(index: CodeIndex, pathPrefix?: string): AnalyzeIslandsResult;
+export interface AuditIssue {
+    code: string;
+    severity: "error" | "warning" | "info";
+    message: string;
+    file: string;
+    line: number;
+    component?: string | undefined;
+    fix: string;
+    fix_snippet?: string | undefined;
+}
+export interface HydrationAuditResult {
+    issues: AuditIssue[];
+    anti_patterns_checked: string[];
+    score: "A" | "B" | "C" | "D";
+}
+export declare function astroHydrationAudit(args: {
+    repo?: string;
+    severity?: "all" | "warnings" | "errors";
+    path_prefix?: string;
+}): Promise<HydrationAuditResult>;
+export declare function hydrationAuditFromIndex(index: CodeIndex, severity?: "all" | "warnings" | "errors", pathPrefix?: string): HydrationAuditResult;
+//# sourceMappingURL=astro-islands.d.ts.map

package/dist/tools/astro-islands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"astro-islands.d.ts","sourceRoot":"","sources":["../../src/tools/astro-islands.ts"],"names":[],"mappings":"AAMA,OAAO,EAAsB,KAAK,MAAM,EAA2B,MAAM,6BAA6B,CAAC;AACvG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAoD7C,MAAM,WAAW,cAAc;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAYD,MAAM,WAAW,YAAY;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAC;CAAE;AACvG,MAAM,WAAW,gBAAiB,SAAQ,MAAM;IAAG,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;CAAE;AACvG,MAAM,WAAW,aAAa;IAAG,kBAAkB,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,wBAAwB,EAAE,MAAM,CAAC;CAAE;AAC5I,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,OAAO,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,aAAa,GAAG,SAAS,CAAA;KAAE,CAAC;IACvK,cAAc,EAAE,YAAY,EAAE,CAAC;CAChC;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,uBAAuB,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAIzJ;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAmCnG;AAID,MAAM,WAAW,UAAU;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAAE;AACjN,MAAM,WAAW,oBAAoB;IAAG,MAAM,EAAE,UAAU,EAAE,CAAC;IAAC,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;CAAE;AA8F9H,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,QAAQ,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAIhK;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,QAAQ,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAW7I"}