cdk8s-local 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# cdk8s-local
+
+## 0.1.0
+
+### Minor Changes
+
+- 0fff51b: Initial release.
+
+### Patch Changes
+
+- Updated dependencies [0fff51b]
+  - cdk8s-kbld2@0.1.0

package/README.md

@@ -0,0 +1,82 @@
+# cdk8s-local
+
+**TLDR: A function to wrap your cdk8s app with a CLI interface that enables quick deploying to a local k3d cluster.**
+
+Whenever I use cdk8s, I find myself writing a simple CLI tool that synthesises my app, builds the container images and deploys it to a local k3d cluster, so I can test my changes quickly. So this package provides a function to do just that, with minimal boilerplate.
+
+In addition, the CLI wrapper includes support for [`cdk8s-kbld2`](../cdk8s-kbld2/README.md) out of the box, so you can easily run your manifests through `kbld` after synth automatically.
+
+```sh
+# Note: only bun is currently supported as I use `bun` to run shell commands (`kbld`, `kapp`, `k3d`, etc) internally.
+bun i cdk8s-local
+```
+
+```ts
+import { App } from "cdk8s";
+import { cdk8sLocal } from "cdk8s-local";
+import { option, optional, string } from "cmd-ts";
+import { YourConstruct } from "./your-code";
+
+await cdk8sLocal({
+	args: {
+		someCustomArg: option({
+			type: optional(string),
+			long: "some-custom-arg",
+			short: "a",
+			description: "a custom argument you can use for whatever you want, i usually use one to select a config file.",
+		}),
+	},
+	async synth({ args: { someCustomArg }, registry }) {
+		// In this function, construct your app as usual, and return the final app instance.
+		const app = new App();
+
+		new YourConstruct(app, {
+			someCustomArg,
+			registry,
+		});
+
+		return app;
+	},
+	k3d: {
+		// k3d cluster configuration can be customised here:
+		servers: 3,
+		ports: [
+			{
+				containerPort: 80,
+				hostPort: 8080,
+			},
+			{
+				containerPort: 443,
+				hostPort: 8443,
+			},
+		],
+		// Some convenience options I find useful have been added:
+		configureCilium: true,
+		disableTraefik: true,
+	},
+});
+```
+
+You can then deploy your app locally with:
+
+```
+bun local.ts --some-custom-arg value
+```
+
+> The wrapper depends on some CLI tools being available on your PATH, primarily `k3d`, `kapp`, `kbld` (even if you don't use `cdk8s-kbld2` or the image build step, sorry), `kubectl` and `docker`. The wrapper will check for these and throw an error if they are not found.
+
+## cdk8s-kbld2 Integration
+
+If a `KbldConfig` construct is detected in your app, `kbld` will be automatically run against your app's generated manifests, and the resulting manifests will be dumped to stdout.
+
+## Local Registry
+
+By default, a local registry will be created by k3d for you to push your images to. This registry is passed to your `synth` function so you can push images to it (e.g. with `cdk8s-kbld2` - or `cdk8s-image` if you really want to).
+
+> Security note: This package uses a subdomain of `k3d.hamishwhc.com`, which resolves to localhost, as the name of the local registry. There _is_ potential here for me to swap the DNS record out from under you in a DNS rebinding attack - if you are concerned, you can set up your own DNS entry that resolves to localhost and pass that in via `k3d.registryName`. See [the related k3d documentation](https://k3d.io/v5.1.0/usage/registries/#preface-referencing-local-registries) - this is a method of achieving option 2 here, without needing to modify `/etc/hosts`.
+
+## Configuration
+
+All configuration options include documentation within the property descriptions, so you can hover over them in your IDE to see what they do.
+
+Some convenience options have been added to the `k3d` configuration to make local development easier. The most notable is `configureCilium`, which sets up k3d as compatible with Cilium by disabling the default CNI and network policies, and then running some ✨ magic ✨ `docker` commands (note that magic here means that I do not understand what the f\*ck they are doing but they do seem to work for me). This option may be rather brittle, so if you run into issues please open an issue or PR!

package/dist/config.d.mts

@@ -0,0 +1,92 @@
+import { DefaultArgs } from "./default-args.mjs";
+import { K3dConfig } from "./k3d-config/index.mjs";
+import { RequiredProgram } from "./requirements.mjs";
+import { ArgTypes, Output } from "@repo/utils/cmd-ts-types";
+import { Awaitable } from "@repo/utils/awaitable";
+import { CommonContext, CommonStartupContext } from "@repo/utils/cli-contexts";
+import { App } from "cdk8s";
+
+//#region src/config.d.ts
+interface StartupContext<Args> extends CommonStartupContext<Args, "local"> {}
+interface Context<Args, Data> extends CommonContext<Args, Data, "local"> {}
+interface SynthContext<Args, Data> extends Context<Args, Data> {
+  /**
+   * Indicates whether the k3d cluster was created during this run.
+   */
+  create: boolean;
+  /**
+   * Information about the k3d local registry.
+   */
+  registry: {
+    name: string;
+    port: number;
+  } | null;
+}
+interface Config<Arguments extends ArgTypes, Data, ParentArguments extends ArgTypes = {}> {
+  /**
+   * `cmd-ts` argument definitions for the CLI. This will be merged with the default arguments provided by `cdk8s-local`,
+   * and passed to your hooks and synth function.
+   *
+   * You can use this to add your own CLI arguments to allow users to configure your CDK8s app generation.
+   */
+  args?: Arguments;
+  /**
+   * A function which synthesizes your CDK8s app. Is expected to return an `App` instance.
+   */
+  synth: (ctx: SynthContext<Output<Arguments & ParentArguments & DefaultArgs>, Data>) => Awaitable<App>;
+  /**
+   * Optional configuration for the generated `cmd-ts` command.
+   */
+  command?: {
+    /**
+     * @default "local"
+     */
+    name?: string;
+    /**
+     * @default "Synthesises, builds and deploys your CDK8s app to a local k3d cluster."
+     */
+    description?: string;
+  };
+  /**
+   * The name of the k3d cluster to create/use.
+   *
+   * This is used during cluster creation and when checking for an existing cluster,
+   * so it is specified separately from the other k3d configuration.
+   * You can still dynamically generate it if you want.
+   *
+   * @default "cdk8s-local"
+   */
+  clusterName?: string | ((ctx: Context<Output<Arguments & ParentArguments & DefaultArgs>, Data>) => Awaitable<string>);
+  /**
+   * k3d configuration.
+   */
+  k3d?: K3dConfig | ((ctx: Context<Output<Arguments & ParentArguments & DefaultArgs>, Data>) => Awaitable<K3dConfig>);
+  /**
+   * Programs used under the hood by your CDK8s app which must be installed for the CLI to work.
+   * This is in addition to the default required programs used by `cdk8s-local`.
+   *
+   * e.g. If you are using `Helm` constructs in your app, you should add `helm` here.
+   */
+  requirements?: RequiredProgram[] | ((ctx: StartupContext<Output<Arguments & ParentArguments & DefaultArgs>>) => Awaitable<RequiredProgram[]>);
+  /**
+   * These hooks run at various points and allow you to customize the CLI's behavior.
+   */
+  hooks?: {
+    /**
+     * A function that will run immediately on startup, but with access to the parsed CLI arguments.
+     *
+     * You can return custom data that will be passed to subsequent hooks and the synth function.
+     */
+    startup?: (ctx: StartupContext<Output<Arguments & ParentArguments & DefaultArgs>>) => Awaitable<Data | void>;
+    /**
+     * A function that will run just before synthesis. If you are using `cdk8s-local`, you probably don't need this,
+     * but you may want to use it with `cdk8s-opinionated-cli`, so you can use a common synth function.
+     *
+     * You can return custom data that will be passed to subsequent hooks and the synth function.
+     */
+    preSynth?: (ctx: SynthContext<Output<Arguments & ParentArguments & DefaultArgs>, Data>) => Awaitable<Data | void>;
+  };
+}
+//#endregion
+export { Config };
+//# sourceMappingURL=config.d.mts.map

package/dist/config.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.mts","names":[],"sources":["../src/config.ts"],"mappings":";;;;;;;;;UAQiB,cAAA,eAA6B,oBAAA,CAAqB,IAAA;AAAA,UAClD,OAAA,qBAA4B,aAAA,CAAc,IAAA,EAAM,IAAA;AAAA,UAEhD,YAAA,qBAAiC,OAAA,CAAQ,IAAA,EAAM,IAAA;EAHE;;;EAOjE,MAAA;EAPsE;;AACvE;EAUC,QAAA;IACC,IAAA;IACA,IAAA;EAAA;AAAA;AAAA,UAIe,MAAA,mBAAyB,QAAA,gCAAwC,QAAA;EAhBxB;;;;;;EAuBzD,IAAA,GAAO,SAAA;EAvB6D;AAErE;;EAyBC,KAAA,GAAQ,GAAA,EAAK,YAAA,CAAa,MAAA,CAAO,SAAA,GAAY,eAAA,GAAkB,WAAA,GAAc,IAAA,MAAU,SAAA,CAAU,GAAA;EAzBxC;;;EA8BzD,OAAA;IA9BwD;;;IAkCvD,IAAA;IAlCwD;;;IAsCxD,WAAA;EAAA;EA5BA;;;AAIF;;;;;;EAoCC,WAAA,cAAyB,GAAA,EAAK,OAAA,CAAQ,MAAA,CAAO,SAAA,GAAY,eAAA,GAAkB,WAAA,GAAc,IAAA,MAAU,SAAA;EAzBtD;;;EA6B7C,GAAA,GAAM,SAAA,KAAc,GAAA,EAAK,OAAA,CAAQ,MAAA,CAAO,SAAA,GAAY,eAAA,GAAkB,WAAA,GAAc,IAAA,MAAU,SAAA,CAAU,SAAA;EA7B3F;;;;;;EAqCb,YAAA,GACG,eAAA,OACE,GAAA,EAAK,cAAA,CAAe,MAAA,CAAO,SAAA,GAAY,eAAA,GAAkB,WAAA,OAAkB,SAAA,CAAU,eAAA;EAdD;;;EAmBzF,KAAA;IAfwC;;;;;IAqBvC,OAAA,IAAW,GAAA,EAAK,cAAA,CAAe,MAAA,CAAO,SAAA,GAAY,eAAA,GAAkB,WAAA,OAAkB,SAAA,CAAU,IAAA;IArBO;;;;;;IA4BvG,QAAA,IAAY,GAAA,EAAK,YAAA,CAAa,MAAA,CAAO,SAAA,GAAY,eAAA,GAAkB,WAAA,GAAc,IAAA,MAAU,SAAA,CAAU,IAAA;EAAA;AAAA"}

package/dist/default-args.d.mts

@@ -0,0 +1,19 @@
+import * as cmd_ts_dist_cjs_argparser0 from "cmd-ts/dist/cjs/argparser";
+import * as cmd_ts_dist_cjs_helpdoc0 from "cmd-ts/dist/cjs/helpdoc";
+
+//#region src/default-args.d.ts
+declare const defaultArgs: {
+  recreate: Partial<cmd_ts_dist_cjs_argparser0.Register> & {
+    parse(context: cmd_ts_dist_cjs_argparser0.ParseContext): Promise<cmd_ts_dist_cjs_argparser0.ParsingResult<boolean>>;
+  } & cmd_ts_dist_cjs_helpdoc0.ProvidesHelp & cmd_ts_dist_cjs_argparser0.Register & Partial<cmd_ts_dist_cjs_helpdoc0.Descriptive>;
+  synth: Partial<cmd_ts_dist_cjs_argparser0.Register> & {
+    parse(context: cmd_ts_dist_cjs_argparser0.ParseContext): Promise<cmd_ts_dist_cjs_argparser0.ParsingResult<boolean>>;
+  } & cmd_ts_dist_cjs_helpdoc0.ProvidesHelp & cmd_ts_dist_cjs_argparser0.Register & Partial<cmd_ts_dist_cjs_helpdoc0.Descriptive>;
+  build: Partial<cmd_ts_dist_cjs_argparser0.Register> & {
+    parse(context: cmd_ts_dist_cjs_argparser0.ParseContext): Promise<cmd_ts_dist_cjs_argparser0.ParsingResult<boolean>>;
+  } & cmd_ts_dist_cjs_helpdoc0.ProvidesHelp & cmd_ts_dist_cjs_argparser0.Register & Partial<cmd_ts_dist_cjs_helpdoc0.Descriptive>;
+};
+type DefaultArgs = typeof defaultArgs;
+//#endregion
+export { DefaultArgs };
+//# sourceMappingURL=default-args.d.mts.map

package/dist/default-args.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-args.d.mts","names":[],"sources":["../src/default-args.ts"],"mappings":";;;;cAEa,WAAA;oBAmBZ,0BAAA,CAAA,QAAA;;;;;;;;;;KACW,WAAA,UAAqB,WAAA"}

package/dist/default-args.mjs

@@ -0,0 +1,27 @@
+import { boolean, flag } from "cmd-ts";
+
+//#region src/default-args.ts
+const defaultArgs = {
+	recreate: flag({
+		type: boolean,
+		short: "r",
+		long: "recreate",
+		description: "delete and recreate the local cluster"
+	}),
+	synth: flag({
+		type: boolean,
+		short: "s",
+		long: "synth",
+		description: "only run the synth step, skip build and deploy steps (will skip cluster creation)"
+	}),
+	build: flag({
+		type: boolean,
+		short: "b",
+		long: "build",
+		description: "only run the synth and build (and push) steps, skip deploy step (will NOT skip cluster creation)"
+	})
+};
+
+//#endregion
+export { defaultArgs };
+//# sourceMappingURL=default-args.mjs.map

package/dist/default-args.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-args.mjs","names":[],"sources":["../src/default-args.ts"],"sourcesContent":["import { boolean, flag } from \"cmd-ts\";\n\nexport const defaultArgs = {\n\trecreate: flag({\n\t\ttype: boolean,\n\t\tshort: \"r\",\n\t\tlong: \"recreate\",\n\t\tdescription: \"delete and recreate the local cluster\",\n\t}),\n\tsynth: flag({\n\t\ttype: boolean,\n\t\tshort: \"s\",\n\t\tlong: \"synth\",\n\t\tdescription: \"only run the synth step, skip build and deploy steps (will skip cluster creation)\",\n\t}),\n\tbuild: flag({\n\t\ttype: boolean,\n\t\tshort: \"b\",\n\t\tlong: \"build\",\n\t\tdescription: \"only run the synth and build (and push) steps, skip deploy step (will NOT skip cluster creation)\",\n\t}),\n};\nexport type DefaultArgs = typeof defaultArgs;\n"],"mappings":";;;AAEA,MAAa,cAAc;CAC1B,UAAU,KAAK;EACd,MAAM;EACN,OAAO;EACP,MAAM;EACN,aAAa;EACb,CAAC;CACF,OAAO,KAAK;EACX,MAAM;EACN,OAAO;EACP,MAAM;EACN,aAAa;EACb,CAAC;CACF,OAAO,KAAK;EACX,MAAM;EACN,OAAO;EACP,MAAM;EACN,aAAa;EACb,CAAC;CACF"}

package/dist/get-k3d-nodes.mjs

@@ -0,0 +1,10 @@
+import { $ } from "bun";
+
+//#region src/get-k3d-nodes.ts
+async function getK3dNodes(clusterName) {
+	return await $`k3d node list -o json`.json();
+}
+
+//#endregion
+export { getK3dNodes };
+//# sourceMappingURL=get-k3d-nodes.mjs.map

package/dist/get-k3d-nodes.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-k3d-nodes.mjs","names":[],"sources":["../src/get-k3d-nodes.ts"],"sourcesContent":["import { $ } from \"bun\";\n\nexport interface HostBinding {\n\tHostIp: string;\n\tHostPort: string;\n}\n\nexport interface K3dNode {\n\tname: string;\n\trole: \"server\" | \"agent\" | \"loadbalancer\" | \"registry\";\n\tportMappings: Record<string, HostBinding[]>;\n}\n\nexport async function getK3dNodes(clusterName: string): Promise<K3dNode[]> {\n\tconst nodes: K3dNode[] = await $`k3d node list -o json`.json();\n\treturn nodes;\n}\n"],"mappings":";;;AAaA,eAAsB,YAAY,aAAyC;AAE1E,QADyB,MAAM,CAAC,wBAAwB,MAAM"}

package/dist/get-registry.d.mts

@@ -0,0 +1,8 @@
+//#region src/get-registry.d.ts
+interface RegistryInfo {
+  name: string;
+  port: number;
+}
+//#endregion
+export { RegistryInfo };
+//# sourceMappingURL=get-registry.d.mts.map

package/dist/get-registry.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-registry.d.mts","names":[],"sources":["../src/get-registry.ts"],"mappings":";UAEiB,YAAA;EAChB,IAAA;EACA,IAAA;AAAA"}

package/dist/get-registry.mjs

@@ -0,0 +1,17 @@
+import { getK3dNodes } from "./get-k3d-nodes.mjs";
+
+//#region src/get-registry.ts
+async function getRegistry(clusterName) {
+	const registryNode = (await getK3dNodes(clusterName)).find((node) => node.role === "registry");
+	if (!registryNode) return null;
+	const registryBindings = registryNode.portMappings["5000/tcp"];
+	if (!registryBindings || registryBindings.length === 0) return null;
+	return {
+		name: registryNode.name,
+		port: parseInt(registryBindings[0].HostPort)
+	};
+}
+
+//#endregion
+export { getRegistry };
+//# sourceMappingURL=get-registry.mjs.map

package/dist/get-registry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-registry.mjs","names":[],"sources":["../src/get-registry.ts"],"sourcesContent":["import { getK3dNodes } from \"./get-k3d-nodes\";\n\nexport interface RegistryInfo {\n\tname: string;\n\tport: number;\n}\n\nexport async function getRegistry(clusterName: string): Promise<RegistryInfo | null> {\n\tconst nodes = await getK3dNodes(clusterName);\n\tconst registryNode = nodes.find((node) => node.role === \"registry\");\n\tif (!registryNode) {\n\t\treturn null;\n\t}\n\n\tconst registryBindings = registryNode.portMappings[\"5000/tcp\"];\n\tif (!registryBindings || registryBindings.length === 0) {\n\t\treturn null;\n\t}\n\n\treturn {\n\t\tname: registryNode.name,\n\t\tport: parseInt(registryBindings[0]!.HostPort),\n\t};\n}\n"],"mappings":";;;AAOA,eAAsB,YAAY,aAAmD;CAEpF,MAAM,gBADQ,MAAM,YAAY,YAAY,EACjB,MAAM,SAAS,KAAK,SAAS,WAAW;AACnE,KAAI,CAAC,aACJ,QAAO;CAGR,MAAM,mBAAmB,aAAa,aAAa;AACnD,KAAI,CAAC,oBAAoB,iBAAiB,WAAW,EACpD,QAAO;AAGR,QAAO;EACN,MAAM,aAAa;EACnB,MAAM,SAAS,iBAAiB,GAAI,SAAS;EAC7C"}

package/dist/index.d.mts

@@ -0,0 +1,53 @@
+import { K3DSimpleConfigV1Alpha5 } from "./k3d-config/v1alpha5.mjs";
+import { BindMountVolume, EnvironmentVariable, K3dConfig, K3dConfigResolution, K3dSimpleConfig, K3sArg, Port } from "./k3d-config/index.mjs";
+import { CommonRequirements } from "./requirements.mjs";
+import { Config } from "./config.mjs";
+import isWsl from "is-wsl";
+import * as cmd_ts_dist_cjs_argparser0 from "cmd-ts/dist/cjs/argparser";
+import * as cmd_ts_dist_cjs_helpdoc0 from "cmd-ts/dist/cjs/helpdoc";
+import * as cmd_ts_dist_cjs_runner0 from "cmd-ts/dist/cjs/runner";
+import { ArgTypes } from "@repo/utils/cmd-ts-types";
+
+//#region src/index.d.ts
+/**
+ * Creates a cdk8s-local CLI command based on the provided configuration.
+ *
+ * Unless you want to integrate a cdk8s-local command into an existing cmd-ts CLI, you probably want to use `cdk8sLocal` instead.
+ */
+declare function cdk8sLocalCommand<Arguments extends ArgTypes, Data>(config: Config<Arguments, Data>): Partial<cmd_ts_dist_cjs_argparser0.Register> & {
+  parse(context: cmd_ts_dist_cjs_argparser0.ParseContext): Promise<cmd_ts_dist_cjs_argparser0.ParsingResult<Arguments & {
+    recreate: Partial<cmd_ts_dist_cjs_argparser0.Register> & {
+      parse(context: cmd_ts_dist_cjs_argparser0.ParseContext): Promise<cmd_ts_dist_cjs_argparser0.ParsingResult<boolean>>;
+    } & cmd_ts_dist_cjs_helpdoc0.ProvidesHelp & cmd_ts_dist_cjs_argparser0.Register & Partial<cmd_ts_dist_cjs_helpdoc0.Descriptive>;
+    synth: Partial<cmd_ts_dist_cjs_argparser0.Register> & {
+      parse(context: cmd_ts_dist_cjs_argparser0.ParseContext): Promise<cmd_ts_dist_cjs_argparser0.ParsingResult<boolean>>;
+    } & cmd_ts_dist_cjs_helpdoc0.ProvidesHelp & cmd_ts_dist_cjs_argparser0.Register & Partial<cmd_ts_dist_cjs_helpdoc0.Descriptive>;
+    build: Partial<cmd_ts_dist_cjs_argparser0.Register> & {
+      parse(context: cmd_ts_dist_cjs_argparser0.ParseContext): Promise<cmd_ts_dist_cjs_argparser0.ParsingResult<boolean>>;
+    } & cmd_ts_dist_cjs_helpdoc0.ProvidesHelp & cmd_ts_dist_cjs_argparser0.Register & Partial<cmd_ts_dist_cjs_helpdoc0.Descriptive>;
+  } extends infer T extends {
+    [x: string]: Partial<cmd_ts_dist_cjs_argparser0.Register> & {
+      parse(context: cmd_ts_dist_cjs_argparser0.ParseContext): Promise<cmd_ts_dist_cjs_argparser0.ParsingResult<any>>;
+    } & Partial<cmd_ts_dist_cjs_helpdoc0.ProvidesHelp>;
+  } ? { [key in keyof T]: cmd_ts_dist_cjs_argparser0.ParsingInto<T[key]> } : never>>;
+} & cmd_ts_dist_cjs_helpdoc0.PrintHelp & cmd_ts_dist_cjs_helpdoc0.ProvidesHelp & cmd_ts_dist_cjs_helpdoc0.Named & Partial<cmd_ts_dist_cjs_helpdoc0.Versioned> & cmd_ts_dist_cjs_argparser0.Register & cmd_ts_dist_cjs_runner0.Handling<Arguments & {
+  recreate: Partial<cmd_ts_dist_cjs_argparser0.Register> & {
+    parse(context: cmd_ts_dist_cjs_argparser0.ParseContext): Promise<cmd_ts_dist_cjs_argparser0.ParsingResult<boolean>>;
+  } & cmd_ts_dist_cjs_helpdoc0.ProvidesHelp & cmd_ts_dist_cjs_argparser0.Register & Partial<cmd_ts_dist_cjs_helpdoc0.Descriptive>;
+  synth: Partial<cmd_ts_dist_cjs_argparser0.Register> & {
+    parse(context: cmd_ts_dist_cjs_argparser0.ParseContext): Promise<cmd_ts_dist_cjs_argparser0.ParsingResult<boolean>>;
+  } & cmd_ts_dist_cjs_helpdoc0.ProvidesHelp & cmd_ts_dist_cjs_argparser0.Register & Partial<cmd_ts_dist_cjs_helpdoc0.Descriptive>;
+  build: Partial<cmd_ts_dist_cjs_argparser0.Register> & {
+    parse(context: cmd_ts_dist_cjs_argparser0.ParseContext): Promise<cmd_ts_dist_cjs_argparser0.ParsingResult<boolean>>;
+  } & cmd_ts_dist_cjs_helpdoc0.ProvidesHelp & cmd_ts_dist_cjs_argparser0.Register & Partial<cmd_ts_dist_cjs_helpdoc0.Descriptive>;
+} extends infer T extends {
+  [x: string]: Partial<cmd_ts_dist_cjs_argparser0.Register> & {
+    parse(context: cmd_ts_dist_cjs_argparser0.ParseContext): Promise<cmd_ts_dist_cjs_argparser0.ParsingResult<any>>;
+  } & Partial<cmd_ts_dist_cjs_helpdoc0.ProvidesHelp>;
+} ? { [key in keyof T]: cmd_ts_dist_cjs_argparser0.ParsingInto<T[key]> } : never, Promise<1 | undefined>> & {
+  run(context: cmd_ts_dist_cjs_argparser0.ParseContext): Promise<cmd_ts_dist_cjs_argparser0.ParsingResult<Promise<1 | undefined>>>;
+} & Partial<cmd_ts_dist_cjs_helpdoc0.Versioned & cmd_ts_dist_cjs_helpdoc0.Descriptive & cmd_ts_dist_cjs_helpdoc0.Aliased>;
+declare function cdk8sLocal<Arguments extends ArgTypes, Data>(config: Config<Arguments, Data>): Promise<void>;
+//#endregion
+export { type BindMountVolume, CommonRequirements, Config, type EnvironmentVariable, type K3DSimpleConfigV1Alpha5, type K3dConfig, type K3dConfigResolution, type K3dSimpleConfig, type K3sArg, type Port, cdk8sLocal, cdk8sLocalCommand, isWsl };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;;;;;;;;;;iBAoCgB,iBAAA,mBAAoC,QAAA,OAAA,CAAgB,MAAA,EAAQ,MAAA,CAAO,SAAA,EAAW,IAAA,IAAK,OAAA,CAAjB,0BAAA,CAAiB,QAAA;iBAAA,0BAAA,CAAA,YAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiK7E,UAAA,mBAA6B,QAAA,OAAA,CAAgB,MAAA,EAAQ,MAAA,CAAO,SAAA,EAAW,IAAA,IAAK,OAAA"}

package/dist/index.mjs

@@ -0,0 +1,153 @@
+import { defaultArgs } from "./default-args.mjs";
+import { getK3dNodes } from "./get-k3d-nodes.mjs";
+import { getRegistry } from "./get-registry.mjs";
+import { resolveK3dConfig } from "./k3d-config/index.mjs";
+import { DEFAULT_REQUIREMENTS, checkRequirements } from "./requirements.mjs";
+import { logger } from "@repo/utils/logger";
+import { resolveThunk } from "@repo/utils/thunk";
+import { $ } from "bun";
+import { KbldConfig } from "cdk8s-kbld2";
+import { binary, command, run } from "cmd-ts";
+import { ConstructOrder } from "constructs";
+import { rm } from "fs/promises";
+import isWsl from "is-wsl";
+import path from "path";
+
+//#region src/index.ts
+/**
+* Creates a cdk8s-local CLI command based on the provided configuration.
+*
+* Unless you want to integrate a cdk8s-local command into an existing cmd-ts CLI, you probably want to use `cdk8sLocal` instead.
+*/
+function cdk8sLocalCommand(config) {
+	return command({
+		name: config.command?.name ?? "local",
+		description: config.command?.description ?? "Synthesises, builds and deploys your CDK8s app to a local k3d cluster.",
+		args: {
+			...config.args,
+			...defaultArgs
+		},
+		handler: async (args) => {
+			const startupCtx = {
+				args,
+				command: "local"
+			};
+			const additionalRequirements = await resolveThunk(config.requirements, startupCtx) ?? [];
+			await checkRequirements([...DEFAULT_REQUIREMENTS, ...additionalRequirements]);
+			const ctx = {
+				...startupCtx,
+				data: await config.hooks?.startup?.(startupCtx) ?? {}
+			};
+			const clusterName = await resolveThunk(config.clusterName, ctx) ?? "cdk8s-local";
+			const clusterGetProc = await $`k3d cluster get ${clusterName}`.throws(false).quiet();
+			let create = true;
+			if (clusterGetProc.exitCode === 0) if (args.recreate) {
+				logger.info("Deleting existing k3d cluster...");
+				await $`k3d cluster delete ${clusterName}`.quiet();
+			} else create = false;
+			let registry = create ? null : await getRegistry(clusterName);
+			let k3dConfigResolution = null;
+			if (create) {
+				k3dConfigResolution = await resolveK3dConfig(clusterName, await resolveThunk(config.k3d, ctx));
+				registry = k3dConfigResolution.registry;
+			}
+			const synthCtx = {
+				...ctx,
+				create,
+				registry
+			};
+			synthCtx.data = await config.hooks?.preSynth?.(synthCtx) ?? synthCtx.data;
+			logger.info("Running synth (generating manifests)...");
+			const app = await config.synth(synthCtx);
+			await rm(app.outdir, {
+				recursive: true,
+				force: true
+			});
+			app.synth();
+			if (args.synth) {
+				logger.info("Synth complete, skipping build and deploy, find manifests in " + path.relative(process.cwd(), app.outdir));
+				return;
+			}
+			if (k3dConfigResolution) {
+				logger.info(`Creating k3d cluster (${clusterName})...`);
+				if (k3dConfigResolution.originalConfig?.configureCilium && isWsl) {
+					logger.warn("Cilium configuration is not supported on WSL, skipping Cilium setup for k3d.");
+					k3dConfigResolution.originalConfig.configureCilium = false;
+				}
+				for (const volume of k3dConfigResolution.originalConfig?.volumes ?? []) {
+					if (volume.deleteOnClusterCreate) await rm(volume.hostPath, {
+						recursive: true,
+						force: true
+					});
+					await $`mkdir -p ${volume.hostPath}`;
+				}
+				await $`k3d cluster create -c - < ${Buffer.from(k3dConfigResolution.resolvedConfig, "utf-8")}`;
+				if (k3dConfigResolution.originalConfig?.configureCilium) {
+					const nodes = await getK3dNodes(clusterName);
+					for (const { name, role } of nodes) {
+						if (role !== "server" && role !== "agent") continue;
+						await $`docker exec -it ${name} mount bpffs /sys/fs/bpf -t bpf`;
+						await $`docker exec -it ${name} mount --make-shared /sys/fs/bpf`;
+						await $`docker exec -it ${name} mkdir -p /run/cilium/cgroupv2`;
+						await $`docker exec -it ${name} mount -t cgroup2 none /run/cilium/cgroupv2`;
+						await $`docker exec -it ${name} mount --make-shared /run/cilium/cgroupv2`;
+						await $`docker exec -it ${name} mount --make-rshared /var/run`;
+					}
+				}
+			}
+			let manifestSource = {
+				type: "directory",
+				path: app.outdir
+			};
+			if (app.node.findAll(ConstructOrder.POSTORDER).find((c) => c instanceof KbldConfig)) {
+				logger.info("Detected kbld config construct, running kbld...");
+				try {
+					manifestSource = {
+						type: "buffer",
+						buffer: await $`kbld -f ${app.outdir}`.arrayBuffer()
+					};
+				} catch (e) {
+					if (e instanceof $.ShellError) {
+						logger.error(e.stderr.toString("utf-8"));
+						logger.fatal("Failed to build images from manifests.");
+						return 1;
+					}
+					throw e;
+				}
+			} else if (args.build) logger.warn("The --build flag was set but no kbld config was found in the app. Skipping build step - no manifests will be emitted on stdout.");
+			if (args.build) {
+				if (manifestSource.type === "buffer") process.stdout.write(Buffer.from(manifestSource.buffer));
+				return;
+			}
+			logger.info("Applying manifests to local cluster...");
+			const context = (await $`kubectl config current-context`.text()).trim();
+			if (context !== `k3d-${clusterName}`) {
+				logger.fatal(`Will not deploy local environment to context: ${context}`);
+				return 1;
+			}
+			try {
+				const commonArguments = [
+					"-y",
+					"-a",
+					clusterName
+				];
+				if (manifestSource.type === "directory") await $`kapp deploy ${commonArguments} -f ${manifestSource.path}`;
+				else await $`kapp deploy ${commonArguments} -f - < ${manifestSource.buffer}`;
+			} catch (e) {
+				if (e instanceof $.ShellError) {
+					logger.fatal("Failed to deploy manifests to local cluster.");
+					return 1;
+				}
+				throw e;
+			}
+			logger.info("Local deployment successful.");
+		}
+	});
+}
+async function cdk8sLocal(config) {
+	await run(binary(cdk8sLocalCommand(config)), process.argv);
+}
+
+//#endregion
+export { cdk8sLocal, cdk8sLocalCommand, isWsl };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { ArgTypes } from \"@repo/utils/cmd-ts-types\";\nimport { logger } from \"@repo/utils/logger\";\nimport { resolveThunk } from \"@repo/utils/thunk\";\nimport { $ } from \"bun\";\nimport { KbldConfig } from \"cdk8s-kbld2\";\nimport { binary, command, run } from \"cmd-ts\";\nimport { ConstructOrder } from \"constructs\";\nimport { rm } from \"fs/promises\";\nimport isWsl from \"is-wsl\";\nimport path from \"path\";\nimport type { Config } from \"./config\";\nimport { defaultArgs } from \"./default-args\";\nimport { getK3dNodes } from \"./get-k3d-nodes\";\nimport { getRegistry } from \"./get-registry\";\nimport { resolveK3dConfig, type K3dConfigResolution } from \"./k3d-config\";\nimport { checkRequirements, DEFAULT_REQUIREMENTS, type CommonRequirements } from \"./requirements\";\n\ntype ManifestSource = { type: \"directory\"; path: string } | { type: \"buffer\"; buffer: ArrayBuffer };\n\nexport type {\n\tBindMountVolume,\n\tEnvironmentVariable,\n\tK3dConfig,\n\tK3dConfigResolution,\n\tK3dSimpleConfig,\n\tK3DSimpleConfigV1Alpha5,\n\tK3sArg,\n\tPort,\n} from \"./k3d-config\";\nexport { CommonRequirements, Config, isWsl };\n\n/**\n * Creates a cdk8s-local CLI command based on the provided configuration.\n *\n * Unless you want to integrate a cdk8s-local command into an existing cmd-ts CLI, you probably want to use `cdk8sLocal` instead.\n */\nexport function cdk8sLocalCommand<Arguments extends ArgTypes, Data>(config: Config<Arguments, Data>) {\n\treturn command({\n\t\tname: config.command?.name ?? \"local\",\n\t\tdescription:\n\t\t\tconfig.command?.description ?? \"Synthesises, builds and deploys your CDK8s app to a local k3d cluster.\",\n\t\targs: {\n\t\t\t...config.args!,\n\t\t\t...defaultArgs,\n\t\t},\n\t\thandler: async (args) => {\n\t\t\tconst startupCtx = { args, command: \"local\" as const };\n\t\t\tconst additionalRequirements = (await resolveThunk(config.requirements, startupCtx)) ?? [];\n\t\t\tawait checkRequirements([...DEFAULT_REQUIREMENTS, ...additionalRequirements]);\n\n\t\t\tconst ctx = {\n\t\t\t\t...startupCtx,\n\t\t\t\tdata: (await config.hooks?.startup?.(startupCtx)) ?? ({} as Data),\n\t\t\t};\n\n\t\t\tconst clusterName = (await resolveThunk(config.clusterName, ctx)) ?? \"cdk8s-local\";\n\n\t\t\tconst clusterGetProc = await $`k3d cluster get ${clusterName}`.throws(false).quiet();\n\t\t\tlet create = true;\n\t\t\tif (clusterGetProc.exitCode === 0) {\n\t\t\t\tif (args.recreate) {\n\t\t\t\t\tlogger.info(\"Deleting existing k3d cluster...\");\n\t\t\t\t\tawait $`k3d cluster delete ${clusterName}`.quiet();\n\t\t\t\t} else {\n\t\t\t\t\tcreate = false;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tlet registry = create ? null : await getRegistry(clusterName);\n\t\t\tlet k3dConfigResolution: K3dConfigResolution | null = null;\n\n\t\t\tif (create) {\n\t\t\t\tconst k3dConfig = await resolveThunk(config.k3d, ctx);\n\t\t\t\tk3dConfigResolution = await resolveK3dConfig(clusterName, k3dConfig);\n\t\t\t\tregistry = k3dConfigResolution.registry;\n\t\t\t}\n\n\t\t\tconst synthCtx = {\n\t\t\t\t...ctx,\n\t\t\t\tcreate,\n\t\t\t\tregistry,\n\t\t\t};\n\t\t\tsynthCtx.data = (await config.hooks?.preSynth?.(synthCtx)) ?? synthCtx.data;\n\n\t\t\tlogger.info(\"Running synth (generating manifests)...\");\n\t\t\tconst app = await config.synth(synthCtx);\n\t\t\tawait rm(app.outdir, { recursive: true, force: true });\n\t\t\tapp.synth();\n\n\t\t\tif (args.synth) {\n\t\t\t\tlogger.info(\n\t\t\t\t\t\"Synth complete, skipping build and deploy, find manifests in \" + path.relative(process.cwd(), app.outdir),\n\t\t\t\t);\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tif (k3dConfigResolution) {\n\t\t\t\tlogger.info(`Creating k3d cluster (${clusterName})...`);\n\t\t\t\tif (k3dConfigResolution.originalConfig?.configureCilium && isWsl) {\n\t\t\t\t\tlogger.warn(\"Cilium configuration is not supported on WSL, skipping Cilium setup for k3d.\");\n\t\t\t\t\tk3dConfigResolution.originalConfig.configureCilium = false;\n\t\t\t\t}\n\n\t\t\t\tfor (const volume of k3dConfigResolution.originalConfig?.volumes ?? []) {\n\t\t\t\t\tif (volume.deleteOnClusterCreate) {\n\t\t\t\t\t\tawait rm(volume.hostPath, { recursive: true, force: true });\n\t\t\t\t\t}\n\t\t\t\t\tawait $`mkdir -p ${volume.hostPath}`;\n\t\t\t\t}\n\n\t\t\t\tconst configBuffer = Buffer.from(k3dConfigResolution.resolvedConfig, \"utf-8\");\n\t\t\t\tawait $`k3d cluster create -c - < ${configBuffer}`;\n\n\t\t\t\tif (k3dConfigResolution.originalConfig?.configureCilium) {\n\t\t\t\t\tconst nodes = await getK3dNodes(clusterName);\n\t\t\t\t\tfor (const { name, role } of nodes) {\n\t\t\t\t\t\tif (role !== \"server\" && role !== \"agent\") {\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\t// Magic to make Cilium work on MacOS (and hopefully Linux) Docker Desktop/OrbStack:\n\t\t\t\t\t\t// - https://sandstorm.de/blog/posts/running-cilium-in-k3s-and-k3d-lightweight-kubernetes-on-mac-os-for-development\n\t\t\t\t\t\t// - https://github.com/cilium/cilium/issues/10516\n\t\t\t\t\t\t// - https://github.com/k3d-io/k3d/issues/363\n\t\t\t\t\t\t// - https://docs.cilium.io/en/v1.14/installation/rancher-desktop/#rancher-desktop-install\n\t\t\t\t\t\t// - https://github.com/istio/istio/issues/54865\n\t\t\t\t\t\tawait $`docker exec -it ${name} mount bpffs /sys/fs/bpf -t bpf`;\n\t\t\t\t\t\tawait $`docker exec -it ${name} mount --make-shared /sys/fs/bpf`;\n\t\t\t\t\t\tawait $`docker exec -it ${name} mkdir -p /run/cilium/cgroupv2`;\n\t\t\t\t\t\tawait $`docker exec -it ${name} mount -t cgroup2 none /run/cilium/cgroupv2`;\n\t\t\t\t\t\tawait $`docker exec -it ${name} mount --make-shared /run/cilium/cgroupv2`;\n\t\t\t\t\t\tawait $`docker exec -it ${name} mount --make-rshared /var/run`;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tlet manifestSource: ManifestSource = { type: \"directory\" as const, path: app.outdir };\n\t\t\tif (app.node.findAll(ConstructOrder.POSTORDER).find((c) => c instanceof KbldConfig)) {\n\t\t\t\tlogger.info(\"Detected kbld config construct, running kbld...\");\n\t\t\t\ttry {\n\t\t\t\t\tmanifestSource = { type: \"buffer\" as const, buffer: await $`kbld -f ${app.outdir}`.arrayBuffer() };\n\t\t\t\t} catch (e) {\n\t\t\t\t\tif (e instanceof $.ShellError) {\n\t\t\t\t\t\tlogger.error(e.stderr.toString(\"utf-8\"));\n\t\t\t\t\t\tlogger.fatal(\"Failed to build images from manifests.\");\n\t\t\t\t\t\treturn 1;\n\t\t\t\t\t}\n\t\t\t\t\tthrow e;\n\t\t\t\t}\n\t\t\t} else if (args.build) {\n\t\t\t\tlogger.warn(\n\t\t\t\t\t\"The --build flag was set but no kbld config was found in the app. Skipping build step - no manifests will be emitted on stdout.\",\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tif (args.build) {\n\t\t\t\tif (manifestSource.type === \"buffer\") {\n\t\t\t\t\tprocess.stdout.write(Buffer.from(manifestSource.buffer));\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tlogger.info(\"Applying manifests to local cluster...\");\n\n\t\t\t// TODO: Set KUBECONFIG for kapp to use the k3d cluster config directly, rather than relying on k3d setting current-context.\n\t\t\tconst context = (await $`kubectl config current-context`.text()).trim();\n\t\t\tif (context !== `k3d-${clusterName}`) {\n\t\t\t\tlogger.fatal(`Will not deploy local environment to context: ${context}`);\n\t\t\t\t// throw new CliError(\"Current kubectl context does not match k3d cluster context.\");\n\t\t\t\treturn 1;\n\t\t\t}\n\n\t\t\t// TODO: Re-evaluate if this is needed in general - it was originally added as I used to only include CRDs when creating a cluster.\n\t\t\t// const filterJson = {\n\t\t\t// \tnot: { and: [{ ops: [\"delete\"] }, { existingResource: { kinds: [\"CustomResourceDefinition\"] } }] },\n\t\t\t// };\n\t\t\t// const filter = `--diff-filter=${JSON.stringify(filterJson)}`;\n\t\t\ttry {\n\t\t\t\tconst commonArguments = [\"-y\", \"-a\", clusterName];\n\t\t\t\tif (manifestSource.type === \"directory\") {\n\t\t\t\t\tawait $`kapp deploy ${commonArguments} -f ${manifestSource.path}`;\n\t\t\t\t} else {\n\t\t\t\t\tawait $`kapp deploy ${commonArguments} -f - < ${manifestSource.buffer}`;\n\t\t\t\t}\n\t\t\t} catch (e) {\n\t\t\t\tif (e instanceof $.ShellError) {\n\t\t\t\t\tlogger.fatal(\"Failed to deploy manifests to local cluster.\");\n\t\t\t\t\treturn 1;\n\t\t\t\t}\n\t\t\t\tthrow e;\n\t\t\t}\n\n\t\t\tlogger.info(\"Local deployment successful.\");\n\t\t},\n\t});\n}\n\nexport async function cdk8sLocal<Arguments extends ArgTypes, Data>(config: Config<Arguments, Data>) {\n\tconst cmd = cdk8sLocalCommand(config);\n\tawait run(binary(cmd), process.argv);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAoCA,SAAgB,kBAAoD,QAAiC;AACpG,QAAO,QAAQ;EACd,MAAM,OAAO,SAAS,QAAQ;EAC9B,aACC,OAAO,SAAS,eAAe;EAChC,MAAM;GACL,GAAG,OAAO;GACV,GAAG;GACH;EACD,SAAS,OAAO,SAAS;GACxB,MAAM,aAAa;IAAE;IAAM,SAAS;IAAkB;GACtD,MAAM,yBAA0B,MAAM,aAAa,OAAO,cAAc,WAAW,IAAK,EAAE;AAC1F,SAAM,kBAAkB,CAAC,GAAG,sBAAsB,GAAG,uBAAuB,CAAC;GAE7E,MAAM,MAAM;IACX,GAAG;IACH,MAAO,MAAM,OAAO,OAAO,UAAU,WAAW,IAAM,EAAE;IACxD;GAED,MAAM,cAAe,MAAM,aAAa,OAAO,aAAa,IAAI,IAAK;GAErE,MAAM,iBAAiB,MAAM,CAAC,mBAAmB,cAAc,OAAO,MAAM,CAAC,OAAO;GACpF,IAAI,SAAS;AACb,OAAI,eAAe,aAAa,EAC/B,KAAI,KAAK,UAAU;AAClB,WAAO,KAAK,mCAAmC;AAC/C,UAAM,CAAC,sBAAsB,cAAc,OAAO;SAElD,UAAS;GAIX,IAAI,WAAW,SAAS,OAAO,MAAM,YAAY,YAAY;GAC7D,IAAI,sBAAkD;AAEtD,OAAI,QAAQ;AAEX,0BAAsB,MAAM,iBAAiB,aAD3B,MAAM,aAAa,OAAO,KAAK,IAAI,CACe;AACpE,eAAW,oBAAoB;;GAGhC,MAAM,WAAW;IAChB,GAAG;IACH;IACA;IACA;AACD,YAAS,OAAQ,MAAM,OAAO,OAAO,WAAW,SAAS,IAAK,SAAS;AAEvE,UAAO,KAAK,0CAA0C;GACtD,MAAM,MAAM,MAAM,OAAO,MAAM,SAAS;AACxC,SAAM,GAAG,IAAI,QAAQ;IAAE,WAAW;IAAM,OAAO;IAAM,CAAC;AACtD,OAAI,OAAO;AAEX,OAAI,KAAK,OAAO;AACf,WAAO,KACN,kEAAkE,KAAK,SAAS,QAAQ,KAAK,EAAE,IAAI,OAAO,CAC1G;AACD;;AAGD,OAAI,qBAAqB;AACxB,WAAO,KAAK,yBAAyB,YAAY,MAAM;AACvD,QAAI,oBAAoB,gBAAgB,mBAAmB,OAAO;AACjE,YAAO,KAAK,+EAA+E;AAC3F,yBAAoB,eAAe,kBAAkB;;AAGtD,SAAK,MAAM,UAAU,oBAAoB,gBAAgB,WAAW,EAAE,EAAE;AACvE,SAAI,OAAO,sBACV,OAAM,GAAG,OAAO,UAAU;MAAE,WAAW;MAAM,OAAO;MAAM,CAAC;AAE5D,WAAM,CAAC,YAAY,OAAO;;AAI3B,UAAM,CAAC,6BADc,OAAO,KAAK,oBAAoB,gBAAgB,QAAQ;AAG7E,QAAI,oBAAoB,gBAAgB,iBAAiB;KACxD,MAAM,QAAQ,MAAM,YAAY,YAAY;AAC5C,UAAK,MAAM,EAAE,MAAM,UAAU,OAAO;AACnC,UAAI,SAAS,YAAY,SAAS,QACjC;AASD,YAAM,CAAC,mBAAmB,KAAK;AAC/B,YAAM,CAAC,mBAAmB,KAAK;AAC/B,YAAM,CAAC,mBAAmB,KAAK;AAC/B,YAAM,CAAC,mBAAmB,KAAK;AAC/B,YAAM,CAAC,mBAAmB,KAAK;AAC/B,YAAM,CAAC,mBAAmB,KAAK;;;;GAKlC,IAAI,iBAAiC;IAAE,MAAM;IAAsB,MAAM,IAAI;IAAQ;AACrF,OAAI,IAAI,KAAK,QAAQ,eAAe,UAAU,CAAC,MAAM,MAAM,aAAa,WAAW,EAAE;AACpF,WAAO,KAAK,kDAAkD;AAC9D,QAAI;AACH,sBAAiB;MAAE,MAAM;MAAmB,QAAQ,MAAM,CAAC,WAAW,IAAI,SAAS,aAAa;MAAE;aAC1F,GAAG;AACX,SAAI,aAAa,EAAE,YAAY;AAC9B,aAAO,MAAM,EAAE,OAAO,SAAS,QAAQ,CAAC;AACxC,aAAO,MAAM,yCAAyC;AACtD,aAAO;;AAER,WAAM;;cAEG,KAAK,MACf,QAAO,KACN,kIACA;AAGF,OAAI,KAAK,OAAO;AACf,QAAI,eAAe,SAAS,SAC3B,SAAQ,OAAO,MAAM,OAAO,KAAK,eAAe,OAAO,CAAC;AAEzD;;AAGD,UAAO,KAAK,yCAAyC;GAGrD,MAAM,WAAW,MAAM,CAAC,iCAAiC,MAAM,EAAE,MAAM;AACvE,OAAI,YAAY,OAAO,eAAe;AACrC,WAAO,MAAM,iDAAiD,UAAU;AAExE,WAAO;;AAQR,OAAI;IACH,MAAM,kBAAkB;KAAC;KAAM;KAAM;KAAY;AACjD,QAAI,eAAe,SAAS,YAC3B,OAAM,CAAC,eAAe,gBAAgB,MAAM,eAAe;QAE3D,OAAM,CAAC,eAAe,gBAAgB,UAAU,eAAe;YAExD,GAAG;AACX,QAAI,aAAa,EAAE,YAAY;AAC9B,YAAO,MAAM,+CAA+C;AAC5D,YAAO;;AAER,UAAM;;AAGP,UAAO,KAAK,+BAA+B;;EAE5C,CAAC;;AAGH,eAAsB,WAA6C,QAAiC;AAEnG,OAAM,IAAI,OADE,kBAAkB,OAAO,CAChB,EAAE,QAAQ,KAAK"}