@shell-shock/plugin-completions 0.2.23 → 0.3.0

package/dist/components/zsh-shared.cjs

@@ -0,0 +1,281 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_helpers_complete_command = require('../helpers/complete-command.cjs');
+const require_helpers_completion_directive_constants = require('../helpers/completion-directive-constants.cjs');
+require('../helpers/index.cjs');
+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_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");
+let _stryke_string_format_snake_case = require("@stryke/string-format/snake-case");
+
+//#region src/components/zsh-shared.tsx
+/**
+* The Zsh Completions generation for the Shell Shock project.
+*/
+function ZshCompletionsShared() {
+	const context = (0, _powerlines_plugin_alloy_core_contexts_context.usePowerlines)();
+	const bin = (0, _alloy_js_core.computed)(() => (0, _shell_shock_core_plugin_utils.getAppBin)(context));
+	const name = (0, _alloy_js_core.computed)(() => (0, _stryke_string_format_snake_case.snakeCase)(bin.value));
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript.TypescriptFile, {
+		get path() {
+			return (0, _stryke_path.joinPaths)(context.entryPath, "completions", "zsh", "shared.ts");
+		},
+		builtinImports: { console: ["colors"] },
+		get children() {
+			return [
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
+					"const": true,
+					"export": true,
+					name: "SHELL_COMPLETIONS",
+					get initializer() {
+						return _alloy_js_core.code` \`__${name.value}_debug() {
+    local file="$BASH_COMP_DEBUG_FILE"
+    if [[ -n \\\${file} ]]; then
+        echo "$*" >> "\\\${file}"
+    fi
+}
+
+_${name.value}() {
+    local shellCompDirectiveError=${require_helpers_completion_directive_constants.CompletionDirective.CompletionDirectiveError}
+    local shellCompDirectiveNoSpace=${require_helpers_completion_directive_constants.CompletionDirective.CompletionDirectiveNoSpace}
+    local shellCompDirectiveNoFileComp=${require_helpers_completion_directive_constants.CompletionDirective.CompletionDirectiveNoFileComp}
+    local shellCompDirectiveFilterFileExt=${require_helpers_completion_directive_constants.CompletionDirective.CompletionDirectiveFilterFileExt}
+    local shellCompDirectiveFilterDirs=${require_helpers_completion_directive_constants.CompletionDirective.CompletionDirectiveFilterDirs}
+    local shellCompDirectiveKeepOrder=${require_helpers_completion_directive_constants.CompletionDirective.CompletionDirectiveKeepOrder}
+
+    local lastParam lastChar flagPrefix requestComp out directive comp lastComp noSpace keepOrder
+    local -a completions
+
+    __${name.value}_debug "\\n========= starting completion logic =========="
+    __${name.value}_debug "CURRENT: \\\${CURRENT}, words[*]: \\\${words[*]}"
+
+    # The user could have moved the cursor backwards on the command-line.
+    # We need to trigger completion from the $CURRENT location, so we need
+    # to truncate the command-line ($words) up to the $CURRENT location.
+    # (We cannot use $CURSOR as its value does not work when a command is an alias.)
+    words=( "\\\${=words[1,CURRENT]}" )
+    __${name.value}_debug "Truncated words[*]: \\\${words[*]},"
+
+    lastParam=\\\${words[-1]}
+    lastChar=\\\${lastParam[-1]}
+    __${name.value}_debug "lastParam: \\\${lastParam}, lastChar: \\\${lastChar}"
+    # For zsh, when completing a flag with an = (e.g., ${bin.value} -n=<TAB>)
+    # completions must be prefixed with the flag
+    setopt local_options BASH_REMATCH
+    if [[ "\\\${lastParam}" =~ '-.*=' ]]; then
+        # We are dealing with a flag with an =
+        flagPrefix="-P \\\${BASH_REMATCH}"
+    fi
+
+    # Prepare the command to obtain completions, ensuring arguments are quoted for eval
+    local -a args_to_quote=("\\\${(@)words[2,-1]}")
+    if [ "\\\${lastChar}" = "" ]; then
+        # If the last parameter is complete (there is a space following it)
+        # We add an extra empty parameter so we can indicate this to the go completion code.
+        __${name.value}_debug "Adding extra empty parameter"
+        args_to_quote+=("")
+    fi
+
+    # Use Zsh's (q) flag to quote each argument safely for eval
+    local quoted_args=("\\\${(@q)args_to_quote}")
+
+    # Join the main command and the quoted arguments into a single string for eval
+    requestComp="${require_helpers_complete_command.EXEC_COMMAND} complete -- \\\${quoted_args[*]}"
+
+    __${name.value}_debug "About to call: eval \\\${requestComp}"
+
+    # Use eval to handle any environment variables and such
+    out=$(eval \\\${requestComp} 2>/dev/null)
+    __${name.value}_debug "completion output: \\\${out}"
+
+    # Extract the directive integer following a : from the last line
+    local lastLine
+    while IFS='\n' read -r line; do
+        lastLine=\\\${line}
+    done < <(printf "%s\n" "\\\${out[@]}")
+    __${name.value}_debug "last line: \\\${lastLine}"
+
+    if [ "\\\${lastLine[1]}" = : ]; then
+        directive=\\\${lastLine[2,-1]}
+        # Remove the directive including the : and the newline
+        local suffix
+        (( suffix=\\\${#lastLine}+2))
+        out=\\\${out[1,-$suffix]}
+    else
+        # There is no directive specified.  Leave $out as is.
+        __${name.value}_debug "No directive found.  Setting to default"
+        directive=0
+    fi
+
+    __${name.value}_debug "directive: \\\${directive}"
+    __${name.value}_debug "completions: \\\${out}"
+    __${name.value}_debug "flagPrefix: \\\${flagPrefix}"
+
+    if [ $((directive & shellCompDirectiveError)) -ne 0 ]; then
+        __${name.value}_debug "Completion received error. Ignoring completions."
+        return
+    fi
+
+    local activeHelpMarker="%"
+    local endIndex=\\\${#activeHelpMarker}
+    local startIndex=$((\\\${#activeHelpMarker}+1))
+    local hasActiveHelp=0
+    while IFS='\n' read -r comp; do
+        # Check if this is an activeHelp statement (i.e., prefixed with $activeHelpMarker)
+        if [ "\\\${comp[1,$endIndex]}" = "$activeHelpMarker" ];then
+            __${name.value}_debug "ActiveHelp found: $comp"
+            comp="\\\${comp[$startIndex,-1]}"
+            if [ -n "$comp" ]; then
+                compadd -x "\\\${comp}"
+                __${name.value}_debug "ActiveHelp will need delimiter"
+                hasActiveHelp=1
+            fi
+            continue
+        fi
+
+        if [ -n "$comp" ]; then
+            # If requested, completions are returned with a description.
+            # The description is preceded by a TAB character.
+            # For zsh's _describe, we need to use a : instead of a TAB.
+            # We first need to escape any : as part of the completion itself.
+            comp=\\\${comp//:/\\:}
+
+            local tab="$(printf '\\t')"
+            comp=\\\${comp//$tab/:}
+
+            __${name.value}_debug "Adding completion: \\\${comp}"
+            completions+=\\\${comp}
+            lastComp=$comp
+        fi
+    done < <(printf "%s\n" "\\\${out[@]}")
+
+    # Add a delimiter after the activeHelp statements, but only if:
+    # - there are completions following the activeHelp statements, or
+    # - file completion will be performed (so there will be choices after the activeHelp)
+    if [ $hasActiveHelp -eq 1 ]; then
+        if [ \\\${#completions} -ne 0 ] || [ $((directive & shellCompDirectiveNoFileComp)) -eq 0 ]; then
+            __${name.value}_debug "Adding activeHelp delimiter"
+            compadd -x "--"
+            hasActiveHelp=0
+        fi
+    fi
+
+    if [ $((directive & shellCompDirectiveNoSpace)) -ne 0 ]; then
+        __${name.value}_debug "Activating nospace."
+        noSpace="-S ''"
+    fi
+
+    if [ $((directive & shellCompDirectiveKeepOrder)) -ne 0 ]; then
+        __${name.value}_debug "Activating keep order."
+        keepOrder="-V"
+    fi
+
+    if [ $((directive & shellCompDirectiveFilterFileExt)) -ne 0 ]; then
+        # File extension filtering
+        local filteringCmd
+        filteringCmd='_files'
+        for filter in \\\${completions[@]}; do
+            if [ \\\${filter[1]} != '*' ]; then
+                # zsh requires a glob pattern to do file filtering
+                filter="\\*.$filter"
+            fi
+            filteringCmd+=" -g $filter"
+        done
+        filteringCmd+=" \\\${flagPrefix}"
+
+        __${name.value}_debug "File filtering command: $filteringCmd"
+        _arguments '*:filename:'"$filteringCmd"
+    elif [ $((directive & shellCompDirectiveFilterDirs)) -ne 0 ]; then
+        # File completion for directories only
+        local subdir
+        subdir="\\\${completions[1]}"
+        if [ -n "$subdir" ]; then
+            __${name.value}_debug "Listing directories in $subdir"
+            pushd "\\\${subdir}" >/dev/null 2>&1
+        else
+            __${name.value}_debug "Listing directories in ."
+        fi
+
+        local result
+        _arguments '*:dirname:_files -/'" \\\${flagPrefix}"
+        result=$?
+        if [ -n "$subdir" ]; then
+            popd >/dev/null 2>&1
+        fi
+        return $result
+    else
+        __${name.value}_debug "Calling _describe"
+        if eval _describe $keepOrder "completions" completions -Q \\\${flagPrefix} \\\${noSpace}; then
+            __${name.value}_debug "_describe found some completions"
+
+            # Return the success of having called _describe
+            return 0
+        else
+            __${name.value}_debug "_describe did not find completions."
+            __${name.value}_debug "Checking if we should do file completion."
+            if [ $((directive & shellCompDirectiveNoFileComp)) -ne 0 ]; then
+                __${name.value}_debug "deactivating file completion"
+
+                # Return 0 to indicate completion is finished and prevent zsh from
+                # trying other completion algorithms (which could cause hanging).
+                # We use NoFileComp directive to explicitly disable file completion.
+                return 0
+            else
+                # Perform file completion
+                __${name.value}_debug "Activating file completion"
+
+                # We must return the result of this command, so it must be the
+                # last command, or else we must store its result to return it.
+                _arguments '*:filename:_files'" \\\${flagPrefix}"
+            fi
+        fi
+    fi
+}
+
+# don't run the completion function when being sourced or eval-ed
+if [ "\\\${funcstack[1]}" = "_${name.value}" ]; then
+    _${name.value}
+fi
+\`; `;
+					}
+				}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.VarDeclaration, {
+					"export": true,
+					"const": true,
+					name: "SHELL_COMPLETIONS_DISPLAY",
+					initializer: _alloy_js_core.code` SHELL_COMPLETIONS.split("\\n").map(line => {
+          if (!line.trim()) {
+            return "";
+          }
+          if (line.trim().startsWith("#")) {
+            return \`\${colors.dim(line)}\`;
+          }
+
+          return colors.white(line).replaceAll(/(?<=\\\$(\\{|\\()).*(?=(\\}\\)))/g, colors.green("$&"))
+            .replaceAll(/\\".*\\"/g, colors.cyan("$&"))
+            .replaceAll(/(\\[|\\]|\\(|\\)|\\||<|>|\\$\\(|\\$?\\{|\\}|\\+|=|;|:)/g, colors.bold(colors.gray("$&")))
+            .replaceAll(/(readonly|complete)\\s+/g, colors.green("$&"))
+            .replaceAll(/(?<=(readonly|complete)\\s+)\\w/g, colors.bold(colors.greenBright("$&")))
+            .replaceAll(/local\\s+/g, colors.red("$&"))
+            .replaceAll(/(?<=local\\s+)\\w/g, colors.bold(colors.redBright("$&")))
+            .replaceAll(/(for|while)\\s+/g, colors.cyan("$&"))
+            .replaceAll(/(?<=for|while\\s+)\\w/g, colors.bold(colors.cyanBright("$&")))
+            .replaceAll(/(return|if|fi|else|elif|then|done)\\s+/g, colors.green("$&"))
+            .replaceAll(/__\\w/g, colors.bold(colors.magentaBright("$&")))
+            .replaceAll(/(?<=\\s)(-\\w|--\\w[\\w-]*)(?=\\s|$)/g, colors.bold(colors.magenta("$&")));
+
+        }).join("\\n"); `
+				})
+			];
+		}
+	});
+}
+
+//#endregion
+exports.ZshCompletionsShared = ZshCompletionsShared;

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

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

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

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

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

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

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

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

package/dist/components/zsh-shared.mjs

@@ -0,0 +1,281 @@
+import { EXEC_COMMAND } from "../helpers/complete-command.mjs";
+import { CompletionDirective } from "../helpers/completion-directive-constants.mjs";
+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 { VarDeclaration } from "@alloy-js/typescript";
+import { Spacing } from "@powerlines/plugin-alloy/core";
+import { usePowerlines } from "@powerlines/plugin-alloy/core/contexts/context";
+import { TypescriptFile } from "@powerlines/plugin-alloy/typescript";
+import { joinPaths } from "@stryke/path";
+import { snakeCase } from "@stryke/string-format/snake-case";
+
+//#region src/components/zsh-shared.tsx
+/**
+* The Zsh Completions generation for the Shell Shock project.
+*/
+function ZshCompletionsShared() {
+	const context = usePowerlines();
+	const bin = computed(() => getAppBin(context));
+	const name = computed(() => snakeCase(bin.value));
+	return createComponent(TypescriptFile, {
+		get path() {
+			return joinPaths(context.entryPath, "completions", "zsh", "shared.ts");
+		},
+		builtinImports: { console: ["colors"] },
+		get children() {
+			return [
+				createComponent(Spacing, {}),
+				createComponent(VarDeclaration, {
+					"const": true,
+					"export": true,
+					name: "SHELL_COMPLETIONS",
+					get initializer() {
+						return code` \`__${name.value}_debug() {
+    local file="$BASH_COMP_DEBUG_FILE"
+    if [[ -n \\\${file} ]]; then
+        echo "$*" >> "\\\${file}"
+    fi
+}
+
+_${name.value}() {
+    local shellCompDirectiveError=${CompletionDirective.CompletionDirectiveError}
+    local shellCompDirectiveNoSpace=${CompletionDirective.CompletionDirectiveNoSpace}
+    local shellCompDirectiveNoFileComp=${CompletionDirective.CompletionDirectiveNoFileComp}
+    local shellCompDirectiveFilterFileExt=${CompletionDirective.CompletionDirectiveFilterFileExt}
+    local shellCompDirectiveFilterDirs=${CompletionDirective.CompletionDirectiveFilterDirs}
+    local shellCompDirectiveKeepOrder=${CompletionDirective.CompletionDirectiveKeepOrder}
+
+    local lastParam lastChar flagPrefix requestComp out directive comp lastComp noSpace keepOrder
+    local -a completions
+
+    __${name.value}_debug "\\n========= starting completion logic =========="
+    __${name.value}_debug "CURRENT: \\\${CURRENT}, words[*]: \\\${words[*]}"
+
+    # The user could have moved the cursor backwards on the command-line.
+    # We need to trigger completion from the $CURRENT location, so we need
+    # to truncate the command-line ($words) up to the $CURRENT location.
+    # (We cannot use $CURSOR as its value does not work when a command is an alias.)
+    words=( "\\\${=words[1,CURRENT]}" )
+    __${name.value}_debug "Truncated words[*]: \\\${words[*]},"
+
+    lastParam=\\\${words[-1]}
+    lastChar=\\\${lastParam[-1]}
+    __${name.value}_debug "lastParam: \\\${lastParam}, lastChar: \\\${lastChar}"
+    # For zsh, when completing a flag with an = (e.g., ${bin.value} -n=<TAB>)
+    # completions must be prefixed with the flag
+    setopt local_options BASH_REMATCH
+    if [[ "\\\${lastParam}" =~ '-.*=' ]]; then
+        # We are dealing with a flag with an =
+        flagPrefix="-P \\\${BASH_REMATCH}"
+    fi
+
+    # Prepare the command to obtain completions, ensuring arguments are quoted for eval
+    local -a args_to_quote=("\\\${(@)words[2,-1]}")
+    if [ "\\\${lastChar}" = "" ]; then
+        # If the last parameter is complete (there is a space following it)
+        # We add an extra empty parameter so we can indicate this to the go completion code.
+        __${name.value}_debug "Adding extra empty parameter"
+        args_to_quote+=("")
+    fi
+
+    # Use Zsh's (q) flag to quote each argument safely for eval
+    local quoted_args=("\\\${(@q)args_to_quote}")
+
+    # Join the main command and the quoted arguments into a single string for eval
+    requestComp="${EXEC_COMMAND} complete -- \\\${quoted_args[*]}"
+
+    __${name.value}_debug "About to call: eval \\\${requestComp}"
+
+    # Use eval to handle any environment variables and such
+    out=$(eval \\\${requestComp} 2>/dev/null)
+    __${name.value}_debug "completion output: \\\${out}"
+
+    # Extract the directive integer following a : from the last line
+    local lastLine
+    while IFS='\n' read -r line; do
+        lastLine=\\\${line}
+    done < <(printf "%s\n" "\\\${out[@]}")
+    __${name.value}_debug "last line: \\\${lastLine}"
+
+    if [ "\\\${lastLine[1]}" = : ]; then
+        directive=\\\${lastLine[2,-1]}
+        # Remove the directive including the : and the newline
+        local suffix
+        (( suffix=\\\${#lastLine}+2))
+        out=\\\${out[1,-$suffix]}
+    else
+        # There is no directive specified.  Leave $out as is.
+        __${name.value}_debug "No directive found.  Setting to default"
+        directive=0
+    fi
+
+    __${name.value}_debug "directive: \\\${directive}"
+    __${name.value}_debug "completions: \\\${out}"
+    __${name.value}_debug "flagPrefix: \\\${flagPrefix}"
+
+    if [ $((directive & shellCompDirectiveError)) -ne 0 ]; then
+        __${name.value}_debug "Completion received error. Ignoring completions."
+        return
+    fi
+
+    local activeHelpMarker="%"
+    local endIndex=\\\${#activeHelpMarker}
+    local startIndex=$((\\\${#activeHelpMarker}+1))
+    local hasActiveHelp=0
+    while IFS='\n' read -r comp; do
+        # Check if this is an activeHelp statement (i.e., prefixed with $activeHelpMarker)
+        if [ "\\\${comp[1,$endIndex]}" = "$activeHelpMarker" ];then
+            __${name.value}_debug "ActiveHelp found: $comp"
+            comp="\\\${comp[$startIndex,-1]}"
+            if [ -n "$comp" ]; then
+                compadd -x "\\\${comp}"
+                __${name.value}_debug "ActiveHelp will need delimiter"
+                hasActiveHelp=1
+            fi
+            continue
+        fi
+
+        if [ -n "$comp" ]; then
+            # If requested, completions are returned with a description.
+            # The description is preceded by a TAB character.
+            # For zsh's _describe, we need to use a : instead of a TAB.
+            # We first need to escape any : as part of the completion itself.
+            comp=\\\${comp//:/\\:}
+
+            local tab="$(printf '\\t')"
+            comp=\\\${comp//$tab/:}
+
+            __${name.value}_debug "Adding completion: \\\${comp}"
+            completions+=\\\${comp}
+            lastComp=$comp
+        fi
+    done < <(printf "%s\n" "\\\${out[@]}")
+
+    # Add a delimiter after the activeHelp statements, but only if:
+    # - there are completions following the activeHelp statements, or
+    # - file completion will be performed (so there will be choices after the activeHelp)
+    if [ $hasActiveHelp -eq 1 ]; then
+        if [ \\\${#completions} -ne 0 ] || [ $((directive & shellCompDirectiveNoFileComp)) -eq 0 ]; then
+            __${name.value}_debug "Adding activeHelp delimiter"
+            compadd -x "--"
+            hasActiveHelp=0
+        fi
+    fi
+
+    if [ $((directive & shellCompDirectiveNoSpace)) -ne 0 ]; then
+        __${name.value}_debug "Activating nospace."
+        noSpace="-S ''"
+    fi
+
+    if [ $((directive & shellCompDirectiveKeepOrder)) -ne 0 ]; then
+        __${name.value}_debug "Activating keep order."
+        keepOrder="-V"
+    fi
+
+    if [ $((directive & shellCompDirectiveFilterFileExt)) -ne 0 ]; then
+        # File extension filtering
+        local filteringCmd
+        filteringCmd='_files'
+        for filter in \\\${completions[@]}; do
+            if [ \\\${filter[1]} != '*' ]; then
+                # zsh requires a glob pattern to do file filtering
+                filter="\\*.$filter"
+            fi
+            filteringCmd+=" -g $filter"
+        done
+        filteringCmd+=" \\\${flagPrefix}"
+
+        __${name.value}_debug "File filtering command: $filteringCmd"
+        _arguments '*:filename:'"$filteringCmd"
+    elif [ $((directive & shellCompDirectiveFilterDirs)) -ne 0 ]; then
+        # File completion for directories only
+        local subdir
+        subdir="\\\${completions[1]}"
+        if [ -n "$subdir" ]; then
+            __${name.value}_debug "Listing directories in $subdir"
+            pushd "\\\${subdir}" >/dev/null 2>&1
+        else
+            __${name.value}_debug "Listing directories in ."
+        fi
+
+        local result
+        _arguments '*:dirname:_files -/'" \\\${flagPrefix}"
+        result=$?
+        if [ -n "$subdir" ]; then
+            popd >/dev/null 2>&1
+        fi
+        return $result
+    else
+        __${name.value}_debug "Calling _describe"
+        if eval _describe $keepOrder "completions" completions -Q \\\${flagPrefix} \\\${noSpace}; then
+            __${name.value}_debug "_describe found some completions"
+
+            # Return the success of having called _describe
+            return 0
+        else
+            __${name.value}_debug "_describe did not find completions."
+            __${name.value}_debug "Checking if we should do file completion."
+            if [ $((directive & shellCompDirectiveNoFileComp)) -ne 0 ]; then
+                __${name.value}_debug "deactivating file completion"
+
+                # Return 0 to indicate completion is finished and prevent zsh from
+                # trying other completion algorithms (which could cause hanging).
+                # We use NoFileComp directive to explicitly disable file completion.
+                return 0
+            else
+                # Perform file completion
+                __${name.value}_debug "Activating file completion"
+
+                # We must return the result of this command, so it must be the
+                # last command, or else we must store its result to return it.
+                _arguments '*:filename:_files'" \\\${flagPrefix}"
+            fi
+        fi
+    fi
+}
+
+# don't run the completion function when being sourced or eval-ed
+if [ "\\\${funcstack[1]}" = "_${name.value}" ]; then
+    _${name.value}
+fi
+\`; `;
+					}
+				}),
+				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)}\`;
+          }
+
+          return colors.white(line).replaceAll(/(?<=\\\$(\\{|\\()).*(?=(\\}\\)))/g, colors.green("$&"))
+            .replaceAll(/\\".*\\"/g, colors.cyan("$&"))
+            .replaceAll(/(\\[|\\]|\\(|\\)|\\||<|>|\\$\\(|\\$?\\{|\\}|\\+|=|;|:)/g, colors.bold(colors.gray("$&")))
+            .replaceAll(/(readonly|complete)\\s+/g, colors.green("$&"))
+            .replaceAll(/(?<=(readonly|complete)\\s+)\\w/g, colors.bold(colors.greenBright("$&")))
+            .replaceAll(/local\\s+/g, colors.red("$&"))
+            .replaceAll(/(?<=local\\s+)\\w/g, colors.bold(colors.redBright("$&")))
+            .replaceAll(/(for|while)\\s+/g, colors.cyan("$&"))
+            .replaceAll(/(?<=for|while\\s+)\\w/g, colors.bold(colors.cyanBright("$&")))
+            .replaceAll(/(return|if|fi|else|elif|then|done)\\s+/g, colors.green("$&"))
+            .replaceAll(/__\\w/g, colors.bold(colors.magentaBright("$&")))
+            .replaceAll(/(?<=\\s)(-\\w|--\\w[\\w-]*)(?=\\s|$)/g, colors.bold(colors.magenta("$&")));
+
+        }).join("\\n"); `
+				})
+			];
+		}
+	});
+}
+
+//#endregion
+export { ZshCompletionsShared };
+//# sourceMappingURL=zsh-shared.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zsh-shared.mjs","names":[],"sources":["../../src/components/zsh-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 Zsh Completions generation for the Shell Shock project.\n */\nexport function ZshCompletionsShared() {\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\", \"zsh\", \"shared.ts\")}\n      builtinImports={{\n        console: [\"colors\"]\n      }}>\n      <Spacing />\n      <VarDeclaration\n        const\n        export\n        name=\"SHELL_COMPLETIONS\"\n        initializer={code` \\`__${name.value}_debug() {\n    local file=\"$BASH_COMP_DEBUG_FILE\"\n    if [[ -n \\\\\\${file} ]]; then\n        echo \"$*\" >> \"\\\\\\${file}\"\n    fi\n}\n\n_${name.value}() {\n    local shellCompDirectiveError=${\n      CompletionDirective.CompletionDirectiveError\n    }\n    local shellCompDirectiveNoSpace=${\n      CompletionDirective.CompletionDirectiveNoSpace\n    }\n    local shellCompDirectiveNoFileComp=${\n      CompletionDirective.CompletionDirectiveNoFileComp\n    }\n    local shellCompDirectiveFilterFileExt=${\n      CompletionDirective.CompletionDirectiveFilterFileExt\n    }\n    local shellCompDirectiveFilterDirs=${\n      CompletionDirective.CompletionDirectiveFilterDirs\n    }\n    local shellCompDirectiveKeepOrder=${\n      CompletionDirective.CompletionDirectiveKeepOrder\n    }\n\n    local lastParam lastChar flagPrefix requestComp out directive comp lastComp noSpace keepOrder\n    local -a completions\n\n    __${name.value}_debug \"\\\\n========= starting completion logic ==========\"\n    __${name.value}_debug \"CURRENT: \\\\\\${CURRENT}, words[*]: \\\\\\${words[*]}\"\n\n    # The user could have moved the cursor backwards on the command-line.\n    # We need to trigger completion from the $CURRENT location, so we need\n    # to truncate the command-line ($words) up to the $CURRENT location.\n    # (We cannot use $CURSOR as its value does not work when a command is an alias.)\n    words=( \"\\\\\\${=words[1,CURRENT]}\" )\n    __${name.value}_debug \"Truncated words[*]: \\\\\\${words[*]},\"\n\n    lastParam=\\\\\\${words[-1]}\n    lastChar=\\\\\\${lastParam[-1]}\n    __${name.value}_debug \"lastParam: \\\\\\${lastParam}, lastChar: \\\\\\${lastChar}\"\n    # For zsh, when completing a flag with an = (e.g., ${bin.value} -n=<TAB>)\n    # completions must be prefixed with the flag\n    setopt local_options BASH_REMATCH\n    if [[ \"\\\\\\${lastParam}\" =~ '-.*=' ]]; then\n        # We are dealing with a flag with an =\n        flagPrefix=\"-P \\\\\\${BASH_REMATCH}\"\n    fi\n\n    # Prepare the command to obtain completions, ensuring arguments are quoted for eval\n    local -a args_to_quote=(\"\\\\\\${(@)words[2,-1]}\")\n    if [ \"\\\\\\${lastChar}\" = \"\" ]; then\n        # If the last parameter is complete (there is a space following it)\n        # We add an extra empty parameter so we can indicate this to the go completion code.\n        __${name.value}_debug \"Adding extra empty parameter\"\n        args_to_quote+=(\"\")\n    fi\n\n    # Use Zsh's (q) flag to quote each argument safely for eval\n    local quoted_args=(\"\\\\\\${(@q)args_to_quote}\")\n\n    # Join the main command and the quoted arguments into a single string for eval\n    requestComp=\"${EXEC_COMMAND} complete -- \\\\\\${quoted_args[*]}\"\n\n    __${name.value}_debug \"About to call: eval \\\\\\${requestComp}\"\n\n    # Use eval to handle any environment variables and such\n    out=$(eval \\\\\\${requestComp} 2>/dev/null)\n    __${name.value}_debug \"completion output: \\\\\\${out}\"\n\n    # Extract the directive integer following a : from the last line\n    local lastLine\n    while IFS='\\n' read -r line; do\n        lastLine=\\\\\\${line}\n    done < <(printf \"%s\\n\" \"\\\\\\${out[@]}\")\n    __${name.value}_debug \"last line: \\\\\\${lastLine}\"\n\n    if [ \"\\\\\\${lastLine[1]}\" = : ]; then\n        directive=\\\\\\${lastLine[2,-1]}\n        # Remove the directive including the : and the newline\n        local suffix\n        (( suffix=\\\\\\${#lastLine}+2))\n        out=\\\\\\${out[1,-$suffix]}\n    else\n        # There is no directive specified.  Leave $out as is.\n        __${name.value}_debug \"No directive found.  Setting to default\"\n        directive=0\n    fi\n\n    __${name.value}_debug \"directive: \\\\\\${directive}\"\n    __${name.value}_debug \"completions: \\\\\\${out}\"\n    __${name.value}_debug \"flagPrefix: \\\\\\${flagPrefix}\"\n\n    if [ $((directive & shellCompDirectiveError)) -ne 0 ]; then\n        __${name.value}_debug \"Completion received error. Ignoring completions.\"\n        return\n    fi\n\n    local activeHelpMarker=\"%\"\n    local endIndex=\\\\\\${#activeHelpMarker}\n    local startIndex=$((\\\\\\${#activeHelpMarker}+1))\n    local hasActiveHelp=0\n    while IFS='\\n' read -r comp; do\n        # Check if this is an activeHelp statement (i.e., prefixed with $activeHelpMarker)\n        if [ \"\\\\\\${comp[1,$endIndex]}\" = \"$activeHelpMarker\" ];then\n            __${name.value}_debug \"ActiveHelp found: $comp\"\n            comp=\"\\\\\\${comp[$startIndex,-1]}\"\n            if [ -n \"$comp\" ]; then\n                compadd -x \"\\\\\\${comp}\"\n                __${name.value}_debug \"ActiveHelp will need delimiter\"\n                hasActiveHelp=1\n            fi\n            continue\n        fi\n\n        if [ -n \"$comp\" ]; then\n            # If requested, completions are returned with a description.\n            # The description is preceded by a TAB character.\n            # For zsh's _describe, we need to use a : instead of a TAB.\n            # We first need to escape any : as part of the completion itself.\n            comp=\\\\\\${comp//:/\\\\:}\n\n            local tab=\"$(printf '\\\\t')\"\n            comp=\\\\\\${comp//$tab/:}\n\n            __${name.value}_debug \"Adding completion: \\\\\\${comp}\"\n            completions+=\\\\\\${comp}\n            lastComp=$comp\n        fi\n    done < <(printf \"%s\\n\" \"\\\\\\${out[@]}\")\n\n    # Add a delimiter after the activeHelp statements, but only if:\n    # - there are completions following the activeHelp statements, or\n    # - file completion will be performed (so there will be choices after the activeHelp)\n    if [ $hasActiveHelp -eq 1 ]; then\n        if [ \\\\\\${#completions} -ne 0 ] || [ $((directive & shellCompDirectiveNoFileComp)) -eq 0 ]; then\n            __${name.value}_debug \"Adding activeHelp delimiter\"\n            compadd -x \"--\"\n            hasActiveHelp=0\n        fi\n    fi\n\n    if [ $((directive & shellCompDirectiveNoSpace)) -ne 0 ]; then\n        __${name.value}_debug \"Activating nospace.\"\n        noSpace=\"-S ''\"\n    fi\n\n    if [ $((directive & shellCompDirectiveKeepOrder)) -ne 0 ]; then\n        __${name.value}_debug \"Activating keep order.\"\n        keepOrder=\"-V\"\n    fi\n\n    if [ $((directive & shellCompDirectiveFilterFileExt)) -ne 0 ]; then\n        # File extension filtering\n        local filteringCmd\n        filteringCmd='_files'\n        for filter in \\\\\\${completions[@]}; do\n            if [ \\\\\\${filter[1]} != '*' ]; then\n                # zsh requires a glob pattern to do file filtering\n                filter=\"\\\\*.$filter\"\n            fi\n            filteringCmd+=\" -g $filter\"\n        done\n        filteringCmd+=\" \\\\\\${flagPrefix}\"\n\n        __${name.value}_debug \"File filtering command: $filteringCmd\"\n        _arguments '*:filename:'\"$filteringCmd\"\n    elif [ $((directive & shellCompDirectiveFilterDirs)) -ne 0 ]; then\n        # File completion for directories only\n        local subdir\n        subdir=\"\\\\\\${completions[1]}\"\n        if [ -n \"$subdir\" ]; then\n            __${name.value}_debug \"Listing directories in $subdir\"\n            pushd \"\\\\\\${subdir}\" >/dev/null 2>&1\n        else\n            __${name.value}_debug \"Listing directories in .\"\n        fi\n\n        local result\n        _arguments '*:dirname:_files -/'\" \\\\\\${flagPrefix}\"\n        result=$?\n        if [ -n \"$subdir\" ]; then\n            popd >/dev/null 2>&1\n        fi\n        return $result\n    else\n        __${name.value}_debug \"Calling _describe\"\n        if eval _describe $keepOrder \"completions\" completions -Q \\\\\\${flagPrefix} \\\\\\${noSpace}; then\n            __${name.value}_debug \"_describe found some completions\"\n\n            # Return the success of having called _describe\n            return 0\n        else\n            __${name.value}_debug \"_describe did not find completions.\"\n            __${name.value}_debug \"Checking if we should do file completion.\"\n            if [ $((directive & shellCompDirectiveNoFileComp)) -ne 0 ]; then\n                __${name.value}_debug \"deactivating file completion\"\n\n                # Return 0 to indicate completion is finished and prevent zsh from\n                # trying other completion algorithms (which could cause hanging).\n                # We use NoFileComp directive to explicitly disable file completion.\n                return 0\n            else\n                # Perform file completion\n                __${name.value}_debug \"Activating file completion\"\n\n                # We must return the result of this command, so it must be the\n                # last command, or else we must store its result to return it.\n                _arguments '*:filename:_files'\" \\\\\\${flagPrefix}\"\n            fi\n        fi\n    fi\n}\n\n# don't run the completion function when being sourced or eval-ed\nif [ \"\\\\\\${funcstack[1]}\" = \"_${name.value}\" ]; then\n    _${name.value}\nfi\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(/(readonly|complete)\\\\s+/g, colors.green(\"$&\"))\n            .replaceAll(/(?<=(readonly|complete)\\\\s+)\\\\w/g, colors.bold(colors.greenBright(\"$&\")))\n            .replaceAll(/local\\\\s+/g, colors.red(\"$&\"))\n            .replaceAll(/(?<=local\\\\s+)\\\\w/g, colors.bold(colors.redBright(\"$&\")))\n            .replaceAll(/(for|while)\\\\s+/g, colors.cyan(\"$&\"))\n            .replaceAll(/(?<=for|while\\\\s+)\\\\w/g, colors.bold(colors.cyanBright(\"$&\")))\n            .replaceAll(/(return|if|fi|else|elif|then|done)\\\\s+/g, colors.green(\"$&\"))\n            .replaceAll(/__\\\\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,uBAAgB;;CAE9B,MAAM,MAAM,eAAe,UAAU,QAAQ,CAAC;CAC9C,MAAM,OAAO,eAAe,UAAU,IAAI,MAAM,CAAC;;EAEjD,IAAM,OAAC;AACJ,UAAA,UAAA,QAAA,WAAA,eAAA,OAAA,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,IAAA,QAAA,KAAA,MAAoB;;;;;;;GAOlC,KAAC,MAAM;oCACgB,oBAAA,yBAAA;sCACtB,oBAAA,2BAAA;yCACiC,oBAAA,8BAAA;4CACX,oBAAA,iCAAA;yCACtB,oBAAA,8BAAA;wCACoC,oBAAA,6BAAA;;;;;QAKpC,KAAA,MAAA;QACA,KAAM,MAAA;;;;;;;QAON,KAAM,MAAS;;;;QAIX,KAAK,MAAM;;;;;;;;;;;;;;YAcR,KAAA,MAAA;;;;;;;;mBAQI,aAAiB;;QAExB,KAAK,MAAM;;;;;;;;;;;QAWX,KAAK,MAAM;;;;;;;;;;YAUP,KAAC,MAAU;;;;QAIf,KAAA,MAAW;QACX,KAAE,MAAO;QACT,KAAK,MAAC;;;YAGV,KAAA,MAAA;;;;;;;;;;;gBAWY,KAAC,MAAM;;;;oBAIb,KAAA,MAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;gBA2Bb,KAAK,MAAM;;;;;;;YAOnB,KAAS,MAAC;;;;;YAKN,KAAA,MAAW;;;;;;;;;;;;;;;;;YAiBf,KAAM,MAAA;;;;;;;gBAOF,KAAA,MAAe;;;;;;;;;;;;;;YAcf,KAAI,MAAK;;;;;;;gBAOL,KAAG,MAAQ;gBACnB,KAAA,MAAA;;oBAEJ,KAAA,MAAA;;;;;;;;oBAQgB,KAAC,MAAM;;;;;;;;;;;gCAWI,KAAM,MAAE;;;;;KAKhC,CAAC;IAAE,gBAAE,SAAA,EAAA,CAAA;IAAA,gBAAA,gBAAA;KACJ,UAAA;KACJ,SAAA;KACJ,MAAA;;;;;;;;;;;;;;;;;;;;;;;KAuBO,CAAC;IAAC;;EAEN,CAAC"}

package/dist/helpers/complete-command.cjs

@@ -4,12 +4,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 function quoteIfNeeded(path) {
 	return path.includes(" ") ? `'${path}'` : path;
 }
-const execPath = process.execPath;
-const processArgs = process.argv.slice(1);
-const quotedExecPath = quoteIfNeeded(execPath);
-const quotedProcessArgs = processArgs.map(quoteIfNeeded);
-const quotedProcessExecArgs = process.execArgv.map(quoteIfNeeded);
-const exec = `${quotedExecPath} ${quotedProcessExecArgs.join(" ")} ${quotedProcessArgs[0]}`;
+const EXEC_COMMAND = `${quoteIfNeeded(process.execPath)} ${process.execArgv.map(quoteIfNeeded).join(" ")} ${process.argv.slice(1).map(quoteIfNeeded)[0]}`;
 
 //#endregion
-exports.exec = exec;
+exports.EXEC_COMMAND = EXEC_COMMAND;

package/dist/helpers/complete-command.d.cts

@@ -1,5 +1,5 @@
 //#region src/helpers/complete-command.d.ts
-declare const exec: string;
+declare const EXEC_COMMAND: string;
 //#endregion
-export { exec };
+export { EXEC_COMMAND };
 //# sourceMappingURL=complete-command.d.cts.map

package/dist/helpers/complete-command.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"complete-command.d.cts","names":[],"sources":["../../src/helpers/complete-command.ts"],"mappings":";cA4Ba,IAAA"}
+{"version":3,"file":"complete-command.d.cts","names":[],"sources":["../../src/helpers/complete-command.ts"],"mappings":";cAsBa,YAAA"}

package/dist/helpers/complete-command.d.mts

@@ -1,5 +1,5 @@
 //#region src/helpers/complete-command.d.ts
-declare const exec: string;
+declare const EXEC_COMMAND: string;
 //#endregion
-export { exec };
+export { EXEC_COMMAND };
 //# sourceMappingURL=complete-command.d.mts.map