@prestyj/editor 0.7.1

package/dist/core/doctor-runner.js

@@ -0,0 +1,419 @@
+/**
+ * Interactive doctor screen.
+ *
+ * Modelled directly on `@prestyj/cli/ui/login.tsx`'s
+ * `renderLoginSelector` so the look matches:
+ *
+ *   ▄▀▀▀ ▄▀▀▀   EZ Editor v0.6.0 · By Nolan Grout
+ *   █ ▀█ █ ▀█   Doctor
+ *   ▀▄▄▀ ▀▄▄▀   Environment check
+ *
+ *   ❯ ✓ ffmpeg            — v8.0.1
+ *     ✓ ffprobe           — v8.0.1
+ *     ○ OpenAI API key    — not set
+ *     ✓ Python 3          — v3.14.3
+ *     …
+ *
+ *   ↑↓ navigate · Enter fix · r refresh · Esc quit
+ *
+ * Mechanics:
+ *   - `\x1b[s` saves the cursor on entry; `\x1b[u\x1b[J` restores +
+ *     clears below for each redraw. No alt-screen buffer (we don't need
+ *     it; the doctor is short and re-runnable).
+ *   - On exit we restore + clear so terminal scrollback is preserved.
+ *   - Enter on an installable runs the package manager directly via
+ *     `spawn` (stdio inherited so the user sees output / answers
+ *     prompts). Enter on a `prompt` opens an inline secret capture.
+ *   - q / Esc / Ctrl+C → quit cleanly.
+ */
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline/promises";
+import chalk from "chalk";
+import { setStoredApiKey } from "./auth/api-keys.js";
+import { runDoctor } from "./doctor.js";
+import { renderDoctorReport } from "./doctor-render.js";
+import { getPackageVersion } from "./version.js";
+const LOGO_LINES = [
+    " \u2588\u2580\u2580\u2580 \u2580\u2580\u2580\u2588",
+    " \u2588\u2580\u2580   \u2584\u2580 ",
+    " \u2588\u2584\u2584\u2584 \u2588\u2584\u2584\u2584",
+];
+const GRADIENT = [
+    "#fbbf24",
+    "#f59e0b",
+    "#f97316",
+    "#ea580c",
+    "#dc2626",
+    "#e11d48",
+    "#db2777",
+    "#e11d48",
+    "#dc2626",
+    "#ea580c",
+    "#f97316",
+    "#f59e0b",
+];
+const PRIMARY = "#f97316";
+const ACCENT = "#ec4899";
+const TEXT = "#e2e8f0";
+const TEXT_DIM = "#64748b";
+const GAP = "   ";
+/**
+ * Top-level entry called by cli.ts.
+ *
+ *   - `--all` → prints the static inventory, no screen.
+ *   - non-TTY / `nonInteractive` → same.
+ *   - everything else → mounts the interactive screen.
+ */
+export async function runDoctorInteractive(opts = {}) {
+    if (opts.all || opts.nonInteractive || !process.stdin.isTTY) {
+        const report = runDoctor();
+        process.stdout.write(staticBanner(opts.onboarding === true));
+        process.stdout.write(renderDoctorReport(report, { all: opts.all, onboarding: opts.onboarding }));
+        return;
+    }
+    await mountSelector(opts.onboarding === true);
+}
+// ── Renderers ─────────────────────────────────────────────
+function gradientLine(text) {
+    let result = "";
+    let colorIdx = 0;
+    for (const ch of text) {
+        if (ch === " ") {
+            result += ch;
+        }
+        else {
+            const color = GRADIENT[Math.min(colorIdx, GRADIENT.length - 1)];
+            result += chalk.hex(color)(ch);
+            colorIdx++;
+        }
+    }
+    return result;
+}
+function bannerLines(onboarding) {
+    const screen = onboarding ? "Welcome" : "Doctor";
+    const subtitle = onboarding ? "First-run environment check" : "Environment check — Enter to fix";
+    return [
+        gradientLine(LOGO_LINES[0]) +
+            GAP +
+            chalk.hex(PRIMARY).bold("EZ Editor") +
+            chalk.hex(TEXT_DIM)(` v${getPackageVersion()}`) +
+            chalk.hex(TEXT_DIM)(" \u00b7 By ") +
+            chalk.hex(TEXT).bold("Nolan Grout"),
+        gradientLine(LOGO_LINES[1]) + GAP + chalk.hex(ACCENT)(screen),
+        gradientLine(LOGO_LINES[2]) + GAP + chalk.hex(TEXT_DIM)(subtitle),
+    ];
+}
+function staticBanner(onboarding) {
+    return bannerLines(onboarding).join("\n") + "\n\n";
+}
+function statusGlyph(c) {
+    if (c.status === "ok")
+        return chalk.green("\u2713");
+    if (c.status === "warn")
+        return chalk.yellow("!");
+    if (c.severity === "required" || c.severity === "block")
+        return chalk.red("\u2717");
+    return chalk.yellow("\u25cb");
+}
+/**
+ * One line per item, modelled on login.tsx's provider rows.
+ *
+ *   ❯ ✓ ffmpeg            — v8.0.1
+ *     ○ OpenAI API key    — not set
+ *
+ * The `detail` is the right-side em-dash text (terse — see doctor.ts
+ * for the trimmed strings: "v8.0.1", "set", "not set", etc).
+ */
+function renderItemLine(c, selected, status) {
+    const marker = selected ? chalk.hex(PRIMARY)("\u276f ") : "  ";
+    const labelColor = status === "ok"
+        ? selected
+            ? chalk.hex(PRIMARY)
+            : chalk.hex(TEXT)
+        : selected
+            ? chalk.hex(PRIMARY).bold
+            : chalk.hex(TEXT);
+    const label = labelColor(c.label.padEnd(22));
+    return `${marker}${statusGlyph(c)} ${label}${chalk.hex(TEXT_DIM)(` \u2014 ${c.detail}`)}`;
+}
+function renderScreen(items, selectedIdx, onboarding, note, exitPending) {
+    const lines = [...bannerLines(onboarding), ""];
+    for (let i = 0; i < items.length; i++) {
+        const c = items[i];
+        const status = c.status === "ok" ? "ok" : c.status === "warn" ? "warn" : "miss";
+        lines.push(renderItemLine(c, i === selectedIdx, status));
+    }
+    lines.push("");
+    if (note)
+        lines.push("  " + chalk.hex(ACCENT)(note));
+    // Footer mirrors ezeditor's main-TUI abort pattern: first Esc / Ctrl+C
+    // shows "Press again to exit"; the second press within 800ms quits.
+    // Avoids accidental quits and matches the look users learned from the
+    // main TUI footer.
+    const footer = exitPending
+        ? chalk.yellow("  Press Esc again to exit")
+        : chalk.hex(TEXT_DIM)("  \u2191\u2193 navigate \u00b7 ") +
+            chalk.hex(PRIMARY)("Enter") +
+            chalk.hex(TEXT_DIM)(" fix \u00b7 ") +
+            chalk.hex(PRIMARY)("r") +
+            chalk.hex(TEXT_DIM)(" refresh \u00b7 ") +
+            chalk.hex(PRIMARY)("Esc") +
+            chalk.hex(TEXT_DIM)(" quit");
+    lines.push(footer);
+    return lines.join("\n");
+}
+// ── Interactive selector ──────────────────────────────────
+async function mountSelector(onboarding) {
+    const stdout = process.stdout;
+    const stdin = process.stdin;
+    let report = runDoctor();
+    let items = report.checks.filter((c) => c.severity !== "info");
+    let selectedIdx = pickFirstActionable(items);
+    let note;
+    let noteTimer = null;
+    // Double-press exit (mirrors ezeditor's main TUI). First Esc / Ctrl+C
+    // arms exitPending; second within DOUBLE_PRESS_TIMEOUT_MS confirms.
+    let exitPending = false;
+    let exitTimer = null;
+    // Full-clear + cursor home, then save the position so subsequent
+    // redraws can restore it. Wipes the shell prompt that ran us, so the
+    // doctor screen looks like a standalone view.
+    stdout.write("\x1b[2J\x1b[H\x1b[s");
+    const draw = () => {
+        stdout.write("\x1b[u\x1b[J" + renderScreen(items, selectedIdx, onboarding, note, exitPending) + "\n");
+    };
+    const flashNote = (text) => {
+        if (noteTimer)
+            clearTimeout(noteTimer);
+        note = text;
+        draw();
+        noteTimer = setTimeout(() => {
+            note = undefined;
+            draw();
+        }, 2500);
+    };
+    const reload = () => {
+        report = runDoctor();
+        items = report.checks.filter((c) => c.severity !== "info");
+        if (selectedIdx >= items.length)
+            selectedIdx = Math.max(0, items.length - 1);
+    };
+    draw();
+    stdin.setRawMode(true);
+    stdin.resume();
+    return new Promise((resolve) => {
+        const cleanup = () => {
+            if (noteTimer)
+                clearTimeout(noteTimer);
+            if (exitTimer)
+                clearTimeout(exitTimer);
+            stdin.removeListener("data", onData);
+            stdin.setRawMode(false);
+            stdin.pause();
+            // Full clear so the user's terminal scrollback isn't polluted with
+            // selector frames; print one summary line as a fresh start.
+            stdout.write("\x1b[2J\x1b[H");
+            const total = items.length;
+            const ok = items.filter((c) => c.status === "ok").length;
+            if (ok === total) {
+                stdout.write(chalk.green("\u2713 Nothing to fix. You're all good.") +
+                    chalk.hex(TEXT_DIM)(" Run `ezeditor` to start.\n"));
+            }
+            else {
+                stdout.write(chalk.hex(TEXT_DIM)(`Doctor closed. ${ok}/${total} ready. Re-run \`ezeditor doctor\` any time.\n`));
+            }
+            resolve();
+        };
+        /**
+         * Tear down the selector, fully clear the screen, re-print the
+         * branded banner, then run an async block with normal stdio. The
+         * full clear (\x1b[2J\x1b[H) wipes the prior shell prompt so the
+         * sub-screen looks like a standalone view, not a continuation of
+         * the user's terminal scrollback.
+         */
+        const runWithSubshell = async (block) => {
+            stdin.removeListener("data", onData);
+            stdin.setRawMode(false);
+            stdin.pause();
+            // Full clear + cursor home, then re-render the banner.
+            stdout.write("\x1b[2J\x1b[H");
+            stdout.write(staticBanner(onboarding));
+            let result;
+            try {
+                result = await block();
+            }
+            catch (e) {
+                process.stdout.write(chalk.red(`\n  Error: ${e.message}\n`));
+                result = { ok: false };
+            }
+            // Brief pause so the user sees the outcome.
+            await new Promise((r) => setTimeout(r, 600));
+            // Full clear + re-save cursor + redraw the selector.
+            stdout.write("\x1b[2J\x1b[H\x1b[s");
+            stdin.setRawMode(true);
+            stdin.resume();
+            stdin.on("data", onData);
+            reload();
+            const cur = items[selectedIdx];
+            if (cur) {
+                const newIdx = items.findIndex((c) => c.id === cur.id);
+                selectedIdx = newIdx >= 0 ? newIdx : pickFirstActionable(items);
+            }
+            if (result.ok)
+                flashNote(`Saved`);
+            else
+                draw();
+        };
+        const onData = (chunk) => {
+            const key = chunk.toString();
+            // Esc / Ctrl+C / q — double-press to confirm. First press arms
+            // exitPending and the footer flips to "Press Esc again to exit";
+            // second press within 800ms confirms; otherwise it auto-clears.
+            if (key === "\x1b" || key === "\x03" || key === "q") {
+                if (exitPending) {
+                    if (exitTimer)
+                        clearTimeout(exitTimer);
+                    cleanup();
+                }
+                else {
+                    exitPending = true;
+                    draw();
+                    exitTimer = setTimeout(() => {
+                        exitPending = false;
+                        draw();
+                    }, 800);
+                }
+                return;
+            }
+            // Any other key clears a pending-exit hint without acting on it.
+            if (exitPending) {
+                if (exitTimer)
+                    clearTimeout(exitTimer);
+                exitPending = false;
+                draw();
+            }
+            // ↑
+            if (key === "\x1b[A" && selectedIdx > 0) {
+                selectedIdx--;
+                draw();
+                return;
+            }
+            // ↓
+            if (key === "\x1b[B" && selectedIdx < items.length - 1) {
+                selectedIdx++;
+                draw();
+                return;
+            }
+            // r → refresh
+            if (key === "r") {
+                reload();
+                flashNote("Refreshed");
+                return;
+            }
+            // Enter → install / prompt / nothing
+            if (key === "\r" || key === "\n") {
+                const cur = items[selectedIdx];
+                if (!cur)
+                    return;
+                if (cur.status === "ok") {
+                    flashNote("Already done");
+                    return;
+                }
+                if (cur.installable) {
+                    const inst = cur.installable;
+                    void runWithSubshell(async () => {
+                        process.stdout.write(chalk.hex(TEXT_DIM)("Running: ") +
+                            chalk.cyan(`${inst.command} ${inst.args.join(" ")}`) +
+                            "\n\n");
+                        const code = await spawnInstall(inst.command, inst.args);
+                        if (code === 0) {
+                            process.stdout.write(chalk.green("\n\u2713 Installed.\n"));
+                            return { ok: true };
+                        }
+                        process.stdout.write(chalk.red(`\n\u2717 Install failed (exit ${code}).\n`));
+                        return { ok: false };
+                    });
+                    return;
+                }
+                if (cur.prompt) {
+                    const p = cur.prompt;
+                    void runWithSubshell(async () => promptForSecret(p));
+                    return;
+                }
+                flashNote("No automatic fix");
+            }
+        };
+        stdin.on("data", onData);
+    });
+}
+// ── Helpers ───────────────────────────────────────────────
+function pickFirstActionable(items) {
+    // Priority: required-missing/warn → optional-warn → optional-missing → 0.
+    const tiers = [
+        { severity: "block", statuses: ["missing", "warn"] },
+        { severity: "required", statuses: ["missing", "warn"] },
+        { severity: "optional", statuses: ["warn"] },
+        { severity: "optional", statuses: ["missing"] },
+    ];
+    for (const tier of tiers) {
+        const idx = items.findIndex((c) => c.severity === tier.severity && tier.statuses.includes(c.status));
+        if (idx >= 0)
+            return idx;
+    }
+    return 0;
+}
+function spawnInstall(command, args) {
+    return new Promise((resolve) => {
+        const child = spawn(command, args, { stdio: "inherit" });
+        child.on("close", (code) => resolve(code ?? 1));
+        child.on("error", () => resolve(1));
+    });
+}
+/**
+ * Prompt the user for a secret, validate it, persist via setStoredApiKey.
+ *
+ * Echoes input as it's typed — these are API keys, and node has no
+ * built-in masked-input primitive without dragging in a dep. Anyone
+ * with shell access could `cat ~/.ezcoder/api-keys.json` anyway.
+ */
+async function promptForSecret(p) {
+    const dim = chalk.hex(TEXT_DIM);
+    const primary = chalk.hex(PRIMARY);
+    const accent = chalk.hex(ACCENT);
+    // Caller (runWithSubshell) has already cleared the screen + printed
+    // the banner. We just add the prompt body.
+    process.stdout.write("  " + primary.bold(p.label) + "\n");
+    if (p.hint)
+        process.stdout.write("  " + dim(p.hint) + "\n");
+    process.stdout.write("  " + dim("(blank + Enter to cancel)") + "\n\n");
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        for (let attempt = 0; attempt < 3; attempt++) {
+            const value = (await rl.question("  " + accent("\u276f "))).trim();
+            if (value.length === 0) {
+                process.stdout.write(dim("  Cancelled.\n"));
+                return { ok: false };
+            }
+            const err = p.validate?.(value);
+            if (err) {
+                process.stdout.write(chalk.yellow(`  ! ${err}\n`));
+                continue;
+            }
+            try {
+                setStoredApiKey(p.store, value);
+            }
+            catch (e) {
+                process.stdout.write(chalk.red(`  \u2717 Failed to save: ${e.message}\n`));
+                return { ok: false };
+            }
+            process.stdout.write(chalk.green("  \u2713 Saved to ~/.ezcoder/api-keys.json (chmod 600).\n"));
+            return { ok: true };
+        }
+        process.stdout.write(dim("  Too many invalid attempts. Cancelled.\n"));
+        return { ok: false };
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=doctor-runner.js.map

package/dist/core/doctor-runner.js.map

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

package/dist/core/doctor.d.ts

@@ -0,0 +1,120 @@
+/**
+ * First-run doctor — environment probes + actionable install hints.
+ *
+ * The CLI runs onboarding on first launch (no `~/.ezcoder/auth.json` and no
+ * `~/.ezcoder/onboarded-ezeditor` marker). The same checks are exposed via
+ * `ezeditor doctor` so users can re-run it any time.
+ *
+ * Design rules:
+ *   - Probes only. We never auto-install anything — surprise sudo
+ *     prompts are worse than a missing dep.
+ *   - Each check carries `severity`:
+ *       block    — nothing meaningful works without it (none currently;
+ *                  the agent can run with zero deps)
+ *       required — most tools need it (ffmpeg / ffprobe)
+ *       optional — unlocks a feature group (openai-key, resolve,
+ *                  premiere, whisper-cpp, whisperx)
+ *       info     — purely informational (auth status)
+ *   - Each check tells the user EXACTLY what to do to fix it, including
+ *     the platform-appropriate install command.
+ *   - Pure module — no I/O writes, no side effects beyond `spawnSync` /
+ *     `existsSync` probes.
+ */
+export type CheckSeverity = "block" | "required" | "optional" | "info";
+export type CheckStatus = "ok" | "missing" | "warn";
+/**
+ * Structured install hint. When present, the doctor's interactive flow
+ * can offer to spawn this command after a Y/N confirmation — no copy-
+ * paste, no shell injection (we never run a string through `sh -c`).
+ *
+ * Only attached to checks where the install is a single packaged step
+ * (Homebrew formula, winget id, apt package). Items that need manual
+ * sign-up (API keys), license acceptance (Resolve installer), or
+ * multi-step setup (whisperx + HF_TOKEN) carry a `fix` string instead.
+ */
+export interface InstallableHint {
+    /** Human label shown in the prompt: "Install ffmpeg via Homebrew". */
+    label: string;
+    /** Executable on PATH. */
+    command: string;
+    /** Argument vector — NEVER a shell string. */
+    args: string[];
+    /**
+     * What managed manager this uses. Used by the renderer to decide
+     * whether to show "requires sudo" copy.
+     */
+    manager: "homebrew" | "winget" | "apt" | "pip" | "npm";
+    /** True when the command requires elevated privileges (sudo / admin). */
+    needsSudo?: boolean;
+}
+/**
+ * Structured prompt action. When present, the doctor's interactive
+ * screen can capture a secret (API key, token) directly and persist
+ * it to the api-keys store — no "open another terminal and run
+ * export X=..." busywork.
+ *
+ * Persistence is on the runner side; this struct just describes WHAT
+ * to capture and WHERE to put it (`store` is a stable id used by
+ * `setStoredApiKey`).
+ */
+export interface PromptHint {
+    /** Title shown above the input: "Paste your OpenAI API key". */
+    label: string;
+    /** Optional one-line guidance under the title (URL where to get it). */
+    hint?: string;
+    /** ApiKeyName from auth/api-keys.ts — "openai" | "huggingface". */
+    store: "openai" | "huggingface";
+    /** Lightweight format check; rejects obviously-wrong input. */
+    validate?: (value: string) => string | undefined;
+}
+export interface DoctorCheck {
+    /** Stable id (also the check key). */
+    id: string;
+    /** ≤30 char display label. */
+    label: string;
+    status: CheckStatus;
+    severity: CheckSeverity;
+    /** One-line current state ("v6.1.1 found", "not on PATH", …). */
+    detail: string;
+    /**
+     * What this check unlocks for the user. Always present, even when
+     * status=ok — gives the user the mental model.
+     */
+    unlocks: string;
+    /**
+     * Optional structured install command for items where a single
+     * package-manager invocation does the job. The CLI offers Y/N
+     * confirmation and spawns it directly.
+     */
+    installable?: InstallableHint;
+    /**
+     * Optional inline secret prompt (API key / token). When the user hits
+     * Enter on this item the doctor captures the value and persists it
+     * to ~/.ezcoder/api-keys.json. Mutually exclusive with `installable` per
+     * action; if both are present, install runs first then prompt.
+     */
+    prompt?: PromptHint;
+    /**
+     * Free-form fix copy for the static `--all` / non-interactive path.
+     * The interactive screen IGNORES this — it uses installable/prompt.
+     * Multi-line is fine here; only `--all` renders it.
+     */
+    fix?: string;
+}
+export interface DoctorReport {
+    checks: DoctorCheck[];
+    /** True when no `severity=required` check is missing. */
+    ready: boolean;
+    /** Where the marker file was/should be written. */
+    markerPath: string;
+    /** Whether onboarding has been completed before. */
+    onboarded: boolean;
+}
+export declare function onboardedMarkerPath(home?: string): string;
+export declare function isOnboarded(home?: string): boolean;
+/**
+ * Run every check. Synchronous and quick — only spawns short-lived
+ * `--version` style probes.
+ */
+export declare function runDoctor(home?: string): DoctorReport;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/core/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/core/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AASH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;AAEvE,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf;;;OAGG;IACH,OAAO,EAAE,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;IACvD,yEAAyE;IACzE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,KAAK,EAAE,QAAQ,GAAG,aAAa,CAAC;IAChC,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAClD;AAED,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,aAAa,CAAC;IACxB,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,yDAAyD;IACzD,KAAK,EAAE,OAAO,CAAC;IACf,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,SAAS,EAAE,OAAO,CAAC;CACpB;AAID,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,MAAkB,GAAG,MAAM,CAEpE;AAED,wBAAgB,WAAW,CAAC,IAAI,GAAE,MAAkB,GAAG,OAAO,CAM7D;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,GAAE,MAAkB,GAAG,YAAY,CAsBhE"}