@shell-shock/plugin-completions 0.1.14 → 0.2.0

package/dist/components/bash-command.cjs

@@ -1,3 +1,6 @@
+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 __stryke_path = require("@stryke/path");
@@ -8,6 +11,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_snake_case = require("@stryke/string-format/snake-case");
 
 //#region src/components/bash-command.tsx
 /**
@@ -94,35 +98,107 @@ function BashCompletionsCommand() {
 								name: "completions",
 								type: "string",
 								get initializer() {
-									return __alloy_js_core.code`colors.white(\`\${colors.gray("###-begin-${(0, __shell_shock_core_plugin_utils.getAppBin)(context)}-completions-###")}
-
-\${colors.gray(\`
-# \${colors.bold("${(0, __shell_shock_core_plugin_utils.getAppTitle)(context)} Bash CLI command completion script")}
-#
-# \${colors.bold("Installation:")} ${(0, __shell_shock_core_plugin_utils.getAppBin)(context)} completions bash --config ~/.bashrc or ${(0, __shell_shock_core_plugin_utils.getAppBin)(context)} completions bash --script or  ${(0, __shell_shock_core_plugin_utils.getAppBin)(context)} completions bash >> ~/.bashrc or ${(0, __shell_shock_core_plugin_utils.getAppBin)(context)} completions bash >> ~/.bash_profile on OSX. \`
-)}
-\${colors.cyan("_${(0, __shell_shock_core_plugin_utils.getAppBin)(context)}_completions()")}
-{
-    local cur_word args type_list
-
-    cur_word="\\\${COMP_WORDS[COMP_CWORD]}"
-    args=("\\\${COMP_WORDS[@]}")
-
-    \${colors.gray("# Ask ${(0, __shell_shock_core_plugin_utils.getAppTitle)(context)} CLI to generate completions.")}
-    mapfile -t type_list < <(${(0, __shell_shock_core_plugin_utils.getAppBin)(context)} --get-completions "\\\${args[@]}")
-    mapfile -t COMPREPLY < <(compgen -W "$( printf '%q ' "\\\${type_list[@]}" )" -- "\\\${cur_word}" |
-        awk '/ / { print "\\\\""$0"\\\\"" } /^[^ ]+$/ { print $0 }')
-
-    \${colors.gray("# if no match was found, fall back to filename completion")}
-    if [ \\\${#COMPREPLY[@]} -eq 0 ]; then
-      COMPREPLY=()
+									return __alloy_js_core.code`# bash completion for ${(0, __shell_shock_core_plugin_utils.getAppTitle)(context)}
+
+# Define shell completion directives
+readonly ShellCompDirectiveError=${require_helpers_completion_directive_constants.CompletionDirective.CompletionDirectiveError}
+readonly ShellCompDirectiveNoSpace=${require_helpers_completion_directive_constants.CompletionDirective.CompletionDirectiveNoSpace}
+readonly ShellCompDirectiveNoFileComp=${require_helpers_completion_directive_constants.CompletionDirective.CompletionDirectiveNoFileComp}
+readonly ShellCompDirectiveFilterFileExt=${require_helpers_completion_directive_constants.CompletionDirective.CompletionDirectiveFilterFileExt}
+readonly ShellCompDirectiveFilterDirs=${require_helpers_completion_directive_constants.CompletionDirective.CompletionDirectiveFilterDirs}
+readonly ShellCompDirectiveKeepOrder=${require_helpers_completion_directive_constants.CompletionDirective.CompletionDirectiveKeepOrder}
+
+# Function to debug completion
+__${(0, __stryke_string_format_snake_case.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_debug() {
+    if [[ -n \${BASH_COMP_DEBUG_FILE:-} ]]; then
+        echo "$*" >> "\${BASH_COMP_DEBUG_FILE}"
+    fi
+}
+
+# Function to handle completions
+__${(0, __stryke_string_format_snake_case.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_complete() {
+    local cur prev words cword
+    _get_comp_words_by_ref -n "=:" cur prev words cword
+
+    local requestComp out directive
+
+    # Build the command to get completions
+    requestComp="${require_helpers_complete_command.exec} complete -- \${words[@]:1}"
+
+    # Add an empty parameter if the last parameter is complete
+    if [[ -z "$cur" ]]; then
+        requestComp="$requestComp ''"
+    fi
+
+    # Get completions from the program
+    out=$(eval "$requestComp" 2>/dev/null)
+
+    # Extract directive if present
+    directive=0
+    if [[ "$out" == *:* ]]; then
+        directive=\${out##*:}
+        out=\${out%:*}
     fi
 
-    return 0
+    # Process completions based on directive
+    if [[ $((directive & $ShellCompDirectiveError)) -ne 0 ]]; then
+        # Error, no completion
+        return
+    fi
+
+    # Apply directives
+    if [[ $((directive & $ShellCompDirectiveNoSpace)) -ne 0 ]]; then
+        compopt -o nospace
+    fi
+    if [[ $((directive & $ShellCompDirectiveKeepOrder)) -ne 0 ]]; then
+        compopt -o nosort
+    fi
+    if [[ $((directive & $ShellCompDirectiveNoFileComp)) -ne 0 ]]; then
+        compopt +o default
+    fi
+
+    # Handle file extension filtering
+    if [[ $((directive & $ShellCompDirectiveFilterFileExt)) -ne 0 ]]; then
+        local filter=""
+        for ext in $out; do
+            filter="$filter|$ext"
+        done
+        filter="\\.($filter)"
+        compopt -o filenames
+        COMPREPLY=( $(compgen -f -X "!$filter" -- "$cur") )
+        return
+    fi
+
+    # Handle directory filtering
+    if [[ $((directive & $ShellCompDirectiveFilterDirs)) -ne 0 ]]; then
+        compopt -o dirnames
+        COMPREPLY=( $(compgen -d -- "$cur") )
+        return
+    fi
+
+    # Process completions
+    local IFS=$'\\n'
+    local tab=$(printf '\\t')
+
+    # Parse completions with descriptions
+    local completions=()
+    while read -r comp; do
+        if [[ "$comp" == *$tab* ]]; then
+            # Split completion and description
+            local value=\${comp%%$tab*}
+            local desc=\${comp#*$tab}
+            completions+=("$value")
+        else
+            completions+=("$comp")
+        fi
+    done <<< "$out"
+
+    # Return completions
+    COMPREPLY=( $(compgen -W "\${completions[*]}" -- "$cur") )
 }
-complete -o bashdefault -o default -F _${(0, __shell_shock_core_plugin_utils.getAppBin)(context)}_completions ${(0, __shell_shock_core_plugin_utils.getAppBin)(context)}
 
-\${colors.gray("###-end-${(0, __shell_shock_core_plugin_utils.getAppBin)(context)}-completions-###")}
+# Register completion function
+complete -F __${(0, __stryke_string_format_snake_case.snakeCase)((0, __shell_shock_core_plugin_utils.getAppBin)(context))}_complete ${(0, __shell_shock_core_plugin_utils.getAppBin)(context)}
 \`); `;
 								}
 							}),

package/dist/components/bash-command.d.cts

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

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

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

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

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

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

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

package/dist/components/bash-command.mjs

@@ -1,3 +1,6 @@
+import { exec } from "../helpers/complete-command.mjs";
+import { CompletionDirective } from "../helpers/completion-directive-constants.mjs";
+import "../helpers/index.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 +11,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/snake-case";
 
 //#region src/components/bash-command.tsx
 /**
@@ -94,35 +98,107 @@ function BashCompletionsCommand() {
 								name: "completions",
 								type: "string",
 								get initializer() {
-									return code`colors.white(\`\${colors.gray("###-begin-${getAppBin(context)}-completions-###")}
-
-\${colors.gray(\`
-# \${colors.bold("${getAppTitle(context)} Bash CLI command completion script")}
-#
-# \${colors.bold("Installation:")} ${getAppBin(context)} completions bash --config ~/.bashrc or ${getAppBin(context)} completions bash --script or  ${getAppBin(context)} completions bash >> ~/.bashrc or ${getAppBin(context)} completions bash >> ~/.bash_profile on OSX. \`
-)}
-\${colors.cyan("_${getAppBin(context)}_completions()")}
-{
-    local cur_word args type_list
-
-    cur_word="\\\${COMP_WORDS[COMP_CWORD]}"
-    args=("\\\${COMP_WORDS[@]}")
-
-    \${colors.gray("# Ask ${getAppTitle(context)} CLI to generate completions.")}
-    mapfile -t type_list < <(${getAppBin(context)} --get-completions "\\\${args[@]}")
-    mapfile -t COMPREPLY < <(compgen -W "$( printf '%q ' "\\\${type_list[@]}" )" -- "\\\${cur_word}" |
-        awk '/ / { print "\\\\""$0"\\\\"" } /^[^ ]+$/ { print $0 }')
-
-    \${colors.gray("# if no match was found, fall back to filename completion")}
-    if [ \\\${#COMPREPLY[@]} -eq 0 ]; then
-      COMPREPLY=()
+									return code`# bash completion for ${getAppTitle(context)}
+
+# Define shell completion directives
+readonly ShellCompDirectiveError=${CompletionDirective.CompletionDirectiveError}
+readonly ShellCompDirectiveNoSpace=${CompletionDirective.CompletionDirectiveNoSpace}
+readonly ShellCompDirectiveNoFileComp=${CompletionDirective.CompletionDirectiveNoFileComp}
+readonly ShellCompDirectiveFilterFileExt=${CompletionDirective.CompletionDirectiveFilterFileExt}
+readonly ShellCompDirectiveFilterDirs=${CompletionDirective.CompletionDirectiveFilterDirs}
+readonly ShellCompDirectiveKeepOrder=${CompletionDirective.CompletionDirectiveKeepOrder}
+
+# Function to debug completion
+__${snakeCase(getAppBin(context))}_debug() {
+    if [[ -n \${BASH_COMP_DEBUG_FILE:-} ]]; then
+        echo "$*" >> "\${BASH_COMP_DEBUG_FILE}"
+    fi
+}
+
+# Function to handle completions
+__${snakeCase(getAppBin(context))}_complete() {
+    local cur prev words cword
+    _get_comp_words_by_ref -n "=:" cur prev words cword
+
+    local requestComp out directive
+
+    # Build the command to get completions
+    requestComp="${exec} complete -- \${words[@]:1}"
+
+    # Add an empty parameter if the last parameter is complete
+    if [[ -z "$cur" ]]; then
+        requestComp="$requestComp ''"
+    fi
+
+    # Get completions from the program
+    out=$(eval "$requestComp" 2>/dev/null)
+
+    # Extract directive if present
+    directive=0
+    if [[ "$out" == *:* ]]; then
+        directive=\${out##*:}
+        out=\${out%:*}
     fi
 
-    return 0
+    # Process completions based on directive
+    if [[ $((directive & $ShellCompDirectiveError)) -ne 0 ]]; then
+        # Error, no completion
+        return
+    fi
+
+    # Apply directives
+    if [[ $((directive & $ShellCompDirectiveNoSpace)) -ne 0 ]]; then
+        compopt -o nospace
+    fi
+    if [[ $((directive & $ShellCompDirectiveKeepOrder)) -ne 0 ]]; then
+        compopt -o nosort
+    fi
+    if [[ $((directive & $ShellCompDirectiveNoFileComp)) -ne 0 ]]; then
+        compopt +o default
+    fi
+
+    # Handle file extension filtering
+    if [[ $((directive & $ShellCompDirectiveFilterFileExt)) -ne 0 ]]; then
+        local filter=""
+        for ext in $out; do
+            filter="$filter|$ext"
+        done
+        filter="\\.($filter)"
+        compopt -o filenames
+        COMPREPLY=( $(compgen -f -X "!$filter" -- "$cur") )
+        return
+    fi
+
+    # Handle directory filtering
+    if [[ $((directive & $ShellCompDirectiveFilterDirs)) -ne 0 ]]; then
+        compopt -o dirnames
+        COMPREPLY=( $(compgen -d -- "$cur") )
+        return
+    fi
+
+    # Process completions
+    local IFS=$'\\n'
+    local tab=$(printf '\\t')
+
+    # Parse completions with descriptions
+    local completions=()
+    while read -r comp; do
+        if [[ "$comp" == *$tab* ]]; then
+            # Split completion and description
+            local value=\${comp%%$tab*}
+            local desc=\${comp#*$tab}
+            completions+=("$value")
+        else
+            completions+=("$comp")
+        fi
+    done <<< "$out"
+
+    # Return completions
+    COMPREPLY=( $(compgen -W "\${completions[*]}" -- "$cur") )
 }
-complete -o bashdefault -o default -F _${getAppBin(context)}_completions ${getAppBin(context)}
 
-\${colors.gray("###-end-${getAppBin(context)}-completions-###")}
+# Register completion function
+complete -F __${snakeCase(getAppBin(context))}_complete ${getAppBin(context)}
 \`); `;
 								}
 							}),

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

@@ -1 +1 @@
-{"version":3,"file":"bash-command.mjs","names":["code","FunctionDeclaration","IfStatement","InterfaceDeclaration","VarDeclaration","ReflectionKind","Spacing","usePowerlines","InterfaceMember","TypescriptFile","TSDoc","TSDocDefaultValue","TSDocRemarks","getAppBin","getAppTitle","joinPaths","BashCompletionsCommand","context","_$createComponent","path","entryPath","imports","builtinImports","children","heading","name","type","string","defaultValue","optional","async","parameters","initializer","condition","_$memo"],"sources":["../../src/components/bash-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 Bash Completions commands' handler wrapper for the Shell Shock project.\n */\nexport function BashCompletionsCommand() {\n  const context = usePowerlines<CompletionsPluginContext>();\n\n  return (\n    <TypescriptFile\n      path={joinPaths(context.entryPath, \"completions\", \"bash\", \"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 Bash completions command.\" />\n      <InterfaceDeclaration export name=\"BashCompletionsOptions\">\n        <TSDoc heading=\"The path to write the completion script to.\">\n          <TSDocRemarks>{`If no extension is provided, the \\`.bash\\` extension will be used.`}</TSDocRemarks>\n          <TSDocDefaultValue\n            type={ReflectionKind.string}\n            defaultValue={`${getAppBin(context)}-completions.bash`}\n          />\n        </TSDoc>\n        <InterfaceMember name=\"script\" optional type=\"string | true\" />\n        <Spacing />\n        <TSDoc heading=\"The Bash 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 Bash configuration file include: \\\\n- \\`~/.bashrc\\` \\\\n- \\`~/.bash_profile\\``}</TSDocRemarks>\n          <TSDocDefaultValue\n            type={ReflectionKind.string}\n            defaultValue=\"~/.bashrc\"\n          />\n        </TSDoc>\n        <InterfaceMember name=\"config\" optional type=\"string | true\" />\n      </InterfaceDeclaration>\n      <Spacing />\n      <TSDoc heading=\"Handler logic for the \\`completions bash\\` command.\"></TSDoc>\n      <FunctionDeclaration\n        export\n        default\n        async\n        name=\"handler\"\n        parameters={[{ name: \"options\", type: \"BashCompletionsOptions\" }]}>\n        <VarDeclaration\n          const\n          name=\"completions\"\n          type=\"string\"\n          initializer={code`colors.white(\\`\\${colors.gray(\"###-begin-${getAppBin(context)}-completions-###\")}\n\n\\${colors.gray(\\`\n# \\${colors.bold(\"${getAppTitle(context)} Bash CLI command completion script\")}\n#\n# \\${colors.bold(\"Installation:\")} ${getAppBin(context)} completions bash --config ~/.bashrc or ${getAppBin(context)} completions bash --script or  ${getAppBin(context)} completions bash >> ~/.bashrc or ${getAppBin(context)} completions bash >> ~/.bash_profile on OSX. \\`\n)}\n\\${colors.cyan(\"_${getAppBin(context)}_completions()\")}\n{\n    local cur_word args type_list\n\n    cur_word=\"\\\\\\${COMP_WORDS[COMP_CWORD]}\"\n    args=(\"\\\\\\${COMP_WORDS[@]}\")\n\n    \\${colors.gray(\"# Ask ${getAppTitle(context)} CLI to generate completions.\")}\n    mapfile -t type_list < <(${getAppBin(context)} --get-completions \"\\\\\\${args[@]}\")\n    mapfile -t COMPREPLY < <(compgen -W \"$( printf '%q ' \"\\\\\\${type_list[@]}\" )\" -- \"\\\\\\${cur_word}\" |\n        awk '/ / { print \"\\\\\\\\\"\"$0\"\\\\\\\\\"\" } /^[^ ]+$/ { print $0 }')\n\n    \\${colors.gray(\"# if no match was found, fall back to filename completion\")}\n    if [ \\\\\\${#COMPREPLY[@]} -eq 0 ]; then\n      COMPREPLY=()\n    fi\n\n    return 0\n}\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 ? \"~/.bashrc\" : 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)} Bash 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.bash\" : options.script;\n          await writeFile(outputPath, stripAnsi(completions));\n\n          success(\\`${getAppTitle(context)} Bash 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":"bash-command.mjs","names":["code","FunctionDeclaration","IfStatement","InterfaceDeclaration","VarDeclaration","ReflectionKind","Spacing","usePowerlines","InterfaceMember","TypescriptFile","TSDoc","TSDocDefaultValue","TSDocRemarks","getAppBin","getAppTitle","joinPaths","snakeCase","CompletionDirective","exec","BashCompletionsCommand","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/bash-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/snake-case\";\nimport { CompletionDirective } from \"../helpers\";\nimport { exec } from \"../helpers/complete-command\";\nimport type { CompletionsPluginContext } from \"../types/plugin\";\n\n/**\n * The Bash Completions commands' handler wrapper for the Shell Shock project.\n */\nexport function BashCompletionsCommand() {\n  const context = usePowerlines<CompletionsPluginContext>();\n\n  return (\n    <TypescriptFile\n      path={joinPaths(context.entryPath, \"completions\", \"bash\", \"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 Bash completions command.\" />\n      <InterfaceDeclaration export name=\"BashCompletionsOptions\">\n        <TSDoc heading=\"The path to write the completion script to.\">\n          <TSDocRemarks>{`If no extension is provided, the \\`.bash\\` extension will be used.`}</TSDocRemarks>\n          <TSDocDefaultValue\n            type={ReflectionKind.string}\n            defaultValue={`${getAppBin(context)}-completions.bash`}\n          />\n        </TSDoc>\n        <InterfaceMember name=\"script\" optional type=\"string | true\" />\n        <Spacing />\n        <TSDoc heading=\"The Bash 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 Bash configuration file include: \\\\n- \\`~/.bashrc\\` \\\\n- \\`~/.bash_profile\\``}</TSDocRemarks>\n          <TSDocDefaultValue\n            type={ReflectionKind.string}\n            defaultValue=\"~/.bashrc\"\n          />\n        </TSDoc>\n        <InterfaceMember name=\"config\" optional type=\"string | true\" />\n      </InterfaceDeclaration>\n      <Spacing />\n      <TSDoc heading=\"Handler logic for the \\`completions bash\\` command.\"></TSDoc>\n      <FunctionDeclaration\n        export\n        default\n        async\n        name=\"handler\"\n        parameters={[{ name: \"options\", type: \"BashCompletionsOptions\" }]}>\n        <VarDeclaration\n          const\n          name=\"completions\"\n          type=\"string\"\n          initializer={code`# bash completion for ${getAppTitle(context)}\n\n# Define shell completion directives\nreadonly ShellCompDirectiveError=${CompletionDirective.CompletionDirectiveError}\nreadonly ShellCompDirectiveNoSpace=${\n            CompletionDirective.CompletionDirectiveNoSpace\n          }\nreadonly ShellCompDirectiveNoFileComp=${\n            CompletionDirective.CompletionDirectiveNoFileComp\n          }\nreadonly ShellCompDirectiveFilterFileExt=${\n            CompletionDirective.CompletionDirectiveFilterFileExt\n          }\nreadonly ShellCompDirectiveFilterDirs=${\n            CompletionDirective.CompletionDirectiveFilterDirs\n          }\nreadonly ShellCompDirectiveKeepOrder=${\n            CompletionDirective.CompletionDirectiveKeepOrder\n          }\n\n# Function to debug completion\n__${snakeCase(getAppBin(context))}_debug() {\n    if [[ -n \\${BASH_COMP_DEBUG_FILE:-} ]]; then\n        echo \"$*\" >> \"\\${BASH_COMP_DEBUG_FILE}\"\n    fi\n}\n\n# Function to handle completions\n__${snakeCase(getAppBin(context))}_complete() {\n    local cur prev words cword\n    _get_comp_words_by_ref -n \"=:\" cur prev words cword\n\n    local requestComp out directive\n\n    # Build the command to get completions\n    requestComp=\"${exec} complete -- \\${words[@]:1}\"\n\n    # Add an empty parameter if the last parameter is complete\n    if [[ -z \"$cur\" ]]; then\n        requestComp=\"$requestComp ''\"\n    fi\n\n    # Get completions from the program\n    out=$(eval \"$requestComp\" 2>/dev/null)\n\n    # Extract directive if present\n    directive=0\n    if [[ \"$out\" == *:* ]]; then\n        directive=\\${out##*:}\n        out=\\${out%:*}\n    fi\n\n    # Process completions based on directive\n    if [[ $((directive & $ShellCompDirectiveError)) -ne 0 ]]; then\n        # Error, no completion\n        return\n    fi\n\n    # Apply directives\n    if [[ $((directive & $ShellCompDirectiveNoSpace)) -ne 0 ]]; then\n        compopt -o nospace\n    fi\n    if [[ $((directive & $ShellCompDirectiveKeepOrder)) -ne 0 ]]; then\n        compopt -o nosort\n    fi\n    if [[ $((directive & $ShellCompDirectiveNoFileComp)) -ne 0 ]]; then\n        compopt +o default\n    fi\n\n    # Handle file extension filtering\n    if [[ $((directive & $ShellCompDirectiveFilterFileExt)) -ne 0 ]]; then\n        local filter=\"\"\n        for ext in $out; do\n            filter=\"$filter|$ext\"\n        done\n        filter=\"\\\\.($filter)\"\n        compopt -o filenames\n        COMPREPLY=( $(compgen -f -X \"!$filter\" -- \"$cur\") )\n        return\n    fi\n\n    # Handle directory filtering\n    if [[ $((directive & $ShellCompDirectiveFilterDirs)) -ne 0 ]]; then\n        compopt -o dirnames\n        COMPREPLY=( $(compgen -d -- \"$cur\") )\n        return\n    fi\n\n    # Process completions\n    local IFS=$'\\\\n'\n    local tab=$(printf '\\\\t')\n\n    # Parse completions with descriptions\n    local completions=()\n    while read -r comp; do\n        if [[ \"$comp\" == *$tab* ]]; then\n            # Split completion and description\n            local value=\\${comp%%$tab*}\n            local desc=\\${comp#*$tab}\n            completions+=(\"$value\")\n        else\n            completions+=(\"$comp\")\n        fi\n    done <<< \"$out\"\n\n    # Return completions\n    COMPREPLY=( $(compgen -W \"\\${completions[*]}\" -- \"$cur\") )\n}\n\n# Register completion function\ncomplete -F __${snakeCase(getAppBin(context))}_complete ${getAppBin(context)}\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 ? \"~/.bashrc\" : 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)} Bash 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.bash\" : options.script;\n          await writeFile(outputPath, stripAnsi(completions));\n\n          success(\\`${getAppTitle(context)} Bash 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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"}