@shell-shock/core 0.10.0 → 0.12.0

package/dist/plugin-utils/description-helpers.cjs

@@ -0,0 +1,105 @@
+
+//#region src/plugin-utils/description-helpers.ts
+const __ΩFormatDescriptionOptions = [
+	"replaceNewlines",
+	true,
+	"collapseWhitespace",
+	"FormatDescriptionOptions",
+	"P)4!8>\")4#8>\"Mw$y"
+];
+/**
+* Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.
+*
+* @remarks
+* This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.
+*
+* @param description - The full description string.
+* @returns The formatted description string.
+*/
+function formatDescriptionWhitespace(description, options = {}) {
+	let formattedDescription = description.trim();
+	if (options.replaceNewlines) formattedDescription = formattedDescription.replace(/\s*\n\s*/g, " ");
+	if (options.collapseWhitespace) formattedDescription = formattedDescription.replace(/\s{2,}/g, " ");
+	return formattedDescription.trim();
+}
+formatDescriptionWhitespace.__type = [
+	"description",
+	() => __ΩFormatDescriptionOptions,
+	"options",
+	() => ({}),
+	"formatDescriptionWhitespace",
+	"P&2!n\"2#>$&/%"
+];
+/**
+* Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.
+*
+* @remarks
+* This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.
+*
+* @param description - The full description string.
+* @returns The formatted description string.
+*/
+function formatDescriptionEscapes(description) {
+	return description.replaceAll("'", "\\'").replaceAll("\"", "\\\"").replaceAll("`", "\\`").replace(/\$\{/g, "\\${");
+}
+formatDescriptionEscapes.__type = [
+	"description",
+	"formatDescriptionEscapes",
+	"P&2!&/\""
+];
+/**
+* Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.
+*
+* @remarks
+* This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.
+*
+* @param description - The full description string.
+* @returns The formatted description string.
+*/
+function formatDescription(description, options = {}) {
+	return formatDescriptionEscapes(formatDescriptionWhitespace(description, options));
+}
+formatDescription.__type = [
+	"description",
+	() => __ΩFormatDescriptionOptions,
+	"options",
+	() => ({}),
+	"formatDescription",
+	"P&2!n\"2#>$&/%"
+];
+const __ΩFormatShortDescriptionOptions = [
+	() => __ΩFormatDescriptionOptions,
+	"length",
+	60,
+	"FormatShortDescriptionOptions",
+	"Pn!'4\"8>#Mw$y"
+];
+/**
+* Extracts the short description from a longer description string. The short description is typically the first sentence or the first line of the description.
+*
+* @param description - The full description string.
+* @param options - Options for formatting the short description, including the maximum length.
+* @returns The extracted short description.
+*/
+function formatShortDescription(description, options = {}) {
+	const length = options.length ?? 60;
+	const formattedDescription = formatDescriptionWhitespace(description, options);
+	let result = ((formattedDescription.indexOf("\n") < length + 1 || formattedDescription.search(/[.!?\n]\s*\S/) > length + 1 ? formattedDescription.trim().match(/^.*[.!?\n]\s?\S/)?.[0]?.trim()?.slice(0, -1)?.trim() : void 0) || formattedDescription).trim();
+	if (result.trim().length > length) result = `${result.substring(0, Math.max(0, length - 3)).trim()}...`;
+	return formatDescriptionEscapes(result);
+}
+formatShortDescription.__type = [
+	"description",
+	() => __ΩFormatShortDescriptionOptions,
+	"options",
+	() => ({}),
+	"formatShortDescription",
+	"P&2!n\"2#>$&/%"
+];
+
+//#endregion
+exports.__ΩFormatDescriptionOptions = __ΩFormatDescriptionOptions;
+exports.__ΩFormatShortDescriptionOptions = __ΩFormatShortDescriptionOptions;
+exports.formatDescription = formatDescription;
+exports.formatShortDescription = formatShortDescription;
+//# sourceMappingURL=description-helpers.cjs.map

package/dist/plugin-utils/description-helpers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"description-helpers.cjs","names":[],"sources":["../../src/plugin-utils/description-helpers.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\nexport interface FormatDescriptionOptions {\n  /**\n   * If true, replaces newlines in the description with spaces. This is useful for ensuring that descriptions are displayed as a single line in contexts where multiline descriptions may not be supported or may cause formatting issues.\n   *\n   * @defaultValue false\n   */\n  replaceNewlines?: boolean;\n\n  /**\n   * If true, collapses multiple consecutive spaces in the description into a single space. This helps to ensure that descriptions are concise and do not contain unnecessary whitespace.\n   *\n   * @defaultValue false\n   */\n  collapseWhitespace?: boolean;\n}\n\n/**\n * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.\n *\n * @remarks\n * This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.\n *\n * @param description - The full description string.\n * @returns The formatted description string.\n */\nfunction formatDescriptionWhitespace(\n  description: string,\n  options: FormatDescriptionOptions = {}\n): string {\n  let formattedDescription = description.trim();\n  if (options.replaceNewlines) {\n    formattedDescription = formattedDescription.replace(/\\s*\\n\\s*/g, \" \");\n  }\n  if (options.collapseWhitespace) {\n    formattedDescription = formattedDescription.replace(/\\s{2,}/g, \" \");\n  }\n\n  return formattedDescription.trim();\n}\n\n/**\n * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.\n *\n * @remarks\n * This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.\n *\n * @param description - The full description string.\n * @returns The formatted description string.\n */\nfunction formatDescriptionEscapes(description: string): string {\n  return description\n    .replaceAll(\"'\", \"\\\\'\")\n    .replaceAll('\"', '\\\\\"')\n    .replaceAll(\"`\", \"\\\\`\")\n    .replace(/\\$\\{/g, \"\\\\${\");\n}\n\n/**\n * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.\n *\n * @remarks\n * This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.\n *\n * @param description - The full description string.\n * @returns The formatted description string.\n */\nexport function formatDescription(\n  description: string,\n  options: FormatDescriptionOptions = {}\n): string {\n  return formatDescriptionEscapes(\n    formatDescriptionWhitespace(description, options)\n  );\n}\n\nexport interface FormatShortDescriptionOptions extends FormatDescriptionOptions {\n  /**\n   * The maximum length of the short description. If the first sentence exceeds this length, it will be truncated.\n   *\n   * @defaultValue 60\n   */\n  length?: number;\n}\n\n/**\n * Extracts the short description from a longer description string. The short description is typically the first sentence or the first line of the description.\n *\n * @param description - The full description string.\n * @param options - Options for formatting the short description, including the maximum length.\n * @returns The extracted short description.\n */\nexport function formatShortDescription(\n  description: string,\n  options: FormatShortDescriptionOptions = {}\n): string {\n  const length = options.length ?? 60;\n  const formattedDescription = formatDescriptionWhitespace(\n    description,\n    options\n  );\n\n  const firstSentenceMatch =\n    formattedDescription.indexOf(\"\\n\") < length + 1 ||\n    formattedDescription.search(/[.!?\\n]\\s*\\S/) > length + 1\n      ? formattedDescription\n          .trim()\n          .match(/^.*[.!?\\n]\\s?\\S/)?.[0]\n          ?.trim()\n          ?.slice(0, -1)\n          ?.trim()\n      : undefined;\n\n  let result = (firstSentenceMatch || formattedDescription).trim();\n  if (result.trim().length > length) {\n    result = `${result.substring(0, Math.max(0, length - 3)).trim()}...`;\n  }\n\n  return formatDescriptionEscapes(result);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AA4BA,SAAG,4BAAA,aAAA,UAAA,EAAA,EAAA;CACC,IAAI,uBAAe,YAAA,MAAA;AACnB,KAAA,QAAA,gBACI,wBAAsB,qBAAA,QAAA,aAAA,IAAA;gCAG5B,wBAAA,qBAAA,QAAA,WAAA,IAAA;AAED,QAAA,qBAAA,MAAA;;AAED,4BAA4B,SAAS;CAAC;OAAqB;CAA6B;QAAkB,EAAE;CAAG;CAAW;CAAA;;;;;;;;;;AAU1H,SAAS,yBAAsB,aAAA;AAC3B,QAAO,YACT,WAAA,KAAA,MAAA,CACO,WAAW,MAAK,OAAM,CACtB,WAAW,KAAK,MAAM,CAC7B,QAAA,SAAA,OAAA;;AAEF,yBAAyB,SAAS;CAAC;CAAC;CAAA;CAAA;;;;;;;;;;AAUpC,SAAgB,kBAAkB,aAAU,UAAA,EAAA,EAAA;AAC1C,QAAA,yBAAA,4BAAA,aAAA,QAAA,CAAA;;AAEF,kBAAkB,SAAC;CAAA;OAAA;CAAA;QAAA,EAAA;CAAA;CAAA;CAAA;AACnB,MAAM,mCAAoB;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAS1B,SAAU,uBAAA,aAAA,UAAA,EAAA,EAAA;CACN,MAAM,SAAS,QAAQ,UAAU;CACpC,MAAA,uBAAA,4BAAA,aAAA,QAAA;CAUE,IAAA,WAT4B,qBAAoB,QAAA,KAAA,GAAA,SAAA,KAC3C,qBAAqB,OAAO,eAAQ,GAAA,SAAA,IAC1C,qBACW,MAAM,CACN,MAAM,kBAAE,GAAA,IACP,MAAM,EACV,MAAA,GAAA,GAAA,EACI,MAAM,GACV,WACP,sBAAA,MAAA;AACH,KAAA,OAAA,MAAA,CAAA,SAAA;AAGI,QAAA,yBAAA,OAAA;;AAEJ,uBAAG,SAAA;CAAA;OAAA;CAAA;QAAA,EAAA;CAAA;CAAA;CAAA"}

package/dist/plugin-utils/description-helpers.d.cts

@@ -0,0 +1,44 @@
+//#region src/plugin-utils/description-helpers.d.ts
+interface FormatDescriptionOptions {
+  /**
+   * If true, replaces newlines in the description with spaces. This is useful for ensuring that descriptions are displayed as a single line in contexts where multiline descriptions may not be supported or may cause formatting issues.
+   *
+   * @defaultValue false
+   */
+  replaceNewlines?: boolean;
+  /**
+   * If true, collapses multiple consecutive spaces in the description into a single space. This helps to ensure that descriptions are concise and do not contain unnecessary whitespace.
+   *
+   * @defaultValue false
+   */
+  collapseWhitespace?: boolean;
+}
+/**
+ * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.
+ *
+ * @remarks
+ * This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.
+ *
+ * @param description - The full description string.
+ * @returns The formatted description string.
+ */
+declare function formatDescription(description: string, options?: FormatDescriptionOptions): string;
+interface FormatShortDescriptionOptions extends FormatDescriptionOptions {
+  /**
+   * The maximum length of the short description. If the first sentence exceeds this length, it will be truncated.
+   *
+   * @defaultValue 60
+   */
+  length?: number;
+}
+/**
+ * Extracts the short description from a longer description string. The short description is typically the first sentence or the first line of the description.
+ *
+ * @param description - The full description string.
+ * @param options - Options for formatting the short description, including the maximum length.
+ * @returns The extracted short description.
+ */
+declare function formatShortDescription(description: string, options?: FormatShortDescriptionOptions): string;
+//#endregion
+export { FormatDescriptionOptions, FormatShortDescriptionOptions, formatDescription, formatShortDescription };
+//# sourceMappingURL=description-helpers.d.cts.map

package/dist/plugin-utils/description-helpers.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"description-helpers.d.cts","names":[],"sources":["../../src/plugin-utils/description-helpers.ts"],"sourcesContent":[],"mappings":";UAkBiB,wBAAA;EAAA;AAkEjB;AASA;AAgBA;;;;;;;;;;;;;;;;;;;iBAzBgB,iBAAA,gCAEL;UAOM,6BAAA,SAAsC;;;;;;;;;;;;;;;iBAgBvC,sBAAA,gCAEL"}

package/dist/plugin-utils/description-helpers.d.mts

@@ -0,0 +1,44 @@
+//#region src/plugin-utils/description-helpers.d.ts
+interface FormatDescriptionOptions {
+  /**
+   * If true, replaces newlines in the description with spaces. This is useful for ensuring that descriptions are displayed as a single line in contexts where multiline descriptions may not be supported or may cause formatting issues.
+   *
+   * @defaultValue false
+   */
+  replaceNewlines?: boolean;
+  /**
+   * If true, collapses multiple consecutive spaces in the description into a single space. This helps to ensure that descriptions are concise and do not contain unnecessary whitespace.
+   *
+   * @defaultValue false
+   */
+  collapseWhitespace?: boolean;
+}
+/**
+ * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.
+ *
+ * @remarks
+ * This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.
+ *
+ * @param description - The full description string.
+ * @returns The formatted description string.
+ */
+declare function formatDescription(description: string, options?: FormatDescriptionOptions): string;
+interface FormatShortDescriptionOptions extends FormatDescriptionOptions {
+  /**
+   * The maximum length of the short description. If the first sentence exceeds this length, it will be truncated.
+   *
+   * @defaultValue 60
+   */
+  length?: number;
+}
+/**
+ * Extracts the short description from a longer description string. The short description is typically the first sentence or the first line of the description.
+ *
+ * @param description - The full description string.
+ * @param options - Options for formatting the short description, including the maximum length.
+ * @returns The extracted short description.
+ */
+declare function formatShortDescription(description: string, options?: FormatShortDescriptionOptions): string;
+//#endregion
+export { FormatDescriptionOptions, FormatShortDescriptionOptions, formatDescription, formatShortDescription };
+//# sourceMappingURL=description-helpers.d.mts.map

package/dist/plugin-utils/description-helpers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"description-helpers.d.mts","names":[],"sources":["../../src/plugin-utils/description-helpers.ts"],"sourcesContent":[],"mappings":";UAkBiB,wBAAA;EAAA;AAkEjB;AASA;AAgBA;;;;;;;;;;;;;;;;;;;iBAzBgB,iBAAA,gCAEL;UAOM,6BAAA,SAAsC;;;;;;;;;;;;;;;iBAgBvC,sBAAA,gCAEL"}

package/dist/plugin-utils/description-helpers.mjs

@@ -0,0 +1,101 @@
+//#region src/plugin-utils/description-helpers.ts
+const __ΩFormatDescriptionOptions = [
+	"replaceNewlines",
+	true,
+	"collapseWhitespace",
+	"FormatDescriptionOptions",
+	"P)4!8>\")4#8>\"Mw$y"
+];
+/**
+* Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.
+*
+* @remarks
+* This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.
+*
+* @param description - The full description string.
+* @returns The formatted description string.
+*/
+function formatDescriptionWhitespace(description, options = {}) {
+	let formattedDescription = description.trim();
+	if (options.replaceNewlines) formattedDescription = formattedDescription.replace(/\s*\n\s*/g, " ");
+	if (options.collapseWhitespace) formattedDescription = formattedDescription.replace(/\s{2,}/g, " ");
+	return formattedDescription.trim();
+}
+formatDescriptionWhitespace.__type = [
+	"description",
+	() => __ΩFormatDescriptionOptions,
+	"options",
+	() => ({}),
+	"formatDescriptionWhitespace",
+	"P&2!n\"2#>$&/%"
+];
+/**
+* Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.
+*
+* @remarks
+* This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.
+*
+* @param description - The full description string.
+* @returns The formatted description string.
+*/
+function formatDescriptionEscapes(description) {
+	return description.replaceAll("'", "\\'").replaceAll("\"", "\\\"").replaceAll("`", "\\`").replace(/\$\{/g, "\\${");
+}
+formatDescriptionEscapes.__type = [
+	"description",
+	"formatDescriptionEscapes",
+	"P&2!&/\""
+];
+/**
+* Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.
+*
+* @remarks
+* This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.
+*
+* @param description - The full description string.
+* @returns The formatted description string.
+*/
+function formatDescription(description, options = {}) {
+	return formatDescriptionEscapes(formatDescriptionWhitespace(description, options));
+}
+formatDescription.__type = [
+	"description",
+	() => __ΩFormatDescriptionOptions,
+	"options",
+	() => ({}),
+	"formatDescription",
+	"P&2!n\"2#>$&/%"
+];
+const __ΩFormatShortDescriptionOptions = [
+	() => __ΩFormatDescriptionOptions,
+	"length",
+	60,
+	"FormatShortDescriptionOptions",
+	"Pn!'4\"8>#Mw$y"
+];
+/**
+* Extracts the short description from a longer description string. The short description is typically the first sentence or the first line of the description.
+*
+* @param description - The full description string.
+* @param options - Options for formatting the short description, including the maximum length.
+* @returns The extracted short description.
+*/
+function formatShortDescription(description, options = {}) {
+	const length = options.length ?? 60;
+	const formattedDescription = formatDescriptionWhitespace(description, options);
+	let result = ((formattedDescription.indexOf("\n") < length + 1 || formattedDescription.search(/[.!?\n]\s*\S/) > length + 1 ? formattedDescription.trim().match(/^.*[.!?\n]\s?\S/)?.[0]?.trim()?.slice(0, -1)?.trim() : void 0) || formattedDescription).trim();
+	if (result.trim().length > length) result = `${result.substring(0, Math.max(0, length - 3)).trim()}...`;
+	return formatDescriptionEscapes(result);
+}
+formatShortDescription.__type = [
+	"description",
+	() => __ΩFormatShortDescriptionOptions,
+	"options",
+	() => ({}),
+	"formatShortDescription",
+	"P&2!n\"2#>$&/%"
+];
+
+//#endregion
+export { __ΩFormatDescriptionOptions, __ΩFormatShortDescriptionOptions, formatDescription, formatShortDescription };
+//# sourceMappingURL=description-helpers.mjs.map

package/dist/plugin-utils/description-helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"description-helpers.mjs","names":[],"sources":["../../src/plugin-utils/description-helpers.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\nexport interface FormatDescriptionOptions {\n  /**\n   * If true, replaces newlines in the description with spaces. This is useful for ensuring that descriptions are displayed as a single line in contexts where multiline descriptions may not be supported or may cause formatting issues.\n   *\n   * @defaultValue false\n   */\n  replaceNewlines?: boolean;\n\n  /**\n   * If true, collapses multiple consecutive spaces in the description into a single space. This helps to ensure that descriptions are concise and do not contain unnecessary whitespace.\n   *\n   * @defaultValue false\n   */\n  collapseWhitespace?: boolean;\n}\n\n/**\n * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.\n *\n * @remarks\n * This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.\n *\n * @param description - The full description string.\n * @returns The formatted description string.\n */\nfunction formatDescriptionWhitespace(\n  description: string,\n  options: FormatDescriptionOptions = {}\n): string {\n  let formattedDescription = description.trim();\n  if (options.replaceNewlines) {\n    formattedDescription = formattedDescription.replace(/\\s*\\n\\s*/g, \" \");\n  }\n  if (options.collapseWhitespace) {\n    formattedDescription = formattedDescription.replace(/\\s{2,}/g, \" \");\n  }\n\n  return formattedDescription.trim();\n}\n\n/**\n * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.\n *\n * @remarks\n * This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.\n *\n * @param description - The full description string.\n * @returns The formatted description string.\n */\nfunction formatDescriptionEscapes(description: string): string {\n  return description\n    .replaceAll(\"'\", \"\\\\'\")\n    .replaceAll('\"', '\\\\\"')\n    .replaceAll(\"`\", \"\\\\`\")\n    .replace(/\\$\\{/g, \"\\\\${\");\n}\n\n/**\n * Formats a description string by trimming whitespace, replacing newlines with spaces (optionally), collapsing multiple spaces into a single space (optionally), and escaping special characters.\n *\n * @remarks\n * This is useful for ensuring that descriptions are concise and well-formatted when displayed in the CLI or documentation.\n *\n * @param description - The full description string.\n * @returns The formatted description string.\n */\nexport function formatDescription(\n  description: string,\n  options: FormatDescriptionOptions = {}\n): string {\n  return formatDescriptionEscapes(\n    formatDescriptionWhitespace(description, options)\n  );\n}\n\nexport interface FormatShortDescriptionOptions extends FormatDescriptionOptions {\n  /**\n   * The maximum length of the short description. If the first sentence exceeds this length, it will be truncated.\n   *\n   * @defaultValue 60\n   */\n  length?: number;\n}\n\n/**\n * Extracts the short description from a longer description string. The short description is typically the first sentence or the first line of the description.\n *\n * @param description - The full description string.\n * @param options - Options for formatting the short description, including the maximum length.\n * @returns The extracted short description.\n */\nexport function formatShortDescription(\n  description: string,\n  options: FormatShortDescriptionOptions = {}\n): string {\n  const length = options.length ?? 60;\n  const formattedDescription = formatDescriptionWhitespace(\n    description,\n    options\n  );\n\n  const firstSentenceMatch =\n    formattedDescription.indexOf(\"\\n\") < length + 1 ||\n    formattedDescription.search(/[.!?\\n]\\s*\\S/) > length + 1\n      ? formattedDescription\n          .trim()\n          .match(/^.*[.!?\\n]\\s?\\S/)?.[0]\n          ?.trim()\n          ?.slice(0, -1)\n          ?.trim()\n      : undefined;\n\n  let result = (firstSentenceMatch || formattedDescription).trim();\n  if (result.trim().length > length) {\n    result = `${result.substring(0, Math.max(0, length - 3)).trim()}...`;\n  }\n\n  return formatDescriptionEscapes(result);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA4BA,SAAG,4BAAA,aAAA,UAAA,EAAA,EAAA;CACC,IAAI,uBAAe,YAAA,MAAA;AACnB,KAAA,QAAA,gBACI,wBAAsB,qBAAA,QAAA,aAAA,IAAA;gCAG5B,wBAAA,qBAAA,QAAA,WAAA,IAAA;AAED,QAAA,qBAAA,MAAA;;AAED,4BAA4B,SAAS;CAAC;OAAqB;CAA6B;QAAkB,EAAE;CAAG;CAAW;CAAA;;;;;;;;;;AAU1H,SAAS,yBAAsB,aAAA;AAC3B,QAAO,YACT,WAAA,KAAA,MAAA,CACO,WAAW,MAAK,OAAM,CACtB,WAAW,KAAK,MAAM,CAC7B,QAAA,SAAA,OAAA;;AAEF,yBAAyB,SAAS;CAAC;CAAC;CAAA;CAAA;;;;;;;;;;AAUpC,SAAgB,kBAAkB,aAAU,UAAA,EAAA,EAAA;AAC1C,QAAA,yBAAA,4BAAA,aAAA,QAAA,CAAA;;AAEF,kBAAkB,SAAC;CAAA;OAAA;CAAA;QAAA,EAAA;CAAA;CAAA;CAAA;AACnB,MAAM,mCAAoB;OAAA;CAAA;CAAA;CAAA;CAAA;CAAA;;;;;;;;AAS1B,SAAU,uBAAA,aAAA,UAAA,EAAA,EAAA;CACN,MAAM,SAAS,QAAQ,UAAU;CACpC,MAAA,uBAAA,4BAAA,aAAA,QAAA;CAUE,IAAA,WAT4B,qBAAoB,QAAA,KAAA,GAAA,SAAA,KAC3C,qBAAqB,OAAO,eAAQ,GAAA,SAAA,IAC1C,qBACW,MAAM,CACN,MAAM,kBAAE,GAAA,IACP,MAAM,EACV,MAAA,GAAA,GAAA,EACI,MAAM,GACV,WACP,sBAAA,MAAA;AACH,KAAA,OAAA,MAAA,CAAA,SAAA;AAGI,QAAA,yBAAA,OAAA;;AAEJ,uBAAG,SAAA;CAAA;OAAA;CAAA;QAAA,EAAA;CAAA;CAAA;CAAA"}

package/dist/plugin-utils/get-command-tree.cjs

@@ -1,4 +1,4 @@
-const require_plugin_utils_context_helpers = require('./context-helpers.cjs');
+const require_context_helpers = require('./context-helpers.cjs');
 
 //#region src/plugin-utils/get-command-tree.ts
 function __assignType(fn, args) {
@@ -16,7 +16,7 @@ function getCommandTree(context, path = []) {
 	if (path.length === 0) return null;
 	let currentTree = context.commands[path[0]] ?? null;
 	if (path.length > 1) {
-		const segments = path.slice(1).filter(__assignType((segment) => !require_plugin_utils_context_helpers.isDynamicPathSegment(segment), [
+		const segments = path.slice(1).filter(__assignType((segment) => !require_context_helpers.isDynamicPathSegment(segment), [
 			"segment",
 			"",
 			"P\"2!\"/\""

package/dist/plugin-utils/get-command-tree.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"get-command-tree.cjs","names":[],"sources":["../../src/plugin-utils/get-command-tree.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 { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport { isDynamicPathSegment } from \"./context-helpers\";\n\n/**\n * Retrieves a specific command tree based on the provided path.\n *\n * @param context - The build context containing the command definitions.\n * @param path - An array of strings representing the command path.\n * @returns The command tree at the specified path, or null if not found.\n */\nexport function getCommandTree(\n  context: Context,\n  path = [] as string[]\n): CommandTree | null {\n  if (path.length === 0) {\n    return null;\n  }\n\n  let currentTree: CommandTree | null = context.commands[path[0]!] ?? null;\n  if (path.length > 1) {\n    const segments = path\n      .slice(1)\n      .filter(segment => !isDynamicPathSegment(segment));\n    for (const segment of segments) {\n      if (\n        currentTree?.children &&\n        Object.prototype.hasOwnProperty.call(currentTree.children, segment)\n      ) {\n        currentTree = currentTree.children[segment] ?? null;\n      } else {\n        return null;\n      }\n    }\n  }\n\n  return currentTree;\n}\n"],"mappings":";;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;;AAUX,SAAgB,eAAe,SAAS,OAAO,EAAE,EAAE;uBAE3C,QAAO;CAEX,IAAI,cAAc,QAAQ,SAAS,KAAK,OAAO;;EAE3C,MAAM,WAAW,KACZ,MAAM,EAAE,CACR,OAAO,cAAa,YAAW,CAAC,0DAAW,QAAA,EAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA;iCAEtD,KAAA,aAAA,YACc,OAAO,UAAU,eAAe,KAAK,YAAU,UAAA,QAAA,CAC9D,eAAA,YAAA,SAAA,YAAA;MAGe,QAAO;;AAInB,QAAO;;AAEX,eAAe,SAAS;CAAC;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}
+{"version":3,"file":"get-command-tree.cjs","names":[],"sources":["../../src/plugin-utils/get-command-tree.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 { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport { isDynamicPathSegment } from \"./context-helpers\";\n\n/**\n * Retrieves a specific command tree based on the provided path.\n *\n * @param context - The build context containing the command definitions.\n * @param path - An array of strings representing the command path.\n * @returns The command tree at the specified path, or null if not found.\n */\nexport function getCommandTree(\n  context: Context,\n  path = [] as string[]\n): CommandTree | null {\n  if (path.length === 0) {\n    return null;\n  }\n\n  let currentTree: CommandTree | null = context.commands[path[0]!] ?? null;\n  if (path.length > 1) {\n    const segments = path\n      .slice(1)\n      .filter(segment => !isDynamicPathSegment(segment));\n    for (const segment of segments) {\n      if (\n        currentTree?.children &&\n        Object.prototype.hasOwnProperty.call(currentTree.children, segment)\n      ) {\n        currentTree = currentTree.children[segment] ?? null;\n      } else {\n        return null;\n      }\n    }\n  }\n\n  return currentTree;\n}\n"],"mappings":";;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;;AAUX,SAAgB,eAAe,SAAS,OAAO,EAAE,EAAE;uBAE3C,QAAO;CAEX,IAAI,cAAc,QAAQ,SAAS,KAAK,OAAO;;EAE3C,MAAM,WAAW,KACZ,MAAM,EAAE,CACR,OAAO,cAAa,YAAW,CAAC,6CAAW,QAAA,EAAA;GAAA;GAAA;GAAA;GAAA,CAAA,CAAA;iCAEtD,KAAA,aAAA,YACc,OAAO,UAAU,eAAe,KAAK,YAAU,UAAA,QAAA,CAC9D,eAAA,YAAA,SAAA,YAAA;MAGe,QAAO;;AAInB,QAAO;;AAEX,eAAe,SAAS;CAAC;CAAA;CAAA;CAAA;CAAA;CAAA;CAAA"}

package/dist/plugin-utils/index.cjs

@@ -1,19 +1,33 @@
-const require_plugin_utils_context_helpers = require('./context-helpers.cjs');
-const require_plugin_utils_reflect = require('./reflect.cjs');
-const require_plugin_utils_get_command_tree = require('./get-command-tree.cjs');
-const require_plugin_utils_traverse_command_tree = require('./traverse-command-tree.cjs');
+const require_context_helpers = require('./context-helpers.cjs');
+const require_reflect = require('./reflect.cjs');
+const require_type_checks = require('./type-checks.cjs');
+const require_deepkit = require('./deepkit.cjs');
+const require_description_helpers = require('./description-helpers.cjs');
+const require_get_command_tree = require('./get-command-tree.cjs');
+const require_traverse_command_tree = require('./traverse-command-tree.cjs');
 
-exports.getAppBin = require_plugin_utils_context_helpers.getAppBin;
-exports.getAppDescription = require_plugin_utils_context_helpers.getAppDescription;
-exports.getAppName = require_plugin_utils_context_helpers.getAppName;
-exports.getAppTitle = require_plugin_utils_context_helpers.getAppTitle;
-exports.getCommandTree = require_plugin_utils_get_command_tree.getCommandTree;
-exports.getDynamicPathSegmentName = require_plugin_utils_context_helpers.getDynamicPathSegmentName;
-exports.getPathSegmentGroupName = require_plugin_utils_context_helpers.getPathSegmentGroupName;
-exports.getPathSegmentName = require_plugin_utils_context_helpers.getPathSegmentName;
-exports.isDynamicPathSegment = require_plugin_utils_context_helpers.isDynamicPathSegment;
-exports.isPathSegmentGroup = require_plugin_utils_context_helpers.isPathSegmentGroup;
-exports.sortArgAliases = require_plugin_utils_context_helpers.sortArgAliases;
-exports.sortOptions = require_plugin_utils_reflect.sortOptions;
-exports.traverseCommandTree = require_plugin_utils_traverse_command_tree.traverseCommandTree;
-exports.traverseCommands = require_plugin_utils_traverse_command_tree.traverseCommands;
+exports.__ΩFormatDescriptionOptions = require_description_helpers.__ΩFormatDescriptionOptions;
+exports.__ΩFormatShortDescriptionOptions = require_description_helpers.__ΩFormatShortDescriptionOptions;
+exports.extractReflectionKind = require_deepkit.extractReflectionKind;
+exports.extractType = require_deepkit.extractType;
+exports.formatDescription = require_description_helpers.formatDescription;
+exports.formatShortDescription = require_description_helpers.formatShortDescription;
+exports.getAppBin = require_context_helpers.getAppBin;
+exports.getAppDescription = require_context_helpers.getAppDescription;
+exports.getAppName = require_context_helpers.getAppName;
+exports.getAppTitle = require_context_helpers.getAppTitle;
+exports.getCommandTree = require_get_command_tree.getCommandTree;
+exports.getDynamicPathSegmentName = require_context_helpers.getDynamicPathSegmentName;
+exports.getPathSegmentGroupName = require_context_helpers.getPathSegmentGroupName;
+exports.getPathSegmentName = require_context_helpers.getPathSegmentName;
+exports.isCommandArgument = require_type_checks.isCommandArgument;
+exports.isCommandOption = require_type_checks.isCommandOption;
+exports.isCommandParameter = require_type_checks.isCommandParameter;
+exports.isCommandParameterConfig = require_type_checks.isCommandParameterConfig;
+exports.isCommandParameterKind = require_type_checks.isCommandParameterKind;
+exports.isDynamicPathSegment = require_context_helpers.isDynamicPathSegment;
+exports.isPathSegmentGroup = require_context_helpers.isPathSegmentGroup;
+exports.sortArgAliases = require_context_helpers.sortArgAliases;
+exports.sortOptions = require_reflect.sortOptions;
+exports.traverseCommandTree = require_traverse_command_tree.traverseCommandTree;
+exports.traverseCommands = require_traverse_command_tree.traverseCommands;

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

@@ -1,5 +1,8 @@
 import { getAppBin, getAppDescription, getAppName, getAppTitle, getDynamicPathSegmentName, getPathSegmentGroupName, getPathSegmentName, isDynamicPathSegment, isPathSegmentGroup, sortArgAliases } from "./context-helpers.cjs";
+import { extractReflectionKind, extractType } from "./deepkit.cjs";
+import { FormatDescriptionOptions, FormatShortDescriptionOptions, formatDescription, formatShortDescription } from "./description-helpers.cjs";
 import { getCommandTree } from "./get-command-tree.cjs";
 import { sortOptions } from "./reflect.cjs";
 import { traverseCommandTree, traverseCommands } from "./traverse-command-tree.cjs";
-export { getAppBin, getAppDescription, getAppName, getAppTitle, getCommandTree, getDynamicPathSegmentName, getPathSegmentGroupName, getPathSegmentName, isDynamicPathSegment, isPathSegmentGroup, sortArgAliases, sortOptions, traverseCommandTree, traverseCommands };
+import { isCommandArgument, isCommandOption, isCommandParameter, isCommandParameterConfig, isCommandParameterKind } from "./type-checks.cjs";
+export { FormatDescriptionOptions, FormatShortDescriptionOptions, extractReflectionKind, extractType, formatDescription, formatShortDescription, getAppBin, getAppDescription, getAppName, getAppTitle, getCommandTree, getDynamicPathSegmentName, getPathSegmentGroupName, getPathSegmentName, isCommandArgument, isCommandOption, isCommandParameter, isCommandParameterConfig, isCommandParameterKind, isDynamicPathSegment, isPathSegmentGroup, sortArgAliases, sortOptions, traverseCommandTree, traverseCommands };

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

@@ -1,5 +1,8 @@
 import { getAppBin, getAppDescription, getAppName, getAppTitle, getDynamicPathSegmentName, getPathSegmentGroupName, getPathSegmentName, isDynamicPathSegment, isPathSegmentGroup, sortArgAliases } from "./context-helpers.mjs";
+import { extractReflectionKind, extractType } from "./deepkit.mjs";
+import { FormatDescriptionOptions, FormatShortDescriptionOptions, formatDescription, formatShortDescription } from "./description-helpers.mjs";
 import { getCommandTree } from "./get-command-tree.mjs";
 import { sortOptions } from "./reflect.mjs";
 import { traverseCommandTree, traverseCommands } from "./traverse-command-tree.mjs";
-export { getAppBin, getAppDescription, getAppName, getAppTitle, getCommandTree, getDynamicPathSegmentName, getPathSegmentGroupName, getPathSegmentName, isDynamicPathSegment, isPathSegmentGroup, sortArgAliases, sortOptions, traverseCommandTree, traverseCommands };
+import { isCommandArgument, isCommandOption, isCommandParameter, isCommandParameterConfig, isCommandParameterKind } from "./type-checks.mjs";
+export { FormatDescriptionOptions, FormatShortDescriptionOptions, extractReflectionKind, extractType, formatDescription, formatShortDescription, getAppBin, getAppDescription, getAppName, getAppTitle, getCommandTree, getDynamicPathSegmentName, getPathSegmentGroupName, getPathSegmentName, isCommandArgument, isCommandOption, isCommandParameter, isCommandParameterConfig, isCommandParameterKind, isDynamicPathSegment, isPathSegmentGroup, sortArgAliases, sortOptions, traverseCommandTree, traverseCommands };

package/dist/plugin-utils/index.mjs

@@ -1,6 +1,9 @@
 import { getAppBin, getAppDescription, getAppName, getAppTitle, getDynamicPathSegmentName, getPathSegmentGroupName, getPathSegmentName, isDynamicPathSegment, isPathSegmentGroup, sortArgAliases } from "./context-helpers.mjs";
 import { sortOptions } from "./reflect.mjs";
+import { isCommandArgument, isCommandOption, isCommandParameter, isCommandParameterConfig, isCommandParameterKind } from "./type-checks.mjs";
+import { extractReflectionKind, extractType } from "./deepkit.mjs";
+import { __ΩFormatDescriptionOptions, __ΩFormatShortDescriptionOptions, formatDescription, formatShortDescription } from "./description-helpers.mjs";
 import { getCommandTree } from "./get-command-tree.mjs";
 import { traverseCommandTree, traverseCommands } from "./traverse-command-tree.mjs";
 
-export { getAppBin, getAppDescription, getAppName, getAppTitle, getCommandTree, getDynamicPathSegmentName, getPathSegmentGroupName, getPathSegmentName, isDynamicPathSegment, isPathSegmentGroup, sortArgAliases, sortOptions, traverseCommandTree, traverseCommands };
+export { __ΩFormatDescriptionOptions, __ΩFormatShortDescriptionOptions, extractReflectionKind, extractType, formatDescription, formatShortDescription, getAppBin, getAppDescription, getAppName, getAppTitle, getCommandTree, getDynamicPathSegmentName, getPathSegmentGroupName, getPathSegmentName, isCommandArgument, isCommandOption, isCommandParameter, isCommandParameterConfig, isCommandParameterKind, isDynamicPathSegment, isPathSegmentGroup, sortArgAliases, sortOptions, traverseCommandTree, traverseCommands };

package/dist/plugin-utils/reflect.cjs

@@ -1,5 +1,4 @@
-const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
-let __powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+const require_types_command = require('../types/command.cjs');
 
 //#region src/plugin-utils/reflect.ts
 function __assignType(fn, args) {
@@ -14,7 +13,7 @@ function __assignType(fn, args) {
 */
 function sortOptions(options) {
 	if (!options || options.length === 0) return [];
-	return options.filter(__assignType((arg) => arg.kind !== __powerlines_deepkit_vendor_type.ReflectionKind.boolean || !arg.isNegativeOf, [
+	return options.filter(__assignType((arg) => arg.kind !== require_types_command.CommandParameterKinds.boolean || !arg.isNegativeOf, [
 		"arg",
 		"",
 		"P\"2!\"/\""
@@ -25,8 +24,8 @@ function sortOptions(options) {
 		"P\"2!\"2\"\"/#"
 	])).reduce(__assignType((ret, arg) => {
 		ret.push(arg);
-		if (arg.kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean) {
-			const negativeArg = options.find(__assignType((a) => a.kind === __powerlines_deepkit_vendor_type.ReflectionKind.boolean && a.isNegativeOf === arg.name, [
+		if (arg.kind === require_types_command.CommandParameterKinds.boolean) {
+			const negativeArg = options.find(__assignType((a) => a.kind === require_types_command.CommandParameterKinds.boolean && a.isNegativeOf === arg.name, [
 				"a",
 				"",
 				"P\"2!\"/\""

package/dist/plugin-utils/reflect.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"reflect.cjs","names":[],"sources":["../../src/plugin-utils/reflect.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 { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport type { CommandOption } from \"../types/command\";\n\n/**\n * Sort command options alphabetically by name, placing boolean options with negatives appropriately.\n *\n * @param options - The array of command options to sort.\n * @returns A new array of sorted command options.\n */\nexport function sortOptions(options: CommandOption[]): CommandOption[] {\n  if (!options || options.length === 0) {\n    return [];\n  }\n\n  return options\n    .filter(arg => arg.kind !== ReflectionKind.boolean || !arg.isNegativeOf)\n    .sort((a, b) => a.name.localeCompare(b.name))\n    .reduce((ret, arg) => {\n      ret.push(arg);\n\n      if (arg.kind === ReflectionKind.boolean) {\n        // Add the negative argument if it exists\n        const negativeArg = options.find(\n          a => a.kind === ReflectionKind.boolean && a.isNegativeOf === arg.name\n        );\n        if (negativeArg) {\n          ret.push(negativeArg);\n        }\n      }\n\n      return ret;\n    }, [] as CommandOption[]);\n}\n"],"mappings":";;;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;AA0BX,SAAgB,YAAY,SAAS;AACjC,KAAI,CAAC,WAAI,QAAA,WAAA,EACX,QAAA,EAAA;AAEE,QAAO,QACF,OAAO,cAAa,QAAO,IAAI,SAAS,gDAAe,WAAW,CAAA,IAAA,cAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAClE,KAAK,cAAc,GAAG,MAAM,EAAE,KAAK,cAAI,EAAA,KAAA,EAAA;EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CACvC,OAAO,cAAU,KAAA,QAAA;AAClB,MAAI,KAAK,IAAE;;GAGP,MAAM,cAAc,QAAQ,KAAK,cAAG,MAAA,EAAA,SAAA,gDAAA,WAAA,EAAA,iBAAA,IAAA,MAAA;IAAA;IAAA;IAAA;IAAA,CAAA,CAAA;AACpC,OAAI,YACA,KAAI,KAAK,YAAY;;AAG7B,SAAO;IACR;EAAC;EAAA;EAAA;EAAA;EAAA,CAAA,EAAA,EAAA,CAAA"}
+{"version":3,"file":"reflect.cjs","names":[],"sources":["../../src/plugin-utils/reflect.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 { CommandOption } from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\n\n/**\n * Sort command options alphabetically by name, placing boolean options with negatives appropriately.\n *\n * @param options - The array of command options to sort.\n * @returns A new array of sorted command options.\n */\nexport function sortOptions(options: CommandOption[]): CommandOption[] {\n  if (!options || options.length === 0) {\n    return [];\n  }\n\n  return options\n    .filter(\n      arg => arg.kind !== CommandParameterKinds.boolean || !arg.isNegativeOf\n    )\n    .sort((a, b) => a.name.localeCompare(b.name))\n    .reduce((ret, arg) => {\n      ret.push(arg);\n\n      if (arg.kind === CommandParameterKinds.boolean) {\n        // Add the negative argument if it exists\n        const negativeArg = options.find(\n          a =>\n            a.kind === CommandParameterKinds.boolean &&\n            a.isNegativeOf === arg.name\n        );\n        if (negativeArg) {\n          ret.push(negativeArg);\n        }\n      }\n\n      return ret;\n    }, [] as CommandOption[]);\n}\n"],"mappings":";;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;AASX,SAAgB,YAAY,SAAS;AACjC,KAAI,CAAC,WAAW,QAAQ,WAAW;gBAI9B,OAAO,cAAa,QAAO,IAAI,SAAS,4CAAqB,WAAA,CAAA,IAAA,cAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA;;;;;KAE7D,OAAO,cAAc,KAAK,QAAQ;AACnC,MAAI,KAAK,IAAI;;GAGT,MAAM,cAAc,QAAQ,KAAK,cAAa,MAAK,EAAE,SAAS,4CAAsB,WAC/F,EAAA,iBAAA,IAAA,MAAA;IAAA;IAAA;IAAA;IAAA,CAAA,CAAA;AACW,OAAI,YACA,KAAI,KAAK,YAAY;;AAG7B,SAAO;IACR;EAAC;EAAK;EAAA;EAAA;EAAA,CAAA,EAAA,EAAA,CAAA"}

package/dist/plugin-utils/reflect.mjs

@@ -1,4 +1,4 @@
-import { ReflectionKind } from "@powerlines/deepkit/vendor/type";
+import { CommandParameterKinds } from "../types/command.mjs";
 
 //#region src/plugin-utils/reflect.ts
 function __assignType(fn, args) {
@@ -13,7 +13,7 @@ function __assignType(fn, args) {
 */
 function sortOptions(options) {
 	if (!options || options.length === 0) return [];
-	return options.filter(__assignType((arg) => arg.kind !== ReflectionKind.boolean || !arg.isNegativeOf, [
+	return options.filter(__assignType((arg) => arg.kind !== CommandParameterKinds.boolean || !arg.isNegativeOf, [
 		"arg",
 		"",
 		"P\"2!\"/\""
@@ -24,8 +24,8 @@ function sortOptions(options) {
 		"P\"2!\"2\"\"/#"
 	])).reduce(__assignType((ret, arg) => {
 		ret.push(arg);
-		if (arg.kind === ReflectionKind.boolean) {
-			const negativeArg = options.find(__assignType((a) => a.kind === ReflectionKind.boolean && a.isNegativeOf === arg.name, [
+		if (arg.kind === CommandParameterKinds.boolean) {
+			const negativeArg = options.find(__assignType((a) => a.kind === CommandParameterKinds.boolean && a.isNegativeOf === arg.name, [
 				"a",
 				"",
 				"P\"2!\"/\""

package/dist/plugin-utils/reflect.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"reflect.mjs","names":[],"sources":["../../src/plugin-utils/reflect.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 { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport type { CommandOption } from \"../types/command\";\n\n/**\n * Sort command options alphabetically by name, placing boolean options with negatives appropriately.\n *\n * @param options - The array of command options to sort.\n * @returns A new array of sorted command options.\n */\nexport function sortOptions(options: CommandOption[]): CommandOption[] {\n  if (!options || options.length === 0) {\n    return [];\n  }\n\n  return options\n    .filter(arg => arg.kind !== ReflectionKind.boolean || !arg.isNegativeOf)\n    .sort((a, b) => a.name.localeCompare(b.name))\n    .reduce((ret, arg) => {\n      ret.push(arg);\n\n      if (arg.kind === ReflectionKind.boolean) {\n        // Add the negative argument if it exists\n        const negativeArg = options.find(\n          a => a.kind === ReflectionKind.boolean && a.isNegativeOf === arg.name\n        );\n        if (negativeArg) {\n          ret.push(negativeArg);\n        }\n      }\n\n      return ret;\n    }, [] as CommandOption[]);\n}\n"],"mappings":";;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;AA0BX,SAAgB,YAAY,SAAS;AACjC,KAAI,CAAC,WAAI,QAAA,WAAA,EACX,QAAA,EAAA;AAEE,QAAO,QACF,OAAO,cAAa,QAAO,IAAI,SAAS,eAAe,WAAW,CAAA,IAAA,cAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CAClE,KAAK,cAAc,GAAG,MAAM,EAAE,KAAK,cAAI,EAAA,KAAA,EAAA;EAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA,CACvC,OAAO,cAAU,KAAA,QAAA;AAClB,MAAI,KAAK,IAAE;;GAGP,MAAM,cAAc,QAAQ,KAAK,cAAG,MAAA,EAAA,SAAA,eAAA,WAAA,EAAA,iBAAA,IAAA,MAAA;IAAA;IAAA;IAAA;IAAA,CAAA,CAAA;AACpC,OAAI,YACA,KAAI,KAAK,YAAY;;AAG7B,SAAO;IACR;EAAC;EAAA;EAAA;EAAA;EAAA,CAAA,EAAA,EAAA,CAAA"}
+{"version":3,"file":"reflect.mjs","names":[],"sources":["../../src/plugin-utils/reflect.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 { CommandOption } from \"../types/command\";\nimport { CommandParameterKinds } from \"../types/command\";\n\n/**\n * Sort command options alphabetically by name, placing boolean options with negatives appropriately.\n *\n * @param options - The array of command options to sort.\n * @returns A new array of sorted command options.\n */\nexport function sortOptions(options: CommandOption[]): CommandOption[] {\n  if (!options || options.length === 0) {\n    return [];\n  }\n\n  return options\n    .filter(\n      arg => arg.kind !== CommandParameterKinds.boolean || !arg.isNegativeOf\n    )\n    .sort((a, b) => a.name.localeCompare(b.name))\n    .reduce((ret, arg) => {\n      ret.push(arg);\n\n      if (arg.kind === CommandParameterKinds.boolean) {\n        // Add the negative argument if it exists\n        const negativeArg = options.find(\n          a =>\n            a.kind === CommandParameterKinds.boolean &&\n            a.isNegativeOf === arg.name\n        );\n        if (negativeArg) {\n          ret.push(negativeArg);\n        }\n      }\n\n      return ret;\n    }, [] as CommandOption[]);\n}\n"],"mappings":";;;AAAA,SAAS,aAAa,IAAI,MAAM;;AAE5B,QAAO;;;;;;;;AASX,SAAgB,YAAY,SAAS;AACjC,KAAI,CAAC,WAAW,QAAQ,WAAW;gBAI9B,OAAO,cAAa,QAAO,IAAI,SAAS,sBAAqB,WAAA,CAAA,IAAA,cAAA;EAAA;EAAA;EAAA;EAAA,CAAA,CAAA;;;;;KAE7D,OAAO,cAAc,KAAK,QAAQ;AACnC,MAAI,KAAK,IAAI;;GAGT,MAAM,cAAc,QAAQ,KAAK,cAAa,MAAK,EAAE,SAAS,sBAAsB,WAC/F,EAAA,iBAAA,IAAA,MAAA;IAAA;IAAA;IAAA;IAAA,CAAA,CAAA;AACW,OAAI,YACA,KAAI,KAAK,YAAY;;AAG7B,SAAO;IACR;EAAC;EAAK;EAAA;EAAA;EAAA,CAAA,EAAA,EAAA,CAAA"}