codegraph-java 0.1.0

package/dist/ui-server/api/when.d.ts

@@ -0,0 +1,125 @@
+/**
+ * `when` on a wire edge — the branch conditions its call site sits under,
+ * read from the source at request time (see `src/graph/branch-guards.ts`).
+ *
+ * The viewer groups a symbol's edges into relations; this annotates the edges
+ * of a set of relations in one pass, parsing each file once. Files that
+ * drifted since the index sync are skipped: the recorded line no longer
+ * reliably points at the call, and a label at the wrong line is worse than
+ * none. The pass is bounded so a hub with hundreds of callers cannot turn one
+ * Symbol view into a parse of the repository.
+ */
+import type CodeGraph from '../../index';
+import type { Language } from '../../types';
+import { type BranchGuard, type CallSiteText, type DefinitionDecorators, type SiteLoop, type SiteTrigger } from '../../graph/branch-guards';
+import type { WireEdge } from './wire';
+export interface WhenBatch {
+    /** POSIX project-relative path of the file the call sites are in. */
+    file: string;
+    edges: WireEdge[];
+}
+export declare function annotateWhen(cg: CodeGraph, projectRoot: string, batches: readonly WhenBatch[]): Promise<void>;
+/**
+ * A per-request reader of the conditions ONE call site sits under, for the
+ * endpoints that walk chains rather than annotate rails (the Screens view's
+ * transitions, the Steps view's links). Files are resolved once, drifted
+ * files yield no label, and the count of sites labelled is bounded so a wide
+ * walk cannot turn one request into a parse of the repository.
+ */
+export interface SiteReader {
+    /** The conditions the site runs under, joined; '' when unconditional or unreadable. */
+    when(caller: {
+        filePath: string;
+        language: Language;
+    }, site: {
+        line?: number;
+        column?: number;
+    }): Promise<string>;
+    /**
+     * The same conditions, outermost first, unjoined — each with the branching
+     * construct it belongs to, so two sites can be told to be the two arms of
+     * ONE `if` rather than two conditions that happen to read as opposites.
+     * What {@link SiteReader.when} joins; empty when unconditional or unreadable.
+     */
+    guards(caller: {
+        filePath: string;
+        language: Language;
+    }, site: {
+        line?: number;
+        column?: number;
+    }): Promise<BranchGuard[]>;
+    /** The loops the site is written inside, outermost first — a run of calls that happens once per item. */
+    loops(caller: {
+        filePath: string;
+        language: Language;
+    }, site: {
+        line?: number;
+        column?: number;
+    }): Promise<SiteLoop[]>;
+    /** What the site passes, abbreviated (`'userEmail', values.email`); null when unreadable. '' for an empty list. */
+    args(caller: {
+        filePath: string;
+        language: Language;
+    }, site: {
+        line?: number;
+        column?: number;
+    }): Promise<string | null>;
+    /** What fires the site — the JSX prop, `on*` option or runs-later call it is written under; null when nothing binds it. */
+    trigger(caller: {
+        filePath: string;
+        language: Language;
+    }, site: {
+        line?: number;
+        column?: number;
+    }): Promise<SiteTrigger | null>;
+    /** The call as written (the whole member chain) and what it passes; null when unreadable. `callee` names the call when a position is shared. */
+    callSite(caller: {
+        filePath: string;
+        language: Language;
+    }, site: {
+        line?: number;
+        column?: number;
+        callee?: string;
+    }): Promise<CallSiteText | null>;
+    /** The decorators / annotations / attributes on a definition, and on its class; null when unreadable. */
+    decorators(definition: {
+        filePath: string;
+        language: Language;
+        startLine: number;
+    }): Promise<DefinitionDecorators | null>;
+    /** The declared types of the members of the class a definition belongs to, by member name; empty when unreadable. */
+    memberTypes(definition: {
+        filePath: string;
+        language: Language;
+        startLine: number;
+    }): Promise<Map<string, string>>;
+    /**
+     * The `'use server'` / `'use client'` directive a JS-family file opens with,
+     * and whether the definition itself opens with `'use server'` (a server
+     * action declared inline). Nothing for other languages or unreadable files.
+     */
+    directive(definition: {
+        filePath: string;
+        language: Language;
+        startLine: number;
+    }): Promise<{
+        file: 'server' | 'client' | null;
+        own: boolean;
+    }>;
+}
+/**
+ * Both readings of one call site — WHEN it runs and WITH WHAT — for the
+ * endpoints that walk chains (Screens, Steps). One file resolution and one
+ * parsed tree serve both; drifted files yield nothing; one site budget bounds
+ * the whole pass.
+ */
+export declare function createSiteReader(cg: CodeGraph, projectRoot: string, maxSites?: number): SiteReader;
+/** The `when` half of {@link createSiteReader}, for callers that read nothing else. */
+export declare function createWhenReader(cg: CodeGraph, projectRoot: string, maxSites?: number): (caller: {
+    filePath: string;
+    language: Language;
+}, site: {
+    line?: number;
+    column?: number;
+}) => Promise<string>;
+//# sourceMappingURL=when.d.ts.map

package/dist/ui-server/api/when.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"when.d.ts","sourceRoot":"","sources":["../../../src/ui-server/api/when.ts"],"names":[],"mappings":"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"}

package/dist/ui-server/api/when.js

@@ -0,0 +1,251 @@
+"use strict";
+/**
+ * `when` on a wire edge — the branch conditions its call site sits under,
+ * read from the source at request time (see `src/graph/branch-guards.ts`).
+ *
+ * The viewer groups a symbol's edges into relations; this annotates the edges
+ * of a set of relations in one pass, parsing each file once. Files that
+ * drifted since the index sync are skipped: the recorded line no longer
+ * reliably points at the call, and a label at the wrong line is worse than
+ * none. The pass is bounded so a hub with hundreds of callers cannot turn one
+ * Symbol view into a parse of the repository.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.annotateWhen = annotateWhen;
+exports.createSiteReader = createSiteReader;
+exports.createWhenReader = createWhenReader;
+const fs = __importStar(require("fs"));
+const branch_guards_1 = require("../../graph/branch-guards");
+const security_1 = require("../security");
+const source_1 = require("./source");
+/** Distinct files parsed per request, and sites labelled per request. */
+const MAX_FILES = 24;
+const MAX_SITES = 400;
+/**
+ * Wall-clock allowance for the whole pass. The Symbol view answers in under
+ * 100 ms; batches are taken in order (the focal file first), and once the
+ * budget is spent the remaining rails simply carry no `when`. The parsed
+ * trees are cached, so the next view of the same neighbourhood is cheaper.
+ */
+const BUDGET_MS = 40;
+async function annotateWhen(cg, projectRoot, batches) {
+    const byFile = new Map();
+    for (const batch of batches) {
+        const bucket = byFile.get(batch.file);
+        if (bucket)
+            bucket.push(...batch.edges);
+        else
+            byFile.set(batch.file, [...batch.edges]);
+    }
+    let files = 0;
+    let sites = 0;
+    const started = Date.now();
+    for (const [file, edges] of byFile) {
+        if (files >= MAX_FILES || sites >= MAX_SITES)
+            return;
+        if (files > 0 && Date.now() - started > BUDGET_MS)
+            return;
+        const found = (0, source_1.findIndexedFile)(cg, file);
+        if (!found || !(0, branch_guards_1.supportsBranchGuards)(found.record.language))
+            continue;
+        if ((0, source_1.hasDriftedOnDisk)(projectRoot, found.storedPath, found.record))
+            continue;
+        let abs;
+        try {
+            abs = (0, security_1.resolveProjectFile)(projectRoot, found.storedPath);
+        }
+        catch {
+            continue;
+        }
+        const withLine = edges.filter((e) => typeof e.line === 'number' && e.line > 0);
+        if (withLine.length === 0)
+            continue;
+        files++;
+        sites += withLine.length;
+        const guards = await (0, branch_guards_1.guardsForFile)(abs, found.record.language, withLine.map((e) => ({ line: e.line, column: typeof e.col === 'number' ? e.col : null })));
+        for (const edge of withLine) {
+            const g = guards.get((0, branch_guards_1.siteKey)({ line: edge.line, column: typeof edge.col === 'number' ? edge.col : null }));
+            const label = g ? (0, branch_guards_1.guardLabel)(g) : '';
+            if (label)
+                edge.when = label;
+        }
+    }
+}
+const JS_FAMILY = new Set(['javascript', 'typescript', 'tsx', 'jsx']);
+/** A file read for its directives, at most. */
+const MAX_DIRECTIVE_FILE = 512 * 1024;
+const FILE_DIRECTIVE = /^(?:\s|\/\/[^\n]*\n|\/\*[\s\S]*?\*\/)*(['"])use (server|client)\1/;
+const OWN_DIRECTIVE = /^\s*(['"])use server\1\s*;?\s*$/m;
+/**
+ * Both readings of one call site — WHEN it runs and WITH WHAT — for the
+ * endpoints that walk chains (Screens, Steps). One file resolution and one
+ * parsed tree serve both; drifted files yield nothing; one site budget bounds
+ * the whole pass.
+ */
+function createSiteReader(cg, projectRoot, maxSites = 600) {
+    const files = new Map();
+    const texts = new Map();
+    let sites = 0;
+    const resolve = (caller) => {
+        const posix = caller.filePath.replace(/\\/g, '/');
+        let file = files.get(posix);
+        if (file === undefined) {
+            file = null;
+            const found = (0, source_1.findIndexedFile)(cg, posix);
+            if (found && !(0, source_1.hasDriftedOnDisk)(projectRoot, found.storedPath, found.record)) {
+                try {
+                    file = { abs: (0, security_1.resolveProjectFile)(projectRoot, found.storedPath), language: found.record.language };
+                }
+                catch {
+                    file = null;
+                }
+            }
+            files.set(posix, file);
+        }
+        return file;
+    };
+    // Named rather than a method, because `createWhenReader` hands `when` out
+    // detached: it must not depend on `this`.
+    const guards = async (caller, site) => {
+        if (!site.line || sites >= maxSites || !(0, branch_guards_1.supportsBranchGuards)(caller.language))
+            return [];
+        const file = resolve(caller);
+        if (!file)
+            return [];
+        sites++;
+        const key = { line: site.line, column: typeof site.column === 'number' ? site.column : null };
+        return (await (0, branch_guards_1.guardsForFile)(file.abs, file.language, [key])).get((0, branch_guards_1.siteKey)(key)) ?? [];
+    };
+    return {
+        guards,
+        async when(caller, site) {
+            return (0, branch_guards_1.guardLabel)(await guards(caller, site));
+        },
+        async loops(caller, site) {
+            // Not counted against the budget: the tree is parsed for the site's
+            // guards anyway, and this is a second climb up the same nodes.
+            if (!site.line || !(0, branch_guards_1.supportsBranchGuards)(caller.language))
+                return [];
+            const file = resolve(caller);
+            if (!file)
+                return [];
+            const key = { line: site.line, column: typeof site.column === 'number' ? site.column : null };
+            return (await (0, branch_guards_1.loopsForFile)(file.abs, file.language, [key])).get((0, branch_guards_1.siteKey)(key)) ?? [];
+        },
+        async args(caller, site) {
+            if (!site.line || sites >= maxSites || !(0, branch_guards_1.supportsBranchGuards)(caller.language))
+                return null;
+            const file = resolve(caller);
+            if (!file)
+                return null;
+            sites++;
+            const key = { line: site.line, column: typeof site.column === 'number' ? site.column : null };
+            return (await (0, branch_guards_1.callArgumentsForFile)(file.abs, file.language, [key])).get((0, branch_guards_1.siteKey)(key)) ?? null;
+        },
+        async trigger(caller, site) {
+            // Not counted against the budget: the tree is already parsed for the
+            // site's guards, and a trigger lookup is a walk up from one node.
+            if (!site.line || !(0, branch_guards_1.supportsBranchGuards)(caller.language))
+                return null;
+            const file = resolve(caller);
+            if (!file)
+                return null;
+            const key = { line: site.line, column: typeof site.column === 'number' ? site.column : null };
+            return (await (0, branch_guards_1.triggersForFile)(file.abs, file.language, [key])).get((0, branch_guards_1.siteKey)(key)) ?? null;
+        },
+        async callSite(caller, site) {
+            if (!site.line || sites >= maxSites || !(0, branch_guards_1.supportsBranchGuards)(caller.language))
+                return null;
+            const file = resolve(caller);
+            if (!file)
+                return null;
+            sites++;
+            const key = { line: site.line, column: typeof site.column === 'number' ? site.column : null, ...(site.callee ? { callee: site.callee } : {}) };
+            return (await (0, branch_guards_1.callSitesForFile)(file.abs, file.language, [key])).get((0, branch_guards_1.siteKey)(key)) ?? null;
+        },
+        async decorators(definition) {
+            // Not counted: one lookup per step, on a tree the walk has parsed anyway.
+            if (!definition.startLine || !(0, branch_guards_1.supportsBranchGuards)(definition.language))
+                return null;
+            const file = resolve(definition);
+            if (!file)
+                return null;
+            return (await (0, branch_guards_1.decoratorsForFile)(file.abs, file.language, [definition.startLine])).get(definition.startLine) ?? null;
+        },
+        async memberTypes(definition) {
+            if (!definition.startLine || !(0, branch_guards_1.supportsBranchGuards)(definition.language))
+                return new Map();
+            const file = resolve(definition);
+            if (!file)
+                return new Map();
+            return (0, branch_guards_1.memberTypesForFile)(file.abs, file.language, definition.startLine);
+        },
+        async directive(definition) {
+            // Not counted: a text read, cached per file, no tree.
+            const none = { file: null, own: false };
+            if (!JS_FAMILY.has(definition.language))
+                return none;
+            const file = resolve(definition);
+            if (!file)
+                return none;
+            let text = texts.get(file.abs);
+            if (text === undefined) {
+                try {
+                    text = fs.statSync(file.abs).size <= MAX_DIRECTIVE_FILE ? fs.readFileSync(file.abs, 'utf8') : null;
+                }
+                catch {
+                    text = null;
+                }
+                texts.set(file.abs, text);
+            }
+            if (text === null)
+                return none;
+            const head = FILE_DIRECTIVE.exec(text);
+            const fileDirective = head ? head[2] : null;
+            let own = false;
+            if (definition.startLine > 0) {
+                const lines = text.split('\n');
+                own = OWN_DIRECTIVE.test(lines.slice(definition.startLine - 1, definition.startLine + 3).join('\n'));
+            }
+            return { file: fileDirective, own };
+        },
+    };
+}
+/** The `when` half of {@link createSiteReader}, for callers that read nothing else. */
+function createWhenReader(cg, projectRoot, maxSites = 600) {
+    return createSiteReader(cg, projectRoot, maxSites).when;
+}
+//# sourceMappingURL=when.js.map

package/dist/ui-server/api/when.js.map

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

package/dist/ui-server/api/wire.d.ts

@@ -0,0 +1,179 @@
+/**
+ * The wire shapes the viewer reads, and the rules for producing them.
+ *
+ * Two ideas run through this file:
+ *
+ * 1. **One round-trip per screen.** Every endpoint returns everything a screen
+ *    draws, in the spirit of `codegraph_explore`: the Symbol view never has to
+ *    ask a follow-up question to render a rail, a badge or a count.
+ * 2. **Capped lists, honest totals.** A symbol with 545 callers cannot ship 545
+ *    rows, but it must never claim it has fewer. Every capped list carries the
+ *    true `total` beside the `shown` slice, so the UI can say "+N more" rather
+ *    than quietly truncating.
+ *
+ * Nothing here reads the filesystem — that lives in `source.ts`, behind
+ * `resolveProjectFile`.
+ */
+import type { Edge, EdgeKind, Language, Node, NodeKind } from '../../types';
+/**
+ * Fan-in at or above which a symbol is a "hub" — changing it is a
+ * repo-wide event. Matches the threshold the Symbol view's `hub · N` badge
+ * uses (design spec §3.2).
+ */
+export declare const HUB_THRESHOLD = 40;
+/**
+ * Below this resolution confidence an edge is a name-only guess. The viewer
+ * folds these away behind "Uncertain · N name-only matches, confidence < 0.6"
+ * rather than mixing them into the rails as if they were resolved.
+ */
+export declare const UNCERTAIN_BELOW = 0.6;
+/** Caller groups (one per calling symbol) returned for a node. */
+export declare const MAX_INCOMING_GROUPS = 300;
+/** Callee groups (one per called symbol) returned for a node. */
+export declare const MAX_OUTGOING_GROUPS = 200;
+/** Edges kept inside a single group — one symbol calling another 400 times. */
+export declare const MAX_EDGES_PER_GROUP = 40;
+/** Test files named in a node's test-caller summary (explore uses the same shape). */
+export declare const MAX_TEST_FILES = 6;
+/**
+ * Dependency hops the blast-radius summary walks. Matches the depth
+ * `codegraph_explore` claims when it says "within 3 hops".
+ */
+export declare const BLAST_DEPTH = 3;
+/** Caller hops walked looking for a test. Mirrors `codegraph_explore`'s "tests:" line. */
+export declare const TEST_CALLER_HOPS = 3;
+/** `getCallers` lookups the test walk may spend, so a god-symbol can't stall a request. */
+export declare const TEST_CALLER_BUDGET = 64;
+/** Unresolved references listed by name before the payload just counts them. */
+export declare const MAX_OUTSIDE_INDEX_SAMPLES = 40;
+/** Symbols in a file outline. Beyond this the outline is truncated, not dropped. */
+export declare const MAX_OUTLINE_NODES = 3000;
+/** Files listed in each direction of the File view's import rails. */
+export declare const MAX_IMPORT_FILES = 300;
+/**
+ * A symbol as it appears in a rail, an outline or a search result: enough to
+ * draw a row and navigate to it, and nothing else. Deliberately excludes the
+ * docstring — a 300-caller rail would otherwise ship 300 docstrings.
+ */
+export interface WireNodeRef {
+    id: string;
+    kind: NodeKind;
+    name: string;
+    qualifiedName: string;
+    /** Project-relative, forward slashes on every platform. */
+    file: string;
+    line: number;
+    endLine: number;
+    language: Language;
+    signature?: string;
+    exported?: boolean;
+    /** The file this symbol lives in looks like test/fixture code. */
+    test: boolean;
+    /**
+     * The file this symbol lives in is tool-generated, so the row draws in ink-4.
+     *
+     * OPTIONAL and absent by default: the verdict is a bounded lookup
+     * (`generatedFilePredicate`), affordable over a screen's worth of rows and
+     * not over a 545-caller rail. An endpoint fills it where it shows.
+     */
+    generated?: boolean;
+}
+/** The focal symbol of a Symbol view — the ref, plus everything the header shows. */
+export interface WireNodeDetail extends WireNodeRef {
+    startColumn: number;
+    endColumn: number;
+    docstring?: string;
+    visibility?: string;
+    async?: boolean;
+    static?: boolean;
+    abstract?: boolean;
+    decorators?: string[];
+    typeParameters?: string[];
+    returnType?: string;
+    /** `endLine - line + 1`, so the header can print "N lines" without the source. */
+    lines: number;
+}
+declare const rel: (p: string) => string;
+export declare function toNodeRef(node: Node): WireNodeRef;
+export declare function toNodeDetail(node: Node): WireNodeDetail;
+/**
+ * One edge, flattened.
+ *
+ * `metadata` is a free-form JSON blob in the schema; the fields lifted out here
+ * are the ones the viewer draws with — confidence decides the uncertain fold,
+ * `provenance`/`synthesizedBy`/`via`/`registeredAt` decide how a connector is
+ * dashed and what the "via <mechanism>" pill says, `valueRef` distinguishes
+ * "passes as value" from "calls". Anything else in the blob stays out: it is
+ * resolver bookkeeping, not something a reader can act on.
+ */
+export interface WireEdge {
+    kind: EdgeKind;
+    line?: number;
+    col?: number;
+    confidence?: number;
+    resolvedBy?: string;
+    provenance?: string;
+    synthesizedBy?: string;
+    via?: string;
+    registeredAt?: string;
+    valueRef?: boolean;
+    /**
+     * The conditions the call site runs under (`!isUploading && isCollected`),
+     * read from the source at request time — see `graph/branch-guards.ts`.
+     * Absent when the site is unconditional or the language has no rules.
+     */
+    when?: string;
+}
+export declare function toWireEdge(edge: Edge): WireEdge;
+/**
+ * Every edge between the focal symbol and ONE other symbol, as a single row.
+ *
+ * Grouping is what makes the rails readable: a helper called from eleven lines
+ * of the same function is one row with eleven call-site chips, not eleven rows.
+ */
+export interface WireRelation {
+    node: WireNodeRef;
+    /** Distinct edge kinds between the two, in first-seen order. */
+    edgeKinds: EdgeKind[];
+    /** Up to {@link MAX_EDGES_PER_GROUP} edges, ordered by line. */
+    edges: WireEdge[];
+    /** True number of edges, even when `edges` was capped. */
+    edgeCount: number;
+    /** Distinct call-site lines, ascending — what the gutter ports anchor to. */
+    lines: number[];
+    /** Highest confidence any edge in the group carries; null when none does. */
+    confidence: number | null;
+    /** The whole group is a name-only guess (see {@link UNCERTAIN_BELOW}). */
+    uncertain: boolean;
+    /** At least one edge was synthesized rather than parsed (dynamic dispatch). */
+    synthesized: boolean;
+    /** Fan-in of the other symbol — the `hub · N` pill. Only filled where the UI shows it. */
+    fanIn?: number;
+    hub?: boolean;
+}
+/** A capped list that still knows how long it really is. */
+export interface WireList<T> {
+    total: number;
+    shown: number;
+    truncated: boolean;
+    items: T[];
+}
+export declare function wireList<T>(items: T[], total: number): WireList<T>;
+/**
+ * Fold edges into one relation per counterpart symbol.
+ *
+ * @param edges     edges all sharing the focal node at one end
+ * @param endpoint  which end of each edge names the OTHER symbol
+ * @param nodes     batch-resolved endpoint nodes (never a lookup per edge)
+ */
+export declare function groupRelations(edges: readonly Edge[], endpoint: (edge: Edge) => string, nodes: Map<string, Node>): WireRelation[];
+/** First call-site line of a relation, for line-anchored ordering. Unlined rows sort last. */
+export declare function firstLine(relation: WireRelation): number;
+/** Node kinds that count as "a type" for the Symbol view's "types used" chips. */
+export declare const TYPE_KINDS: ReadonlySet<NodeKind>;
+/** Container kinds whose members the outline nests one level deeper. */
+export declare const CONTAINER_KINDS: ReadonlySet<NodeKind>;
+/** The four edge kinds `getCallers` treats as "reaches this symbol". */
+export declare const CALLER_EDGE_KINDS: ReadonlySet<EdgeKind>;
+export { rel as toPosixPath };
+//# sourceMappingURL=wire.d.ts.map

package/dist/ui-server/api/wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../../src/ui-server/api/wire.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAO5E;;;;GAIG;AACH,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC;;;;GAIG;AACH,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,kEAAkE;AAClE,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,sFAAsF;AACtF,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC;;;GAGG;AACH,eAAO,MAAM,WAAW,IAAI,CAAC;AAE7B,0FAA0F;AAC1F,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,2FAA2F;AAC3F,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,gFAAgF;AAChF,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C,oFAAoF;AACpF,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAMpC;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kEAAkE;IAClE,IAAI,EAAE,OAAO,CAAC;IACd;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qFAAqF;AACrF,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAC;CACf;AAED,QAAA,MAAM,GAAG,GAAI,GAAG,MAAM,KAAG,MAA+B,CAAC;AAEzD,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,WAAW,CAgBjD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,cAAc,CAgBvD;AAMD;;;;;;;;;GASG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,CAa/C;AAMD;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,WAAW,CAAC;IAClB,gEAAgE;IAChE,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,gEAAgE;IAChE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,0EAA0E;IAC1E,SAAS,EAAE,OAAO,CAAC;IACnB,+EAA+E;IAC/E,WAAW,EAAE,OAAO,CAAC;IACrB,0FAA0F;IAC1F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,4DAA4D;AAC5D,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,CAAC,EAAE,CAAC;CACZ;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAElE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,EAChC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,GACvB,YAAY,EAAE,CAgDhB;AAED,8FAA8F;AAC9F,wBAAgB,SAAS,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAExD;AAED,kFAAkF;AAClF,eAAO,MAAM,UAAU,EAAE,WAAW,CAAC,QAAQ,CAS3C,CAAC;AAEH,wEAAwE;AACxE,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,QAAQ,CAWhD,CAAC;AAEH,wEAAwE;AACxE,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,QAAQ,CAMlD,CAAC;AAEH,OAAO,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC"}