zod-args-parser 2.0.0-beta.0 → 2.0.0-beta.2

package/lib/esm/autocomplete-scripts/bash-autocomplete-script.js

@@ -1,2 +1,74 @@
-import{transformOptionToArgument}from"../parse/parser-utilities.js";function generateBashAutocompleteScript(n){const o=n.subcommands??[],e={};for(const n of o)e[n.name]={options:n.options?Object.keys(n.options).map(n=>transformOptionToArgument(n)):[],aliases:n.aliases??[]};let t="";for(const[n,{options:o,aliases:s}]of Object.entries(e))t+=`    ${n}${s.length>0?"|":""}${s.join("|")})\n`,t+=`      opts="${o.join(" ")}"\n`,t+="      ;;\n";if(n.options?.length){t+='    "-"*)\n',t+=`      opts="${(n.options?Object.keys(n.options).map(n=>transformOptionToArgument(n)):[]).join(" ")}"\n`,t+="      ;;\n"}return`# Auto-generated by zod-args-parser\n\n_${n.cliName}_autocomplete() {\n  local cur prev commands opts subcommand used_opts filtered_opts\n\n  cur="\${COMP_WORDS[COMP_CWORD]}"\n  prev="\${COMP_WORDS[COMP_CWORD-1]}"\n  subcommand="\${COMP_WORDS[1]}"\n\n  commands="${Object.keys(e).join(" ")}"\n\n  case "$subcommand" in\n${t}\n  esac\n\n  used_opts=""\n  if [[ " \${commands[@]} " =~ " $subcommand " ]]; then\n    for word in "\${COMP_WORDS[@]:2}"; do\n      if [[ "$word" =~ ^- ]]; then\n        used_opts+=" $word"\n      fi\n    done\n  fi\n\n  if [[ -n "$opts" ]]; then\n    filtered_opts=""\n    for opt in $opts; do\n      if [[ ! " $used_opts " =~ " $opt " ]]; then\n        filtered_opts+="$opt "\n      fi\n    done\n    COMPREPLY=( $(compgen -W "$filtered_opts" -- "$cur") )\n    return\n  fi\n\n  if [[ "\${COMP_CWORD}" -eq 1 ]]; then\n    COMPREPLY=( $(compgen -W "$commands" -- "$cur") )\n  fi\n}\n\ncomplete -F _${n.cliName}_autocomplete ${n.cliName}\n`}export{generateBashAutocompleteScript};
-//# sourceMappingURL=bash-autocomplete-script.js.map
+// src/autocomplete-scripts/bash-autocomplete-script.ts
+import { transformOptionToArgument } from "../parse/parser-utilities.js";
+function generateBashAutocompleteScript(cliDefinition) {
+  const subcommands = cliDefinition.subcommands ?? [];
+  const mappedCommands = {};
+  for (const subcommand of subcommands) {
+    mappedCommands[subcommand.name] = {
+      options: subcommand.options ? Object.keys(subcommand.options).map((key) => transformOptionToArgument(key)) : [],
+      aliases: subcommand.aliases ?? []
+    };
+  }
+  let switchCase = "";
+  for (const [name, { options, aliases }] of Object.entries(mappedCommands)) {
+    const caseNames = [name, ...aliases];
+    switchCase += `    ${caseNames.join("|")})
+`;
+    switchCase += `      opts="${options.join(" ")}"
+`;
+    switchCase += "      ;;\n";
+  }
+  const globalOptions = cliDefinition.options ? Object.keys(cliDefinition.options).map((key) => transformOptionToArgument(key)) : [];
+  if (globalOptions.length > 0) {
+    switchCase += `    *)
+`;
+    switchCase += `      opts="${globalOptions.join(" ")}"
+`;
+    switchCase += "      ;;\n";
+  }
+  return `# Auto-generated by zod-args-parser
+
+_${cliDefinition.cliName}_autocomplete() {
+  local cur prev commands opts subcommand used_opts filtered_opts
+
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  prev="\${COMP_WORDS[COMP_CWORD-1]}"
+  subcommand="\${COMP_WORDS[1]}"
+
+  commands="${Object.keys(mappedCommands).join(" ")}"
+
+  case "$subcommand" in
+${switchCase}  esac
+
+  used_opts=""
+  if [[ " \${commands[@]} " =~ " $subcommand " ]]; then
+    for word in "\${COMP_WORDS[@]:2}"; do
+      if [[ "$word" =~ ^- ]]; then
+        used_opts+=" $word"
+      fi
+    done
+  fi
+
+  if [[ -n "$opts" ]]; then
+    filtered_opts=""
+    for opt in $opts; do
+      if [[ ! " $used_opts " =~ " $opt " ]]; then
+        filtered_opts+="$opt "
+      fi
+    done
+    COMPREPLY=( $(compgen -W "$filtered_opts" -- "$cur") )
+    return
+  fi
+
+  if [[ "\${COMP_CWORD}" -eq 1 ]]; then
+    COMPREPLY=( $(compgen -W "$commands" -- "$cur") )
+  fi
+}
+
+complete -F _${cliDefinition.cliName}_autocomplete ${cliDefinition.cliName}
+`;
+}
+export {
+  generateBashAutocompleteScript
+};
+//# sourceMappingURL=bash-autocomplete-script.js.map

package/lib/esm/autocomplete-scripts/bash-autocomplete-script.js.map

@@ -1 +1,7 @@
-{"version":3,"names":["transformOptionToArgument","generateBashAutocompleteScript","cliDefinition","subcommands","mappedCommands","subcommand","name","options","Object","keys","map","key","aliases","switchCase","entries","length","join","cliName"],"sources":["../../../src/autocomplete-scripts/bash-autocomplete-script.ts"],"sourcesContent":["import { transformOptionToArgument } from \"../parse/parser-utilities.ts\";\n\nimport type { Cli } from \"../types/definitions-types.ts\";\n\n/**\n * - Generate bash autocomplete script for your CLI\n * - The generated script should be added to your `.bash_profile` or `.bashrc` file:\n *\n *   - Run: `nano $HOME/.bash_profile` or `nano $HOME/.bashrc`\n *   - Add the following line: `source <generated script path>`\n *   - Save and reopen bash to take effect\n */\nexport function generateBashAutocompleteScript(cliDefinition: Cli): string {\n  const subcommands = cliDefinition.subcommands ?? [];\n\n  type MappedCommands = Record<string, { options: string[]; aliases: string[] }>;\n\n  const mappedCommands: MappedCommands = {};\n\n  for (const subcommand of subcommands) {\n    mappedCommands[subcommand.name] = {\n      options: subcommand.options ? Object.keys(subcommand.options).map(key => transformOptionToArgument(key)) : [],\n      aliases: subcommand.aliases ?? [],\n    };\n  }\n\n  let switchCase = \"\";\n  for (const [key, { options, aliases }] of Object.entries(mappedCommands)) {\n    switchCase += `    ${key}${aliases.length > 0 ? \"|\" : \"\"}${aliases.join(\"|\")})\\n`;\n    switchCase += `      opts=\"${options.join(\" \")}\"\\n`;\n    switchCase += \"      ;;\\n\";\n  }\n\n  if (cliDefinition.options?.length) {\n    const optionsNames = cliDefinition.options\n      ? Object.keys(cliDefinition.options).map(key => transformOptionToArgument(key))\n      : [];\n    switchCase += `    \"-\"*)\\n`;\n    switchCase += `      opts=\"${optionsNames.join(\" \")}\"\\n`;\n    switchCase += \"      ;;\\n\";\n  }\n\n  return `# Auto-generated by zod-args-parser\n\n_${cliDefinition.cliName}_autocomplete() {\n  local cur prev commands opts subcommand used_opts filtered_opts\n\n  cur=\"\\${COMP_WORDS[COMP_CWORD]}\"\n  prev=\"\\${COMP_WORDS[COMP_CWORD-1]}\"\n  subcommand=\"\\${COMP_WORDS[1]}\"\n\n  commands=\"${Object.keys(mappedCommands).join(\" \")}\"\n\n  case \"$subcommand\" in\n${switchCase}\n  esac\n\n  used_opts=\"\"\n  if [[ \" \\${commands[@]} \" =~ \" $subcommand \" ]]; then\n    for word in \"\\${COMP_WORDS[@]:2}\"; do\n      if [[ \"$word\" =~ ^- ]]; then\n        used_opts+=\" $word\"\n      fi\n    done\n  fi\n\n  if [[ -n \"$opts\" ]]; then\n    filtered_opts=\"\"\n    for opt in $opts; do\n      if [[ ! \" $used_opts \" =~ \" $opt \" ]]; then\n        filtered_opts+=\"$opt \"\n      fi\n    done\n    COMPREPLY=( $(compgen -W \"$filtered_opts\" -- \"$cur\") )\n    return\n  fi\n\n  if [[ \"\\${COMP_CWORD}\" -eq 1 ]]; then\n    COMPREPLY=( $(compgen -W \"$commands\" -- \"$cur\") )\n  fi\n}\n\ncomplete -F _${cliDefinition.cliName}_autocomplete ${cliDefinition.cliName}\n`;\n}\n"],"mappings":"OAASA,8BAAiC,+BAYnC,SAASC,+BAA+BC,GAC7C,MAAMC,EAAcD,EAAcC,aAAe,GAI3CC,EAAiC,CAAC,EAExC,UAAWC,KAAcF,EACvBC,EAAeC,EAAWC,MAAQ,CAChCC,QAASF,EAAWE,QAAUC,OAAOC,KAAKJ,EAAWE,SAASG,IAAIC,GAAOX,0BAA0BW,IAAQ,GAC3GC,QAASP,EAAWO,SAAW,IAInC,IAAIC,EAAa,GACjB,UAAYF,GAAKJ,QAAEA,EAAAK,QAASA,MAAcJ,OAAOM,QAAQV,GACvDS,GAAc,OAAOF,IAAMC,EAAQG,OAAS,EAAI,IAAM,KAAKH,EAAQI,KAAK,UACxEH,GAAc,eAAeN,EAAQS,KAAK,UAC1CH,GAAc,aAGhB,GAAIX,EAAcK,SAASQ,OAAQ,CAIjCF,GAAc,cACdA,GAAc,gBAJOX,EAAcK,QAC/BC,OAAOC,KAAKP,EAAcK,SAASG,IAAIC,GAAOX,0BAA0BW,IACxE,IAEsCK,KAAK,UAC/CH,GAAc,YAChB,CAEA,MAAO,2CAENX,EAAce,6NAOHT,OAAOC,KAAKL,GAAgBY,KAAK,qCAG7CH,6lBA4BaX,EAAce,wBAAwBf,EAAce,WAEnE,Q","ignoreList":[]}
+{
+  "version": 3,
+  "sources": ["../../../src/autocomplete-scripts/bash-autocomplete-script.ts"],
+  "sourcesContent": ["import { transformOptionToArgument } from \"../parse/parser-utilities.ts\";\n\nimport type { Cli } from \"../types/definitions-types.ts\";\n\n/**\n * - Generate bash autocomplete script for your CLI\n * - The generated script should be added to your `.bash_profile` or `.bashrc` file:\n *\n *   - Run: `nano $HOME/.bash_profile` or `nano $HOME/.bashrc`\n *   - Add the following line: `source <generated script path>`\n *   - Save and reopen bash to take effect\n */\nexport function generateBashAutocompleteScript(cliDefinition: Cli): string {\n  const subcommands = cliDefinition.subcommands ?? [];\n  type MappedCommands = Record<string, { options: string[]; aliases: string[] }>;\n\n  // Map subcommands to options + aliases\n  const mappedCommands: MappedCommands = {};\n  for (const subcommand of subcommands) {\n    mappedCommands[subcommand.name] = {\n      options: subcommand.options ? Object.keys(subcommand.options).map(key => transformOptionToArgument(key)) : [],\n      aliases: subcommand.aliases ?? [],\n    };\n  }\n\n  // Generate switch-case block for subcommands + aliases\n  let switchCase = \"\";\n  for (const [name, { options, aliases }] of Object.entries(mappedCommands)) {\n    const caseNames = [name, ...aliases];\n    switchCase += `    ${caseNames.join(\"|\")})\\n`;\n    switchCase += `      opts=\"${options.join(\" \")}\"\\n`;\n    switchCase += \"      ;;\\n\";\n  }\n\n  // Include global CLI options in a default case\n  const globalOptions = cliDefinition.options\n    ? Object.keys(cliDefinition.options).map(key => transformOptionToArgument(key))\n    : [];\n\n  if (globalOptions.length > 0) {\n    switchCase += `    *)\\n`;\n    switchCase += `      opts=\"${globalOptions.join(\" \")}\"\\n`;\n    switchCase += \"      ;;\\n\";\n  }\n\n  return `# Auto-generated by zod-args-parser\n\n_${cliDefinition.cliName}_autocomplete() {\n  local cur prev commands opts subcommand used_opts filtered_opts\n\n  cur=\"\\${COMP_WORDS[COMP_CWORD]}\"\n  prev=\"\\${COMP_WORDS[COMP_CWORD-1]}\"\n  subcommand=\"\\${COMP_WORDS[1]}\"\n\n  commands=\"${Object.keys(mappedCommands).join(\" \")}\"\n\n  case \"$subcommand\" in\n${switchCase}  esac\n\n  used_opts=\"\"\n  if [[ \" \\${commands[@]} \" =~ \" $subcommand \" ]]; then\n    for word in \"\\${COMP_WORDS[@]:2}\"; do\n      if [[ \"$word\" =~ ^- ]]; then\n        used_opts+=\" $word\"\n      fi\n    done\n  fi\n\n  if [[ -n \"$opts\" ]]; then\n    filtered_opts=\"\"\n    for opt in $opts; do\n      if [[ ! \" $used_opts \" =~ \" $opt \" ]]; then\n        filtered_opts+=\"$opt \"\n      fi\n    done\n    COMPREPLY=( $(compgen -W \"$filtered_opts\" -- \"$cur\") )\n    return\n  fi\n\n  if [[ \"\\${COMP_CWORD}\" -eq 1 ]]; then\n    COMPREPLY=( $(compgen -W \"$commands\" -- \"$cur\") )\n  fi\n}\n\ncomplete -F _${cliDefinition.cliName}_autocomplete ${cliDefinition.cliName}\n`;\n}\n"],
+  "mappings": ";AAAA,SAAS,iCAAiC;AAYnC,SAAS,+BAA+B,eAA4B;AACzE,QAAM,cAAc,cAAc,eAAe,CAAC;AAIlD,QAAM,iBAAiC,CAAC;AACxC,aAAW,cAAc,aAAa;AACpC,mBAAe,WAAW,IAAI,IAAI;AAAA,MAChC,SAAS,WAAW,UAAU,OAAO,KAAK,WAAW,OAAO,EAAE,IAAI,SAAO,0BAA0B,GAAG,CAAC,IAAI,CAAC;AAAA,MAC5G,SAAS,WAAW,WAAW,CAAC;AAAA,IAClC;AAAA,EACF;AAGA,MAAI,aAAa;AACjB,aAAW,CAAC,MAAM,EAAE,SAAS,QAAQ,CAAC,KAAK,OAAO,QAAQ,cAAc,GAAG;AACzE,UAAM,YAAY,CAAC,MAAM,GAAG,OAAO;AACnC,kBAAc,OAAO,UAAU,KAAK,GAAG,CAAC;AAAA;AACxC,kBAAc,eAAe,QAAQ,KAAK,GAAG,CAAC;AAAA;AAC9C,kBAAc;AAAA,EAChB;AAGA,QAAM,gBAAgB,cAAc,UAChC,OAAO,KAAK,cAAc,OAAO,EAAE,IAAI,SAAO,0BAA0B,GAAG,CAAC,IAC5E,CAAC;AAEL,MAAI,cAAc,SAAS,GAAG;AAC5B,kBAAc;AAAA;AACd,kBAAc,eAAe,cAAc,KAAK,GAAG,CAAC;AAAA;AACpD,kBAAc;AAAA,EAChB;AAEA,SAAO;AAAA;AAAA,GAEN,cAAc,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,cAOV,OAAO,KAAK,cAAc,EAAE,KAAK,GAAG,CAAC;AAAA;AAAA;AAAA,EAGjD,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,eA2BG,cAAc,OAAO,iBAAiB,cAAc,OAAO;AAAA;AAE1E;",
+  "names": []
+}

package/lib/esm/autocomplete-scripts/powershell-autocomplete-script.js

@@ -1,2 +1,90 @@
-import{transformOptionToArgument}from"../parse/parser-utilities.js";function generatePowerShellAutocompleteScript(e){const n=e.subcommands??[],t=e.meta??{},o={};for(const e of n)o[e.name]={options:e.options?Object.keys(e.options).map(e=>transformOptionToArgument(e)):[],aliases:e.aliases??[]};const a=Object.keys(o).map(e=>`'${e}'`).join(", "),m=(e.options?Object.keys(e.options).map(e=>transformOptionToArgument(e)):[]).map(e=>`'${e}'`).join(", ");let r="switch ($subcommand) {\n";for(const[e,{options:n,aliases:t}]of Object.entries(o)){const o=n.map(e=>`'${e}'`).join(", ");r+=`        '${e}' { @(${o}) }\n`;for(const e of t)r+=`        '${e}' { @(${o}) }\n`}r+=`        default { @(${m}) }\n    }`;const s=t.description??t.descriptionMarkdown;let i="";return s&&(i=`<#\n.DESCRIPTION\n${s}\n${t.example?`\n.EXAMPLE\n${t.example}`:""}\n#>`),`# Auto-generated by zod-args-parser\n\n${i}\nfunction ${e.cliName} {\n    param(\n        [Parameter(Position = 0, Mandatory = $false)]\n        [string]$subcommand,\n        [Parameter(Position = 1, ValueFromRemainingArguments = $true)]\n        [string[]]$arguments\n    )\n    $scriptPath = (Get-Command '${e.cliName}.ps1').Source\n    if ($scriptPath) {\n        $argumentList = @($subcommand) + ($arguments | Where-Object { $_ -notin '--', '--%' }) | Where-Object { $_ -ne '' }\n        & $scriptPath @argumentList\n        return\n    }\n    Write-Error "Could not find '${e.cliName}.ps1' script"\n}\n\nRegister-ArgumentCompleter -CommandName '${e.cliName}' -ParameterName 'subcommand' -ScriptBlock {\n    param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameters)\n    $subcommands = @(${a}${a&&m?", ":""}${m})\n    $subcommands | Where-Object { $_ -like "$wordToComplete*" }\n}\n\nRegister-ArgumentCompleter -CommandName '${e.cliName}' -ParameterName 'arguments' -ScriptBlock {\n    param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameters)\n    $subcommand = $commandAst.CommandElements[1].Value\n    $arguments = ${r}\n    $arguments | Where-Object { $_ -like "$wordToComplete*" }\n}`}export{generatePowerShellAutocompleteScript};
-//# sourceMappingURL=powershell-autocomplete-script.js.map
+// src/autocomplete-scripts/powershell-autocomplete-script.ts
+import { transformOptionToArgument } from "../parse/parser-utilities.js";
+function generatePowerShellAutocompleteScript(cliDefinition) {
+  const subcommands = cliDefinition.subcommands ?? [];
+  const meta = cliDefinition.meta ?? {};
+  const mappedCommands = {};
+  for (const subcommand of subcommands) {
+    const options = [];
+    if (subcommand.options) {
+      for (const key of Object.keys(subcommand.options)) {
+        options.push(transformOptionToArgument(key));
+      }
+    }
+    const aliases = subcommand.aliases ?? [];
+    mappedCommands[subcommand.name] = { options, aliases };
+  }
+  const subcommandsString = Object.keys(mappedCommands).map((key) => `'${key}'`).join(", ");
+  const cliOptions = [];
+  if (cliDefinition.options) {
+    for (const key of Object.keys(cliDefinition.options)) {
+      cliOptions.push(transformOptionToArgument(key));
+    }
+  }
+  const cliOptionsString = cliOptions.map((opt) => `'${opt}'`).join(", ");
+  let switchCase = "switch ($subcommand) {\n";
+  for (const commandName in mappedCommands) {
+    const data = mappedCommands[commandName];
+    const optionsString = data.options.map((opt) => `'${opt}'`).join(", ");
+    switchCase += `        '${commandName}' { @(${optionsString}) }
+`;
+    for (const alias of data.aliases) {
+      switchCase += `        '${alias}' { @(${optionsString}) }
+`;
+    }
+  }
+  switchCase += `        default { @(${cliOptionsString}) }
+    }`;
+  let commentBlock = "";
+  if (meta.description || meta.example) {
+    commentBlock = "<#\n";
+    if (meta.description || meta.descriptionMarkdown) {
+      commentBlock += `.DESCRIPTION
+${meta.description ?? meta.descriptionMarkdown}
+
+`;
+    }
+    if (meta.example) {
+      commentBlock += `.EXAMPLE
+${meta.example}
+`;
+    }
+    commentBlock += "#>";
+  }
+  const cliName = cliDefinition.cliName;
+  return `# Auto-generated by zod-args-parser
+
+${commentBlock}
+function ${cliName} {
+    param(
+        [Parameter(Position = 0, Mandatory = $false)]
+        [string]$subcommand,
+        [Parameter(Position = 1, ValueFromRemainingArguments = $true)]
+        [string[]]$arguments
+    )
+    $scriptPath = (Get-Command '${cliName}.ps1').Source
+    if ($scriptPath) {
+        $argumentList = @($subcommand) + ($arguments | Where-Object { $_ -notin '--', '--%' }) | Where-Object { $_ -ne '' }
+        & $scriptPath @argumentList
+        return
+    }
+    Write-Error "Could not find '${cliName}.ps1' script"
+}
+
+Register-ArgumentCompleter -CommandName '${cliName}' -ParameterName 'subcommand' -ScriptBlock {
+    param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameters)
+    $subcommands = @(${subcommandsString}${subcommandsString && cliOptionsString ? ", " : ""}${cliOptionsString})
+    $subcommands | Where-Object { $_ -like "$wordToComplete*" }
+}
+
+Register-ArgumentCompleter -CommandName '${cliName}' -ParameterName 'arguments' -ScriptBlock {
+    param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameters)
+    $subcommand = $commandAst.CommandElements[1].Value
+    $arguments = ${switchCase}
+    $arguments | Where-Object { $_ -like "$wordToComplete*" }
+}`;
+}
+export {
+  generatePowerShellAutocompleteScript
+};
+//# sourceMappingURL=powershell-autocomplete-script.js.map

package/lib/esm/autocomplete-scripts/powershell-autocomplete-script.js.map

@@ -1 +1,7 @@
-{"version":3,"names":["transformOptionToArgument","generatePowerShellAutocompleteScript","cliDefinition","subcommands","meta","mappedCommands","subcommand","name","options","Object","keys","map","key","aliases","subcommandsString","join","cliOptionsString","option","switchCase","entries","optionsString","a","description","descriptionMarkdown","functionInfo","example","cliName"],"sources":["../../../src/autocomplete-scripts/powershell-autocomplete-script.ts"],"sourcesContent":["import { transformOptionToArgument } from \"../parse/parser-utilities.ts\";\n\nimport type { Cli } from \"../types/definitions-types.ts\";\n\n/**\n * - Generates a PowerShell autocomplete script for your CLI.\n * - The script assumes that your CLI is available as a `.ps1` file in the environment variable. For example:\n *   `cliName.ps1`.\n * - This should return a path to your script: `(Get-Command <cliName>.ps1).Source`\n * - The generated script should be added to your `profile.ps1` file:\n *\n *   - Run: `notepad $profile`\n *   - Add the following line: `. \"<generated script path>\"`\n *   - Save and reopen powershell to take effect\n */\nexport function generatePowerShellAutocompleteScript(cliDefinition: Cli): string {\n  const subcommands = cliDefinition.subcommands ?? [];\n  const meta = cliDefinition.meta ?? {};\n\n  type MappedCommands = Record<string, { options: string[]; aliases: string[] }>;\n\n  const mappedCommands: MappedCommands = {};\n\n  for (const subcommand of subcommands) {\n    mappedCommands[subcommand.name] = {\n      options: subcommand.options ? Object.keys(subcommand.options).map(key => transformOptionToArgument(key)) : [],\n      aliases: subcommand.aliases ?? [],\n    };\n  }\n\n  const subcommandsString = Object.keys(mappedCommands)\n    .map(key => `'${key}'`)\n    .join(\", \");\n\n  const optionsNames = cliDefinition.options\n    ? Object.keys(cliDefinition.options).map(key => transformOptionToArgument(key))\n    : [];\n  const cliOptionsString = optionsNames.map(option => `'${option}'`).join(\", \");\n\n  let switchCase = \"switch ($subcommand) {\\n\";\n  for (const [key, { options, aliases }] of Object.entries(mappedCommands)) {\n    const optionsString = options.map(option => `'${option}'`).join(\", \");\n    switchCase += `        '${key}' { @(${optionsString}) }\\n`;\n    for (const a of aliases) {\n      switchCase += `        '${a}' { @(${optionsString}) }\\n`;\n    }\n  }\n  switchCase += `        default { @(${cliOptionsString}) }\\n    }`;\n\n  const description = meta.description ?? meta.descriptionMarkdown;\n\n  let functionInfo = \"\";\n  if (description) {\n    functionInfo = `<#\\n.DESCRIPTION\\n${description}\\n${meta.example ? `\\n.EXAMPLE\\n${meta.example}` : \"\"}\\n#>`;\n  }\n\n  return `# Auto-generated by zod-args-parser\n\n${functionInfo}\nfunction ${cliDefinition.cliName} {\n    param(\n        [Parameter(Position = 0, Mandatory = $false)]\n        [string]$subcommand,\n        [Parameter(Position = 1, ValueFromRemainingArguments = $true)]\n        [string[]]$arguments\n    )\n    $scriptPath = (Get-Command '${cliDefinition.cliName}.ps1').Source\n    if ($scriptPath) {\n        $argumentList = @($subcommand) + ($arguments | Where-Object { $_ -notin '--', '--%' }) | Where-Object { $_ -ne '' }\n        & $scriptPath @argumentList\n        return\n    }\n    Write-Error \"Could not find '${cliDefinition.cliName}.ps1' script\"\n}\n\nRegister-ArgumentCompleter -CommandName '${cliDefinition.cliName}' -ParameterName 'subcommand' -ScriptBlock {\n    param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameters)\n    $subcommands = @(${subcommandsString}${subcommandsString && cliOptionsString ? \", \" : \"\"}${cliOptionsString})\n    $subcommands | Where-Object { $_ -like \"$wordToComplete*\" }\n}\n\nRegister-ArgumentCompleter -CommandName '${cliDefinition.cliName}' -ParameterName 'arguments' -ScriptBlock {\n    param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameters)\n    $subcommand = $commandAst.CommandElements[1].Value\n    $arguments = ${switchCase}\n    $arguments | Where-Object { $_ -like \"$wordToComplete*\" }\n}`;\n}\n"],"mappings":"OAASA,8BAAiC,+BAenC,SAASC,qCAAqCC,GACnD,MAAMC,EAAcD,EAAcC,aAAe,GAC3CC,EAAOF,EAAcE,MAAQ,CAAC,EAI9BC,EAAiC,CAAC,EAExC,UAAWC,KAAcH,EACvBE,EAAeC,EAAWC,MAAQ,CAChCC,QAASF,EAAWE,QAAUC,OAAOC,KAAKJ,EAAWE,SAASG,IAAIC,GAAOZ,0BAA0BY,IAAQ,GAC3GC,QAASP,EAAWO,SAAW,IAInC,MAAMC,EAAoBL,OAAOC,KAAKL,GACnCM,IAAIC,GAAO,IAAIA,MACfG,KAAK,MAKFC,GAHed,EAAcM,QAC/BC,OAAOC,KAAKR,EAAcM,SAASG,IAAIC,GAAOZ,0BAA0BY,IACxE,IACkCD,IAAIM,GAAU,IAAIA,MAAWF,KAAK,MAExE,IAAIG,EAAa,2BACjB,UAAYN,GAAKJ,QAAEA,EAAAK,QAASA,MAAcJ,OAAOU,QAAQd,GAAiB,CACxE,MAAMe,EAAgBZ,EAAQG,IAAIM,GAAU,IAAIA,MAAWF,KAAK,MAChEG,GAAc,YAAYN,UAAYQ,SACtC,UAAWC,KAAKR,EACdK,GAAc,YAAYG,UAAUD,QAExC,CACAF,GAAc,uBAAuBF,cAErC,MAAMM,EAAclB,EAAKkB,aAAelB,EAAKmB,oBAE7C,IAAIC,EAAe,GAKnB,OAJIF,IACFE,EAAe,qBAAqBF,MAAgBlB,EAAKqB,QAAU,eAAerB,EAAKqB,UAAY,UAG9F,0CAEPD,eACStB,EAAcwB,4PAOSxB,EAAcwB,2QAMbxB,EAAcwB,uEAGNxB,EAAcwB,0KAElCZ,IAAoBA,GAAqBE,EAAmB,KAAO,KAAKA,sHAIpDd,EAAcwB,6NAGtCR,qEAGnB,Q","ignoreList":[]}
+{
+  "version": 3,
+  "sources": ["../../../src/autocomplete-scripts/powershell-autocomplete-script.ts"],
+  "sourcesContent": ["import { transformOptionToArgument } from \"../parse/parser-utilities.ts\";\n\nimport type { Cli } from \"../types/definitions-types.ts\";\n\n/**\n * Generates a PowerShell autocomplete script for a CLI.\n *\n * Instructions:\n *\n * - Ensure your CLI is available as a `.ps1` file in your environment. e.g., `cliName.ps1`.\n * - Add the generated script to your `profile.ps1` file:\n *\n *   1. Run: `notepad $profile`\n *   2. Add: `. \"<generated script path>\"`\n *   3. Save and reopen PowerShell\n */\nexport function generatePowerShellAutocompleteScript(cliDefinition: Cli): string {\n  const subcommands = cliDefinition.subcommands ?? [];\n  const meta = cliDefinition.meta ?? {};\n\n  interface CommandData {\n    options: string[];\n    aliases: string[];\n  }\n\n  const mappedCommands: Record<string, CommandData> = {};\n\n  // Map subcommands to their options and aliases\n  for (const subcommand of subcommands) {\n    const options: string[] = [];\n    if (subcommand.options) {\n      for (const key of Object.keys(subcommand.options)) {\n        options.push(transformOptionToArgument(key));\n      }\n    }\n\n    const aliases: string[] = subcommand.aliases ?? [];\n    mappedCommands[subcommand.name] = { options, aliases };\n  }\n\n  // Prepare string representations for subcommands and CLI global options\n  const subcommandsString = Object.keys(mappedCommands)\n    .map(key => `'${key}'`)\n    .join(\", \");\n\n  const cliOptions: string[] = [];\n  if (cliDefinition.options) {\n    for (const key of Object.keys(cliDefinition.options)) {\n      cliOptions.push(transformOptionToArgument(key));\n    }\n  }\n\n  const cliOptionsString = cliOptions.map(opt => `'${opt}'`).join(\", \");\n\n  // Build the switch-case mapping subcommands/aliases to their options\n  let switchCase = \"switch ($subcommand) {\\n\";\n  for (const commandName in mappedCommands) {\n    const data = mappedCommands[commandName];\n    const optionsString = data.options.map(opt => `'${opt}'`).join(\", \");\n\n    // Primary subcommand\n    switchCase += `        '${commandName}' { @(${optionsString}) }\\n`;\n\n    // Aliases\n    for (const alias of data.aliases) {\n      switchCase += `        '${alias}' { @(${optionsString}) }\\n`;\n    }\n  }\n\n  // Default case returns global CLI options\n  switchCase += `        default { @(${cliOptionsString}) }\\n    }`;\n\n  // Optional comment block with description/example\n  let commentBlock = \"\";\n  if (meta.description || meta.example) {\n    commentBlock = \"<#\\n\";\n\n    if (meta.description || meta.descriptionMarkdown) {\n      commentBlock += `.DESCRIPTION\\n${meta.description ?? meta.descriptionMarkdown}\\n\\n`;\n    }\n\n    if (meta.example) {\n      commentBlock += `.EXAMPLE\\n${meta.example}\\n`;\n    }\n\n    commentBlock += \"#>\";\n  }\n\n  const cliName = cliDefinition.cliName;\n\n  return `# Auto-generated by zod-args-parser\n\n${commentBlock}\nfunction ${cliName} {\n    param(\n        [Parameter(Position = 0, Mandatory = $false)]\n        [string]$subcommand,\n        [Parameter(Position = 1, ValueFromRemainingArguments = $true)]\n        [string[]]$arguments\n    )\n    $scriptPath = (Get-Command '${cliName}.ps1').Source\n    if ($scriptPath) {\n        $argumentList = @($subcommand) + ($arguments | Where-Object { $_ -notin '--', '--%' }) | Where-Object { $_ -ne '' }\n        & $scriptPath @argumentList\n        return\n    }\n    Write-Error \"Could not find '${cliName}.ps1' script\"\n}\n\nRegister-ArgumentCompleter -CommandName '${cliName}' -ParameterName 'subcommand' -ScriptBlock {\n    param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameters)\n    $subcommands = @(${subcommandsString}${subcommandsString && cliOptionsString ? \", \" : \"\"}${cliOptionsString})\n    $subcommands | Where-Object { $_ -like \"$wordToComplete*\" }\n}\n\nRegister-ArgumentCompleter -CommandName '${cliName}' -ParameterName 'arguments' -ScriptBlock {\n    param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameters)\n    $subcommand = $commandAst.CommandElements[1].Value\n    $arguments = ${switchCase}\n    $arguments | Where-Object { $_ -like \"$wordToComplete*\" }\n}`;\n}\n"],
+  "mappings": ";AAAA,SAAS,iCAAiC;AAgBnC,SAAS,qCAAqC,eAA4B;AAC/E,QAAM,cAAc,cAAc,eAAe,CAAC;AAClD,QAAM,OAAO,cAAc,QAAQ,CAAC;AAOpC,QAAM,iBAA8C,CAAC;AAGrD,aAAW,cAAc,aAAa;AACpC,UAAM,UAAoB,CAAC;AAC3B,QAAI,WAAW,SAAS;AACtB,iBAAW,OAAO,OAAO,KAAK,WAAW,OAAO,GAAG;AACjD,gBAAQ,KAAK,0BAA0B,GAAG,CAAC;AAAA,MAC7C;AAAA,IACF;AAEA,UAAM,UAAoB,WAAW,WAAW,CAAC;AACjD,mBAAe,WAAW,IAAI,IAAI,EAAE,SAAS,QAAQ;AAAA,EACvD;AAGA,QAAM,oBAAoB,OAAO,KAAK,cAAc,EACjD,IAAI,SAAO,IAAI,GAAG,GAAG,EACrB,KAAK,IAAI;AAEZ,QAAM,aAAuB,CAAC;AAC9B,MAAI,cAAc,SAAS;AACzB,eAAW,OAAO,OAAO,KAAK,cAAc,OAAO,GAAG;AACpD,iBAAW,KAAK,0BAA0B,GAAG,CAAC;AAAA,IAChD;AAAA,EACF;AAEA,QAAM,mBAAmB,WAAW,IAAI,SAAO,IAAI,GAAG,GAAG,EAAE,KAAK,IAAI;AAGpE,MAAI,aAAa;AACjB,aAAW,eAAe,gBAAgB;AACxC,UAAM,OAAO,eAAe,WAAW;AACvC,UAAM,gBAAgB,KAAK,QAAQ,IAAI,SAAO,IAAI,GAAG,GAAG,EAAE,KAAK,IAAI;AAGnE,kBAAc,YAAY,WAAW,SAAS,aAAa;AAAA;AAG3D,eAAW,SAAS,KAAK,SAAS;AAChC,oBAAc,YAAY,KAAK,SAAS,aAAa;AAAA;AAAA,IACvD;AAAA,EACF;AAGA,gBAAc,uBAAuB,gBAAgB;AAAA;AAGrD,MAAI,eAAe;AACnB,MAAI,KAAK,eAAe,KAAK,SAAS;AACpC,mBAAe;AAEf,QAAI,KAAK,eAAe,KAAK,qBAAqB;AAChD,sBAAgB;AAAA,EAAiB,KAAK,eAAe,KAAK,mBAAmB;AAAA;AAAA;AAAA,IAC/E;AAEA,QAAI,KAAK,SAAS;AAChB,sBAAgB;AAAA,EAAa,KAAK,OAAO;AAAA;AAAA,IAC3C;AAEA,oBAAgB;AAAA,EAClB;AAEA,QAAM,UAAU,cAAc;AAE9B,SAAO;AAAA;AAAA,EAEP,YAAY;AAAA,WACH,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kCAOgB,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mCAMN,OAAO;AAAA;AAAA;AAAA,2CAGC,OAAO;AAAA;AAAA,uBAE3B,iBAAiB,GAAG,qBAAqB,mBAAmB,OAAO,EAAE,GAAG,gBAAgB;AAAA;AAAA;AAAA;AAAA,2CAIpE,OAAO;AAAA;AAAA;AAAA,mBAG/B,UAAU;AAAA;AAAA;AAG7B;",
+  "names": []
+}

package/lib/esm/autocomplete-scripts/zsh-autocomplete-script.js

@@ -1,25 +1,47 @@
-import{transformOptionToArgument}from"../parse/parser-utilities.js";function generateZshAutocompleteScript(e){const t=e.subcommands??[],a=e=>{return e.options?String.raw`${e.name})
+// src/autocomplete-scripts/zsh-autocomplete-script.ts
+import { transformOptionToArgument } from "../parse/parser-utilities.js";
+function generateZshAutocompleteScript(cliDefinition) {
+  const subcommands = cliDefinition.subcommands ?? [];
+  const generateArguments = (command) => {
+    if (!command.options) return "";
+    const arguments_ = Object.entries(command.options).map(([name, option]) => {
+      const description = option.meta?.description ?? "";
+      return `'${transformOptionToArgument(name)}[${description}]'`;
+    });
+    return arguments_.join(" \\\n            ");
+  };
+  const generateSubcommandCase = (subcommand) => {
+    return String.raw`${subcommand.name})
           _arguments \
-            ${t=e,(t.options?Object.entries(t.options).map(([e,t])=>`'${transformOptionToArgument(e)}[${t.meta?.description??""}]'`):[]).join(" \\\n            ")} \
+            ${generateArguments(subcommand)} \
             '*: :_files' \
             && ret=0
-          ;;`:"";var t};return String.raw`# Auto-generated by zod-args-parser
+          ;;`;
+  };
+  const subcommandCases = subcommands.map((cmd) => generateSubcommandCase(cmd)).filter(Boolean).join("\n        ");
+  const commandDescriptions = subcommands.map((sub) => `"${sub.name}:${sub.meta?.description ?? ""}"`).join("\n    ");
+  const globalOptions = cliDefinition.options ? Object.entries(cliDefinition.options).map(([name, option]) => {
+    const description = option.meta?.description ?? "";
+    return `'${transformOptionToArgument(name)}[${description}]'`;
+  }).join(" \\\n            ") : "";
+  const cliName = cliDefinition.cliName;
+  return String.raw`# Auto-generated by zod-args-parser
 
-_${e.cliName}_autocomplete() {
+_${cliName}_autocomplete() {
   local ret=1
 
   _arguments -C \
-    '1: :_${e.cliName}_commands' \
+    '1: :_${cliName}_commands' \
     '*:: :->subcmds' \
     && ret=0
 
   case $state in
     subcmds)
       case "$words[1]" in
-        ${t.map(e=>a(e)).filter(Boolean).join("\n        ")}
+        ${subcommandCases}
         *)
           _arguments \
-            '*: :_files' \
+            ${globalOptions ? globalOptions + " \\\n            " : ""}'*: :_files' \
             && ret=0
           ;;
       esac
@@ -28,15 +50,19 @@ _${e.cliName}_autocomplete() {
 
   return $ret
 }
-  
-_${e.cliName}_commands() {
+
+_${cliName}_commands() {
   local -a commands=(
-    ${t.map(e=>`"${e.name}:${e.meta?.description??""}"`).join("\n    ")}
+    ${commandDescriptions}
   )
 
   _describe -t subcommands 'subcommand' commands
 }
 
-compdef _${e.cliName}_autocomplete ${e.cliName}
-`}export{generateZshAutocompleteScript};
-//# sourceMappingURL=zsh-autocomplete-script.js.map
+compdef _${cliName}_autocomplete ${cliName}
+`;
+}
+export {
+  generateZshAutocompleteScript
+};
+//# sourceMappingURL=zsh-autocomplete-script.js.map

package/lib/esm/autocomplete-scripts/zsh-autocomplete-script.js.map

@@ -1 +1,7 @@
-{"version":3,"names":["transformOptionToArgument","generateZshAutocompleteScript","cliDefinition","subcommands","genSubCommand","subcommand","options","String","raw","name","command","Object","entries","map","value","meta","description","join","cliName","subCommand","filter","Boolean"],"sources":["../../../src/autocomplete-scripts/zsh-autocomplete-script.ts"],"sourcesContent":["import { transformOptionToArgument } from \"../parse/parser-utilities.ts\";\n\nimport type { Cli, Subcommand } from \"../types/definitions-types.ts\";\n\n/**\n * - Generates a ZSH autocomplete script for your CLI.\n * - The generated script should be added to your `~/.zshrc` or `~/.zsh_profile` file:\n *\n *   - Run: `nano $HOME/.zshrc` or `nano $HOME/.zsh_profile`\n *   - Add the following line: `source <generated script path>`\n *   - Save and reopen zsh to take effect\n */\nexport function generateZshAutocompleteScript(cliDefinition: Cli): string {\n  const subcommands = cliDefinition.subcommands ?? [];\n\n  const genArguments = (command: Subcommand) => {\n    const optionsNameDesc = command.options\n      ? Object.entries(command.options).map(\n          ([name, value]) => `'${transformOptionToArgument(name)}[${value.meta?.description ?? \"\"}]'`,\n        )\n      : [];\n\n    return optionsNameDesc.join(\" \\\\\\n            \");\n  };\n\n  const genSubCommand = (subcommand: Subcommand) => {\n    const options = subcommand.options;\n    if (!options) return \"\";\n    return String.raw`${subcommand.name})\n          _arguments \\\n            ${genArguments(subcommand)} \\\n            '*: :_files' \\\n            && ret=0\n          ;;`;\n  };\n\n  return String.raw`# Auto-generated by zod-args-parser\n\n_${cliDefinition.cliName}_autocomplete() {\n  local ret=1\n\n  _arguments -C \\\n    '1: :_${cliDefinition.cliName}_commands' \\\n    '*:: :->subcmds' \\\n    && ret=0\n\n  case $state in\n    subcmds)\n      case \"$words[1]\" in\n        ${subcommands\n          .map(subCommand => genSubCommand(subCommand))\n          .filter(Boolean)\n          .join(\"\\n        \")}\n        *)\n          _arguments \\\n            '*: :_files' \\\n            && ret=0\n          ;;\n      esac\n      ;;\n  esac\n\n  return $ret\n}\n  \n_${cliDefinition.cliName}_commands() {\n  local -a commands=(\n    ${subcommands.map(subcommand => `\"${subcommand.name}:${subcommand.meta?.description ?? \"\"}\"`).join(\"\\n    \")}\n  )\n\n  _describe -t subcommands 'subcommand' commands\n}\n\ncompdef _${cliDefinition.cliName}_autocomplete ${cliDefinition.cliName}\n`;\n}\n"],"mappings":"OAASA,8BAAiC,+BAYnC,SAASC,8BAA8BC,GAC5C,MAAMC,EAAcD,EAAcC,aAAe,GAY3CC,EAAiBC,IAErB,OADgBA,EAAWC,QAEpBC,OAAOC,GAAA,GAAMH,EAAWI;;cAbXC,EAeGL,GAdCK,EAAQJ,QAC5BK,OAAOC,QAAQF,EAAQJ,SAASO,IAC9B,EAAEJ,EAAMK,KAAW,IAAId,0BAA0BS,MAASK,EAAMC,MAAMC,aAAe,QAEvF,IAEmBC,KAAK;;;cAKP,GAZF,IAACP,GAqBtB,OAAOH,OAAOC,GAAA;;GAEbN,EAAcgB;;;;YAILhB,EAAcgB;;;;;;;UAOhBf,EACCU,IAAIM,GAAcf,EAAce,IAChCC,OAAOC,SACPJ,KAAK;;;;;;;;;;;;;GAabf,EAAcgB;;MAEXf,EAAYU,IAAIR,GAAc,IAAIA,EAAWI,QAAQJ,EAAWU,MAAMC,aAAe,OAAOC,KAAK;;;;;;WAM5Ff,EAAcgB,wBAAwBhB,EAAcgB;CAE/D,Q","ignoreList":[]}
+{
+  "version": 3,
+  "sources": ["../../../src/autocomplete-scripts/zsh-autocomplete-script.ts"],
+  "sourcesContent": ["import { transformOptionToArgument } from \"../parse/parser-utilities.ts\";\n\nimport type { Cli, Subcommand } from \"../types/definitions-types.ts\";\n\n/** Generates a Zsh autocomplete script for a CLI, including global options when no subcommand is provided. */\nexport function generateZshAutocompleteScript(cliDefinition: Cli): string {\n  const subcommands = cliDefinition.subcommands ?? [];\n\n  /** Generate the argument strings for a subcommand Format: 'option[description]' */\n  const generateArguments = (command: Subcommand) => {\n    if (!command.options) return \"\";\n    const arguments_ = Object.entries(command.options).map(([name, option]) => {\n      const description = option.meta?.description ?? \"\";\n      return `'${transformOptionToArgument(name)}[${description}]'`;\n    });\n    return arguments_.join(\" \\\\\\n            \");\n  };\n\n  /** Generate a case block for a subcommand */\n  const generateSubcommandCase = (subcommand: Subcommand) => {\n    return String.raw`${subcommand.name})\n          _arguments \\\n            ${generateArguments(subcommand)} \\\n            '*: :_files' \\\n            && ret=0\n          ;;`;\n  };\n\n  const subcommandCases = subcommands\n    .map(cmd => generateSubcommandCase(cmd))\n    .filter(Boolean)\n    .join(\"\\n        \");\n\n  const commandDescriptions = subcommands.map(sub => `\"${sub.name}:${sub.meta?.description ?? \"\"}\"`).join(\"\\n    \");\n\n  // Global CLI options (only used when no subcommand is provided)\n  const globalOptions = cliDefinition.options\n    ? Object.entries(cliDefinition.options)\n        .map(([name, option]) => {\n          const description = option.meta?.description ?? \"\";\n          return `'${transformOptionToArgument(name)}[${description}]'`;\n        })\n        .join(\" \\\\\\n            \")\n    : \"\";\n\n  const cliName = cliDefinition.cliName;\n\n  return String.raw`# Auto-generated by zod-args-parser\n\n_${cliName}_autocomplete() {\n  local ret=1\n\n  _arguments -C \\\n    '1: :_${cliName}_commands' \\\n    '*:: :->subcmds' \\\n    && ret=0\n\n  case $state in\n    subcmds)\n      case \"$words[1]\" in\n        ${subcommandCases}\n        *)\n          _arguments \\\n            ${globalOptions ? globalOptions + \" \\\\\\n            \" : \"\"}'*: :_files' \\\n            && ret=0\n          ;;\n      esac\n      ;;\n  esac\n\n  return $ret\n}\n\n_${cliName}_commands() {\n  local -a commands=(\n    ${commandDescriptions}\n  )\n\n  _describe -t subcommands 'subcommand' commands\n}\n\ncompdef _${cliName}_autocomplete ${cliName}\n`;\n}\n"],
+  "mappings": ";AAAA,SAAS,iCAAiC;AAKnC,SAAS,8BAA8B,eAA4B;AACxE,QAAM,cAAc,cAAc,eAAe,CAAC;AAGlD,QAAM,oBAAoB,CAAC,YAAwB;AACjD,QAAI,CAAC,QAAQ,QAAS,QAAO;AAC7B,UAAM,aAAa,OAAO,QAAQ,QAAQ,OAAO,EAAE,IAAI,CAAC,CAAC,MAAM,MAAM,MAAM;AACzE,YAAM,cAAc,OAAO,MAAM,eAAe;AAChD,aAAO,IAAI,0BAA0B,IAAI,CAAC,IAAI,WAAW;AAAA,IAC3D,CAAC;AACD,WAAO,WAAW,KAAK,mBAAmB;AAAA,EAC5C;AAGA,QAAM,yBAAyB,CAAC,eAA2B;AACzD,WAAO,OAAO,MAAM,WAAW,IAAI;AAAA;AAAA,cAEzB,kBAAkB,UAAU,CAAC;AAAA;AAAA;AAAA;AAAA,EAIzC;AAEA,QAAM,kBAAkB,YACrB,IAAI,SAAO,uBAAuB,GAAG,CAAC,EACtC,OAAO,OAAO,EACd,KAAK,YAAY;AAEpB,QAAM,sBAAsB,YAAY,IAAI,SAAO,IAAI,IAAI,IAAI,IAAI,IAAI,MAAM,eAAe,EAAE,GAAG,EAAE,KAAK,QAAQ;AAGhH,QAAM,gBAAgB,cAAc,UAChC,OAAO,QAAQ,cAAc,OAAO,EACjC,IAAI,CAAC,CAAC,MAAM,MAAM,MAAM;AACvB,UAAM,cAAc,OAAO,MAAM,eAAe;AAChD,WAAO,IAAI,0BAA0B,IAAI,CAAC,IAAI,WAAW;AAAA,EAC3D,CAAC,EACA,KAAK,mBAAmB,IAC3B;AAEJ,QAAM,UAAU,cAAc;AAE9B,SAAO,OAAO;AAAA;AAAA,GAEb,OAAO;AAAA;AAAA;AAAA;AAAA,YAIE,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,UAOT,eAAe;AAAA;AAAA;AAAA,cAGX,gBAAgB,gBAAgB,sBAAsB,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,GAUnE,OAAO;AAAA;AAAA,MAEJ,mBAAmB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,WAMd,OAAO,iBAAiB,OAAO;AAAA;AAE1C;",
+  "names": []
+}

package/lib/esm/cli-error/cli-error.js

@@ -0,0 +1,38 @@
+// src/cli-error/cli-error.ts
+import { ErrorCause } from "./error-cause.js";
+import { definitionErrorMessage } from "./error-message/definition-error-message.js";
+import { internalErrorMessage } from "./error-message/internal-error-message.js";
+import { parseErrorMessage } from "./error-message/parse-error-message.js";
+import { validationErrorMessage } from "./error-message/validation-error-message.js";
+var CliError = class _CliError extends Error {
+  code;
+  cause;
+  context;
+  constructor(options) {
+    super(options.message ?? _CliError.errorMessage(options));
+    this.cause = options.cause;
+    this.code = options.code;
+    this.context = options.context;
+  }
+  static errorMessage(options) {
+    const defaultErrorMessage = "unknown error";
+    if (options.cause === ErrorCause.Internal) {
+      return internalErrorMessage(options) ?? defaultErrorMessage;
+    }
+    if (options.cause === ErrorCause.Parse) {
+      return parseErrorMessage(options) ?? defaultErrorMessage;
+    }
+    if (options.cause === ErrorCause.Definition) {
+      return definitionErrorMessage(options) ?? defaultErrorMessage;
+    }
+    if (options.cause === ErrorCause.Validation) {
+      return validationErrorMessage(options) ?? defaultErrorMessage;
+    }
+    const executiveCheck = options;
+    return executiveCheck;
+  }
+};
+export {
+  CliError
+};
+//# sourceMappingURL=cli-error.js.map

package/lib/esm/cli-error/cli-error.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/cli-error/cli-error.ts"],
+  "sourcesContent": ["import { ErrorCause } from \"./error-cause.ts\";\nimport { definitionErrorMessage } from \"./error-message/definition-error-message.ts\";\nimport { internalErrorMessage } from \"./error-message/internal-error-message.ts\";\nimport { parseErrorMessage } from \"./error-message/parse-error-message.ts\";\nimport { validationErrorMessage } from \"./error-message/validation-error-message.ts\";\n\nimport type { CliErrorImpl, CliErrorOptionUnion } from \"../types/error-types.ts\";\n\nexport class CliError extends Error implements CliErrorImpl {\n  readonly code;\n  readonly cause;\n  readonly context;\n\n  constructor(options: CliErrorOptionUnion) {\n    super(options.message ?? CliError.errorMessage(options));\n\n    this.cause = options.cause;\n    this.code = options.code;\n    this.context = options.context;\n  }\n\n  static errorMessage(options: CliErrorOptionUnion): string {\n    const defaultErrorMessage = \"unknown error\";\n\n    if (options.cause === ErrorCause.Internal) {\n      return internalErrorMessage(options) ?? defaultErrorMessage;\n    }\n\n    if (options.cause === ErrorCause.Parse) {\n      return parseErrorMessage(options) ?? defaultErrorMessage;\n    }\n\n    if (options.cause === ErrorCause.Definition) {\n      return definitionErrorMessage(options) ?? defaultErrorMessage;\n    }\n\n    if (options.cause === ErrorCause.Validation) {\n      return validationErrorMessage(options) ?? defaultErrorMessage;\n    }\n\n    const executiveCheck: never = options;\n    return executiveCheck;\n  }\n}\n"],
+  "mappings": ";AAAA,SAAS,kBAAkB;AAC3B,SAAS,8BAA8B;AACvC,SAAS,4BAA4B;AACrC,SAAS,yBAAyB;AAClC,SAAS,8BAA8B;AAIhC,IAAM,WAAN,MAAM,kBAAiB,MAA8B;AAAA,EACjD;AAAA,EACA;AAAA,EACA;AAAA,EAET,YAAY,SAA8B;AACxC,UAAM,QAAQ,WAAW,UAAS,aAAa,OAAO,CAAC;AAEvD,SAAK,QAAQ,QAAQ;AACrB,SAAK,OAAO,QAAQ;AACpB,SAAK,UAAU,QAAQ;AAAA,EACzB;AAAA,EAEA,OAAO,aAAa,SAAsC;AACxD,UAAM,sBAAsB;AAE5B,QAAI,QAAQ,UAAU,WAAW,UAAU;AACzC,aAAO,qBAAqB,OAAO,KAAK;AAAA,IAC1C;AAEA,QAAI,QAAQ,UAAU,WAAW,OAAO;AACtC,aAAO,kBAAkB,OAAO,KAAK;AAAA,IACvC;AAEA,QAAI,QAAQ,UAAU,WAAW,YAAY;AAC3C,aAAO,uBAAuB,OAAO,KAAK;AAAA,IAC5C;AAEA,QAAI,QAAQ,UAAU,WAAW,YAAY;AAC3C,aAAO,uBAAuB,OAAO,KAAK;AAAA,IAC5C;AAEA,UAAM,iBAAwB;AAC9B,WAAO;AAAA,EACT;AACF;",
+  "names": []
+}

package/lib/esm/cli-error/error-cause.js

@@ -0,0 +1,12 @@
+// src/cli-error/error-cause.ts
+import { Enum } from "../utilities/utilities.js";
+var ErrorCause = Enum({
+  Internal: void 0,
+  Parse: void 0,
+  Validation: void 0,
+  Definition: void 0
+});
+export {
+  ErrorCause
+};
+//# sourceMappingURL=error-cause.js.map

package/lib/esm/cli-error/error-cause.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/cli-error/error-cause.ts"],
+  "sourcesContent": ["import { Enum } from \"../utilities/utilities.ts\";\n\nimport type { ErrorCauseI } from \"../types/error-types.ts\";\n\nexport const ErrorCause: { [K in keyof ErrorCauseI]: K } = Enum({\n  Internal: undefined,\n  Parse: undefined,\n  Validation: undefined,\n  Definition: undefined,\n});\n"],
+  "mappings": ";AAAA,SAAS,YAAY;AAId,IAAM,aAA8C,KAAK;AAAA,EAC9D,UAAU;AAAA,EACV,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,YAAY;AACd,CAAC;",
+  "names": []
+}

package/lib/esm/cli-error/error-code/definition-error-code.js

@@ -0,0 +1,23 @@
+// src/cli-error/error-code/definition-error-code.ts
+import { Enum } from "../../utilities/utilities.js";
+var DefinitionErrorCode = Enum({
+  MissingSchema: void 0,
+  EmptyDefinitionGroup: void 0,
+  MissingDefinitionName: void 0,
+  InvalidDefinitionOptionName: void 0,
+  InvalidDefinitionArgumentName: void 0,
+  InvalidOptionalArgumentDefinition: void 0,
+  DuplicateDefinitionName: void 0,
+  EmptyStringAliasName: void 0,
+  SelfRequire: void 0,
+  UnknownRequireName: void 0,
+  SelfConflict: void 0,
+  UnknownConflictName: void 0,
+  DefinitionRequiresConflictOverlap: void 0,
+  MissingOnExecute: void 0,
+  SubcommandHelpNotFound: void 0
+});
+export {
+  DefinitionErrorCode
+};
+//# sourceMappingURL=definition-error-code.js.map

package/lib/esm/cli-error/error-code/definition-error-code.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/cli-error/error-code/definition-error-code.ts"],
+  "sourcesContent": ["import { Enum } from \"../../utilities/utilities.ts\";\n\nimport type { DefinitionErrorI } from \"../../types/error-types.ts\";\n\nexport const DefinitionErrorCode: { [K in keyof DefinitionErrorI]: K } = Enum({\n  MissingSchema: undefined,\n  EmptyDefinitionGroup: undefined,\n  MissingDefinitionName: undefined,\n  InvalidDefinitionOptionName: undefined,\n  InvalidDefinitionArgumentName: undefined,\n  InvalidOptionalArgumentDefinition: undefined,\n  DuplicateDefinitionName: undefined,\n  EmptyStringAliasName: undefined,\n  SelfRequire: undefined,\n  UnknownRequireName: undefined,\n  SelfConflict: undefined,\n  UnknownConflictName: undefined,\n  DefinitionRequiresConflictOverlap: undefined,\n  MissingOnExecute: undefined,\n  SubcommandHelpNotFound: undefined,\n});\n"],
+  "mappings": ";AAAA,SAAS,YAAY;AAId,IAAM,sBAA4D,KAAK;AAAA,EAC5E,eAAe;AAAA,EACf,sBAAsB;AAAA,EACtB,uBAAuB;AAAA,EACvB,6BAA6B;AAAA,EAC7B,+BAA+B;AAAA,EAC/B,mCAAmC;AAAA,EACnC,yBAAyB;AAAA,EACzB,sBAAsB;AAAA,EACtB,aAAa;AAAA,EACb,oBAAoB;AAAA,EACpB,cAAc;AAAA,EACd,qBAAqB;AAAA,EACrB,mCAAmC;AAAA,EACnC,kBAAkB;AAAA,EAClB,wBAAwB;AAC1B,CAAC;",
+  "names": []
+}

package/lib/esm/cli-error/error-code/internal-error-code.js

@@ -0,0 +1,10 @@
+// src/cli-error/error-code/internal-error-code.ts
+import { Enum } from "../../utilities/utilities.js";
+var InternalErrorCode = Enum({
+  MissingPreparedTypes: void 0,
+  CannotFindCliDefinition: void 0
+});
+export {
+  InternalErrorCode
+};
+//# sourceMappingURL=internal-error-code.js.map

package/lib/esm/cli-error/error-code/internal-error-code.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/cli-error/error-code/internal-error-code.ts"],
+  "sourcesContent": ["import { Enum } from \"../../utilities/utilities.ts\";\n\nimport type { InternalErrorI } from \"../../types/error-types.ts\";\n\nexport const InternalErrorCode: { [K in keyof InternalErrorI]: K } = Enum({\n  MissingPreparedTypes: undefined,\n  CannotFindCliDefinition: undefined,\n});\n"],
+  "mappings": ";AAAA,SAAS,YAAY;AAId,IAAM,oBAAwD,KAAK;AAAA,EACxE,sBAAsB;AAAA,EACtB,yBAAyB;AAC3B,CAAC;",
+  "names": []
+}

package/lib/esm/cli-error/error-code/parse-error-code.js

@@ -0,0 +1,18 @@
+// src/cli-error/error-code/parse-error-code.ts
+import { Enum } from "../../utilities/utilities.js";
+var ParseErrorCode = Enum({
+  UnknownSubcommand: void 0,
+  CommandWithoutOptions: void 0,
+  UnknownOption: void 0,
+  DuplicateOptionProvided: void 0,
+  InvalidNegationForNonBooleanOption: void 0,
+  PositionalArgumentNotAllowed: void 0,
+  MissingRequiredOption: void 0,
+  MissingRequiredArgument: void 0,
+  OptionMissingValue: void 0,
+  FlagAssignedValue: void 0
+});
+export {
+  ParseErrorCode
+};
+//# sourceMappingURL=parse-error-code.js.map

package/lib/esm/cli-error/error-code/parse-error-code.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/cli-error/error-code/parse-error-code.ts"],
+  "sourcesContent": ["import { Enum } from \"../../utilities/utilities.ts\";\n\nimport type { ParseErrorI } from \"../../types/error-types.ts\";\n\nexport const ParseErrorCode: { [K in keyof ParseErrorI]: K } = Enum({\n  UnknownSubcommand: undefined,\n  CommandWithoutOptions: undefined,\n  UnknownOption: undefined,\n  DuplicateOptionProvided: undefined,\n  InvalidNegationForNonBooleanOption: undefined,\n  PositionalArgumentNotAllowed: undefined,\n  MissingRequiredOption: undefined,\n  MissingRequiredArgument: undefined,\n  OptionMissingValue: undefined,\n  FlagAssignedValue: undefined,\n});\n"],
+  "mappings": ";AAAA,SAAS,YAAY;AAId,IAAM,iBAAkD,KAAK;AAAA,EAClE,mBAAmB;AAAA,EACnB,uBAAuB;AAAA,EACvB,eAAe;AAAA,EACf,yBAAyB;AAAA,EACzB,oCAAoC;AAAA,EACpC,8BAA8B;AAAA,EAC9B,uBAAuB;AAAA,EACvB,yBAAyB;AAAA,EACzB,oBAAoB;AAAA,EACpB,mBAAmB;AACrB,CAAC;",
+  "names": []
+}

package/lib/esm/cli-error/error-code/validation-error-code.js

@@ -0,0 +1,17 @@
+// src/cli-error/error-code/validation-error-code.ts
+import { Enum } from "../../utilities/utilities.js";
+var ValidationErrorCode = Enum({
+  NoOptionsToValidate: void 0,
+  NoArgumentsToValidate: void 0,
+  UnknownOptionValidation: void 0,
+  UnknownArgumentValidation: void 0,
+  SchemaValidationFailed: void 0,
+  MutuallyExclusiveConflict: void 0,
+  RequiredDependencyMissing: void 0,
+  AsyncSchemaNotSupported: void 0,
+  CoercionFailed: void 0
+});
+export {
+  ValidationErrorCode
+};
+//# sourceMappingURL=validation-error-code.js.map

package/lib/esm/cli-error/error-code/validation-error-code.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/cli-error/error-code/validation-error-code.ts"],
+  "sourcesContent": ["import { Enum } from \"../../utilities/utilities.ts\";\n\nimport type { ValidationErrorI } from \"../../types/error-types.ts\";\n\nexport const ValidationErrorCode: { [K in keyof ValidationErrorI]: K } = Enum({\n  NoOptionsToValidate: undefined,\n  NoArgumentsToValidate: undefined,\n  UnknownOptionValidation: undefined,\n  UnknownArgumentValidation: undefined,\n  SchemaValidationFailed: undefined,\n  MutuallyExclusiveConflict: undefined,\n  RequiredDependencyMissing: undefined,\n  AsyncSchemaNotSupported: undefined,\n  CoercionFailed: undefined,\n});\n"],
+  "mappings": ";AAAA,SAAS,YAAY;AAId,IAAM,sBAA4D,KAAK;AAAA,EAC5E,qBAAqB;AAAA,EACrB,uBAAuB;AAAA,EACvB,yBAAyB;AAAA,EACzB,2BAA2B;AAAA,EAC3B,wBAAwB;AAAA,EACxB,2BAA2B;AAAA,EAC3B,2BAA2B;AAAA,EAC3B,yBAAyB;AAAA,EACzB,gBAAgB;AAClB,CAAC;",
+  "names": []
+}

package/lib/esm/cli-error/error-message/definition-error-message.js

@@ -0,0 +1,70 @@
+// src/cli-error/error-message/definition-error-message.ts
+import { DefinitionErrorCode } from "../error-code/definition-error-code.js";
+function definitionErrorMessage({ code, context }) {
+  if (code === DefinitionErrorCode.MissingDefinitionName) {
+    const propertyName = context.commandKind === "command" ? "cliName" : "name";
+    return `invalid ${context.commandKind} definition: "${propertyName}" property is required.`;
+  }
+  if (code === DefinitionErrorCode.EmptyDefinitionGroup) {
+    return `invalid ${context.commandKind} definition "${context.commandName}": "${context.kind}" property is optional but cannot be empty.`;
+  }
+  if (code === DefinitionErrorCode.MissingSchema) {
+    return `invalid ${context.commandKind} definition "${context.commandName}": the ${context.kind} "${context.name}" is missing the "schema" property.`;
+  }
+  if (code === DefinitionErrorCode.InvalidDefinitionOptionName) {
+    if (context.negatedAliasName) {
+      return `invalid ${context.commandKind} definition "${context.commandName}": the option "${context.optionName}" has the alias "${context.negatedAliasName}" which cannot be named as a negated option.`;
+    }
+    return `invalid ${context.commandKind} definition "${context.commandName}": the option "${context.optionName}" cannot be named as a negated option.`;
+  }
+  if (code === DefinitionErrorCode.InvalidDefinitionArgumentName) {
+    return `invalid ${context.commandKind} definition "${context.commandName}": the argument "${context.name}" cannot be a number..`;
+  }
+  if (code === DefinitionErrorCode.DuplicateDefinitionName) {
+    const foundIn = context.foundInName ? `conflict with the ${context.foundInKind} "${context.foundInName}" alias name` : `conflict with other ${context.foundInKind} name`;
+    if (context.duplicatedAlias) {
+      return `invalid ${context.commandKind} definition "${context.commandName}": the ${context.kind} "${context.name}" has the alias "${context.duplicatedAlias}" which ${foundIn}.`;
+    }
+    return `invalid ${context.commandKind} definition "${context.commandName}": the ${context.kind} "${context.name}" name ${foundIn}.`;
+  }
+  if (code === DefinitionErrorCode.EmptyStringAliasName) {
+    if (context.optionName) {
+      return `invalid ${context.commandKind} definition "${context.commandName}": the option "${context.optionName}" has an empty string alias name.`;
+    }
+    return `invalid ${context.commandKind} definition "${context.commandName}": empty string alias name is not allowed.`;
+  }
+  if (code === DefinitionErrorCode.SelfRequire) {
+    return `invalid ${context.commandKind} definition "${context.commandName}": the ${context.kind} "${context.name}" cannot require itself.`;
+  }
+  if (code === DefinitionErrorCode.UnknownRequireName) {
+    return `invalid ${context.commandKind} definition "${context.commandName}": the ${context.kind} "${context.name}" requires a non-existent name "${context.requiredName}".`;
+  }
+  if (code === DefinitionErrorCode.SelfConflict) {
+    return `invalid ${context.commandKind} definition "${context.commandName}": the ${context.kind} "${context.name}" cannot conflict with itself.`;
+  }
+  if (code === DefinitionErrorCode.UnknownConflictName) {
+    return `invalid ${context.commandKind} definition "${context.commandName}": the ${context.kind} "${context.name}" conflicts with a non-existent name "${context.requiredName}".`;
+  }
+  if (code === DefinitionErrorCode.DefinitionRequiresConflictOverlap) {
+    const s = context.intersectedNames.length > 1 ? "s" : "";
+    return `invalid ${context.commandKind} definition "${context.commandName}": the ${context.kind} "${context.name}" has overlapping 'requires' and 'conflictsWith' name${s}: ` + context.intersectedNames.join(", ");
+  }
+  if (code === DefinitionErrorCode.InvalidOptionalArgumentDefinition) {
+    if (context.allowPositionals) {
+      return `invalid ${context.commandKind} definition "${context.commandName}": the argument "${context.name}" cannot be optional when "allowPositionals" is enabled.`;
+    }
+    return `invalid ${context.commandKind} definition "${context.commandName}": the argument "${context.name}" cannot be optional unless it is the last argument.`;
+  }
+  if (code === DefinitionErrorCode.MissingOnExecute) {
+    return `trying to execute ${context.commandKind} "${context.commandName}" which does not have an "onExecute" handler.`;
+  }
+  if (code === DefinitionErrorCode.SubcommandHelpNotFound) {
+    return `cannot generate help message for subcommand "${context.subcommandName}" because it does not exist in CLI "${context.cliName}".`;
+  }
+  const executiveCheck = code;
+  return executiveCheck;
+}
+export {
+  definitionErrorMessage
+};
+//# sourceMappingURL=definition-error-message.js.map

package/lib/esm/cli-error/error-message/definition-error-message.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/cli-error/error-message/definition-error-message.ts"],
+  "sourcesContent": ["import { DefinitionErrorCode } from \"../error-code/definition-error-code.ts\";\n\nimport type { CliErrorOptionByCause } from \"../../types/error-types.ts\";\n\nexport function definitionErrorMessage({ code, context }: CliErrorOptionByCause<\"Definition\">) {\n  if (code === DefinitionErrorCode.MissingDefinitionName) {\n    const propertyName = context.commandKind === \"command\" ? \"cliName\" : \"name\";\n    return `invalid ${context.commandKind} definition: \"${propertyName}\" property is required.`;\n  }\n\n  if (code === DefinitionErrorCode.EmptyDefinitionGroup) {\n    return (\n      `invalid ${context.commandKind} definition \"${context.commandName}\": ` +\n      `\"${context.kind}\" property is optional but cannot be empty.`\n    );\n  }\n\n  if (code === DefinitionErrorCode.MissingSchema) {\n    return (\n      `invalid ${context.commandKind} definition \"${context.commandName}\": ` +\n      `the ${context.kind} \"${context.name}\" is missing the \"schema\" property.`\n    );\n  }\n\n  if (code === DefinitionErrorCode.InvalidDefinitionOptionName) {\n    if (context.negatedAliasName) {\n      return (\n        `invalid ${context.commandKind} definition \"${context.commandName}\": ` +\n        `the option \"${context.optionName}\" has the alias \"${context.negatedAliasName}\" which cannot be named as a negated option.`\n      );\n    }\n\n    return (\n      `invalid ${context.commandKind} definition \"${context.commandName}\": ` +\n      `the option \"${context.optionName}\" cannot be named as a negated option.`\n    );\n  }\n\n  if (code === DefinitionErrorCode.InvalidDefinitionArgumentName) {\n    return (\n      `invalid ${context.commandKind} definition \"${context.commandName}\": ` +\n      `the argument \"${context.name}\" cannot be a number..`\n    );\n  }\n\n  if (code === DefinitionErrorCode.DuplicateDefinitionName) {\n    const foundIn = context.foundInName\n      ? `conflict with the ${context.foundInKind} \"${context.foundInName}\" alias name`\n      : `conflict with other ${context.foundInKind} name`;\n\n    if (context.duplicatedAlias) {\n      return (\n        `invalid ${context.commandKind} definition \"${context.commandName}\": ` +\n        `the ${context.kind} \"${context.name}\" has the alias \"${context.duplicatedAlias}\" which ${foundIn}.`\n      );\n    }\n\n    return (\n      `invalid ${context.commandKind} definition \"${context.commandName}\": ` +\n      `the ${context.kind} \"${context.name}\" name ${foundIn}.`\n    );\n  }\n\n  if (code === DefinitionErrorCode.EmptyStringAliasName) {\n    if (context.optionName) {\n      return (\n        `invalid ${context.commandKind} definition \"${context.commandName}\": ` +\n        `the option \"${context.optionName}\" has an empty string alias name.`\n      );\n    }\n\n    return (\n      `invalid ${context.commandKind} definition \"${context.commandName}\": ` + `empty string alias name is not allowed.`\n    );\n  }\n\n  if (code === DefinitionErrorCode.SelfRequire) {\n    return (\n      `invalid ${context.commandKind} definition \"${context.commandName}\": ` +\n      `the ${context.kind} \"${context.name}\" cannot require itself.`\n    );\n  }\n\n  if (code === DefinitionErrorCode.UnknownRequireName) {\n    return (\n      `invalid ${context.commandKind} definition \"${context.commandName}\": ` +\n      `the ${context.kind} \"${context.name}\" requires a non-existent name \"${context.requiredName}\".`\n    );\n  }\n\n  if (code === DefinitionErrorCode.SelfConflict) {\n    return (\n      `invalid ${context.commandKind} definition \"${context.commandName}\": ` +\n      `the ${context.kind} \"${context.name}\" cannot conflict with itself.`\n    );\n  }\n\n  if (code === DefinitionErrorCode.UnknownConflictName) {\n    return (\n      `invalid ${context.commandKind} definition \"${context.commandName}\": ` +\n      `the ${context.kind} \"${context.name}\" conflicts with a non-existent name \"${context.requiredName}\".`\n    );\n  }\n\n  if (code === DefinitionErrorCode.DefinitionRequiresConflictOverlap) {\n    const s = context.intersectedNames.length > 1 ? \"s\" : \"\";\n    return (\n      `invalid ${context.commandKind} definition \"${context.commandName}\": ` +\n      `the ${context.kind} \"${context.name}\" has overlapping 'requires' and 'conflictsWith' name${s}: ` +\n      context.intersectedNames.join(\", \")\n    );\n  }\n\n  if (code === DefinitionErrorCode.InvalidOptionalArgumentDefinition) {\n    if (context.allowPositionals) {\n      return (\n        `invalid ${context.commandKind} definition \"${context.commandName}\": ` +\n        `the argument \"${context.name}\" cannot be optional when \"allowPositionals\" is enabled.`\n      );\n    }\n\n    return (\n      `invalid ${context.commandKind} definition \"${context.commandName}\": ` +\n      `the argument \"${context.name}\" cannot be optional unless it is the last argument.`\n    );\n  }\n\n  if (code === DefinitionErrorCode.MissingOnExecute) {\n    return (\n      `trying to execute ${context.commandKind} \"${context.commandName}\" ` +\n      `which does not have an \"onExecute\" handler.`\n    );\n  }\n\n  if (code === DefinitionErrorCode.SubcommandHelpNotFound) {\n    return (\n      `cannot generate help message for subcommand \"${context.subcommandName}\" ` +\n      `because it does not exist in CLI \"${context.cliName}\".`\n    );\n  }\n\n  const executiveCheck: never = code;\n  return executiveCheck;\n}\n"],
+  "mappings": ";AAAA,SAAS,2BAA2B;AAI7B,SAAS,uBAAuB,EAAE,MAAM,QAAQ,GAAwC;AAC7F,MAAI,SAAS,oBAAoB,uBAAuB;AACtD,UAAM,eAAe,QAAQ,gBAAgB,YAAY,YAAY;AACrE,WAAO,WAAW,QAAQ,WAAW,iBAAiB,YAAY;AAAA,EACpE;AAEA,MAAI,SAAS,oBAAoB,sBAAsB;AACrD,WACE,WAAW,QAAQ,WAAW,gBAAgB,QAAQ,WAAW,OAC7D,QAAQ,IAAI;AAAA,EAEpB;AAEA,MAAI,SAAS,oBAAoB,eAAe;AAC9C,WACE,WAAW,QAAQ,WAAW,gBAAgB,QAAQ,WAAW,UAC1D,QAAQ,IAAI,KAAK,QAAQ,IAAI;AAAA,EAExC;AAEA,MAAI,SAAS,oBAAoB,6BAA6B;AAC5D,QAAI,QAAQ,kBAAkB;AAC5B,aACE,WAAW,QAAQ,WAAW,gBAAgB,QAAQ,WAAW,kBAClD,QAAQ,UAAU,oBAAoB,QAAQ,gBAAgB;AAAA,IAEjF;AAEA,WACE,WAAW,QAAQ,WAAW,gBAAgB,QAAQ,WAAW,kBAClD,QAAQ,UAAU;AAAA,EAErC;AAEA,MAAI,SAAS,oBAAoB,+BAA+B;AAC9D,WACE,WAAW,QAAQ,WAAW,gBAAgB,QAAQ,WAAW,oBAChD,QAAQ,IAAI;AAAA,EAEjC;AAEA,MAAI,SAAS,oBAAoB,yBAAyB;AACxD,UAAM,UAAU,QAAQ,cACpB,qBAAqB,QAAQ,WAAW,KAAK,QAAQ,WAAW,iBAChE,uBAAuB,QAAQ,WAAW;AAE9C,QAAI,QAAQ,iBAAiB;AAC3B,aACE,WAAW,QAAQ,WAAW,gBAAgB,QAAQ,WAAW,UAC1D,QAAQ,IAAI,KAAK,QAAQ,IAAI,oBAAoB,QAAQ,eAAe,WAAW,OAAO;AAAA,IAErG;AAEA,WACE,WAAW,QAAQ,WAAW,gBAAgB,QAAQ,WAAW,UAC1D,QAAQ,IAAI,KAAK,QAAQ,IAAI,UAAU,OAAO;AAAA,EAEzD;AAEA,MAAI,SAAS,oBAAoB,sBAAsB;AACrD,QAAI,QAAQ,YAAY;AACtB,aACE,WAAW,QAAQ,WAAW,gBAAgB,QAAQ,WAAW,kBAClD,QAAQ,UAAU;AAAA,IAErC;AAEA,WACE,WAAW,QAAQ,WAAW,gBAAgB,QAAQ,WAAW;AAAA,EAErE;AAEA,MAAI,SAAS,oBAAoB,aAAa;AAC5C,WACE,WAAW,QAAQ,WAAW,gBAAgB,QAAQ,WAAW,UAC1D,QAAQ,IAAI,KAAK,QAAQ,IAAI;AAAA,EAExC;AAEA,MAAI,SAAS,oBAAoB,oBAAoB;AACnD,WACE,WAAW,QAAQ,WAAW,gBAAgB,QAAQ,WAAW,UAC1D,QAAQ,IAAI,KAAK,QAAQ,IAAI,mCAAmC,QAAQ,YAAY;AAAA,EAE/F;AAEA,MAAI,SAAS,oBAAoB,cAAc;AAC7C,WACE,WAAW,QAAQ,WAAW,gBAAgB,QAAQ,WAAW,UAC1D,QAAQ,IAAI,KAAK,QAAQ,IAAI;AAAA,EAExC;AAEA,MAAI,SAAS,oBAAoB,qBAAqB;AACpD,WACE,WAAW,QAAQ,WAAW,gBAAgB,QAAQ,WAAW,UAC1D,QAAQ,IAAI,KAAK,QAAQ,IAAI,yCAAyC,QAAQ,YAAY;AAAA,EAErG;AAEA,MAAI,SAAS,oBAAoB,mCAAmC;AAClE,UAAM,IAAI,QAAQ,iBAAiB,SAAS,IAAI,MAAM;AACtD,WACE,WAAW,QAAQ,WAAW,gBAAgB,QAAQ,WAAW,UAC1D,QAAQ,IAAI,KAAK,QAAQ,IAAI,wDAAwD,CAAC,OAC7F,QAAQ,iBAAiB,KAAK,IAAI;AAAA,EAEtC;AAEA,MAAI,SAAS,oBAAoB,mCAAmC;AAClE,QAAI,QAAQ,kBAAkB;AAC5B,aACE,WAAW,QAAQ,WAAW,gBAAgB,QAAQ,WAAW,oBAChD,QAAQ,IAAI;AAAA,IAEjC;AAEA,WACE,WAAW,QAAQ,WAAW,gBAAgB,QAAQ,WAAW,oBAChD,QAAQ,IAAI;AAAA,EAEjC;AAEA,MAAI,SAAS,oBAAoB,kBAAkB;AACjD,WACE,qBAAqB,QAAQ,WAAW,KAAK,QAAQ,WAAW;AAAA,EAGpE;AAEA,MAAI,SAAS,oBAAoB,wBAAwB;AACvD,WACE,gDAAgD,QAAQ,cAAc,uCACjC,QAAQ,OAAO;AAAA,EAExD;AAEA,QAAM,iBAAwB;AAC9B,SAAO;AACT;",
+  "names": []
+}