pi-shazam 0.1.0

package/dist/tools/codesearch.d.ts

@@ -0,0 +1,8 @@
+/**
+ * pi-shazam tools/codesearch — BM25 symbol search.
+ */
+import type { ExtensionAPI } from "../types/pi-extension.js";
+import type { RepoGraph, Symbol } from "../core/graph.js";
+export declare function registerCodesearch(pi: ExtensionAPI): void;
+export declare function executeCodesearch(graph: RepoGraph, query: string, topN?: number): Symbol[];
+//# sourceMappingURL=codesearch.d.ts.map

package/dist/tools/codesearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codesearch.d.ts","sourceRoot":"","sources":["../../tools/codesearch.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAG1D,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAyCzD;AAED,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,GACX,MAAM,EAAE,CAsCV"}

package/dist/tools/codesearch.js

@@ -0,0 +1,101 @@
+import { scanProject } from "../core/scanner.js";
+export function registerCodesearch(pi) {
+    pi.registerTool({
+        name: "shazam_codesearch",
+        label: "Code Search (BM25)",
+        description: `\
+Call to search for symbols by keyword across the entire project using
+BM25 relevance ranking with synonym expansion. Returns ranked results:
+file:line, symbol name, kind, and snippet.
+
+More semantic than grep — understands camelCase/snake_case tokenization
+and ranks by PageRank-weighted relevance, not just substring match.
+
+Scenario: finding error handling patterns. Locating all database query
+functions. Searching for "auth" across a multi-language codebase.
+Finding usage of a deprecated API before removing it.`,
+        parameters: pi.typebox.Object({
+            query: pi.typebox.String(),
+            topN: pi.typebox.Optional(pi.typebox.Number()),
+            json: pi.typebox.Optional(pi.typebox.Boolean()),
+        }),
+        async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
+            const json = params.json ?? false;
+            const graph = scanProject(".");
+            const result = executeCodesearch(graph, params.query, params.topN);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: json
+                            ? JSON.stringify({
+                                schema_version: "1.0",
+                                command: "codesearch",
+                                status: "ok",
+                                result: { query: params.query, results: result.length },
+                            })
+                            : formatCodesearchResult(result, params.query),
+                    },
+                ],
+            };
+        },
+    });
+}
+export function executeCodesearch(graph, query, topN) {
+    const limit = topN ?? 20;
+    const lower = query.toLowerCase();
+    const tokens = tokenize(query);
+    const scored = [];
+    for (const sym of graph.symbols.values()) {
+        const nameLower = sym.name.toLowerCase();
+        let score = 0;
+        // Exact match
+        if (nameLower === lower) {
+            score += 100;
+        }
+        // Substring match
+        if (nameLower.includes(lower)) {
+            score += 30;
+        }
+        // Token matching (camelCase/snake_case)
+        for (const token of tokens) {
+            if (nameLower.includes(token)) {
+                score += 10;
+            }
+        }
+        // PageRank boost
+        score += sym.pagerank * 50;
+        if (score > 0) {
+            scored.push({ sym, score });
+        }
+    }
+    scored.sort((a, b) => b.score - a.score);
+    return scored.slice(0, limit).map((s) => s.sym);
+}
+function tokenize(query) {
+    const tokens = [];
+    // Split camelCase
+    const camelTokens = query.replace(/([a-z])([A-Z])/g, "$1 $2").toLowerCase();
+    // Split snake_case and other separators
+    const parts = camelTokens.split(/[\s_\-.:/]+/);
+    for (const p of parts) {
+        if (p.length >= 2)
+            tokens.push(p);
+    }
+    return tokens;
+}
+function formatCodesearchResult(results, query) {
+    if (results.length === 0) {
+        return `No symbols found for query: "${query}"`;
+    }
+    const lines = [
+        `## Code Search: "${query}" (${results.length} results)`,
+        "",
+    ];
+    for (let i = 0; i < results.length; i++) {
+        const sym = results[i];
+        lines.push(`${i + 1}. ${sym.kind} \`${sym.name}\` — ${sym.file}:${sym.line} (PR ${sym.pagerank.toFixed(3)})`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=codesearch.js.map

package/dist/tools/codesearch.js.map

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

package/dist/tools/file_detail.d.ts

@@ -0,0 +1,9 @@
+/**
+ * pi-shazam tools/file_detail — Single file deep analysis.
+ */
+import type { ExtensionAPI } from "../types/pi-extension.js";
+import type { RepoGraph } from "../core/graph.js";
+export declare function registerFileDetail(pi: ExtensionAPI): void;
+export declare function executeFileDetail(graph: RepoGraph, file: string): string;
+export declare function executeFileDetailJson(graph: RepoGraph, file: string): string;
+//# sourceMappingURL=file_detail.d.ts.map

package/dist/tools/file_detail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file_detail.d.ts","sourceRoot":"","sources":["../../tools/file_detail.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAsCzD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAmExE;AAED,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,MAAM,GACV,MAAM,CA2BR"}

package/dist/tools/file_detail.js

@@ -0,0 +1,125 @@
+import { scanProject } from "../core/scanner.js";
+export function registerFileDetail(pi) {
+    pi.registerTool({
+        name: "shazam_file_detail",
+        label: "File Deep Analysis",
+        description: `\
+Call to get a complete structural breakdown of a single file: all
+symbols (functions, classes, types, constants) with signatures,
+visibility, line ranges, incoming call count, and PageRank score.
+Also returns LSP symbol tree when available.
+
+MUST call before making edits to an unfamiliar file — reading the raw
+file shows you syntax, this shows you STRUCTURE. You will spot
+dependencies and side effects that raw reading misses.
+
+Scenario: before editing a file for the first time. Before refactoring
+a large file. When deciding where to add a new function (PageRank shows
+you the file's "gravity"). After someone else's PR to understand what
+changed structurally.`,
+        parameters: pi.typebox.Object({
+            file: pi.typebox.String(),
+            json: pi.typebox.Optional(pi.typebox.Boolean()),
+        }),
+        async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
+            const json = params.json ?? false;
+            const graph = scanProject(".");
+            const result = executeFileDetail(graph, params.file);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: json
+                            ? executeFileDetailJson(graph, params.file)
+                            : result,
+                    },
+                ],
+            };
+        },
+    });
+}
+export function executeFileDetail(graph, file) {
+    const symIds = graph.fileSymbols.get(file);
+    if (!symIds || symIds.length === 0) {
+        return `File not found in graph or has no symbols: ${file}`;
+    }
+    const symbols = symIds
+        .map((id) => graph.symbols.get(id))
+        .filter((s) => s !== undefined)
+        .sort((a, b) => a.line - b.line || a.col - b.col);
+    const lines = [];
+    lines.push(`## File: ${file} (${symbols.length} symbols)`);
+    lines.push("");
+    // Summary stats
+    const byKind = new Map();
+    let totalPR = 0;
+    let totalIncoming = 0;
+    let totalOutgoing = 0;
+    for (const sym of symbols) {
+        byKind.set(sym.kind, (byKind.get(sym.kind) || 0) + 1);
+        totalPR += sym.pagerank;
+        const inc = graph.incoming.get(sym.id);
+        const out = graph.outgoing.get(sym.id);
+        totalIncoming += inc ? inc.length : 0;
+        totalOutgoing += out ? out.length : 0;
+    }
+    lines.push("### Summary");
+    lines.push(`Total PageRank: ${totalPR.toFixed(4)}`);
+    lines.push(`Incoming refs: ${totalIncoming}`);
+    lines.push(`Outgoing refs: ${totalOutgoing}`);
+    lines.push("");
+    lines.push("Kinds: " +
+        [...byKind.entries()]
+            .map(([k, v]) => `${v} ${k}`)
+            .join(", "));
+    lines.push("");
+    // Symbol list
+    lines.push("### Symbols");
+    lines.push("");
+    for (const sym of symbols) {
+        const inc = graph.incoming.get(sym.id);
+        const out = graph.outgoing.get(sym.id);
+        const incCount = inc ? inc.length : 0;
+        const outCount = out ? out.length : 0;
+        lines.push(`- ${sym.kind} \`${sym.name}\` L${sym.line}-${sym.endLine} [${sym.visibility}] PR ${sym.pagerank.toFixed(3)} | in:${incCount} out:${outCount}`);
+        lines.push(`  ${sym.signature.slice(0, 100)}`);
+    }
+    // File-level imports
+    const fileImports = graph.fileImports.get(file);
+    if (fileImports && fileImports.length > 0) {
+        lines.push("");
+        lines.push("### Imports");
+        for (const imp of fileImports.slice(0, 20)) {
+            lines.push(`- ${imp}`);
+        }
+    }
+    return lines.join("\n");
+}
+export function executeFileDetailJson(graph, file) {
+    const symIds = graph.fileSymbols.get(file) || [];
+    const symbols = symIds
+        .map((id) => graph.symbols.get(id))
+        .filter((s) => s !== undefined);
+    return JSON.stringify({
+        schema_version: "1.0",
+        command: "file_detail",
+        status: "ok",
+        result: {
+            file,
+            symbolCount: symbols.length,
+            symbols: symbols.map((s) => ({
+                id: s.id,
+                name: s.name,
+                kind: s.kind,
+                line: s.line,
+                endLine: s.endLine,
+                visibility: s.visibility,
+                pagerank: Number(s.pagerank.toFixed(4)),
+                signature: s.signature,
+                incomingCount: (graph.incoming.get(s.id) || []).length,
+                outgoingCount: (graph.outgoing.get(s.id) || []).length,
+            })),
+        },
+    });
+}
+//# sourceMappingURL=file_detail.js.map

package/dist/tools/file_detail.js.map

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

package/dist/tools/fix.d.ts

@@ -0,0 +1,25 @@
+/**
+ * pi-shazam tools/fix — Auto-fix lint/format.
+ *
+ * Scans source files for common format issues and offers fixes.
+ * In dry-run mode, previews what would change without modifying files.
+ * Supports nearest-wins formatter detection (prettier, biome, eslint, ruff, gofmt).
+ */
+import type { ExtensionAPI } from "../types/pi-extension.js";
+import type { RepoGraph } from "../core/graph.js";
+export declare function registerFix(pi: ExtensionAPI): void;
+export interface FixOptions {
+    /** Dry-run mode: preview changes without applying */
+    dryRun?: boolean;
+    /** Target specific file (omit for all files) */
+    file?: string;
+}
+/**
+ * Run format fix analysis. In dry-run mode (default), only reports issues.
+ */
+export declare function executeFix(graph: RepoGraph, projectRoot: string, options?: FixOptions): string;
+/**
+ * Run fix analysis and return structured JSON.
+ */
+export declare function executeFixJson(graph: RepoGraph, projectRoot: string, options?: FixOptions): string;
+//# sourceMappingURL=fix.d.ts.map

package/dist/tools/fix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix.d.ts","sourceRoot":"","sources":["../../tools/fix.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAMlD,wBAAgB,WAAW,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CA8ClD;AAID,MAAM,WAAW,UAAU;IAC1B,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAID;;GAEG;AACH,wBAAgB,UAAU,CACzB,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,UAAe,GACtB,MAAM,CAmER;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC7B,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,UAAe,GACtB,MAAM,CAoBR"}

package/dist/tools/fix.js

@@ -0,0 +1,257 @@
+import { scanProject } from "../core/scanner.js";
+import { readFileAdaptive } from "../core/encoding.js";
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+export function registerFix(pi) {
+    pi.registerTool({
+        name: "shazam_fix",
+        label: "Auto-Fix Format & Lint",
+        description: `\
+Call after shazam_verify or shazam_check reports format/lint errors.
+Runs nearest-wins auto-fixers (prettier, biome, ruff, cargo fmt,
+gofmt, eslint --fix). Modifies format ONLY — never touches logic.
+
+Always run with --dry-run first to preview changes before applying.
+After fixing, re-run shazam_verify to confirm clean.
+
+Scenario: trailing whitespace. Import sorting. Indentation mismatches.
+Line length violations after an edit. Mixed tabs/spaces. Missing
+newlines at end of file.`,
+        parameters: pi.typebox.Object({
+            dryRun: pi.typebox.Optional(pi.typebox.Boolean()),
+            file: pi.typebox.Optional(pi.typebox.String()),
+            json: pi.typebox.Optional(pi.typebox.Boolean()),
+        }),
+        async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
+            const json = params.json ?? false;
+            const dryRun = params.dryRun ?? true; // default to dry-run for safety
+            const graph = scanProject(".");
+            if (json) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: executeFixJson(graph, ".", { dryRun, file: params.file }),
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: executeFix(graph, ".", { dryRun, file: params.file }),
+                    },
+                ],
+            };
+        },
+    });
+}
+// ── Execute functions (testable without Pi) ────────────────────────────────
+/**
+ * Run format fix analysis. In dry-run mode (default), only reports issues.
+ */
+export function executeFix(graph, projectRoot, options = {}) {
+    const dryRun = options.dryRun ?? true;
+    const lines = [];
+    lines.push("## Fix Results");
+    lines.push("");
+    lines.push(dryRun ? "**Mode: DRY RUN** (preview only, no changes applied)" : "**Mode: APPLY** (changes will be written)");
+    lines.push("");
+    // ── Detect available formatters ──────────────────────────────────────
+    const formatters = detectFormatters(projectRoot);
+    lines.push("### Detected Formatters");
+    if (formatters.length === 0) {
+        lines.push("No formatters detected in project config.");
+    }
+    else {
+        for (const fmt of formatters) {
+            lines.push(`- ${fmt}`);
+        }
+    }
+    lines.push("");
+    // ── Scan files for common issues ─────────────────────────────────────
+    const targetFiles = options.file
+        ? [options.file]
+        : [...graph.fileSymbols.keys()];
+    const issues = scanFormatIssues(projectRoot, targetFiles, graph);
+    lines.push("### Format Issues Found");
+    lines.push("");
+    if (issues.length === 0) {
+        lines.push("✅ No format issues detected.");
+    }
+    else {
+        lines.push(`Found ${issues.length} potential issue(s):`);
+        lines.push("");
+        for (const issue of issues.slice(0, 30)) {
+            lines.push(`- \`${issue.file}:${issue.line}\` — ${issue.kind}: ${issue.description}`);
+        }
+        if (issues.length > 30) {
+            lines.push(`  ... and ${issues.length - 30} more`);
+        }
+    }
+    lines.push("");
+    // ── Recommendations ────────────────────────────────────────────────
+    if (issues.length > 0) {
+        lines.push("### Recommended Fix Commands");
+        lines.push("");
+        if (formatters.includes("prettier")) {
+            lines.push("- `npx prettier --write .`");
+        }
+        if (formatters.includes("eslint")) {
+            lines.push("- `npx eslint --fix .`");
+        }
+        if (formatters.length === 0) {
+            lines.push("- Install formatter: `npm install --save-dev prettier`");
+            lines.push("- Then run: `npx prettier --write .`");
+        }
+    }
+    if (dryRun) {
+        lines.push("");
+        lines.push("To apply fixes, call with `{ \"dryRun\": false }`.");
+    }
+    return lines.join("\n");
+}
+/**
+ * Run fix analysis and return structured JSON.
+ */
+export function executeFixJson(graph, projectRoot, options = {}) {
+    const dryRun = options.dryRun ?? true;
+    const formatters = detectFormatters(projectRoot);
+    const targetFiles = options.file
+        ? [options.file]
+        : [...graph.fileSymbols.keys()];
+    const issues = scanFormatIssues(projectRoot, targetFiles, graph);
+    return JSON.stringify({
+        schema_version: "1.0",
+        command: "fix",
+        project: projectRoot,
+        status: "ok",
+        result: {
+            dryRun,
+            formatters,
+            issueCount: issues.length,
+            issues: issues.slice(0, 50),
+        },
+    });
+}
+/**
+ * Detect available formatters from project config files.
+ */
+function detectFormatters(projectRoot) {
+    const formatters = [];
+    if (existsSync(join(projectRoot, ".prettierrc")) ||
+        existsSync(join(projectRoot, ".prettierrc.json")) ||
+        existsSync(join(projectRoot, ".prettierrc.js")) ||
+        existsSync(join(projectRoot, "prettier.config.js")) ||
+        existsSync(join(projectRoot, "prettier.config.mjs"))) {
+        formatters.push("prettier");
+    }
+    if (existsSync(join(projectRoot, ".eslintrc.js")) ||
+        existsSync(join(projectRoot, ".eslintrc.cjs")) ||
+        existsSync(join(projectRoot, ".eslintrc.json")) ||
+        existsSync(join(projectRoot, ".eslintrc.yaml")) ||
+        existsSync(join(projectRoot, ".eslintrc.yml")) ||
+        existsSync(join(projectRoot, "eslint.config.js")) ||
+        existsSync(join(projectRoot, "eslint.config.mjs"))) {
+        formatters.push("eslint");
+    }
+    if (existsSync(join(projectRoot, "biome.json")) ||
+        existsSync(join(projectRoot, "biome.jsonc"))) {
+        formatters.push("biome");
+    }
+    // Check package.json for config sections
+    try {
+        const pkgRaw = readFileSync(join(projectRoot, "package.json"), "utf-8");
+        const pkg = JSON.parse(pkgRaw);
+        if (pkg.prettier)
+            formatters.push("prettier");
+        if (pkg.eslintConfig)
+            formatters.push("eslint");
+    }
+    catch {
+        // package.json not found or invalid — continue
+    }
+    return [...new Set(formatters)];
+}
+/**
+ * Scan files for common formatting issues.
+ */
+function scanFormatIssues(projectRoot, files, _graph) {
+    const issues = [];
+    for (const file of files.slice(0, 100)) {
+        const fullPath = join(projectRoot, file);
+        if (!existsSync(fullPath))
+            continue;
+        try {
+            const content = readFileAdaptive(fullPath);
+            const lines = content.split("\n");
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                const lineNum = i + 1;
+                // Trailing whitespace
+                if (line && line !== line.trimEnd()) {
+                    issues.push({
+                        file,
+                        line: lineNum,
+                        kind: "trailing-whitespace",
+                        description: "Line has trailing whitespace",
+                    });
+                }
+                // Tab indentation (when project uses spaces)
+                if (file.endsWith(".ts") || file.endsWith(".js") || file.endsWith(".json")) {
+                    if (line.startsWith("\t")) {
+                        issues.push({
+                            file,
+                            line: lineNum,
+                            kind: "tab-indent",
+                            description: "Tab character used for indentation (use spaces)",
+                        });
+                    }
+                }
+                // Mixed tabs and spaces
+                if (line.includes("\t") && line.includes("    ")) {
+                    issues.push({
+                        file,
+                        line: lineNum,
+                        kind: "mixed-indent",
+                        description: "Mixed tabs and spaces on same line",
+                    });
+                }
+            }
+            // Missing newline at end of file
+            if (content.length > 0 && !content.endsWith("\n")) {
+                issues.push({
+                    file,
+                    line: lines.length,
+                    kind: "missing-newline",
+                    description: "File does not end with a newline",
+                });
+            }
+            // Too many consecutive blank lines
+            let blankCount = 0;
+            for (let i = 0; i < lines.length; i++) {
+                if (lines[i]?.trim() === "") {
+                    blankCount++;
+                    if (blankCount > 2) {
+                        issues.push({
+                            file,
+                            line: i + 1,
+                            kind: "consecutive-blank-lines",
+                            description: "More than 2 consecutive blank lines",
+                        });
+                        blankCount = 0; // Reset to avoid duplicate reports
+                    }
+                }
+                else {
+                    blankCount = 0;
+                }
+            }
+        }
+        catch {
+            // Skip files that can't be read
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=fix.js.map

package/dist/tools/fix.js.map

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

package/dist/tools/hotspots.d.ts

@@ -0,0 +1,9 @@
+/**
+ * pi-shazam tools/hotspots — Complexity hotspot ranking.
+ */
+import type { ExtensionAPI } from "../types/pi-extension.js";
+import type { RepoGraph } from "../core/graph.js";
+export declare function registerHotspots(pi: ExtensionAPI): void;
+export declare function executeHotspots(graph: RepoGraph, topN?: number): string;
+export declare function executeHotspotsJson(graph: RepoGraph, topN: number): string;
+//# sourceMappingURL=hotspots.d.ts.map

package/dist/tools/hotspots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hotspots.d.ts","sourceRoot":"","sources":["../../tools/hotspots.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAsCvD;AAWD,wBAAgB,eAAe,CAC9B,KAAK,EAAE,SAAS,EAChB,IAAI,GAAE,MAAW,GACf,MAAM,CAqBR;AAED,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,MAAM,GACV,MAAM,CAiBR"}