@canonical/pragma-cli 0.36.0 → 0.38.0

package/dist/src/capabilities/doctor/checks/targetHealth.js

@@ -26,7 +26,7 @@
  */
 import { MCP_SERVER_NAME } from "../../../constants.js";
 import { detectionFailure, detectTargets, resolveRoots, } from "../../setup/buildPlan.js";
-import { lspEditorNames, lspSkipReason, mcpGroupState, mcpWriteState, skillsSkipReason, skillsSkipRemedy, } from "../../setup/operations/index.js";
+import { blockedMcpGroups, describeEditorSource, firstLspBlock, firstMcpBlock, installableEditors, LSP_SKIP_REMEDY, lspBlockReason, lspEditorNames, lspSkipReason, mcpBlockReason, mcpGroupState, mcpWriteState, skillsSkipReason, skillsSkipRemedy, } from "../../setup/operations/index.js";
 import { shortenPath, TARGET_IDS } from "../../setup/plan.js";
 import { MCP_NO_LOCATION } from "../../setup/targets.js";
 import { checkShellCompletions } from "./checkShellCompletions.js";
@@ -42,15 +42,78 @@ const configHealth = (d, roots) => {
     }
     return { status: "pass", detail: `${path} — valid` };
 };
-/** The `lsp` row — the first this report has ever had. */
-const lspHealth = (d) => {
+/**
+ * The `lsp` row: one sub-item per editor, saying HOW it was found and where
+ * pragma stands in it.
+ *
+ * Provenance per editor is the point. A colleague whose macOS `setup lsp`
+ * reported nothing had VS Code installed the whole time, and a one-line row
+ * ("not installed in …", or a bare skip) could not tell them whether pragma had
+ * missed the editor or found it and could not act. Per the owner, 2026-09-16,
+ * this report says per editor how it was found and why a step was skipped.
+ *
+ * The row's own status keeps the report's invariant that every `available` row
+ * has a remedy: any editor that CAN be installed into makes the row
+ * `available`, whose derived fix is `pragma setup lsp`. A row where NOTHING is
+ * installed and nothing is installable is a `skip` carrying the first block's
+ * own remedy — a Nix declaration, a `chmod`, or the palette command — never
+ * the derived command, which would only reproduce the skip.
+ *
+ * An INSTALLED editor is a `pass` even when its extensions folder is blocked.
+ * The copy is there and works; the block only says this command cannot CHANGE
+ * it. Reporting a skip instead told the owner of a site-managed folder that
+ * already held the extension to chmod it and install again, and made a machine
+ * that is installed everywhere it can be a permanent `○ lsp`.
+ */
+const lspHealth = (d, roots) => {
     if (d.state === "unknown") {
-        return { status: "skip", detail: lspSkipReason(d) };
+        return {
+            status: "skip",
+            detail: lspSkipReason(d),
+            remedy: LSP_SKIP_REMEDY,
+        };
+    }
+    const items = d.editors.map((e) => {
+        const reason = e.installed ? undefined : lspBlockReason(e);
+        const state = reason ?? (e.installed ? "installed" : "not installed");
+        return {
+            label: e.editor.name,
+            status: e.installed
+                ? "pass"
+                : reason !== undefined
+                    ? "skip"
+                    : "available",
+            detail: `${describeEditorSource(e, roots)} · ${state}`,
+        };
+    });
+    const installable = installableEditors(d);
+    if (installable.length > 0) {
+        return {
+            status: "available",
+            detail: `not installed in ${installable.map((e) => e.editor.name).join(", ")}`,
+            items,
+        };
+    }
+    // Nothing installable. The row is the block's only when nothing is installed
+    // either — otherwise the honest headline is what IS in place.
+    const block = d.editors.some((e) => e.installed)
+        ? undefined
+        : firstLspBlock(d);
+    if (block !== undefined) {
+        return {
+            status: "skip",
+            // The headline names the editor; the item's own detail does not, because
+            // its label already has.
+            detail: block.headline,
+            items,
+            remedy: block.remedy,
+        };
     }
-    const editors = lspEditorNames(d).join(", ");
-    return d.state === "installed"
-        ? { status: "pass", detail: `installed in ${editors}` }
-        : { status: "available", detail: `not installed in ${editors}` };
+    return {
+        status: "pass",
+        detail: `installed in ${lspEditorNames(d).join(", ")}`,
+        items,
+    };
 };
 /**
  * The `mcp` row: one sub-item per file, each saying whether the entry is
@@ -66,6 +129,12 @@ async function mcpHealth(d, scope, cwd, roots) {
     const items = d.groups.map((group) => {
         const state = mcpGroupState(d, group.path);
         const label = shortenPath(group.path, roots);
+        // A file pragma must not write is reported as a skip, not as an
+        // `available` whose `fix:` would fail the moment it ran.
+        const blocked = mcpBlockReason(d, group, roots);
+        if (blocked !== undefined) {
+            return { label, status: "skip", detail: blocked };
+        }
         if (state === "absent") {
             return { label, status: "available", detail: "not registered" };
         }
@@ -80,6 +149,21 @@ async function mcpHealth(d, scope, cwd, roots) {
                 : `registered, but \`${MCP_SERVER_NAME}\` is not on PATH`,
         };
     });
+    // Every location blocked means the row's whole answer is the block: it
+    // carries the first one's remedy — the entry to declare by hand — rather than
+    // the derived `pragma setup mcp`, which would only reproduce the skip.
+    const blockedGroups = blockedMcpGroups(d);
+    const block = blockedGroups.length === d.groups.length
+        ? firstMcpBlock(d, roots)
+        : undefined;
+    if (block !== undefined) {
+        return {
+            status: "skip",
+            detail: block.reason,
+            items,
+            remedy: block.remedy,
+        };
+    }
     const configured = items.filter((item) => item.status === "pass").length;
     const failing = items.filter((item) => item.status === "fail").length;
     if (failing > 0) {
@@ -89,6 +173,7 @@ async function mcpHealth(d, scope, cwd, roots) {
             items,
         };
     }
+    const writable = items.length - blockedGroups.length;
     if (configured === 0) {
         // Absence in the LOCAL PROJECT is not a failure: registering there is
         // opt-in, so a repository with no checked-in MCP config is healthy. The
@@ -100,13 +185,13 @@ async function mcpHealth(d, scope, cwd, roots) {
             }
             : {
                 status: "available",
-                detail: `not registered in any of ${items.length} config files`,
+                detail: `not registered in any of ${writable} config files`,
                 items,
             };
     }
     return {
-        status: configured === items.length ? "pass" : "available",
-        detail: `registered in ${configured} of ${items.length} config files`,
+        status: configured === writable ? "pass" : "available",
+        detail: `registered in ${configured} of ${writable} config files`,
         items,
     };
 }
@@ -198,7 +283,7 @@ async function healthOf(row, rt, roots) {
             };
         }
         case "lsp":
-            return lspHealth(row.detection);
+            return lspHealth(row.detection, roots);
         case "mcp":
             return mcpHealth(row.detection, row.scope, rt.cwd, roots);
         default:
@@ -316,12 +401,17 @@ export const fixCommandFor = (id, scope, bin) => `${bin} setup ${id}${scope ===
  *
  * @param rt - The per-invocation runtime.
  * @param bin - The binary name the `fix:` lines are derived from.
+ * @param probe - The writability filesystem seam, threaded to every row's
+ *   detection. Defaults to the real one; a test injects a fixture to reach the
+ *   blocked arms — a `/nix/store` path, a directory that refuses `W_OK` —
+ *   through THIS entry point, rather than opening the row bodies up as exports
+ *   nothing in production would call.
  * @returns One {@link CheckResult} per (target, scope), plus one per scope.
  * @note Impure — every target's detection reads the real filesystem.
  */
-export async function scopedChecks(rt, bin) {
+export async function scopedChecks(rt, bin, probe) {
     const roots = await resolveRoots(rt);
-    const detected = await detectTargets(rt, [...TARGET_IDS], "both");
+    const detected = await detectTargets(rt, [...TARGET_IDS], "both", probe);
     const [targetRows, inventoryRows] = await Promise.all([
         Promise.all(detected.map(async (row) => {
             const health = await healthOf(row, rt, roots);

package/dist/src/capabilities/doctor/checks/targetHealth.js.map

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

package/dist/src/capabilities/graph/connect.render.js

@@ -0,0 +1,101 @@
+/**
+ * Formatters for `graph connect` — the same answer in two registers.
+ *
+ * A person gets one ROW PER STEP grouped by path, with each node's human name
+ * from the pack index, because what a reader wants from "how do these two
+ * connect" is the chain, read left to right, with the direction of every edge
+ * visible.
+ *
+ * An agent gets ONE OBJECT. Not Markdown: the answer is structured data — two
+ * endpoints, a verdict, the paths, and the policy the walk ran under — and
+ * flattening it into prose would make a caller parse back out what it already
+ * had (Constitution XI). This is also why neither format ever explains WHY two
+ * things relate: the predicates on the path are the explanation, and a sentence
+ * synthesised from them would be pragma asserting a meaning the graph does not
+ * carry.
+ *
+ * Terms arrive already compacted and named by the relation index, against the
+ * store's own merged prefix map — so these formatters carry no prefix map and
+ * re-derive nothing.
+ */
+/** The short form of a term: prefixed when there is one, else the raw value. */
+const short = (term) => term.prefixed ?? term.value;
+/** A term as a reader should see it — short form, with its name when known. */
+const named = (term) => term.title ? `${short(term)} (${term.title})` : short(term);
+/** A blank node has no address, and saying so beats printing a dead handle. */
+const node = (term) => term.addressable === false ? `[record ${term.value}]` : named(term);
+/** `1 hop` / `2 hops` — a count a reader does not have to forgive. */
+const count = (n, noun) => `${n} ${noun}${n === 1 ? "" : "s"}`;
+/** The sentence for each way of being unconnected — one per case, never shared. */
+const REFUSALS = {
+    "endpoint-carries-no-relation": "Not connectable: one endpoint carries no relation the model uses — it is only classified.",
+    "shares-only-rosters": "Not connected in the model. The two share membership, which is not a relation.",
+    "no-path-within-hop-limit": "Not connected: no relation path between them within the hop limit.",
+};
+/** One roster group, as a line a reader can act on. */
+function rosterLine(roster) {
+    const shape = roster.side === "subjects"
+        ? `${short(roster.predicate)} -> ${node(roster.node)}`
+        : `${node(roster.node)} -> ${short(roster.predicate)}`;
+    return `    ${shape}  (${roster.members} members)`;
+}
+/** One path, as a header plus one row per step. */
+function pathLines(path, ordinal) {
+    const lines = [`  Path ${ordinal} (${count(path.steps.length, "hop")})`];
+    for (const step of path.steps) {
+        const arrow = step.direction === "forward"
+            ? `--${short(step.predicate)}->`
+            : `<-${short(step.predicate)}--`;
+        lines.push(`    ${node(step.from)}  ${arrow}  ${node(step.to)}`);
+    }
+    return lines;
+}
+/** The policy block every answer carries, positive or negative. */
+function policyLines(data) {
+    return [
+        "",
+        `  Hop limit ${data.hopLimit}; edges whose fan-in exceeds ${data.rosterThreshold} are rosters, not relations.`,
+        `  Packs searched: ${data.packs.length > 0 ? data.packs.join(", ") : "none recorded"}`,
+    ];
+}
+export const connectFormatters = {
+    plain(data) {
+        const title = `${node(data.a.term)}  <->  ${node(data.b.term)}`;
+        const lines = [title, "=".repeat(Math.min(Math.max(title.length, 24), 96))];
+        if (data.connected) {
+            lines.push(`  Connected in ${count(data.hops ?? 0, "relation hop")}, by ${count(data.pathCount, "shortest path")}.`, "");
+            for (const [index, path] of data.paths.entries()) {
+                lines.push(...pathLines(path, index + 1));
+                lines.push("");
+            }
+            if (data.truncated) {
+                lines.push(`  Showing ${data.paths.length} of ${data.pathCount} shortest paths — raise --paths for the rest.`);
+            }
+        }
+        else {
+            lines.push(`  ${REFUSALS[data.unconnectedBecause ?? "no-path-within-hop-limit"]}`);
+            for (const endpoint of [data.a, data.b]) {
+                if (endpoint.relatable)
+                    continue;
+                lines.push("", `  ${node(endpoint.term)} carries no relation. It is classified by:`, ...(endpoint.classifiedBy ?? []).map(rosterLine));
+            }
+            if (data.sharedRosters.length > 0) {
+                lines.push("", "  Rosters they both belong to:");
+                lines.push(...data.sharedRosters.map(rosterLine));
+                lines.push("", "  A roster is answered by the noun's own list verb, not by a path.");
+            }
+        }
+        lines.push(...policyLines(data));
+        return lines.join("\n").trimEnd();
+    },
+    /**
+     * The agent-facing format IS the object — one JSON value on one line.
+     *
+     * `json` pretty-prints the same payload for a human reading a pipe; the two
+     * are the same data by construction, so an agent and a reader never see
+     * different answers to the same question.
+     */
+    llm: (data) => JSON.stringify(data),
+    json: (data) => JSON.stringify(data, null, 2),
+};
+//# sourceMappingURL=connect.render.js.map

package/dist/src/capabilities/graph/connect.render.js.map

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

package/dist/src/capabilities/graph/connect.types.js

@@ -0,0 +1,21 @@
+/**
+ * The shape of a `graph connect` answer — the ONE contract its run body writes
+ * and its three formatters read.
+ *
+ * Type-only, and deliberately its own module: the formatters hang off the verb
+ * spec, so they are on the static import graph the lazy-dispatch probe walks
+ * (`capabilities/lazy.test.ts`), while the walk itself must stay behind a
+ * dynamic import. A shared type module lets both sides name the same answer
+ * without dragging the traversal onto the storeless fast path.
+ *
+ * Every answer carries the POLICY it was produced under — the hop limit, the
+ * roster threshold, and the packs searched. That is Constitution VI applied to
+ * the answer rather than only to the source: the commonest answer this verb
+ * gives is "these two are not connected", and that sentence means nothing
+ * without knowing how far it looked, what it was willing to walk, and what it
+ * was looking in. A missing pack is what makes an honest "no path" and a
+ * dishonest one byte-identical, so `packs` is present whether the answer is
+ * positive or negative.
+ */
+export {};
+//# sourceMappingURL=connect.types.js.map

package/dist/src/capabilities/graph/connect.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.types.js","sourceRoot":"","sources":["../../../../src/capabilities/graph/connect.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}

package/dist/src/capabilities/graph/connect.verb.js

@@ -0,0 +1,147 @@
+/**
+ * `graph connect <a> <b>` — what connects two entities, and what "unlinked"
+ * means when nothing does.
+ *
+ * The third verb on the `graph` noun, beside `inspect` (one entity's
+ * neighbourhood) and `query` (the raw SPARQL escape hatch). It belongs here for
+ * the same reason those two do: it reads ACROSS the whole store rather than
+ * within one population, so it hangs off the noun for a store-wide read and
+ * adds no noun of its own.
+ *
+ * It is hand-written rather than a declared pack story because the pack grammar
+ * cannot express it. A list story's parameters are exactly its declared filters
+ * plus its declared search, every filter is projected as an OPTIONAL NAMED
+ * flag, and the only positional-and-required parameter the compiler ever mints
+ * is a lookup's single name — so there is nowhere in the grammar to put two
+ * required entity arguments. And a filter is a row predicate over an author's
+ * query, so a declared form would have to enumerate the walk space and let a
+ * filter pick one pair out of it: at four hops that space is 71 million walks,
+ * against the largest declared story's 1,698 rows.
+ *
+ * Both arguments accept exactly what `graph inspect` accepts — a prefixed name
+ * or an absolute IRI — and complete from the pack index through the same
+ * `names`/`index` source a compiled lookup's `<name>` uses, so the two
+ * positionals behave like every other entity argument in the CLI.
+ *
+ * Store-backed and read-only, like both its siblings. The traversal lives in a
+ * dynamically-imported run body: the relation index it needs is built by one
+ * scan of the store, and a process that never asks a connect question must
+ * never pay for it — which is the same guarantee `needsStore` and the lazy
+ * store already give every other read.
+ */
+import { BIN_NAME } from "../../constants.js";
+import { PragmaError } from "../../kernel/error/index.js";
+import { asVerb } from "../../kernel/spec/asVerb.js";
+import { connectFormatters } from "./connect.render.js";
+/**
+ * The hop limit in force unless `--hops` says otherwise.
+ *
+ * Four, from the measured connectivity ladder on the shipped pack: it is the
+ * smallest limit that spans the longest genuine bridge in this store — the walk
+ * from a platform variable through its declaration and its references to the
+ * symbol behind it — and the largest that keeps the answer set honest. At three
+ * that walk is refused; at six the connected fraction jumps and the paths stop
+ * being something a person can hold in mind.
+ */
+export const DEFAULT_HOPS = 4;
+/** The ceiling `--hops` may be raised to; above it the verb refuses. */
+export const MAX_HOPS = 6;
+/** How many shortest paths are shown unless `--paths` says otherwise. */
+export const DEFAULT_PATHS = 10;
+/**
+ * Hold a numeric param to a whole number within its stated range.
+ *
+ * REFUSES rather than clamps. A clamped `--hops 40` would answer a question
+ * nobody asked and report a limit the caller did not set, which is precisely
+ * the hidden policy every answer's policy block exists to rule out.
+ *
+ * The kernel already coerces a `number` param and rejects what is not a number
+ * at all (`project/cli/dispatch.ts#coerceParam`, and `z.number()` over MCP), so
+ * what is left to check is RANGE and wholeness — `--hops 2.5` is a number, and
+ * it is not a hop count.
+ *
+ * @param value - The coerced param value.
+ * @param name - The flag's name, for the diagnostic.
+ * @param fallback - The value when the flag was not given.
+ * @param min - The smallest accepted value.
+ * @param max - The largest accepted value, if there is one.
+ * @returns The validated integer.
+ * @throws PragmaError INVALID_INPUT when the value is not an integer in range.
+ */
+function bounded(value, name, fallback, min, max) {
+    if (value === undefined || value === null)
+        return fallback;
+    const parsed = typeof value === "number" ? value : Number(value);
+    const ceiling = max === undefined ? "" : ` and at most ${max}`;
+    if (!Number.isInteger(parsed) ||
+        parsed < min ||
+        (max !== undefined && parsed > max)) {
+        throw PragmaError.invalidInput(name, String(value), {
+            recovery: {
+                message: `--${name} must be a whole number of at least ${min}${ceiling}.`,
+            },
+        });
+    }
+    return parsed;
+}
+const connectVerb = {
+    path: ["graph", "connect"],
+    summary: "Show the shortest relation paths between two entities.",
+    doc: "Finds every shortest path of RELATION edges between two entities, and says which kind of nothing it found when there is no path. An edge counts as a relation only where it does not fan out into a roster — membership of a class, a tier or a family is answered by that noun's list verb, not by a path — so most pairs are correctly reported as unconnected. Address each endpoint by prefixed name (ds:global.component.button) or absolute IRI. Every answer states the hop limit, the fan-in threshold, and the packs searched.",
+    params: [
+        {
+            kind: "string",
+            name: "a",
+            doc: "The first endpoint — a prefixed name or absolute IRI.",
+            positional: true,
+            required: true,
+            complete: { kind: "names", source: { from: "index", type: "" } },
+        },
+        {
+            kind: "string",
+            name: "b",
+            doc: "The second endpoint — a prefixed name or absolute IRI.",
+            positional: true,
+            required: true,
+            complete: { kind: "names", source: { from: "index", type: "" } },
+        },
+        {
+            kind: "number",
+            name: "hops",
+            doc: `Largest path length to return (default ${DEFAULT_HOPS}, ceiling ${MAX_HOPS}).`,
+            default: DEFAULT_HOPS,
+        },
+        {
+            kind: "number",
+            name: "paths",
+            doc: `Most shortest paths to show (default ${DEFAULT_PATHS}); the answer always reports the true total.`,
+            default: DEFAULT_PATHS,
+        },
+    ],
+    output: { formatters: connectFormatters },
+    examples: [
+        {
+            cmd: `${BIN_NAME} graph connect ds:global.component.button dt:color.text`,
+            note: "a block and a token symbol",
+        },
+        {
+            cmd: `${BIN_NAME} graph connect ds:global.component.button ds:apps.pattern.datatable --format json`,
+            note: "an honest unlinked answer, with the policy it was found under",
+        },
+    ],
+    capability: {
+        needsStore: true,
+        mutates: false,
+        mcp: {
+            expose: true,
+            annotations: { readOnlyHint: true, openWorldHint: false },
+        },
+    },
+    run: (params, rt) => import("./runConnect.js").then((m) => m.runConnect(rt, String(params.a), String(params.b), {
+        hops: bounded(params.hops, "hops", DEFAULT_HOPS, 1, MAX_HOPS),
+        paths: bounded(params.paths, "paths", DEFAULT_PATHS, 1),
+    })),
+};
+/** The `graph connect` verb. */
+export const graphConnectVerb = asVerb(connectVerb);
+//# sourceMappingURL=connect.verb.js.map

package/dist/src/capabilities/graph/connect.verb.js.map

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

package/dist/src/capabilities/graph/index.js

@@ -1,8 +1,10 @@
 /**
- * The `graph` capability module — `inspect` (single-entity read) plus `query`
- * (the raw SPARQL escape hatch, PR6). The covenant blesses both.
+ * The `graph` capability module — `inspect` (single-entity read), `query` (the
+ * raw SPARQL escape hatch, PR6) and `connect` (relation paths between two
+ * entities). The covenant blesses all three.
  */
 import { resourceProvider } from "../resources/index.js";
+import { graphConnectVerb } from "./connect.verb.js";
 import { graphInspectVerb } from "./inspect.verb.js";
 import { graphQueryVerb } from "./query.verb.js";
 /**
@@ -13,7 +15,7 @@ import { graphQueryVerb } from "./query.verb.js";
  */
 export const graphModule = {
     name: "graph",
-    verbs: [graphInspectVerb, graphQueryVerb],
+    verbs: [graphConnectVerb, graphInspectVerb, graphQueryVerb],
     mcpResources: resourceProvider,
 };
 //# sourceMappingURL=index.js.map

package/dist/src/capabilities/graph/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/capabilities/graph/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAqB;IAC3C,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,CAAC,gBAAgB,EAAE,cAAc,CAAC;IACzC,YAAY,EAAE,gBAAgB;CAC/B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/capabilities/graph/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAqB;IAC3C,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,CAAC;IAC3D,YAAY,EAAE,gBAAgB;CAC/B,CAAC"}