@shell-shock/plugin-completions 0.1.13 → 0.2.0

package/dist/components/zsh-command.cjs

@@ -1,3 +1,5 @@
+const require_helpers_complete_command = require('../helpers/complete-command.cjs');
+const require_helpers_completion_directive_constants = require('../helpers/completion-directive-constants.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 __stryke_path = require("@stryke/path");
@@ -8,6 +10,7 @@ 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 __powerlines_plugin_alloy_typescript_components_tsdoc = require("@powerlines/plugin-alloy/typescript/components/tsdoc");
+let __stryke_string_format = require("@stryke/string-format");
 
 //#region src/components/zsh-command.tsx
 /**
@@ -94,35 +97,219 @@ function ZshCompletionsCommand() {
 								name: "completions",
 								type: "string",
 								get initializer() {
-									return __alloy_js_core.code`colors.white(\`\${colors.gray(\`#compdef \${colors.bold("${(0, __shell_shock_core_plugin_utils.getAppBin)(context)}")}\`)}
-\${colors.gray("###-begin-${(0, __shell_shock_core_plugin_utils.getAppBin)(context)}-completions-###")}
-
-\${colors.gray(\`
-# \${colors.bold("${(0, __shell_shock_core_plugin_utils.getAppTitle)(context)} Zsh CLI command completion script")}
-#
-# \${colors.bold("Installation:")} ${(0, __shell_shock_core_plugin_utils.getAppBin)(context)} completions zsh --config ~/.zshrc or ${(0, __shell_shock_core_plugin_utils.getAppBin)(context)} completions zsh --script or ${(0, __shell_shock_core_plugin_utils.getAppBin)(context)} completions zsh >> ~/.zshrc or ${(0, __shell_shock_core_plugin_utils.getAppBin)(context)} completions zsh >> ~/.zprofile on OSX. \`
-)}
-\${colors.cyan("_${(0, __shell_shock_core_plugin_utils.getAppBin)(context)}_completions()")}
-{
-  local reply
-  local si=$IFS
-  IFS=$'\\n' reply=($(COMP_CWORD="$((CURRENT-1))" COMP_LINE="$BUFFER" COMP_POINT="$CURSOR" ${(0, __shell_shock_core_plugin_utils.getAppBin)(context)} --get-completions "\\\${words[@]}"))
-  IFS=$si
-  if [[ \\\${#reply} -gt 0 ]]; then
-    _describe 'values' reply
-  else
-    _default
-  fi
+									return __alloy_js_core.code`#compdef ${(0, __shell_shock_core_plugin_utils.getAppBin)(context)}
+compdef _${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))} ${(0, __shell_shock_core_plugin_utils.getAppBin)(context)}
+
+# zsh completion for ${(0, __shell_shock_core_plugin_utils.getAppTitle)(context)} -*- shell-script -*-
+
+__${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_debug() {
+    local file="$BASH_COMP_DEBUG_FILE"
+    if [[ -n \${file} ]]; then
+        echo "$*" >> "\${file}"
+    fi
 }
 
-if [[ "\\\${zsh_eval_context[-1]}" == "loadautofunc" ]]; then
-  _${(0, __shell_shock_core_plugin_utils.getAppBin)(context)}_completions "$@"
-else
-  compdef _${(0, __shell_shock_core_plugin_utils.getAppBin)(context)}_completions ${(0, __shell_shock_core_plugin_utils.getAppBin)(context)}
-fi
-complete -o bashdefault -o default -F _${(0, __shell_shock_core_plugin_utils.getAppBin)(context)}_completions ${(0, __shell_shock_core_plugin_utils.getAppBin)(context)}
+_${(0, __shell_shock_core_plugin_utils.getAppBin)(context)}() {
+    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
+
+    __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_debug "\\n========= starting completion logic =========="
+    __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_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]}" )
+    __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_debug "Truncated words[*]: \${words[*]},"
+
+    lastParam=\${words[-1]}
+    lastChar=\${lastParam[-1]}
+    __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_debug "lastParam: \${lastParam}, lastChar: \${lastChar}"
+    # For zsh, when completing a flag with an = (e.g., ${(0, __shell_shock_core_plugin_utils.getAppBin)(context)} -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.
+        __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_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} complete -- \${quoted_args[*]}"
+
+    __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_debug "About to call: eval \${requestComp}"
+
+    # Use eval to handle any environment variables and such
+    out=$(eval \${requestComp} 2>/dev/null)
+    __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_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[@]}")
+    __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_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.
+        __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_debug "No directive found.  Setting to default"
+        directive=0
+    fi
+
+    __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_debug "directive: \${directive}"
+    __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_debug "completions: \${out}"
+    __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_debug "flagPrefix: \${flagPrefix}"
+
+    if [ $((directive & shellCompDirectiveError)) -ne 0 ]; then
+        __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_debug "Completion received error. Ignoring completions."
+        return
+    fi
 
-\${colors.gray("###-end-${(0, __shell_shock_core_plugin_utils.getAppBin)(context)}-completions-###")}
+    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
+            __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_debug "ActiveHelp found: $comp"
+            comp="\${comp[$startIndex,-1]}"
+            if [ -n "$comp" ]; then
+                compadd -x "\${comp}"
+                __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_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/:}
+
+            __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_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
+            __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_debug "Adding activeHelp delimiter"
+            compadd -x "--"
+            hasActiveHelp=0
+        fi
+    fi
+
+    if [ $((directive & shellCompDirectiveNoSpace)) -ne 0 ]; then
+        __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_debug "Activating nospace."
+        noSpace="-S ''"
+    fi
+
+    if [ $((directive & shellCompDirectiveKeepOrder)) -ne 0 ]; then
+        __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_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}"
+
+        __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_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
+            __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_debug "Listing directories in $subdir"
+            pushd "\${subdir}" >/dev/null 2>&1
+        else
+            __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_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
+        __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_debug "Calling _describe"
+        if eval _describe $keepOrder "completions" completions -Q \${flagPrefix} \${noSpace}; then
+            __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_debug "_describe found some completions"
+
+            # Return the success of having called _describe
+            return 0
+        else
+            __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_debug "_describe did not find completions."
+            __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_debug "Checking if we should do file completion."
+            if [ $((directive & shellCompDirectiveNoFileComp)) -ne 0 ]; then
+                __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_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
+                __${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_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]}" = "_${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}" ]; then
+    _${(0, __stryke_string_format.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}
+fi
 \`);`;
 								}
 							}),

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

@@ -1 +1 @@
-{"version":3,"file":"zsh-command.d.cts","names":[],"sources":["../../src/components/zsh-command.tsx"],"sourcesContent":[],"mappings":";;;;;;AA4CgB,iBAAA,qBAAA,CAAA,CAAqB,EAAA,eAAA,CAAA,QAAA"}
+{"version":3,"file":"zsh-command.d.cts","names":[],"sources":["../../src/components/zsh-command.tsx"],"sourcesContent":[],"mappings":";;;;;;AA+CgB,iBAAA,qBAAA,CAAA,CAAqB,EAAA,eAAA,CAAA,QAAA"}

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

@@ -1,10 +1,10 @@
-import * as _alloy_js_core0 from "@alloy-js/core";
+import * as _alloy_js_core2 from "@alloy-js/core";
 
 //#region src/components/zsh-command.d.ts
 /**
  * The Zsh Completions commands' handler wrapper for the Shell Shock project.
  */
-declare function ZshCompletionsCommand(): _alloy_js_core0.Children;
+declare function ZshCompletionsCommand(): _alloy_js_core2.Children;
 //#endregion
 export { ZshCompletionsCommand };
 //# sourceMappingURL=zsh-command.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"zsh-command.d.mts","names":[],"sources":["../../src/components/zsh-command.tsx"],"sourcesContent":[],"mappings":";;;;;;AA4CgB,iBAAA,qBAAA,CAAA,CAAqB,EAAA,eAAA,CAAA,QAAA"}
+{"version":3,"file":"zsh-command.d.mts","names":[],"sources":["../../src/components/zsh-command.tsx"],"sourcesContent":[],"mappings":";;;;;;AA+CgB,iBAAA,qBAAA,CAAA,CAAqB,EAAA,eAAA,CAAA,QAAA"}

package/dist/components/zsh-command.mjs

@@ -1,3 +1,5 @@
+import { exec } 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 { joinPaths } from "@stryke/path";
@@ -8,6 +10,7 @@ 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 { snakeCase } from "@stryke/string-format";
 
 //#region src/components/zsh-command.tsx
 /**
@@ -94,35 +97,219 @@ function ZshCompletionsCommand() {
 								name: "completions",
 								type: "string",
 								get initializer() {
-									return code`colors.white(\`\${colors.gray(\`#compdef \${colors.bold("${getAppBin(context)}")}\`)}
-\${colors.gray("###-begin-${getAppBin(context)}-completions-###")}
-
-\${colors.gray(\`
-# \${colors.bold("${getAppTitle(context)} Zsh CLI command completion script")}
-#
-# \${colors.bold("Installation:")} ${getAppBin(context)} completions zsh --config ~/.zshrc or ${getAppBin(context)} completions zsh --script or ${getAppBin(context)} completions zsh >> ~/.zshrc or ${getAppBin(context)} completions zsh >> ~/.zprofile on OSX. \`
-)}
-\${colors.cyan("_${getAppBin(context)}_completions()")}
-{
-  local reply
-  local si=$IFS
-  IFS=$'\\n' reply=($(COMP_CWORD="$((CURRENT-1))" COMP_LINE="$BUFFER" COMP_POINT="$CURSOR" ${getAppBin(context)} --get-completions "\\\${words[@]}"))
-  IFS=$si
-  if [[ \\\${#reply} -gt 0 ]]; then
-    _describe 'values' reply
-  else
-    _default
-  fi
+									return code`#compdef ${getAppBin(context)}
+compdef _${snakeCase(getAppBin(context))} ${getAppBin(context)}
+
+# zsh completion for ${getAppTitle(context)} -*- shell-script -*-
+
+__${snakeCase(getAppBin(context))}_debug() {
+    local file="$BASH_COMP_DEBUG_FILE"
+    if [[ -n \${file} ]]; then
+        echo "$*" >> "\${file}"
+    fi
 }
 
-if [[ "\\\${zsh_eval_context[-1]}" == "loadautofunc" ]]; then
-  _${getAppBin(context)}_completions "$@"
-else
-  compdef _${getAppBin(context)}_completions ${getAppBin(context)}
-fi
-complete -o bashdefault -o default -F _${getAppBin(context)}_completions ${getAppBin(context)}
+_${getAppBin(context)}() {
+    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
+
+    __${snakeCase(getAppBin(context))}_debug "\\n========= starting completion logic =========="
+    __${snakeCase(getAppBin(context))}_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]}" )
+    __${snakeCase(getAppBin(context))}_debug "Truncated words[*]: \${words[*]},"
+
+    lastParam=\${words[-1]}
+    lastChar=\${lastParam[-1]}
+    __${snakeCase(getAppBin(context))}_debug "lastParam: \${lastParam}, lastChar: \${lastChar}"
+    # For zsh, when completing a flag with an = (e.g., ${getAppBin(context)} -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.
+        __${snakeCase(getAppBin(context))}_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} complete -- \${quoted_args[*]}"
+
+    __${snakeCase(getAppBin(context))}_debug "About to call: eval \${requestComp}"
+
+    # Use eval to handle any environment variables and such
+    out=$(eval \${requestComp} 2>/dev/null)
+    __${snakeCase(getAppBin(context))}_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[@]}")
+    __${snakeCase(getAppBin(context))}_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.
+        __${snakeCase(getAppBin(context))}_debug "No directive found.  Setting to default"
+        directive=0
+    fi
+
+    __${snakeCase(getAppBin(context))}_debug "directive: \${directive}"
+    __${snakeCase(getAppBin(context))}_debug "completions: \${out}"
+    __${snakeCase(getAppBin(context))}_debug "flagPrefix: \${flagPrefix}"
+
+    if [ $((directive & shellCompDirectiveError)) -ne 0 ]; then
+        __${snakeCase(getAppBin(context))}_debug "Completion received error. Ignoring completions."
+        return
+    fi
 
-\${colors.gray("###-end-${getAppBin(context)}-completions-###")}
+    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
+            __${snakeCase(getAppBin(context))}_debug "ActiveHelp found: $comp"
+            comp="\${comp[$startIndex,-1]}"
+            if [ -n "$comp" ]; then
+                compadd -x "\${comp}"
+                __${snakeCase(getAppBin(context))}_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/:}
+
+            __${snakeCase(getAppBin(context))}_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
+            __${snakeCase(getAppBin(context))}_debug "Adding activeHelp delimiter"
+            compadd -x "--"
+            hasActiveHelp=0
+        fi
+    fi
+
+    if [ $((directive & shellCompDirectiveNoSpace)) -ne 0 ]; then
+        __${snakeCase(getAppBin(context))}_debug "Activating nospace."
+        noSpace="-S ''"
+    fi
+
+    if [ $((directive & shellCompDirectiveKeepOrder)) -ne 0 ]; then
+        __${snakeCase(getAppBin(context))}_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}"
+
+        __${snakeCase(getAppBin(context))}_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
+            __${snakeCase(getAppBin(context))}_debug "Listing directories in $subdir"
+            pushd "\${subdir}" >/dev/null 2>&1
+        else
+            __${snakeCase(getAppBin(context))}_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
+        __${snakeCase(getAppBin(context))}_debug "Calling _describe"
+        if eval _describe $keepOrder "completions" completions -Q \${flagPrefix} \${noSpace}; then
+            __${snakeCase(getAppBin(context))}_debug "_describe found some completions"
+
+            # Return the success of having called _describe
+            return 0
+        else
+            __${snakeCase(getAppBin(context))}_debug "_describe did not find completions."
+            __${snakeCase(getAppBin(context))}_debug "Checking if we should do file completion."
+            if [ $((directive & shellCompDirectiveNoFileComp)) -ne 0 ]; then
+                __${snakeCase(getAppBin(context))}_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
+                __${snakeCase(getAppBin(context))}_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]}" = "_${snakeCase(getAppBin(context))}" ]; then
+    _${snakeCase(getAppBin(context))}
+fi
 \`);`;
 								}
 							}),

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

@@ -1 +1 @@
-{"version":3,"file":"zsh-command.mjs","names":["code","FunctionDeclaration","IfStatement","InterfaceDeclaration","VarDeclaration","ReflectionKind","Spacing","usePowerlines","InterfaceMember","TypescriptFile","TSDoc","TSDocDefaultValue","TSDocRemarks","getAppBin","getAppTitle","joinPaths","ZshCompletionsCommand","context","_$createComponent","path","entryPath","imports","builtinImports","children","heading","name","type","string","defaultValue","optional","async","parameters","initializer","condition","_$memo"],"sources":["../../src/components/zsh-command.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code } from \"@alloy-js/core\";\nimport {\n  FunctionDeclaration,\n  IfStatement,\n  InterfaceDeclaration,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport {\n  InterfaceMember,\n  TypescriptFile\n} from \"@powerlines/plugin-alloy/typescript\";\nimport {\n  TSDoc,\n  TSDocDefaultValue,\n  TSDocRemarks\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport { getAppBin, getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport { joinPaths } from \"@stryke/path\";\nimport type { CompletionsPluginContext } from \"../types/plugin\";\n\n/**\n * The Zsh Completions commands' handler wrapper for the Shell Shock project.\n */\nexport function ZshCompletionsCommand() {\n  const context = usePowerlines<CompletionsPluginContext>();\n\n  return (\n    <TypescriptFile\n      path={joinPaths(context.entryPath, \"completions\", \"zsh\", \"command.ts\")}\n      imports={{\n        \"node:os\": [\"os\"],\n        \"node:fs/promises\": [\"readFile\", \"writeFile\"]\n      }}\n      builtinImports={{\n        \"shell-shock:console\": [\n          \"colors\",\n          \"writeLine\",\n          \"success\",\n          \"warn\",\n          \"stripAnsi\"\n        ]\n      }}>\n      <TSDoc heading=\"Options for the Zsh completions command.\" />\n      <InterfaceDeclaration export name=\"ZshCompletionsOptions\">\n        <TSDoc heading=\"The path to write the completion script to.\">\n          <TSDocRemarks>{`If no extension is provided, the \\`.zsh\\` extension will be used.`}</TSDocRemarks>\n          <TSDocDefaultValue\n            type={ReflectionKind.string}\n            defaultValue={`${getAppBin(context)}-completions.zsh`}\n          />\n        </TSDoc>\n        <InterfaceMember name=\"script\" optional type=\"string | true\" />\n        <Spacing />\n        <TSDoc heading=\"The Zsh configuration file to append the completion script to.\">\n          <TSDocRemarks>{`The generated completion script will be appended to the specified configuration file. Possible values for the Zsh configuration file include: \\\\n- \\`~/.zshrc\\` \\\\n- \\`~/.zprofile\\``}</TSDocRemarks>\n          <TSDocDefaultValue\n            type={ReflectionKind.string}\n            defaultValue=\"~/.zshrc\"\n          />\n        </TSDoc>\n        <InterfaceMember name=\"config\" optional type=\"string | true\" />\n      </InterfaceDeclaration>\n      <Spacing />\n      <TSDoc heading=\"Handler logic for the \\`completions zsh\\` command.\"></TSDoc>\n      <FunctionDeclaration\n        export\n        default\n        async\n        name=\"handler\"\n        parameters={[{ name: \"options\", type: \"ZshCompletionsOptions\" }]}>\n        <VarDeclaration\n          const\n          name=\"completions\"\n          type=\"string\"\n          initializer={code`colors.white(\\`\\${colors.gray(\\`#compdef \\${colors.bold(\"${getAppBin(context)}\")}\\`)}\n\\${colors.gray(\"###-begin-${getAppBin(context)}-completions-###\")}\n\n\\${colors.gray(\\`\n# \\${colors.bold(\"${getAppTitle(context)} Zsh CLI command completion script\")}\n#\n# \\${colors.bold(\"Installation:\")} ${getAppBin(context)} completions zsh --config ~/.zshrc or ${getAppBin(context)} completions zsh --script or ${getAppBin(context)} completions zsh >> ~/.zshrc or ${getAppBin(context)} completions zsh >> ~/.zprofile on OSX. \\`\n)}\n\\${colors.cyan(\"_${getAppBin(context)}_completions()\")}\n{\n  local reply\n  local si=$IFS\n  IFS=$'\\\\n' reply=($(COMP_CWORD=\"$((CURRENT-1))\" COMP_LINE=\"$BUFFER\" COMP_POINT=\"$CURSOR\" ${getAppBin(context)} --get-completions \"\\\\\\${words[@]}\"))\n  IFS=$si\n  if [[ \\\\\\${#reply} -gt 0 ]]; then\n    _describe 'values' reply\n  else\n    _default\n  fi\n}\n\nif [[ \"\\\\\\${zsh_eval_context[-1]}\" == \"loadautofunc\" ]]; then\n  _${getAppBin(context)}_completions \"$@\"\nelse\n  compdef _${getAppBin(context)}_completions ${getAppBin(context)}\nfi\ncomplete -o bashdefault -o default -F _${getAppBin(context)}_completions ${getAppBin(context)}\n\n\\${colors.gray(\"###-end-${getAppBin(context)}-completions-###\")}\n\\`);`}\n        />\n        <Spacing />\n        <IfStatement condition={code`options.config`}>\n          <VarDeclaration\n            let\n            name=\"configFilePath\"\n            type=\"string\"\n            initializer={code`options.config === true ? \"~/.zshrc\" : options.config`}\n          />\n          <Spacing />\n          <IfStatement condition={code`configFilePath.startsWith(\"~\")`}>\n            {code`configFilePath = join(os.homedir(), configFilePath.replace(\"~\", \"\")); `}\n          </IfStatement>\n          <Spacing />\n          <VarDeclaration\n            let\n            name=\"configFileContent\"\n            type=\"string\"\n            initializer={code`\"\";`}\n          />\n          <Spacing />\n          {code`try {\n            configFileContent = await readFile(configFilePath, \"utf8\");\n          } catch (error) {\n            if (error.code === \"ENOENT\") {\n              // If the file doesn't exist, we can create it later when writing the completion script.\n              warn(\\`Configuration file \\${colors.bold(configFilePath)} does not exist. It will be created when the completion script is written.\\`);\n            } else {\n              return { error };\n            }\n          }\n\n          await writeFile(configFilePath, \\`\\${configFileContent}\\\\n\\\\n\\${stripAnsi(completions)}\\`);\n\n          success(\\`${getAppTitle(context)} Zsh completion script has been generated and appended to \\${colors.bold(configFilePath)}. Please restart your terminal or run \\`source \\${configFilePath}\\` to apply the changes.\\`); `}\n        </IfStatement>\n        <Spacing />\n        <IfStatement condition={code`options.script`}>\n          {code`const outputPath = options.script === true ? \"${getAppBin(context)}-completions.zsh\" : options.script;\n          await writeFile(outputPath, stripAnsi(completions));\n\n          success(\\`${getAppTitle(context)} Zsh completion script has been generated at \\${colors.bold(outputPath)}.\\`);`}\n        </IfStatement>\n        <Spacing />\n        <IfStatement condition={code`!options.config && !options.script`}>\n          {code`writeLine(\" ------------------------------------------------- \");\n          writeLine(completions);\n          writeLine(\" ------------------------------------------------- \");`}\n        </IfStatement>\n      </FunctionDeclaration>\n    </TypescriptFile>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"zsh-command.mjs","names":["code","FunctionDeclaration","IfStatement","InterfaceDeclaration","VarDeclaration","ReflectionKind","Spacing","usePowerlines","InterfaceMember","TypescriptFile","TSDoc","TSDocDefaultValue","TSDocRemarks","getAppBin","getAppTitle","joinPaths","snakeCase","exec","CompletionDirective","ZshCompletionsCommand","context","_$createComponent","path","entryPath","imports","builtinImports","children","heading","name","type","string","defaultValue","optional","async","parameters","initializer","CompletionDirectiveError","CompletionDirectiveNoSpace","CompletionDirectiveNoFileComp","CompletionDirectiveFilterFileExt","CompletionDirectiveFilterDirs","CompletionDirectiveKeepOrder","condition","_$memo"],"sources":["../../src/components/zsh-command.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                  ⚡ Storm Software - Shell Shock\n\n This code was released as part of the Shell Shock project. Shell Shock\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/shell-shock.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/shell-shock\n Documentation:            https://docs.stormsoftware.com/projects/shell-shock\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { code } from \"@alloy-js/core\";\nimport {\n  FunctionDeclaration,\n  IfStatement,\n  InterfaceDeclaration,\n  VarDeclaration\n} from \"@alloy-js/typescript\";\nimport { ReflectionKind } from \"@powerlines/deepkit/vendor/type\";\nimport { Spacing } from \"@powerlines/plugin-alloy/core\";\nimport { usePowerlines } from \"@powerlines/plugin-alloy/core/contexts/context\";\nimport {\n  InterfaceMember,\n  TypescriptFile\n} from \"@powerlines/plugin-alloy/typescript\";\nimport {\n  TSDoc,\n  TSDocDefaultValue,\n  TSDocRemarks\n} from \"@powerlines/plugin-alloy/typescript/components/tsdoc\";\nimport { getAppBin, getAppTitle } from \"@shell-shock/core/plugin-utils\";\nimport { joinPaths } from \"@stryke/path\";\nimport { snakeCase } from \"@stryke/string-format\";\nimport { exec } from \"../helpers/complete-command\";\nimport { CompletionDirective } from \"../helpers/completion-directive-constants\";\nimport type { CompletionsPluginContext } from \"../types/plugin\";\n\n/**\n * The Zsh Completions commands' handler wrapper for the Shell Shock project.\n */\nexport function ZshCompletionsCommand() {\n  const context = usePowerlines<CompletionsPluginContext>();\n\n  return (\n    <TypescriptFile\n      path={joinPaths(context.entryPath, \"completions\", \"zsh\", \"command.ts\")}\n      imports={{\n        \"node:os\": [\"os\"],\n        \"node:fs/promises\": [\"readFile\", \"writeFile\"]\n      }}\n      builtinImports={{\n        \"shell-shock:console\": [\n          \"colors\",\n          \"writeLine\",\n          \"success\",\n          \"warn\",\n          \"stripAnsi\"\n        ]\n      }}>\n      <TSDoc heading=\"Options for the Zsh completions command.\" />\n      <InterfaceDeclaration export name=\"ZshCompletionsOptions\">\n        <TSDoc heading=\"The path to write the completion script to.\">\n          <TSDocRemarks>{`If no extension is provided, the \\`.zsh\\` extension will be used.`}</TSDocRemarks>\n          <TSDocDefaultValue\n            type={ReflectionKind.string}\n            defaultValue={`${getAppBin(context)}-completions.zsh`}\n          />\n        </TSDoc>\n        <InterfaceMember name=\"script\" optional type=\"string | true\" />\n        <Spacing />\n        <TSDoc heading=\"The Zsh configuration file to append the completion script to.\">\n          <TSDocRemarks>{`The generated completion script will be appended to the specified configuration file. Possible values for the Zsh configuration file include: \\\\n- \\`~/.zshrc\\` \\\\n- \\`~/.zprofile\\``}</TSDocRemarks>\n          <TSDocDefaultValue\n            type={ReflectionKind.string}\n            defaultValue=\"~/.zshrc\"\n          />\n        </TSDoc>\n        <InterfaceMember name=\"config\" optional type=\"string | true\" />\n      </InterfaceDeclaration>\n      <Spacing />\n      <TSDoc heading=\"Handler logic for the \\`completions zsh\\` command.\"></TSDoc>\n      <FunctionDeclaration\n        export\n        default\n        async\n        name=\"handler\"\n        parameters={[{ name: \"options\", type: \"ZshCompletionsOptions\" }]}>\n        <VarDeclaration\n          const\n          name=\"completions\"\n          type=\"string\"\n          initializer={code`#compdef ${getAppBin(context)}\ncompdef _${snakeCase(getAppBin(context))} ${getAppBin(context)}\n\n# zsh completion for ${getAppTitle(context)} -*- shell-script -*-\n\n__${snakeCase(getAppBin(context))}_debug() {\n    local file=\"$BASH_COMP_DEBUG_FILE\"\n    if [[ -n \\${file} ]]; then\n        echo \"$*\" >> \"\\${file}\"\n    fi\n}\n\n_${getAppBin(context)}() {\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    __${snakeCase(getAppBin(context))}_debug \"\\\\n========= starting completion logic ==========\"\n    __${snakeCase(getAppBin(context))}_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    __${snakeCase(getAppBin(context))}_debug \"Truncated words[*]: \\${words[*]},\"\n\n    lastParam=\\${words[-1]}\n    lastChar=\\${lastParam[-1]}\n    __${snakeCase(getAppBin(context))}_debug \"lastParam: \\${lastParam}, lastChar: \\${lastChar}\"\n    # For zsh, when completing a flag with an = (e.g., ${getAppBin(\n      context\n    )} -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        __${snakeCase(getAppBin(context))}_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} complete -- \\${quoted_args[*]}\"\n\n    __${snakeCase(getAppBin(context))}_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    __${snakeCase(getAppBin(context))}_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    __${snakeCase(getAppBin(context))}_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        __${snakeCase(getAppBin(context))}_debug \"No directive found.  Setting to default\"\n        directive=0\n    fi\n\n    __${snakeCase(getAppBin(context))}_debug \"directive: \\${directive}\"\n    __${snakeCase(getAppBin(context))}_debug \"completions: \\${out}\"\n    __${snakeCase(getAppBin(context))}_debug \"flagPrefix: \\${flagPrefix}\"\n\n    if [ $((directive & shellCompDirectiveError)) -ne 0 ]; then\n        __${snakeCase(getAppBin(context))}_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            __${snakeCase(getAppBin(context))}_debug \"ActiveHelp found: $comp\"\n            comp=\"\\${comp[$startIndex,-1]}\"\n            if [ -n \"$comp\" ]; then\n                compadd -x \"\\${comp}\"\n                __${snakeCase(getAppBin(context))}_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            __${snakeCase(getAppBin(context))}_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            __${snakeCase(getAppBin(context))}_debug \"Adding activeHelp delimiter\"\n            compadd -x \"--\"\n            hasActiveHelp=0\n        fi\n    fi\n\n    if [ $((directive & shellCompDirectiveNoSpace)) -ne 0 ]; then\n        __${snakeCase(getAppBin(context))}_debug \"Activating nospace.\"\n        noSpace=\"-S ''\"\n    fi\n\n    if [ $((directive & shellCompDirectiveKeepOrder)) -ne 0 ]; then\n        __${snakeCase(getAppBin(context))}_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        __${snakeCase(getAppBin(context))}_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            __${snakeCase(getAppBin(context))}_debug \"Listing directories in $subdir\"\n            pushd \"\\${subdir}\" >/dev/null 2>&1\n        else\n            __${snakeCase(getAppBin(context))}_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        __${snakeCase(getAppBin(context))}_debug \"Calling _describe\"\n        if eval _describe $keepOrder \"completions\" completions -Q \\${flagPrefix} \\${noSpace}; then\n            __${snakeCase(getAppBin(context))}_debug \"_describe found some completions\"\n\n            # Return the success of having called _describe\n            return 0\n        else\n            __${snakeCase(getAppBin(context))}_debug \"_describe did not find completions.\"\n            __${snakeCase(getAppBin(context))}_debug \"Checking if we should do file completion.\"\n            if [ $((directive & shellCompDirectiveNoFileComp)) -ne 0 ]; then\n                __${snakeCase(getAppBin(context))}_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                __${snakeCase(getAppBin(context))}_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]}\" = \"_${snakeCase(getAppBin(context))}\" ]; then\n    _${snakeCase(getAppBin(context))}\nfi\n\\`);`}\n        />\n        <Spacing />\n        <IfStatement condition={code`options.config`}>\n          <VarDeclaration\n            let\n            name=\"configFilePath\"\n            type=\"string\"\n            initializer={code`options.config === true ? \"~/.zshrc\" : options.config`}\n          />\n          <Spacing />\n          <IfStatement condition={code`configFilePath.startsWith(\"~\")`}>\n            {code`configFilePath = join(os.homedir(), configFilePath.replace(\"~\", \"\")); `}\n          </IfStatement>\n          <Spacing />\n          <VarDeclaration\n            let\n            name=\"configFileContent\"\n            type=\"string\"\n            initializer={code`\"\";`}\n          />\n          <Spacing />\n          {code`try {\n            configFileContent = await readFile(configFilePath, \"utf8\");\n          } catch (error) {\n            if (error.code === \"ENOENT\") {\n              // If the file doesn't exist, we can create it later when writing the completion script.\n              warn(\\`Configuration file \\${colors.bold(configFilePath)} does not exist. It will be created when the completion script is written.\\`);\n            } else {\n              return { error };\n            }\n          }\n\n          await writeFile(configFilePath, \\`\\${configFileContent}\\\\n\\\\n\\${stripAnsi(completions)}\\`);\n\n          success(\\`${getAppTitle(context)} Zsh completion script has been generated and appended to \\${colors.bold(configFilePath)}. Please restart your terminal or run \\`source \\${configFilePath}\\` to apply the changes.\\`); `}\n        </IfStatement>\n        <Spacing />\n        <IfStatement condition={code`options.script`}>\n          {code`const outputPath = options.script === true ? \"${getAppBin(context)}-completions.zsh\" : options.script;\n          await writeFile(outputPath, stripAnsi(completions));\n\n          success(\\`${getAppTitle(context)} Zsh completion script has been generated at \\${colors.bold(outputPath)}.\\`);`}\n        </IfStatement>\n        <Spacing />\n        <IfStatement condition={code`!options.config && !options.script`}>\n          {code`writeLine(\" ------------------------------------------------- \");\n          writeLine(completions);\n          writeLine(\" ------------------------------------------------- \");`}\n        </IfStatement>\n      </FunctionDeclaration>\n    </TypescriptFile>\n  );\n}\n"],"mappings":"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"}

package/dist/helpers/complete-command.cjs

@@ -0,0 +1,14 @@
+
+//#region src/helpers/complete-command.ts
+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]}`;
+
+//#endregion
+exports.exec = exec;

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

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