@shell-shock/plugin-changelog 0.1.5 → 0.1.6

package/dist/components/changelog-command.cjs

@@ -104,7 +104,7 @@ function ChangelogCommand() {
 										return !!result.error;
 									},
 									get children() {
-										return _alloy_js_core.code` return error(\`Failed to load changelog: ${result.error.message.replaceAll(/`/g, "\\`")}\`); `;
+										return _alloy_js_core.code` return error(\`Failed to load changelog: ${result.error.message.replaceAll("\\", "\\\\").replaceAll("`", "\\`").replaceAll("${", "\\${").replaceAll("\n", "\\n").replaceAll("\r", "\\r").replaceAll("	", "\\t")}\`); `;
 									}
 								});
 							},

package/dist/components/changelog-command.mjs

@@ -102,7 +102,7 @@ function ChangelogCommand() {
 										return !!result.error;
 									},
 									get children() {
-										return code` return error(\`Failed to load changelog: ${result.error.message.replaceAll(/`/g, "\\`")}\`); `;
+										return code` return error(\`Failed to load changelog: ${result.error.message.replaceAll("\\", "\\\\").replaceAll("`", "\\`").replaceAll("${", "\\${").replaceAll("\n", "\\n").replaceAll("\r", "\\r").replaceAll("	", "\\t")}\`); `;
 									}
 								});
 							},

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

@@ -1 +1 @@
-{"version":3,"file":"changelog-command.mjs","names":[],"sources":["../../src/components/changelog-command.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, createResource, Show } from \"@alloy-js/core\";\nimport {\n  FunctionDeclaration,\n  InterfaceDeclaration\n} 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 {\n  InterfaceMember,\n  TypescriptFile\n} from \"@powerlines/plugin-alloy/typescript\";\nimport {\n  TSDoc,\n  TSDocDefaultValue,\n  TSDocParam\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport { renderMarkdown } from \"@shell-shock/unified/markdown\";\nimport { joinPaths } from \"@stryke/path\";\nimport type { ChangelogPluginContext } from \"../types/plugin\";\n\n/**\n * The Changelog command's handler wrapper for the Shell Shock project.\n */\nexport function ChangelogCommand() {\n  const context = usePowerlines<ChangelogPluginContext>();\n\n  const result = createResource(async () => {\n    const content = await context.fs.read(context.config.changelog.file);\n    if (!content) {\n      return null;\n    }\n\n    return renderMarkdown(content);\n  });\n\n  return (\n    <TypescriptFile\n      path={joinPaths(context.entryPath, \"changelog\", \"command.ts\")}\n      imports={{\n        \"node:os\": \"os\",\n        \"node:fs/promises\": [\"readFile\", \"writeFile\"]\n      }}\n      builtinImports={{\n        console: [\"textColors\", \"bold\", \"writeLine\", \"error\", \"warn\"]\n      }}>\n      <TSDoc heading=\"Options for the Changelog command.\" />\n      <InterfaceDeclaration export name=\"ChangelogOptions\">\n        <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        <InterfaceMember name=\"start\" optional type=\"string\" />\n        <Spacing />\n        <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.\">\n          <TSDocDefaultValue\n            type={ReflectionKind.string}\n            defaultValue=\"latest\"\n          />\n        </TSDoc>\n        <InterfaceMember name=\"end\" optional type=\"string\" />\n      </InterfaceDeclaration>\n      <Spacing />\n      <TSDoc heading={`Display the ${getAppTitle(context)} changelog.`}>\n        <TSDocParam name=\"options\">\n          {code`An object containing options for displaying the changelog.`}\n        </TSDocParam>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        default\n        async\n        name=\"handler\"\n        parameters={[{ name: \"options\", type: \"ChangelogOptions\" }]}>\n        <Show\n          when={!result.loading && !result.error}\n          fallback={\n            <Show when={!!result.error}>\n              {code` return error(\\`Failed to load changelog: ${result.error!.message.replaceAll(\n                /`/g,\n                \"\\\\\\`\"\n              )}\\`); `}\n            </Show>\n          }>\n          <Show\n            when={!!result.data}\n            fallback={code` return warn(\"There is no changelog available for display.\"); `}>\n            {result.data}\n          </Show>\n        </Show>\n      </FunctionDeclaration>\n    </TypescriptFile>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAkCA,SAAS,mBAAwB;CACjC,MAAQ,UAAC,eAA6C;CACtD,MAAQ,SAAC,eAAuB,YAAY;EAC5C,MAAS,UAAW,MAAM,QAAQ,GAAC,KAAK,QAAA,OAAA,UAAA,KAAA;AACxC,MAAO,CAAA;AAGJ,SAAI,eAAmB,QAAQ;GAChC;AACF,QAAO,gBAAS,gBAAmB;EACjC,IAAM,OAAO;;;EAGX,SAAM;GACJ,WAAW;GACX,oBAAW,CAAA,YAAA,YAAA;GACb;oBAEA,SAAO;GAAA;GAAe;GAAQ;GAAA;GAAA;GAAA,EAC9B;;AAEF,UAAO;IAAA,gBAAA,OAAA,EACJ,SAAA,sCACC,CAAA;IAAI,gBAAY,sBAAoB;KACpC,UAAS;KACP,MAAM;KACN,IAAC,WAAQ;AACV,aAAA;OAAA,gBAAA,OAAA,EACD,SAAe,2QACb,CAAA;OAAA,gBAAwB,iBAAS;QACjC,MAAA;QACI,UAAU;QACf,MAAA;QACE,CAAA;OAAK,gBAAa,SAAS,EAAA,CAAQ;OAAC,gBAAgB,OAAU;QAC9D,SAAA;QACA,IAAO,WAAE;AACJ,gBAAC,gBAAqB,mBAAsB;UAC/C,IAAA,OAAA;AACO,kBAAA,eAAqB;;UAE5B,cAAA;UACI,CAAA;;QAEP,CAAA;OAAA,gBAAoB,iBAAA;QACrB,MAAS;QACJ,UAAU;QACb,MAAA;QACE,CAAA;OAAA;;KAEJ,CAAC;IAAA,gBAAK,SAAA,EAAA,CAAA;IAAA,gBAAA,OAAA;KACN,IAAA,UAAA;AACC,aAAA,eAAA,YAAA,QAAA,CAAA;;KAEA,IAAA,WAAA;AACA,aAAM,gBAAO,YAAA;OACb,MAAU;OACT,UAAA,IAAA;OACC,CAAA;;KAEH,CAAC;IAAE,gBAAgB,qBAAa;KAC/B,UAAO;KACP,WAAW;KACX,OAAO;KACP,MAAM;KACN,YAAU,CAAA;MACR,MAAC;MACD,MAAC;MACF,CAAC;KACF,IAAI,WAAU;AACZ,aAAG,gBAAW,MAAA;OACZ,IAAI,OAAA;AACF,eAAA,CAAA,OAAA,WAAA,CAAA,OAAA;;OAER,IAAA,WAAc;AACjB,eAAA,gBAAA,MAAA;SACH,IAAA,OAAA"}
+{"version":3,"file":"changelog-command.mjs","names":[],"sources":["../../src/components/changelog-command.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, createResource, Show } from \"@alloy-js/core\";\nimport {\n  FunctionDeclaration,\n  InterfaceDeclaration\n} 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 {\n  InterfaceMember,\n  TypescriptFile\n} from \"@powerlines/plugin-alloy/typescript\";\nimport {\n  TSDoc,\n  TSDocDefaultValue,\n  TSDocParam\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport { getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport { renderMarkdown } from \"@shell-shock/unified/markdown\";\nimport { joinPaths } from \"@stryke/path\";\nimport type { ChangelogPluginContext } from \"../types/plugin\";\n\n/**\n * The Changelog command's handler wrapper for the Shell Shock project.\n */\nexport function ChangelogCommand() {\n  const context = usePowerlines<ChangelogPluginContext>();\n\n  const result = createResource(async () => {\n    const content = await context.fs.read(context.config.changelog.file);\n    if (!content) {\n      return null;\n    }\n\n    return renderMarkdown(content);\n  });\n\n  return (\n    <TypescriptFile\n      path={joinPaths(context.entryPath, \"changelog\", \"command.ts\")}\n      imports={{\n        \"node:os\": \"os\",\n        \"node:fs/promises\": [\"readFile\", \"writeFile\"]\n      }}\n      builtinImports={{\n        console: [\"textColors\", \"bold\", \"writeLine\", \"error\", \"warn\"]\n      }}>\n      <TSDoc heading=\"Options for the Changelog command.\" />\n      <InterfaceDeclaration export name=\"ChangelogOptions\">\n        <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        <InterfaceMember name=\"start\" optional type=\"string\" />\n        <Spacing />\n        <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.\">\n          <TSDocDefaultValue\n            type={ReflectionKind.string}\n            defaultValue=\"latest\"\n          />\n        </TSDoc>\n        <InterfaceMember name=\"end\" optional type=\"string\" />\n      </InterfaceDeclaration>\n      <Spacing />\n      <TSDoc heading={`Display the ${getAppTitle(context)} changelog.`}>\n        <TSDocParam name=\"options\">\n          {code`An object containing options for displaying the changelog.`}\n        </TSDocParam>\n      </TSDoc>\n      <FunctionDeclaration\n        export\n        default\n        async\n        name=\"handler\"\n        parameters={[{ name: \"options\", type: \"ChangelogOptions\" }]}>\n        <Show\n          when={!result.loading && !result.error}\n          fallback={\n            <Show when={!!result.error}>\n              {code` return error(\\`Failed to load changelog: ${result\n                .error!.message.replaceAll(\"\\\\\", \"\\\\\\\\\")\n                .replaceAll(\"`\", \"\\\\`\")\n                .replaceAll(\"${\", \"\\\\${\")\n                .replaceAll(\"\\n\", \"\\\\n\")\n                .replaceAll(\"\\r\", \"\\\\r\")\n                .replaceAll(\"\\t\", \"\\\\t\")}\\`); `}\n            </Show>\n          }>\n          <Show\n            when={!!result.data}\n            fallback={code` return warn(\"There is no changelog available for display.\"); `}>\n            {result.data}\n          </Show>\n        </Show>\n      </FunctionDeclaration>\n    </TypescriptFile>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAkCA,SAAS,mBAAwB;CACjC,MAAQ,UAAC,eAA6C;CACtD,MAAQ,SAAC,eAAuB,YAAY;EAC5C,MAAS,UAAW,MAAM,QAAQ,GAAC,KAAK,QAAA,OAAA,UAAA,KAAA;AACxC,MAAO,CAAA;AAGJ,SAAI,eAAmB,QAAQ;GAChC;AACF,QAAO,gBAAS,gBAAmB;EACjC,IAAM,OAAO;;;EAGX,SAAM;GACJ,WAAW;GACX,oBAAW,CAAA,YAAA,YAAA;GACb;oBAEA,SAAO;GAAA;GAAe;GAAQ;GAAA;GAAA;GAAA,EAC9B;;AAEF,UAAO;IAAA,gBAAA,OAAA,EACJ,SAAA,sCACC,CAAA;IAAI,gBAAY,sBAAoB;KACpC,UAAS;KACP,MAAM;KACN,IAAC,WAAQ;AACV,aAAA;OAAA,gBAAA,OAAA,EACD,SAAe,2QACb,CAAA;OAAA,gBAAwB,iBAAS;QACjC,MAAA;QACI,UAAU;QACf,MAAA;QACE,CAAA;OAAK,gBAAa,SAAS,EAAA,CAAQ;OAAC,gBAAgB,OAAU;QAC9D,SAAA;QACA,IAAO,WAAE;AACJ,gBAAC,gBAAqB,mBAAsB;UAC/C,IAAA,OAAA;AACO,kBAAA,eAAqB;;UAE5B,cAAA;UACI,CAAA;;QAEP,CAAA;OAAA,gBAAoB,iBAAA;QACrB,MAAS;QACJ,UAAU;QACb,MAAA;QACE,CAAA;OAAA;;KAEJ,CAAC;IAAA,gBAAK,SAAA,EAAA,CAAA;IAAA,gBAAA,OAAA;KACN,IAAA,UAAA;AACC,aAAA,eAAA,YAAA,QAAA,CAAA;;KAEA,IAAA,WAAA;AACA,aAAM,gBAAO,YAAA;OACb,MAAU;OACT,UAAA,IAAA;OACC,CAAA;;KAEH,CAAC;IAAE,gBAAgB,qBAAa;KAC/B,UAAO;KACP,WAAS;KACT,OAAO;KACP,MAAM;KACN,YAAS,CAAA;MACP,MAAM;MACN,MAAM;MACP,CAAC;KACF,IAAG,WAAA;AACD,aAAC,gBAAA,MAAA;OACC,IAAI,OAAI;AACR,eAAS,CAAC,OAAM,WAAY,CAAC,OAAM;;OAEnC,IAAI,WAAA;AACF,eAAA,gBAAA,MAAA;SACN,IAAA,OAAmB;AACrB,iBAAc,CAAA,CAAA,OAAA;;SAEpB,IAAA,WAAA"}

package/dist/helpers/resolve-changelog.cjs

@@ -0,0 +1,51 @@
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+let _stryke_path_join = require("@stryke/path/join");
+let powerlines_plugin_utils = require("powerlines/plugin-utils");
+let _stryke_path = require("@stryke/path");
+let node_fs = require("node:fs");
+
+//#region src/helpers/resolve-changelog.ts
+const CHANGELOG_FILE_EXTENSIONS = [
+	"md",
+	"markdown",
+	"txt"
+];
+const CHANGELOG_FILE_NAMES = [
+	"CHANGELOG",
+	"changelog",
+	"Changelog",
+	"RELEASE-NOTES",
+	"release-notes",
+	"Release-Notes",
+	"RELEASE_NOTES",
+	"release_notes",
+	"Release_Notes",
+	"RELEASES",
+	"releases",
+	"Releases",
+	"HISTORY",
+	"history",
+	"History"
+];
+function resolveChangelogFile(context, fileName) {
+	for (const ext of CHANGELOG_FILE_EXTENSIONS) if (fileName && (0, node_fs.existsSync)((0, powerlines_plugin_utils.replacePathTokens)(context, (0, _stryke_path_join.joinPaths)("{root}", (0, _stryke_path.appendExtension)(fileName, ext))))) return (0, _stryke_path_join.joinPaths)("{root}", (0, _stryke_path.appendExtension)(fileName, ext));
+}
+/**
+* Resolves the path to the changelog file based on the provided options and context. If a specific file is provided in the options, it will attempt to resolve that file first. If not, it will look for common changelog file names in the application's root directory.
+*
+* @param context - The unresolved context of the plugin, which includes information about the application's root directory and other relevant data for resolving paths.
+* @param options - The options provided for the changelog plugin, which may include a specific file name to look for.
+* @returns The resolved path to the changelog file if found, or undefined if no valid changelog file could be resolved.
+*/
+function resolveChangelog(context, options) {
+	let changelogFile = resolveChangelogFile(context, options.file);
+	if (changelogFile) return changelogFile;
+	for (const name of CHANGELOG_FILE_NAMES) {
+		changelogFile = resolveChangelogFile(context, name);
+		if (changelogFile) return changelogFile;
+	}
+	return changelogFile;
+}
+
+//#endregion
+exports.resolveChangelog = resolveChangelog;

package/dist/helpers/resolve-changelog.mjs

@@ -0,0 +1,51 @@
+import { joinPaths } from "@stryke/path/join";
+import { replacePathTokens } from "powerlines/plugin-utils";
+import { appendExtension } from "@stryke/path";
+import { existsSync } from "node:fs";
+
+//#region src/helpers/resolve-changelog.ts
+const CHANGELOG_FILE_EXTENSIONS = [
+	"md",
+	"markdown",
+	"txt"
+];
+const CHANGELOG_FILE_NAMES = [
+	"CHANGELOG",
+	"changelog",
+	"Changelog",
+	"RELEASE-NOTES",
+	"release-notes",
+	"Release-Notes",
+	"RELEASE_NOTES",
+	"release_notes",
+	"Release_Notes",
+	"RELEASES",
+	"releases",
+	"Releases",
+	"HISTORY",
+	"history",
+	"History"
+];
+function resolveChangelogFile(context, fileName) {
+	for (const ext of CHANGELOG_FILE_EXTENSIONS) if (fileName && existsSync(replacePathTokens(context, joinPaths("{root}", appendExtension(fileName, ext))))) return joinPaths("{root}", appendExtension(fileName, ext));
+}
+/**
+* Resolves the path to the changelog file based on the provided options and context. If a specific file is provided in the options, it will attempt to resolve that file first. If not, it will look for common changelog file names in the application's root directory.
+*
+* @param context - The unresolved context of the plugin, which includes information about the application's root directory and other relevant data for resolving paths.
+* @param options - The options provided for the changelog plugin, which may include a specific file name to look for.
+* @returns The resolved path to the changelog file if found, or undefined if no valid changelog file could be resolved.
+*/
+function resolveChangelog(context, options) {
+	let changelogFile = resolveChangelogFile(context, options.file);
+	if (changelogFile) return changelogFile;
+	for (const name of CHANGELOG_FILE_NAMES) {
+		changelogFile = resolveChangelogFile(context, name);
+		if (changelogFile) return changelogFile;
+	}
+	return changelogFile;
+}
+
+//#endregion
+export { resolveChangelog };
+//# sourceMappingURL=resolve-changelog.mjs.map

package/dist/helpers/resolve-changelog.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-changelog.mjs","names":[],"sources":["../../src/helpers/resolve-changelog.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 { UnresolvedContext } from \"@shell-shock/core\";\nimport { appendExtension } from \"@stryke/path\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { existsSync } from \"node:fs\";\nimport { replacePathTokens } from \"powerlines/plugin-utils\";\nimport type { ChangelogPluginOptions } from \"../types/plugin\";\n\nconst CHANGELOG_FILE_EXTENSIONS = [\"md\", \"markdown\", \"txt\"] as const;\n\nconst CHANGELOG_FILE_NAMES = [\n  \"CHANGELOG\",\n  \"changelog\",\n  \"Changelog\",\n  \"RELEASE-NOTES\",\n  \"release-notes\",\n  \"Release-Notes\",\n  \"RELEASE_NOTES\",\n  \"release_notes\",\n  \"Release_Notes\",\n  \"RELEASES\",\n  \"releases\",\n  \"Releases\",\n  \"HISTORY\",\n  \"history\",\n  \"History\"\n] as const;\n\nfunction resolveChangelogFile(\n  context: UnresolvedContext,\n  fileName?: string\n): string | undefined {\n  for (const ext of CHANGELOG_FILE_EXTENSIONS) {\n    if (\n      fileName &&\n      existsSync(\n        replacePathTokens(\n          context,\n          joinPaths(\"{root}\", appendExtension(fileName, ext))\n        )\n      )\n    ) {\n      return joinPaths(\"{root}\", appendExtension(fileName, ext));\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Resolves the path to the changelog file based on the provided options and context. If a specific file is provided in the options, it will attempt to resolve that file first. If not, it will look for common changelog file names in the application's root directory.\n *\n * @param context - The unresolved context of the plugin, which includes information about the application's root directory and other relevant data for resolving paths.\n * @param options - The options provided for the changelog plugin, which may include a specific file name to look for.\n * @returns The resolved path to the changelog file if found, or undefined if no valid changelog file could be resolved.\n */\nexport function resolveChangelog(\n  context: UnresolvedContext,\n  options: ChangelogPluginOptions\n): string | undefined {\n  let changelogFile = resolveChangelogFile(context, options.file);\n  if (changelogFile) {\n    return changelogFile;\n  }\n\n  for (const name of CHANGELOG_FILE_NAMES) {\n    changelogFile = resolveChangelogFile(context, name);\n    if (changelogFile) {\n      return changelogFile;\n    }\n  }\n\n  return changelogFile;\n}\n"],"mappings":";;;;;;AAyBA,MAAM,4BAA4B;CAAC;CAAM;CAAY;CAAM;AAE3D,MAAM,uBAAuB;CAC3B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,SAAS,qBACP,SACA,UACoB;AACpB,MAAK,MAAM,OAAO,0BAChB,KACE,YACA,WACE,kBACE,SACA,UAAU,UAAU,gBAAgB,UAAU,IAAI,CAAC,CACpD,CACF,CAED,QAAO,UAAU,UAAU,gBAAgB,UAAU,IAAI,CAAC;;;;;;;;;AAchE,SAAgB,iBACd,SACA,SACoB;CACpB,IAAI,gBAAgB,qBAAqB,SAAS,QAAQ,KAAK;AAC/D,KAAI,cACF,QAAO;AAGT,MAAK,MAAM,QAAQ,sBAAsB;AACvC,kBAAgB,qBAAqB,SAAS,KAAK;AACnD,MAAI,cACF,QAAO;;AAIX,QAAO"}

package/dist/index.cjs

@@ -2,6 +2,7 @@ Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toString
 const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
 const require_components_changelog_command = require('./components/changelog-command.cjs');
 require('./components/index.cjs');
+const require_resolve_changelog = require('./helpers/resolve-changelog.cjs');
 let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
 let _powerlines_plugin_alloy_render = require("@powerlines/plugin-alloy/render");
 let _shell_shock_core_plugin_utils = require("@shell-shock/core/plugin-utils");
@@ -20,30 +21,41 @@ const plugin = (options = {}) => {
 		name: "shell-shock:changelog",
 		config() {
 			this.debug("Providing default configuration for the Shell Shock `changelog` plugin.");
-			return { changelog: (0, defu.default)({ command: { name: (0, _stryke_type_checks_is_set_string.isSetString)(options.command) ? options.command : "changelog" } }, options, { file: (0, _stryke_path_join.joinPaths)("{root}", "CHANGELOG.md") }) };
+			return { changelog: (0, defu.default)({
+				file: require_resolve_changelog.resolveChangelog(this, options),
+				command: { name: (0, _stryke_type_checks_is_set_string.isSetString)(options.command) ? options.command : "changelog" }
+			}, options) };
 		},
 		configResolved() {
 			this.debug("Adding the CLI changelog commands to the application context.");
-			this.config.changelog.file = (0, powerlines_plugin_utils.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 ${(0, _shell_shock_core_plugin_utils.getAppTitle)(this)} changelog.`,
-				entry: {
-					file: (0, _stryke_path_join.joinPaths)(this.entryPath, "changelog", "index.ts"),
-					input: { file: (0, _stryke_path_join.joinPaths)(this.entryPath, "changelog", "command.ts") }
-				},
-				isVirtual: false,
-				...this.config.changelog.command
-			});
+			if ((0, _stryke_type_checks_is_set_string.isSetString)(this.config.changelog.file)) {
+				this.config.changelog.file = (0, powerlines_plugin_utils.replacePathTokens)(this, this.config.changelog.file);
+				if (!this.fs.existsSync(this.config.changelog.file)) {
+					this.warn(`The changelog file could not be found at the resolved path: ${this.config.changelog.file}. The \`${this.config.changelog.command.name}\` command will not be added to the application. Please ensure that the changelog file exists at the specified path or adjust the \`changelog.file\` option to point to the correct location.`);
+					return;
+				}
+				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 ${(0, _shell_shock_core_plugin_utils.getAppTitle)(this)} changelog.`,
+					entry: {
+						file: (0, _stryke_path_join.joinPaths)(this.entryPath, "changelog", "index.ts"),
+						input: { file: (0, _stryke_path_join.joinPaths)(this.entryPath, "changelog", "command.ts") }
+					},
+					isVirtual: false,
+					source: "changelog-plugin",
+					...this.config.changelog.command
+				});
+			}
 		},
 		async prepare() {
+			if ((0, _stryke_type_checks_is_set_string.isSetString)(this.config.changelog.file) && !this.fs.existsSync(this.config.changelog.file)) return;
 			this.debug("Rendering changelog command module for the Shell Shock `changelog` plugin.");
 			return (0, _powerlines_plugin_alloy_render.render)(this, (0, _alloy_js_core_jsx_runtime.createComponent)(require_components_changelog_command.ChangelogCommand, {}));
 		}

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.tsx"],"mappings":";;;;;;AAoCA;cAAa,MAAA,oBACM,sBAAA,GAAyB,sBAAA,EAE1C,OAAA,GAAS,sBAAA,KACR,MAAA,CAAO,QAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.tsx"],"mappings":";;;;;;AAqCA;cAAa,MAAA,oBACM,sBAAA,GAAyB,sBAAA,EAE1C,OAAA,GAAS,sBAAA,KACR,MAAA,CAAO,QAAA"}

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.tsx"],"mappings":";;;;;;AAoCA;cAAa,MAAA,oBACM,sBAAA,GAAyB,sBAAA,EAE1C,OAAA,GAAS,sBAAA,KACR,MAAA,CAAO,QAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.tsx"],"mappings":";;;;;;AAqCA;cAAa,MAAA,oBACM,sBAAA,GAAyB,sBAAA,EAE1C,OAAA,GAAS,sBAAA,KACR,MAAA,CAAO,QAAA"}

package/dist/index.mjs

@@ -1,5 +1,6 @@
 import { ChangelogCommand } from "./components/changelog-command.mjs";
 import "./components/index.mjs";
+import { resolveChangelog } from "./helpers/resolve-changelog.mjs";
 import { createComponent } from "@alloy-js/core/jsx-runtime";
 import { render } from "@powerlines/plugin-alloy/render";
 import { getAppTitle } from "@shell-shock/core/plugin-utils";
@@ -17,30 +18,41 @@ const plugin = (options = {}) => {
 		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") }) };
+			return { changelog: defu({
+				file: resolveChangelog(this, options),
+				command: { name: isSetString(options.command) ? options.command : "changelog" }
+			}, options) };
 		},
 		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
-			});
+			if (isSetString(this.config.changelog.file)) {
+				this.config.changelog.file = replacePathTokens(this, this.config.changelog.file);
+				if (!this.fs.existsSync(this.config.changelog.file)) {
+					this.warn(`The changelog file could not be found at the resolved path: ${this.config.changelog.file}. The \`${this.config.changelog.command.name}\` command will not be added to the application. Please ensure that the changelog file exists at the specified path or adjust the \`changelog.file\` option to point to the correct location.`);
+					return;
+				}
+				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,
+					source: "changelog-plugin",
+					...this.config.changelog.command
+				});
+			}
 		},
 		async prepare() {
+			if (isSetString(this.config.changelog.file) && !this.fs.existsSync(this.config.changelog.file)) return;
 			this.debug("Rendering changelog command module for the Shell Shock `changelog` plugin.");
 			return render(this, createComponent(ChangelogCommand, {}));
 		}

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 { 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 type { Plugin } from \"powerlines\";\nimport { replacePathTokens } from \"powerlines/plugin-utils\";\nimport { ChangelogCommand } from \"./components\";\nimport type {\n  ChangelogPluginContext,\n  ChangelogPluginOptions\n} from \"./types/plugin\";\n\nexport type * from \"./types\";\n\n/**\n * The Changelog - Shell Shock plugin to add version check functionality and changelog commands to a Shell Shock application.\n */\nexport const plugin = <\n  TContext extends ChangelogPluginContext = ChangelogPluginContext\n>(\n  options: ChangelogPluginOptions = {}\n): Plugin<TContext> => {\n  return {\n    name: \"shell-shock:changelog\",\n    config() {\n      this.debug(\n        \"Providing default configuration for the Shell Shock `changelog` plugin.\"\n      );\n\n      return {\n        changelog: defu(\n          {\n            command: {\n              name: isSetString(options.command) ? options.command : \"changelog\"\n            }\n          },\n          options,\n          {\n            file: joinPaths(\"{root}\", \"CHANGELOG.md\")\n          }\n        )\n      };\n    },\n    configResolved() {\n      this.debug(\n        \"Adding the CLI changelog commands to the application context.\"\n      );\n\n      this.config.changelog.file = replacePathTokens(\n        this,\n        this.config.changelog.file\n      );\n\n      this.inputs ??= [];\n      if (\n        this.inputs.some(\n          input => input.id === this.config.changelog.command.name\n        )\n      ) {\n        this.info(\n          \"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        );\n      } else {\n        this.inputs.push({\n          id: this.config.changelog.command.name,\n          path: this.config.changelog.command.name,\n          segments: [this.config.changelog.command.name],\n          title: \"Changelog\",\n          icon: \"🗃\",\n          tags: [\"Utility\"],\n          description: `Display the ${getAppTitle(this)} changelog.`,\n          entry: {\n            file: joinPaths(this.entryPath, \"changelog\", \"index.ts\"),\n            input: {\n              file: joinPaths(this.entryPath, \"changelog\", \"command.ts\")\n            }\n          },\n          isVirtual: false,\n          ...this.config.changelog.command\n        });\n      }\n    },\n    async prepare() {\n      this.debug(\n        \"Rendering changelog command module for the Shell Shock `changelog` plugin.\"\n      );\n\n      return render(this, <ChangelogCommand />);\n    }\n  };\n};\n\nexport default plugin;\n"],"mappings":";;;;;;;;;;;;;;AAiCA,MAAE,UAAA,UAAA,EAAA,KAAA;AACA,QAAK;EACL,MAAA;EACF,SAAa;AACX,QAAS,MAAA,0EAAiC;AAC3C,UAAA,EACC,WAAS,KAAA,EACD,SAAS,EACV,MAAA,YAAA,QAAA,QAAA,GAAA,QAAA,UAAA,aACE,EACP,EAAO,SAAE,EACH,MAAM,UAAA,UAAA,eAAA,EACP,CAAA,EACF;;EAEH,iBAAS;AACP,QAAE,MAAS,gEAAM;AACjB,QAAI,OAAA,UAAA,OAAA,kBAAA,MAAA,KAAA,OAAA,UAAA,KAAA;AACJ,QAAK,WAAU,EAAA;AACf,OAAI,KAAI,OAAM,MAAA,UAAY,MAAQ,OAAS,KAAE,OAAQ,UAAW,QAAS,KAAA,CACvE,MAAI,KAAA,0MAAA;OAEJ,MAAE,OAAO,KAAA;IACP,IAAA,KAAA,OAAA,UAAA,QAAA;IACA,MAAM,KAAE,OAAU,UAAU,QAAC;IAC7B,UAAA,CAAA,KAAA,OAAA,UAAA,QAAA,KAAA;IACF,OAAA;IACD,MAAA;IACF,MAAA,CAAA,UAAA;IACD,aAAiB,eAAA,YAAA,KAAA,CAAA;IACX,OAAM;KACP,MAAO,UAAQ,KAAS,WAAU,aAAO,WAAY;KACvD,OAAA,8DAEI;KACH;IACA,WAAY;IACb,GAAA,KAAA,OAAA,UAAA;;;EAIH,MAAI,UAAY;AACd,QAAI,MAAO,6EAA6C;AACxD,UAAE,OAAA,MAAA,gBAAA,kBAAA,EAAA,CAAA,CAAA;;EAEL"}
+{"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 { 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 type { Plugin } from \"powerlines\";\nimport { replacePathTokens } from \"powerlines/plugin-utils\";\nimport { ChangelogCommand } from \"./components\";\nimport { resolveChangelog } from \"./helpers/resolve-changelog\";\nimport type {\n  ChangelogPluginContext,\n  ChangelogPluginOptions\n} from \"./types/plugin\";\n\nexport type * from \"./types\";\n\n/**\n * The Changelog - Shell Shock plugin to add version check functionality and changelog commands to a Shell Shock application.\n */\nexport const plugin = <\n  TContext extends ChangelogPluginContext = ChangelogPluginContext\n>(\n  options: ChangelogPluginOptions = {}\n): Plugin<TContext> => {\n  return {\n    name: \"shell-shock:changelog\",\n    config() {\n      this.debug(\n        \"Providing default configuration for the Shell Shock `changelog` plugin.\"\n      );\n\n      return {\n        changelog: defu(\n          {\n            file: resolveChangelog(this, options),\n            command: {\n              name: isSetString(options.command) ? options.command : \"changelog\"\n            }\n          },\n          options\n        )\n      };\n    },\n    configResolved() {\n      this.debug(\n        \"Adding the CLI changelog commands to the application context.\"\n      );\n\n      if (isSetString(this.config.changelog.file)) {\n        this.config.changelog.file = replacePathTokens(\n          this,\n          this.config.changelog.file\n        );\n\n        if (!this.fs.existsSync(this.config.changelog.file)) {\n          this.warn(\n            `The changelog file could not be found at the resolved path: ${\n              this.config.changelog.file\n            }. The \\`${\n              this.config.changelog.command.name\n            }\\` command will not be added to the application. Please ensure that the changelog file exists at the specified path or adjust the \\`changelog.file\\` option to point to the correct location.`\n          );\n          return;\n        }\n\n        this.inputs ??= [];\n        if (\n          this.inputs.some(\n            input => input.id === this.config.changelog.command.name\n          )\n        ) {\n          this.info(\n            \"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          );\n        } else {\n          this.inputs.push({\n            id: this.config.changelog.command.name,\n            path: this.config.changelog.command.name,\n            segments: [this.config.changelog.command.name],\n            title: \"Changelog\",\n            icon: \"🗃\",\n            tags: [\"Utility\"],\n            description: `Display the ${getAppTitle(this)} changelog.`,\n            entry: {\n              file: joinPaths(this.entryPath, \"changelog\", \"index.ts\"),\n              input: {\n                file: joinPaths(this.entryPath, \"changelog\", \"command.ts\")\n              }\n            },\n            isVirtual: false,\n            source: \"changelog-plugin\",\n            ...this.config.changelog.command\n          });\n        }\n      }\n    },\n    async prepare() {\n      if (\n        isSetString(this.config.changelog.file) &&\n        !this.fs.existsSync(this.config.changelog.file)\n      ) {\n        return;\n      }\n\n      this.debug(\n        \"Rendering changelog command module for the Shell Shock `changelog` plugin.\"\n      );\n\n      return render(this, <ChangelogCommand />);\n    }\n  };\n};\n\nexport default plugin;\n"],"mappings":";;;;;;;;;;;;;;;AAkCA,MAAE,UAAA,UAAA,EAAA,KAAA;AACA,QAAK;EACL,MAAA;EACF,SAAa;AACX,QAAS,MAAA,0EAAiC;AAC3C,UAAA,EACC,WAAS,KAAA;IACD,MAAA,iBAAa,MAAA,QAAA;IACd,SAAA,EACE,MAAM,YAAM,QAAU,QAAA,GAAA,QAAA,UAAA,aACtB;IACL,EAAK,QAAK,EACT;;;AAGD,QAAA,MAAO,gEAAA;AACP,OAAE,YAAW,KAAI,OAAA,UAAA,KAAA,EAAA;AACf,SAAE,OAAA,UAAA,OAAA,kBAAA,MAAA,KAAA,OAAA,UAAA,KAAA;AACF,QAAI,CAAA,KAAM,GAAA,WAAA,KAAiB,OAAM,UAAQ,KAAA,EAAA;AACvC,UAAE,KAAQ,+DAAC,KAAA,OAAA,UAAA,KAAA,UAAA,KAAA,OAAA,UAAA,QAAA,KAAA,+LAAA;AACX;;AAEF,SAAG,WAAA,EAAA;AACH,QAAE,KAAA,OAAA,MAAA,UAAA,MAAA,OAAA,KAAA,OAAA,UAAA,QAAA,KAAA,CACF,MAAA,KAAA,0MAAA;QAEH,MAAA,OAAA,KAAA;KACD,IAAA,KAAiB,OAAA,UAAA,QAAA;KACV,MAAK,KAAA,OAAA,UAAA,QAAA;KACP,UAAW,CAAG,KAAC,OAAU,UAAW,QAAK,KAAA;KAC3C,OAAA;;KAEG,MAAA,CAAA,UAAiB;KACf,aAAQ,eAAiB,YAAA,KAAiB,CAAA;KAC5C,OAAI;MACA,MAAC,UAAO,KAAU,WAAA,aAAA,WAAA;MACvB,OAAA,8DAEI;MACH;KACE,WAAK;KACL,QAAO;KACP,GAAG,KAAK,OAAE,UAAA;KACX,CAAC;;;EAIR,MAAI,UAAA;kGAEA;AAEF,QAAI,MAAK,6EAAW;AACpB,UAAM,OAAQ,MAAM,gBAAa,kBAAiB,EAAQ,CAAA,CAAA;;EAE7D"}

package/dist/types/plugin.d.cts

@@ -6,6 +6,54 @@ 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.
    *
+   * @remarks
+   * If not provided, the plugin will attempt to resolve the changelog file by looking for common changelog file names (e.g., `CHANGELOG.md`, `RELEASE-NOTES.md`, etc.) in the application's root directory. If a specific file name is provided but cannot be found, it will fall back to looking for common changelog file names. If no valid changelog file can be resolved, the `changelog` command will not be added to the application. The following list of common changelog file names will be used for resolution:
+   * - `CHANGELOG.md`
+   * - `changelog.md`
+   * - `Changelog.md`
+   * - `CHANGELOG.markdown`
+   * - `changelog.markdown`
+   * - `Changelog.markdown`
+   * - `CHANGELOG.txt`
+   * - `changelog.txt`
+   * - `Changelog.txt`
+   * - `RELEASE-NOTES.md`
+   * - `release-notes.md`
+   * - `Release-Notes.md`
+   * - `RELEASE-NOTES.markdown`
+   * - `release-notes.markdown`
+   * - `Release-Notes.markdown`
+   * - `RELEASE-NOTES.txt`
+   * - `release-notes.txt`
+   * - `Release-Notes.txt`
+   * - `RELEASE_NOTES.md`
+   * - `release_notes.md`
+   * - `Release_Notes.md`
+   * - `RELEASE_NOTES.markdown`
+   * - `release_notes.markdown`
+   * - `Release_Notes.markdown`
+   * - `RELEASE_NOTES.txt`
+   * - `release_notes.txt`
+   * - `Release_Notes.txt`
+   * - `RELEASES.md`
+   * - `releases.md`
+   * - `Releases.md`
+   * - `RELEASES.markdown`
+   * - `releases.markdown`
+   * - `Releases.markdown`
+   * - `RELEASES.txt`
+   * - `releases.txt`
+   * - `Releases.txt`
+   * - `HISTORY.md`
+   * - `history.md`
+   * - `History.md`
+   * - `HISTORY.markdown`
+   * - `history.markdown`
+   * - `History.markdown`
+   * - `HISTORY.txt`
+   * - `history.txt`
+   * - `History.txt`
+   *
    * @defaultValue "\{root\}/CHANGELOG.md"
    */
   file?: string;

package/dist/types/plugin.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.cts","names":[],"sources":["../../src/types/plugin.ts"],"mappings":";;;;UA0BiB,sBAAA;;AAAjB;;;;EAME,IAAA;EAUA;;;;;AAGF;;;EAHE,OAAA,GAAU,OAAA,CAAQ,aAAA;AAAA;AAAA,KAGR,yBAAA,GAA4B,UAAA;EAI3B;;;EAAX,SAAA,EAAW,sBAAA;AAAA;AAAA,KAGD,6BAAA,GAAgC,cAAA;EAAA;;;EAI1C,SAAA,EAAW,QAAA,CAAS,IAAA,CAAK,sBAAA;IAIO;;;IAA9B,OAAA,EAAS,YAAA,CAAa,OAAA,CAAQ,aAAA;EAAA;AAAA;AAAA,KAItB,sBAAA,yBACc,6BAAA,GACtB,6BAAA,IACA,OAAA,CAAQ,eAAA"}
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../../src/types/plugin.ts"],"mappings":";;;;UA0BiB,sBAAA;;AAAjB;;;;;;;;;;AAmEA;;;;;;;;;AAOA;;;;;;;;;;;;;;;;;;;;;;;AAYA;;;;;;;;;;EAhCE,IAAA;EAkCE;;;;;;;;EAxBF,OAAA,GAAU,OAAA,CAAQ,aAAA;AAAA;AAAA,KAGR,yBAAA,GAA4B,UAAA;;;;EAItC,SAAA,EAAW,sBAAA;AAAA;AAAA,KAGD,6BAAA,GAAgC,cAAA;;;;EAI1C,SAAA,EAAW,QAAA,CAAS,IAAA,CAAK,sBAAA;;;;IAIvB,OAAA,EAAS,YAAA,CAAa,OAAA,CAAQ,aAAA;EAAA;AAAA;AAAA,KAItB,sBAAA,yBACc,6BAAA,GACtB,6BAAA,IACA,OAAA,CAAQ,eAAA"}

package/dist/types/plugin.d.mts

@@ -6,6 +6,54 @@ 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.
    *
+   * @remarks
+   * If not provided, the plugin will attempt to resolve the changelog file by looking for common changelog file names (e.g., `CHANGELOG.md`, `RELEASE-NOTES.md`, etc.) in the application's root directory. If a specific file name is provided but cannot be found, it will fall back to looking for common changelog file names. If no valid changelog file can be resolved, the `changelog` command will not be added to the application. The following list of common changelog file names will be used for resolution:
+   * - `CHANGELOG.md`
+   * - `changelog.md`
+   * - `Changelog.md`
+   * - `CHANGELOG.markdown`
+   * - `changelog.markdown`
+   * - `Changelog.markdown`
+   * - `CHANGELOG.txt`
+   * - `changelog.txt`
+   * - `Changelog.txt`
+   * - `RELEASE-NOTES.md`
+   * - `release-notes.md`
+   * - `Release-Notes.md`
+   * - `RELEASE-NOTES.markdown`
+   * - `release-notes.markdown`
+   * - `Release-Notes.markdown`
+   * - `RELEASE-NOTES.txt`
+   * - `release-notes.txt`
+   * - `Release-Notes.txt`
+   * - `RELEASE_NOTES.md`
+   * - `release_notes.md`
+   * - `Release_Notes.md`
+   * - `RELEASE_NOTES.markdown`
+   * - `release_notes.markdown`
+   * - `Release_Notes.markdown`
+   * - `RELEASE_NOTES.txt`
+   * - `release_notes.txt`
+   * - `Release_Notes.txt`
+   * - `RELEASES.md`
+   * - `releases.md`
+   * - `Releases.md`
+   * - `RELEASES.markdown`
+   * - `releases.markdown`
+   * - `Releases.markdown`
+   * - `RELEASES.txt`
+   * - `releases.txt`
+   * - `Releases.txt`
+   * - `HISTORY.md`
+   * - `history.md`
+   * - `History.md`
+   * - `HISTORY.markdown`
+   * - `history.markdown`
+   * - `History.markdown`
+   * - `HISTORY.txt`
+   * - `history.txt`
+   * - `History.txt`
+   *
    * @defaultValue "\{root\}/CHANGELOG.md"
    */
   file?: string;

package/dist/types/plugin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.mts","names":[],"sources":["../../src/types/plugin.ts"],"mappings":";;;;UA0BiB,sBAAA;;AAAjB;;;;EAME,IAAA;EAUA;;;;;AAGF;;;EAHE,OAAA,GAAU,OAAA,CAAQ,aAAA;AAAA;AAAA,KAGR,yBAAA,GAA4B,UAAA;EAI3B;;;EAAX,SAAA,EAAW,sBAAA;AAAA;AAAA,KAGD,6BAAA,GAAgC,cAAA;EAAA;;;EAI1C,SAAA,EAAW,QAAA,CAAS,IAAA,CAAK,sBAAA;IAIO;;;IAA9B,OAAA,EAAS,YAAA,CAAa,OAAA,CAAQ,aAAA;EAAA;AAAA;AAAA,KAItB,sBAAA,yBACc,6BAAA,GACtB,6BAAA,IACA,OAAA,CAAQ,eAAA"}
+{"version":3,"file":"plugin.d.mts","names":[],"sources":["../../src/types/plugin.ts"],"mappings":";;;;UA0BiB,sBAAA;;AAAjB;;;;;;;;;;AAmEA;;;;;;;;;AAOA;;;;;;;;;;;;;;;;;;;;;;;AAYA;;;;;;;;;;EAhCE,IAAA;EAkCE;;;;;;;;EAxBF,OAAA,GAAU,OAAA,CAAQ,aAAA;AAAA;AAAA,KAGR,yBAAA,GAA4B,UAAA;;;;EAItC,SAAA,EAAW,sBAAA;AAAA;AAAA,KAGD,6BAAA,GAAgC,cAAA;;;;EAI1C,SAAA,EAAW,QAAA,CAAS,IAAA,CAAK,sBAAA;;;;IAIvB,OAAA,EAAS,YAAA,CAAa,OAAA,CAAQ,aAAA;EAAA;AAAA;AAAA,KAItB,sBAAA,yBACc,6BAAA,GACtB,6BAAA,IACA,OAAA,CAAQ,eAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shell-shock/plugin-changelog",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "private": false,
   "description": "A package containing a Shell Shock plugin to manage upgrading the local application's version.",
   "keywords": [
@@ -125,19 +125,19 @@
   "dependencies": {
     "@alloy-js/core": "0.23.0-dev.8",
     "@alloy-js/typescript": "0.23.0-dev.4",
-    "@powerlines/deepkit": "^0.6.167",
-    "@powerlines/plugin-alloy": "^0.26.10",
-    "@powerlines/plugin-plugin": "^0.12.344",
-    "@shell-shock/core": "^0.17.2",
-    "@shell-shock/unified": "^0.2.0",
+    "@powerlines/deepkit": "^0.8.0",
+    "@powerlines/plugin-alloy": "^0.26.15",
+    "@powerlines/plugin-plugin": "^0.12.347",
+    "@shell-shock/core": "^0.17.3",
+    "@shell-shock/unified": "^0.2.1",
     "@stryke/path": "^0.27.4",
     "@stryke/type-checks": "^0.6.1",
     "@stryke/types": "^0.11.3",
     "defu": "^6.1.7",
-    "powerlines": "^0.42.34"
+    "powerlines": "^0.42.37"
   },
   "devDependencies": {
-    "@powerlines/plugin-deepkit": "^0.11.272",
+    "@powerlines/plugin-deepkit": "^0.11.277",
     "@types/node": "^25.6.0"
   },
   "publishConfig": {
@@ -155,5 +155,5 @@
       "./package.json": "./package.json"
     }
   },
-  "gitHead": "38e2393cfc876607226b05a59cc9bd62e3b59960"
+  "gitHead": "d6ec6746792a83206915332c4eb87c9da70a5148"
 }