@shell-shock/core 0.9.7 → 0.11.0

package/dist/resolver/resolve.mjs

@@ -0,0 +1,208 @@
+import { getDynamicPathSegmentName, isDynamicPathSegment } from "../plugin-utils/context-helpers.mjs";
+import { extractType } from "../plugin-utils/deepkit.mjs";
+import { getDefaultOptions } from "../helpers/utilities.mjs";
+import { applyArgsDefaults, applyDefaults, applyOptionsDefaults, resolveVirtualCommand } from "./helpers.mjs";
+import { resolveFromBytecode } from "./deepkit.mjs";
+import { resolveFromExports } from "./module.mjs";
+import { constantCase } from "@stryke/string-format/constant-case";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { titleCase } from "@stryke/string-format/title-case";
+import { ReflectionVisibility } from "@powerlines/deepkit/vendor/type";
+import { esbuildPlugin } from "@powerlines/deepkit/esbuild-plugin";
+import { resolveModule } from "@powerlines/plugin-esbuild/helpers/resolve";
+
+//#region src/resolver/resolve.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+async function initialize(input) {
+	const { context, command, parent } = input;
+	const title = command.title || `${parent?.title ? `${parent.isVirtual ? parent.title.replace(/(?:c|C)ommands?$/, "").trim() : parent.title} - ` : ""}${titleCase(command.name)}${command.isVirtual ? " Commands" : ""}`;
+	const result = {
+		input,
+		output: {
+			alias: [],
+			icon: parent?.icon,
+			...command,
+			title,
+			options: getDefaultOptions(context, command),
+			args: [],
+			parent: parent ?? null,
+			children: {}
+		}
+	};
+	if (!command.isVirtual) {
+		if (!command.entry.input?.file || !context.fs.existsSync(command.entry.input.file)) throw new Error(`${!command.entry.input?.file ? "Missing" : "Non-existent"} command entry file for "${command.name}"`);
+		context.debug(`Adding reflection for user-defined command: ${command.id} (file: ${command.entry.input.file})`);
+		result.module = await (resolveModule.Ω = [["CommandModule", "\"w!"]], resolveModule(context, command.entry.input, { plugins: [esbuildPlugin(context, {
+			reflection: "default",
+			reflectionLevel: "verbose"
+		})] }));
+	}
+	return result;
+}
+initialize.__type = [
+	"ResolverInput",
+	"input",
+	"ResolverContext",
+	"initialize",
+	"P\"w!2\"\"w#`/$"
+];
+async function postprocess(ctx) {
+	ctx.output.options = applyOptionsDefaults(ctx.output.options);
+	ctx.output.args = applyArgsDefaults(ctx.output.args);
+	ctx.output.args.forEach(__assignType((argument, index) => {
+		const found = ctx.output.args.findIndex(__assignType((arg) => arg.name === argument.name, [
+			"arg",
+			"",
+			"P\"2!\"/\""
+		]));
+		if (found !== -1 && found !== index || ctx.output.segments.some(__assignType((segment) => isDynamicPathSegment(segment) && getDynamicPathSegmentName(segment) === argument.name, [
+			"segment",
+			"",
+			"P\"2!\"/\""
+		]))) {
+			argument.name += `_${ctx.output.segments.filter(__assignType((segment) => isDynamicPathSegment(segment) && getDynamicPathSegmentName(segment).replace(/_\d+$/, "") === argument.name, [
+				"segment",
+				"",
+				"P\"2!\"/\""
+			])).length + ctx.output.args.filter(__assignType((arg) => arg.name.replace(/_\d+$/, "") === argument.name, [
+				"arg",
+				"",
+				"P\"2!\"/\""
+			])).length}`;
+			argument.env = constantCase(argument.name);
+		}
+	}, [
+		"argument",
+		"index",
+		"",
+		"P\"2!\"2\"\"/#"
+	]));
+	applyDefaults(ctx);
+	if (ctx.input.context.env) {
+		if (isSetObject(ctx.output.options)) Object.values(ctx.output.options).filter(__assignType((option) => option.env !== false, [
+			"option",
+			"",
+			"P\"2!\"/\""
+		])).forEach(__assignType((option) => {
+			ctx.input.context.env.types.env.addProperty({
+				name: option.env,
+				optional: option.optional ? true : void 0,
+				description: option.description,
+				visibility: ReflectionVisibility.public,
+				type: extractType(option),
+				default: option.default,
+				tags: {
+					title: option.title,
+					alias: option.alias.filter(__assignType((alias) => alias.length > 1, [
+						"alias",
+						"",
+						"P\"2!\"/\""
+					])).map(__assignType((alias) => constantCase(alias), [
+						"alias",
+						"",
+						"P\"2!\"/\""
+					])),
+					domain: "cli"
+				}
+			});
+		}, [
+			"option",
+			"",
+			"P\"2!\"/\""
+		]));
+		ctx.output.args.filter(__assignType((arg) => arg.env !== false, [
+			"arg",
+			"",
+			"P\"2!\"/\""
+		])).forEach(__assignType((arg) => ctx.input.context.env.types.env.addProperty({
+			name: arg.env,
+			optional: arg.optional ? true : void 0,
+			description: arg.description,
+			visibility: ReflectionVisibility.public,
+			type: extractType(arg),
+			default: arg.default,
+			tags: {
+				alias: arg.alias.filter(__assignType((alias) => alias.length > 1, [
+					"alias",
+					"",
+					"P\"2!\"/\""
+				])).map(__assignType((alias) => constantCase(alias), [
+					"alias",
+					"",
+					"P\"2!\"/\""
+				])),
+				domain: "cli"
+			}
+		}), [
+			"arg",
+			"",
+			"P\"2!\"/\""
+		]));
+	}
+	for (const input of ctx.input.context.inputs.filter(__assignType((input$1) => input$1.segments.filter(__assignType((segment) => !isDynamicPathSegment(segment), [
+		"segment",
+		"",
+		"P\"2!\"/\""
+	])).length === ctx.input.command.segments.filter(__assignType((segment) => !isDynamicPathSegment(segment), [
+		"segment",
+		"",
+		"P\"2!\"/\""
+	])).length + 1 && input$1.segments.slice(0, ctx.input.command.segments.length).every(__assignType((value, index) => value === ctx.input.command.segments[index], [
+		"value",
+		"index",
+		"",
+		"P\"2!\"2\"\"/#"
+	])), [
+		"input",
+		"",
+		"P\"2!\"/\""
+	]))) ctx.output.children[input.name] = await (resolve.Ω = [[
+		() => ctx,
+		"ResolverContext",
+		"Pi!\"w\"q\"!j"
+	]], resolve({
+		context: ctx.input.context,
+		command: input,
+		parent: ctx.output
+	}));
+	return ctx.output;
+}
+postprocess.__type = [
+	"ResolverContext",
+	"ctx",
+	"CommandTree",
+	"postprocess",
+	"P\"w!2\"\"w#`/$"
+];
+/**
+* Resolves a command tree from the given resolver input.
+*
+* @param input - The resolver input containing the context, command, and optional parent command tree.
+* @returns A promise that resolves to the resolved command tree.
+*/
+async function resolve(input) {
+	const ctx = await (initialize.Ω = [[
+		() => input,
+		"ResolverInput",
+		"Pi!\"w\"q\"!j"
+	]], initialize(input));
+	if (!ctx.output.isVirtual) {
+		await resolveFromExports(ctx);
+		resolveFromBytecode(ctx);
+	} else resolveVirtualCommand(ctx);
+	return postprocess(ctx);
+}
+resolve.__type = [
+	"ResolverInput",
+	"input",
+	"CommandTree",
+	"resolve",
+	"P\"w!2\"\"w#`/$"
+];
+
+//#endregion
+export { resolve };
+//# sourceMappingURL=resolve.mjs.map

package/dist/resolver/resolve.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.mjs","names":[],"sources":["../../src/resolver/resolve.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { esbuildPlugin } from \"@powerlines/deepkit/esbuild-plugin\";\nimport { ReflectionVisibility } from \"@powerlines/deepkit/vendor/type\";\nimport { resolveModule } from \"@powerlines/plugin-esbuild/helpers/resolve\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { getDefaultOptions } from \"../helpers/utilities\";\nimport {\n  getDynamicPathSegmentName,\n  isDynamicPathSegment\n} from \"../plugin-utils/context-helpers\";\nimport { extractType } from \"../plugin-utils/deepkit\";\nimport type { CommandModule, CommandTree, Context } from \"../types\";\nimport { resolveFromBytecode } from \"./deepkit\";\nimport {\n  applyArgsDefaults,\n  applyDefaults,\n  applyOptionsDefaults,\n  resolveVirtualCommand\n} from \"./helpers\";\nimport { resolveFromExports } from \"./module\";\nimport type { ResolverContext, ResolverInput } from \"./types\";\n\nasync function initialize<TContext extends Context = Context>(\n  input: ResolverInput<TContext>\n): Promise<ResolverContext> {\n  const { context, command, parent } = input;\n\n  const title =\n    command.title ||\n    `${\n      parent?.title\n        ? `${\n            parent.isVirtual\n              ? parent.title.replace(/(?:c|C)ommands?$/, \"\").trim()\n              : parent.title\n          } - `\n        : \"\"\n    }${titleCase(command.name)}${command.isVirtual ? \" Commands\" : \"\"}`;\n\n  const output = {\n    alias: [],\n    icon: parent?.icon,\n    ...command,\n    title,\n    options: getDefaultOptions(context, command),\n    args: [],\n    parent: parent ?? null,\n    children: {}\n  } as CommandTree;\n\n  const result: ResolverContext = {\n    input,\n    output\n  };\n\n  if (!command.isVirtual) {\n    if (\n      !command.entry.input?.file ||\n      !context.fs.existsSync(command.entry.input.file)\n    ) {\n      throw new Error(\n        `${\n          !command.entry.input?.file ? \"Missing\" : \"Non-existent\"\n        } command entry file for \"${command.name}\"`\n      );\n    }\n\n    context.debug(\n      `Adding reflection for user-defined command: ${command.id} (file: ${\n        command.entry.input.file\n      })`\n    );\n\n    result.module = await resolveModule<CommandModule>(\n      context,\n      command.entry.input,\n      {\n        plugins: [\n          esbuildPlugin(context, {\n            reflection: \"default\",\n            reflectionLevel: \"verbose\"\n          })\n        ]\n      }\n    );\n  }\n\n  return result;\n}\n\nasync function postprocess<TContext extends Context = Context>(\n  ctx: ResolverContext<TContext>\n): Promise<CommandTree> {\n  ctx.output.options = applyOptionsDefaults(ctx.output.options);\n  ctx.output.args = applyArgsDefaults(ctx.output.args);\n\n  // Ensure unique argument names by appending an index suffix to duplicates\n  ctx.output.args.forEach((argument, index) => {\n    const found = ctx.output.args.findIndex(arg => arg.name === argument.name);\n    if (\n      (found !== -1 && found !== index) ||\n      ctx.output.segments.some(\n        segment =>\n          isDynamicPathSegment(segment) &&\n          getDynamicPathSegmentName(segment) === argument.name\n      )\n    ) {\n      argument.name += `_${\n        ctx.output.segments.filter(\n          segment =>\n            isDynamicPathSegment(segment) &&\n            getDynamicPathSegmentName(segment).replace(/_\\d+$/, \"\") ===\n              argument.name\n        ).length +\n        ctx.output.args.filter(\n          arg => arg.name.replace(/_\\d+$/, \"\") === argument.name\n        ).length\n      }`;\n      argument.env = constantCase(argument.name);\n    }\n  });\n\n  applyDefaults(ctx);\n\n  if (ctx.input.context.env) {\n    if (isSetObject(ctx.output.options)) {\n      Object.values(ctx.output.options)\n        .filter(option => option.env !== false)\n        .forEach(option => {\n          ctx.input.context.env.types.env.addProperty({\n            name: option.env as string,\n            optional: option.optional ? true : undefined,\n            description: option.description,\n            visibility: ReflectionVisibility.public,\n            type: extractType(option),\n            default: option.default,\n            tags: {\n              title: option.title,\n              alias: option.alias\n                .filter(alias => alias.length > 1)\n                .map(alias => constantCase(alias)),\n              domain: \"cli\"\n            }\n          });\n        });\n    }\n\n    ctx.output.args\n      .filter(arg => arg.env !== false)\n      .forEach(arg =>\n        ctx.input.context.env.types.env.addProperty({\n          name: arg.env as string,\n          optional: arg.optional ? true : undefined,\n          description: arg.description,\n          visibility: ReflectionVisibility.public,\n          type: extractType(arg),\n          default: arg.default,\n          tags: {\n            alias: arg.alias\n              .filter(alias => alias.length > 1)\n              .map(alias => constantCase(alias)),\n            domain: \"cli\"\n          }\n        })\n      );\n  }\n\n  for (const input of ctx.input.context.inputs.filter(\n    input =>\n      input.segments.filter(segment => !isDynamicPathSegment(segment))\n        .length ===\n        ctx.input.command.segments.filter(\n          segment => !isDynamicPathSegment(segment)\n        ).length +\n          1 &&\n      input.segments\n        .slice(0, ctx.input.command.segments.length)\n        .every((value, index) => value === ctx.input.command.segments[index])\n  )) {\n    ctx.output.children[input.name] = await resolve<TContext>({\n      context: ctx.input.context,\n      command: input,\n      parent: ctx.output\n    });\n  }\n\n  return ctx.output;\n}\n\n/**\n * Resolves a command tree from the given resolver input.\n *\n * @param input - The resolver input containing the context, command, and optional parent command tree.\n * @returns A promise that resolves to the resolved command tree.\n */\nexport async function resolve<TContext extends Context = Context>(\n  input: ResolverInput<TContext>\n): Promise<CommandTree> {\n  const ctx = await initialize<TContext>(input);\n\n  if (!ctx.output.isVirtual) {\n    await resolveFromExports(ctx);\n    resolveFromBytecode(ctx);\n  } else {\n    resolveVirtualCommand(ctx);\n  }\n\n  return postprocess(ctx);\n}\n"],"mappings":"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"}

package/dist/types/command.cjs

@@ -1,10 +1,15 @@
 
 //#region src/types/command.ts
-const __ΩRecord = [
+const __ΩPick = [
+	"T",
 	"K",
+	"Pick",
+	"l+e#!e\"!fRb!b\"Pde\"\"N#!w#y"
+];
+const __ΩPartial = [
 	"T",
-	"Record",
-	"l'e#\"Rb!b\"Pde\"!N#!w#y"
+	"Partial",
+	"l+e#!e\"!fRb!Pde\"!gN#\"w\"y"
 ];
 const __ΩOmit = [
 	"T",
@@ -14,11 +19,11 @@ const __ΩOmit = [
 	"Omit",
 	"b!b\"e!!e!!ge!\"o$#o##w%y"
 ];
-const __ΩPick = [
-	"T",
+const __ΩRecord = [
 	"K",
-	"Pick",
-	"l+e#!e\"!fRb!b\"Pde\"\"N#!w#y"
+	"T",
+	"Record",
+	"l'e#\"Rb!b\"Pde\"!N#!w#y"
 ];
 const __ΩExclude = [
 	"T",
@@ -26,9 +31,21 @@ const __ΩExclude = [
 	"Exclude",
 	"l6!Re$!RPe#!e$\"qk#%QRb!b\"Pde\"!p)w#y"
 ];
+const __ΩCommandParameterType = ["CommandParameterType", "P&')P&'JFJw!y"];
+const CommandParameterKinds = {
+	string: "string",
+	number: "number",
+	boolean: "boolean"
+};
+const __ΩCommandParameterKind = [
+	() => CommandParameterKinds,
+	() => CommandParameterKinds,
+	"CommandParameterKind",
+	"i!i\"gfw#y"
+];
 const __ΩBaseCommandParameter = [
 	"name",
-	"ReflectionKind",
+	() => __ΩCommandParameterKind,
 	"kind",
 	"title",
 	"description",
@@ -37,94 +54,124 @@ const __ΩBaseCommandParameter = [
 	"env",
 	"optional",
 	"BaseCommandParameter",
-	"P&4!\"w\"4#&4$&4%&F4&P&.'J4()4)Mw*y"
+	"P&4!n\"4#&4$&4%&F4&P&.'J4()4)Mw*y"
 ];
 const __ΩStringCommandParameter = [
 	() => __ΩBaseCommandParameter,
-	5,
+	"string",
 	"kind",
 	"default",
+	"email",
+	"uri",
+	"uuid",
+	"ipv4",
+	"ipv6",
+	"date",
+	"time",
+	"date-time",
+	"duration",
+	"format",
 	"variadic",
+	"choices",
 	"StringCommandParameter",
-	"Pn!a\"4#&4$8)4%Mw&y"
+	"Pn!.\"4#&4$8P.%.&.'.(.).*.+.,.-J4.8)4/&F408Mw1y"
 ];
 const __ΩNumberCommandParameter = [
 	() => __ΩBaseCommandParameter,
-	6,
+	"number",
 	"kind",
 	"default",
 	"variadic",
+	"choices",
 	"NumberCommandParameter",
-	"Pn!a\"4#'4$8)4%Mw&y"
+	"Pn!.\"4#'4$8)4%'F4&8Mw'y"
 ];
 const __ΩBooleanCommandParameter = [
 	() => __ΩBaseCommandParameter,
-	7,
+	"boolean",
 	"kind",
 	"default",
-	"isNegativeOf",
-	"skipAddingNegative",
 	"BooleanCommandParameter",
-	"Pn!a\"4#)4$8&4%8)4&8Mw'y"
+	"Pn!.\"4#)4$8Mw%y"
 ];
-const __ΩStringCommandOption = [
+const __ΩCommandParameter = [
 	() => __ΩStringCommandParameter,
-	"ReflectionProperty",
-	"reflection",
-	"StringCommandOption",
-	"Pn!\"w\"4#8Mw$y"
+	() => __ΩNumberCommandParameter,
+	() => __ΩBooleanCommandParameter,
+	"CommandParameter",
+	"Pn!n\"n#Jw$y"
 ];
-const __ΩNumberCommandOption = [
+const __ΩAsCommandParameterConfig = [
+	"T",
+	() => __ΩPick,
+	"kind",
+	"alias",
+	() => __ΩPartial,
+	() => __ΩOmit,
+	"kind",
+	"alias",
+	"alias",
+	"AsCommandParameterConfig",
+	"b!Pe\"!P.#.$Jo\"#e\"!P.'.(Jo&#o%\"PP&&FJ4)8MKw*y"
+];
+const __ΩStringCommandParameterConfig = [
+	() => __ΩAsCommandParameterConfig,
+	() => __ΩStringCommandParameter,
+	"StringCommandParameterConfig",
+	"n\"o!\"w#y"
+];
+const __ΩNumberCommandParameterConfig = [
+	() => __ΩAsCommandParameterConfig,
 	() => __ΩNumberCommandParameter,
-	"ReflectionProperty",
-	"reflection",
-	"NumberCommandOption",
-	"Pn!\"w\"4#8Mw$y"
+	"NumberCommandParameterConfig",
+	"n\"o!\"w#y"
+];
+const __ΩBooleanCommandParameterConfig = [
+	() => __ΩAsCommandParameterConfig,
+	() => __ΩBooleanCommandParameter,
+	"BooleanCommandParameterConfig",
+	"n\"o!\"w#y"
+];
+const __ΩCommandParameterConfig = [
+	() => __ΩStringCommandParameterConfig,
+	() => __ΩNumberCommandParameterConfig,
+	() => __ΩBooleanCommandParameterConfig,
+	"CommandParameterConfig",
+	"Pn!n\"n#Jw$y"
 ];
 const __ΩBooleanCommandOption = [
 	() => __ΩBooleanCommandParameter,
-	"ReflectionProperty",
-	"reflection",
 	"isNegativeOf",
 	"skipAddingNegative",
 	"BooleanCommandOption",
-	"Pn!\"w\"4#8&4$8)4%8Mw&y"
+	"Pn!&4\"8)4#8Mw$y"
 ];
 const __ΩCommandOption = [
-	() => __ΩStringCommandOption,
-	() => __ΩNumberCommandOption,
+	() => __ΩStringCommandParameter,
+	() => __ΩNumberCommandParameter,
 	() => __ΩBooleanCommandOption,
 	"CommandOption",
 	"Pn!n\"n#Jw$y"
 ];
-const __ΩStringCommandArgument = [
-	() => __ΩStringCommandParameter,
-	"ReflectionParameter",
-	"reflection",
-	"StringCommandArgument",
-	"Pn!\"w\"4#Mw$y"
+const __ΩCommandOptionConfig = [
+	() => __ΩAsCommandParameterConfig,
+	() => __ΩCommandOption,
+	"CommandOptionConfig",
+	"n\"o!\"w#y"
 ];
-const __ΩNumberCommandArgument = [
+const __ΩCommandArgument = [
+	() => __ΩStringCommandParameter,
 	() => __ΩNumberCommandParameter,
-	"ReflectionParameter",
-	"reflection",
-	"NumberCommandArgument",
-	"Pn!\"w\"4#Mw$y"
-];
-const __ΩBooleanCommandArgument = [
 	() => __ΩBooleanCommandParameter,
-	"ReflectionParameter",
-	"reflection",
-	"BooleanCommandArgument",
-	"Pn!\"w\"4#Mw$y"
-];
-const __ΩCommandArgument = [
-	() => __ΩStringCommandArgument,
-	() => __ΩNumberCommandArgument,
-	() => __ΩBooleanCommandArgument,
 	"CommandArgument",
 	"Pn!n\"n#Jw$y"
 ];
+const __ΩCommandArgumentConfig = [
+	() => __ΩAsCommandParameterConfig,
+	() => __ΩCommandArgument,
+	"CommandArgumentConfig",
+	"n\"o!\"w#y"
+];
 const __ΩCommandBase = [
 	"id",
 	"name",
@@ -138,15 +185,15 @@ const __ΩCommandBase = [
 	"CommandBase",
 	"PP&,J4!&4\"P&,J4#&F4$&4%8&4&8&F4'8&4(8)4)Mw*y"
 ];
-const __ΩCommandInput = [
+const __ΩCommandConfig = [
 	() => __ΩCommandBase,
 	"id",
 	"entry",
-	"CommandInput",
+	"CommandConfig",
 	"Pn!&4\"!4#Mw$y"
 ];
 const __ΩCommandTree = [
-	() => __ΩCommandInput,
+	() => __ΩCommandConfig,
 	"title",
 	"description",
 	"alias",
@@ -154,88 +201,73 @@ const __ΩCommandTree = [
 	() => __ΩCommandOption,
 	"options",
 	() => __ΩCommandArgument,
-	"arguments",
+	"args",
 	0,
 	"parent",
 	() => __ΩRecord,
 	0,
 	"children",
-	"ReflectionFunction",
-	"reflection",
 	"CommandTree",
-	"Pn!P&4\"&4#&F4$&n&o%#4'n(F4)P,n*J4+&n-o,#4.P\"w/,J40MKw1y"
-];
-const __ΩSerializedCommandOption = [
-	() => __ΩOmit,
-	() => __ΩCommandOption,
-	"reflection",
-	"SerializedCommandOption",
-	"n\".#o!#w$y"
-];
-const __ΩSerializedCommandArgument = [
-	() => __ΩOmit,
-	() => __ΩCommandArgument,
-	"reflection",
-	"SerializedCommandArgument",
-	"n\".#o!#w$y"
+	"Pn!P&4\"&4#&F4$&n&o%#4'n(F4)P,n*J4+&n-o,#4.MKw/y"
 ];
 const __ΩSerializedCommandTree = [
 	() => __ΩOmit,
 	() => __ΩCommandTree,
-	"options",
-	"arguments",
 	"parent",
 	"children",
-	"reflection",
-	() => __ΩRecord,
-	() => __ΩSerializedCommandOption,
-	"options",
-	() => __ΩSerializedCommandArgument,
-	"arguments",
 	"parent",
 	() => __ΩRecord,
 	0,
 	"children",
-	"SerializedTypes",
-	"reflection",
 	"SerializedCommandTree",
-	"Pn\"P.#.$.%.&.'Jo!#P&n)o(#4*n+F4,P,&J4-&n/o.#40\"w1428MKw3y"
+	"Pn\"P.#.$Jo!#PP,&J4%&n'o&#4(MKw)y"
 ];
-const __ΩMetadata = [
+const __ΩCommandMetadata = [
 	"title",
 	"description",
 	"alias",
 	"icon",
-	"Metadata",
+	"CommandMetadata",
 	"P&4!8&4\"8P&&FJ4#8&4$8Mw%y"
 ];
 const __ΩCommandModule = [
-	() => __ΩMetadata,
+	() => __ΩCommandMetadata,
 	"metadata",
+	() => __ΩRecord,
+	() => __ΩCommandOptionConfig,
+	"JSONSchema7Object",
+	"StandardJSONSchemaV1",
+	"options",
+	() => __ΩCommandArgumentConfig,
+	"args",
 	"default",
 	"CommandModule",
-	"Pn!4\"8!4#8Mw$y"
+	"Pn!4\"8P&n$o##\"w%\"w&!J4'8Pn(F!\"w&!J4)8!4*8Mw+y"
 ];
 
 //#endregion
+exports.CommandParameterKinds = CommandParameterKinds;
+exports.__ΩAsCommandParameterConfig = __ΩAsCommandParameterConfig;
 exports.__ΩBaseCommandParameter = __ΩBaseCommandParameter;
-exports.__ΩBooleanCommandArgument = __ΩBooleanCommandArgument;
 exports.__ΩBooleanCommandOption = __ΩBooleanCommandOption;
 exports.__ΩBooleanCommandParameter = __ΩBooleanCommandParameter;
+exports.__ΩBooleanCommandParameterConfig = __ΩBooleanCommandParameterConfig;
 exports.__ΩCommandArgument = __ΩCommandArgument;
+exports.__ΩCommandArgumentConfig = __ΩCommandArgumentConfig;
 exports.__ΩCommandBase = __ΩCommandBase;
-exports.__ΩCommandInput = __ΩCommandInput;
+exports.__ΩCommandConfig = __ΩCommandConfig;
+exports.__ΩCommandMetadata = __ΩCommandMetadata;
 exports.__ΩCommandModule = __ΩCommandModule;
 exports.__ΩCommandOption = __ΩCommandOption;
+exports.__ΩCommandOptionConfig = __ΩCommandOptionConfig;
+exports.__ΩCommandParameter = __ΩCommandParameter;
+exports.__ΩCommandParameterConfig = __ΩCommandParameterConfig;
+exports.__ΩCommandParameterKind = __ΩCommandParameterKind;
+exports.__ΩCommandParameterType = __ΩCommandParameterType;
 exports.__ΩCommandTree = __ΩCommandTree;
-exports.__ΩMetadata = __ΩMetadata;
-exports.__ΩNumberCommandArgument = __ΩNumberCommandArgument;
-exports.__ΩNumberCommandOption = __ΩNumberCommandOption;
 exports.__ΩNumberCommandParameter = __ΩNumberCommandParameter;
-exports.__ΩSerializedCommandArgument = __ΩSerializedCommandArgument;
-exports.__ΩSerializedCommandOption = __ΩSerializedCommandOption;
+exports.__ΩNumberCommandParameterConfig = __ΩNumberCommandParameterConfig;
 exports.__ΩSerializedCommandTree = __ΩSerializedCommandTree;
-exports.__ΩStringCommandArgument = __ΩStringCommandArgument;
-exports.__ΩStringCommandOption = __ΩStringCommandOption;
 exports.__ΩStringCommandParameter = __ΩStringCommandParameter;
+exports.__ΩStringCommandParameterConfig = __ΩStringCommandParameterConfig;
 //# sourceMappingURL=command.cjs.map

package/dist/types/command.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"command.cjs","names":[],"sources":["../../src/types/command.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type {\n  ReflectionFunction,\n  ReflectionKind,\n  ReflectionParameter,\n  ReflectionProperty,\n  SerializedTypes\n} from \"@powerlines/deepkit/vendor/type\";\nimport type { AnyFunction } from \"@stryke/types/base\";\nimport type { ResolvedEntryTypeDefinition } from \"powerlines/types/resolved\";\n\nexport interface BaseCommandParameter {\n  /**\n   * The option name.\n   */\n  name: string;\n  /**\n   * The option kind.\n   */\n  kind: ReflectionKind;\n  /**\n   * The display title.\n   */\n  title: string;\n  /**\n   * The option description.\n   */\n  description: string;\n  /**\n   * Alternative option names.\n   */\n  alias: string[];\n  /**\n   * The environment variable name or false to disable.\n   */\n  env: string | false;\n  /**\n   * Whether the option is optional.\n   */\n  optional: boolean;\n}\n\nexport interface StringCommandParameter extends BaseCommandParameter {\n  /**\n   * The option kind.\n   */\n  kind: ReflectionKind.string;\n  /**\n   * The default value.\n   */\n  default?: string;\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: boolean;\n}\n\nexport interface NumberCommandParameter extends BaseCommandParameter {\n  /**\n   * The option kind.\n   */\n  kind: ReflectionKind.number;\n  /**\n   * The default value.\n   */\n  default?: number;\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: boolean;\n}\n\nexport interface BooleanCommandParameter extends BaseCommandParameter {\n  /**\n   * The option kind.\n   */\n  kind: ReflectionKind.boolean;\n  /**\n   * The default value.\n   */\n  default?: boolean;\n  /**\n   * The option this negates.\n   */\n  isNegativeOf?: string;\n  /**\n   * Whether to skip adding a negative option.\n   */\n  skipAddingNegative?: boolean;\n}\n\nexport interface StringCommandOption extends StringCommandParameter {\n  /**\n   * The property reflection.\n   */\n  reflection?: ReflectionProperty;\n}\n\nexport interface NumberCommandOption extends NumberCommandParameter {\n  /**\n   * The property reflection.\n   */\n  reflection?: ReflectionProperty;\n}\n\nexport interface BooleanCommandOption extends BooleanCommandParameter {\n  /**\n   * The property reflection.\n   */\n  reflection?: ReflectionProperty;\n  /**\n   * The option this negates.\n   */\n  isNegativeOf?: string;\n  /**\n   * Whether to skip adding a negative option.\n   */\n  skipAddingNegative?: boolean;\n}\n\nexport type CommandOption =\n  | StringCommandOption\n  | NumberCommandOption\n  | BooleanCommandOption;\n\nexport interface StringCommandArgument extends StringCommandParameter {\n  /**\n   * The parameter reflection.\n   */\n  reflection: ReflectionParameter;\n}\n\nexport interface NumberCommandArgument extends NumberCommandParameter {\n  /**\n   * The parameter reflection.\n   */\n  reflection: ReflectionParameter;\n}\n\nexport interface BooleanCommandArgument extends BooleanCommandParameter {\n  /**\n   * The parameter reflection.\n   */\n  reflection: ReflectionParameter;\n}\n\nexport type CommandArgument =\n  | StringCommandArgument\n  | NumberCommandArgument\n  | BooleanCommandArgument;\n\nexport interface CommandBase {\n  /**\n   * The command id.\n   */\n  id: string | null;\n\n  /**\n   * The command name.\n   */\n  name: string;\n\n  /**\n   * The full command path value.\n   */\n  path: string | null;\n\n  /**\n   * The path segments.\n   */\n  segments: string[];\n\n  /**\n   * The display title.\n   */\n  title?: string;\n\n  /**\n   * The command description.\n   */\n  description?: string;\n\n  /**\n   * Alternative command names.\n   */\n  alias?: string[];\n\n  /**\n   * The command icon.\n   */\n  icon?: string;\n\n  /**\n   * Whether the command is virtual.\n   *\n   * @remarks\n   * Virtual commands are considered forks in the command tree and are not directly executable. They are used to group related subcommands together without having an actual command handler or entry point.\n   */\n  isVirtual: boolean;\n}\n\nexport interface CommandInput extends CommandBase {\n  /**\n   * The command id.\n   */\n  id: string;\n\n  /**\n   * The resolved entry definition.\n   */\n  entry: ResolvedEntryTypeDefinition;\n}\n\nexport type CommandTree = CommandInput & {\n  /**\n   * The display title.\n   */\n  title: string;\n  /**\n   * The command description.\n   */\n  description: string;\n  /**\n   * Alternative command names.\n   */\n  alias: string[];\n  /**\n   * The command options.\n   */\n  options: Record<string, CommandOption>;\n  /**\n   * The positional arguments provided to the command.\n   */\n  arguments: CommandArgument[];\n  /**\n   * The parent command.\n   */\n  parent: null | CommandTree;\n  /**\n   * Child commands.\n   */\n  children: Record<string, CommandTree>;\n  /**\n   * The command handler reflection.\n   */\n  reflection: ReflectionFunction | null;\n};\n\nexport type SerializedCommandOption = Omit<CommandOption, \"reflection\">;\n\nexport type SerializedCommandArgument = Omit<CommandArgument, \"reflection\">;\n\nexport type SerializedCommandTree = Omit<\n  CommandTree,\n  \"options\" | \"arguments\" | \"parent\" | \"children\" | \"reflection\"\n> & {\n  /**\n   * The command options.\n   */\n  options: Record<string, SerializedCommandOption>;\n  /**\n   * The positional arguments provided to the command.\n   */\n  arguments: SerializedCommandArgument[];\n  /**\n   * The parent command id.\n   */\n  parent: null | string;\n  /**\n   * Serialized child commands.\n   */\n  children: Record<string, SerializedCommandTree>;\n  /**\n   * The command handler reflection.\n   */\n  reflection?: SerializedTypes;\n};\n\nexport interface Metadata {\n  /**\n   * The display name of the command.\n   *\n   * @remarks\n   * This value will be used in various displays of the user interface and documentation. If not provided, a formatted value of the command name will be used.\n   */\n  title?: string;\n\n  /**\n   * A brief description of what the command does.\n   *\n   * @remarks\n   * This value will be used in various displays of the user interface and documentation. If not provided, a default message may be shown.\n   */\n  description?: string;\n\n  /**\n   * One or more alternative names for the command.\n   */\n  alias?: string | string[];\n\n  /**\n   * An optional icon to visually represent the command in user interfaces.\n   *\n   * @remarks\n   * This can be a string containing an emoji, a Unicode character, or any other symbol that helps to visually identify the command. If not provided, no icon will be displayed.\n   */\n  icon?: string;\n}\n\nexport interface CommandModule {\n  metadata?: Metadata;\n  default?: AnyFunction;\n}\n"],"mappings":";;AAAA,MAAM,YAAY;CAAC;CAAK;CAAK;CAAU;CAAyB;;;;;;;;;AAEhE,MAAM,UAAU;CAAC;CAAK;CAAK;CAAQ;CAAY;;;;;;;AAE/C,MAAM,0BAA0B;CAAC;CAAQ;CAAkB;CAAQ;CAAG;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEtE,MAAM,4BAA4B;OAAO;CAAyB;CAAG;CAAE;CAAA;CAAA;CAAA;CAAA;;;;;;;;;;AAIvE,MAAM,6BAA6B;OAAO;CAAyB;CAAG;CAAC;CAAA;CAAA;CAAA;CAAA;CAAA;AAEvE,MAAM,yBAAyB;OAAO;CAAqB;CAAA;CAAA;CAAA;CAAA;AAE3D,MAAM,yBAAyB;OAAK;CAAA;CAAA;CAAA;CAAA;CAAA;AAEpC,MAAM,0BAA0B;OAAO;CAA4B;CAAG;CAAA;CAAA;CAAA;CAAA;CAAA;AAEtE,MAAM,mBAAM;OAAA;OAAA;OAAA;CAAA;CAAA;CAAA;AAEZ,MAAM,2BAAU;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEhB,MAAM,2BAAc;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEpB,MAAM,4BAA4B;OAAM;CAAA;CAAA;CAAA;CAAA;CAAA;AAExC,MAAM,qBAAqB;OAAO;OAAgC;OAAU;CAAA;CAAA;CAAA;AAE5E,MAAM,iBAAiB;CAAC;CAAM;CAAQ;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEtC,MAAM,kBAAc;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEpB,MAAM,iBAAQ;OAAA;CAAA;CAAA;CAAA;OAAA;OAAA;CAAA;OAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEd,MAAM,6BAAc;OAAA;OAAA;CAAA;CAAA;CAAA;CAAA;AAEpB,MAAM,+BAAgB;OAAA;OAAA;CAAA;CAAA;CAAA;CAAA;AAEtB,MAAM,2BAAgB;OAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;OAAA;OAAA;CAAA;OAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEtB,MAAM,cAAS;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEf,MAAM,mBAAmB;OAAE;CAAA;CAAA;CAAA;CAAA;CAAA"}
+{"version":3,"file":"command.cjs","names":[],"sources":["../../src/types/command.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { StandardJSONSchemaV1 } from \"@standard-schema/spec\";\nimport type { JsonSchema7TupleType } from \"@stryke/json\";\nimport type { AnyFunction } from \"@stryke/types/base\";\nimport type { JSONSchema7Object } from \"json-schema\";\nimport type { ResolvedEntryTypeDefinition } from \"powerlines\";\nimport type * as z3 from \"zod/v3\";\n\nexport type CommandParameterType =\n  | string\n  | number\n  | boolean\n  | (string | number)[];\n\nexport const CommandParameterKinds = {\n  string: \"string\",\n  number: \"number\",\n  boolean: \"boolean\"\n} as const;\n\nexport type CommandParameterKind =\n  (typeof CommandParameterKinds)[keyof typeof CommandParameterKinds];\n\nexport interface BaseCommandParameter {\n  /**\n   * The option name.\n   */\n  name: string;\n  /**\n   * The option kind.\n   */\n  kind: CommandParameterKind;\n  /**\n   * The display title.\n   */\n  title: string;\n  /**\n   * The option description.\n   */\n  description: string;\n  /**\n   * Alternative option names.\n   */\n  alias: string[];\n  /**\n   * The environment variable name or false to disable.\n   */\n  env: string | false;\n  /**\n   * Whether the option is optional.\n   */\n  optional: boolean;\n}\n\nexport interface StringCommandParameter extends BaseCommandParameter {\n  /**\n   * The option kind.\n   */\n  kind: \"string\";\n  /**\n   * The default value.\n   */\n  default?: string;\n  /**\n   * A standard string format to validate the option value against.\n   */\n  format?:\n    | \"email\"\n    | \"uri\"\n    | \"uuid\"\n    | \"ipv4\"\n    | \"ipv6\"\n    | \"date\"\n    | \"time\"\n    | \"date-time\"\n    | \"duration\";\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: boolean;\n\n  /**\n   * The allowed choices for the option value.\n   */\n  choices?: string[];\n}\n\nexport interface NumberCommandParameter extends BaseCommandParameter {\n  /**\n   * The option kind.\n   */\n  kind: \"number\";\n  /**\n   * The default value.\n   */\n  default?: number;\n  /**\n   * Whether the option accepts multiple values.\n   */\n  variadic: boolean;\n\n  /**\n   * The allowed choices for the option value.\n   */\n  choices?: number[];\n}\n\nexport interface BooleanCommandParameter extends BaseCommandParameter {\n  /**\n   * The option kind.\n   */\n  kind: \"boolean\";\n  /**\n   * The default value.\n   */\n  default?: boolean;\n}\n\nexport type CommandParameter =\n  | StringCommandParameter\n  | NumberCommandParameter\n  | BooleanCommandParameter;\n\nexport type AsCommandParameterConfig<T extends BaseCommandParameter> = Pick<\n  T,\n  \"kind\" | \"alias\"\n> &\n  Partial<Omit<T, \"kind\" | \"alias\">> & {\n    alias?: string | string[];\n  };\n\nexport type StringCommandParameterConfig =\n  AsCommandParameterConfig<StringCommandParameter>;\nexport type NumberCommandParameterConfig =\n  AsCommandParameterConfig<NumberCommandParameter>;\nexport type BooleanCommandParameterConfig =\n  AsCommandParameterConfig<BooleanCommandParameter>;\n\nexport type CommandParameterConfig =\n  | StringCommandParameterConfig\n  | NumberCommandParameterConfig\n  | BooleanCommandParameterConfig;\n\nexport interface BooleanCommandOption extends BooleanCommandParameter {\n  /**\n   * The option this negates.\n   */\n  isNegativeOf?: string;\n  /**\n   * Whether to skip adding a negative option.\n   */\n  skipAddingNegative?: boolean;\n}\n\nexport type CommandOption =\n  | StringCommandParameter\n  | NumberCommandParameter\n  | BooleanCommandOption;\nexport type CommandOptionConfig = AsCommandParameterConfig<CommandOption>;\n\nexport type CommandArgument =\n  | StringCommandParameter\n  | NumberCommandParameter\n  | BooleanCommandParameter;\nexport type CommandArgumentConfig = AsCommandParameterConfig<CommandArgument>;\n\nexport interface CommandBase {\n  /**\n   * The command id.\n   */\n  id: string | null;\n\n  /**\n   * The command name.\n   */\n  name: string;\n\n  /**\n   * The full command path value.\n   */\n  path: string | null;\n\n  /**\n   * The path segments.\n   */\n  segments: string[];\n\n  /**\n   * The display title.\n   */\n  title?: string;\n\n  /**\n   * The command description.\n   */\n  description?: string;\n\n  /**\n   * Alternative command names.\n   */\n  alias?: string[];\n\n  /**\n   * The command icon.\n   */\n  icon?: string;\n\n  /**\n   * Whether the command is virtual.\n   *\n   * @remarks\n   * Virtual commands are considered forks in the command tree and are not directly executable. They are used to group related subcommands together without having an actual command handler or entry point.\n   */\n  isVirtual: boolean;\n}\n\nexport interface CommandConfig extends CommandBase {\n  /**\n   * The command id.\n   */\n  id: string;\n\n  /**\n   * The resolved entry definition.\n   */\n  entry: ResolvedEntryTypeDefinition;\n}\n\nexport type CommandTree = CommandConfig & {\n  /**\n   * The display title.\n   */\n  title: string;\n  /**\n   * The command description.\n   */\n  description: string;\n  /**\n   * Alternative command names.\n   */\n  alias: string[];\n  /**\n   * The command options.\n   */\n  options: Record<string, CommandOption>;\n  /**\n   * The positional arguments provided to the command.\n   */\n  args: CommandArgument[];\n  /**\n   * The parent command.\n   */\n  parent: null | CommandTree;\n  /**\n   * Child commands.\n   */\n  children: Record<string, CommandTree>;\n};\n\nexport type SerializedCommandTree = Omit<CommandTree, \"parent\" | \"children\"> & {\n  /**\n   * The parent command id.\n   */\n  parent: null | string;\n  /**\n   * Serialized child commands.\n   */\n  children: Record<string, SerializedCommandTree>;\n};\n\nexport interface CommandMetadata {\n  /**\n   * The display name of the command.\n   *\n   * @remarks\n   * This value will be used in various displays of the user interface and documentation. If not provided, a formatted value of the command name will be used.\n   */\n  title?: string;\n\n  /**\n   * A brief description of what the command does.\n   *\n   * @remarks\n   * This value will be used in various displays of the user interface and documentation. If not provided, a default message may be shown.\n   */\n  description?: string;\n\n  /**\n   * One or more alternative names for the command.\n   */\n  alias?: string | string[];\n\n  /**\n   * An optional icon to visually represent the command in user interfaces.\n   *\n   * @remarks\n   * This can be a string containing an emoji, a Unicode character, or any other symbol that helps to visually identify the command. If not provided, no icon will be displayed.\n   */\n  icon?: string;\n}\n\nexport interface CommandModule {\n  metadata?: CommandMetadata;\n  options?:\n    | Record<string, CommandOptionConfig>\n    | JSONSchema7Object\n    | StandardJSONSchemaV1<Record<string, CommandParameterType>>\n    | z3.AnyZodObject;\n  args?:\n    | CommandArgumentConfig[]\n    | JsonSchema7TupleType\n    | StandardJSONSchemaV1<CommandParameterType[]>\n    | z3.AnyZodTuple;\n  default?: AnyFunction;\n}\n"],"mappings":";;AAAA,MAAM,UAAU;CAAC;CAAK;CAAK;CAAQ;CAA4B;;;;;;AAE/D,MAAM,UAAU;CAAC;CAAK;OAAW;OAAc;CAAA;CAAA;CAAA;;;;;;;AAE/C,MAAM,aAAa;CAAC;CAAK;CAAK;CAAW;CAA6B;AACtE,MAAM,0BAA0B,CAAC,wBAAwB,gBAAW;AAEpE,MAAa,wBAAwB;;CAEjC,QAAQ;CACR,SAAS;CACZ;AACD,MAAM,0BAA0B;OAAO;OAAoB;CAAA;CAAA;CAAA;AAE3D,MAAM,0BAA0B;CAAC;OAAG;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEpC,MAAM,4BAA4B;OAAO;CAAyB;CAAI;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEtE,MAAM,4BAA4B;OAAO;CAAwB;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEjE,MAAM,6BAA6B;OAAO;CAAW;CAAA;CAAA;CAAA;CAAA;CAAA;AAErD,MAAM,sBAAsB;OAAO;OAA0B;OAAA;CAAA;CAAA;CAAA;;;;;;;;;;;;;;AAI7D,MAAM,kCAAG;OAAA;OAAA;CAAA;CAAA;CAAA;AAET,MAAM,kCAAI;OAAA;OAAA;CAAA;CAAA;CAAA;;;;;;;AAIV,MAAM,4BAAY;OAAA;OAAA;OAAA;CAAA;CAAA;CAAA;AAElB,MAAM,0BAAa;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAInB,MAAM,yBAAyB;OAAO;OAA8B;CAAA;CAAA;CAAA;AAEpE,MAAM,qBAAqB;OAAO;OAAI;OAAA;CAAA;CAAA;CAAA;AAEtC,MAAM,2BAAc;OAAA;OAAA;CAAA;CAAA;CAAA;AAEpB,MAAM,iBAAQ;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEd,MAAM,mBAAc;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEpB,MAAM,iBAAiB;OAAK;CAAA;CAAA;CAAA;OAAA;OAAA;CAAA;OAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAE5B,MAAM,2BAAgB;OAAA;OAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEtB,MAAM,qBAAS;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA;AAEf,MAAM,mBAAmB;OAAE;CAAA;OAAA;OAAA;CAAA;CAAA;CAAA;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}