codegraph-java 0.1.0

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

@@ -0,0 +1,139 @@
+/**
+ * The anchor's body as the code reads it — the Steps view's second reading.
+ *
+ * `steps.ts` walks FORWARD from the anchor and draws what it sets in motion,
+ * a row per distance. That is the right picture for a screen, where handlers
+ * fire on events and nothing orders them. It is the wrong one for a handler:
+ * on proshop's login, `User.findOne`, `jwt.sign`, `200` and `401` are each one
+ * step from the anchor and land side by side, when the code says *first the
+ * lookup, then IF the password matches sign a token and answer 200, ELSE
+ * answer 401* — and the signing happens INSIDE the reply it is part of.
+ *
+ * This file turns the same walk into that reading: items in source order,
+ * forks where the code forks, an arm that replies or leaves ending there, and
+ * a folded helper drawn in place at the call. It is a pure function of the
+ * records the walk made ({@link ProgramSite}) — no graph, no source, no
+ * control-flow graph. A fork exists only where a guard was READ, so a language
+ * without rules, or a file that drifted since the index, yields a plain
+ * sequence rather than an invented structure.
+ *
+ * What makes the fold possible is that a guard names the DECISION it belongs
+ * to and not just its own words (`BranchGuard.branch`): the `if` and the
+ * `else` of one statement carry the same branch with `negated` flipped, an
+ * early exit carries the branch of the `if` that returned, and every case of a
+ * switch carries the branch of the switch. Two sites are arms of one fork when
+ * they agree on the branch and disagree on the arm — which a joined condition
+ * string can never say.
+ */
+import { type BranchGuard, type SiteLoop } from '../../graph/branch-guards';
+import type { WireNodeRef } from './wire';
+/** How an arm of a fork leaves, when it does — the rail stops there. */
+export type WireArmEnd = 'reply' | 'return' | 'throw' | 'exit';
+export interface WireArm {
+    /** This arm's own condition, in the words the rest of the view uses. */
+    when: string;
+    /** The arm taken when the fork's condition does NOT hold — the `else` side. */
+    not?: true;
+    /** How it leaves: it answers the request, returns, or throws. Null = it runs on. */
+    ends: WireArmEnd | null;
+    body: WireBlock;
+}
+export type WireBlock = WireItem[];
+export type WireItem = 
+/**
+ * A step of the picture, where the code writes it. `body` is what it does,
+ * when the walk entered it; `again` says it happens here too and was read
+ * above — a function is read ONCE in a rail, however many times it is called.
+ */
+{
+    kind: 'step';
+    step: string;
+    link?: string;
+    within?: string;
+    body?: WireBlock;
+    again?: true;
+}
+/** A decision: `if` / `else`, a `switch`, a ternary, a `try`, or an early exit. */
+ | {
+    kind: 'fork';
+    on: string;
+    form: 'if' | 'switch' | 'ternary' | 'try';
+    arms: WireArm[];
+}
+/**
+ * A run of items that is not plain sequence: a helper drawn where it is
+ * called (`inline`), a body that runs for each item (`loop`), work that runs
+ * after this function returns (`later`), or calls started together
+ * (`together`).
+ */
+ | {
+    kind: 'block';
+    block: 'inline' | 'loop' | 'later' | 'together';
+    by?: string;
+    /** For a loop: whether it runs once per item or while a condition holds. */
+    loop?: 'each' | 'while';
+    via?: WireNodeRef;
+    within?: string;
+    body: WireBlock;
+    again?: true;
+}
+/** Where the reading stopped: a helper that calls itself, or a cap the walk hit. */
+ | {
+    kind: 'cut';
+    why: 'folded' | 'depth';
+};
+export interface WireProgram {
+    root: WireBlock;
+    /** Items the reading could not place — a recursion or a cap it hit. */
+    truncated: number;
+}
+/** One thing that happens in one function, and where the code writes it. */
+export interface ProgramSite {
+    /** The step reached here, when one is. */
+    step?: string;
+    /** The link that step arrived on — the panel's row for this site. */
+    link?: string;
+    /** The helper the walk folded into here; its own sites are its body. */
+    into?: string;
+    /** Where the call is written: its start, and the end of its span. */
+    at: {
+        line: number;
+        column: number;
+        end: {
+            line: number;
+            column: number;
+        };
+    };
+    /** The call this one is written inside the arguments of (`res.json`). */
+    within?: string;
+    /** The conditions it runs under, outermost first. */
+    guards: BranchGuard[];
+    /** The loops it is written inside, outermost first. */
+    loops?: SiteLoop[];
+    /** What fires it, when something binds it — a callback runs LATER. */
+    trigger?: {
+        kind: string;
+        name: string;
+        of?: string | null;
+    };
+}
+export interface ProgramInput {
+    /** The sites of each function, by the function's node id. */
+    sites: ReadonlyMap<string, readonly ProgramSite[]>;
+    /** Where the reading starts: the anchor's root function. */
+    root: string | null;
+    /** A folded helper, for the words on the block it opens. */
+    node(id: string): WireNodeRef | null;
+    /**
+     * What a step is, for the two things the reading needs to know: whether it
+     * ANSWERS (a reply ends its arm), and the function to read on into when the
+     * walk entered it (null for a boundary, an effect, or a step of its own
+     * chapter).
+     */
+    step(id: string): {
+        reply: boolean;
+        into: string | null;
+    } | null;
+}
+export declare function buildProgram(input: ProgramInput): WireProgram | null;
+//# sourceMappingURL=program.d.ts.map

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

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

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

@@ -0,0 +1,315 @@
+"use strict";
+/**
+ * The anchor's body as the code reads it — the Steps view's second reading.
+ *
+ * `steps.ts` walks FORWARD from the anchor and draws what it sets in motion,
+ * a row per distance. That is the right picture for a screen, where handlers
+ * fire on events and nothing orders them. It is the wrong one for a handler:
+ * on proshop's login, `User.findOne`, `jwt.sign`, `200` and `401` are each one
+ * step from the anchor and land side by side, when the code says *first the
+ * lookup, then IF the password matches sign a token and answer 200, ELSE
+ * answer 401* — and the signing happens INSIDE the reply it is part of.
+ *
+ * This file turns the same walk into that reading: items in source order,
+ * forks where the code forks, an arm that replies or leaves ending there, and
+ * a folded helper drawn in place at the call. It is a pure function of the
+ * records the walk made ({@link ProgramSite}) — no graph, no source, no
+ * control-flow graph. A fork exists only where a guard was READ, so a language
+ * without rules, or a file that drifted since the index, yields a plain
+ * sequence rather than an invented structure.
+ *
+ * What makes the fold possible is that a guard names the DECISION it belongs
+ * to and not just its own words (`BranchGuard.branch`): the `if` and the
+ * `else` of one statement carry the same branch with `negated` flipped, an
+ * early exit carries the branch of the `if` that returned, and every case of a
+ * switch carries the branch of the switch. Two sites are arms of one fork when
+ * they agree on the branch and disagree on the arm — which a joined condition
+ * string can never say.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildProgram = buildProgram;
+const branch_guards_1 = require("../../graph/branch-guards");
+// =============================================================================
+// The fold
+// =============================================================================
+/** Callbacks whose argument runs after this function returns, not where it is written. */
+const LATER_OF = /^(?:then|catch|finally|setTimeout|setInterval|setImmediate|queueMicrotask|requestAnimationFrame|useEffect|useLayoutEffect|addListener|addEventListener|on|once|subscribe|nextTick|process\.nextTick)$/;
+/** Calls whose arguments are started TOGETHER, not one after the other. */
+const TOGETHER = /^(?:Promise\.(?:all|allSettled|any|race)|asyncio\.gather|Task\.WhenAll|Task\.WhenAny)$/;
+/** How deep a helper may be drawn inside a helper before the reading says so. */
+const MAX_INLINE = 8;
+/** Items in one reading. A rail past this is not a reading any more. */
+const MAX_ITEMS = 1200;
+function buildProgram(input) {
+    if (input.root === null)
+        return null;
+    const state = { truncated: 0, items: 0, read: new Set([input.root]) };
+    const root = blockFor(input, input.root, [input.root], state);
+    return root.length === 0 ? null : { root, truncated: state.truncated };
+}
+/** One function's body, in the code's order. */
+function blockFor(input, fn, path, state) {
+    const sites = [...(input.sites.get(fn) ?? [])].sort(compareSites);
+    if (sites.length === 0)
+        return [];
+    const root = [];
+    /** The constructs open at the site being placed, outermost first. */
+    const stack = [];
+    const bodyAt = (depth) => (depth === 0 ? root : stack[depth - 1].body);
+    for (const site of sites) {
+        const scopes = scopesOf(site);
+        // The longest run of open constructs the site still sits inside — same
+        // construct AND, for a fork, the same arm of it.
+        let keep = 0;
+        while (keep < stack.length && keep < scopes.length && sameScope(stack[keep], scopes[keep]))
+            keep++;
+        // The construct after it may still be the SAME decision taken the other
+        // way — an `else`, another `case`, the code after an early exit. That keeps
+        // the fork and opens its other arm; anything deeper is closed either way.
+        const open = stack[keep];
+        const scope = scopes[keep];
+        if (open && scope && open.branch === scope.branch && open.fork && scope.kind === 'guard') {
+            stack.length = keep + 1;
+            open.armKey = armKey(scope.guard);
+            open.body = armFor(open.fork, scope.guard).body;
+            keep++;
+        }
+        else {
+            stack.length = keep;
+        }
+        for (let i = keep; i < scopes.length; i++)
+            stack.push(openScope(bodyAt(i), scopes[i]));
+        const item = itemFor(input, site, path, state);
+        if (item !== null) {
+            state.items++;
+            place(bodyAt(scopes.length), item, site);
+        }
+    }
+    // An arm that answers the request, or whose code leaves, stops there.
+    seal(input, root);
+    return root;
+}
+/**
+ * The constructs a site is written inside, outermost first: its guards and its
+ * loops merged by where each one STARTS. Both were read by the same climb up
+ * the same ancestors, and on one ancestor chain an outer construct always
+ * begins before an inner one — so the positions alone rebuild the nesting,
+ * without either reading having to know about the other.
+ */
+function scopesOf(site) {
+    const guards = site.guards.map((guard) => ({ kind: 'guard', branch: guard.branch, guard }));
+    const loops = (site.loops ?? []).map((loop) => ({ kind: 'loop', branch: loop.branch, loop }));
+    if (loops.length === 0)
+        return guards;
+    return [...guards, ...loops].sort((a, b) => at(a.branch) - at(b.branch) || a.branch.localeCompare(b.branch));
+}
+/** A `line:column` branch as one number, for ordering constructs by where they start. */
+function at(branch) {
+    const [line, column] = branch.split(':');
+    return (Number(line) || 0) * 10000 + (Number(column) || 0);
+}
+function sameScope(open, scope) {
+    if (open.branch !== scope.branch)
+        return false;
+    if (scope.kind === 'loop')
+        return !open.fork;
+    return !!open.fork && open.armKey === armKey(scope.guard);
+}
+/** Open a construct: a bracketed loop, or a fork with the arm this site is in. */
+function openScope(into, scope) {
+    if (scope.kind === 'loop') {
+        const block = { kind: 'block', block: 'loop', by: scope.loop.text, loop: scope.loop.kind, body: [] };
+        into.push(block);
+        return { branch: scope.branch, body: block.body };
+    }
+    const g = scope.guard;
+    // The decision as a reader says it, not as the guard stores it: a
+    // disjunction keeps the parentheses that stop `a || b` from reading as two
+    // ways of arriving (`guardLabel` is the one place that decides).
+    const fork = { kind: 'fork', on: (0, branch_guards_1.guardLabel)([{ ...g, negated: false }]), form: formOf(g), arms: [] };
+    // An early exit is a fork whose OTHER arm left before this site could run:
+    // `if (!product) throw` — the throw is written first, so it is the first arm,
+    // and it is empty because nothing in the picture happens there.
+    if (g.form === 'guard' && g.negated) {
+        fork.arms.push({ when: (0, branch_guards_1.guardLabel)([{ ...g, negated: false }]), ends: g.exit ?? 'return', body: [] });
+    }
+    into.push(fork);
+    return { branch: scope.branch, fork, armKey: armKey(g), body: armFor(fork, g).body };
+}
+/** What one recorded site draws as. */
+function itemFor(input, site, path, state) {
+    if (site.into) {
+        // A helper the walk folded: drawn where it is called, its own body inside.
+        const via = input.node(site.into);
+        const block = {
+            kind: 'block',
+            block: 'inline',
+            ...(via ? { via } : {}),
+            ...(site.within ? { within: site.within } : {}),
+            body: [],
+        };
+        if (!open(site.into, path, state)) {
+            block.again = true;
+            return block;
+        }
+        block.body = blockFor(input, site.into, [...path, site.into], state);
+        return block.body.length === 0 ? null : block;
+    }
+    if (!site.step)
+        return null;
+    const step = input.step(site.step);
+    const item = {
+        kind: 'step',
+        step: site.step,
+        ...(site.link ? { link: site.link } : {}),
+        ...(site.within ? { within: site.within } : {}),
+    };
+    // A step the walk entered reads on into what it does — the same steps the
+    // tree draws a row below, here under the box that reaches them.
+    if (step?.into) {
+        if (open(step.into, path, state)) {
+            const body = blockFor(input, step.into, [...path, step.into], state);
+            if (body.length > 0)
+                item.body = body;
+        }
+        else if (input.sites.has(step.into))
+            item.again = true;
+    }
+    return item;
+}
+/**
+ * Whether this reading may open a function's body here: not if it is already
+ * open on the way in (a helper that calls itself), not if it has been read
+ * somewhere else in this picture, and not past the depth or the size the
+ * reading allows.
+ */
+function open(fn, path, state) {
+    if (path.includes(fn) || state.read.has(fn))
+        return false;
+    if (path.length >= MAX_INLINE || state.items >= MAX_ITEMS) {
+        state.truncated++;
+        return false;
+    }
+    state.read.add(fn);
+    return true;
+}
+/**
+ * Put an item in its block, opening the run it belongs to: work registered to
+ * run later, and calls started together, are not the sequence they are written
+ * in and say so rather than pretending.
+ */
+function place(block, item, site) {
+    const run = runFor(site);
+    if (run === null) {
+        block.push(item);
+        return;
+    }
+    const last = block[block.length - 1];
+    if (last && last.kind === 'block' && last.block === run.block && last.by === run.by) {
+        last.body.push(item);
+        return;
+    }
+    block.push({ kind: 'block', block: run.block, ...(run.by ? { by: run.by } : {}), body: [item] });
+}
+/** The run a site belongs to — registered to run later, started together — or null for plain sequence. */
+function runFor(site) {
+    const fires = site.trigger;
+    if (fires && fires.kind === 'callback' && LATER_OF.test(fires.name))
+        return { block: 'later', by: fires.name };
+    if (site.within && TOGETHER.test(site.within))
+        return { block: 'together', by: site.within };
+    return null;
+}
+/** An arm of a fork by its condition, reusing the one already open for it. */
+function armFor(fork, g) {
+    const when = (0, branch_guards_1.guardLabel)([g]);
+    const found = fork.arms.find((a) => a.when === when);
+    if (found)
+        return found;
+    const arm = { when, ...(g.negated ? { not: true } : {}), ends: g.armExit ?? null, body: [] };
+    fork.arms.push(arm);
+    return arm;
+}
+/** `!` and the condition — the arm, not the decision: an `if` and its `else` differ here and nowhere else. */
+function armKey(g) {
+    return `${g.negated ? '!' : ''}${g.text}`;
+}
+function formOf(g) {
+    switch (g.form) {
+        case 'case':
+            return 'switch';
+        case 'ternary':
+            return 'ternary';
+        case 'catch':
+            return 'try';
+        default:
+            return 'if';
+    }
+}
+/**
+ * How each arm ends, decided after its body is known: an arm whose last item
+ * answers the request ends with the reply — the strongest thing a reader can
+ * be told about an endpoint's arm — and otherwise the arm keeps how its code
+ * leaves, read at the site.
+ */
+function seal(input, block) {
+    for (const item of block) {
+        if (item.kind === 'fork') {
+            // A switch's head is the thing being decided on, which only its arms
+            // together say: every case was written `<subject> === <value>`.
+            if (item.form === 'switch')
+                item.on = subjectOf(item.arms.map((a) => a.when));
+            for (const arm of item.arms) {
+                seal(input, arm.body);
+                if (repliesLast(input, arm.body))
+                    arm.ends = 'reply';
+            }
+        }
+        else if (item.kind === 'block')
+            seal(input, item.body);
+        else if (item.kind === 'step' && item.body)
+            seal(input, item.body);
+    }
+}
+/**
+ * What every arm of a switch is deciding on: the longest start they share, cut
+ * at a word. '' when they share nothing — then the head says nothing and each
+ * arm says its own condition, which is never wrong.
+ */
+function subjectOf(arms) {
+    if (arms.length < 2)
+        return '';
+    let common = arms[0];
+    for (const arm of arms.slice(1)) {
+        let i = 0;
+        while (i < common.length && i < arm.length && common[i] === arm[i])
+            i++;
+        common = common.slice(0, i);
+    }
+    return /^[\w$.?[\]'"]+/.exec(common.trim())?.[0] ?? '';
+}
+/** Whether the last thing a block does is answer the request. */
+function repliesLast(input, block) {
+    const last = block[block.length - 1];
+    if (!last)
+        return false;
+    if (last.kind === 'step')
+        return input.step(last.step)?.reply === true;
+    if (last.kind === 'block')
+        return repliesLast(input, last.body);
+    return false;
+}
+/** Source order: a call written inside another's arguments runs first; then by position. */
+function compareSites(a, b) {
+    if (inside(a.at, b.at))
+        return -1;
+    if (inside(b.at, a.at))
+        return 1;
+    return a.at.line - b.at.line || a.at.column - b.at.column;
+}
+function inside(x, y) {
+    const afterStart = x.line > y.line || (x.line === y.line && x.column > y.column);
+    const beforeEnd = x.line < y.end.line || (x.line === y.end.line && x.column < y.end.column);
+    return afterStart && beforeEnd;
+}
+//# sourceMappingURL=program.js.map

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

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

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

@@ -0,0 +1,76 @@
+/**
+ * How the JSON API answers — success, refusal, and every failure in between.
+ *
+ * The viewer is the only client, and it runs on the same machine as the index,
+ * so an error here is a message to a developer looking at their own project,
+ * not information to withhold from a prober. Every failure therefore says what
+ * went wrong and — where there is one — what to do about it, exactly the way
+ * the CLI and the MCP tools do. What it never does is leak a stack trace.
+ */
+import type { IncomingMessage, ServerResponse } from 'http';
+/**
+ * Machine-readable failure reasons. The viewer switches on these rather than
+ * on prose, so renaming a message never breaks a screen.
+ */
+export type ApiErrorCode = 'bad-request' | 'not-found' | 'refused' | 'no-index' | 'index-unusable' | 'internal';
+/** An error that already carries a user-facing message and a status. */
+export declare class ApiError extends Error {
+    readonly code: ApiErrorCode;
+    /** Optional second line: what the user can do about it. */
+    readonly hint: string | undefined;
+    constructor(code: ApiErrorCode, message: string, hint?: string);
+}
+export declare function badRequest(message: string, hint?: string): ApiError;
+export declare function notFound(message: string, hint?: string): ApiError;
+/** Send a successful payload. */
+export declare function ok(res: ServerResponse, payload: unknown, method: string): true;
+/** Send a failure. Anything that is not an {@link ApiError} becomes a 500. */
+export declare function fail(res: ServerResponse, err: unknown, method: string): true;
+/**
+ * Bytes a request body may carry.
+ *
+ * The only body this server reads is a saved trail: a name and up to 64 node
+ * ids. 64 KB is generous for that and small enough that a runaway client cannot
+ * make the process hold a megabyte per socket.
+ */
+export declare const MAX_BODY_BYTES: number;
+/**
+ * Read a request body as JSON.
+ *
+ * Counts BYTES, not characters, and stops at the cap by destroying the socket
+ * rather than draining a body nobody is going to parse — a `Content-Length`
+ * header is a claim, and the only limit that holds is the one applied to what
+ * actually arrives.
+ *
+ * @throws {ApiError} `bad-request` for a body that is too large or is not JSON.
+ */
+export declare function readJsonBody(req: IncomingMessage): Promise<unknown>;
+/** A required, non-empty string parameter. */
+export declare function requiredParam(query: URLSearchParams, name: string): string;
+/**
+ * A bounded integer parameter.
+ *
+ * Out-of-range values are an error rather than silently clamped: a viewer
+ * asking for line 10 000 000 of a 200-line file has a bug, and answering it
+ * with line 200 would hide that.
+ */
+export declare function intParam(query: URLSearchParams, name: string, opts: {
+    min: number;
+    max: number;
+    default?: number;
+}): number;
+/**
+ * Free-form text input, bounded.
+ *
+ * The same reasoning as the MCP tools' input ceiling: a huge string is never a
+ * real query, and letting one through means a full-table LIKE scan or an FTS5
+ * parse over megabytes.
+ */
+export declare const MAX_QUERY_LENGTH = 2000;
+export declare function textParam(query: URLSearchParams, name: string): string;
+/**
+ * Text that must be PRESENT but may be empty — a search box the user has
+ * cleared. Absent is still an error; empty is a legitimate state.
+ */
+export declare function optionalTextParam(query: URLSearchParams, name: string): string;
+//# sourceMappingURL=respond.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"respond.d.ts","sourceRoot":"","sources":["../../../src/ui-server/api/respond.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAG5D;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB,aAAa,GACb,WAAW,GACX,SAAS,GACT,UAAU,GACV,gBAAgB,GAChB,UAAU,CAAC;AAgBf,wEAAwE;AACxE,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEtB,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAM/D;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAEnE;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAEjE;AAED,iCAAiC;AACjC,wBAAgB,EAAE,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAG9E;AAED,8EAA8E;AAC9E,wBAAgB,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAoB5E;AAMD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,QAAY,CAAC;AAExC;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAuBzE;AAMD,8CAA8C;AAC9C,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAM1E;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD,MAAM,CAaR;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,OAAQ,CAAC;AAEtC,wBAAgB,SAAS,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI9E"}