@shell-shock/plugin-completions 0.2.24 → 0.3.0

package/dist/components/fish-shared.d.cts

@@ -0,0 +1,10 @@
+import * as _$_alloy_js_core0 from "@alloy-js/core";
+
+//#region src/components/fish-shared.d.ts
+/**
+ * The Fish Completions generation for the Shell Shock project.
+ */
+declare function FishCompletionsShared(): _$_alloy_js_core0.Children;
+//#endregion
+export { FishCompletionsShared };
+//# sourceMappingURL=fish-shared.d.cts.map

package/dist/components/fish-shared.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fish-shared.d.cts","names":[],"sources":["../../src/components/fish-shared.tsx"],"mappings":";;;;;;iBAiCgB,qBAAA,CAAA,GAAqB,iBAAA,CAAA,QAAA"}

package/dist/components/fish-shared.d.mts

@@ -0,0 +1,10 @@
+import * as _$_alloy_js_core0 from "@alloy-js/core";
+
+//#region src/components/fish-shared.d.ts
+/**
+ * The Fish Completions generation for the Shell Shock project.
+ */
+declare function FishCompletionsShared(): _$_alloy_js_core0.Children;
+//#endregion
+export { FishCompletionsShared };
+//# sourceMappingURL=fish-shared.d.mts.map

package/dist/components/fish-shared.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fish-shared.d.mts","names":[],"sources":["../../src/components/fish-shared.tsx"],"mappings":";;;;;;iBAiCgB,qBAAA,CAAA,GAAqB,iBAAA,CAAA,QAAA"}

package/dist/components/{fish-command.mjs → fish-shared.mjs}

@@ -1,108 +1,38 @@
 import { EXEC_COMMAND } from "../helpers/complete-command.mjs";
 import { CompletionDirective } from "../helpers/completion-directive-constants.mjs";
-import { createComponent, memo } from "@alloy-js/core/jsx-runtime";
-import { getAppBin, getAppTitle } from "@shell-shock/core/plugin-utils";
+import "../helpers/index.mjs";
+import { createComponent } from "@alloy-js/core/jsx-runtime";
+import { getAppBin } from "@shell-shock/core/plugin-utils";
 import { code, computed } from "@alloy-js/core";
-import { FunctionDeclaration, IfStatement, InterfaceDeclaration, VarDeclaration } from "@alloy-js/typescript";
-import { ReflectionKind } from "@powerlines/deepkit/vendor/type";
+import { VarDeclaration } from "@alloy-js/typescript";
 import { Spacing } from "@powerlines/plugin-alloy/core";
 import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
-import { InterfaceMember, TypescriptFile } from "@powerlines/plugin-alloy/typescript";
-import { TSDoc, TSDocDefaultValue, TSDocRemarks } from "@powerlines/plugin-alloy/typescript/components/tsdoc";
+import { TypescriptFile } from "@powerlines/plugin-alloy/typescript";
 import { joinPaths } from "@stryke/path";
 import { snakeCase } from "@stryke/string-format/snake-case";
 
-//#region src/components/fish-command.tsx
+//#region src/components/fish-shared.tsx
 /**
-* The Fish Completions commands' handler wrapper for the Shell Shock project.
+* The Fish Completions generation for the Shell Shock project.
 */
-function FishCompletionsCommand() {
+function FishCompletionsShared() {
 	const context = usePowerlines();
 	const bin = computed(() => getAppBin(context));
 	const name = computed(() => snakeCase(bin.value));
 	return createComponent(TypescriptFile, {
 		get path() {
-			return joinPaths(context.entryPath, "completions", "fish", "command.ts");
+			return joinPaths(context.entryPath, "completions", "fish", "shared.ts");
 		},
-		imports: {
-			"node:os": "os",
-			"node:path": ["join"],
-			"node:fs/promises": ["readFile", "writeFile"]
-		},
-		builtinImports: { "shell-shock:console": [
-			"colors",
-			"writeLine",
-			"success",
-			"warn",
-			"stripAnsi"
-		] },
+		builtinImports: { console: ["colors"] },
 		get children() {
 			return [
-				createComponent(TSDoc, { heading: "Options for the Fish completions command." }),
-				createComponent(InterfaceDeclaration, {
-					"export": true,
-					name: "FishCompletionsOptions",
-					get children() {
-						return [
-							createComponent(TSDoc, {
-								heading: "The path to write the completion script to.",
-								get children() {
-									return [createComponent(TSDocRemarks, { children: `If no extension is provided, the \`.fish\` extension will be used.` }), createComponent(TSDocDefaultValue, {
-										get type() {
-											return ReflectionKind.string;
-										},
-										get defaultValue() {
-											return `${bin.value}-completions.fish`;
-										}
-									})];
-								}
-							}),
-							createComponent(InterfaceMember, {
-								name: "script",
-								optional: true,
-								type: "string | true"
-							}),
-							createComponent(Spacing, {}),
-							createComponent(TSDoc, {
-								heading: "The Fish configuration file to append the completion script to.",
-								get children() {
-									return [createComponent(TSDocRemarks, { children: `The generated completion script will be appended to the specified configuration file. Possible values for the Fish configuration file include: \\n- \`~/.config/fish/config.fish\`` }), createComponent(TSDocDefaultValue, {
-										get type() {
-											return ReflectionKind.string;
-										},
-										defaultValue: "~/.config/fish/config.fish"
-									})];
-								}
-							}),
-							createComponent(InterfaceMember, {
-								name: "config",
-								optional: true,
-								type: "string | true"
-							})
-						];
-					}
-				}),
 				createComponent(Spacing, {}),
-				createComponent(TSDoc, { heading: "Handler logic for the \\`completions fish\\` command." }),
-				createComponent(FunctionDeclaration, {
+				createComponent(VarDeclaration, {
+					"const": true,
 					"export": true,
-					"default": true,
-					async: true,
-					name: "handler",
-					parameters: [{
-						name: "options",
-						type: "FishCompletionsOptions"
-					}],
-					get children() {
-						return [
-							createComponent(VarDeclaration, {
-								"const": true,
-								name: "completions",
-								type: "string",
-								get initializer() {
-									return code` \`# fish completion for ${getAppTitle(context)} -*- shell-script -*-
-
-function __${name.value}_debug
+					name: "SHELL_COMPLETIONS",
+					get initializer() {
+						return code` \`function __${name.value}_debug
     set -l file "$BASH_COMP_DEBUG_FILE"
     if test -n "$file"
         echo "$argv" >> $file
@@ -194,8 +124,7 @@ function __${name.value}_requires_order_preservation
         return 1
     end
 
-    set -l directive (string sub --start 2 $__$
-    {name.value}_perform_completion_once_result[-1])
+    set -l directive (string sub --start 2 $__${name.value}_perform_completion_once_result[-1])
     __${name.value}_debug "Directive is: $directive"
 
     set -l shellCompDirectiveKeepOrder ${CompletionDirective.CompletionDirectiveKeepOrder}
@@ -334,68 +263,35 @@ complete -c ${getAppBin(context)} -n 'not __${name.value}_requires_order_preserv
 # Otherwise we use the -k flag
 complete -k -c ${bin.value} -n '__${name.value}_requires_order_preservation && __${name.value}_prepare_completions' -f -a '$__${name.value}_comp_results'
 \`; `;
-								}
-							}),
-							createComponent(Spacing, {}),
-							createComponent(IfStatement, {
-								condition: code`options.config`,
-								get children() {
-									return [
-										createComponent(VarDeclaration, {
-											"let": true,
-											name: "configFilePath",
-											type: "string",
-											initializer: code`options.config === true ? "~/.config/fish/config.fish" : options.config`
-										}),
-										createComponent(Spacing, {}),
-										createComponent(IfStatement, {
-											condition: code`configFilePath.startsWith("~")`,
-											children: code`configFilePath = join(os.homedir(), configFilePath.replace("~", "")); `
-										}),
-										createComponent(Spacing, {}),
-										createComponent(VarDeclaration, {
-											"let": true,
-											name: "configFileContent",
-											type: "string",
-											initializer: code`"";`
-										}),
-										createComponent(Spacing, {}),
-										memo(() => code`try {
-            configFileContent = await readFile(configFilePath, "utf8");
-          } catch (error) {
-            if (Error.isError(error) && error.code === "ENOENT") {
-              // If the file doesn't exist, we can create it later when writing the completion script.
-              warn(\`Configuration file \${colors.bold(configFilePath)} does not exist. It will be created when the completion script is written.\`);
-            } else {
-              return { error };
-            }
+					}
+				}),
+				createComponent(Spacing, {}),
+				createComponent(VarDeclaration, {
+					"export": true,
+					"const": true,
+					name: "SHELL_COMPLETIONS_DISPLAY",
+					initializer: code` SHELL_COMPLETIONS.split("\\n").map(line => {
+          if (!line.trim()) {
+            return "";
+          }
+          if (line.trim().startsWith("#")) {
+            return \`\${colors.dim(line)}\`;
           }
 
-          await writeFile(configFilePath, \`\${configFileContent}\\n\\n\${stripAnsi(completions)}\`);
-
-          success(\`${getAppTitle(context)} Fish completion script has been generated and appended to \${colors.bold(configFilePath)}. Please restart your terminal or run \`source \${configFilePath}\` to apply the changes.\`); `)
-									];
-								}
-							}),
-							createComponent(Spacing, {}),
-							createComponent(IfStatement, {
-								condition: code`options.script`,
-								get children() {
-									return code`const outputPath = options.script === true ? "${bin.value}-completions.fish" : options.script;
-          await writeFile(outputPath, stripAnsi(completions));
-
-          success(\`${getAppTitle(context)} Fish completion script has been generated at \${colors.bold(outputPath)}.\`);`;
-								}
-							}),
-							createComponent(Spacing, {}),
-							createComponent(IfStatement, {
-								condition: code`!options.config && !options.script`,
-								children: code`writeLine(" ------------------------------------------------- ");
-          writeLine(completions);
-          writeLine(" ------------------------------------------------- ");`
-							})
-						];
-					}
+          return colors.white(line).replaceAll(/(?<=\\\$(\\{|\\()).*(?=(\\}\\)))/g, colors.green("$&"))
+            .replaceAll(/(\\"|\\').*(\\"|\\')/g, colors.cyan("$&"))
+            .replaceAll(/(\\[|\\]|\\(|\\)|\\||<|>|\\$\\(|\\$?\\{|\\}|\\+|=|;|:)/g, colors.bold(colors.gray("$&")))
+            .replaceAll(/(function|complete)\\s+/g, colors.green("$&"))
+            .replaceAll(/(?<=(function|complete)\\s+)\\w/g, colors.bold(colors.greenBright("$&")))
+            .replaceAll(/set\\s+/g, colors.red("$&"))
+            .replaceAll(/(?<=set\\s+)\\w/g, colors.bold(colors.redBright("$&")))
+            .replaceAll(/while\\s+/g, colors.cyan("$&"))
+            .replaceAll(/(?<=while\\s+)\\w/g, colors.bold(colors.cyanBright("$&")))
+            .replaceAll(/(if|fi|else|elif|then|done)\\s+/g, colors.green("$&"))
+            .replaceAll(/\\s__\\w/g, colors.bold(colors.magentaBright("$&")))
+            .replaceAll(/(?<=\\s)(-\\w|--\\w[\\w-]*)(?=\\s|$)/g, colors.bold(colors.magenta("$&")));
+
+        }).join("\\n"); `
 				})
 			];
 		}
@@ -403,5 +299,5 @@ complete -k -c ${bin.value} -n '__${name.value}_requires_order_preservation && _
 }
 
 //#endregion
-export { FishCompletionsCommand };
-//# sourceMappingURL=fish-command.mjs.map
+export { FishCompletionsShared };
+//# sourceMappingURL=fish-shared.mjs.map

package/dist/components/fish-shared.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fish-shared.mjs","names":[],"sources":["../../src/components/fish-shared.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code, computed } from \"@alloy-js/core\";\nimport { VarDeclaration } from \"@alloy-js/typescript\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport { TypescriptFile } from \"@powerlines/plugin-alloy/typescript\";\nimport { getAppBin } from \"@shell-shock/core/plugin-utils\";\nimport { joinPaths } from \"@stryke/path\";\nimport { snakeCase } from \"@stryke/string-format/snake-case\";\nimport { CompletionDirective } from \"../helpers\";\nimport { EXEC_COMMAND } from \"../helpers/complete-command\";\nimport type { CompletionsPluginContext } from \"../types/plugin\";\n\n/**\n * The Fish Completions generation for the Shell Shock project.\n */\nexport function FishCompletionsShared() {\n  const context = usePowerlines<CompletionsPluginContext>();\n\n  const bin = computed(() => getAppBin(context));\n  const name = computed(() => snakeCase(bin.value));\n\n  return (\n    <TypescriptFile\n      path={joinPaths(context.entryPath, \"completions\", \"fish\", \"shared.ts\")}\n      builtinImports={{\n        console: [\"colors\"]\n      }}>\n      <Spacing />\n      <VarDeclaration\n        const\n        export\n        name=\"SHELL_COMPLETIONS\"\n        initializer={code` \\`function __${name.value}_debug\n    set -l file \"$BASH_COMP_DEBUG_FILE\"\n    if test -n \"$file\"\n        echo \"$argv\" >> $file\n    end\nend\n\nfunction __${name.value}_perform_completion\n    __${name.value}_debug \"Starting __${name.value}_perform_completion\"\n\n    # Extract all args except the last one\n    set -l args (commandline -opc)\n    # Extract the last arg and escape it in case it is a space or wildcard\n    set -l lastArg (string escape -- (commandline -ct))\n\n    __${name.value}_debug \"args: $args\"\n    __${name.value}_debug \"last arg: $lastArg\"\n\n    # Build the completion request command\n    set -l requestComp \"${EXEC_COMMAND} complete -- (string join ' ' -- (string escape -- $args[2..-1])) $lastArg\"\n\n    __${name.value}_debug \"Calling $requestComp\"\n    set -l results (eval $requestComp 2> /dev/null)\n\n    # Some programs may output extra empty lines after the directive.\n    # Let's ignore them or else it will break completion.\n    # Ref: https://github.com/spf13/cobra/issues/1279\n    for line in $results[-1..1]\n        if test (string trim -- $line) = \"\"\n            # Found an empty line, remove it\n            set results $results[1..-2]\n        else\n            # Found non-empty line, we have our proper output\n            break\n        end\n    end\n\n    set -l comps $results[1..-2]\n    set -l directiveLine $results[-1]\n\n    # For Fish, when completing a flag with an = (e.g., <program> -n=<TAB>)\n    # completions must be prefixed with the flag\n    set -l flagPrefix (string match -r -- '-.*=' \"$lastArg\")\n\n    __${name.value}_debug \"Comps: $comps\"\n    __${name.value}_debug \"DirectiveLine: $directiveLine\"\n    __${name.value}_debug \"flagPrefix: $flagPrefix\"\n\n    for comp in $comps\n        printf \"%s%s\\\\n\" \"$flagPrefix\" \"$comp\"\n    end\n\n    printf \"%s\\\\n\" \"$directiveLine\"\nend\n\n# This function limits calls to __${\n          name.value\n        }_perform_completion, by caching the result\nfunction __${name.value}_perform_completion_once\n    __${name.value}_debug \"Starting __${name.value}_perform_completion_once\"\n\n    if test -n \"$__${name.value}_perform_completion_once_result\"\n        __${name.value}_debug \"Seems like a valid result already exists, skipping __${name.value}_perform_completion\"\n        return 0\n    end\n\n    set --global __${name.value}_perform_completion_once_result (__${\n      name.value\n    }_perform_completion)\n    if test -z \"$__${name.value}_perform_completion_once_result\"\n        __${name.value}_debug \"No completions, probably due to a failure\"\n        return 1\n    end\n\n    __${name.value}_debug \"Performed completions and set __${\n      name.value\n    }_perform_completion_once_result\"\n    return 0\nend\n\n# This function is used to clear the cached result after completions are run\nfunction __${name.value}_clear_perform_completion_once_result\n    __${name.value}_debug \"\"\n    __${name.value}_debug \"========= clearing previously set __${\n      name.value\n    }_perform_completion_once_result variable ==========\"\n    set --erase __${name.value}_perform_completion_once_result\n    __${name.value}_debug \"Successfully erased the variable __${\n      name.value\n    }_perform_completion_once_result\"\nend\n\nfunction __${name.value}_requires_order_preservation\n    __${name.value}_debug \"\"\n    __${name.value}_debug \"========= checking if order preservation is required ==========\"\n\n    __${name.value}_perform_completion_once\n    if test -z \"$__${name.value}_perform_completion_once_result\"\n        __${name.value}_debug \"Error determining if order preservation is required\"\n        return 1\n    end\n\n    set -l directive (string sub --start 2 $__${\n      name.value\n    }_perform_completion_once_result[-1])\n    __${name.value}_debug \"Directive is: $directive\"\n\n    set -l shellCompDirectiveKeepOrder ${\n      CompletionDirective.CompletionDirectiveKeepOrder\n    }\n    set -l keeporder (math (math --scale 0 $directive / $shellCompDirectiveKeepOrder) % 2)\n    __${name.value}_debug \"Keeporder is: $keeporder\"\n\n    if test $keeporder -ne 0\n        __${name.value}_debug \"This does require order preservation\"\n        return 0\n    end\n\n    __${name.value}_debug \"This doesn't require order preservation\"\n    return 1\nend\n\n# This function does two things:\n# - Obtain the completions and store them in the global __${\n          name.value\n        }_comp_results\n# - Return false if file completion should be performed\nfunction __${name.value}_prepare_completions\n    __${name.value}_debug \"\"\n    __${name.value}_debug \"========= starting completion logic ==========\"\n\n    # Start fresh\n    set --erase __${name.value}_comp_results\n\n    __${name.value}_perform_completion_once\n    __${name.value}_debug \"Completion results: $__${\n      name.value\n    }_perform_completion_once_result\"\n\n    if test -z \"$__${name.value}_perform_completion_once_result\"\n        __${name.value}_debug \"No completion, probably due to a failure\"\n        # Might as well do file completion, in case it helps\n        return 1\n    end\n\n    set -l directive (string sub --start 2 $__${\n      name.value\n    }_perform_completion_once_result[-1])\n    set --global __${name.value}_comp_results $__${\n      name.value\n    }_perform_completion_once_result[1..-2]\n\n    __${name.value}_debug \"Completions are: $__${name.value}_comp_results\"\n    __${name.value}_debug \"Directive is: $directive\"\n\n    set -l shellCompDirectiveError ${\n      CompletionDirective.CompletionDirectiveError\n    }\n    set -l shellCompDirectiveNoSpace ${\n      CompletionDirective.CompletionDirectiveNoSpace\n    }\n    set -l shellCompDirectiveNoFileComp ${\n      CompletionDirective.CompletionDirectiveNoFileComp\n    }\n    set -l shellCompDirectiveFilterFileExt ${\n      CompletionDirective.CompletionDirectiveFilterFileExt\n    }\n    set -l shellCompDirectiveFilterDirs ${\n      CompletionDirective.CompletionDirectiveFilterDirs\n    }\n    if test -z \"$directive\"\n        set directive 0\n    end\n\n    set -l compErr (math (math --scale 0 $directive / $shellCompDirectiveError) % 2)\n    if test $compErr -eq 1\n        __${name.value}_debug \"Received error directive: aborting.\"\n        # Might as well do file completion, in case it helps\n        return 1\n    end\n\n    set -l filefilter (math (math --scale 0 $directive / $shellCompDirectiveFilterFileExt) % 2)\n    set -l dirfilter (math (math --scale 0 $directive / $shellCompDirectiveFilterDirs) % 2)\n    if test $filefilter -eq 1; or test $dirfilter -eq 1\n        __${name.value}_debug \"File extension filtering or directory filtering not supported\"\n        # Do full file completion instead\n        return 1\n    end\n\n    set -l nospace (math (math --scale 0 $directive / $shellCompDirectiveNoSpace) % 2)\n    set -l nofiles (math (math --scale 0 $directive / $shellCompDirectiveNoFileComp) % 2)\n\n    __${name.value}_debug \"nospace: $nospace, nofiles: $nofiles\"\n\n    # If we want to prevent a space, or if file completion is NOT disabled,\n    # we need to count the number of valid completions.\n    # To do so, we will filter on prefix as the completions we have received\n    # may not already be filtered so as to allow fish to match on different\n    # criteria than the prefix.\n    if test $nospace -ne 0; or test $nofiles -eq 0\n        set -l prefix (commandline -t | string escape --style=regex)\n        __${name.value}_debug \"prefix: $prefix\"\n\n        set -l completions (string match -r -- \"^$prefix.*\" $__${\n          name.value\n        }_comp_results)\n        set --global __${name.value}_comp_results $completions\n        __${name.value}_debug \"Filtered completions are: $__${\n          name.value\n        }_comp_results\"\n\n        # Important not to quote the variable for count to work\n        set -l numComps (count $__${name.value}_comp_results)\n        __${name.value}_debug \"numComps: $numComps\"\n\n        if test $numComps -eq 1; and test $nospace -ne 0\n            # We must first split on \\\\t to get rid of the descriptions to be\n            # able to check what the actual completion will be.\n            # We don't need descriptions anyway since there is only a single\n            # real completion which the shell will expand immediately.\n            set -l split (string split --max 1 \"\\\\t\" $__${\n              name.value\n            }_comp_results[1])\n\n            # Fish won't add a space if the completion ends with any\n            # of the following characters: @=/:.,\n            set -l lastChar (string sub -s -1 -- $split)\n            if not string match -r -q \"[@=/:.,]\" -- \"$lastChar\"\n                # In other cases, to support the \"nospace\" directive we trick the shell\n                # by outputting an extra, longer completion.\n                __${name.value}_debug \"Adding second completion to perform nospace directive\"\n                set --global __${name.value}_comp_results $split[1] $split[1].\n                __${name.value}_debug \"Completions are now: $__${\n                  name.value\n                }_comp_results\"\n            end\n        end\n\n        if test $numComps -eq 0; and test $nofiles -eq 0\n            # To be consistent with bash and zsh, we only trigger file\n            # completion when there are no other completions\n            __${name.value}_debug \"Requesting file completion\"\n            return 1\n        end\n    end\n\n    return 0\nend\n\n# Since Fish completions are only loaded once the user triggers them, we trigger them ourselves\n# so we can properly delete any completions provided by another script.\n# Only do this if the program can be found, or else fish may print some errors; besides,\n# the existing completions will only be loaded if the program can be found.\nif type -q \"${bin.value}\"\n    # The space after the program name is essential to trigger completion for the program\n    # and not completion of the program name itself.\n    # Also, we use '> /dev/null 2>&1' since '&>' is not supported in older versions of fish.\n    complete --do-complete \"${bin.value} \" > /dev/null 2>&1\nend\n\n# Remove any pre-existing completions for the program since we will be handling all of them.\ncomplete -c ${bin.value} -e\n# This will get called after the two calls below and clear the cached result\ncomplete -c ${bin.value} -n '__${name.value}_clear_perform_completion_once_result'\n# The call to __${name.value}_prepare_completions will setup __${\n          name.value\n        }_comp_results\n# which provides the program's completion choices.\n# If this doesn't require order preservation, we don't use the -k flag\ncomplete -c ${getAppBin(\n          context\n        )} -n 'not __${name.value}_requires_order_preservation && __${\n          name.value\n        }_prepare_completions' -f -a '$__${name.value}_comp_results'\n# Otherwise we use the -k flag\ncomplete -k -c ${bin.value} -n '__${name.value}_requires_order_preservation && __${\n          name.value\n        }_prepare_completions' -f -a '$__${name.value}_comp_results'\n\\`; `}\n      />\n      <Spacing />\n      <VarDeclaration\n        export\n        const\n        name=\"SHELL_COMPLETIONS_DISPLAY\"\n        initializer={code` SHELL_COMPLETIONS.split(\"\\\\n\").map(line => {\n          if (!line.trim()) {\n            return \"\";\n          }\n          if (line.trim().startsWith(\"#\")) {\n            return \\`\\${colors.dim(line)}\\`;\n          }\n\n          return colors.white(line).replaceAll(/(?<=\\\\\\$(\\\\{|\\\\()).*(?=(\\\\}\\\\)))/g, colors.green(\"$&\"))\n            .replaceAll(/(\\\\\"|\\\\').*(\\\\\"|\\\\')/g, colors.cyan(\"$&\"))\n            .replaceAll(/(\\\\[|\\\\]|\\\\(|\\\\)|\\\\||<|>|\\\\$\\\\(|\\\\$?\\\\{|\\\\}|\\\\+|=|;|:)/g, colors.bold(colors.gray(\"$&\")))\n            .replaceAll(/(function|complete)\\\\s+/g, colors.green(\"$&\"))\n            .replaceAll(/(?<=(function|complete)\\\\s+)\\\\w/g, colors.bold(colors.greenBright(\"$&\")))\n            .replaceAll(/set\\\\s+/g, colors.red(\"$&\"))\n            .replaceAll(/(?<=set\\\\s+)\\\\w/g, colors.bold(colors.redBright(\"$&\")))\n            .replaceAll(/while\\\\s+/g, colors.cyan(\"$&\"))\n            .replaceAll(/(?<=while\\\\s+)\\\\w/g, colors.bold(colors.cyanBright(\"$&\")))\n            .replaceAll(/(if|fi|else|elif|then|done)\\\\s+/g, colors.green(\"$&\"))\n            .replaceAll(/\\\\s__\\\\w/g, colors.bold(colors.magentaBright(\"$&\")))\n            .replaceAll(/(?<=\\\\s)(-\\\\w|--\\\\w[\\\\w-]*)(?=\\\\s|$)/g, colors.bold(colors.magenta(\"$&\")));\n\n        }).join(\"\\\\n\"); `}\n      />\n    </TypescriptFile>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAkCA,SAAgB,wBAAgB;;CAE9B,MAAM,MAAM,eAAe,UAAU,QAAQ,CAAC;CAC9C,MAAM,OAAO,eAAe,UAAU,IAAI,MAAM,CAAC;;EAEjD,IAAM,OAAC;AACJ,UAAA,UAAA,QAAA,WAAA,eAAA,QAAA,YAAA;;EAED,gBAAgB,EACd,SAAS,CAAC,SAAS,EACpB;EACD,IAAG,WAAS;AACV,UAAC;IAAA,gBAAA,SAAA,EAAA,CAAA;IAAA,gBAAA,gBAAA;KACC,SAAA;KACA,UAAA;KACA,MAAM;KACN,IAAA,cAAkB;AAChB,aAAO,IAAC,iBAAoB,KAAA,MAAA;;;;;;;aAOzB,KAAK,MAAC;;;;;;;;QAQX,KAAK,MAAM;;;;;;QAMX,KAAG,MAAQ;;;;;;;;;;;;;;;;;;;;;;;QAuBX,KAAK,MAAM;QACX,KAAK,MAAM;;;;;;;;;;oCAUJ,KAAA,MAAA;aACN,KAAA,MAAA;QACD,KAAK,MAAK,qBAAM,KAAA,MAAA;;;YAGZ,KAAK,MAAI,+DAA0C,KAAA,MAAA;;;;;qBAK1C,KAAK,MAAM;YACrB,KAAA,MAAA;;;;QAIH,KAAA,MAAO,0CAAA,KAAA,MAAA;;;;;aAKV,KAAA,MAAA;QACD,KAAO,MAAA;;;QAGJ,KAAA,MAAY,6CAAsC,KAAY,MAAI;;;aAG5D,KAAK,MAAC;QACb,KAAK,MAAA;QACN,KAAA,MAAA;;QAEG,KAAK,MAAM;qBACR,KAAA,MAAA;YACN,KAAA,MAAA;;;;gDAIsB,KAAA,MAAA;QACnB,KAAK,MAAM;;yCAEA,oBAAA,6BAAA;;QAEX,KAAI,MAAK;;;;;;;QAOT,KAAK,MAAM;;;;;4DAKsC,KAAA,MAAA;;;QAGlD,KAAM,MAAA;QACL,KAAI,MAAK;;;;;QAKb,KAAO,MAAA;;;qBAGU,KAAI,MAAM;YACpB,KAAI,MAAA;;;;;gDAKY,KAAA,MAAA;qBACR,KAAO,MAAM,mBAAc,KAAU,MAAM;;QAExD,KAAM,MAAA,8BAAA,KAAA,MAAA;QACJ,KAAE,MAAS;;qCAEA,oBAAA,yBAAA;uCACmB,oBAAa,2BAAA;0CACxC,oBAAA,8BAAA;6CACyB,oBAAA,iCAAA;;;;;;;;YAQzB,KAAA,MAAW;;;;;;;;YAQV,KAAC,MAAM;;;;;;;;QAQX,KAAG,MAAA;;;;;;;;;YASC,KAAK,MAAA;;iEAEb,KAAA,MAAA;;YAEO,KAAA,MAAS,uCAAmC,KAAA,MAAA;;;oCAGvB,KAAA,MAAe;YACvC,KAAO,MAAA;;;;;;;0DAOmB,KAAA,MAAA;;;;;;;;;iCASJ,KAAO,MAAM;oBAC1B,KAAM,MAAI,kCAA2B,KAAA,MAAA;;;;;;;;;;;;;;;;;;;;;;;8BAuB1B,IAAA,MAAY;;;;cAI3B,IAAA,MAAA;;cAEC,IAAI,MAAM,SAAO,KAAM,MAAO;kBAC3B,KAAI,MAAA,oCAA2B,KAAA,MAAA;;;cAGlC,UAAO,QAAW,CAAC,aAAY,KAAK,MAAO,oCAAyB,KAAA,MAAA,kCAAA,KAAA,MAAA;;iBAElE,IAAI,MAAK,SAAM,KAAQ,MAAO,oCAAqC,KAAA,MAAS,kCAAA,KAAA,MAAA;;;KAGrF,CAAC;IAAE,gBAAa,SAAA,EAAA,CAAA;IAAA,gBAAA,gBAAA;KACf,UAAS;KACT,SAAI;KACJ,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;EAyBR,CAAA"}

package/dist/components/index.cjs

@@ -1,10 +1,26 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_components_bash_command = require('./bash-command.cjs');
-const require_components_fish_command = require('./fish-command.cjs');
-const require_components_powershell_command = require('./powershell-command.cjs');
-const require_components_zsh_command = require('./zsh-command.cjs');
+const require_components_bash_config_command = require('./bash-config-command.cjs');
+const require_components_bash_script_command = require('./bash-script-command.cjs');
+const require_components_bash_shared = require('./bash-shared.cjs');
+const require_components_fish_config_command = require('./fish-config-command.cjs');
+const require_components_fish_script_command = require('./fish-script-command.cjs');
+const require_components_fish_shared = require('./fish-shared.cjs');
+const require_components_powershell_config_command = require('./powershell-config-command.cjs');
+const require_components_powershell_script_command = require('./powershell-script-command.cjs');
+const require_components_powershell_shared = require('./powershell-shared.cjs');
+const require_components_zsh_config_command = require('./zsh-config-command.cjs');
+const require_components_zsh_script_command = require('./zsh-script-command.cjs');
+const require_components_zsh_shared = require('./zsh-shared.cjs');
 
-exports.BashCompletionsCommand = require_components_bash_command.BashCompletionsCommand;
-exports.FishCompletionsCommand = require_components_fish_command.FishCompletionsCommand;
-exports.PowerShellCompletionsCommand = require_components_powershell_command.PowerShellCompletionsCommand;
-exports.ZshCompletionsCommand = require_components_zsh_command.ZshCompletionsCommand;
+exports.BashCompletionsShared = require_components_bash_shared.BashCompletionsShared;
+exports.BashConfigCompletionsCommand = require_components_bash_config_command.BashConfigCompletionsCommand;
+exports.BashScriptCompletionsCommand = require_components_bash_script_command.BashScriptCompletionsCommand;
+exports.FishCompletionsShared = require_components_fish_shared.FishCompletionsShared;
+exports.FishConfigCompletionsCommand = require_components_fish_config_command.FishConfigCompletionsCommand;
+exports.FishScriptCompletionsCommand = require_components_fish_script_command.FishScriptCompletionsCommand;
+exports.PowerShellCompletionsShared = require_components_powershell_shared.PowerShellCompletionsShared;
+exports.PowerShellConfigCompletionsCommand = require_components_powershell_config_command.PowerShellConfigCompletionsCommand;
+exports.PowerShellScriptCompletionsCommand = require_components_powershell_script_command.PowerShellScriptCompletionsCommand;
+exports.ZshCompletionsShared = require_components_zsh_shared.ZshCompletionsShared;
+exports.ZshConfigCompletionsCommand = require_components_zsh_config_command.ZshConfigCompletionsCommand;
+exports.ZshScriptCompletionsCommand = require_components_zsh_script_command.ZshScriptCompletionsCommand;

package/dist/components/index.d.cts

@@ -1,5 +1,13 @@
-import { BashCompletionsCommand } from "./bash-command.cjs";
-import { FishCompletionsCommand } from "./fish-command.cjs";
-import { PowerShellCompletionsCommand } from "./powershell-command.cjs";
-import { ZshCompletionsCommand } from "./zsh-command.cjs";
-export { BashCompletionsCommand, FishCompletionsCommand, PowerShellCompletionsCommand, ZshCompletionsCommand };
+import { BashConfigCompletionsCommand } from "./bash-config-command.cjs";
+import { BashScriptCompletionsCommand } from "./bash-script-command.cjs";
+import { BashCompletionsShared } from "./bash-shared.cjs";
+import { FishConfigCompletionsCommand } from "./fish-config-command.cjs";
+import { FishScriptCompletionsCommand } from "./fish-script-command.cjs";
+import { FishCompletionsShared } from "./fish-shared.cjs";
+import { PowerShellConfigCompletionsCommand } from "./powershell-config-command.cjs";
+import { PowerShellScriptCompletionsCommand } from "./powershell-script-command.cjs";
+import { PowerShellCompletionsShared } from "./powershell-shared.cjs";
+import { ZshConfigCompletionsCommand } from "./zsh-config-command.cjs";
+import { ZshScriptCompletionsCommand } from "./zsh-script-command.cjs";
+import { ZshCompletionsShared } from "./zsh-shared.cjs";
+export { BashCompletionsShared, BashConfigCompletionsCommand, BashScriptCompletionsCommand, FishCompletionsShared, FishConfigCompletionsCommand, FishScriptCompletionsCommand, PowerShellCompletionsShared, PowerShellConfigCompletionsCommand, PowerShellScriptCompletionsCommand, ZshCompletionsShared, ZshConfigCompletionsCommand, ZshScriptCompletionsCommand };

package/dist/components/index.d.mts

@@ -1,5 +1,13 @@
-import { BashCompletionsCommand } from "./bash-command.mjs";
-import { FishCompletionsCommand } from "./fish-command.mjs";
-import { PowerShellCompletionsCommand } from "./powershell-command.mjs";
-import { ZshCompletionsCommand } from "./zsh-command.mjs";
-export { BashCompletionsCommand, FishCompletionsCommand, PowerShellCompletionsCommand, ZshCompletionsCommand };
+import { BashConfigCompletionsCommand } from "./bash-config-command.mjs";
+import { BashScriptCompletionsCommand } from "./bash-script-command.mjs";
+import { BashCompletionsShared } from "./bash-shared.mjs";
+import { FishConfigCompletionsCommand } from "./fish-config-command.mjs";
+import { FishScriptCompletionsCommand } from "./fish-script-command.mjs";
+import { FishCompletionsShared } from "./fish-shared.mjs";
+import { PowerShellConfigCompletionsCommand } from "./powershell-config-command.mjs";
+import { PowerShellScriptCompletionsCommand } from "./powershell-script-command.mjs";
+import { PowerShellCompletionsShared } from "./powershell-shared.mjs";
+import { ZshConfigCompletionsCommand } from "./zsh-config-command.mjs";
+import { ZshScriptCompletionsCommand } from "./zsh-script-command.mjs";
+import { ZshCompletionsShared } from "./zsh-shared.mjs";
+export { BashCompletionsShared, BashConfigCompletionsCommand, BashScriptCompletionsCommand, FishCompletionsShared, FishConfigCompletionsCommand, FishScriptCompletionsCommand, PowerShellCompletionsShared, PowerShellConfigCompletionsCommand, PowerShellScriptCompletionsCommand, ZshCompletionsShared, ZshConfigCompletionsCommand, ZshScriptCompletionsCommand };

package/dist/components/index.mjs

@@ -1,6 +1,14 @@
-import { BashCompletionsCommand } from "./bash-command.mjs";
-import { FishCompletionsCommand } from "./fish-command.mjs";
-import { PowerShellCompletionsCommand } from "./powershell-command.mjs";
-import { ZshCompletionsCommand } from "./zsh-command.mjs";
+import { BashConfigCompletionsCommand } from "./bash-config-command.mjs";
+import { BashScriptCompletionsCommand } from "./bash-script-command.mjs";
+import { BashCompletionsShared } from "./bash-shared.mjs";
+import { FishConfigCompletionsCommand } from "./fish-config-command.mjs";
+import { FishScriptCompletionsCommand } from "./fish-script-command.mjs";
+import { FishCompletionsShared } from "./fish-shared.mjs";
+import { PowerShellConfigCompletionsCommand } from "./powershell-config-command.mjs";
+import { PowerShellScriptCompletionsCommand } from "./powershell-script-command.mjs";
+import { PowerShellCompletionsShared } from "./powershell-shared.mjs";
+import { ZshConfigCompletionsCommand } from "./zsh-config-command.mjs";
+import { ZshScriptCompletionsCommand } from "./zsh-script-command.mjs";
+import { ZshCompletionsShared } from "./zsh-shared.mjs";
 
-export { BashCompletionsCommand, FishCompletionsCommand, PowerShellCompletionsCommand, ZshCompletionsCommand };
+export { BashCompletionsShared, BashConfigCompletionsCommand, BashScriptCompletionsCommand, FishCompletionsShared, FishConfigCompletionsCommand, FishScriptCompletionsCommand, PowerShellCompletionsShared, PowerShellConfigCompletionsCommand, PowerShellScriptCompletionsCommand, ZshCompletionsShared, ZshConfigCompletionsCommand, ZshScriptCompletionsCommand };

package/dist/components/powershell-config-command.cjs

@@ -0,0 +1,128 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let _shell_shock_core_plugin_utils = require("@shell-shock/core/plugin-utils");
+let _alloy_js_core = require("@alloy-js/core");
+let _alloy_js_typescript = require("@alloy-js/typescript");
+let _powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
+let _powerlines_plugin_alloy_core = require("@powerlines/plugin-alloy/core");
+let _powerlines_plugin_alloy_core_contexts_context = require("@powerlines/plugin-alloy/core/contexts/context");
+let _powerlines_plugin_alloy_typescript = require("@powerlines/plugin-alloy/typescript");
+let _stryke_path = require("@stryke/path");
+
+//#region src/components/powershell-config-command.tsx
+function PowerShellConfigCompletionsCommand() {
+	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript.TypescriptFile, {
+		get path() {
+			return (0, _stryke_path.joinPaths)(context.entryPath, "completions", "powershell", "config", "command.ts");
+		},
+		imports: {
+			"node:os": "os",
+			"node:path": ["join"],
+			"node:fs/promises": ["readFile", "writeFile"],
+			"../shared": ["SHELL_COMPLETIONS", "SHELL_COMPLETIONS_DISPLAY"]
+		},
+		builtinImports: { "shell-shock:console": [
+			"colors",
+			"writeLine",
+			"success",
+			"warn"
+		] },
+		get children() {
+			return [
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript.TSDoc, { heading: "Options for the PowerShell Completions - Configuration command." }),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceDeclaration, {
+					"export": true,
+					name: "PowerShellConfigCompletionsOptions",
+					get children() {
+						return [(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript.TSDoc, {
+							heading: "Should the generated completion script be written to console output instead of an actual file on disk? This is useful for debugging purposes or if you want to manually handle the output.",
+							get children() {
+								return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript.TSDocDefaultValue, {
+									get type() {
+										return _powerlines_deepkit_vendor_type.ReflectionKind.boolean;
+									},
+									defaultValue: false
+								});
+							}
+						}), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.InterfaceMember, {
+							name: "display",
+							optional: true,
+							type: "boolean"
+						})];
+					}
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript.TSDoc, { heading: "Handler logic for the \\`completions powershell config\\` command." }),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+					"export": true,
+					"default": true,
+					async: true,
+					name: "handler",
+					parameters: [{
+						name: "options",
+						type: "PowerShellConfigCompletionsOptions",
+						default: "{}"
+					}, {
+						name: "path",
+						type: "string",
+						default: `"~/.config/powershell/Microsoft.PowerShell_profile.ps1"`
+					}],
+					get children() {
+						return [(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
+							condition: _alloy_js_core.code`options.display !== true`,
+							get children() {
+								return [
+									(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
+										"let": true,
+										name: "configPath",
+										type: "string",
+										initializer: _alloy_js_core.code` path.includes(".") ? path : join(path, "Microsoft.PowerShell_profile.ps1");`
+									}),
+									(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core.Spacing, {}),
+									(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.IfStatement, {
+										condition: _alloy_js_core.code`configPath.startsWith("~")`,
+										children: _alloy_js_core.code`configPath = join(os.homedir(), configPath.replace("~", "")); `
+									}),
+									(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core.Spacing, {}),
+									(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
+										"let": true,
+										name: "content",
+										type: "string",
+										initializer: _alloy_js_core.code`"";`
+									}),
+									(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core.Spacing, {}),
+									(0, _alloy_js_core_jsx_runtime.memo)(() => _alloy_js_core.code`try {
+            content = await readFile(configPath, "utf8");
+          } catch (error) {
+            if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
+              // If the file doesn't exist, we can create it later when writing the completion script.
+              warn(\`Configuration file \${colors.bold(configPath)} does not exist. It will be created when the completion script is written.\`);
+            } else {
+              return { error };
+            }
+          }
+
+          await writeFile(configPath, \`\${content}\\n\\n### Begin - ${(0, _shell_shock_core_plugin_utils.getAppTitle)(context)} PowerShell Completions ###\\n\\n\${SHELL_COMPLETIONS} \\n\\n### End - ${(0, _shell_shock_core_plugin_utils.getAppTitle)(context)} PowerShell Completions ###\`);
+
+          success(\`${(0, _shell_shock_core_plugin_utils.getAppTitle)(context)} shell completions have been applied to PowerShell configuration file at \${colors.bold(configPath)}. Please restart your terminal or run \\\`source \${configPath}\\\` for the changes to take effect.\`); `)
+								];
+							}
+						}), (0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.ElseClause, { get children() {
+							return _alloy_js_core.code`writeLine(" ------------------------------------------------- ");
+            writeLine(\`### Begin - ${(0, _shell_shock_core_plugin_utils.getAppTitle)(context)} PowerShell Completions ###\`);
+            writeLine("");
+            SHELL_COMPLETIONS_DISPLAY.split("\\n").map(line => writeLine(line));
+            writeLine("");
+            writeLine(\`### End - ${(0, _shell_shock_core_plugin_utils.getAppTitle)(context)} PowerShell Completions ###\`);
+            writeLine(" ------------------------------------------------- ");`;
+						} })];
+					}
+				})
+			];
+		}
+	});
+}
+
+//#endregion
+exports.PowerShellConfigCompletionsCommand = PowerShellConfigCompletionsCommand;

package/dist/components/powershell-config-command.d.cts

@@ -0,0 +1,7 @@
+import * as _$_alloy_js_core0 from "@alloy-js/core";
+
+//#region src/components/powershell-config-command.d.ts
+declare function PowerShellConfigCompletionsCommand(): _$_alloy_js_core0.Children;
+//#endregion
+export { PowerShellConfigCompletionsCommand };
+//# sourceMappingURL=powershell-config-command.d.cts.map

package/dist/components/powershell-config-command.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"powershell-config-command.d.cts","names":[],"sources":["../../src/components/powershell-config-command.tsx"],"mappings":";;;iBAuCgB,kCAAA,CAAA,GAAkC,iBAAA,CAAA,QAAA"}

package/dist/components/powershell-config-command.d.mts

@@ -0,0 +1,7 @@
+import * as _$_alloy_js_core0 from "@alloy-js/core";
+
+//#region src/components/powershell-config-command.d.ts
+declare function PowerShellConfigCompletionsCommand(): _$_alloy_js_core0.Children;
+//#endregion
+export { PowerShellConfigCompletionsCommand };
+//# sourceMappingURL=powershell-config-command.d.mts.map

package/dist/components/powershell-config-command.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"powershell-config-command.d.mts","names":[],"sources":["../../src/components/powershell-config-command.tsx"],"mappings":";;;iBAuCgB,kCAAA,CAAA,GAAkC,iBAAA,CAAA,QAAA"}