trail-code 0.0.0-stage → 0.28.0-semantic.3

package/dist/blast/diff.js.map

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

package/dist/blast/evidence.d.ts

@@ -0,0 +1,51 @@
+import type { Evidence } from "../viz/assemble.js";
+import type { Impacted, Seed } from "./blast.js";
+import type { ChangedFile } from "./diff.js";
+/** Symbols given their own snippet per node. Past this the panel is a file listing
+ * rather than a summary — the rest are still counted in the headline. */
+export declare const MAX_EVIDENCE = 4;
+/** `L12-L34` → the numbers, so a label is something a reader can type. */
+export declare function spanRange(span: string): {
+    start: number;
+    end: number;
+} | null;
+/** Evidence for one changed symbol: what this PR did to it. */
+export declare function seedEvidence(seed: Seed, file: ChangedFile | undefined): Evidence | null;
+/**
+ * The first line inside a span that mentions one of `needles`, with its number.
+ *
+ * This is the whole trick behind "why is this symbol here": the edge says A calls
+ * B, and this finds the line where it does it. Shared so `blast`'s panel, its
+ * comment and `graft callers` all quote the same line for the same edge.
+ */
+export declare function referenceLine(path: string, span: string, needles: RegExp[], read: (path: string) => string[] | null): {
+    n: number;
+    text: string;
+} | null;
+/** A symbol name, matched as a whole word — `export` must not hit `exportViz`. */
+export declare const wordRe: (name: string) => RegExp;
+/**
+ * Evidence for one dependent symbol: the line that reaches the diff.
+ *
+ * Nothing changed here, so there is no hunk to show — the useful line is the one
+ * naming a changed symbol or module, which answers "why am I in this blast radius
+ * at all". Found by reading the symbol's span off disk.
+ *
+ * When no line names the diff, this returns nothing rather than quoting the span's
+ * first line: for a file-level dependent that first line is `/**`, and a panel that
+ * shows it has spent a code block to say nothing.
+ */
+export declare function impactedEvidence(sym: Impacted, reach: ReachTerms, read: (path: string) => string[] | null): Evidence | null;
+/** What a line has to mention to be the line that reaches the diff. */
+export interface ReachTerms {
+    /** Changed symbol names, longest first. */
+    names: string[];
+    /** `from "./data.js"` for each changed file, matched on the module specifier so
+     * a common stem like `data` cannot match a variable of the same name. */
+    modules: RegExp[];
+}
+export declare function reachTerms(seeds: Seed[], changed: ChangedFile[]): ReachTerms;
+/** Read each file once, and never fail: a snippet is a nicety, and a symbol whose
+ * file moved under us must not take the whole page down. */
+export declare function fileReader(root: string | undefined): (path: string) => string[] | null;
+//# sourceMappingURL=evidence.d.ts.map

package/dist/blast/evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../../src/blast/evidence.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAgB,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAY,MAAM,WAAW,CAAC;AAIvD;yEACyE;AACzE,eAAO,MAAM,YAAY,IAAI,CAAC;AAK9B,0EAA0E;AAC1E,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAK7E;AAqCD,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,IAAI,CAavF;AAID;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,GAAG,IAAI,GACtC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQpC;AAED,kFAAkF;AAClF,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,KAAG,MAA+C,CAAC;AAEtF;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,GAAG,IAAI,GACtC,QAAQ,GAAG,IAAI,CA4BjB;AAED,uEAAuE;AACvE,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;6EACyE;IACzE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,UAAU,CAO5E;AAED;4DAC4D;AAC5D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,GAAG,IAAI,CAgBtF"}

package/dist/blast/evidence.js

@@ -0,0 +1,162 @@
+/**
+ * Turning a report into code a reader can see.
+ *
+ * `blast` knows which lines changed (git's hunks) and which symbols reach them
+ * (the walk), and both the hosted panel and the PR comment want to SHOW that
+ * rather than cite a line number the reader has to go and look up. The shaping
+ * lives here so the two surfaces quote the same lines: a comment that disagreed
+ * with the page it links to would be worse than one that said less.
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+const plural = (n, one, many = `${one}s`) => `${n} ${n === 1 ? one : many}`;
+/** Symbols given their own snippet per node. Past this the panel is a file listing
+ * rather than a summary — the rest are still counted in the headline. */
+export const MAX_EVIDENCE = 4;
+/** Lines shown per snippet before it folds. A handful is a hunk you can read at a
+ * glance; a 30-line refactor is a diff view's job, not a panel's. */
+const MAX_LINES = 6;
+/** `L12-L34` → the numbers, so a label is something a reader can type. */
+export function spanRange(span) {
+    const m = /^L(\d+)(?:-L(\d+))?$/.exec(span);
+    if (!m)
+        return null;
+    const start = Number(m[1]);
+    return { start, end: m[2] === undefined ? start : Number(m[2]) };
+}
+function labelFor(name, path, span) {
+    const r = spanRange(span);
+    return r ? `${name} · ${path}:${r.start}-${r.end}` : `${name} · ${path}`;
+}
+/** Keep the first {@link MAX_LINES}, and say how many were left. */
+function fold(lines) {
+    if (lines.length <= MAX_LINES)
+        return { lines };
+    return { lines: lines.slice(0, MAX_LINES), more: lines.length - MAX_LINES };
+}
+const asEvidenceLines = (lines) => lines.map((l) => ({ n: l.n, sign: l.sign, text: l.text }));
+/**
+ * The hunks of `file` that fall inside `span`.
+ *
+ * A file's diff is split by symbol rather than shown whole, because two unrelated
+ * edits in one file are two answers — a panel that merges them makes the reader do
+ * the separating.
+ */
+function hunksIn(file, span) {
+    const out = [];
+    let dropped = 0;
+    for (const h of file.hunks) {
+        if (span && (h.end < span.start || h.start > span.end))
+            continue;
+        out.push(...asEvidenceLines(h.lines));
+        dropped += h.dropped;
+    }
+    return { lines: out, dropped };
+}
+/** Evidence for one changed symbol: what this PR did to it. */
+export function seedEvidence(seed, file) {
+    if (!file)
+        return null;
+    const span = seed.wholeFile ? null : spanRange(seed.span);
+    const { lines, dropped } = hunksIn(file, span);
+    if (lines.length === 0 && dropped === 0)
+        return null;
+    const folded = fold(lines);
+    const more = (folded.more ?? 0) + dropped;
+    return {
+        label: seed.wholeFile ? seed.path : labelFor(seed.name, seed.path, seed.span),
+        note: file.status === "added" ? "new file" : seed.wholeFile ? "outside any symbol" : undefined,
+        lines: folded.lines,
+        more: more > 0 ? more : undefined,
+    };
+}
+const escapeRe = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+/**
+ * The first line inside a span that mentions one of `needles`, with its number.
+ *
+ * This is the whole trick behind "why is this symbol here": the edge says A calls
+ * B, and this finds the line where it does it. Shared so `blast`'s panel, its
+ * comment and `graft callers` all quote the same line for the same edge.
+ */
+export function referenceLine(path, span, needles, read) {
+    const range = spanRange(span);
+    const lines = read(path);
+    if (!range || !lines)
+        return null;
+    for (const [i, text] of lines.slice(range.start - 1, range.end).entries()) {
+        if (needles.some((re) => re.test(text)))
+            return { n: range.start + i, text };
+    }
+    return null;
+}
+/** A symbol name, matched as a whole word — `export` must not hit `exportViz`. */
+export const wordRe = (name) => new RegExp(`\\b${escapeRe(name)}\\b`);
+/**
+ * Evidence for one dependent symbol: the line that reaches the diff.
+ *
+ * Nothing changed here, so there is no hunk to show — the useful line is the one
+ * naming a changed symbol or module, which answers "why am I in this blast radius
+ * at all". Found by reading the symbol's span off disk.
+ *
+ * When no line names the diff, this returns nothing rather than quoting the span's
+ * first line: for a file-level dependent that first line is `/**`, and a panel that
+ * shows it has spent a code block to say nothing.
+ */
+export function impactedEvidence(sym, reach, read) {
+    // A changed symbol's own name is the strongest signal; a file-level dependent
+    // usually reaches the diff through its import line, which names a MODULE
+    // instead, so both are tried in that order.
+    const byName = referenceLine(sym.path, sym.span, reach.names.map(wordRe), read);
+    if (byName) {
+        const hit = reach.names.find((n) => wordRe(n).test(byName.text));
+        return {
+            label: labelFor(sym.name, sym.path, sym.span),
+            note: `${sym.relation} ${hit}`,
+            lines: [{ n: byName.n, sign: " ", text: byName.text }],
+        };
+    }
+    const byModule = referenceLine(sym.path, sym.span, reach.modules, read);
+    if (byModule) {
+        return {
+            label: labelFor(sym.name, sym.path, sym.span),
+            note: sym.relation,
+            lines: [{ n: byModule.n, sign: " ", text: byModule.text }],
+        };
+    }
+    // No line names the diff — an indirect reach (a dynamic import, a re-export),
+    // or a symbol whose whole file is the span. Quoting its first line means
+    // quoting `/**`, so the block is dropped instead: the path stays in `sources`
+    // and the panel simply says less.
+    return null;
+}
+export function reachTerms(seeds, changed) {
+    const names = [...new Set(seeds.filter((s) => !s.wholeFile).map((s) => s.name))].sort((a, b) => b.length - a.length);
+    const stems = [...new Set(changed.map((f) => f.path.replace(/\.[^./]+$/, "").split("/").pop() ?? ""))].filter(Boolean);
+    return {
+        names,
+        modules: stems.map((stem) => new RegExp(`["'\`][^"'\`]*\\b${escapeRe(stem)}(\\.[a-z]+)?["'\`]`)),
+    };
+}
+/** Read each file once, and never fail: a snippet is a nicety, and a symbol whose
+ * file moved under us must not take the whole page down. */
+export function fileReader(root) {
+    const cache = new Map();
+    return (path) => {
+        if (root === undefined)
+            return null;
+        const hit = cache.get(path);
+        if (hit !== undefined)
+            return hit;
+        let lines = null;
+        try {
+            lines = readFileSync(join(root, path), "utf8").split("\n");
+        }
+        catch {
+            // Deleted, renamed under us, or unreadable: no snippet, no failure.
+            lines = null;
+        }
+        cache.set(path, lines);
+        return lines;
+    };
+}
+//# sourceMappingURL=evidence.js.map

package/dist/blast/evidence.js.map

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

package/dist/blast/modules.d.ts

@@ -0,0 +1,33 @@
+export interface ModuleIndex {
+    /** Label for a repo-relative path — a concept name when one claims the file. */
+    labelOf(path: string): string;
+    /** The claiming concept's name, or null when only the directory fallback applies.
+     * Callers that group files need to tell the two apart: a shared concept is a real
+     * grouping signal, a shared directory is only a shared directory. */
+    conceptOf(path: string): string | null;
+    /** True when at least one concept node was read (i.e. a --deep graph). */
+    hasConcepts: boolean;
+}
+/**
+ * Build the path → module-label lookup for a context dir.
+ *
+ * A file can be cited by several concepts; the SMALLEST claiming concept wins.
+ * A concept grounded in three files says something specific about those three,
+ * while a forty-file concept is closer to "the codebase" — picking the tighter
+ * one keeps the diagram's boxes meaningful.
+ */
+export declare function moduleIndex(contextDir: string): ModuleIndex;
+/**
+ * A concept name trimmed to fit a node.
+ *
+ * Concept names are written for a reader with the whole file in front of them, so
+ * they run long and some carry a `Concept: ` prefix from the synthesis prompt.
+ * "Reciprocal-Rank Fusion for Workspace Federation" is a fine node title in `graft
+ * viz` and unreadable inside a circle.
+ */
+export declare function shortLabel(label: string): string;
+/** The parent directory of a directory label, or "" at the top level. */
+export declare function parentDir(dir: string): string;
+/** Fallback label: the file's directory, or `(root)` for a top-level file. */
+export declare function dirLabel(path: string): string;
+//# sourceMappingURL=modules.d.ts.map

package/dist/blast/modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.d.ts","sourceRoot":"","sources":["../../src/blast/modules.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,WAAW;IAC1B,gFAAgF;IAChF,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B;;yEAEqE;IACrE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACvC,0EAA0E;IAC1E,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,CAiB3D;AAeD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAWhD;AAED,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI7C;AAED,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7C"}

package/dist/blast/modules.js

@@ -0,0 +1,83 @@
+/**
+ * Module labels for the blast diagram — the "what part of the system is this?"
+ * layer, so a reviewer reads `Graph Extraction and Loading` instead of eleven
+ * file paths.
+ *
+ * Two sources, best first:
+ *   1. the deep tier's concept nodes (`graft/*.md`), whose frontmatter lists the
+ *      source files each concept was synthesized from. This is why `blast` is
+ *      worth running on a `build --deep` graph: the grouping is the product.
+ *   2. the file's directory, when no concept claims it (a breadth-tier graph, or
+ *      a file added by this very PR and therefore absent from the concept layer).
+ */
+import { readNodes } from "../context/node-file.js";
+/**
+ * Build the path → module-label lookup for a context dir.
+ *
+ * A file can be cited by several concepts; the SMALLEST claiming concept wins.
+ * A concept grounded in three files says something specific about those three,
+ * while a forty-file concept is closer to "the codebase" — picking the tighter
+ * one keeps the diagram's boxes meaningful.
+ */
+export function moduleIndex(contextDir) {
+    const claims = new Map();
+    const nodes = readNodes(contextDir);
+    for (const node of nodes) {
+        if (!node.name)
+            continue;
+        for (const src of node.sources) {
+            const prev = claims.get(src.path);
+            if (!prev || node.sources.length < prev.size) {
+                claims.set(src.path, { label: node.name, size: node.sources.length });
+            }
+        }
+    }
+    return {
+        hasConcepts: nodes.length > 0,
+        labelOf: (path) => shortLabel(claims.get(path)?.label ?? dirLabel(path)),
+        conceptOf: (path) => claims.get(path)?.label ?? null,
+    };
+}
+/** Longest label a circle can hold before the text overruns it. */
+const MAX_LABEL = 30;
+/**
+ * Clause breaks a long concept name can be cut at.
+ *
+ * A concept name is a sentence fragment, so it has real joints: everything after
+ * "via", "and", a colon or an opening parenthesis is elaboration. Cutting there
+ * leaves a phrase that still reads as a name — "Incremental Build" rather than
+ * "Incremental Build via…" — which is why these cuts take no ellipsis.
+ */
+const CLAUSE_BREAK = /\s(?:\(|—|-\s)|:\s|\s(?:via|and|for|with|using|in|across|over|from|of|by|to)\s/i;
+/**
+ * A concept name trimmed to fit a node.
+ *
+ * Concept names are written for a reader with the whole file in front of them, so
+ * they run long and some carry a `Concept: ` prefix from the synthesis prompt.
+ * "Reciprocal-Rank Fusion for Workspace Federation" is a fine node title in `graft
+ * viz` and unreadable inside a circle.
+ */
+export function shortLabel(label) {
+    const bare = label.replace(/^concepts?:\s*/i, "").trim();
+    if (bare.length <= MAX_LABEL)
+        return bare;
+    const at = CLAUSE_BREAK.exec(bare);
+    if (at && at.index >= 8 && at.index <= MAX_LABEL)
+        return bare.slice(0, at.index).trimEnd();
+    // No usable joint: a word-boundary cut, marked, because this one really does stop
+    // mid-phrase and a reader must not take the fragment for the whole name.
+    const cut = bare.lastIndexOf(" ", MAX_LABEL);
+    return `${bare.slice(0, cut > MAX_LABEL / 2 ? cut : MAX_LABEL).trimEnd()}…`;
+}
+/** The parent directory of a directory label, or "" at the top level. */
+export function parentDir(dir) {
+    const trimmed = dir.replace(/\/$/, "");
+    const cut = trimmed.lastIndexOf("/");
+    return cut === -1 ? "" : `${trimmed.slice(0, cut)}/`;
+}
+/** Fallback label: the file's directory, or `(root)` for a top-level file. */
+export function dirLabel(path) {
+    const cut = path.lastIndexOf("/");
+    return cut === -1 ? "(root)" : path.slice(0, cut) + "/";
+}
+//# sourceMappingURL=modules.js.map

package/dist/blast/modules.js.map

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

package/dist/blast/name.d.ts

@@ -0,0 +1,74 @@
+import type { ChatModel } from "../ai/llm/types.js";
+import type { GraphV1 } from "../graph/types.js";
+import type { BlastReport } from "./blast.js";
+/** One cluster to name: its identity, its files and the symbols inside it. */
+export interface Cluster {
+    key: string;
+    files: string[];
+    symbols: string[];
+}
+/** Anything that can turn clusters into names. A model in production, a stub in tests. */
+export interface Namer {
+    /** Names by cluster key. A key the namer chose not to name is simply absent. */
+    name(clusters: Cluster[]): Promise<Map<string, string>>;
+}
+export interface NameStats {
+    /** Labels taken from the cache, and labels that cost a call. */
+    cached: number;
+    named: number;
+    /** Clusters the namer declined ("mixed") or could not answer for. */
+    declined: number;
+    /** Set when naming was attempted and failed outright; the reason, for one line
+     * in the report. Never thrown: a comment without names still beats no comment. */
+    error?: string;
+}
+/** The production namer: one forced-tool call for every cluster at once. */
+export declare class ChatNamer implements Namer {
+    private readonly model;
+    constructor(model: ChatModel);
+    name(clusters: Cluster[]): Promise<Map<string, string>>;
+}
+/**
+ * A model-written string on its way into a Mermaid label and a markdown table.
+ *
+ * Symbol names from a fork's diff reach the prompt, so the answer is untrusted
+ * input: anything that could close a label, open a tag or start a table cell is
+ * stripped here rather than at each render site.
+ */
+export declare function sanitize(raw: string): string;
+/**
+ * The cache key for a cluster: what it contains, not what it is called.
+ *
+ * Member paths pin the shape and each member's `body_hash` pins the content, so a
+ * cluster is renamed only when the code in it actually changes. Without this the
+ * same area gets a slightly different name on every PR and two comments stop being
+ * comparable — the failure the cache exists to prevent.
+ */
+export declare function clusterHash(files: string[], hashes: Map<string, string>): string;
+export declare function loadNameCache(contextDir: string): Record<string, string>;
+export declare function saveNameCache(contextDir: string, names: Record<string, string>): void;
+/**
+ * Fill in labels for every cluster still sitting on its symbol backstop.
+ *
+ * Clusters already named by a concept node are left alone: a concept was written
+ * from whole file bodies, which is strictly more than the paths and symbol names
+ * this pass can see.
+ */
+export declare function applyNames(graph: GraphV1, report: BlastReport, opts: {
+    namer?: Namer;
+    contextDir: string;
+}): Promise<NameStats>;
+/**
+ * Name the clusters left on their symbol backstop, and say what it cost.
+ *
+ * Everything here is best-effort by construction: no key, a spent quota or a
+ * refused call leaves the backstop labels in place, because neither a PR check
+ * nor a review comment should fail over a cosmetic layer. The note comes back
+ * rather than going to a stream, so `graft blast --name` can prefix it and the
+ * App can log it against the pull request it belongs to.
+ */
+export declare function nameReport(graph: GraphV1, report: BlastReport, contextDir: string): Promise<{
+    stats: NameStats;
+    note: string | null;
+}>;
+//# sourceMappingURL=name.d.ts.map

package/dist/blast/name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"name.d.ts","sourceRoot":"","sources":["../../src/blast/name.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAA+B,MAAM,YAAY,CAAC;AAG3E,8EAA8E;AAC9E,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,0FAA0F;AAC1F,MAAM,WAAW,KAAK;IACpB,gFAAgF;IAChF,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,SAAS;IACxB,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;IACjB;sFACkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqDD,4EAA4E;AAC5E,qBAAa,SAAU,YAAW,KAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,SAAS;IAEvC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAuB9D;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG5C;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAGhF;AAMD,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxE;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAQrF;AAeD;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC1C,OAAO,CAAC,SAAS,CAAC,CAwDpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAwBpD"}