@shell-shock/core 0.2.0 → 0.2.1

package/dist/powerlines.cjs

@@ -1,3 +1,172 @@
-Object.defineProperty(exports,`__esModule`,{value:!0});const e=require(`./_virtual/rolldown_runtime.cjs`),t=require(`./helpers/get-default-options.cjs`),n=require(`./helpers/persistence.cjs`),r=require(`./helpers/resolve-command.cjs`),i=require(`./helpers/update-package-json.cjs`),a=require(`./helpers/utilities.cjs`);let o=require(`@stryke/fs/chmod-x`),s=require(`@stryke/path/append`),c=require(`@stryke/path/file-path-fns`),l=require(`@stryke/path/is-parent-path`),u=require(`@stryke/path/join-paths`),d=require(`@stryke/path/replace`),f=require(`@stryke/path/resolve-parent-path`),p=require(`@stryke/string-format/title-case`),m=require(`@stryke/type-checks/is-set-object`),h=require(`defu`),g=require(`node:fs`);const _=50,v=(e={})=>[{name:`shell-shock:config`,async config(){return this.trace(`Resolving the Shell Shock configuration.`),(0,h.defu)(e,{entry:!this.config.entry||Array.isArray(this.config.entry)&&this.config.entry.length===0?[(0,u.joinPaths)(this.config.sourceRoot,`**/*`)]:void 0,build:{target:`node22`,platform:`node`},interactive:!0,type:`application`,framework:`shell-shock`})},configResolved:{order:`pre`,async handler(){this.trace(`Shell Shock configuration has been resolved.`),await i.updatePackageJsonBinary(this),this.config.name=a.getAppName(this),this.config.title=a.getAppTitle(this),this.config.description=a.getAppDescription(this),this.options=t.getDefaultOptions(this,{id:null,name:this.config.name,title:this.config.title,description:this.config.description,path:[],isVirtual:!1}),this.inputs??=[]}}},{name:`shell-shock:inputs`,async configResolved(){this.trace(`Finding command entry points.`),this.commandsPath=r.findCommandsRoot(this),this.inputs=this.entry.filter(e=>(0,c.findFileName)(e.file,{withExtension:!1})===`command`).reduce((e,t)=>{let n=(0,s.appendPath)((0,s.appendPath)(t.file,this.config.projectRoot),this.workspaceConfig.workspaceRoot);if(!(0,l.isParentPath)(n,this.commandsPath))throw Error(`Command entry point "${n}" is not located within the commands root "${this.commandsPath}". Please ensure that all command entry points are located within the current project.`);let i=r.resolveCommandPath(this,n),a=i.replaceAll(`/`,`-`);if(!e.some(e=>e.id===a)){let o=r.findCommandName(n);e.push({id:a,path:i.split(`/`).filter(Boolean),name:o,title:(0,p.titleCase)(o),isVirtual:!1,entry:{...t,file:n,input:{file:t.file,name:t.name},output:o}})}return e},this.inputs)}},{name:`shell-shock:virtual-inputs`,configResolved:{order:`post`,async handler(){this.inputs.length===0?this.warn(`No commands were found in the project. Please ensure at least one command exists.`):(this.info(`Shell Shock will create an application with the following commands: \n${this.inputs.filter(e=>!e.isVirtual).map(e=>` - ${e.id}: ${(0,d.replacePath)(e.entry.file,this.commandsPath)}${e.isVirtual?` (virtual)`:``}`).join(`
-`)}`),this.trace(`Finding and adding virtual command inputs for each command previously found.`),this.inputs=this.inputs.reduce((e,t)=>{let n=0,i=(0,f.resolveParentPath)((0,c.findFilePath)(t.entry.file));for(;i!==this.commandsPath;){if(n++>50)throw Error(`Maximum command virtual parent depth of 50 exceeded while processing command: ${t.name}`);if(!e.some(e=>(0,c.findFilePath)(e.entry.file)===i)){let t=(0,u.joinPaths)(i,`command.ts`),n=r.resolveCommandPath(this,t),a=n.replaceAll(`/`,`-`);if(!e.some(e=>e.id===a)){let i=r.findCommandName(t);e.push({id:a,path:n.split(`/`).filter(Boolean),name:i,title:(0,p.titleCase)(i),isVirtual:!0,entry:{file:t,input:{file:t}}})}}i=(0,f.resolveParentPath)(i)}return e},this.inputs).sort((e,t)=>e.path.length-t.path.length),this.trace(`Final command input list: \n${this.inputs.map(e=>` - ${e.id}: ${(0,d.replacePath)(e.entry.file,this.commandsPath)}${e.isVirtual?` (virtual)`:``}`).join(`
-`)}`))}}},{name:`shell-shock:reflect-commands`,async prepare(){if(this.entry=[],this.commands={},this.config.command!==`prepare`&&this.persistedMeta?.checksum===this.meta.checksum&&this.fs.existsSync(n.getCommandsPersistencePath(this)))this.debug(`Skipping reflection initialization as the meta checksum has not changed.`),await n.readCommandsPersistence(this);else{for(let e of this.inputs.filter(e=>e.path.length===1))this.commands[e.name]=await r.reflectCommandTree(this,e);await n.writeCommandsPersistence(this)}}},{name:`shell-shock:chmod+x`,async buildEnd(){if(!(0,m.isSetObject)(this.packageJson.bin)){this.warn(`No binaries were found in package.json. Please ensure the binaries are correctly configured.`);return}this.debug(`Adding executable permissions to binaries.`);for(let e of Object.values(this.packageJson.bin))(0,g.existsSync)((0,s.appendPath)(e,this.config.output.buildPath))&&await(0,o.chmodX)((0,s.appendPath)(e,this.config.output.buildPath))}}];var y=v;exports.default=y,exports.shellShock=v;
+Object.defineProperty(exports, '__esModule', { value: true });
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_persistence = require('./helpers/persistence.cjs');
+const require_resolve_command = require('./helpers/resolve-command.cjs');
+const require_update_package_json = require('./helpers/update-package-json.cjs');
+const require_utilities = require('./helpers/utilities.cjs');
+let __powerlines_plugin_tsdown = require("@powerlines/plugin-tsdown");
+__powerlines_plugin_tsdown = require_rolldown_runtime.__toESM(__powerlines_plugin_tsdown);
+let __stryke_fs_chmod_x = require("@stryke/fs/chmod-x");
+let __stryke_helpers_get_unique = require("@stryke/helpers/get-unique");
+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_title_case = require("@stryke/string-format/title-case");
+let __stryke_type_checks_is_function = require("@stryke/type-checks/is-function");
+let __stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
+let defu = require("defu");
+
+//#region src/powerlines.ts
+const MAX_DEPTH = 50;
+/**
+* The core Powerlines plugin to build Shell Shock projects.
+*/
+const shellShock = (options = {}) => {
+	return [
+		(0, __powerlines_plugin_tsdown.default)(),
+		{
+			name: "shell-shock:config",
+			async config() {
+				this.trace("Resolving the Shell Shock configuration.");
+				return (0, defu.defu)(options, {
+					entry: !this.config.entry || Array.isArray(this.config.entry) && this.config.entry.length === 0 ? [(0, __stryke_path_join_paths.joinPaths)(this.config.sourceRoot, "**/*")] : void 0,
+					build: {
+						target: "node22",
+						platform: "node"
+					},
+					type: "application",
+					framework: "shell-shock"
+				});
+			},
+			configResolved: {
+				order: "pre",
+				async handler() {
+					this.trace("Shell Shock configuration has been resolved.");
+					await require_update_package_json.updatePackageJsonBinary(this);
+					this.config.name = require_utilities.getAppName(this);
+					this.config.title = require_utilities.getAppTitle(this);
+					this.config.description = require_utilities.getAppDescription(this);
+					if (this.config.defaultOptions === false) this.options = [];
+					else if (Array.isArray(this.config.defaultOptions)) this.options = (0, __stryke_helpers_get_unique.getUniqueBy)(this.config.defaultOptions, (item) => item.name);
+					else if ((0, __stryke_type_checks_is_function.isFunction)(this.config.defaultOptions)) this.options = (0, __stryke_helpers_get_unique.getUniqueBy)(this.config.defaultOptions(this, {
+						id: null,
+						name: this.config.name,
+						title: this.config.title,
+						description: this.config.description,
+						path: [],
+						isVirtual: false
+					}), (item) => item.name);
+					this.inputs ??= [];
+				}
+			}
+		},
+		{
+			name: "shell-shock:inputs",
+			async configResolved() {
+				this.trace("Finding command entry points.");
+				this.commandsPath = require_resolve_command.findCommandsRoot(this);
+				this.inputs = this.entry.filter((entry) => (0, __stryke_path_file_path_fns.findFileName)(entry.file, { withExtension: false }) === "command").reduce((ret, entry) => {
+					const file = (0, __stryke_path_append.appendPath)((0, __stryke_path_append.appendPath)(entry.file, this.config.projectRoot), this.workspaceConfig.workspaceRoot);
+					if (!(0, __stryke_path_is_parent_path.isParentPath)(file, this.commandsPath)) throw new Error(`Command entry point "${file}" is not located within the commands root "${this.commandsPath}". Please ensure that all command entry points are located within the current project.`);
+					const path = require_resolve_command.resolveCommandPath(this, file);
+					const id = path.replaceAll("/", "-");
+					if (!ret.some((existing) => existing.id === id)) {
+						const name = require_resolve_command.findCommandName(file);
+						ret.push({
+							id,
+							path: path.split("/").filter(Boolean),
+							name,
+							title: (0, __stryke_string_format_title_case.titleCase)(name),
+							isVirtual: false,
+							entry: {
+								...entry,
+								file,
+								input: {
+									file: entry.file,
+									name: entry.name
+								},
+								output: name
+							}
+						});
+					}
+					return ret;
+				}, this.inputs);
+			}
+		},
+		{
+			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.info(`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.trace("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 path = require_resolve_command.resolveCommandPath(this, file);
+									const id = path.replaceAll("/", "-");
+									if (!ret.some((existing) => existing.id === id)) {
+										const name = require_resolve_command.findCommandName(file);
+										ret.push({
+											id,
+											path: path.split("/").filter(Boolean),
+											name,
+											title: (0, __stryke_string_format_title_case.titleCase)(name),
+											isVirtual: true,
+											entry: {
+												file,
+												input: { file }
+											}
+										});
+									}
+								}
+								parentPath = (0, __stryke_path_resolve_parent_path.resolveParentPath)(parentPath);
+							}
+							return ret;
+						}, this.inputs).sort((a, b) => a.path.length - b.path.length);
+						this.trace(`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",
+			async prepare() {
+				this.entry = [];
+				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.length === 1)) this.commands[input.name] = await require_resolve_command.reflectCommandTree(this, input);
+					await require_persistence.writeCommandsPersistence(this);
+				}
+			}
+		},
+		{
+			name: "shell-shock:chmod+x",
+			async buildEnd() {
+				if (!(0, __stryke_type_checks_is_set_object.isSetObject)(this.packageJson.bin)) {
+					this.warn("No binaries were found in package.json. Please ensure the binaries are correctly configured.");
+					return;
+				}
+				this.debug("Adding executable permissions to binaries.");
+				for (const executablePath of Object.values(this.packageJson.bin)) if (this.fs.existsSync((0, __stryke_path_append.appendPath)(executablePath, this.config.output.buildPath))) await (0, __stryke_fs_chmod_x.chmodX)((0, __stryke_path_append.appendPath)(executablePath, this.config.output.buildPath));
+			}
+		}
+	];
+};
+var powerlines_default = shellShock;
+
+//#endregion
+exports.default = powerlines_default;
+exports.shellShock = shellShock;

package/dist/powerlines.mjs

@@ -1,3 +1,168 @@
-import{getDefaultOptions as e}from"./helpers/get-default-options.mjs";import{getCommandsPersistencePath as t,readCommandsPersistence as n,writeCommandsPersistence as r}from"./helpers/persistence.mjs";import{findCommandName as i,findCommandsRoot as a,reflectCommandTree as o,resolveCommandPath as s}from"./helpers/resolve-command.mjs";import{updatePackageJsonBinary as c}from"./helpers/update-package-json.mjs";import{getAppDescription as l,getAppName as u,getAppTitle as d}from"./helpers/utilities.mjs";import{chmodX as f}from"@stryke/fs/chmod-x";import{appendPath as p}from"@stryke/path/append";import{findFileName as m,findFilePath as h}from"@stryke/path/file-path-fns";import{isParentPath as g}from"@stryke/path/is-parent-path";import{joinPaths as _}from"@stryke/path/join-paths";import{replacePath as v}from"@stryke/path/replace";import{resolveParentPath as y}from"@stryke/path/resolve-parent-path";import{titleCase as b}from"@stryke/string-format/title-case";import{isSetObject as x}from"@stryke/type-checks/is-set-object";import{defu as S}from"defu";import{existsSync as C}from"node:fs";const w=(w={})=>[{name:`shell-shock:config`,async config(){return this.trace(`Resolving the Shell Shock configuration.`),S(w,{entry:!this.config.entry||Array.isArray(this.config.entry)&&this.config.entry.length===0?[_(this.config.sourceRoot,`**/*`)]:void 0,build:{target:`node22`,platform:`node`},interactive:!0,type:`application`,framework:`shell-shock`})},configResolved:{order:`pre`,async handler(){this.trace(`Shell Shock configuration has been resolved.`),await c(this),this.config.name=u(this),this.config.title=d(this),this.config.description=l(this),this.options=e(this,{id:null,name:this.config.name,title:this.config.title,description:this.config.description,path:[],isVirtual:!1}),this.inputs??=[]}}},{name:`shell-shock:inputs`,async configResolved(){this.trace(`Finding command entry points.`),this.commandsPath=a(this),this.inputs=this.entry.filter(e=>m(e.file,{withExtension:!1})===`command`).reduce((e,t)=>{let n=p(p(t.file,this.config.projectRoot),this.workspaceConfig.workspaceRoot);if(!g(n,this.commandsPath))throw Error(`Command entry point "${n}" is not located within the commands root "${this.commandsPath}". Please ensure that all command entry points are located within the current project.`);let r=s(this,n),a=r.replaceAll(`/`,`-`);if(!e.some(e=>e.id===a)){let o=i(n);e.push({id:a,path:r.split(`/`).filter(Boolean),name:o,title:b(o),isVirtual:!1,entry:{...t,file:n,input:{file:t.file,name:t.name},output:o}})}return e},this.inputs)}},{name:`shell-shock:virtual-inputs`,configResolved:{order:`post`,async handler(){this.inputs.length===0?this.warn(`No commands were found in the project. Please ensure at least one command exists.`):(this.info(`Shell Shock will create an application with the following commands: \n${this.inputs.filter(e=>!e.isVirtual).map(e=>` - ${e.id}: ${v(e.entry.file,this.commandsPath)}${e.isVirtual?` (virtual)`:``}`).join(`
-`)}`),this.trace(`Finding and adding virtual command inputs for each command previously found.`),this.inputs=this.inputs.reduce((e,t)=>{let n=0,r=y(h(t.entry.file));for(;r!==this.commandsPath;){if(n++>50)throw Error(`Maximum command virtual parent depth of 50 exceeded while processing command: ${t.name}`);if(!e.some(e=>h(e.entry.file)===r)){let t=_(r,`command.ts`),n=s(this,t),a=n.replaceAll(`/`,`-`);if(!e.some(e=>e.id===a)){let r=i(t);e.push({id:a,path:n.split(`/`).filter(Boolean),name:r,title:b(r),isVirtual:!0,entry:{file:t,input:{file:t}}})}}r=y(r)}return e},this.inputs).sort((e,t)=>e.path.length-t.path.length),this.trace(`Final command input list: \n${this.inputs.map(e=>` - ${e.id}: ${v(e.entry.file,this.commandsPath)}${e.isVirtual?` (virtual)`:``}`).join(`
-`)}`))}}},{name:`shell-shock:reflect-commands`,async prepare(){if(this.entry=[],this.commands={},this.config.command!==`prepare`&&this.persistedMeta?.checksum===this.meta.checksum&&this.fs.existsSync(t(this)))this.debug(`Skipping reflection initialization as the meta checksum has not changed.`),await n(this);else{for(let e of this.inputs.filter(e=>e.path.length===1))this.commands[e.name]=await o(this,e);await r(this)}}},{name:`shell-shock:chmod+x`,async buildEnd(){if(!x(this.packageJson.bin)){this.warn(`No binaries were found in package.json. Please ensure the binaries are correctly configured.`);return}this.debug(`Adding executable permissions to binaries.`);for(let e of Object.values(this.packageJson.bin))C(p(e,this.config.output.buildPath))&&await f(p(e,this.config.output.buildPath))}}];var T=w;export{T as default,w as shellShock};
+import { getCommandsPersistencePath, readCommandsPersistence, writeCommandsPersistence } from "./helpers/persistence.mjs";
+import { findCommandName, findCommandsRoot, reflectCommandTree, resolveCommandPath } from "./helpers/resolve-command.mjs";
+import { updatePackageJsonBinary } from "./helpers/update-package-json.mjs";
+import { getAppDescription, getAppName, getAppTitle } from "./helpers/utilities.mjs";
+import tsdown from "@powerlines/plugin-tsdown";
+import { chmodX } from "@stryke/fs/chmod-x";
+import { getUniqueBy } from "@stryke/helpers/get-unique";
+import { appendPath } from "@stryke/path/append";
+import { findFileName, 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 { titleCase } from "@stryke/string-format/title-case";
+import { isFunction } from "@stryke/type-checks/is-function";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { defu } from "defu";
+
+//#region src/powerlines.ts
+const MAX_DEPTH = 50;
+/**
+* The core Powerlines plugin to build Shell Shock projects.
+*/
+const shellShock = (options = {}) => {
+	return [
+		tsdown(),
+		{
+			name: "shell-shock:config",
+			async config() {
+				this.trace("Resolving the Shell Shock configuration.");
+				return defu(options, {
+					entry: !this.config.entry || Array.isArray(this.config.entry) && this.config.entry.length === 0 ? [joinPaths(this.config.sourceRoot, "**/*")] : void 0,
+					build: {
+						target: "node22",
+						platform: "node"
+					},
+					type: "application",
+					framework: "shell-shock"
+				});
+			},
+			configResolved: {
+				order: "pre",
+				async handler() {
+					this.trace("Shell Shock configuration has been resolved.");
+					await updatePackageJsonBinary(this);
+					this.config.name = getAppName(this);
+					this.config.title = getAppTitle(this);
+					this.config.description = getAppDescription(this);
+					if (this.config.defaultOptions === false) this.options = [];
+					else if (Array.isArray(this.config.defaultOptions)) this.options = getUniqueBy(this.config.defaultOptions, (item) => item.name);
+					else if (isFunction(this.config.defaultOptions)) this.options = getUniqueBy(this.config.defaultOptions(this, {
+						id: null,
+						name: this.config.name,
+						title: this.config.title,
+						description: this.config.description,
+						path: [],
+						isVirtual: false
+					}), (item) => item.name);
+					this.inputs ??= [];
+				}
+			}
+		},
+		{
+			name: "shell-shock:inputs",
+			async configResolved() {
+				this.trace("Finding command entry points.");
+				this.commandsPath = findCommandsRoot(this);
+				this.inputs = this.entry.filter((entry) => findFileName(entry.file, { withExtension: false }) === "command").reduce((ret, entry) => {
+					const file = appendPath(appendPath(entry.file, this.config.projectRoot), this.workspaceConfig.workspaceRoot);
+					if (!isParentPath(file, this.commandsPath)) throw new Error(`Command entry point "${file}" is not located within the commands root "${this.commandsPath}". Please ensure that all command entry points are located within the current project.`);
+					const path = resolveCommandPath(this, file);
+					const id = path.replaceAll("/", "-");
+					if (!ret.some((existing) => existing.id === id)) {
+						const name = findCommandName(file);
+						ret.push({
+							id,
+							path: path.split("/").filter(Boolean),
+							name,
+							title: titleCase(name),
+							isVirtual: false,
+							entry: {
+								...entry,
+								file,
+								input: {
+									file: entry.file,
+									name: entry.name
+								},
+								output: name
+							}
+						});
+					}
+					return ret;
+				}, this.inputs);
+			}
+		},
+		{
+			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.info(`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.trace("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 path = resolveCommandPath(this, file);
+									const id = path.replaceAll("/", "-");
+									if (!ret.some((existing) => existing.id === id)) {
+										const name = findCommandName(file);
+										ret.push({
+											id,
+											path: path.split("/").filter(Boolean),
+											name,
+											title: titleCase(name),
+											isVirtual: true,
+											entry: {
+												file,
+												input: { file }
+											}
+										});
+									}
+								}
+								parentPath = resolveParentPath(parentPath);
+							}
+							return ret;
+						}, this.inputs).sort((a, b) => a.path.length - b.path.length);
+						this.trace(`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",
+			async prepare() {
+				this.entry = [];
+				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.length === 1)) this.commands[input.name] = await reflectCommandTree(this, input);
+					await writeCommandsPersistence(this);
+				}
+			}
+		},
+		{
+			name: "shell-shock:chmod+x",
+			async buildEnd() {
+				if (!isSetObject(this.packageJson.bin)) {
+					this.warn("No binaries were found in package.json. Please ensure the binaries are correctly configured.");
+					return;
+				}
+				this.debug("Adding executable permissions to binaries.");
+				for (const executablePath of Object.values(this.packageJson.bin)) if (this.fs.existsSync(appendPath(executablePath, this.config.output.buildPath))) await chmodX(appendPath(executablePath, this.config.output.buildPath));
+			}
+		}
+	];
+};
+var powerlines_default = shellShock;
+
+//#endregion
+export { powerlines_default as default, shellShock };

package/dist/types/command.mjs

@@ -1 +1 @@
-export{};
+export {  };

package/dist/types/config.d.cts

@@ -1,29 +1,14 @@
 import { CommandBase, CommandOption } from "./command.cjs";
 import { Context } from "./context.cjs";
+import { NodeJsPluginOptions, NodeJsPluginResolvedConfig, NodeJsPluginUserConfig } from "@powerlines/plugin-nodejs/types/plugin";
 import { TsdownPluginResolvedConfig, TsdownPluginUserConfig } from "@powerlines/plugin-tsdown";
 
 //#region src/types/config.d.ts
-interface Options {
-  /**
-   * The default interactive mode to apply to commands.
-   *
-   * @remarks
-   * The following modes are available:
-   * - `true`: Enable interactivity when a TTY is detected and no explicit interactive flag is set (default).
-   * - `false`: Disable interactivity unless an explicit interactive flag is set.
-   * - `"never"`: Always disable interactivity, regardless of TTY presence or flags.
-   *
-   * @defaultValue `true`
-   */
-  interactive?: boolean | "never";
+interface Options extends NodeJsPluginOptions {
   /**
    * A set of default command options to apply to each command.
    *
    * @remarks
-   * By default, Shell Shock adds the following set of default arguments to each command:
-   * - `--help` (`-h`, `-?`): Show help information.
-   * - `--version` (`-v`): Show the version of the application.
-   *
    * To disable the addition of these default options, set this property to `false`, or provide a custom set of options/a function that returns them.
    */
   defaultOptions?: CommandOption[] | ((context: Context, input: CommandBase) => CommandOption[]) | false;
@@ -32,8 +17,8 @@ interface Options {
    */
   bin?: string | string[];
 }
-type UserConfig = Partial<Omit<TsdownPluginUserConfig, "type" | "framework" | "singleBuild" | "environments">> & Options;
-type ResolvedConfig = TsdownPluginResolvedConfig & Required<Omit<Options, "bin"> & {
+type UserConfig = Partial<Omit<TsdownPluginUserConfig, "type" | "framework" | "singleBuild" | "environments">> & Partial<NodeJsPluginUserConfig> & Omit<Options, "env">;
+type ResolvedConfig = TsdownPluginResolvedConfig & NodeJsPluginResolvedConfig & Required<Omit<Options, "bin" | "env"> & {
   bin: string[];
 }>;
 //#endregion

package/dist/types/config.d.mts

@@ -1,29 +1,14 @@
 import { CommandBase, CommandOption } from "./command.mjs";
 import { Context } from "./context.mjs";
 import { TsdownPluginResolvedConfig, TsdownPluginUserConfig } from "@powerlines/plugin-tsdown";
+import { NodeJsPluginOptions, NodeJsPluginResolvedConfig, NodeJsPluginUserConfig } from "@powerlines/plugin-nodejs/types/plugin";
 
 //#region src/types/config.d.ts
-interface Options {
-  /**
-   * The default interactive mode to apply to commands.
-   *
-   * @remarks
-   * The following modes are available:
-   * - `true`: Enable interactivity when a TTY is detected and no explicit interactive flag is set (default).
-   * - `false`: Disable interactivity unless an explicit interactive flag is set.
-   * - `"never"`: Always disable interactivity, regardless of TTY presence or flags.
-   *
-   * @defaultValue `true`
-   */
-  interactive?: boolean | "never";
+interface Options extends NodeJsPluginOptions {
   /**
    * A set of default command options to apply to each command.
    *
    * @remarks
-   * By default, Shell Shock adds the following set of default arguments to each command:
-   * - `--help` (`-h`, `-?`): Show help information.
-   * - `--version` (`-v`): Show the version of the application.
-   *
    * To disable the addition of these default options, set this property to `false`, or provide a custom set of options/a function that returns them.
    */
   defaultOptions?: CommandOption[] | ((context: Context, input: CommandBase) => CommandOption[]) | false;
@@ -32,8 +17,8 @@ interface Options {
    */
   bin?: string | string[];
 }
-type UserConfig = Partial<Omit<TsdownPluginUserConfig, "type" | "framework" | "singleBuild" | "environments">> & Options;
-type ResolvedConfig = TsdownPluginResolvedConfig & Required<Omit<Options, "bin"> & {
+type UserConfig = Partial<Omit<TsdownPluginUserConfig, "type" | "framework" | "singleBuild" | "environments">> & Partial<NodeJsPluginUserConfig> & Omit<Options, "env">;
+type ResolvedConfig = TsdownPluginResolvedConfig & NodeJsPluginResolvedConfig & Required<Omit<Options, "bin" | "env"> & {
   bin: string[];
 }>;
 //#endregion

package/dist/types/config.mjs

@@ -1 +1 @@
-export{};
+export {  };

package/dist/types/context.d.cts

@@ -1,9 +1,10 @@
 import { CommandInput, CommandOption, CommandTree } from "./command.cjs";
 import { ResolvedConfig } from "./config.cjs";
 import { TsdownPluginContext } from "@powerlines/plugin-tsdown";
+import { EnvPluginContext } from "@powerlines/plugin-env/types/plugin";
 
 //#region src/types/context.d.ts
-type Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = TsdownPluginContext<TResolvedConfig> & {
+type Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = TsdownPluginContext<TResolvedConfig> & EnvPluginContext<TResolvedConfig> & {
   /**
    * The root path where commands are located.
    */

package/dist/types/context.d.mts

@@ -1,9 +1,10 @@
 import { CommandInput, CommandOption, CommandTree } from "./command.mjs";
 import { ResolvedConfig } from "./config.mjs";
 import { TsdownPluginContext } from "@powerlines/plugin-tsdown";
+import { EnvPluginContext } from "@powerlines/plugin-env/types/plugin";
 
 //#region src/types/context.d.ts
-type Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = TsdownPluginContext<TResolvedConfig> & {
+type Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = TsdownPluginContext<TResolvedConfig> & EnvPluginContext<TResolvedConfig> & {
   /**
    * The root path where commands are located.
    */

package/dist/types/context.mjs

@@ -1 +1 @@
-export{};
+export {  };

package/dist/types/index.mjs

@@ -1 +1 @@
-export{};
+export {  };

package/dist/types/options.mjs

@@ -1 +1 @@
-export{};
+export {  };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shell-shock/core",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "type": "module",
   "description": "A package containing the core Shell Shock functionality used to build and manage a command-line application.",
   "repository": {
@@ -131,26 +131,86 @@
         "types": "./dist/types/*.d.mts",
         "default": "./dist/types/*.mjs"
       }
+    },
+    "./plugin-utils": {
+      "import": {
+        "types": "./dist/plugin-utils/index.d.mts",
+        "default": "./dist/plugin-utils/index.mjs"
+      },
+      "require": {
+        "types": "./dist/plugin-utils/index.d.cts",
+        "default": "./dist/plugin-utils/index.cjs"
+      },
+      "default": {
+        "types": "./dist/plugin-utils/index.d.mts",
+        "default": "./dist/plugin-utils/index.mjs"
+      }
+    },
+    "./plugin-utils/*": {
+      "import": {
+        "types": "./dist/plugin-utils/*.d.mts",
+        "default": "./dist/plugin-utils/*.mjs"
+      },
+      "require": {
+        "types": "./dist/plugin-utils/*.d.cts",
+        "default": "./dist/plugin-utils/*.cjs"
+      },
+      "default": {
+        "types": "./dist/plugin-utils/*.d.mts",
+        "default": "./dist/plugin-utils/*.mjs"
+      }
+    },
+    "./components": {
+      "import": {
+        "types": "./dist/components/index.d.mts",
+        "default": "./dist/components/index.mjs"
+      },
+      "require": {
+        "types": "./dist/components/index.d.cts",
+        "default": "./dist/components/index.cjs"
+      },
+      "default": {
+        "types": "./dist/components/index.d.mts",
+        "default": "./dist/components/index.mjs"
+      }
+    },
+    "./components/*": {
+      "import": {
+        "types": "./dist/components/*.d.mts",
+        "default": "./dist/components/*.mjs"
+      },
+      "require": {
+        "types": "./dist/components/*.d.cts",
+        "default": "./dist/components/*.cjs"
+      },
+      "default": {
+        "types": "./dist/components/*.d.mts",
+        "default": "./dist/components/*.mjs"
+      }
     }
   },
   "files": ["dist/**/*"],
   "keywords": ["shell-shock", "powerlines", "storm-software"],
   "dependencies": {
-    "@powerlines/deepkit": "^0.5.10",
-    "@powerlines/plugin-plugin": "^0.12.47",
-    "@powerlines/plugin-tsdown": "^0.1.47",
-    "@stryke/convert": "^0.6.29",
-    "@stryke/helpers": "^0.9.31",
-    "@stryke/json": "^0.9.32",
-    "@stryke/path": "^0.24.0",
-    "@stryke/string-format": "^0.12.29",
-    "@stryke/type-checks": "^0.5.14",
+    "@alloy-js/core": "^0.22.0",
+    "@alloy-js/typescript": "^0.22.0",
+    "@powerlines/deepkit": "^0.5.56",
+    "@powerlines/plugin-alloy": "^0.18.24",
+    "@powerlines/plugin-plugin": "^0.12.92",
+    "@powerlines/plugin-tsdown": "^0.1.93",
+    "@stryke/convert": "^0.6.30",
+    "@stryke/fs": "^0.33.27",
+    "@stryke/helpers": "^0.9.32",
+    "@stryke/json": "^0.9.33",
+    "@stryke/path": "^0.24.1",
+    "@stryke/string-format": "^0.12.30",
+    "@stryke/type-checks": "^0.5.15",
     "defu": "^6.1.4",
-    "powerlines": "^0.36.0",
-    "@stryke/capnp": "^0.12.51",
-    "@stryke/fs": "^0.33.26"
+    "powerlines": "^0.37.14",
+    "@powerlines/plugin-env": "^0.15.27",
+    "@powerlines/plugin-nodejs": "^0.1.22"
   },
-  "devDependencies": { "@types/node": "^24.10.4", "typescript": "^5.9.3" },
+  "devDependencies": { "@types/node": "^22.19.3", "typescript": "^5.9.3" },
   "publishConfig": { "access": "public" },
-  "gitHead": "e7794a7d008c5d32b5a999b62421281d370166cd"
+  "gitHead": "5a8ce9d8f2cefeec8df5147bf80b5c3af71c6c16"
 }

package/dist/helpers/get-default-options.cjs

@@ -1 +0,0 @@
-const e=require(`../_virtual/rolldown_runtime.cjs`);let t=require(`@powerlines/deepkit/vendor/type`),n=require(`@stryke/type-checks/is-function`);function r(e,r){return e.config.defaultOptions===!1?[]:Array.isArray(e.config.defaultOptions)?e.config.defaultOptions:(0,n.isFunction)(e.config.defaultOptions)?e.config.defaultOptions(e,r):[{name:`help`,title:`Help`,description:`Show help information.`,alias:[`h`,`?`],kind:t.ReflectionKind.boolean,optional:!0,default:!1,skipAddingNegative:!0},{name:`version`,title:`Version`,description:`Show the version of the application.`,alias:[`v`],kind:t.ReflectionKind.boolean,optional:!0,default:!1,skipAddingNegative:!0}]}exports.getDefaultOptions=r;

package/dist/helpers/get-default-options.d.cts

@@ -1,15 +0,0 @@
-import { CommandBase, CommandOption } from "../types/command.cjs";
-import { Context } from "../types/context.cjs";
-
-//#region src/helpers/get-default-options.d.ts
-
-/**
- * Get the default command options.
- *
- * @param context - The build context.
- * @param command - The command input.
- * @returns The default command options.
- */
-declare function getDefaultOptions(context: Context, command: CommandBase): CommandOption[];
-//#endregion
-export { getDefaultOptions };

package/dist/helpers/get-default-options.d.mts

@@ -1,15 +0,0 @@
-import { CommandBase, CommandOption } from "../types/command.mjs";
-import { Context } from "../types/context.mjs";
-
-//#region src/helpers/get-default-options.d.ts
-
-/**
- * Get the default command options.
- *
- * @param context - The build context.
- * @param command - The command input.
- * @returns The default command options.
- */
-declare function getDefaultOptions(context: Context, command: CommandBase): CommandOption[];
-//#endregion
-export { getDefaultOptions };

package/dist/helpers/get-default-options.mjs

@@ -1 +0,0 @@
-import{ReflectionKind as e}from"@powerlines/deepkit/vendor/type";import{isFunction as t}from"@stryke/type-checks/is-function";function n(n,r){return n.config.defaultOptions===!1?[]:Array.isArray(n.config.defaultOptions)?n.config.defaultOptions:t(n.config.defaultOptions)?n.config.defaultOptions(n,r):[{name:`help`,title:`Help`,description:`Show help information.`,alias:[`h`,`?`],kind:e.boolean,optional:!0,default:!1,skipAddingNegative:!0},{name:`version`,title:`Version`,description:`Show the version of the application.`,alias:[`v`],kind:e.boolean,optional:!0,default:!1,skipAddingNegative:!0}]}export{n as getDefaultOptions};