@shell-shock/preset-script 0.6.23 → 0.6.27

package/dist/plugin-help/dist/components/help-command.mjs

@@ -0,0 +1,96 @@
+import { createComponent } from "@alloy-js/core/jsx-runtime";
+import { code } from "@alloy-js/core";
+import { FunctionDeclaration, InterfaceDeclaration } from "@alloy-js/typescript";
+import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
+import { InterfaceMember as InterfaceMember$1, TypescriptFile } from "@powerlines/plugin-alloy/typescript";
+import { joinPaths } from "@stryke/path";
+import { ReflectionKind } from "@powerlines/deepkit/vendor/type";
+import { Spacing } from "@powerlines/plugin-alloy/core";
+import { TSDoc, TSDocDefaultValue, TSDocRemarks } from "@powerlines/plugin-alloy/typescript/components/tsdoc";
+
+//#region ../plugin-help/dist/components/help-command.mjs
+/**
+* The Help command's handler wrapper for the Shell Shock project.
+*/
+function HelpCommand() {
+	const context = usePowerlines();
+	return createComponent(TypescriptFile, {
+		get path() {
+			return joinPaths(context.entryPath, "help", "command.ts");
+		},
+		imports: {
+			"node:os": ["os"],
+			"node:fs/promises": ["readFile", "writeFile"]
+		},
+		builtinImports: { console: [
+			"colors",
+			"writeLine",
+			"success",
+			"warn",
+			"stripAnsi"
+		] },
+		get children() {
+			return [
+				createComponent(TSDoc, { heading: "Options for the Help command." }),
+				createComponent(InterfaceDeclaration, {
+					"export": true,
+					name: "HelpOptions",
+					get children() {
+						return [
+							createComponent(TSDoc, {
+								heading: "Whether to help to the latest version.",
+								get children() {
+									return [createComponent(TSDocRemarks, { children: `If set to \`true\`, the command will attempt to help to the latest version. This option takes precedence over the \`version\` option.` }), createComponent(TSDocDefaultValue, {
+										get type() {
+											return ReflectionKind.boolean;
+										},
+										defaultValue: false
+									})];
+								}
+							}),
+							createComponent(InterfaceMember$1, {
+								name: "latest",
+								optional: true,
+								type: "boolean"
+							}),
+							createComponent(Spacing, {}),
+							createComponent(TSDoc, {
+								heading: "A specific application version to help to.",
+								get children() {
+									return [createComponent(TSDocRemarks, { children: `The command will attempt to help to the specified version. The version should be a valid semantic version string, or \`latest\` to help to the latest version.` }), createComponent(TSDocDefaultValue, {
+										get type() {
+											return ReflectionKind.string;
+										},
+										defaultValue: "latest"
+									})];
+								}
+							}),
+							createComponent(InterfaceMember$1, {
+								name: "version",
+								optional: true,
+								type: "string"
+							})
+						];
+					}
+				}),
+				createComponent(Spacing, {}),
+				createComponent(TSDoc, { heading: "Handler logic for the \\`help\\` command." }),
+				createComponent(FunctionDeclaration, {
+					"export": true,
+					"default": true,
+					async: true,
+					name: "handler",
+					parameters: [{
+						name: "options",
+						type: "HelpOptions"
+					}],
+					children: code` return;`
+				})
+			];
+		}
+	});
+}
+
+//#endregion
+export { HelpCommand };
+//# sourceMappingURL=help-command.mjs.map

package/dist/plugin-help/dist/components/help-command.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-command.mjs","names":["TSDoc$1","TSDocRemarks$1","InterfaceMember"],"sources":["../../../../../plugin-help/dist/components/help-command.mjs"],"sourcesContent":["import { createComponent } from \"@alloy-js/core/jsx-runtime\";\nimport { code } from \"@alloy-js/core\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { FunctionDeclaration, InterfaceDeclaration } from \"@alloy-js/typescript\";\nimport { InterfaceMember, TypescriptFile } from \"@powerlines/plugin-alloy/typescript\";\nimport { joinPaths } from \"@stryke/path\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core\";\nimport { TSDoc as TSDoc$1, TSDocDefaultValue, TSDocRemarks as TSDocRemarks$1 } from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\n\n//#region src/components/help-command.tsx\n/**\n* The Help command's handler wrapper for the Shell Shock project.\n*/\nfunction HelpCommand() {\n\tconst context = usePowerlines();\n\treturn createComponent(TypescriptFile, {\n\t\tget path() {\n\t\t\treturn joinPaths(context.entryPath, \"help\", \"command.ts\");\n\t\t},\n\t\timports: {\n\t\t\t\"node:os\": [\"os\"],\n\t\t\t\"node:fs/promises\": [\"readFile\", \"writeFile\"]\n\t\t},\n\t\tbuiltinImports: { console: [\n\t\t\t\"colors\",\n\t\t\t\"writeLine\",\n\t\t\t\"success\",\n\t\t\t\"warn\",\n\t\t\t\"stripAnsi\"\n\t\t] },\n\t\tget children() {\n\t\t\treturn [\n\t\t\t\tcreateComponent(TSDoc$1, { heading: \"Options for the Help command.\" }),\n\t\t\t\tcreateComponent(InterfaceDeclaration, {\n\t\t\t\t\t\"export\": true,\n\t\t\t\t\tname: \"HelpOptions\",\n\t\t\t\t\tget children() {\n\t\t\t\t\t\treturn [\n\t\t\t\t\t\t\tcreateComponent(TSDoc$1, {\n\t\t\t\t\t\t\t\theading: \"Whether to help to the latest version.\",\n\t\t\t\t\t\t\t\tget children() {\n\t\t\t\t\t\t\t\t\treturn [createComponent(TSDocRemarks$1, { children: `If set to \\`true\\`, the command will attempt to help to the latest version. This option takes precedence over the \\`version\\` option.` }), createComponent(TSDocDefaultValue, {\n\t\t\t\t\t\t\t\t\t\tget type() {\n\t\t\t\t\t\t\t\t\t\t\treturn ReflectionKind.boolean;\n\t\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\t\tdefaultValue: false\n\t\t\t\t\t\t\t\t\t})];\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\tcreateComponent(InterfaceMember, {\n\t\t\t\t\t\t\t\tname: \"latest\",\n\t\t\t\t\t\t\t\toptional: true,\n\t\t\t\t\t\t\t\ttype: \"boolean\"\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\tcreateComponent(Spacing, {}),\n\t\t\t\t\t\t\tcreateComponent(TSDoc$1, {\n\t\t\t\t\t\t\t\theading: \"A specific application version to help to.\",\n\t\t\t\t\t\t\t\tget children() {\n\t\t\t\t\t\t\t\t\treturn [createComponent(TSDocRemarks$1, { children: `The command will attempt to help to the specified version. The version should be a valid semantic version string, or \\`latest\\` to help to the latest version.` }), createComponent(TSDocDefaultValue, {\n\t\t\t\t\t\t\t\t\t\tget type() {\n\t\t\t\t\t\t\t\t\t\t\treturn ReflectionKind.string;\n\t\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\t\tdefaultValue: \"latest\"\n\t\t\t\t\t\t\t\t\t})];\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\tcreateComponent(InterfaceMember, {\n\t\t\t\t\t\t\t\tname: \"version\",\n\t\t\t\t\t\t\t\toptional: true,\n\t\t\t\t\t\t\t\ttype: \"string\"\n\t\t\t\t\t\t\t})\n\t\t\t\t\t\t];\n\t\t\t\t\t}\n\t\t\t\t}),\n\t\t\t\tcreateComponent(Spacing, {}),\n\t\t\t\tcreateComponent(TSDoc$1, { heading: \"Handler logic for the \\\\`help\\\\` command.\" }),\n\t\t\t\tcreateComponent(FunctionDeclaration, {\n\t\t\t\t\t\"export\": true,\n\t\t\t\t\t\"default\": true,\n\t\t\t\t\tasync: true,\n\t\t\t\t\tname: \"handler\",\n\t\t\t\t\tparameters: [{\n\t\t\t\t\t\tname: \"options\",\n\t\t\t\t\t\ttype: \"HelpOptions\"\n\t\t\t\t\t}],\n\t\t\t\t\tchildren: code` return;`\n\t\t\t\t})\n\t\t\t];\n\t\t}\n\t});\n}\n\n//#endregion\nexport { HelpCommand };\n//# sourceMappingURL=help-command.mjs.map"],"mappings":";;;;;;;;;;;;;;AAcA,SAAS,cAAc;CACtB,MAAM,UAAU,eAAe;AAC/B,QAAO,gBAAgB,gBAAgB;EACtC,IAAI,OAAO;AACV,UAAO,UAAU,QAAQ,WAAW,QAAQ,aAAa;;EAE1D,SAAS;GACR,WAAW,CAAC,KAAK;GACjB,oBAAoB,CAAC,YAAY,YAAY;GAC7C;EACD,gBAAgB,EAAE,SAAS;GAC1B;GACA;GACA;GACA;GACA;GACA,EAAE;EACH,IAAI,WAAW;AACd,UAAO;IACN,gBAAgBA,OAAS,EAAE,SAAS,iCAAiC,CAAC;IACtE,gBAAgB,sBAAsB;KACrC,UAAU;KACV,MAAM;KACN,IAAI,WAAW;AACd,aAAO;OACN,gBAAgBA,OAAS;QACxB,SAAS;QACT,IAAI,WAAW;AACd,gBAAO,CAAC,gBAAgBC,cAAgB,EAAE,UAAU,yIAAyI,CAAC,EAAE,gBAAgB,mBAAmB;UAClO,IAAI,OAAO;AACV,kBAAO,eAAe;;UAEvB,cAAc;UACd,CAAC,CAAC;;QAEJ,CAAC;OACF,gBAAgBC,mBAAiB;QAChC,MAAM;QACN,UAAU;QACV,MAAM;QACN,CAAC;OACF,gBAAgB,SAAS,EAAE,CAAC;OAC5B,gBAAgBF,OAAS;QACxB,SAAS;QACT,IAAI,WAAW;AACd,gBAAO,CAAC,gBAAgBC,cAAgB,EAAE,UAAU,kKAAkK,CAAC,EAAE,gBAAgB,mBAAmB;UAC3P,IAAI,OAAO;AACV,kBAAO,eAAe;;UAEvB,cAAc;UACd,CAAC,CAAC;;QAEJ,CAAC;OACF,gBAAgBC,mBAAiB;QAChC,MAAM;QACN,UAAU;QACV,MAAM;QACN,CAAC;OACF;;KAEF,CAAC;IACF,gBAAgB,SAAS,EAAE,CAAC;IAC5B,gBAAgBF,OAAS,EAAE,SAAS,6CAA6C,CAAC;IAClF,gBAAgB,qBAAqB;KACpC,UAAU;KACV,WAAW;KACX,OAAO;KACP,MAAM;KACN,YAAY,CAAC;MACZ,MAAM;MACN,MAAM;MACN,CAAC;KACF,UAAU,IAAI;KACd,CAAC;IACF;;EAEF,CAAC"}

package/dist/plugin-help/dist/components/index.cjs

@@ -0,0 +1,3 @@
+const require_display = require('./display.cjs');
+const require_help_builtin = require('./help-builtin.cjs');
+const require_help_command = require('./help-command.cjs');

package/dist/plugin-help/dist/components/index.mjs

@@ -0,0 +1,5 @@
+import { BaseHelpDisplay, CommandHelpDisplay, HelpCommandsDisplay, HelpOptionsDisplay, HelpUsageDisplay, VirtualCommandHelpDisplay } from "./display.mjs";
+import { HelpBuiltin } from "./help-builtin.mjs";
+import { HelpCommand } from "./help-command.mjs";
+
+export {  };

package/dist/plugin-help/dist/index.cjs

@@ -0,0 +1,104 @@
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+const require_is_set_string = require('./node_modules/.pnpm/@stryke_type-checks@0.5.41/node_modules/@stryke/type-checks/dist/is-set-string.cjs');
+const require_help_builtin = require('./components/help-builtin.cjs');
+const require_help_command = require('./components/help-command.cjs');
+require('./components/index.cjs');
+let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let _alloy_js_core = require("@alloy-js/core");
+let _powerlines_plugin_alloy_core_components = require("@powerlines/plugin-alloy/core/components");
+let _powerlines_plugin_alloy_render = require("@powerlines/plugin-alloy/render");
+let _shell_shock_plugin_console = require("@shell-shock/plugin-console");
+_shell_shock_plugin_console = require_runtime.__toESM(_shell_shock_plugin_console);
+let _shell_shock_core_plugin_utils = require("@shell-shock/core/plugin-utils");
+let defu = require("defu");
+defu = require_runtime.__toESM(defu);
+let _shell_shock_plugin_theme = require("@shell-shock/plugin-theme");
+_shell_shock_plugin_theme = require_runtime.__toESM(_shell_shock_plugin_theme);
+let _stryke_path_join = require("@stryke/path/join");
+
+//#region ../plugin-help/dist/index.mjs
+/**
+* The Help - Shell Shock plugin to add a help command to the application.
+*/
+const plugin = (options = {}) => {
+	return [
+		...(0, _shell_shock_plugin_theme.default)(options.theme),
+		(0, _shell_shock_plugin_console.default)(options.console),
+		{
+			name: "shell-shock:help",
+			enforce: "post",
+			config() {
+				this.debug("Providing default configuration for the Shell Shock `help` plugin.");
+				return { help: (0, defu.default)({ command: options.command === false ? false : require_is_set_string.isSetString(options.command) ? options.command : "help" }, options, { builtins: true }) };
+			},
+			async configResolved() {
+				this.debug("Adding the Help command to the application context.");
+				if (this.config.help.command !== false) {
+					this.inputs ??= [];
+					if (this.inputs.some((input) => input.name === this.config.help.command)) this.info("The `help` command already exists in the commands list. If you would like the help command to be managed by the `@shell-shock/plugin-help` package, please remove or rename the command.");
+					else this.inputs.push({
+						id: this.config.help.command,
+						name: this.config.help.command,
+						path: this.config.help.command,
+						segments: [this.config.help.command],
+						title: "Help",
+						description: `A command for displaying help information to assist in using the ${(0, _shell_shock_core_plugin_utils.getAppTitle)(this, true)} command-line interface application.`,
+						entry: {
+							file: (0, _stryke_path_join.joinPaths)(this.entryPath, "help", "index.ts"),
+							input: { file: (0, _stryke_path_join.joinPaths)(this.entryPath, "help", "command.ts") }
+						},
+						isVirtual: false
+					});
+					await (0, _powerlines_plugin_alloy_render.render)(this, (0, _alloy_js_core_jsx_runtime.createComponent)(require_help_command.HelpCommand, {}));
+				}
+			},
+			prepare: {
+				order: "post",
+				async handler() {
+					const _self$ = this;
+					const commands = await (0, _shell_shock_core_plugin_utils.getCommandList)(this);
+					this.debug(`Rendering \`help\` built-ins for each of the ${commands.length} command modules.`);
+					const bin = (0, _alloy_js_core.computed)(() => ({
+						id: "",
+						name: (0, _shell_shock_core_plugin_utils.getAppName)(this),
+						title: (0, _shell_shock_core_plugin_utils.getAppTitle)(this),
+						description: (0, _shell_shock_core_plugin_utils.getAppDescription)(this),
+						isVirtual: true,
+						path: null,
+						segments: [],
+						alias: [],
+						options: Object.fromEntries(this.options.map((option) => [option.name, option])),
+						entry: { file: (0, _stryke_path_join.joinPaths)(this.entryPath, "bin.ts") },
+						args: [],
+						parent: null,
+						children: this.commands
+					}));
+					return (0, _powerlines_plugin_alloy_render.render)(this, [(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.Show, {
+						get when() {
+							return _self$.config.help.builtins !== false;
+						},
+						get children() {
+							return [
+								(0, _alloy_js_core_jsx_runtime.createComponent)(require_help_builtin.HelpBuiltin, { get command() {
+									return bin.value;
+								} }),
+								(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components.Spacing, {}),
+								(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_core.For, {
+									get each() {
+										return commands.sort((a, b) => a.name.localeCompare(b.name));
+									},
+									doubleHardline: true,
+									children: (command) => (0, _alloy_js_core_jsx_runtime.createComponent)(require_help_builtin.HelpBuiltin, { command })
+								})
+							];
+						}
+					})]);
+				}
+			}
+		}
+	];
+};
+
+//#endregion
+exports.plugin = plugin;
+//# sourceMappingURL=index.cjs.map

package/dist/plugin-help/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["isSetString","HelpCommand","Show","HelpBuiltin","Spacing","For"],"sources":["../../../../plugin-help/dist/index.mjs"],"sourcesContent":["import { isSetString } from \"./node_modules/.pnpm/@stryke_type-checks@0.5.41/node_modules/@stryke/type-checks/dist/is-set-string.mjs\";\nimport { HelpBuiltin } from \"./components/help-builtin.mjs\";\nimport { HelpCommand } from \"./components/help-command.mjs\";\nimport \"./components/index.mjs\";\nimport { createComponent } from \"@alloy-js/core/jsx-runtime\";\nimport { For, Show, computed } from \"@alloy-js/core\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport { getAppDescription, getAppName, getAppTitle, getCommandList } from \"@shell-shock/core/plugin-utils\";\nimport console from \"@shell-shock/plugin-console\";\nimport theme from \"@shell-shock/plugin-theme\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport defu from \"defu\";\n\n//#region src/index.tsx\n/**\n* The Help - Shell Shock plugin to add a help command to the application.\n*/\nconst plugin = (options = {}) => {\n\treturn [\n\t\t...theme(options.theme),\n\t\tconsole(options.console),\n\t\t{\n\t\t\tname: \"shell-shock:help\",\n\t\t\tenforce: \"post\",\n\t\t\tconfig() {\n\t\t\t\tthis.debug(\"Providing default configuration for the Shell Shock `help` plugin.\");\n\t\t\t\treturn { help: defu({ command: options.command === false ? false : isSetString(options.command) ? options.command : \"help\" }, options, { builtins: true }) };\n\t\t\t},\n\t\t\tasync configResolved() {\n\t\t\t\tthis.debug(\"Adding the Help command to the application context.\");\n\t\t\t\tif (this.config.help.command !== false) {\n\t\t\t\t\tthis.inputs ??= [];\n\t\t\t\t\tif (this.inputs.some((input) => input.name === this.config.help.command)) this.info(\"The `help` command already exists in the commands list. If you would like the help command to be managed by the `@shell-shock/plugin-help` package, please remove or rename the command.\");\n\t\t\t\t\telse this.inputs.push({\n\t\t\t\t\t\tid: this.config.help.command,\n\t\t\t\t\t\tname: this.config.help.command,\n\t\t\t\t\t\tpath: this.config.help.command,\n\t\t\t\t\t\tsegments: [this.config.help.command],\n\t\t\t\t\t\ttitle: \"Help\",\n\t\t\t\t\t\tdescription: `A command for displaying help information to assist in using the ${getAppTitle(this, true)} command-line interface application.`,\n\t\t\t\t\t\tentry: {\n\t\t\t\t\t\t\tfile: joinPaths(this.entryPath, \"help\", \"index.ts\"),\n\t\t\t\t\t\t\tinput: { file: joinPaths(this.entryPath, \"help\", \"command.ts\") }\n\t\t\t\t\t\t},\n\t\t\t\t\t\tisVirtual: false\n\t\t\t\t\t});\n\t\t\t\t\tawait render(this, createComponent(HelpCommand, {}));\n\t\t\t\t}\n\t\t\t},\n\t\t\tprepare: {\n\t\t\t\torder: \"post\",\n\t\t\t\tasync handler() {\n\t\t\t\t\tconst _self$ = this;\n\t\t\t\t\tconst commands = await getCommandList(this);\n\t\t\t\t\tthis.debug(`Rendering \\`help\\` built-ins for each of the ${commands.length} command modules.`);\n\t\t\t\t\tconst bin = computed(() => ({\n\t\t\t\t\t\tid: \"\",\n\t\t\t\t\t\tname: getAppName(this),\n\t\t\t\t\t\ttitle: getAppTitle(this),\n\t\t\t\t\t\tdescription: getAppDescription(this),\n\t\t\t\t\t\tisVirtual: true,\n\t\t\t\t\t\tpath: null,\n\t\t\t\t\t\tsegments: [],\n\t\t\t\t\t\talias: [],\n\t\t\t\t\t\toptions: Object.fromEntries(this.options.map((option) => [option.name, option])),\n\t\t\t\t\t\tentry: { file: joinPaths(this.entryPath, \"bin.ts\") },\n\t\t\t\t\t\targs: [],\n\t\t\t\t\t\tparent: null,\n\t\t\t\t\t\tchildren: this.commands\n\t\t\t\t\t}));\n\t\t\t\t\treturn render(this, [createComponent(Show, {\n\t\t\t\t\t\tget when() {\n\t\t\t\t\t\t\treturn _self$.config.help.builtins !== false;\n\t\t\t\t\t\t},\n\t\t\t\t\t\tget children() {\n\t\t\t\t\t\t\treturn [\n\t\t\t\t\t\t\t\tcreateComponent(HelpBuiltin, { get command() {\n\t\t\t\t\t\t\t\t\treturn bin.value;\n\t\t\t\t\t\t\t\t} }),\n\t\t\t\t\t\t\t\tcreateComponent(Spacing, {}),\n\t\t\t\t\t\t\t\tcreateComponent(For, {\n\t\t\t\t\t\t\t\t\tget each() {\n\t\t\t\t\t\t\t\t\t\treturn commands.sort((a, b) => a.name.localeCompare(b.name));\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\tdoubleHardline: true,\n\t\t\t\t\t\t\t\t\tchildren: (command) => createComponent(HelpBuiltin, { command })\n\t\t\t\t\t\t\t\t})\n\t\t\t\t\t\t\t];\n\t\t\t\t\t\t}\n\t\t\t\t\t})]);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t];\n};\n\n//#endregion\nexport { plugin as default, plugin };\n//# sourceMappingURL=index.mjs.map"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAkBA,MAAM,UAAU,UAAU,EAAE,KAAK;AAChC,QAAO;EACN,0CAAS,QAAQ,MAAM;2CACf,QAAQ,QAAQ;EACxB;GACC,MAAM;GACN,SAAS;GACT,SAAS;AACR,SAAK,MAAM,qEAAqE;AAChF,WAAO,EAAE,wBAAW,EAAE,SAAS,QAAQ,YAAY,QAAQ,QAAQA,kCAAY,QAAQ,QAAQ,GAAG,QAAQ,UAAU,QAAQ,EAAE,SAAS,EAAE,UAAU,MAAM,CAAC,EAAE;;GAE7J,MAAM,iBAAiB;AACtB,SAAK,MAAM,sDAAsD;AACjE,QAAI,KAAK,OAAO,KAAK,YAAY,OAAO;AACvC,UAAK,WAAW,EAAE;AAClB,SAAI,KAAK,OAAO,MAAM,UAAU,MAAM,SAAS,KAAK,OAAO,KAAK,QAAQ,CAAE,MAAK,KAAK,2LAA2L;SAC1Q,MAAK,OAAO,KAAK;MACrB,IAAI,KAAK,OAAO,KAAK;MACrB,MAAM,KAAK,OAAO,KAAK;MACvB,MAAM,KAAK,OAAO,KAAK;MACvB,UAAU,CAAC,KAAK,OAAO,KAAK,QAAQ;MACpC,OAAO;MACP,aAAa,oHAAgF,MAAM,KAAK,CAAC;MACzG,OAAO;OACN,uCAAgB,KAAK,WAAW,QAAQ,WAAW;OACnD,OAAO,EAAE,uCAAgB,KAAK,WAAW,QAAQ,aAAa,EAAE;OAChE;MACD,WAAW;MACX,CAAC;AACF,uDAAa,sDAAsBC,kCAAa,EAAE,CAAC,CAAC;;;GAGtD,SAAS;IACR,OAAO;IACP,MAAM,UAAU;KACf,MAAM,SAAS;KACf,MAAM,WAAW,yDAAqB,KAAK;AAC3C,UAAK,MAAM,gDAAgD,SAAS,OAAO,mBAAmB;KAC9F,MAAM,0CAAsB;MAC3B,IAAI;MACJ,qDAAiB,KAAK;MACtB,uDAAmB,KAAK;MACxB,mEAA+B,KAAK;MACpC,WAAW;MACX,MAAM;MACN,UAAU,EAAE;MACZ,OAAO,EAAE;MACT,SAAS,OAAO,YAAY,KAAK,QAAQ,KAAK,WAAW,CAAC,OAAO,MAAM,OAAO,CAAC,CAAC;MAChF,OAAO,EAAE,uCAAgB,KAAK,WAAW,SAAS,EAAE;MACpD,MAAM,EAAE;MACR,QAAQ;MACR,UAAU,KAAK;MACf,EAAE;AACH,wDAAc,MAAM,iDAAiBC,qBAAM;MAC1C,IAAI,OAAO;AACV,cAAO,OAAO,OAAO,KAAK,aAAa;;MAExC,IAAI,WAAW;AACd,cAAO;wDACUC,kCAAa,EAAE,IAAI,UAAU;AAC5C,gBAAO,IAAI;WACT,CAAC;wDACYC,kDAAS,EAAE,CAAC;wDACZC,oBAAK;SACpB,IAAI,OAAO;AACV,iBAAO,SAAS,MAAM,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,KAAK,CAAC;;SAE7D,gBAAgB;SAChB,WAAW,4DAA4BF,kCAAa,EAAE,SAAS,CAAC;SAChE,CAAC;QACF;;MAEF,CAAC,CAAC,CAAC;;IAEL;GACD;EACD"}

package/dist/plugin-help/dist/index.d.cts

@@ -0,0 +1,2 @@
+import { HelpPluginContext, HelpPluginOptions, HelpPluginResolvedConfig, HelpPluginUserConfig } from "./types/plugin.cjs";
+import { Plugin } from "powerlines";

package/dist/plugin-help/dist/index.d.mts

@@ -0,0 +1,2 @@
+import { HelpPluginContext, HelpPluginOptions, HelpPluginResolvedConfig, HelpPluginUserConfig } from "./types/plugin.mjs";
+import { Plugin } from "powerlines";

package/dist/plugin-help/dist/index.mjs

@@ -0,0 +1,100 @@
+import { isSetString } from "./node_modules/.pnpm/@stryke_type-checks@0.5.41/node_modules/@stryke/type-checks/dist/is-set-string.mjs";
+import { HelpBuiltin } from "./components/help-builtin.mjs";
+import { HelpCommand } from "./components/help-command.mjs";
+import "./components/index.mjs";
+import { createComponent } from "@alloy-js/core/jsx-runtime";
+import { For, Show, computed } from "@alloy-js/core";
+import { Spacing } from "@powerlines/plugin-alloy/core/components";
+import { render } from "@powerlines/plugin-alloy/render";
+import console from "@shell-shock/plugin-console";
+import { getAppDescription, getAppName, getAppTitle, getCommandList } from "@shell-shock/core/plugin-utils";
+import defu from "defu";
+import theme from "@shell-shock/plugin-theme";
+import { joinPaths } from "@stryke/path/join";
+
+//#region ../plugin-help/dist/index.mjs
+/**
+* The Help - Shell Shock plugin to add a help command to the application.
+*/
+const plugin = (options = {}) => {
+	return [
+		...theme(options.theme),
+		console(options.console),
+		{
+			name: "shell-shock:help",
+			enforce: "post",
+			config() {
+				this.debug("Providing default configuration for the Shell Shock `help` plugin.");
+				return { help: defu({ command: options.command === false ? false : isSetString(options.command) ? options.command : "help" }, options, { builtins: true }) };
+			},
+			async configResolved() {
+				this.debug("Adding the Help command to the application context.");
+				if (this.config.help.command !== false) {
+					this.inputs ??= [];
+					if (this.inputs.some((input) => input.name === this.config.help.command)) this.info("The `help` command already exists in the commands list. If you would like the help command to be managed by the `@shell-shock/plugin-help` package, please remove or rename the command.");
+					else this.inputs.push({
+						id: this.config.help.command,
+						name: this.config.help.command,
+						path: this.config.help.command,
+						segments: [this.config.help.command],
+						title: "Help",
+						description: `A command for displaying help information to assist in using the ${getAppTitle(this, true)} command-line interface application.`,
+						entry: {
+							file: joinPaths(this.entryPath, "help", "index.ts"),
+							input: { file: joinPaths(this.entryPath, "help", "command.ts") }
+						},
+						isVirtual: false
+					});
+					await render(this, createComponent(HelpCommand, {}));
+				}
+			},
+			prepare: {
+				order: "post",
+				async handler() {
+					const _self$ = this;
+					const commands = await getCommandList(this);
+					this.debug(`Rendering \`help\` built-ins for each of the ${commands.length} command modules.`);
+					const bin = computed(() => ({
+						id: "",
+						name: getAppName(this),
+						title: getAppTitle(this),
+						description: getAppDescription(this),
+						isVirtual: true,
+						path: null,
+						segments: [],
+						alias: [],
+						options: Object.fromEntries(this.options.map((option) => [option.name, option])),
+						entry: { file: joinPaths(this.entryPath, "bin.ts") },
+						args: [],
+						parent: null,
+						children: this.commands
+					}));
+					return render(this, [createComponent(Show, {
+						get when() {
+							return _self$.config.help.builtins !== false;
+						},
+						get children() {
+							return [
+								createComponent(HelpBuiltin, { get command() {
+									return bin.value;
+								} }),
+								createComponent(Spacing, {}),
+								createComponent(For, {
+									get each() {
+										return commands.sort((a, b) => a.name.localeCompare(b.name));
+									},
+									doubleHardline: true,
+									children: (command) => createComponent(HelpBuiltin, { command })
+								})
+							];
+						}
+					})]);
+				}
+			}
+		}
+	];
+};
+
+//#endregion
+export { plugin };
+//# sourceMappingURL=index.mjs.map

package/dist/plugin-help/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../plugin-help/dist/index.mjs"],"sourcesContent":["import { isSetString } from \"./node_modules/.pnpm/@stryke_type-checks@0.5.41/node_modules/@stryke/type-checks/dist/is-set-string.mjs\";\nimport { HelpBuiltin } from \"./components/help-builtin.mjs\";\nimport { HelpCommand } from \"./components/help-command.mjs\";\nimport \"./components/index.mjs\";\nimport { createComponent } from \"@alloy-js/core/jsx-runtime\";\nimport { For, Show, computed } from \"@alloy-js/core\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport { getAppDescription, getAppName, getAppTitle, getCommandList } from \"@shell-shock/core/plugin-utils\";\nimport console from \"@shell-shock/plugin-console\";\nimport theme from \"@shell-shock/plugin-theme\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport defu from \"defu\";\n\n//#region src/index.tsx\n/**\n* The Help - Shell Shock plugin to add a help command to the application.\n*/\nconst plugin = (options = {}) => {\n\treturn [\n\t\t...theme(options.theme),\n\t\tconsole(options.console),\n\t\t{\n\t\t\tname: \"shell-shock:help\",\n\t\t\tenforce: \"post\",\n\t\t\tconfig() {\n\t\t\t\tthis.debug(\"Providing default configuration for the Shell Shock `help` plugin.\");\n\t\t\t\treturn { help: defu({ command: options.command === false ? false : isSetString(options.command) ? options.command : \"help\" }, options, { builtins: true }) };\n\t\t\t},\n\t\t\tasync configResolved() {\n\t\t\t\tthis.debug(\"Adding the Help command to the application context.\");\n\t\t\t\tif (this.config.help.command !== false) {\n\t\t\t\t\tthis.inputs ??= [];\n\t\t\t\t\tif (this.inputs.some((input) => input.name === this.config.help.command)) this.info(\"The `help` command already exists in the commands list. If you would like the help command to be managed by the `@shell-shock/plugin-help` package, please remove or rename the command.\");\n\t\t\t\t\telse this.inputs.push({\n\t\t\t\t\t\tid: this.config.help.command,\n\t\t\t\t\t\tname: this.config.help.command,\n\t\t\t\t\t\tpath: this.config.help.command,\n\t\t\t\t\t\tsegments: [this.config.help.command],\n\t\t\t\t\t\ttitle: \"Help\",\n\t\t\t\t\t\tdescription: `A command for displaying help information to assist in using the ${getAppTitle(this, true)} command-line interface application.`,\n\t\t\t\t\t\tentry: {\n\t\t\t\t\t\t\tfile: joinPaths(this.entryPath, \"help\", \"index.ts\"),\n\t\t\t\t\t\t\tinput: { file: joinPaths(this.entryPath, \"help\", \"command.ts\") }\n\t\t\t\t\t\t},\n\t\t\t\t\t\tisVirtual: false\n\t\t\t\t\t});\n\t\t\t\t\tawait render(this, createComponent(HelpCommand, {}));\n\t\t\t\t}\n\t\t\t},\n\t\t\tprepare: {\n\t\t\t\torder: \"post\",\n\t\t\t\tasync handler() {\n\t\t\t\t\tconst _self$ = this;\n\t\t\t\t\tconst commands = await getCommandList(this);\n\t\t\t\t\tthis.debug(`Rendering \\`help\\` built-ins for each of the ${commands.length} command modules.`);\n\t\t\t\t\tconst bin = computed(() => ({\n\t\t\t\t\t\tid: \"\",\n\t\t\t\t\t\tname: getAppName(this),\n\t\t\t\t\t\ttitle: getAppTitle(this),\n\t\t\t\t\t\tdescription: getAppDescription(this),\n\t\t\t\t\t\tisVirtual: true,\n\t\t\t\t\t\tpath: null,\n\t\t\t\t\t\tsegments: [],\n\t\t\t\t\t\talias: [],\n\t\t\t\t\t\toptions: Object.fromEntries(this.options.map((option) => [option.name, option])),\n\t\t\t\t\t\tentry: { file: joinPaths(this.entryPath, \"bin.ts\") },\n\t\t\t\t\t\targs: [],\n\t\t\t\t\t\tparent: null,\n\t\t\t\t\t\tchildren: this.commands\n\t\t\t\t\t}));\n\t\t\t\t\treturn render(this, [createComponent(Show, {\n\t\t\t\t\t\tget when() {\n\t\t\t\t\t\t\treturn _self$.config.help.builtins !== false;\n\t\t\t\t\t\t},\n\t\t\t\t\t\tget children() {\n\t\t\t\t\t\t\treturn [\n\t\t\t\t\t\t\t\tcreateComponent(HelpBuiltin, { get command() {\n\t\t\t\t\t\t\t\t\treturn bin.value;\n\t\t\t\t\t\t\t\t} }),\n\t\t\t\t\t\t\t\tcreateComponent(Spacing, {}),\n\t\t\t\t\t\t\t\tcreateComponent(For, {\n\t\t\t\t\t\t\t\t\tget each() {\n\t\t\t\t\t\t\t\t\t\treturn commands.sort((a, b) => a.name.localeCompare(b.name));\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\tdoubleHardline: true,\n\t\t\t\t\t\t\t\t\tchildren: (command) => createComponent(HelpBuiltin, { command })\n\t\t\t\t\t\t\t\t})\n\t\t\t\t\t\t\t];\n\t\t\t\t\t\t}\n\t\t\t\t\t})]);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t];\n};\n\n//#endregion\nexport { plugin as default, plugin };\n//# sourceMappingURL=index.mjs.map"],"mappings":";;;;;;;;;;;;;;;;;;AAkBA,MAAM,UAAU,UAAU,EAAE,KAAK;AAChC,QAAO;EACN,GAAG,MAAM,QAAQ,MAAM;EACvB,QAAQ,QAAQ,QAAQ;EACxB;GACC,MAAM;GACN,SAAS;GACT,SAAS;AACR,SAAK,MAAM,qEAAqE;AAChF,WAAO,EAAE,MAAM,KAAK,EAAE,SAAS,QAAQ,YAAY,QAAQ,QAAQ,YAAY,QAAQ,QAAQ,GAAG,QAAQ,UAAU,QAAQ,EAAE,SAAS,EAAE,UAAU,MAAM,CAAC,EAAE;;GAE7J,MAAM,iBAAiB;AACtB,SAAK,MAAM,sDAAsD;AACjE,QAAI,KAAK,OAAO,KAAK,YAAY,OAAO;AACvC,UAAK,WAAW,EAAE;AAClB,SAAI,KAAK,OAAO,MAAM,UAAU,MAAM,SAAS,KAAK,OAAO,KAAK,QAAQ,CAAE,MAAK,KAAK,2LAA2L;SAC1Q,MAAK,OAAO,KAAK;MACrB,IAAI,KAAK,OAAO,KAAK;MACrB,MAAM,KAAK,OAAO,KAAK;MACvB,MAAM,KAAK,OAAO,KAAK;MACvB,UAAU,CAAC,KAAK,OAAO,KAAK,QAAQ;MACpC,OAAO;MACP,aAAa,oEAAoE,YAAY,MAAM,KAAK,CAAC;MACzG,OAAO;OACN,MAAM,UAAU,KAAK,WAAW,QAAQ,WAAW;OACnD,OAAO,EAAE,MAAM,UAAU,KAAK,WAAW,QAAQ,aAAa,EAAE;OAChE;MACD,WAAW;MACX,CAAC;AACF,WAAM,OAAO,MAAM,gBAAgB,aAAa,EAAE,CAAC,CAAC;;;GAGtD,SAAS;IACR,OAAO;IACP,MAAM,UAAU;KACf,MAAM,SAAS;KACf,MAAM,WAAW,MAAM,eAAe,KAAK;AAC3C,UAAK,MAAM,gDAAgD,SAAS,OAAO,mBAAmB;KAC9F,MAAM,MAAM,gBAAgB;MAC3B,IAAI;MACJ,MAAM,WAAW,KAAK;MACtB,OAAO,YAAY,KAAK;MACxB,aAAa,kBAAkB,KAAK;MACpC,WAAW;MACX,MAAM;MACN,UAAU,EAAE;MACZ,OAAO,EAAE;MACT,SAAS,OAAO,YAAY,KAAK,QAAQ,KAAK,WAAW,CAAC,OAAO,MAAM,OAAO,CAAC,CAAC;MAChF,OAAO,EAAE,MAAM,UAAU,KAAK,WAAW,SAAS,EAAE;MACpD,MAAM,EAAE;MACR,QAAQ;MACR,UAAU,KAAK;MACf,EAAE;AACH,YAAO,OAAO,MAAM,CAAC,gBAAgB,MAAM;MAC1C,IAAI,OAAO;AACV,cAAO,OAAO,OAAO,KAAK,aAAa;;MAExC,IAAI,WAAW;AACd,cAAO;QACN,gBAAgB,aAAa,EAAE,IAAI,UAAU;AAC5C,gBAAO,IAAI;WACT,CAAC;QACJ,gBAAgB,SAAS,EAAE,CAAC;QAC5B,gBAAgB,KAAK;SACpB,IAAI,OAAO;AACV,iBAAO,SAAS,MAAM,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,KAAK,CAAC;;SAE7D,gBAAgB;SAChB,WAAW,YAAY,gBAAgB,aAAa,EAAE,SAAS,CAAC;SAChE,CAAC;QACF;;MAEF,CAAC,CAAC,CAAC;;IAEL;GACD;EACD"}

package/dist/plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/constant-case.cjs

@@ -0,0 +1,18 @@
+
+//#region ../plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/constant-case.mjs
+/**
+* Check if the input string is in constant case.
+*
+* @remarks
+* Constant case is defined as all uppercase letters with underscores separating words - "THIS_IS_AN_EXAMPLE".
+*
+* @param input - The input string to check.
+* @returns True if the input is in constant case, false otherwise.
+*/
+function isConstantCase(input) {
+	return input ? /^[A-Z0-9_]+$/.test(input) : false;
+}
+
+//#endregion
+exports.isConstantCase = isConstantCase;
+//# sourceMappingURL=constant-case.cjs.map

package/dist/plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/constant-case.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant-case.cjs","names":[],"sources":["../../../../../../../../../../../plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/constant-case.mjs"],"sourcesContent":["//#region ../../node_modules/.pnpm/@stryke+string-format@0.17.6/node_modules/@stryke/string-format/dist/constant-case.mjs\n/**\n* Check if the input string is in constant case.\n*\n* @remarks\n* Constant case is defined as all uppercase letters with underscores separating words - \"THIS_IS_AN_EXAMPLE\".\n*\n* @param input - The input string to check.\n* @returns True if the input is in constant case, false otherwise.\n*/\nfunction isConstantCase(input) {\n\treturn input ? /^[A-Z0-9_]+$/.test(input) : false;\n}\n\n//#endregion\nexport { isConstantCase };\n//# sourceMappingURL=constant-case.mjs.map"],"x_google_ignoreList":[0],"mappings":";;;;;;;;;;;AAUA,SAAS,eAAe,OAAO;AAC9B,QAAO,QAAQ,eAAe,KAAK,MAAM,GAAG"}

package/dist/plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/constant-case.mjs

@@ -0,0 +1,17 @@
+//#region ../plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/constant-case.mjs
+/**
+* Check if the input string is in constant case.
+*
+* @remarks
+* Constant case is defined as all uppercase letters with underscores separating words - "THIS_IS_AN_EXAMPLE".
+*
+* @param input - The input string to check.
+* @returns True if the input is in constant case, false otherwise.
+*/
+function isConstantCase(input) {
+	return input ? /^[A-Z0-9_]+$/.test(input) : false;
+}
+
+//#endregion
+export { isConstantCase };
+//# sourceMappingURL=constant-case.mjs.map

package/dist/plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/constant-case.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant-case.mjs","names":[],"sources":["../../../../../../../../../../../plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/constant-case.mjs"],"sourcesContent":["//#region ../../node_modules/.pnpm/@stryke+string-format@0.17.6/node_modules/@stryke/string-format/dist/constant-case.mjs\n/**\n* Check if the input string is in constant case.\n*\n* @remarks\n* Constant case is defined as all uppercase letters with underscores separating words - \"THIS_IS_AN_EXAMPLE\".\n*\n* @param input - The input string to check.\n* @returns True if the input is in constant case, false otherwise.\n*/\nfunction isConstantCase(input) {\n\treturn input ? /^[A-Z0-9_]+$/.test(input) : false;\n}\n\n//#endregion\nexport { isConstantCase };\n//# sourceMappingURL=constant-case.mjs.map"],"x_google_ignoreList":[0],"mappings":";;;;;;;;;;AAUA,SAAS,eAAe,OAAO;AAC9B,QAAO,QAAQ,eAAe,KAAK,MAAM,GAAG"}

package/dist/plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/get-words.cjs

@@ -0,0 +1,39 @@
+
+//#region ../plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/get-words.mjs
+/**
+* Regular expression pattern to split strings into words for various case conversions
+*
+* This pattern matches sequences of characters in a string, considering the following case:
+* - Sequences of two or more uppercase letters followed by an uppercase letter and lowercase letters or digits (for acronyms)
+* - Sequences of one uppercase letter optionally followed by lowercase letters and digits
+* - Single uppercase letters
+* - Sequences of digits
+*
+* The resulting match can be used to convert camelCase, snake_case, kebab-case, and other mixed formats into
+* a consistent format like snake case.
+*
+* @example
+* const matches = 'camelCaseHTTPRequest'.match(CASE_SPLIT_PATTERN);
+* // matches: ['camel', 'Case', 'HTTP', 'Request']
+*/
+const CASE_SPLIT_PATTERN = /[A-Z]?[a-z]+|\d+|[A-Z]+(?![a-z])/g;
+const RELAXED_SPLIT_PATTERN = /[A-Z/.-]?[a-z/.-]+|\d+|[A-Z/.-]+(?![a-z/.-])/g;
+/**
+* Splits a string into words using a regular expression pattern
+*
+* @example
+* const words = getWords('camelCaseHTTPRequest');
+* // words: ['camel', 'Case', 'HTTP', 'Request']
+*
+* @param str - The string to split into words
+* @param options - Options for splitting the string
+* @returns An array of words
+*/
+function getWords(str, options = {}) {
+	if (str.length > 5e3) throw new Error("The regular expression parameter of `get-words` can't handle strings longer than 2000 characters");
+	return [...str.match(options.split ?? (options.relaxed ? RELAXED_SPLIT_PATTERN : CASE_SPLIT_PATTERN)) ?? []];
+}
+
+//#endregion
+exports.getWords = getWords;
+//# sourceMappingURL=get-words.cjs.map

package/dist/plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/get-words.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-words.cjs","names":[],"sources":["../../../../../../../../../../../plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/get-words.mjs"],"sourcesContent":["//#region ../../node_modules/.pnpm/@stryke+string-format@0.17.6/node_modules/@stryke/string-format/dist/get-words.mjs\n/**\n* Regular expression pattern to split strings into words for various case conversions\n*\n* This pattern matches sequences of characters in a string, considering the following case:\n* - Sequences of two or more uppercase letters followed by an uppercase letter and lowercase letters or digits (for acronyms)\n* - Sequences of one uppercase letter optionally followed by lowercase letters and digits\n* - Single uppercase letters\n* - Sequences of digits\n*\n* The resulting match can be used to convert camelCase, snake_case, kebab-case, and other mixed formats into\n* a consistent format like snake case.\n*\n* @example\n* const matches = 'camelCaseHTTPRequest'.match(CASE_SPLIT_PATTERN);\n* // matches: ['camel', 'Case', 'HTTP', 'Request']\n*/\nconst CASE_SPLIT_PATTERN = /[A-Z]?[a-z]+|\\d+|[A-Z]+(?![a-z])/g;\nconst RELAXED_SPLIT_PATTERN = /[A-Z/.-]?[a-z/.-]+|\\d+|[A-Z/.-]+(?![a-z/.-])/g;\n/**\n* Splits a string into words using a regular expression pattern\n*\n* @example\n* const words = getWords('camelCaseHTTPRequest');\n* // words: ['camel', 'Case', 'HTTP', 'Request']\n*\n* @param str - The string to split into words\n* @param options - Options for splitting the string\n* @returns An array of words\n*/\nfunction getWords(str, options = {}) {\n\tif (str.length > 5e3) throw new Error(\"The regular expression parameter of `get-words` can't handle strings longer than 2000 characters\");\n\treturn [...str.match(options.split ?? (options.relaxed ? RELAXED_SPLIT_PATTERN : CASE_SPLIT_PATTERN)) ?? []];\n}\n\n//#endregion\nexport { getWords };\n//# sourceMappingURL=get-words.mjs.map"],"x_google_ignoreList":[0],"mappings":";;;;;;;;;;;;;;;;;;AAiBA,MAAM,qBAAqB;AAC3B,MAAM,wBAAwB;;;;;;;;;;;;AAY9B,SAAS,SAAS,KAAK,UAAU,EAAE,EAAE;AACpC,KAAI,IAAI,SAAS,IAAK,OAAM,IAAI,MAAM,mGAAmG;AACzI,QAAO,CAAC,GAAG,IAAI,MAAM,QAAQ,UAAU,QAAQ,UAAU,wBAAwB,oBAAoB,IAAI,EAAE,CAAC"}

package/dist/plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/get-words.mjs

@@ -0,0 +1,38 @@
+//#region ../plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/get-words.mjs
+/**
+* Regular expression pattern to split strings into words for various case conversions
+*
+* This pattern matches sequences of characters in a string, considering the following case:
+* - Sequences of two or more uppercase letters followed by an uppercase letter and lowercase letters or digits (for acronyms)
+* - Sequences of one uppercase letter optionally followed by lowercase letters and digits
+* - Single uppercase letters
+* - Sequences of digits
+*
+* The resulting match can be used to convert camelCase, snake_case, kebab-case, and other mixed formats into
+* a consistent format like snake case.
+*
+* @example
+* const matches = 'camelCaseHTTPRequest'.match(CASE_SPLIT_PATTERN);
+* // matches: ['camel', 'Case', 'HTTP', 'Request']
+*/
+const CASE_SPLIT_PATTERN = /[A-Z]?[a-z]+|\d+|[A-Z]+(?![a-z])/g;
+const RELAXED_SPLIT_PATTERN = /[A-Z/.-]?[a-z/.-]+|\d+|[A-Z/.-]+(?![a-z/.-])/g;
+/**
+* Splits a string into words using a regular expression pattern
+*
+* @example
+* const words = getWords('camelCaseHTTPRequest');
+* // words: ['camel', 'Case', 'HTTP', 'Request']
+*
+* @param str - The string to split into words
+* @param options - Options for splitting the string
+* @returns An array of words
+*/
+function getWords(str, options = {}) {
+	if (str.length > 5e3) throw new Error("The regular expression parameter of `get-words` can't handle strings longer than 2000 characters");
+	return [...str.match(options.split ?? (options.relaxed ? RELAXED_SPLIT_PATTERN : CASE_SPLIT_PATTERN)) ?? []];
+}
+
+//#endregion
+export { getWords };
+//# sourceMappingURL=get-words.mjs.map

package/dist/plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/get-words.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-words.mjs","names":[],"sources":["../../../../../../../../../../../plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/get-words.mjs"],"sourcesContent":["//#region ../../node_modules/.pnpm/@stryke+string-format@0.17.6/node_modules/@stryke/string-format/dist/get-words.mjs\n/**\n* Regular expression pattern to split strings into words for various case conversions\n*\n* This pattern matches sequences of characters in a string, considering the following case:\n* - Sequences of two or more uppercase letters followed by an uppercase letter and lowercase letters or digits (for acronyms)\n* - Sequences of one uppercase letter optionally followed by lowercase letters and digits\n* - Single uppercase letters\n* - Sequences of digits\n*\n* The resulting match can be used to convert camelCase, snake_case, kebab-case, and other mixed formats into\n* a consistent format like snake case.\n*\n* @example\n* const matches = 'camelCaseHTTPRequest'.match(CASE_SPLIT_PATTERN);\n* // matches: ['camel', 'Case', 'HTTP', 'Request']\n*/\nconst CASE_SPLIT_PATTERN = /[A-Z]?[a-z]+|\\d+|[A-Z]+(?![a-z])/g;\nconst RELAXED_SPLIT_PATTERN = /[A-Z/.-]?[a-z/.-]+|\\d+|[A-Z/.-]+(?![a-z/.-])/g;\n/**\n* Splits a string into words using a regular expression pattern\n*\n* @example\n* const words = getWords('camelCaseHTTPRequest');\n* // words: ['camel', 'Case', 'HTTP', 'Request']\n*\n* @param str - The string to split into words\n* @param options - Options for splitting the string\n* @returns An array of words\n*/\nfunction getWords(str, options = {}) {\n\tif (str.length > 5e3) throw new Error(\"The regular expression parameter of `get-words` can't handle strings longer than 2000 characters\");\n\treturn [...str.match(options.split ?? (options.relaxed ? RELAXED_SPLIT_PATTERN : CASE_SPLIT_PATTERN)) ?? []];\n}\n\n//#endregion\nexport { getWords };\n//# sourceMappingURL=get-words.mjs.map"],"x_google_ignoreList":[0],"mappings":";;;;;;;;;;;;;;;;;AAiBA,MAAM,qBAAqB;AAC3B,MAAM,wBAAwB;;;;;;;;;;;;AAY9B,SAAS,SAAS,KAAK,UAAU,EAAE,EAAE;AACpC,KAAI,IAAI,SAAS,IAAK,OAAM,IAAI,MAAM,mGAAmG;AACzI,QAAO,CAAC,GAAG,IAAI,MAAM,QAAQ,UAAU,QAAQ,UAAU,wBAAwB,oBAAoB,IAAI,EAAE,CAAC"}

package/dist/plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/kebab-case.cjs

@@ -0,0 +1,34 @@
+const require_get_words = require('./get-words.cjs');
+
+//#region ../plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/kebab-case.mjs
+/**
+* Check if the input string is in kebab case.
+*
+* @remarks
+* Kebab case is defined as all lowercase letters with hyphens separating words - "this-is-an-example".
+*
+* @param input - The input string to check.
+* @returns True if the input is in kebab case, false otherwise.
+*/
+function isKebabCase(input) {
+	return input ? /^[a-z]+(?:-[a-z0-9]+)*$/.test(input) : false;
+}
+/**
+* Convert the input string to kebab case.
+*
+* @remarks
+* Kebab case is defined as all lowercase letters with hyphens separating words - "this-is-an-example".
+*
+* @param input - The input string.
+* @returns The kebab-cased string.
+*/
+function kebabCase(input) {
+	if (isKebabCase(input) || input === void 0) return input;
+	const parts = input ? require_get_words.getWords(input) : [];
+	if (parts.length === 0) return "";
+	return parts.join("-").toLowerCase();
+}
+
+//#endregion
+exports.kebabCase = kebabCase;
+//# sourceMappingURL=kebab-case.cjs.map

package/dist/plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/kebab-case.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"kebab-case.cjs","names":["getWords"],"sources":["../../../../../../../../../../../plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/kebab-case.mjs"],"sourcesContent":["import { getWords } from \"./get-words.mjs\";\n\n//#region ../../node_modules/.pnpm/@stryke+string-format@0.17.6/node_modules/@stryke/string-format/dist/kebab-case.mjs\n/**\n* Check if the input string is in kebab case.\n*\n* @remarks\n* Kebab case is defined as all lowercase letters with hyphens separating words - \"this-is-an-example\".\n*\n* @param input - The input string to check.\n* @returns True if the input is in kebab case, false otherwise.\n*/\nfunction isKebabCase(input) {\n\treturn input ? /^[a-z]+(?:-[a-z0-9]+)*$/.test(input) : false;\n}\n/**\n* Convert the input string to kebab case.\n*\n* @remarks\n* Kebab case is defined as all lowercase letters with hyphens separating words - \"this-is-an-example\".\n*\n* @param input - The input string.\n* @returns The kebab-cased string.\n*/\nfunction kebabCase(input) {\n\tif (isKebabCase(input) || input === void 0) return input;\n\tconst parts = input ? getWords(input) : [];\n\tif (parts.length === 0) return \"\";\n\treturn parts.join(\"-\").toLowerCase();\n}\n\n//#endregion\nexport { kebabCase };\n//# sourceMappingURL=kebab-case.mjs.map"],"x_google_ignoreList":[0],"mappings":";;;;;;;;;;;;AAYA,SAAS,YAAY,OAAO;AAC3B,QAAO,QAAQ,0BAA0B,KAAK,MAAM,GAAG;;;;;;;;;;;AAWxD,SAAS,UAAU,OAAO;AACzB,KAAI,YAAY,MAAM,IAAI,UAAU,KAAK,EAAG,QAAO;CACnD,MAAM,QAAQ,QAAQA,2BAAS,MAAM,GAAG,EAAE;AAC1C,KAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,QAAO,MAAM,KAAK,IAAI,CAAC,aAAa"}

package/dist/plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/kebab-case.mjs

@@ -0,0 +1,34 @@
+import { getWords } from "./get-words.mjs";
+
+//#region ../plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/kebab-case.mjs
+/**
+* Check if the input string is in kebab case.
+*
+* @remarks
+* Kebab case is defined as all lowercase letters with hyphens separating words - "this-is-an-example".
+*
+* @param input - The input string to check.
+* @returns True if the input is in kebab case, false otherwise.
+*/
+function isKebabCase(input) {
+	return input ? /^[a-z]+(?:-[a-z0-9]+)*$/.test(input) : false;
+}
+/**
+* Convert the input string to kebab case.
+*
+* @remarks
+* Kebab case is defined as all lowercase letters with hyphens separating words - "this-is-an-example".
+*
+* @param input - The input string.
+* @returns The kebab-cased string.
+*/
+function kebabCase(input) {
+	if (isKebabCase(input) || input === void 0) return input;
+	const parts = input ? getWords(input) : [];
+	if (parts.length === 0) return "";
+	return parts.join("-").toLowerCase();
+}
+
+//#endregion
+export { kebabCase };
+//# sourceMappingURL=kebab-case.mjs.map

package/dist/plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/kebab-case.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"kebab-case.mjs","names":[],"sources":["../../../../../../../../../../../plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/kebab-case.mjs"],"sourcesContent":["import { getWords } from \"./get-words.mjs\";\n\n//#region ../../node_modules/.pnpm/@stryke+string-format@0.17.6/node_modules/@stryke/string-format/dist/kebab-case.mjs\n/**\n* Check if the input string is in kebab case.\n*\n* @remarks\n* Kebab case is defined as all lowercase letters with hyphens separating words - \"this-is-an-example\".\n*\n* @param input - The input string to check.\n* @returns True if the input is in kebab case, false otherwise.\n*/\nfunction isKebabCase(input) {\n\treturn input ? /^[a-z]+(?:-[a-z0-9]+)*$/.test(input) : false;\n}\n/**\n* Convert the input string to kebab case.\n*\n* @remarks\n* Kebab case is defined as all lowercase letters with hyphens separating words - \"this-is-an-example\".\n*\n* @param input - The input string.\n* @returns The kebab-cased string.\n*/\nfunction kebabCase(input) {\n\tif (isKebabCase(input) || input === void 0) return input;\n\tconst parts = input ? getWords(input) : [];\n\tif (parts.length === 0) return \"\";\n\treturn parts.join(\"-\").toLowerCase();\n}\n\n//#endregion\nexport { kebabCase };\n//# sourceMappingURL=kebab-case.mjs.map"],"x_google_ignoreList":[0],"mappings":";;;;;;;;;;;;AAYA,SAAS,YAAY,OAAO;AAC3B,QAAO,QAAQ,0BAA0B,KAAK,MAAM,GAAG;;;;;;;;;;;AAWxD,SAAS,UAAU,OAAO;AACzB,KAAI,YAAY,MAAM,IAAI,UAAU,KAAK,EAAG,QAAO;CACnD,MAAM,QAAQ,QAAQ,SAAS,MAAM,GAAG,EAAE;AAC1C,KAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,QAAO,MAAM,KAAK,IAAI,CAAC,aAAa"}

package/dist/plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/snake-case.cjs

@@ -0,0 +1,41 @@
+const require_upper_case_first = require('./upper-case-first.cjs');
+const require_constant_case = require('./constant-case.cjs');
+
+//#region ../plugin-help/dist/node_modules/.pnpm/@stryke_string-format@0.17.6/node_modules/@stryke/string-format/dist/snake-case.mjs
+/**
+* Check if the input string is in snake case.
+*
+* @remarks
+* Snake case is defined as all lowercase letters with underscores separating words - "this_is_an_example"
+*
+* @param input - The input string to check.
+* @returns True if the input is in snake case, false otherwise.
+*/
+function isSnakeCase(input) {
+	return input ? /^[a-z]+(?:_[a-z0-9]+)*$/.test(input) : false;
+}
+/**
+* Convert the input string to snake case.
+*
+*  @remarks
+* Snake case is defined as all lowercase letters with underscores separating words - "this_is_an_example"
+*
+* @param input - The input string.
+* @param options - Options to control the behavior of the function.
+* @returns The snake-cased string.
+*/
+function snakeCase(input, options) {
+	if (isSnakeCase(input) || input === void 0) return input;
+	if (require_constant_case.isConstantCase(input)) return input.toLowerCase();
+	const parts = input?.replace(/[A-Z]+/g, (input$1) => require_upper_case_first.upperCaseFirst(input$1) ?? "").split(/(?=[A-Z])|[\s._-]/).map((x) => x.toLowerCase()) ?? [];
+	if (parts.length === 0) return "";
+	if (parts.length === 1) return parts[0];
+	const result = parts.reduce((ret, part) => {
+		return `${ret}_${part.toLowerCase()}`;
+	});
+	return options?.splitOnNumber === false ? result : result.replace(/[A-Z]\d/i, (val) => `${val[0]}_${val[1]}`);
+}
+
+//#endregion
+exports.snakeCase = snakeCase;
+//# sourceMappingURL=snake-case.cjs.map