@shell-shock/core 0.2.1 → 0.3.0

package/dist/plugin.cjs

@@ -0,0 +1,267 @@
+Object.defineProperty(exports, '__esModule', { value: true });
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_plugin_utils_context_helpers = require('./plugin-utils/context-helpers.cjs');
+const require_components_docs = require('./components/docs.cjs');
+const require_persistence = require('./helpers/persistence.cjs');
+const require_utilities = require('./helpers/utilities.cjs');
+const require_resolve_command = require('./helpers/resolve-command.cjs');
+const require_update_package_json = require('./helpers/update-package-json.cjs');
+const require_validations = require('./helpers/validations.cjs');
+const require_plugin_utils_get_command_tree = require('./plugin-utils/get-command-tree.cjs');
+const require_plugin_utils_traverse_command_tree = require('./plugin-utils/traverse-command-tree.cjs');
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let __alloy_js_core_components = require("@alloy-js/core/components");
+let __powerlines_plugin_alloy_render = require("@powerlines/plugin-alloy/render");
+let __powerlines_plugin_nodejs = require("@powerlines/plugin-nodejs");
+__powerlines_plugin_nodejs = require_rolldown_runtime.__toESM(__powerlines_plugin_nodejs);
+let __powerlines_plugin_tsdown = require("@powerlines/plugin-tsdown");
+__powerlines_plugin_tsdown = require_rolldown_runtime.__toESM(__powerlines_plugin_tsdown);
+let __stryke_convert_to_array = require("@stryke/convert/to-array");
+let __stryke_fs_chmod_x = require("@stryke/fs/chmod-x");
+let __stryke_path_append = require("@stryke/path/append");
+let __stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
+let __stryke_path_is_parent_path = require("@stryke/path/is-parent-path");
+let __stryke_path_join_paths = require("@stryke/path/join-paths");
+let __stryke_path_replace = require("@stryke/path/replace");
+let __stryke_path_resolve_parent_path = require("@stryke/path/resolve-parent-path");
+let __stryke_string_format_camel_case = require("@stryke/string-format/camel-case");
+let __stryke_string_format_constant_case = require("@stryke/string-format/constant-case");
+let __stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
+let __stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
+let __stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+let defu = require("defu");
+let powerlines_lib_entry = require("powerlines/lib/entry");
+
+//#region src/plugin.tsx
+const MAX_DEPTH = 50;
+/**
+* The core Powerlines plugin to build Shell Shock projects.
+*/
+const plugin = (options = {}) => {
+	return [
+		(0, __powerlines_plugin_tsdown.default)(),
+		{
+			name: "shell-shock:config",
+			async config() {
+				this.debug("Resolving the Shell Shock configuration.");
+				await require_update_package_json.updatePackageJsonBinary(this);
+				const result = (0, defu.defu)({ output: { buildPath: (0, __stryke_path_join_paths.joinPaths)(this.config.projectRoot, "dist") } }, options, {
+					name: require_plugin_utils_context_helpers.getAppName(this),
+					title: require_plugin_utils_context_helpers.getAppTitle(this),
+					description: require_plugin_utils_context_helpers.getAppDescription(this),
+					envPrefix: (0, __stryke_string_format_constant_case.constantCase)(require_plugin_utils_context_helpers.getAppName(this)),
+					env: { prefix: [] },
+					automd: { generators: {} },
+					isCaseSensitive: false,
+					output: {
+						format: "esm",
+						dts: true
+					},
+					entry: !this.config.entry || Array.isArray(this.config.entry) && this.config.entry.length === 0 ? [(0, __stryke_path_join_paths.joinPaths)(this.config.sourceRoot, "**/*.ts"), (0, __stryke_path_join_paths.joinPaths)(this.config.sourceRoot, "**/*.tsx")] : void 0,
+					build: {
+						dts: false,
+						platform: "node",
+						nodeProtocol: true,
+						unbundle: false
+					},
+					type: "application",
+					framework: "shell-shock"
+				});
+				if (!result.env.prefix.includes(result.envPrefix)) result.env.prefix.push(result.envPrefix);
+				return result;
+			},
+			configResolved: {
+				order: "pre",
+				async handler() {
+					this.debug("Shell Shock configuration has been resolved.");
+					this.config.bin = ((0, __stryke_type_checks_is_set_string.isSetString)(this.packageJson.bin) ? { [(0, __stryke_string_format_kebab_case.kebabCase)(this.config.name)]: this.packageJson.bin } : this.packageJson.bin) ?? { [(0, __stryke_string_format_kebab_case.kebabCase)(this.config.name)]: require_update_package_json.formatBinaryPath(this.config.output.format) };
+					this.inputs ??= [];
+					this.options = Object.values(require_utilities.getDefaultOptions(this, {
+						id: null,
+						name: this.config.name,
+						title: this.config.title,
+						description: this.config.description,
+						path: {
+							value: null,
+							segments: []
+						},
+						isVirtual: false
+					}));
+				}
+			}
+		},
+		...(0, __powerlines_plugin_nodejs.default)(),
+		{
+			name: "shell-shock:inputs",
+			async configResolved() {
+				this.debug("Finding command entry point files.");
+				this.commandsPath = require_resolve_command.findCommandsRoot(this);
+				const entries = await (0, powerlines_lib_entry.resolveEntries)(this, (0, __stryke_convert_to_array.toArray)(this.config.entry || []));
+				this.debug(`Found ${entries.length} entry points specified in the configuration options.`);
+				this.inputs = entries.reduce((ret, entry) => {
+					if (!(0, __stryke_path_is_parent_path.isParentPath)(entry.file, this.commandsPath)) throw new Error(`Command entry point "${entry.file}" is not located within the commands root "${this.commandsPath}". Please ensure that all command entry points are located within the current project.`);
+					const id = require_resolve_command.resolveCommandId(this, entry.file);
+					if (!ret.some((existing) => existing.id === id)) {
+						const path = require_resolve_command.resolveCommandPath(this, entry.file);
+						const name = require_resolve_command.resolveCommandName(entry.file);
+						ret.push({
+							id,
+							path: {
+								value: path,
+								segments: path.split("/").filter(Boolean)
+							},
+							name,
+							isVirtual: false,
+							entry: {
+								...entry,
+								file: entry.file,
+								input: {
+									file: entry.file,
+									name: entry.name
+								},
+								output: name
+							}
+						});
+					}
+					return ret;
+				}, this.inputs);
+				this.debug(`Shell Shock will process ${this.inputs.length} command entry files: \n${this.inputs.map((command) => ` - ${command.id}: ${(0, __stryke_path_replace.replacePath)(command.entry.file, this.commandsPath)}`).join("\n")}`);
+			}
+		},
+		{
+			name: "shell-shock:virtual-inputs",
+			configResolved: {
+				order: "post",
+				async handler() {
+					if (this.inputs.length === 0) this.warn("No commands were found in the project. Please ensure at least one command exists.");
+					else {
+						this.debug(`Shell Shock will create an application with the following commands: \n${this.inputs.filter((cmd) => !cmd.isVirtual).map((command) => ` - ${command.id}: ${(0, __stryke_path_replace.replacePath)(command.entry.file, this.commandsPath)}${command.isVirtual ? " (virtual)" : ""}`).join("\n")}`);
+						this.debug("Finding and adding virtual command inputs for each command previously found.");
+						this.inputs = this.inputs.reduce((ret, command) => {
+							let depth = 0;
+							let parentPath = (0, __stryke_path_resolve_parent_path.resolveParentPath)((0, __stryke_path_file_path_fns.findFilePath)(command.entry.file));
+							while (parentPath !== this.commandsPath) {
+								if (depth++ > MAX_DEPTH) throw new Error(`Maximum command virtual parent depth of ${MAX_DEPTH} exceeded while processing command: ${command.name}`);
+								if (!ret.some((existing) => (0, __stryke_path_file_path_fns.findFilePath)(existing.entry.file) === parentPath)) {
+									const file = (0, __stryke_path_join_paths.joinPaths)(parentPath, "command.ts");
+									const id = require_resolve_command.resolveCommandId(this, file);
+									if (!ret.some((existing) => existing.id === id)) {
+										const name = require_resolve_command.resolveCommandName(file);
+										const path = require_resolve_command.resolveCommandPath(this, file);
+										ret.push({
+											id,
+											path: {
+												value: path,
+												segments: path.split("/").filter(Boolean)
+											},
+											name,
+											isVirtual: true,
+											entry: { file }
+										});
+									}
+								}
+								parentPath = (0, __stryke_path_resolve_parent_path.resolveParentPath)(parentPath);
+							}
+							return ret;
+						}, this.inputs).sort((a, b) => a.path.segments.length - b.path.segments.length);
+						this.debug(`Final command input list: \n${this.inputs.map((command) => ` - ${command.id}: ${(0, __stryke_path_replace.replacePath)(command.entry.file, this.commandsPath)}${command.isVirtual ? " (virtual)" : ""}`).join("\n")}`);
+					}
+				}
+			}
+		},
+		{
+			name: "shell-shock:reflect-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(require_persistence.getCommandsPersistencePath(this))) {
+						this.debug(`Skipping reflection initialization as the meta checksum has not changed.`);
+						await require_persistence.readCommandsPersistence(this);
+					} else {
+						for (const input of this.inputs.filter((input$1) => input$1.path.segments.filter((segment) => !require_plugin_utils_context_helpers.isVariableCommandPath(segment)).length === 1)) this.commands[input.name] = await require_resolve_command.reflectCommandTree(this, input);
+						this.debug("Post-processing commands to ensure proper reflection.");
+						this.options = this.options.map((option) => ({
+							...option,
+							name: (0, __stryke_string_format_camel_case.camelCase)(option.name),
+							alias: option.alias ?? [],
+							optional: option.optional ?? false
+						}));
+						await require_plugin_utils_traverse_command_tree.traverseCommands(this, (command) => {
+							command.options = Object.fromEntries(Object.entries(command.options).map(([name, option]) => [(0, __stryke_string_format_camel_case.camelCase)(name), {
+								...option,
+								name: (0, __stryke_string_format_camel_case.camelCase)(name),
+								alias: option.alias ?? [],
+								optional: option.optional ?? false
+							}]));
+						});
+						await require_persistence.writeCommandsPersistence(this);
+					}
+					this.debug("Validating the CLI applications command tree.");
+					let isValid = true;
+					await require_plugin_utils_traverse_command_tree.traverseCommands(this, (command) => {
+						const failures = require_validations.validateCommand(command);
+						if (failures.length > 0) {
+							this.error(`Found ${failures.length} issue${failures.length > 1 ? "s" : ""} with the ${command.title} command: \n${failures.map((failure) => ` - ${failure.code}: ${failure.details}`).join("\n")}\n`);
+							isValid = false;
+						}
+					});
+					if (!isValid) throw new Error(`One or more commands in the command tree are invalid. Please review the errors above and correct them before proceeding.`);
+					this.info(`\nCreating an application with the following command tree: \n${require_utilities.formatCommandTree(this)}\n`);
+				}
+			}
+		},
+		{
+			name: "shell-shock:chmod+x",
+			configResolved() {
+				this.config.build.outputOptions ??= {};
+				this.config.build.outputOptions.banner = (chunk) => {
+					if (chunk.isEntry && (0, __stryke_path_join_paths.joinPaths)(this.entryPath, "bin.ts") === chunk.facadeModuleId) {
+						this.debug(`Adding hashbang to binary executable output file: ${chunk.fileName}`);
+						return `#!/usr/bin/env ${this.config.mode === "development" ? "-S NODE_OPTIONS=--enable-source-maps" : ""} node\n`;
+					}
+					return "";
+				};
+			},
+			async buildEnd() {
+				if (!(0, __stryke_type_checks_is_set_object.isSetObject)(this.config.bin)) this.warn(`No binaries were found for the ${this.config.name} application. Please ensure the binaries are correctly configured in your Shell Shock configuration or package.json.`);
+				else await Promise.all(Object.values(this.config.bin).map(async (bin) => {
+					const path = (0, __stryke_path_append.appendPath)(bin, (0, __stryke_path_join_paths.joinPaths)(this.workspaceConfig.workspaceRoot, this.config.projectRoot));
+					if (this.fs.existsSync(path)) {
+						this.debug(`Adding executable permissions (chmod+x) to binary executable output file: ${path}`);
+						await (0, __stryke_fs_chmod_x.chmodX)(path);
+					} else this.warn(`Unable to locate the binary executable output file: ${path}. This may indicate either a misconfiguration in the package.json file or an issue with the build process.`);
+				}));
+			}
+		},
+		{
+			name: "shell-shock:docs",
+			async docs() {
+				this.debug("Rendering entrypoint modules for the Shell Shock `script` preset.");
+				const commands = this.inputs.map((input) => require_plugin_utils_get_command_tree.getCommandTree(this, input.path.segments)).filter(Boolean);
+				return (0, __powerlines_plugin_alloy_render.render)(this, (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core_components.For, {
+					get each() {
+						return Object.values(commands);
+					},
+					doubleHardline: true,
+					children: (child) => (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core_components.Show, {
+						get when() {
+							return !child.isVirtual;
+						},
+						get children() {
+							return (0, __alloy_js_core_jsx_runtime.createComponent)(require_components_docs.CommandDocsFile, { command: child });
+						}
+					})
+				}));
+			}
+		}
+	];
+};
+var plugin_default = plugin;
+
+//#endregion
+exports.default = plugin_default;
+exports.plugin = plugin;
+exports.shellShock = plugin;
+//# sourceMappingURL=plugin.cjs.map

package/dist/plugin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs","names":["For","Show","render","nodejs","tsdown","toArray","chmodX","appendPath","findFilePath","isParentPath","joinPaths","replacePath","resolveParentPath","camelCase","constantCase","kebabCase","isSetObject","isSetString","defu","resolveEntries","CommandDocsFile","getCommandsPersistencePath","readCommandsPersistence","writeCommandsPersistence","findCommandsRoot","reflectCommandTree","resolveCommandId","resolveCommandName","resolveCommandPath","formatBinaryPath","updatePackageJsonBinary","formatCommandTree","getDefaultOptions","validateCommand","getAppDescription","getAppName","getAppTitle","isVariableCommandPath","getCommandTree","traverseCommands","MAX_DEPTH","plugin","options","name","config","debug","result","output","buildPath","projectRoot","title","description","envPrefix","env","prefix","automd","generators","isCaseSensitive","format","dts","entry","Array","isArray","length","sourceRoot","undefined","build","platform","nodeProtocol","unbundle","type","framework","includes","push","configResolved","order","handler","bin","packageJson","inputs","Object","values","id","path","value","segments","isVirtual","commandsPath","entries","reduce","ret","file","Error","some","existing","split","filter","Boolean","input","map","command","join","warn","cmd","depth","parentPath","sort","a","b","prepare","commands","skipCache","persistedMeta","checksum","meta","fs","existsSync","segment","option","alias","optional","fromEntries","isValid","failures","error","failure","code","details","info","outputOptions","banner","chunk","isEntry","entryPath","facadeModuleId","fileName","mode","buildEnd","Promise","all","workspaceConfig","workspaceRoot","docs","_$createComponent","each","doubleHardline","children","child","when","shellShock"],"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 { render } from \"@powerlines/plugin-alloy/render\";\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 { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { defu } from \"defu\";\nimport type { Plugin } from \"powerlines\";\nimport { resolveEntries } from \"powerlines/lib/entry\";\nimport type { RenderedChunk } from \"rolldown\";\nimport type { OutputOptions } from \"tsdown\";\nimport { CommandDocsFile } from \"./components/docs\";\nimport {\n  getCommandsPersistencePath,\n  readCommandsPersistence,\n  writeCommandsPersistence\n} from \"./helpers/persistence\";\nimport {\n  findCommandsRoot,\n  reflectCommandTree,\n  resolveCommandId,\n  resolveCommandName,\n  resolveCommandPath\n} from \"./helpers/resolve-command\";\nimport {\n  formatBinaryPath,\n  updatePackageJsonBinary\n} from \"./helpers/update-package-json\";\nimport { formatCommandTree, getDefaultOptions } from \"./helpers/utilities\";\nimport { validateCommand } from \"./helpers/validations\";\nimport {\n  getAppDescription,\n  getAppName,\n  getAppTitle,\n  isVariableCommandPath\n} from \"./plugin-utils/context-helpers\";\nimport { getCommandTree } from \"./plugin-utils/get-command-tree\";\nimport { traverseCommands } from \"./plugin-utils/traverse-command-tree\";\nimport type { CommandOption, 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) => {\n  return [\n    tsdown(),\n    {\n      name: \"shell-shock:config\",\n      async config() {\n        this.debug(\"Resolving the Shell Shock configuration.\");\n\n        await updatePackageJsonBinary(this);\n\n        const result = defu(\n          {\n            output: {\n              buildPath: joinPaths(this.config.projectRoot, \"dist\")\n            }\n          },\n          options,\n          {\n            name: getAppName(this),\n            title: getAppTitle(this),\n            description: getAppDescription(this),\n            envPrefix: constantCase(getAppName(this)),\n            env: {\n              prefix: [] as string[]\n            },\n            automd: {\n              generators: {}\n            },\n            isCaseSensitive: false,\n            output: {\n              format: \"esm\",\n              dts: true\n            },\n            entry:\n              !this.config.entry ||\n              (Array.isArray(this.config.entry) &&\n                this.config.entry.length === 0)\n                ? [\n                    joinPaths(this.config.sourceRoot, \"**/*.ts\"),\n                    joinPaths(this.config.sourceRoot, \"**/*.tsx\")\n                  ]\n                : undefined,\n            build: {\n              dts: false,\n              platform: \"node\",\n              nodeProtocol: true,\n              unbundle: false\n            },\n            type: \"application\",\n            framework: \"shell-shock\"\n          }\n        );\n        if (!result.env.prefix.includes(result.envPrefix)) {\n          result.env.prefix.push(result.envPrefix);\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          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          this.inputs ??= [];\n          this.options = Object.values(\n            getDefaultOptions(this, {\n              id: null,\n              name: this.config.name,\n              title: this.config.title,\n              description: this.config.description,\n              path: {\n                value: null,\n                segments: []\n              },\n              isVirtual: false\n            })\n          );\n        }\n      }\n    },\n    ...nodejs<TContext>(),\n    {\n      name: \"shell-shock:inputs\",\n      async configResolved() {\n        this.debug(\"Finding command entry point files.\");\n\n        this.commandsPath = findCommandsRoot(this);\n\n        const entries = await resolveEntries(\n          this,\n          toArray(this.config.entry || [])\n        );\n        this.debug(\n          `Found ${\n            entries.length\n          } entry points specified in the configuration options.`\n        );\n\n        this.inputs = entries.reduce((ret, entry) => {\n          if (!isParentPath(entry.file, this.commandsPath)) {\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 path = resolveCommandPath(this, entry.file);\n            const name = resolveCommandName(entry.file);\n\n            ret.push({\n              id,\n              path: {\n                value: path,\n                segments: path.split(\"/\").filter(Boolean)\n              },\n              name,\n              isVirtual: false,\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    },\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              `Shell Shock will create an application with the following commands: \\n${this.inputs\n                .filter(cmd => !cmd.isVirtual)\n                .map(\n                  command =>\n                    ` - ${command.id}: ${replacePath(\n                      command.entry.file,\n                      this.commandsPath\n                    )}${command.isVirtual ? \" (virtual)\" : \"\"}`\n                )\n                .join(\"\\n\")}`\n            );\n\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                while (parentPath !== this.commandsPath) {\n                  if (depth++ > MAX_DEPTH) {\n                    throw new Error(\n                      `Maximum command virtual parent depth of ${\n                        MAX_DEPTH\n                      } exceeded while processing command: ${command.name}`\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                      const path = resolveCommandPath(this, file);\n\n                      ret.push({\n                        id,\n                        path: {\n                          value: path,\n                          segments: path.split(\"/\").filter(Boolean)\n                        },\n                        name,\n                        isVirtual: true,\n                        entry: {\n                          file\n                        }\n                      });\n                    }\n                  }\n\n                  parentPath = resolveParentPath(parentPath);\n                }\n\n                return ret;\n              }, this.inputs)\n              .sort((a, b) => a.path.segments.length - b.path.segments.length);\n\n            this.debug(\n              `Final command input list: \\n${this.inputs\n                .map(\n                  command =>\n                    ` - ${command.id}: ${replacePath(\n                      command.entry.file,\n                      this.commandsPath\n                    )}${command.isVirtual ? \" (virtual)\" : \"\"}`\n                )\n                .join(\"\\n\")}`\n            );\n          }\n        }\n      }\n    },\n    {\n      name: \"shell-shock:reflect-commands\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\"Initializing the CLI application's command tree.\");\n          this.commands = {};\n\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 reflection initialization 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.path.segments.filter(\n                  segment => !isVariableCommandPath(segment)\n                ).length === 1\n            )) {\n              this.commands[input.name] = await reflectCommandTree(this, input);\n            }\n\n            this.debug(\"Post-processing commands to ensure proper reflection.\");\n\n            this.options = this.options.map(\n              option =>\n                ({\n                  ...option,\n                  name: camelCase(option.name),\n                  alias: option.alias ?? [],\n                  optional: option.optional ?? false\n                }) as CommandOption\n            );\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                  } as CommandOption\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.build.outputOptions ??= {} as OutputOptions;\n        (this.config.build.outputOptions as OutputOptions).banner = (\n          chunk: RenderedChunk\n        ) => {\n          if (\n            chunk.isEntry &&\n            joinPaths(this.entryPath, \"bin.ts\") === chunk.facadeModuleId\n          ) {\n            this.debug(\n              `Adding hashbang to binary executable output file: ${chunk.fileName}`\n            );\n\n            return `#!/usr/bin/env ${\n              this.config.mode === \"development\"\n                ? \"-S NODE_OPTIONS=--enable-source-maps\"\n                : \"\"\n            } node\\n`;\n          }\n          return \"\";\n        };\n      },\n      async buildEnd() {\n        if (!isSetObject(this.config.bin)) {\n          this.warn(\n            `No binaries were found for the ${\n              this.config.name\n            } application. Please ensure the binaries are correctly configured in your Shell Shock configuration or package.json.`\n          );\n        } else {\n          await Promise.all(\n            Object.values(this.config.bin).map(async bin => {\n              const path = appendPath(\n                bin,\n                joinPaths(\n                  this.workspaceConfig.workspaceRoot,\n                  this.config.projectRoot\n                )\n              );\n\n              if (this.fs.existsSync(path)) {\n                this.debug(\n                  `Adding executable permissions (chmod+x) to binary executable output file: ${path}`\n                );\n\n                await chmodX(path);\n              } else {\n                this.warn(\n                  `Unable to locate the binary executable output file: ${path}. This may indicate either a misconfiguration in the package.json file or an issue with the build process.`\n                );\n              }\n            })\n          );\n        }\n      }\n    },\n    {\n      name: \"shell-shock:docs\",\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.path.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  ] as Plugin<TContext>[];\n};\n\nexport { plugin as shellShock };\nexport default plugin;\n"],"mappings":"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"}

package/dist/plugin.d.cts

@@ -0,0 +1,13 @@
+import { Context } from "./types/context.cjs";
+import { Options } from "./types/config.cjs";
+import { Plugin } from "powerlines";
+
+//#region src/plugin.d.ts
+
+/**
+ * The core Powerlines plugin to build Shell Shock projects.
+ */
+declare const plugin: <TContext extends Context = Context>(options?: Options) => Plugin<TContext>[];
+//#endregion
+export { plugin as default, plugin, plugin as shellShock };
+//# sourceMappingURL=plugin.d.cts.map

package/dist/plugin.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AA4EA;AAAwC,cAA3B,MAA2B,EAAA,CAAA,iBAAA,OAAA,GAAU,OAAV,CAAA,CAAA,OAAA,CAAA,EAC7B,OAD6B,EAAA,GAuajC,MAvaiC,CAua1B,QAva0B,CAAA,EAAA"}

package/dist/plugin.d.mts

@@ -0,0 +1,13 @@
+import { Context } from "./types/context.mjs";
+import { Options } from "./types/config.mjs";
+import { Plugin } from "powerlines";
+
+//#region src/plugin.d.ts
+
+/**
+ * The core Powerlines plugin to build Shell Shock projects.
+ */
+declare const plugin: <TContext extends Context = Context>(options?: Options) => Plugin<TContext>[];
+//#endregion
+export { plugin as default, plugin, plugin as shellShock };
+//# sourceMappingURL=plugin.d.mts.map

package/dist/plugin.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.mts","names":[],"sources":["../src/plugin.tsx"],"sourcesContent":[],"mappings":";;;;;;;;AA4EA;AAAwC,cAA3B,MAA2B,EAAA,CAAA,iBAAA,OAAA,GAAU,OAAV,CAAA,CAAA,OAAA,CAAA,EAC7B,OAD6B,EAAA,GAuajC,MAvaiC,CAua1B,QAva0B,CAAA,EAAA"}

package/dist/plugin.mjs

@@ -0,0 +1,261 @@
+import { getAppDescription, getAppName, getAppTitle, isVariableCommandPath } from "./plugin-utils/context-helpers.mjs";
+import { CommandDocsFile } from "./components/docs.mjs";
+import { getCommandsPersistencePath, readCommandsPersistence, writeCommandsPersistence } from "./helpers/persistence.mjs";
+import { formatCommandTree, getDefaultOptions } from "./helpers/utilities.mjs";
+import { findCommandsRoot, reflectCommandTree, resolveCommandId, resolveCommandName, resolveCommandPath } from "./helpers/resolve-command.mjs";
+import { formatBinaryPath, updatePackageJsonBinary } from "./helpers/update-package-json.mjs";
+import { validateCommand } from "./helpers/validations.mjs";
+import { getCommandTree } from "./plugin-utils/get-command-tree.mjs";
+import { traverseCommands } from "./plugin-utils/traverse-command-tree.mjs";
+import { createComponent } from "@alloy-js/core/jsx-runtime";
+import { For, Show } from "@alloy-js/core/components";
+import { render } from "@powerlines/plugin-alloy/render";
+import nodejs from "@powerlines/plugin-nodejs";
+import tsdown from "@powerlines/plugin-tsdown";
+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 { isParentPath } from "@stryke/path/is-parent-path";
+import { joinPaths } from "@stryke/path/join-paths";
+import { replacePath } from "@stryke/path/replace";
+import { resolveParentPath } from "@stryke/path/resolve-parent-path";
+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 { isSetObject } from "@stryke/type-checks/is-set-object";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import { defu } from "defu";
+import { resolveEntries } from "powerlines/lib/entry";
+
+//#region src/plugin.tsx
+const MAX_DEPTH = 50;
+/**
+* The core Powerlines plugin to build Shell Shock projects.
+*/
+const plugin = (options = {}) => {
+	return [
+		tsdown(),
+		{
+			name: "shell-shock:config",
+			async config() {
+				this.debug("Resolving the Shell Shock configuration.");
+				await updatePackageJsonBinary(this);
+				const result = defu({ output: { buildPath: joinPaths(this.config.projectRoot, "dist") } }, options, {
+					name: getAppName(this),
+					title: getAppTitle(this),
+					description: getAppDescription(this),
+					envPrefix: constantCase(getAppName(this)),
+					env: { prefix: [] },
+					automd: { generators: {} },
+					isCaseSensitive: false,
+					output: {
+						format: "esm",
+						dts: true
+					},
+					entry: !this.config.entry || Array.isArray(this.config.entry) && this.config.entry.length === 0 ? [joinPaths(this.config.sourceRoot, "**/*.ts"), joinPaths(this.config.sourceRoot, "**/*.tsx")] : void 0,
+					build: {
+						dts: false,
+						platform: "node",
+						nodeProtocol: true,
+						unbundle: false
+					},
+					type: "application",
+					framework: "shell-shock"
+				});
+				if (!result.env.prefix.includes(result.envPrefix)) result.env.prefix.push(result.envPrefix);
+				return result;
+			},
+			configResolved: {
+				order: "pre",
+				async handler() {
+					this.debug("Shell Shock configuration has been resolved.");
+					this.config.bin = (isSetString(this.packageJson.bin) ? { [kebabCase(this.config.name)]: this.packageJson.bin } : this.packageJson.bin) ?? { [kebabCase(this.config.name)]: formatBinaryPath(this.config.output.format) };
+					this.inputs ??= [];
+					this.options = Object.values(getDefaultOptions(this, {
+						id: null,
+						name: this.config.name,
+						title: this.config.title,
+						description: this.config.description,
+						path: {
+							value: null,
+							segments: []
+						},
+						isVirtual: false
+					}));
+				}
+			}
+		},
+		...nodejs(),
+		{
+			name: "shell-shock:inputs",
+			async configResolved() {
+				this.debug("Finding command entry point files.");
+				this.commandsPath = findCommandsRoot(this);
+				const entries = await resolveEntries(this, toArray(this.config.entry || []));
+				this.debug(`Found ${entries.length} entry points specified in the configuration options.`);
+				this.inputs = entries.reduce((ret, entry) => {
+					if (!isParentPath(entry.file, this.commandsPath)) throw new Error(`Command entry point "${entry.file}" is not located within the commands root "${this.commandsPath}". Please ensure that all command entry points are located within the current project.`);
+					const id = resolveCommandId(this, entry.file);
+					if (!ret.some((existing) => existing.id === id)) {
+						const path = resolveCommandPath(this, entry.file);
+						const name = resolveCommandName(entry.file);
+						ret.push({
+							id,
+							path: {
+								value: path,
+								segments: path.split("/").filter(Boolean)
+							},
+							name,
+							isVirtual: false,
+							entry: {
+								...entry,
+								file: entry.file,
+								input: {
+									file: entry.file,
+									name: entry.name
+								},
+								output: name
+							}
+						});
+					}
+					return ret;
+				}, this.inputs);
+				this.debug(`Shell Shock will process ${this.inputs.length} command entry files: \n${this.inputs.map((command) => ` - ${command.id}: ${replacePath(command.entry.file, this.commandsPath)}`).join("\n")}`);
+			}
+		},
+		{
+			name: "shell-shock:virtual-inputs",
+			configResolved: {
+				order: "post",
+				async handler() {
+					if (this.inputs.length === 0) this.warn("No commands were found in the project. Please ensure at least one command exists.");
+					else {
+						this.debug(`Shell Shock will create an application with the following commands: \n${this.inputs.filter((cmd) => !cmd.isVirtual).map((command) => ` - ${command.id}: ${replacePath(command.entry.file, this.commandsPath)}${command.isVirtual ? " (virtual)" : ""}`).join("\n")}`);
+						this.debug("Finding and adding virtual command inputs for each command previously found.");
+						this.inputs = this.inputs.reduce((ret, command) => {
+							let depth = 0;
+							let parentPath = resolveParentPath(findFilePath(command.entry.file));
+							while (parentPath !== this.commandsPath) {
+								if (depth++ > MAX_DEPTH) throw new Error(`Maximum command virtual parent depth of ${MAX_DEPTH} exceeded while processing command: ${command.name}`);
+								if (!ret.some((existing) => findFilePath(existing.entry.file) === parentPath)) {
+									const file = joinPaths(parentPath, "command.ts");
+									const id = resolveCommandId(this, file);
+									if (!ret.some((existing) => existing.id === id)) {
+										const name = resolveCommandName(file);
+										const path = resolveCommandPath(this, file);
+										ret.push({
+											id,
+											path: {
+												value: path,
+												segments: path.split("/").filter(Boolean)
+											},
+											name,
+											isVirtual: true,
+											entry: { file }
+										});
+									}
+								}
+								parentPath = resolveParentPath(parentPath);
+							}
+							return ret;
+						}, this.inputs).sort((a, b) => a.path.segments.length - b.path.segments.length);
+						this.debug(`Final command input list: \n${this.inputs.map((command) => ` - ${command.id}: ${replacePath(command.entry.file, this.commandsPath)}${command.isVirtual ? " (virtual)" : ""}`).join("\n")}`);
+					}
+				}
+			}
+		},
+		{
+			name: "shell-shock:reflect-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))) {
+						this.debug(`Skipping reflection initialization as the meta checksum has not changed.`);
+						await readCommandsPersistence(this);
+					} else {
+						for (const input of this.inputs.filter((input$1) => input$1.path.segments.filter((segment) => !isVariableCommandPath(segment)).length === 1)) this.commands[input.name] = await reflectCommandTree(this, input);
+						this.debug("Post-processing commands to ensure proper reflection.");
+						this.options = this.options.map((option) => ({
+							...option,
+							name: camelCase(option.name),
+							alias: option.alias ?? [],
+							optional: option.optional ?? false
+						}));
+						await traverseCommands(this, (command) => {
+							command.options = Object.fromEntries(Object.entries(command.options).map(([name, option]) => [camelCase(name), {
+								...option,
+								name: camelCase(name),
+								alias: option.alias ?? [],
+								optional: option.optional ?? false
+							}]));
+						});
+						await writeCommandsPersistence(this);
+					}
+					this.debug("Validating the CLI applications command tree.");
+					let isValid = true;
+					await traverseCommands(this, (command) => {
+						const failures = validateCommand(command);
+						if (failures.length > 0) {
+							this.error(`Found ${failures.length} issue${failures.length > 1 ? "s" : ""} with the ${command.title} command: \n${failures.map((failure) => ` - ${failure.code}: ${failure.details}`).join("\n")}\n`);
+							isValid = false;
+						}
+					});
+					if (!isValid) throw new Error(`One or more commands in the command tree are invalid. Please review the errors above and correct them before proceeding.`);
+					this.info(`\nCreating an application with the following command tree: \n${formatCommandTree(this)}\n`);
+				}
+			}
+		},
+		{
+			name: "shell-shock:chmod+x",
+			configResolved() {
+				this.config.build.outputOptions ??= {};
+				this.config.build.outputOptions.banner = (chunk) => {
+					if (chunk.isEntry && joinPaths(this.entryPath, "bin.ts") === chunk.facadeModuleId) {
+						this.debug(`Adding hashbang to binary executable output file: ${chunk.fileName}`);
+						return `#!/usr/bin/env ${this.config.mode === "development" ? "-S NODE_OPTIONS=--enable-source-maps" : ""} node\n`;
+					}
+					return "";
+				};
+			},
+			async buildEnd() {
+				if (!isSetObject(this.config.bin)) this.warn(`No binaries were found for the ${this.config.name} application. Please ensure the binaries are correctly configured in your Shell Shock configuration or package.json.`);
+				else await Promise.all(Object.values(this.config.bin).map(async (bin) => {
+					const path = appendPath(bin, joinPaths(this.workspaceConfig.workspaceRoot, this.config.projectRoot));
+					if (this.fs.existsSync(path)) {
+						this.debug(`Adding executable permissions (chmod+x) to binary executable output file: ${path}`);
+						await chmodX(path);
+					} else this.warn(`Unable to locate the binary executable output file: ${path}. This may indicate either a misconfiguration in the package.json file or an issue with the build process.`);
+				}));
+			}
+		},
+		{
+			name: "shell-shock:docs",
+			async docs() {
+				this.debug("Rendering entrypoint modules for the Shell Shock `script` preset.");
+				const commands = this.inputs.map((input) => getCommandTree(this, input.path.segments)).filter(Boolean);
+				return render(this, createComponent(For, {
+					get each() {
+						return Object.values(commands);
+					},
+					doubleHardline: true,
+					children: (child) => createComponent(Show, {
+						get when() {
+							return !child.isVirtual;
+						},
+						get children() {
+							return createComponent(CommandDocsFile, { command: child });
+						}
+					})
+				}));
+			}
+		}
+	];
+};
+var plugin_default = plugin;
+
+//#endregion
+export { plugin_default as default, plugin, plugin as shellShock };
+//# sourceMappingURL=plugin.mjs.map