@prestyj/editor 0.7.1

package/dist/core/doctor.js

@@ -0,0 +1,413 @@
+/**
+ * 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.
+ */
+import { statSync } from "node:fs";
+import { homedir, platform } from "node:os";
+import { join } from "node:path";
+import { spawnSync } from "node:child_process";
+import { getStoredApiKey } from "./auth/api-keys.js";
+import { checkFfmpeg, checkFfprobe } from "./media/ffmpeg.js";
+const ONBOARDED_MARKER = "onboarded-ezeditor";
+export function onboardedMarkerPath(home = homedir()) {
+    return join(home, ".ezcoder", ONBOARDED_MARKER);
+}
+export function isOnboarded(home = homedir()) {
+    try {
+        return statSync(onboardedMarkerPath(home)).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Run every check. Synchronous and quick — only spawns short-lived
+ * `--version` style probes.
+ */
+export function runDoctor(home = homedir()) {
+    // Host (Resolve / Premiere) detection lives in the live banner +
+    // footer at runtime — the doctor doesn't lecture users about which
+    // NLE they have. They know.
+    const checks = [
+        checkFfmpegProbe(),
+        checkFfprobeProbe(),
+        checkAuthFile(home),
+        checkOpenAIKey(),
+        checkPython(),
+        checkWhisperCpp(),
+        checkWhisperX(),
+        checkAnthropicKey(),
+    ];
+    const ready = checks.every((c) => c.severity !== "required" || c.status === "ok");
+    return {
+        checks,
+        ready,
+        markerPath: onboardedMarkerPath(home),
+        onboarded: isOnboarded(home),
+    };
+}
+// ── Individual probes ──────────────────────────────────────
+function checkFfmpegProbe() {
+    const ok = checkFfmpeg();
+    return {
+        id: "ffmpeg",
+        label: "ffmpeg",
+        status: ok ? "ok" : "missing",
+        severity: "required",
+        detail: ok ? versionLine("ffmpeg") : "not on PATH",
+        unlocks: "Most tools (transcoding, captions, color grading, silence/filler cuts, transitions, " +
+            "audio mixing, GIF/thumbnail generation). ~70% of the toolkit.",
+        fix: ok ? undefined : ffmpegInstallHint(),
+        installable: ok
+            ? undefined
+            : buildInstallable({
+                pkg: { darwin: "ffmpeg", linux: "ffmpeg", win32: "Gyan.FFmpeg" },
+                label: "Install ffmpeg",
+            }),
+    };
+}
+function checkFfprobeProbe() {
+    const ok = checkFfprobe();
+    return {
+        id: "ffprobe",
+        label: "ffprobe",
+        status: ok ? "ok" : "missing",
+        severity: "required",
+        detail: ok ? versionLine("ffprobe") : "not on PATH",
+        unlocks: "probe_media (fps / duration / codec detection — runs on every input file).",
+        fix: ok ? undefined : ffmpegInstallHint(),
+        // ffprobe ships in the same Homebrew/winget/apt package as ffmpeg.
+        installable: ok
+            ? undefined
+            : buildInstallable({
+                pkg: { darwin: "ffmpeg", linux: "ffmpeg", win32: "Gyan.FFmpeg" },
+                label: "Install ffmpeg (includes ffprobe)",
+            }),
+    };
+}
+function checkOpenAIKey() {
+    const fromEnv = !!process.env.OPENAI_API_KEY;
+    const fromStore = !!getStoredApiKey("openai");
+    const present = fromEnv || fromStore;
+    return {
+        id: "openai-key",
+        label: "OpenAI API key",
+        status: present ? "ok" : "missing",
+        severity: "optional",
+        detail: fromEnv ? "set (env)" : fromStore ? "set (saved)" : "not set",
+        unlocks: "Vision tools: analyze_hook, score_shot, color_match, grade_skin_tones, " +
+            "match_clip_color, and the OpenAI transcription backend.",
+        prompt: present
+            ? undefined
+            : {
+                label: "Paste your OpenAI API key",
+                hint: "Get one at https://platform.openai.com/api-keys (free tier available)",
+                store: "openai",
+                validate: (v) => (v.startsWith("sk-") ? undefined : "OpenAI keys start with 'sk-'"),
+            },
+        fix: present
+            ? undefined
+            : "Press Enter to paste your key here — it'll be saved to ~/.ezcoder/api-keys.json.",
+    };
+}
+function checkAnthropicKey() {
+    // Anthropic auth normally goes through OAuth (~/.ezcoder/auth.json). The env
+    // var only matters for users who prefer raw API keys. We mark it as
+    // info — auth status is what really matters.
+    const present = !!process.env.ANTHROPIC_API_KEY;
+    return {
+        id: "anthropic-key",
+        label: "ANTHROPIC_API_KEY",
+        status: present ? "ok" : "missing",
+        severity: "info",
+        detail: present ? "set" : "not set",
+        unlocks: "Direct Anthropic API auth without OAuth. Most users should `ezeditor login` instead.",
+        fix: undefined,
+    };
+}
+function checkPython() {
+    const candidates = platform() === "win32" ? ["py", "python", "python3"] : ["python3", "python"];
+    for (const cmd of candidates) {
+        const r = spawnSync(cmd, cmd === "py" ? ["-3", "--version"] : ["--version"], {
+            encoding: "utf8",
+        });
+        if (r.status === 0) {
+            const out = (r.stdout || r.stderr).trim();
+            const m = /\b(\d+\.\d+(?:\.\d+)?)\b/.exec(out);
+            return {
+                id: "python",
+                label: "Python 3",
+                status: "ok",
+                severity: "optional",
+                detail: m ? `v${m[1]}` : "found",
+                unlocks: "DaVinci Resolve scripting bridge (host integration). Without Python, file-only " +
+                    "mode still works.",
+            };
+        }
+    }
+    return {
+        id: "python",
+        label: "Python 3",
+        status: "missing",
+        severity: "optional",
+        detail: "not on PATH",
+        unlocks: "DaVinci Resolve scripting bridge (host integration). File-only mode works without it.",
+        fix: platform() === "darwin"
+            ? "brew install python   # latest 3.x (currently 3.14)"
+            : platform() === "linux"
+                ? "sudo apt install python3   # debian/ubuntu — your distro's package manager otherwise"
+                : "winget install Python.Python.3   # or python.org installer",
+        installable: buildInstallable({
+            // 'python' is Homebrew's alias for the current default Python 3
+            // bottle (currently 3.14). Tracks Homebrew's choice so we don't
+            // pin a stale minor.
+            pkg: { darwin: "python", linux: "python3", win32: "Python.Python.3" },
+            label: "Install Python 3",
+        }),
+    };
+}
+function checkWhisperCpp() {
+    for (const cmd of ["whisper-cli", "whisper", "main"]) {
+        const r = spawnSync(cmd, ["--help"], { encoding: "utf8" });
+        if (r.status === 0 && (r.stdout + r.stderr).toLowerCase().includes("whisper")) {
+            return {
+                id: "whisper-cpp",
+                label: "whisper.cpp",
+                status: "ok",
+                severity: "optional",
+                detail: "installed",
+                unlocks: "Local transcription (free, fast, private). Without it, transcribe falls back to " +
+                    "the OpenAI API (requires OPENAI_API_KEY).",
+            };
+        }
+    }
+    return {
+        id: "whisper-cpp",
+        label: "whisper.cpp",
+        status: "missing",
+        severity: "optional",
+        detail: "not installed",
+        unlocks: "Local transcription. Without it, transcribe uses the OpenAI API (requires OPENAI_API_KEY).",
+        fix: platform() === "darwin"
+            ? "brew install whisper-cpp   # then download a model from https://huggingface.co/ggerganov/whisper.cpp"
+            : "Build from source: https://github.com/ggml-org/whisper.cpp",
+        // Only Homebrew packages whisper.cpp cleanly. Linux / Windows users
+        // need to build from source — we leave them with the `fix` string.
+        installable: buildInstallable({
+            pkg: { darwin: "whisper-cpp" },
+            label: "Install whisper.cpp (you'll still need to download a model)",
+        }),
+    };
+}
+function checkWhisperX() {
+    const r = spawnSync("whisperx", ["--help"], { encoding: "utf8" });
+    const ok = r.status === 0;
+    const fromEnv = !!process.env.HF_TOKEN;
+    const fromStore = !!getStoredApiKey("huggingface");
+    const hfToken = fromEnv || fromStore;
+    if (ok && hfToken) {
+        return {
+            id: "whisperx",
+            label: "whisperx",
+            status: "ok",
+            severity: "optional",
+            detail: fromEnv ? "ready (env)" : "ready (saved)",
+            unlocks: "Speaker diarization (transcribe with diarize=true). Required for read_transcript with " +
+                "speaker filters.",
+        };
+    }
+    if (ok && !hfToken) {
+        return {
+            id: "whisperx",
+            label: "whisperx",
+            status: "warn",
+            severity: "optional",
+            detail: "missing HF_TOKEN",
+            unlocks: "Speaker diarization (transcribe with diarize=true).",
+            prompt: {
+                label: "Paste your Hugging Face token",
+                hint: "Free at https://huggingface.co/settings/tokens — also accept " +
+                    "https://huggingface.co/pyannote/speaker-diarization-3.1 model terms.",
+                store: "huggingface",
+                validate: (v) => (v.startsWith("hf_") ? undefined : "Hugging Face tokens start with 'hf_'"),
+            },
+            fix: "Press Enter to paste your token here — it'll be saved to ~/.ezcoder/api-keys.json.",
+        };
+    }
+    return {
+        id: "whisperx",
+        label: "whisperx",
+        status: "missing",
+        severity: "optional",
+        detail: "not installed",
+        unlocks: "Speaker diarization (transcribe with diarize=true).",
+        fix: whisperxFixHint(),
+        installable: whisperxInstaller(),
+        // After install succeeds the next doctor pass will see whisperx on
+        // PATH and surface the warn-state with the HF_TOKEN prompt above.
+        // We don't bundle the token prompt with the install action because
+        // pipx output is verbose and we want a clean transition.
+    };
+}
+/**
+ * Install path for whisperx. We prefer `pipx` because modern Python on
+ * Homebrew / most distros enforces PEP 668 — `pip install --user` is
+ * refused unless you pass `--break-system-packages`. pipx solves this
+ * by isolating each tool in its own venv and exposing the entry point
+ * on PATH. Fallback chain:
+ *   1. pipx — the recommended path on Homebrew/Linux distros (PEP 668-safe).
+ *   2. pip3 with --break-system-packages — last resort when pipx isn't
+ *      installed; the user can always install pipx manually first.
+ *   3. nothing — falls back to the manual `fix` text.
+ */
+function whisperxInstaller() {
+    if (hasManager("pipx")) {
+        return {
+            label: "Install whisperx via pipx (you'll still need HF_TOKEN + accept model terms)",
+            command: "pipx",
+            args: ["install", "whisperx"],
+            manager: "pip",
+        };
+    }
+    // No pipx — don't try `pip3 install --user`; PEP 668 will reject it on
+    // any sane Python install. Surface the manual fix instead so the user
+    // sees the right next step (install pipx) rather than a wall of pip
+    // error text.
+    return undefined;
+}
+function whisperxFixHint() {
+    const installPipx = platform() === "darwin"
+        ? "brew install pipx"
+        : platform() === "linux"
+            ? "sudo apt install pipx   # or your distro's package manager"
+            : "winget install pipx";
+    return (`${installPipx}\n` +
+        "pipx install whisperx\n" +
+        "export HF_TOKEN=hf_...   # https://huggingface.co/settings/tokens\n" +
+        "Then accept https://huggingface.co/pyannote/speaker-diarization-3.1 model terms.");
+}
+function checkAuthFile(home) {
+    const path = join(home, ".ezcoder", "auth.json");
+    const exists = (() => {
+        try {
+            return statSync(path).isFile();
+        }
+        catch {
+            return false;
+        }
+    })();
+    return {
+        id: "auth",
+        label: "Auth",
+        status: exists ? "ok" : "missing",
+        severity: "required",
+        detail: exists ? "signed in" : "not configured",
+        unlocks: "The agent itself. Without auth, ezeditor can't talk to a model provider.",
+        fix: exists
+            ? undefined
+            : "Run `ezeditor login` and pick a provider (Anthropic OAuth recommended; OpenAI / GLM / " +
+                "Moonshot also supported). Auth is shared with ezcoder via ~/.ezcoder/auth.json — log in once.",
+    };
+}
+// ── Helpers ────────────────────────────────────────────────
+/**
+ * Probe a `<cmd> -version` output and return ONLY the version number
+ * (e.g. "v8.0.1"). Trims away program name + copyright noise so the
+ * doctor's right-hand column stays a clean one-word status.
+ */
+function versionLine(cmd) {
+    const r = spawnSync(cmd, ["-version"], { encoding: "utf8" });
+    if (r.status !== 0)
+        return "found";
+    const first = (r.stdout.split(/\r?\n/)[0] || "").trim();
+    const m = /\b(\d+\.\d+(?:\.\d+)?)\b/.exec(first);
+    return m ? `v${m[1]}` : "found";
+}
+function ffmpegInstallHint() {
+    switch (platform()) {
+        case "darwin":
+            return "brew install ffmpeg";
+        case "linux":
+            return "sudo apt install ffmpeg   # debian/ubuntu — your distro's package manager otherwise";
+        case "win32":
+            return "winget install ffmpeg   # or scoop install ffmpeg";
+        default:
+            return "Install ffmpeg from https://ffmpeg.org/download.html";
+    }
+}
+/**
+ * True when `cmd --version` (or `--help` for managers that don't have
+ * a version flag) exits 0. Cached for the lifetime of the process so we
+ * don't re-spawn the same probe across multiple checks.
+ */
+const _managerCache = new Map();
+function hasManager(cmd) {
+    const cached = _managerCache.get(cmd);
+    if (cached !== undefined)
+        return cached;
+    const r = spawnSync(cmd, ["--version"], { encoding: "utf8" });
+    const ok = r.status === 0;
+    _managerCache.set(cmd, ok);
+    return ok;
+}
+/**
+ * Build an InstallableHint for a package whose name matches across the
+ * common managers we support. Returns undefined when no supported
+ * manager is available on this platform — in which case the check just
+ * surfaces a `fix` string instead.
+ */
+function buildInstallable(opts) {
+    const p = platform();
+    if (p === "darwin" && opts.pkg.darwin && hasManager("brew")) {
+        return {
+            label: opts.label,
+            command: "brew",
+            args: ["install", opts.pkg.darwin],
+            manager: "homebrew",
+        };
+    }
+    if (p === "linux" && opts.pkg.linux && hasManager("apt")) {
+        return {
+            label: opts.label,
+            command: "sudo",
+            args: ["apt", "install", "-y", opts.pkg.linux],
+            manager: "apt",
+            needsSudo: true,
+        };
+    }
+    if (p === "win32" && opts.pkg.win32 && hasManager("winget")) {
+        return {
+            label: opts.label,
+            command: "winget",
+            args: [
+                "install",
+                "--id",
+                opts.pkg.win32,
+                "-e",
+                "--accept-source-agreements",
+                "--accept-package-agreements",
+            ],
+            manager: "winget",
+        };
+    }
+    return undefined;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/core/doctor.js.map

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=doctor.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.test.d.ts","sourceRoot":"","sources":["../../src/core/doctor.test.ts"],"names":[],"mappings":""}

package/dist/core/doctor.test.js

@@ -0,0 +1,131 @@
+import { mkdirSync, mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { describe, expect, it } from "vitest";
+import { isOnboarded, onboardedMarkerPath, runDoctor } from "./doctor.js";
+/**
+ * The doctor module is mostly env probes; we don't try to mock spawn.
+ * What we DO test is:
+ *   - Every check is present and well-formed.
+ *   - severity / status semantics are consistent.
+ *   - The marker file plumbing works against a synthetic home dir.
+ *   - `ready` reflects required-check status correctly.
+ */
+describe("runDoctor", () => {
+    it("returns a check for every documented id", () => {
+        const r = runDoctor();
+        const ids = r.checks.map((c) => c.id).sort();
+        expect(ids).toEqual([
+            "anthropic-key",
+            "auth",
+            "ffmpeg",
+            "ffprobe",
+            "openai-key",
+            "python",
+            "whisper-cpp",
+            "whisperx",
+        ].sort());
+    });
+    it("every check has label / detail / unlocks populated", () => {
+        const r = runDoctor();
+        for (const c of r.checks) {
+            expect(c.label.length).toBeGreaterThan(0);
+            expect(c.label.length).toBeLessThanOrEqual(40);
+            expect(c.detail.length).toBeGreaterThan(0);
+            expect(c.unlocks.length).toBeGreaterThan(0);
+        }
+    });
+    it("only checks with status='missing' or 'warn' carry a fix message", () => {
+        const r = runDoctor();
+        for (const c of r.checks) {
+            if (c.status === "ok") {
+                expect(c.fix).toBeUndefined();
+            }
+        }
+    });
+    it("ready === true only when every required check is ok", () => {
+        const r = runDoctor();
+        const requiredOk = r.checks
+            .filter((c) => c.severity === "required")
+            .every((c) => c.status === "ok");
+        expect(r.ready).toBe(requiredOk);
+    });
+    it("returns a markerPath inside the user's home", () => {
+        const r = runDoctor();
+        expect(r.markerPath).toContain(".ezcoder");
+        expect(r.markerPath).toContain("onboarded-ezeditor");
+    });
+});
+describe("isOnboarded / onboardedMarkerPath", () => {
+    it("returns false when the marker is absent", () => {
+        const home = mkdtempSync(join(tmpdir(), "gg-doctor-"));
+        expect(isOnboarded(home)).toBe(false);
+    });
+    it("returns true once the marker file exists", () => {
+        const home = mkdtempSync(join(tmpdir(), "gg-doctor-"));
+        const path = onboardedMarkerPath(home);
+        mkdirSync(join(home, ".ezcoder"), { recursive: true });
+        writeFileSync(path, "2026-04-30T00:00:00.000Z\n", "utf8");
+        expect(isOnboarded(home)).toBe(true);
+    });
+    it("returns false when the marker path exists but isn't a regular file", () => {
+        const home = mkdtempSync(join(tmpdir(), "gg-doctor-"));
+        // Create a directory at the marker path instead of a file.
+        mkdirSync(onboardedMarkerPath(home), { recursive: true });
+        expect(isOnboarded(home)).toBe(false);
+    });
+    it("auth check sees a present auth.json under the synthetic home", () => {
+        const home = mkdtempSync(join(tmpdir(), "gg-doctor-"));
+        mkdirSync(join(home, ".ezcoder"), { recursive: true });
+        writeFileSync(join(home, ".ezcoder", "auth.json"), "{}", "utf8");
+        const r = runDoctor(home);
+        const auth = r.checks.find((c) => c.id === "auth");
+        expect(auth.status).toBe("ok");
+        expect(auth.detail).toBe("signed in");
+    });
+    it("auth check reports missing on a fresh home", () => {
+        const home = mkdtempSync(join(tmpdir(), "gg-doctor-"));
+        const r = runDoctor(home);
+        const auth = r.checks.find((c) => c.id === "auth");
+        expect(auth.status).toBe("missing");
+        expect(auth.fix).toContain("ezeditor login");
+    });
+});
+describe("doctor severity / status invariants", () => {
+    it("OPENAI_API_KEY check returns ok when the env var is set", () => {
+        const prev = process.env.OPENAI_API_KEY;
+        process.env.OPENAI_API_KEY = "test-fake-key";
+        try {
+            const r = runDoctor();
+            const k = r.checks.find((c) => c.id === "openai-key");
+            expect(k.status).toBe("ok");
+            expect(k.severity).toBe("optional");
+            expect(k.fix).toBeUndefined();
+            expect(k.prompt).toBeUndefined();
+        }
+        finally {
+            if (prev === undefined)
+                delete process.env.OPENAI_API_KEY;
+            else
+                process.env.OPENAI_API_KEY = prev;
+        }
+    });
+    it("ANTHROPIC_API_KEY check is informational (never blocks)", () => {
+        const r = runDoctor();
+        const k = r.checks.find((c) => c.id === "anthropic-key");
+        expect(k.severity).toBe("info");
+    });
+    it("ffmpeg / ffprobe checks are required", () => {
+        const r = runDoctor();
+        const ff = r.checks.find((c) => c.id === "ffmpeg");
+        const fp = r.checks.find((c) => c.id === "ffprobe");
+        expect(ff.severity).toBe("required");
+        expect(fp.severity).toBe("required");
+    });
+    it("does not include host (resolve/premiere) checks — those live in the runtime UI", () => {
+        const r = runDoctor();
+        expect(r.checks.find((c) => c.id === "resolve")).toBeUndefined();
+        expect(r.checks.find((c) => c.id === "premiere")).toBeUndefined();
+    });
+});
+//# sourceMappingURL=doctor.test.js.map

package/dist/core/doctor.test.js.map

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

package/dist/core/ducking.d.ts

@@ -0,0 +1,37 @@
+export interface DuckingOptions {
+    /**
+     * Sidechain threshold (linear amplitude, 0-1). When the voice exceeds
+     * this, the compressor clamps the music. Default 0.02 — matches typical
+     * dialogue average energy. Real-world podcast implementations cluster at
+     * 0.012–0.03; below 0.02 even quiet voice triggers ducking, above 0.05
+     * quiet conversation won't duck the music at all.
+     */
+    threshold?: number;
+    /** Compression ratio. Default 8. */
+    ratio?: number;
+    /** Attack time in ms. Default 5. */
+    attackMs?: number;
+    /** Release time in ms. Default 250. */
+    releaseMs?: number;
+    /** Voice gain in linear amplitude. Default 1 (unchanged). */
+    voiceGain?: number;
+    /** Background gain (post-duck) in linear amplitude. Default 1. */
+    bgGain?: number;
+    signal?: AbortSignal;
+}
+export interface DuckingResult {
+    output: string;
+    filterGraph: string;
+}
+/**
+ * Render a voice + background mix with the background ducked underneath the
+ * voice. Both inputs may be audio or video files; the output is whatever
+ * extension you give it (PCM .wav for max quality, .m4a/.aac for size).
+ */
+export declare function duckAudio(voicePath: string, bgPath: string, outputPath: string, opts?: DuckingOptions): Promise<DuckingResult>;
+/**
+ * Pure builder for the sidechain filter graph. Exposed so tests can verify
+ * the chain without spawning ffmpeg.
+ */
+export declare function buildDuckingFilter(opts?: DuckingOptions): string;
+//# sourceMappingURL=ducking.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ducking.d.ts","sourceRoot":"","sources":["../../src/core/ducking.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,aAAa,CAAC,CAoBxB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,cAAmB,GAAG,MAAM,CAepE"}