@shell-shock/core 0.9.7 → 0.11.0

package/dist/api.cjs

@@ -45,7 +45,6 @@ var ShellShockAPI = class ShellShockAPI {
 		return this.#powerlines.finalize();
 	}
 	static __type = [
-		"PowerlinesAPI",
 		"#powerlines",
 		"UserConfig",
 		"config",
@@ -62,7 +61,7 @@ var ShellShockAPI = class ShellShockAPI {
 		"docs",
 		"finalize",
 		"ShellShockAPI",
-		"\"w!3\"P\"w#2$>%P7&`0'sP\"w!2(\"0)P!2*$`0+P!2*$`0,P!2*$`0-P!2*$`0.P!2*$`0/P$`005w1"
+		"!3!P\"w\"2#>$P7%`0&sP!2'\"0(P!2)$`0*P!2)$`0+P!2)$`0,P!2)$`0-P!2)$`0.P$`0/5w0"
 	];
 };
 /**

package/dist/api.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"api.cjs","names":[],"sources":["../src/api.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 { createPowerlines } from \"powerlines\";\nimport type { PowerlinesAPI } from \"powerlines/api\";\nimport type {\n  BuildInlineConfig,\n  CleanInlineConfig,\n  DocsInlineConfig,\n  LintInlineConfig,\n  PluginConfig,\n  PrepareInlineConfig\n} from \"powerlines/types/config\";\nimport { plugin } from \"./plugin\";\nimport type { UserConfig } from \"./types/config\";\n\n/**\n * The Shell Shock API class.\n *\n * @remarks\n * This class provides methods to interact with the Shell Shock build system, including cleaning, preparing, linting, building, generating documentation, and finalizing projects.\n */\nexport class ShellShockAPI {\n  #powerlines: PowerlinesAPI;\n\n  public static async from(config: UserConfig = {}): Promise<ShellShockAPI> {\n    const powerlines = await createPowerlines({\n      framework: \"shell-shock\",\n      ...config,\n      plugins: [plugin(), ...(config.plugins ?? [])] as PluginConfig<any>[]\n    });\n\n    return new ShellShockAPI(powerlines);\n  }\n\n  private constructor(powerlines: PowerlinesAPI) {\n    this.#powerlines = powerlines;\n  }\n\n  public async clean(inlineConfig: CleanInlineConfig): Promise<void> {\n    return this.#powerlines.clean(inlineConfig);\n  }\n\n  public async prepare(inlineConfig: PrepareInlineConfig): Promise<void> {\n    return this.#powerlines.prepare(inlineConfig);\n  }\n\n  public async lint(inlineConfig: LintInlineConfig): Promise<void> {\n    return this.#powerlines.lint(inlineConfig);\n  }\n\n  public async build(inlineConfig: BuildInlineConfig): Promise<void> {\n    return this.#powerlines.build(inlineConfig);\n  }\n\n  public async docs(inlineConfig: DocsInlineConfig): Promise<void> {\n    return this.#powerlines.docs(inlineConfig);\n  }\n\n  public async finalize(): Promise<void> {\n    return this.#powerlines.finalize();\n  }\n}\n\n/**\n * Creates a new {@link ShellShockAPI} instance.\n *\n * @param options - The user configuration options.\n * @returns A promise that resolves to a {@link ShellShockAPI} instance.\n */\nexport async function createShellShock(\n  options: Partial<UserConfig> = {}\n): Promise<ShellShockAPI> {\n  options.root ??= process.cwd();\n\n  return ShellShockAPI.from(options);\n}\n"],"mappings":";;;;;AAAA,MAAM,aAAa;CAAC;CAAK;CAAW;CAA2B;;;;;;;AA0B/D,IAAa,gBAAb,MAAa,cAAO;CAChB;CACA,aAAa,KAAK,SAAS,EAAE,EAAA;AAMzB,SAAE,IAAA,cALiB,uCAAqB;;GAE9C,GAAA;GACU,SAAS,CAAC,uBAAM,EAAA,GAAA,OAAA,WAAA,EAAA,CAAA;GAC3B,CAAA,CACS;;CAER,YAAA,cAAA;AACM,QAAK,aAAc;;;AAGnB,SAAO,MAAK,WAAY,MAAM,aAAa;;CAE/C,MAAM,QAAQ,cAAY;AACtB,SAAO,MAAA,WAAA,QAAA,aAAA;;CAEX,MAAE,KAAA,cAAA;;;CAGJ,MAAA,MAAA,cAAA;;;CAGE,MAAM,KAAK,cAAc;AAC3B,SAAA,MAAA,WAAA,KAAA,aAAA;;CAEE,MAAM,WAAW;AACb,SAAO,MAAK,WAAY,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWtC,SAAQ,SAAS,QAAQ,KAAK;AAC9B,QAAO,cAAc,KAAK,QAAQ"}
+{"version":3,"file":"api.cjs","names":[],"sources":["../src/api.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 {\n  BuildInlineConfig,\n  CleanInlineConfig,\n  DocsInlineConfig,\n  LintInlineConfig,\n  PluginConfig,\n  PowerlinesAPI,\n  PrepareInlineConfig\n} from \"powerlines\";\nimport { createPowerlines } from \"powerlines\";\nimport { plugin } from \"./plugin\";\nimport type { UserConfig } from \"./types/config\";\n\n/**\n * The Shell Shock API class.\n *\n * @remarks\n * This class provides methods to interact with the Shell Shock build system, including cleaning, preparing, linting, building, generating documentation, and finalizing projects.\n */\nexport class ShellShockAPI {\n  #powerlines: PowerlinesAPI;\n\n  public static async from(config: UserConfig = {}): Promise<ShellShockAPI> {\n    const powerlines = await createPowerlines({\n      framework: \"shell-shock\",\n      ...config,\n      plugins: [plugin(), ...(config.plugins ?? [])] as PluginConfig<any>[]\n    });\n\n    return new ShellShockAPI(powerlines);\n  }\n\n  private constructor(powerlines: PowerlinesAPI) {\n    this.#powerlines = powerlines;\n  }\n\n  public async clean(inlineConfig: CleanInlineConfig): Promise<void> {\n    return this.#powerlines.clean(inlineConfig);\n  }\n\n  public async prepare(inlineConfig: PrepareInlineConfig): Promise<void> {\n    return this.#powerlines.prepare(inlineConfig);\n  }\n\n  public async lint(inlineConfig: LintInlineConfig): Promise<void> {\n    return this.#powerlines.lint(inlineConfig);\n  }\n\n  public async build(inlineConfig: BuildInlineConfig): Promise<void> {\n    return this.#powerlines.build(inlineConfig);\n  }\n\n  public async docs(inlineConfig: DocsInlineConfig): Promise<void> {\n    return this.#powerlines.docs(inlineConfig);\n  }\n\n  public async finalize(): Promise<void> {\n    return this.#powerlines.finalize();\n  }\n}\n\n/**\n * Creates a new {@link ShellShockAPI} instance.\n *\n * @param options - The user configuration options.\n * @returns A promise that resolves to a {@link ShellShockAPI} instance.\n */\nexport async function createShellShock(\n  options: Partial<UserConfig> = {}\n): Promise<ShellShockAPI> {\n  options.root ??= process.cwd();\n\n  return ShellShockAPI.from(options);\n}\n"],"mappings":";;;;;AAAA,MAAM,aAAa;CAAC;CAAK;CAAW;CAA2B;;;;;;;AAS/D,IAAa,gBAAb,MAAa,cAAc;CACvB;CACA,aAAa,KAAK,SAAS,EAAE,EAAE;2BACR,uCAAuB;;GAEtC,GAAG;;GAEN,CAAC;;CAGN,YAAY,cAAG;AACX,QAAK,aAAM;;CAEf,MAAM,MAAM,cAAE;AACV,SAAM,MAAA,WAAA,MAAA,aAAA;;CAEV,MAAM,QAAQ,cAAE;AACZ,SAAO,MAAI,WAAA,QAAA,aAAA;;CAEf,MAAM,KAAK,cAAc;AACrB,SAAO,MAAK,WAAY,KAAK,aAAW;;CAE9C,MAAA,MAAA,cAAA;AACM,SAAO,MAAK,WAAQ,MAAA,aAAA;;CAExB,MAAM,KAAA,cAAA;AACF,SAAO,MAAK,WAAY,KAAK,aAAa;;CAE9C,MAAM,WAAW;AACb,SAAO,MAAK,WAAQ,UAAA;;CAExB,OAAO,SAAS;EAAC;EAAe;EAAc;SAAiB,EAAE;QAAO;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;;;;;;;;AAQ5E,eAAE,iBAAA,UAAA,EAAA,EAAA;;AAEE,QAAO,cAAc,KAAK,QAAQ;;AAEtC,iBAAE,SAAA;OAAA;CAAA;CAAA;QAAA,EAAA;OAAA;CAAA;CAAA;CAAA"}

package/dist/api.d.cts

@@ -1,5 +1,5 @@
 import { UserConfig } from "./types/config.cjs";
-import { BuildInlineConfig, CleanInlineConfig, DocsInlineConfig, LintInlineConfig, PrepareInlineConfig } from "powerlines/types/config";
+import { BuildInlineConfig, CleanInlineConfig, DocsInlineConfig, LintInlineConfig, PrepareInlineConfig } from "powerlines";
 
 //#region src/api.d.ts
 

package/dist/api.d.mts

@@ -1,5 +1,5 @@
 import { UserConfig } from "./types/config.mjs";
-import { BuildInlineConfig, CleanInlineConfig, DocsInlineConfig, LintInlineConfig, PrepareInlineConfig } from "powerlines/types/config";
+import { BuildInlineConfig, CleanInlineConfig, DocsInlineConfig, LintInlineConfig, PrepareInlineConfig } from "powerlines";
 
 //#region src/api.d.ts
 

package/dist/api.mjs

@@ -44,7 +44,6 @@ var ShellShockAPI = class ShellShockAPI {
 		return this.#powerlines.finalize();
 	}
 	static __type = [
-		"PowerlinesAPI",
 		"#powerlines",
 		"UserConfig",
 		"config",
@@ -61,7 +60,7 @@ var ShellShockAPI = class ShellShockAPI {
 		"docs",
 		"finalize",
 		"ShellShockAPI",
-		"\"w!3\"P\"w#2$>%P7&`0'sP\"w!2(\"0)P!2*$`0+P!2*$`0,P!2*$`0-P!2*$`0.P!2*$`0/P$`005w1"
+		"!3!P\"w\"2#>$P7%`0&sP!2'\"0(P!2)$`0*P!2)$`0+P!2)$`0,P!2)$`0-P!2)$`0.P$`0/5w0"
 	];
 };
 /**

package/dist/api.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"api.mjs","names":[],"sources":["../src/api.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 { createPowerlines } from \"powerlines\";\nimport type { PowerlinesAPI } from \"powerlines/api\";\nimport type {\n  BuildInlineConfig,\n  CleanInlineConfig,\n  DocsInlineConfig,\n  LintInlineConfig,\n  PluginConfig,\n  PrepareInlineConfig\n} from \"powerlines/types/config\";\nimport { plugin } from \"./plugin\";\nimport type { UserConfig } from \"./types/config\";\n\n/**\n * The Shell Shock API class.\n *\n * @remarks\n * This class provides methods to interact with the Shell Shock build system, including cleaning, preparing, linting, building, generating documentation, and finalizing projects.\n */\nexport class ShellShockAPI {\n  #powerlines: PowerlinesAPI;\n\n  public static async from(config: UserConfig = {}): Promise<ShellShockAPI> {\n    const powerlines = await createPowerlines({\n      framework: \"shell-shock\",\n      ...config,\n      plugins: [plugin(), ...(config.plugins ?? [])] as PluginConfig<any>[]\n    });\n\n    return new ShellShockAPI(powerlines);\n  }\n\n  private constructor(powerlines: PowerlinesAPI) {\n    this.#powerlines = powerlines;\n  }\n\n  public async clean(inlineConfig: CleanInlineConfig): Promise<void> {\n    return this.#powerlines.clean(inlineConfig);\n  }\n\n  public async prepare(inlineConfig: PrepareInlineConfig): Promise<void> {\n    return this.#powerlines.prepare(inlineConfig);\n  }\n\n  public async lint(inlineConfig: LintInlineConfig): Promise<void> {\n    return this.#powerlines.lint(inlineConfig);\n  }\n\n  public async build(inlineConfig: BuildInlineConfig): Promise<void> {\n    return this.#powerlines.build(inlineConfig);\n  }\n\n  public async docs(inlineConfig: DocsInlineConfig): Promise<void> {\n    return this.#powerlines.docs(inlineConfig);\n  }\n\n  public async finalize(): Promise<void> {\n    return this.#powerlines.finalize();\n  }\n}\n\n/**\n * Creates a new {@link ShellShockAPI} instance.\n *\n * @param options - The user configuration options.\n * @returns A promise that resolves to a {@link ShellShockAPI} instance.\n */\nexport async function createShellShock(\n  options: Partial<UserConfig> = {}\n): Promise<ShellShockAPI> {\n  options.root ??= process.cwd();\n\n  return ShellShockAPI.from(options);\n}\n"],"mappings":";;;;AAAA,MAAM,aAAa;CAAC;CAAK;CAAW;CAA2B;;;;;;;AA0B/D,IAAa,gBAAb,MAAa,cAAO;CAChB;CACA,aAAa,KAAK,SAAS,EAAE,EAAA;AAMzB,SAAE,IAAA,cALiB,MAAM,iBAAe;;GAE9C,GAAA;GACU,SAAS,CAAC,QAAM,EAAA,GAAA,OAAA,WAAA,EAAA,CAAA;GAC3B,CAAA,CACS;;CAER,YAAA,YAAA;AACM,QAAK,aAAc;;;AAGnB,SAAO,MAAK,WAAY,MAAM,aAAa;;CAE/C,MAAM,QAAQ,cAAY;AACtB,SAAO,MAAA,WAAA,QAAA,aAAA;;CAEX,MAAE,KAAA,cAAA;;;CAGJ,MAAA,MAAA,cAAA;;;CAGE,MAAM,KAAK,cAAc;AAC3B,SAAA,MAAA,WAAA,KAAA,aAAA;;CAEE,MAAM,WAAW;AACb,SAAO,MAAK,WAAY,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWtC,SAAQ,SAAS,QAAQ,KAAK;AAC9B,QAAO,cAAc,KAAK,QAAQ"}
+{"version":3,"file":"api.mjs","names":[],"sources":["../src/api.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 {\n  BuildInlineConfig,\n  CleanInlineConfig,\n  DocsInlineConfig,\n  LintInlineConfig,\n  PluginConfig,\n  PowerlinesAPI,\n  PrepareInlineConfig\n} from \"powerlines\";\nimport { createPowerlines } from \"powerlines\";\nimport { plugin } from \"./plugin\";\nimport type { UserConfig } from \"./types/config\";\n\n/**\n * The Shell Shock API class.\n *\n * @remarks\n * This class provides methods to interact with the Shell Shock build system, including cleaning, preparing, linting, building, generating documentation, and finalizing projects.\n */\nexport class ShellShockAPI {\n  #powerlines: PowerlinesAPI;\n\n  public static async from(config: UserConfig = {}): Promise<ShellShockAPI> {\n    const powerlines = await createPowerlines({\n      framework: \"shell-shock\",\n      ...config,\n      plugins: [plugin(), ...(config.plugins ?? [])] as PluginConfig<any>[]\n    });\n\n    return new ShellShockAPI(powerlines);\n  }\n\n  private constructor(powerlines: PowerlinesAPI) {\n    this.#powerlines = powerlines;\n  }\n\n  public async clean(inlineConfig: CleanInlineConfig): Promise<void> {\n    return this.#powerlines.clean(inlineConfig);\n  }\n\n  public async prepare(inlineConfig: PrepareInlineConfig): Promise<void> {\n    return this.#powerlines.prepare(inlineConfig);\n  }\n\n  public async lint(inlineConfig: LintInlineConfig): Promise<void> {\n    return this.#powerlines.lint(inlineConfig);\n  }\n\n  public async build(inlineConfig: BuildInlineConfig): Promise<void> {\n    return this.#powerlines.build(inlineConfig);\n  }\n\n  public async docs(inlineConfig: DocsInlineConfig): Promise<void> {\n    return this.#powerlines.docs(inlineConfig);\n  }\n\n  public async finalize(): Promise<void> {\n    return this.#powerlines.finalize();\n  }\n}\n\n/**\n * Creates a new {@link ShellShockAPI} instance.\n *\n * @param options - The user configuration options.\n * @returns A promise that resolves to a {@link ShellShockAPI} instance.\n */\nexport async function createShellShock(\n  options: Partial<UserConfig> = {}\n): Promise<ShellShockAPI> {\n  options.root ??= process.cwd();\n\n  return ShellShockAPI.from(options);\n}\n"],"mappings":";;;;AAAA,MAAM,aAAa;CAAC;CAAK;CAAW;CAA2B;;;;;;;AAS/D,IAAa,gBAAb,MAAa,cAAc;CACvB;CACA,aAAa,KAAK,SAAS,EAAE,EAAE;2BACR,MAAM,iBAAiB;;GAEtC,GAAG;;GAEN,CAAC;;CAGN,YAAY,YAAG;AACX,QAAK,aAAM;;CAEf,MAAM,MAAM,cAAE;AACV,SAAM,MAAA,WAAA,MAAA,aAAA;;CAEV,MAAM,QAAQ,cAAE;AACZ,SAAO,MAAI,WAAA,QAAA,aAAA;;CAEf,MAAM,KAAK,cAAc;AACrB,SAAO,MAAK,WAAY,KAAK,aAAW;;CAE9C,MAAA,MAAA,cAAA;AACM,SAAO,MAAK,WAAQ,MAAA,aAAA;;CAExB,MAAM,KAAA,cAAA;AACF,SAAO,MAAK,WAAY,KAAK,aAAa;;CAE9C,MAAM,WAAW;AACb,SAAO,MAAK,WAAQ,UAAA;;CAExB,OAAO,SAAS;EAAC;EAAe;EAAc;SAAiB,EAAE;QAAO;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;;;;;;;;AAQ5E,eAAE,iBAAA,UAAA,EAAA,EAAA;;AAEE,QAAO,cAAc,KAAK,QAAQ;;AAEtC,iBAAE,SAAA;OAAA;CAAA;CAAA;QAAA,EAAA;OAAA;CAAA;CAAA;CAAA"}

package/dist/components/docs.cjs

@@ -1,8 +1,8 @@
 const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
 const require_contexts_command = require('../contexts/command.cjs');
 const require_docs_helpers = require('../helpers/docs-helpers.cjs');
-const require_plugin_utils_context_helpers = require('../plugin-utils/context-helpers.cjs');
-const require_plugin_utils_reflect = require('../plugin-utils/reflect.cjs');
+const require_context_helpers = require('../plugin-utils/context-helpers.cjs');
+const require_reflect = require('../plugin-utils/reflect.cjs');
 const require_components_usage = require('./usage.cjs');
 let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
 let __alloy_js_core = require("@alloy-js/core");
@@ -21,7 +21,7 @@ function CommandOptionsDocs(props) {
 	const { command } = props;
 	if (Object.keys(command.options).length === 0) return __alloy_js_core.code`This command does not have any options.`;
 	return (0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_markdown_components_markdown_table.MarkdownTable, { get data() {
-		return require_plugin_utils_reflect.sortOptions(Object.values(command.options)).map((option) => {
+		return require_reflect.sortOptions(Object.values(command.options)).map((option) => {
 			return {
 				name: option.name.trim(),
 				description: option.description.trim(),
@@ -44,7 +44,7 @@ function CommandDocsUsageExample(props) {
 		(0, __alloy_js_core_jsx_runtime.createComponent)(require_components_usage.Usage, {
 			command,
 			get bin() {
-				return require_plugin_utils_context_helpers.getAppBin(context);
+				return require_context_helpers.getAppBin(context);
 			},
 			packageManager
 		}),

package/dist/components/docs.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"docs.cjs","names":["code","For","memo","Show","Heading","Spacing","usePowerlines","MarkdownFile","MarkdownTable","joinPaths","CommandContext","getDocsOutputPath","getAppBin","sortOptions","Usage","CommandOptionsDocs","props","command","Object","keys","options","length","_$createComponent","data","values","map","option","name","trim","description","defaultValue","default","String","includes","required","optional","CommandDocsUsageExample","packageManager","context","_$createIntrinsic","bin","CommandDocs","levelOffset","usageExamples","level","children","title","_$memo","when","fallback","each","hardline","CommandDocsFile","rest","Provider","value","_$mergeProps","path"],"sources":["../../src/components/docs.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, For, memo, Show } from \"@alloy-js/core\";\nimport { Heading } from \"@alloy-js/markdown\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { MarkdownFileProps } from \"@powerlines/plugin-alloy/markdown/components/markdown-file\";\nimport { MarkdownFile } from \"@powerlines/plugin-alloy/markdown/components/markdown-file\";\nimport { MarkdownTable } from \"@powerlines/plugin-alloy/markdown/components/markdown-table\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { CommandContext } from \"../contexts/command\";\nimport { getDocsOutputPath } from \"../helpers/docs-helpers\";\nimport { getAppBin } from \"../plugin-utils/context-helpers\";\nimport { sortOptions } from \"../plugin-utils/reflect\";\nimport type { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport { Usage } from \"./usage\";\n\nexport interface CommandOptionsDocsProps {\n  /**\n   * The command to generate options documentation for.\n   */\n  command: CommandTree;\n}\n\n/**\n * Generates the options markdown documentation for a command.\n */\nexport function CommandOptionsDocs(props: CommandOptionsDocsProps) {\n  const { command } = props;\n  if (Object.keys(command.options).length === 0) {\n    return code`This command does not have any options.`;\n  }\n\n  return (\n    <MarkdownTable\n      data={sortOptions(Object.values(command.options)).map(option => {\n        return {\n          name: option.name.trim(),\n          description: option.description.trim(),\n          defaultValue: option.default\n            ? String(option.default)?.includes('\"')\n              ? option.default\n              : `\\`${option.default}\\``\n            : \"\",\n          required: option.optional || option.default ? \"\" : \"✔\"\n        };\n      })}\n    />\n  );\n}\n\nexport interface CommandDocsUsageExampleProps {\n  /**\n   * The package manager to generate the usage example for.\n   *\n   * @remarks\n   * If not specified, examples for all supported package managers will be generated.\n   *\n   * @defaultValue \"npm\"\n   */\n  packageManager?: \"npm\" | \"yarn\" | \"pnpm\" | \"bun\";\n\n  /**\n   * The command to generate the usage example for.\n   */\n  command: CommandTree;\n}\n\n/**\n * Generates the markdown documentation for a command.\n */\nexport function CommandDocsUsageExample(props: CommandDocsUsageExampleProps) {\n  const { packageManager = \"npm\", command } = props;\n\n  const context = usePowerlines<Context>();\n\n  return (\n    <>\n      <hbr />\n      {code`\\`\\`\\`bash `}\n      <hbr />\n      <Usage\n        command={command}\n        bin={getAppBin(context)}\n        packageManager={packageManager}\n      />\n      <hbr />\n      {code`\\`\\`\\``}\n      <hbr />\n    </>\n  );\n}\n\nexport interface CommandDocsProps {\n  /**\n   * The heading level offset to apply to the generated documentation.\n   *\n   * @remarks\n   * This is useful when nesting the documentation within other markdown files.\n   *\n   * @defaultValue 0\n   */\n  levelOffset?: number;\n\n  /**\n   * The command to generate options documentation for.\n   */\n  command: CommandTree;\n\n  /**\n   * Optional usage examples to include in the documentation.\n   *\n   * @defaultValue `[\"npm\"]`\n   */\n  usageExamples?: Required<CommandDocsUsageExampleProps>[\"packageManager\"][];\n}\n\n/**\n * Generates the markdown documentation for a command.\n */\nexport function CommandDocs(props: CommandDocsProps) {\n  const { levelOffset = 0, command, usageExamples } = props;\n\n  return (\n    <>\n      <Heading level={1 + levelOffset}>{command.title}</Heading>\n      <Spacing />\n      {code`${command.description}`}\n      <Spacing />\n      <Heading level={2 + levelOffset}>Usage</Heading>\n      <Spacing />\n      {code`The ${command.name} command can be executed using the following syntax: `}\n      <Spacing />\n      <Show\n        when={usageExamples && usageExamples.length > 0}\n        fallback={\n          <CommandDocsUsageExample packageManager=\"npm\" command={command} />\n        }>\n        <For each={usageExamples!} hardline>\n          {packageManager => (\n            <CommandDocsUsageExample\n              packageManager={packageManager}\n              command={command}\n            />\n          )}\n        </For>\n      </Show>\n      <Spacing />\n      <Heading level={2 + levelOffset}>Options</Heading>\n      <Spacing />\n      {code`The following options are available for the ${\n        command.name\n      } command:`}\n      <Spacing />\n      <CommandOptionsDocs command={command} />\n      <Spacing />\n    </>\n  );\n}\n\nexport interface CommandDocsFileProps extends Partial<MarkdownFileProps> {\n  /**\n   * The heading level offset to apply to the generated documentation.\n   *\n   * @remarks\n   * This is useful when nesting the documentation within other markdown files.\n   *\n   * @defaultValue 0\n   */\n  levelOffset?: number;\n\n  /**\n   * The command to generate documentation for.\n   */\n  command: CommandTree;\n}\n\n/**\n * Generates the markdown documentation file for a command.\n */\nexport function CommandDocsFile(props: CommandDocsFileProps) {\n  const { levelOffset = 0, command, ...rest } = props;\n\n  const context = usePowerlines<Context>();\n  const usageExamples = memo(\n    () => [\"npm\", \"yarn\", \"pnpm\", \"bun\"] as CommandDocsProps[\"usageExamples\"]\n  );\n\n  return (\n    <CommandContext.Provider value={command}>\n      <MarkdownFile\n        path={joinPaths(getDocsOutputPath(context), `${command.path}.md`)}\n        {...rest}>\n        <CommandDocs\n          levelOffset={levelOffset}\n          command={command}\n          usageExamples={usageExamples()}\n        />\n      </MarkdownFile>\n    </CommandContext.Provider>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"docs.cjs","names":["code","For","memo","Show","Heading","Spacing","usePowerlines","MarkdownFile","MarkdownTable","joinPaths","CommandContext","getDocsOutputPath","getAppBin","sortOptions","Usage","CommandOptionsDocs","props","command","Object","keys","options","length","_$createComponent","data","values","map","option","name","trim","description","defaultValue","default","String","includes","required","optional","CommandDocsUsageExample","packageManager","context","_$createIntrinsic","bin","CommandDocs","levelOffset","usageExamples","level","children","title","_$memo","when","fallback","each","hardline","CommandDocsFile","rest","Provider","value","_$mergeProps","path"],"sources":["../../src/components/docs.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, For, memo, Show } from \"@alloy-js/core\";\nimport { Heading } from \"@alloy-js/markdown\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core/components/spacing\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport type { MarkdownFileProps } from \"@powerlines/plugin-alloy/markdown/components/markdown-file\";\nimport { MarkdownFile } from \"@powerlines/plugin-alloy/markdown/components/markdown-file\";\nimport { MarkdownTable } from \"@powerlines/plugin-alloy/markdown/components/markdown-table\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { CommandContext } from \"../contexts/command\";\nimport { getDocsOutputPath } from \"../helpers/docs-helpers\";\nimport { getAppBin } from \"../plugin-utils/context-helpers\";\nimport { sortOptions } from \"../plugin-utils/reflect\";\nimport type { CommandTree } from \"../types/command\";\nimport type { Context } from \"../types/context\";\nimport { Usage } from \"./usage\";\n\nexport interface CommandOptionsDocsProps {\n  /**\n   * The command to generate options documentation for.\n   */\n  command: CommandTree;\n}\n\n/**\n * Generates the options markdown documentation for a command.\n */\nexport function CommandOptionsDocs(props: CommandOptionsDocsProps) {\n  const { command } = props;\n  if (Object.keys(command.options).length === 0) {\n    return code`This command does not have any options.`;\n  }\n\n  return (\n    <MarkdownTable\n      data={sortOptions(Object.values(command.options)).map(option => {\n        return {\n          name: option.name.trim(),\n          description: option.description.trim(),\n          defaultValue: option.default\n            ? String(option.default)?.includes('\"')\n              ? option.default\n              : `\\`${option.default}\\``\n            : \"\",\n          required: option.optional || option.default ? \"\" : \"✔\"\n        };\n      })}\n    />\n  );\n}\n\nexport interface CommandDocsUsageExampleProps {\n  /**\n   * The package manager to generate the usage example for.\n   *\n   * @remarks\n   * If not specified, examples for all supported package managers will be generated.\n   *\n   * @defaultValue \"npm\"\n   */\n  packageManager?: \"npm\" | \"yarn\" | \"pnpm\" | \"bun\";\n\n  /**\n   * The command to generate the usage example for.\n   */\n  command: CommandTree;\n}\n\n/**\n * Generates the markdown documentation for a command.\n */\nexport function CommandDocsUsageExample(props: CommandDocsUsageExampleProps) {\n  const { packageManager = \"npm\", command } = props;\n\n  const context = usePowerlines<Context>();\n\n  return (\n    <>\n      <hbr />\n      {code`\\`\\`\\`bash `}\n      <hbr />\n      <Usage\n        command={command}\n        bin={getAppBin(context)}\n        packageManager={packageManager}\n      />\n      <hbr />\n      {code`\\`\\`\\``}\n      <hbr />\n    </>\n  );\n}\n\nexport interface CommandDocsProps {\n  /**\n   * The heading level offset to apply to the generated documentation.\n   *\n   * @remarks\n   * This is useful when nesting the documentation within other markdown files.\n   *\n   * @defaultValue 0\n   */\n  levelOffset?: number;\n\n  /**\n   * The command to generate options documentation for.\n   */\n  command: CommandTree;\n\n  /**\n   * Optional usage examples to include in the documentation.\n   *\n   * @defaultValue `[\"npm\"]`\n   */\n  usageExamples?: Required<CommandDocsUsageExampleProps>[\"packageManager\"][];\n}\n\n/**\n * Generates the markdown documentation for a command.\n */\nexport function CommandDocs(props: CommandDocsProps) {\n  const { levelOffset = 0, command, usageExamples } = props;\n\n  return (\n    <>\n      <Heading level={1 + levelOffset}>{command.title}</Heading>\n      <Spacing />\n      {code`${command.description}`}\n      <Spacing />\n      <Heading level={2 + levelOffset}>Usage</Heading>\n      <Spacing />\n      {code`The ${command.name} command can be executed using the following syntax: `}\n      <Spacing />\n      <Show\n        when={usageExamples && usageExamples.length > 0}\n        fallback={\n          <CommandDocsUsageExample packageManager=\"npm\" command={command} />\n        }>\n        <For each={usageExamples!} hardline>\n          {packageManager => (\n            <CommandDocsUsageExample\n              packageManager={packageManager}\n              command={command}\n            />\n          )}\n        </For>\n      </Show>\n      <Spacing />\n      <Heading level={2 + levelOffset}>Options</Heading>\n      <Spacing />\n      {code`The following options are available for the ${\n        command.name\n      } command:`}\n      <Spacing />\n      <CommandOptionsDocs command={command} />\n      <Spacing />\n    </>\n  );\n}\n\nexport interface CommandDocsFileProps extends Partial<MarkdownFileProps> {\n  /**\n   * The heading level offset to apply to the generated documentation.\n   *\n   * @remarks\n   * This is useful when nesting the documentation within other markdown files.\n   *\n   * @defaultValue 0\n   */\n  levelOffset?: number;\n\n  /**\n   * The command to generate documentation for.\n   */\n  command: CommandTree;\n}\n\n/**\n * Generates the markdown documentation file for a command.\n */\nexport function CommandDocsFile(props: CommandDocsFileProps) {\n  const { levelOffset = 0, command, ...rest } = props;\n\n  const context = usePowerlines<Context>();\n  const usageExamples = memo(\n    () => [\"npm\", \"yarn\", \"pnpm\", \"bun\"] as CommandDocsProps[\"usageExamples\"]\n  );\n\n  return (\n    <CommandContext.Provider value={command}>\n      <MarkdownFile\n        path={joinPaths(getDocsOutputPath(context), `${command.path}.md`)}\n        {...rest}>\n        <CommandDocs\n          levelOffset={levelOffset}\n          command={command}\n          usageExamples={usageExamples()}\n        />\n      </MarkdownFile>\n    </CommandContext.Provider>\n  );\n}\n"],"mappings":"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"}

package/dist/components/docs.d.cts

@@ -1,5 +1,5 @@
 import { CommandTree } from "../types/command.cjs";
-import * as _alloy_js_core8 from "@alloy-js/core";
+import * as _alloy_js_core7 from "@alloy-js/core";
 import { MarkdownFileProps } from "@powerlines/plugin-alloy/markdown/components/markdown-file";
 
 //#region src/components/docs.d.ts
@@ -12,7 +12,7 @@ interface CommandOptionsDocsProps {
 /**
  * Generates the options markdown documentation for a command.
  */
-declare function CommandOptionsDocs(props: CommandOptionsDocsProps): _alloy_js_core8.Children;
+declare function CommandOptionsDocs(props: CommandOptionsDocsProps): _alloy_js_core7.Children;
 interface CommandDocsUsageExampleProps {
   /**
    * The package manager to generate the usage example for.
@@ -31,7 +31,7 @@ interface CommandDocsUsageExampleProps {
 /**
  * Generates the markdown documentation for a command.
  */
-declare function CommandDocsUsageExample(props: CommandDocsUsageExampleProps): _alloy_js_core8.Children;
+declare function CommandDocsUsageExample(props: CommandDocsUsageExampleProps): _alloy_js_core7.Children;
 interface CommandDocsProps {
   /**
    * The heading level offset to apply to the generated documentation.
@@ -56,7 +56,7 @@ interface CommandDocsProps {
 /**
  * Generates the markdown documentation for a command.
  */
-declare function CommandDocs(props: CommandDocsProps): _alloy_js_core8.Children;
+declare function CommandDocs(props: CommandDocsProps): _alloy_js_core7.Children;
 interface CommandDocsFileProps extends Partial<MarkdownFileProps> {
   /**
    * The heading level offset to apply to the generated documentation.
@@ -75,7 +75,7 @@ interface CommandDocsFileProps extends Partial<MarkdownFileProps> {
 /**
  * Generates the markdown documentation file for a command.
  */
-declare function CommandDocsFile(props: CommandDocsFileProps): _alloy_js_core8.Children;
+declare function CommandDocsFile(props: CommandDocsFileProps): _alloy_js_core7.Children;
 //#endregion
 export { CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps };
 //# sourceMappingURL=docs.d.cts.map

package/dist/components/docs.d.mts

@@ -1,5 +1,5 @@
 import { CommandTree } from "../types/command.mjs";
-import * as _alloy_js_core20 from "@alloy-js/core";
+import * as _alloy_js_core16 from "@alloy-js/core";
 import { MarkdownFileProps } from "@powerlines/plugin-alloy/markdown/components/markdown-file";
 
 //#region src/components/docs.d.ts
@@ -12,7 +12,7 @@ interface CommandOptionsDocsProps {
 /**
  * Generates the options markdown documentation for a command.
  */
-declare function CommandOptionsDocs(props: CommandOptionsDocsProps): _alloy_js_core20.Children;
+declare function CommandOptionsDocs(props: CommandOptionsDocsProps): _alloy_js_core16.Children;
 interface CommandDocsUsageExampleProps {
   /**
    * The package manager to generate the usage example for.
@@ -31,7 +31,7 @@ interface CommandDocsUsageExampleProps {
 /**
  * Generates the markdown documentation for a command.
  */
-declare function CommandDocsUsageExample(props: CommandDocsUsageExampleProps): _alloy_js_core20.Children;
+declare function CommandDocsUsageExample(props: CommandDocsUsageExampleProps): _alloy_js_core16.Children;
 interface CommandDocsProps {
   /**
    * The heading level offset to apply to the generated documentation.
@@ -56,7 +56,7 @@ interface CommandDocsProps {
 /**
  * Generates the markdown documentation for a command.
  */
-declare function CommandDocs(props: CommandDocsProps): _alloy_js_core20.Children;
+declare function CommandDocs(props: CommandDocsProps): _alloy_js_core16.Children;
 interface CommandDocsFileProps extends Partial<MarkdownFileProps> {
   /**
    * The heading level offset to apply to the generated documentation.
@@ -75,7 +75,7 @@ interface CommandDocsFileProps extends Partial<MarkdownFileProps> {
 /**
  * Generates the markdown documentation file for a command.
  */
-declare function CommandDocsFile(props: CommandDocsFileProps): _alloy_js_core20.Children;
+declare function CommandDocsFile(props: CommandDocsFileProps): _alloy_js_core16.Children;
 //#endregion
 export { CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps };
 //# sourceMappingURL=docs.d.mts.map

package/dist/components/helpers.d.cts

@@ -1,4 +1,4 @@
-import * as _alloy_js_core12 from "@alloy-js/core";
+import * as _alloy_js_core19 from "@alloy-js/core";
 
 //#region src/components/helpers.d.ts
 interface BooleanInputParserLogicProps {
@@ -7,29 +7,29 @@ interface BooleanInputParserLogicProps {
 /**
  * Parses a string input into a boolean value, interpreting common truthy and falsy string representations.
  */
-declare function BooleanInputParserLogic(props: BooleanInputParserLogicProps): _alloy_js_core12.Children;
+declare function BooleanInputParserLogic(props: BooleanInputParserLogicProps): _alloy_js_core19.Children;
 /**
  * Write the logic to determine if the application is running in debug mode.
  *
  * @remarks
  * This is used to conditionally include debug-only logic in the generated application, such as additional logging or development tools. The logic should check for common indicators of debug mode, such as environment variables or the presence of a debugger.
  */
-declare function IsDebug(): _alloy_js_core12.Children;
+declare function IsDebug(): _alloy_js_core19.Children;
 /**
  * Write the logic to determine if the application is **not** running in debug mode.
  */
-declare function IsNotDebug(): _alloy_js_core12.Children;
+declare function IsNotDebug(): _alloy_js_core19.Children;
 /**
  * Write the logic to determine if the application is running in verbose mode.
  *
  * @remarks
  * This is used to conditionally include verbose-only logic in the generated application, such as additional logging or detailed output. The logic should check for common indicators of verbose mode, such as environment variables or command-line flags.
  */
-declare function IsVerbose(): _alloy_js_core12.Children;
+declare function IsVerbose(): _alloy_js_core19.Children;
 /**
  * Write the logic to determine if the application is **not** running in verbose mode.
  */
-declare function IsNotVerbose(): _alloy_js_core12.Children;
+declare function IsNotVerbose(): _alloy_js_core19.Children;
 //#endregion
 export { BooleanInputParserLogic, BooleanInputParserLogicProps, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose };
 //# sourceMappingURL=helpers.d.cts.map

package/dist/components/helpers.d.mts

@@ -1,4 +1,4 @@
-import * as _alloy_js_core8 from "@alloy-js/core";
+import * as _alloy_js_core20 from "@alloy-js/core";
 
 //#region src/components/helpers.d.ts
 interface BooleanInputParserLogicProps {
@@ -7,29 +7,29 @@ interface BooleanInputParserLogicProps {
 /**
  * Parses a string input into a boolean value, interpreting common truthy and falsy string representations.
  */
-declare function BooleanInputParserLogic(props: BooleanInputParserLogicProps): _alloy_js_core8.Children;
+declare function BooleanInputParserLogic(props: BooleanInputParserLogicProps): _alloy_js_core20.Children;
 /**
  * Write the logic to determine if the application is running in debug mode.
  *
  * @remarks
  * This is used to conditionally include debug-only logic in the generated application, such as additional logging or development tools. The logic should check for common indicators of debug mode, such as environment variables or the presence of a debugger.
  */
-declare function IsDebug(): _alloy_js_core8.Children;
+declare function IsDebug(): _alloy_js_core20.Children;
 /**
  * Write the logic to determine if the application is **not** running in debug mode.
  */
-declare function IsNotDebug(): _alloy_js_core8.Children;
+declare function IsNotDebug(): _alloy_js_core20.Children;
 /**
  * Write the logic to determine if the application is running in verbose mode.
  *
  * @remarks
  * This is used to conditionally include verbose-only logic in the generated application, such as additional logging or detailed output. The logic should check for common indicators of verbose mode, such as environment variables or command-line flags.
  */
-declare function IsVerbose(): _alloy_js_core8.Children;
+declare function IsVerbose(): _alloy_js_core20.Children;
 /**
  * Write the logic to determine if the application is **not** running in verbose mode.
  */
-declare function IsNotVerbose(): _alloy_js_core8.Children;
+declare function IsNotVerbose(): _alloy_js_core20.Children;
 //#endregion
 export { BooleanInputParserLogic, BooleanInputParserLogicProps, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose };
 //# sourceMappingURL=helpers.d.mts.map

package/dist/components/helpers.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.mts","names":[],"sources":["../../src/components/helpers.tsx"],"sourcesContent":[],"mappings":";;;UAoBiB,4BAAA;;;AAAjB;AAOA;AA0BA;AAOgB,iBAjCA,uBAAA,CAiCU,KAAA,EAjCqB,4BAiCrB,CAAA,EAjCiD,eAAA,CAAA,QAiCjD;AAgB1B;AAaA;;;;;iBApCgB,OAAA,CAAA,GAAO,eAAA,CAAA;;;;iBAOP,UAAA,CAAA,GAAU,eAAA,CAAA;;;;;;;iBAgBV,SAAA,CAAA,GAAS,eAAA,CAAA;;;;iBAaT,YAAA,CAAA,GAAY,eAAA,CAAA"}
+{"version":3,"file":"helpers.d.mts","names":[],"sources":["../../src/components/helpers.tsx"],"sourcesContent":[],"mappings":";;;UAoBiB,4BAAA;;;AAAjB;AAOA;AA0BA;AAOgB,iBAjCA,uBAAA,CAiCU,KAAA,EAjCqB,4BAiCrB,CAAA,EAjCiD,gBAAA,CAAA,QAiCjD;AAgB1B;AAaA;;;;;iBApCgB,OAAA,CAAA,GAAO,gBAAA,CAAA;;;;iBAOP,UAAA,CAAA,GAAU,gBAAA,CAAA;;;;;;;iBAgBV,SAAA,CAAA,GAAS,gBAAA,CAAA;;;;iBAaT,YAAA,CAAA,GAAY,gBAAA,CAAA"}

package/dist/components/index.cjs

@@ -16,6 +16,7 @@ exports.CommandParserLogic = require_components_options_parser_logic.CommandPars
 exports.ContextUtilities = require_components_utils_builtin.ContextUtilities;
 exports.DynamicSegmentsParserLogic = require_components_options_parser_logic.DynamicSegmentsParserLogic;
 exports.EnvSupportUtilities = require_components_utils_builtin.EnvSupportUtilities;
+exports.FindSuggestionsDeclaration = require_components_utils_builtin.FindSuggestionsDeclaration;
 exports.HyperlinkSupportUtilities = require_components_utils_builtin.HyperlinkSupportUtilities;
 exports.IsDebug = require_components_helpers.IsDebug;
 exports.IsNotDebug = require_components_helpers.IsNotDebug;

package/dist/components/index.d.cts

@@ -2,5 +2,5 @@ import { CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, C
 import { BooleanInputParserLogic, BooleanInputParserLogicProps, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose } from "./helpers.cjs";
 import { ArgumentsParserLogic, ArgumentsParserLogicProps, CommandParserLogic, CommandParserLogicProps, DynamicSegmentsParserLogic, DynamicSegmentsParserLogicProps, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserConditionProps, OptionsMemberParserLogic, OptionsMemberParserLogicProps, OptionsParserLogic, OptionsParserLogicProps } from "./options-parser-logic.cjs";
 import { Usage, UsageProps } from "./usage.cjs";
-import { ArgsUtilities, ColorSupportUtilities, ContextUtilities, EnvSupportUtilities, HyperlinkSupportUtilities, SpawnFunctionDeclaration, UtilsBuiltin, UtilsBuiltinProps } from "./utils-builtin.cjs";
-export { ArgsUtilities, ArgumentsParserLogic, ArgumentsParserLogicProps, BooleanInputParserLogic, BooleanInputParserLogicProps, ColorSupportUtilities, CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps, CommandParserLogic, CommandParserLogicProps, ContextUtilities, DynamicSegmentsParserLogic, DynamicSegmentsParserLogicProps, EnvSupportUtilities, HyperlinkSupportUtilities, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserConditionProps, OptionsMemberParserLogic, OptionsMemberParserLogicProps, OptionsParserLogic, OptionsParserLogicProps, SpawnFunctionDeclaration, Usage, UsageProps, UtilsBuiltin, UtilsBuiltinProps };
+import { ArgsUtilities, ColorSupportUtilities, ContextUtilities, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, SpawnFunctionDeclaration, UtilsBuiltin, UtilsBuiltinProps } from "./utils-builtin.cjs";
+export { ArgsUtilities, ArgumentsParserLogic, ArgumentsParserLogicProps, BooleanInputParserLogic, BooleanInputParserLogicProps, ColorSupportUtilities, CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps, CommandParserLogic, CommandParserLogicProps, ContextUtilities, DynamicSegmentsParserLogic, DynamicSegmentsParserLogicProps, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserConditionProps, OptionsMemberParserLogic, OptionsMemberParserLogicProps, OptionsParserLogic, OptionsParserLogicProps, SpawnFunctionDeclaration, Usage, UsageProps, UtilsBuiltin, UtilsBuiltinProps };

package/dist/components/index.d.mts

@@ -2,5 +2,5 @@ import { CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, C
 import { BooleanInputParserLogic, BooleanInputParserLogicProps, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose } from "./helpers.mjs";
 import { ArgumentsParserLogic, ArgumentsParserLogicProps, CommandParserLogic, CommandParserLogicProps, DynamicSegmentsParserLogic, DynamicSegmentsParserLogicProps, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserConditionProps, OptionsMemberParserLogic, OptionsMemberParserLogicProps, OptionsParserLogic, OptionsParserLogicProps } from "./options-parser-logic.mjs";
 import { Usage, UsageProps } from "./usage.mjs";
-import { ArgsUtilities, ColorSupportUtilities, ContextUtilities, EnvSupportUtilities, HyperlinkSupportUtilities, SpawnFunctionDeclaration, UtilsBuiltin, UtilsBuiltinProps } from "./utils-builtin.mjs";
-export { ArgsUtilities, ArgumentsParserLogic, ArgumentsParserLogicProps, BooleanInputParserLogic, BooleanInputParserLogicProps, ColorSupportUtilities, CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps, CommandParserLogic, CommandParserLogicProps, ContextUtilities, DynamicSegmentsParserLogic, DynamicSegmentsParserLogicProps, EnvSupportUtilities, HyperlinkSupportUtilities, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserConditionProps, OptionsMemberParserLogic, OptionsMemberParserLogicProps, OptionsParserLogic, OptionsParserLogicProps, SpawnFunctionDeclaration, Usage, UsageProps, UtilsBuiltin, UtilsBuiltinProps };
+import { ArgsUtilities, ColorSupportUtilities, ContextUtilities, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, SpawnFunctionDeclaration, UtilsBuiltin, UtilsBuiltinProps } from "./utils-builtin.mjs";
+export { ArgsUtilities, ArgumentsParserLogic, ArgumentsParserLogicProps, BooleanInputParserLogic, BooleanInputParserLogicProps, ColorSupportUtilities, CommandDocs, CommandDocsFile, CommandDocsFileProps, CommandDocsProps, CommandDocsUsageExample, CommandDocsUsageExampleProps, CommandOptionsDocs, CommandOptionsDocsProps, CommandParserLogic, CommandParserLogicProps, ContextUtilities, DynamicSegmentsParserLogic, DynamicSegmentsParserLogicProps, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserConditionProps, OptionsMemberParserLogic, OptionsMemberParserLogicProps, OptionsParserLogic, OptionsParserLogicProps, SpawnFunctionDeclaration, Usage, UsageProps, UtilsBuiltin, UtilsBuiltinProps };

package/dist/components/index.mjs

@@ -1,7 +1,7 @@
 import { Usage } from "./usage.mjs";
 import { CommandDocs, CommandDocsFile, CommandDocsUsageExample, CommandOptionsDocs } from "./docs.mjs";
-import { ArgsUtilities, ColorSupportUtilities, ContextUtilities, EnvSupportUtilities, HyperlinkSupportUtilities, SpawnFunctionDeclaration, UtilsBuiltin } from "./utils-builtin.mjs";
+import { ArgsUtilities, ColorSupportUtilities, ContextUtilities, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, SpawnFunctionDeclaration, UtilsBuiltin } from "./utils-builtin.mjs";
 import { BooleanInputParserLogic, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose } from "./helpers.mjs";
 import { ArgumentsParserLogic, CommandParserLogic, DynamicSegmentsParserLogic, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserLogic, OptionsParserLogic } from "./options-parser-logic.mjs";
 
-export { ArgsUtilities, ArgumentsParserLogic, BooleanInputParserLogic, ColorSupportUtilities, CommandDocs, CommandDocsFile, CommandDocsUsageExample, CommandOptionsDocs, CommandParserLogic, ContextUtilities, DynamicSegmentsParserLogic, EnvSupportUtilities, HyperlinkSupportUtilities, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserLogic, OptionsParserLogic, SpawnFunctionDeclaration, Usage, UtilsBuiltin };
+export { ArgsUtilities, ArgumentsParserLogic, BooleanInputParserLogic, ColorSupportUtilities, CommandDocs, CommandDocsFile, CommandDocsUsageExample, CommandOptionsDocs, CommandParserLogic, ContextUtilities, DynamicSegmentsParserLogic, EnvSupportUtilities, FindSuggestionsDeclaration, HyperlinkSupportUtilities, IsDebug, IsNotDebug, IsNotVerbose, IsVerbose, OptionsInterfaceDeclaration, OptionsMember, OptionsMemberParserCondition, OptionsMemberParserLogic, OptionsParserLogic, SpawnFunctionDeclaration, Usage, UtilsBuiltin };