@pristine-ts/cli 2.0.6 → 2.0.16

package/dist/lib/cjs/event-handlers/repl-start.event-handler.js

@@ -0,0 +1,280 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var ReplStartEventHandler_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReplStartEventHandler = void 0;
+const readline = __importStar(require("node:readline"));
+const tsyringe_1 = require("tsyringe");
+const core_1 = require("@pristine-ts/core");
+const common_1 = require("@pristine-ts/common");
+const observability_1 = require("@pristine-ts/observability");
+const cli_output_manager_1 = require("../managers/cli-output.manager");
+const cli_module_keyname_1 = require("../cli.module.keyname");
+const start_repl_event_payload_1 = require("../event-payloads/start-repl.event-payload");
+const start_repl_event_response_type_1 = require("../types/start-repl-event-response.type");
+/**
+ * The interactive `pristine` console, modelled as a long-running event handler. Launched
+ * when the bin is invoked with no command (or `pristine repl`) — `ReplStartEventMapper`
+ * produces a `StartReplEventPayload` and this handler runs the readline loop for the rest
+ * of the process lifetime.
+ *
+ * **Why an event handler.** The REPL is the same shape as `pristine start` (or any
+ * long-running command): an EventHandler whose `handle()` doesn't return until the
+ * session ends. This gives the CLI bootstrap a uniform shape — `cli.ts` just calls
+ * `kernel.handle(argv, {keyname: Cli})` regardless of whether the user invoked a one-shot
+ * command or wants the interactive console. There is no driver/handler asymmetry left in
+ * the bootstrap; the mapping layer routes argv to the right payload.
+ *
+ * **Per-line dispatch.** Each typed line is re-entered through `kernel.handle(...,
+ * {keyname: Cli})` — using `Kernel` (the proper re-entry seam — it owns trace lifecycle,
+ * child container creation, the works). The `Kernel` is `registerInstance`-d into its
+ * own container by `Cli.bootstrap()`, so this handler injects it via DI like any other
+ * service.
+ *
+ * Plus the session verbs `/help`, `/clear`, `/exit` handled in-process (they're not
+ * commands — they don't re-enter the kernel). Tab-completion is driven by the live
+ * command registry and by recent trace ids for `/trace` / `/logs`.
+ */
+let ReplStartEventHandler = ReplStartEventHandler_1 = class ReplStartEventHandler {
+    constructor(kernel, container, cliOutput, traceStore) {
+        this.kernel = kernel;
+        this.container = container;
+        this.cliOutput = cliOutput;
+        this.traceStore = traceStore;
+        this.commands = [];
+    }
+    supports(event) {
+        return event.payload instanceof start_repl_event_payload_1.StartReplEventPayload;
+    }
+    /**
+     * Runs the read-eval-print loop until `/exit` or EOF (Ctrl-D). Resolves with the exit
+     * code wrapped in a `StartReplEventResponse`; the mapper surfaces that to `Cli.bootstrap`.
+     */
+    handle(event) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.commands = this.resolveCommands();
+            this.printBanner();
+            const rl = readline.createInterface({
+                input: process.stdin,
+                output: process.stdout,
+                prompt: ReplStartEventHandler_1.PROMPT,
+                completer: (line) => this.complete(line),
+            });
+            const exitCode = yield new Promise((resolve) => {
+                rl.prompt();
+                rl.on("line", (line) => {
+                    const trimmed = line.trim();
+                    if (trimmed.length === 0) {
+                        rl.prompt();
+                        return;
+                    }
+                    // Pause input while a command runs so its own SIGINT handling (e.g. `logs -f`)
+                    // owns Ctrl-C, and so a second line can't interleave mid-dispatch.
+                    rl.pause();
+                    void this.handleLine(trimmed).then((shouldExit) => {
+                        if (shouldExit) {
+                            rl.close();
+                            return;
+                        }
+                        rl.resume();
+                        rl.prompt();
+                    });
+                });
+                // Ctrl-C at an idle prompt clears the line rather than killing the session.
+                rl.on("SIGINT", () => {
+                    this.cliOutput.writeLine("(type /exit to quit)");
+                    rl.prompt();
+                });
+                rl.on("close", () => {
+                    void this.shutdown().then(() => resolve(common_1.ExitCode.Success));
+                });
+            });
+            return new start_repl_event_response_type_1.StartReplEventResponse(event, exitCode);
+        });
+    }
+    /**
+     * Handles one input line. Returns true when the session should end.
+     */
+    handleLine(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const withoutSlash = input.startsWith("/") ? input.slice(1) : input;
+            const tokens = withoutSlash.split(/\s+/).filter(token => token.length > 0);
+            const name = tokens[0];
+            const rest = tokens.slice(1);
+            if (name === "exit" || name === "quit") {
+                return true;
+            }
+            if (name === "clear") {
+                console.clear();
+                return false;
+            }
+            if (name === "help") {
+                this.printHelp();
+                return false;
+            }
+            try {
+                // Re-enter the kernel with a synthetic argv under the `Cli` keyname — parsing and
+                // dispatch are identical to a one-shot invocation. The `"pristine"` token is the
+                // bin marker `PristineArgv` scans for; everything after it is treated as user
+                // args. `CliEventHandler` returns the exit code instead of calling `process.exit`,
+                // so the loop survives. An unknown command throws `CommandNotFoundError`, caught
+                // below.
+                yield this.kernel.handle(["node", "pristine", name, ...rest], { keyname: core_1.ExecutionContextKeynameEnum.Cli, context: null });
+            }
+            catch (error) {
+                try {
+                    // Stringification + writeLine are wrapped together — `error.message`/`String(error)`
+                    // can throw on pathological inputs, and a throw here would kill the REPL session.
+                    this.cliOutput.writeLine(`Error: ${error instanceof Error ? error.message : String(error)}`);
+                }
+                catch (_a) {
+                    // Drop the error rather than crashing the session.
+                }
+            }
+            return false;
+        });
+    }
+    /**
+     * Readline completer. Completes `/`-prefixed command names and session verbs; for
+     * `/trace` and `/logs` it completes the trailing token with recent trace ids.
+     */
+    complete(line) {
+        const traceIdMatch = /^\/(trace|logs)\s+(\S*)$/.exec(line);
+        if (traceIdMatch !== null) {
+            const partial = traceIdMatch[2];
+            const hits = this.traceStore.recentTraceIds(ReplStartEventHandler_1.TRACE_ID_COMPLETION_LIMIT)
+                .filter(id => id.startsWith(partial));
+            return [hits, partial];
+        }
+        const candidates = [
+            ...this.commands.map(command => `/${command.name}`),
+            ...ReplStartEventHandler_1.SESSION_VERBS,
+        ];
+        const hits = candidates.filter(candidate => candidate.startsWith(line));
+        return [hits.length > 0 ? hits : candidates, line];
+    }
+    printBanner() {
+        this.cliOutput.writeLine("Pristine — interactive console");
+        this.cliOutput.writeLine("Type /help for commands, /exit to quit.");
+        this.cliOutput.writeLine("");
+    }
+    printHelp() {
+        var _a;
+        this.cliOutput.writeLine("Session:");
+        this.cliOutput.writeLine("  /help            show this message");
+        this.cliOutput.writeLine("  /clear           clear the screen");
+        this.cliOutput.writeLine("  /exit            leave the console");
+        this.cliOutput.writeLine("");
+        this.cliOutput.writeLine("Commands (also runnable as `pristine <name>`):");
+        const sorted = [...this.commands].sort((a, b) => a.name.localeCompare(b.name));
+        const longest = sorted.reduce((max, command) => Math.max(max, command.name.length), 0);
+        for (const command of sorted) {
+            const padded = `/${command.name}`.padEnd(longest + 3, " ");
+            this.cliOutput.writeLine(`  ${padded}${(_a = command.description) !== null && _a !== void 0 ? _a : ""}`);
+        }
+    }
+    shutdown() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                yield this.kernel.stop();
+            }
+            catch (_a) {
+                // Best-effort — we're leaving the process anyway.
+            }
+        });
+    }
+    /**
+     * Enumerates every registered command. Resolved from the per-event child container the
+     * kernel handed this handler when it dispatched the REPL-start event — same container
+     * `HelpCommand`/`ListCommand` themselves use, so commands that depend on
+     * `CurrentChildContainer` resolve cleanly.
+     *
+     * `resolveAll`, justified: framework REPL infrastructure at session start — enumerating
+     * every `Command`-tagged service is a container-introspection operation with no
+     * constructor seam.
+     */
+    resolveCommands() {
+        try {
+            return this.container.resolveAll(common_1.ServiceDefinitionTagEnum.Command);
+        }
+        catch (error) {
+            try {
+                // Stringification + stderr.write are wrapped together — `error.message`/`String(error)`
+                // can throw on pathological inputs, and a throw here would bubble out and kill REPL
+                // startup.
+                process.stderr.write(`[repl] could not load commands: ${error instanceof Error ? error.message : String(error)}\n`);
+            }
+            catch (_a) {
+                // Drop the report rather than crashing startup; the empty completer is still usable.
+            }
+            return [];
+        }
+    }
+};
+exports.ReplStartEventHandler = ReplStartEventHandler;
+ReplStartEventHandler.PROMPT = "pristine ❯ ";
+ReplStartEventHandler.SESSION_VERBS = ["/help", "/clear", "/exit"];
+ReplStartEventHandler.TRACE_ID_COMPLETION_LIMIT = 25;
+exports.ReplStartEventHandler = ReplStartEventHandler = ReplStartEventHandler_1 = __decorate([
+    (0, common_1.tag)(common_1.ServiceDefinitionTagEnum.EventHandler),
+    (0, common_1.moduleScoped)(cli_module_keyname_1.CliModuleKeyname),
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)(core_1.Kernel)),
+    __param(1, (0, tsyringe_1.inject)(common_1.ServiceDefinitionTagEnum.CurrentChildContainer)),
+    __metadata("design:paramtypes", [core_1.Kernel, Object, cli_output_manager_1.CliOutput,
+        observability_1.TraceStore])
+], ReplStartEventHandler);
+//# sourceMappingURL=repl-start.event-handler.js.map

package/dist/lib/cjs/event-handlers/repl-start.event-handler.js.map

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

package/dist/lib/cjs/event-payloads/event-payloads.js

@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./command.event-payload"), exports);
+__exportStar(require("./start-repl.event-payload"), exports);
 //# sourceMappingURL=event-payloads.js.map

package/dist/lib/cjs/event-payloads/event-payloads.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-payloads.js","sourceRoot":"","sources":["../../../../src/event-payloads/event-payloads.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC"}
+{"version":3,"file":"event-payloads.js","sourceRoot":"","sources":["../../../../src/event-payloads/event-payloads.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC;AACxC,6DAA2C"}

package/dist/lib/cjs/event-payloads/start-repl.event-payload.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StartReplEventPayload = void 0;
+/**
+ * Payload that signals "launch the interactive REPL." Produced by `ReplStartEventMapper`
+ * for argv shapes with no command (`pristine`) or with the explicit `repl` command
+ * (`pristine repl`). Consumed by `ReplStartEventHandler` which runs the readline loop
+ * for the rest of the process lifetime.
+ *
+ * The payload carries the `scriptPath` (argv[1]) for parity with `CommandEventPayload`
+ * and for diagnostics; the REPL itself reads its input from stdin, not from the payload.
+ */
+class StartReplEventPayload {
+    constructor(scriptPath) {
+        this.scriptPath = scriptPath;
+    }
+}
+exports.StartReplEventPayload = StartReplEventPayload;
+//# sourceMappingURL=start-repl.event-payload.js.map

package/dist/lib/cjs/event-payloads/start-repl.event-payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-repl.event-payload.js","sourceRoot":"","sources":["../../../../src/event-payloads/start-repl.event-payload.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;GAQG;AACH,MAAa,qBAAqB;IAChC,YAAmB,UAAkB;QAAlB,eAAU,GAAV,UAAU,CAAQ;IACrC,CAAC;CACF;AAHD,sDAGC"}

package/dist/lib/cjs/interfaces/interfaces.js

@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./command.interface"), exports);
+__exportStar(require("./terminal-key.interface"), exports);
 //# sourceMappingURL=interfaces.js.map

package/dist/lib/cjs/interfaces/interfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../../src/interfaces/interfaces.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC"}
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../../src/interfaces/interfaces.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,2DAAyC"}

package/dist/lib/cjs/interfaces/terminal-key.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=terminal-key.interface.js.map

package/dist/lib/cjs/interfaces/terminal-key.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-key.interface.js","sourceRoot":"","sources":["../../../../src/interfaces/terminal-key.interface.ts"],"names":[],"mappings":""}

package/dist/lib/cjs/managers/cli-output.manager.js

@@ -0,0 +1,45 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliOutput = void 0;
+const tsyringe_1 = require("tsyringe");
+const common_1 = require("@pristine-ts/common");
+const cli_module_keyname_1 = require("../cli.module.keyname");
+/**
+ * Pipe-friendly stdout primitives for the CLI. Use this when you need to emit text that
+ * a user might redirect or pipe — help banners, command tables, JSON dumps — and the
+ * `LogHandler` pipeline would be wrong because it can be severity-gated, routed to
+ * stderr per-severity, or fanned out to file/Sentry transports. For event narration
+ * ("Compiling X", "Server started"), use `LogHandler` instead.
+ */
+let CliOutput = class CliOutput {
+    /**
+     * Writes a message to stdout without a newline.
+     */
+    write(message) {
+        process.stdout.write(message);
+    }
+    /**
+     * Writes a message to stdout with a newline.
+     */
+    writeLine(message) {
+        process.stdout.write(message + "\n");
+    }
+    /**
+     * Renders an array of objects as a table using Node's `console.table`.
+     */
+    writeTable(rows) {
+        console.table(rows);
+    }
+};
+exports.CliOutput = CliOutput;
+exports.CliOutput = CliOutput = __decorate([
+    (0, tsyringe_1.injectable)(),
+    (0, common_1.moduleScoped)(cli_module_keyname_1.CliModuleKeyname)
+], CliOutput);
+//# sourceMappingURL=cli-output.manager.js.map

package/dist/lib/cjs/managers/cli-output.manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-output.manager.js","sourceRoot":"","sources":["../../../../src/managers/cli-output.manager.ts"],"names":[],"mappings":";;;;;;;;;AAAA,uCAAoC;AACpC,gDAAiD;AACjD,8DAAuD;AAEvD;;;;;;GAMG;AAGI,IAAM,SAAS,GAAf,MAAM,SAAS;IAEpB;;OAEG;IACH,KAAK,CAAC,OAAe;QACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,OAAe;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,IAAW;QACpB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;CACF,CAAA;AAtBY,8BAAS;oBAAT,SAAS;IAFrB,IAAA,qBAAU,GAAE;IACZ,IAAA,qBAAY,EAAC,qCAAgB,CAAC;GAClB,SAAS,CAsBrB"}

package/dist/lib/cjs/managers/cli-progress-bar.manager.js

@@ -0,0 +1,49 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var CliProgressBar_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliProgressBar = void 0;
+const tsyringe_1 = require("tsyringe");
+const common_1 = require("@pristine-ts/common");
+const cli_module_keyname_1 = require("../cli.module.keyname");
+const node_readline_1 = require("node:readline");
+/**
+ * Inline progress bar rendered on the current TTY line. Each call clears and redraws
+ * the line, so callers must not interleave other output (LogHandler narration, raw
+ * CliOutput writes, etc.) between updates or the previous bar will be left behind on
+ * the line above.
+ */
+let CliProgressBar = CliProgressBar_1 = class CliProgressBar {
+    /**
+     * Renders the progress bar at the current line. When `current >= total` the cursor
+     * is advanced to the next line so subsequent output doesn't overwrite the finished bar.
+     */
+    update(current, total, message = "", width = 30) {
+        const percentage = Math.min(Math.max(current / total, 0), 1);
+        const filledWidth = Math.round(width * percentage);
+        const emptyWidth = width - filledWidth;
+        const filledBar = CliProgressBar_1.FILLED.repeat(filledWidth);
+        const emptyBar = CliProgressBar_1.EMPTY.repeat(emptyWidth);
+        (0, node_readline_1.clearLine)(process.stdout, 0);
+        (0, node_readline_1.cursorTo)(process.stdout, 0);
+        process.stdout.write(`${CliProgressBar_1.CYAN}[${filledBar}${emptyBar}]${CliProgressBar_1.RESET} ${Math.round(percentage * 100)}% ${message}`);
+        if (current >= total) {
+            process.stdout.write("\n");
+        }
+    }
+};
+exports.CliProgressBar = CliProgressBar;
+CliProgressBar.FILLED = "█";
+CliProgressBar.EMPTY = "░";
+CliProgressBar.CYAN = "\x1b[36m";
+CliProgressBar.RESET = "\x1b[0m";
+exports.CliProgressBar = CliProgressBar = CliProgressBar_1 = __decorate([
+    (0, tsyringe_1.injectable)(),
+    (0, common_1.moduleScoped)(cli_module_keyname_1.CliModuleKeyname)
+], CliProgressBar);
+//# sourceMappingURL=cli-progress-bar.manager.js.map

package/dist/lib/cjs/managers/cli-progress-bar.manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-progress-bar.manager.js","sourceRoot":"","sources":["../../../../src/managers/cli-progress-bar.manager.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,uCAAoC;AACpC,gDAAiD;AACjD,8DAAuD;AACvD,iDAAkD;AAElD;;;;;GAKG;AAGI,IAAM,cAAc,sBAApB,MAAM,cAAc;IAOzB;;;OAGG;IACH,MAAM,CAAC,OAAe,EAAE,KAAa,EAAE,UAAkB,EAAE,EAAE,QAAgB,EAAE;QAC7E,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7D,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,CAAC;QACnD,MAAM,UAAU,GAAG,KAAK,GAAG,WAAW,CAAC;QAEvC,MAAM,SAAS,GAAG,gBAAc,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC5D,MAAM,QAAQ,GAAG,gBAAc,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAEzD,IAAA,yBAAS,EAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC7B,IAAA,wBAAQ,EAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,gBAAc,CAAC,IAAI,IAAI,SAAS,GAAG,QAAQ,IAAI,gBAAc,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;QAE3I,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;YACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;;AA1BU,wCAAc;AAED,qBAAM,GAAG,GAAG,AAAN,CAAO;AACb,oBAAK,GAAG,GAAG,AAAN,CAAO;AACZ,mBAAI,GAAG,UAAU,AAAb,CAAc;AAClB,oBAAK,GAAG,SAAS,AAAZ,CAAa;yBAL/B,cAAc;IAF1B,IAAA,qBAAU,GAAE;IACZ,IAAA,qBAAY,EAAC,qCAAgB,CAAC;GAClB,cAAc,CA2B1B"}