@vyuhlabs/dxkit 2.6.0 → 2.7.1

package/dist/dashboard/graph-adapter.js

@@ -0,0 +1,415 @@
+"use strict";
+/**
+ * Pure-function adapter — converts the in-memory `Graph` into the
+ * shape cytoscape.js consumes (`ElementsDefinition` equivalent).
+ *
+ * Three tiers, matching the dashboard's three-level drill-down:
+ *
+ *   Tier 1 — community view (default tab landing)
+ *     N community bubbles + inter-community edges, sized by
+ *     member-count (sqrt scale) and labeled by dominantSourceDir.
+ *
+ *   Tier 2 — file view (within one community)
+ *     File nodes for every file in the community, sized by call
+ *     in-degree, edges = imports_from between member files plus
+ *     the strongest cross-community import edges.
+ *
+ *   Tier 3 — symbol view (within one file)
+ *     Symbol nodes for every function / class / method in the file,
+ *     sized by call in-degree, edges = calls within the file plus
+ *     thin external-call indicators that the renderer can wire as
+ *     "click → jump to the target file."
+ *
+ * Pure: no DOM access, no cytoscape import, no I/O. Tested with
+ * synthetic `Graph` fixtures (see test/dashboard/graph-adapter.test.ts).
+ * The DOM-bound mounter (Part B's `graph-tab.ts`) consumes these
+ * elements and hands them to cytoscape.
+ *
+ * Per CLAUDE.md Rule 12: every graph traversal here goes through
+ * `src/explore/queries.ts` — no callers / callees / community lookup
+ * code is reimplemented in this module. The arch gate enforces.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.adaptToTier1 = adaptToTier1;
+exports.adaptToTier2 = adaptToTier2;
+exports.adaptToTier3 = adaptToTier3;
+const queries_1 = require("../explore/queries");
+// ─── Tier 1 — community bubbles ──────────────────────────────────────────────
+/**
+ * Build the cytoscape elements for the community-view (Tier 1) of a
+ * graph. Each community becomes one node; inter-community edges are
+ * synthesized by counting cross-community `calls` + `imports_from`
+ * edges.
+ *
+ * Limit defaults to the top-20 communities by node-count — beyond
+ * that the layout gets dense without adding information. The CLI's
+ * `explore communities` default is 8; the viz needs more breadth to
+ * communicate "this repo has lots of natural modules" so we lift
+ * the cap.
+ */
+function adaptToTier1(graph, opts = {}) {
+    const limit = opts.limit ?? 20;
+    // Use the canonical query for the per-community summary (Rule 12).
+    // Rank-by-node-count is identical to communitiesQuery's behavior;
+    // we just want the top-N rendered.
+    const summaries = (0, queries_1.communitiesQuery)(graph, limit);
+    const communityIds = new Set(summaries.map((s) => s.id));
+    // Largest community → size 1.0; sqrt scale ensures a 4× node-count
+    // community renders ~2× the radius (visual area still proportional).
+    const maxNodeCount = summaries.reduce((m, s) => Math.max(m, s.nodeCount), 0);
+    const nodes = summaries.map((s) => ({
+        group: 'nodes',
+        data: {
+            id: communityId(s.id),
+            label: s.dominantSourceDir || `community-${s.id}`,
+            size: maxNodeCount > 0 ? Math.sqrt(s.nodeCount / maxNodeCount) : 0,
+            colorGroup: s.dominantPack || 'multi',
+            tier: 1,
+            communityId: s.id,
+            meta: {
+                nodeCount: s.nodeCount,
+                cohesion: round2(s.cohesion),
+                dominantPack: s.dominantPack || 'mixed',
+                topHotFiles: s.topHotFiles.slice(0, 3).join(', '),
+            },
+        },
+    }));
+    // Inter-community edges — count cross-community calls + imports.
+    // Bidirectional pairs collapse to one undirected edge for visual
+    // clarity (cytoscape can still treat the underlying edge as
+    // directed if a layout cares).
+    const pairCounts = new Map();
+    for (const edge of graph.edges) {
+        if (edge.relation === 'method')
+            continue; // method ownership is intra-file noise
+        const fromComm = graph.communityByNode.get(edge.from);
+        const toComm = graph.communityByNode.get(edge.to);
+        if (!fromComm || !toComm)
+            continue;
+        if (fromComm.id === toComm.id)
+            continue; // intra-community
+        if (!communityIds.has(fromComm.id) || !communityIds.has(toComm.id))
+            continue;
+        const [a, b] = fromComm.id < toComm.id ? [fromComm.id, toComm.id] : [toComm.id, fromComm.id];
+        const key = `${a}->${b}`;
+        const existing = pairCounts.get(key);
+        if (existing) {
+            existing.count++;
+        }
+        else {
+            pairCounts.set(key, { from: a, to: b, count: 1 });
+        }
+    }
+    const maxPairCount = Math.max(0, ...[...pairCounts.values()].map((p) => p.count));
+    const edges = [...pairCounts.entries()].map(([key, p]) => ({
+        group: 'edges',
+        data: {
+            id: `e1:${key}`,
+            source: communityId(p.from),
+            target: communityId(p.to),
+            relation: 'community',
+            weight: maxPairCount > 0 ? Math.sqrt(p.count / maxPairCount) : 0,
+            occurrences: p.count,
+        },
+    }));
+    return { nodes, edges };
+}
+// ─── Tier 2 — files within a community ───────────────────────────────────────
+/**
+ * Build the cytoscape elements for the file-view (Tier 2) of one
+ * community. File nodes are the union of `sourceFile` across all
+ * nodes whose community is the target.
+ *
+ * Edges are intra-community `imports_from` + `calls` aggregated to
+ * the file level (a 12-call cluster from src/foo.ts → src/bar.ts
+ * becomes one edge with `occurrences: 12`).
+ *
+ * Empty result when the community id is unknown — the renderer
+ * surfaces a "community not found" error in that case.
+ */
+function adaptToTier2(graph, communityId) {
+    const community = graph.communityById.get(communityId);
+    if (!community) {
+        return { nodes: [], edges: [] };
+    }
+    // Files in the community: union of nodes[].sourceFile.
+    const filesInCommunity = new Set();
+    for (const nodeId of community.nodeIds) {
+        const node = graph.nodeById.get(nodeId);
+        if (node?.sourceFile)
+            filesInCommunity.add(node.sourceFile);
+    }
+    // Per-file call in-degree, computed via callersOf for Rule 12 compliance.
+    const callsInByFile = new Map();
+    for (const nodeId of community.nodeIds) {
+        const node = graph.nodeById.get(nodeId);
+        if (!node?.sourceFile)
+            continue;
+        const callers = (0, queries_1.callersOf)(graph, nodeId);
+        callsInByFile.set(node.sourceFile, (callsInByFile.get(node.sourceFile) ?? 0) + callers.length);
+    }
+    // Per-file pack id (derived from the most common extension in the file's nodes).
+    const packByFile = new Map();
+    for (const sourceFile of filesInCommunity) {
+        packByFile.set(sourceFile, packFromExt(sourceFile));
+    }
+    // Per-file line-of-code aggregation surfaces on hover.
+    const symbolCountByFile = new Map();
+    for (const sourceFile of filesInCommunity) {
+        symbolCountByFile.set(sourceFile, (0, queries_1.nodesInFile)(graph, sourceFile).length);
+    }
+    const maxCallsIn = Math.max(0, ...callsInByFile.values());
+    const fileToNodeId = (sourceFile) => `f2:${sourceFile}`;
+    const nodes = [...filesInCommunity].sort().map((sourceFile) => {
+        const callsIn = callsInByFile.get(sourceFile) ?? 0;
+        return {
+            group: 'nodes',
+            data: {
+                id: fileToNodeId(sourceFile),
+                label: basename(sourceFile),
+                size: maxCallsIn > 0 ? Math.sqrt(callsIn / maxCallsIn) : 0,
+                colorGroup: packByFile.get(sourceFile) || 'multi',
+                tier: 2,
+                communityId: community.id,
+                sourceFile,
+                meta: {
+                    callsIn,
+                    symbolCount: symbolCountByFile.get(sourceFile) ?? 0,
+                    path: sourceFile,
+                },
+            },
+        };
+    });
+    // Aggregate edges to the file level. Walk every node in the
+    // community + every outbound edge; bucket by (sourceFile,
+    // targetFile, relation).
+    const edgeKey = (from, to, rel) => `${from}\x00${to}\x00${rel}`;
+    const edgeBuckets = new Map();
+    for (const nodeId of community.nodeIds) {
+        const fromNode = graph.nodeById.get(nodeId);
+        if (!fromNode?.sourceFile)
+            continue;
+        const fromFile = fromNode.sourceFile;
+        for (const e of graph.edgesFromNode.get(nodeId) ?? []) {
+            if (e.relation === 'method')
+                continue;
+            const toNode = graph.nodeById.get(e.to);
+            if (!toNode?.sourceFile)
+                continue;
+            const toFile = toNode.sourceFile;
+            if (fromFile === toFile)
+                continue;
+            if (!filesInCommunity.has(toFile))
+                continue; // intra-community only at Tier 2
+            const k = edgeKey(fromFile, toFile, e.relation);
+            const existing = edgeBuckets.get(k);
+            if (existing) {
+                existing.occurrences += e.occurrences ?? 1;
+            }
+            else {
+                edgeBuckets.set(k, {
+                    from: fromFile,
+                    to: toFile,
+                    relation: e.relation,
+                    occurrences: e.occurrences ?? 1,
+                });
+            }
+        }
+    }
+    const maxOcc = Math.max(0, ...[...edgeBuckets.values()].map((b) => b.occurrences));
+    const edges = [...edgeBuckets.values()].map((b, i) => ({
+        group: 'edges',
+        data: {
+            id: `e2:${i}`,
+            source: fileToNodeId(b.from),
+            target: fileToNodeId(b.to),
+            relation: b.relation,
+            weight: maxOcc > 0 ? Math.sqrt(b.occurrences / maxOcc) : 0,
+            occurrences: b.occurrences,
+        },
+    }));
+    return { nodes, edges };
+}
+// ─── Tier 3 — symbols within a file ──────────────────────────────────────────
+/**
+ * Build the cytoscape elements for the symbol-view (Tier 3) of one
+ * file. Symbol nodes are the function / class / method declarations
+ * (module nodes are excluded — they're file-as-a-whole markers, not
+ * navigable symbols).
+ *
+ * Edges are `calls` edges between symbols within the file. Calls
+ * that LEAVE the file become "external" indicators carrying the
+ * target file path — the renderer styles them as dim arrows and
+ * makes them clickable for navigation.
+ *
+ * Empty result when no symbols are declared in the file (the file
+ * isn't in the graph) — the renderer surfaces a "no symbols
+ * extracted" message.
+ */
+function adaptToTier3(graph, sourceFile) {
+    const fileNodes = (0, queries_1.nodesInFile)(graph, sourceFile);
+    if (fileNodes.length === 0) {
+        return { nodes: [], edges: [] };
+    }
+    const symbolNodes = fileNodes.filter((n) => n.kind !== 'module');
+    const symbolIds = new Set(symbolNodes.map((n) => n.id));
+    // Per-symbol call in-degree drives size.
+    const callsInBySymbol = new Map();
+    for (const n of symbolNodes) {
+        callsInBySymbol.set(n.id, (0, queries_1.callersOf)(graph, n.id).length);
+    }
+    const maxCallsIn = Math.max(0, ...callsInBySymbol.values());
+    const nodes = symbolNodes.map((n) => ({
+        group: 'nodes',
+        data: {
+            id: `s3:${n.id}`,
+            label: stripParens(n.label),
+            size: maxCallsIn > 0 ? Math.sqrt((callsInBySymbol.get(n.id) ?? 0) / maxCallsIn) : 0,
+            colorGroup: n.kind, // 'function' | 'class' | 'method'
+            tier: 3,
+            sourceFile,
+            line: n.line,
+            meta: {
+                kind: n.kind,
+                callsIn: callsInBySymbol.get(n.id) ?? 0,
+                callsOut: (0, queries_1.calleesOf)(graph, n.id).length,
+                exported: n.exported === undefined ? 'unknown' : n.exported,
+            },
+        },
+    }));
+    const intraEdges = [];
+    const externalBuckets = new Map();
+    for (const n of symbolNodes) {
+        for (const e of graph.edgesFromNode.get(n.id) ?? []) {
+            if (e.relation !== 'calls')
+                continue;
+            if (symbolIds.has(e.to)) {
+                // Intra-file call — render as a real edge between two Tier 3 nodes.
+                intraEdges.push({
+                    group: 'edges',
+                    data: {
+                        id: `i3:${e.from}->${e.to}`,
+                        source: `s3:${e.from}`,
+                        target: `s3:${e.to}`,
+                        relation: 'calls',
+                        weight: 0, // weight assigned below once max is known
+                        occurrences: e.occurrences ?? 1,
+                    },
+                });
+            }
+            else {
+                // Out-of-file call — bucket by (source symbol, target file).
+                const target = graph.nodeById.get(e.to);
+                const targetFile = target?.sourceFile;
+                if (!targetFile || targetFile === sourceFile)
+                    continue;
+                const key = `${n.id}\x00${targetFile}`;
+                const existing = externalBuckets.get(key);
+                if (existing) {
+                    existing.occurrences += e.occurrences ?? 1;
+                }
+                else {
+                    externalBuckets.set(key, {
+                        sourceSymbol: n.id,
+                        targetFile,
+                        occurrences: e.occurrences ?? 1,
+                    });
+                }
+            }
+        }
+    }
+    // Weight scaling — share the same denominator across intra + external
+    // for visual consistency.
+    const allOcc = [
+        ...intraEdges.map((e) => e.data.occurrences ?? 1),
+        ...[...externalBuckets.values()].map((b) => b.occurrences),
+    ];
+    const maxOcc = Math.max(0, ...allOcc);
+    for (const edge of intraEdges) {
+        edge.data.weight = maxOcc > 0 ? Math.sqrt((edge.data.occurrences ?? 1) / maxOcc) : 0;
+    }
+    const externalEdges = [...externalBuckets.values()].map((b, i) => ({
+        group: 'edges',
+        data: {
+            id: `x3:${i}`,
+            source: `s3:${b.sourceSymbol}`,
+            target: `ext3:${b.targetFile}`,
+            relation: 'calls',
+            weight: maxOcc > 0 ? Math.sqrt(b.occurrences / maxOcc) : 0,
+            occurrences: b.occurrences,
+            externalTargetFile: b.targetFile,
+        },
+    }));
+    // Virtual "external file" nodes — one per distinct target file —
+    // sized small + neutral-colored. Renderer wires them as clickable
+    // "leaves this file" affordances.
+    const externalFiles = new Set([...externalBuckets.values()].map((b) => b.targetFile));
+    const externalNodes = [...externalFiles].sort().map((f) => ({
+        group: 'nodes',
+        data: {
+            id: `ext3:${f}`,
+            label: basename(f),
+            size: 0.1,
+            colorGroup: 'external',
+            tier: 3,
+            sourceFile: f,
+            meta: {
+                external: true,
+                path: f,
+            },
+        },
+    }));
+    return {
+        nodes: [...nodes, ...externalNodes],
+        edges: [...intraEdges, ...externalEdges],
+    };
+}
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function communityId(id) {
+    return `c1:${id}`;
+}
+function basename(p) {
+    if (!p)
+        return '';
+    const i = Math.max(p.lastIndexOf('/'), p.lastIndexOf('\\'));
+    return i >= 0 ? p.slice(i + 1) : p;
+}
+function stripParens(label) {
+    if (!label)
+        return '';
+    let s = label.replace(/\(\)$/, '');
+    if (s.includes('.'))
+        s = s.split('.').pop() ?? s;
+    return s;
+}
+function round2(n) {
+    return Math.round(n * 100) / 100;
+}
+// Tier 2's pack derivation mirrors `queries.ts:packFromExt` — kept
+// inline rather than re-exported from queries.ts because the public
+// queries.ts surface should remain the documented "graph queries"
+// API (per Rule 12) and not leak a per-extension lookup table.
+function packFromExt(sourceFile) {
+    const i = sourceFile.lastIndexOf('.');
+    if (i < 0)
+        return '';
+    const ext = sourceFile.slice(i).toLowerCase();
+    const map = {
+        '.ts': 'typescript',
+        '.tsx': 'typescript',
+        '.js': 'typescript',
+        '.jsx': 'typescript',
+        '.mjs': 'typescript',
+        '.cjs': 'typescript',
+        '.py': 'python',
+        '.go': 'go',
+        '.rs': 'rust',
+        '.cs': 'csharp',
+        '.kt': 'kotlin',
+        '.kts': 'kotlin',
+        '.java': 'java',
+        '.rb': 'ruby',
+    };
+    return map[ext] ?? '';
+}
+//# sourceMappingURL=graph-adapter.js.map

package/dist/dashboard/graph-adapter.js.map

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

package/dist/dashboard/graph-tab.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Dashboard graph-viz tab renderer — embeds graphify's vis.js viewer.
+ *
+ * Sprint 3 pivot (2026-05-27): rather than build a custom cytoscape
+ * tier drill-down, we embed the interactive viewer graphify itself
+ * ships. The upstream `graphify.export.to_html` writes a self-
+ * contained vis.js HTML page to `.dxkit/reports/graph.html` as a
+ * side-effect of `gatherGraphifyGraph` (see `analyzers/tools/
+ * graphify.ts`). This renderer:
+ *
+ *   1. reads that HTML
+ *   2. swaps graphify's unpkg.com `<script src=…vis-network…>` tag for
+ *      an inline `<script>` containing the locally-bundled
+ *      `vis-network.min.js` (offline-friendly per dxkit's posture —
+ *      no third-party fetch when the user opens the dashboard)
+ *   3. emits the swapped HTML inside an `<iframe srcdoc>` so the
+ *      embedded viewer's CSS + JS namespace stays isolated from the
+ *      host dashboard
+ *
+ * Empty-state branches when `graph.html` is missing (gather never
+ * ran, graph exceeded the 5000-node viz cap, etc.). Vendor-missing
+ * branch when `dist/dashboard/vendor/vis-network.min.js` is absent
+ * (`npm run build` hasn't run).
+ *
+ * Per CLAUDE.md Rule 12, we still flow `graph.json` reads through
+ * `loadGraph` even though the renderer doesn't consume `graph.json`
+ * itself — the loader doubles as our existence check before we go
+ * read `graph.html` off disk.
+ */
+/** Options accepted by the tab renderer. */
+export interface GraphTabOptions {
+    /**
+     * Project root. The renderer reads `.dxkit/reports/graph.json` for
+     * the existence check (via Rule 12's `loadGraph`) and then loads
+     * `.dxkit/reports/graph.html` from disk for embedding.
+     */
+    cwd?: string;
+    /**
+     * Override the vendor directory. Tests pass a tmpdir with a fake
+     * `vis-network.min.js` so they don't depend on `npm run build`
+     * having populated `dist/dashboard/vendor/`.
+     */
+    vendorDir?: string;
+    /**
+     * Override the on-disk path to graphify's `graph.html`. Defaults
+     * to `<cwd>/.dxkit/reports/graph.html`. Tests use a fixture path.
+     */
+    graphHtmlPath?: string;
+}
+/**
+ * One-stop renderer. Returns:
+ *   - `html`: the HTML fragment to splice into the dashboard body
+ *     (the new "Graph" tab pane).
+ *   - `navBadge`: the badge text the sidebar shows next to "Graph"
+ *     (community count when ready; "—" otherwise).
+ *   - `hasData`: convenience boolean — true when a viewable graph
+ *     was found and the iframe will render.
+ */
+export declare function renderGraphTab(opts: GraphTabOptions): {
+    html: string;
+    navBadge: string;
+    hasData: boolean;
+};
+/** Sidecar metadata produced by the graphify gather. */
+interface GraphHtmlMeta {
+    mode: 'full' | 'aggregated';
+    totalNodes: number;
+    totalEdges: number;
+    communities: number;
+    aggregatedNodeCount: number | null;
+}
+/**
+ * Prepend a small banner inside graphify's `<body>` explaining that
+ * the visible view is community-aggregated. Surfaced for honesty —
+ * the user should understand each node is a cluster, not a symbol,
+ * when the full graph exceeded the 5000-node viz cap.
+ *
+ * Exported for tests.
+ */
+export declare function injectAggregateBanner(html: string, meta: GraphHtmlMeta): string;
+/**
+ * Replace graphify's `<script src="https://unpkg.com/vis-network/...">`
+ * with an inline `<script>` containing the bundled vis-network source.
+ * The replacement is conservative — we match the upstream tag exactly
+ * (with optional version pin + path variations) and bail to the
+ * untouched HTML if the pattern doesn't fit. That way an upstream
+ * graphify change to a different CDN URL is surfaced as "viewer works
+ * online only" rather than a corrupt swap.
+ *
+ * Exported for tests; downstream consumers should use `renderGraphTab`.
+ */
+export declare function inlineVisNetwork(upstreamHtml: string, visBundle: string): string;
+/**
+ * HTML-encode the supplied HTML so it can sit safely inside an
+ * `<iframe srcdoc="…">` attribute. Only the characters that
+ * specifically break the attribute boundary — `&`, `"`, and `<` — get
+ * escaped. (`<` would prematurely close the iframe's start tag in the
+ * outer document if naive UTF-8 left it unescaped.)
+ */
+export declare function encodeForSrcdoc(html: string): string;
+/**
+ * CSS for the graph tab. The host dashboard at
+ * `src/analyzers/dashboard/index.ts` splices this into its global
+ * `<style>` block via a sibling import. The iframe gets a fixed-height
+ * fill of the tab area; the empty-state card centers vertically.
+ */
+export declare const GRAPH_TAB_CSS = "\n.graph-tab-pane { flex: 1; flex-direction: column; padding: 24px 28px; overflow: hidden; }\n.graph-tab-empty.graph-tab-pane { display: flex; align-items: center; justify-content: center; min-height: 400px; padding: 60px 32px; }\n.graph-empty-card { text-align: center; padding: 48px 32px; background: var(--bg-card); border-radius: 12px; border: 1px solid var(--border); max-width: 640px; }\n.graph-empty-icon { font-size: 56px; margin-bottom: 16px; }\n.graph-empty-card h2 { font-size: 22px; color: var(--text-primary); margin-bottom: 12px; }\n.graph-empty-card p { color: var(--text-secondary); line-height: 1.55; }\n.graph-empty-card code { background: var(--bg-tertiary); padding: 2px 6px; border-radius: 4px; font-family: ui-monospace, \"SF Mono\", Menlo, monospace; font-size: 0.92em; }\n.graph-iframe { width: 100%; height: 100%; min-height: 600px; border: 1px solid var(--border); border-radius: 10px; background: var(--bg-primary); }\n";
+export {};
+//# sourceMappingURL=graph-tab.d.ts.map

package/dist/dashboard/graph-tab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-tab.d.ts","sourceRoot":"","sources":["../../src/dashboard/graph-tab.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAUH,4CAA4C;AAC5C,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB,CAgFA;AAUD,wDAAwD;AACxD,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAsBD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,CAe/E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAsBhF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAwCD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,u7BASzB,CAAC"}