@parlor/scaffold 0.0.0-stage → 0.1.0

package/dist/add/run.js

@@ -0,0 +1,167 @@
+import { indentLines } from "../edit/ops.js";
+import { projectFiles, templateFiles, writeFiles } from "../files.js";
+import { uncommittedChanges } from "../git.js";
+import { commandsFor, formatCommand } from "../package-manager.js";
+import { planAddons } from "./plan.js";
+import { commitStaging, discardStaging, generateInStaging, installDependencies, pendingInstallCommands, restoreManifests, snapshotManifests, stageProject, } from "./transaction.js";
+/**
+ * The one entry point behind `parlor add`. A transaction in stages, so a failure never leaves
+ * an app that cannot boot and a crash is finished by the next run (every step it already did
+ * is `done`):
+ *   1. plan (no writes); `blocked`, `done` and `dry-run` return here
+ *   2. git: `uncommittedChanges(rootDir)` non-empty and `gitCheck` -> `dirty`
+ *   3. install: snapshot `package.json` and the lockfile; round one adds every dependency whose
+ *      version is known (`<pm> add`), round two resolves each `FromPackage` from the manifest
+ *      round one installed and adds those; any failure restores the snapshot -> `failed`
+ *   4. stage: `stageProject` copies the tree (minus node_modules, .git, .parlor) into
+ *      `.parlor/add/<run id>/` and lays the planned writes over it
+ *   5. generate: each pending generation's tool runs in the staging dir; `generationDone`
+ *      against the staging copy must then hold, else the copy is discarded -> `failed`
+ *   6. commit: every staged file whose bytes differ from the project is written through a temp
+ *      file and a rename; the staging dir is removed
+ * `install: false` skips 3 and 5; `pending` then names the install commands and a second
+ * `parlor add` to generate.
+ */
+export async function addAddons(request) {
+    const { layout, addons, packageManager, log } = request;
+    const { rootDir } = layout;
+    const plan = await planAddons(layout, addons, projectFiles(rootDir), templateFiles());
+    if (plan.kind === "done")
+        return plan;
+    if (plan.kind === "blocked")
+        return { kind: "blocked", addons, manual: plan.manual };
+    if (request.mode === "dry-run")
+        return { kind: "planned", plan };
+    if (request.gitCheck) {
+        const files = await uncommittedChanges(rootDir);
+        if (files && files.length > 0)
+            return { kind: "dirty", addons, files };
+    }
+    if (!request.install) {
+        await writeFiles(rootDir, new Map(plan.writes.map((write) => [write.path, write.content])));
+        const pm = commandsFor(packageManager);
+        const rerun = plan.generate.length > 0 ||
+            plan.dependencies.some((dependency) => typeof dependency.version !== "string");
+        return {
+            kind: "applied",
+            plan,
+            generated: [],
+            pending: [
+                ...pendingInstallCommands(plan.dependencies, packageManager).map(formatCommand),
+                ...(rerun ? [pm.exec("parlor", ["add", ...addons])] : []),
+            ],
+        };
+    }
+    let snapshot;
+    if (plan.dependencies.length > 0) {
+        snapshot = await snapshotManifests(rootDir);
+        const installed = await installDependencies(rootDir, plan.dependencies, packageManager, projectFiles(rootDir), log);
+        if (!installed.ok) {
+            await restoreManifests(rootDir, snapshot);
+            return { kind: "failed", addons, stage: "install", message: installed.message };
+        }
+    }
+    const staging = await stageProject(rootDir, plan.writes);
+    if (plan.generate.length > 0) {
+        log(`generating ${plan.generate
+            .map((generation) => generation.kind === "route-tree"
+            ? "the route tree"
+            : `the migration "${generation.name}"`)
+            .join(", then ")}`);
+        const generated = await generateInStaging(layout, staging, plan.generate, request.tools);
+        if (!generated.ok) {
+            await discardStaging(staging);
+            if (snapshot)
+                await restoreManifests(rootDir, snapshot);
+            return { kind: "failed", addons, stage: "generate", message: generated.message };
+        }
+    }
+    const written = await commitStaging(rootDir, staging);
+    const planned = new Set(plan.writes.map((write) => write.path));
+    return {
+        kind: "applied",
+        plan,
+        generated: written.filter((path) => !planned.has(path)),
+        pending: [],
+    };
+}
+function planLines(plan, generated) {
+    const width = Math.max(0, ...plan.writes
+        .filter((write) => write.change === "update")
+        .map((write) => write.path.length));
+    return [
+        ...plan.writes
+            .filter((write) => write.change === "create")
+            .map((write) => `+ ${write.path}`),
+        ...plan.writes
+            .filter((write) => write.change === "update")
+            .map((write) => write.summary.length > 0
+            ? `~ ${write.path.padEnd(width)}  ${write.summary.join(", ")}`
+            : `~ ${write.path}`),
+        ...(generated.length > 0 ? [`~ ${generated.join(", ")}`] : []),
+    ];
+}
+/** The terminal text for a result and the exit code: 1 for `blocked`, `dirty` and `failed`, else 0. */
+export function formatAddResult(result, manager) {
+    const pm = commandsFor(manager);
+    const command = (addons) => `parlor add ${addons.join(" ")}`;
+    switch (result.kind) {
+        case "done":
+            return {
+                text: `${result.addons.join(", ")} ${result.addons.length === 1 ? "is" : "are"} already added. Nothing changed.`,
+                exitCode: 0,
+            };
+        case "blocked": {
+            const files = [...new Set(result.manual.map((change) => change.file))];
+            const rerun = pm.exec("parlor", ["add", ...result.addons]);
+            return {
+                text: [
+                    `${command(result.addons)}: cannot edit ${files.join(", ")} safely, so nothing was changed.`,
+                    ...result.manual.flatMap((change) => [
+                        "",
+                        `  ${change.file}: ${change.reason}`,
+                        `  Make this change by hand, then run \`${rerun}\` again:`,
+                        "",
+                        indentLines(change.change, "    "),
+                    ]),
+                ].join("\n"),
+                exitCode: 1,
+            };
+        }
+        case "dirty":
+            return {
+                text: `${command(result.addons)}: this project has uncommitted changes (${result.files.join(", ")}).\nCommit or stash them so the change is easy to review, or pass --no-git-check.`,
+                exitCode: 1,
+            };
+        case "failed":
+            return {
+                text: `${command(result.addons)}: ${result.message}\nNothing was changed.`,
+                exitCode: 1,
+            };
+        case "planned": {
+            const installs = result.plan.dependencies.map((dependency) => typeof dependency.version === "string"
+                ? `${dependency.name}@${dependency.version}`
+                : `${dependency.name} (pinned by ${dependency.version.fromPackage})`);
+            return {
+                text: [
+                    ...planLines(result.plan, []),
+                    ...(installs.length > 0 ? [`would install ${installs.join(", ")}`] : []),
+                    "Nothing was written (--dry-run).",
+                ].join("\n"),
+                exitCode: 0,
+            };
+        }
+        case "applied":
+            return {
+                text: [
+                    ...planLines(result.plan, result.generated),
+                    ...result.plan.notes,
+                    ...(result.pending.length > 0
+                        ? ["", "Run these to finish:", ...result.pending.map((line) => `  ${line}`)]
+                        : []),
+                ].join("\n"),
+                exitCode: 0,
+            };
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/add/run.js.map

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

package/dist/add/transaction.d.ts

@@ -0,0 +1,67 @@
+import { type Command, type InstallOutcome, type PackageManager } from "../package-manager.js";
+import type { Generation, ProjectLayout } from "./addon.js";
+import { type PlannedDependency, type PlannedWrite, type ProjectFiles } from "./plan.js";
+import type { AddTools } from "./run.js";
+/** Under `.parlor/`, which every project ignores, so a crash leaves nothing a commit would pick up. */
+export declare const STAGING_DIR = ".parlor/add";
+/** Never copied into a staging dir and never committed back from one. */
+export declare const NOT_STAGED: ReadonlySet<string>;
+/** `package.json` plus whichever lockfile the project has, as they were before the install. */
+export interface ManifestSnapshot {
+    readonly files: ReadonlyMap<string, Buffer | undefined>;
+}
+export declare const LOCKFILES: readonly ["pnpm-lock.yaml", "package-lock.json", "yarn.lock", "bun.lock", "bun.lockb"];
+export declare function snapshotManifests(rootDir: string): Promise<ManifestSnapshot>;
+/** Puts every snapshotted file back, deleting the ones that did not exist. */
+export declare function restoreManifests(rootDir: string, snapshot: ManifestSnapshot): Promise<void>;
+export type InstallResult = {
+    readonly ok: true;
+    readonly outcome: InstallOutcome;
+} | {
+    readonly ok: false;
+    readonly message: string;
+};
+/**
+ * Two rounds of `<pm> add`, because a `FromPackage` version is readable only once that package
+ * is in `node_modules`: round one adds every dependency with a known version, round two reads
+ * each `FromPackage` through `project.manifest` and adds those. A `listed` dependency with no
+ * known version is a plain `<pm> install`. Nothing here touches files other than the ones the
+ * package manager owns.
+ */
+export declare function installDependencies(rootDir: string, dependencies: readonly PlannedDependency[], manager: PackageManager, project: ProjectFiles, log: (line: string) => void): Promise<InstallResult>;
+/** The install commands `--no-install` left for the developer, in the order to run them. */
+export declare function pendingInstallCommands(dependencies: readonly PlannedDependency[], manager: PackageManager): readonly Command[];
+export interface Staging {
+    /** Absolute: `<rootDir>/.parlor/add/<run id>`. */
+    readonly dir: string;
+    /** A `ProjectFiles` over `dir`, for `generationDone` and the commit diff. */
+    readonly files: ProjectFiles;
+}
+/**
+ * Copies the project tree except `NOT_STAGED` into a fresh staging dir and lays `writes` over
+ * it. Module resolution from the staging dir walks up to the project's `node_modules`, so the
+ * generators run there unchanged.
+ */
+export declare function stageProject(rootDir: string, writes: readonly PlannedWrite[]): Promise<Staging>;
+export type GenerateResult = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly generation: Generation;
+    readonly message: string;
+};
+/**
+ * Runs each generation's tool in the staging dir, then checks `generationDone` there. A tool
+ * that throws, or whose declared outputs are not in the copy afterwards, fails the whole run
+ * before anything reaches the project.
+ */
+export declare function generateInStaging(layout: ProjectLayout, staging: Staging, generations: readonly Generation[], tools: AddTools): Promise<GenerateResult>;
+/**
+ * Every file in the staging dir whose bytes differ from the project's is written through
+ * `<path>.parlor-tmp` and a rename, then the staging dir is removed. Returns the project paths
+ * written. A crash between two renames leaves whole files, and the next run's plan finds each
+ * written step `done`.
+ */
+export declare function commitStaging(rootDir: string, staging: Staging): Promise<readonly string[]>;
+export declare function discardStaging(staging: Staging): Promise<void>;
+//# sourceMappingURL=transaction.d.ts.map

package/dist/add/transaction.d.ts.map

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

package/dist/add/transaction.js

@@ -0,0 +1,181 @@
+import { randomUUID } from "node:crypto";
+import { cp, mkdir, readdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { projectFiles } from "../files.js";
+import { commandsFor, formatCommand, runInstall, } from "../package-manager.js";
+import { generationDone, resolveFromPackage, } from "./plan.js";
+/** Under `.parlor/`, which every project ignores, so a crash leaves nothing a commit would pick up. */
+export const STAGING_DIR = ".parlor/add";
+/** Never copied into a staging dir and never committed back from one. */
+export const NOT_STAGED = new Set([
+    "node_modules",
+    ".git",
+    ".parlor",
+]);
+export const LOCKFILES = [
+    "pnpm-lock.yaml",
+    "package-lock.json",
+    "yarn.lock",
+    "bun.lock",
+    "bun.lockb",
+];
+export async function snapshotManifests(rootDir) {
+    const files = new Map();
+    for (const name of ["package.json", ...LOCKFILES]) {
+        files.set(name, await readFile(join(rootDir, name)).catch(() => undefined));
+    }
+    return { files };
+}
+/** Puts every snapshotted file back, deleting the ones that did not exist. */
+export async function restoreManifests(rootDir, snapshot) {
+    for (const [name, content] of snapshot.files) {
+        const path = join(rootDir, name);
+        if (content === undefined)
+            await rm(path, { force: true });
+        else
+            await writeFile(path, content);
+    }
+}
+/**
+ * Two rounds of `<pm> add`, because a `FromPackage` version is readable only once that package
+ * is in `node_modules`: round one adds every dependency with a known version, round two reads
+ * each `FromPackage` through `project.manifest` and adds those. A `listed` dependency with no
+ * known version is a plain `<pm> install`. Nothing here touches files other than the ones the
+ * package manager owns.
+ */
+export async function installDependencies(rootDir, dependencies, manager, project, log) {
+    const add = commandsFor(manager).add;
+    let outcome = { kind: "installed" };
+    const round = async (resolved) => {
+        for (const dev of [false, true]) {
+            const group = resolved.filter((dependency) => dependency.dev === dev);
+            if (group.length === 0)
+                continue;
+            const command = add(group.map((dependency) => `${dependency.name}@${dependency.version}`), { dev });
+            const result = await runInstall(rootDir, command, log);
+            if (result.kind === "failed") {
+                return {
+                    ok: false,
+                    message: `${formatCommand(command)} failed (exit ${result.exitCode}).`,
+                };
+            }
+            if (result.kind === "ignored-builds")
+                outcome = result;
+        }
+        return undefined;
+    };
+    const known = dependencies.filter((dependency) => typeof dependency.version === "string");
+    if (known.length > 0) {
+        log(`installing ${known.map((dependency) => `${dependency.name}@${dependency.version}`).join(", ")}`);
+        const failed = await round(known);
+        if (failed)
+            return failed;
+    }
+    const pinned = [];
+    for (const dependency of dependencies) {
+        if (typeof dependency.version === "string")
+            continue;
+        const version = await resolveFromPackage(dependency.version, project);
+        if (version === undefined) {
+            return {
+                ok: false,
+                message: `${dependency.version.fromPackage} does not declare ${dependency.version.dependency}`,
+            };
+        }
+        log(`installing ${dependency.name}@${version} (pinned by ${dependency.version.fromPackage})`);
+        pinned.push({ ...dependency, version });
+    }
+    const failed = await round(pinned);
+    return failed ?? { ok: true, outcome };
+}
+/** The install commands `--no-install` left for the developer, in the order to run them. */
+export function pendingInstallCommands(dependencies, manager) {
+    const add = commandsFor(manager).add;
+    return [false, true].flatMap((dev) => {
+        const group = dependencies.filter((dependency) => dependency.dev === dev && typeof dependency.version === "string");
+        return group.length === 0
+            ? []
+            : [
+                add(group.map((dependency) => `${dependency.name}@${String(dependency.version)}`), { dev }),
+            ];
+    });
+}
+/**
+ * Copies the project tree except `NOT_STAGED` into a fresh staging dir and lays `writes` over
+ * it. Module resolution from the staging dir walks up to the project's `node_modules`, so the
+ * generators run there unchanged.
+ */
+export async function stageProject(rootDir, writes) {
+    const dir = join(rootDir, STAGING_DIR, randomUUID());
+    await mkdir(dir, { recursive: true });
+    for (const entry of await readdir(rootDir)) {
+        if (NOT_STAGED.has(entry))
+            continue;
+        await cp(join(rootDir, entry), join(dir, entry), { recursive: true });
+    }
+    for (const write of writes) {
+        const target = join(dir, write.path);
+        await mkdir(dirname(target), { recursive: true });
+        await writeFile(target, write.content);
+    }
+    return { dir, files: projectFiles(dir) };
+}
+/**
+ * Runs each generation's tool in the staging dir, then checks `generationDone` there. A tool
+ * that throws, or whose declared outputs are not in the copy afterwards, fails the whole run
+ * before anything reaches the project.
+ */
+export async function generateInStaging(layout, staging, generations, tools) {
+    for (const generation of generations) {
+        const tool = generation.kind === "route-tree" ? "parlor typegen" : "parlor db generate";
+        try {
+            if (generation.kind === "route-tree")
+                await tools.routeTree(staging.dir);
+            else
+                await tools.migration(staging.dir, generation.name);
+        }
+        catch (error) {
+            return {
+                ok: false,
+                generation,
+                message: `${tool} failed: ${error.message}`,
+            };
+        }
+        if (!(await generationDone({ ...layout, rootDir: staging.dir }, generation, staging.files))) {
+            return {
+                ok: false,
+                generation,
+                message: generation.kind === "route-tree"
+                    ? `${tool} wrote no route ${generation.routes.join(", ")}`
+                    : `${tool} wrote no migration with tables ${generation.tables.join(", ")}`,
+            };
+        }
+    }
+    return { ok: true };
+}
+/**
+ * Every file in the staging dir whose bytes differ from the project's is written through
+ * `<path>.parlor-tmp` and a rename, then the staging dir is removed. Returns the project paths
+ * written. A crash between two renames leaves whole files, and the next run's plan finds each
+ * written step `done`.
+ */
+export async function commitStaging(rootDir, staging) {
+    const written = [];
+    for (const path of await staging.files.list("")) {
+        const staged = await readFile(join(staging.dir, path));
+        const current = await readFile(join(rootDir, path)).catch(() => undefined);
+        if (current?.equals(staged))
+            continue;
+        const target = join(rootDir, path);
+        await mkdir(dirname(target), { recursive: true });
+        await writeFile(`${target}.parlor-tmp`, staged);
+        await rename(`${target}.parlor-tmp`, target);
+        written.push(path);
+    }
+    await discardStaging(staging);
+    return written;
+}
+export async function discardStaging(staging) {
+    await rm(staging.dir, { recursive: true, force: true });
+}
+//# sourceMappingURL=transaction.js.map

package/dist/add/transaction.js.map

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

package/dist/addons/agent.d.ts

@@ -0,0 +1,61 @@
+import { SERVER_ENTRY } from "../add/addon.js";
+/**
+ * The default template already contains all of this; a test runs this add-on on it and expects
+ * no change, which is what keeps the two from drifting.
+ */
+export declare const agent: {
+    readonly summary: "The agent sidebar: chat with your own coding agent inside the app.";
+    readonly requires: {
+        readonly routesDir: "src/routes";
+    };
+    readonly dependencies: {
+        readonly "@parlor/chat": "framework";
+    };
+    readonly files: readonly [{
+        readonly template: "default";
+        readonly dir: "src/agent";
+    }];
+    readonly edits: readonly [{
+        readonly file: typeof SERVER_ENTRY;
+        readonly ops: readonly [{
+            readonly kind: "import";
+            readonly names: readonly ["chat"];
+            readonly from: "@parlor/chat/server";
+        }, {
+            readonly kind: "append-element";
+            readonly call: {
+                readonly callee: "createServer";
+                readonly from: "@parlor/server";
+            };
+            readonly path: readonly ["plugins"];
+            readonly element: "chat()";
+        }];
+    }, {
+        readonly file: "src/routes/__root.tsx";
+        readonly ops: readonly [{
+            readonly kind: "import";
+            readonly names: readonly ["agentPanel"];
+            readonly from: "../agent/views.js";
+        }, {
+            readonly kind: "append-element";
+            readonly call: {
+                readonly callee: "createRootRoute";
+                readonly from: "@tanstack/react-router";
+            };
+            readonly path: readonly ["staticData", "views"];
+            readonly element: "agentPanel";
+        }];
+    }];
+    readonly mounts: readonly [{
+        readonly component: "AgentButton";
+        readonly module: "src/agent/agent-button.tsx";
+        readonly into: {
+            readonly file: "src/header-actions.tsx";
+            readonly parent: "HeaderActions";
+        };
+    }];
+    readonly env: readonly [];
+    readonly generate: readonly [];
+    readonly notes: readonly ["Restart the dev server. Open the Agent button to chat with the coding agents on this computer."];
+};
+//# sourceMappingURL=agent.d.ts.map

package/dist/addons/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/addons/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2ChB,CAAC"}

package/dist/addons/agent.js

@@ -0,0 +1,50 @@
+import { defineAddon, SERVER_ENTRY } from "../add/addon.js";
+/**
+ * The default template already contains all of this; a test runs this add-on on it and expects
+ * no change, which is what keeps the two from drifting.
+ */
+export const agent = defineAddon({
+    summary: "The agent sidebar: chat with your own coding agent inside the app.",
+    requires: { routesDir: "src/routes" },
+    dependencies: { "@parlor/chat": "framework" },
+    files: [{ template: "default", dir: "src/agent" }],
+    edits: [
+        {
+            file: SERVER_ENTRY,
+            ops: [
+                { kind: "import", names: ["chat"], from: "@parlor/chat/server" },
+                {
+                    kind: "append-element",
+                    call: { callee: "createServer", from: "@parlor/server" },
+                    path: ["plugins"],
+                    element: "chat()",
+                },
+            ],
+        },
+        {
+            file: "src/routes/__root.tsx",
+            ops: [
+                { kind: "import", names: ["agentPanel"], from: "../agent/views.js" },
+                {
+                    kind: "append-element",
+                    call: { callee: "createRootRoute", from: "@tanstack/react-router" },
+                    path: ["staticData", "views"],
+                    element: "agentPanel",
+                },
+            ],
+        },
+    ],
+    mounts: [
+        {
+            component: "AgentButton",
+            module: "src/agent/agent-button.tsx",
+            into: { file: "src/header-actions.tsx", parent: "HeaderActions" },
+        },
+    ],
+    env: [],
+    generate: [],
+    notes: [
+        "Restart the dev server. Open the Agent button to chat with the coding agents on this computer.",
+    ],
+});
+//# sourceMappingURL=agent.js.map

package/dist/addons/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/addons/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE5D;;;GAGG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,WAAW,CAAC;IAC/B,OAAO,EAAE,oEAAoE;IAC7E,QAAQ,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE;IACrC,YAAY,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE;IAC7C,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC;IAClD,KAAK,EAAE;QACL;YACE,IAAI,EAAE,YAAY;YAClB,GAAG,EAAE;gBACH,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE;gBAChE;oBACE,IAAI,EAAE,gBAAgB;oBACtB,IAAI,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,gBAAgB,EAAE;oBACxD,IAAI,EAAE,CAAC,SAAS,CAAC;oBACjB,OAAO,EAAE,QAAQ;iBAClB;aACF;SACF;QACD;YACE,IAAI,EAAE,uBAAuB;YAC7B,GAAG,EAAE;gBACH,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE;gBACpE;oBACE,IAAI,EAAE,gBAAgB;oBACtB,IAAI,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,wBAAwB,EAAE;oBACnE,IAAI,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC;oBAC7B,OAAO,EAAE,YAAY;iBACtB;aACF;SACF;KACF;IACD,MAAM,EAAE;QACN;YACE,SAAS,EAAE,aAAa;YACxB,MAAM,EAAE,4BAA4B;YACpC,IAAI,EAAE,EAAE,IAAI,EAAE,wBAAwB,EAAE,MAAM,EAAE,eAAe,EAAE;SAClE;KACF;IACD,GAAG,EAAE,EAAE;IACP,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE;QACL,gGAAgG;KACjG;CACF,CAAC,CAAC"}