@tscomfy/cli 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 the tscomfy authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,23 @@
-# Temporary Holding Version
+# @tscomfy/cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The `tscomfy` command: generates TypeScript types from a ComfyUI server's `/object_info`, checks
+them for drift, and transpiles API prompts and UI workflows to typed code. It only sends
+`GET` requests; it never queues anything. Runs on Node 24 or later and Bun 1.4 or later.
+
+```sh
+npm install @tscomfy/core
+npm install --save-dev @tscomfy/cli
+
+npx tscomfy generate --url http://127.0.0.1:8188 --out src/comfy/local
+npx tscomfy check --url http://127.0.0.1:8188 --out src/comfy/local
+npx tscomfy transpile --workflow my-workflow.json --schema src/comfy/local --out src/my-workflow.ts
+```
+
+`generate` writes `nodes.ts` (the types), `index.ts` (the typed schema), the raw
+`object_info.json` and a `tscomfy.json` manifest. `tscomfy --help` and
+`tscomfy help <command>` list every option. See the [guides](https://github.com/TheeKia/tscomfy/tree/main/docs/guides), starting with
+[getting started](https://github.com/TheeKia/tscomfy/tree/main/docs/guides/getting-started.md).
+
+## License
+
+MIT

package/dist/args.d.ts

@@ -0,0 +1,24 @@
+/** One flag a command accepts: `--name value`, `--name=value`, or a boolean `--name`. */
+export interface FlagSpec {
+    readonly name: string;
+    readonly takesValue: boolean;
+    /** A one-letter alias of a boolean flag: `h` for `-h`. */
+    readonly short?: string;
+}
+/** Parsed flags: the value of each given flag, `true` for a boolean one. */
+export type Flags = ReadonlyMap<string, string | true>;
+/** `-h, --help`, which every command takes. */
+export declare const HELP: FlagSpec;
+/**
+ * Parses the arguments after the command name. Throws a usage {@link CliError} (exit 2).
+ *
+ * A value given apart (`--out dir`) can't start with `-`, so a forgotten value isn't read from
+ * the next flag (`--out --from x`); `--out=-dir` gives such a value. Every value is recorded in
+ * a regenerate command, which can't keep control characters, so none may have one.
+ */
+export declare function parseFlags(args: readonly string[], specs: readonly FlagSpec[]): Flags;
+/** A flag's value, if given. */
+export declare function value(flags: Flags, name: string): string | undefined;
+/** A flag's value, which must be given. */
+export declare function required(flags: Flags, name: string): string;
+//# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAEA,yFAAyF;AACzF,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,4EAA4E;AAC5E,MAAM,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;AAEvD,+CAA+C;AAC/C,eAAO,MAAM,IAAI,EAAE,QAA0D,CAAC;AAE9E;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,KAAK,CAyCrF;AAED,gCAAgC;AAChC,wBAAgB,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGpE;AAED,2CAA2C;AAC3C,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI3D"}

package/dist/args.js

@@ -0,0 +1,66 @@
+import { CliError } from "./io.js";
+/** `-h, --help`, which every command takes. */
+export const HELP = { name: "help", takesValue: false, short: "h" };
+/**
+ * Parses the arguments after the command name. Throws a usage {@link CliError} (exit 2).
+ *
+ * A value given apart (`--out dir`) can't start with `-`, so a forgotten value isn't read from
+ * the next flag (`--out --from x`); `--out=-dir` gives such a value. Every value is recorded in
+ * a regenerate command, which can't keep control characters, so none may have one.
+ */
+export function parseFlags(args, specs) {
+    const flags = new Map();
+    for (let index = 0; index < args.length; index++) {
+        const arg = args[index] ?? "";
+        const short = /^-([A-Za-z])$/.exec(arg)?.[1];
+        if (short !== undefined) {
+            const spec = specs.find((each) => each.short === short);
+            if (spec === undefined)
+                throw new CliError(`Unknown option -${short}.`, 2);
+            if (flags.has(spec.name))
+                throw new CliError(`--${spec.name} is given twice.`, 2);
+            flags.set(spec.name, true);
+            continue;
+        }
+        if (!arg.startsWith("--"))
+            throw new CliError(`Unexpected argument ${JSON.stringify(arg)}.`, 2);
+        const equals = arg.indexOf("=");
+        const name = arg.slice(2, equals === -1 ? undefined : equals);
+        const spec = specs.find((each) => each.name === name);
+        if (spec === undefined)
+            throw new CliError(`Unknown option --${name}.`, 2);
+        if (flags.has(name))
+            throw new CliError(`--${name} is given twice.`, 2);
+        if (!spec.takesValue) {
+            if (equals !== -1)
+                throw new CliError(`--${name} takes no value.`, 2);
+            flags.set(name, true);
+            continue;
+        }
+        const given = equals === -1 ? args[++index] : arg.slice(equals + 1);
+        if (given === undefined || given === "")
+            throw new CliError(`--${name} needs a value.`, 2);
+        if (equals === -1 && given.startsWith("-")) {
+            throw new CliError(`--${name} needs a value; for one that starts with -, write --${name}=<value>.`, 2);
+        }
+        // oxlint-disable-next-line no-control-regex -- control characters are what this looks for
+        if (/[\u0000-\u001f\u007f]/.test(given)) {
+            throw new CliError(`--${name} has a control character, which a regenerate command can't keep.`, 2);
+        }
+        flags.set(name, given);
+    }
+    return flags;
+}
+/** A flag's value, if given. */
+export function value(flags, name) {
+    const given = flags.get(name);
+    return typeof given === "string" ? given : undefined;
+}
+/** A flag's value, which must be given. */
+export function required(flags, name) {
+    const given = value(flags, name);
+    if (given === undefined)
+        throw new CliError(`--${name} is required.`, 2);
+    return given;
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

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

package/dist/check.d.ts

@@ -0,0 +1,6 @@
+import type { Io } from "./io.ts";
+/** `tscomfy check --help`. */
+export declare const CHECK_USAGE: string;
+/** `tscomfy check`. */
+export declare function checkCommand(io: Io, args: readonly string[]): Promise<number>;
+//# sourceMappingURL=check.d.ts.map

package/dist/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../src/check.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAKlC,8BAA8B;AAC9B,eAAO,MAAM,WAAW,EAAE,MAazB,CAAC;AAmBF,uBAAuB;AACvB,wBAAsB,YAAY,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAqEnF"}

package/dist/check.js

@@ -0,0 +1,185 @@
+import { join } from "node:path";
+import { CODEGEN_VERSION } from "@tscomfy/codegen";
+import { diffSchemas, hashSchema, } from "@tscomfy/core";
+import { HELP, parseFlags, required } from "./args.js";
+import { regenerateCommand } from "./generate.js";
+import { contentHash, FILES, MANIFEST, readGenerated, SNAPSHOT } from "./manifest.js";
+import { count } from "./report.js";
+import { loadSchema, readSource } from "./source.js";
+/** `tscomfy check --help`. */
+export const CHECK_USAGE = `Usage: tscomfy check (--url <server> | --from <object_info.json>) --out <dir>
+
+Compares the server's node definitions with the snapshot in <dir>/${SNAPSHOT}, and checks
+that the files in <dir> are exactly what \`tscomfy generate\` wrote (<dir>/${MANIFEST}). Exits
+with 1 when anything differs, so it can guard a build. New files in upload and remote combos
+(an uploaded image) are runtime state, not drift.
+
+Options:
+  --url <server>   A ComfyUI server, e.g. http://127.0.0.1:8188. Only GET requests.
+  --from <file>    A saved /object_info response instead of a server.
+  --out <dir>      The directory \`tscomfy generate\` wrote.
+  --verbose        List every changed node, input and combo option, rather than the first few.
+  -h, --help       Show this help.
+`;
+const FLAGS = [
+    { name: "url", takesValue: true },
+    { name: "from", takesValue: true },
+    { name: "out", takesValue: true },
+    { name: "verbose", takesValue: false },
+    HELP,
+];
+/** How many node and input names a list shows before the rest are counted, unless verbose. */
+const SHOWN_NAMES = 10;
+/** How many combo options a change lists before the rest are counted, unless verbose. */
+const SHOWN_OPTIONS = 5;
+/** What follows a count of entries left out. */
+const MORE = " (--verbose shows all)";
+/** `tscomfy check`. */
+export async function checkCommand(io, args) {
+    const flags = parseFlags(args, FLAGS);
+    if (flags.has("help")) {
+        io.out(CHECK_USAGE);
+        return 0;
+    }
+    const out = required(flags, "out");
+    const verbose = flags.has("verbose");
+    const { manifest, snapshotPath, snapshotText, schema: snapshot } = await readGenerated(io, out);
+    const source = await readSource(io, flags);
+    const current = loadSchema(source).schema;
+    // Files that don't hash as recorded were edited, removed or left half-written.
+    const stale = [];
+    for (const file of FILES) {
+        const hash = manifest.files[file];
+        // Sequential: a few small reads, and a stable order for the message.
+        // oxlint-disable-next-line no-await-in-loop
+        const text = file === SNAPSHOT ? snapshotText : await io.readText(join(out, file));
+        if (text === undefined || contentHash(text) !== hash)
+            stale.push(file);
+    }
+    // Another codegen, or another core normalizing the same snapshot differently.
+    const outdated = manifest.codegen !== CODEGEN_VERSION || manifest.schema !== hashSchema(snapshot);
+    const { diff, runtime } = withoutRuntimeOptions(diffSchemas(snapshot, current), current);
+    const drifted = diff.added.length + diff.removed.length + diff.changed.length > 0;
+    const ignored = runtime.length === 0
+        ? ""
+        : ` (changed files in ${count(runtime.length, "upload or remote combo")} aren't drift: ${listed(runtime, verbose, SHOWN_NAMES)})`;
+    if (!drifted && stale.length === 0 && !outdated) {
+        const nodes = Object.keys(current.nodes).length;
+        io.out(`Up to date: ${count(nodes, "node type")} ${nodes === 1 ? "matches" : "match"} ${snapshotPath}${ignored}.\n`);
+        return 0;
+    }
+    const lines = [];
+    if (stale.length > 0) {
+        lines.push(`${list(stale)} in ${out} ${stale.length === 1 ? "isn't" : "aren't"} what tscomfy generate wrote: edited, missing, or from an interrupted run.`);
+    }
+    if (outdated) {
+        lines.push(manifest.codegen === CODEGEN_VERSION
+            ? `${out} was generated by another version of tscomfy, which read the snapshot differently.`
+            : `${out} was generated by @tscomfy/codegen ${manifest.codegen}; this is ${CODEGEN_VERSION}.`);
+    }
+    if (drifted) {
+        lines.push(`${source.label} differs from ${snapshotPath}${ignored}:`, ...formatDiff(diff, verbose));
+    }
+    const command = regenerateCommand({
+        flag: source.flag,
+        out,
+        exportName: manifest.exportName,
+        importExtension: manifest.importExtension,
+        // With --url, the server says again.
+        ...(flags.has("from") && manifest.comfyVersion !== undefined
+            ? { comfyVersion: manifest.comfyVersion }
+            : {}),
+    });
+    lines.push(`Run ${command} to update.`);
+    io.out(`${lines.join("\n")}\n`);
+    return 1;
+}
+/**
+ * The diff without option changes of upload and remote combos (docs/plan.md §6.5): their options
+ * are the server's files, which change with every upload, and the types take any string there.
+ * Also returns those inputs, as `Class.input`.
+ */
+function withoutRuntimeOptions(diff, current) {
+    const runtime = [];
+    const changed = [];
+    for (const change of diff.changed) {
+        const inputs = current.nodes[change.classType]?.inputs ?? [];
+        const kept = change.inputsChanged.filter((input) => {
+            const definition = inputs.find((each) => each.name === input.name);
+            const runtimeOnly = !input.specChanged &&
+                definition?.kind === "combo" &&
+                (definition.upload || definition.remote);
+            if (runtimeOnly)
+                runtime.push(`${change.classType}.${input.name}`);
+            return !runtimeOnly;
+        });
+        const rest = { ...change, inputsChanged: kept };
+        const empty = kept.length === 0 &&
+            rest.inputsAdded.length === 0 &&
+            rest.inputsRemoved.length === 0 &&
+            !rest.outputsChanged &&
+            !rest.detailsChanged;
+        if (!empty)
+            changed.push(rest);
+    }
+    return { diff: { ...diff, changed }, runtime };
+}
+/**
+ * The diff as indented lines: every list (nodes, inputs, options, changed nodes) cut to its
+ * first few entries unless `verbose`, so a server that differs a lot still gives short lines.
+ */
+function formatDiff(diff, verbose) {
+    const lines = [];
+    if (diff.added.length > 0) {
+        lines.push(`  + ${count(diff.added.length, "node")} added: ${listed(diff.added, verbose, SHOWN_NAMES)}`);
+    }
+    if (diff.removed.length > 0) {
+        lines.push(`  - ${count(diff.removed.length, "node")} removed: ${listed(diff.removed, verbose, SHOWN_NAMES)}`);
+    }
+    if (diff.changed.length > 0) {
+        lines.push(`  ~ ${count(diff.changed.length, "node")} changed:`);
+        const shown = verbose ? diff.changed : diff.changed.slice(0, SHOWN_NAMES);
+        for (const change of shown)
+            lines.push(...formatChange(change, verbose));
+        if (shown.length < diff.changed.length) {
+            lines.push(`    … and ${String(diff.changed.length - shown.length)} more${MORE}`);
+        }
+    }
+    return lines;
+}
+function formatChange(change, verbose) {
+    const lines = [`    ${change.classType}`];
+    if (change.inputsAdded.length > 0) {
+        lines.push(`      inputs added: ${listed(change.inputsAdded, verbose, SHOWN_NAMES)}`);
+    }
+    if (change.inputsRemoved.length > 0) {
+        lines.push(`      inputs removed: ${listed(change.inputsRemoved, verbose, SHOWN_NAMES)}`);
+    }
+    for (const input of change.inputsChanged) {
+        const options = (values) => listed(values.map((option) => JSON.stringify(option)), verbose, SHOWN_OPTIONS);
+        const parts = [
+            ...(input.optionsAdded.length > 0 ? [`+ ${options(input.optionsAdded)}`] : []),
+            ...(input.optionsRemoved.length > 0 ? [`- ${options(input.optionsRemoved)}`] : []),
+            ...(input.specChanged ? ["spec changed"] : []),
+        ];
+        lines.push(`      ${input.name}: ${parts.join("; ")}`);
+    }
+    if (change.outputsChanged)
+        lines.push("      outputs changed");
+    if (change.detailsChanged)
+        lines.push("      details changed (name, category, description, flags or order)");
+    return lines;
+}
+/** `a, b, c`, or the first `limit` and `… and 4 more (--verbose shows all)` unless `verbose`. */
+function listed(items, verbose, limit) {
+    const shown = verbose ? items : items.slice(0, limit);
+    const rest = items.length - shown.length;
+    return rest > 0 ? `${shown.join(", ")}, … and ${String(rest)} more${MORE}` : shown.join(", ");
+}
+/** `a`, `a and b`, `a, b and c`. */
+function list(items) {
+    return items.length <= 1
+        ? items.join("")
+        : `${items.slice(0, -1).join(", ")} and ${items.at(-1) ?? ""}`;
+}
+//# sourceMappingURL=check.js.map

package/dist/check.js.map

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

package/dist/generate.d.ts

@@ -0,0 +1,17 @@
+import { type Io } from "./io.ts";
+/** `tscomfy generate --help`. */
+export declare const GENERATE_USAGE: string;
+/** `tscomfy generate`. */
+export declare function generateCommand(io: Io, args: readonly string[]): Promise<number>;
+/** What regenerates a directory: the recorded options, from a given source. */
+export interface Regenerate {
+    /** `--url <server>` or `--from <file>`, as shell words. */
+    readonly flag: string;
+    readonly out: string;
+    readonly exportName: string;
+    readonly importExtension: ".js" | ".ts";
+    readonly comfyVersion?: string;
+}
+/** The `tscomfy generate` command for a POSIX shell; options at their defaults are left out. */
+export declare function regenerateCommand(options: Regenerate): string;
+//# sourceMappingURL=generate.d.ts.map

package/dist/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAIA,OAAO,EAAY,KAAK,EAAE,EAAE,MAAM,SAAS,CAAC;AAa5C,iCAAiC;AACjC,eAAO,MAAM,cAAc,EAAE,MAsB5B,CAAC;AAcF,0BAA0B;AAC1B,wBAAsB,eAAe,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAyDtF;AAqBD,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACzB,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,KAAK,GAAG,KAAK,CAAC;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,gGAAgG;AAChG,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAa7D"}

package/dist/generate.js

@@ -0,0 +1,166 @@
+import { basename, dirname, join } from "node:path";
+import { CODEGEN_VERSION, exportNameProblem, generate } from "@tscomfy/codegen";
+import { hashSchema } from "@tscomfy/core";
+import { HELP, parseFlags, required, value } from "./args.js";
+import { CliError } from "./io.js";
+import { contentHash, formatManifest, MANIFEST, readManifest, SNAPSHOT, } from "./manifest.js";
+import { count, formatDiagnostic, reportDiagnostics, size } from "./report.js";
+import { loadSchema, readSource } from "./source.js";
+import { camelName, flagWords } from "./util.js";
+/** `tscomfy generate --help`. */
+export const GENERATE_USAGE = `Usage: tscomfy generate (--url <server> | --from <object_info.json>) --out <dir> [options]
+
+Writes <dir>/nodes.ts (types), <dir>/index.ts (the typed schema), <dir>/${SNAPSHOT}
+(the raw response, for regenerating offline and for \`tscomfy check\`) and <dir>/${MANIFEST}
+(what was generated, for \`tscomfy check\` and \`tscomfy transpile\`).
+
+Options:
+  --url <server>             A ComfyUI server, e.g. http://127.0.0.1:8188. Only GET requests.
+                             Credentials and the query are sent, never written or shown.
+  --from <file>              A saved /object_info response instead of a server.
+  --out <dir>                The directory to write into.
+  --name <identifier>        The exported schema constant. Default: from the directory name,
+                             camelCased (my-server → myServer).
+  --import-extension <ext>   How index.ts imports nodes.ts: .js (default) or .ts.
+  --comfy-version <version>  The ComfyUI version to record, with --from. Default: the one
+                             recorded next to <file> when it is a snapshot generate wrote.
+  --verbose                  List every diagnostic.
+  --quiet                    Print errors only.
+  -h, --help                 Show this help.
+
+The headers record the command that regenerates the files, for a POSIX shell in the directory
+generate ran in. A value that starts with - is written --flag=<value>.
+`;
+const FLAGS = [
+    { name: "url", takesValue: true },
+    { name: "from", takesValue: true },
+    { name: "out", takesValue: true },
+    { name: "name", takesValue: true },
+    { name: "import-extension", takesValue: true },
+    { name: "comfy-version", takesValue: true },
+    { name: "verbose", takesValue: false },
+    { name: "quiet", takesValue: false },
+    HELP,
+];
+/** `tscomfy generate`. */
+export async function generateCommand(io, args) {
+    const flags = parseFlags(args, FLAGS);
+    if (flags.has("help")) {
+        io.out(GENERATE_USAGE);
+        return 0;
+    }
+    const out = required(flags, "out");
+    const exportName = readName(flags, out);
+    const importExtension = readExtension(flags);
+    if (flags.has("comfy-version") && !flags.has("from")) {
+        throw new CliError("--comfy-version goes with --from; with --url it comes from the server.", 2);
+    }
+    if (flags.has("verbose") && flags.has("quiet")) {
+        throw new CliError("--verbose and --quiet don't go together.", 2);
+    }
+    const read = await readSource(io, flags);
+    const source = await withSnapshotVersion(io, flags, read);
+    const schema = loadSchema(source);
+    const command = regenerateCommand({
+        flag: source.flag,
+        out,
+        exportName,
+        importExtension,
+        // With --url, the server says again.
+        ...(flags.has("from") && source.comfyVersion !== undefined
+            ? { comfyVersion: source.comfyVersion }
+            : {}),
+    });
+    const result = generate(schema.schema, { exportName, importExtension, command });
+    const files = [...result.files, { path: SNAPSHOT, contents: source.text }];
+    await Promise.all(files.map((file) => io.writeText(join(out, file.path), file.contents)));
+    // Last: a run interrupted before this leaves a manifest that doesn't match the files.
+    const manifest = {
+        codegen: CODEGEN_VERSION,
+        schema: hashSchema(schema.schema),
+        exportName,
+        importExtension,
+        ...(source.comfyVersion === undefined ? {} : { comfyVersion: source.comfyVersion }),
+        files: Object.fromEntries(files.map((file) => [file.path, contentHash(file.contents)])),
+    };
+    await io.writeText(join(out, MANIFEST), formatManifest(manifest));
+    const diagnostics = [...schema.diagnostics, ...result.diagnostics];
+    if (!flags.has("quiet")) {
+        const version = schema.schema.comfyVersion === undefined ? "" : ` (ComfyUI ${schema.schema.comfyVersion})`;
+        io.out(`Generated ${count(Object.keys(schema.schema.nodes).length, "node type")} from ${source.label}${version} into ${out}:\n` +
+            `  ${files.map((file) => `${file.path} ${size(byteLength(file.contents))}`).join(" · ")}\n`);
+        io.out(reportDiagnostics(diagnostics, schema.schema, source.text, flags.has("verbose")));
+    }
+    else {
+        const errors = diagnostics.filter((diagnostic) => diagnostic.severity === "error");
+        for (const diagnostic of errors)
+            io.err(`${formatDiagnostic(diagnostic)}\n`);
+    }
+    return 0;
+}
+/**
+ * `--from` a snapshot generate wrote, without `--comfy-version`: the version its manifest
+ * records, when the file is exactly the one recorded. Regenerating offline then keeps the
+ * version a `--url` run fetched. Anything else (another file, an edited snapshot, no manifest,
+ * or one that isn't ours) leaves the version unknown, as for any saved response.
+ */
+async function withSnapshotVersion(io, flags, source) {
+    const from = value(flags, "from");
+    if (from === undefined || source.comfyVersion !== undefined || basename(from) !== SNAPSHOT) {
+        return source;
+    }
+    const manifest = await readManifest(io, dirname(from)).catch(() => undefined);
+    const recorded = manifest?.comfyVersion;
+    if (recorded === undefined || manifest?.files[SNAPSHOT] !== contentHash(source.text)) {
+        return source;
+    }
+    return { ...source, comfyVersion: recorded };
+}
+/** The `tscomfy generate` command for a POSIX shell; options at their defaults are left out. */
+export function regenerateCommand(options) {
+    return [
+        "tscomfy generate",
+        options.flag,
+        flagWords("out", options.out),
+        ...(options.exportName === defaultName(options.out)
+            ? []
+            : [flagWords("name", options.exportName)]),
+        ...(options.importExtension === ".js" ? [] : [`--import-extension ${options.importExtension}`]),
+        ...(options.comfyVersion === undefined
+            ? []
+            : [flagWords("comfy-version", options.comfyVersion)]),
+    ].join(" ");
+}
+/** The export name from the output directory (see {@link camelName}), if it can be one. */
+function defaultName(out) {
+    const name = camelName(basename(out));
+    return exportNameProblem(name) === undefined ? name : undefined;
+}
+function readName(flags, out) {
+    const given = value(flags, "name");
+    if (given === undefined) {
+        const derived = defaultName(out);
+        if (derived === undefined) {
+            const name = camelName(basename(out));
+            const why = name === "" ? "" : `: ${JSON.stringify(name)} won't do, ${exportNameProblem(name) ?? ""}`;
+            throw new CliError(`Can't make an export name from ${JSON.stringify(out)}${why}; pass --name.`, 2);
+        }
+        return derived;
+    }
+    const problem = exportNameProblem(given);
+    if (problem !== undefined) {
+        throw new CliError(`--name ${JSON.stringify(given)} isn't usable: ${problem}.`, 2);
+    }
+    return given;
+}
+function readExtension(flags) {
+    const extension = value(flags, "import-extension") ?? ".js";
+    if (extension !== ".js" && extension !== ".ts") {
+        throw new CliError("--import-extension is .js or .ts.", 2);
+    }
+    return extension;
+}
+function byteLength(text) {
+    return new TextEncoder().encode(text).length;
+}
+//# sourceMappingURL=generate.js.map

package/dist/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAc,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAW,MAAM,SAAS,CAAC;AAC5C,OAAO,EACL,WAAW,EACX,cAAc,EACd,QAAQ,EAER,YAAY,EACZ,QAAQ,GACT,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,UAAU,EAAe,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEjD,iCAAiC;AACjC,MAAM,CAAC,MAAM,cAAc,GAAW;;0EAEoC,QAAQ;mFACC,QAAQ;;;;;;;;;;;;;;;;;;;CAmB1F,CAAC;AAEF,MAAM,KAAK,GAAG;IACZ,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE;IACjC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE;IAClC,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE;IACjC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE;IAClC,EAAE,IAAI,EAAE,kBAAkB,EAAE,UAAU,EAAE,IAAI,EAAE;IAC9C,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,IAAI,EAAE;IAC3C,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE;IACtC,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE;IACpC,IAAI;CACI,CAAC;AAEX,0BAA0B;AAC1B,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EAAM,EAAE,IAAuB;IACnE,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACtC,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACvB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACxC,MAAM,eAAe,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAC7C,IAAI,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,QAAQ,CAAC,wEAAwE,EAAE,CAAC,CAAC,CAAC;IAClG,CAAC;IACD,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,QAAQ,CAAC,0CAA0C,EAAE,CAAC,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAElC,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG;QACH,UAAU;QACV,eAAe;QACf,qCAAqC;QACrC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS;YACxD,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE;YACvC,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,CAAC;IACjF,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3E,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC1F,sFAAsF;IACtF,MAAM,QAAQ,GAAa;QACzB,OAAO,EAAE,eAAe;QACxB,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC;QACjC,UAAU;QACV,eAAe;QACf,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;QACnF,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;KACxF,CAAC;IACF,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;IAElE,MAAM,WAAW,GAAG,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACnE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,MAAM,OAAO,GACX,MAAM,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,YAAY,GAAG,CAAC;QAC7F,EAAE,CAAC,GAAG,CACJ,aAAa,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,SAAS,MAAM,CAAC,KAAK,GAAG,OAAO,SAAS,GAAG,KAAK;YACtH,KAAK,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAC9F,CAAC;QACF,EAAE,CAAC,GAAG,CAAC,iBAAiB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC3F,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;QACnF,KAAK,MAAM,UAAU,IAAI,MAAM;YAAE,EAAE,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,mBAAmB,CAAC,EAAM,EAAE,KAAY,EAAE,MAAc;IACrE,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAClC,IAAI,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC3F,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC9E,MAAM,QAAQ,GAAG,QAAQ,EAAE,YAAY,CAAC;IACxC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACrF,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,EAAE,GAAG,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC;AAC/C,CAAC;AAYD,gGAAgG;AAChG,MAAM,UAAU,iBAAiB,CAAC,OAAmB;IACnD,OAAO;QACL,kBAAkB;QAClB,OAAO,CAAC,IAAI;QACZ,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC;QAC7B,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC;YACjD,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;QAC5C,GAAG,CAAC,OAAO,CAAC,eAAe,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,sBAAsB,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;QAC/F,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS;YACpC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,CAAC,SAAS,CAAC,eAAe,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;KACxD,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,2FAA2F;AAC3F,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,OAAO,iBAAiB,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAClE,CAAC;AAED,SAAS,QAAQ,CAAC,KAAY,EAAE,GAAW;IACzC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACnC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;YACtC,MAAM,GAAG,GACP,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,cAAc,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC5F,MAAM,IAAI,QAAQ,CAChB,kCAAkC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,GAAG,gBAAgB,EAC3E,CAAC,CACF,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,QAAQ,CAAC,UAAU,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,kBAAkB,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CAAC,KAAY;IACjC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,EAAE,kBAAkB,CAAC,IAAI,KAAK,CAAC;IAC5D,IAAI,SAAS,KAAK,KAAK,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;QAC/C,MAAM,IAAI,QAAQ,CAAC,mCAAmC,EAAE,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;AAC/C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @module @tscomfy/cli
+ *
+ * The `tscomfy` command: generate types from a ComfyUI server, check them for drift against a
+ * snapshot, and transpile API prompts and UI workflows to code. The only package with I/O,
+ * through `node:fs`, `node:crypto` and `fetch`, so it runs on Node and Bun.
+ * Exported for running the CLI in-process: `run(args, systemIo())`, or with an {@link Io} of
+ * your own, which reports failures as {@link CliError}s.
+ */
+export { CliError, type Io, systemIo } from "./io.ts";
+export { CLI_VERSION, run } from "./run.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * @module @tscomfy/cli
+ *
+ * The `tscomfy` command: generate types from a ComfyUI server, check them for drift against a
+ * snapshot, and transpile API prompts and UI workflows to code. The only package with I/O,
+ * through `node:fs`, `node:crypto` and `fetch`, so it runs on Node and Bun.
+ * Exported for running the CLI in-process: `run(args, systemIo())`, or with an {@link Io} of
+ * your own, which reports failures as {@link CliError}s.
+ */
+export { CliError, systemIo } from "./io.js";
+export { CLI_VERSION, run } from "./run.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAW,QAAQ,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC"}

package/dist/io.d.ts

@@ -0,0 +1,26 @@
+/** Everything the CLI does to the outside world, so commands can be tested without it. */
+export interface Io {
+    /** Writes to standard output. */
+    readonly out: (text: string) => void;
+    /** Writes to standard error. */
+    readonly err: (text: string) => void;
+    /**
+     * GETs a URL's body; throws a {@link CliError} for a network error or a non-2xx status (with
+     * the message of an error body, such as `{"detail": "Not authenticated"}`).
+     */
+    readonly fetchText: (url: string) => Promise<string>;
+    /** A file's text (UTF-8, without a byte order mark), or `undefined` when it doesn't exist. */
+    readonly readText: (path: string) => Promise<string | undefined>;
+    /** Replaces a file's contents in one step, creating its directory. */
+    readonly writeText: (path: string, text: string) => Promise<void>;
+}
+/** A failure to report to the user: a message, and the exit code to end with. */
+export declare class CliError extends Error {
+    /** 1 for a failure, 2 for a usage error. */
+    readonly exitCode: number;
+    /** A failure with `message`, ending the process with `exitCode`. */
+    constructor(message: string, exitCode?: number);
+}
+/** The real world: the process's streams, `fetch` and `node:fs`, which Node and Bun both have. */
+export declare function systemIo(): Io;
+//# sourceMappingURL=io.d.ts.map

package/dist/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAIA,0FAA0F;AAC1F,MAAM,WAAW,EAAE;IACjB,iCAAiC;IACjC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,gCAAgC;IAChC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,8FAA8F;IAC9F,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACjE,sEAAsE;IACtE,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE;AAED,iFAAiF;AACjF,qBAAa,QAAS,SAAQ,KAAK;IACjC,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,oEAAoE;IACpE,YAAY,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAI,EAIxC;CACF;AAID,kGAAkG;AAClG,wBAAgB,QAAQ,IAAI,EAAE,CAqD7B"}