@kjanat/dreamcli 4.0.0 → 4.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/{adapter-D0hbBNVB.d.mts → adapter-YM5QGi3M.d.mts} +2 -0
- package/dist/{completion-D4mz6axB.mjs → completion-CUMeOnAz.mjs} +1 -1
- package/dist/completion.d.mts +1 -1
- package/dist/completion.mjs +1 -1
- package/dist/{config-B9ddC-Kb.mjs → config-CrlScpYX.mjs} +1 -1
- package/dist/config.d.mts +1 -1
- package/dist/config.mjs +1 -1
- package/dist/{core-Cp2w8vRq.mjs → core-DvXUolc_.mjs} +3 -3
- package/dist/{index-DyoaS234.d.mts → index-3l8uj16E.d.mts} +1 -1
- package/dist/{index-DXROeDPC.d.mts → index-BAj2y70U.d.mts} +2 -2
- package/dist/{index-DndPmT8J.d.mts → index-Cap0MA2V.d.mts} +5 -3
- package/dist/{index-DOfClfYR.d.mts → index-Cp9kt2t-.d.mts} +1 -1
- package/dist/index.d.mts +4 -4
- package/dist/index.mjs +1 -1
- package/dist/{json-schema-C9SzZ7jY.mjs → json-schema-DRlrz_IV.mjs} +1 -1
- package/dist/json-schema.d.mts +1 -1
- package/dist/json-schema.mjs +1 -1
- package/dist/prompt.mjs +1 -1
- package/dist/runtime.d.mts +2 -2
- package/dist/runtime.mjs +1 -1
- package/dist/testkit.d.mts +2 -2
- package/dist/testkit.mjs +1 -1
- package/dist/version.mjs +1 -1
- package/package.json +1 -1
- package/skills/cli-creation/SKILL.md +1 -1
|
@@ -36,6 +36,8 @@ interface RuntimeAdapter {
|
|
|
36
36
|
readonly stdout: WriteFn;
|
|
37
37
|
/** Writer for stderr. Framework routes `out.warn`/`out.error` through this. */
|
|
38
38
|
readonly stderr: WriteFn;
|
|
39
|
+
/** Wait for pending output writes to settle, rejecting with a recorded output failure. */
|
|
40
|
+
readonly flush?: () => Promise<void>;
|
|
39
41
|
/**
|
|
40
42
|
* Line reader for stdin. Used by the prompt engine for interactive input.
|
|
41
43
|
*
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import{t as __exportAll}from"./rolldown-runtime-G4Kt5YOX.mjs";import{C as flagExpectsValue,G as getFlagNegatedName,H as createFlagSchema,N as resolvePlainHelpDescription,Q as CLIError,W as getFlagAliasNames,Z as builtinEnabled,f as
|
|
1
|
+
import{t as __exportAll}from"./rolldown-runtime-G4Kt5YOX.mjs";import{C as flagExpectsValue,G as getFlagNegatedName,H as createFlagSchema,N as resolvePlainHelpDescription,Q as CLIError,W as getFlagAliasNames,Z as builtinEnabled,f as collectPropagatedFlags,u as resolveRootSurface}from"./core-DvXUolc_.mjs";import{DREAMCLI_REVISION,DREAMCLI_VERSION}from"./version.mjs";function versionTag(){let e=` (${DREAMCLI_REVISION})`;return`@kjanat/dreamcli v${DREAMCLI_VERSION}${e}`}function programTag(e){return e.version===void 0?e.name:`${e.name} v${e.version}`}function resolveRootCompletionSurface(e,t=`subcommands`){let n=resolveRootSurface(e),r=createRootFlags(builtinEnabled(e.builtins,`help`),e.version!==void 0),i=n.visibleDefaultCommand?.flags??{},a=t===`surface`?n.hasVisibleDefault:n.hasVisibleDefault&&!n.hasVisibleSubcommands,o=n.visibleDefaultCommand,s=o!==void 0&&n.visibleCommands.some(e=>e.name===o.name);return{visibleCommands:n.defaultRouted&&o!==void 0&&!s?[o,...n.visibleCommands]:n.defaultRouted?n.visibleCommands:n.visibleSubcommands,visibleDefaultCommand:n.visibleDefaultCommand,rootFlags:r,defaultFlags:i,includeDefaultFlags:a}}function createRootFlags(e,t){return{...e?{help:createSyntheticRootFlag(`Show help text`)}:{},...t?{version:createSyntheticRootFlag(`Show version`)}:{}}}function createSyntheticRootFlag(e){return createFlagSchema(`boolean`,{description:e})}function walkCommandTree(e,t=[]){let n=[];for(let r of e){if(r.hidden)continue;let e=[...t,r],i=collectPropagatedFlags(e),a={...i,...r.flags},o=r.commands.filter(e=>!e.hidden);n.push({path:e.map(e=>e.name),schema:r,propagatedFlags:i,mergedFlags:a,children:o}),o.length>0&&n.push(...walkCommandTree(o,e))}return n}function getVisibleNegatedName(e,t){if(!(t.negation===void 0||t.negation.hidden))return getFlagNegatedName(e,t)}function sanitizeShellIdentifier(e){let t=e.replace(/[^a-zA-Z0-9_]/g,`_`);if(t===e)return t;let n=2166136261;for(let t=0;t<e.length;t+=1)n^=e.charCodeAt(t),n=Math.imul(n,16777619);return`${t}_${(n>>>0).toString(16).padStart(8,`0`)}`}function quoteShellArg(e){return/^[a-zA-Z0-9_\-.]+$/.test(e)?e:`'${e.replace(/'/g,`'\\''`)}'`}function generateBashCompletion(e,t){let n=`_${sanitizeShellIdentifier(t?.functionPrefix??e.name)}_completions`,r=resolveRootCompletionSurface(e,t?.rootMode),i=r.visibleCommands,a=walkCommandTree(i),o=a.reduce((e,t)=>Math.max(e,t.path.length),0),s=[];if(s.push(`#!/usr/bin/env bash`),s.push(`# Bash completion for ${programTag(e)}`),s.push(`# Generated by ${versionTag()}`),s.push(`#`),s.push(`# Usage: source <(${e.name} completions bash)`),s.push(`#`),s.push(`# Install permanently:`),s.push(`# ${e.name} completions bash > /etc/bash_completion.d/${e.name} # Linux`),s.push(`# ${e.name} completions bash > $(brew --prefix)/etc/bash_completion.d/${e.name} # macOS`),s.push(`#`),s.push(`# Requires: bash-completion (provides _init_completion)`),s.push(``),s.push(`${n}() {`),s.push(` local cur prev words cword`),s.push(` _init_completion || return`),s.push(``),i.length>0){let e=a.filter(e=>e.children.length>0),t=collectValueFlagPattern(a,r);s.push(` # Build subcommand path by scanning COMP_WORDS`),s.push(` local subcmd_path=""`),s.push(` local i`),s.push(` for ((i = 1; i < cword; i++)); do`),s.push(' case "${words[i]}" in'),s.push(` --) break ;;`),t.length>0&&s.push(`\t\t\t${t}) ((i++)); continue ;;`),s.push(` -*) continue ;;`),s.push(` esac`),emitBashPathDetection(s,i,e,o),s.push(` done`),s.push(``),s.push(` # Complete flags and subcommands for the active path`),s.push(` case "$subcmd_path" in`);for(let e of a){let t=e.path.join(` `),n=e.mergedFlags,r=collectEnumCasesFromFlags(n),i=collectFlagWords(n),a=dedupeWords(e.children.flatMap(e=>[e.name,...e.aliases])).map(escapeForSingleQuote).join(` `),o=i.split(` `).filter(Boolean).map(escapeForSingleQuote).join(` `),c=a.length>0?`${a} ${o}`:o;if(s.push(`\t\t${quoteShellCasePattern(t)})`),r.length>0){s.push(` local enum_flag=""`),s.push(` local enum_cur="$cur"`),s.push(` local enum_prefix=""`),s.push(` if [[ "$cur" == --*=* ]]; then`),s.push(' enum_flag="${cur%%=*}"'),s.push(' enum_cur="${cur#*=}"'),s.push(' enum_prefix="${cur%%=*}="'),s.push(` fi`),s.push(' case "${enum_flag:-$prev}" in');for(let e of r)s.push(`\t\t\t\t${e.flags})`),s.push(formatBashEnumCompletion(e.values,` `,`enum_cur`,`enum_prefix`)),s.push(` return`),s.push(` ;;`);s.push(` *)`),s.push(` ;;`),s.push(` esac`)}s.push(`\t\t\tCOMPREPLY=($(compgen -W '${c.trim()}' -- "$cur"))`),s.push(` return`),s.push(` ;;`)}s.push(` *)`),s.push(` ;;`),s.push(` esac`),s.push(``);let n=collectFlagWords(r.rootFlags).split(` `).filter(Boolean),c=r.includeDefaultFlags?collectFlagWords(r.defaultFlags).split(` `).filter(Boolean):[],l=dedupeWords([...i.flatMap(e=>[e.name,...e.aliases]),...n,...c]).map(escapeForSingleQuote).join(` `);s.push(` # Root-level completions: visible root surface`),s.push(`\tCOMPREPLY=($(compgen -W '${l}' -- "$cur"))`)}else{let e=collectFlagWords({...r.rootFlags,...r.includeDefaultFlags?r.defaultFlags:{}});s.push(`\tCOMPREPLY=($(compgen -W '${e}' -- "$cur"))`)}return s.push(`}`),s.push(``),s.push(`complete -F ${n} ${quoteShellArg(e.name)}`),s.push(``),s.join(`
|
|
2
2
|
`)}function emitBashPathDetection(e,t,n,r){e.push(` case "$subcmd_path" in`),e.push(` '')`),e.push(' case "${words[i]}" in');for(let n of t){let t=[n.name,...n.aliases].map(escapeBashCasePatternValue);e.push(`\t\t\t\t\t${t.join(`|`)})`),e.push(`\t\t\t\t\t\tsubcmd_path="${escapeBashDoubleQuotedValue(n.name)}"`),e.push(` ;;`)}if(e.push(` esac`),e.push(` ;;`),r>1)for(let t of n){let n=t.path.join(` `);e.push(`\t\t\t${quoteShellCasePattern(n)})`),e.push(' case "${words[i]}" in');for(let n of t.children){let t=[n.name,...n.aliases].map(escapeBashCasePatternValue);e.push(`\t\t\t\t\t${t.join(`|`)})`),e.push(`\t\t\t\t\t\tsubcmd_path="$subcmd_path ${escapeBashDoubleQuotedValue(n.name)}"`),e.push(` ;;`)}e.push(` esac`),e.push(` ;;`)}e.push(` esac`)}function quoteShellCasePattern(e){return e.includes(` `)?`"${escapeBashDoubleQuotedValue(e)}"`:escapeBashCasePatternValue(e)}function escapeBashCasePatternValue(e){return/^[a-zA-Z0-9_\-.]+$/.test(e)?e:e.replace(/\\/g,`\\\\`).replace(/'/g,`\\'`).replace(/"/g,`\\"`).replace(/\|/g,`\\|`).replace(/\*/g,`\\*`).replace(/\?/g,`\\?`).replace(/\[/g,`\\[`).replace(/\]/g,`\\]`).replace(/\(/g,`\\(`).replace(/\)/g,`\\)`).replace(/\{/g,`\\{`).replace(/\}/g,`\\}`).replace(/\+/g,`\\+`).replace(/!/g,`\\!`).replace(/@/g,`\\@`).replace(/#/g,`\\#`).replace(/~/g,`\\~`).replace(/\s/g,e=>e===` `?`\\ `:`\\${e}`)}function escapeBashDoubleQuotedValue(e){return e.replace(/\\/g,`\\\\`).replace(/"/g,`\\"`).replace(/\$/g,`\\$`).replace(/`/g,"\\`")}function escapeForSingleQuote(e){return/^[a-zA-Z0-9_\-.]+$/.test(e)?e:e.replace(/'/g,`'\\''`)}function formatBashEnumCompletion(e,t,n=`cur`,r){let i=[];if(e.some(e=>!/^[a-zA-Z0-9_\-.]+$/.test(e))){let r=e.map(escapeBashDollarQuote).join(`\\n`);i.push(`${t}local IFS=$'\\n'`),i.push(`${t}COMPREPLY=($(compgen -W $'${r}' -- "$${n}"))`)}else i.push(`${t}COMPREPLY=($(compgen -W '${e.join(` `)}' -- "$${n}"))`);return r!==void 0&&(i.push(`${t}if [[ -n "$${r}" && "\${#COMPREPLY[@]}" -gt 0 ]]; then`),i.push(`${t}\tlocal i`),i.push(`${t}\tfor ((i = 0; i < \${#COMPREPLY[@]}; i++)); do`),i.push(`${t}\t\tCOMPREPLY[i]="$${r}\${COMPREPLY[i]}"`),i.push(`${t}\tdone`),i.push(`${t}fi`)),i.join(`
|
|
3
3
|
`)}function escapeBashDollarQuote(e){return e.replace(/\\/g,`\\\\`).replace(/'/g,`\\'`).replace(/\n/g,`\\n`)}function collectFlagWords(e){let t=[];for(let[n,r]of Object.entries(e)){t.push(`--${n}`);for(let e of getFlagAliasNames(r))t.push(e.length===1?`-${e}`:`--${e}`);let e=getVisibleNegatedName(n,r);e!==void 0&&t.push(`--${e}`)}return t.join(` `)}function collectValueFlagPattern(e,t){let n=new Set,r=e=>{for(let[t,r]of Object.entries(e))if(flagExpectsValue(r)){n.add(`--${t}`);for(let e of getFlagAliasNames(r,{includeHidden:!0}))n.add(e.length===1?`-${e}`:`--${e}`)}};for(let t of e)r(t.mergedFlags);return r(t.rootFlags),t.includeDefaultFlags&&r(t.defaultFlags),[...n].map(escapeBashCasePatternValue).join(`|`)}function dedupeWords(e){return[...new Set(e)]}function collectEnumCasesFromFlags(e){let t=[];for(let[n,r]of Object.entries(e)){if(r.kind!==`enum`||r.enumValues===void 0)continue;let e=[`--${n}`,...getFlagAliasNames(r,{includeHidden:!0}).map(e=>e.length===1?`-${e}`:`--${e}`)].map(escapeBashCasePatternValue);t.push({flags:e.join(`|`),values:r.enumValues})}return t}function generateFishCompletion(e,t){let n=`__${sanitizeShellIdentifier(t?.functionPrefix??e.name)}_completions`,r=`${n}_path`,i=`${n}_path_is`,a=resolveRootCompletionSurface(e,t?.rootMode),o=a.visibleCommands,s=walkCommandTree(o),c=quoteShellArg(e.name),l=[];l.push(`# Fish completion for ${programTag(e)}`),l.push(`# Generated by ${versionTag()}`),l.push(`#`),l.push(`# Usage: source (${e.name} completions fish | psub)`),l.push(`#`),l.push(`# Install permanently:`),l.push(`# ${e.name} completions fish > ~/.config/fish/completions/${e.name}.fish`),l.push(``),l.push(`complete -c ${c} -f`),l.push(``),emitFishPathHelpers(l,r,i,o,s,a),appendFishCommandCompletions(l,c,i,``,o),appendFishFlagCompletions(l,c,i,``,a.rootFlags),a.includeDefaultFlags&&appendFishFlagCompletions(l,c,i,``,a.defaultFlags);for(let e of s){let t=e.path.join(` `);appendFishCommandCompletions(l,c,i,t,e.children),appendFishFlagCompletions(l,c,i,t,e.mergedFlags)}return l.join(`
|
|
4
4
|
`)}function emitFishPathHelpers(e,t,n,r,i,a){let o=collectFishValueFlagPatterns(i,a);e.push(`function ${t}`),e.push(` set -l words (commandline -opc)`),e.push(` if test (count $words) -gt 0`),e.push(` set -e words[1]`),e.push(` end`),e.push(` set -l subcmd_path ''`),e.push(` set -l expect_value 0`),e.push(` for word in $words`),e.push(` if test $expect_value -eq 1`),e.push(` set expect_value 0`),e.push(` continue`),e.push(` end`),e.push(` switch $word`),e.push(` case '--'`),e.push(` break`),o.exact.length>0&&(e.push(`\t\t\tcase ${o.exact.map(quoteShellArg).join(` `)}`),e.push(` set expect_value 1`),e.push(` continue`)),o.prefix.length>0&&(e.push(`\t\t\tcase ${o.prefix.map(quoteShellArg).join(` `)}`),e.push(` continue`)),e.push(` case '-*'`),e.push(` continue`),e.push(` end`),e.push(` switch "$subcmd_path|$word"`);for(let t of r)for(let n of[t.name,...t.aliases])e.push(`\t\t\tcase ${quoteShellArg(`|${n}`)}`),e.push(`\t\t\t\tset subcmd_path ${quoteShellArg(t.name)}`);for(let t of i)for(let n of t.children)for(let r of[n.name,...n.aliases])e.push(`\t\t\tcase ${quoteShellArg(`${t.path.join(` `)}|${r}`)}`),e.push(`\t\t\t\tset subcmd_path ${quoteShellArg(`${t.path.join(` `)} ${n.name}`)}`);e.push(` case '*'`),e.push(` break`),e.push(` end`),e.push(` end`),e.push(` printf '%s\\n' "$subcmd_path"`),e.push(`end`),e.push(``),e.push(`function ${n}`),e.push(` set -l expected "$argv[1]"`),e.push(`\ttest (${t}) = "$expected"`),e.push(`end`),e.push(``)}function appendFishCommandCompletions(e,t,n,r,i){let a=buildFishCondition(n,r);for(let n of i){let r=quoteShellArg(n.description??n.name);for(let i of[n.name,...n.aliases])e.push(`complete -c ${t} -n "${a}" -a ${quoteShellArg(i)} -d ${r}`)}i.length>0&&e.push(``)}function appendFishFlagCompletions(e,t,n,r,i){let a=buildFishCondition(n,r);for(let[n,r]of Object.entries(i)){let i=[`complete -c ${t}`,`-n "${a}"`];for(let e of getFlagAliasNames(r,{kind:`short`}))i.push(`-s ${quoteShellArg(e)}`);i.push(`-l ${quoteShellArg(n)}`);for(let e of getFlagAliasNames(r,{kind:`long`}))i.push(`-l ${quoteShellArg(e)}`);let o=getVisibleNegatedName(n,r);if(o!==void 0&&i.push(`-l ${quoteShellArg(o)}`),i.push(`-d ${quoteShellArg(r.description===void 0?n:resolvePlainHelpDescription(r.description))}`),flagExpectsValue(r)&&i.push(`-r`,`-f`),r.kind===`enum`&&r.enumValues!==void 0){for(let t of r.enumValues)e.push([...i,`-a ${quoteShellArg(t)}`].join(` `));continue}e.push(i.join(` `))}Object.keys(i).length>0&&e.push(``)}function collectFishValueFlagPatterns(e,t){let n=new Set,r=new Set,i=[t.rootFlags,...t.includeDefaultFlags?[t.defaultFlags]:[],...e.map(e=>e.mergedFlags)];for(let e of i)for(let[t,i]of Object.entries(e))if(flagExpectsValue(i)){n.add(`--${t}`),r.add(`--${t}=*`);for(let e of getFlagAliasNames(i,{kind:`short`,includeHidden:!0}))n.add(`-${e}`),r.add(`-${e}*`);for(let e of getFlagAliasNames(i,{kind:`long`,includeHidden:!0}))n.add(`--${e}`),r.add(`--${e}=*`)}return{exact:[...n],prefix:[...r]}}function buildFishCondition(e,t){return`${e} ${quoteShellArg(t)}`}function generatePowerShellCompletion(e,t){let n=`__${sanitizeShellIdentifier(t?.functionPrefix??e.name)}_completions`,r=`${n}_paths`,i=resolveRootCompletionSurface(e,t?.rootMode),a=i.visibleCommands,o=walkCommandTree(a),s=[];return s.push(`# PowerShell completion for ${programTag(e)}`),s.push(`# Generated by ${versionTag()}`),s.push(`#`),s.push(`# Install for the current session:`),s.push(`# ${e.name} completions powershell | Out-String | Invoke-Expression`),s.push(`#`),s.push(`# Install permanently:`),s.push(`# ${e.name} completions powershell > $PROFILE.CurrentUserCurrentHost`),s.push(``),s.push(`using namespace System.Management.Automation`),s.push(`using namespace System.Management.Automation.Language`),s.push(``),emitPowerShellPathTable(s,r,i,o),s.push(``),emitPowerShellHelpers(s,n,r),s.push(``),s.push(`Register-ArgumentCompleter -Native -CommandName ${quotePowerShellString(e.name)} -ScriptBlock {`),s.push(` param($wordToComplete, $commandAst, $cursorPosition)`),s.push(`\t$state = ${n}_GetState -CommandAst $commandAst -CursorPosition $cursorPosition`),s.push(` if ($null -eq $state.PathData) {`),s.push(` return`),s.push(` }`),s.push(``),s.push(` $results = [System.Collections.Generic.List[CompletionResult]]::new()`),s.push(` if ($state.AfterSeparator) {`),s.push(` return $results`),s.push(` }`),s.push(``),s.push(` $wordPrefix = if ([string]::IsNullOrEmpty($wordToComplete)) { '' } else { $wordToComplete }`),s.push(``),s.push(` if ($state.ExpectingValue) {`),s.push(`\t\t${n}_AddEnumResults -Results $results -Flag $state.ValueFlag -WordToComplete $wordPrefix`),s.push(` return $results`),s.push(` }`),s.push(``),s.push(`\t$inlineValue = ${n}_ResolveInlineValueCompletion -PathData $state.PathData -WordToComplete $wordPrefix`),s.push(` if ($null -ne $inlineValue) {`),s.push(`\t\t${n}_AddInlineEnumResults -Results $results -InlineValue $inlineValue -WordToComplete $wordPrefix`),s.push(` return $results`),s.push(` }`),s.push(``),s.push(` if ($wordPrefix.StartsWith('-')) {`),s.push(`\t\t${n}_AddFlagResults -Results $results -PathData $state.PathData -WordToComplete $wordPrefix`),s.push(` return $results`),s.push(` }`),s.push(``),s.push(`\t${n}_AddCommandResults -Results $results -PathData $state.PathData -WordToComplete $wordPrefix`),s.push(`\t${n}_AddFlagResults -Results $results -PathData $state.PathData -WordToComplete $wordPrefix`),s.push(` return $results`),s.push(`}`),s.join(`
|
package/dist/completion.d.mts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { C as SHELLS, T as CompletionOptions, o as CLISchema, w as Shell } from "./index-
|
|
1
|
+
import { C as SHELLS, T as CompletionOptions, o as CLISchema, w as Shell } from "./index-BAj2y70U.mjs";
|
|
2
2
|
//#region src/core/completion/shells/bash.d.ts
|
|
3
3
|
/**
|
|
4
4
|
* Generate a bash completion script for the CLI.
|
package/dist/completion.mjs
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{it as SHELLS}from"./core-
|
|
1
|
+
import{it as SHELLS}from"./core-DvXUolc_.mjs";import{a as generateFishCompletion,i as generatePowerShellCompletion,n as generateCompletion,o as generateBashCompletion,r as generateZshCompletion}from"./completion-CUMeOnAz.mjs";export{SHELLS,generateBashCompletion,generateCompletion,generateFishCompletion,generatePowerShellCompletion,generateZshCompletion};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{t as __exportAll}from"./rolldown-runtime-G4Kt5YOX.mjs";import{Q as CLIError}from"./core-
|
|
1
|
+
import{t as __exportAll}from"./rolldown-runtime-G4Kt5YOX.mjs";import{Q as CLIError}from"./core-DvXUolc_.mjs";var config_exports=__exportAll({buildConfigSearchPaths:()=>buildConfigSearchPaths,configFormat:()=>configFormat,discoverConfig:()=>discoverConfig});function isPlainObject(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=Object.getPrototypeOf(e);return t===Object.prototype||t===null}const jsonLoader={extensions:[`json`],parse:e=>{let t=JSON.parse(e);if(typeof t!=`object`||!t||Array.isArray(t))throw Error(`Config must be a JSON object`);return t}};function joinPath(e,...t){let n=e.includes(`\\`)?`\\`:`/`;return[e.endsWith(n)?e.slice(0,-1):e,...t].join(n)}function ancestorDirs(e){let t=e.includes(`\\`)?`\\`:`/`,n=e;for(;n.length>1&&n.endsWith(t)&&!n.endsWith(`:${t}`);)n=n.slice(0,-1);let r=[n];for(;;){let e=n.lastIndexOf(t);if(e<0)break;let i=n.slice(0,e);if(i===``?i=t:/^[A-Za-z]:$/.test(i)&&(i=`${i}${t}`),i===n)break;r.push(i),n=i}return r}function getExtension(e){let t=e.lastIndexOf(`.`);return t<=Math.max(e.lastIndexOf(`/`),e.lastIndexOf(`\\`))?``:e.slice(t+1).toLowerCase()}function buildConfigSearchPaths(e,t){let n=buildExtensionList(t.loaders),r=[];for(let i of ancestorDirs(t.baseDir)){for(let t of n)r.push(joinPath(i,`.${e}.${t}`));for(let t of n)r.push(joinPath(i,`${e}.config.${t}`));for(let t of n)r.push(joinPath(i,`.config`,`${e}.${t}`))}for(let i of t.userConfigDirs)for(let t of n)r.push(joinPath(i,e,`config.${t}`));for(let i of t.systemConfigDirs??[])for(let t of n)r.push(joinPath(i,e,`config.${t}`));return r}function buildExtensionList(e){let t=new Set,n=[];for(let e of jsonLoader.extensions){let r=e.toLowerCase();t.has(r)||(t.add(r),n.push(r))}if(e!==void 0)for(let r of e)for(let e of r.extensions){let r=e.toLowerCase();t.has(r)||(t.add(r),n.push(r))}return n}function buildLoaderMap(e){let t=new Map;for(let e of jsonLoader.extensions)t.set(e.toLowerCase(),jsonLoader);if(e!==void 0)for(let n of e)for(let e of n.extensions)t.set(e.toLowerCase(),n);return t}async function discoverConfig(e,t,n){let r=buildLoaderMap(n?.loaders),i=n?.configPath===void 0?n?.searchPaths??buildConfigSearchPaths(e,{baseDir:n?.baseDir??t.cwd,userConfigDirs:t.userConfigDirs??[t.configDir],systemConfigDirs:t.systemConfigDirs??[],...n?.loaders===void 0?{}:{loaders:n.loaders}}):[n.configPath];for(let e of i){let i=await t.readFile(e);if(i===null){if(n?.configPath!==void 0)throw new CLIError(`Config file not found: ${e}`,{code:`CONFIG_NOT_FOUND`,details:{path:e},suggest:`Create the config file or remove the --config flag`});continue}let a=getExtension(e),o=r.get(a);if(o===void 0)throw new CLIError(`No loader registered for config format: .${a}`,{code:`CONFIG_UNKNOWN_FORMAT`,details:{path:e,extension:a},suggest:`Supported formats: ${[...r.keys()].join(`, `)}`});try{let t=o.parse(i);if(!isPlainObject(t))throw Error(`Config loader must return a plain object`);return{found:!0,path:e,data:t,format:a}}catch(t){throw new CLIError(`Failed to parse config file: ${e}`,{code:`CONFIG_PARSE_ERROR`,cause:t,details:{path:e,format:a,message:t instanceof Error?t.message:String(t)},suggest:`Check the config file for syntax errors`})}}return{found:!1}}function configFormat(e,t){return{extensions:e,parse:t}}export{discoverConfig as i,configFormat as n,config_exports as r,buildConfigSearchPaths as t};
|
package/dist/config.d.mts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import { _ as discoverManifest, a as ConfigNotFound, c as buildConfigSearchPaths, d as PackageRepositoryUrlOptions, f as packageRepositoryUrl, g as PackageRepository, h as PackageJsonData, i as ConfigFound, l as configFormat, m as PackageJsonAdapter, n as ConfigDiscoveryOptions, o as ConfigSearchPathOptions, p as ManifestDiscoveryOptions, r as ConfigDiscoveryResult, s as FormatLoader, t as ConfigAdapter, u as discoverConfig, v as inferCliName } from "./index-
|
|
1
|
+
import { _ as discoverManifest, a as ConfigNotFound, c as buildConfigSearchPaths, d as PackageRepositoryUrlOptions, f as packageRepositoryUrl, g as PackageRepository, h as PackageJsonData, i as ConfigFound, l as configFormat, m as PackageJsonAdapter, n as ConfigDiscoveryOptions, o as ConfigSearchPathOptions, p as ManifestDiscoveryOptions, r as ConfigDiscoveryResult, s as FormatLoader, t as ConfigAdapter, u as discoverConfig, v as inferCliName } from "./index-Cp9kt2t-.mjs";
|
|
2
2
|
export { type ConfigAdapter, type ConfigDiscoveryOptions, type ConfigDiscoveryResult, type ConfigFound, type ConfigNotFound, type ConfigSearchPathOptions, type FormatLoader, type ManifestDiscoveryOptions, type PackageJsonAdapter, type PackageJsonData, type PackageRepository, type PackageRepositoryUrlOptions, buildConfigSearchPaths, configFormat, discoverConfig, discoverManifest, inferCliName, packageRepositoryUrl };
|
package/dist/config.mjs
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{p as packageRepositoryUrl}from"./core-DvXUolc_.mjs";import{n as inferCliName,t as discoverManifest}from"./package-json-BgE9YjjQ.mjs";import{i as discoverConfig,n as configFormat,t as buildConfigSearchPaths}from"./config-CrlScpYX.mjs";export{buildConfigSearchPaths,configFormat,discoverConfig,discoverManifest,inferCliName,packageRepositoryUrl};
|
|
@@ -9,9 +9,9 @@ import{createColors,isColorSupported,strip}from"ansispeck";const SHELLS=Object.f
|
|
|
9
9
|
`)}const EXAMPLE_TOKEN=/(?:'[^']*'|"[^"]*"|\S)+/g;function highlightExampleCommand(e,t){let n=0;return e.replace(EXAMPLE_TOKEN,e=>{let r=n===0?t.usageBin(e):e.startsWith(`-`)?t.flag(e):e;return n+=1,r})}function formatExamplesSection(e,t,n){let r=[t.sectionTitle(`Examples:`)],i=t.examplePrompt(`$`);for(let a of e){let e=highlightExampleCommand(resolveExampleCommand(a.command,n),t);a.description===void 0?r.push(` ${i} ${e}`):(r.push(` ${a.description}:`),r.push(` ${i} ${e}`))}return r.join(`
|
|
10
10
|
`)}function bindMethods(e){let t=e,n=new Set,r=Object.getPrototypeOf(e);for(;r!==null&&r!==Object.prototype;){for(let i of Object.getOwnPropertyNames(r)){if(i===`constructor`||n.has(i))continue;n.add(i);let a=Object.getOwnPropertyDescriptor(r,i);a!==void 0&&typeof a.value==`function`&&Object.defineProperty(t,i,{value:a.value.bind(e),writable:!0,enumerable:!1,configurable:!0})}r=Object.getPrototypeOf(r)}}function writeLine(e,t){e(`${t}\n`)}const noopSpinnerHandle={update(){},succeed(){},fail(){},stop(){},wrap(e){return e}},noopProgressHandle={increment(){},update(){},done(){},fail(){}};var StaticSpinnerHandle=class{write;stopped=!1;constructor(e,t){this.write=t,writeLine(t,e),bindMethods(this)}update(e){}succeed(e){this.stopped||(this.stopped=!0,e!==void 0&&writeLine(this.write,e))}fail(e){this.stopped||(this.stopped=!0,e!==void 0&&writeLine(this.write,e))}stop(){this.stopped||=!0}async wrap(e,t){try{let n=await e;return this.succeed(t?.succeed),n}catch(e){throw this.fail(t?.fail),e}}},StaticProgressHandle=class{write;stopped=!1;constructor(e,t){this.write=t,e!==void 0&&writeLine(t,e),bindMethods(this)}increment(e){}update(e){}done(e){this.stopped||(this.stopped=!0,e!==void 0&&writeLine(this.write,e))}fail(e){this.stopped||(this.stopped=!0,e!==void 0&&writeLine(this.write,e))}};const HIDE_CURSOR=`\x1B[?25l`,SHOW_CURSOR=`\x1B[?25h`,ERASE_LINE=`\x1B[2K`,SPINNER_FRAMES=[`⠋`,`⠙`,`⠹`,`⠸`,`⠼`,`⠴`,`⠦`,`⠧`,`⠇`,`⠏`];var TTYSpinnerHandle=class{write;stopped=!1;timer;frameIndex=0;text;constructor(e,t){this.write=t,this.text=e,t(HIDE_CURSOR),this.render(),this.timer=setInterval(()=>{this.frameIndex=(this.frameIndex+1)%SPINNER_FRAMES.length,this.render()},80),bindMethods(this)}render(){let e=SPINNER_FRAMES[this.frameIndex]??SPINNER_FRAMES[0];this.write(`\r${ERASE_LINE}${e} ${this.text}`)}cleanup(){this.timer!==void 0&&(clearInterval(this.timer),this.timer=void 0),this.write(`\r${ERASE_LINE}${SHOW_CURSOR}`)}update(e){this.stopped||(this.text=e,this.render())}succeed(e){this.stopped||(this.stopped=!0,this.cleanup(),e!==void 0&&writeLine(this.write,`✓ ${e}`))}fail(e){this.stopped||(this.stopped=!0,this.cleanup(),e!==void 0&&writeLine(this.write,`✗ ${e}`))}stop(){this.stopped||(this.stopped=!0,this.cleanup())}async wrap(e,t){try{let n=await e;return this.succeed(t?.succeed),n}catch(e){throw this.fail(t?.fail),e}}},TTYProgressHandle=class{write;stopped=!1;timer;current=0;total;label;pulsePos=0;pulseDir=1;constructor(e,t){this.write=t,this.total=e.total,this.label=e.label??``,t(HIDE_CURSOR),this.render(),this.total===void 0&&(this.timer=setInterval(()=>{this.advancePulse(),this.render()},80)),bindMethods(this)}advancePulse(){this.pulsePos+=this.pulseDir,this.pulsePos+3>20?(this.pulseDir=-1,this.pulsePos=17):this.pulsePos<0&&(this.pulseDir=1,this.pulsePos=0)}render(){let e=this.total===void 0?this.renderIndeterminate():this.renderDeterminate(this.total),t=this.label.length>0?` ${this.label}`:``;this.write(`\r${ERASE_LINE}${e}${t}`)}renderDeterminate(e){let t=e>0?Math.max(0,Math.min(this.current/e,1)):0,n=Math.round(t*20),r=20-n,i=Math.round(t*100);return`[${`█`.repeat(n)}${`░`.repeat(r)}] ${String(i)}%`}renderIndeterminate(){let e=``;for(let t=0;t<20;t++)e+=t>=this.pulsePos&&t<this.pulsePos+3?`█`:`░`;return`[${e}]`}cleanup(){this.timer!==void 0&&(clearInterval(this.timer),this.timer=void 0),this.write(`\r${ERASE_LINE}${SHOW_CURSOR}`)}increment(e){this.stopped||(this.current+=e??1,this.render())}update(e){this.stopped||(this.current=e,this.render())}done(e){this.stopped||(this.stopped=!0,this.cleanup(),e!==void 0&&writeLine(this.write,`✓ ${e}`))}fail(e){this.stopped||(this.stopped=!0,this.cleanup(),e!==void 0&&writeLine(this.write,`✗ ${e}`))}},CaptureSpinnerHandle=class{events;stopped=!1;constructor(e,t){this.events=t,t.push({type:`spinner:start`,text:e}),bindMethods(this)}update(e){this.stopped||this.events.push({type:`spinner:update`,text:e})}succeed(e){this.stopped||(this.stopped=!0,this.events.push({type:`spinner:succeed`,text:e??``}))}fail(e){this.stopped||(this.stopped=!0,this.events.push({type:`spinner:fail`,text:e??``}))}stop(){this.stopped||(this.stopped=!0,this.events.push({type:`spinner:stop`}))}async wrap(e,t){try{let n=await e;return this.succeed(t?.succeed),n}catch(e){throw this.fail(t?.fail),e}}},CaptureProgressHandle=class{events;stopped=!1;constructor(e,t){this.events=t,t.push({type:`progress:start`,label:e.label??``,total:e.total}),bindMethods(this)}increment(e){this.stopped||this.events.push({type:`progress:increment`,delta:e??1})}update(e){this.stopped||this.events.push({type:`progress:update`,value:e})}done(e){this.stopped||(this.stopped=!0,this.events.push({type:`progress:done`,text:e}))}fail(e){this.stopped||(this.stopped=!0,this.events.push({type:`progress:fail`,text:e}))}};function resolveOutputPolicy(e){return{jsonMode:e.jsonMode,isTTY:e.isTTY,verbosity:e.verbosity}}function resolveTextStream(e){return e.jsonMode?`stderr`:`stdout`}function shouldEmitInfo(e){return e.verbosity!==`quiet`}function resolveTableFormat(e,t){switch(t?.format){case`json`:return`json`;case`text`:return`text`;case`auto`:case void 0:return e.jsonMode?`json`:`text`}}function resolveTableTextStream(e,t){return t?.format===`text`&&`stream`in t&&t.stream!==void 0?t.stream:resolveTextStream(e)}function resolveActivityRenderMode(e,t){return e.jsonMode||e.verbosity===`quiet`?`noop`:e.isTTY?`tty`:t===`static`?`static`:`noop`}function resolveSpinnerPolicy(e,t){let n=resolveActivityRenderMode(e,t);return{mode:n,stream:`stderr`,cleanup:n===`noop`?`none`:`stop`}}function resolveProgressPolicy(e,t){let n=resolveActivityRenderMode(e,t);return{mode:n,stream:`stderr`,cleanup:n===`noop`?`none`:`done`}}function resolveWriterForStream(e,t){return t===`stderr`?e.stderr:e.stdout}function createSpinnerHandleFromPolicy(e,t,n){if(e.mode===`noop`)return{handle:noopSpinnerHandle,cleanup:void 0};if(e.mode===`tty`){let e=new TTYSpinnerHandle(t,n);return{handle:e,cleanup:()=>e.stop()}}let r=new StaticSpinnerHandle(t,n);return{handle:r,cleanup:()=>r.stop()}}function createProgressHandleFromPolicy(e,t,n){if(e.mode===`noop`)return{handle:noopProgressHandle,cleanup:void 0};if(e.mode===`tty`){let e=new TTYProgressHandle(t,n);return{handle:e,cleanup:()=>e.done()}}let r=new StaticProgressHandle(t.label,n);return{handle:r,cleanup:()=>r.done()}}const noopWrite$1=()=>{},requestedExitCodes=new WeakMap;function validateExitCode(e){if(!Number.isInteger(e)||e<0||e>255)throw RangeError(`Exit code must be an integer from 0 to 255`);return e}function setRequestedExitCode(e,t){requestedExitCodes.set(e,validateExitCode(t))}function getRequestedExitCode(e){return requestedExitCodes.get(e)}function clearRequestedExitCode(e){requestedExitCodes.delete(e)}function resolveHyperlinkOverride(e,t){let n=t.indexOf(`--`),r=n===-1?t:t.slice(0,n);if(r.includes(`--no-hyperlinks`))return!1;if(r.includes(`--hyperlinks`))return!0;if(e.NO_HYPERLINKS)return!1;if(e.FORCE_HYPERLINKS)return!0}function resolveOptions(e){let t=e?.isTTY??!1,n=e?.jsonMode??!1;return{stdout:e?.stdout??noopWrite$1,stderr:e?.stderr??noopWrite$1,isTTY:t,verbosity:e?.verbosity??`normal`,jsonMode:n,color:e?.color??(t&&!n&&isColorSupported),isHyperlinkSupported:e?.hyperlinks??t}}var OutputChannel=class{options;policy;jsonMode;verbosity;isTTY;color;isHyperlinkSupported;constructor(e){this.options=e,this.policy=resolveOutputPolicy(e),this.jsonMode=e.jsonMode,this.verbosity=this.policy.verbosity,this.isTTY=e.isTTY,this.color=createColors(e.color),this.isHyperlinkSupported=e.isHyperlinkSupported,bindMethods(this)}log(e){writeLine(resolveWriterForStream(this.options,resolveTextStream(this.policy)),e)}info(e){shouldEmitInfo(this.policy)&&writeLine(resolveWriterForStream(this.options,resolveTextStream(this.policy)),e)}status(e){shouldEmitInfo(this.policy)&&writeLine(this.options.stderr,e)}warn(e){writeLine(this.options.stderr,e)}error(e){writeLine(this.options.stderr,e)}setExitCode(e){setRequestedExitCode(this,e)}json(e){writeLine(this.options.stdout,JSON.stringify(e))}table(e,t,n){let{columns:r,options:i}=resolveTableArgs(t,n),a=resolveTableFormat(this.policy,i),o=r??inferColumns(e);if(a===`json`){this.json(projectTableRows(e,o));return}let s=formatTable(e,o);s.length!==0&&writeLine(resolveTextTableWriter(this.options,this.policy,a,i),s)}activeCleanup;stopActive(){this.activeCleanup!==void 0&&(this.activeCleanup(),this.activeCleanup=void 0)}spinner(e,t){let n=createSpinnerHandleFromPolicy(resolveSpinnerPolicy(this.policy,t?.fallback??`silent`),e,this.options.stderr);return n.cleanup===void 0?n.handle:(this.stopActive(),this.activeCleanup=n.cleanup,n.handle)}progress(e){let t=createProgressHandleFromPolicy(resolveProgressPolicy(this.policy,e.fallback??`silent`),e,this.options.stderr);return t.cleanup===void 0?t.handle:(this.stopActive(),this.activeCleanup=t.cleanup,t.handle)}},CaptureOutputChannel=class extends OutputChannel{activity;constructor(e,t){super(e),this.activity=t}spinner(e,t){return new CaptureSpinnerHandle(e,this.activity)}progress(e){return new CaptureProgressHandle(e,this.activity)}};function inferColumns(e){let t=e[0];return t===void 0?[]:Object.keys(t).map(e=>({key:e}))}function isTableColumns(e){return Array.isArray(e)}function resolveTableArgs(e,t){return t===void 0?isTableColumns(e)?{columns:e,options:t}:{columns:void 0,options:e}:{columns:isTableColumns(e)?e:void 0,options:t}}function cellKeyHolder(e,t){for(let n=e;n!==null;n=Object.getPrototypeOf(n))if(Object.hasOwn(n,t))return n;return null}function cellValue(e,t){let n=cellKeyHolder(e,t);return n===null||n===Object.prototype?void 0:e[t]}function projectTableRows(e,t){return e.map(e=>Object.fromEntries(t.map(t=>[t.key,cellValue(e,t.key)])))}function resolveTextTableWriter(e,t,n,r){return n===`json`?e.stdout:resolveWriterForStream(e,resolveTableTextStream(t,r))}function cellToString(e){return formatDisplayValue(e)}function formatTable(e,t){if(e.length===0||t.length===0)return``;let n=t.map(e=>e.header??e.key),r=e.map(e=>t.map(t=>cellToString(cellValue(e,t.key)))),i=n.map((e,t)=>{let n=e.length;for(let e of r){let r=e[t];r!==void 0&&r.length>n&&(n=r.length)}return n});return[n.map((e,t)=>e.padEnd(i[t]??0)).join(` `),i.map(e=>`-`.repeat(e)).join(` `),...r.map(e=>e.map((e,t)=>e.padEnd(i[t]??0)).join(` `))].join(`
|
|
11
11
|
`)}function createOutput(e){return new OutputChannel(resolveOptions(e))}function createCaptureOutput(e){let t={stdout:[],stderr:[],activity:[]};return[new CaptureOutputChannel(resolveOptions({...e,stdout:e=>t.stdout.push(e),stderr:e=>t.stderr.push(e)}),t.activity),t]}function formatDiagnosticValue(e){if(typeof e==`string`)return e;try{let t=JSON.stringify(e);if(t!==void 0)return t}catch{}try{return String(e)}catch{return`<unprintable>`}}function diagnosticValue(e,t){return e?{kind:`redacted`,text:`<redacted>`}:{kind:`visible`,value:t,text:formatDiagnosticValue(t)}}function middleware(e){return{_handler:e}}function wasExplicit(e){return e!==void 0&&e.stage!=="default"}const STDIN_OCCURRENCE={kind:`stdin`},NEGATED_OCCURRENCE={kind:`negated`},INCREMENT_OCCURRENCE={kind:`increment`};function occurrenceValue(e){switch(e.kind){case`value`:return e.value;case`entry`:return[e.key,e.value];case`stdin`:return`-`;case`negated`:return!1;case`increment`:return 1;case`aggregated`:return e.value}}function projectOccurrences(e,t){if(e.kind===`count`)return projectCount(t);if(e.kind===`one`){let e=t[t.length-1];return e===void 0?void 0:occurrenceValue(e)}return t.map(occurrenceValue)}function projectCount(e){let t;for(let n of e)t=n.kind===`increment`?(typeof t==`number`?t:0)+1:occurrenceValue(n);return t}function liftOccurrences(e,t,n){return Array.isArray(t)?t.map(t=>liftElement(e,t,n)):[{kind:`aggregated`,value:t}]}function liftElement(e,t,n){if(n&&t===`-`)return STDIN_OCCURRENCE;if(e.kind===`entries`){let e=entryPairOf(t);if(e!==void 0)return{kind:`entry`,key:e[0],value:e[1]}}return{kind:`value`,value:t}}function entryPairOf(e){if(!Array.isArray(e)||e.length!==2)return;let t=e[0],n=e[1];return typeof t==`string`?[t,n]:void 0}function readAggregated(e){let t=e.length===1?e[0]:void 0;return t?.kind===`aggregated`?{value:t.value}:void 0}function entryPairsOf(e){let t=[];for(let n of e)n.kind===`entry`&&t.push([n.key,n.value]);return t}function tokenize(e){let t=[],n=!1;for(let r of e){if(n){t.push({kind:`positional`,value:r});continue}if(r===`--`){t.push({kind:`separator`}),n=!0;continue}if(r.startsWith(`--`)){let e=r.indexOf(`=`);e===-1?t.push({kind:`long-flag`,name:r.slice(2),value:void 0}):t.push({kind:`long-flag`,name:r.slice(2,e),value:r.slice(e+1)});continue}if(r.startsWith(`-`)&&r.length>1){t.push({kind:`short-flags`,chars:r.slice(1)});continue}t.push({kind:`positional`,value:r})}return t}function includesBeforeSeparator(e,t){for(let n of e){if(n===`--`)return!1;if(n===t)return!0}return!1}function requestsHelp(e){return includesBeforeSeparator(e,`--help`)||includesBeforeSeparator(e,`-h`)}function stripBeforeSeparator(e,t){let n=e.indexOf(`--`),r=n===-1?e:e.slice(0,n);if(!r.includes(t))return e;let i=r.filter(e=>e!==t);return n===-1?i:[...i,...e.slice(n)]}function kebabToCamel(e){return e.replace(/-+([a-z0-9])/g,(e,t)=>t.toUpperCase())}function camelToKebab(e){return e.replace(/([a-z0-9])([A-Z])/g,`$1-$2`).toLowerCase()}function counterpartSpelling(e){if(e.length<2)return;if(e.includes(`-`)){let t=kebabToCamel(e);return t===e?void 0:t}let t=camelToKebab(e);return t===e?void 0:t}function buildFlagLookup(e,t){let n=new Map;for(let[t,r]of Object.entries(e)){n.set(t,{name:t,schema:r,negated:!1,parity:!1});for(let e of getFlagAliasNames(r,{includeHidden:!0}))n.set(e,{name:t,schema:r,negated:!1,parity:!1});let e=getFlagNegatedName(t,r);e!==void 0&&n.set(e,{name:t,schema:r,negated:!0,parity:!1})}if(t?.caseParity!==!1){let e=[...n];for(let[t,r]of e){let e=counterpartSpelling(t);e!==void 0&&!n.has(e)&&n.set(e,{...r,parity:!0})}}return n}function occurrencesOf(e,t,n){let r=e.get(t);if(r!==void 0)return r;let i={schema:n,occurrences:[],counted:0};return e.set(t,i),i}function recordFlagOccurrence(e,t,n,r,i,a){let o=occurrencesOf(e,t,n);if(o.counted+=1,o.counted>1&&n.duplicates===`error`){let e=diagnosticValue(n.sensitive,[...o.occurrences.filter(e=>e.policed).map(e=>e.reported),r]);throw new ParseError(`Flag --${t} may only be specified once`,{code:`DUPLICATE_FLAG`,details:{flag:t,input:i,count:o.counted,...e.kind===`visible`?{values:e.value}:{}}})}o.counted>1&&n.duplicates===`first`||o.occurrences.push({policed:!0,reported:r,items:a()})}function recordCountIncrement(e,t,n){occurrencesOf(e,t,n).occurrences.push({policed:!1,reported:void 0,items:[INCREMENT_OCCURRENCE]})}function projectFlags(e){let t={};for(let[n,r]of e)t[n]=projectOccurrences(flagCardinality(r.schema),r.occurrences.flatMap(e=>e.items));return t}function flagExpectsValue(e){return e.kind!==`boolean`&&e.kind!==`count`}function isStdinSentinel(e,t){return e===`-`&&t!==void 0&&stdinReadsOnDash(t)}function coerceFlagValue(e,t,n,r=`--${e}`){return occurrenceValue(flagTokenOccurrence(e,t,n,r))}function flagTokenOccurrence(e,t,n,r){if(isStdinSentinel(t,n.stdin))return STDIN_OCCURRENCE;let i=flagCardinality(n);if(i.kind===`count`)return{kind:`value`,value:coerceCountToken(e,t,r,n.sensitive)};if(i.kind===`entries`){let[i,a]=coerceEntryToken(e,t,n,r);return{kind:`entry`,key:i,value:a}}return{kind:`value`,value:coerceElementToken(e,t,n,r)}}function coerceElementToken(e,t,n,r){let i=decodeValue(flagValueSchema(n),t,`token`);if(i.ok)return i.value;throw flagValueError(e,r,t,i.failure,n.sensitive)}function coerceCountToken(e,t,n,r){let i=t.trim()===``?NaN:Number(t);if(!Number.isInteger(i)||i<0){let i=diagnosticValue(r,t);throw new ParseError(`Invalid count value '${i.text}' for flag ${n}. Use a non-negative integer`,{code:`INVALID_VALUE`,details:{flag:e,input:n,...i.kind===`visible`?{value:i.value}:{},expected:`count`}})}return i}function coerceEntryToken(e,t,n,r){let i=splitEntryPair(t);if(i===void 0){let i=diagnosticValue(n.sensitive,t);throw new ParseError(`Invalid value '${i.text}' for flag ${r}. Use KEY=VALUE`,{code:`INVALID_VALUE`,details:{flag:e,input:r,...i.kind===`visible`?{value:i.value}:{},expected:`key=value`}})}return[i[0],coerceElementToken(e,i[1],n,r)]}function valueParseError(e,t,n){let r=diagnosticValue(e.sensitive,t),i={...e.details,...r.kind===`visible`?{value:r.value}:{}};switch(n.kind){case`type`:return n.expected===`number`?new ParseError(`Invalid number value '${r.text}' for ${e.label}`,{code:`INVALID_VALUE`,details:{...i,expected:`number`}}):n.expected===`boolean`?new ParseError(`Invalid boolean value '${r.text}' for ${e.label}. Use true/false or 1/0`,{code:`INVALID_VALUE`,details:{...i,expected:`boolean`}}):new ParseError(`Invalid value '${r.text}' for ${e.label}`,{code:`INVALID_VALUE`,details:{...i,expected:`string`}});case`enum`:{let t=n.enumValues;return t===void 0?new ParseError(`${e.enumLabel} is misconfigured: no allowed values declared`,{code:`INVALID_SCHEMA`,details:e.enumDetails}):new ParseError(`Invalid value '${r.text}' for ${e.label}. Allowed: ${t.join(`, `)}`,{code:`INVALID_VALUE`,details:{...i,allowed:t}})}case`string-constraint`:return new ParseError(`Invalid value '${r.text}' for ${e.label}: ${describeStringConstraintViolation(n.violation)}`,{code:`INVALID_VALUE`,details:{...i,expected:`string`,...stringConstraintDetails(n.violation)}});case`number-constraint`:return new ParseError(`Invalid number value '${r.text}' for ${e.label}: ${describeNumberConstraintViolation(n.violation)}`,{code:`INVALID_VALUE`,details:{...i,expected:`number`,constraint:n.violation.kind,...`bound`in n.violation?{bound:n.violation.bound}:{}}});case`thrown`:{if(n.error instanceof ParseError)return e.sensitive?new ParseError(n.error.message,{code:n.error.code,exitCode:n.error.exitCode,details:e.details,...n.error.suggest===void 0?{}:{suggest:n.error.suggest}}):n.error;let t=n.error instanceof Error?n.error.message:String(n.error);return new ParseError(`Failed to parse ${e.label} value '${r.text}': ${t}`,{code:`INVALID_VALUE`,details:i,...r.kind===`visible`?{cause:n.error}:{}})}}}function flagValueError(e,t,n,r,i){return valueParseError({details:{flag:e,input:t},label:`flag ${t}`,enumDetails:{flag:e,kind:`enum`,missing:`enumValues`},enumLabel:`Enum flag --${e}`,sensitive:i},n,r)}function argTokenOccurrence(e,t,n){if(isStdinSentinel(t,n.stdin))return STDIN_OCCURRENCE;if(argCardinality(n).kind===`entries`){let r=splitEntryPair(t);if(r===void 0){let r=diagnosticValue(n.sensitive,t);throw new ParseError(`Invalid value '${r.text}' for argument <${e}>. Use KEY=VALUE`,{code:`INVALID_VALUE`,details:{arg:e,...r.kind===`visible`?{value:r.value}:{},expected:`key=value`}})}return{kind:`entry`,key:r[0],value:decodeArgToken(e,r[1],n)}}return{kind:`value`,value:decodeArgToken(e,t,n)}}function decodeArgToken(e,t,n){let r=decodeValue(argValueSchema(n),t,`token`);if(r.ok)return r.value;throw argValueError(e,t,r.failure,n.sensitive)}function argValueError(e,t,n,r){return valueParseError({details:{arg:e},label:`argument <${e}>`,enumDetails:{arg:e,kind:`enum`,missing:`enumValues`},enumLabel:`Enum argument <${e}>`,sensitive:r},t,n)}function parse(e,t,n){let r=tokenize(t),i=buildFlagLookup(e.flags,n),a=[],o=new Map,s=0;for(;s<r.length;){let e=r[s];if(e===void 0)break;if(e.kind===`separator`){s++;continue}if(e.kind===`positional`){a.push(e.value),s++;continue}if(e.kind===`long-flag`){s=parseLongFlag(e,r,s,i,o);continue}s=parseShortFlags(e,r,s,i,o)}let c=mapPositionals(e.args,a);return{flags:projectFlags(o),args:c}}function parseLongFlag(e,t,n,r,i){let a=r.get(e.name);if(!a){let t=suggestFlag(e.name,r);throw new ParseError(`Unknown flag --${e.name}${t?`. Did you mean --${t}?`:``}`,{code:`UNKNOWN_FLAG`,details:{flag:e.name,...t?{suggestion:t}:{}},...t?{suggest:`--${t}`}:{}})}let{name:o,schema:s,negated:c}=a,l=`--${e.name}`;if(c){if(e.value!==void 0){let t=diagnosticValue(s.sensitive,e.value);throw new ParseError(`Flag ${l} does not take a value`,{code:`INVALID_VALUE`,details:{flag:o,input:e.name,...t.kind===`visible`?{value:t.value}:{}}})}return recordFlagOccurrence(i,o,s,!1,l,()=>[NEGATED_OCCURRENCE]),n+1}if(!flagExpectsValue(s)){if(e.value!==void 0){let t=flagTokenOccurrence(o,e.value,s,l);recordFlagOccurrence(i,o,s,occurrenceValue(t),l,()=>[t])}else s.kind===`count`?recordCountIncrement(i,o,s):recordFlagOccurrence(i,o,s,!0,l,()=>[{kind:`value`,value:!0}]);return n+1}if(e.value!==void 0){let t=e.value;return recordFlagOccurrence(i,o,s,t,l,()=>flagTokenOccurrences(o,s,t,l)),n+1}let u=t[n+1];if(u?.kind!==`positional`)throw new ParseError(`Flag ${l} requires a value`,{code:`MISSING_VALUE`,details:{flag:o,input:e.name,kind:s.kind}});return recordFlagOccurrence(i,o,s,u.value,l,()=>flagTokenOccurrences(o,s,u.value,l)),n+2}function parseShortFlags(e,t,n,r,i){let{chars:a}=e,o=n+1;for(let e=0;e<a.length;e++){let n=a.charAt(e),s=r.get(n);if(!s)throw new ParseError(`Unknown flag -${n}`,{code:`UNKNOWN_FLAG`,details:{flag:n}});let{name:c,schema:l}=s,u=`-${n}`;if(!flagExpectsValue(l)){l.kind===`count`?recordCountIncrement(i,c,l):recordFlagOccurrence(i,c,l,!0,u,()=>[{kind:`value`,value:!0}]);continue}if(e<a.length-1){let t=a.slice(e+1);recordFlagOccurrence(i,c,l,t,u,()=>flagTokenOccurrences(c,l,t,u));break}let d=t[o];if(d?.kind!==`positional`)throw new ParseError(`Flag -${n} requires a value`,{code:`MISSING_VALUE`,details:{flag:c,input:n,kind:l.kind}});recordFlagOccurrence(i,c,l,d.value,u,()=>flagTokenOccurrences(c,l,d.value,u)),o++}return o}function flagTokenOccurrences(e,t,n,r=`--${e}`){let i=flagCardinality(t);return isCollection(i)?splitCliToken(i.cliSplit,n,t).map(n=>flagTokenOccurrence(e,n,t,r)):[flagTokenOccurrence(e,n,t,r)]}function splitCliToken(e,t,n){return isStdinSentinel(t,n.stdin)?[t]:e.format===`delimiter`?t.split(e.delimiter).filter(e=>e.length>0):[t]}const WHOLE_TOKEN={format:`whole`};function cliSplitOf(e){return e.kind===`many`||e.kind===`entries`?e.cliSplit:WHOLE_TOKEN}function mapPositionals(e,t){let n={},r=0;for(let i of e){let e=argCardinality(i.schema),a=cliSplitOf(e);if(i.schema.variadic){let o=t.slice(r).flatMap(e=>splitCliToken(a,e,{stdin:i.schema.stdin}).map(e=>argTokenOccurrence(i.name,e,i.schema)));n[i.name]=projectOccurrences(e,o),r=t.length;break}let o=t[r];if(o!==void 0){let t=splitCliToken(a,o,{stdin:i.schema.stdin}).map(e=>argTokenOccurrence(i.name,e,i.schema));n[i.name]=projectOccurrences(e,t),r++}}if(r<t.length){let n=t.slice(r);throw new ParseError(`Unexpected positional argument${n.length>1?`s`:``}: ${n.join(`, `)}`,{code:`UNEXPECTED_POSITIONAL`,details:{excess:n,expected:e.length}})}return n}function suggestFlag(e,t){let n,r=1/0,i=Math.max(2,Math.floor(e.length/2));for(let[a,o]of t){if(a.length<2||o.parity||o.negated&&o.schema.negation?.hidden===!0)continue;let t=o.schema.aliases.find(e=>e.name===a);if(a!==o.name&&!o.negated&&t?.hidden)continue;let s=levenshtein$1(e,a);s<r&&s<=i&&(r=s,n=a)}return n}function levenshtein$1(e,t){if(e===t)return 0;if(e.length===0)return t.length;if(t.length===0)return e.length;let n=e.length<=t.length?e:t,r=e.length<=t.length?t:e,i=n.length,a=r.length,o=Array.from({length:i+1},(e,t)=>t);for(let e=1;e<=a;e++){let t=o[0]??0;o[0]=e;for(let a=1;a<=i;a++){let i=n.charAt(a-1)===r.charAt(e-1)?0:1,s=Math.min((o[a]??0)+1,(o[a-1]??0)+1,t+i);t=o[a]??0,o[a]=s}}return o[i]??0}function resolvePromptConfig(e,t){if(e.kind===`confirm`||e.kind===`input`)return e;let n=e.choices??t?.map(e=>({value:e}))??[];if(n.length===0)throw Error(`Prompt config (${e.kind}) requires choices but none were provided and no enum values are available`);let r=n;return e.kind===`select`?{kind:`select`,message:e.message,choices:r}:{kind:`multiselect`,message:e.message,choices:r,...e.min===void 0?{}:{min:e.min},...e.max===void 0?{}:{max:e.max}}}function sourceLabel(e){switch(e.kind){case`stdin`:return`from stdin`;case`env`:return`from env ${e.envVar}`;case`config`:return`from config ${e.configPath}`;case`prompt`:return`from prompt`}}function sourceDetails(e){switch(e.kind){case`stdin`:return{source:`stdin`};case`env`:return{source:`env`,envVar:e.envVar};case`config`:return{source:`config`,configPath:e.configPath};case`prompt`:return{source:`prompt`}}}function suggestBySource(e,t){switch(e.kind){case`stdin`:return t.stdin;case`env`:return t.env(e.envVar);case`config`:return t.config(e.configPath);case`prompt`:return t.prompt}}function coercionError(e,t,n,r,i,a,o,s){return new ValidationError(`${a(i.text)} ${sourceLabel(t)} for flag --${e}`,{code:n,details:{flag:e,...sourceDetails(t),...i.kind===`visible`?{value:i.value}:{},expected:r,...s},suggest:o})}function diagnosticSourceOf(e){switch(e.stage){case`stdin`:return{kind:`stdin`};case`env`:return{kind:`env`,envVar:e.envVar};case`config`:return{kind:`config`,configPath:e.configPath};case`prompt`:return{kind:`prompt`}}}function coerceValue(e,t,n,r){let i=diagnosticSourceOf(t),a=flagCardinality(r);if(a.kind===`count`)return coerceCount(e,i,n,r.sensitive);if(a.kind===`one`){let a=flagValueSchema(r);return coerceValueSchema(e,i,trimmedStdinValue(t,n,a),a,r.sensitive)}return coerceCollection(a,i,t.split,n,t=>coerceValueSchema(e,i,t,flagValueSchema(r),r.sensitive),flagCollectionErrors(e,i,r.sensitive),flagAggregationErrors(e,r.sensitive))}function trimmedStdinValue(e,t,n){return e.stage!==`stdin`||!e.trim||typeof t!=`string`?t:keepsStdinTerminator(n)?stripTerminator(t):t}function coerceCount(e,t,n,r){let i=typeof n==`string`?n.trim()===``?NaN:Number(n):n;return typeof i==`number`&&Number.isInteger(i)&&i>=0?{ok:!0,value:i}:{ok:!1,error:coercionError(e,t,`TYPE_MISMATCH`,`count`,diagnosticValue(r,n),e=>`Invalid count value '${e}'`,suggestBySource(t,{stdin:`Pipe a non-negative integer to stdin for --${e}`,env:e=>`Set ${e} to a non-negative integer`,config:e=>`Set ${e} to a non-negative integer in your config`,prompt:`Enter a non-negative integer for --${e}`}))}}function sourceClause(e){return e.kind===`cli`?``:`${sourceLabel(e)} `}function aggregationSourceDetails(e){return e.kind===`cli`?{}:sourceDetails(e)}function duplicateKeyReport(e,t){let n=diagnosticValue(e,t);return n.kind===`visible`?{quoted:`'${n.text}'`,details:{key:n.value},subject:`'${n.text}'`}:{quoted:`'${n.text}'`,details:{},subject:`the repeated key`}}function coerceCollection(e,t,n,r,i,a,o){if(e.kind===`many`){let e=readManyParts(t,r,n);if(!e.ok)return{ok:!1,error:a(e.fault)};let o=[];for(let t of e.parts){let e=i(t);if(!e.ok)return e;o.push(e.value)}return{ok:!0,value:o}}let s=readEntryPairs(r,n);if(!s.ok)return{ok:!1,error:a(s.fault)};let c=[];for(let[e,t]of s.pairs){let n=i(t);if(!n.ok)return n;c.push([e,n.value])}let l=foldEntries(c,e.duplicateKeys);return l.ok?{ok:!0,value:l.value}:{ok:!1,error:o({kind:`duplicate-key`,key:l.duplicateKey},t)}}function splitFault(e,t){switch(e.kind){case`json`:return{kind:`json`,error:e.error,raw:t};case`json-shape`:return{kind:`json-shape`,expected:e.expected,raw:t};case`pair`:return{kind:`pair`,segment:e.raw}}}function readManyParts(e,t,n){if(Array.isArray(t))return{ok:!0,parts:t};if(typeof t!=`string`)return{ok:!1,fault:{kind:`shape`,expected:`array`,raw:t}};let r=splitManyText(n,t);return r.ok?{ok:!0,parts:e.kind===`prompt`?r.parts.map(trimStringPart):r.parts}:{ok:!1,fault:splitFault(r.failure,t)}}function readEntryPairs(e,t){if(isPairList(e))return{ok:!0,pairs:e};if(typeof e==`object`&&e&&!Array.isArray(e))return{ok:!0,pairs:Object.entries(e)};if(typeof e!=`string`)return{ok:!1,fault:{kind:`shape`,expected:`object`,raw:e}};let n=splitEntriesText(t,e);return n.ok?{ok:!0,pairs:n.parts}:{ok:!1,fault:splitFault(n.failure,e)}}function isPairList(e){return Array.isArray(e)&&e.every(e=>Array.isArray(e)&&e.length===2&&typeof e[0]==`string`)}function trimStringPart(e){return typeof e==`string`?e.trim():e}function thrownMessage(e){return e instanceof Error?e.message:String(e)}function flagCollectionErrors(e,t,n){return r=>{switch(r.kind){case`shape`:{let i=r.expected===`array`?`values`:`KEY=VALUE pairs`,a=diagnosticValue(n,r.raw);return coercionError(e,t,`TYPE_MISMATCH`,r.expected,a,e=>`Invalid ${r.expected} value '${e}'`,suggestBySource(t,{stdin:`Pipe ${i} to stdin for --${e}`,env:e=>`Set ${e} to comma-separated ${i}`,config:e=>`Set ${e} to an ${r.expected} in your config`,prompt:`Provide valid ${i} for --${e}`}))}case`pair`:{let i=diagnosticValue(n,r.segment);return new ValidationError(`Invalid key-value pair '${i.text}' ${sourceLabel(t)} for flag --${e}`,{code:`TYPE_MISMATCH`,details:{flag:e,...sourceDetails(t),...i.kind===`visible`?{segment:i.value}:{},expected:`key=value`},suggest:suggestBySource(t,{stdin:`Pipe KEY=VALUE pairs to stdin for --${e}`,env:e=>`Set ${e} to comma-separated KEY=VALUE pairs`,config:e=>`Set ${e} to an object with string values`,prompt:`Use KEY=VALUE for --${e}`})})}case`json`:{let i=diagnosticValue(n,r.raw),a=i.kind===`visible`?thrownMessage(r.error):void 0;return new ValidationError(`Invalid JSON value '${i.text}' ${sourceLabel(t)} for flag --${e}${a===void 0?``:`: ${a}`}`,{code:`TYPE_MISMATCH`,details:{flag:e,...sourceDetails(t),...i.kind===`visible`?{value:i.value,cause:thrownMessage(r.error)}:{},expected:`json`},suggest:`Provide valid JSON for --${e}`})}case`json-shape`:{let i=diagnosticValue(n,r.raw);return new ValidationError(`Invalid JSON value '${i.text}' ${sourceLabel(t)} for flag --${e}, expected an ${r.expected}`,{code:`TYPE_MISMATCH`,details:{flag:e,...sourceDetails(t),...i.kind===`visible`?{value:i.value}:{},expected:r.expected},suggest:`Provide a JSON ${r.expected} for --${e}`})}}}}function flagAggregationErrors(e,t){return(n,r)=>{if(n.kind===`dash-without-stdin`)return new ValidationError(`No piped stdin for the '-' occurrence of flag --${e}`,{code:`MISSING_STDIN`,details:{flag:e,source:`stdin`},suggest:`Pipe a value to stdin, or drop the '-' occurrence of --${e}`});if(n.kind===`shape`){let i=n.expected===`array`?`values`:`KEY=VALUE pairs`,a=diagnosticValue(t,n.raw);return new ValidationError(`Invalid ${n.expected} value '${a.text}' ${sourceClause(r)}for flag --${e}`,{code:`TYPE_MISMATCH`,details:{flag:e,...aggregationSourceDetails(r),...a.kind===`visible`?{value:a.value}:{},expected:n.expected},suggest:`Provide ${i} for --${e}`})}let i=duplicateKeyReport(t,n.key);return new ValidationError(`Duplicate key ${i.quoted} ${sourceClause(r)}for flag --${e}`,{code:`CONSTRAINT_VIOLATED`,details:{flag:e,...aggregationSourceDetails(r),...i.details},suggest:`Set ${i.subject} once for --${e}`})}}function argCollectionErrors(e,t,n){return r=>{switch(r.kind){case`shape`:{let i=diagnosticValue(n,r.raw);return new ValidationError(`Invalid ${r.expected} value '${i.text}' ${argSourceLabel(t)} for argument <${e}>`,{code:`TYPE_MISMATCH`,details:{arg:e,...argSourceDetails(t),...i.kind===`visible`?{value:i.value}:{},expected:r.expected},suggest:r.expected===`object`?`Use KEY=VALUE for <${e}>`:`Provide values for <${e}>`})}case`pair`:{let i=diagnosticValue(n,r.segment);return new ValidationError(`Invalid key-value pair '${i.text}' ${argSourceLabel(t)} for argument <${e}>`,{code:`TYPE_MISMATCH`,details:{arg:e,...argSourceDetails(t),...i.kind===`visible`?{segment:i.value}:{},expected:`key=value`},suggest:`Use KEY=VALUE for <${e}>`})}case`json`:{let i=diagnosticValue(n,r.raw),a=i.kind===`visible`?thrownMessage(r.error):void 0;return new ValidationError(`Invalid JSON value '${i.text}' ${argSourceLabel(t)} for argument <${e}>${a===void 0?``:`: ${a}`}`,{code:`TYPE_MISMATCH`,details:{arg:e,...argSourceDetails(t),...i.kind===`visible`?{value:i.value,cause:thrownMessage(r.error)}:{},expected:`json`},suggest:`Provide valid JSON for <${e}>`})}case`json-shape`:{let i=diagnosticValue(n,r.raw);return new ValidationError(`Invalid JSON value '${i.text}' ${argSourceLabel(t)} for argument <${e}>, expected an ${r.expected}`,{code:`TYPE_MISMATCH`,details:{arg:e,...argSourceDetails(t),...i.kind===`visible`?{value:i.value}:{},expected:r.expected},suggest:`Provide a JSON ${r.expected} for <${e}>`})}}}}function argAggregationErrors(e,t){return(n,r)=>{if(n.kind===`dash-without-stdin`)return new ValidationError(`No piped stdin for the '-' occurrence of argument <${e}>`,{code:`MISSING_STDIN`,details:{arg:e,source:`stdin`},suggest:`Pipe a value to stdin, or drop the '-' from <${e}>`});if(n.kind===`shape`){let i=diagnosticValue(t,n.raw);return new ValidationError(`Invalid ${n.expected} value '${i.text}' ${sourceClause(r)}for argument <${e}>`,{code:`TYPE_MISMATCH`,details:{arg:e,...aggregationSourceDetails(r),...i.kind===`visible`?{value:i.value}:{},expected:n.expected},suggest:`Provide KEY=VALUE pairs for <${e}>`})}let i=duplicateKeyReport(t,n.key);return new ValidationError(`Duplicate key ${i.quoted} ${sourceClause(r)}for argument <${e}>`,{code:`CONSTRAINT_VIOLATED`,details:{arg:e,...aggregationSourceDetails(r),...i.details},suggest:`Set ${i.subject} once for <${e}>`})}}function coerceValueSchema(e,t,n,r,i){let a=decodeValue(r,n,valueInputOf(t));return a.ok?{ok:!0,value:a.value}:{ok:!1,error:valueCoercionError(e,t,n,a.failure,i)}}function valueInputOf(e){return e.kind}function valueCoercionError(e,t,n,r,i){let a=diagnosticValue(i,n);switch(r.kind){case`type`:return typeCoercionError(e,t,r.expected,a);case`enum`:{let n=r.enumValues??[];return new ValidationError(`Invalid value '${a.text}' ${sourceLabel(t)} for flag --${e}. Allowed: ${n.join(`, `)}`,{code:`INVALID_ENUM`,details:{flag:e,...sourceDetails(t),...a.kind===`visible`?{value:a.value}:{},allowed:n},suggest:suggestBySource(t,{stdin:`Pipe one of: ${n.join(`, `)}`,env:e=>`Set ${e} to one of: ${n.join(`, `)}`,config:e=>`Set ${e} to one of: ${n.join(`, `)}`,prompt:`Select one of: ${n.join(`, `)}`})})}case`string-constraint`:return new ValidationError(`Invalid value '${a.text}' ${sourceLabel(t)} for flag --${e}: ${describeStringConstraintViolation(r.violation)}`,{code:`CONSTRAINT_VIOLATED`,details:{flag:e,...sourceDetails(t),...a.kind===`visible`?{value:a.value}:{},expected:`string`,...stringConstraintDetails(r.violation)},suggest:suggestBySource(t,{stdin:`Pipe a valid string to stdin for --${e}`,env:e=>`Set ${e} to a valid string`,config:e=>`Set ${e} to a valid string in your config`,prompt:`Enter a valid value for --${e}`})});case`number-constraint`:return new ValidationError(`Invalid number value '${a.text}' ${sourceLabel(t)} for flag --${e}: ${describeNumberConstraintViolation(r.violation)}`,{code:`CONSTRAINT_VIOLATED`,details:{flag:e,...sourceDetails(t),...a.kind===`visible`?{value:a.value}:{},expected:`number`,constraint:r.violation.kind,...`bound`in r.violation?{bound:r.violation.bound}:{}},suggest:suggestBySource(t,{stdin:`Pipe a valid number to stdin for --${e}`,env:e=>`Set ${e} to a valid number`,config:e=>`Set ${e} to a valid number in your config`,prompt:`Enter a valid number for --${e}`})});case`thrown`:{let n=thrownMessage(r.error);return new ValidationError(`Failed to parse ${suggestBySource(t,{stdin:`stdin`,env:e=>`env ${e}`,config:e=>`config ${e}`,prompt:`prompt`})} for flag --${e} value '${a.text}': ${n}`,{code:`TYPE_MISMATCH`,details:{flag:e,...sourceDetails(t),...a.kind===`visible`?{value:a.value}:{},expected:`custom`},suggest:suggestBySource(t,{stdin:`Pipe a valid value to stdin for --${e}`,env:t=>`Set ${t} to a valid value for --${e}`,config:t=>`Set ${t} to a valid value for --${e} in your config`,prompt:`Enter a valid value for --${e}`})})}}}function typeCoercionError(e,t,n,r){return n===`string`?coercionError(e,t,`TYPE_MISMATCH`,`string`,r,e=>`Invalid string value '${e}'`,suggestBySource(t,{stdin:`Pipe a valid string to stdin for --${e}`,env:e=>`Set ${e} to a valid string`,config:e=>`Set ${e} to a string in your config`,prompt:`Enter a valid string for --${e}`})):n===`number`?coercionError(e,t,`TYPE_MISMATCH`,`number`,r,e=>`Invalid number value '${e}'`,suggestBySource(t,{stdin:`Pipe a valid number to stdin for --${e}`,env:e=>`Set ${e} to a valid number`,config:e=>`Set ${e} to a valid number in your config`,prompt:`Enter a valid number for --${e}`})):coercionError(e,t,`TYPE_MISMATCH`,`boolean`,r,e=>`Invalid boolean value '${e}'`,suggestBySource(t,{stdin:`Pipe true/false, 1/0, or yes/no to stdin for --${e}`,env:e=>`Set ${e} to true/false, 1/0, or yes/no`,config:e=>`Set ${e} to true or false in your config`,prompt:`Answer yes or no for --${e}`}))}function argSourceLabel(e){return sourceLabel(e)}function argSourceDetails(e){return sourceDetails(e)}function buildArgCoercionSuggest(e,t,n){let r=n===`custom`?`value`:n;return suggestBySource(t,{stdin:`Pipe a valid ${r} to stdin for <${e}>`,env:t=>n===`custom`?`Set ${t} to a valid value for <${e}>`:`Set ${t} to a valid ${n}`,config:t=>`Set ${t} to a valid ${r} for <${e}>`,prompt:`Enter a valid ${r} for <${e}>`})}function argBooleanSuggest(e,t){return suggestBySource(t,{stdin:`Pipe true/false, 1/0, or yes/no to stdin for <${e}>`,env:e=>`Set ${e} to true/false, 1/0, or yes/no`,config:e=>`Set ${e} to true or false in your config`,prompt:`Answer yes or no for <${e}>`})}function argValueCoercionError(e,t,n,r,i){let a=`${argSourceLabel(t)} for argument <${e}>`,o=diagnosticValue(i,n);switch(r.kind){case`type`:return argTypeCoercionError(e,t,r.expected,o);case`enum`:{let n=r.enumValues??[],i=n.join(`, `);return new ValidationError(`Invalid value '${o.text}' ${a}. Allowed: ${i}`,{code:`INVALID_ENUM`,details:{arg:e,...argSourceDetails(t),...o.kind===`visible`?{value:o.value}:{},allowed:n},suggest:suggestBySource(t,{stdin:`Provide one of: ${i}`,env:e=>`Set ${e} to one of: ${i}`,config:e=>`Set ${e} to one of: ${i}`,prompt:`Provide one of: ${i}`})})}case`string-constraint`:return new ValidationError(`Invalid value '${o.text}' ${a}: ${describeStringConstraintViolation(r.violation)}`,{code:`CONSTRAINT_VIOLATED`,details:{arg:e,...argSourceDetails(t),...o.kind===`visible`?{value:o.value}:{},expected:`string`,...stringConstraintDetails(r.violation)},suggest:buildArgCoercionSuggest(e,t,`string`)});case`number-constraint`:return new ValidationError(`Invalid number value '${o.text}' ${a}: ${describeNumberConstraintViolation(r.violation)}`,{code:`CONSTRAINT_VIOLATED`,details:{arg:e,...argSourceDetails(t),...o.kind===`visible`?{value:o.value}:{},expected:`number`,constraint:r.violation.kind,...`bound`in r.violation?{bound:r.violation.bound}:{}},suggest:buildArgCoercionSuggest(e,t,`number`)});case`thrown`:{let n=thrownMessage(r.error);return new ValidationError(`Failed to parse ${suggestBySource(t,{stdin:`stdin`,env:e=>`env ${e}`,config:e=>`config ${e}`,prompt:`prompt`})} for argument <${e}> value '${o.text}': ${n}`,{code:`TYPE_MISMATCH`,details:{arg:e,...argSourceDetails(t),...o.kind===`visible`?{value:o.value}:{},expected:`custom`},suggest:buildArgCoercionSuggest(e,t,`custom`)})}}}function argTypeCoercionError(e,t,n,r){let i=`${argSourceLabel(t)} for argument <${e}>`,a={arg:e,...argSourceDetails(t),...r.kind===`visible`?{value:r.value}:{},expected:n};return n===`string`?new ValidationError(`Invalid string value '${r.text}' ${i}`,{code:`TYPE_MISMATCH`,details:a,suggest:buildArgCoercionSuggest(e,t,`string`)}):n===`number`?new ValidationError(`Invalid number value '${r.text}' ${i}`,{code:`TYPE_MISMATCH`,details:a,suggest:buildArgCoercionSuggest(e,t,`number`)}):new ValidationError(`Invalid boolean value '${r.text}' ${i}`,{code:`TYPE_MISMATCH`,details:a,suggest:argBooleanSuggest(e,t)})}function coerceArgValue(e,t,n,r){let i=diagnosticSourceOf(t),a=argCardinality(r);return isCollection(a)?coerceCollection(a,i,t.split,n,t=>coerceArgElement(e,i,t,r),argCollectionErrors(e,i,r.sensitive),argAggregationErrors(e,r.sensitive)):coerceArgElement(e,i,trimmedStdinValue(t,n,argValueSchema(r)),r)}function coerceArgElement(e,t,n,r){let i=decodeValue(argValueSchema(r),n,valueInputOf(t));return i.ok?{ok:!0,value:i.value}:{ok:!1,error:argValueCoercionError(e,t,n,i.failure,r.sensitive)}}function finishCliFlagValue(e,t,n,r,i){let a=flagCardinality(t);return isCollection(a)?spliceCliCollection(a,n,r,i,n=>coerceValueSchema(e,{kind:`stdin`},n,flagValueSchema(t),t.sensitive),flagCollectionErrors(e,{kind:`stdin`},t.sensitive),flagAggregationErrors(e,t.sensitive)):{kind:`value`,value:n,viaStdin:!1}}function finishCliArgValue(e,t,n,r,i){let a=argCardinality(t);return isCollection(a)?spliceCliCollection(a,n,r,i,n=>coerceArgElement(e,{kind:`stdin`},n,t),argCollectionErrors(e,{kind:`stdin`},t.sensitive),argAggregationErrors(e,t.sensitive)):{kind:`value`,value:n,viaStdin:!1}}const CLI_SOURCE={kind:`cli`},STDIN_SOURCE={kind:`stdin`};function spliceCliCollection(e,t,n,r,i,a,o){let s=liftOccurrences(e,t,r!==void 0&&stdinReadsOnDash(r)),c=readAggregated(s);if(c!==void 0)return{kind:`value`,value:c.value,viaStdin:!1};let l=[],u=0,d=!1;for(let t of s){if(t.kind!==`stdin`){l.push({occurrence:t,source:CLI_SOURCE});continue}if(u+=1,r===void 0||typeof n!=`string`)continue;let o=readStdinOccurrence(e,r.split,n,i,a);if(o.kind!==`value`)return o;d=!0;for(let e of o.occurrences)l.push({occurrence:e,source:STDIN_SOURCE})}if(u>0&&typeof n!=`string`)return u===s.length?{kind:`absent`}:{kind:`error`,error:o({kind:`dash-without-stdin`},CLI_SOURCE)};if(e.kind===`many`)return{kind:`value`,value:l.map(e=>occurrenceValue(e.occurrence)),viaStdin:d};let f=[];for(let e of l){if(e.occurrence.kind!==`entry`)return{kind:`error`,error:o({kind:`shape`,expected:`object`,raw:occurrenceValue(e.occurrence)},e.source)};f.push(e)}let p=foldEntries(entryPairsOf(f.map(e=>e.occurrence)),e.duplicateKeys);return p.ok?{kind:`value`,value:p.value,viaStdin:d}:{kind:`error`,error:o({kind:`duplicate-key`,key:p.duplicateKey},f[p.at]?.source??CLI_SOURCE)}}function readStdinOccurrence(e,t,n,r,i){let a={kind:`stdin`};if(e.kind===`many`){let e=readManyParts(a,n,t);if(!e.ok)return{kind:`error`,error:i(e.fault)};let o=[];for(let t of e.parts){let e=r(t);if(!e.ok)return{kind:`error`,error:e.error};o.push({kind:`value`,value:e.value})}return{kind:`value`,occurrences:o}}let o=readEntryPairs(n,t);if(!o.ok)return{kind:`error`,error:i(o.fault)};let s=[];for(let[e,t]of o.pairs){let n=r(t);if(!n.ok)return{kind:`error`,error:n.error};s.push({kind:`entry`,key:e,value:n.value})}return{kind:`value`,occurrences:s}}function isRecord(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function readStringProperty(e,t){let n=Reflect.get(e,t);return typeof n==`string`?n:void 0}function describeIssueSource(e){switch(readStringProperty(e,`source`)){case`stdin`:return{kind:`stdin`,label:`stdin`};case`prompt`:return{kind:`prompt`,label:`prompt`};case`env`:{let t=readStringProperty(e,`envVar`);return t===void 0?void 0:{kind:`env`,label:`env ${t}`}}case`config`:{let t=readStringProperty(e,`configPath`);return t===void 0?void 0:{kind:`config`,label:`config ${t}`}}default:return}}function summarizeValidationError(e){let t=e.details;if(!isRecord(t))return{code:e.code,inputKind:`input`,label:`input`,message:e.message};let n=readStringProperty(t,`flag`);if(n!==void 0){let r=describeIssueSource(t);return{code:e.code,inputKind:`flag`,name:n,label:`flag --${n}`,message:e.message,...r===void 0?{}:{sourceKind:r.kind,sourceLabel:r.label}}}let r=readStringProperty(t,`arg`);if(r!==void 0){let n=describeIssueSource(t);return{code:e.code,inputKind:`arg`,name:r,label:`argument <${r}>`,message:e.message,...n===void 0?{}:{sourceKind:n.kind,sourceLabel:n.label}}}return{code:e.code,inputKind:`input`,label:`input`,message:e.message}}function formatAggregateHeadline(e){let t=e.filter(e=>e.inputKind===`flag`).length,n=e.filter(e=>e.inputKind===`arg`).length,r=e.length-t-n,i=[];return t>0&&i.push(`${t} flag${t===1?``:`s`}`),n>0&&i.push(`${n} arg${n===1?``:`s`}`),r>0&&i.push(`${r} input${r===1?``:`s`}`),i.length===0?`Multiple validation errors (${e.length})`:`Multiple validation errors (${i.join(`, `)})`}function formatAggregateLine(e){let t=e.sourceLabel===void 0?``:` [${e.sourceLabel}]`;return`${e.label}${t}: ${e.message}`}function isNonEmpty(e){return e.length>0}function isValidationErrorJson(e){return!(typeof e!=`object`||!e||!(`code`in e)||!(`message`in e)||!(`exitCode`in e)||typeof e.code!=`string`||typeof e.message!=`string`||typeof e.exitCode!=`number`||`suggest`in e&&e.suggest!==void 0&&typeof e.suggest!=`string`||`details`in e&&e.details!==void 0&&(e.details===null||typeof e.details!=`object`))}function collectValidationErrors(e){let t=e.details?.errors;if(!Array.isArray(t))return[e];let n=[];for(let r of t){if(!isValidationErrorJson(r))return[e];n.push(new ValidationError(r.message,{code:r.code,exitCode:r.exitCode,...r.suggest===void 0?{}:{suggest:r.suggest},...r.details===void 0?{}:{details:r.details}}))}return n}function throwAggregatedErrors(e){if(e.length===1)throw e[0];let t=e.map(summarizeValidationError),n=t.map(formatAggregateLine);throw new ValidationError(`${formatAggregateHeadline(t)}:\n - ${n.join(`
|
|
12
|
-
- `)}`,{code:e[0].code,details:{errors:e.map(e=>e.toJSON()),count:e.length,issues:t},suggest:`Fix the listed validation errors and retry`})}function subjectLabel(e){return e.kind===`flag`?`flag --${e.name}`:`argument <${e.name}>`}function subjectReference(e){return e.kind===`flag`?`--${e.name}`:`<${e.name}>`}function subjectDetails(e){return e.kind===`flag`?{flag:e.name}:{arg:e.name}}async function validatePathChecks(e,t,n,r,i,a){let o=subjectLabel(e),s=subjectReference(e),c=subjectDetails(e),l=diagnosticValue(a,t),u;try{u=await r(t)}catch(e){if(l.kind===`redacted`)return new ValidationError(`Failed to inspect path '${l.text}' for ${o}`,{code:`CONSTRAINT_VIOLATED`,details:{...c,constraint:`stat`},suggest:`Provide an accessible path for ${s}`});let t=e instanceof Error?e.message:String(e);return new ValidationError(`Failed to inspect path '${l.text}' for ${o}: ${t}`,{code:`CONSTRAINT_VIOLATED`,details:{...c,value:l.value,constraint:`stat`,cause:t},suggest:`Provide an accessible path for ${s}`,cause:e})}if(u===null){if(n.create&&i!==void 0)try{await i(t);return}catch(e){if(l.kind===`redacted`)return new ValidationError(`Failed to create directory '${l.text}' for ${o}`,{code:`CONSTRAINT_VIOLATED`,details:{...c,constraint:`create`},suggest:`Provide a creatable or existing directory path for ${s}`});let t=e instanceof Error?e.message:String(e);return new ValidationError(`Failed to create directory '${l.text}' for ${o}: ${t}`,{code:`CONSTRAINT_VIOLATED`,details:{...c,value:l.value,constraint:`create`,cause:t},suggest:`Provide a creatable or existing directory path for ${s}`,cause:e})}return n.mustExist?new ValidationError(`Path '${l.text}' for ${o} does not exist`,{code:`CONSTRAINT_VIOLATED`,details:{...c,...l.kind===`visible`?{value:l.value}:{},constraint:`mustExist`},suggest:`Provide an existing path for ${s}`}):void 0}if(n.type!==void 0&&u!==n.type)return new ValidationError(`Path '${l.text}' for ${o} is a ${u}, expected a ${n.type}`,{code:`CONSTRAINT_VIOLATED`,details:{...c,...l.kind===`visible`?{value:l.value}:{},constraint:`pathType`,expected:n.type},suggest:`Provide a ${n.type} path for ${s}`})}function pathValuesOf(e){return typeof e==`string`?[e]:Array.isArray(e)?e.filter(e=>typeof e==`string`):typeof e==`object`&&e?Object.values(e).filter(e=>typeof e==`string`):[]}function resolveConfigPath(e,t){let n=t.split(`.`),r=e;for(let e of n){if(typeof r!=`object`||!r||!Object.hasOwn(r,e))return;r=r[e]}return r}const ABSENT={kind:`absent`};async function runStages(e,t,n){let r=stdinBindingOf(e);for(let i of e){let e=await runStage(i,r,t,n);if(e.kind!==`absent`)return e}return ABSENT}async function runStage(e,t,n,r){switch(e.stage){case`cli`:return cliStage(t,n,r);case`stdin`:return stdinStage(e,n,r);case`env`:return envStage(e,n,r);case`config`:return configStage(e,n,r);case`prompt`:return promptStage(e,n,r);case`default`:return{kind:`value`,value:e.defaultValue,provenance:{stage:`default`}}}}function cliStage(e,t,n){if(t.cli.kind===`dash`){let r=n.stdinData;return e===void 0||typeof r!=`string`?ABSENT:coerced(t,e,r,{stage:`cli`,via:`stdin`,trigger:`dash`})}if(t.cli.kind===`value`){let r=t.finishCli(t.cli.value,n.stdinData,e);return r.kind===`absent`?ABSENT:r.kind===`error`?{kind:`error`,error:r.error}:{kind:`value`,value:r.value,provenance:cliProvenance(r.viaStdin)}}return ABSENT}function cliProvenance(e){return e?{stage:`cli`,via:`stdin`,trigger:`dash`}:{stage:`cli`}}function stdinStage(e,t,n){if(!stdinReadsWhenMissing(e)||t.cli.kind!==`absent`)return ABSENT;let r=n.stdinData;return typeof r==`string`?coerced(t,e,r,{stage:`stdin`,via:`stdin`,trigger:`fallback`}):ABSENT}function envStage(e,t,n){let r=e.envVar,i=Object.hasOwn(n.env,r)?n.env[r]:void 0;return i===void 0?ABSENT:coerced(t,e,i,{stage:`env`,envVar:r})}function configStage(e,t,n){let r=e.configPath,i=resolveConfigPath(n.config,r);return i===void 0?ABSENT:coerced(t,e,i,{stage:`config`,configPath:r})}async function promptStage(e,t,n){if(!n.canPrompt)return ABSENT;let r=await t.runPrompt(e);return r.ok?{kind:`value`,value:r.value,provenance:{stage:`prompt`}}:r.error===void 0?ABSENT:{kind:`error`,error:r.error}}function coerced(e,t,n,r){let i=e.coerce(t,n);return i.ok?{kind:`value`,value:i.value,provenance:r}:{kind:`error`,error:i.error}}function readCliValue(e,t,n){if(!e||t===void 0)return{kind:`absent`};let r=stdinBindingOf(n);return t===`-`&&r!==void 0&&stdinReadsOnDash(r)?{kind:`dash`}:{kind:`value`,value:t}}async function resolveFlags(e,t,n){let r={},i=[],a=new Set,o={env:n.env,config:n.config,stdinData:n.stdinData,canPrompt:n.prompter!==void 0};for(let[s,c]of Object.entries(e)){let e=sourceBindings(c);record(s,c,await runStages(bindingsBeforePrompt(e),stageInput$1(s,c,t,e,n.prompter),o),r,i,a,n)}let s=n.interactive===void 0?void 0:n.interactive({flags:r});for(let[c,l]of Object.entries(e)){if(Object.hasOwn(r,c)||a.has(c))continue;let e=withPromptBinding(l,sourceBindings(l),effectivePromptConfig(c,l,s));if(record(c,l,await runStages(bindingsFromPrompt(e),stageInput$1(c,l,t,e,n.prompter),o),r,i,a,n),!(Object.hasOwn(r,c)||a.has(c))){if(l.kind===`array`&&l.presence!==`required`){r[c]=[],n.provenance[c]={stage:`default`};continue}if(l.kind===`keyValue`&&l.presence!==`required`){r[c]={},n.provenance[c]={stage:`default`};continue}if(l.presence===`required`){let e={flag:c,kind:l.kind};l.envVar!==void 0&&(e.envVar=l.envVar),l.configPath!==void 0&&(e.configPath=l.configPath),i.push(new ValidationError(`Missing required flag --${c}`,{code:`REQUIRED_FLAG`,details:e,suggest:buildRequiredFlagSuggest(c,l)}));continue}r[c]=void 0}}for(let[t,a]of Object.entries(e)){let e=Object.hasOwn(r,t)?r[t]:void 0,o=flagValueSchema(a).pathChecks;if(a.kind===`array`&&a.unique&&Array.isArray(e)&&(r[t]=[...dedupe(e)]),o!==void 0&&n.stat!==void 0)for(let e of pathValuesOf(Object.hasOwn(r,t)?r[t]:void 0)){let r=await validatePathChecks({kind:`flag`,name:t},e,o,n.stat,n.mkdir,a.sensitive);r!==void 0&&i.push(r)}}return isNonEmpty(i)&&throwAggregatedErrors(i),r}function stageInput$1(e,t,n,r,i){let a=Object.hasOwn(n,e);return{cli:readCliValue(a,a?n[e]:void 0,r),coerce:(n,r)=>coerceValue(e,n,r,t),finishCli:(n,r,i)=>finishCliFlagValue(e,t,n,r,i),runPrompt:async n=>i===void 0?{ok:!1,error:void 0}:resolvePromptValueWithConfig(e,t,n,i)}}function record(e,t,n,r,i,a,o){if(n.kind===`error`){i.push(n.error),a.add(e);return}n.kind!==`absent`&&(t.deprecated!==void 0&&n.provenance.stage!=="default"&&o.deprecations.push({kind:`flag`,name:e,message:t.deprecated}),r[e]=n.value,o.provenance[e]=n.provenance)}function effectivePromptConfig(e,t,n){let r=n!==void 0&&Object.hasOwn(n,e)?n[e]:void 0;if(r!==!1)return r==null||r===0||r===``?t.prompt:r}const COMPATIBLE_PROMPT_KINDS={boolean:[`confirm`],string:[`input`,`select`],number:[`input`],enum:[`select`,`input`],array:[`multiselect`],custom:[`input`,`select`,`confirm`,`multiselect`],count:[],keyValue:[]};function promptCompatibilityError(e,t,n,r){let i={...e.details,promptKind:n,allowed:r},a=`Prompt kind '${n}' is not compatible with ${t} ${e.singular} ${e.reference}.`,o=r[0];return o===void 0?new ValidationError(`${a} ${t} ${e.plural} are not promptable`,{code:`CONSTRAINT_VIOLATED`,details:i,suggest:`Remove the prompt config for ${e.reference}`}):new ValidationError(`${a} Use '${o}' instead`,{code:`CONSTRAINT_VIOLATED`,details:i,suggest:`Change the prompt to { kind: '${o}' } for ${e.reference}`})}function validatePromptFlagCompatibility(e,t,n){let r=COMPATIBLE_PROMPT_KINDS[t];if(!r.includes(n))return promptCompatibilityError({reference:`--${e}`,singular:`flag`,plural:`flags`,details:{flag:e,flagKind:t}},t,n,r)}async function resolvePromptValueWithConfig(e,t,n,r){let i=n.prompt,a=validatePromptFlagCompatibility(e,t.kind,i.kind);if(a!==void 0)return{ok:!1,error:a};let o=resolvePromptConfig(i,valueEnumValues(flagValueSchema(t))),s=await r.promptOne(o);return!s.answered||i.kind===`input`&&i.default===void 0&&typeof s.value==`string`&&s.value.trim()===``?{ok:!1,error:void 0}:coerceValue(e,n,s.value,t)}function buildRequiredFlagSuggest(e,t){let n=[],r=t.kind!==`boolean`&&t.kind!==`count`;n.push(`Provide --${e}${r?` <value>`:``}`);let i=t.stdin;if(i!==void 0&&n.push(i.when===`dash`?`pass --${e} - to read stdin`:i.when===`missing`?`pipe a value to stdin`:`pipe a value to stdin or pass --${e} -`),t.envVar!==void 0&&n.push(`set ${t.envVar}`),t.configPath!==void 0&&n.push(`add ${t.configPath} to config`),n.length<=1)return n.join(``);let a=n.slice(0,-1),o=n.slice(-1).join(``);return n.length===2?`${a.join(``)} or ${o}`:`${a.join(`, `)}, or ${o}`}async function resolveArgs(e,t,n){let r={},i=[],a={env:n.env,config:n.config,stdinData:n.stdinData,canPrompt:n.prompter!==void 0};for(let{name:o,schema:s}of e){let e=sourceBindings(s),c=await runStages(e,stageInput(o,s,t,e,n.prompter),a);if(c.kind===`error`){i.push(c.error);continue}if(c.kind===`value`){s.deprecated!==void 0&&c.provenance.stage!=="default"&&n.deprecations.push({kind:`arg`,name:o,message:s.deprecated}),r[o]=c.value,n.provenance[o]=c.provenance;continue}let l=argCardinality(s);if(l.kind===`many`||l.kind===`entries`){if(s.presence===`required`){i.push(new ValidationError(`Missing required argument <${o}>`,{code:`REQUIRED_ARG`,details:{arg:o,...s.variadic?{variadic:!0}:{}},suggest:buildRequiredArgSuggest(o,s,s.variadic)}));continue}r[o]=l.kind===`many`?[]:{},n.provenance[o]={stage:`default`};continue}if(s.presence===`required`){i.push(new ValidationError(`Missing required argument <${o}>`,{code:`REQUIRED_ARG`,details:{arg:o},suggest:buildRequiredArgSuggest(o,s)}));continue}r[o]=void 0}for(let{name:t,schema:n}of e){if(!n.unique)continue;let e=Object.hasOwn(r,t)?r[t]:void 0;Array.isArray(e)&&(r[t]=[...dedupe(e)])}if(n.stat!==void 0)for(let{name:t,schema:a}of e){let e=argValueSchema(a).pathChecks;if(e!==void 0)for(let o of pathValuesOf(Object.hasOwn(r,t)?r[t]:void 0)){let r=await validatePathChecks({kind:`arg`,name:t},o,e,n.stat,n.mkdir,a.sensitive);r!==void 0&&i.push(r)}}return isNonEmpty(i)&&throwAggregatedErrors(i),r}function stageInput(e,t,n,r,i){let a=Object.hasOwn(n,e),o=a?n[e]:void 0;return{cli:argCollectedNothing(t,o)?{kind:`absent`}:readCliValue(a,o,r),coerce:(n,r)=>coerceArgValue(e,n,r,t),finishCli:(n,r,i)=>finishCliArgValue(e,t,n,r,i),runPrompt:async n=>i===void 0?{ok:!1,error:void 0}:resolveArgPromptValue(e,t,n,i)}}function argPromptCompatibility(e){return argCardinality(e).kind===`many`?{allowed:COMPATIBLE_PROMPT_KINDS.array,kindWord:`variadic ${e.kind}`}:{allowed:COMPATIBLE_PROMPT_KINDS[e.kind],kindWord:e.kind}}async function resolveArgPromptValue(e,t,n,r){let i=n.prompt,{allowed:a,kindWord:o}=argPromptCompatibility(t);if(!a.includes(i.kind))return{ok:!1,error:promptCompatibilityError({reference:`<${e}>`,singular:`argument`,plural:`arguments`,details:{arg:e,argKind:t.kind}},o,i.kind,a)};let s=resolvePromptConfig(i,valueEnumValues(argValueSchema(t))),c=await r.promptOne(s);return!c.answered||i.kind===`input`&&i.default===void 0&&typeof c.value==`string`&&c.value.trim()===``?{ok:!1,error:void 0}:coerceArgValue(e,n,c.value,t)}function buildRequiredArgSuggest(e,t,n){let r=[n?`Provide at least one value for <${e}>`:`Provide a value for <${e}>`],i=t.stdin;return i!==void 0&&r.push(i.when===`dash`?`pass '-' to read stdin`:i.when===`missing`?`pipe a value to stdin`:`pipe a value to stdin or pass '-'`),t.envVar!==void 0&&r.push(`set ${t.envVar}`),t.configPath!==void 0&&r.push(`add ${t.configPath} to config`),r.length===1?r[0]:r.length===2?`${r[0]} or ${r[1]}`:`${r.slice(0,-1).join(`, `)}, or ${r[r.length-1]}`}function formatIssuePath(e,t){if(!(t||e===void 0||e.length===0))return e.map(e=>{let t=typeof e==`object`?e.key:e;return typeof t==`number`?String(t):diagnosticValue(!1,t).text}).join(`.`)}function issuesMessage(e,t,n){return`${e} failed validation: ${t.map(e=>{let t=formatIssuePath(e.path,n);return t===void 0?e.message:`${t}: ${e.message}`}).join(`; `)}`}async function validateValue(e,t,n,r){let i;try{i=await n[`~standard`].validate(t)}catch(n){let i=n instanceof Error?n.message:String(n),a=diagnosticValue(r,t);return{ok:!1,error:new ValidationError(`${e} validator threw: ${i}`,{code:`CONSTRAINT_VIOLATED`,...a.kind===`visible`?{details:{value:a.value,cause:i}}:{},suggest:`Fix the validator for ${e}, or provide a value it can process`})}}if(i.issues!==void 0){let n=diagnosticValue(r,t);return{ok:!1,error:new ValidationError(issuesMessage(e,i.issues,r),{code:`CONSTRAINT_VIOLATED`,details:{...n.kind===`visible`?{value:n.value}:{},issues:i.issues.map(e=>e.message)},suggest:`Provide a value for ${e} that satisfies its validator`})}}return{ok:!0,value:i.value}}function resolvedValue(e,t){return Object.hasOwn(e,t)?e[t]:void 0}async function applyStandardValidators(e,t,n){let r=[],i={...t};for(let[n,a]of Object.entries(e.flags)){let e=resolvedValue(t,n);if(e===void 0)continue;let o=await validateInput(`--${n}`,e,isCollection(flagCardinality(a)),flagValueSchema(a).standard,flagAggregateStandard(a),r,a.sensitive);o.changed&&(i[n]=o.value)}let a={...n};for(let t of e.args){let e=resolvedValue(n,t.name);if(e===void 0)continue;let i=await validateInput(`<${t.name}>`,e,isCollection(argCardinality(t.schema)),argValueSchema(t.schema).standard,argAggregateStandard(t.schema),r,t.schema.sensitive);i.changed&&(a[t.name]=i.value)}return{flags:i,args:a,errors:r}}async function validateInput(e,t,n,r,i,a,o){let s=t,c=!1,l=a.length;if(r!==void 0){let t=n?await validateElements(e,s,r,a,o):await validateOne(e,s,r,a,o);s=t.value,c||=t.changed}if(i!==void 0&&a.length===l){let t=await validateValue(e,s,i,o);t.ok?(s=t.value,c=!0):a.push(t.error)}return{changed:c,value:s}}async function validateElements(e,t,n,r,i){if(Array.isArray(t)){let a=[];for(let[o,s]of t.entries()){let t=await validateValue(`${e}[${o}]`,s,n,i);t.ok?a.push(t.value):(a.push(s),r.push(t.error))}return{changed:!0,value:a}}if(isPlainRecord(t)){let a=new Map;for(let[o,s]of Object.entries(t)){let t=await validateValue(i?e:`${e}.${diagnosticValue(!1,o).text}`,s,n,i);a.set(o,t.ok?t.value:s),t.ok||r.push(t.error)}return{changed:!0,value:Object.fromEntries(a)}}return validateOne(e,t,n,r,i)}async function validateOne(e,t,n,r,i){let a=await validateValue(e,t,n,i);return a.ok?{changed:!0,value:a.value}:(r.push(a.error),{changed:!1,value:t})}function isPlainRecord(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=Object.getPrototypeOf(e);return t===Object.prototype||t===null}async function resolve(e,t,n){let r=[],i=provenanceRecord(),a=provenanceRecord(),o={env:n?.env??{},config:n?.config??{},stdinData:n?.stdinData,prompter:n?.prompter,deprecations:r,stat:n?.stat,mkdir:n?.mkdir},s={},c={},l=[];try{s=await resolveFlags(e.flags,t.flags,{...o,interactive:e.interactive,provenance:i})}catch(e){if(!isValidationError(e))throw e;l.push(...collectValidationErrors(e))}try{c=await resolveArgs(e.args,t.args,{...o,provenance:a})}catch(e){if(!isValidationError(e))throw e;l.push(...collectValidationErrors(e))}let u=await applyStandardValidators(e,s,c);return s=u.flags,c=u.args,l.push(...u.errors),isNonEmpty(l)&&throwAggregatedErrors(l),{flags:s,args:c,deprecations:r,provenance:{flags:i,args:a}}}function provenanceRecord(){return Object.create(null)}async function executeCommand(e){let{argv:t,command:n,meta:r,options:i,out:a,schema:o}=e;clearRequestedExitCode(a);try{if(builtinEnabled(i?.builtins,`help`)&&requestsHelp(t)){if(a.jsonMode||i?.jsonMode===!0){let{generateCommandSchema:e}=await import(`./json-schema-C9SzZ7jY.mjs`).then(e=>e.a);return a.json(e(o,void 0,{name:i?.help?.binName??o.name,version:i?.help?.version})),{exitCode:0,error:void 0}}let e=formatHelp(o,i?.help?.colors===void 0?{...i?.help,colors:a.color}:i.help);return a.log(e),{exitCode:0,error:void 0}}let e=n.handler;if(e===void 0){let e=new CLIError(`Command '${o.name}' has no action handler`,{code:`NO_ACTION`,suggest:`Add an .action() handler to the '${o.name}' command`});return a.error(e.message),{exitCode:1,error:e}}await runBeforeParseHooks(i?.plugins,{argv:t,command:o,meta:r,out:a});let s=parse(o,t,i?.flags),c=i?.prompter??await scriptedPrompter(i?.answers),l=await resolve(o,s,{...i?.stdinData===void 0?{}:{stdinData:i.stdinData},...i?.env===void 0?{}:{env:i.env},...i?.config===void 0?{}:{config:i.config},...c===void 0?{}:{prompter:c},...i?.stat===void 0?{}:{stat:i.stat},...i?.mkdir===void 0?{}:{mkdir:i.mkdir}}),u={args:l.args,flags:l.flags,deprecations:l.deprecations,command:o,meta:r,out:a};await runResolvedHooks(i?.plugins,`afterResolve`,u);for(let e of l.deprecations)a.warn(formatDeprecation(e));return await runResolvedHooks(i?.plugins,`beforeAction`,u),await executeWithExecutionSteps(n,e,l,a,r),await runResolvedHooks(i?.plugins,`afterAction`,u),{exitCode:getRequestedExitCode(a)??0,error:void 0}}catch(e){if(e instanceof CLIError)return i?.jsonMode===!0?a.json({error:e.toJSON()}):(a.error(e.message),e.suggest!==void 0&&a.error(`Suggestion: ${e.suggest}`)),{exitCode:e.exitCode,error:e};let t=new CLIError(`Unexpected error: ${e instanceof Error?e.message:String(e)}`,{code:`UNEXPECTED_ERROR`,cause:e});return i?.jsonMode===!0?a.json({error:t.toJSON()}):a.error(t.message),{exitCode:1,error:t}}finally{a.stopActive(),clearRequestedExitCode(a)}}async function scriptedPrompter(e){if(e===void 0)return;let{createTestPrompter:t}=await import(`./test-prompter-v__jT2yG.mjs`).then(e=>e.r);return t(e)}async function runBeforeParseHooks(e,t){if(e!==void 0)for(let n of e){let e=n.hooks.beforeParse;e!==void 0&&await e(t)}}async function runResolvedHooks(e,t,n){if(e!==void 0)for(let r of e){let e=r.hooks[t];e!==void 0&&await e(n)}}async function executeWithExecutionSteps(e,t,n,r,i){let a=e.steps,{args:o,flags:s}=n,c=n.provenance,l=async e=>{await t({flags:s,args:o,sources:c,ctx:e,out:r,meta:i})};for(let e=a.length-1;e>=0;e--){let t=a[e];if(t===void 0)continue;let n=l;switch(t.kind){case`derive`:l=async e=>{let a=await t.handler({args:o,flags:s,sources:c,ctx:e,out:r,meta:i});if(a===void 0){await n(e);return}if(typeof a!=`object`||!a||Array.isArray(a))throw new CLIError(`derive() must return an object or undefined`,{code:`INVALID_BUILDER_STATE`,suggest:`Return an object to add context, or return nothing for validation-only derive handlers`});await n({...e,...a})};break;case`middleware`:l=async e=>{await t.handler({args:o,flags:s,sources:c,ctx:e,out:r,meta:i,next:async t=>{await n({...e,...t})}})}}}await l({})}function buildRunResult(e,t){return{exitCode:e.exitCode,stdout:t.stdout,stderr:t.stderr,activity:t.activity,error:e.error}}function formatDeprecation(e){let t=e.kind===`flag`?`flag --${e.name}`:`argument <${e.name}>`;return typeof e.message==`string`?`Warning: ${t} is deprecated: ${e.message}`:`Warning: ${t} is deprecated`}function stripTrailing(e,t){let n=e.length;for(;n>0&&t.includes(e.charCodeAt(n-1));)--n;return n===e.length?e:e.slice(0,n)}function resolveHomeDirectory(e,t){return t?e.USERPROFILE?e.USERPROFILE:e.HOMEDRIVE&&e.HOMEPATH?e.HOMEDRIVE+e.HOMEPATH:e.HOME||`C:\\`:e.HOME||`/`}function resolveConfigDirectory(e,t,n){if(t)return e.APPDATA!==void 0&&e.APPDATA!==``?e.APPDATA:`${stripTrailing(n,[47,92])||n}\\AppData\\Roaming`;let r=stripTrailing(n,[47]);return e.XDG_CONFIG_HOME!==void 0&&e.XDG_CONFIG_HOME!==``?e.XDG_CONFIG_HOME:r.length===0?`/.config`:`${r}/.config`}function isDenoErrorNamed(e,t){if(typeof e!=`object`||!e||!(`name`in e))return!1;let n=e;return typeof n.name==`string`&&n.name===t}function safeEnvToObject(e){try{return e.env.toObject()}catch(e){if(isDenoErrorNamed(e,`PermissionDenied`))return{};throw e}}function safeCwd(e){try{return e.cwd()}catch(e){if(isDenoErrorNamed(e,`PermissionDenied`))return`/`;throw e}}function createDenoAdapter(e){let t=e??getDenoNamespace(),n=new TextEncoder,r=[`deno`,`run`,...t.args],i=safeEnvToObject(t),a=safeCwd(t),o=e=>{t.stdout.writeSync(n.encode(e))},s=e=>{t.stderr.writeSync(n.encode(e))},c=createDenoReadLine(t),l=async e=>{try{return await t.readTextFile(e)}catch(e){if(isDenoErrorNamed(e,`NotFound`)||isDenoErrorNamed(e,`PermissionDenied`))return null;throw e}},u=async e=>{try{return(await t.stat(e)).isDirectory?`directory`:`file`}catch(e){if(isDenoErrorNamed(e,`NotFound`))return null;throw e}},d=resolveDenoHomedir(i,t.build.os===`windows`),f=resolveDenoConfigDir(i,d,t.build.os===`windows`),p=t.stdin.isTerminal();return{argv:r,env:i,cwd:a,stdout:o,stderr:s,stdin:c,readStdin:()=>readDenoStdinAll(t,p),isTTY:t.stdout.isTerminal(),stdinIsTTY:p,getTerminalSize:()=>readDenoTerminalSize(t),onTerminalResize:e=>onDenoTerminalResize(t,e),exit:e=>t.exit(e),readFile:l,stat:u,mkdir:e=>t.mkdir(e,{recursive:!0}),homedir:d,configDir:f,userConfigDirs:t.build.os===`darwin`?[f,`${d}/Library/Application Support`]:[f],systemConfigDirs:t.build.os===`windows`?[]:[`/etc`]}}function normalizeTerminalSize$1(e,t){if(e!==void 0&&t!==void 0&&Number.isFinite(e)&&Number.isFinite(t)&&!(e<=0||t<=0))return{columns:e,rows:t}}function readDenoTerminalSize(e){if(e.stdout.isTerminal()&&e.consoleSize!==void 0)try{let t=e.consoleSize();return normalizeTerminalSize$1(t.columns,t.rows)}catch{return}}function onDenoTerminalResize(e,t){if(e.stdout.isTerminal()&&e.build.os!==`windows`&&e.addSignalListener!==void 0&&e.removeSignalListener!==void 0){try{e.addSignalListener(`SIGWINCH`,t)}catch{return}return()=>{e.removeSignalListener?.(`SIGWINCH`,t)}}}function getDenoNamespace(){return globalThis.Deno}async function readDenoStdinAll(e,t){if(t)return null;let n=e.stdin.readable.getReader(),r=new TextDecoder,i=[];try{for(;;){let{value:e,done:t}=await n.read();if(t){i.push(r.decode());break}i.push(r.decode(e,{stream:!0}))}}finally{n.releaseLock()}return i.join(``)}function createDenoReadLine(e){let t=new TextDecoder,n=``,r=!1;return async()=>{let i=e.stdin.readable.getReader();try{for(;;){let e=n.indexOf(`
|
|
13
|
-
`);if(e!==-1){let t=n.slice(0,e).replace(/\r$/,``);return n=n.slice(e+1),t}if(r){if(n.length===0)return null;let e=n;return n=``,e}let{value:a,done:o}=await i.read();if(o){n+=t.decode(),r=!0;continue}n+=t.decode(a,{stream:!0})}}finally{i.releaseLock()}}}function resolveDenoHomedir(e,t){return resolveHomeDirectory(e,t)}function resolveDenoConfigDir(e,t,n){return resolveConfigDirectory(e,n,t)}const RUNTIMES=[`node`,`bun`,`deno`,`unknown`];function detectRuntime(e){let t=e??globalThis;return typeof t.Bun?.version==`string`?`bun`:typeof t.Deno?.version?.deno==`string`?`deno`:typeof t.process?.versions?.node==`string`?`node`:`unknown`}function getNodeProcess(){return globalThis.process}function isNodeSystemError(e){return typeof e!=`object`||!e||!(`code`in e)?!1:typeof e.code==`string`}function resolveHomedir(e,t){return resolveHomeDirectory(e,t===`win32`)}function resolveConfigDir(e,t,n){return resolveConfigDirectory(e,t===`win32`,n)}function createNodeAdapter(e){let t=e??getNodeProcess(),n=
|
|
12
|
+
- `)}`,{code:e[0].code,details:{errors:e.map(e=>e.toJSON()),count:e.length,issues:t},suggest:`Fix the listed validation errors and retry`})}function subjectLabel(e){return e.kind===`flag`?`flag --${e.name}`:`argument <${e.name}>`}function subjectReference(e){return e.kind===`flag`?`--${e.name}`:`<${e.name}>`}function subjectDetails(e){return e.kind===`flag`?{flag:e.name}:{arg:e.name}}async function validatePathChecks(e,t,n,r,i,a){let o=subjectLabel(e),s=subjectReference(e),c=subjectDetails(e),l=diagnosticValue(a,t),u;try{u=await r(t)}catch(e){if(l.kind===`redacted`)return new ValidationError(`Failed to inspect path '${l.text}' for ${o}`,{code:`CONSTRAINT_VIOLATED`,details:{...c,constraint:`stat`},suggest:`Provide an accessible path for ${s}`});let t=e instanceof Error?e.message:String(e);return new ValidationError(`Failed to inspect path '${l.text}' for ${o}: ${t}`,{code:`CONSTRAINT_VIOLATED`,details:{...c,value:l.value,constraint:`stat`,cause:t},suggest:`Provide an accessible path for ${s}`,cause:e})}if(u===null){if(n.create&&i!==void 0)try{await i(t);return}catch(e){if(l.kind===`redacted`)return new ValidationError(`Failed to create directory '${l.text}' for ${o}`,{code:`CONSTRAINT_VIOLATED`,details:{...c,constraint:`create`},suggest:`Provide a creatable or existing directory path for ${s}`});let t=e instanceof Error?e.message:String(e);return new ValidationError(`Failed to create directory '${l.text}' for ${o}: ${t}`,{code:`CONSTRAINT_VIOLATED`,details:{...c,value:l.value,constraint:`create`,cause:t},suggest:`Provide a creatable or existing directory path for ${s}`,cause:e})}return n.mustExist?new ValidationError(`Path '${l.text}' for ${o} does not exist`,{code:`CONSTRAINT_VIOLATED`,details:{...c,...l.kind===`visible`?{value:l.value}:{},constraint:`mustExist`},suggest:`Provide an existing path for ${s}`}):void 0}if(n.type!==void 0&&u!==n.type)return new ValidationError(`Path '${l.text}' for ${o} is a ${u}, expected a ${n.type}`,{code:`CONSTRAINT_VIOLATED`,details:{...c,...l.kind===`visible`?{value:l.value}:{},constraint:`pathType`,expected:n.type},suggest:`Provide a ${n.type} path for ${s}`})}function pathValuesOf(e){return typeof e==`string`?[e]:Array.isArray(e)?e.filter(e=>typeof e==`string`):typeof e==`object`&&e?Object.values(e).filter(e=>typeof e==`string`):[]}function resolveConfigPath(e,t){let n=t.split(`.`),r=e;for(let e of n){if(typeof r!=`object`||!r||!Object.hasOwn(r,e))return;r=r[e]}return r}const ABSENT={kind:`absent`};async function runStages(e,t,n){let r=stdinBindingOf(e);for(let i of e){let e=await runStage(i,r,t,n);if(e.kind!==`absent`)return e}return ABSENT}async function runStage(e,t,n,r){switch(e.stage){case`cli`:return cliStage(t,n,r);case`stdin`:return stdinStage(e,n,r);case`env`:return envStage(e,n,r);case`config`:return configStage(e,n,r);case`prompt`:return promptStage(e,n,r);case`default`:return{kind:`value`,value:e.defaultValue,provenance:{stage:`default`}}}}function cliStage(e,t,n){if(t.cli.kind===`dash`){let r=n.stdinData;return e===void 0||typeof r!=`string`?ABSENT:coerced(t,e,r,{stage:`cli`,via:`stdin`,trigger:`dash`})}if(t.cli.kind===`value`){let r=t.finishCli(t.cli.value,n.stdinData,e);return r.kind===`absent`?ABSENT:r.kind===`error`?{kind:`error`,error:r.error}:{kind:`value`,value:r.value,provenance:cliProvenance(r.viaStdin)}}return ABSENT}function cliProvenance(e){return e?{stage:`cli`,via:`stdin`,trigger:`dash`}:{stage:`cli`}}function stdinStage(e,t,n){if(!stdinReadsWhenMissing(e)||t.cli.kind!==`absent`)return ABSENT;let r=n.stdinData;return typeof r==`string`?coerced(t,e,r,{stage:`stdin`,via:`stdin`,trigger:`fallback`}):ABSENT}function envStage(e,t,n){let r=e.envVar,i=Object.hasOwn(n.env,r)?n.env[r]:void 0;return i===void 0?ABSENT:coerced(t,e,i,{stage:`env`,envVar:r})}function configStage(e,t,n){let r=e.configPath,i=resolveConfigPath(n.config,r);return i===void 0?ABSENT:coerced(t,e,i,{stage:`config`,configPath:r})}async function promptStage(e,t,n){if(!n.canPrompt)return ABSENT;let r=await t.runPrompt(e);return r.ok?{kind:`value`,value:r.value,provenance:{stage:`prompt`}}:r.error===void 0?ABSENT:{kind:`error`,error:r.error}}function coerced(e,t,n,r){let i=e.coerce(t,n);return i.ok?{kind:`value`,value:i.value,provenance:r}:{kind:`error`,error:i.error}}function readCliValue(e,t,n){if(!e||t===void 0)return{kind:`absent`};let r=stdinBindingOf(n);return t===`-`&&r!==void 0&&stdinReadsOnDash(r)?{kind:`dash`}:{kind:`value`,value:t}}async function resolveFlags(e,t,n){let r={},i=[],a=new Set,o={env:n.env,config:n.config,stdinData:n.stdinData,canPrompt:n.prompter!==void 0};for(let[s,c]of Object.entries(e)){let e=sourceBindings(c);record(s,c,await runStages(bindingsBeforePrompt(e),stageInput$1(s,c,t,e,n.prompter),o),r,i,a,n)}let s=n.interactive===void 0?void 0:n.interactive({flags:r});for(let[c,l]of Object.entries(e)){if(Object.hasOwn(r,c)||a.has(c))continue;let e=withPromptBinding(l,sourceBindings(l),effectivePromptConfig(c,l,s));if(record(c,l,await runStages(bindingsFromPrompt(e),stageInput$1(c,l,t,e,n.prompter),o),r,i,a,n),!(Object.hasOwn(r,c)||a.has(c))){if(l.kind===`array`&&l.presence!==`required`){r[c]=[],n.provenance[c]={stage:`default`};continue}if(l.kind===`keyValue`&&l.presence!==`required`){r[c]={},n.provenance[c]={stage:`default`};continue}if(l.presence===`required`){let e={flag:c,kind:l.kind};l.envVar!==void 0&&(e.envVar=l.envVar),l.configPath!==void 0&&(e.configPath=l.configPath),i.push(new ValidationError(`Missing required flag --${c}`,{code:`REQUIRED_FLAG`,details:e,suggest:buildRequiredFlagSuggest(c,l)}));continue}r[c]=void 0}}for(let[t,a]of Object.entries(e)){let e=Object.hasOwn(r,t)?r[t]:void 0,o=flagValueSchema(a).pathChecks;if(a.kind===`array`&&a.unique&&Array.isArray(e)&&(r[t]=[...dedupe(e)]),o!==void 0&&n.stat!==void 0)for(let e of pathValuesOf(Object.hasOwn(r,t)?r[t]:void 0)){let r=await validatePathChecks({kind:`flag`,name:t},e,o,n.stat,n.mkdir,a.sensitive);r!==void 0&&i.push(r)}}return isNonEmpty(i)&&throwAggregatedErrors(i),r}function stageInput$1(e,t,n,r,i){let a=Object.hasOwn(n,e);return{cli:readCliValue(a,a?n[e]:void 0,r),coerce:(n,r)=>coerceValue(e,n,r,t),finishCli:(n,r,i)=>finishCliFlagValue(e,t,n,r,i),runPrompt:async n=>i===void 0?{ok:!1,error:void 0}:resolvePromptValueWithConfig(e,t,n,i)}}function record(e,t,n,r,i,a,o){if(n.kind===`error`){i.push(n.error),a.add(e);return}n.kind!==`absent`&&(t.deprecated!==void 0&&n.provenance.stage!=="default"&&o.deprecations.push({kind:`flag`,name:e,message:t.deprecated}),r[e]=n.value,o.provenance[e]=n.provenance)}function effectivePromptConfig(e,t,n){let r=n!==void 0&&Object.hasOwn(n,e)?n[e]:void 0;if(r!==!1)return r==null||r===0||r===``?t.prompt:r}const COMPATIBLE_PROMPT_KINDS={boolean:[`confirm`],string:[`input`,`select`],number:[`input`],enum:[`select`,`input`],array:[`multiselect`],custom:[`input`,`select`,`confirm`,`multiselect`],count:[],keyValue:[]};function promptCompatibilityError(e,t,n,r){let i={...e.details,promptKind:n,allowed:r},a=`Prompt kind '${n}' is not compatible with ${t} ${e.singular} ${e.reference}.`,o=r[0];return o===void 0?new ValidationError(`${a} ${t} ${e.plural} are not promptable`,{code:`CONSTRAINT_VIOLATED`,details:i,suggest:`Remove the prompt config for ${e.reference}`}):new ValidationError(`${a} Use '${o}' instead`,{code:`CONSTRAINT_VIOLATED`,details:i,suggest:`Change the prompt to { kind: '${o}' } for ${e.reference}`})}function validatePromptFlagCompatibility(e,t,n){let r=COMPATIBLE_PROMPT_KINDS[t];if(!r.includes(n))return promptCompatibilityError({reference:`--${e}`,singular:`flag`,plural:`flags`,details:{flag:e,flagKind:t}},t,n,r)}async function resolvePromptValueWithConfig(e,t,n,r){let i=n.prompt,a=validatePromptFlagCompatibility(e,t.kind,i.kind);if(a!==void 0)return{ok:!1,error:a};let o=resolvePromptConfig(i,valueEnumValues(flagValueSchema(t))),s=await r.promptOne(o);return!s.answered||i.kind===`input`&&i.default===void 0&&typeof s.value==`string`&&s.value.trim()===``?{ok:!1,error:void 0}:coerceValue(e,n,s.value,t)}function buildRequiredFlagSuggest(e,t){let n=[],r=t.kind!==`boolean`&&t.kind!==`count`;n.push(`Provide --${e}${r?` <value>`:``}`);let i=t.stdin;if(i!==void 0&&n.push(i.when===`dash`?`pass --${e} - to read stdin`:i.when===`missing`?`pipe a value to stdin`:`pipe a value to stdin or pass --${e} -`),t.envVar!==void 0&&n.push(`set ${t.envVar}`),t.configPath!==void 0&&n.push(`add ${t.configPath} to config`),n.length<=1)return n.join(``);let a=n.slice(0,-1),o=n.slice(-1).join(``);return n.length===2?`${a.join(``)} or ${o}`:`${a.join(`, `)}, or ${o}`}async function resolveArgs(e,t,n){let r={},i=[],a={env:n.env,config:n.config,stdinData:n.stdinData,canPrompt:n.prompter!==void 0};for(let{name:o,schema:s}of e){let e=sourceBindings(s),c=await runStages(e,stageInput(o,s,t,e,n.prompter),a);if(c.kind===`error`){i.push(c.error);continue}if(c.kind===`value`){s.deprecated!==void 0&&c.provenance.stage!=="default"&&n.deprecations.push({kind:`arg`,name:o,message:s.deprecated}),r[o]=c.value,n.provenance[o]=c.provenance;continue}let l=argCardinality(s);if(l.kind===`many`||l.kind===`entries`){if(s.presence===`required`){i.push(new ValidationError(`Missing required argument <${o}>`,{code:`REQUIRED_ARG`,details:{arg:o,...s.variadic?{variadic:!0}:{}},suggest:buildRequiredArgSuggest(o,s,s.variadic)}));continue}r[o]=l.kind===`many`?[]:{},n.provenance[o]={stage:`default`};continue}if(s.presence===`required`){i.push(new ValidationError(`Missing required argument <${o}>`,{code:`REQUIRED_ARG`,details:{arg:o},suggest:buildRequiredArgSuggest(o,s)}));continue}r[o]=void 0}for(let{name:t,schema:n}of e){if(!n.unique)continue;let e=Object.hasOwn(r,t)?r[t]:void 0;Array.isArray(e)&&(r[t]=[...dedupe(e)])}if(n.stat!==void 0)for(let{name:t,schema:a}of e){let e=argValueSchema(a).pathChecks;if(e!==void 0)for(let o of pathValuesOf(Object.hasOwn(r,t)?r[t]:void 0)){let r=await validatePathChecks({kind:`arg`,name:t},o,e,n.stat,n.mkdir,a.sensitive);r!==void 0&&i.push(r)}}return isNonEmpty(i)&&throwAggregatedErrors(i),r}function stageInput(e,t,n,r,i){let a=Object.hasOwn(n,e),o=a?n[e]:void 0;return{cli:argCollectedNothing(t,o)?{kind:`absent`}:readCliValue(a,o,r),coerce:(n,r)=>coerceArgValue(e,n,r,t),finishCli:(n,r,i)=>finishCliArgValue(e,t,n,r,i),runPrompt:async n=>i===void 0?{ok:!1,error:void 0}:resolveArgPromptValue(e,t,n,i)}}function argPromptCompatibility(e){return argCardinality(e).kind===`many`?{allowed:COMPATIBLE_PROMPT_KINDS.array,kindWord:`variadic ${e.kind}`}:{allowed:COMPATIBLE_PROMPT_KINDS[e.kind],kindWord:e.kind}}async function resolveArgPromptValue(e,t,n,r){let i=n.prompt,{allowed:a,kindWord:o}=argPromptCompatibility(t);if(!a.includes(i.kind))return{ok:!1,error:promptCompatibilityError({reference:`<${e}>`,singular:`argument`,plural:`arguments`,details:{arg:e,argKind:t.kind}},o,i.kind,a)};let s=resolvePromptConfig(i,valueEnumValues(argValueSchema(t))),c=await r.promptOne(s);return!c.answered||i.kind===`input`&&i.default===void 0&&typeof c.value==`string`&&c.value.trim()===``?{ok:!1,error:void 0}:coerceArgValue(e,n,c.value,t)}function buildRequiredArgSuggest(e,t,n){let r=[n?`Provide at least one value for <${e}>`:`Provide a value for <${e}>`],i=t.stdin;return i!==void 0&&r.push(i.when===`dash`?`pass '-' to read stdin`:i.when===`missing`?`pipe a value to stdin`:`pipe a value to stdin or pass '-'`),t.envVar!==void 0&&r.push(`set ${t.envVar}`),t.configPath!==void 0&&r.push(`add ${t.configPath} to config`),r.length===1?r[0]:r.length===2?`${r[0]} or ${r[1]}`:`${r.slice(0,-1).join(`, `)}, or ${r[r.length-1]}`}function formatIssuePath(e,t){if(!(t||e===void 0||e.length===0))return e.map(e=>{let t=typeof e==`object`?e.key:e;return typeof t==`number`?String(t):diagnosticValue(!1,t).text}).join(`.`)}function issuesMessage(e,t,n){return`${e} failed validation: ${t.map(e=>{let t=formatIssuePath(e.path,n);return t===void 0?e.message:`${t}: ${e.message}`}).join(`; `)}`}async function validateValue(e,t,n,r){let i;try{i=await n[`~standard`].validate(t)}catch(n){let i=n instanceof Error?n.message:String(n),a=diagnosticValue(r,t);return{ok:!1,error:new ValidationError(`${e} validator threw: ${i}`,{code:`CONSTRAINT_VIOLATED`,...a.kind===`visible`?{details:{value:a.value,cause:i}}:{},suggest:`Fix the validator for ${e}, or provide a value it can process`})}}if(i.issues!==void 0){let n=diagnosticValue(r,t);return{ok:!1,error:new ValidationError(issuesMessage(e,i.issues,r),{code:`CONSTRAINT_VIOLATED`,details:{...n.kind===`visible`?{value:n.value}:{},issues:i.issues.map(e=>e.message)},suggest:`Provide a value for ${e} that satisfies its validator`})}}return{ok:!0,value:i.value}}function resolvedValue(e,t){return Object.hasOwn(e,t)?e[t]:void 0}async function applyStandardValidators(e,t,n){let r=[],i={...t};for(let[n,a]of Object.entries(e.flags)){let e=resolvedValue(t,n);if(e===void 0)continue;let o=await validateInput(`--${n}`,e,isCollection(flagCardinality(a)),flagValueSchema(a).standard,flagAggregateStandard(a),r,a.sensitive);o.changed&&(i[n]=o.value)}let a={...n};for(let t of e.args){let e=resolvedValue(n,t.name);if(e===void 0)continue;let i=await validateInput(`<${t.name}>`,e,isCollection(argCardinality(t.schema)),argValueSchema(t.schema).standard,argAggregateStandard(t.schema),r,t.schema.sensitive);i.changed&&(a[t.name]=i.value)}return{flags:i,args:a,errors:r}}async function validateInput(e,t,n,r,i,a,o){let s=t,c=!1,l=a.length;if(r!==void 0){let t=n?await validateElements(e,s,r,a,o):await validateOne(e,s,r,a,o);s=t.value,c||=t.changed}if(i!==void 0&&a.length===l){let t=await validateValue(e,s,i,o);t.ok?(s=t.value,c=!0):a.push(t.error)}return{changed:c,value:s}}async function validateElements(e,t,n,r,i){if(Array.isArray(t)){let a=[];for(let[o,s]of t.entries()){let t=await validateValue(`${e}[${o}]`,s,n,i);t.ok?a.push(t.value):(a.push(s),r.push(t.error))}return{changed:!0,value:a}}if(isPlainRecord(t)){let a=new Map;for(let[o,s]of Object.entries(t)){let t=await validateValue(i?e:`${e}.${diagnosticValue(!1,o).text}`,s,n,i);a.set(o,t.ok?t.value:s),t.ok||r.push(t.error)}return{changed:!0,value:Object.fromEntries(a)}}return validateOne(e,t,n,r,i)}async function validateOne(e,t,n,r,i){let a=await validateValue(e,t,n,i);return a.ok?{changed:!0,value:a.value}:(r.push(a.error),{changed:!1,value:t})}function isPlainRecord(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=Object.getPrototypeOf(e);return t===Object.prototype||t===null}async function resolve(e,t,n){let r=[],i=provenanceRecord(),a=provenanceRecord(),o={env:n?.env??{},config:n?.config??{},stdinData:n?.stdinData,prompter:n?.prompter,deprecations:r,stat:n?.stat,mkdir:n?.mkdir},s={},c={},l=[];try{s=await resolveFlags(e.flags,t.flags,{...o,interactive:e.interactive,provenance:i})}catch(e){if(!isValidationError(e))throw e;l.push(...collectValidationErrors(e))}try{c=await resolveArgs(e.args,t.args,{...o,provenance:a})}catch(e){if(!isValidationError(e))throw e;l.push(...collectValidationErrors(e))}let u=await applyStandardValidators(e,s,c);return s=u.flags,c=u.args,l.push(...u.errors),isNonEmpty(l)&&throwAggregatedErrors(l),{flags:s,args:c,deprecations:r,provenance:{flags:i,args:a}}}function provenanceRecord(){return Object.create(null)}async function executeCommand(e){let{argv:t,command:n,meta:r,options:i,out:a,schema:o}=e;clearRequestedExitCode(a);try{if(builtinEnabled(i?.builtins,`help`)&&requestsHelp(t)){if(a.jsonMode||i?.jsonMode===!0){let{generateCommandSchema:e}=await import(`./json-schema-DRlrz_IV.mjs`).then(e=>e.a);return a.json(e(o,void 0,{name:i?.help?.binName??o.name,version:i?.help?.version})),{exitCode:0,error:void 0}}let e=formatHelp(o,i?.help?.colors===void 0?{...i?.help,colors:a.color}:i.help);return a.log(e),{exitCode:0,error:void 0}}let e=n.handler;if(e===void 0){let e=new CLIError(`Command '${o.name}' has no action handler`,{code:`NO_ACTION`,suggest:`Add an .action() handler to the '${o.name}' command`});return a.error(e.message),{exitCode:1,error:e}}await runBeforeParseHooks(i?.plugins,{argv:t,command:o,meta:r,out:a});let s=parse(o,t,i?.flags),c=i?.prompter??await scriptedPrompter(i?.answers),l=await resolve(o,s,{...i?.stdinData===void 0?{}:{stdinData:i.stdinData},...i?.env===void 0?{}:{env:i.env},...i?.config===void 0?{}:{config:i.config},...c===void 0?{}:{prompter:c},...i?.stat===void 0?{}:{stat:i.stat},...i?.mkdir===void 0?{}:{mkdir:i.mkdir}}),u={args:l.args,flags:l.flags,deprecations:l.deprecations,command:o,meta:r,out:a};await runResolvedHooks(i?.plugins,`afterResolve`,u);for(let e of l.deprecations)a.warn(formatDeprecation(e));return await runResolvedHooks(i?.plugins,`beforeAction`,u),await executeWithExecutionSteps(n,e,l,a,r),await runResolvedHooks(i?.plugins,`afterAction`,u),{exitCode:getRequestedExitCode(a)??0,error:void 0}}catch(e){if(e instanceof CLIError)return i?.jsonMode===!0?a.json({error:e.toJSON()}):(a.error(e.message),e.suggest!==void 0&&a.error(`Suggestion: ${e.suggest}`)),{exitCode:e.exitCode,error:e};let t=new CLIError(`Unexpected error: ${e instanceof Error?e.message:String(e)}`,{code:`UNEXPECTED_ERROR`,cause:e});return i?.jsonMode===!0?a.json({error:t.toJSON()}):a.error(t.message),{exitCode:1,error:t}}finally{a.stopActive(),clearRequestedExitCode(a)}}async function scriptedPrompter(e){if(e===void 0)return;let{createTestPrompter:t}=await import(`./test-prompter-v__jT2yG.mjs`).then(e=>e.r);return t(e)}async function runBeforeParseHooks(e,t){if(e!==void 0)for(let n of e){let e=n.hooks.beforeParse;e!==void 0&&await e(t)}}async function runResolvedHooks(e,t,n){if(e!==void 0)for(let r of e){let e=r.hooks[t];e!==void 0&&await e(n)}}async function executeWithExecutionSteps(e,t,n,r,i){let a=e.steps,{args:o,flags:s}=n,c=n.provenance,l=async e=>{await t({flags:s,args:o,sources:c,ctx:e,out:r,meta:i})};for(let e=a.length-1;e>=0;e--){let t=a[e];if(t===void 0)continue;let n=l;switch(t.kind){case`derive`:l=async e=>{let a=await t.handler({args:o,flags:s,sources:c,ctx:e,out:r,meta:i});if(a===void 0){await n(e);return}if(typeof a!=`object`||!a||Array.isArray(a))throw new CLIError(`derive() must return an object or undefined`,{code:`INVALID_BUILDER_STATE`,suggest:`Return an object to add context, or return nothing for validation-only derive handlers`});await n({...e,...a})};break;case`middleware`:l=async e=>{await t.handler({args:o,flags:s,sources:c,ctx:e,out:r,meta:i,next:async t=>{await n({...e,...t})}})}}}await l({})}function buildRunResult(e,t){return{exitCode:e.exitCode,stdout:t.stdout,stderr:t.stderr,activity:t.activity,error:e.error}}function formatDeprecation(e){let t=e.kind===`flag`?`flag --${e.name}`:`argument <${e.name}>`;return typeof e.message==`string`?`Warning: ${t} is deprecated: ${e.message}`:`Warning: ${t} is deprecated`}var ExitError=class extends Error{name=`ExitError`;code;constructor(e){super(`Process exited with code ${e}`),this.code=e}};const noopWrite=()=>{},eofRead=()=>Promise.resolve(null),noopReadFile=()=>Promise.resolve(null),noopStat=()=>Promise.resolve(null),noopMkdir=()=>Promise.resolve();function createTestAdapter(e){let t=e?.stdinIsTTY??!1,n=t?void 0:e?.stdinData;return{argv:e?.argv??[`node`,`test`],env:e?.env??{},cwd:e?.cwd??`/test`,stdout:e?.stdout??noopWrite,stderr:e?.stderr??noopWrite,stdin:e?.stdin??eofRead,readStdin:()=>{if(n===void 0)return Promise.resolve(null);let e=n;return n=void 0,Promise.resolve(e)},isTTY:e?.isTTY??!1,stdinIsTTY:t,getTerminalSize:()=>e?.terminalSize,onTerminalResize:t=>e?.onTerminalResize?.(t),exit:e?.exit??(e=>{throw new ExitError(e)}),readFile:e?.readFile??noopReadFile,stat:e?.stat??noopStat,mkdir:e?.mkdir??noopMkdir,homedir:e?.homedir??`/home/test`,configDir:e?.configDir??`/home/test/.config`,userConfigDirs:e?.userConfigDirs??[e?.configDir??`/home/test/.config`],systemConfigDirs:e?.systemConfigDirs??[]}}async function exitAfterFlush(e,t){let n=t;try{await e.flush?.()}catch{n=t===0?1:t}return e.exit(n)}function stripTrailing(e,t){let n=e.length;for(;n>0&&t.includes(e.charCodeAt(n-1));)--n;return n===e.length?e:e.slice(0,n)}function resolveHomeDirectory(e,t){return t?e.USERPROFILE?e.USERPROFILE:e.HOMEDRIVE&&e.HOMEPATH?e.HOMEDRIVE+e.HOMEPATH:e.HOME||`C:\\`:e.HOME||`/`}function resolveConfigDirectory(e,t,n){if(t)return e.APPDATA!==void 0&&e.APPDATA!==``?e.APPDATA:`${stripTrailing(n,[47,92])||n}\\AppData\\Roaming`;let r=stripTrailing(n,[47]);return e.XDG_CONFIG_HOME!==void 0&&e.XDG_CONFIG_HOME!==``?e.XDG_CONFIG_HOME:r.length===0?`/.config`:`${r}/.config`}function isDenoErrorNamed(e,t){if(typeof e!=`object`||!e||!(`name`in e))return!1;let n=e;return typeof n.name==`string`&&n.name===t}function safeEnvToObject(e){try{return e.env.toObject()}catch(e){if(isDenoErrorNamed(e,`PermissionDenied`))return{};throw e}}function safeCwd(e){try{return e.cwd()}catch(e){if(isDenoErrorNamed(e,`PermissionDenied`))return`/`;throw e}}function createDenoAdapter(e){let t=e??getDenoNamespace(),n=new TextEncoder,r=[`deno`,`run`,...t.args],i=safeEnvToObject(t),a=safeCwd(t),o=e=>{t.stdout.writeSync(n.encode(e))},s=e=>{t.stderr.writeSync(n.encode(e))},c=createDenoReadLine(t),l=async e=>{try{return await t.readTextFile(e)}catch(e){if(isDenoErrorNamed(e,`NotFound`)||isDenoErrorNamed(e,`PermissionDenied`))return null;throw e}},u=async e=>{try{return(await t.stat(e)).isDirectory?`directory`:`file`}catch(e){if(isDenoErrorNamed(e,`NotFound`))return null;throw e}},d=resolveDenoHomedir(i,t.build.os===`windows`),f=resolveDenoConfigDir(i,d,t.build.os===`windows`),p=t.stdin.isTerminal();return{argv:r,env:i,cwd:a,stdout:o,stderr:s,stdin:c,readStdin:()=>readDenoStdinAll(t,p),isTTY:t.stdout.isTerminal(),stdinIsTTY:p,getTerminalSize:()=>readDenoTerminalSize(t),onTerminalResize:e=>onDenoTerminalResize(t,e),exit:e=>t.exit(e),readFile:l,stat:u,mkdir:e=>t.mkdir(e,{recursive:!0}),homedir:d,configDir:f,userConfigDirs:t.build.os===`darwin`?[f,`${d}/Library/Application Support`]:[f],systemConfigDirs:t.build.os===`windows`?[]:[`/etc`]}}function normalizeTerminalSize$1(e,t){if(e!==void 0&&t!==void 0&&Number.isFinite(e)&&Number.isFinite(t)&&!(e<=0||t<=0))return{columns:e,rows:t}}function readDenoTerminalSize(e){if(e.stdout.isTerminal()&&e.consoleSize!==void 0)try{let t=e.consoleSize();return normalizeTerminalSize$1(t.columns,t.rows)}catch{return}}function onDenoTerminalResize(e,t){if(e.stdout.isTerminal()&&e.build.os!==`windows`&&e.addSignalListener!==void 0&&e.removeSignalListener!==void 0){try{e.addSignalListener(`SIGWINCH`,t)}catch{return}return()=>{e.removeSignalListener?.(`SIGWINCH`,t)}}}function getDenoNamespace(){return globalThis.Deno}async function readDenoStdinAll(e,t){if(t)return null;let n=e.stdin.readable.getReader(),r=new TextDecoder,i=[];try{for(;;){let{value:e,done:t}=await n.read();if(t){i.push(r.decode());break}i.push(r.decode(e,{stream:!0}))}}finally{n.releaseLock()}return i.join(``)}function createDenoReadLine(e){let t=new TextDecoder,n=``,r=!1;return async()=>{let i=e.stdin.readable.getReader();try{for(;;){let e=n.indexOf(`
|
|
13
|
+
`);if(e!==-1){let t=n.slice(0,e).replace(/\r$/,``);return n=n.slice(e+1),t}if(r){if(n.length===0)return null;let e=n;return n=``,e}let{value:a,done:o}=await i.read();if(o){n+=t.decode(),r=!0;continue}n+=t.decode(a,{stream:!0})}}finally{i.releaseLock()}}}function resolveDenoHomedir(e,t){return resolveHomeDirectory(e,t)}function resolveDenoConfigDir(e,t,n){return resolveConfigDirectory(e,n,t)}const RUNTIMES=[`node`,`bun`,`deno`,`unknown`];function detectRuntime(e){let t=e??globalThis;return typeof t.Bun?.version==`string`?`bun`:typeof t.Deno?.version?.deno==`string`?`deno`:typeof t.process?.versions?.node==`string`?`node`:`unknown`}function getNodeProcess(){return globalThis.process}function isNodeSystemError(e){return typeof e!=`object`||!e||!(`code`in e)?!1:typeof e.code==`string`}function resolveHomedir(e,t){return resolveHomeDirectory(e,t===`win32`)}function resolveConfigDir(e,t,n){return resolveConfigDirectory(e,t===`win32`,n)}function createNodeAdapter(e){let t=e??getNodeProcess(),n=0,r=[],i=()=>{if(n!==0)return;let e=r;r=[];let i=outputFailure(t);for(let t of e)i===void 0?t.resolve():t.reject(i.error)},a=e=>t=>{n+=1;let r=!1,a=t=>{r||(r=!0,t!=null&&recordStreamError(e,t),--n,i())};try{e.write(t,a)}catch(e){throw a(),e}};watchStreamErrors(t.stdout),watchStreamErrors(t.stderr);let o=a(t.stdout),s=a(t.stderr),c=()=>new Promise((e,t)=>{r.push({resolve:e,reject:t}),i()}),l=createNodeReadLine(t),u=async e=>{let t=await import(`node:fs/promises`);try{return await t.readFile(e,`utf8`)}catch(e){if(isNodeSystemError(e)&&e.code===`ENOENT`)return null;throw e}},d=async e=>{let t=await import(`node:fs/promises`);try{return(await t.stat(e)).isDirectory()?`directory`:`file`}catch(e){if(isNodeSystemError(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return null;throw e}},f=async e=>{await(await import(`node:fs/promises`)).mkdir(e,{recursive:!0})},p=resolveHomedir(t.env,t.platform),m=resolveConfigDir(t.env,t.platform,p),h=t.platform===`darwin`?[m,`${p}/Library/Application Support`]:[m],g=t.platform===`win32`?[]:[`/etc`],_=t.stdin.isTTY===!0;return{argv:t.argv,env:t.env,cwd:t.cwd(),stdout:o,stderr:s,flush:c,stdin:l,readStdin:()=>readNodeStdinAll(t,_),isTTY:t.stdout.isTTY===!0,stdinIsTTY:_,getTerminalSize:()=>readNodeTerminalSize(t),onTerminalResize:e=>onNodeTerminalResize(t,e),exit:e=>t.exit(e),readFile:u,stat:d,mkdir:f,homedir:p,configDir:m,userConfigDirs:h,systemConfigDirs:g}}const streamStates=new WeakMap;function recordStreamError(e,t){streamStates.get(e)===void 0&&streamStates.set(e,isNodeSystemError(t)&&t.code===`EPIPE`?{kind:`closed`}:{kind:`failed`,error:t})}function watchStreamErrors(e){streamStates.has(e)||(streamStates.set(e,void 0),e.on?.(`error`,t=>recordStreamError(e,t)))}function outputFailure(e){for(let t of[e.stdout,e.stderr]){let e=streamStates.get(t);if(e?.kind===`failed`)return e}}function normalizeTerminalSize(e,t){if(e!==void 0&&t!==void 0&&Number.isFinite(e)&&Number.isFinite(t)&&!(e<=0||t<=0))return{columns:e,rows:t}}function readNodeTerminalSize(e){if(e.stdout.isTTY===!0){try{let t=e.stdout.getWindowSize?.();if(t!==void 0){let[e,n]=t,r=normalizeTerminalSize(e,n);if(r!==void 0)return r}}catch{}return normalizeTerminalSize(e.stdout.columns,e.stdout.rows)}}function onNodeTerminalResize(e,t){if(e.stdout.isTTY===!0&&e.stdout.on!==void 0){if(e.stdout.off!==void 0)return e.stdout.on(`resize`,t),()=>{e.stdout.off?.(`resize`,t)};if(e.stdout.removeListener!==void 0)return e.stdout.on(`resize`,t),()=>{e.stdout.removeListener?.(`resize`,t)}}}async function readNodeStdinAll(e,t){if(t)return null;let n=[],r=new TextDecoder;for await(let t of e.stdin)n.push(r.decode(t,{stream:!0}));return n.push(r.decode()),n.join(``)}function createNodeReadLine(e){let t=e.stdin[Symbol.asyncIterator](),n=new TextDecoder,r=``,i=!1;return async()=>{for(;;){let e=r.indexOf(`
|
|
14
14
|
`);if(e!==-1){let t=r.slice(0,e).replace(/\r$/,``);return r=r.slice(e+1),t}if(i){if(r.length===0)return null;let e=r;return r=``,e}let a=await t.next();if(a.done){r+=n.decode(),i=!0;continue}r+=n.decode(a.value,{stream:!0})}}}function isDenoNamespace(e){if(typeof e!=`object`||!e)return!1;let t=e;return Array.isArray(t.args)&&typeof t.cwd==`function`&&typeof t.exit==`function`&&typeof t.readTextFile==`function`&&typeof t.env?.get==`function`&&typeof t.env.toObject==`function`&&typeof t.stdout?.writeSync==`function`&&typeof t.stdout.isTerminal==`function`&&typeof t.stderr?.writeSync==`function`&&typeof t.stdin?.isTerminal==`function`&&typeof t.stdin?.readable?.getReader==`function`}function getInjectedDenoNamespace(e){let t=e.Deno;return isDenoNamespace(t)?t:void 0}function createAdapter(e){let t=e??globalThis,n=detectRuntime(t);switch(n){case`deno`:return createDenoAdapter(getInjectedDenoNamespace(t));case`bun`:case`node`:case`unknown`:return createNodeAdapter();default:return n}}function commandRoutes(e){return[e.name,...e.aliases]}function assertNoSiblingRouteConflict(e,t,n,r){let i=t.get(n);if(i!==void 0){let t=i===r;throw new CLIError(t?`Command '${r}' reuses route '${n}' under '${e}'`:`Duplicate command route '${n}' under '${e}' (${i} and ${r})`,{code:`DUPLICATE_COMMAND`,suggest:t?`Remove route '${n}' from the aliases of '${r}'`:`Ensure sibling command names and aliases are unique`})}t.set(n,r)}function compileCommand(e){let t=new Map,n=new Map;for(let r of e._subcommands){let i=commandRoutes(r.schema);for(let t of i)assertNoSiblingRouteConflict(e.schema.name,n,t,r.schema.name);let a=compileCommand(r);for(let e of i)t.set(e,a)}return{schema:e.schema,handler:e.handler,steps:e._executionSteps,subcommands:t}}const SHORTHAND_HOSTS={github:`https://github.com`,gitlab:`https://gitlab.com`,bitbucket:`https://bitbucket.org`};function stripGitSuffix(e){return e.endsWith(`.git`)?e.slice(0,-4):e}function packageRepositoryUrl(e,t){let n=resolveRepositoryUrl(e);if(n===void 0&&t?.require===!0)throw new CLIError(e.repository===void 0?`manifest has no 'repository' field`:`manifest 'repository' is not a recognisable locator: ${JSON.stringify(e.repository)}`,{code:`INVALID_REPOSITORY`,suggest:`Set 'repository' to a supported locator (e.g. 'github:user/repo' or 'git+https://github.com/user/repo.git'), or drop { require: true } and handle undefined`});return n}function resolveRepositoryUrl(e){let t=typeof e.repository==`string`?e.repository:e.repository?.url;if(t===void 0)return;let n=t.trim();if(n.length===0)return;let r=/^(github|gitlab|bitbucket):([^/]+\/[^/]+)$/.exec(n);if(r!==null&&r[1]!==void 0&&r[2]!==void 0){let e=SHORTHAND_HOSTS[r[1]];if(e!==void 0)return`${e}/${stripGitSuffix(r[2])}`}if(/^[\w.-]+\/[\w.-]+$/.test(n))return`https://github.com/${stripGitSuffix(n)}`;n.startsWith(`git+`)&&(n=n.slice(4));let i=/^git@([^:/]+):(.+)$/.exec(n);if(i!==null&&i[1]!==void 0&&i[2]!==void 0)return`https://${i[1]}/${stripGitSuffix(stripTrailing(i[2],[47]))}`;if(/^(?:https?|git|ssh):\/\//.test(n))try{let e=new URL(n),t=stripGitSuffix(stripTrailing(e.pathname,[47]));return`https://${e.hostname}${t}`}catch{return}}function releaseTagUrl(e,t){let n;try{n=new URL(e).hostname}catch{return}if(n===`github.com`)return`${e}/releases/tag/v${t}`;if(n===`gitlab.com`)return`${e}/-/releases/v${t}`}function deriveHelpLinks(e,t,n){if(e===void 0)return;if(t===void 0||e.name!==void 0&&e.version!==void 0)return e;let r=packageRepositoryUrl(t);return{name:e.name??r??t.homepage,version:e.version??(r!==void 0&&n!==void 0?releaseTagUrl(r,n):void 0)}}function dispatch(e,t,n=[],r=new Map,i){let a=-1;for(let t=0;t<e.length;t++){let n=e[t];if(n!==void 0){if(n===`--`){t+1<e.length&&(a=t+1);break}if(n.startsWith(`-`)){consumesFollowingToken(n,r)&&t++;continue}a=t;break}}if(a===-1)return{kind:`unknown`,input:``,candidates:uniqueCommands(t),parentPath:n};let o=e[a];if(o===void 0)return{kind:`unknown`,input:``,candidates:uniqueCommands(t),parentPath:n};let s=t.get(o);if(s===void 0)return{kind:`unknown`,input:o,candidates:uniqueCommands(t),parentPath:n};let c=[...e.slice(0,a),...e.slice(a+1)],l=[...n,s.schema];if(s.subcommands.size>0){let e=dispatch(c,s.subcommands,l,buildFlagLookup(s.schema.flags,i),i);switch(e.kind){case`match`:return e;case`unknown`:return e.input===``?s.schema.hasAction?{kind:`match`,command:s,commandPath:l,remainingArgv:c}:{kind:`needs-subcommand`,command:s,commandPath:l}:s.schema.hasAction?{kind:`match`,command:s,commandPath:l,remainingArgv:c}:e;case`needs-subcommand`:return e;default:return e}}return{kind:`match`,command:s,commandPath:l,remainingArgv:c}}function consumesFollowingToken(e,t){if(e.startsWith(`--`)){if(e.includes(`=`))return!1;let n=t.get(e.slice(2));return n!==void 0&&flagExpectsValue(n.schema)}let n=e.slice(1);for(let e=0;e<n.length;e++){let r=t.get(n.charAt(e));if(r===void 0)return!1;if(flagExpectsValue(r.schema))return e===n.length-1}return!1}function levenshtein(e,t){let n=e.length,r=t.length,i=r+1,a=new Uint16Array(i),o=new Uint16Array(i);for(let e=0;e<=r;e++)a[e]=e;for(let i=1;i<=n;i++){o[0]=i;for(let n=1;n<=r;n++){let r=e.charAt(i-1)===t.charAt(n-1)?0:1,s=a[n]??0,c=o[n-1]??0,l=a[n-1]??0;o[n]=Math.min(s+1,c+1,l+r)}[a,o]=[o,a]}return a[r]??Math.max(n,r)}function findClosestCommand(e,t){let n,r=4;for(let i of t){let t=levenshtein(e,i.schema.name);t<r&&(r=t,n=i.schema.name);for(let t of i.schema.aliases){let a=levenshtein(e,t);a<r&&(r=a,n=i.schema.name)}}return r<=3?n:void 0}function uniqueCommands(e){let t=new Set,n=[];for(let r of e.values())t.has(r)||(t.add(r),n.push(r));return n}function collectPropagatedFlags(e){if(e.length<=1)return{};let t={};for(let n=0;n<e.length-1;n++){let r=e[n];if(r!==void 0){for(let[i,a]of Object.entries(r.flags))if(a.propagate){let r=!1;for(let t=n+1;t<e.length-1;t++){let n=e[t];if(n!==void 0&&Object.hasOwn(n.flags,i)){r=!0;break}}r||(t[i]=a)}}}let n=e[e.length-1];if(n!==void 0)for(let e of Object.keys(n.flags))delete t[e];return t}const rootBooleanSchema=flag.boolean().schema,ROOT_OUTPUT_NAMES=[`json`,`quiet`];function spellingIndex(e){let t=new Map;for(let n of ROOT_OUTPUT_NAMES)for(let r of BUILTIN_SPECS[n][e])t.set(r,n);return t}const ROOT_LONG_SPELLINGS=spellingIndex(`long`),ROOT_SHORT_SPELLINGS=spellingIndex(`short`);function coerceRootValue(e,t,n){try{return{kind:`flag`,name:e,selection:coerceFlagValue(e,n,rootBooleanSchema,t)===!0?`on`:`off`}}catch(t){if(t instanceof ParseError)return{kind:`invalid`,name:e,error:t};throw t}}function ownedName(e,t,n){let r=e.get(t);if(r!==void 0&&builtinEnabled(n,r))return r}function matchRootToken(e,t){let n=ownedName(ROOT_SHORT_SPELLINGS,e,t);if(n!==void 0)return{kind:`flag`,name:n,selection:`on`};let r=ownedName(ROOT_LONG_SPELLINGS,e,t);if(r!==void 0)return{kind:`flag`,name:r,selection:`on`};let i=e.indexOf(`=`);if(i===-1)return{kind:`unrelated`};let a=e.slice(0,i),o=ownedName(ROOT_LONG_SPELLINGS,a,t);return o===void 0?{kind:`unrelated`}:coerceRootValue(o,a,e.slice(i+1))}function readRootOutputFlags(e,t){let n=e.indexOf(`--`),r=n===-1?e:e.slice(0,n),i={json:`absent`,quiet:`absent`},a=[],o=new Map,s=!1;for(let e of r){let n=matchRootToken(e,t);if(n.kind===`unrelated`){a.push(e);continue}if(s=!0,n.kind===`invalid`){o.delete(n.name),o.set(n.name,n.error);continue}i[n.name]=n.selection,o.delete(n.name)}let c=s?n===-1?a:[...a,...e.slice(n)]:e,l={json:i.json,quiet:i.quiet,argv:c},u=o.values().next().value;return u===void 0?{kind:`ok`,...l}:{kind:`failed`,...l,error:u}}function resolveRootJsonMode(e,t){return e.json===`absent`?t===!0:e.json===`on`}function resolveRootVerbosity(e,t){return e.quiet===`on`?`quiet`:e.quiet===`off`?`normal`:t}function buildMeta(e,t,n){return{name:e.name,bin:t.binName??e.name,version:e.version,command:n}}function buildRootCommandMap(e){let t=new Map,n=(e,n)=>{let r=t.get(e);if(r!==void 0)throw new CLIError(`Duplicate root command route '${e}' (${r.schema.name} and ${n.schema.name})`,{code:`DUPLICATE_COMMAND`,suggest:`Ensure root command names and aliases are unique`});t.set(e,n)};for(let t of e){n(t.schema.name,t);for(let e of t.schema.aliases)n(e,t)}return t}function mergeCommandSchema(e,t){let n=collectPropagatedFlags(t);return Object.keys(n).length===0?e.schema:{...e.schema,flags:{...n,...e.schema.flags}}}function buildCommandExecutionPlan(e){return{command:e.command,mergedSchema:mergeCommandSchema(e.command,e.commandPath),argv:e.argv,meta:e.meta,plugins:e.plugins,output:e.output,help:e.help}}function buildPlannerMatchOutcome(e,t,n,r){return{kind:`match`,plan:buildCommandExecutionPlan({command:t,commandPath:n,argv:r,meta:buildMeta(e.schema,e.help,t.schema.name),plugins:e.compiled.plugins,output:e.output,help:e.help})}}function canDelegateUnknownRootToDefault(e,t){return t===``||e.schema.args.length>0}function findUnknownFlagBeforePositional(e,t,n){let r=buildFlagLookup(t,n);for(let t=0;t<e.length;t++){let n=e[t];if(n===void 0||n===`--`||n===`-`||!n.startsWith(`-`))return;if(n.startsWith(`--`)){let e=n.indexOf(`=`),i=n.slice(2,e===-1?void 0:e),a=r.get(i);if(a===void 0)return e===-1?n:`--${i}`;e===-1&&flagExpectsValue(a.schema)&&t++;continue}let i=n.slice(1);for(let e=0;e<i.length;e++){let n=i.charAt(e),a=r.get(n);if(a===void 0)return`-${n}`;if(flagExpectsValue(a.schema)){e===i.length-1&&t++;break}}}}function scanRootHead(e,t,n){for(let r=0;r<e.length;r++){let i=e[r];if(i===void 0)continue;if(n&&(i===`--help`||i===`-h`))return{helpBeforeCommand:!0,firstCommandToken:void 0,commandTokenIndex:-1};if(i===`-`||!i.startsWith(`-`))return{helpBeforeCommand:!1,firstCommandToken:i,commandTokenIndex:r};if(i.startsWith(`--`)){let e=i.indexOf(`=`),n=i.slice(2,e===-1?void 0:e),a=t?.get(n);a!==void 0&&e===-1&&flagExpectsValue(a.schema)&&r++;continue}let a=i.slice(1);for(let e=0;e<a.length;e++){let n=t?.get(a.charAt(e));if(n!==void 0&&flagExpectsValue(n.schema)){e===a.length-1&&r++;break}}}return{helpBeforeCommand:!1,firstCommandToken:void 0,commandTokenIndex:-1}}function helpHint(e,t){return t?{suggest:`Run '${e} --help' for available commands`}:{}}function planCompletionsFlag(e,t){let n=e.indexOf(`--`),r=n===-1?e.length:n;for(let n=0;n<r;n++){let i=e[n];if(i===void 0)continue;let a;if(i===`--completions`){let t=n+1<r?e[n+1]:void 0;a=t!==void 0&&!t.startsWith(`-`)?t:void 0}else if(i.startsWith(`--completions=`))a=i.slice(14);else continue;if(a===void 0||a===``)return{kind:`root-completions`,shell:void 0,options:t.options};let o=normalizeShell(a);return o===void 0||!t.shells.includes(o)?{kind:`dispatch-error`,error:new ParseError(`Unknown shell '${a}'`,{code:`INVALID_VALUE`,suggest:`Valid shells: ${t.shells.join(`, `)}`})}:{kind:`root-completions`,shell:o,options:t.options}}}function planInvocation(e){let t=builtinEnabled(e.schema.builtins,`help`),n=readRootOutputFlags(e.argv,e.schema.builtins),r=n.argv,i=r.indexOf(`--`),a=i===-1?r:r.slice(0,i),o=e.compiled.defaultCommand,s=o===void 0?void 0:buildFlagLookup(o.schema.flags,e.schema.flagSettings);if(e.schema.version!==void 0&&(includesBeforeSeparator(e.argv,`--version`)||includesBeforeSeparator(e.argv,`-V`)))return{kind:`root-version`,version:e.schema.version};if(e.schema.completionsFlag!==void 0){let t=planCompletionsFlag(e.argv,e.schema.completionsFlag);if(t!==void 0)return t}let c=scanRootHead(a,s,t);if(c.helpBeforeCommand)return{kind:`root-help`,help:e.help};if(t&&c.firstCommandToken===`help`&&!e.compiled.commands.some(e=>e.schema.name===`help`||e.schema.aliases.includes(`help`))){let t=r.slice(c.commandTokenIndex+1);return t.length===0?{kind:`root-help`,help:e.help}:planInvocation({...e,argv:[...t,`--help`]})}if(n.kind===`failed`&&!(t&&requestsHelp(r)))return{kind:`dispatch-error`,error:n.error};if(e.compiled.commands.length===0&&o===void 0)return{kind:`dispatch-error`,error:new CLIError(`No commands registered`,{code:`NO_ACTION`,suggest:`Add commands via .command() or .default() before calling .run()`})};if(r.length===0&&o===void 0)return{kind:`root-help`,help:e.help};let l=dispatch(r,buildRootCommandMap(o!==void 0&&e.schema.defaultCommandRouted?[...e.compiled.commands,o]:e.compiled.commands),[],s,e.schema.flagSettings);switch(l.kind){case`unknown`:{if(o!==void 0&&l.parentPath.length===0){if((l.input===``?void 0:findClosestCommand(l.input,l.candidates))===void 0&&canDelegateUnknownRootToDefault(o,l.input))return buildPlannerMatchOutcome(e,o,[o.schema],r);let n=findUnknownFlagBeforePositional(r,o.schema.flags,e.schema.flagSettings);if(n!==void 0)return{kind:`dispatch-error`,error:new ParseError(`Unknown flag ${n}`,{code:`UNKNOWN_FLAG`,...helpHint(e.schema.name,t)})}}if(l.input===``){let n=r.find(e=>e.startsWith(`-`));return n===void 0?{kind:`root-help`,help:e.help}:{kind:`dispatch-error`,error:new ParseError(`Unknown flag ${n}`,{code:`UNKNOWN_FLAG`,...helpHint(e.schema.name,t)})}}let n=findClosestCommand(l.input,l.candidates),i=l.parentPath.length>0?`${e.schema.name} ${l.parentPath.map(e=>e.name).join(` `)}`:e.schema.name;return{kind:`dispatch-error`,error:new ParseError(`Unknown command: ${l.input}`,{code:`UNKNOWN_COMMAND`,...n===void 0?helpHint(i,t):{suggest:`Did you mean '${n}'?`}})}}case`needs-subcommand`:{let t=l.commandPath.slice(0,-1).map(e=>e.name);return{kind:`needs-subcommand`,command:l.command,commandPath:l.commandPath,help:{...e.help,binName:[e.schema.name,...t].join(` `)}}}case`match`:return buildPlannerMatchOutcome(e,l.command,l.commandPath,l.remainingArgv)}}function plugin(e,t){let n=Object.freeze({...e});return Object.freeze({hooks:n,name:t})}const RENAME=`Rename the flag`,STRIPPED=`The root strips that token before dispatch`;function releaseRemedy(e,...t){return[RENAME,...t,`release the built-in with .builtins({ ${e}: 'off' }) before registering the command`].join(`, or `)}const BUILTIN_EFFECTS={help:`A help request renders before flags are parsed`,json:STRIPPED,quiet:STRIPPED},BUILTIN_REMEDIES={help:releaseRemedy(`help`),json:releaseRemedy(`json`),quiet:releaseRemedy(`quiet`,`use out.status() for output that root --quiet suppresses`)},VERSION_RESERVED={rootSpelling:`--version`,effect:`The root intercepts that token before dispatch`,remedy:RENAME},VERSION_TOKENS=[`version`,`V`];function reservedTokens(e,t){let n=new Map;for(let e of BUILTIN_NAMES){if(!builtinEnabled(t,e))continue;let r={rootSpelling:builtinSpelling(e),effect:BUILTIN_EFFECTS[e],remedy:BUILTIN_REMEDIES[e]};for(let t of builtinTokens(e))n.set(t,r)}if(e!==void 0)for(let e of VERSION_TOKENS)n.set(e,VERSION_RESERVED);return n}function spellingOf(e){return e.length===1?`-${e}`:`--${e}`}function flagSpellings(e,t){let n=[[e,`name`]];for(let e of getFlagAliasNames(t,{includeHidden:!0}))n.push([e,`alias`]);let r=getFlagNegatedName(e,t);return r!==void 0&&n.push([r,`negation`]),n}function findReservedCollision(e,t){for(let[n,r]of Object.entries(e.flags))for(let[i,a]of flagSpellings(n,r)){let r=t.get(i);if(r!==void 0)return{commandName:e.name,flagName:n,spelling:spellingOf(i),origin:a,reserved:r}}for(let n of e.commands){let e=findReservedCollision(n,t);if(e!==void 0)return e}}function subjectOf(e){switch(e.origin){case`name`:return`defines a '${e.spelling}' flag`;case`alias`:return`defines a '${e.spelling}' alias on flag '${e.flagName}'`;case`negation`:return`defines a '${e.spelling}' negated spelling on flag '${e.flagName}'`}}function reservedFlagError(e){return new CLIError(`Command '${e.commandName}' ${subjectOf(e)}, which is reserved by the root '${e.reserved.rootSpelling}' flag. ${e.reserved.effect}, so the command can never receive it`,{code:`RESERVED_FLAG`,details:{command:e.commandName,flag:e.flagName},suggest:e.reserved.remedy})}function assertNoReservedFlagCollisions(e,t,n){let r=reservedTokens(e,n);for(let e of t){if(e===void 0)continue;let t=findReservedCollision(e,r);if(t!==void 0)throw reservedFlagError(t)}}function resolveRootSurface(e){let t=e.commands.filter(e=>!e.hidden),n=e.defaultCommand,r=n!==void 0&&!n.hidden?n:void 0,i=r===void 0?t:t.filter(e=>e.name!==r.name);return{visibleCommands:t,visibleSubcommands:i,visibleDefaultCommand:r,hasVisibleDefault:r!==void 0,hasVisibleSubcommands:i.length>0,defaultRouted:r!==void 0&&e.defaultCommandRouted===!0}}function formatRootHelp(e,t){let n=t?.width??80,r=t?.binName??e.name,i=t?.hyperlinks===!0,a=t?.inlineDefault??!0,o=t?.showDefaultInCommands??!1,s=resolveHelpTheme(t?.colors,t?.theme),c=resolveRootSurface(e),l=c.visibleDefaultCommand,u=!c.hasVisibleSubcommands&&e.completionsFlag===void 0,d=a||u?l:void 0,f=resolveSurfaceCommand(e,d),p=f!==void 0,m=[formatHeader(e,i,s)];e.description!==void 0&&m.push(e.description);let h=c.hasVisibleSubcommands?l===void 0?`<command>`:`[command]`:``,g=s.sectionTitle(`Usage:`),_=h.length>0?`${g} ${s.usageBin(r)} ${s.placeholder(h)} ${s.placeholder(`[options]`)}`:`${g} ${s.usageBin(r)} ${s.placeholder(`[options]`)}`,v=[];p&&f!==void 0&&(v=[...formatHelpSections(f,{...t,binName:r,isDefaultHelp:!0})]);let y=v.shift();p&&y!==void 0&&d!==void 0?m.push(c.hasVisibleSubcommands?mergeUsageSections(_,y,g):y):m.push(_);let b=l!==void 0&&(c.defaultRouted||o),x=b?[...c.visibleSubcommands,l]:c.visibleSubcommands;x.length>0&&m.push(formatRootCommandsSection(x,b?l?.name:void 0,n,s)),p&&f!==void 0&&(f.description!==void 0&&f.description===e.description&&v[0]===f.description&&v.shift(),m.push(...v));let S=formatGlobalOptionsSection(e,n,s);if(S.length>0&&m.push(S),builtinEnabled(e.builtins,`help`)&&(t?.footer??c.hasVisibleSubcommands)){let e=c.hasVisibleSubcommands?l===void 0?` <command>`:` [command]`:``;m.push(`Run '${r}${e} --help' for more information.`)}return`${m.join(`
|
|
15
15
|
|
|
16
16
|
`)}\n`}function resolveSurfaceCommand(e,t){if(e.completionsFlag===void 0)return t;let n=t??command(e.name).schema;return{...n,flags:{completions:completionsFlagSchema(e.completionsFlag.shells),...n.flags}}}function completionsFlagSchema(e){return createFlagSchema(`enum`,{description:`Print a shell completion script and exit`,enumValues:e})}function formatHeader(e,t,n){let r=t?e.helpLinks:void 0,i=n.headerName(e.name),a=r?.name===void 0?i:osc8(r.name,i);if(e.version===void 0)return a;let o=n.headerVersion(`v${e.version}`);return`${a} ${r?.version===void 0?o:osc8(r.version,o)}`}function formatRootCommandsSection(e,t,n,r){let i=[r.sectionTitle(`Commands:`)],a=0;for(let n of e){let e=n.name===t?10:0,r=n.name.length+e;r>a&&(a=r)}let o=2+a+2;for(let a of e){let e=padEnd(` ${a.name===t?`${r.command(a.name)}${r.annotation(` (default)`)}`:r.command(a.name)}`,o),s=a.description??``;s.length===0?i.push(e.trimEnd()):i.push(`${e}${wrapText(s,n,o)}`)}return i.join(`
|
|
17
|
-
`)}function formatGlobalOptionsSection(e,t,n){let r=[],i=t=>{builtinEnabled(e.builtins,t)&&r.push({left:n.flag(builtinFlagForms(t)),description:BUILTIN_SPECS[t].description})};for(let t of BUILTIN_NAMES)i(t),t===`help`&&e.version!==void 0&&r.push({left:n.flag(`-V, --version`),description:`Print the version number and exit`});return e.configSettings!==void 0&&r.push({left:`${n.flag(`--config`)} ${n.placeholder(`<path>`)}`,description:`Load configuration from the given file`}),r.length===0?``:formatFlagEntriesBlock(n.sectionTitle(`Global options:`),r,t)}function mergeUsageSections(e,t,n){let r=`${n} `,i=t.startsWith(r)?t.slice(r.length):t;return`${e}\n${` `.repeat(7)}${i}`}const PRECHECK_OUTPUT={jsonMode:!1,isTTY:!1,verbosity:`normal`};function extractConfigFlag(e){let t=[],n;for(let r=0;r<e.length;r+=1){let i=e[r];if(i!==void 0){if(i===`--`){t.push(...e.slice(r));break}if(n===void 0&&i.startsWith(`--config=`)){let e=i.slice(9);if(e.length>0){n=e;continue}t.push(i);continue}if(n===void 0&&i===`--config`){let a=e[r+1];if(a!==void 0&&!a.startsWith(`-`)&&a!==`--`){n=a,r+=1;continue}t.push(i);continue}t.push(i)}}return{configPath:n,filteredArgv:t}}function commandInvocationNeedsStdin(e,t,n,r){if(builtinEnabled(r,`help`)&&(t.includes(`--help`)||t.includes(`-h`)))return!1;try{let r=parse(e,t,n);return invocationSelectsStdin(e.flags,e.args,r)}catch(e){if(e instanceof ParseError)return!1;throw e}}function invocationNeedsStdin(e,t,n){let r=planInvocation({schema:e,compiled:t,argv:n,help:{binName:e.name},output:PRECHECK_OUTPUT});switch(r.kind){case`match`:return commandInvocationNeedsStdin(r.plan.mergedSchema,r.plan.argv,e.flagSettings,e.builtins);case`dispatch-error`:case`needs-subcommand`:case`root-help`:case`root-version`:case`root-completions`:return!1}}function isCompletionsInvocation(e,t,n){if(!e.hasBuiltInCompletions)return!1;let r=planInvocation({schema:e,compiled:t,argv:n,help:{binName:e.name},output:PRECHECK_OUTPUT});return r.kind===`root-completions`||r.kind===`match`&&r.plan.command.schema.name===`completions`}async function discoverManifestData(e,t){let{discoverManifest:n}=await import(`./package-json-BgE9YjjQ.mjs`).then(e=>e.r);return n(e,{...t.from===void 0?{}:{startDir:t.from},files:t.files})}async function inferManifestCliName(e,t){let{inferCliName:n}=await import(`./package-json-BgE9YjjQ.mjs`).then(e=>e.r);return n(e,{stripScope:t})}async function applyPackageJsonDiscovery(e,t,n,r){let i=e.packageJsonSettings,a=i!==void 0&&!r?await(async()=>{let n=i.data??await discoverManifestData(t,i);if(n===null)return e;let r=i.inferName?await inferManifestCliName(n,i.stripScope):void 0;return{...e,...e.version===void 0&&n.version!==void 0?{version:n.version}:{},...e.description===void 0&&n.description!==void 0?{description:n.description}:{},...r===void 0?{}:{name:r},helpLinks:deriveHelpLinks(e.helpLinks,n,e.version??n.version)}})():e;return n===void 0?a:{...a,name:n}}function discoveredVersionCollision(e,t,n){if(e.version!==t.version)try{assertNoReservedFlagCollisions(e.version,[n.defaultCommand?.schema,...n.commands.map(e=>e.schema)],e.builtins);return}catch(e){if(e instanceof CLIError)return e;throw e}}async function loadRuntimeConfig(e,t,n,r,i){if(e.configSettings===void 0||r||i!==void 0)return i;try{let{discoverConfig:r}=await import(`./config-B9ddC-Kb.mjs`).then(e=>e.r),i=await r(e.configSettings.appName,t,{...n===void 0?{}:{configPath:n},...e.configSettings.loaders===void 0?{}:{loaders:e.configSettings.loaders}});return i.found?i.data:void 0}catch(e){if(e instanceof CLIError)return e;throw e}}function createLazyTerminalPrompter(e){let t;return{async promptOne(n){return t??=import(`./terminal-C8KTXjv5.mjs`).then(e=>e.n).then(({createTerminalPrompter:t})=>t(e.stdin,e.stderr)),(await t).promptOne(n)}}}async function prepareRuntimePreflight(e){let t=e.adapter.argv.slice(2),{configPath:n,filteredArgv:r}=e.schema.configSettings===void 0?{configPath:void 0,filteredArgv:t}:extractConfigFlag(t),i=readRootOutputFlags(r,e.schema.builtins),a=resolveRootJsonMode(i,e.options?.jsonMode),o=resolveRootVerbosity(i,e.options?.verbosity)??`normal`,s=isCompletionsInvocation(e.schema,e.compiled,r),c=await applyPackageJsonDiscovery(e.schema,e.adapter,e.inheritedName,s),l=discoveredVersionCollision(c,e.schema,e.compiled);if(l!==void 0)return{kind:`startup-error`,error:l,jsonMode:a};let u=await loadRuntimeConfig(c,e.adapter,n,s,e.options?.config);if(u instanceof CLIError)return{kind:`startup-error`,error:u,jsonMode:a};let d=e.options?.prompter===void 0&&e.adapter.stdinIsTTY?createLazyTerminalPrompter(e.adapter):void 0,f=e.options?.stdinData===void 0&&invocationNeedsStdin(c,e.compiled,r)?await e.adapter.readStdin():e.options?.stdinData;return{kind:`ready`,schema:c,filteredArgv:r,inputs:{env:e.options?.env??e.adapter.env,isTTY:e.options?.isTTY??e.adapter.isTTY,jsonMode:a,verbosity:o,stat:e.options?.stat??e.adapter.stat,mkdir:e.options?.mkdir??e.adapter.mkdir,...f===void 0?{}:{stdinData:f},...e.options?.prompter===void 0?d===void 0?{}:{prompter:d}:{prompter:e.options.prompter},...u===void 0?{}:{config:u}}}}const COMPLETIONS_FLAG_NAME=`completions`;function commandReservesCompletionsFlag(e){if(Object.hasOwn(e.flags,COMPLETIONS_FLAG_NAME))return!0;for(let[t,n]of Object.entries(e.flags))if(getFlagAliasNames(n,{kind:`long`,includeHidden:!0}).includes(COMPLETIONS_FLAG_NAME)||getFlagNegatedName(t,n)===COMPLETIONS_FLAG_NAME)return!0;return e.commands.some(commandReservesCompletionsFlag)}function assertNoCompletionsFlagCollision(e){if(commandReservesCompletionsFlag(e))throw new CLIError(`Command '${e.name}' defines a '--${COMPLETIONS_FLAG_NAME}' flag, which is reserved by .completions({ as: 'flag' })`,{code:`RESERVED_FLAG`,suggest:`Rename the flag, or register completions as a subcommand with .completions() instead of { as: 'flag' }`})}function assertNoTopLevelRouteConflict(e,t,n){let r=new Map,i=n===void 0?e:[...e,n];for(let e of i)for(let t of commandRoutes(e))assertNoSiblingRouteConflict(`root`,r,t,e.name);for(let e of commandRoutes(t)){let n=r.get(e);if(n!==void 0)throw new CLIError(`Command route '${e}' is already registered by '${n}'`,{code:`DUPLICATE_COMMAND`,suggest:n===t.name?`Ensure command '${t.name}' does not reuse route '${e}'`:`Rename '${t.name}' or remove route '${e}' from '${n}'`});r.set(e,t.name)}}const compiledStates=new WeakMap;function compiledStateOf(e){let t=compiledStates.get(e);if(t===void 0)throw new CLIError(`CLI builder carries no compiled command graph`,{code:`INVALID_BUILDER_STATE`,suggest:`Create CLI builders with cli()`});return t}function rebuild(e,t){return CLIBuilder._from(t,compiledStateOf(e))}function completionGeneratorOptions(e){if(e!==void 0)return{...e.functionPrefix===void 0?{}:{functionPrefix:e.functionPrefix},...e.rootMode===void 0?{}:{rootMode:e.rootMode}}}function sealCLISchema(e){return e}function buildCLISchema(e){let t=e.configSettings;return sealCLISchema({name:e.name,inheritName:e.inheritName??!1,version:e.version,description:e.description,commands:(e.commands??[]).map(e=>createCommandSchema(e)),defaultCommand:e.defaultCommand===void 0?void 0:createCommandSchema(e.defaultCommand),defaultCommandRouted:e.defaultCommandRouted??!1,configSettings:t===void 0?void 0:{appName:t.appName,loaders:t.loaders},packageJsonSettings:e.packageJsonSettings,helpLinks:e.helpLinks,hasBuiltInCompletions:e.hasBuiltInCompletions??!1,completionsFlag:e.completionsFlag,helpConfig:e.helpConfig,flagSettings:e.flagSettings,builtins:normalizeBuiltins(e.builtins)})}function createCLISchema(e){if(e.name===``)throw new CLIError(`CLI schema requires a non-empty name`,{code:`INVALID_SCHEMA`,details:{name:e.name},suggest:`Pass a program name such as { name: "mycli" }`});let t=buildCLISchema(e),n=[];for(let e of t.commands)assertNoTopLevelRouteConflict(n,e),n.push(e);let r=e.defaultCommand!==void 0&&e.commands?.includes(e.defaultCommand)===!0;t.defaultCommand!==void 0&&!r&&assertNoTopLevelRouteConflict(n,t.defaultCommand);let i=[t.defaultCommand,...t.commands];if(assertNoReservedFlagCollisions(t.version,i,t.builtins),t.completionsFlag!==void 0)for(let e of i)e!==void 0&&assertNoCompletionsFlagCollision(e);return t}var ResolvedRenderContext=class{jsonMode;verbosity;isTTY;color;isHyperlinkSupported;constructor(e){this.jsonMode=e.jsonMode,this.verbosity=e.verbosity,this.isTTY=e.isTTY,this.color=e.color,this.isHyperlinkSupported=e.isHyperlinkSupported}};function resolveRenderContext(e,t){let n=readRootOutputFlags(e,t?.builtins),r=resolveRootJsonMode(n,t?.jsonMode),i=resolveRootVerbosity(n,t?.verbosity)??`normal`;return new ResolvedRenderContext(createOutput({jsonMode:r,isTTY:t?.isTTY??!1,verbosity:i,...t?.color===void 0?{}:{color:t.color},...hyperlinksOption(resolveHyperlinkOverride(t?.env??{},e))}))}function hyperlinksOption(e){return e===void 0?{}:{hyperlinks:e}}function resolveEffectiveHyperlinkOverride(e,t,n,r){return e?.hyperlinks??t?.hyperlinks??resolveHyperlinkOverride(n,r)}function buildCommandRunOptions(e,t,n){return{help:t,...n===void 0?{}:{meta:n},...e?.plugins===void 0?{}:{plugins:e.plugins},...e?.builtins===void 0?{}:{builtins:e.builtins},...e?.env===void 0?{}:{env:e.env},...e?.config===void 0?{}:{config:e.config},...e?.stdinData===void 0?{}:{stdinData:e.stdinData},...e?.prompter===void 0?{}:{prompter:e.prompter},...e?.answers===void 0?{}:{answers:e.answers},...e?.stat===void 0?{}:{stat:e.stat},...e?.mkdir===void 0?{}:{mkdir:e.mkdir},...e?.verbosity===void 0?{}:{verbosity:e.verbosity},...e?.jsonMode===void 0?{}:{jsonMode:e.jsonMode},...e?.isTTY===void 0?{}:{isTTY:e.isTTY},...e?.out===void 0?{}:{out:e.out},...e?.captured===void 0?{}:{captured:e.captured},...e?.flags===void 0?{}:{flags:e.flags}}}var CLIBuilder=class e{schema;constructor(e){this.schema=e}static _from(t,n){let r=new e(t);return compiledStates.set(r,n),r}version(e){return assertNoReservedFlagCollisions(e,[this.schema.defaultCommand,...this.schema.commands],this.schema.builtins),rebuild(this,{...this.schema,version:e})}builtins(e){let t={...e.help===void 0?{}:{help:e.help},...e.json===void 0?{}:{json:e.json},...e.quiet===void 0?{}:{quiet:e.quiet}},n=normalizeBuiltins({...this.schema.builtins,...t});return assertNoReservedFlagCollisions(this.schema.version,[this.schema.defaultCommand,...this.schema.commands],n),rebuild(this,sealCLISchema({...this.schema,builtins:n}))}description(e){return rebuild(this,{...this.schema,description:e})}links(e){return rebuild(this,{...this.schema,helpLinks:{name:toUrlString(e?.name),version:toUrlString(e?.version)}})}help(e){return rebuild(this,{...this.schema,helpConfig:{...this.schema.helpConfig,...e}})}config(e,t){return rebuild(this,sealCLISchema({...this.schema,configSettings:{appName:e,loaders:t}}))}configLoader(e){if(this.schema.configSettings===void 0)throw new CLIError(`.configLoader() requires .config() to be called first`,{code:`INVALID_BUILDER_STATE`,suggest:`Call .config(appName) before .configLoader()`});let t=this.schema.configSettings.loaders??[];return rebuild(this,sealCLISchema({...this.schema,configSettings:{...this.schema.configSettings,loaders:[...t,e]}}))}manifest(e){let t=buildManifestSchema(this.schema,e,DEFAULT_MANIFEST_FILES);return assertNoReservedFlagCollisions(t.version,[t.defaultCommand,...t.commands],t.builtins),rebuild(this,t)}command(t){assertNoTopLevelRouteConflict(this.schema.commands,t.schema,this.schema.defaultCommand),assertNoReservedFlagCollisions(this.schema.version,[t.schema],this.schema.builtins),this.schema.completionsFlag!==void 0&&assertNoCompletionsFlagCollision(t.schema);let n=compiledStateOf(this);return e._from({...this.schema,commands:[...this.schema.commands,t.schema]},{...n,commands:[...n.commands,compileCommand(t)]})}default(t,n){if(this.schema.defaultCommand!==void 0)throw new CLIError(`Only one default command is allowed`,{code:`DUPLICATE_DEFAULT`,suggest:`Call .default() only once when building the CLI`});assertNoTopLevelRouteConflict(this.schema.commands,t.schema),assertNoReservedFlagCollisions(this.schema.version,[t.schema],this.schema.builtins),this.schema.completionsFlag!==void 0&&assertNoCompletionsFlagCollision(t.schema);let r=compiledStateOf(this);return e._from({...this.schema,defaultCommand:t.schema,defaultCommandRouted:n?.route??!1},{...r,defaultCommand:compileCommand(t)})}plugin(t){let n=compiledStateOf(this);return e._from(this.schema,{...n,plugins:[...n.plugins,t]})}completions(e){if(this.schema.hasBuiltInCompletions)throw new CLIError(`.completions() has already been called`,{code:`DUPLICATE_COMMAND`,suggest:`Call .completions() only once when building the CLI`});if(e?.as===`flag`){this.schema.defaultCommand!==void 0&&assertNoCompletionsFlagCollision(this.schema.defaultCommand);for(let e of this.schema.commands)assertNoCompletionsFlagCollision(e);return rebuild(this,{...this.schema,hasBuiltInCompletions:!0,completionsFlag:{shells:SHELLS,options:completionGeneratorOptions(e)}})}let t=this.schema,n=completionGeneratorOptions(e),r=command(`completions`).alias(`completion`).description(`Generate shell completion script`).arg(`shell`,arg.custom(e=>{let t=normalizeShell(e);if(t===void 0)throw Error(`Unknown shell '${e}'. Valid shells: ${SHELLS.join(`, `)}`);return t}).env(`SHELL`).describe(`Target shell (${SHELLS.join(`, `)})`)).action(async({args:e,meta:r,out:i})=>{let a=r.bin===t.name?t:{...t,name:r.bin},{generateCompletion:o}=await import(`./completion-D4mz6axB.mjs`).then(e=>e.t),s=o(a,e.shell,n);i.jsonMode?i.json({shell:e.shell,script:s}):i.log(s)}),i=this.command(r);return rebuild(i,{...i.schema,hasBuiltInCompletions:!0})}async execute(e,t){return executeCLI(this,e,t)}async run(e){let t=e?.adapter??createAdapter(),n=this.schema.inheritName?inferInvocationName(t.argv):void 0,r=compiledStateOf(this),i=await prepareRuntimePreflight({schema:this.schema,compiled:r,adapter:t,options:e,inheritedName:n});if(i.kind===`startup-error`)return i.jsonMode?t.stdout(`${JSON.stringify({error:i.error.toJSON()})}\n`):(t.stderr(`Error: ${i.error.message}\n`),i.error.suggest!==void 0&&t.stderr(`Suggestion: ${i.error.suggest}\n`)),t.exit(i.error.exitCode);let a=i.schema===this.schema?this:rebuild(this,sealCLISchema({...this.schema,...i.schema})),o=t.getTerminalSize(),s=e?.help?.width===void 0&&i.schema.helpConfig?.width===void 0?o?.columns:void 0,c=s===void 0?e?.help:{...e?.help,width:s},l=resolveEffectiveHyperlinkOverride(c,a.schema.helpConfig,t.env,t.argv),u={...e,...i.inputs,...c===void 0?{}:{help:c},out:createOutput({stdout:t.stdout,stderr:t.stderr,jsonMode:i.inputs.jsonMode,isTTY:i.inputs.isTTY,...i.inputs.verbosity===`normal`?{}:{verbosity:i.inputs.verbosity},...hyperlinksOption(l)})},d=await executeCLI(a,i.filteredArgv,u);for(let e of d.stdout)t.stdout(e);for(let e of d.stderr)t.stderr(e);return t.exit(d.exitCode)}};async function executeCLI(e,t,n){let r=readRootOutputFlags(t,e.schema.builtins),i=resolveRootJsonMode(r,n?.jsonMode),a=resolveRootVerbosity(r,n?.verbosity),o=resolveEffectiveHyperlinkOverride(n?.help,e.schema.helpConfig,n?.env??{},t),s={...a===void 0?{}:{verbosity:a},...i?{jsonMode:i}:{},...n?.isTTY===void 0?{}:{isTTY:n.isTTY},...hyperlinksOption(o)},c,l;n?.out===void 0?[c,l]=createCaptureOutput(Object.keys(s).length>0?s:void 0):(c=n.out,l=n.captured??{stdout:[],stderr:[],activity:[]}),clearRequestedExitCode(c);let u=n?.help?.version??e.schema.version,d={...e.schema.helpConfig,...n?.help,binName:n?.help?.binName??e.schema.name,hyperlinks:c.isHyperlinkSupported,colors:n?.help?.colors??c.color,...u===void 0?{}:{version:u}},f=compiledStateOf(e),p=n?.flags??e.schema.flagSettings,m={...n,plugins:f.plugins,builtins:e.schema.builtins,...i?{jsonMode:i}:{},...a===void 0?{}:{verbosity:a},...p===void 0?{}:{flags:p}},h={jsonMode:i,isTTY:c.isTTY,verbosity:a??`normal`},g=planInvocation({schema:n?.flags===void 0?e.schema:{...e.schema,flagSettings:p},compiled:f,argv:t,help:d,output:h});switch(g.kind){case`root-version`:return c.log(g.version),buildRunResult({exitCode:0,error:void 0},l);case`root-completions`:{let t=g.shell??detectShell(n?.env??{});if(t===void 0){let e=new CLIError(`Could not detect shell`,{code:`MISSING_VALUE`,suggest:`Pass one explicitly, e.g. '${d.binName} --completions zsh'`});return i?c.json({error:e.toJSON()}):(c.error(e.message),c.error(`Suggestion: ${e.suggest}`)),buildRunResult({exitCode:e.exitCode,error:e},l)}let r=d.binName===void 0||d.binName===e.schema.name?e.schema:{...e.schema,name:d.binName},{generateCompletion:a}=await import(`./completion-D4mz6axB.mjs`).then(e=>e.t),o=a(r,t,g.options);return i?c.json({shell:t,script:o}):c.log(o),buildRunResult({exitCode:0,error:void 0},l)}case`root-help`:if(i){let{generateSchema:t}=await import(`./json-schema-C9SzZ7jY.mjs`).then(e=>e.a);c.json(t(e.schema,void 0,{name:g.help.binName??e.schema.name,version:g.help.version??e.schema.version}))}else{let t=formatRootHelp(resolveHelpLinksSchema(e.schema),g.help);c.log(t)}return buildRunResult({exitCode:0,error:void 0},l);case`dispatch-error`:return i?c.json({error:g.error.toJSON()}):(c.error(g.error.message),g.error.suggest!==void 0&&g.error.code!==`NO_ACTION`&&c.error(`Suggestion: ${g.error.suggest}`)),buildRunResult({exitCode:g.error.exitCode,error:g.error},l);case`needs-subcommand`:if(i){let{generateCommandSchema:e}=await import(`./json-schema-C9SzZ7jY.mjs`).then(e=>e.a);c.json(e(g.command.schema,void 0,{name:g.help.binName??g.command.schema.name,version:g.help.version}))}else{let e=formatHelp(g.command.schema,g.help);c.log(e)}return buildRunResult({exitCode:0,error:void 0},l);case`match`:{let e=buildCommandRunOptions(m,g.plan.help??d,g.plan.meta);return buildRunResult(await executeCommand({command:{handler:g.plan.command.handler,steps:g.plan.command.steps},argv:g.plan.argv,out:c,schema:g.plan.mergedSchema,meta:g.plan.meta,options:e}),l)}}}const RUNTIME_BINARIES=new Set([`bun`,`deno`,`node`,`tsx`]);function basename(e){let t=stripTrailing(e,[47,92]);if(t.length===0)return;let n=Math.max(t.lastIndexOf(`/`),t.lastIndexOf(`\\`)),r=n>=0?t.slice(n+1):t;return r.length>0?r:void 0}function isRuntimeBinaryName(e){let t=e.toLowerCase().replace(/\.exe$/i,``);return RUNTIME_BINARIES.has(t)}function inferInvocationName(e){let t=e[0],n=e[1],r=t===void 0?void 0:basename(t);if(r!==void 0&&isRuntimeBinaryName(r)){if(r===`bun`&&n===`run`){let t=e[2];return t===void 0||t.startsWith(`-`)?void 0:basename(t)}return r===`deno`&&n===`run`||n===void 0||n.startsWith(`-`)?void 0:basename(n)}return t===void 0?void 0:basename(t)}function toUrlString(e){if(e!==void 0)return e instanceof URL?e.href:e}function resolveHelpLinksSchema(e){return e.helpLinks===void 0?e:{...e,helpLinks:deriveHelpLinks(e.helpLinks,e.packageJsonSettings?.data,e.version)}}const DEFAULT_MANIFEST_FILES=[`package.json`];function normalizeInferName(e){return e===void 0||e===!1?{inferName:!1,stripScope:!0}:e===!0?{inferName:!0,stripScope:!0}:{inferName:!0,stripScope:e.scope!==`keep`}}function buildManifestSchema(e,t,n){if(isPackageJsonData(t))return{...e,...e.version===void 0&&t.version!==void 0?{version:t.version}:{},...e.description===void 0&&t.description!==void 0?{description:t.description}:{},packageJsonSettings:{inferName:!1,stripScope:!0,from:void 0,files:n,data:t}};let{inferName:r,stripScope:i}=normalizeInferName(t?.inferName),a=t?.files??n;return{...e,packageJsonSettings:{inferName:r,stripScope:i,from:normalizeFromSetting(t?.from),files:a,data:void 0}}}function normalizeFromSetting(e){if(e===void 0)return;let t=typeof e==`object`&&!(e instanceof URL)?e.url:e;if(t instanceof URL){if(t.protocol!==`file:`)return t.href}else if(!t.startsWith(`file:`))return t;let n=decodeURIComponent(new URL(t).pathname);return/^\/[A-Za-z]:/.test(n)?n.slice(1).replace(/\//g,`\\`):n}function isPackageJsonData(e){return typeof e!=`object`||!e||Array.isArray(e)?!1:`name`in e||`version`in e||`description`in e||`bin`in e||`homepage`in e||`repository`in e}function cli(e,t){let n=typeof e==`string`?{name:e,...t}:e,r=n.name??`cli`,i=n.inherit??!1;return CLIBuilder._from(createCLISchema({name:r,inheritName:i,flagSettings:n.flags}),{commands:[],defaultCommand:void 0,plugins:[]})}function isMainModule(e){return e.main===!0}const DEFINITION_SCHEMA_URL=`https://dreamcli.kjanat.dev/schemas/definition/v1.schema.json`,DEFINITION_SCHEMA_VERSION=1;function adapterReader(e){let t=e;return()=>(t??=createAdapter(),t)}function scriptName(e){let t=e.argv[1]??``,n=t.slice(Math.max(t.lastIndexOf(`/`),t.lastIndexOf(`\\`))+1);return n===``?`script`:n}function withoutUndeclaredTokens(e,t){let n=tokenize(e),r=[],i=0;for(;i<n.length;){let a=n[i],o=e[i];if(a===void 0||o===void 0)break;if(a.kind===`positional`||a.kind===`separator`){i++;continue}if(a.kind===`long-flag`){let s=t.get(a.name);if(i++,s===void 0)continue;if(r.push(o),!s.negated&&a.value===void 0&&flagExpectsValue(s.schema)){let t=e[i];n[i]?.kind===`positional`&&t!==void 0&&(r.push(t),i++)}continue}let s=``,c=!1;for(let e=0;e<a.chars.length;e++){let n=a.chars.charAt(e),r=t.get(n);if(r!==void 0&&(s+=n,flagExpectsValue(r.schema))){let t=a.chars.slice(e+1);t.length>0?s+=t:c=!0;break}}if(i++,s.length!==0&&(r.push(`-${s}`),c)){let t=e[i];n[i]?.kind===`positional`&&t!==void 0&&(r.push(t),i++)}}return r}async function readFlags(e,t){for(let t of Reflect.ownKeys(e))if(typeof t!=`string`||!Object.prototype.propertyIsEnumerable.call(e,t))throw new CLIError(`Flag definitions must use enumerable string keys`,{code:`INVALID_SCHEMA`});let n=Object.getPrototypeOf(e);if(n!==Object.prototype&&n!==null)throw new CLIError(`Flag definitions record has a replaced prototype. A '__proto__' key sets the prototype instead of adding a definition, and an inherited definition is never read`,{code:`INVALID_SCHEMA`,suggest:`Pass a plain object with no '__proto__' key, or a record built with Object.create(null)`});let r=Object.entries(e);for(let[e]of r)if(e===`__proto__`)throw new CLIError(`Flag name '${e}' is not usable as a flag`,{code:`INVALID_SCHEMA`,details:{flag:e},suggest:`Rename the definition key, for example to "proto"`});let i=createCommandSchema({name:`<standalone>`,flags:Object.fromEntries(r.map(([e,t])=>[e,t.schema]))}),a=adapterReader(t?.adapter),o=t?.argv??a().argv.slice(2),s=buildFlagLookup(i.flags,t?.parse);(t?.help??`on`)===`on`&&!s.has(`help`)&&!s.has(`h`)&&requestsHelp(o)&&(a().stdout(formatHelp(i,{binName:scriptName(a()),isDefaultHelp:!0})),a().exit(0));let c=parse(i,t?.strict===!1?withoutUndeclaredTokens(o,s):o,t?.parse),l=t?.stdinData===void 0&&invocationSelectsStdin(i.flags,i.args,c)?await a().readStdin():t?.stdinData,u=await resolve(i,c,{env:t?.env??a().env,stat:t?.stat??(e=>a().stat(e)),mkdir:t?.mkdir??(e=>a().mkdir(e)),...t?.config===void 0?{}:{config:t.config},...t?.prompter===void 0?{}:{prompter:t.prompter},...l===void 0?{}:{stdinData:l}});for(let e of u.deprecations)t?.onDeprecation?.(e);return t?.onSources?.(u.provenance.flags),u.flags}var ExitError=class extends Error{name=`ExitError`;code;constructor(e){super(`Process exited with code ${e}`),this.code=e}};const noopWrite=()=>{},eofRead=()=>Promise.resolve(null),noopReadFile=()=>Promise.resolve(null),noopStat=()=>Promise.resolve(null),noopMkdir=()=>Promise.resolve();function createTestAdapter(e){let t=e?.stdinIsTTY??!1,n=t?void 0:e?.stdinData;return{argv:e?.argv??[`node`,`test`],env:e?.env??{},cwd:e?.cwd??`/test`,stdout:e?.stdout??noopWrite,stderr:e?.stderr??noopWrite,stdin:e?.stdin??eofRead,readStdin:()=>{if(n===void 0)return Promise.resolve(null);let e=n;return n=void 0,Promise.resolve(e)},isTTY:e?.isTTY??!1,stdinIsTTY:t,getTerminalSize:()=>e?.terminalSize,onTerminalResize:t=>e?.onTerminalResize?.(t),exit:e?.exit??(e=>{throw new ExitError(e)}),readFile:e?.readFile??noopReadFile,stat:e?.stat??noopStat,mkdir:e?.mkdir??noopMkdir,homedir:e?.homedir??`/home/test`,configDir:e?.configDir??`/home/test/.config`,userConfigDirs:e?.userConfigDirs??[e?.configDir??`/home/test/.config`],systemConfigDirs:e?.systemConfigDirs??[]}}async function runCommand(e,t,n){return runCommandInternal(e,t,n)}async function runCommandInternal(e,t,n){let r=readRootOutputFlags(t,n?.builtins),i=resolveRootJsonMode(r,n?.jsonMode),a=resolveRootVerbosity(r,n?.verbosity),o=r.argv,s,c;if(n?.out!==void 0)s=n.out,c=n.captured??{stdout:[],stderr:[],activity:[]};else{let e={...a===void 0?{}:{verbosity:a},...i?{jsonMode:i}:{},...n?.isTTY===void 0?{}:{isTTY:n.isTTY}};[s,c]=createCaptureOutput(Object.keys(e).length>0?e:void 0)}if(r.kind===`failed`&&!(builtinEnabled(n?.builtins,`help`)&&requestsHelp(o))){let{error:e}=r;return i?s.json({error:e.toJSON()}):(s.error(e.message),e.suggest!==void 0&&s.error(`Suggestion: ${e.suggest}`)),buildRunResult({exitCode:e.exitCode,error:e},c)}let l=n?.mergedSchema??e.schema,u=n?.meta??{name:l.name,bin:n?.help?.binName??l.name,version:void 0,command:l.name},d=n===void 0?i?{jsonMode:i}:void 0:{...n,...i?{jsonMode:i}:{}};return buildRunResult(await executeCommand({command:{handler:e.handler,steps:e._executionSteps},argv:o,out:s,schema:l,meta:u,...d===void 0?{}:{options:d}}),c)}export{ParseError as $,createCaptureOutput as A,resolveExampleCommand as B,flagExpectsValue as C,tokenize as D,stripBeforeSeparator as E,visibleWidth as F,getFlagNegatedName as G,createFlagSchema as H,CommandBuilder as I,createArgSchema as J,ArgBuilder as K,command as L,formatHelp as M,resolvePlainHelpDescription as N,wasExplicit as O,osc8 as P,CLIError as Q,createCommandSchema as R,resolvePromptConfig as S,parse as T,flag as U,FlagBuilder as V,getFlagAliasNames as W,SPLIT_FORMATS as X,DUPLICATE_KEYS as Y,builtinEnabled as Z,createNodeAdapter as _,DEFINITION_SCHEMA_URL as a,createDenoAdapter as b,cli as c,resolveRenderContext as d,ValidationError as et,resolveRootSurface as f,createAdapter as g,packageRepositoryUrl as h,readFlags as i,SHELLS as it,createOutput as j,middleware as k,createCLISchema as l,collectPropagatedFlags as m,ExitError as n,isParseError as nt,DEFINITION_SCHEMA_VERSION as o,plugin as p,arg as q,createTestAdapter as r,isValidationError as rt,CLIBuilder as s,runCommand as t,isCLIError as tt,isMainModule as u,RUNTIMES as v,includesBeforeSeparator as w,resolve as x,detectRuntime as y,group as z};
|
|
17
|
+
`)}function formatGlobalOptionsSection(e,t,n){let r=[],i=t=>{builtinEnabled(e.builtins,t)&&r.push({left:n.flag(builtinFlagForms(t)),description:BUILTIN_SPECS[t].description})};for(let t of BUILTIN_NAMES)i(t),t===`help`&&e.version!==void 0&&r.push({left:n.flag(`-V, --version`),description:`Print the version number and exit`});return e.configSettings!==void 0&&r.push({left:`${n.flag(`--config`)} ${n.placeholder(`<path>`)}`,description:`Load configuration from the given file`}),r.length===0?``:formatFlagEntriesBlock(n.sectionTitle(`Global options:`),r,t)}function mergeUsageSections(e,t,n){let r=`${n} `,i=t.startsWith(r)?t.slice(r.length):t;return`${e}\n${` `.repeat(7)}${i}`}const PRECHECK_OUTPUT={jsonMode:!1,isTTY:!1,verbosity:`normal`};function extractConfigFlag(e){let t=[],n;for(let r=0;r<e.length;r+=1){let i=e[r];if(i!==void 0){if(i===`--`){t.push(...e.slice(r));break}if(n===void 0&&i.startsWith(`--config=`)){let e=i.slice(9);if(e.length>0){n=e;continue}t.push(i);continue}if(n===void 0&&i===`--config`){let a=e[r+1];if(a!==void 0&&!a.startsWith(`-`)&&a!==`--`){n=a,r+=1;continue}t.push(i);continue}t.push(i)}}return{configPath:n,filteredArgv:t}}function commandInvocationNeedsStdin(e,t,n,r){if(builtinEnabled(r,`help`)&&(t.includes(`--help`)||t.includes(`-h`)))return!1;try{let r=parse(e,t,n);return invocationSelectsStdin(e.flags,e.args,r)}catch(e){if(e instanceof ParseError)return!1;throw e}}function invocationNeedsStdin(e,t,n){let r=planInvocation({schema:e,compiled:t,argv:n,help:{binName:e.name},output:PRECHECK_OUTPUT});switch(r.kind){case`match`:return commandInvocationNeedsStdin(r.plan.mergedSchema,r.plan.argv,e.flagSettings,e.builtins);case`dispatch-error`:case`needs-subcommand`:case`root-help`:case`root-version`:case`root-completions`:return!1}}function isCompletionsInvocation(e,t,n){if(!e.hasBuiltInCompletions)return!1;let r=planInvocation({schema:e,compiled:t,argv:n,help:{binName:e.name},output:PRECHECK_OUTPUT});return r.kind===`root-completions`||r.kind===`match`&&r.plan.command.schema.name===`completions`}async function discoverManifestData(e,t){let{discoverManifest:n}=await import(`./package-json-BgE9YjjQ.mjs`).then(e=>e.r);return n(e,{...t.from===void 0?{}:{startDir:t.from},files:t.files})}async function inferManifestCliName(e,t){let{inferCliName:n}=await import(`./package-json-BgE9YjjQ.mjs`).then(e=>e.r);return n(e,{stripScope:t})}async function applyPackageJsonDiscovery(e,t,n,r){let i=e.packageJsonSettings,a=i!==void 0&&!r?await(async()=>{let n=i.data??await discoverManifestData(t,i);if(n===null)return e;let r=i.inferName?await inferManifestCliName(n,i.stripScope):void 0;return{...e,...e.version===void 0&&n.version!==void 0?{version:n.version}:{},...e.description===void 0&&n.description!==void 0?{description:n.description}:{},...r===void 0?{}:{name:r},helpLinks:deriveHelpLinks(e.helpLinks,n,e.version??n.version)}})():e;return n===void 0?a:{...a,name:n}}function discoveredVersionCollision(e,t,n){if(e.version!==t.version)try{assertNoReservedFlagCollisions(e.version,[n.defaultCommand?.schema,...n.commands.map(e=>e.schema)],e.builtins);return}catch(e){if(e instanceof CLIError)return e;throw e}}async function loadRuntimeConfig(e,t,n,r,i){if(e.configSettings===void 0||r||i!==void 0)return i;try{let{discoverConfig:r}=await import(`./config-CrlScpYX.mjs`).then(e=>e.r),i=await r(e.configSettings.appName,t,{...n===void 0?{}:{configPath:n},...e.configSettings.loaders===void 0?{}:{loaders:e.configSettings.loaders}});return i.found?i.data:void 0}catch(e){if(e instanceof CLIError)return e;throw e}}function createLazyTerminalPrompter(e){let t;return{async promptOne(n){return t??=import(`./terminal-C8KTXjv5.mjs`).then(e=>e.n).then(({createTerminalPrompter:t})=>t(e.stdin,e.stderr)),(await t).promptOne(n)}}}async function prepareRuntimePreflight(e){let t=e.adapter.argv.slice(2),{configPath:n,filteredArgv:r}=e.schema.configSettings===void 0?{configPath:void 0,filteredArgv:t}:extractConfigFlag(t),i=readRootOutputFlags(r,e.schema.builtins),a=resolveRootJsonMode(i,e.options?.jsonMode),o=resolveRootVerbosity(i,e.options?.verbosity)??`normal`,s=isCompletionsInvocation(e.schema,e.compiled,r),c=await applyPackageJsonDiscovery(e.schema,e.adapter,e.inheritedName,s),l=discoveredVersionCollision(c,e.schema,e.compiled);if(l!==void 0)return{kind:`startup-error`,error:l,jsonMode:a};let u=await loadRuntimeConfig(c,e.adapter,n,s,e.options?.config);if(u instanceof CLIError)return{kind:`startup-error`,error:u,jsonMode:a};let d=e.options?.prompter===void 0&&e.adapter.stdinIsTTY?createLazyTerminalPrompter(e.adapter):void 0,f=e.options?.stdinData===void 0&&invocationNeedsStdin(c,e.compiled,r)?await e.adapter.readStdin():e.options?.stdinData;return{kind:`ready`,schema:c,filteredArgv:r,inputs:{env:e.options?.env??e.adapter.env,isTTY:e.options?.isTTY??e.adapter.isTTY,jsonMode:a,verbosity:o,stat:e.options?.stat??e.adapter.stat,mkdir:e.options?.mkdir??e.adapter.mkdir,...f===void 0?{}:{stdinData:f},...e.options?.prompter===void 0?d===void 0?{}:{prompter:d}:{prompter:e.options.prompter},...u===void 0?{}:{config:u}}}}const COMPLETIONS_FLAG_NAME=`completions`;function commandReservesCompletionsFlag(e){if(Object.hasOwn(e.flags,COMPLETIONS_FLAG_NAME))return!0;for(let[t,n]of Object.entries(e.flags))if(getFlagAliasNames(n,{kind:`long`,includeHidden:!0}).includes(COMPLETIONS_FLAG_NAME)||getFlagNegatedName(t,n)===COMPLETIONS_FLAG_NAME)return!0;return e.commands.some(commandReservesCompletionsFlag)}function assertNoCompletionsFlagCollision(e){if(commandReservesCompletionsFlag(e))throw new CLIError(`Command '${e.name}' defines a '--${COMPLETIONS_FLAG_NAME}' flag, which is reserved by .completions({ as: 'flag' })`,{code:`RESERVED_FLAG`,suggest:`Rename the flag, or register completions as a subcommand with .completions() instead of { as: 'flag' }`})}function assertNoTopLevelRouteConflict(e,t,n){let r=new Map,i=n===void 0?e:[...e,n];for(let e of i)for(let t of commandRoutes(e))assertNoSiblingRouteConflict(`root`,r,t,e.name);for(let e of commandRoutes(t)){let n=r.get(e);if(n!==void 0)throw new CLIError(`Command route '${e}' is already registered by '${n}'`,{code:`DUPLICATE_COMMAND`,suggest:n===t.name?`Ensure command '${t.name}' does not reuse route '${e}'`:`Rename '${t.name}' or remove route '${e}' from '${n}'`});r.set(e,t.name)}}const compiledStates=new WeakMap;function compiledStateOf(e){let t=compiledStates.get(e);if(t===void 0)throw new CLIError(`CLI builder carries no compiled command graph`,{code:`INVALID_BUILDER_STATE`,suggest:`Create CLI builders with cli()`});return t}function rebuild(e,t){return CLIBuilder._from(t,compiledStateOf(e))}function completionGeneratorOptions(e){if(e!==void 0)return{...e.functionPrefix===void 0?{}:{functionPrefix:e.functionPrefix},...e.rootMode===void 0?{}:{rootMode:e.rootMode}}}function sealCLISchema(e){return e}function buildCLISchema(e){let t=e.configSettings;return sealCLISchema({name:e.name,inheritName:e.inheritName??!1,version:e.version,description:e.description,commands:(e.commands??[]).map(e=>createCommandSchema(e)),defaultCommand:e.defaultCommand===void 0?void 0:createCommandSchema(e.defaultCommand),defaultCommandRouted:e.defaultCommandRouted??!1,configSettings:t===void 0?void 0:{appName:t.appName,loaders:t.loaders},packageJsonSettings:e.packageJsonSettings,helpLinks:e.helpLinks,hasBuiltInCompletions:e.hasBuiltInCompletions??!1,completionsFlag:e.completionsFlag,helpConfig:e.helpConfig,flagSettings:e.flagSettings,builtins:normalizeBuiltins(e.builtins)})}function createCLISchema(e){if(e.name===``)throw new CLIError(`CLI schema requires a non-empty name`,{code:`INVALID_SCHEMA`,details:{name:e.name},suggest:`Pass a program name such as { name: "mycli" }`});let t=buildCLISchema(e),n=[];for(let e of t.commands)assertNoTopLevelRouteConflict(n,e),n.push(e);let r=e.defaultCommand!==void 0&&e.commands?.includes(e.defaultCommand)===!0;t.defaultCommand!==void 0&&!r&&assertNoTopLevelRouteConflict(n,t.defaultCommand);let i=[t.defaultCommand,...t.commands];if(assertNoReservedFlagCollisions(t.version,i,t.builtins),t.completionsFlag!==void 0)for(let e of i)e!==void 0&&assertNoCompletionsFlagCollision(e);return t}var ResolvedRenderContext=class{jsonMode;verbosity;isTTY;color;isHyperlinkSupported;constructor(e){this.jsonMode=e.jsonMode,this.verbosity=e.verbosity,this.isTTY=e.isTTY,this.color=e.color,this.isHyperlinkSupported=e.isHyperlinkSupported}};function resolveRenderContext(e,t){let n=readRootOutputFlags(e,t?.builtins),r=resolveRootJsonMode(n,t?.jsonMode),i=resolveRootVerbosity(n,t?.verbosity)??`normal`;return new ResolvedRenderContext(createOutput({jsonMode:r,isTTY:t?.isTTY??!1,verbosity:i,...t?.color===void 0?{}:{color:t.color},...hyperlinksOption(resolveHyperlinkOverride(t?.env??{},e))}))}function hyperlinksOption(e){return e===void 0?{}:{hyperlinks:e}}function resolveEffectiveHyperlinkOverride(e,t,n,r){return e?.hyperlinks??t?.hyperlinks??resolveHyperlinkOverride(n,r)}function buildCommandRunOptions(e,t,n){return{help:t,...n===void 0?{}:{meta:n},...e?.plugins===void 0?{}:{plugins:e.plugins},...e?.builtins===void 0?{}:{builtins:e.builtins},...e?.env===void 0?{}:{env:e.env},...e?.config===void 0?{}:{config:e.config},...e?.stdinData===void 0?{}:{stdinData:e.stdinData},...e?.prompter===void 0?{}:{prompter:e.prompter},...e?.answers===void 0?{}:{answers:e.answers},...e?.stat===void 0?{}:{stat:e.stat},...e?.mkdir===void 0?{}:{mkdir:e.mkdir},...e?.verbosity===void 0?{}:{verbosity:e.verbosity},...e?.jsonMode===void 0?{}:{jsonMode:e.jsonMode},...e?.isTTY===void 0?{}:{isTTY:e.isTTY},...e?.out===void 0?{}:{out:e.out},...e?.captured===void 0?{}:{captured:e.captured},...e?.flags===void 0?{}:{flags:e.flags}}}var CLIBuilder=class e{schema;constructor(e){this.schema=e}static _from(t,n){let r=new e(t);return compiledStates.set(r,n),r}version(e){return assertNoReservedFlagCollisions(e,[this.schema.defaultCommand,...this.schema.commands],this.schema.builtins),rebuild(this,{...this.schema,version:e})}builtins(e){let t={...e.help===void 0?{}:{help:e.help},...e.json===void 0?{}:{json:e.json},...e.quiet===void 0?{}:{quiet:e.quiet}},n=normalizeBuiltins({...this.schema.builtins,...t});return assertNoReservedFlagCollisions(this.schema.version,[this.schema.defaultCommand,...this.schema.commands],n),rebuild(this,sealCLISchema({...this.schema,builtins:n}))}description(e){return rebuild(this,{...this.schema,description:e})}links(e){return rebuild(this,{...this.schema,helpLinks:{name:toUrlString(e?.name),version:toUrlString(e?.version)}})}help(e){return rebuild(this,{...this.schema,helpConfig:{...this.schema.helpConfig,...e}})}config(e,t){return rebuild(this,sealCLISchema({...this.schema,configSettings:{appName:e,loaders:t}}))}configLoader(e){if(this.schema.configSettings===void 0)throw new CLIError(`.configLoader() requires .config() to be called first`,{code:`INVALID_BUILDER_STATE`,suggest:`Call .config(appName) before .configLoader()`});let t=this.schema.configSettings.loaders??[];return rebuild(this,sealCLISchema({...this.schema,configSettings:{...this.schema.configSettings,loaders:[...t,e]}}))}manifest(e){let t=buildManifestSchema(this.schema,e,DEFAULT_MANIFEST_FILES);return assertNoReservedFlagCollisions(t.version,[t.defaultCommand,...t.commands],t.builtins),rebuild(this,t)}command(t){assertNoTopLevelRouteConflict(this.schema.commands,t.schema,this.schema.defaultCommand),assertNoReservedFlagCollisions(this.schema.version,[t.schema],this.schema.builtins),this.schema.completionsFlag!==void 0&&assertNoCompletionsFlagCollision(t.schema);let n=compiledStateOf(this);return e._from({...this.schema,commands:[...this.schema.commands,t.schema]},{...n,commands:[...n.commands,compileCommand(t)]})}default(t,n){if(this.schema.defaultCommand!==void 0)throw new CLIError(`Only one default command is allowed`,{code:`DUPLICATE_DEFAULT`,suggest:`Call .default() only once when building the CLI`});assertNoTopLevelRouteConflict(this.schema.commands,t.schema),assertNoReservedFlagCollisions(this.schema.version,[t.schema],this.schema.builtins),this.schema.completionsFlag!==void 0&&assertNoCompletionsFlagCollision(t.schema);let r=compiledStateOf(this);return e._from({...this.schema,defaultCommand:t.schema,defaultCommandRouted:n?.route??!1},{...r,defaultCommand:compileCommand(t)})}plugin(t){let n=compiledStateOf(this);return e._from(this.schema,{...n,plugins:[...n.plugins,t]})}completions(e){if(this.schema.hasBuiltInCompletions)throw new CLIError(`.completions() has already been called`,{code:`DUPLICATE_COMMAND`,suggest:`Call .completions() only once when building the CLI`});if(e?.as===`flag`){this.schema.defaultCommand!==void 0&&assertNoCompletionsFlagCollision(this.schema.defaultCommand);for(let e of this.schema.commands)assertNoCompletionsFlagCollision(e);return rebuild(this,{...this.schema,hasBuiltInCompletions:!0,completionsFlag:{shells:SHELLS,options:completionGeneratorOptions(e)}})}let t=this.schema,n=completionGeneratorOptions(e),r=command(`completions`).alias(`completion`).description(`Generate shell completion script`).arg(`shell`,arg.custom(e=>{let t=normalizeShell(e);if(t===void 0)throw Error(`Unknown shell '${e}'. Valid shells: ${SHELLS.join(`, `)}`);return t}).env(`SHELL`).describe(`Target shell (${SHELLS.join(`, `)})`)).action(async({args:e,meta:r,out:i})=>{let a=r.bin===t.name?t:{...t,name:r.bin},{generateCompletion:o}=await import(`./completion-CUMeOnAz.mjs`).then(e=>e.t),s=o(a,e.shell,n);i.jsonMode?i.json({shell:e.shell,script:s}):i.log(s)}),i=this.command(r);return rebuild(i,{...i.schema,hasBuiltInCompletions:!0})}async execute(e,t){return executeCLI(this,e,t)}async run(e){let t=e?.adapter??createAdapter(),n=this.schema.inheritName?inferInvocationName(t.argv):void 0,r=compiledStateOf(this),i=await prepareRuntimePreflight({schema:this.schema,compiled:r,adapter:t,options:e,inheritedName:n});if(i.kind===`startup-error`)return i.jsonMode?t.stdout(`${JSON.stringify({error:i.error.toJSON()})}\n`):(t.stderr(`Error: ${i.error.message}\n`),i.error.suggest!==void 0&&t.stderr(`Suggestion: ${i.error.suggest}\n`)),exitAfterFlush(t,i.error.exitCode);let a=i.schema===this.schema?this:rebuild(this,sealCLISchema({...this.schema,...i.schema})),o=t.getTerminalSize(),s=e?.help?.width===void 0&&i.schema.helpConfig?.width===void 0?o?.columns:void 0,c=s===void 0?e?.help:{...e?.help,width:s},l=resolveEffectiveHyperlinkOverride(c,a.schema.helpConfig,t.env,t.argv),u={...e,...i.inputs,...c===void 0?{}:{help:c},out:createOutput({stdout:t.stdout,stderr:t.stderr,jsonMode:i.inputs.jsonMode,isTTY:i.inputs.isTTY,...i.inputs.verbosity===`normal`?{}:{verbosity:i.inputs.verbosity},...hyperlinksOption(l)})},d=await executeCLI(a,i.filteredArgv,u);for(let e of d.stdout)t.stdout(e);for(let e of d.stderr)t.stderr(e);return exitAfterFlush(t,d.exitCode)}};async function executeCLI(e,t,n){let r=readRootOutputFlags(t,e.schema.builtins),i=resolveRootJsonMode(r,n?.jsonMode),a=resolveRootVerbosity(r,n?.verbosity),o=resolveEffectiveHyperlinkOverride(n?.help,e.schema.helpConfig,n?.env??{},t),s={...a===void 0?{}:{verbosity:a},...i?{jsonMode:i}:{},...n?.isTTY===void 0?{}:{isTTY:n.isTTY},...hyperlinksOption(o)},c,l;n?.out===void 0?[c,l]=createCaptureOutput(Object.keys(s).length>0?s:void 0):(c=n.out,l=n.captured??{stdout:[],stderr:[],activity:[]}),clearRequestedExitCode(c);let u=n?.help?.version??e.schema.version,d={...e.schema.helpConfig,...n?.help,binName:n?.help?.binName??e.schema.name,hyperlinks:c.isHyperlinkSupported,colors:n?.help?.colors??c.color,...u===void 0?{}:{version:u}},f=compiledStateOf(e),p=n?.flags??e.schema.flagSettings,m={...n,plugins:f.plugins,builtins:e.schema.builtins,...i?{jsonMode:i}:{},...a===void 0?{}:{verbosity:a},...p===void 0?{}:{flags:p}},h={jsonMode:i,isTTY:c.isTTY,verbosity:a??`normal`},g=planInvocation({schema:n?.flags===void 0?e.schema:{...e.schema,flagSettings:p},compiled:f,argv:t,help:d,output:h});switch(g.kind){case`root-version`:return c.log(g.version),buildRunResult({exitCode:0,error:void 0},l);case`root-completions`:{let t=g.shell??detectShell(n?.env??{});if(t===void 0){let e=new CLIError(`Could not detect shell`,{code:`MISSING_VALUE`,suggest:`Pass one explicitly, e.g. '${d.binName} --completions zsh'`});return i?c.json({error:e.toJSON()}):(c.error(e.message),c.error(`Suggestion: ${e.suggest}`)),buildRunResult({exitCode:e.exitCode,error:e},l)}let r=d.binName===void 0||d.binName===e.schema.name?e.schema:{...e.schema,name:d.binName},{generateCompletion:a}=await import(`./completion-CUMeOnAz.mjs`).then(e=>e.t),o=a(r,t,g.options);return i?c.json({shell:t,script:o}):c.log(o),buildRunResult({exitCode:0,error:void 0},l)}case`root-help`:if(i){let{generateSchema:t}=await import(`./json-schema-DRlrz_IV.mjs`).then(e=>e.a);c.json(t(e.schema,void 0,{name:g.help.binName??e.schema.name,version:g.help.version??e.schema.version}))}else{let t=formatRootHelp(resolveHelpLinksSchema(e.schema),g.help);c.log(t)}return buildRunResult({exitCode:0,error:void 0},l);case`dispatch-error`:return i?c.json({error:g.error.toJSON()}):(c.error(g.error.message),g.error.suggest!==void 0&&g.error.code!==`NO_ACTION`&&c.error(`Suggestion: ${g.error.suggest}`)),buildRunResult({exitCode:g.error.exitCode,error:g.error},l);case`needs-subcommand`:if(i){let{generateCommandSchema:e}=await import(`./json-schema-DRlrz_IV.mjs`).then(e=>e.a);c.json(e(g.command.schema,void 0,{name:g.help.binName??g.command.schema.name,version:g.help.version}))}else{let e=formatHelp(g.command.schema,g.help);c.log(e)}return buildRunResult({exitCode:0,error:void 0},l);case`match`:{let e=buildCommandRunOptions(m,g.plan.help??d,g.plan.meta);return buildRunResult(await executeCommand({command:{handler:g.plan.command.handler,steps:g.plan.command.steps},argv:g.plan.argv,out:c,schema:g.plan.mergedSchema,meta:g.plan.meta,options:e}),l)}}}const RUNTIME_BINARIES=new Set([`bun`,`deno`,`node`,`tsx`]);function basename(e){let t=stripTrailing(e,[47,92]);if(t.length===0)return;let n=Math.max(t.lastIndexOf(`/`),t.lastIndexOf(`\\`)),r=n>=0?t.slice(n+1):t;return r.length>0?r:void 0}function isRuntimeBinaryName(e){let t=e.toLowerCase().replace(/\.exe$/i,``);return RUNTIME_BINARIES.has(t)}function inferInvocationName(e){let t=e[0],n=e[1],r=t===void 0?void 0:basename(t);if(r!==void 0&&isRuntimeBinaryName(r)){if(r===`bun`&&n===`run`){let t=e[2];return t===void 0||t.startsWith(`-`)?void 0:basename(t)}return r===`deno`&&n===`run`||n===void 0||n.startsWith(`-`)?void 0:basename(n)}return t===void 0?void 0:basename(t)}function toUrlString(e){if(e!==void 0)return e instanceof URL?e.href:e}function resolveHelpLinksSchema(e){return e.helpLinks===void 0?e:{...e,helpLinks:deriveHelpLinks(e.helpLinks,e.packageJsonSettings?.data,e.version)}}const DEFAULT_MANIFEST_FILES=[`package.json`];function normalizeInferName(e){return e===void 0||e===!1?{inferName:!1,stripScope:!0}:e===!0?{inferName:!0,stripScope:!0}:{inferName:!0,stripScope:e.scope!==`keep`}}function buildManifestSchema(e,t,n){if(isPackageJsonData(t))return{...e,...e.version===void 0&&t.version!==void 0?{version:t.version}:{},...e.description===void 0&&t.description!==void 0?{description:t.description}:{},packageJsonSettings:{inferName:!1,stripScope:!0,from:void 0,files:n,data:t}};let{inferName:r,stripScope:i}=normalizeInferName(t?.inferName),a=t?.files??n;return{...e,packageJsonSettings:{inferName:r,stripScope:i,from:normalizeFromSetting(t?.from),files:a,data:void 0}}}function normalizeFromSetting(e){if(e===void 0)return;let t=typeof e==`object`&&!(e instanceof URL)?e.url:e;if(t instanceof URL){if(t.protocol!==`file:`)return t.href}else if(!t.startsWith(`file:`))return t;let n=decodeURIComponent(new URL(t).pathname);return/^\/[A-Za-z]:/.test(n)?n.slice(1).replace(/\//g,`\\`):n}function isPackageJsonData(e){return typeof e!=`object`||!e||Array.isArray(e)?!1:`name`in e||`version`in e||`description`in e||`bin`in e||`homepage`in e||`repository`in e}function cli(e,t){let n=typeof e==`string`?{name:e,...t}:e,r=n.name??`cli`,i=n.inherit??!1;return CLIBuilder._from(createCLISchema({name:r,inheritName:i,flagSettings:n.flags}),{commands:[],defaultCommand:void 0,plugins:[]})}function isMainModule(e){return e.main===!0}const DEFINITION_SCHEMA_URL=`https://dreamcli.kjanat.dev/schemas/definition/v1.schema.json`,DEFINITION_SCHEMA_VERSION=1;function adapterReader(e){let t=e;return()=>(t??=createAdapter(),t)}function scriptName(e){let t=e.argv[1]??``,n=t.slice(Math.max(t.lastIndexOf(`/`),t.lastIndexOf(`\\`))+1);return n===``?`script`:n}function withoutUndeclaredTokens(e,t){let n=tokenize(e),r=[],i=0;for(;i<n.length;){let a=n[i],o=e[i];if(a===void 0||o===void 0)break;if(a.kind===`positional`||a.kind===`separator`){i++;continue}if(a.kind===`long-flag`){let s=t.get(a.name);if(i++,s===void 0)continue;if(r.push(o),!s.negated&&a.value===void 0&&flagExpectsValue(s.schema)){let t=e[i];n[i]?.kind===`positional`&&t!==void 0&&(r.push(t),i++)}continue}let s=``,c=!1;for(let e=0;e<a.chars.length;e++){let n=a.chars.charAt(e),r=t.get(n);if(r!==void 0&&(s+=n,flagExpectsValue(r.schema))){let t=a.chars.slice(e+1);t.length>0?s+=t:c=!0;break}}if(i++,s.length!==0&&(r.push(`-${s}`),c)){let t=e[i];n[i]?.kind===`positional`&&t!==void 0&&(r.push(t),i++)}}return r}async function readFlags(e,t){for(let t of Reflect.ownKeys(e))if(typeof t!=`string`||!Object.prototype.propertyIsEnumerable.call(e,t))throw new CLIError(`Flag definitions must use enumerable string keys`,{code:`INVALID_SCHEMA`});let n=Object.getPrototypeOf(e);if(n!==Object.prototype&&n!==null)throw new CLIError(`Flag definitions record has a replaced prototype. A '__proto__' key sets the prototype instead of adding a definition, and an inherited definition is never read`,{code:`INVALID_SCHEMA`,suggest:`Pass a plain object with no '__proto__' key, or a record built with Object.create(null)`});let r=Object.entries(e);for(let[e]of r)if(e===`__proto__`)throw new CLIError(`Flag name '${e}' is not usable as a flag`,{code:`INVALID_SCHEMA`,details:{flag:e},suggest:`Rename the definition key, for example to "proto"`});let i=createCommandSchema({name:`<standalone>`,flags:Object.fromEntries(r.map(([e,t])=>[e,t.schema]))}),a=adapterReader(t?.adapter),o=t?.argv??a().argv.slice(2),s=buildFlagLookup(i.flags,t?.parse);(t?.help??`on`)===`on`&&!s.has(`help`)&&!s.has(`h`)&&requestsHelp(o)&&(a().stdout(formatHelp(i,{binName:scriptName(a()),isDefaultHelp:!0})),await exitAfterFlush(a(),0));let c=parse(i,t?.strict===!1?withoutUndeclaredTokens(o,s):o,t?.parse),l=t?.stdinData===void 0&&invocationSelectsStdin(i.flags,i.args,c)?await a().readStdin():t?.stdinData,u=await resolve(i,c,{env:t?.env??a().env,stat:t?.stat??(e=>a().stat(e)),mkdir:t?.mkdir??(e=>a().mkdir(e)),...t?.config===void 0?{}:{config:t.config},...t?.prompter===void 0?{}:{prompter:t.prompter},...l===void 0?{}:{stdinData:l}});for(let e of u.deprecations)t?.onDeprecation?.(e);return t?.onSources?.(u.provenance.flags),u.flags}async function runCommand(e,t,n){return runCommandInternal(e,t,n)}async function runCommandInternal(e,t,n){let r=readRootOutputFlags(t,n?.builtins),i=resolveRootJsonMode(r,n?.jsonMode),a=resolveRootVerbosity(r,n?.verbosity),o=r.argv,s,c;if(n?.out!==void 0)s=n.out,c=n.captured??{stdout:[],stderr:[],activity:[]};else{let e={...a===void 0?{}:{verbosity:a},...i?{jsonMode:i}:{},...n?.isTTY===void 0?{}:{isTTY:n.isTTY}};[s,c]=createCaptureOutput(Object.keys(e).length>0?e:void 0)}if(r.kind===`failed`&&!(builtinEnabled(n?.builtins,`help`)&&requestsHelp(o))){let{error:e}=r;return i?s.json({error:e.toJSON()}):(s.error(e.message),e.suggest!==void 0&&s.error(`Suggestion: ${e.suggest}`)),buildRunResult({exitCode:e.exitCode,error:e},c)}let l=n?.mergedSchema??e.schema,u=n?.meta??{name:l.name,bin:n?.help?.binName??l.name,version:void 0,command:l.name},d=n===void 0?i?{jsonMode:i}:void 0:{...n,...i?{jsonMode:i}:{}};return buildRunResult(await executeCommand({command:{handler:e.handler,steps:e._executionSteps},argv:o,out:s,schema:l,meta:u,...d===void 0?{}:{options:d}}),c)}export{ParseError as $,createCaptureOutput as A,resolveExampleCommand as B,flagExpectsValue as C,tokenize as D,stripBeforeSeparator as E,visibleWidth as F,getFlagNegatedName as G,createFlagSchema as H,CommandBuilder as I,createArgSchema as J,ArgBuilder as K,command as L,formatHelp as M,resolvePlainHelpDescription as N,wasExplicit as O,osc8 as P,CLIError as Q,createCommandSchema as R,resolvePromptConfig as S,parse as T,flag as U,FlagBuilder as V,getFlagAliasNames as W,SPLIT_FORMATS as X,DUPLICATE_KEYS as Y,builtinEnabled as Z,detectRuntime as _,CLIBuilder as a,createTestAdapter as b,isMainModule as c,plugin as d,ValidationError as et,collectPropagatedFlags as f,RUNTIMES as g,createNodeAdapter as h,DEFINITION_SCHEMA_VERSION as i,SHELLS as it,createOutput as j,middleware as k,resolveRenderContext as l,createAdapter as m,readFlags as n,isParseError as nt,cli as o,packageRepositoryUrl as p,arg as q,DEFINITION_SCHEMA_URL as r,isValidationError as rt,createCLISchema as s,runCommand as t,isCLIError as tt,resolveRootSurface as u,createDenoAdapter as v,includesBeforeSeparator as w,resolve as x,ExitError as y,group as z};
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { Bt as FlagKind, Pn as NumberConstraints, Q as ArgKind, T as ExampleMeta, Ut as FlagPresence, b as CommandSchema, et as ArgPresence, jt as DuplicatePolicy, kn as PromptKind, vt as DuplicateKeys } from "./index-BziI2aKc.mjs";
|
|
2
2
|
import "./index-DWsnGZlx.mjs";
|
|
3
|
-
import { o as CLISchema } from "./index-
|
|
3
|
+
import { o as CLISchema } from "./index-BAj2y70U.mjs";
|
|
4
4
|
//#region src/core/json-schema/constants.d.ts
|
|
5
5
|
/**
|
|
6
6
|
* Identifiers of the definition document format.
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { C as ErasedActionHandler, E as ExecutionStep, G as ArgConfig, Jn as schemaBrand, Ln as HelpThemeFactory, Nt as FlagBuilder, Pt as FlagConfig, U as Verbosity, W as ArgBuilder, _ as CommandDefinition, b as CommandSchema, g as CommandBuilder } from "./index-BziI2aKc.mjs";
|
|
2
2
|
import { H as Builtins, U as BuiltinsConfig, b as ParseOptions, n as RunResult, t as RunOptions, u as CLIPlugin } from "./index-DWsnGZlx.mjs";
|
|
3
|
-
import { n as RuntimeAdapter } from "./adapter-
|
|
4
|
-
import { h as PackageJsonData, s as FormatLoader } from "./index-
|
|
3
|
+
import { n as RuntimeAdapter } from "./adapter-YM5QGi3M.mjs";
|
|
4
|
+
import { h as PackageJsonData, s as FormatLoader } from "./index-Cp9kt2t-.mjs";
|
|
5
5
|
import { Colors } from "ansispeck";
|
|
6
6
|
//#region src/core/completion/shells/shared.d.ts
|
|
7
7
|
/**
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { n as RuntimeAdapter } from "./adapter-
|
|
1
|
+
import { n as RuntimeAdapter } from "./adapter-YM5QGi3M.mjs";
|
|
2
2
|
//#region src/runtime/detect.d.ts
|
|
3
3
|
/**
|
|
4
4
|
* Auto-detects the current JavaScript runtime environment.
|
|
@@ -238,13 +238,15 @@ interface NodeProcess {
|
|
|
238
238
|
readonly rows?: number;
|
|
239
239
|
getWindowSize?(): readonly [number, number];
|
|
240
240
|
on?(event: 'resize', listener: () => void): unknown;
|
|
241
|
+
on?(event: 'error', listener: (error: Error) => void): unknown;
|
|
241
242
|
off?(event: 'resize', listener: () => void): unknown;
|
|
242
243
|
removeListener?(event: 'resize', listener: () => void): unknown;
|
|
243
|
-
write(data: string): unknown;
|
|
244
|
+
write(data: string, callback?: (error?: Error | null) => void): unknown;
|
|
244
245
|
};
|
|
245
246
|
/** Standard error stream with write. */
|
|
246
247
|
readonly stderr: {
|
|
247
|
-
|
|
248
|
+
on?(event: 'error', listener: (error: Error) => void): unknown;
|
|
249
|
+
write(data: string, callback?: (error?: Error | null) => void): unknown;
|
|
248
250
|
};
|
|
249
251
|
/** Terminate the process with the given exit code. */
|
|
250
252
|
exit(code: number): never;
|
package/dist/index.d.mts
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
import { $ as ArgParseFn, $t as WithoutElementEligibility, A as Out, An as PromptResult, At as DefaultValueOptions, B as MiddlewareHandler, Bn as ProgressHandle, Bt as FlagKind, Cn as StandardSchemaV1Types, Ct as SplitOptions, D as InteractiveParams, Dn as PromptConfig, Dt as BooleanFlagDefinition, En as MultiselectPromptConfig, Et as ArrayFlagDefinition, F as InputSources, Fn as HelpDescription, Ft as FlagDefinition, G as ArgConfig, Gn as TableFormat, Gt as InferFlag, H as middleware, Hn as SpinnerHandle, Ht as FlagParseFn, I as ResolutionProvenance, In as HelpTheme, It as FlagDefinitionBase, J as ArgDefinitionBase, Jt as NumberFlagDefinition, K as ArgDefaultValue, Kn as TableOptions, Kt as InferFlags, L as SourcesOf, Ln as HelpThemeFactory, Lt as FlagDefinitionByKind, M as createCommandSchema, Mn as SelectPromptConfig, Mt as EnumFlagDefinition, N as group, Nn as NumberConstraintViolation, Nt as FlagBuilder, O as InteractiveResolver, On as PromptConfigBase, Ot as CountFlagDefinition, P as resolveExampleCommand, Pn as NumberConstraints, Pt as FlagConfig, Q as ArgKind, Qt as WithPresence, R as wasExplicit, Rn as ActivityEvent, Rt as FlagDefinitionOverrides, S as DeriveParams, Sn as StandardSchemaV1SuccessResult, St as SplitFormat, T as ExampleMeta, Tn as InputPromptConfig, Tt as SplitSetting, U as Verbosity, Un as SpinnerOptions, Ut as FlagPresence, V as MiddlewareParams, Vn as ProgressOptions, Vt as FlagNegation, W as ArgBuilder, Wn as TableColumn, Wt as FlagSchema, X as ArgDefinitionOverrides, Xt as StringElementConfig, Y as ArgDefinitionByKind, Yt as ResolvedValue, Z as ArgFactory, Zt as StringFlagDefinition, _ as CommandDefinition, _n as StandardSchemaV1Issue, _t as DUPLICATE_KEYS, a as WriteFn, an as PathFlagOptions, at as InferArg, b as CommandSchema, bn as StandardSchemaV1Props, bt as SourceSplitBinding, c as ResolvedMultiselectPromptConfig, cn as StringConstraints, ct as NumberArgDefinition, d as resolvePromptConfig, dn as StdinOptions, dt as StringArgElementConfig, en as createFlagSchema, et as ArgPresence, f as ActionHandler, fn as StdinWhen, ft as WithArgPresence, g as CommandBuilder, gn as StandardSchemaV1FailureResult, gt as createArgSchema, h as CommandArgEntryDefinition, hn as StandardSchemaV1, ht as arg, i as createOutput, in as PathChecks, it as EnumArgDefinition, j as command, jn as SelectChoice, jt as DuplicatePolicy, k as InteractiveResult, kn as PromptKind, kt as CustomFlagDefinition, l as ResolvedPromptConfig, ln as StdinBinding, lt as ResolvedArgValue, m as CommandArgEntry, mn as InferStandardOutput, mt as WithoutArgElementEligibility, n as OutputOptions, nn as getFlagNegatedName, nt as BooleanArgDefinition, o as PromptEngine, on as UrlFlagOptions, ot as InferArgs, p as ActionParams, pn as InferStandardInput, pt as WithVariadic, q as ArgDefinition, qn as TableStream, qt as KeyValueFlagDefinition, rn as DateFlagOptions, rt as CustomArgDefinition, s as ReadFn, sn as StringConstraintViolation, st as KeyValueArgDefinition, tn as flag, tt as ArgSchema, u as ResolvedSelectPromptConfig, un as StdinConsume, ut as StringArgDefinition, v as CommandExample, vn as StandardSchemaV1Options, vt as DuplicateKeys, w as ExampleCommand, wn as ConfirmPromptConfig, wt as SplitPolicy, x as DeriveHandler, xn as StandardSchemaV1Result, xt as SplitBinding, y as CommandMeta, yn as StandardSchemaV1PathSegment, yt as SPLIT_FORMATS, z as Middleware, zn as Fallback, zt as FlagFactory } from "./index-BziI2aKc.mjs";
|
|
2
2
|
import { A as ErrorCode, B as BuiltinMode, C as includesBeforeSeparator, D as CLIError, E as tokenize, F as ValidationErrorCode, H as Builtins, I as ValidationErrorOptions, L as isCLIError, M as ParseErrorCode, N as ParseErrorOptions, O as CLIErrorJSON, P as ValidationError, R as isParseError, S as Token, T as stripBeforeSeparator, U as BuiltinsConfig, V as BuiltinName, _ as ResolutionProvenanceRecord, b as ParseOptions, c as formatHelp, d as CLIPluginHooks, f as PluginCommandContext, g as DeprecationWarning, h as resolve, j as ParseError, k as CLIErrorOptions, l as BeforeParseParams, m as plugin, n as RunResult, p as ResolvedCommandParams, s as HelpOptions, u as CLIPlugin, v as ResolveOptions, w as parse, x as ParseResult, y as ResolveResult, z as isValidationError } from "./index-DWsnGZlx.mjs";
|
|
3
|
-
import { C as SHELLS, S as HelpLinks, T as CompletionOptions, _ as ResolvedManifestSettings, a as CLIRunOptions, b as isMainModule, c as CompletionsFlagConfig, d as DefaultCommandOptions, f as HelpConfig, g as RenderContextOptions, h as RenderContext, i as CLIOptions, l as ConfigSettings, m as ManifestSettings, n as CLIDefinition, o as CLISchema, p as InferNameOption, r as CLIExecuteOptions, s as CompletionRegistrationOptions, t as CLIBuilder, u as ConfigSettingsDefinition, v as cli, w as Shell, x as resolveRenderContext, y as createCLISchema } from "./index-
|
|
4
|
-
import { n as RuntimeAdapter } from "./adapter-
|
|
5
|
-
import { a as ConfigNotFound, d as PackageRepositoryUrlOptions, g as PackageRepository, h as PackageJsonData, i as ConfigFound, m as PackageJsonAdapter, n as ConfigDiscoveryOptions, o as ConfigSearchPathOptions, p as ManifestDiscoveryOptions, r as ConfigDiscoveryResult, s as FormatLoader, t as ConfigAdapter } from "./index-
|
|
6
|
-
import { D as DEFINITION_SCHEMA_URL, O as DEFINITION_SCHEMA_VERSION, S as StdinBindingFragmentV1, _ as JsonSchemaOptions, a as CommandDefinitionFragmentV1, b as SourceSplitFragmentV1, c as ExampleDefinitionFragmentV1, d as FlagNegationFragmentV1, f as FlagPathChecksFragmentV1, g as InputSchemaProperty, h as InputSchemaDocument, i as CommandDefinitionDocumentV1, l as FlagDefinitionFragmentV1, m as InputSchemaBranch, n as ArgElementFragmentV1, o as DefinitionDocument, p as FlagStringConstraintsFragmentV1, r as CommandDefinitionDocument, s as DefinitionDocumentV1, t as ArgDefinitionFragmentV1, u as FlagElementFragmentV1, v as PromptChoiceFragmentV1, x as SplitPolicyFragmentV1, y as PromptDefinitionFragmentV1 } from "./index-
|
|
3
|
+
import { C as SHELLS, S as HelpLinks, T as CompletionOptions, _ as ResolvedManifestSettings, a as CLIRunOptions, b as isMainModule, c as CompletionsFlagConfig, d as DefaultCommandOptions, f as HelpConfig, g as RenderContextOptions, h as RenderContext, i as CLIOptions, l as ConfigSettings, m as ManifestSettings, n as CLIDefinition, o as CLISchema, p as InferNameOption, r as CLIExecuteOptions, s as CompletionRegistrationOptions, t as CLIBuilder, u as ConfigSettingsDefinition, v as cli, w as Shell, x as resolveRenderContext, y as createCLISchema } from "./index-BAj2y70U.mjs";
|
|
4
|
+
import { n as RuntimeAdapter } from "./adapter-YM5QGi3M.mjs";
|
|
5
|
+
import { a as ConfigNotFound, d as PackageRepositoryUrlOptions, g as PackageRepository, h as PackageJsonData, i as ConfigFound, m as PackageJsonAdapter, n as ConfigDiscoveryOptions, o as ConfigSearchPathOptions, p as ManifestDiscoveryOptions, r as ConfigDiscoveryResult, s as FormatLoader, t as ConfigAdapter } from "./index-Cp9kt2t-.mjs";
|
|
6
|
+
import { D as DEFINITION_SCHEMA_URL, O as DEFINITION_SCHEMA_VERSION, S as StdinBindingFragmentV1, _ as JsonSchemaOptions, a as CommandDefinitionFragmentV1, b as SourceSplitFragmentV1, c as ExampleDefinitionFragmentV1, d as FlagNegationFragmentV1, f as FlagPathChecksFragmentV1, g as InputSchemaProperty, h as InputSchemaDocument, i as CommandDefinitionDocumentV1, l as FlagDefinitionFragmentV1, m as InputSchemaBranch, n as ArgElementFragmentV1, o as DefinitionDocument, p as FlagStringConstraintsFragmentV1, r as CommandDefinitionDocument, s as DefinitionDocumentV1, t as ArgDefinitionFragmentV1, u as FlagElementFragmentV1, v as PromptChoiceFragmentV1, x as SplitPolicyFragmentV1, y as PromptDefinitionFragmentV1 } from "./index-3l8uj16E.mjs";
|
|
7
7
|
import { Colors } from "ansispeck";
|
|
8
8
|
//#region src/core/help/ansi.d.ts
|
|
9
9
|
/**
|
package/dist/index.mjs
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{$ as ParseError,B as resolveExampleCommand,D as tokenize,E as stripBeforeSeparator,F as visibleWidth,G as getFlagNegatedName,H as createFlagSchema,I as CommandBuilder,J as createArgSchema,K as ArgBuilder,L as command,M as formatHelp,O as wasExplicit,P as osc8,Q as CLIError,R as createCommandSchema,S as resolvePromptConfig,T as parse,U as flag,V as FlagBuilder,X as SPLIT_FORMATS,Y as DUPLICATE_KEYS,a as
|
|
1
|
+
import{$ as ParseError,B as resolveExampleCommand,D as tokenize,E as stripBeforeSeparator,F as visibleWidth,G as getFlagNegatedName,H as createFlagSchema,I as CommandBuilder,J as createArgSchema,K as ArgBuilder,L as command,M as formatHelp,O as wasExplicit,P as osc8,Q as CLIError,R as createCommandSchema,S as resolvePromptConfig,T as parse,U as flag,V as FlagBuilder,X as SPLIT_FORMATS,Y as DUPLICATE_KEYS,a as CLIBuilder,c as isMainModule,d as plugin,et as ValidationError,i as DEFINITION_SCHEMA_VERSION,it as SHELLS,j as createOutput,k as middleware,l as resolveRenderContext,n as readFlags,nt as isParseError,o as cli,q as arg,r as DEFINITION_SCHEMA_URL,rt as isValidationError,s as createCLISchema,tt as isCLIError,w as includesBeforeSeparator,x as resolve,z as group}from"./core-DvXUolc_.mjs";export{ArgBuilder,CLIBuilder,CLIError,CommandBuilder,DEFINITION_SCHEMA_URL,DEFINITION_SCHEMA_VERSION,DUPLICATE_KEYS,FlagBuilder,ParseError,SHELLS,SPLIT_FORMATS,ValidationError,arg,cli,command,createArgSchema,createCLISchema,createCommandSchema,createFlagSchema,createOutput,flag,formatHelp,getFlagNegatedName,group,includesBeforeSeparator,isCLIError,isMainModule,isParseError,isValidationError,middleware,osc8,parse,plugin,readFlags,resolve,resolveExampleCommand,resolvePromptConfig,resolveRenderContext,stripBeforeSeparator,tokenize,visibleWidth,wasExplicit};
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import{t as __exportAll}from"./rolldown-runtime-G4Kt5YOX.mjs";import{B as resolveExampleCommand,N as resolvePlainHelpDescription,W as getFlagAliasNames,Y as DUPLICATE_KEYS,
|
|
1
|
+
import{t as __exportAll}from"./rolldown-runtime-G4Kt5YOX.mjs";import{B as resolveExampleCommand,N as resolvePlainHelpDescription,W as getFlagAliasNames,Y as DUPLICATE_KEYS,r as DEFINITION_SCHEMA_URL}from"./core-DvXUolc_.mjs";const definitionMetaSchemaDescriptions={root:{description:`Runtime descriptor for the CLI program.
|
|
2
2
|
|
|
3
3
|
Stores the program name, version, description, and registered command schemas.\\
|
|
4
4
|
Sealed by createCLISchema and rebuilt by each CLIBuilder step.`,properties:{name:{description:`Program name (used in help text, usage lines, and completion scripts).`},version:{description:"Program version (shown by `--version`)."},description:{description:`Program description (shown in root help).`},defaultCommand:{description:`Schema of the default command dispatched when no subcommand matches.
|
package/dist/json-schema.d.mts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import { C as definitionMetaSchema, D as DEFINITION_SCHEMA_URL, E as generateSchema, O as DEFINITION_SCHEMA_VERSION, S as StdinBindingFragmentV1, T as generateInputSchema, _ as JsonSchemaOptions, a as CommandDefinitionFragmentV1, b as SourceSplitFragmentV1, c as ExampleDefinitionFragmentV1, d as FlagNegationFragmentV1, f as FlagPathChecksFragmentV1, g as InputSchemaProperty, h as InputSchemaDocument, i as CommandDefinitionDocumentV1, l as FlagDefinitionFragmentV1, m as InputSchemaBranch, n as ArgElementFragmentV1, o as DefinitionDocument, p as FlagStringConstraintsFragmentV1, r as CommandDefinitionDocument, s as DefinitionDocumentV1, t as ArgDefinitionFragmentV1, u as FlagElementFragmentV1, v as PromptChoiceFragmentV1, w as generateCommandSchema, x as SplitPolicyFragmentV1, y as PromptDefinitionFragmentV1 } from "./index-
|
|
1
|
+
import { C as definitionMetaSchema, D as DEFINITION_SCHEMA_URL, E as generateSchema, O as DEFINITION_SCHEMA_VERSION, S as StdinBindingFragmentV1, T as generateInputSchema, _ as JsonSchemaOptions, a as CommandDefinitionFragmentV1, b as SourceSplitFragmentV1, c as ExampleDefinitionFragmentV1, d as FlagNegationFragmentV1, f as FlagPathChecksFragmentV1, g as InputSchemaProperty, h as InputSchemaDocument, i as CommandDefinitionDocumentV1, l as FlagDefinitionFragmentV1, m as InputSchemaBranch, n as ArgElementFragmentV1, o as DefinitionDocument, p as FlagStringConstraintsFragmentV1, r as CommandDefinitionDocument, s as DefinitionDocumentV1, t as ArgDefinitionFragmentV1, u as FlagElementFragmentV1, v as PromptChoiceFragmentV1, w as generateCommandSchema, x as SplitPolicyFragmentV1, y as PromptDefinitionFragmentV1 } from "./index-3l8uj16E.mjs";
|
|
2
2
|
export { type ArgDefinitionFragmentV1, type ArgElementFragmentV1, type CommandDefinitionDocument, type CommandDefinitionDocumentV1, type CommandDefinitionFragmentV1, DEFINITION_SCHEMA_URL, DEFINITION_SCHEMA_VERSION, type DefinitionDocument, type DefinitionDocumentV1, type ExampleDefinitionFragmentV1, type FlagDefinitionFragmentV1, type FlagElementFragmentV1, type FlagNegationFragmentV1, type FlagPathChecksFragmentV1, type FlagStringConstraintsFragmentV1, type InputSchemaBranch, type InputSchemaDocument, type InputSchemaProperty, type JsonSchemaOptions, type PromptChoiceFragmentV1, type PromptDefinitionFragmentV1, type SourceSplitFragmentV1, type SplitPolicyFragmentV1, type StdinBindingFragmentV1, definitionMetaSchema, generateCommandSchema, generateInputSchema, generateSchema };
|
package/dist/json-schema.mjs
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{i as DEFINITION_SCHEMA_VERSION,r as DEFINITION_SCHEMA_URL}from"./core-DvXUolc_.mjs";import{i as generateSchema,n as generateCommandSchema,r as generateInputSchema,t as definitionMetaSchema}from"./json-schema-DRlrz_IV.mjs";export{DEFINITION_SCHEMA_URL,DEFINITION_SCHEMA_VERSION,definitionMetaSchema,generateCommandSchema,generateInputSchema,generateSchema};
|
package/dist/prompt.mjs
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{S as resolvePromptConfig}from"./core-
|
|
1
|
+
import{S as resolvePromptConfig}from"./core-DvXUolc_.mjs";import{t as createTerminalPrompter}from"./terminal-C8KTXjv5.mjs";export{createTerminalPrompter,resolvePromptConfig};
|
package/dist/runtime.d.mts
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import { n as RuntimeAdapter, r as TerminalSize, t as ExitError } from "./adapter-
|
|
2
|
-
import { a as createAdapter, c as Runtime, i as createDenoAdapter, l as detectRuntime, n as createNodeAdapter, o as GlobalForDetect, r as DenoNamespace, s as RUNTIMES, t as NodeProcess } from "./index-
|
|
1
|
+
import { n as RuntimeAdapter, r as TerminalSize, t as ExitError } from "./adapter-YM5QGi3M.mjs";
|
|
2
|
+
import { a as createAdapter, c as Runtime, i as createDenoAdapter, l as detectRuntime, n as createNodeAdapter, o as GlobalForDetect, r as DenoNamespace, s as RUNTIMES, t as NodeProcess } from "./index-Cap0MA2V.mjs";
|
|
3
3
|
export { type DenoNamespace, ExitError, type GlobalForDetect, type NodeProcess, RUNTIMES, type Runtime, type RuntimeAdapter, type TerminalSize, createAdapter, createDenoAdapter, createNodeAdapter, detectRuntime };
|
package/dist/runtime.mjs
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{_ as
|
|
1
|
+
import{_ as detectRuntime,g as RUNTIMES,h as createNodeAdapter,m as createAdapter,v as createDenoAdapter,y as ExitError}from"./core-DvXUolc_.mjs";export{ExitError,RUNTIMES,createAdapter,createDenoAdapter,createNodeAdapter,detectRuntime};
|
package/dist/testkit.d.mts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { G as ArgConfig, Nt as FlagBuilder, Pt as FlagConfig, W as ArgBuilder, g as CommandBuilder, r as createCaptureOutput, t as CapturedOutput } from "./index-BziI2aKc.mjs";
|
|
2
2
|
import { U as BuiltinsConfig, a as TestPrompterOptions, i as TestAnswer, n as RunResult, o as createTestPrompter, r as PROMPT_CANCEL, t as RunOptions } from "./index-DWsnGZlx.mjs";
|
|
3
|
-
import { a as createTestAdapter, i as TestAdapterOptions } from "./adapter-
|
|
4
|
-
import "./index-
|
|
3
|
+
import { a as createTestAdapter, i as TestAdapterOptions } from "./adapter-YM5QGi3M.mjs";
|
|
4
|
+
import "./index-Cap0MA2V.mjs";
|
|
5
5
|
//#region src/core/testkit/index.d.ts
|
|
6
6
|
/**
|
|
7
7
|
* Options for {@linkcode runCommand}.
|
package/dist/testkit.mjs
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{A as createCaptureOutput,
|
|
1
|
+
import{A as createCaptureOutput,b as createTestAdapter,t as runCommand}from"./core-DvXUolc_.mjs";import{n as createTestPrompter,t as PROMPT_CANCEL}from"./test-prompter-v__jT2yG.mjs";export{PROMPT_CANCEL,createCaptureOutput,createTestAdapter,createTestPrompter,runCommand};
|
package/dist/version.mjs
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
const DREAMCLI_VERSION=`4.
|
|
1
|
+
const DREAMCLI_VERSION=`4.1.0`,DREAMCLI_REVISION=`9029705`;export{DREAMCLI_REVISION,DREAMCLI_VERSION};
|
package/package.json
CHANGED
|
@@ -52,7 +52,7 @@ deno doc --filter=CLIBuilder jsr:@kjanat/dreamcli 2>/dev/null # one symbol
|
|
|
52
52
|
`2>/dev/null` matters: deno writes download and type-check progress to stderr,
|
|
53
53
|
which otherwise swamps the documentation output.
|
|
54
54
|
|
|
55
|
-
Pin a version with `jsr:@kjanat/dreamcli@4.
|
|
55
|
+
Pin a version with `jsr:@kjanat/dreamcli@4.1.0` when the project is not on
|
|
56
56
|
latest. `--filter` takes a declaration name; it prints nothing for a name that
|
|
57
57
|
does not exist, which is itself a useful signal.
|
|
58
58
|
|