@shell-shock/core 0.17.10 → 0.17.12

package/dist/plugin-utils/type-checks.mjs

@@ -1,26 +1,142 @@
-import { CommandParameterKinds } from "../types/command.mjs";
-import { isSetString } from "@stryke/type-checks/is-set-string";
 import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { isSetString } from "@stryke/type-checks/is-set-string";
 import { isBoolean } from "@stryke/type-checks/is-boolean";
 
 //#region src/plugin-utils/type-checks.ts
+const __ΩRecord = [
+	"K",
+	"T",
+	"Record",
+	"l'e#\"Rb!b\"Pde\"!N#!w#y"
+];
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+function isStringArray(value) {
+	return Array.isArray(value) && value.every(__assignType((item) => isSetString(item), [
+		"item",
+		"",
+		"P\"2!\"/\""
+	]));
+}
+isStringArray.__type = [
+	"value",
+	"isStringArray",
+	"P#2!!/\""
+];
+function isNumberArray(value) {
+	return Array.isArray(value) && value.every(__assignType((item) => typeof item === "number" && Number.isFinite(item), [
+		"item",
+		"",
+		"P\"2!\"/\""
+	]));
+}
+isNumberArray.__type = [
+	"value",
+	"isNumberArray",
+	"P#2!!/\""
+];
+function isBooleanArray(value) {
+	return Array.isArray(value) && value.every(__assignType((item) => isBoolean(item), [
+		"item",
+		"",
+		"P\"2!\"/\""
+	]));
+}
+isBooleanArray.__type = [
+	"value",
+	"isBooleanArray",
+	"P#2!!/\""
+];
+function isAliasConfig(value) {
+	return isSetString(value) || isStringArray(value);
+}
+isAliasConfig.__type = [
+	"value",
+	"isAliasConfig",
+	"P#2!!/\""
+];
+function isTypedDefaultValue(type, value, variadic) {
+	if (type === "string") {
+		if (variadic === true) return isStringArray(value);
+		if (variadic === false) return isSetString(value);
+		return isSetString(value) || isStringArray(value);
+	}
+	if (type === "number") {
+		if (variadic === true) return isNumberArray(value);
+		if (variadic === false) return typeof value === "number" && Number.isFinite(value);
+		return typeof value === "number" && Number.isFinite(value) || isNumberArray(value);
+	}
+	if (variadic === true) return isBooleanArray(value);
+	if (variadic === false) return isBoolean(value);
+	return isBoolean(value) || isBooleanArray(value);
+}
+isTypedDefaultValue.__type = [
+	"CommandParameterType",
+	"type",
+	"value",
+	"variadic",
+	"isTypedDefaultValue",
+	"P\"w!2\"#2#)2$8)/%"
+];
+function hasValidOptionalCommonFields(obj) {
+	if ("alias" in obj && obj.alias !== void 0 && !isAliasConfig(obj.alias)) return false;
+	if ("name" in obj && obj.name !== void 0 && !isSetString(obj.name)) return false;
+	if ("title" in obj && obj.title !== void 0 && !isSetString(obj.title)) return false;
+	if ("description" in obj && obj.description !== void 0 && !isSetString(obj.description)) return false;
+	if ("env" in obj && obj.env !== void 0 && !(isSetString(obj.env) || obj.env === false)) return false;
+	if ("required" in obj && obj.required !== void 0 && !isBoolean(obj.required)) return false;
+	if ("variadic" in obj && obj.variadic !== void 0 && !isBoolean(obj.variadic)) return false;
+	return true;
+}
+hasValidOptionalCommonFields.__type = [
+	() => __ΩRecord,
+	"obj",
+	"hasValidOptionalCommonFields",
+	"P&#o!#2\")/#"
+];
+function hasValidTypeSpecificFields(obj, type) {
+	const variadic = isBoolean(obj.variadic) ? obj.variadic : void 0;
+	if ("default" in obj && obj.default !== void 0 && !isTypedDefaultValue(type, obj.default, variadic)) return false;
+	if (type === "string") {
+		if ("format" in obj && obj.format !== void 0 && !isSetString(obj.format)) return false;
+		if ("choices" in obj && obj.choices !== void 0 && !isStringArray(obj.choices)) return false;
+		return true;
+	}
+	if (type === "number") {
+		if ("choices" in obj && obj.choices !== void 0 && !isNumberArray(obj.choices)) return false;
+		return true;
+	}
+	if ("choices" in obj && obj.choices !== void 0) return false;
+	if ("format" in obj && obj.format !== void 0) return false;
+	return true;
+}
+hasValidTypeSpecificFields.__type = [
+	() => __ΩRecord,
+	"obj",
+	"CommandParameterType",
+	"type",
+	"hasValidTypeSpecificFields",
+	"P&#o!#2\"\"w#2$)/%"
+];
 /**
-* Type guard to check if a value is a valid {@link CommandParameterKind} type.
+* Type guard to check if a value is a valid {@link CommandParameterType} type.
 *
 * @param obj - The value to check.
-* @returns True if the value is a valid {@link CommandParameterKind} type, false otherwise.
+* @returns True if the value is a valid {@link CommandParameterType} type, false otherwise.
 */
-function isCommandParameterKind(obj) {
+function isCommandParameterType(obj) {
 	return isSetString(obj) && [
-		CommandParameterKinds.string,
-		CommandParameterKinds.number,
-		CommandParameterKinds.boolean
+		"string",
+		"number",
+		"boolean"
 	].includes(obj);
 }
-isCommandParameterKind.__type = [
+isCommandParameterType.__type = [
 	"obj",
-	"isCommandParameterKind",
-	"Type guard to check if a value is a valid {@link CommandParameterKind} type.",
+	"isCommandParameterType",
+	"Type guard to check if a value is a valid {@link CommandParameterType} type.",
 	"P\"2!!/\"?#"
 ];
 /**
@@ -30,7 +146,8 @@ isCommandParameterKind.__type = [
 * @returns True if the value is a valid {@link CommandParameterConfig} type, false otherwise.
 */
 function isCommandParameterConfig(obj) {
-	return isSetObject(obj) && "kind" in obj && isCommandParameterKind(obj.kind);
+	if (!isSetObject(obj) || !("type" in obj) || !isCommandParameterType(obj.type)) return false;
+	return hasValidOptionalCommonFields(obj) && hasValidTypeSpecificFields(obj, obj.type);
 }
 isCommandParameterConfig.__type = [
 	"obj",
@@ -45,7 +162,15 @@ isCommandParameterConfig.__type = [
 * @returns True if the value is a valid {@link CommandParameter} type, false otherwise.
 */
 function isCommandParameter(obj) {
-	return isCommandParameterConfig(obj) && "name" in obj && isSetString(obj.name) && "title" in obj && isSetString(obj.title) && "description" in obj && isSetString(obj.description) && "alias" in obj && Array.isArray(obj.alias) && "env" in obj && (isSetString(obj.env) || obj.env === false) && "optional" in obj && isBoolean(obj.optional) && "variadic" in obj && isBoolean(obj.variadic);
+	if (!isCommandParameterConfig(obj)) return false;
+	if (!("name" in obj) || !isSetString(obj.name)) return false;
+	if (!("title" in obj) || !isSetString(obj.title)) return false;
+	if (!("description" in obj) || !isSetString(obj.description)) return false;
+	if (!("alias" in obj) || !isStringArray(obj.alias)) return false;
+	if (!("env" in obj) || !(isSetString(obj.env) || obj.env === false)) return false;
+	if (!("required" in obj) || !isBoolean(obj.required)) return false;
+	if (!("variadic" in obj) || !isBoolean(obj.variadic)) return false;
+	return hasValidTypeSpecificFields(obj, obj.type);
 }
 isCommandParameter.__type = [
 	"obj",
@@ -60,7 +185,11 @@ isCommandParameter.__type = [
 * @returns True if the value is a valid {@link CommandOption} type, false otherwise.
 */
 function isCommandOption(obj) {
-	return isCommandParameterConfig(obj) && isCommandParameter(obj) && "default" in obj;
+	if (!isCommandParameter(obj)) return false;
+	if (obj.type !== "boolean") return true;
+	if ("isNegativeOf" in obj && obj.isNegativeOf !== void 0 && !isSetString(obj.isNegativeOf)) return false;
+	if ("skipAddingNegative" in obj && obj.skipAddingNegative !== void 0 && !isBoolean(obj.skipAddingNegative)) return false;
+	return true;
 }
 isCommandOption.__type = [
 	"obj",
@@ -75,7 +204,7 @@ isCommandOption.__type = [
 * @returns True if the value is a valid {@link CommandArgument} type, false otherwise.
 */
 function isCommandArgument(obj) {
-	return isCommandParameterConfig(obj) && isCommandParameter(obj);
+	return isCommandParameter(obj);
 }
 isCommandArgument.__type = [
 	"obj",
@@ -85,5 +214,5 @@ isCommandArgument.__type = [
 ];
 
 //#endregion
-export { isCommandArgument, isCommandOption, isCommandParameter, isCommandParameterConfig, isCommandParameterKind };
+export { isCommandArgument, isCommandOption, isCommandParameter, isCommandParameterConfig, isCommandParameterType };
 //# sourceMappingURL=type-checks.mjs.map

package/dist/plugin-utils/type-checks.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"type-checks.mjs","names":[],"sources":["../../src/plugin-utils/type-checks.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { isBoolean } from \"@stryke/type-checks/is-boolean\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport type {\n  CommandArgument,\n  CommandOption,\n  CommandParameter,\n  CommandParameterConfig,\n  CommandParameterKind\n} from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameterKind} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameterKind} type, false otherwise.\n */\nexport function isCommandParameterKind(obj: any): obj is CommandParameterKind {\n  return (\n    isSetString(obj) &&\n    [\n      CommandParameterKinds.string,\n      CommandParameterKinds.number,\n      CommandParameterKinds.boolean\n    ].includes(obj as CommandParameterKind)\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameterConfig} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameterConfig} type, false otherwise.\n */\nexport function isCommandParameterConfig(\n  obj: any\n): obj is CommandParameterConfig {\n  return isSetObject(obj) && \"kind\" in obj && isCommandParameterKind(obj.kind);\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandParameter} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandParameter} type, false otherwise.\n */\nexport function isCommandParameter(obj: any): obj is CommandParameter {\n  return (\n    isCommandParameterConfig(obj) &&\n    \"name\" in obj &&\n    isSetString(obj.name) &&\n    \"title\" in obj &&\n    isSetString(obj.title) &&\n    \"description\" in obj &&\n    isSetString(obj.description) &&\n    \"alias\" in obj &&\n    Array.isArray(obj.alias) &&\n    \"env\" in obj &&\n    (isSetString(obj.env) || obj.env === false) &&\n    \"optional\" in obj &&\n    isBoolean(obj.optional) &&\n    \"variadic\" in obj &&\n    isBoolean(obj.variadic)\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandOption} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandOption} type, false otherwise.\n */\nexport function isCommandOption(obj: any): obj is CommandOption {\n  return (\n    isCommandParameterConfig(obj) && isCommandParameter(obj) && \"default\" in obj\n  );\n}\n\n/**\n * Type guard to check if a value is a valid {@link CommandArgument} type.\n *\n * @param obj - The value to check.\n * @returns True if the value is a valid {@link CommandArgument} type, false otherwise.\n */\nexport function isCommandArgument(obj: any): obj is CommandArgument {\n  return isCommandParameterConfig(obj) && isCommandParameter(obj);\n}\n"],"mappings":";;;;;;;;;;;;AA2BA,SAAgB,uBAAS,KAAA;AACzB,QAAS,YAAA,IAAA,IAAA;EAAqB,sBAAkB;EAAQ,sBAAA;EAAA,sBAAA;EAAA,CAAA,SAAA,IAAA;;AAExD,uBAAE,SAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOF,SAAS,yBAAA,KAAA;AACP,QAAE,YAAiB,IAAC,IAAA,UAAA,OAAA,uBAAA,IAAA,KAAA;;AAEtB,yBAAM,SAA4B;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;AAOlC,SAAE,mBAAA,KAAA;AACA,QAAM,yBAA0B,IAAI,IAAC,UAAa,OAAA,YAAA,IAAuB,KAAK,IAAA,WAAA,OAAA,YAAA,IAAA,MAAA,IAAA,iBAAA,OAAA,YAAA,IAAA,YAAA,IAAA,WAAA,OAAA,MAAA,QAAA,IAAA,MAAA,IAAA,SAAA,QAAA,YAAA,IAAA,IAAA,IAAA,IAAA,QAAA,UAAA,cAAA,OAAA,UAAA,IAAA,SAAA,IAAA,cAAA,OAAA,UAAA,IAAA,SAAA;;AAEhF,mBAAmB,SAAS;CAAC;CAAK;CAAA;CAAA;CAAA;;;;;;;AAOlC,SAAA,gBAAA,KAAA;;;AAGA,gBAAgB,SAAS;CAAC;CAAO;CAAmB;CAAsB;CAAA;;;;;;;AAO1E,SAAI,kBAA8B,KAAC;AACjC,QAAO,yBAAU,IAAA,IAAA,mBAAA,IAAA;;AAEnB,kBAAkB,SAAE;CAAA;CAAA;CAAA;CAAA;CAAA"}
+{"version":3,"file":"type-checks.mjs","names":[],"sources":[],"mappings":""}

package/dist/plugin.cjs

@@ -3,13 +3,12 @@ const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
 const require_context_helpers = require('./plugin-utils/context-helpers.cjs');
 const require_components_docs = require('./components/docs.cjs');
 const require_components_exec_builtin = require('./components/exec-builtin.cjs');
-const require_deepkit = require('./plugin-utils/deepkit.cjs');
 const require_traverse_command_tree = require('./plugin-utils/traverse-command-tree.cjs');
 const require_get_command_tree = require('./plugin-utils/get-command-tree.cjs');
-require('./plugin-utils/index.cjs');
 const require_components_state_builtin = require('./components/state-builtin.cjs');
 const require_components_utils_builtin = require('./components/utils-builtin.cjs');
 const require_automd = require('./helpers/automd.cjs');
+const require_get_framework = require('./helpers/get-framework.cjs');
 const require_paths = require('./helpers/paths.cjs');
 const require_persistence = require('./helpers/persistence.cjs');
 const require_update_package_json = require('./helpers/update-package-json.cjs');
@@ -17,20 +16,20 @@ const require_utilities = require('./helpers/utilities.cjs');
 const require_validations = require('./helpers/validations.cjs');
 const require_resolve = require('./resolver/resolve.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_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let _alloy_js_core = require("@alloy-js/core");
 let _powerlines_plugin_alloy_render = require("@powerlines/plugin-alloy/render");
 let _powerlines_plugin_automd = require("@powerlines/plugin-automd");
 _powerlines_plugin_automd = require_runtime.__toESM(_powerlines_plugin_automd);
-let _powerlines_plugin_env_helpers = require("@powerlines/plugin-env/helpers");
+let _powerlines_plugin_env_helpers_schema = require("@powerlines/plugin-env/helpers/schema");
 let _powerlines_plugin_nodejs = require("@powerlines/plugin-nodejs");
 _powerlines_plugin_nodejs = require_runtime.__toESM(_powerlines_plugin_nodejs);
 let _powerlines_plugin_tsdown = require("@powerlines/plugin-tsdown");
 _powerlines_plugin_tsdown = require_runtime.__toESM(_powerlines_plugin_tsdown);
+let _powerlines_schema = require("@powerlines/schema");
 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_find = require("@stryke/path/find");
 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");
@@ -39,8 +38,10 @@ 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_object = require("@stryke/type-checks/is-object");
+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 = require("powerlines");
 let powerlines_utils = require("powerlines/utils");
 
 //#region src/plugin.tsx
@@ -57,7 +58,7 @@ const plugin = __assignType((options = {}) => {
 		(_powerlines_plugin_tsdown.default.Ω = [["Context", "\"w!"]], (0, _powerlines_plugin_tsdown.default)()),
 		(_powerlines_plugin_automd.default.Ω = [["Context", "\"w!"]], (0, _powerlines_plugin_automd.default)()),
 		{
-			name: "shell-shock:config",
+			name: "shell-shock/core:config",
 			config: __assignType(async function config() {
 				this.debug("Resolving the Shell Shock configuration.");
 				return (0, defu.defu)(options, {
@@ -66,7 +67,7 @@ const plugin = __assignType((options = {}) => {
 					description: require_context_helpers.getAppDescription(this),
 					platform: "node",
 					projectType: "application",
-					framework: "shell-shock",
+					framework: require_get_framework.getFramework(),
 					isCaseSensitive: false,
 					output: {
 						format: "esm",
@@ -111,13 +112,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: (0, _stryke_string_format_camel_case.camelCase)(option.name),
 						alias: option.alias ?? [],
-						optional: option.optional ?? false
+						required: option.required ?? true
 					}), [
 						"option",
 						"",
@@ -127,13 +128,39 @@ const plugin = __assignType((options = {}) => {
 			}
 		},
 		...(_powerlines_plugin_nodejs.default.Ω = [["Context", "\"w!"]], (0, _powerlines_plugin_nodejs.default)((0, defu.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 ((0, _stryke_type_checks_is_set_string.isSetString)(value)) return value;
+					if ((0, _stryke_type_checks_is_set_object.isSetObject)(value) && (0, powerlines.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) => (0, _stryke_type_checks_is_set_string.isSetString)(value), [
+					"value",
+					"",
+					"P\"2!!/\""
+				])));
+				else if ((0, _stryke_type_checks_is_set_string.isSetString)(this.config.input)) configuredInputs.push(this.config.input);
+				else if ((0, _stryke_type_checks_is_set_object.isSetObject)(this.config.input) && (0, powerlines.isFileReference)(this.config.input)) configuredInputs.push(String(this.config.input.file));
+				else if ((0, _stryke_type_checks_is_set_object.isSetObject)(this.config.input)) configuredInputs.push(...Object.values(this.config.input).map(toInputLocation).filter(__assignType((value) => (0, _stryke_type_checks_is_set_string.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 require_paths.findCommandsRoot(this);
 				this.debug(`Resolved commands root path: ${this.commandsPath}`);
 				const inputs = await (0, powerlines_utils.resolveInputs)(this, this.config.input);
@@ -173,14 +200,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
 							}
@@ -209,7 +234,7 @@ const plugin = __assignType((options = {}) => {
 			}, ["prepare", "P\"/!"])
 		},
 		{
-			name: "shell-shock:virtual-inputs",
+			name: "shell-shock/core:virtual-inputs",
 			configResolved: {
 				order: "post",
 				async handler() {
@@ -218,10 +243,10 @@ const plugin = __assignType((options = {}) => {
 						this.debug("Finding and adding virtual command inputs for each command previously found.");
 						this.inputs = this.inputs.reduce(__assignType((ret, command) => {
 							let depth = 0;
-							let parentPath = (0, _stryke_path_resolve_parent_path.resolveParentPath)((0, _stryke_path_file_path_fns.findFilePath)(command.entry.file));
+							let parentPath = (0, _stryke_path_resolve_parent_path.resolveParentPath)((0, _stryke_path_find.findFilePath)(command.entry.file));
 							if ((0, _stryke_path_is_parent_path.isParentPath)(parentPath, this.commandsPath)) while (parentPath !== this.commandsPath) {
 								if (depth++ > MAX_DEPTH) throw new Error(`Unable to process virtual commands for ${command.name} \n\nPlease ensure ${command.entry.file} is a valid command entry file and does not have an invalid path.`);
-								if (!ret.some(__assignType((existing) => (0, _stryke_path_file_path_fns.findFilePath)(existing.entry.file) === parentPath, [
+								if (!ret.some(__assignType((existing) => (0, _stryke_path_find.findFilePath)(existing.entry.file) === parentPath, [
 									"existing",
 									"",
 									"P\"2!\"/\""
@@ -260,9 +285,8 @@ const plugin = __assignType((options = {}) => {
 											name,
 											alias: [],
 											tags: [],
-											isVirtual: true,
-											entry: { file },
-											source: "file"
+											virtual: true,
+											entry: { file }
 										});
 									}
 								}
@@ -280,7 +304,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" ? (0, _stryke_path_replace.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!\"/\""
@@ -290,54 +314,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 (0, _powerlines_plugin_env_helpers_schema.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 (!(0, _powerlines_schema.isJsonSchemaObject)(this.env.config.schema)) throw new Error("Invalid environment variable schema extracted.");
+					const env = (0, _powerlines_schema.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) => (0, _stryke_type_checks_is_set_string.isSetString)(option.env) && !env[option.env], [
 						"option",
 						"",
 						"P\"2!\"/\""
-					]))) this.env.types.env.addProperty({
+					]))) (0, _powerlines_schema.addProperty)(this.env.config, option.env, {
+						...option,
 						name: option.env,
-						optional: option.optional ? true : void 0,
-						description: option.description,
-						visibility: _powerlines_deepkit_vendor_type.ReflectionVisibility.public,
-						type: require_deepkit.extractType(option),
-						default: option.default,
-						tags: {
-							title: option.title,
-							alias: option.alias.filter(__assignType((alias) => alias.length > 1, [
-								"alias",
-								"",
-								"P\"2!\"/\""
-							])).map(__assignType((alias) => (0, _stryke_string_format_constant_case.constantCase)(alias), [
-								"alias",
-								"",
-								"P\"2!\"/\""
-							])),
-							domain: "cli"
-						}
+						alias: option.alias.filter(__assignType((alias) => alias.length > 1, [
+							"alias",
+							"",
+							"P\"2!\"/\""
+						])).map(__assignType((alias) => (0, _stryke_string_format_constant_case.constantCase)(alias), [
+							"alias",
+							"",
+							"P\"2!\"/\""
+						]))
 					});
-					await (0, _powerlines_plugin_env_helpers.writeEnvTypeReflection)(this, this.env.types.env, "env");
+					await (0, _powerlines_plugin_env_helpers_schema.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(require_persistence.getCommandsPersistencePath(this))) {
+					if (this.config.command !== "prepare" && this.config.skipCache !== true && this.persistedMeta?.checksum === this.meta.checksum && this.fs.existsSync((0, _powerlines_schema.getCacheFilePath)(this, this.env.config))) {
 						this.debug(`Skipping command resolution as the meta checksum has not changed.`);
-						await require_persistence.readCommandsPersistence(this);
+						await (0, _powerlines_plugin_env_helpers_schema.extractEnv)(this);
 					} else {
 						for (const input of this.inputs.filter(__assignType((input) => input.segments.filter(__assignType((segment) => !require_context_helpers.isDynamicPathSegment(segment) && !require_context_helpers.isPathSegmentGroup(segment), [
 							"segment",
@@ -357,7 +380,7 @@ const plugin = __assignType((options = {}) => {
 								...option,
 								name: (0, _stryke_string_format_camel_case.camelCase)(name),
 								alias: option.alias ?? [],
-								optional: option.optional ?? false
+								required: option.required ?? true
 							}], [
 								"param0",
 								"",
@@ -393,7 +416,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 (_) => {
@@ -420,7 +443,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 = {
@@ -435,15 +458,15 @@ const plugin = __assignType((options = {}) => {
 					"",
 					"P\"2!\"/\""
 				])).filter(Boolean);
-				return (0, _powerlines_plugin_alloy_render.render)(this, (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core_components.For, {
+				return (0, _powerlines_plugin_alloy_render.render)(this, (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
 					get each() {
 						return Object.values(commands);
 					},
 					doubleHardline: true,
 					get children() {
-						return __assignType((child) => (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core_components.Show, {
+						return __assignType((child) => (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
 							get when() {
-								return !child.isVirtual;
+								return !child.virtual;
 							},
 							get children() {
 								return (0, _alloy_js_core_jsx_runtime.createComponent)(require_components_docs.CommandDocsFile, { command: child });
@@ -468,4 +491,5 @@ const plugin = __assignType((options = {}) => {
 
 //#endregion
 exports.default = plugin;
-exports.plugin = plugin;
+exports.plugin = plugin;
+//# sourceMappingURL=plugin.cjs.map

package/dist/plugin.cjs.map

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

package/dist/plugin.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.tsx"],"mappings":";;;;;;;AAqFA;cAAa,MAAA,oBAA2B,OAAA,GAAU,OAAA,EAChD,OAAA,GAAS,OAAA,KACR,MAAA,CAAO,QAAA"}
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../src/plugin.tsx"],"mappings":";;;;;;;AAwFA;cAAa,MAAA,oBAA2B,OAAA,GAAU,OAAA,EAChD,OAAA,GAAS,OAAA,KACR,MAAA,CAAO,QAAA"}

package/dist/plugin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.mts","names":[],"sources":["../src/plugin.tsx"],"mappings":";;;;;;;AAqFA;cAAa,MAAA,oBAA2B,OAAA,GAAU,OAAA,EAChD,OAAA,GAAS,OAAA,KACR,MAAA,CAAO,QAAA"}
+{"version":3,"file":"plugin.d.mts","names":[],"sources":["../src/plugin.tsx"],"mappings":""}