@shell-shock/preset-cli 0.9.7 → 0.9.9

package/dist/helpers/{get-default-options.cjs → get-global-options.cjs}

@@ -1,8 +1,8 @@
 const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 let _shell_shock_core = require("@shell-shock/core");
-let _shell_shock_preset_script_helpers_get_default_options = require("@shell-shock/preset-script/helpers/get-default-options");
+let _shell_shock_preset_script_helpers_get_global_options = require("@shell-shock/preset-script/helpers/get-global-options");
 
-//#region src/helpers/get-default-options.ts
+//#region src/helpers/get-global-options.ts
 /**
 * Get the default command options.
 *
@@ -10,9 +10,9 @@ let _shell_shock_preset_script_helpers_get_default_options = require("@shell-sho
 * @param _ - The command input.
 * @returns The default command options.
 */
-function getDefaultOptions(context, _) {
+function getGlobalOptions(context, _) {
 	return [
-		...(0, _shell_shock_preset_script_helpers_get_default_options.getDefaultOptions)(),
+		...(0, _shell_shock_preset_script_helpers_get_global_options.getGlobalOptions)(),
 		context.config.interactive !== "never" && context.config.interactive !== true && {
 			name: "interactive",
 			title: "Interactive",
@@ -36,4 +36,4 @@ function getDefaultOptions(context, _) {
 }
 
 //#endregion
-exports.getDefaultOptions = getDefaultOptions;
+exports.getGlobalOptions = getGlobalOptions;

package/dist/helpers/{get-default-options.mjs → get-global-options.mjs}

@@ -1,7 +1,7 @@
 import { CommandParameterKinds } from "@shell-shock/core";
-import { getDefaultOptions } from "@shell-shock/preset-script/helpers/get-default-options";
+import { getGlobalOptions } from "@shell-shock/preset-script/helpers/get-global-options";
 
-//#region src/helpers/get-default-options.ts
+//#region src/helpers/get-global-options.ts
 /**
 * Get the default command options.
 *
@@ -9,9 +9,9 @@ import { getDefaultOptions } from "@shell-shock/preset-script/helpers/get-defaul
 * @param _ - The command input.
 * @returns The default command options.
 */
-function getDefaultOptions$1(context, _) {
+function getGlobalOptions$1(context, _) {
 	return [
-		...getDefaultOptions(),
+		...getGlobalOptions(),
 		context.config.interactive !== "never" && context.config.interactive !== true && {
 			name: "interactive",
 			title: "Interactive",
@@ -35,5 +35,5 @@ function getDefaultOptions$1(context, _) {
 }
 
 //#endregion
-export { getDefaultOptions$1 as getDefaultOptions };
-//# sourceMappingURL=get-default-options.mjs.map
+export { getGlobalOptions$1 as getGlobalOptions };
+//# sourceMappingURL=get-global-options.mjs.map

package/dist/helpers/get-global-options.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-global-options.mjs","names":["getGlobalOptions","_getGlobalOptions"],"sources":["../../src/helpers/get-global-options.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 type { CommandBase, CommandOption } from \"@shell-shock/core\";\nimport { CommandParameterKinds } from \"@shell-shock/core\";\nimport { getGlobalOptions as _getGlobalOptions } from \"@shell-shock/preset-script/helpers/get-global-options\";\nimport type { CLIPresetContext } from \"../types\";\n\n/**\n * Get the default command options.\n *\n * @param context - The build context.\n * @param _ - The command input.\n * @returns The default command options.\n */\nexport function getGlobalOptions(\n  context: CLIPresetContext,\n  _: CommandBase\n): CommandOption[] {\n  return [\n    ..._getGlobalOptions(),\n    context.config.interactive !== \"never\" &&\n      context.config.interactive !== true && {\n        name: \"interactive\",\n        title: \"Interactive\",\n        description:\n          \"Enable interactive mode - will be set to false if running in a CI pipeline.\",\n        alias: [\"i\", \"interact\"],\n        kind: CommandParameterKinds.boolean,\n        optional: true,\n        default: context.config.interactive !== false\n      },\n    context.config.interactive !== \"never\" &&\n      context.config.interactive !== false && {\n        name: \"non-interactive\",\n        title: \"Non-Interactive\",\n        description:\n          \"Disable interactive mode - will be set to true if running in a CI pipeline.\",\n        alias: [\"no-interactive\"],\n        kind: CommandParameterKinds.boolean,\n        optional: true,\n        default: false,\n        isNegativeOf: \"interactive\"\n      }\n  ].filter(Boolean) as CommandOption[];\n}\n"],"mappings":";;;;;;;;;;;AA8BA,SAAgBA,mBACd,SACA,GACiB;AACjB,QAAO;EACL,GAAGC,kBAAmB;EACtB,QAAQ,OAAO,gBAAgB,WAC7B,QAAQ,OAAO,gBAAgB,QAAQ;GACrC,MAAM;GACN,OAAO;GACP,aACE;GACF,OAAO,CAAC,KAAK,WAAW;GACxB,MAAM,sBAAsB;GAC5B,UAAU;GACV,SAAS,QAAQ,OAAO,gBAAgB;GACzC;EACH,QAAQ,OAAO,gBAAgB,WAC7B,QAAQ,OAAO,gBAAgB,SAAS;GACtC,MAAM;GACN,OAAO;GACP,aACE;GACF,OAAO,CAAC,iBAAiB;GACzB,MAAM,sBAAsB;GAC5B,UAAU;GACV,SAAS;GACT,cAAc;GACf;EACJ,CAAC,OAAO,QAAQ"}

package/dist/index.cjs

@@ -1,17 +1,19 @@
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
 const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+const require_index = require('./plugin-changelog/dist/index.cjs');
 const require_components_banner_builtin = require('./components/banner-builtin.cjs');
 const require_components_command_router = require('./components/command-router.cjs');
 const require_components_virtual_command_entry = require('./components/virtual-command-entry.cjs');
 const require_components_command_entry = require('./components/command-entry.cjs');
 const require_components_upgrade_builtin = require('./components/upgrade-builtin.cjs');
-const require_get_default_options = require('./helpers/get-default-options.cjs');
+const require_get_global_options = require('./helpers/get-global-options.cjs');
 let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
 let _alloy_js_core = require("@alloy-js/core");
 let _alloy_js_typescript = require("@alloy-js/typescript");
 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_core_plugin_utils = require("@shell-shock/core/plugin-utils");
+let _stryke_path = require("@stryke/path");
 let _shell_shock_plugin_completions = require("@shell-shock/plugin-completions");
 _shell_shock_plugin_completions = require_runtime.__toESM(_shell_shock_plugin_completions);
 let _shell_shock_plugin_console = require("@shell-shock/plugin-console");
@@ -23,7 +25,6 @@ _shell_shock_plugin_prompts = require_runtime.__toESM(_shell_shock_plugin_prompt
 let _shell_shock_plugin_upgrade = require("@shell-shock/plugin-upgrade");
 _shell_shock_plugin_upgrade = require_runtime.__toESM(_shell_shock_plugin_upgrade);
 let _shell_shock_preset_script_components_bin_entry = require("@shell-shock/preset-script/components/bin-entry");
-let _stryke_path = require("@stryke/path");
 
 //#region src/index.tsx
 /**
@@ -37,6 +38,7 @@ const plugin = (options = {}) => {
 		...(0, _shell_shock_plugin_console.default)(options),
 		...(0, _shell_shock_plugin_help.default)(options),
 		...(0, _shell_shock_plugin_prompts.default)(options),
+		...options.changelog !== false ? [require_index.plugin(options.changelog)] : [],
 		...options.completions !== false ? (0, _shell_shock_plugin_completions.default)(options.completions) : [],
 		(0, _shell_shock_plugin_upgrade.default)(options),
 		{
@@ -44,7 +46,7 @@ const plugin = (options = {}) => {
 			config() {
 				this.debug("Providing default configuration for the Shell Shock `cli` preset.");
 				return {
-					defaultOptions: require_get_default_options.getDefaultOptions,
+					globalOptions: require_get_global_options.getGlobalOptions,
 					isCaseSensitive: false,
 					...options
 				};
@@ -107,14 +109,12 @@ const plugin = (options = {}) => {
 								"divider",
 								"stripAnsi",
 								"writeLine",
-								"splitText",
-								"colors"
+								"splitText"
 							],
-							utils: [
-								"useApp",
+							utils: ["isMinimal", "isInteractive"],
+							state: [
+								"useGlobal",
 								"useArgs",
-								"isMinimal",
-								"isInteractive",
 								"isHelp"
 							],
 							prompts: [

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.tsx"],"mappings":";;;;;;AAiDA;;;;cAAa,MAAA,oBAA2B,gBAAA,GAAmB,gBAAA,EACzD,OAAA,GAAS,gBAAA,KACR,MAAA,CAAO,QAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.tsx"],"mappings":";;;;;;AAkDA;;;;cAAa,MAAA,oBAA2B,gBAAA,GAAmB,gBAAA,EACzD,OAAA,GAAS,gBAAA,KACR,MAAA,CAAO,QAAA"}

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.tsx"],"mappings":";;;;;;AAiDA;;;;cAAa,MAAA,oBAA2B,gBAAA,GAAmB,gBAAA,EACzD,OAAA,GAAS,gBAAA,KACR,MAAA,CAAO,QAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.tsx"],"mappings":";;;;;;AAkDA;;;;cAAa,MAAA,oBAA2B,gBAAA,GAAmB,gBAAA,EACzD,OAAA,GAAS,gBAAA,KACR,MAAA,CAAO,QAAA"}

package/dist/index.mjs

@@ -1,22 +1,23 @@
+import { plugin as plugin$1 } from "./packages/plugin-changelog/dist/index.mjs";
 import { BannerBuiltin } from "./components/banner-builtin.mjs";
 import { CommandRouter } from "./components/command-router.mjs";
 import { VirtualCommandEntry } from "./components/virtual-command-entry.mjs";
 import { CommandEntry } from "./components/command-entry.mjs";
 import { UpgradeBuiltin } from "./components/upgrade-builtin.mjs";
-import { getDefaultOptions } from "./helpers/get-default-options.mjs";
+import { getGlobalOptions } from "./helpers/get-global-options.mjs";
 import { createComponent, createIntrinsic, memo } from "@alloy-js/core/jsx-runtime";
 import { For, Show, code, computed } from "@alloy-js/core";
 import { VarDeclaration } from "@alloy-js/typescript";
 import { Spacing } from "@powerlines/plugin-alloy/core/components";
 import { render } from "@powerlines/plugin-alloy/render";
 import { getAppDescription, getAppName, getCommandList } from "@shell-shock/core/plugin-utils";
+import { joinPaths } from "@stryke/path";
 import completions from "@shell-shock/plugin-completions";
 import console from "@shell-shock/plugin-console";
 import help from "@shell-shock/plugin-help";
 import prompts from "@shell-shock/plugin-prompts";
 import upgrade from "@shell-shock/plugin-upgrade";
 import { BinEntry } from "@shell-shock/preset-script/components/bin-entry";
-import { joinPaths } from "@stryke/path";
 
 //#region src/index.tsx
 /**
@@ -30,6 +31,7 @@ const plugin = (options = {}) => {
 		...console(options),
 		...help(options),
 		...prompts(options),
+		...options.changelog !== false ? [plugin$1(options.changelog)] : [],
 		...options.completions !== false ? completions(options.completions) : [],
 		upgrade(options),
 		{
@@ -37,7 +39,7 @@ const plugin = (options = {}) => {
 			config() {
 				this.debug("Providing default configuration for the Shell Shock `cli` preset.");
 				return {
-					defaultOptions: getDefaultOptions,
+					globalOptions: getGlobalOptions,
 					isCaseSensitive: false,
 					...options
 				};
@@ -100,14 +102,12 @@ const plugin = (options = {}) => {
 								"divider",
 								"stripAnsi",
 								"writeLine",
-								"splitText",
-								"colors"
+								"splitText"
 							],
-							utils: [
-								"useApp",
+							utils: ["isMinimal", "isInteractive"],
+							state: [
+								"useGlobal",
 								"useArgs",
-								"isMinimal",
-								"isInteractive",
 								"isHelp"
 							],
 							prompts: [

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport { VarDeclaration } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport {\n  getAppDescription,\n  getAppName,\n  getCommandList\n} from \"@shell-shock/core/plugin-utils\";\nimport completions from \"@shell-shock/plugin-completions\";\nimport console from \"@shell-shock/plugin-console\";\nimport help from \"@shell-shock/plugin-help\";\nimport prompts from \"@shell-shock/plugin-prompts\";\nimport upgrade from \"@shell-shock/plugin-upgrade\";\nimport { BinEntry } from \"@shell-shock/preset-script/components/bin-entry\";\nimport { joinPaths } from \"@stryke/path\";\nimport type { Plugin } from \"powerlines\";\nimport { BannerBuiltin } from \"./components/banner-builtin\";\nimport { CommandEntry } from \"./components/command-entry\";\nimport { CommandRouter } from \"./components/command-router\";\nimport { UpgradeBuiltin } from \"./components/upgrade-builtin\";\nimport { VirtualCommandEntry } from \"./components/virtual-command-entry\";\nimport { getDefaultOptions } from \"./helpers/get-default-options\";\nimport type { CLIPresetContext, CLIPresetOptions } from \"./types/plugin\";\n\n/**\n * The Shell Shock CLI Preset plugin.\n *\n * @remarks\n * This preset includes a set of built-in modules and commands to create a CLI application, as well as configuration options to customize the generated code. It also includes the `prompts` plugin to provide interactive prompts in the CLI application, and the `upgrade` plugin to manage upgrading the local application's version.\n */\nexport const plugin = <TContext extends CLIPresetContext = CLIPresetContext>(\n  options: CLIPresetOptions = {}\n): Plugin<TContext>[] => {\n  return [\n    ...console<TContext>(options),\n    ...help<TContext>(options),\n    ...prompts<TContext>(options),\n    ...(options.completions !== false\n      ? completions<TContext>(options.completions)\n      : []),\n    upgrade<TContext>(options),\n    {\n      name: \"shell-shock:cli-preset\",\n      config() {\n        this.debug(\n          \"Providing default configuration for the Shell Shock `cli` preset.\"\n        );\n\n        return {\n          defaultOptions: getDefaultOptions,\n          isCaseSensitive: false,\n          ...options\n        };\n      },\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\"Rendering built-in modules.\");\n\n          const commands = await getCommandList(this);\n          this.debug(\n            `Rendering \\`banner\\` built-ins for each of the ${\n              commands.length\n            } command modules.`\n          );\n\n          const bin = computed(() => ({\n            id: \"\",\n            name: getAppName(this),\n            title: \"\",\n            description: getAppDescription(this),\n            isVirtual: true,\n            path: null,\n            segments: [],\n            alias: [],\n            tags: [],\n            options: Object.fromEntries(\n              this.options.map(option => [option.name, option])\n            ),\n            entry: {\n              file: joinPaths(this.entryPath, \"bin.ts\")\n            },\n            args: [],\n            parent: null,\n            children: this.commands\n          }));\n\n          return render(\n            this,\n            <>\n              <UpgradeBuiltin />\n              <BannerBuiltin command={bin.value} />\n              <Spacing />\n              <For\n                each={commands.sort((a, b) => a.name.localeCompare(b.name))}\n                doubleHardline>\n                {command => <BannerBuiltin command={command} />}\n              </For>\n            </>\n          );\n        }\n      }\n    },\n    {\n      name: \"shell-shock:cli-preset:generate-entrypoint\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\n            \"Rendering entrypoint modules for the Shell Shock `cli` preset.\"\n          );\n\n          return render(\n            this,\n            <>\n              <BinEntry\n                builtinImports={{\n                  console: [\n                    \"info\",\n                    \"debug\",\n                    \"warn\",\n                    \"help\",\n                    \"error\",\n                    \"cursor\",\n                    \"divider\",\n                    \"stripAnsi\",\n                    \"writeLine\",\n                    \"splitText\",\n                    \"colors\"\n                  ],\n                  utils: [\n                    \"useApp\",\n                    \"useArgs\",\n                    \"isMinimal\",\n                    \"isInteractive\",\n                    \"isHelp\"\n                  ],\n                  prompts: [\n                    \"text\",\n                    \"numeric\",\n                    \"toggle\",\n                    \"select\",\n                    \"confirm\",\n                    \"isCancel\"\n                  ],\n                  env: [\"env\", \"paths\"],\n                  upgrade: [\"executeUpgrade\"]\n                }}>\n                <Show when={Object.keys(this.commands).length > 0}>\n                  <VarDeclaration\n                    let\n                    name=\"args\"\n                    type=\"string[]\"\n                    initializer={code`useArgs();`}\n                  />\n                  <hbr />\n                  <CommandRouter segments={[]} commands={this.commands ?? {}} />\n                  <hbr />\n                </Show>\n                <hbr />\n                {code`await showBanner(0);`}\n                <Spacing />\n                {code`return showHelp(); `}\n              </BinEntry>\n              <Show when={Object.values(this.commands).length > 0}>\n                <For each={Object.values(this.commands)} doubleHardline>\n                  {child => (\n                    <Show\n                      when={child.isVirtual}\n                      fallback={<CommandEntry command={child} />}>\n                      <VirtualCommandEntry command={child} />\n                    </Show>\n                  )}\n                </For>\n              </Show>\n            </>\n          );\n        }\n      }\n    }\n  ];\n};\n\nexport default plugin;\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, computed, For, Show } from \"@alloy-js/core\";\nimport { VarDeclaration } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport {\n  getAppDescription,\n  getAppName,\n  getCommandList\n} from \"@shell-shock/core/plugin-utils\";\nimport changelog from \"@shell-shock/plugin-changelog\";\nimport completions from \"@shell-shock/plugin-completions\";\nimport console from \"@shell-shock/plugin-console\";\nimport help from \"@shell-shock/plugin-help\";\nimport prompts from \"@shell-shock/plugin-prompts\";\nimport upgrade from \"@shell-shock/plugin-upgrade\";\nimport { BinEntry } from \"@shell-shock/preset-script/components/bin-entry\";\nimport { joinPaths } from \"@stryke/path\";\nimport type { Plugin } from \"powerlines\";\nimport { BannerBuiltin } from \"./components/banner-builtin\";\nimport { CommandEntry } from \"./components/command-entry\";\nimport { CommandRouter } from \"./components/command-router\";\nimport { UpgradeBuiltin } from \"./components/upgrade-builtin\";\nimport { VirtualCommandEntry } from \"./components/virtual-command-entry\";\nimport { getGlobalOptions } from \"./helpers/get-global-options\";\nimport type { CLIPresetContext, CLIPresetOptions } from \"./types/plugin\";\n\n/**\n * The Shell Shock CLI Preset plugin.\n *\n * @remarks\n * This preset includes a set of built-in modules and commands to create a CLI application, as well as configuration options to customize the generated code. It also includes the `prompts` plugin to provide interactive prompts in the CLI application, and the `upgrade` plugin to manage upgrading the local application's version.\n */\nexport const plugin = <TContext extends CLIPresetContext = CLIPresetContext>(\n  options: CLIPresetOptions = {}\n): Plugin<TContext>[] => {\n  return [\n    ...console<TContext>(options),\n    ...help<TContext>(options),\n    ...prompts<TContext>(options),\n    ...(options.changelog !== false\n      ? [changelog<TContext>(options.changelog)]\n      : []),\n    ...(options.completions !== false\n      ? completions<TContext>(options.completions)\n      : []),\n    upgrade<TContext>(options),\n    {\n      name: \"shell-shock:cli-preset\",\n      config() {\n        this.debug(\n          \"Providing default configuration for the Shell Shock `cli` preset.\"\n        );\n\n        return {\n          globalOptions: getGlobalOptions,\n          isCaseSensitive: false,\n          ...options\n        };\n      },\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\"Rendering built-in modules.\");\n\n          const commands = await getCommandList(this);\n          this.debug(\n            `Rendering \\`banner\\` built-ins for each of the ${\n              commands.length\n            } command modules.`\n          );\n\n          const bin = computed(() => ({\n            id: \"\",\n            name: getAppName(this),\n            title: \"\",\n            description: getAppDescription(this),\n            isVirtual: true,\n            path: null,\n            segments: [],\n            alias: [],\n            tags: [],\n            options: Object.fromEntries(\n              this.options.map(option => [option.name, option])\n            ),\n            entry: {\n              file: joinPaths(this.entryPath, \"bin.ts\")\n            },\n            args: [],\n            parent: null,\n            children: this.commands\n          }));\n\n          return render(\n            this,\n            <>\n              <UpgradeBuiltin />\n              <BannerBuiltin command={bin.value} />\n              <Spacing />\n              <For\n                each={commands.sort((a, b) => a.name.localeCompare(b.name))}\n                doubleHardline>\n                {command => <BannerBuiltin command={command} />}\n              </For>\n            </>\n          );\n        }\n      }\n    },\n    {\n      name: \"shell-shock:cli-preset:generate-entrypoint\",\n      prepare: {\n        order: \"post\",\n        async handler() {\n          this.debug(\n            \"Rendering entrypoint modules for the Shell Shock `cli` preset.\"\n          );\n\n          return render(\n            this,\n            <>\n              <BinEntry\n                builtinImports={{\n                  console: [\n                    \"info\",\n                    \"debug\",\n                    \"warn\",\n                    \"help\",\n                    \"error\",\n                    \"cursor\",\n                    \"divider\",\n                    \"stripAnsi\",\n                    \"writeLine\",\n                    \"splitText\"\n                  ],\n                  utils: [\"isMinimal\", \"isInteractive\"],\n                  state: [\"useGlobal\", \"useArgs\", \"isHelp\"],\n                  prompts: [\n                    \"text\",\n                    \"numeric\",\n                    \"toggle\",\n                    \"select\",\n                    \"confirm\",\n                    \"isCancel\"\n                  ],\n                  env: [\"env\", \"paths\"],\n                  upgrade: [\"executeUpgrade\"]\n                }}>\n                <Show when={Object.keys(this.commands).length > 0}>\n                  <VarDeclaration\n                    let\n                    name=\"args\"\n                    type=\"string[]\"\n                    initializer={code`useArgs();`}\n                  />\n                  <hbr />\n                  <CommandRouter segments={[]} commands={this.commands ?? {}} />\n                  <hbr />\n                </Show>\n                <hbr />\n                {code`await showBanner(0);`}\n                <Spacing />\n                {code`return showHelp(); `}\n              </BinEntry>\n              <Show when={Object.values(this.commands).length > 0}>\n                <For each={Object.values(this.commands)} doubleHardline>\n                  {child => (\n                    <Show\n                      when={child.isVirtual}\n                      fallback={<CommandEntry command={child} />}>\n                      <VirtualCommandEntry command={child} />\n                    </Show>\n                  )}\n                </For>\n              </Show>\n            </>\n          );\n        }\n      }\n    }\n  ];\n};\n\nexport default plugin;\n"],"mappings":"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"}

package/dist/node_modules/.pnpm/@stryke_types@0.11.3/node_modules/@stryke/types/dist/base.d.cts

@@ -0,0 +1,17 @@
+//#region ../../node_modules/.pnpm/@stryke+types@0.11.3/node_modules/@stryke/types/dist/base.d.cts
+/**
+ * Create a type that makes the given keys required. The remaining keys are kept as is.
+ *
+ * @remarks
+ * Use-case: You want to define a single model where the only thing that changes is whether or not some of the keys are required.
+ */
+type RequiredKeys<BaseType, Keys extends keyof BaseType> = Required<Pick<BaseType, Keys>> & Omit<BaseType, Keys>;
+/**
+ * Create a type that makes the given keys optional. The remaining keys are kept as is.
+ *
+ * @remarks
+ * Use-case: You want to define a single model where the only thing that changes is whether or not some of the keys are optional.
+ */
+//#endregion
+export { RequiredKeys };
+//# sourceMappingURL=base.d.cts.map

package/dist/node_modules/.pnpm/@stryke_types@0.11.3/node_modules/@stryke/types/dist/base.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.cts","names":["TypedArray","SerializablePrimitive","Primitive","BuiltIns","Date","RegExp","AtomicObject","Function","Promise","TypeTester","value","TypeMap","Record","emptyObjectSymbol","FunctionOrValue","Value","X","List","A","ReadonlyArray","FunctionLike","P","R$1","args","AnyFunction","Nullish","Nullishable","T","NonNullishObject","NativeClass","AnyNumber","AnyString","AnyBoolean","AnyArray","PlainObject","AnyMap","Map","AnyWeakMap","WeakKey","WeakMap","EmptyArray","EmptyObject","Any","IndexType","TypedIndexable","Indexable","Dictionary","EMPTY_STRING","NEWLINE_STRING","EMPTY_OBJECT","AnyCase","F1","Uppercase","Lowercase","F2","R","F","Newable","_args","Abstract","prototype","Clonable","clone","MaybePromise","ReducerFunction","TState","TAction","state","action","TYPE_ARGUMENTS","TYPE_ARRAY","TYPE_OBJECT","TYPE_MAP","TYPE_SET","Collection","IArguments","Set","NonUndefined","BrowserNativeObject","File","DeepPartial","NestedValue","K","Rollback","initialValue","currentValue","RequiredKeysOf","BaseType","Key","Exclude","IsEqual","G","B","Filter","KeyType$1","ExcludeType","ExceptOptions","requireExactProps","Except","ObjectType","KeysType","Options","KeyType","Partial","Simplify","RequiredKeys","Keys","Pick","Required","Omit","PartialKeys","$NestedValue","TValue","RefObject","current","Identity","id","Versioned","version","Sequenced","sequence","Typed","__type","ClassTypeCheckable","isTypeOf","NonRecursiveType","arguments_","IsPrimitive","IsNever","IsAny","IsNull","IsUndefined","IsUnknown","IsNullish","IsFunction","GlobalThis","globalThis","Class","Arguments","Constructor","AbstractClass","AbstractConstructor","BuildTuple","L","Fill","HasMultipleCallSignatures","StructuredCloneablePrimitive","StructuredCloneableData","ArrayBuffer","DataView","Error","Blob","StructuredCloneableCollection","StructuredCloneable","ReadonlyMap","ReadonlySet","key"],"sources":["../../../../../../../../../../node_modules/.pnpm/@stryke+types@0.11.3/node_modules/@stryke/types/dist/base.d.cts"],"x_google_ignoreList":[0],"mappings":";;;;;;;KAiLKyG,YAAAA,8BAA0ClB,QAAAA,IAAYqB,QAAAA,CAASD,IAAAA,CAAKpB,QAAAA,EAAUmB,IAAAA,KAASG,IAAAA,CAAKtB,QAAAA,EAAUmB,IAAAA"}

package/dist/node_modules/.pnpm/@stryke_types@0.11.3/node_modules/@stryke/types/dist/base.d.mts

@@ -0,0 +1,17 @@
+//#region ../../node_modules/.pnpm/@stryke+types@0.11.3/node_modules/@stryke/types/dist/base.d.cts
+/**
+ * Create a type that makes the given keys required. The remaining keys are kept as is.
+ *
+ * @remarks
+ * Use-case: You want to define a single model where the only thing that changes is whether or not some of the keys are required.
+ */
+type RequiredKeys<BaseType, Keys extends keyof BaseType> = Required<Pick<BaseType, Keys>> & Omit<BaseType, Keys>;
+/**
+ * Create a type that makes the given keys optional. The remaining keys are kept as is.
+ *
+ * @remarks
+ * Use-case: You want to define a single model where the only thing that changes is whether or not some of the keys are optional.
+ */
+//#endregion
+export { RequiredKeys };
+//# sourceMappingURL=base.d.mts.map

package/dist/node_modules/.pnpm/@stryke_types@0.11.3/node_modules/@stryke/types/dist/base.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.mts","names":["TypedArray","SerializablePrimitive","Primitive","BuiltIns","Date","RegExp","AtomicObject","Function","Promise","TypeTester","value","TypeMap","Record","emptyObjectSymbol","FunctionOrValue","Value","X","List","A","ReadonlyArray","FunctionLike","P","R$1","args","AnyFunction","Nullish","Nullishable","T","NonNullishObject","NativeClass","AnyNumber","AnyString","AnyBoolean","AnyArray","PlainObject","AnyMap","Map","AnyWeakMap","WeakKey","WeakMap","EmptyArray","EmptyObject","Any","IndexType","TypedIndexable","Indexable","Dictionary","EMPTY_STRING","NEWLINE_STRING","EMPTY_OBJECT","AnyCase","F1","Uppercase","Lowercase","F2","R","F","Newable","_args","Abstract","prototype","Clonable","clone","MaybePromise","ReducerFunction","TState","TAction","state","action","TYPE_ARGUMENTS","TYPE_ARRAY","TYPE_OBJECT","TYPE_MAP","TYPE_SET","Collection","IArguments","Set","NonUndefined","BrowserNativeObject","File","DeepPartial","NestedValue","K","Rollback","initialValue","currentValue","RequiredKeysOf","BaseType","Key","Exclude","IsEqual","G","B","Filter","KeyType$1","ExcludeType","ExceptOptions","requireExactProps","Except","ObjectType","KeysType","Options","KeyType","Partial","Simplify","RequiredKeys","Keys","Pick","Required","Omit","PartialKeys","$NestedValue","TValue","RefObject","current","Identity","id","Versioned","version","Sequenced","sequence","Typed","__type","ClassTypeCheckable","isTypeOf","NonRecursiveType","arguments_","IsPrimitive","IsNever","IsAny","IsNull","IsUndefined","IsUnknown","IsNullish","IsFunction","GlobalThis","globalThis","Class","Arguments","Constructor","AbstractClass","AbstractConstructor","BuildTuple","L","Fill","HasMultipleCallSignatures","StructuredCloneablePrimitive","StructuredCloneableData","ArrayBuffer","DataView","Error","Blob","StructuredCloneableCollection","StructuredCloneable","ReadonlyMap","ReadonlySet","key"],"sources":["../../../../../../../../../../node_modules/.pnpm/@stryke+types@0.11.3/node_modules/@stryke/types/dist/base.d.cts"],"x_google_ignoreList":[0],"mappings":";;;;;;;KAiLKyG,YAAAA,8BAA0ClB,QAAAA,IAAYqB,QAAAA,CAASD,IAAAA,CAAKpB,QAAAA,EAAUmB,IAAAA,KAASG,IAAAA,CAAKtB,QAAAA,EAAUmB,IAAAA"}

package/dist/packages/plugin-changelog/dist/components/changelog-command.mjs

@@ -0,0 +1,130 @@
+import { e } from "../../../unified/dist/markdown/index.mjs";
+import { createComponent } from "@alloy-js/core/jsx-runtime";
+import { Show, code, createResource } from "@alloy-js/core";
+import { FunctionDeclaration, InterfaceDeclaration } from "@alloy-js/typescript";
+import { getAppTitle } from "@shell-shock/core/plugin-utils";
+import { ReflectionKind } from "@powerlines/deepkit/vendor/type";
+import { Spacing } from "@powerlines/plugin-alloy/core";
+import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
+import { InterfaceMember, TypescriptFile } from "@powerlines/plugin-alloy/typescript";
+import { TSDoc, TSDocDefaultValue, TSDocParam } from "@powerlines/plugin-alloy/typescript/components/tsdoc";
+import { joinPaths } from "@stryke/path";
+
+//#region ../plugin-changelog/dist/components/changelog-command.mjs
+/**
+* The Changelog command's handler wrapper for the Shell Shock project.
+*/
+function ChangelogCommand() {
+	const context = usePowerlines();
+	const result = createResource(async () => {
+		const content = await context.fs.read(context.config.changelog.file);
+		if (!content) return null;
+		return e(content);
+	});
+	return createComponent(TypescriptFile, {
+		get path() {
+			return joinPaths(context.entryPath, "changelog", "command.ts");
+		},
+		imports: {
+			"node:os": "os",
+			"node:fs/promises": ["readFile", "writeFile"]
+		},
+		builtinImports: { console: [
+			"textColors",
+			"bold",
+			"writeLine",
+			"error",
+			"warn"
+		] },
+		get children() {
+			return [
+				createComponent(TSDoc, { heading: "Options for the Changelog command." }),
+				createComponent(InterfaceDeclaration, {
+					"export": true,
+					name: "ChangelogOptions",
+					get children() {
+						return [
+							createComponent(TSDoc, { heading: "An optional starting version for the changelog. The command will attempt to display changes starting from the specified version. The version should be a valid semantic version string. If not specified, the changelog will start from the earliest version available." }),
+							createComponent(InterfaceMember, {
+								name: "start",
+								optional: true,
+								type: "string"
+							}),
+							createComponent(Spacing, {}),
+							createComponent(TSDoc, {
+								heading: "An optional ending version for the changelog. The command will attempt to display changes up to the specified version. The version should be a valid semantic version string. If not specified, the changelog will display changes up to the latest version available.",
+								get children() {
+									return createComponent(TSDocDefaultValue, {
+										get type() {
+											return ReflectionKind.string;
+										},
+										defaultValue: "latest"
+									});
+								}
+							}),
+							createComponent(InterfaceMember, {
+								name: "end",
+								optional: true,
+								type: "string"
+							})
+						];
+					}
+				}),
+				createComponent(Spacing, {}),
+				createComponent(TSDoc, {
+					get heading() {
+						return `Display the ${getAppTitle(context)} changelog.`;
+					},
+					get children() {
+						return createComponent(TSDocParam, {
+							name: "options",
+							children: code`An object containing options for displaying the changelog.`
+						});
+					}
+				}),
+				createComponent(FunctionDeclaration, {
+					"export": true,
+					"default": true,
+					async: true,
+					name: "handler",
+					parameters: [{
+						name: "options",
+						type: "ChangelogOptions"
+					}],
+					get children() {
+						return createComponent(Show, {
+							get when() {
+								return !result.loading && !result.error;
+							},
+							get fallback() {
+								return createComponent(Show, {
+									get when() {
+										return !!result.error;
+									},
+									get children() {
+										return code` return error(\`Failed to load changelog: ${result.error.message.replaceAll(/`/g, "\\`")}\`); `;
+									}
+								});
+							},
+							get children() {
+								return createComponent(Show, {
+									get when() {
+										return !!result.data?.toString();
+									},
+									fallback: code` return warn("There is no changelog available for display."); `,
+									get children() {
+										return code` return \`${result.data?.toString()}\`; `;
+									}
+								});
+							}
+						});
+					}
+				})
+			];
+		}
+	});
+}
+
+//#endregion
+export { ChangelogCommand };
+//# sourceMappingURL=changelog-command.mjs.map

package/dist/packages/plugin-changelog/dist/components/changelog-command.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog-command.mjs","names":["markdown"],"sources":["../../../../../../plugin-changelog/dist/components/changelog-command.mjs"],"sourcesContent":["import { createComponent } from \"@alloy-js/core/jsx-runtime\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport { Show, code, createResource } from \"@alloy-js/core\";\nimport { FunctionDeclaration, InterfaceDeclaration } from \"@alloy-js/typescript\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { InterfaceMember, TypescriptFile } from \"@powerlines/plugin-alloy/typescript\";\nimport { TSDoc, TSDocDefaultValue, TSDocParam } from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport markdown from \"@shell-shock/unified/markdown\";\nimport { joinPaths } from \"@stryke/path\";\n\n//#region src/components/changelog-command.tsx\n/**\n* The Changelog command's handler wrapper for the Shell Shock project.\n*/\nfunction ChangelogCommand() {\n\tconst context = usePowerlines();\n\tconst result = createResource(async () => {\n\t\tconst content = await context.fs.read(context.config.changelog.file);\n\t\tif (!content) return null;\n\t\treturn markdown(content);\n\t});\n\treturn createComponent(TypescriptFile, {\n\t\tget path() {\n\t\t\treturn joinPaths(context.entryPath, \"changelog\", \"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\"textColors\",\n\t\t\t\"bold\",\n\t\t\t\"writeLine\",\n\t\t\t\"error\",\n\t\t\t\"warn\"\n\t\t] },\n\t\tget children() {\n\t\t\treturn [\n\t\t\t\tcreateComponent(TSDoc, { heading: \"Options for the Changelog command.\" }),\n\t\t\t\tcreateComponent(InterfaceDeclaration, {\n\t\t\t\t\t\"export\": true,\n\t\t\t\t\tname: \"ChangelogOptions\",\n\t\t\t\t\tget children() {\n\t\t\t\t\t\treturn [\n\t\t\t\t\t\t\tcreateComponent(TSDoc, { heading: \"An optional starting version for the changelog. The command will attempt to display changes starting from the specified version. The version should be a valid semantic version string. If not specified, the changelog will start from the earliest version available.\" }),\n\t\t\t\t\t\t\tcreateComponent(InterfaceMember, {\n\t\t\t\t\t\t\t\tname: \"start\",\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\tcreateComponent(Spacing, {}),\n\t\t\t\t\t\t\tcreateComponent(TSDoc, {\n\t\t\t\t\t\t\t\theading: \"An optional ending version for the changelog. The command will attempt to display changes up to the specified version. The version should be a valid semantic version string. If not specified, the changelog will display changes up to the latest version available.\",\n\t\t\t\t\t\t\t\tget children() {\n\t\t\t\t\t\t\t\t\treturn 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: \"end\",\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, {\n\t\t\t\t\tget heading() {\n\t\t\t\t\t\treturn `Display the ${getAppTitle(context)} changelog.`;\n\t\t\t\t\t},\n\t\t\t\t\tget children() {\n\t\t\t\t\t\treturn createComponent(TSDocParam, {\n\t\t\t\t\t\t\tname: \"options\",\n\t\t\t\t\t\t\tchildren: code`An object containing options for displaying the changelog.`\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t}),\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: \"ChangelogOptions\"\n\t\t\t\t\t}],\n\t\t\t\t\tget children() {\n\t\t\t\t\t\treturn createComponent(Show, {\n\t\t\t\t\t\t\tget when() {\n\t\t\t\t\t\t\t\treturn !result.loading && !result.error;\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\tget fallback() {\n\t\t\t\t\t\t\t\treturn createComponent(Show, {\n\t\t\t\t\t\t\t\t\tget when() {\n\t\t\t\t\t\t\t\t\t\treturn !!result.error;\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\tget children() {\n\t\t\t\t\t\t\t\t\t\treturn code` return error(\\`Failed to load changelog: ${result.error.message.replaceAll(/`/g, \"\\\\`\")}\\`); `;\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\tget children() {\n\t\t\t\t\t\t\t\treturn createComponent(Show, {\n\t\t\t\t\t\t\t\t\tget when() {\n\t\t\t\t\t\t\t\t\t\treturn !!result.data?.toString();\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\tfallback: code` return warn(\"There is no changelog available for display.\"); `,\n\t\t\t\t\t\t\t\t\tget children() {\n\t\t\t\t\t\t\t\t\t\treturn code` return \\`${result.data?.toString()}\\`; `;\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});\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 { ChangelogCommand };\n//# sourceMappingURL=changelog-command.mjs.map"],"mappings":";;;;;;;;;;;;;;;;AAgBA,SAAS,mBAAmB;CAC3B,MAAM,UAAU,eAAe;CAC/B,MAAM,SAAS,eAAe,YAAY;EACzC,MAAM,UAAU,MAAM,QAAQ,GAAG,KAAK,QAAQ,OAAO,UAAU,KAAK;AACpE,MAAI,CAAC,QAAS,QAAO;AACrB,SAAOA,EAAS,QAAQ;GACvB;AACF,QAAO,gBAAgB,gBAAgB;EACtC,IAAI,OAAO;AACV,UAAO,UAAU,QAAQ,WAAW,aAAa,aAAa;;EAE/D,SAAS;GACR,WAAW;GACX,oBAAoB,CAAC,YAAY,YAAY;GAC7C;EACD,gBAAgB,EAAE,SAAS;GAC1B;GACA;GACA;GACA;GACA;GACA,EAAE;EACH,IAAI,WAAW;AACd,UAAO;IACN,gBAAgB,OAAO,EAAE,SAAS,sCAAsC,CAAC;IACzE,gBAAgB,sBAAsB;KACrC,UAAU;KACV,MAAM;KACN,IAAI,WAAW;AACd,aAAO;OACN,gBAAgB,OAAO,EAAE,SAAS,2QAA2Q,CAAC;OAC9S,gBAAgB,iBAAiB;QAChC,MAAM;QACN,UAAU;QACV,MAAM;QACN,CAAC;OACF,gBAAgB,SAAS,EAAE,CAAC;OAC5B,gBAAgB,OAAO;QACtB,SAAS;QACT,IAAI,WAAW;AACd,gBAAO,gBAAgB,mBAAmB;UACzC,IAAI,OAAO;AACV,kBAAO,eAAe;;UAEvB,cAAc;UACd,CAAC;;QAEH,CAAC;OACF,gBAAgB,iBAAiB;QAChC,MAAM;QACN,UAAU;QACV,MAAM;QACN,CAAC;OACF;;KAEF,CAAC;IACF,gBAAgB,SAAS,EAAE,CAAC;IAC5B,gBAAgB,OAAO;KACtB,IAAI,UAAU;AACb,aAAO,eAAe,YAAY,QAAQ,CAAC;;KAE5C,IAAI,WAAW;AACd,aAAO,gBAAgB,YAAY;OAClC,MAAM;OACN,UAAU,IAAI;OACd,CAAC;;KAEH,CAAC;IACF,gBAAgB,qBAAqB;KACpC,UAAU;KACV,WAAW;KACX,OAAO;KACP,MAAM;KACN,YAAY,CAAC;MACZ,MAAM;MACN,MAAM;MACN,CAAC;KACF,IAAI,WAAW;AACd,aAAO,gBAAgB,MAAM;OAC5B,IAAI,OAAO;AACV,eAAO,CAAC,OAAO,WAAW,CAAC,OAAO;;OAEnC,IAAI,WAAW;AACd,eAAO,gBAAgB,MAAM;SAC5B,IAAI,OAAO;AACV,iBAAO,CAAC,CAAC,OAAO;;SAEjB,IAAI,WAAW;AACd,iBAAO,IAAI,6CAA6C,OAAO,MAAM,QAAQ,WAAW,MAAM,MAAM,CAAC;;SAEtG,CAAC;;OAEH,IAAI,WAAW;AACd,eAAO,gBAAgB,MAAM;SAC5B,IAAI,OAAO;AACV,iBAAO,CAAC,CAAC,OAAO,MAAM,UAAU;;SAEjC,UAAU,IAAI;SACd,IAAI,WAAW;AACd,iBAAO,IAAI,aAAa,OAAO,MAAM,UAAU,CAAC;;SAEjD,CAAC;;OAEH,CAAC;;KAEH,CAAC;IACF;;EAEF,CAAC"}

package/dist/packages/plugin-changelog/dist/components/index.mjs

@@ -0,0 +1,3 @@
+import { ChangelogCommand } from "./changelog-command.mjs";
+
+export {  };

package/dist/packages/plugin-changelog/dist/index.d.cts

@@ -0,0 +1,2 @@
+import { ChangelogPluginContext, ChangelogPluginOptions, ChangelogPluginResolvedConfig, ChangelogPluginUserConfig } from "./types/plugin.cjs";
+import { Plugin } from "powerlines";

package/dist/packages/plugin-changelog/dist/index.d.mts

@@ -0,0 +1,2 @@
+import { ChangelogPluginContext, ChangelogPluginOptions, ChangelogPluginResolvedConfig, ChangelogPluginUserConfig } from "./types/plugin.mjs";
+import { Plugin } from "powerlines";

package/dist/packages/plugin-changelog/dist/index.mjs

@@ -0,0 +1,52 @@
+import { ChangelogCommand } from "./components/changelog-command.mjs";
+import "./components/index.mjs";
+import { createComponent } from "@alloy-js/core/jsx-runtime";
+import { render } from "@powerlines/plugin-alloy/render";
+import { getAppTitle } from "@shell-shock/core/plugin-utils";
+import { joinPaths } from "@stryke/path/join";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import defu from "defu";
+import { replacePathTokens } from "powerlines/plugin-utils";
+
+//#region ../plugin-changelog/dist/index.mjs
+/**
+* The Changelog - Shell Shock plugin to add version check functionality and changelog commands to a Shell Shock application.
+*/
+const plugin = (options = {}) => {
+	return {
+		name: "shell-shock:changelog",
+		config() {
+			this.debug("Providing default configuration for the Shell Shock `changelog` plugin.");
+			return { changelog: defu({ command: { name: isSetString(options.command) ? options.command : "changelog" } }, options, { file: joinPaths("{root}", "CHANGELOG.md") }) };
+		},
+		configResolved() {
+			this.debug("Adding the CLI changelog commands to the application context.");
+			this.config.changelog.file = replacePathTokens(this, this.config.changelog.file);
+			this.inputs ??= [];
+			if (this.inputs.some((input) => input.id === this.config.changelog.command.name)) this.info("The `changelog` command already exists in the commands list. If you would like the changelog command to be managed by the `@shell-shock/plugin-changelog` package, please remove or rename the command.");
+			else this.inputs.push({
+				id: this.config.changelog.command.name,
+				path: this.config.changelog.command.name,
+				segments: [this.config.changelog.command.name],
+				title: "Changelog",
+				icon: "🗃",
+				tags: ["Utility"],
+				description: `Display the ${getAppTitle(this)} changelog.`,
+				entry: {
+					file: joinPaths(this.entryPath, "changelog", "index.ts"),
+					input: { file: joinPaths(this.entryPath, "changelog", "command.ts") }
+				},
+				isVirtual: false,
+				...this.config.changelog.command
+			});
+		},
+		async prepare() {
+			this.debug("Rendering changelog command module for the Shell Shock `changelog` plugin.");
+			return render(this, createComponent(ChangelogCommand, {}));
+		}
+	};
+};
+
+//#endregion
+export { plugin };
+//# sourceMappingURL=index.mjs.map

package/dist/packages/plugin-changelog/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../plugin-changelog/dist/index.mjs"],"sourcesContent":["import { ChangelogCommand } from \"./components/changelog-command.mjs\";\nimport \"./components/index.mjs\";\nimport { createComponent } from \"@alloy-js/core/jsx-runtime\";\nimport { render } from \"@powerlines/plugin-alloy/render\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport defu from \"defu\";\nimport { replacePathTokens } from \"powerlines/plugin-utils\";\n\n//#region src/index.tsx\n/**\n* The Changelog - Shell Shock plugin to add version check functionality and changelog commands to a Shell Shock application.\n*/\nconst plugin = (options = {}) => {\n\treturn {\n\t\tname: \"shell-shock:changelog\",\n\t\tconfig() {\n\t\t\tthis.debug(\"Providing default configuration for the Shell Shock `changelog` plugin.\");\n\t\t\treturn { changelog: defu({ command: { name: isSetString(options.command) ? options.command : \"changelog\" } }, options, { file: joinPaths(\"{root}\", \"CHANGELOG.md\") }) };\n\t\t},\n\t\tconfigResolved() {\n\t\t\tthis.debug(\"Adding the CLI changelog commands to the application context.\");\n\t\t\tthis.config.changelog.file = replacePathTokens(this, this.config.changelog.file);\n\t\t\tthis.inputs ??= [];\n\t\t\tif (this.inputs.some((input) => input.id === this.config.changelog.command.name)) this.info(\"The `changelog` command already exists in the commands list. If you would like the changelog command to be managed by the `@shell-shock/plugin-changelog` package, please remove or rename the command.\");\n\t\t\telse this.inputs.push({\n\t\t\t\tid: this.config.changelog.command.name,\n\t\t\t\tpath: this.config.changelog.command.name,\n\t\t\t\tsegments: [this.config.changelog.command.name],\n\t\t\t\ttitle: \"Changelog\",\n\t\t\t\ticon: \"🗃\",\n\t\t\t\ttags: [\"Utility\"],\n\t\t\t\tdescription: `Display the ${getAppTitle(this)} changelog.`,\n\t\t\t\tentry: {\n\t\t\t\t\tfile: joinPaths(this.entryPath, \"changelog\", \"index.ts\"),\n\t\t\t\t\tinput: { file: joinPaths(this.entryPath, \"changelog\", \"command.ts\") }\n\t\t\t\t},\n\t\t\t\tisVirtual: false,\n\t\t\t\t...this.config.changelog.command\n\t\t\t});\n\t\t},\n\t\tasync prepare() {\n\t\t\tthis.debug(\"Rendering changelog command module for the Shell Shock `changelog` plugin.\");\n\t\t\treturn render(this, createComponent(ChangelogCommand, {}));\n\t\t}\n\t};\n};\n\n//#endregion\nexport { plugin as default, plugin };\n//# sourceMappingURL=index.mjs.map"],"mappings":";;;;;;;;;;;;;;AAcA,MAAM,UAAU,UAAU,EAAE,KAAK;AAChC,QAAO;EACN,MAAM;EACN,SAAS;AACR,QAAK,MAAM,0EAA0E;AACrF,UAAO,EAAE,WAAW,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,QAAQ,QAAQ,GAAG,QAAQ,UAAU,aAAa,EAAE,EAAE,SAAS,EAAE,MAAM,UAAU,UAAU,eAAe,EAAE,CAAC,EAAE;;EAExK,iBAAiB;AAChB,QAAK,MAAM,gEAAgE;AAC3E,QAAK,OAAO,UAAU,OAAO,kBAAkB,MAAM,KAAK,OAAO,UAAU,KAAK;AAChF,QAAK,WAAW,EAAE;AAClB,OAAI,KAAK,OAAO,MAAM,UAAU,MAAM,OAAO,KAAK,OAAO,UAAU,QAAQ,KAAK,CAAE,MAAK,KAAK,0MAA0M;OACjS,MAAK,OAAO,KAAK;IACrB,IAAI,KAAK,OAAO,UAAU,QAAQ;IAClC,MAAM,KAAK,OAAO,UAAU,QAAQ;IACpC,UAAU,CAAC,KAAK,OAAO,UAAU,QAAQ,KAAK;IAC9C,OAAO;IACP,MAAM;IACN,MAAM,CAAC,UAAU;IACjB,aAAa,eAAe,YAAY,KAAK,CAAC;IAC9C,OAAO;KACN,MAAM,UAAU,KAAK,WAAW,aAAa,WAAW;KACxD,OAAO,EAAE,MAAM,UAAU,KAAK,WAAW,aAAa,aAAa,EAAE;KACrE;IACD,WAAW;IACX,GAAG,KAAK,OAAO,UAAU;IACzB,CAAC;;EAEH,MAAM,UAAU;AACf,QAAK,MAAM,6EAA6E;AACxF,UAAO,OAAO,MAAM,gBAAgB,kBAAkB,EAAE,CAAC,CAAC;;EAE3D"}

package/dist/packages/plugin-changelog/dist/types/plugin.d.cts

@@ -0,0 +1,43 @@
+import { RequiredKeys } from "../../../../node_modules/.pnpm/@stryke_types@0.11.3/node_modules/@stryke/types/dist/base.cjs";
+import { CommandConfig, Context, ResolvedConfig, UserConfig } from "@shell-shock/core";
+
+//#region ../plugin-changelog/dist/types/plugin.d.cts
+//#region src/types/plugin.d.ts
+interface ChangelogPluginOptions {
+  /**
+   * The path to the changelog file to read when executing the `changelog` command. This can be an absolute path or a path relative to the application's root directory.
+   *
+   * @defaultValue "\{root\}/CHANGELOG.md"
+   */
+  file?: string;
+  /**
+   * Should the plugin add the `changelog` command?
+   *
+   * @remarks
+   * This can be set to a string to specify a custom command name for the `changelog` command or an object to override the default command configuration. By default, the command name will be `"changelog"`.
+   *
+   * @defaultValue "changelog"
+   */
+  command?: Partial<CommandConfig> | string;
+}
+type ChangelogPluginUserConfig = UserConfig & {
+  /**
+   * Resolved changelog configuration for the plugin.
+   */
+  changelog: ChangelogPluginOptions;
+};
+type ChangelogPluginResolvedConfig = ResolvedConfig & {
+  /**
+   * Resolved changelog configuration for the plugin.
+   */
+  changelog: Required<Omit<ChangelogPluginOptions, "command">> & {
+    /**
+     * Resolved command configuration for the changelog command.
+     */
+    command: RequiredKeys<Partial<CommandConfig>, "name">;
+  };
+};
+type ChangelogPluginContext<TResolvedConfig extends ChangelogPluginResolvedConfig = ChangelogPluginResolvedConfig> = Context<TResolvedConfig>; //#endregion
+//#endregion
+export { ChangelogPluginContext, ChangelogPluginOptions, ChangelogPluginResolvedConfig, ChangelogPluginUserConfig };
+//# sourceMappingURL=plugin.d.cts.map

package/dist/packages/plugin-changelog/dist/types/plugin.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.cts","names":["CommandConfig","Context","ResolvedConfig","UserConfig","RequiredKeys","ChangelogPluginOptions","Partial","file","command","ChangelogPluginUserConfig","changelog","ChangelogPluginResolvedConfig","Omit","Required","ChangelogPluginContext","TResolvedConfig"],"sources":["../../../../../../plugin-changelog/dist/types/plugin.d.cts"],"mappings":";;;;;UAIUK,sBAAAA;EAAsB;;;;;EAM9BE,IAAAA;EASkBP;;;AAAa;;;;;EAA/BQ,OAAAA,GAAUF,OAAAA,CAAQN,aAAAA;AAAAA;AAAAA,KAEfS,yBAAAA,GAA4BN,UAAAA;EAIE;AAAA;;EAAjCO,SAAAA,EAAWL,sBAAAA;AAAAA;AAAAA,KAERM,6BAAAA,GAAgCT,cAAAA;EAIfU;;;EAApBF,SAAAA,EAAWG,QAAAA,CAASD,IAAAA,CAAKP,sBAAAA;IAIdD;;;IAATI,OAAAA,EAASJ,YAAAA,CAAaE,OAAAA,CAAQN,aAAAA;EAAAA;AAAAA;AAAAA,KAG7Bc,sBAAAA,yBAA+CH,6BAAAA,GAAgCA,6BAAAA,IAAiCV,OAAAA,CAAQc,eAAAA"}