initiative-plugin-sdk 2.0.0

package/dist/build.d.ts

@@ -0,0 +1,52 @@
+/**
+ * `initiative-plugin build`: the files a plug-in's definition produces.
+ *
+ * - `manifest.json`: the manifest, with each widget's module bundled into its
+ *   `module_source`, after `validateManifest` has passed it. That parses
+ *   every JSONata expression a declarative plug-in gives, so one that does not
+ *   parse fails the build at its place in the manifest.
+ * - With `--registry <dir>`, the plug-in's registry source under
+ *   `<dir>/<publisher>/<uid>/`: `listing.json`, this version's
+ *   `<version>/manifest.json` and the avatar. It is written only while the
+ *   listing names the package's own version: between releases the package
+ *   runs ahead of its listing, and what the listing already publishes is left
+ *   as it was.
+ *
+ * With `--check` nothing is written, and any file that differs from what would
+ * be written is a failure.
+ *
+ * Bundling uses esbuild, which the plug-in installs beside the SDK
+ * (`npm install --save-dev esbuild`). Nothing at run time needs it.
+ */
+import { type AnyPlugin } from "./define.js";
+import type { Manifest } from "./contract.js";
+export interface BuildOptions {
+    /** The plug-in's package directory. */
+    root: string;
+    /** The module whose default export is the plug-in's definition, relative to `root`. */
+    plugin: string;
+    /** Where registry sources live; the plug-in's is written under `<publisher>/<uid>/`. */
+    registry?: string;
+    check: boolean;
+}
+type Esbuild = typeof import("esbuild");
+/** esbuild, or null after saying how to install it. */
+export declare function bundler(command: string): Promise<Esbuild | null>;
+/** What a definition builds: the plug-in and its manifest, or every problem that stops it. */
+export type Compiled = {
+    plugin: AnyPlugin;
+    manifest: Manifest;
+    problems?: never;
+} | {
+    problems: string[];
+};
+/**
+ * Load the plug-in's definition, bundle its widgets and check the manifest they
+ * make, with nothing written.
+ */
+export declare function compile(esbuild: Esbuild, root: string, entry: string): Promise<Compiled>;
+/** Build, or check, the plug-in's files. Answers the process's exit code. */
+export declare function build(options: BuildOptions): Promise<number>;
+/** A listing's registration: the plug-in's kind, and a container's image and Compose service. */
+export declare function registrationOf(plugin: AnyPlugin): Record<string, unknown>;
+export {};

package/dist/build.js

@@ -0,0 +1,229 @@
+/**
+ * `initiative-plugin build`: the files a plug-in's definition produces.
+ *
+ * - `manifest.json`: the manifest, with each widget's module bundled into its
+ *   `module_source`, after `validateManifest` has passed it. That parses
+ *   every JSONata expression a declarative plug-in gives, so one that does not
+ *   parse fails the build at its place in the manifest.
+ * - With `--registry <dir>`, the plug-in's registry source under
+ *   `<dir>/<publisher>/<uid>/`: `listing.json`, this version's
+ *   `<version>/manifest.json` and the avatar. It is written only while the
+ *   listing names the package's own version: between releases the package
+ *   runs ahead of its listing, and what the listing already publishes is left
+ *   as it was.
+ *
+ * With `--check` nothing is written, and any file that differs from what would
+ * be written is a failure.
+ *
+ * Bundling uses esbuild, which the plug-in installs beside the SDK
+ * (`npm install --save-dev esbuild`). Nothing at run time needs it.
+ */
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { basename, dirname, join, relative, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { CAPS } from "./contract.js";
+import { manifestOf } from "./define.js";
+import { validateManifest } from "./validate.js";
+/** esbuild, or null after saying how to install it. */
+export async function bundler(command) {
+    try {
+        return await import("esbuild");
+    }
+    catch {
+        process.stderr.write(`initiative-plugin ${command} bundles with esbuild: npm install --save-dev esbuild\n`);
+        return null;
+    }
+}
+/**
+ * Load the plug-in's definition, bundle its widgets and check the manifest they
+ * make, with nothing written.
+ */
+export async function compile(esbuild, root, entry) {
+    const plugin = await loadPlugin(esbuild, root, entry);
+    const modules = {};
+    const problems = [];
+    for (const [id, widget] of Object.entries(plugin.widgets ?? {})) {
+        const source = await bundleWidget(esbuild, root, widget.module);
+        const bytes = Buffer.byteLength(source, "utf-8");
+        if (bytes > CAPS.moduleSourceBytes) {
+            problems.push(`widget ${id}: ${widget.module} bundles to ${bytes} bytes, over the ${CAPS.moduleSourceBytes}-byte cap`);
+        }
+        modules[id] = source;
+    }
+    const manifest = manifestOf(plugin, modules);
+    problems.push(...validateManifest(manifest, { publicId: plugin.publicId }).map((problem) => `manifest${problem.where}: ${problem.message}`));
+    problems.push(...kindProblems(plugin));
+    if (plugin.listing?.compose)
+        problems.push(...composeProblems(plugin.listing.compose));
+    return problems.length ? { problems } : { plugin, manifest };
+}
+/** Build, or check, the plug-in's files. Answers the process's exit code. */
+export async function build(options) {
+    const esbuild = await bundler("build");
+    if (!esbuild)
+        return 1;
+    const root = resolve(options.root);
+    const compiled = await compile(esbuild, root, options.plugin);
+    if (compiled.problems) {
+        for (const problem of compiled.problems)
+            process.stderr.write(`${problem}\n`);
+        return 1;
+    }
+    const { plugin, manifest } = compiled;
+    const manifestText = `${JSON.stringify(manifest, null, 2)}\n`;
+    const outputs = [[join(root, "manifest.json"), manifestText]];
+    if (options.registry !== undefined) {
+        const listing = plugin.listing;
+        if (!listing) {
+            process.stderr.write("--registry was given, but the plug-in declares no listing\n");
+            return 1;
+        }
+        const version = JSON.parse(readFileSync(join(root, "package.json"), "utf-8")).version;
+        if (version === listing.version) {
+            const avatar = readFileSync(resolve(root, listing.avatar));
+            const source = resolve(root, options.registry, listing.publisher, plugin.uid);
+            outputs.push([join(source, "listing.json"), `${JSON.stringify(listingSource(plugin, avatar), null, 2)}\n`], [join(source, listing.version, "manifest.json"), manifestText], [join(source, "assets", basename(listing.avatar)), avatar]);
+        }
+        else {
+            process.stdout.write(`the registry source lists ${listing.version}; ${version} is listed at its release\n`);
+        }
+    }
+    let stale = false;
+    for (const [path, content] of outputs) {
+        const name = relative(process.cwd(), path);
+        if (options.check) {
+            const current = existsSync(path) ? readFileSync(path) : null;
+            if (!current || !current.equals(Buffer.from(content))) {
+                process.stderr.write(`${name} is out of date: run initiative-plugin build\n`);
+                stale = true;
+            }
+        }
+        else {
+            mkdirSync(dirname(path), { recursive: true });
+            writeFileSync(path, content);
+            process.stdout.write(`wrote ${name}\n`);
+        }
+    }
+    return stale ? 1 : 0;
+}
+/** The plug-in's definition, compiled from its TypeScript and imported. */
+async function loadPlugin(esbuild, root, entry) {
+    const outfile = join(root, "node_modules", ".cache", "initiative-plugin", `plugin-${process.pid}-${Date.now()}.mjs`);
+    await esbuild.build({
+        entryPoints: [resolve(root, entry)],
+        outfile,
+        bundle: true,
+        platform: "node",
+        format: "esm",
+        packages: "external",
+        logLevel: "error",
+    });
+    try {
+        const loaded = (await import(pathToFileURL(outfile).href));
+        const plugin = loaded.default;
+        if (!plugin || typeof plugin.publicId !== "string") {
+            throw new Error(`${entry} must export the plug-in's definition as its default export`);
+        }
+        return plugin;
+    }
+    finally {
+        rmSync(outfile, { force: true });
+    }
+}
+/**
+ * One widget as the single script the sandbox runs: its module and everything
+ * it imports, with `render` left as a global.
+ */
+async function bundleWidget(esbuild, root, module) {
+    const path = `./${relative(root, resolve(root, module)).split("\\").join("/")}`;
+    const result = await esbuild.build({
+        stdin: {
+            contents: `import { render } from ${JSON.stringify(path)};\nglobalThis.render = render;\n`,
+            resolveDir: root,
+            sourcefile: "widget.js",
+            loader: "js",
+        },
+        bundle: true,
+        write: false,
+        format: "iife",
+        platform: "neutral",
+        target: "es2020",
+        charset: "utf8",
+        legalComments: "none",
+        logLevel: "error",
+    });
+    return result.outputFiles[0].text.trimEnd();
+}
+/**
+ * What a definition says that its manifest does not show: a declarative plug-in
+ * runs no hooks and asks for no scopes, and only a container plug-in's listing
+ * names an image.
+ */
+function kindProblems(plugin) {
+    const problems = [];
+    if (plugin.hosts) {
+        if (Object.keys(plugin.hooks ?? {}).length)
+            problems.push("hooks: a declarative plug-in runs no hooks");
+        if (plugin.scopes)
+            problems.push("scopes: a declarative plug-in asks for none, since it does not call Initiative");
+        if (plugin.listing?.image || plugin.listing?.compose)
+            problems.push("listing: a declarative plug-in has no image or compose service");
+    }
+    else if (plugin.listing && !plugin.listing.image) {
+        problems.push("listing: a container plug-in names its image");
+    }
+    return problems;
+}
+/** The registry's rules for a compose snippet: its size, its two placeholders, its address. */
+function composeProblems({ service, baseUrl }) {
+    const problems = [];
+    if (!service || service.length > 4096) {
+        problems.push("listing compose: the service is 1 to 4096 characters");
+    }
+    for (const [placeholder] of service.matchAll(/\$\{(?!(?:IMAGE|INITIATIVE_URL)\})[^}]*\}?/g)) {
+        problems.push(`listing compose: ${placeholder} is not a placeholder; Initiative fills \${IMAGE} and \${INITIATIVE_URL}`);
+    }
+    if (baseUrl.length > 512 || !/^https?:\/\/[A-Za-z0-9.-]+(?::[0-9]{1,5})?(?:\/[^\s?#]*)?$/.test(baseUrl)) {
+        problems.push("listing compose: baseUrl is an http or https URL of at most 512 characters");
+    }
+    return problems;
+}
+/** The registry source listing: what the catalogue shows, this version, and the registration, a container's or a declarative plug-in's. */
+function listingSource(plugin, avatar) {
+    const listing = plugin.listing;
+    return {
+        schema: 1,
+        uid: plugin.uid,
+        public_id: plugin.publicId,
+        publisher: listing.publisher,
+        kind: "plugin",
+        name: plugin.name,
+        summary: listing.summary,
+        ...(listing.description !== undefined ? { description: listing.description } : {}),
+        avatar: {
+            path: `assets/${basename(listing.avatar)}`,
+            sha256: createHash("sha256").update(avatar).digest("hex"),
+        },
+        versions: [
+            {
+                version: listing.version,
+                definition: `${listing.version}/manifest.json`,
+                ...(listing.minAppVersion !== undefined ? { min_app_version: listing.minAppVersion } : {}),
+                ...(listing.releaseNotes !== undefined ? { release_notes: listing.releaseNotes } : {}),
+            },
+        ],
+        registration: registrationOf(plugin),
+    };
+}
+/** A listing's registration: the plug-in's kind, and a container's image and Compose service. */
+export function registrationOf(plugin) {
+    const listing = plugin.listing;
+    return {
+        ...(plugin.hosts ? { kind: "declarative" } : { kind: "container", image: listing.image }),
+        scope_ceiling: [...(listing.scopeCeiling ?? plugin.scopes ?? [])],
+        reference_sectors: [...(listing.referenceSectors ?? [])],
+        ...(listing.compose ? { compose: { service: listing.compose.service, base_url: listing.compose.baseUrl } } : {}),
+    };
+}
+//# sourceMappingURL=build.js.map

package/dist/build.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+/**
+ * `initiative-plugin`: start, build, pack and upload a plug-in, and keys and
+ * manifest checks.
+ *
+ *   initiative-plugin init [dir] [--example minimal]
+ *   initiative-plugin build [--plugin <file>] [--registry <dir>] [--check]
+ *   initiative-plugin pack [--plugin <file>] [--out <file>]
+ *   initiative-plugin dev --initiative <url> [--api-key <key>] [--plugin <file>]
+ *   initiative-plugin keygen [--alg RS256|ES256] [--kid <id>] [--out <dir>]
+ *   initiative-plugin validate <file.json>   a manifest, or a served manifest document
+ *   initiative-plugin schema                 print the schema a manifest is checked against
+ *   initiative-plugin uid                    mint a catalog uid
+ *
+ * `build` reads the plug-in's definition (default `src/plugin.ts`) and writes
+ * `manifest.json`, and with `--registry` the plug-in's registry source; see
+ * `build.ts`. `pack` writes the plug-in's listing file, which a self-hosted
+ * deployment publishes as its own plug-in (`pack.ts`), and `dev` uploads it to one
+ * and again on each change (`dev.ts`); its key may be given as
+ * `INITIATIVE_API_KEY` instead. `init` copies an example (`init.ts`).
+ * `keygen` writes `private-key.pem` (mode 0600) and `jwks.json`
+ * into `--out` and refuses to overwrite either.
+ */
+export {};

package/dist/cli.js

@@ -0,0 +1,160 @@
+#!/usr/bin/env node
+/**
+ * `initiative-plugin`: start, build, pack and upload a plug-in, and keys and
+ * manifest checks.
+ *
+ *   initiative-plugin init [dir] [--example minimal]
+ *   initiative-plugin build [--plugin <file>] [--registry <dir>] [--check]
+ *   initiative-plugin pack [--plugin <file>] [--out <file>]
+ *   initiative-plugin dev --initiative <url> [--api-key <key>] [--plugin <file>]
+ *   initiative-plugin keygen [--alg RS256|ES256] [--kid <id>] [--out <dir>]
+ *   initiative-plugin validate <file.json>   a manifest, or a served manifest document
+ *   initiative-plugin schema                 print the schema a manifest is checked against
+ *   initiative-plugin uid                    mint a catalog uid
+ *
+ * `build` reads the plug-in's definition (default `src/plugin.ts`) and writes
+ * `manifest.json`, and with `--registry` the plug-in's registry source; see
+ * `build.ts`. `pack` writes the plug-in's listing file, which a self-hosted
+ * deployment publishes as its own plug-in (`pack.ts`), and `dev` uploads it to one
+ * and again on each change (`dev.ts`); its key may be given as
+ * `INITIATIVE_API_KEY` instead. `init` copies an example (`init.ts`).
+ * `keygen` writes `private-key.pem` (mode 0600) and `jwks.json`
+ * into `--out` and refuses to overwrite either.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { build } from "./build.js";
+import { dev } from "./dev.js";
+import { init, mintUid } from "./init.js";
+import { generatePluginKeys } from "./keys.js";
+import { pack } from "./pack.js";
+import { manifestSchema, validateDocument, validateManifest } from "./validate.js";
+function usage() {
+    process.stderr.write([
+        "usage:",
+        "  initiative-plugin init [dir] [--example minimal]",
+        "  initiative-plugin build [--plugin <file>] [--registry <dir>] [--check]",
+        "  initiative-plugin pack [--plugin <file>] [--out <file>]",
+        "  initiative-plugin dev --initiative <url> [--api-key <key>] [--plugin <file>]",
+        "  initiative-plugin keygen [--alg RS256|ES256] [--kid <id>] [--out <dir>]",
+        "  initiative-plugin validate <file.json>",
+        "  initiative-plugin schema",
+        "  initiative-plugin uid",
+        "",
+    ].join("\n"));
+    process.exit(2);
+}
+/** `--name value` pairs and the `--name` switches in `switches`, and nothing else. */
+function flags(args, values, switches = []) {
+    const out = {};
+    for (let index = 0; index < args.length; index += 1) {
+        const name = args[index].startsWith("--") ? args[index].slice(2) : "";
+        if (switches.includes(name)) {
+            out[name] = true;
+        }
+        else if (values.includes(name) && args[index + 1] !== undefined) {
+            out[name] = args[index + 1];
+            index += 1;
+        }
+        else
+            usage();
+    }
+    return out;
+}
+function keygen(args) {
+    const options = flags(args, ["alg", "kid", "out"]);
+    const alg = (options.alg ?? "RS256");
+    if (alg !== "RS256" && alg !== "ES256") {
+        process.stderr.write(`unsupported --alg ${alg}: use RS256 or ES256\n`);
+        return 2;
+    }
+    const dir = options.out ?? ".";
+    const keyPath = join(dir, "private-key.pem");
+    const jwksPath = join(dir, "jwks.json");
+    for (const path of [keyPath, jwksPath]) {
+        if (existsSync(path)) {
+            process.stderr.write(`${path} already exists; choose another --out\n`);
+            return 1;
+        }
+    }
+    const keys = generatePluginKeys({ alg, ...(options.kid ? { kid: options.kid } : {}) });
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(keyPath, keys.privateKeyPem, { mode: 0o600, flag: "wx" });
+    writeFileSync(jwksPath, `${JSON.stringify(keys.jwks, null, 2)}\n`, { flag: "wx" });
+    process.stdout.write([
+        `wrote ${keyPath} (keep it secret)`,
+        `wrote ${jwksPath} (the public half, for the plug-in's listing or a deployment's operator)`,
+        `kid: ${keys.kid}`,
+        `alg: ${keys.alg}`,
+        "",
+    ].join("\n"));
+    return 0;
+}
+function validate(path) {
+    if (!path)
+        usage();
+    let body;
+    try {
+        body = JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch (error) {
+        process.stderr.write(`${path}: ${error.message}\n`);
+        return 1;
+    }
+    // A served document carries the manifest as its `definition`.
+    const document = typeof body === "object" && body !== null && "definition" in body;
+    const problems = document ? validateDocument(body) : validateManifest(body);
+    if (problems.length === 0) {
+        process.stdout.write(`${path}: no problems found (checked as a ${document ? "document" : "manifest"})\n`);
+        return 0;
+    }
+    for (const problem of problems)
+        process.stderr.write(`${path}${problem.where}: ${problem.message}\n`);
+    return 1;
+}
+async function main(argv) {
+    const [command, ...rest] = argv;
+    switch (command) {
+        case "init": {
+            const dir = rest[0]?.startsWith("--") === false ? rest.shift() : ".";
+            const options = flags(rest, ["example"]);
+            return init({ dir, example: options.example ?? "minimal" });
+        }
+        case "build": {
+            const options = flags(rest, ["plugin", "registry"], ["check"]);
+            return build({
+                root: process.cwd(),
+                plugin: typeof options.plugin === "string" ? options.plugin : "src/plugin.ts",
+                ...(typeof options.registry === "string" ? { registry: options.registry } : {}),
+                check: options.check === true,
+            });
+        }
+        case "pack": {
+            const options = flags(rest, ["plugin", "out"]);
+            return pack({ root: process.cwd(), plugin: options.plugin ?? "src/plugin.ts", out: options.out });
+        }
+        case "dev": {
+            const options = flags(rest, ["initiative", "api-key", "plugin"]);
+            const apiKey = options["api-key"] ?? process.env.INITIATIVE_API_KEY;
+            if (!options.initiative || !apiKey) {
+                process.stderr.write("dev uploads the plug-in to your deployment: give --initiative <url> and --api-key <key>\n");
+                return 2;
+            }
+            return dev({ root: process.cwd(), plugin: options.plugin ?? "src/plugin.ts", initiative: options.initiative, apiKey });
+        }
+        case "keygen":
+            return keygen(rest);
+        case "validate":
+            return validate(rest[0]);
+        case "schema":
+            process.stdout.write(`${JSON.stringify(manifestSchema(), null, 2)}\n`);
+            return 0;
+        case "uid":
+            process.stdout.write(`${mintUid()}\n`);
+            return 0;
+        default:
+            usage();
+    }
+}
+process.exit(await main(process.argv.slice(2)));
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAA2B,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEnF,SAAS,KAAK;IACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB;QACE,QAAQ;QACR,oDAAoD;QACpD,0EAA0E;QAC1E,2DAA2D;QAC3D,gFAAgF;QAChF,2EAA2E;QAC3E,0CAA0C;QAC1C,4BAA4B;QAC5B,yBAAyB;QACzB,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,sFAAsF;AACtF,SAAS,KAAK,CAAC,IAAc,EAAE,MAAgB,EAAE,QAAQ,GAAa,EAAE;IACtE,MAAM,GAAG,GAAkC,EAAE,CAAC;IAC9C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACnB,CAAC;aAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YAClE,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YAC5B,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;;YAAM,KAAK,EAAE,CAAC;IACjB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,MAAM,CAAC,IAAc;IAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAA2B,CAAC;IAC7E,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAuB,CAAC;IAC3D,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;QACvC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,GAAG,wBAAwB,CAAC,CAAC;QACvE,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC;IAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;QACvC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,yCAAyC,CAAC,CAAC;YACvE,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,kBAAkB,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACvF,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACxE,aAAa,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACnF,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB;QACE,SAAS,OAAO,mBAAmB;QACnC,SAAS,QAAQ,0EAA0E;QAC3F,QAAQ,IAAI,CAAC,GAAG,EAAE;QAClB,QAAQ,IAAI,CAAC,GAAG,EAAE;QAClB,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,QAAQ,CAAC,IAAwB;IACxC,IAAI,CAAC,IAAI;QAAE,KAAK,EAAE,CAAC;IACnB,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,KAAM,KAAe,CAAC,OAAO,IAAI,CAAC,CAAC;QAC/D,OAAO,CAAC,CAAC;IACX,CAAC;IACD,8DAA8D;IAC9D,MAAM,QAAQ,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,YAAY,IAAI,IAAI,CAAC;IACnF,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC5E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,qCAAqC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC;QAC1G,OAAO,CAAC,CAAC;IACX,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,QAAQ;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;IACtG,OAAO,CAAC,CAAC;AACX,CAAC;AAED,KAAK,UAAU,IAAI,CAAC,IAAc;IAChC,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAChC,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YACtE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,CAA2B,CAAC;YACnE,OAAO,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,SAAS,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,KAAK,OAAO,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;YAC/D,OAAO,KAAK,CAAC;gBACX,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE;gBACnB,MAAM,EAAE,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe;gBAC7E,GAAG,CAAC,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/E,KAAK,EAAE,OAAO,CAAC,KAAK,KAAK,IAAI;aAC9B,CAAC,CAAC;QACL,CAAC;QACD,KAAK,MAAM,EAAE,CAAC;YACZ,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,CAA2B,CAAC;YACzE,OAAO,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,eAAe,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACpG,CAAC;QACD,KAAK,KAAK,EAAE,CAAC;YACX,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,QAAQ,CAAC,CAA2B,CAAC;YAC3F,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;YACpE,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC;gBACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2FAA2F,CAAC,CAAC;gBAClH,OAAO,CAAC,CAAC;YACX,CAAC;YACD,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,eAAe,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;QACzH,CAAC;QACD,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;QACtB,KAAK,UAAU;YACb,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3B,KAAK,QAAQ;YACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YACvE,OAAO,CAAC,CAAC;QACX,KAAK,KAAK;YACR,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,EAAE,IAAI,CAAC,CAAC;YACvC,OAAO,CAAC,CAAC;QACX;YACE,KAAK,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC"}