@bluewombat/integrator 0.1.0

package/dist/args/parse-args.js

@@ -0,0 +1,222 @@
+import { existsSync, statSync } from "node:fs";
+import { isAbsolute, relative, resolve } from "node:path";
+const INTEGRATOR_FLAGS = new Set([
+    "--id",
+    "--parent",
+    "--child",
+    "--duration-ms",
+    "--on-status",
+    "--strategy",
+]);
+function isIntegratorFlag(token) {
+    return INTEGRATOR_FLAGS.has(token);
+}
+function takeValue(argv, index) {
+    const value = argv[index + 1];
+    if (value === undefined || value.startsWith("--")) {
+        return null;
+    }
+    return { value, next: index + 2 };
+}
+function takeCommandArgv(argv, start) {
+    if (argv[start] !== "--") {
+        return null;
+    }
+    const command = [];
+    let i = start + 1;
+    while (i < argv.length) {
+        const token = argv[i];
+        if (token !== undefined && isIntegratorFlag(token)) {
+            break;
+        }
+        if (token !== undefined) {
+            command.push(token);
+        }
+        i += 1;
+    }
+    if (command.length === 0) {
+        return null;
+    }
+    return { command, next: i };
+}
+function parsePositiveInt(raw) {
+    if (!/^\d+$/.test(raw)) {
+        return null;
+    }
+    const value = Number(raw);
+    if (!Number.isSafeInteger(value) || value < 1) {
+        return null;
+    }
+    return value;
+}
+function isDirectory(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function pathsOverlap(parent, child) {
+    const parentResolved = resolve(parent);
+    const childResolved = resolve(child);
+    if (parentResolved === childResolved) {
+        return true;
+    }
+    const fromParent = relative(parentResolved, childResolved);
+    const fromChild = relative(childResolved, parentResolved);
+    const childInsideParent = fromParent !== "" && !fromParent.startsWith("..") && !isAbsolute(fromParent);
+    const parentInsideChild = fromChild !== "" && !fromChild.startsWith("..") && !isAbsolute(fromChild);
+    return childInsideParent || parentInsideChild;
+}
+function snapshotPartial(id, onStatusArgv) {
+    const partial = {};
+    if (id !== undefined && id.length > 0) {
+        partial.id = id;
+    }
+    if (onStatusArgv !== undefined) {
+        partial.onStatusArgv = onStatusArgv;
+    }
+    return partial;
+}
+function withPartial(reason, id, onStatusArgv) {
+    const failure = { ok: false, reason };
+    const partial = snapshotPartial(id, onStatusArgv);
+    if (partial.id !== undefined) {
+        failure.id = partial.id;
+    }
+    if (partial.onStatusArgv !== undefined) {
+        failure.onStatusArgv = partial.onStatusArgv;
+    }
+    return failure;
+}
+/**
+ * Parse Integrator CLI argv (without node/script). Malformed input → not ok.
+ */
+export function parseArgs(argv) {
+    let id;
+    let parent;
+    let child;
+    let durationMs;
+    let strategy;
+    let onStatusArgv;
+    let i = 0;
+    while (i < argv.length) {
+        const token = argv[i];
+        if (token === undefined) {
+            break;
+        }
+        if (token === "--id") {
+            const taken = takeValue(argv, i);
+            if (!taken) {
+                return withPartial("Missing value for --id.", id, onStatusArgv);
+            }
+            id = taken.value;
+            i = taken.next;
+            continue;
+        }
+        if (token === "--parent") {
+            const taken = takeValue(argv, i);
+            if (!taken) {
+                return withPartial("Missing value for --parent.", id, onStatusArgv);
+            }
+            parent = taken.value;
+            i = taken.next;
+            continue;
+        }
+        if (token === "--child") {
+            const taken = takeValue(argv, i);
+            if (!taken) {
+                return withPartial("Missing value for --child.", id, onStatusArgv);
+            }
+            child = taken.value;
+            i = taken.next;
+            continue;
+        }
+        if (token === "--duration-ms") {
+            const taken = takeValue(argv, i);
+            if (!taken) {
+                return withPartial("Missing value for --duration-ms.", id, onStatusArgv);
+            }
+            const value = parsePositiveInt(taken.value);
+            if (value === null) {
+                return withPartial("--duration-ms must be a positive integer.", id, onStatusArgv);
+            }
+            durationMs = value;
+            i = taken.next;
+            continue;
+        }
+        if (token === "--strategy") {
+            const taken = takeValue(argv, i);
+            if (!taken) {
+                return withPartial("Missing value for --strategy.", id, onStatusArgv);
+            }
+            if (taken.value.length === 0) {
+                return withPartial("--strategy must be a non-empty package name or path.", id, onStatusArgv);
+            }
+            strategy = taken.value;
+            i = taken.next;
+            continue;
+        }
+        if (token === "--on-status") {
+            const command = takeCommandArgv(argv, i + 1);
+            if (!command) {
+                return withPartial("Missing non-empty command after --on-status --.", id, onStatusArgv);
+            }
+            onStatusArgv = command.command;
+            i = command.next;
+            continue;
+        }
+        return withPartial(`Unknown argument "${token}".`, id, onStatusArgv);
+    }
+    if (id === undefined) {
+        return withPartial("Missing required --id.", id, onStatusArgv);
+    }
+    if (id.length === 0) {
+        return withPartial("--id must be non-empty.", undefined, onStatusArgv);
+    }
+    if (parent === undefined) {
+        return withPartial("Missing required --parent.", id, onStatusArgv);
+    }
+    if (child === undefined) {
+        return withPartial("Missing required --child.", id, onStatusArgv);
+    }
+    if (durationMs === undefined) {
+        return withPartial("Missing required --duration-ms.", id, onStatusArgv);
+    }
+    if (strategy === undefined) {
+        return withPartial("Missing required --strategy. Pass a package name or path that exports strategy.", id, onStatusArgv);
+    }
+    if (!isAbsolute(parent)) {
+        return withPartial("--parent must be an absolute path.", id, onStatusArgv);
+    }
+    if (!isAbsolute(child)) {
+        return withPartial("--child must be an absolute path.", id, onStatusArgv);
+    }
+    if (!existsSync(parent)) {
+        return withPartial(`--parent does not exist: ${parent}`, id, onStatusArgv);
+    }
+    if (!isDirectory(parent)) {
+        return withPartial(`--parent is not a directory: ${parent}`, id, onStatusArgv);
+    }
+    if (!existsSync(child)) {
+        return withPartial(`--child does not exist: ${child}`, id, onStatusArgv);
+    }
+    if (!isDirectory(child)) {
+        return withPartial(`--child is not a directory: ${child}`, id, onStatusArgv);
+    }
+    if (pathsOverlap(parent, child)) {
+        return withPartial("--parent and --child must not be the same path, and neither may be a prefix of the other.", id, onStatusArgv);
+    }
+    const invocation = {
+        id,
+        parent: resolve(parent),
+        child: resolve(child),
+        durationMs,
+    };
+    if (onStatusArgv !== undefined) {
+        invocation.onStatusArgv = onStatusArgv;
+    }
+    return { ok: true, invocation, strategy };
+}
+//# sourceMappingURL=parse-args.js.map

package/dist/args/parse-args.js.map

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

package/dist/child/run-child.d.ts

@@ -0,0 +1,41 @@
+import type { ClockName } from "../types.js";
+export type SpawnRequest = {
+    argv: string[];
+    /** Undefined lets the child inherit the caller's directory. */
+    cwd?: string | undefined;
+    /** Wall-clock budget for this child (ms). */
+    timeoutMs: number;
+    /** Which clock owns the nearer deadline when timeoutMs hits. */
+    timeoutClock: ClockName;
+    /** When true, treat kill as interrupted (stop signal). */
+    shouldInterrupt: () => boolean;
+    /** Undefined lets the child inherit the caller's environment. */
+    env?: NodeJS.ProcessEnv | undefined;
+    /** Layered on top of the inherited environment. Ignored when `env` is set. */
+    envOverrides?: NodeJS.ProcessEnv | undefined;
+};
+export type SpawnOutcome = {
+    kind: "exited";
+    exitCode: number | null;
+    signal: NodeJS.Signals | null;
+    stdout: string;
+    stderr: string;
+} | {
+    kind: "timed_out";
+    clock: ClockName;
+    stdout: string;
+    stderr: string;
+} | {
+    kind: "interrupted";
+    stdout: string;
+    stderr: string;
+} | {
+    kind: "spawn_error";
+    detail: string;
+};
+/**
+ * Run one child with a wall-clock timeout. Does not inherit Integrator stdin.
+ */
+export declare function runChild(request: SpawnRequest): Promise<SpawnOutcome>;
+export declare function combinedOutput(stdout: string, stderr: string): string;
+//# sourceMappingURL=run-child.d.ts.map

package/dist/child/run-child.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-child.d.ts","sourceRoot":"","sources":["../../src/child/run-child.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAK7C,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,YAAY,EAAE,SAAS,CAAC;IACxB,0DAA0D;IAC1D,eAAe,EAAE,MAAM,OAAO,CAAC;IAC/B,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;IACpC,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;CAC9C,CAAC;AAgBF,MAAM,MAAM,YAAY,GACpB;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAiBN;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAsHrE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGrE"}

package/dist/child/run-child.js

@@ -0,0 +1,145 @@
+import { spawn } from "node:child_process";
+const OUTPUT_TRUNCATE = 8_192;
+const OUTPUT_LIMIT_CHARS = 8 * 1024 * 1024;
+/**
+ * The one place ambient environment enters a child. `env` replaces it outright;
+ * `envOverrides` layers on top of what the child would inherit anyway.
+ */
+function childEnv(request) {
+    if (request.env !== undefined) {
+        return request.env;
+    }
+    if (request.envOverrides !== undefined) {
+        return { ...process.env, ...request.envOverrides };
+    }
+    return undefined;
+}
+function truncate(text) {
+    if (text.length <= OUTPUT_TRUNCATE) {
+        return text;
+    }
+    return `${text.slice(0, OUTPUT_TRUNCATE)}…[truncated]`;
+}
+function killProcessTree(child) {
+    try {
+        child.kill("SIGKILL");
+    }
+    catch {
+        // already gone
+    }
+}
+/**
+ * Run one child with a wall-clock timeout. Does not inherit Integrator stdin.
+ */
+export function runChild(request) {
+    return new Promise((resolve) => {
+        const [file, ...args] = request.argv;
+        if (file === undefined) {
+            resolve({ kind: "spawn_error", detail: "Empty command." });
+            return;
+        }
+        let settled = false;
+        let timedOut = false;
+        let interrupted = false;
+        let stdout = "";
+        let stderr = "";
+        let timer;
+        let interruptPoll;
+        const finish = (outcome) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            if (timer !== undefined) {
+                clearTimeout(timer);
+            }
+            if (interruptPoll !== undefined) {
+                clearInterval(interruptPoll);
+            }
+            resolve(outcome);
+        };
+        let child;
+        try {
+            child = spawn(file, args, {
+                cwd: request.cwd,
+                env: childEnv(request),
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+        }
+        catch (error) {
+            const detail = error instanceof Error ? error.message : String(error);
+            finish({ kind: "spawn_error", detail });
+            return;
+        }
+        if (!child.stdout || !child.stderr) {
+            finish({ kind: "spawn_error", detail: "Child stdout/stderr pipes unavailable." });
+            return;
+        }
+        child.stdout.setEncoding("utf8");
+        child.stderr.setEncoding("utf8");
+        let overflowed = false;
+        const take = (chunk) => {
+            if (overflowed) {
+                return false;
+            }
+            if (stdout.length + stderr.length + chunk.length > OUTPUT_LIMIT_CHARS) {
+                overflowed = true;
+                killProcessTree(child);
+                return false;
+            }
+            return true;
+        };
+        child.stdout.on("data", (chunk) => {
+            if (take(chunk)) {
+                stdout += chunk;
+            }
+        });
+        child.stderr.on("data", (chunk) => {
+            if (take(chunk)) {
+                stderr += chunk;
+            }
+        });
+        child.on("error", (error) => {
+            finish({ kind: "spawn_error", detail: error.message });
+        });
+        timer = setTimeout(() => {
+            timedOut = true;
+            killProcessTree(child);
+        }, Math.max(1, request.timeoutMs));
+        interruptPoll = setInterval(() => {
+            if (request.shouldInterrupt()) {
+                interrupted = true;
+                killProcessTree(child);
+            }
+        }, 20);
+        if (request.shouldInterrupt()) {
+            interrupted = true;
+            killProcessTree(child);
+        }
+        child.on("close", (exitCode, signal) => {
+            const out = truncate(stdout);
+            const err = truncate(stderr);
+            if (overflowed) {
+                finish({
+                    kind: "spawn_error",
+                    detail: `Child wrote more than ${OUTPUT_LIMIT_CHARS} characters; its answer cannot be read.`,
+                });
+                return;
+            }
+            if (interrupted || request.shouldInterrupt()) {
+                finish({ kind: "interrupted", stdout: out, stderr: err });
+                return;
+            }
+            if (timedOut) {
+                finish({ kind: "timed_out", clock: request.timeoutClock, stdout: out, stderr: err });
+                return;
+            }
+            finish({ kind: "exited", exitCode, signal, stdout: out, stderr: err });
+        });
+    });
+}
+export function combinedOutput(stdout, stderr) {
+    const parts = [stdout, stderr].filter((p) => p.length > 0);
+    return truncate(parts.join("\n"));
+}
+//# sourceMappingURL=run-child.js.map

package/dist/child/run-child.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,99 @@
+#!/usr/bin/env node
+import { existsSync } from "node:fs";
+import { isAbsolute, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { parseArgs } from "./args/parse-args.js";
+import { createStdoutProgressWriter } from "./progress/emit.js";
+import { invalidInvocationResult, runIntegrator } from "./run/run-integrator.js";
+/**
+ * Process signals belong to the binary, not to the Transformer: a Transformer imported into
+ * a host must not hijack the host's SIGINT. The CLI owns the flag it passes in.
+ */
+function installSignalHandlers(state) {
+    const onSignal = () => {
+        state.interrupted = true;
+    };
+    process.on("SIGINT", onSignal);
+    process.on("SIGTERM", onSignal);
+    return () => {
+        process.off("SIGINT", onSignal);
+        process.off("SIGTERM", onSignal);
+    };
+}
+/**
+ * Load an isolation strategy package. Same contract Host uses: export `strategy`.
+ */
+async function loadStrategy(specifier) {
+    let url = specifier;
+    if (specifier.startsWith(".") || isAbsolute(specifier)) {
+        const path = resolve(process.cwd(), specifier);
+        if (!existsSync(path)) {
+            return { ok: false, reason: `Strategy "${specifier}" is not a file: ${path}` };
+        }
+        url = pathToFileURL(path).href;
+    }
+    let loaded;
+    try {
+        loaded = await import(url);
+    }
+    catch (error) {
+        return {
+            ok: false,
+            reason: `Strategy "${specifier}" could not be loaded: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+    const strategy = loaded.strategy;
+    if (strategy === null ||
+        typeof strategy !== "object" ||
+        typeof strategy.fold !== "object" ||
+        strategy === undefined) {
+        return {
+            ok: false,
+            reason: `Strategy "${specifier}" does not export strategy with a fold backend.`,
+        };
+    }
+    return { ok: true, fold: strategy.fold };
+}
+async function main(argv) {
+    const write = createStdoutProgressWriter();
+    const parsed = parseArgs(argv);
+    if (!parsed.ok) {
+        const result = await invalidInvocationResult({
+            cwd: process.cwd(),
+            id: parsed.id,
+            onStatusArgv: parsed.onStatusArgv,
+            write,
+            reason: parsed.reason,
+        });
+        return result.exitCode;
+    }
+    const loaded = await loadStrategy(parsed.strategy);
+    if (!loaded.ok) {
+        const result = await invalidInvocationResult({
+            cwd: process.cwd(),
+            id: parsed.invocation.id,
+            onStatusArgv: parsed.invocation.onStatusArgv,
+            write,
+            reason: loaded.reason,
+        });
+        return result.exitCode;
+    }
+    const interruptFlag = { interrupted: false };
+    const detachSignals = installSignalHandlers(interruptFlag);
+    try {
+        const result = await runIntegrator({
+            invocation: parsed.invocation,
+            backend: loaded.fold,
+            write,
+            interruptFlag,
+            cwd: process.cwd(),
+        });
+        return result.exitCode;
+    }
+    finally {
+        detachSignals();
+    }
+}
+const exitCode = await main(process.argv.slice(2));
+process.exitCode = exitCode;
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/fold/backend.d.ts

@@ -0,0 +1,32 @@
+import type { FoldStop } from "./working-files.js";
+export type FoldBackendResult = {
+    ok: true;
+} | {
+    ok: false;
+    stop: FoldStop;
+} | {
+    ok: false;
+    conflict: true;
+    report: string;
+} | {
+    ok: false;
+    detail: string;
+};
+/**
+ * How Integrator folds the Child into the Parent. The caller injects one;
+ * Integrator does not choose a strategy or know git versus copy.
+ */
+export type FoldBackend = {
+    fold(input: {
+        parent: string;
+        child: string;
+        id?: string;
+        subject?: string;
+        mergeSubject?: string;
+        deadlineMs: number;
+        now: () => number;
+        shouldInterrupt: () => boolean;
+        shouldStop: () => FoldStop | undefined;
+    }): Promise<FoldBackendResult>;
+};
+//# sourceMappingURL=backend.d.ts.map

package/dist/fold/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/fold/backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,MAAM,iBAAiB,GACzB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC7B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,CAAC,KAAK,EAAE;QACV,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,GAAG,EAAE,MAAM,MAAM,CAAC;QAClB,eAAe,EAAE,MAAM,OAAO,CAAC;QAC/B,UAAU,EAAE,MAAM,QAAQ,GAAG,SAAS,CAAC;KACxC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAChC,CAAC"}

package/dist/fold/backend.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=backend.js.map

package/dist/fold/backend.js.map

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

package/dist/fold/fold.d.ts

@@ -0,0 +1,32 @@
+import type { FoldBackend } from "./backend.js";
+import { type FoldStop } from "./working-files.js";
+export type FoldResult = {
+    ok: true;
+} | {
+    ok: false;
+    stop: FoldStop;
+} | {
+    ok: false;
+    conflict: true;
+    report: string;
+} | {
+    ok: false;
+    detail: string;
+};
+/**
+ * Fold Child working files into Parent through the injected backend.
+ * Parent is restored unless the fold completes.
+ */
+export declare function fold(input: {
+    parent: string;
+    child: string;
+    backend: FoldBackend;
+    /** Names this Integration in what it writes. */
+    id?: string;
+    subject?: string;
+    mergeSubject?: string;
+    deadlineMs: number;
+    now: () => number;
+    shouldInterrupt: () => boolean;
+}): Promise<FoldResult>;
+//# sourceMappingURL=fold.d.ts.map

package/dist/fold/fold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fold.d.ts","sourceRoot":"","sources":["../../src/fold/fold.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EACL,KAAK,QAAQ,EAId,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,UAAU,GAClB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC7B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC;;;GAGG;AACH,wBAAsB,IAAI,CAAC,KAAK,EAAE;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,gDAAgD;IAChD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,OAAO,CAAC;CAChC,GAAG,OAAO,CAAC,UAAU,CAAC,CA8CtB"}