@meltemi/diagrams-cli 0.0.0-stage → 1.9.0

package/dist/auth-command.js

@@ -0,0 +1,233 @@
+/**
+ * `login`, `logout` and `whoami` (`cli-cloud`, "Signing in from the command line").
+ *
+ * What `logout` does when the service cannot be asked (offline, a server error): the entry is KEPT
+ * and the command fails with exit code 1 (`logout.not-revoked`), because forgetting a token that is
+ * still alive would leave one nobody can revoke from this computer. Only an answer that settles the
+ * matter lets it go: the token revoked (204), or the service saying it does not know the token
+ * (`token.invalid`). Nobody is stuck with an entry they cannot remove: the message names the file.
+ */
+import { randomBytes } from "node:crypto";
+import { parseArgs } from "node:util";
+import { getLocale } from "@meltemi/diagrams-i18n";
+import { messages } from "./messages/index.js";
+import { cloudHost, newClient, openCloud, usage, usageError, } from "./cloud-context.js";
+import { CloudError, EXIT_OK, EXIT_USAGE, isCloudError } from "./cloud-errors.js";
+import { environmentToken } from "./credentials.js";
+import { LOGIN_TIMEOUT_MS, approvalCheck, listenForApproval, sameText } from "./login-listener.js";
+import { openUrl } from "./open-url.js";
+/** A token as the service makes them: `mdg_` and base64url characters. */
+const TOKEN_SHAPE = /^mdg_[A-Za-z0-9_-]{4,512}$/;
+/** The options of the three commands: `--host` and `--help`, and `login`'s own. */
+function parse(context, args, help, withLogin) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: [...args],
+            options: {
+                host: { type: "string" },
+                ...(withLogin
+                    ? {
+                        "no-browser": { type: "boolean", default: false },
+                        token: { type: "boolean", default: false },
+                    }
+                    : {}),
+                help: { type: "boolean", short: "h", default: false },
+            },
+            allowPositionals: true,
+            strict: true,
+        });
+    }
+    catch (error) {
+        return usageError(context, error, help);
+    }
+    const values = parsed.values;
+    if (values.help) {
+        context.stdout(help);
+        return EXIT_OK;
+    }
+    if (parsed.positionals.length > 0) {
+        return usage(context, messages().cloud.noArguments(context.command), help);
+    }
+    return {
+        host: values.host,
+        noBrowser: values["no-browser"] === true,
+        token: values.token === true,
+    };
+}
+// ------------------------------------------------------------------------------------- login
+export const loginCommand = async (args, context) => {
+    const help = messages().help.login;
+    const options = parse(context, args, help, true);
+    if (typeof options === "number")
+        return options;
+    if (environmentToken(context.env) !== undefined) {
+        throw new CloudError("login.environment-token", "MELTEMI_TOKEN is set.");
+    }
+    const host = cloudHost(context, { host: options.host });
+    // Read the file and make its folder first: a token made now must have somewhere to go.
+    context.credentials.prepare();
+    // Both flows keep the entry before they return it.
+    const entry = options.token
+        ? await loginWithToken(context, host)
+        : await loginInBrowser(context, host, options.noBrowser);
+    context.stdout(`${messages().cloud.login.signedIn(entry.user.name, host)}\n`);
+    return EXIT_OK;
+};
+/** `--token`: the token comes from standard input; its id and owner from `GET /api/session`. */
+async function loginWithToken(context, host) {
+    if (context.stdin === undefined) {
+        throw new CloudError("login.token-input", "--token reads standard input.", {
+            exitCode: EXIT_USAGE,
+        });
+    }
+    // A byte order mark is what some shells put in front of what they pipe.
+    const input = await context.stdin();
+    const token = (input.charCodeAt(0) === 0xfeff ? input.slice(1) : input).trim();
+    if (token === "")
+        throw new CloudError("login.no-token", "No token was given.");
+    if (!TOKEN_SHAPE.test(token))
+        throw new CloudError("login.not-a-token", "Not an API token.");
+    const { user, token: identity } = await newClient(context, host, token).session();
+    const entry = { token, id: identity.id, user: { sub: user.sub, name: user.name } };
+    context.credentials.save(host, entry);
+    return entry;
+}
+/** The browser flow: approve in the browser, receive the code here, exchange it, learn who it is. */
+async function loginInBrowser(context, host, noBrowser) {
+    const t = messages().cloud.login;
+    const state = randomBytes(32).toString("base64url");
+    let listener;
+    try {
+        listener = await listenForApproval({
+            timeoutMs: context.hooks.loginTimeoutMs ?? LOGIN_TIMEOUT_MS,
+            fallbackLocale: getLocale(),
+        });
+    }
+    catch (error) {
+        throw new CloudError("login.listener", "Cannot listen.", {
+            details: { reason: error.message },
+        });
+    }
+    try {
+        // Built here, from the host and numbers and letters of our own, never from what a server says.
+        const url = new URL("/cli-auth", host);
+        url.searchParams.set("port", String(listener.port));
+        url.searchParams.set("state", state);
+        // The check first, so that the person recognises their own request on the page.
+        context.stdout(`${t.check(approvalCheck(state))}\n${t.checkNote}\n`);
+        if (noBrowser) {
+            context.stdout(`${t.visit(url.href)}\n`);
+        }
+        else {
+            context.stdout(`${t.opening(url.href)}\n`);
+            try {
+                await (context.hooks.openBrowser ?? openUrl)(url.href);
+            }
+            catch {
+                context.stdout(`${t.openFailed}\n`);
+            }
+        }
+        context.stdout(`${t.waiting}\n`);
+        const arrival = await listener.outcome;
+        if (arrival === "timeout")
+            throw new CloudError("login.timeout", "No approval arrived.");
+        if (!sameText(arrival.state, state)) {
+            arrival.reply(false);
+            throw new CloudError("login.state-mismatch", "The state does not match.");
+        }
+        try {
+            const entry = await finishLogin(context, host, arrival.code, state);
+            arrival.reply(true);
+            return entry;
+        }
+        catch (error) {
+            arrival.reply(false);
+            throw error;
+        }
+    }
+    finally {
+        await listener.close();
+    }
+}
+/**
+ * Exchanges the one-time code (once; it is a secret and is never printed) and asks who the token is
+ * for. A token that could not be completed is revoked again, so that none is left that nobody holds.
+ */
+async function finishLogin(context, host, code, state) {
+    const issued = await newClient(context, host).exchangeCode(code, state);
+    const client = newClient(context, host, issued.token);
+    const revoke = () => client.deleteToken(issued.id).then(() => true, () => false);
+    let entry;
+    try {
+        const { user } = await client.session();
+        entry = { token: issued.token, id: issued.id, user: { sub: user.sub, name: user.name } };
+        // Kept before the browser is answered: the page says "done" only when it is.
+        context.credentials.save(host, entry);
+    }
+    catch (error) {
+        const revoked = await revoke();
+        if (isCloudError(error) && error.code.startsWith("credentials.")) {
+            const reason = String(error.details["reason"] ?? error.message);
+            throw new CloudError(revoked ? "login.not-stored" : "login.not-stored-not-revoked", `The token could not be kept: ${reason}`, { details: { reason } });
+        }
+        throw error;
+    }
+    return entry;
+}
+// ------------------------------------------------------------------------------------ logout
+export const logoutCommand = async (args, context) => {
+    const help = messages().help.logout;
+    const options = parse(context, args, help, false);
+    if (typeof options === "number")
+        return options;
+    const t = messages().cloud.logout;
+    const host = cloudHost(context, { host: options.host });
+    const note = environmentToken(context.env) !== undefined ? `${t.environment}\n` : "";
+    const entry = context.credentials.entry(host);
+    if (entry === undefined) {
+        context.stdout(`${t.none(host)}\n${note}`);
+        return EXIT_OK;
+    }
+    const client = newClient(context, host, entry.token);
+    try {
+        try {
+            await client.deleteToken(entry.id);
+        }
+        catch (error) {
+            // The stored id is not this token's (the file was edited): the token knows its own.
+            if (!isCloudError(error, "not-found"))
+                throw error;
+            await client.deleteToken((await client.session()).token.id);
+        }
+    }
+    catch (error) {
+        if (isCloudError(error, "token.invalid")) {
+            context.credentials.remove(host);
+            context.stdout(`${t.alreadyRevoked(host)}\n${note}`);
+            return EXIT_OK;
+        }
+        const reason = error instanceof Error ? error.message : String(error);
+        throw new CloudError("logout.not-revoked", `The token could not be revoked: ${reason}`, {
+            details: { host, reason, path: context.credentials.path },
+        });
+    }
+    context.credentials.remove(host);
+    context.stdout(`${t.done(host)}\n${note}`);
+    return EXIT_OK;
+};
+// ------------------------------------------------------------------------------------ whoami
+export const whoamiCommand = async (args, context) => {
+    const help = messages().help.whoami;
+    const options = parse(context, args, help, false);
+    if (typeof options === "number")
+        return options;
+    const t = messages().cloud.whoami;
+    const { host, client, token } = openCloud(context, { host: options.host });
+    const { user } = await client.session();
+    context.stdout(`${t.who(user.name, user.handle)}\n${t.host(host)}\n`);
+    if (token.source === "environment")
+        context.stdout(`${t.environment}\n`);
+    return EXIT_OK;
+};
+//# sourceMappingURL=auth-command.js.map

package/dist/auth-command.js.map

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

package/dist/bin.d.ts

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

package/dist/bin.d.ts.map

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

package/dist/bin.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+import { createInterface } from "node:readline/promises";
+import { CLI_NAME, run } from "./cli.js";
+import { messages } from "./messages/index.js";
+import { redactSecrets } from "./redact.js";
+const redact = (message) => redactSecrets(message, process.env);
+/** The most standard input is read for: a token is a few dozen characters. */
+const MAX_INPUT = 8 * 1024;
+/**
+ * What a person or a pipe gives `login --token`: one line typed at a terminal, else the first
+ * kilobytes of standard input. The token never comes from an argument.
+ */
+async function readStandardInput() {
+    if (process.stdin.isTTY) {
+        const terminal = createInterface({ input: process.stdin, output: process.stderr });
+        try {
+            return await terminal.question(messages().cloud.login.tokenPrompt);
+        }
+        finally {
+            terminal.close();
+        }
+    }
+    process.stdin.setEncoding("utf8");
+    let text = "";
+    for await (const chunk of process.stdin) {
+        text += chunk;
+        if (text.length > MAX_INPUT)
+            break;
+    }
+    return text.slice(0, MAX_INPUT);
+}
+process.on("uncaughtException", (error) => {
+    process.stderr.write(`${messages().common.internalError(CLI_NAME, redact(error.message))}\n`);
+    if (process.env.MELTEMI_DEBUG)
+        process.stderr.write(`${redact(error.stack ?? "")}\n`);
+    process.exit(70);
+});
+process.exitCode = await run(process.argv.slice(2), {
+    stdout: (text) => process.stdout.write(text),
+    stderr: (text) => process.stderr.write(text),
+    cwd: process.cwd(),
+    env: process.env,
+    locale: Intl.DateTimeFormat().resolvedOptions().locale,
+    stdin: readStandardInput,
+    // Only a person at a terminal can answer.
+    ...(process.stdin.isTTY
+        ? {
+            ask: async (question) => {
+                const terminal = createInterface({ input: process.stdin, output: process.stderr });
+                try {
+                    return await terminal.question(question);
+                }
+                finally {
+                    terminal.close();
+                }
+            },
+        }
+        : {}),
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

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

package/dist/build-command.d.ts

@@ -0,0 +1,23 @@
+import type { Diagnostic } from "@meltemi/diagrams-language";
+import { type ProjectSessions } from "@meltemi/diagrams-editor/node";
+import { type Workspace } from "@meltemi/diagrams-project";
+/** What the build command needs from the CLI: output, paths, projects and diagnostics. */
+export interface BuildContext {
+    readonly name: string;
+    readonly stdout: (text: string) => void;
+    readonly stderr: (text: string) => void;
+    readonly cwd: string;
+    /** A path as printed: relative to the working folder. */
+    readonly display: (path: string) => string;
+    readonly projects: () => ProjectSessions;
+    /** The generator the catalog names, such as `Meltemi Diagrams 1.0.0`. */
+    readonly generator: string;
+    /** Prints the manifest and asset diagnostics of a project; returns whether there are errors. */
+    readonly printProject: (workspace: Workspace) => boolean;
+    readonly printDiagnostics: (path: string, diagnostics: readonly Diagnostic[]) => void;
+}
+/** A size for people: bytes, KB or MB, with the decimal sign of the interface language. */
+export declare function formatSize(bytes: number): string;
+/** `meltemi-diagrams build catalog`. */
+export declare function buildCommand(args: readonly string[], context: BuildContext): number;
+//# sourceMappingURL=build-command.d.ts.map

package/dist/build-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-command.d.ts","sourceRoot":"","sources":["../src/build-command.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEnF,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAG1E,0FAA0F;AAC1F,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,eAAe,CAAC;IACzC,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,gGAAgG;IAChG,QAAQ,CAAC,YAAY,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,OAAO,CAAC;IACzD,QAAQ,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,UAAU,EAAE,KAAK,IAAI,CAAC;CACvF;AAMD,2FAA2F;AAC3F,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED,wCAAwC;AACxC,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,CAyGnF"}

package/dist/build-command.js

@@ -0,0 +1,123 @@
+import { mkdirSync, statSync, writeFileSync } from "node:fs";
+import { dirname, isAbsolute, resolve } from "node:path";
+import { parseArgs } from "node:util";
+import { catalogScript } from "@meltemi/diagrams-catalog/node";
+import { buildCatalog } from "@meltemi/diagrams-editor/node";
+import { decimal, getLocale } from "@meltemi/diagrams-i18n";
+import { toProjectPath } from "@meltemi/diagrams-project";
+import { argumentsError, messages } from "./messages/index.js";
+const EXIT_OK = 0;
+const EXIT_FINDINGS = 1;
+const EXIT_USAGE = 2;
+/** A size for people: bytes, KB or MB, with the decimal sign of the interface language. */
+export function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${Math.round(bytes / 1024)} KB`;
+    const megabytes = bytes / (1024 * 1024);
+    const locale = getLocale();
+    // English keeps its one fixed decimal ("2.0 MB"); Spanish writes "2 MB" and "2,5 MB".
+    return `${locale === "en" ? megabytes.toFixed(1) : decimal(locale, megabytes)} MB`;
+}
+/** `meltemi-diagrams build catalog`. */
+export function buildCommand(args, context) {
+    const [target, ...rest] = args;
+    if (target === undefined || target === "-h" || target === "--help") {
+        context.stdout(messages().help.build);
+        return target === undefined ? EXIT_USAGE : EXIT_OK;
+    }
+    if (target !== "catalog") {
+        context.stderr(`${context.name} build: ${messages().build.unknownTarget(target)}\n`);
+        return EXIT_USAGE;
+    }
+    let values;
+    let positionals;
+    try {
+        const parsed = parseArgs({
+            args: [...rest],
+            options: {
+                out: { type: "string" },
+                title: { type: "string" },
+                source: { type: "boolean", default: false },
+                help: { type: "boolean", short: "h", default: false },
+            },
+            allowPositionals: true,
+            strict: true,
+        });
+        values = parsed.values;
+        positionals = parsed.positionals;
+    }
+    catch (error) {
+        context.stderr(`${context.name} build catalog: ${argumentsError(error)}\n`);
+        return EXIT_USAGE;
+    }
+    if (values.help) {
+        context.stdout(messages().help.build);
+        return EXIT_OK;
+    }
+    if (positionals.length > 1) {
+        context.stderr(`${context.name} build catalog: ${messages().common.oneProject}\n`);
+        return EXIT_USAGE;
+    }
+    if (values.title !== undefined && values.title.trim() === "") {
+        context.stderr(`${context.name} build catalog: ${messages().build.title}\n`);
+        return EXIT_USAGE;
+    }
+    const path = positionals[0] ?? ".";
+    const absolute = toProjectPath(resolve(context.cwd, path));
+    let isDirectory;
+    try {
+        isDirectory = statSync(absolute).isDirectory();
+    }
+    catch {
+        context.stderr(`${context.name} build catalog: ${messages().common.pathNotFound(path)}\n`);
+        return EXIT_USAGE;
+    }
+    const projects = context.projects();
+    const workspace = isDirectory ? projects.forFolder(absolute) : projects.forFile(absolute);
+    const out = values.out === undefined
+        ? undefined
+        : toProjectPath(isAbsolute(values.out) ? values.out : resolve(context.cwd, values.out));
+    let errors = context.printProject(workspace);
+    const build = buildCatalog(workspace, projects, {
+        ...(out !== undefined ? { out } : {}),
+        ...(values.title !== undefined ? { title: values.title.trim() } : {}),
+        ...(values.source ? { source: true } : {}),
+        generator: context.generator,
+        script: catalogScript,
+    });
+    for (const [file, diagnostics] of [...build.diagnostics].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) {
+        context.printDiagnostics(context.display(file), diagnostics);
+        errors ||= diagnostics.some((d) => d.severity === "error");
+    }
+    const t = messages().build;
+    for (const entry of build.skipped) {
+        context.stderr(`${context.name} build catalog: ${t.skipped(`${context.display(entry.path)}#${entry.id}`, entry.reason)}\n`);
+    }
+    for (const warning of build.warnings) {
+        context.stderr(`${context.name} build catalog: ${t.warning(warning)}\n`);
+    }
+    const { entries, entities } = build.data;
+    if (entries.length === 0) {
+        context.stderr(`${context.name} build catalog: ${t.empty(context.display(workspace.root))}\n`);
+        return build.skipped.length > 0 ? EXIT_FINDINGS : EXIT_USAGE;
+    }
+    try {
+        mkdirSync(dirname(build.out), { recursive: true });
+        writeFileSync(build.out, build.html);
+    }
+    catch (error) {
+        context.stderr(`${context.name} build catalog: ${messages().common.cannotWrite(context.display(build.out), error.message)}\n`);
+        return EXIT_USAGE;
+    }
+    const diagrams = entries.filter((e) => e.kind === "diagram").length;
+    const parts = [
+        t.diagrams(diagrams),
+        t.stories(entries.length - diagrams),
+        ...(entities.length > 0 ? [t.entities(entities.length)] : []),
+    ];
+    context.stdout(`${t.wrote(context.display(build.out), parts, formatSize(Buffer.byteLength(build.html)))}\n`);
+    return errors || build.skipped.length > 0 ? EXIT_FINDINGS : EXIT_OK;
+}
+//# sourceMappingURL=build-command.js.map

package/dist/build-command.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,46 @@
+import { type Locale } from "@meltemi/diagrams-i18n";
+import type { CloudHooks } from "./cloud-context.js";
+export { FONT_POLICIES, MOTION_MODES, WRITABLE_FORMATS, exportFileName } from "./export-command.js";
+/** Command name (decision 0002). */
+export declare const CLI_NAME = "meltemi-diagrams";
+/** Short alias installed next to the full command name. */
+export declare const CLI_ALIAS = "mdg";
+/** Extension of `.meltemi` sources (decision 0002). */
+export declare const MELTEMI_EXTENSION = ".meltemi";
+export declare const CLI_VERSION = "1.9.0";
+export declare const EXIT_OK = 0;
+export declare const EXIT_FINDINGS = 1;
+export declare const EXIT_USAGE = 2;
+/** The cloud commands: not signed in, or the service refused the token (run `login`). */
+export declare const EXIT_AUTH = 3;
+export interface CliIo {
+    readonly stdout: (text: string) => void;
+    readonly stderr: (text: string) => void;
+    readonly cwd: string;
+    /** Where `assist` reads provider settings and keys; the process environment by default. */
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    /** Asks a question in a terminal; absent when nobody can answer. */
+    readonly ask?: (question: string) => Promise<string>;
+    /** Reads standard input, for `login --token`; the binary passes it. */
+    readonly stdin?: () => Promise<string>;
+    /** What the cloud commands use besides the process: tests replace the network and the browser. */
+    readonly cloud?: CloudHooks;
+    /**
+     * The system's language, for messages when neither `--lang` nor the environment names one;
+     * the binary passes it. Written files never depend on it.
+     */
+    readonly locale?: string;
+}
+/**
+ * Takes `--lang <en|es>` (or `--lang=<en|es>`) out of the arguments, wherever it is written:
+ * every command accepts it.
+ */
+export declare function takeLang(argv: readonly string[]): {
+    args: string[];
+    lang: Locale | undefined;
+} | {
+    error: string;
+};
+/** Runs the command line and returns the exit code; `assist`, which waits for a model, a promise of it. */
+export declare function run(input: readonly string[], io: CliIo): number | Promise<number>;
+//# 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":"AAAA,OAAO,EAML,KAAK,MAAM,EACZ,MAAM,wBAAwB,CAAC;AAmChC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAUrD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEpG,oCAAoC;AACpC,eAAO,MAAM,QAAQ,qBAAqB,CAAC;AAC3C,2DAA2D;AAC3D,eAAO,MAAM,SAAS,QAAQ,CAAC;AAC/B,uDAAuD;AACvD,eAAO,MAAM,iBAAiB,aAAa,CAAC;AAC5C,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC,eAAO,MAAM,OAAO,IAAI,CAAC;AACzB,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,UAAU,IAAI,CAAC;AAC5B,yFAAyF;AACzF,eAAO,MAAM,SAAS,IAAI,CAAC;AAE3B,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,2FAA2F;IAC3F,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC5D,oEAAoE;IACpE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,uEAAuE;IACvE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,kGAAkG;IAClG,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAcD;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB;IAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAclE;AAED,2GAA2G;AAC3G,wBAAgB,GAAG,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA6JjF"}