@shell-shock/core 0.17.10 → 0.17.12

package/dist/plugin.mjs

@@ -1,31 +1,30 @@
 import { getAppDescription, getAppName, getAppTitle, getDynamicPathSegmentName, isDynamicPathSegment, isPathSegmentGroup } from "./plugin-utils/context-helpers.mjs";
 import { CommandDocsFile } from "./components/docs.mjs";
 import { ExecBuiltin } from "./components/exec-builtin.mjs";
-import { extractType } from "./plugin-utils/deepkit.mjs";
 import { traverseCommands } from "./plugin-utils/traverse-command-tree.mjs";
 import { getCommandTree } from "./plugin-utils/get-command-tree.mjs";
-import "./plugin-utils/index.mjs";
 import { StateBuiltin } from "./components/state-builtin.mjs";
 import { UtilsBuiltin } from "./components/utils-builtin.mjs";
 import { commands } from "./helpers/automd.mjs";
+import { getFramework } from "./helpers/get-framework.mjs";
 import { findCommandsRoot, resolveCommandId, resolveCommandName, resolveCommandPath } from "./helpers/paths.mjs";
-import { getCommandsPersistencePath, readCommandsPersistence, writeCommandsPersistence } from "./helpers/persistence.mjs";
+import { writeCommandsPersistence } from "./helpers/persistence.mjs";
 import { formatBinaryPath, updatePackageJsonBinary } from "./helpers/update-package-json.mjs";
 import { formatCommandTree, getGlobalOptions } from "./helpers/utilities.mjs";
 import { validateCommand } from "./helpers/validations.mjs";
 import { resolve } from "./resolver/resolve.mjs";
 import { createComponent } from "@alloy-js/core/jsx-runtime";
-import { For, Show } from "@alloy-js/core/components";
-import { ReflectionVisibility } from "@powerlines/deepkit/vendor/type";
+import { For, Show } from "@alloy-js/core";
 import { render } from "@powerlines/plugin-alloy/render";
 import automd from "@powerlines/plugin-automd";
-import { writeEnvTypeReflection } from "@powerlines/plugin-env/helpers";
+import { extractEnv, writeEnv } from "@powerlines/plugin-env/helpers/schema";
 import nodejs from "@powerlines/plugin-nodejs";
 import tsdown from "@powerlines/plugin-tsdown";
+import { addProperty, getCacheFilePath, getProperties, isJsonSchemaObject } from "@powerlines/schema";
 import { toArray } from "@stryke/convert/to-array";
 import { chmodX } from "@stryke/fs/chmod-x";
 import { appendPath } from "@stryke/path/append";
-import { findFilePath } from "@stryke/path/file-path-fns";
+import { findFilePath } from "@stryke/path/find";
 import { isParentPath } from "@stryke/path/is-parent-path";
 import { joinPaths } from "@stryke/path/join-paths";
 import { replacePath } from "@stryke/path/replace";
@@ -34,8 +33,10 @@ import { camelCase } from "@stryke/string-format/camel-case";
 import { constantCase } from "@stryke/string-format/constant-case";
 import { kebabCase } from "@stryke/string-format/kebab-case";
 import { isObject } from "@stryke/type-checks/is-object";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
 import { isSetString } from "@stryke/type-checks/is-set-string";
 import { defu } from "defu";
+import { isFileReference } from "powerlines";
 import { resolveInputs } from "powerlines/utils";
 
 //#region src/plugin.tsx
@@ -52,7 +53,7 @@ const plugin = __assignType((options = {}) => {
 		(tsdown.Ω = [["Context", "\"w!"]], tsdown()),
 		(automd.Ω = [["Context", "\"w!"]], automd()),
 		{
-			name: "shell-shock:config",
+			name: "shell-shock/core:config",
 			config: __assignType(async function config() {
 				this.debug("Resolving the Shell Shock configuration.");
 				return defu(options, {
@@ -61,7 +62,7 @@ const plugin = __assignType((options = {}) => {
 					description: getAppDescription(this),
 					platform: "node",
 					projectType: "application",
-					framework: "shell-shock",
+					framework: getFramework(),
 					isCaseSensitive: false,
 					output: {
 						format: "esm",
@@ -106,13 +107,13 @@ const plugin = __assignType((options = {}) => {
 						title: this.config.title,
 						description: this.config.description,
 						alias: [],
-						isVirtual: false
+						virtual: false
 					}));
 					this.globalOptions = this.globalOptions.map(__assignType((option) => ({
 						...option,
 						name: camelCase(option.name),
 						alias: option.alias ?? [],
-						optional: option.optional ?? false
+						required: option.required ?? true
 					}), [
 						"option",
 						"",
@@ -122,13 +123,39 @@ const plugin = __assignType((options = {}) => {
 			}
 		},
 		...(nodejs.Ω = [["Context", "\"w!"]], nodejs(defu(options ?? {}, { env: {
-			types: "@shell-shock/core/types/env#ShellShockEnv",
+			config: "@shell-shock/core/types/env#ShellShockEnv",
 			validate: false
 		} }))),
 		{
-			name: "shell-shock:inputs",
+			name: "shell-shock/core:inputs",
 			async configResolved() {
-				this.debug(`Checking for commands using input: ${JSON.stringify(this.config.input)}`);
+				const toInputLocation = __assignType((value) => {
+					if (isSetString(value)) return value;
+					if (isSetObject(value) && isFileReference(value)) return String(value.file);
+					return null;
+				}, [
+					"value",
+					"",
+					"P#2!P&,J/\""
+				]);
+				const configuredInputs = [];
+				if (Array.isArray(this.config.input)) configuredInputs.push(...this.config.input.map(toInputLocation).filter(__assignType((value) => isSetString(value), [
+					"value",
+					"",
+					"P\"2!!/\""
+				])));
+				else if (isSetString(this.config.input)) configuredInputs.push(this.config.input);
+				else if (isSetObject(this.config.input) && isFileReference(this.config.input)) configuredInputs.push(String(this.config.input.file));
+				else if (isSetObject(this.config.input)) configuredInputs.push(...Object.values(this.config.input).map(toInputLocation).filter(__assignType((value) => isSetString(value), [
+					"value",
+					"",
+					"P\"2!!/\""
+				])));
+				this.debug(configuredInputs.length <= 1 ? `Checking for command modules in the following location: ${configuredInputs[0] ?? "(none configured)"}.` : `Checking for command modules in the following locations:\n${configuredInputs.map(__assignType((input) => ` - ${input}`, [
+					"input",
+					"",
+					"P\"2!\"/\""
+				])).join("\n")}`);
 				this.commandsPath = await findCommandsRoot(this);
 				this.debug(`Resolved commands root path: ${this.commandsPath}`);
 				const inputs = await resolveInputs(this, this.config.input);
@@ -168,14 +195,12 @@ const plugin = __assignType((options = {}) => {
 							name,
 							alias: [],
 							tags: [],
-							isVirtual: false,
-							source: "file",
+							virtual: false,
 							entry: {
 								...entry,
-								file: entry.file,
 								input: {
 									file: entry.file,
-									name: entry.name
+									export: entry.export
 								},
 								output: name
 							}
@@ -204,7 +229,7 @@ const plugin = __assignType((options = {}) => {
 			}, ["prepare", "P\"/!"])
 		},
 		{
-			name: "shell-shock:virtual-inputs",
+			name: "shell-shock/core:virtual-inputs",
 			configResolved: {
 				order: "post",
 				async handler() {
@@ -255,9 +280,8 @@ const plugin = __assignType((options = {}) => {
 											name,
 											alias: [],
 											tags: [],
-											isVirtual: true,
-											entry: { file },
-											source: "file"
+											virtual: true,
+											entry: { file }
 										});
 									}
 								}
@@ -275,7 +299,7 @@ const plugin = __assignType((options = {}) => {
 							"",
 							"P\"2!\"2\"\"/#"
 						]));
-						this.debug(`Final command input list: \n${this.inputs.map(__assignType((command) => ` - ${command.id}${command.isVirtual ? " (virtual)" : ""}: ${command.source === "file" ? replacePath(command.entry.file, this.commandsPath) : `added by ${command.source}`}`, [
+						this.debug(`Final command input list: \n${this.inputs.map(__assignType((command) => ` - ${command.id}${command.virtual ? " (virtual)" : ""}`, [
 							"command",
 							"",
 							"P\"2!\"/\""
@@ -285,54 +309,53 @@ const plugin = __assignType((options = {}) => {
 			}
 		},
 		{
-			name: "shell-shock:update-env",
+			name: "shell-shock/core:update-env",
 			configResolved: {
 				order: "post",
 				async handler() {
 					this.debug("Adding global options to the CLI application's environment variables.");
+					if (!this.env.config) {
+						this.debug("Environment variable schema not found in plugin context. Extracting environment variable schema from type definitions provided in plugin options.");
+						await extractEnv(this);
+						if (!this.env.config) throw new Error("Failed to extract environment variable schema from type definitions provided in plugin options. Please ensure the `env.types` option is correctly specified and points to a valid TypeScript type definition file.");
+					}
+					if (!isJsonSchemaObject(this.env.config.schema)) throw new Error("Invalid environment variable schema extracted.");
+					const env = getProperties(this.env.config);
 					for (const option of Object.values(this.globalOptions).filter(__assignType((option) => Boolean(option.env), [
 						"option",
 						"",
 						"P\"2!\"/\""
-					])).filter(__assignType((option) => !this.env.types.env.getPropertyOrUndefined(option.env), [
+					])).filter(__assignType((option) => isSetString(option.env) && !env[option.env], [
 						"option",
 						"",
 						"P\"2!\"/\""
-					]))) this.env.types.env.addProperty({
+					]))) addProperty(this.env.config, option.env, {
+						...option,
 						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"
-						}
+						alias: option.alias.filter(__assignType((alias) => alias.length > 1, [
+							"alias",
+							"",
+							"P\"2!\"/\""
+						])).map(__assignType((alias) => constantCase(alias), [
+							"alias",
+							"",
+							"P\"2!\"/\""
+						]))
 					});
-					await writeEnvTypeReflection(this, this.env.types.env, "env");
+					await writeEnv(this);
 				}
 			}
 		},
 		{
-			name: "shell-shock:resolve-commands",
+			name: "shell-shock/core:resolve-commands",
 			prepare: {
 				order: "post",
 				async handler() {
 					this.debug("Initializing the CLI application's command tree.");
 					this.commands = {};
-					if (this.config.command !== "prepare" && this.config.skipCache !== true && this.persistedMeta?.checksum === this.meta.checksum && this.fs.existsSync(getCommandsPersistencePath(this))) {
+					if (this.config.command !== "prepare" && this.config.skipCache !== true && this.persistedMeta?.checksum === this.meta.checksum && this.fs.existsSync(getCacheFilePath(this, this.env.config))) {
 						this.debug(`Skipping command resolution as the meta checksum has not changed.`);
-						await readCommandsPersistence(this);
+						await extractEnv(this);
 					} else {
 						for (const input of this.inputs.filter(__assignType((input) => input.segments.filter(__assignType((segment) => !isDynamicPathSegment(segment) && !isPathSegmentGroup(segment), [
 							"segment",
@@ -352,7 +375,7 @@ const plugin = __assignType((options = {}) => {
 								...option,
 								name: camelCase(name),
 								alias: option.alias ?? [],
-								optional: option.optional ?? false
+								required: option.required ?? true
 							}], [
 								"param0",
 								"",
@@ -388,7 +411,7 @@ const plugin = __assignType((options = {}) => {
 			}
 		},
 		{
-			name: "shell-shock:chmod+x",
+			name: "shell-shock/core:chmod+x",
 			configResolved() {
 				this.config.tsdown.hooks ??= {};
 				this.config.tsdown.hooks["build:done"] = __assignType(async (_) => {
@@ -415,7 +438,7 @@ const plugin = __assignType((options = {}) => {
 			}
 		},
 		{
-			name: "shell-shock:docs",
+			name: "shell-shock/core:docs",
 			configResolved: __assignType(function configResolved() {
 				this.config.automd ??= {};
 				this.config.automd.generators = {
@@ -438,7 +461,7 @@ const plugin = __assignType((options = {}) => {
 					get children() {
 						return __assignType((child) => createComponent(Show, {
 							get when() {
-								return !child.isVirtual;
+								return !child.virtual;
 							},
 							get children() {
 								return createComponent(CommandDocsFile, { command: child });

package/dist/plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.mjs","names":[],"sources":["../src/plugin.tsx"],"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 { For, Show } from \"@alloy-js/core/components\";\nimport { ReflectionVisibility } from \"@powerlines/deepkit/vendor/type\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport automd from \"@powerlines/plugin-automd\";\nimport { writeEnvTypeReflection } from \"@powerlines/plugin-env/helpers\";\nimport nodejs from \"@powerlines/plugin-nodejs\";\nimport tsdown from \"@powerlines/plugin-tsdown\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { chmodX } from \"@stryke/fs/chmod-x\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { findFilePath } from \"@stryke/path/file-path-fns\";\nimport { isParentPath } from \"@stryke/path/is-parent-path\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { resolveParentPath } from \"@stryke/path/resolve-parent-path\";\nimport { camelCase } from \"@stryke/string-format/camel-case\";\nimport { constantCase } from \"@stryke/string-format/constant-case\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { isObject } from \"@stryke/type-checks/is-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { defu } from \"defu\";\nimport type { Plugin } from \"powerlines\";\nimport { resolveInputs } from \"powerlines/utils\";\nimport type { BuildContext, RolldownChunk, TsdownHooks } from \"tsdown\";\nimport { CommandDocsFile } from \"./components/docs\";\nimport { ExecBuiltin } from \"./components/exec-builtin\";\nimport { StateBuiltin } from \"./components/state-builtin\";\nimport { UtilsBuiltin } from \"./components/utils-builtin\";\nimport { commands } from \"./helpers/automd\";\nimport {\n  findCommandsRoot,\n  resolveCommandId,\n  resolveCommandName,\n  resolveCommandPath\n} from \"./helpers/paths\";\nimport {\n  getCommandsPersistencePath,\n  readCommandsPersistence,\n  writeCommandsPersistence\n} from \"./helpers/persistence\";\nimport {\n  formatBinaryPath,\n  updatePackageJsonBinary\n} from \"./helpers/update-package-json\";\nimport { formatCommandTree, getGlobalOptions } from \"./helpers/utilities\";\nimport { validateCommand } from \"./helpers/validations\";\nimport { extractType } from \"./plugin-utils\";\nimport {\n  getAppDescription,\n  getAppName,\n  getAppTitle,\n  getDynamicPathSegmentName,\n  isDynamicPathSegment,\n  isPathSegmentGroup\n} from \"./plugin-utils/context-helpers\";\nimport { getCommandTree } from \"./plugin-utils/get-command-tree\";\nimport { traverseCommands } from \"./plugin-utils/traverse-command-tree\";\nimport { resolve } from \"./resolver/resolve\";\nimport type { CommandTree } from \"./types/command\";\nimport type { Options } from \"./types/config\";\nimport type { Context } from \"./types/context\";\n\nconst MAX_DEPTH = 50;\n\n/**\n * The core Powerlines plugin to build Shell Shock projects.\n */\nexport const plugin = <TContext extends Context = Context>(\n  options: Options = {}\n): Plugin<TContext>[] => {\n  return [\n    tsdown<TContext>(),\n    automd<TContext>(),\n    {\n      name: \"shell-shock:config\",\n      async config() {\n        this.debug(\"Resolving the Shell Shock configuration.\");\n\n        const result = defu(options, {\n          name: getAppName(this),\n          title: getAppTitle(this),\n          description: getAppDescription(this),\n          platform: \"node\",\n          projectType: \"application\",\n          framework: \"shell-shock\",\n          isCaseSensitive: false,\n          output: {\n            format: \"esm\",\n            dts: false\n          },\n          input:\n            !this.config.input ||\n            (Array.isArray(this.config.input) &&\n              this.config.input.length === 0) ||\n            (isObject(this.config.input) &&\n              Object.keys(this.config.input).length === 0)\n              ? [\"src/**/command.ts\", \"src/**/command.tsx\"]\n              : undefined,\n          resolve: {\n            external: [\"@powerlines/deepkit\"],\n            skipNodeModulesBundle: true\n          },\n          tsdown: {\n            dts: false,\n            nodeProtocol: true,\n            unbundle: false\n          }\n        });\n\n        return result;\n      },\n      configResolved: {\n        order: \"pre\",\n        async handler() {\n          this.debug(\"Shell Shock configuration has been resolved.\");\n\n          await updatePackageJsonBinary(this);\n\n          this.config.appSpecificEnvPrefix = isSetString(\n            this.config.autoAssignEnv\n          )\n            ? this.config.autoAssignEnv\n            : constantCase(getAppName(this));\n          if (\n            !this.config.env.prefix ||\n            !Array.isArray(this.config.env.prefix)\n          ) {\n            this.config.env.prefix = toArray(this.config.env.prefix);\n          }\n\n          if (\n            !this.config.env.prefix.includes(this.config.appSpecificEnvPrefix)\n          ) {\n            this.config.env.prefix.push(this.config.appSpecificEnvPrefix);\n          }\n\n          this.config.bin = (isSetString(this.packageJson.bin)\n            ? { [kebabCase(this.config.name)]: this.packageJson.bin }\n            : this.packageJson.bin) ?? {\n            [kebabCase(this.config.name)]: formatBinaryPath(\n              this.config.output.format\n            )\n          };\n\n          if (isSetString(this.config.reference)) {\n            if (this.config.reference.includes(\"{command}\")) {\n              this.config.reference = {\n                app: this.config.reference\n                  .substring(0, this.config.reference.indexOf(\"{command}\"))\n                  .replace(/\\/?$/, \"/\"),\n                commands: this.config.reference\n              };\n            } else if (this.config.reference.includes(\"{commands}\")) {\n              this.config.reference = {\n                app: this.config.reference\n                  .substring(0, this.config.reference.indexOf(\"{commands}\"))\n                  .replace(/\\/?$/, \"/\"),\n                commands: this.config.reference\n              };\n            } else {\n              this.config.reference = {\n                app: this.config.reference\n              };\n            }\n          }\n\n          this.inputs ??= [];\n          this.globalOptions = Object.values(\n            getGlobalOptions(this, {\n              id: null,\n              name: this.config.name,\n              path: null,\n              segments: [],\n              title: this.config.title,\n              description: this.config.description,\n              alias: [],\n              isVirtual: false\n            })\n          );\n\n          this.globalOptions = this.globalOptions.map(option => ({\n            ...option,\n            name: camelCase(option.name),\n            alias: option.alias ?? [],\n            optional: option.optional ?? false\n          }));\n        }\n      }\n    },\n    ...nodejs<TContext>(\n      defu(options ?? {}, {\n        env: {\n          types: \"@shell-shock/core/types/env#ShellShockEnv\",\n          validate: false\n        }\n      })\n    ),\n    {\n      name: \"shell-shock:inputs\",\n      async configResolved() {\n        this.debug(\n          `Checking for commands using input: ${JSON.stringify(this.config.input)}`\n        );\n\n        this.commandsPath = await findCommandsRoot(this);\n        this.debug(`Resolved commands root path: ${this.commandsPath}`);\n\n        const inputs = await resolveInputs(this, this.config.input);\n\n        this.debug(\n          `Found ${\n            inputs.length\n          } entry points specified in the configuration options.`\n        );\n\n        this.inputs = inputs.reduce((ret, entry) => {\n          if (\n            entry.file !== this.commandsPath &&\n            !isParentPath(entry.file, this.commandsPath)\n          ) {\n            throw new Error(\n              `Command entry point \"${\n                entry.file\n              }\" is not located within the commands root \"${\n                this.commandsPath\n              }\". Please ensure that all command entry points are located within the current project.`\n            );\n          }\n\n          const id = resolveCommandId(this, entry.file);\n          if (!ret.some(existing => existing.id === id)) {\n            const name = resolveCommandName(entry.file);\n            let segments = resolveCommandPath(this, entry.file)\n              .split(\"/\")\n              .filter(Boolean);\n\n            // Ensure unique segment names by appending an index suffix to duplicates\n            segments = segments.map((segment, index) => {\n              const found = segments.findIndex(\n                existing => existing === segment\n              );\n              if (found !== -1 && found !== index) {\n                segment += `_${\n                  segments.filter(\n                    segment =>\n                      isDynamicPathSegment(segment) &&\n                      getDynamicPathSegmentName(segment).replace(\n                        /_\\d+$/,\n                        \"\"\n                      ) === segment\n                  ).length\n                }`;\n              }\n\n              return segment;\n            });\n\n            ret.push({\n              id,\n              path: segments.join(\"/\"),\n              segments,\n              name,\n              alias: [],\n              tags: [],\n              isVirtual: false,\n              source: \"file\",\n              entry: {\n                ...entry,\n                file: entry.file,\n                input: {\n                  file: entry.file,\n                  name: entry.name\n                },\n                output: name\n              }\n            });\n          }\n\n          return ret;\n        }, this.inputs);\n\n        this.debug(\n          `Shell Shock will process ${\n            this.inputs.length\n          } command entry files: \\n${this.inputs\n            .map(\n              command =>\n                ` - ${command.id}: ${replacePath(\n                  command.entry.file,\n                  this.commandsPath\n                )}`\n            )\n            .join(\"\\n\")}`\n        );\n      },\n      async prepare() {\n        this.debug(\n          \"Rendering base built-in modules for the Shell Shock application.\"\n        );\n\n        return render(\n          this,\n          <>\n            <StateBuiltin />\n            <UtilsBuiltin />\n            <ExecBuiltin />\n          </>\n        );\n      }\n    },\n    {\n      name: \"shell-shock:virtual-inputs\",\n      configResolved: {\n        order: \"post\",\n        async handler() {\n          if (this.inputs.length === 0) {\n            this.warn(\n              \"No commands were found in the project. Please ensure at least one command exists.\"\n            );\n          } else {\n            this.debug(\n              \"Finding and adding virtual command inputs for each command previously found.\"\n            );\n\n            this.inputs = this.inputs\n              .reduce((ret, command) => {\n                let depth = 0;\n\n                let parentPath = resolveParentPath(\n                  findFilePath(command.entry.file)\n                );\n                if (isParentPath(parentPath, this.commandsPath)) {\n                  while (parentPath !== this.commandsPath) {\n                    if (depth++ > MAX_DEPTH) {\n                      throw new Error(\n                        `Unable to process virtual commands for ${\n                          command.name\n                        } \\n\\nPlease ensure ${\n                          command.entry.file\n                        } is a valid command entry file and does not have an invalid path.`\n                      );\n                    }\n\n                    if (\n                      !ret.some(\n                        existing =>\n                          findFilePath(existing.entry.file) === parentPath\n                      )\n                    ) {\n                      const file = joinPaths(parentPath, \"command.ts\");\n                      const id = resolveCommandId(this, file);\n                      if (!ret.some(existing => existing.id === id)) {\n                        const name = resolveCommandName(file);\n\n                        let segments = resolveCommandPath(this, file)\n                          .split(\"/\")\n                          .filter(Boolean);\n\n                        // Ensure unique segment names by appending an index suffix to duplicates\n                        segments = segments.map((segment, index) => {\n                          const found = segments.findIndex(\n                            existing => existing === segment\n                          );\n                          if (found !== -1 && found !== index) {\n                            segment += `_${\n                              segments.filter(\n                                segment =>\n                                  isDynamicPathSegment(segment) &&\n                                  getDynamicPathSegmentName(segment).replace(\n                                    /_\\d+$/,\n                                    \"\"\n                                  ) === segment\n                              ).length\n                            }`;\n                          }\n\n                          return segment;\n                        });\n\n                        ret.push({\n                          id,\n                          path: segments.join(\"/\"),\n                          segments,\n                          name,\n                          alias: [],\n                          tags: [],\n                          isVirtual: true,\n                          entry: {\n                            file\n                          },\n                          source: \"file\"\n                        });\n                      }\n                    }\n\n                    parentPath = resolveParentPath(parentPath);\n                  }\n                }\n\n                return ret;\n              }, this.inputs)\n              .sort((a, b) => a.segments.length - b.segments.length);\n\n            this.debug(\n              `Final command input list: \\n${this.inputs\n                .map(\n                  command =>\n                    ` - ${command.id}${command.isVirtual ? \" (virtual)\" : \"\"}: ${\n                      command.source === \"file\"\n                        ? replacePath(command.entry.file, this.commandsPath)\n                        : `added by ${command.source}`\n                    }`\n                )\n                .join(\"\\n\")}`\n            );\n          }\n        }\n      }\n    },\n    {\n      name: \"shell-shock:update-env\",\n      configResolved: {\n        order: \"post\",\n        async handler() {\n          this.debug(\n            \"Adding global options to the CLI application's environment variables.\"\n          );\n\n          for (const option of Object.values(this.globalOptions)\n            .filter(option => Boolean(option.env))\n            .filter(\n              option =>\n                !this.env.types.env.getPropertyOrUndefined(option.env as string)\n            )) {\n            this.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          await writeEnvTypeReflection(this, this.env.types.env, \"env\");\n        }\n      }\n    },\n    {\n      name: \"shell-shock:resolve-commands\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\"Initializing the CLI application's command tree.\");\n\n          this.commands = {};\n          if (\n            this.config.command !== \"prepare\" &&\n            this.config.skipCache !== true &&\n            this.persistedMeta?.checksum === this.meta.checksum &&\n            this.fs.existsSync(getCommandsPersistencePath(this))\n          ) {\n            this.debug(\n              `Skipping command resolution as the meta checksum has not changed.`\n            );\n\n            await readCommandsPersistence(this);\n          } else {\n            for (const input of this.inputs.filter(\n              input =>\n                input.segments.filter(\n                  segment =>\n                    !isDynamicPathSegment(segment) &&\n                    !isPathSegmentGroup(segment)\n                ).length === 1\n            )) {\n              this.commands[input.name] = await resolve({\n                context: this,\n                command: input\n              });\n            }\n\n            this.debug(\"Post-processing commands to ensure proper reflection.\");\n\n            await traverseCommands(this, command => {\n              command.options = Object.fromEntries(\n                Object.entries(command.options).map(([name, option]) => [\n                  camelCase(name),\n                  {\n                    ...option,\n                    name: camelCase(name),\n                    alias: option.alias ?? [],\n                    optional: option.optional ?? false\n                  }\n                ])\n              );\n            });\n\n            await writeCommandsPersistence(this);\n          }\n\n          this.debug(\"Validating the CLI applications command tree.\");\n\n          let isValid = true;\n          await traverseCommands(this, command => {\n            const failures = validateCommand(command);\n            if (failures.length > 0) {\n              this.error(\n                `Found ${failures.length} issue${failures.length > 1 ? \"s\" : \"\"} with the ${\n                  command.title\n                } command: \\n${failures\n                  .map(failure => ` - ${failure.code}: ${failure.details}`)\n                  .join(\"\\n\")}\\n`\n              );\n              isValid = false;\n            }\n          });\n          if (!isValid) {\n            throw new Error(\n              `One or more commands in the command tree are invalid. Please review the errors above and correct them before proceeding.`\n            );\n          }\n\n          this.info(\n            `\\nCreating an application with the following command tree: \\n${formatCommandTree(\n              this\n            )}\\n`\n          );\n        }\n      }\n    },\n    {\n      name: \"shell-shock:chmod+x\",\n      configResolved() {\n        this.config.tsdown.hooks ??= {};\n        (this.config.tsdown.hooks as TsdownHooks)[\"build:done\"] = async (\n          _: BuildContext & {\n            chunks: RolldownChunk[];\n          }\n        ) => {\n          await Promise.all(\n            Object.values(this.config.bin).map(async bin => {\n              const path = appendPath(\n                bin,\n                joinPaths(this.config.cwd, this.config.root)\n              );\n              if (this.fs.existsSync(path)) {\n                this.debug(\n                  `Adding hashbang to binary executable output file: ${path}`\n                );\n\n                const content = await this.fs.read(path);\n                if (content && !content.startsWith(\"#!\")) {\n                  await this.fs.write(\n                    path,\n                    `#!/usr/bin/env ${\n                      this.config.mode === \"development\"\n                        ? \"-S NODE_OPTIONS=--enable-source-maps\"\n                        : \"\"\n                    } node\\n\\n${content}`\n                  );\n                }\n\n                this.debug(\n                  `Adding executable permissions (chmod+x) to binary executable output file: ${\n                    path\n                  }`\n                );\n\n                await chmodX(path);\n              } else {\n                this.warn(\n                  `Expected binary output file not found at path: ${\n                    path\n                  }. Skipping adding hashbang and executable permissions (chmod+x).`\n                );\n              }\n            })\n          );\n        };\n      }\n    },\n    {\n      name: \"shell-shock:docs\",\n      configResolved() {\n        this.config.automd ??= {};\n        this.config.automd.generators = {\n          ...(this.config.automd.generators ?? {}),\n          commands: commands(this)\n        };\n      },\n      async docs() {\n        this.debug(\n          \"Rendering entrypoint modules for the Shell Shock `script` preset.\"\n        );\n\n        const commands = this.inputs\n          .map(input => getCommandTree(this, input.segments))\n          .filter(Boolean) as CommandTree[];\n\n        return render(\n          this,\n          <For each={Object.values(commands)} doubleHardline>\n            {child => (\n              <Show when={!child.isVirtual}>\n                <CommandDocsFile command={child} />\n              </Show>\n            )}\n          </For>\n        );\n      }\n    }\n  ];\n};\n\nexport default plugin;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEE,IAAG,SAAS;;;AAyDd,MAAE,YAAgB;;;;AAIlB,MAAS,SAAA,cAA0B,UAAQ,EAAA,KAAA;AAC3C,QAAS;GAAA,OAAA,IAAa,CAAC,CAAA,WAAQ,OAAO,CAAA,EAAM,QAAA;GAAA,OAAA,IAAA,CAAA,CAAA,WAAA,OAAA,CAAA,EAAA,QAAA;EAAA;GAC5C,MAAO;GACL,QAAA,aAAiB,eAAA,SAAA;AACjB,SAAA,MAAU,2CAAA;AAwBR,WAvBS,KAAA,SAAA;KACX,MAAA,WAAA,KAAyB;KACzB,OAAA,YAAoB,KAAA;KACpB,aAAA,kBAAA,KAAA;KACM,UAAS;KACT,aAAC;KACD,WAAC;KACD,iBAAiB;KAClB,QAAO;MACP,QAAO;MACP,KAAO;;KAER,OAAS,CAAC,KAAI,OAAA,SAAA,MAAA,QAAA,KAAA,OAAA,MAAA,IAAA,KAAA,OAAA,MAAA,WAAA,KAAA,SAAA,KAAA,OAAA,MAAA,IAAA,OAAA,KAAA,KAAA,OAAA,MAAA,CAAA,WAAA,IAAA,CAAA,qBAAA,qBAAA,GAAA;;MAElB,UAAA,CAAA,sBAAA;MACK,uBAA0B;MAC/B;KACK,QAAM;MACH,KAAC;MACD,cAAc;MACf,UAAA;MACL;KACA,CACA;MACE,CAAA,UAAY,QAAO,CAAA;GACrB,gBAAgB;IACd,OAAO;;AAEL,UAAK,MAAC,+CAAuB;AAC7B,WAAM,wBAAkB,KAAA;AACxB,UAAE,OAAO,uBAAiB,YAAA,KAAA,OAAA,cAAA,GAAA,KAAA,OAAA,gBAAA,aAAA,WAAA,KAAA,CAAA;AAC1B,SAAE,CAAA,KAAA,OAAa,IAAA,UAAA,CAAiB,MAAM,QAAA,KAAA,OAAA,IAAA,OAAA,CACpC,MAAA,OAAW,IAAK,SAAA,QAAA,KAAA,OAAA,IAAA,OAAA;AAElB,SAAE,CAAA,KAAA,OAAY,IAAM,OAAM,SAAA,KAAA,OAAA,qBAAA,CACxB,MAAA,OAAA,IAAgB,OAAM,KAAA,KAAA,OAAA,qBAAA;AAExB,UAAI,OAAQ,OAAK,YAAA,KAAA,YAAA,IAAA,GAAA,GACd,UAAM,KAAA,OAAA,KAAA,GAAA,KAAA,YAAA,KACR,GAAE,KAAA,YAAA,QAAA,GACD,UAAK,KAAA,OAAA,KAAA,GAAA,iBAAA,KAAA,OAAA,OAAA,OAAA,EACN;AACD,SAAI,YAAO,KAAQ,OAAK,UAAc,CACpC,KAAI,KAAK,OAAO,UAAM,SAAa,YAAE,CACnC,MAAC,OAAS,YAAY;MACpB,KAAA,KAAO,OAAU,UAAO,UAAa,GAAG,KAAG,OAAA,UAAA,QAAA,YAAA,CAAA,CAAA,QAAA,QAAA,IAAA;MAC3C,UAAU,KAAC,OAAW;MACvB;cACM,KAAA,OAAA,UAAA,SAAA,aAAA,CACP,MAAA,OAAY,YAAY;MACxB,KAAA,KAAA,OAAA,UAAuB,UAAA,GAAA,KAAA,OAAA,UAAA,QAAA,aAAA,CAAA,CAAA,QAAA,QAAA,IAAA;MACxB,UAAA,KAAA,OAAA;MACD;SAEE,MAAA,OAAY,YAAM,EAClB,KAAA,KAAU,OAAA,WACZ;AAGF,UAAA,WAAa,EAAA;AACd,UAAA,gBAAA,OAAA,OAAA,iBAAA,MAAA;MACD,IAAA;MACE,MAAQ,KAAI,OAAA;MACZ,MAAM;MACJ,UAAU,EAAE;;MAEZ,aAAM,KAAA,OAAA;;MAEN,WAAW;MACZ,CAAC,CAAC;AACH,UAAE,gBAAA,KAAA,cAAA,IAAA,cAAA,YAAA;MACA,GAAG;MACH,MAAI,UAAY,OAAC,KAAW;MAC5B,OAAG,OAAA,SAAA,EAAA;MACH,UAAQ,OAAO,YAAY;MAC5B,GAAG;MAAC;MAAM;MAAQ;MAAK,CAAM,CAAC;;IAElC;GACF;EAAE,IAAI,OAAC,IAAA,CAAA,CAAA,WAAA,OAAA,CAAA,EAAA,OAAA,KAAA,WAAA,EAAA,EAAA;GAEJ,OAAO;GACP,UAAO;GACR,EACF,CAAC,CAAC;EAAG;GACJ,MAAM;;AAEJ,SAAI,MAAK,sCAA+B,KAAY,UAAG,KAAA,OAAA,MAAA,GAAA;AACvD,SAAK,eAAe,MAAM,iBAAe,KAAK;AAC9C,SAAK,MAAG,gCAAyB,KAAA,eAAA;IACjC,MAAM,SAAC,MAAc,cAAc,MAAE,KAAA,OAAgB,MAAA;AACrD,SAAK,MAAG,SAAY,OAAO,OAAA,uDAAA;AAC3B,SAAK,SAAC,OAAA,OAAA,cAAA,KAAA,UAAA;AACJ,SAAG,MAAA,SAAA,KAAA,gBAAA,CAAA,aAAA,MAAA,MAAA,KAAA,aAAA;KAGH,MAAM,KAAE,iBAAY,MAAU,MAAU,KAAC;AACzC,SAAI,CAAC,IAAC,KAAK,cAAgB,aAAG,SAAA,OAAA,IAAA;MAAA;MAAA;MAAA;MAAA,CAAA,CAAA,EAAA;MAC5B,MAAM,OAAK,mBAAY,MAAA,KAAA;MACvB,IAAI,WAAK,mBAAyB,MAAA,MAAU,KAAO,CAAC,MAAE,IAAQ,CAAC,OAAC,QAAA;AAEhE,iBAAM,SAAc,IAAC,cAAO,SAAA,UAAA;OAC1B,MAAG,QAAA,SAAA,UAAA,cAAA,aAAA,aAAA,SAAA;QAAA;QAAA;QAAA;QAAA,CAAA,CAAA;AACH,WAAE,UAAS,MAAK,UAAO,MACrB,YAAW,IAAC,SAAY,OAAA,cAAA,YAAA,qBAAA,QAAA,IAAA,0BAAA,QAAA,CAAA,QAAA,SAAA,GAAA,KAAA,SAAA;QAAA;QAAA;QAAA;QAAA,CAAA,CAAA,CAAA;AAE1B,cAAO;SACN;OAAC;OAAK;OAAe;OAAI;OAAC,CAAA,CAAA;AAC7B,UAAI,KAAE;OACJ;OACA,MAAM,SAAC,KAAA,IAAA;OACP;OACA;OACA,OAAG,EAAA;OACH,MAAA,EAAA;OACF,WAAA;;OAEA,OAAK;QACD,GAAC;QACH,MAAA,MAAA;QACE,OAAI;SACJ,MAAM,MAAK;SACX,MAAM,MAAI;SACV;QACA,QAAO;QACR;OACF,CAAC;;AAEJ,YAAK;OACJ;KAAC;KAAC;KAAA;KAAA;KAAA,CAAA,EAAA,KAAA,OAAA;;;;;;;GAGP,SAAS,aAAQ,eAAA,UAAA;AACf,SAAK,MAAM,mEAAuB;AAClC,WAAM,OAAO,MAAO;KAAA,gBAAW,cAAA,EAAA,CAAA;KAAA,gBAAA,cAAA,EAAA,CAAA;KAAA,gBAAA,aAAA,EAAA,CAAA;KAAA,CAAA;MAC9B,CAAC,WAAI,QAAU,CAAA;GACnB;EAAE;GACD,MAAI;GACJ,gBAAE;IACD,OAAA;IACC,MAAC,UAAe;AAChB,SAAK,KAAA,OAAa,WAAE,EAClB,MAAK,KAAA,oFAAA;UACE;AACL,WAAA,MAAU,+EAAA;AACZ,WAAA,SAAA,KAAA,OAAA,OAAA,cAAA,KAAA,YAAA;OACD,IAAA,QAAA;OACF,IAAA,aAAA,kBAAA,aAAA,QAAA,MAAA,KAAA,CAAA;AACD,WAAA,aAAA,YAAA,KAAA,aAAA,CACS,QAAM,eAAa,KAAA,cAAA;AACpB,YAAA,UAAiB,UACX,OAAA,IAAA,MAAA,0CAAA,QAAA,KAAA,qBAAA,QAAA,MAAA,KAAA,mEAAA;AAET,YAAA,CAAA,IAAA,KAAA,cAAA,aAAA,aAAA,SAAA,MAAA,KAAA,KAAA,YAAA;SAAA;SAAA;SAAA;SAAA,CAAA,CAAA,EAAA;;SAEI,MAAA,KAAe,iBAAM,MAAiB,KAAK;AACtC,aAAE,CAAA,IAAA,KAAS,cAAc,aAAa,SAAA,OAAe,IAAA;UAAA;UAAA;UAAA;UAAA,CAAA,CAAA,EAAA;;UAEnD,IAAG,WAAM,mBAAyB,MAAM,KAAC,CAAK,MAAC,IAAA,CAAA,OAAA,QAAA;AAEjD,qBAAA,SAAA,IAAA,cAAA,SAAA,UAAA;WACA,MAAA,QAAA,SAAA,UAAA,cAAA,aAAA,aAAA,SAAA;YAAA;YAAA;YAAA;YAAA,CAAA,CAAA;AACC,eAAA,UAAA,MAAA,UAAA,MACK,YAAW,IAAG,SAAI,OAAa,cAAS,YAAA,qBAAA,QAAA,IAAA,0BAAA,QAAA,CAAA,QAAA,SAAA,GAAA,KAAA,SAAA;YAAA;YAAA;YAAA;YAAA,CAAA,CAAA,CAAA;;aAG1C;WAAA;WAAa;WAAO;WAAM;WAAI,CAAA,CAAA;AACvC,cAAA,KAAA;WACS;WACT,MAAa,SAAW,KAAK,IAAC;WAC/B;WACU;WACA,OAAO,EAAA;WACP,MAAA,EAAA;WACF,WAAY;WACX,OAAA,EACG,MACX;WACH,QAAA;;;;AAIE,qBAAa,kBAAmB,WAAW;;AAG3C,cAAG;;;;;;;;;;;;AAEL,WAAK,MAAM,+BAAyB,KAAU,OAAQ,IAAC,cAAU,YAAA,MAAA,QAAA,KAAA,QAAA,YAAA,eAAA,GAAA,IAAA,QAAA,WAAA,SAAA,YAAA,QAAA,MAAA,MAAA,KAAA,aAAA,GAAA,YAAA,QAAA,YAAA;OAAA;OAAA;OAAA;OAAA,CAAA,CAAA,CAAA,KAAA,KAAA,GAAA;;;IAGtE;GACF;EAAE;GACD,MAAM;GACN,gBAAY;IACV,OAAO;IACP,MAAM,UAAQ;AACZ,UAAK,MAAM,wEAAkC;AAC7C,UAAK,MAAM,UAAG,OAAA,OAAA,KAA0B,cAAS,CAAA,OAAO,cAAA,WAAA,QAAA,OAAA,IAAA,EAAA;MAAA;MAAA;MAAA;MAAA,CAAA,CAAA,CAAA,OAAA,cAAA,WAAA,CAAA,KAAA,IAAA,MAAA,IAAA,uBAAA,OAAA,IAAA,EAAA;MAAA;MAAA;MAAA;MAAA,CAAA,CAAA,CACtD,MAAK,IAAI,MAAM,IAAI,YAAE;MACnB,MAAM,OAAO;MACb,UAAU,OAAM,WAAA,OAAA;MAChB,aAAQ,OAAA;MACR,YAAM,qBAAA;MACN,MAAE,YAAA,OAAA;;MAEF,MAAE;OACA,OAAA,OAAA;;;;;;;;;;OAEF,QAAS;OACR;MACF,CAAC;AAEJ,WAAM,uBAAI,MAAA,KAAA,IAAA,MAAA,KAAA,MAAA;;IAEb;GACF;EAAE;GACD,MAAM;GACN,SAAS;IACP,OAAO;IACP,MAAM,UAAU;AACd,UAAK,MAAG,mDAAO;AACf,UAAK,WAAW,EAAA;AAChB,SAAI,KAAK,OAAO,YAAM,aAAA,KAAA,OAAA,cAAA,QAAA,KAAA,eAAA,aAAA,KAAA,KAAA,YAAA,KAAA,GAAA,WAAA,2BAAA,KAAA,CAAA,EAAA;AACpB,WAAK,MAAE,oEAAA;AACP,YAAM,wBAAQ,KAAA;YACV;AACJ,WAAI,MAAA,SAAA,KAAA,OAAA,OAAA,cAAA,UAAA,MAAA,SAAA,OAAA,cAAA,YAAA,CAAA,qBAAA,QAAA,IAAA,CAAA,mBAAA,QAAA,EAAA;OAAA;OAAA;OAAA;OAAA,CAAA,CAAA,CAAA,WAAA,GAAA;OAAA;OAAA;OAAA;OAAA,CAAA,CAAA,CACJ,MAAA,SAAA,MAAA,QAAA,MAAA,QAAA;;OAEA,SAAU;OACT,CAAA;AAEH,WAAK,MAAK,wDAAA;AACR,YAAM,iBAAY,MAAS,cAAA,YAAA;AACzB,eAAK,UAAO,OAAA,YAAA,OAAA,QAAA,QAAA,QAAA,CAAA,IAAA,cAAA,CAAA,MAAA,YAAA,CAAA,UAAA,KAAA,EAAA;QACZ,GAAA;QACC,MAAG,UAAA,KAAA;QACF,OAAO,OAAE,SAAA,EAAA;QACT,UAAQ,OAAQ,YAAO;QACxB,CAAC,EAAE;QAAC;QAAS;QAAK;QAAK,CAAA,CAAA,CAAA;SACvB;OAAC;OAAS;OAAA;OAAA,CAAA,CAAA;AACb,YAAM,yBAAE,KAAA;;AAEV,UAAK,MAAM,gDAAK;KAChB,IAAC,UAAA;AACF,WAAA,iBAAA,MAAA,cAAA,YAAA;MACD,MAAM,WAAU,gBAAA,QAAA;AACd,UAAK,SAAK,SAAA,GAAA;AACP,YAAA,MAAU,SAAW,SAAG,OAAY,QAAS,SAAO,SAAW,IAAC,MAAA,GAAA,YAAA,QAAA,MAAA,cAAA,SAAA,IAAA,cAAA,YAAA,MAAA,QAAA,KAAA,IAAA,QAAA,WAAA;QAAA;QAAA;QAAA;QAAA,CAAA,CAAA,CAAA,KAAA,KAAA,CAAA,IAAA;AAClE,iBAAA;;QAED;MAAA;MAAa;MAAA;MAAA,CAAA,CAAA;AACb,SAAE,CAAA,QACA,OAAC,IAAA,MAAA,2HAAA;AAEH,UAAK,KAAA,gEAAc,kBAAA,KAAA,CAAA,IAAA;;IAEtB;GACF;EAAE;GACD,MAAE;GACF,iBAAC;AACD,SAAA,OAAA,OAAA,UAAA,EAAA;AACE,SAAK,OAAO,OAAO,MAAA,gBAAe,aAAA,OAAA,MAAA;AAClC,WAAA,QAAgB,IAAA,OAAA,OAAA,KAAA,OAAA,IAAA,CAAA,IAAA,aAAA,OAAA,QAAA;MACd,MAAQ,OAAK,WAAA,KAAA,UAAA,KAAA,OAAA,KAAA,KAAA,OAAA,KAAA,CAAA;AACb,UAAM,KAAA,GAAQ,WAAE,KAAA,EAAA;AACZ,YAAE,MAAK,qDAAqB,OAAA;OAC5B,MAAK,UAAI,MAAA,KAAA,GAAA,KAAA,KAAA;AACT,WAAG,WAAY,CAAA,QAAK,WAAa,KAAO,CACvC,OAAA,KAAA,GAAA,MAAA,MAAA,kBAAA,KAAA,OAAA,SAAA,gBAAA,yCAAA,GAAA,WAAA,UAAA;AAED,YAAK,MAAK,6EAAA,OAAA;AACV,aAAG,OAAQ,KAAI;;QAIhB;MAAC;MAAG;MAAQ;MAAK,CAAA,CAAO,CAAC;OAC3B;KAAC;KAAU;KAAK;KAAI;KAAA,CAAA;;GAE1B;EAAE;GACD,MAAM;GACN,gBAAa,aAAA,SAAA,iBAAA;AACX,SAAK,OAAO,WAAE,EAAA;AACd,SAAK,OAAO,OAAO,aAAa;KAC9B,GAAI,KAAK,OAAO,OAAO,cAAc,EAAA;KACrC,UAAU,SAAS,KAAK;KACzB;MACA,CAAC,kBAAkB,QAAO,CAAC;GAC9B,MAAM,OAAO;AACX,SAAK,MAAM,oEAAuB;IAClC,MAAM,WAAW,KAAK,OAAG,IAAM,cAAc,UAAS,eAAgB,MAAC,MAAQ,SAAK,EAAA;KAAA;KAAA;KAAA;KAAA,CAAA,CAAA,CAAA,OAAA,QAAA;AACpF,WAAO,OAAO,MAAG,gBAAA,KAAA;KACf,IAAI,OAAO;;;KAGX,gBAAe;KACf,IAAI,WAAW;AACb,aAAO,cAAS,UAAa,gBAAe,MAAS;OACnD,IAAI,OAAM;AACR,eAAO,CAAC,MAAA;;OAEV,IAAI,WAAW;AACb,eAAO,gBAAe,iBAAoB,EACxC,SAAQ;;OAGb,CAAC,EAAE;OAAC;OAAS;OAAG;OAAS,CAAA;;;;GAIjC;EAAC;GACD;CAAC;CAAW;QAAiB,EAAA;CAAM;CAAE;CAAS,CAAS"}
+{"version":3,"file":"plugin.mjs","names":[],"sources":[],"mappings":""}

package/dist/resolver/helpers.cjs

@@ -1,6 +1,4 @@
-const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require_context_helpers = require('../plugin-utils/context-helpers.cjs');
-const require_types_command = require('../types/command.cjs');
 let _stryke_string_format_constant_case = require("@stryke/string-format/constant-case");
 let _stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
 let defu = require("defu");
@@ -17,53 +15,57 @@ function __assignType(fn, args) {
 * Resolves the description for a command option based on its reflection.
 *
 * @param name - The name of the command option.
-* @param kind - The reflection kind of the command option.
-* @param optional - Whether the command option is optional.
+* @param type - The reflection kind of the command option.
+* @param required - Whether the command option is required.
 * @param variadic - Whether the command option is variadic (i.e., an array).
 * @param title - The title of the command option, if any.
 * @param defaultValue - The default value of the command option, if any.
 * @returns The resolved description for the command option.
 */
-function resolveCommandOptionDescription(name, kind, optional = false, variadic = false, title, defaultValue) {
-	return `A${optional && !defaultValue ? "n optional" : ""} command-line ${kind === require_types_command.CommandParameterKinds.boolean ? "flag" : "option"} that allows the user to ${kind === require_types_command.CommandParameterKinds.boolean ? "set the" : variadic ? "specify custom" : "specify a custom"} ${title?.trim() || (0, _stryke_string_format_title_case.titleCase)(name)} ${kind === require_types_command.CommandParameterKinds.boolean ? "indicator" : `${kind === require_types_command.CommandParameterKinds.number ? "numeric" : "string"} value${variadic ? "s" : ""}`}.`;
+function resolveCommandOptionDescription(name, type, required = true, variadic = false, title, defaultValue) {
+	return `A${!required && !defaultValue ? "n optional" : ""} command-line ${type === "boolean" ? "flag" : "option"} that allows the user to ${type === "boolean" ? "set the" : variadic ? "specify custom" : "specify a custom"} ${title?.trim() || (0, _stryke_string_format_title_case.titleCase)(name)} ${type === "boolean" ? "indicator" : `${type === "number" ? "numeric" : "string"} value${variadic ? "s" : ""}`}.`;
 }
 resolveCommandOptionDescription.__type = [
 	"name",
-	"CommandParameterKind",
-	"kind",
-	"optional",
+	"string",
+	"number",
+	"boolean",
+	"type",
+	"required",
 	"variadic",
 	"title",
 	"defaultValue",
 	"resolveCommandOptionDescription",
 	"Resolves the description for a command option based on its reflection.",
-	"P&2!\"w\"2#\"2$\"2%&2&8\"2'8&/(?)"
+	"P&2!P.\".#.$J2%\"2&\"2'&2(8\"2)8&/*?+"
 ];
 /**
 * Resolves the description for a command argument based on its reflection.
 *
 * @param name - The name of the command argument.
-* @param kind - The reflection kind of the command argument.
-* @param optional - Whether the command argument is optional.
+* @param type - The reflection kind of the command argument.
+* @param required - Whether the command argument is required.
 * @param variadic - Whether the command argument is variadic (i.e., an array).
 * @param title - The title of the command argument, if any.
 * @param defaultValue - The default value of the command argument, if any.
 * @returns The resolved description for the command argument.
 */
-function resolveCommandArgumentDescription(name, kind, optional = false, variadic = false, title, defaultValue) {
-	return `An${optional && !defaultValue ? " optional" : ""} argument that allows the user to ${kind === require_types_command.CommandParameterKinds.boolean ? "set the" : variadic ? "specify custom" : "specify a custom"} ${title?.trim() || (0, _stryke_string_format_title_case.titleCase)(name)} ${kind === require_types_command.CommandParameterKinds.boolean ? "indicator" : `${kind === require_types_command.CommandParameterKinds.number ? "numeric" : "string"} value${variadic ? "s" : ""}`}.`;
+function resolveCommandArgumentDescription(name, type, required = true, variadic = false, title, defaultValue) {
+	return `An${!required && !defaultValue ? " optional" : ""} argument that allows the user to ${type === "boolean" ? "set the" : variadic ? "specify custom" : "specify a custom"} ${title?.trim() || (0, _stryke_string_format_title_case.titleCase)(name)} ${type === "boolean" ? "indicator" : `${type === "number" ? "numeric" : "string"} value${variadic ? "s" : ""}`}.`;
 }
 resolveCommandArgumentDescription.__type = [
 	"name",
-	"CommandParameterKind",
-	"kind",
-	"optional",
+	"string",
+	"number",
+	"boolean",
+	"type",
+	"required",
 	"variadic",
 	"title",
 	"defaultValue",
 	"resolveCommandArgumentDescription",
 	"Resolves the description for a command argument based on its reflection.",
-	"P&2!\"w\"2#\"2$\"2%&2&8\"2'8&/(?)"
+	"P&2!P.\".#.$J2%\"2&\"2'&2(8\"2)8&/*?+"
 ];
 function applyOptionsDefaults(ctx) {
 	return Object.fromEntries(Object.entries(ctx.output.options).map(__assignType(([key, option]) => {
@@ -73,7 +75,7 @@ function applyOptionsDefaults(ctx) {
 			...option,
 			name,
 			title,
-			description: option.description || resolveCommandOptionDescription(name, option.kind, option.optional, option.kind !== require_types_command.CommandParameterKinds.boolean && option.variadic, title, option.default),
+			description: option.description || resolveCommandOptionDescription(name, option.type, option.required, option.type !== "boolean" && option.variadic, title, option.default),
 			env: option.env || option.env === false ? option.env : ctx.input.context.config.autoAssignEnv ? (0, _stryke_string_format_constant_case.constantCase)(name) : false
 		}];
 	}, [
@@ -96,7 +98,7 @@ function applyArgsDefaults(ctx) {
 			...arg,
 			name,
 			title,
-			description: arg.description || resolveCommandArgumentDescription(name, arg.kind, arg.optional, arg.kind !== require_types_command.CommandParameterKinds.boolean && arg.variadic, title, arg.default),
+			description: arg.description || resolveCommandArgumentDescription(name, arg.type, arg.required, arg.type !== "boolean" && arg.variadic, title, arg.default),
 			env: arg.name ? arg.env || arg.env === false ? arg.env : ctx.input.context.config.autoAssignEnv ? (0, _stryke_string_format_constant_case.constantCase)(name) : false : false
 		};
 	}, [
@@ -115,7 +117,7 @@ applyArgsDefaults.__type = [
 ];
 function applyDefaults(ctx) {
 	ctx.output.description ??= `The ${ctx.output.title.replace(/(?:c|C)ommands?$/, "").trim()} executable command-line interface.`;
-	if ((0, _stryke_type_checks_is_set_string.isSetString)(ctx.input.context.config.reference?.commands) && ctx.input.context.config.reference.commands.includes("{command}")) ctx.output.reference ??= ctx.input.context.config.reference.commands ? ctx.input.context.config.reference.commands.replace("{command}", ctx.input.command.segments.filter(__assignType((segment) => !require_context_helpers.isDynamicPathSegment(segment), [
+	if ((0, _stryke_type_checks_is_set_string.isSetString)(ctx.input.context.config.reference?.commands) && ctx.input.context.config.reference.commands.includes("{command}")) ctx.output.docs ??= ctx.input.context.config.reference.commands ? ctx.input.context.config.reference.commands.replace("{command}", ctx.input.command.segments.filter(__assignType((segment) => !require_context_helpers.isDynamicPathSegment(segment), [
 		"segment",
 		"",
 		"P\"2!\"/\""
@@ -127,6 +129,12 @@ applyDefaults.__type = [
 	"applyDefaults",
 	"P\"w!2\"\"/#"
 ];
+/**
+* Resolves a virtual command by applying default values to its title and description based on the command name and application title.
+*
+* @template TContext - The type of the context object.
+* @param ctx - The resolver context containing the input and output for the command resolution process.
+*/
 function resolveVirtualCommand(ctx) {
 	ctx.output.title ??= (0, _stryke_string_format_title_case.titleCase)(ctx.input.command.name);
 	ctx.output.description ??= `A collection of available ${ctx.output.title.replace(/(?:c|C)ommands?$/, "").trim() || (0, _stryke_string_format_title_case.titleCase)(ctx.input.command.name)} commands that are included in the ${require_context_helpers.getAppTitle(ctx.input.context, true)} command-line application.`;
@@ -135,7 +143,8 @@ resolveVirtualCommand.__type = [
 	"ResolverContext",
 	"ctx",
 	"resolveVirtualCommand",
-	"P\"w!2\"\"/#"
+	"Resolves a virtual command by applying default values to its title and description based on the command name and application title.",
+	"P\"w!2\"\"/#?$"
 ];
 /**
 * Merges two command parameters, giving precedence to string values in the second configuration.
@@ -169,5 +178,5 @@ const mergeCommandParameter = (0, defu.createDefu)(__assignType((obj, key, value
 exports.applyArgsDefaults = applyArgsDefaults;
 exports.applyDefaults = applyDefaults;
 exports.applyOptionsDefaults = applyOptionsDefaults;
-exports.mergeCommandParameter = mergeCommandParameter;
-exports.resolveVirtualCommand = resolveVirtualCommand;
+exports.resolveVirtualCommand = resolveVirtualCommand;
+//# sourceMappingURL=helpers.cjs.map

package/dist/resolver/helpers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.cjs","names":[],"sources":[],"mappings":""}