@ironbee-ai/cli 0.12.0 → 0.13.0

package/dist/tui/command.d.ts

@@ -0,0 +1,18 @@
+/**
+ * IronBee — `ironbee tui` command
+ *
+ * Umbrella entry for the interactive full-screen TUI. Builds the shared screen
+ * + session, runs the shell (home menu over the area registry, or deep-linked
+ * straight into `[area]`), and on exit performs the one-shot artifact rerender
+ * if any area changed artifact-affecting config.
+ *
+ * blessed and the whole TUI stack are required lazily inside the action so a
+ * normal `ironbee <other-command>` invocation never loads them.
+ */
+import { Command } from "commander";
+export interface TuiOpts {
+    projectDir?: string;
+}
+export declare function runTui(area: string | undefined, opts: TuiOpts): Promise<void>;
+export declare const tuiCommand: Command;
+//# sourceMappingURL=command.d.ts.map

package/dist/tui/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/tui/command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,MAAM,WAAW,OAAO;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAkBD,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAsCnF;AAED,eAAO,MAAM,UAAU,EAAE,OAenB,CAAC"}

package/dist/tui/command.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * IronBee — `ironbee tui` command
+ *
+ * Umbrella entry for the interactive full-screen TUI. Builds the shared screen
+ * + session, runs the shell (home menu over the area registry, or deep-linked
+ * straight into `[area]`), and on exit performs the one-shot artifact rerender
+ * if any area changed artifact-affecting config.
+ *
+ * blessed and the whole TUI stack are required lazily inside the action so a
+ * normal `ironbee <other-command>` invocation never loads them.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tuiCommand = void 0;
+exports.runTui = runTui;
+const commander_1 = require("commander");
+const path_1 = require("path");
+const output_1 = require("../lib/output");
+const prompt_1 = require("../lib/prompt");
+function reportRerender(projectDir) {
+    const rerenderMod = require("./shell/rerender");
+    try {
+        const clients = rerenderMod.rerenderArtifacts(projectDir);
+        if (clients.length > 0) {
+            console.log(`${output_1.pc.green("✓")}  Re-rendered ${output_1.pc.bold(clients.join(", "))} artifacts in ${output_1.pc.dim(projectDir)}`);
+            console.log(`   ${output_1.pc.yellow("⚠")}  Restart your editor / agent session for the changes to take effect.`);
+        }
+        else {
+            console.log(`   ${output_1.pc.dim("· no clients detected in")} ${output_1.pc.dim(projectDir)} ${output_1.pc.dim("— skipped rerender")}`);
+        }
+    }
+    catch (e) {
+        console.error(`${output_1.pc.red("✗")}  Artifact rerender failed: ${e instanceof Error ? e.message : String(e)}`);
+        console.error(`   ${output_1.pc.dim("Run")} ${output_1.pc.cyan("ironbee install")} ${output_1.pc.dim("to resync artifacts with config.")}`);
+    }
+}
+async function runTui(area, opts) {
+    if (!(0, prompt_1.isInteractive)()) {
+        console.error(`${output_1.pc.red("✗")}  ${output_1.pc.bold("ironbee tui")} requires an interactive terminal (TTY).`);
+        console.error(`   ${output_1.pc.dim("In non-interactive contexts use")} ${output_1.pc.cyan("ironbee config get/set/list")} ${output_1.pc.dim("instead.")}`);
+        process.exitCode = 1;
+        return;
+    }
+    const projectDir = (0, path_1.resolve)(opts.projectDir ?? process.cwd());
+    // Lazy require — keeps blessed + the TUI stack out of every non-TUI command.
+    const registry = require("./shell/registry");
+    if (area !== undefined && registry.findArea(area) === undefined) {
+        const ids = registry.AREAS.map((a) => a.id).join(", ");
+        console.error(`${output_1.pc.red("✗")}  Unknown TUI area ${output_1.pc.bold(area)}. Known areas: ${output_1.pc.cyan(ids)}.`);
+        process.exitCode = 1;
+        return;
+    }
+    const blessedMod = require("blessed");
+    const sessionMod = require("./shell/session");
+    const shellMod = require("./shell/shell");
+    const screen = blessedMod.screen({
+        smartCSR: true,
+        title: "IronBee TUI",
+        fullUnicode: true,
+    });
+    const session = new sessionMod.TuiSession(screen, projectDir);
+    await shellMod.runShell(session, area);
+    // The shell already tore down the screen; safe to print now. Re-render every
+    // project whose artifact-affecting config changed (the active project is
+    // switchable, so this can be more than one). Operational commands (install /
+    // uninstall / drain / import) run in the foreground inside the TUI, so
+    // there's nothing else to flush here.
+    for (const dir of session.rerenderProjects()) {
+        reportRerender(dir);
+    }
+}
+exports.tuiCommand = new commander_1.Command("tui")
+    .description("Interactive full-screen TUI. Home menu of areas (Configuration, Platforms, …); "
+    + "open one directly with `ironbee tui <area>`. The config area reads each key's description, "
+    + "shows global / project / local + merged values side by side, and edits/unsets any layer in place.")
+    .argument("[area]", "Open a specific area directly (e.g. `config`). Omit for the home menu.")
+    .option("-p, --project-dir <dir>", "Project directory (default: cwd).")
+    .action(async (area, opts) => {
+    try {
+        await runTui(area, opts);
+    }
+    catch (e) {
+        console.error(`${output_1.pc.red("✗")}  ${e instanceof Error ? e.message : String(e)}`);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=command.js.map

package/dist/tui/command.js.map

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

package/dist/tui/config/area.d.ts

@@ -0,0 +1,6 @@
+/**
+ * IronBee — Config area: the TuiArea wrapper around the config browser view.
+ */
+import { TuiArea } from "../shell/area";
+export declare const configArea: TuiArea;
+//# sourceMappingURL=area.d.ts.map

package/dist/tui/config/area.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"area.d.ts","sourceRoot":"","sources":["../../../src/tui/config/area.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAA2B,OAAO,EAAE,MAAM,eAAe,CAAC;AAGjE,eAAO,MAAM,UAAU,EAAE,OAOxB,CAAC"}

package/dist/tui/config/area.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * IronBee — Config area: the TuiArea wrapper around the config browser view.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configArea = void 0;
+const view_1 = require("./view");
+exports.configArea = {
+    id: "config",
+    title: "Configuration",
+    summary: "Browse & edit config keys across global / project / local layers",
+    mount(ctx) {
+        return (0, view_1.mountConfigView)(ctx);
+    },
+};
+//# sourceMappingURL=area.js.map

package/dist/tui/config/area.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"area.js","sourceRoot":"","sources":["../../../src/tui/config/area.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAGH,iCAAyC;AAE5B,QAAA,UAAU,GAAY;IAC/B,EAAE,EAAE,QAAQ;IACZ,KAAK,EAAE,eAAe;IACtB,OAAO,EAAE,kEAAkE;IAC3E,KAAK,CAAC,GAAgB;QAClB,OAAO,IAAA,sBAAe,EAAC,GAAG,CAAC,CAAC;IAChC,CAAC;CACJ,CAAC"}

package/dist/tui/config/docs.d.ts

@@ -0,0 +1,28 @@
+/**
+ * IronBee — Config TUI: docs generator (canonical source → docs table)
+ *
+ * `CONFIG_SCHEMA` is the single source of truth for config-key metadata. The
+ * key-reference table in `docs/claude-md/configuration.md` is GENERATED from it
+ * by `renderConfigDocsTable`, spliced between the marker comments below by
+ * `replaceConfigTable`. `scripts/generate-config-docs.js` regenerates the file;
+ * `tests/unit/tui/config-docs.test.ts` fails when the committed table drifts
+ * from the schema.
+ *
+ * Pure module — no fs / side effects. The script and test own the file I/O.
+ */
+/** Marker that opens the generated table region in configuration.md. */
+export declare const CONFIG_TABLE_START: string;
+/** Marker that closes the generated table region. */
+export declare const CONFIG_TABLE_END: string;
+/**
+ * Render the full config-key reference as grouped markdown tables, ordered by
+ * `orderedEntries()`. One `### <group>` heading + table per group.
+ */
+export declare function renderConfigDocsTable(): string;
+/**
+ * Replace the table between the markers in `markdown` with a freshly-rendered
+ * one. Throws when the markers are missing or out of order. Idempotent — the
+ * region between the markers is fully replaced each call.
+ */
+export declare function replaceConfigTable(markdown: string): string;
+//# sourceMappingURL=docs.d.ts.map

package/dist/tui/config/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/tui/config/docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,EAAE,MACoH,CAAC;AAEtJ,qDAAqD;AACrD,eAAO,MAAM,gBAAgB,EAAE,MAA4C,CAAC;AAO5E;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAoB9C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAY3D"}

package/dist/tui/config/docs.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * IronBee — Config TUI: docs generator (canonical source → docs table)
+ *
+ * `CONFIG_SCHEMA` is the single source of truth for config-key metadata. The
+ * key-reference table in `docs/claude-md/configuration.md` is GENERATED from it
+ * by `renderConfigDocsTable`, spliced between the marker comments below by
+ * `replaceConfigTable`. `scripts/generate-config-docs.js` regenerates the file;
+ * `tests/unit/tui/config-docs.test.ts` fails when the committed table drifts
+ * from the schema.
+ *
+ * Pure module — no fs / side effects. The script and test own the file I/O.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_TABLE_END = exports.CONFIG_TABLE_START = void 0;
+exports.renderConfigDocsTable = renderConfigDocsTable;
+exports.replaceConfigTable = replaceConfigTable;
+const schema_1 = require("./schema");
+/** Marker that opens the generated table region in configuration.md. */
+exports.CONFIG_TABLE_START = "<!-- IRONBEE:CONFIG-TABLE:START (generated from src/tui/config/schema.ts — run `node scripts/generate-config-docs.js`; do not edit by hand) -->";
+/** Marker that closes the generated table region. */
+exports.CONFIG_TABLE_END = "<!-- IRONBEE:CONFIG-TABLE:END -->";
+/** Escape a value for safe placement inside a markdown table cell. */
+function cell(s) {
+    return s.replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
+}
+/**
+ * Render the full config-key reference as grouped markdown tables, ordered by
+ * `orderedEntries()`. One `### <group>` heading + table per group.
+ */
+function renderConfigDocsTable() {
+    const entries = (0, schema_1.orderedEntries)();
+    const out = [];
+    let lastGroup = "";
+    for (const e of entries) {
+        const group = (0, schema_1.groupOf)(e.path);
+        if (group !== lastGroup) {
+            if (lastGroup !== "") {
+                out.push("");
+            }
+            out.push(`### ${(0, schema_1.groupTitle)(group)}`);
+            out.push("");
+            out.push("| Key | Type | Default | Artifacts | Description |");
+            out.push("| --- | --- | --- | --- | --- |");
+            lastGroup = group;
+        }
+        const artifacts = e.artifactAffecting ? "rerender" : "—";
+        out.push(`| \`${e.path}\` | \`${e.type}\` | ${cell(e.def)} | ${artifacts} | ${cell(e.description)} |`);
+    }
+    return out.join("\n");
+}
+/**
+ * Replace the table between the markers in `markdown` with a freshly-rendered
+ * one. Throws when the markers are missing or out of order. Idempotent — the
+ * region between the markers is fully replaced each call.
+ */
+function replaceConfigTable(markdown) {
+    const startIdx = markdown.indexOf(exports.CONFIG_TABLE_START);
+    const endIdx = markdown.indexOf(exports.CONFIG_TABLE_END);
+    if (startIdx === -1 || endIdx === -1 || endIdx < startIdx) {
+        throw new Error("Config table markers not found (or out of order) in configuration.md. "
+            + `Expected ${exports.CONFIG_TABLE_START} … ${exports.CONFIG_TABLE_END}.`);
+    }
+    const head = markdown.slice(0, startIdx + exports.CONFIG_TABLE_START.length);
+    const tail = markdown.slice(endIdx);
+    return `${head}\n\n${renderConfigDocsTable()}\n\n${tail}`;
+}
+//# sourceMappingURL=docs.js.map

package/dist/tui/config/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../src/tui/config/docs.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAoBH,sDAoBC;AAOD,gDAYC;AAzDD,qCAAkF;AAElF,wEAAwE;AAC3D,QAAA,kBAAkB,GAC3B,iJAAiJ,CAAC;AAEtJ,qDAAqD;AACxC,QAAA,gBAAgB,GAAW,mCAAmC,CAAC;AAE5E,sEAAsE;AACtE,SAAS,IAAI,CAAC,CAAS;IACnB,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,SAAgB,qBAAqB;IACjC,MAAM,OAAO,GAAwB,IAAA,uBAAc,GAAE,CAAC;IACtD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,SAAS,GAAW,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACtB,MAAM,KAAK,GAAW,IAAA,gBAAO,EAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,IAAI,SAAS,KAAK,EAAE,EAAE,CAAC;gBACnB,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,OAAO,IAAA,mBAAU,EAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACrC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACb,GAAG,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;YAC/D,GAAG,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;YAC5C,SAAS,GAAG,KAAK,CAAC;QACtB,CAAC;QACD,MAAM,SAAS,GAAW,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC;QACjE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,IAAI,QAAQ,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,SAAS,MAAM,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC3G,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,QAAgB;IAC/C,MAAM,QAAQ,GAAW,QAAQ,CAAC,OAAO,CAAC,0BAAkB,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAW,QAAQ,CAAC,OAAO,CAAC,wBAAgB,CAAC,CAAC;IAC1D,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,IAAI,MAAM,GAAG,QAAQ,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CACX,wEAAwE;cACtE,YAAY,0BAAkB,MAAM,wBAAgB,GAAG,CAC5D,CAAC;IACN,CAAC;IACD,MAAM,IAAI,GAAW,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,GAAG,0BAAkB,CAAC,MAAM,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAW,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5C,OAAO,GAAG,IAAI,OAAO,qBAAqB,EAAE,OAAO,IAAI,EAAE,CAAC;AAC9D,CAAC"}

package/dist/tui/config/edit.d.ts

@@ -0,0 +1,36 @@
+/**
+ * IronBee — Config TUI: write core
+ *
+ * Layer-scoped set / unset that write the targeted config file ONLY (no
+ * console output, no prompts, no artifact rerender). The shell batches all
+ * edits and re-renders client artifacts once on exit (see
+ * `shell/rerender.ts`) — never mid-session, so the full-screen UI is never
+ * corrupted by `client.install` stdout.
+ *
+ * Depends only on the public `lib/` surface, never on the `commands/config.ts`
+ * command layer.
+ */
+/** Whether changing this key requires re-rendering installed client artifacts. */
+export declare function affectsArtifacts(key: string): boolean;
+/** Result of a layer set. */
+export interface LayerSetResult {
+    /** The coerced value that was written. */
+    value: unknown;
+    /** Whether this key triggers an artifact rerender on exit. */
+    artifactAffecting: boolean;
+}
+/**
+ * Set `key` to `rawValue` in the given layer file. `json` forces strict JSON
+ * parsing (otherwise heuristic: JSON-or-raw-string). Writes the file in place.
+ */
+export declare function setLayerValue(layerPath: string, key: string, rawValue: string, json: boolean): LayerSetResult;
+/** Result of a layer unset. */
+export interface LayerUnsetResult {
+    /** `true` when the key was present and removed; `false` when it was absent. */
+    removed: boolean;
+    /** Whether this key triggers an artifact rerender on exit. */
+    artifactAffecting: boolean;
+}
+/** Remove `key` from the given layer file. Idempotent — no-op when absent. */
+export declare function unsetLayerValue(layerPath: string, key: string): LayerUnsetResult;
+//# sourceMappingURL=edit.d.ts.map

package/dist/tui/config/edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../../src/tui/config/edit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD;AA2BD,6BAA6B;AAC7B,MAAM,WAAW,cAAc;IAC3B,0CAA0C;IAC1C,KAAK,EAAE,OAAO,CAAC;IACf,8DAA8D;IAC9D,iBAAiB,EAAE,OAAO,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,cAAc,CAM7G;AAED,+BAA+B;AAC/B,MAAM,WAAW,gBAAgB;IAC7B,+EAA+E;IAC/E,OAAO,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,iBAAiB,EAAE,OAAO,CAAC;CAC9B;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAOhF"}

package/dist/tui/config/edit.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * IronBee — Config TUI: write core
+ *
+ * Layer-scoped set / unset that write the targeted config file ONLY (no
+ * console output, no prompts, no artifact rerender). The shell batches all
+ * edits and re-renders client artifacts once on exit (see
+ * `shell/rerender.ts`) — never mid-session, so the full-screen UI is never
+ * corrupted by `client.install` stdout.
+ *
+ * Depends only on the public `lib/` surface, never on the `commands/config.ts`
+ * command layer.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.affectsArtifacts = affectsArtifacts;
+exports.setLayerValue = setLayerValue;
+exports.unsetLayerValue = unsetLayerValue;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const schema_1 = require("./schema");
+const value_1 = require("./value");
+/** Whether changing this key requires re-rendering installed client artifacts. */
+function affectsArtifacts(key) {
+    return schema_1.ARTIFACT_AFFECTING_TOP_KEYS.has((0, schema_1.topKey)(key));
+}
+/**
+ * Read a config layer file as a plain object. Missing / empty → `{}`. Throws
+ * on malformed JSON or a non-object top-level so the TUI surfaces the problem
+ * instead of silently clobbering a hand-edited-but-broken file.
+ */
+function readRawConfig(filePath) {
+    if (!(0, fs_1.existsSync)(filePath)) {
+        return {};
+    }
+    const raw = (0, fs_1.readFileSync)(filePath, "utf-8");
+    if (raw.trim().length === 0) {
+        return {};
+    }
+    const parsed = JSON.parse(raw);
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error(`Config at ${filePath} is not a JSON object.`);
+    }
+    return parsed;
+}
+function writeRawConfig(filePath, config) {
+    (0, fs_1.mkdirSync)((0, path_1.dirname)(filePath), { recursive: true });
+    (0, fs_1.writeFileSync)(filePath, JSON.stringify(config, null, 2) + "\n");
+}
+/**
+ * Set `key` to `rawValue` in the given layer file. `json` forces strict JSON
+ * parsing (otherwise heuristic: JSON-or-raw-string). Writes the file in place.
+ */
+function setLayerValue(layerPath, key, rawValue, json) {
+    const value = (0, value_1.parseValue)(rawValue, json);
+    const config = readRawConfig(layerPath);
+    (0, value_1.setAtPath)(config, key, value);
+    writeRawConfig(layerPath, config);
+    return { value, artifactAffecting: affectsArtifacts(key) };
+}
+/** Remove `key` from the given layer file. Idempotent — no-op when absent. */
+function unsetLayerValue(layerPath, key) {
+    const config = readRawConfig(layerPath);
+    const removed = (0, value_1.unsetAtPath)(config, key);
+    if (removed) {
+        writeRawConfig(layerPath, config);
+    }
+    return { removed, artifactAffecting: affectsArtifacts(key) };
+}
+//# sourceMappingURL=edit.js.map

package/dist/tui/config/edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.js","sourceRoot":"","sources":["../../../src/tui/config/edit.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;AAQH,4CAEC;AAuCD,sCAMC;AAWD,0CAOC;AAvED,2BAAwE;AACxE,+BAA+B;AAC/B,qCAA+D;AAC/D,mCAA6D;AAE7D,kFAAkF;AAClF,SAAgB,gBAAgB,CAAC,GAAW;IACxC,OAAO,oCAA2B,CAAC,GAAG,CAAC,IAAA,eAAM,EAAC,GAAG,CAAC,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,QAAgB;IACnC,IAAI,CAAC,IAAA,eAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAW,IAAA,iBAAY,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpD,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,wBAAwB,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,MAAiC,CAAC;AAC7C,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB,EAAE,MAA+B;IACrE,IAAA,cAAS,EAAC,IAAA,cAAO,EAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,IAAA,kBAAa,EAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACpE,CAAC;AAUD;;;GAGG;AACH,SAAgB,aAAa,CAAC,SAAiB,EAAE,GAAW,EAAE,QAAgB,EAAE,IAAa;IACzF,MAAM,KAAK,GAAY,IAAA,kBAAU,EAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAClD,MAAM,MAAM,GAA4B,aAAa,CAAC,SAAS,CAAC,CAAC;IACjE,IAAA,iBAAS,EAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9B,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAClC,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;AAC/D,CAAC;AAUD,8EAA8E;AAC9E,SAAgB,eAAe,CAAC,SAAiB,EAAE,GAAW;IAC1D,MAAM,MAAM,GAA4B,aAAa,CAAC,SAAS,CAAC,CAAC;IACjE,MAAM,OAAO,GAAY,IAAA,mBAAW,EAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClD,IAAI,OAAO,EAAE,CAAC;QACV,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;AACjE,CAAC"}

package/dist/tui/config/introspect.d.ts

@@ -0,0 +1,58 @@
+/**
+ * IronBee — Config TUI: layer introspection
+ *
+ * For a given dotted key, resolves what each of the three config layers
+ * (global / project / local) holds, what the merged effective value is, which
+ * layer that effective value comes from, and whether a live env-var override
+ * shadows the file layers. This is the read model the detail pane renders.
+ *
+ * Reads only the already-public lib surface (`loadConfig`, `getConfigLayerPaths`,
+ * `findActiveEnvOverride`) so the TUI stays decoupled from the command layer.
+ */
+import { IronBeeConfig } from "../../lib/config";
+/** Which source supplies the merged effective value for a key. */
+export type EffectiveSource = "global" | "project" | "local" | "env" | "none";
+/** A layer's recorded name. */
+export type LayerName = "global" | "project" | "local";
+/** One layer's raw on-disk value for a key. */
+export interface LayerValue {
+    layer: LayerName;
+    /** Whether the key is an own-property at this layer (vs. absent). */
+    present: boolean;
+    /** The raw value at this layer (`undefined` when absent). */
+    value: unknown;
+    /** On-disk path of this layer's file (`undefined` for project/local with no projectDir). */
+    filePath: string | undefined;
+}
+/** A live env-var override shadowing the file layers for a key. */
+export interface EnvOverrideValue {
+    envVar: string;
+    value: unknown;
+}
+/** The fully-resolved read model for one key. */
+export interface KeyIntrospection {
+    path: string;
+    /** global, project, local — always in that order. */
+    layers: LayerValue[];
+    /** Set when an env var currently overrides this key. */
+    envOverride: EnvOverrideValue | undefined;
+    /** Merged effective value (file layers + env), or `undefined` when unset everywhere. */
+    merged: unknown;
+    /** Which source the merged value comes from. */
+    effective: EffectiveSource;
+}
+/** Parsed layers + on-disk paths + merged config, read once and reused. */
+export interface LoadedLayers {
+    globalPath: string;
+    projectPath: string | undefined;
+    localPath: string | undefined;
+    global: Record<string, unknown>;
+    project: Record<string, unknown>;
+    local: Record<string, unknown>;
+    merged: IronBeeConfig;
+}
+/** Reads all three layer files + the merged config in one pass. */
+export declare function loadLayers(projectDir?: string): LoadedLayers;
+/** Builds the read model for one key from already-loaded layers. */
+export declare function introspectKey(path: string, layers: LoadedLayers): KeyIntrospection;
+//# sourceMappingURL=introspect.d.ts.map

package/dist/tui/config/introspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.d.ts","sourceRoot":"","sources":["../../../src/tui/config/introspect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAIH,aAAa,EAEhB,MAAM,kBAAkB,CAAC;AAG1B,kEAAkE;AAClE,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAE9E,+BAA+B;AAC/B,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAEvD,+CAA+C;AAC/C,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,SAAS,CAAC;IACjB,qEAAqE;IACrE,OAAO,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,KAAK,EAAE,OAAO,CAAC;IACf,4FAA4F;IAC5F,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAClB;AAED,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,wDAAwD;IACxD,WAAW,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAC1C,wFAAwF;IACxF,MAAM,EAAE,OAAO,CAAC;IAChB,gDAAgD;IAChD,SAAS,EAAE,eAAe,CAAC;CAC9B;AAED,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,EAAE,aAAa,CAAC;CACzB;AAqBD,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY,CAY5D;AAYD,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,gBAAgB,CA8BlF"}

package/dist/tui/config/introspect.js

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ * IronBee — Config TUI: layer introspection
+ *
+ * For a given dotted key, resolves what each of the three config layers
+ * (global / project / local) holds, what the merged effective value is, which
+ * layer that effective value comes from, and whether a live env-var override
+ * shadows the file layers. This is the read model the detail pane renders.
+ *
+ * Reads only the already-public lib surface (`loadConfig`, `getConfigLayerPaths`,
+ * `findActiveEnvOverride`) so the TUI stays decoupled from the command layer.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadLayers = loadLayers;
+exports.introspectKey = introspectKey;
+const fs_1 = require("fs");
+const config_1 = require("../../lib/config");
+const value_1 = require("./value");
+function readLayerFile(filePath) {
+    if (filePath === undefined || !(0, fs_1.existsSync)(filePath)) {
+        return {};
+    }
+    try {
+        const raw = (0, fs_1.readFileSync)(filePath, "utf-8");
+        if (raw.trim().length === 0) {
+            return {};
+        }
+        const parsed = JSON.parse(raw);
+        if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+            return {};
+        }
+        return parsed;
+    }
+    catch {
+        return {};
+    }
+}
+/** Reads all three layer files + the merged config in one pass. */
+function loadLayers(projectDir) {
+    const paths = (0, config_1.getConfigLayerPaths)(projectDir);
+    return {
+        globalPath: paths.global,
+        projectPath: paths.project,
+        localPath: paths.local,
+        global: readLayerFile(paths.global),
+        project: readLayerFile(paths.project),
+        local: readLayerFile(paths.local),
+        merged: (0, config_1.loadConfig)(projectDir),
+    };
+}
+function resolveEnvOverride(path) {
+    const override = (0, config_1.findActiveEnvOverride)(path);
+    if (override === undefined) {
+        return undefined;
+    }
+    const raw = process.env[override.envVar] ?? "";
+    const value = override.coerce ? override.coerce(raw) : raw;
+    return { envVar: override.envVar, value };
+}
+/** Builds the read model for one key from already-loaded layers. */
+function introspectKey(path, layers) {
+    const layerValues = [
+        { layer: "global", present: (0, value_1.hasAtPath)(layers.global, path), value: (0, value_1.getAtPath)(layers.global, path), filePath: layers.globalPath },
+        { layer: "project", present: (0, value_1.hasAtPath)(layers.project, path), value: (0, value_1.getAtPath)(layers.project, path), filePath: layers.projectPath },
+        { layer: "local", present: (0, value_1.hasAtPath)(layers.local, path), value: (0, value_1.getAtPath)(layers.local, path), filePath: layers.localPath },
+    ];
+    const envOverride = resolveEnvOverride(path);
+    const merged = (0, value_1.getAtPath)(layers.merged, path);
+    let effective;
+    if (envOverride !== undefined) {
+        effective = "env";
+    }
+    else {
+        // High → low precedence: local > project > global.
+        const local = layerValues[2];
+        const project = layerValues[1];
+        const global = layerValues[0];
+        if (local.present) {
+            effective = "local";
+        }
+        else if (project.present) {
+            effective = "project";
+        }
+        else if (global.present) {
+            effective = "global";
+        }
+        else {
+            effective = "none";
+        }
+    }
+    return { path, layers: layerValues, envOverride, merged, effective };
+}
+//# sourceMappingURL=introspect.js.map

package/dist/tui/config/introspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.js","sourceRoot":"","sources":["../../../src/tui/config/introspect.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AA+EH,gCAYC;AAaD,sCA8BC;AApID,2BAA8C;AAC9C,6CAM0B;AAC1B,mCAA+C;AAiD/C,SAAS,aAAa,CAAC,QAA4B;IAC/C,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,IAAA,eAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;QAClD,OAAO,EAAE,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACD,MAAM,GAAG,GAAW,IAAA,iBAAY,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACpD,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAC;QACd,CAAC;QACD,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACzE,OAAO,EAAE,CAAC;QACd,CAAC;QACD,OAAO,MAAiC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC;AAED,mEAAmE;AACnE,SAAgB,UAAU,CAAC,UAAmB;IAC1C,MAAM,KAAK,GACP,IAAA,4BAAmB,EAAC,UAAU,CAAC,CAAC;IACpC,OAAO;QACH,UAAU,EAAE,KAAK,CAAC,MAAM;QACxB,WAAW,EAAE,KAAK,CAAC,OAAO;QAC1B,SAAS,EAAE,KAAK,CAAC,KAAK;QACtB,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC;QACnC,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC;QACrC,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC;QACjC,MAAM,EAAE,IAAA,mBAAU,EAAC,UAAU,CAAC;KACjC,CAAC;AACN,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY;IACpC,MAAM,QAAQ,GAA4B,IAAA,8BAAqB,EAAC,IAAI,CAAC,CAAC;IACtE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,MAAM,GAAG,GAAW,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACvD,MAAM,KAAK,GAAY,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACpE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;AAC9C,CAAC;AAED,oEAAoE;AACpE,SAAgB,aAAa,CAAC,IAAY,EAAE,MAAoB;IAC5D,MAAM,WAAW,GAAiB;QAC9B,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAA,iBAAS,EAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,IAAA,iBAAS,EAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,UAAU,EAAE;QAChI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAA,iBAAS,EAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,IAAA,iBAAS,EAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE;QACpI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAA,iBAAS,EAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,IAAA,iBAAS,EAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE;KAC/H,CAAC;IAEF,MAAM,WAAW,GAAiC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAY,IAAA,iBAAS,EAAC,MAAM,CAAC,MAAiC,EAAE,IAAI,CAAC,CAAC;IAElF,IAAI,SAA0B,CAAC;IAC/B,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC5B,SAAS,GAAG,KAAK,CAAC;IACtB,CAAC;SAAM,CAAC;QACJ,mDAAmD;QACnD,MAAM,KAAK,GAAe,WAAW,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,OAAO,GAAe,WAAW,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAe,WAAW,CAAC,CAAC,CAAC,CAAC;QAC1C,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAChB,SAAS,GAAG,OAAO,CAAC;QACxB,CAAC;aAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACzB,SAAS,GAAG,SAAS,CAAC;QAC1B,CAAC;aAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACxB,SAAS,GAAG,QAAQ,CAAC;QACzB,CAAC;aAAM,CAAC;YACJ,SAAS,GAAG,MAAM,CAAC;QACvB,CAAC;IACL,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AACzE,CAAC"}

package/dist/tui/config/schema.d.ts

@@ -0,0 +1,81 @@
+/**
+ * IronBee — Config TUI: canonical config-key schema
+ *
+ * Single source of truth for every config key the TUI knows about. Each
+ * entry carries the metadata the TUI needs to render and edit a key:
+ *   - `path`              — dotted key (e.g. `collector.url`). The list/docs
+ *                           group is DERIVED from its first segment ({@link groupOf}).
+ *   - `type`              — value shape (drives validation hints)
+ *   - `editor`            — which edit affordance the TUI offers
+ *   - `description`       — concise one-paragraph explanation (shown in detail)
+ *   - `def`              — human-readable default (display only)
+ *   - `enumValues?`       — allowed values for `enum` editor
+ *   - `artifactAffecting` — whether changing it requires re-rendering installed
+ *                           client artifacts (hooks / MCP / skill-rule md /
+ *                           permissions). Mirrors `ARTIFACT_AFFECTING_TOP_KEYS`
+ *                           in `src/commands/config.ts` — kept here so the TUI
+ *                           stays self-contained (no import from the command
+ *                           layer). A consistency test asserts the two agree.
+ *
+ * This module has ZERO runtime dependencies on the rest of the codebase so it
+ * can be unit-tested in isolation and imported from anywhere.
+ */
+/** Coarse value shape for a config key. */
+export type ConfigValueType = "boolean" | "number" | "string" | "string-array" | "json";
+/** Which edit affordance the TUI offers for a key. */
+export type ConfigEditorKind = "toggle" | "number" | "text" | "enum" | "string-list" | "json";
+/** One config key's metadata. */
+export interface ConfigSchemaEntry {
+    path: string;
+    type: ConfigValueType;
+    editor: ConfigEditorKind;
+    description: string;
+    def: string;
+    enumValues?: string[];
+    artifactAffecting: boolean;
+}
+/**
+ * Top-level keys whose change requires re-rendering installed client
+ * artifacts. Mirrors `ARTIFACT_AFFECTING_TOP_KEYS` in `src/commands/config.ts`.
+ * Duplicated (not imported) to keep this module decoupled from the command
+ * layer; `tests/unit/tui/config-schema.test.ts` asserts every schema entry's
+ * `artifactAffecting` flag matches membership here.
+ */
+export declare const ARTIFACT_AFFECTING_TOP_KEYS: ReadonlySet<string>;
+/**
+ * Display order of groups in the list pane. Group MEMBERSHIP is derived from
+ * each key's first dot-segment ({@link groupOf}) — this list only controls the
+ * ORDER they appear in (and which trailing groups are "known"). Unknown groups
+ * (a future top segment not listed here) sort after these, alphabetically.
+ */
+export declare const GROUP_ORDER: readonly string[];
+/** Human-readable section headings, keyed by group (= first path segment). */
+export declare const GROUP_TITLES: Record<string, string>;
+/** Top-level segment of a dotted path. */
+export declare function topKey(dotPath: string): string;
+/**
+ * The group a key belongs to — its first dot-segment, or `"general"` for
+ * top-level (dot-less) keys like `maxRetries` / `ignoredVerifyPatterns`. This
+ * is the single, data-driven grouping used by the TUI list and the docs table;
+ * there is no hand-maintained group field to drift.
+ */
+export declare function groupOf(path: string): string;
+/** Display title for a group, falling back to the raw group name. */
+export declare function groupTitle(group: string): string;
+/** Sort rank for a group per {@link GROUP_ORDER}; unknown groups sort last. */
+export declare function groupRank(group: string): number;
+/**
+ * The canonical config-key registry. Adding a config key to IronBee should be
+ * accompanied by an entry here — the schema test fails loudly otherwise, which
+ * is the canonical-source guarantee.
+ */
+export declare const CONFIG_SCHEMA: ConfigSchemaEntry[];
+/** Returns the schema entry for a dotted path, or undefined when unknown. */
+export declare function findSchemaEntry(path: string): ConfigSchemaEntry | undefined;
+/**
+ * Returns all schema entries sorted by group display order (per {@link groupRank},
+ * group derived via {@link groupOf}) then path. This is the canonical ordering
+ * the TUI list pane and the docs table render.
+ */
+export declare function orderedEntries(): ConfigSchemaEntry[];
+//# sourceMappingURL=schema.d.ts.map

package/dist/tui/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/tui/config/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,cAAc,GAAG,MAAM,CAAC;AAExF,sDAAsD;AACtD,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC;AAE9F,iCAAiC;AACjC,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,EAAE,WAAW,CAAC,MAAM,CAW1D,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE,SAAS,MAAM,EAiB/B,CAAC;AAEX,8EAA8E;AAC9E,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAiB/C,CAAC;AAEF,0CAA0C;AAC1C,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG5C;AAED,qEAAqE;AACrE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,iBAAiB,EAoZ5C,CAAC;AAEF,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAE3E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,iBAAiB,EAAE,CASpD"}