@kjanat/dreamcli 5.0.0 → 5.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.
Files changed (42) hide show
  1. package/dist/completion-B4oRc2Ae.mjs +59 -0
  2. package/dist/completion.d.mts +11 -1
  3. package/dist/completion.mjs +1 -1
  4. package/dist/config-DSh3QJpX.mjs +1 -0
  5. package/dist/config.d.mts +11 -1
  6. package/dist/config.mjs +1 -1
  7. package/dist/core-BZx351-p.mjs +21 -0
  8. package/dist/dynamic-BK2lQF2M.mjs +1 -0
  9. package/dist/{index-BidVVmln.d.mts → index-CLtWJqwn.d.mts} +8 -5
  10. package/dist/{index-BIMjOsR6.d.mts → index-CuhI1Ynv.d.mts} +394 -4
  11. package/dist/{index-DpslpOVV.d.mts → index-DDhRLoTu.d.mts} +7 -1
  12. package/dist/{index-jq_FJRKt.d.mts → index-DIWRV_wp.d.mts} +1 -1
  13. package/dist/{index-hzYPRc_O.d.mts → index-Vjl2_m23.d.mts} +5 -5
  14. package/dist/{index-AIC5Gler.d.mts → index-aTmg9yfl.d.mts} +1 -1
  15. package/dist/index.d.mts +30 -7
  16. package/dist/index.mjs +1 -1
  17. package/dist/json-schema-CYgq_hFu.mjs +59 -0
  18. package/dist/json-schema.d.mts +9 -1
  19. package/dist/json-schema.mjs +1 -1
  20. package/dist/{package-json-fYhxDdWD.mjs → package-json-hqUWeazy.mjs} +1 -1
  21. package/dist/prompt.d.mts +12 -1
  22. package/dist/prompt.mjs +1 -1
  23. package/dist/rolldown-runtime-DOYBPklu.mjs +1 -0
  24. package/dist/runtime.d.mts +20 -2
  25. package/dist/runtime.mjs +1 -1
  26. package/dist/session-BEKj0yLA.mjs +1 -0
  27. package/dist/{terminal-DRsRn4sc.mjs → terminal-Dws_b5UK.mjs} +1 -1
  28. package/dist/test-prompter-euLYzWWO.mjs +1 -0
  29. package/dist/testkit.d.mts +17 -4
  30. package/dist/testkit.mjs +1 -1
  31. package/dist/version.mjs +1 -1
  32. package/dreamcli.schema.json +11 -0
  33. package/package.json +7 -7
  34. package/skills/cli-creation/SKILL.md +1 -1
  35. package/dist/adapter-DBeedKmD.d.mts +0 -283
  36. package/dist/completion-Bh-qywmB.mjs +0 -6
  37. package/dist/config-DruA8aFV.mjs +0 -1
  38. package/dist/core-B9YNSJeA.mjs +0 -19
  39. package/dist/json-schema-DF5fXdKQ.mjs +0 -59
  40. package/dist/rolldown-runtime-G4Kt5YOX.mjs +0 -1
  41. package/dist/session-Crtzt7LY.mjs +0 -1
  42. package/dist/test-prompter-BLNGCOA_.mjs +0 -1
@@ -0,0 +1,21 @@
1
+ import{createColors,isColorSupported,strip}from"ansispeck";const SHELLS=Object.freeze([`bash`,`zsh`,`fish`,`powershell`]);function normalizeShell(e){let t=e.split(/[\\/]/),n=(t[t.length-1]??e).replace(/\.(?:exe|cmd|bat)$/i,``);return n===`pwsh`?`powershell`:SHELLS.includes(n)?n:void 0}function detectShell(e){let t=e.SHELL,n=t!==void 0&&t!==``?normalizeShell(t):void 0;if(n!==void 0)return n;if(e.PSModulePath!==void 0)return`powershell`}const OMIT=Symbol(`omit`);function project(e,t){switch(typeof e){case`string`:case`number`:case`boolean`:return e;case`bigint`:return String(e);case`undefined`:case`function`:case`symbol`:return OMIT}if(e===null)return null;if(t.has(e))return OMIT;try{let n=Reflect.get(e,`toJSON`);if(typeof n==`function`){let r=Reflect.apply(n,e,[]);return r===e?projectStructure(e,t):project(r,t)}return projectStructure(e,t)}catch{return OMIT}}function projectStructure(e,t){t.add(e);try{return Array.isArray(e)?e.map(e=>{let n=project(e,t);return n===OMIT?null:n}):projectRecord(e,t)}finally{t.delete(e)}}function projectRecord(e,t){let n={};for(let[r,i]of Object.entries(e)){let e=project(i,t);e!==OMIT&&(n[r]=e)}return n}function toJsonSafeRecord(e){return projectRecord(e,/* @__PURE__ */ new WeakSet)}var CLIError=class extends Error{name=`CLIError`;code;exitCode;suggest;details;constructor(e,t){super(e,t.cause===void 0?void 0:{cause:t.cause}),this.code=t.code,this.exitCode=t.exitCode??1,this.suggest=t.suggest,this.details=t.details}toJSON(){return{name:this.name,code:this.code,message:this.message,exitCode:this.exitCode,...this.suggest!==void 0&&{suggest:this.suggest},...this.details!==void 0&&{details:toJsonSafeRecord(this.details)}}}},ParseError=class extends CLIError{name=`ParseError`;constructor(e,t){super(e,{...t,exitCode:t.exitCode??2})}},ValidationError=class extends CLIError{name=`ValidationError`;constructor(e,t){super(e,{...t,exitCode:t.exitCode??2})}};function isCLIError(e){return e instanceof CLIError}function isParseError(e){return e instanceof ParseError}function isValidationError(e){return e instanceof ValidationError}const BUILTIN_SPECS={help:{long:[`--help`],short:[`-h`],description:`Show this help message and exit`},json:{long:[`--json`],short:[],description:`Emit machine-readable JSON output`},quiet:{long:[`--quiet`],short:[`-q`],description:`Suppress informational output`}};function builtinSpelling(e){return BUILTIN_SPECS[e].long[0]??BUILTIN_SPECS[e].short[0]??e}const BUILTIN_NAMES=[`help`,`json`,`quiet`],DEFAULT_BUILTINS={help:`on`,json:`on`,quiet:`on`};function builtinEnabled(e,t){return(e?.[t]??`on`)===`on`}function builtinFlagForms(e){let t=BUILTIN_SPECS[e];return[...t.short,...t.long].join(`, `)}function builtinTokens(e){let t=BUILTIN_SPECS[e];return[...t.long,...t.short].map(e=>e.replace(/^-+/,``))}function readBuiltinMode(e,t){let n=e[t];if(n===void 0||n===`on`||n===`off`)return n??`on`;throw new CLIError(`Built-in '${t}' must be 'on' or 'off'`,{code:`INVALID_SCHEMA`,details:{builtin:t,value:n},suggest:`Pass { ${t}: 'off' } to release the flag, or omit the key to keep it on`})}function normalizeBuiltins(e){return e===void 0?DEFAULT_BUILTINS:{help:readBuiltinMode(e,`help`),json:readBuiltinMode(e,`json`),quiet:readBuiltinMode(e,`quiet`)}}function formatDisplayValue(e){if(e==null)return``;if(typeof e==`string`||typeof e==`number`||typeof e==`boolean`||typeof e==`bigint`||typeof e==`symbol`)return String(e);if(e instanceof Date)return Number.isNaN(e.getTime())?`Invalid Date`:e.toISOString();if(typeof e==`function`)return e.name.length>0?`[Function: ${e.name}]`:`[Function]`;try{return JSON.stringify(e)??`[unserializable]`}catch{return`[unserializable]`}}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 validateNumberConstraints(e,t){if(Number.isNaN(e)||(t?.finite??!0)&&!Number.isFinite(e))return{kind:`finite`};if(t?.int===!0&&!Number.isInteger(e))return{kind:`int`};if(t?.min!==void 0&&e<t.min)return{kind:`min`,bound:t.min};if(t?.max!==void 0&&e>t.max)return{kind:`max`,bound:t.max}}function describeNumberConstraintViolation(e){switch(e.kind){case`finite`:return`must be a finite number`;case`int`:return`must be an integer`;case`min`:return`must be >= ${e.bound}`;case`max`:return`must be <= ${e.bound}`}}function assertNumberConstraints(e){if(e.min!==void 0&&!Number.isFinite(e.min))throw RangeError(`number constraint 'min' must be a finite number (got ${e.min}); omit it for no lower bound`);if(e.max!==void 0&&!Number.isFinite(e.max))throw RangeError(`number constraint 'max' must be a finite number (got ${e.max}); omit it for no upper bound`);if(e.min!==void 0&&e.max!==void 0&&e.min>e.max)throw RangeError(`number constraint 'min' (${e.min}) must not exceed 'max' (${e.max})`)}function validateStringConstraints(e,t){if(t!==void 0){if(t.nonEmpty===!0&&e.length===0)return{kind:`nonEmpty`};if(t.minLength!==void 0&&e.length<t.minLength)return{kind:`minLength`,bound:t.minLength};if(t.maxLength!==void 0&&e.length>t.maxLength)return{kind:`maxLength`,bound:t.maxLength};if(t.pattern!==void 0&&(t.pattern.lastIndex=0,!t.pattern.test(e)))return{kind:`pattern`,pattern:String(t.pattern)}}}function describeStringConstraintViolation(e){switch(e.kind){case`nonEmpty`:return`must not be empty`;case`minLength`:return`must be at least ${e.bound} characters`;case`maxLength`:return`must be at most ${e.bound} characters`;case`pattern`:return`must match ${e.pattern}`}}function stringConstraintDetails(e){return{constraint:e.kind,...`bound`in e?{bound:e.bound}:{},...`pattern`in e?{pattern:e.pattern}:{}}}function assertStringConstraints(e){for(let t of[`minLength`,`maxLength`]){let n=e[t];if(n!==void 0&&(!Number.isInteger(n)||n<0))throw RangeError(`string constraint '${t}' must be a non-negative integer (got ${n}); omit it for no bound`)}if(e.minLength!==void 0&&e.maxLength!==void 0&&e.minLength>e.maxLength)throw RangeError(`string constraint 'minLength' (${e.minLength}) must not exceed 'maxLength' (${e.maxLength})`)}const ISO_DATE_PATTERN=/^(\d{4})-(\d{2})-(\d{2})(?:T(\d{2}):(\d{2})(?::(\d{2})(?:\.(\d{1,3}))?)?(Z|[+-]\d{2}:\d{2})?)?$/;function parseDateValue(e,t){if(e instanceof Date)return validateDateBounds(e,t);if(typeof e!=`string`)throw Error(`Invalid date: expected an ISO-8601 string`);let n=ISO_DATE_PATTERN.exec(e);if(n===null)throw Error(`Invalid date: expected ISO-8601 (e.g. 2026-07-10 or 2026-07-10T14:30:00Z)`);let[,r,i,a,o,s,c]=n,l=Number(r),u=Number(i),d=Number(a);if(u<1||u>12)throw Error(`Invalid date: month must be 01-12`);if(d<1||d>daysInMonth(l,u))throw Error(`Invalid date: not a real calendar date`);if(o!==void 0&&Number(o)>23)throw Error(`Invalid date: hours must be 00-23`);if(s!==void 0&&Number(s)>59)throw Error(`Invalid date: minutes must be 00-59`);if(c!==void 0&&Number(c)>59)throw Error(`Invalid date: seconds must be 00-59`);let f=n[4]!==void 0,p=n[8]!==void 0,m=new Date(f&&!p?`${e}Z`:e);if(Number.isNaN(m.getTime()))throw Error(`Invalid date`);return validateDateBounds(m,t)}function daysInMonth(e,t){return new Date(Date.UTC(e,t,0)).getUTCDate()}function validateDateBounds(e,t){if(Number.isNaN(e.getTime()))throw Error(`Invalid date`);if(t?.min!==void 0&&e.getTime()<t.min.getTime())throw Error(`Date is before the earliest allowed ${t.min.toISOString()}`);if(t?.max!==void 0&&e.getTime()>t.max.getTime())throw Error(`Date is after the latest allowed ${t.max.toISOString()}`);return e}function parseUrlValue(e,t){if(typeof e!=`string`&&!(e instanceof URL))throw Error(`Invalid URL: expected a URL string`);let n;try{n=e instanceof URL?e:new URL(e)}catch{throw Error(`Invalid URL`)}if(t?.protocols!==void 0){let e=n.protocol.replace(/:$/,``);if(!t.protocols.includes(e))throw Error(`URL protocol is not allowed. Allowed: ${t.protocols.join(`, `)}`)}return n}const DURATION_UNITS={ms:1,s:1e3,m:6e4,h:36e5,d:864e5};function parseDurationValue(e){if(typeof e==`number`){if(!Number.isFinite(e)||e<0)throw Error(`Invalid duration: must be a non-negative number`);return e}if(typeof e!=`string`||e.length===0)throw Error(`Invalid duration: expected e.g. 30s, 5m, 1h30m, or 250ms`);if(/^\d+(?:\.\d+)?$/.test(e))return Number(e);let t=/(\d+(?:\.\d+)?)(ms|s|m|h|d)/gy,n=0,r=0;for(let i of e.matchAll(t)){let[e,t,a]=i,o=a===void 0?void 0:DURATION_UNITS[a];if(t===void 0||o===void 0)break;n+=Number(t)*o,r+=e.length}if(r!==e.length||r===0)throw Error(`Invalid duration: expected e.g. 30s, 5m, 1h30m, or 250ms`);return n}const BYTE_UNITS={b:1,kb:1024,mb:1024**2,gb:1024**3,tb:1024**4};function parseBytesValue(e){if(typeof e==`number`){if(!Number.isFinite(e)||e<0)throw Error(`Invalid size: must be a non-negative number`);return e}if(typeof e!=`string`||e.length===0)throw Error(`Invalid size: expected e.g. 512mb, 1.5gb, or 64kb`);let t=/^(\d+(?:\.\d+)?)\s*(b|kb|mb|gb|tb)?$/i.exec(e);if(t===null||t[1]===void 0)throw Error(`Invalid size: expected e.g. 512mb, 1.5gb, or 64kb`);let n=(t[2]??`b`).toLowerCase(),r=BYTE_UNITS[n];if(r===void 0)throw Error(`Invalid size: unknown unit`);return Math.round(Number(t[1])*r)}function buildPathChecks(e){if(!(e===void 0||e.mustExist!==!0&&e.type===void 0))return{mustExist:e.mustExist??!0,type:e.type,create:e.type===`directory`&&e.create===!0}}const STRING_TYPE_FAILURE={ok:!1,failure:{kind:`type`,expected:`string`}},NUMBER_TYPE_FAILURE={ok:!1,failure:{kind:`type`,expected:`number`}},BOOLEAN_TYPE_FAILURE={ok:!1,failure:{kind:`type`,expected:`boolean`}},stringCodec={name:`string`,decode(e,t){return typeof e==`string`?{ok:!0,value:e}:t===`prompt`||t===`config`&&(typeof e==`number`||typeof e==`boolean`)?{ok:!0,value:String(e)}:STRING_TYPE_FAILURE}},strictStringCodec={name:`string`,decode(e){return typeof e==`string`?{ok:!0,value:e}:STRING_TYPE_FAILURE}},numberCodec={name:`number`,decode(e){if(typeof e==`number`)return Number.isNaN(e)?NUMBER_TYPE_FAILURE:{ok:!0,value:e};if(typeof e==`string`&&e.trim()!==``){let t=Number(e);if(!Number.isNaN(t))return{ok:!0,value:t}}return NUMBER_TYPE_FAILURE}},booleanCodec={name:`boolean`,decode(e,t){if(t===`token`)return e===`true`||e===`1`?{ok:!0,value:!0}:e===`false`||e===`0`?{ok:!0,value:!1}:BOOLEAN_TYPE_FAILURE;if(typeof e==`boolean`)return{ok:!0,value:e};if(typeof e==`string`){let n=e.toLowerCase();if(n===`true`||n===`1`||n===`yes`||t===`prompt`&&n===`y`)return{ok:!0,value:!0};if(n===`false`||n===`0`||n===`no`||n===``||t===`prompt`&&n===`n`)return{ok:!0,value:!1}}return BOOLEAN_TYPE_FAILURE}};function enumCodec(e){return{name:`enum`,enumValues:e,decode(t){return typeof t==`string`&&e?.includes(t)===!0?{ok:!0,value:t}:{ok:!1,failure:{kind:`enum`,enumValues:e}}}}}const passthroughCodec={name:`custom`,parseFn:void 0,decode(e){return{ok:!0,value:e}}};function parsedCodec(e){return{name:`custom`,parseFn:e,decode(t){try{return{ok:!0,value:e(t)}}catch(e){return{ok:!1,failure:{kind:`thrown`,error:e}}}}}}function stringParsedCodec(e){return{name:`custom`,parseFn:e,decode(t){try{return{ok:!0,value:e(typeof t==`string`?t:String(t))}}catch(e){return{ok:!1,failure:{kind:`thrown`,error:e}}}}}}function decodeValue(e,t,n){let r=e.codec.decode(stdinDecodeInput(e,t,n),n);if(!r.ok)return r;let i=checkValueConstraints(e.constraints,r.value);return i===void 0?r:{ok:!1,failure:i}}function stdinDecodeInput(e,t,n){return n!==`stdin`||keepsStdinTerminator(e)||typeof t!=`string`?t:stripTerminator(t)}function stripTerminator(e){return e.endsWith(`\r
2
+ `)?e.slice(0,-2):e.endsWith(`
3
+ `)||e.endsWith(`\r`)?e.slice(0,-1):e}function keepsStdinTerminator(e){return e.codec.name===`string`}function validateDecodedValue(e,t){return checkValueDomain(e.codec,t)??checkValueConstraints(e.constraints,t)}function checkValueDomain(e,t){switch(e.name){case`string`:return typeof t==`string`?void 0:{kind:`type`,expected:`string`};case`number`:return typeof t==`number`?void 0:{kind:`type`,expected:`number`};case`boolean`:return typeof t==`boolean`?void 0:{kind:`type`,expected:`boolean`};case`enum`:return typeof t==`string`&&e.enumValues?.includes(t)===!0?void 0:{kind:`enum`,enumValues:e.enumValues};case`custom`:return}}function describeValueFailure(e){switch(e.kind){case`type`:return`expected a ${e.expected}`;case`enum`:return`expected one of: ${(e.enumValues??[]).join(`, `)}`;case`string-constraint`:return describeStringConstraintViolation(e.violation);case`number-constraint`:return describeNumberConstraintViolation(e.violation);case`thrown`:return e.error instanceof Error?e.error.message:String(e.error)}}function checkValueConstraints(e,t){if(e===void 0)return;if(e.kind===`string`){if(typeof t!=`string`)return;let n=validateStringConstraints(t,e.stringConstraints);return n===void 0?void 0:{kind:`string-constraint`,value:t,violation:n}}if(typeof t!=`number`)return;let n=validateNumberConstraints(t,e.numberConstraints);return n===void 0?void 0:{kind:`number-constraint`,value:t,violation:n}}function makeValue(e,t){return{codec:e,constraints:t?.constraints,standard:t?.standard,pathChecks:t?.pathChecks,valueHint:t?.valueHint}}function stringValue(e){return makeValue(stringCodec,{constraints:{kind:`string`,stringConstraints:e}})}function strictStringValue(){return makeValue(strictStringCodec,{constraints:{kind:`string`,stringConstraints:void 0}})}function numberValue(e){return makeValue(numberCodec,{constraints:{kind:`number`,numberConstraints:e}})}function booleanValue(){return makeValue(booleanCodec)}function enumValue(e){return makeValue(enumCodec(e))}function customValue(e){return makeValue(parsedCodec(e))}function stringParsedValue(e){return makeValue(stringParsedCodec(e))}function standardValue(e){return makeValue(passthroughCodec,{standard:e})}function passthroughValue(){return makeValue(passthroughCodec)}function urlValue(e){return makeValue(parsedCodec(t=>parseUrlValue(t,e)),{valueHint:`url`})}function pathValue(e){let t=buildPathChecks(e);return makeValue(stringCodec,{constraints:{kind:`string`,stringConstraints:void 0},valueHint:`path`,...t===void 0?{}:{pathChecks:t}})}function dateValue(e){return makeValue(parsedCodec(t=>parseDateValue(t,e)),{valueHint:`date`})}function durationValue(){return makeValue(parsedCodec(parseDurationValue),{valueHint:`duration`})}function bytesValue(){return makeValue(parsedCodec(parseBytesValue),{valueHint:`size`})}function valueDefinitionFields(e){let t=e.constraints,n=e.codec;return{...t?.kind===`string`&&t.stringConstraints!==void 0?{stringConstraints:t.stringConstraints}:{},...t?.kind===`number`&&t.numberConstraints!==void 0?{numberConstraints:t.numberConstraints}:{},...n.name===`custom`&&n.parseFn!==void 0?{parseFn:n.parseFn}:{},...e.standard===void 0?{}:{standard:e.standard},...e.pathChecks===void 0?{}:{pathChecks:e.pathChecks},...e.valueHint===void 0?{}:{valueHint:e.valueHint}}}function flagValueSchema(e){switch(e.kind){case`string`:return scalarValue(e,stringValue(e.stringConstraints));case`number`:return scalarValue(e,numberValue(e.numberConstraints));case`boolean`:return scalarValue(e,booleanValue());case`enum`:return scalarValue(e,enumValue(e.enumValues));case`custom`:return scalarValue(e,e.parseFn===void 0?passthroughValue():customValue(e.parseFn));case`array`:return elementValue(e,passthroughValue);case`keyValue`:return elementValue(e,strictStringValue);case`count`:return scalarValue(e,numberValue({int:!0,min:0}))}}function flagAggregateStandard(e){return e.aggregateStandard}function argValueSchema(e){switch(e.kind){case`string`:return scalarValue(e,stringValue(e.stringConstraints));case`number`:return scalarValue(e,numberValue(e.numberConstraints));case`boolean`:return scalarValue(e,booleanValue());case`enum`:return scalarValue(e,enumValue(e.enumValues));case`custom`:return scalarValue(e,e.parseFn===void 0?passthroughValue():stringParsedValue(e.parseFn));case`keyValue`:return argElementValue(e)}}function argElementValue(e){let t=e.elementSchema===void 0?strictStringValue():argValueSchema(e.elementSchema);return t.standard===void 0&&e.standard!==void 0?{...t,standard:e.standard}:t}function argAggregateStandard(e){return e.aggregateStandard}function scalarValue(e,t){return{...t,standard:e.standard,pathChecks:e.pathChecks,valueHint:e.valueHint}}function elementValue(e,t){let n=e.elementSchema===void 0?t():flagValueSchema(e.elementSchema);return n.standard===void 0&&e.standard!==void 0?{...n,standard:e.standard}:n}function valueEnumValues(e){return e?.codec.name===`enum`?e.codec.enumValues:void 0}const SPLIT_FORMATS=[`whole`,`delimiter`,`lines`,`json`],WHOLE={format:`whole`},LINES={format:`lines`},ENV_DEFAULT={format:`delimiter`,delimiter:`,`},NAMED_SPLIT_POLICIES={whole:WHOLE,lines:LINES,json:{format:`json`}},ALLOWED_SPLIT_FORMATS={cli:[`whole`,`delimiter`],env:[`whole`,`delimiter`,`json`],stdin:[`whole`,`delimiter`,`lines`,`json`]};function splitPolicyFromString(e){return Object.hasOwn(NAMED_SPLIT_POLICIES,e)?NAMED_SPLIT_POLICIES[e]??WHOLE:{format:`delimiter`,delimiter:e}}function normalizeSplitPolicy(e,t){if(typeof t==`string`)return normalizeSplitPolicyObject(e,splitPolicyFromString(t));if(typeof t!=`object`||!t)throw new CLIError(`Split policy for ${e} must be a string or object`,{code:`INVALID_SCHEMA`,details:{source:e,received:t===null?`null`:typeof t},suggest:`Pass a format name, delimiter string, or split-policy object`});return normalizeSplitPolicyObject(e,t)}function normalizeSplitPolicyObject(e,t){let n=t;if(typeof n.format!=`string`)throw new CLIError(`Split policy for ${e} requires a string format`,{code:`INVALID_SCHEMA`,details:{source:e,field:`format`,received:typeof n.format},suggest:`Pass a supported split format`});let r=ALLOWED_SPLIT_FORMATS[e];if(!r.includes(n.format))throw new CLIError(`Split format '${String(n.format)}' is not available for ${e}`,{code:`INVALID_SCHEMA`,details:{source:e,format:n.format,allowed:[...r]},suggest:`Use one of: ${r.filter(e=>e!==`delimiter`).join(`, `)}, or a delimiter string`});if(n.format!==`delimiter`)return{format:n.format};if(typeof n.delimiter!=`string`)throw new CLIError(`Split delimiter for ${e} must be a string`,{code:`INVALID_SCHEMA`,details:{source:e,format:n.format,received:typeof n.delimiter},suggest:`Pass a delimiter string, for example ','`});if(n.delimiter.length===0)throw new CLIError(`Split delimiter for ${e} must not be empty`,{code:`INVALID_SCHEMA`,details:{source:e,format:n.format},suggest:`Pass a non-empty delimiter, for example ','`});return{format:`delimiter`,delimiter:n.delimiter}}function normalizeSplitOptions(e,t){let n=e.cli===void 0?void 0:normalizeSplitPolicy(`cli`,e.cli),r=e.env===void 0?t?.env:normalizeSplitPolicy(`env`,e.env),i=e.stdin===void 0?t?.stdin:normalizeSplitPolicy(`stdin`,e.stdin);return{separator:n!==void 0&&n.format===`delimiter`?n.delimiter:void 0,setsSeparator:n!==void 0,split:r===void 0&&i===void 0?void 0:{env:r,stdin:i}}}function splitBindingOf(e,t){return{cli:e===void 0?WHOLE:{format:`delimiter`,delimiter:e},env:t?.env??ENV_DEFAULT,stdin:t?.stdin??LINES}}const DUPLICATE_KEYS=[`first`,`last`,`error`],ONE={kind:`one`},COUNT={kind:`count`};function flagCardinality(e){switch(e.kind){case`array`:return{kind:`many`,unique:e.unique,cliSplit:splitBindingOf(e.separator,e.split).cli};case`keyValue`:return{kind:`entries`,duplicateKeys:e.duplicateKeys,cliSplit:splitBindingOf(e.separator,e.split).cli};case`count`:return COUNT;case`string`:case`number`:case`boolean`:case`enum`:case`custom`:return ONE}}function argCardinality(e){return e.kind===`keyValue`?{kind:`entries`,duplicateKeys:e.duplicateKeys,cliSplit:splitBindingOf(e.separator,e.split).cli}:e.variadic?{kind:`many`,unique:e.unique,cliSplit:splitBindingOf(e.separator,e.split).cli}:ONE}function isCollection(e){return e.kind===`many`||e.kind===`entries`}function splitManyText(e,t){switch(e.format){case`whole`:return{ok:!0,parts:t.length===0?[]:[t]};case`delimiter`:return{ok:!0,parts:splitDelimited(t,e.delimiter)};case`lines`:return{ok:!0,parts:splitLines(t)};case`json`:{let e=parseJson(t);return e.ok?Array.isArray(e.value)?{ok:!0,parts:e.value}:{ok:!1,failure:{kind:`json-shape`,expected:`array`}}:e}}}function splitEntriesText(e,t){if(e.format===`json`){let e=parseJson(t);if(!e.ok)return e;let n=e.value;return typeof n!=`object`||!n||Array.isArray(n)?{ok:!1,failure:{kind:`json-shape`,expected:`object`}}:{ok:!0,parts:Object.entries(n)}}let n=e.format===`whole`?t.length===0?[]:[t]:e.format===`lines`?splitLines(t):splitDelimited(t,e.delimiter),r=[];for(let e of n){let t=splitEntryPair(e);if(t===void 0)return{ok:!1,failure:{kind:`pair`,raw:e}};r.push(t)}return{ok:!0,parts:r}}function splitEntryPair(e){let t=e.indexOf(`=`);if(!(t<=0))return[e.slice(0,t),e.slice(t+1)]}function splitDelimited(e,t){return e.split(t).filter(e=>e.length>0)}function splitLines(e){if(e.length===0)return[];let t=e.split(/\r\n|\n|\r/);return t.length>1&&t[t.length-1]===``&&t.pop(),t}function parseJson(e){try{return{ok:!0,value:JSON.parse(e)}}catch(e){return{ok:!1,failure:{kind:`json`,error:e}}}}function dedupe(e){return[...new Set(e)]}function foldEntries(e,t){let n=/* @__PURE__ */ new Map;for(let[r,[i,a]]of e.entries()){if(n.has(i)){if(t===`error`)return{ok:!1,duplicateKey:i,at:r};if(t===`first`)continue}n.set(i,a)}return{ok:!0,value:Object.fromEntries(n)}}function validateDefault(e,t,n,r){switch(t.kind){case`one`:return validateDefaultElement(e,void 0,r);case`count`:return typeof r==`number`&&Number.isInteger(r)&&r>=0?void 0:{kind:`shape`,expected:`count`};case`many`:if(!Array.isArray(r))return{kind:`shape`,expected:`array`};for(let[t,n]of r.entries()){let r=validateDefaultElement(e,{kind:`index`,index:t},n);if(r!==void 0)return r}return validateDefaultStandard(n,void 0,r);case`entries`:if(typeof r!=`object`||!r||Array.isArray(r))return{kind:`shape`,expected:`object`};for(let[t,n]of Object.entries(r)){let r=validateDefaultElement(e,{kind:`key`,key:t},n);if(r!==void 0)return r}return validateDefaultStandard(n,void 0,r)}}function validateDefaultElement(e,t,n){let r=validateDecodedValue(e,n);return r===void 0?validateDefaultStandard(e.standard,t,n):{kind:`element`,at:t,value:n,failure:r}}function validateDefaultStandard(e,t,n){if(e===void 0)return;let r=e[`~standard`].validate(n);if(!(r instanceof Promise)&&r.issues!==void 0)return{kind:`standard`,at:t,value:n,issues:r.issues.map(e=>e.message)}}const VOWEL_INITIAL=/^[aeiou]/i;function indefiniteArticle(e){return VOWEL_INITIAL.test(e)?`an`:`a`}function reportableDefaultLocation(e,t){if(`at`in e&&e.at!==void 0)return e.at.kind===`index`?String(e.at.index):t?void 0:e.at.key}function defaultViolationError(e,t,n,r){let i=reportableDefaultLocation(n,r),a=describeDefaultViolation(n);return new CLIError(`Default value for ${e}${i===void 0?``:` at ${i}`} is invalid: ${a}`,{code:`INVALID_DEFAULT`,details:{...t,...i===void 0?{}:{at:i},reason:a},suggest:`Change the default so it satisfies what ${e} accepts`})}function describeDefaultViolation(e){switch(e.kind){case`shape`:return e.expected===`count`?`expected a non-negative integer`:`expected an ${e.expected}`;case`element`:return describeValueFailure(e.failure);case`standard`:return e.issues.join(`; `)}}const ENV_INDEX_PLACEHOLDER=`{index}`;function envNameFault(e,t){if(typeof e!=`string`||e.length===0)return`must be a non-empty string`;if(e.includes(`=`)||e.includes(`\0`))return`must not contain '=' or NUL`;let n=e.split(ENV_INDEX_PLACEHOLDER),r=n.length-1;if(n.some(e=>e.includes(`{`)||e.includes(`}`)))return`must not contain braces other than the ${ENV_INDEX_PLACEHOLDER} placeholder`;if(t&&r===0)return`must contain the ${ENV_INDEX_PLACEHOLDER} placeholder`;if(!t&&r>0)return`must not contain the ${ENV_INDEX_PLACEHOLDER} placeholder`}function invalidBindingError(e,t,n){return new CLIError(`Indexed env binding '${e}' ${t}`,{code:`INVALID_SCHEMA`,details:{field:`envIndexed`,part:e},suggest:n})}function normalizeIndexedEnvBinding(e){if(typeof e!=`object`||!e)throw new CLIError(`Indexed env binding must be an object`,{code:`INVALID_SCHEMA`,details:{field:`envIndexed`},suggest:`Pass { count, value } or { count, fields } to '.env()'`});let t=envNameFault(e.count,!1);if(t!==void 0)throw invalidBindingError(`count`,t,`Name the variable that holds the number of entries, such as ITEM_COUNT`);let n=Object.hasOwn(e,`value`)&&e.value!==void 0;if(n===(Object.hasOwn(e,`fields`)&&e.fields!==void 0))throw new CLIError(`Indexed env binding needs exactly one of 'value' and 'fields'`,{code:`INVALID_SCHEMA`,details:{field:`envIndexed`},suggest:`Use 'value' for a list of values or 'fields' for a list of records`});if(n){let t=envNameFault(e.value,!0);if(t!==void 0)throw invalidBindingError(`value`,t,`Use a template such as ITEM_${ENV_INDEX_PLACEHOLDER}`);return Object.freeze({count:e.count,value:e.value})}let r=e.fields;if(typeof r!=`object`||!r||Array.isArray(r))throw invalidBindingError(`fields`,`must be an object mapping field names to templates`,`Use { key: 'KEY_${ENV_INDEX_PLACEHOLDER}', value: 'VALUE_${ENV_INDEX_PLACEHOLDER}' }`);let i=Object.entries(r);if(i.length===0)throw invalidBindingError(`fields`,`must declare at least one field`,`Declare a field per variable, or use 'value' for a list of values`);let a=/* @__PURE__ */ new Map;for(let[e,t]of i){if(e.length===0)throw invalidBindingError(`fields`,`must not use an empty field name`,`Name every field`);let n=envNameFault(t,!0);if(n!==void 0)throw invalidBindingError(`fields.${e}`,n,`Use a template such as ${e.toUpperCase()}_${ENV_INDEX_PLACEHOLDER}`);let r=a.get(t);if(r!==void 0)throw invalidBindingError(`fields.${e}`,`reuses the template of field '${r}'`,`Give every field its own variable template`);a.set(t,e)}return Object.freeze({count:e.count,fields:Object.freeze(Object.fromEntries(i))})}function envIdentifier(e){return e.replace(/([a-z0-9])([A-Z])/g,`$1_$2`).replace(/([A-Z]+)([A-Z][a-z])/g,`$1_$2`).toUpperCase().replace(/[^A-Z0-9]+/g,`_`).replace(/^_+|_+$/g,``)}function deriveEnvPrefix(e){let t=envIdentifier(e);if(t===``)throw new CLIError(`Cannot derive an env prefix from the CLI name '${e}'`,{code:`INVALID_SCHEMA`,details:{field:`envPrefix`,name:e},suggest:`Pass the prefix explicitly, such as .envPrefix('ACME_')`});return`${t}_`}function isIndexedEnvBinding(e){return typeof e==`object`&&!!e&&(Object.hasOwn(e,`count`)||Object.hasOwn(e,`value`)||Object.hasOwn(e,`fields`))}function deriveEnvName(e){let t=envIdentifier(e);if(t===``)throw new CLIError(`Cannot derive an env variable name from the input name '${e}'`,{code:`INVALID_SCHEMA`,details:{field:`envFromName`,name:e},suggest:`Name the variable explicitly, such as .env('TOKEN')`});return t}function normalizeEnvPrefix(e){let t=typeof e!=`string`||e.length===0?`must be a non-empty string`:/[={}\0]/.test(e)?`must not contain '=', braces, or NUL`:void 0;if(t!==void 0)throw new CLIError(`Env prefix ${t}`,{code:`INVALID_SCHEMA`,details:{field:`envPrefix`},suggest:`Use a prefix such as 'ACME_', or call .envPrefix() to derive one from the CLI name`});return e}function effectiveEnvName(e,t,n){return n||t===void 0?e:`${t}${e}`}function effectiveIndexedEnvBinding(e,t,n){if(n||t===void 0)return e;let r=`${t}${e.count}`;return e.fields===void 0?{count:r,value:`${t}${e.value}`}:{count:r,fields:Object.fromEntries(Object.entries(e.fields).map(([e,n])=>[e,`${t}${n}`]))}}function expandEnvTemplate(e,t){return e.replaceAll(ENV_INDEX_PLACEHOLDER,String(t))}function indexedEnvMembers(e){return e.fields===void 0?[[void 0,e.value]]:Object.entries(e.fields)}function formatIndexedEnvBinding(e){return`${indexedEnvMembers(e).map(([,e])=>e).join(` + `)}, count: ${e.count}`}function isStandardSchemaV1(e){if(e===null||typeof e!=`object`&&typeof e!=`function`||!(`~standard`in e))return!1;let t=e[`~standard`];return typeof t==`object`&&!!t&&`version`in t&&t.version===1&&`validate`in t&&typeof t.validate==`function`}const STDIN_WHENS=[`dash`,`missing`,`dash-or-missing`],STDIN_CONSUMES=[`exclusive`,`broadcast`],DEFAULT_STDIN_BINDING={when:`dash-or-missing`,consume:`exclusive`,trim:!1};function assertStdinOptions(e){if(e.argv!==void 0&&typeof e.argv!=`boolean`)throw new CLIError(`Stdin argv must be a boolean`,{code:`INVALID_SCHEMA`,suggest:`Pass argv: true or argv: false`});if(e.argv===!1&&e.when===`dash`)throw new CLIError(`Stdin mode 'dash' requires a command-line form`,{code:`INVALID_SCHEMA`,suggest:`Use when: 'missing' or omit when with argv: false`});if(e.when!==void 0&&!STDIN_WHENS.includes(e.when))throw new CLIError(`Unknown stdin mode '${String(e.when)}'`,{code:`INVALID_SCHEMA`,details:{when:e.when,allowed:[...STDIN_WHENS]},suggest:`Use one of: ${STDIN_WHENS.join(`, `)}`});if(e.consume!==void 0&&!STDIN_CONSUMES.includes(e.consume))throw new CLIError(`Unknown stdin consumption mode '${String(e.consume)}'`,{code:`INVALID_SCHEMA`,details:{consume:e.consume,allowed:[...STDIN_CONSUMES]},suggest:`Use one of: ${STDIN_CONSUMES.join(`, `)}`});if(e.trim!==void 0&&typeof e.trim!=`boolean`)throw new CLIError(`Stdin trim must be a boolean, received '${String(e.trim)}'`,{code:`INVALID_SCHEMA`,details:{trim:e.trim},suggest:`Pass trim: true or trim: false`})}function normalizeStdinBinding(e){return e===void 0?DEFAULT_STDIN_BINDING:(assertStdinOptions(e),{...e.argv===!1?{argv:!1}:{},when:e.when??DEFAULT_STDIN_BINDING.when,consume:e.consume??DEFAULT_STDIN_BINDING.consume,trim:e.trim??DEFAULT_STDIN_BINDING.trim})}function stdinReadsOnDash(e){return e.when===`dash`||e.when===`dash-or-missing`}function stdinReadsWhenMissing(e){return e.when===`missing`||e.when===`dash-or-missing`}function acceptsArgv(e){return e.stdin?.argv!==!1}const FLAG_KINDS=[`string`,`number`,`boolean`,`enum`,`array`,`custom`,`count`,`keyValue`];function normalizeFlagAlias(e){return typeof e==`string`?{name:e,hidden:!1}:{name:e.name,hidden:e.hidden}}function normalizeFlagAliases(e){return e.map(normalizeFlagAlias)}function getFlagAliasNames(e,t){let n=t?.includeHidden??!1,r=t?.kind??`all`;return e.aliases.filter(e=>n||!e.hidden).filter(e=>r===`short`?e.name.length===1:r!==`long`||e.name.length>1).map(e=>e.name)}function getFlagNegatedName(e,t){if(t.negation!==void 0)return t.negation.alias??`no-${e}`}const NORMALIZED_FLAG_SCHEMA_KEYS=/* @__PURE__ */ `kind.presence.defaultValue.defaultDescription.sensitive.aliases.stdin.envVar.envIndexed.envAbsolute.envFromName.configPath.description.enumValues.numberConstraints.stringConstraints.elementSchema.separator.split.duplicateKeys.unique.pathChecks.valueHint.prompt.parseFn.standard.aggregateStandard.deprecated.propagate.negation.duplicates`.split(`.`);function isNormalizedFlagSchema(e){return NORMALIZED_FLAG_SCHEMA_KEYS.every(t=>t in e)}function assertEligibleFlagElementBuilder(e){if(COLLECTION_FLAG_KINDS.includes(e.kind)||e.kind===`count`)throw new CLIError(`Flag element schema kind '${e.kind}' is not supported`,{code:`INVALID_SCHEMA`,details:{kind:e.kind,field:`kind`},suggest:`Use a scalar value kind for the collection element`});let t=[[`sensitive`,!1],[`defaultDescription`,void 0],[`presence`,e.kind===`boolean`?`defaulted`:`optional`],[`defaultValue`,e.kind!==`boolean`&&void 0],[`stdin`,void 0],[`envVar`,void 0],[`envIndexed`,void 0],[`envAbsolute`,!1],[`envFromName`,!1],[`configPath`,void 0],[`description`,void 0],[`elementSchema`,void 0],[`separator`,void 0],[`split`,void 0],[`duplicateKeys`,`last`],[`unique`,!1],[`prompt`,void 0],[`completion`,void 0],[`aggregateStandard`,void 0],[`deprecated`,void 0],[`propagate`,!1],[`negation`,void 0],[`duplicates`,`last`]];for(let[n,r]of t)if(e[n]!==r)throw new CLIError(`Flag element schema field '${String(n)}' is not supported`,{code:`INVALID_SCHEMA`,details:{kind:e.kind,field:n},suggest:`Drop '${String(n)}' from the collection element`});if(e.aliases.length!==0)throw new CLIError(`Flag element schema field 'aliases' is not supported`,{code:`INVALID_SCHEMA`,details:{kind:e.kind,field:`aliases`},suggest:`Drop 'aliases' from the collection element`})}function assertValidFlagElementSchema(e){let t=e.completion===void 0?e.sensitive?`sensitive`:e.defaultDescription===void 0?void 0:`defaultDescription`:`completion`;if(t!==void 0)throw new CLIError(`Flag element schema field '${t}' is not supported`,{code:`INVALID_SCHEMA`,details:{kind:e.kind,field:t},suggest:`Drop '${t}' from the collection element`})}function normalizeFlagElementSchema(e){if(isNormalizedFlagSchema(e))return assertValidFlagDefinition(e.kind,e),assertValidFlagElementSchema(e),e;let{kind:t,...n}=e;assertValidFlagDefinition(t,n);let r=buildFlagSchema(t,normalizeFlagDefinitionFields(n));return assertValidFlagElementSchema(r),r}function normalizeFlagDefinitionFields(e){let{elementSchema:t,...n}=e;return t===void 0?n:{...n,elementSchema:normalizeFlagElementSchema(t)}}const STDIN_CAPABLE_FLAG_KINDS=[`string`,`number`,`boolean`,`enum`,`custom`,`array`,`keyValue`],COLLECTION_FLAG_KINDS=[`array`,`keyValue`],KIND_SPECIFIC_FLAG_FIELDS=[[`enumValues`,[`enum`]],[`numberConstraints`,[`number`]],[`stringConstraints`,[`string`]],[`pathChecks`,[`string`]],[`elementSchema`,COLLECTION_FLAG_KINDS],[`separator`,COLLECTION_FLAG_KINDS],[`split`,COLLECTION_FLAG_KINDS],[`aggregateStandard`,COLLECTION_FLAG_KINDS],[`parseFn`,[`custom`]],[`negation`,[`boolean`]]];function assertValidFlagDefinition(e,t){assertKnownFlagKind(e);for(let[n,r]of KIND_SPECIFIC_FLAG_FIELDS)if(!r.includes(e)&&t[n]!==void 0)throw invalidFlagFieldError(e,n,r);if(e!==`array`&&t.unique===!0)throw invalidFlagFieldError(e,`unique`,[`array`]);if(e!==`keyValue`&&t.duplicateKeys!==void 0&&t.duplicateKeys!==`last`)throw invalidFlagFieldError(e,`duplicateKeys`,[`keyValue`]);if(t.duplicateKeys!==void 0&&!DUPLICATE_KEYS.includes(t.duplicateKeys))throw new CLIError(`Unknown duplicate-key policy '${String(t.duplicateKeys)}'`,{code:`INVALID_SCHEMA`,details:{duplicateKeys:t.duplicateKeys,allowed:[...DUPLICATE_KEYS]},suggest:`Use one of: ${DUPLICATE_KEYS.join(`, `)}`});if(e===`enum`&&t.enumValues===void 0)throw new CLIError(`Flag schema kind 'enum' requires field 'enumValues'`,{code:`INVALID_SCHEMA`,details:{kind:e,field:`enumValues`},suggest:`Pass the allowed values in 'enumValues'`});if((e===`array`||e===`count`||e===`keyValue`)&&t.duplicates!==void 0&&t.duplicates!==`last`)throw new CLIError(`Flag schema field 'duplicates' is not supported on kind '${e}'`,{code:`INVALID_SCHEMA`,details:{kind:e,field:`duplicates`},suggest:`Drop 'duplicates'; kind '${e}' accumulates every occurrence`});if((e===`count`||e===`keyValue`)&&t.prompt!==void 0)throw new CLIError(`Flag schema field 'prompt' is not available on kind '${e}'`,{code:`INVALID_SCHEMA`,details:{kind:e,field:`prompt`},suggest:`Drop 'prompt' from the ${e} flag`});if(t.stdin!==void 0&&assertStdinCapableKind(e),t.envIndexed!==void 0&&assertIndexedEnvFlag(e,t),t.envFromName===!0&&(t.envVar!==void 0||t.envIndexed!==void 0))throw new CLIError(`Flag schema field 'envFromName' is mutually exclusive with 'envVar' and 'envIndexed'`,{code:`INVALID_SCHEMA`,details:{kind:e,field:`envFromName`},suggest:`Declare one env source: a derived name, a variable name, or an indexed family`});if(t.envAbsolute===!0&&t.envVar===void 0&&t.envIndexed===void 0&&t.envFromName!==!0)throw new CLIError(`Flag schema field 'envAbsolute' requires an env source`,{code:`INVALID_SCHEMA`,details:{kind:e,field:`envAbsolute`},suggest:`Bind an env source, or drop 'envAbsolute'`})}function assertIndexedEnvFlag(e,t){let n=t.envIndexed;if(n===void 0)return;if(normalizeIndexedEnvBinding(n),t.envVar!==void 0)throw new CLIError(`Flag schema fields 'envVar' and 'envIndexed' are mutually exclusive`,{code:`INVALID_SCHEMA`,details:{kind:e,field:`envIndexed`},suggest:`Declare one env source: a variable name or an indexed family`});if(e===`custom`)return;if(e!==`array`)throw new CLIError(`Flag schema field 'envIndexed' requires kind 'array' or 'custom', received kind '${e}'`,{code:`INVALID_SCHEMA`,details:{kind:e,field:`envIndexed`,requiredKinds:[`array`,`custom`]},suggest:`Read an indexed family into flag.array(...) or flag.custom(...), or bind a single variable`});let r=t.elementSchema;if(n.fields!==void 0&&r!==void 0&&r.kind!==`custom`)throw new CLIError(`Indexed env records need a custom element, received element kind '${r.kind}'`,{code:`INVALID_SCHEMA`,details:{kind:e,field:`envIndexed`,elementKind:r.kind},suggest:`Use flag.array(flag.custom(recordSchema)) to decode each record`})}function assertKnownFlagKind(e){if(!FLAG_KINDS.includes(e))throw new CLIError(`Unknown flag kind '${String(e)}'`,{code:`INVALID_SCHEMA`,details:{kind:e,allowed:[...FLAG_KINDS]},suggest:`Use one of: ${FLAG_KINDS.join(`, `)}`})}function assertStdinCapableKind(e){if(!STDIN_CAPABLE_FLAG_KINDS.some(t=>t===e))throw new CLIError(`Flag schema field 'stdin' is not available on kind '${e}'`,{code:`INVALID_SCHEMA`,details:{kind:e,field:`stdin`,allowedKinds:[...STDIN_CAPABLE_FLAG_KINDS]},suggest:`Drop 'stdin' or declare the flag as one of: ${STDIN_CAPABLE_FLAG_KINDS.join(`, `)}`})}function invalidFlagFieldError(e,t,n){let r=n.map(e=>`'${e}'`).join(` or `);return new CLIError(`Flag schema field '${t}' requires kind ${r}, received kind '${e}'`,{code:`INVALID_SCHEMA`,details:{kind:e,field:t,requiredKinds:[...n]},suggest:`Drop '${t}' or declare the flag as kind ${r}`})}function buildFlagSchema(e,t){let n=assembleFlagSchema(e,t);return assertValidFlagDefault(void 0,n),n}function assembleFlagSchema(e,t){let n=t?.aliases===void 0?[]:normalizeFlagAliases(t.aliases),{aliases:r,presence:i,stdin:a,unique:o,envAbsolute:s,envFromName:c,sensitive:l,propagate:u,duplicates:d,duplicateKeys:f,...p}=t??{};return{kind:e,presence:i??`optional`,defaultValue:void 0,defaultDescription:void 0,sensitive:l===!0||p.prompt?.kind===`password`||p.prompt?.sensitive===!0,stdin:a===void 0?void 0:normalizeStdinBinding(a),envVar:void 0,configPath:void 0,description:void 0,enumValues:void 0,numberConstraints:void 0,stringConstraints:void 0,elementSchema:void 0,separator:void 0,split:void 0,duplicateKeys:f??`last`,unique:o??!1,envAbsolute:s??!1,envFromName:c??!1,pathChecks:void 0,valueHint:void 0,prompt:void 0,parseFn:void 0,standard:void 0,aggregateStandard:void 0,deprecated:void 0,propagate:u??!1,negation:void 0,duplicates:d??`last`,...p,envIndexed:p.envIndexed===void 0?void 0:normalizeIndexedEnvBinding(p.envIndexed),aliases:n}}function assertValidFlagDefault(e,t){if(t.defaultValue===void 0)return;let n=validateDefault(flagValueSchema(t),flagCardinality(t),flagAggregateStandard(t),t.defaultValue);if(n!==void 0)throw defaultViolationError(e===void 0?`${indefiniteArticle(t.kind)} ${t.kind} flag`:`flag --${e}`,{kind:t.kind,...e===void 0?{}:{flag:e}},n,t.sensitive)}function createFlagSchema(e,t){if(typeof e==`string`){let n=t??{};return assertValidFlagDefinition(e,n),buildFlagSchema(e,normalizeFlagDefinitionFields(n))}let{kind:n,...r}=e;return assertValidFlagDefinition(n,r),buildFlagSchema(n,normalizeFlagDefinitionFields(r))}var FlagBuilder=class e{schema;constructor(e){this.schema=e}complete(t){return new e({...this.schema,completion:t})}default(t,n){let r={...this.schema,presence:`defaulted`,defaultValue:t,defaultDescription:n?.description};return assertValidFlagDefault(void 0,r),new e(r)}required(){return new e({...this.schema,presence:`required`})}sensitive(t=!0){return new e({...this.schema,sensitive:t||this.schema.prompt?.kind===`password`||this.schema.prompt?.sensitive===!0})}alias(t,n){return new e({...this.schema,aliases:[...this.schema.aliases,{name:t,hidden:n?.hidden??!1}]})}env(t,n){return typeof t==`string`?new e({...this.schema,envVar:t,envIndexed:void 0,envFromName:!1,envAbsolute:n?.absolute===!0}):isIndexedEnvBinding(t)?nextFlag({...this.schema,envVar:void 0,envIndexed:normalizeIndexedEnvBinding(t),envFromName:!1,envAbsolute:n?.absolute===!0}):new e({...this.schema,envVar:void 0,envIndexed:void 0,envFromName:!0,envAbsolute:t?.absolute===!0})}stdin(t){return assertStdinCapableKind(this.schema.kind),new e({...this.schema,stdin:normalizeStdinBinding(t)})}config(t){return new e({...this.schema,configPath:t})}describe(t){return new e({...this.schema,description:t})}prompt(t){return new e({...this.schema,prompt:t,sensitive:this.schema.sensitive||t.kind===`password`||t.sensitive===!0})}deprecated(t){return new e({...this.schema,deprecated:t??!0})}propagate(){return new e({...this.schema,propagate:!0})}int(e=!0){return nextFlag({...this.schema,numberConstraints:{...this.schema.numberConstraints,int:e}})}min(e){let t={...this.schema.numberConstraints,min:e};return assertNumberConstraints(t),nextFlag({...this.schema,numberConstraints:t})}max(e){let t={...this.schema.numberConstraints,max:e};return assertNumberConstraints(t),nextFlag({...this.schema,numberConstraints:t})}finite(e=!0){return nextFlag({...this.schema,numberConstraints:{...this.schema.numberConstraints,finite:e}})}nonEmpty(e=!0){return nextFlag({...this.schema,stringConstraints:{...this.schema.stringConstraints,nonEmpty:e}})}minLength(e){let t={...this.schema.stringConstraints,minLength:e};return assertStringConstraints(t),nextFlag({...this.schema,stringConstraints:t})}maxLength(e){let t={...this.schema.stringConstraints,maxLength:e};return assertStringConstraints(t),nextFlag({...this.schema,stringConstraints:t})}pattern(e){return nextFlag({...this.schema,stringConstraints:{...this.schema.stringConstraints,pattern:e}})}separator(e){return normalizeSplitPolicy(`cli`,e),nextFlag({...this.schema,separator:e})}split(e){let t=normalizeSplitOptions(e,this.schema.split);return nextFlag({...this.schema,...t.setsSeparator?{separator:t.separator}:{},split:t.split})}duplicateKeys(e){return nextFlag({...this.schema,duplicateKeys:e})}standard(e){let t=isCollection(flagCardinality(this.schema));return nextFlag({...this.schema,...t?{aggregateStandard:e}:{standard:e}})}unique(e=!0){return nextFlag({...this.schema,unique:e})}negatable(e){return nextFlag({...this.schema,negation:{alias:e?.alias,hidden:e?.hidden??!1}})}duplicates(e){return nextFlag({...this.schema,duplicates:e})}};function nextFlag(e){return assertValidFlagDefinition(e.kind,e),assertValidFlagDefault(void 0,e),new FlagBuilder(e)}const flag={string(e){return e!==void 0&&assertStringConstraints(e),new FlagBuilder(createFlagSchema(`string`,valueDefinitionFields(stringValue(e))))},number(e){return e!==void 0&&assertNumberConstraints(e),new FlagBuilder(createFlagSchema(`number`,valueDefinitionFields(numberValue(e))))},boolean(){return new FlagBuilder(createFlagSchema(`boolean`,{presence:`defaulted`,defaultValue:!1}))},enum(e){return new FlagBuilder(createFlagSchema(`enum`,{enumValues:e}))},array(e){return assertFlagElementBuilder(`array`,e),new FlagBuilder(createFlagSchema(`array`,{elementSchema:e.schema}))},custom(e){return isStandardSchemaV1(e)?new FlagBuilder(createFlagSchema(`custom`,valueDefinitionFields(standardValue(e)))):new FlagBuilder(createFlagSchema(`custom`,valueDefinitionFields(customValue(e))))},url(e){return new FlagBuilder(createFlagSchema(`custom`,valueDefinitionFields(urlValue(e))))},path(e){return new FlagBuilder(createFlagSchema(`string`,valueDefinitionFields(pathValue(e))))},date(e){return new FlagBuilder(createFlagSchema(`custom`,valueDefinitionFields(dateValue(e))))},duration(){return new FlagBuilder(createFlagSchema(`custom`,valueDefinitionFields(durationValue())))},bytes(){return new FlagBuilder(createFlagSchema(`custom`,valueDefinitionFields(bytesValue())))},count(){return new FlagBuilder(createFlagSchema(`count`,{presence:`defaulted`,defaultValue:0}))},keyValue(e){return e!==void 0&&assertFlagElementBuilder(`keyValue`,e),new FlagBuilder(createFlagSchema(`keyValue`,{valueHint:`key=value`,...e===void 0?{}:{elementSchema:e.schema}}))}};function assertFlagElementBuilder(e,t){if(t instanceof FlagBuilder)assertEligibleFlagElementBuilder(t.schema);else throw new CLIError(`flag.${e}() requires an element builder`,{code:`INVALID_SCHEMA`,details:{factory:e,field:`element`,received:typeof t},suggest:`Pass an element builder, as in flag.${e}(flag.string())`})}const ARG_KINDS=[`string`,`number`,`boolean`,`enum`,`custom`,`keyValue`],COLLECTION_ARG_FIELDS=[`separator`,`split`],KIND_SPECIFIC_ARG_FIELDS=[[`enumValues`,`enum`],[`numberConstraints`,`number`],[`stringConstraints`,`string`],[`pathChecks`,`string`],[`parseFn`,`custom`],[`duplicateKeys`,`keyValue`],[`elementSchema`,`keyValue`]],NORMALIZED_ARG_SCHEMA_KEYS=/* @__PURE__ */ `kind.presence.variadic.stdin.defaultValue.defaultDescription.sensitive.description.envVar.envIndexed.envAbsolute.envFromName.configPath.prompt.enumValues.elementSchema.numberConstraints.stringConstraints.pathChecks.valueHint.parseFn.separator.split.duplicateKeys.unique.standard.aggregateStandard.deprecated`.split(`.`);function isNormalizedArgSchema(e){return NORMALIZED_ARG_SCHEMA_KEYS.every(t=>Object.hasOwn(e,t))}function assertValidArgElementSchema(e){if(e.kind===`keyValue`)throw new CLIError(`Arg element schema kind 'keyValue' is not supported`,{code:`INVALID_SCHEMA`,details:{kind:e.kind,field:`kind`},suggest:`Use a scalar value kind for the key-value element`});for(let[t,n]of[[`sensitive`,!1],[`defaultDescription`,void 0],[`presence`,`required`],[`variadic`,!1],[`stdin`,void 0],[`defaultValue`,void 0],[`description`,void 0],[`envVar`,void 0],[`envIndexed`,void 0],[`envAbsolute`,!1],[`envFromName`,!1],[`configPath`,void 0],[`prompt`,void 0],[`completion`,void 0],[`elementSchema`,void 0],[`separator`,void 0],[`split`,void 0],[`duplicateKeys`,`last`],[`unique`,!1],[`aggregateStandard`,void 0],[`deprecated`,void 0]])if(e[t]!==n)throw new CLIError(`Arg element schema field '${String(t)}' is not supported`,{code:`INVALID_SCHEMA`,details:{kind:e.kind,field:t},suggest:`Drop '${String(t)}' from the key-value element`})}function normalizeArgElementSchema(e){if(isNormalizedArgSchema(e))return assertValidArgDefinition(e.kind,e),assertValidArgElementSchema(e),e;let{kind:t,...n}=e;assertValidArgDefinition(t,n);let r=buildArgSchema(t,normalizeArgDefinitionFields(n));return assertValidArgElementSchema(r),r}function normalizeArgDefinitionFields(e){let{elementSchema:t,...n}=e;return t===void 0?n:{...n,elementSchema:normalizeArgElementSchema(t)}}function assertValidArgDefinition(e,t){assertKnownArgKind(e);for(let[n,r]of KIND_SPECIFIC_ARG_FIELDS)if(e!==r&&t[n]!==void 0&&(n!==`duplicateKeys`||t[n]!==`last`))throw new CLIError(`Arg schema field '${n}' requires kind '${r}', received kind '${e}'`,{code:`INVALID_SCHEMA`,details:{kind:e,field:n,requiredKind:r},suggest:`Drop '${n}' or declare the arg as kind '${r}'`});if(e===`enum`&&t.enumValues===void 0)throw new CLIError(`Arg schema kind 'enum' requires field 'enumValues'`,{code:`INVALID_SCHEMA`,details:{kind:e,field:`enumValues`},suggest:`Pass the allowed values in 'enumValues'`});if(t.duplicateKeys!==void 0&&!DUPLICATE_KEYS.includes(t.duplicateKeys))throw new CLIError(`Unknown duplicate-key policy '${String(t.duplicateKeys)}'`,{code:`INVALID_SCHEMA`,details:{duplicateKeys:t.duplicateKeys,allowed:[...DUPLICATE_KEYS]},suggest:`Use one of: ${DUPLICATE_KEYS.join(`, `)}`});let n=e===`keyValue`||t.variadic===!0;if(t.aggregateStandard!==void 0&&!n)throw new CLIError(`Arg schema field 'aggregateStandard' requires a collection, received a non-variadic '${e}' arg`,{code:`INVALID_SCHEMA`,details:{kind:e,field:`aggregateStandard`},suggest:`Add 'variadic: true', declare the arg as kind 'keyValue', or use 'standard'`});if(e===`keyValue`&&t.prompt!==void 0)throw new CLIError(`Arg schema field 'prompt' is not available on kind 'keyValue'`,{code:`INVALID_SCHEMA`,details:{kind:e,field:`prompt`},suggest:`Drop 'prompt' from the keyValue argument`});for(let r of COLLECTION_ARG_FIELDS)if(!(t[r]===void 0||n))throw new CLIError(`Arg schema field '${r}' requires a collection, received a non-variadic '${e}' arg`,{code:`INVALID_SCHEMA`,details:{kind:e,field:r},suggest:`Add 'variadic: true', declare the arg as kind 'keyValue', or drop '${r}'`});if(t.unique===!0&&(e===`keyValue`||t.variadic!==!0))throw new CLIError(`Arg schema field 'unique' requires a variadic arg of a list kind`,{code:`INVALID_SCHEMA`,details:{kind:e,field:`unique`},suggest:`Add 'variadic: true' on a list kind, or drop 'unique'`});if(t.envIndexed!==void 0&&assertIndexedEnvArg(e,t),t.envFromName===!0&&(t.envVar!==void 0||t.envIndexed!==void 0))throw new CLIError(`Arg schema field 'envFromName' is mutually exclusive with 'envVar' and 'envIndexed'`,{code:`INVALID_SCHEMA`,details:{kind:e,field:`envFromName`},suggest:`Declare one env source: a derived name, a variable name, or an indexed family`});if(t.envAbsolute===!0&&t.envVar===void 0&&t.envIndexed===void 0&&t.envFromName!==!0)throw new CLIError(`Arg schema field 'envAbsolute' requires an env source`,{code:`INVALID_SCHEMA`,details:{kind:e,field:`envAbsolute`},suggest:`Bind an env source, or drop 'envAbsolute'`})}function assertIndexedEnvArg(e,t){let n=t.envIndexed;if(n===void 0)return;if(normalizeIndexedEnvBinding(n),t.envVar!==void 0)throw new CLIError(`Arg schema fields 'envVar' and 'envIndexed' are mutually exclusive`,{code:`INVALID_SCHEMA`,details:{kind:e,field:`envIndexed`},suggest:`Declare one env source: a variable name or an indexed family`});let r=e===`custom`&&t.parseFn===void 0,i=t.variadic===!0&&e!==`keyValue`;if(!r&&!(i&&n.fields===void 0))throw i?new CLIError(`Indexed env records need a custom arg without a parse function, received kind '${e}'`,{code:`INVALID_SCHEMA`,details:{kind:e,field:`envIndexed`},suggest:`Use arg.custom(recordSchema).variadic() with a Standard Schema validator`}):new CLIError(`Arg schema field 'envIndexed' requires a variadic arg or a custom arg without a parse function, received ${t.variadic===!0?`variadic `:``}kind '${e}'`,{code:`INVALID_SCHEMA`,details:{kind:e,field:`envIndexed`},suggest:`Call .variadic() before .env(), use arg.custom(schema) with a Standard Schema validator, or bind a single variable`})}function assertKnownArgKind(e){if(!ARG_KINDS.includes(e))throw new CLIError(`Unknown arg kind '${String(e)}'`,{code:`INVALID_SCHEMA`,details:{kind:e,allowed:[...ARG_KINDS]},suggest:`Use one of: ${ARG_KINDS.join(`, `)}`})}function buildArgSchema(e,t){let n=assembleArgSchema(e,t);return assertValidArgDefault(void 0,n),n}function assembleArgSchema(e,t){let{presence:n,variadic:r,stdin:i,unique:a,sensitive:o,duplicateKeys:s,envAbsolute:c,envFromName:l,...u}=t??{};return{kind:e,presence:n??`required`,variadic:r??!1,stdin:i===void 0?void 0:normalizeStdinBinding(i),defaultValue:void 0,defaultDescription:void 0,sensitive:o===!0||u.prompt?.kind===`password`||u.prompt?.sensitive===!0,description:void 0,envVar:void 0,configPath:void 0,prompt:void 0,enumValues:void 0,elementSchema:void 0,numberConstraints:void 0,stringConstraints:void 0,pathChecks:void 0,valueHint:void 0,parseFn:void 0,separator:void 0,split:void 0,duplicateKeys:s??`last`,unique:a??!1,envAbsolute:c??!1,envFromName:l??!1,standard:void 0,aggregateStandard:void 0,deprecated:void 0,...u,envIndexed:u.envIndexed===void 0?void 0:normalizeIndexedEnvBinding(u.envIndexed)}}function assertValidArgDefault(e,t){if(t.defaultValue===void 0)return;let n=validateDefault(argValueSchema(t),argCardinality(t),argAggregateStandard(t),t.defaultValue);if(n!==void 0)throw defaultViolationError(e===void 0?`${indefiniteArticle(t.kind)} ${t.kind} argument`:`argument <${e}>`,{kind:t.kind,...e===void 0?{}:{arg:e}},n,t.sensitive)}function createArgSchema(e,t){if(typeof e==`string`)return assertValidArgDefinition(e,t??{}),buildArgSchema(e,normalizeArgDefinitionFields(t??{}));let{kind:n,...r}=e;return assertValidArgDefinition(n,r),buildArgSchema(n,normalizeArgDefinitionFields(r))}var ArgBuilder=class e{schema;constructor(e){this.schema=e}complete(t){return new e({...this.schema,completion:t})}required(){return new e({...this.schema,presence:`required`})}optional(){return new e({...this.schema,presence:`optional`})}default(t,n){let r={...this.schema,presence:`defaulted`,defaultValue:t,defaultDescription:n?.description};return assertValidArgDefault(void 0,r),new e(r)}variadic(){return nextArg({...this.schema,variadic:!0})}separator(e){return normalizeSplitPolicy(`cli`,e),nextArg({...this.schema,separator:e})}split(e){let t=normalizeSplitOptions(e,this.schema.split);return nextArg({...this.schema,...t.setsSeparator?{separator:t.separator}:{},split:t.split})}unique(e=!0){return(this.schema.kind===`keyValue`||this.schema.variadic!==!0)&&assertValidArgDefinition(this.schema.kind,{...this.schema,unique:!0}),nextArg({...this.schema,unique:e})}duplicateKeys(e){return nextArg({...this.schema,duplicateKeys:e})}standard(e){let t=isCollection(argCardinality(this.schema));return nextArg({...this.schema,...t?{aggregateStandard:e}:{standard:e}})}stdin(t){return new e({...this.schema,stdin:normalizeStdinBinding(t)})}env(t,n){return typeof t==`string`?new e({...this.schema,envVar:t,envIndexed:void 0,envFromName:!1,envAbsolute:n?.absolute===!0}):isIndexedEnvBinding(t)?nextArg({...this.schema,envVar:void 0,envIndexed:normalizeIndexedEnvBinding(t),envFromName:!1,envAbsolute:n?.absolute===!0}):new e({...this.schema,envVar:void 0,envIndexed:void 0,envFromName:!0,envAbsolute:t?.absolute===!0})}config(t){return new e({...this.schema,configPath:t})}prompt(t){return new e({...this.schema,prompt:t,sensitive:this.schema.sensitive||t.kind===`password`||t.sensitive===!0})}sensitive(t=!0){return new e({...this.schema,sensitive:t||this.schema.prompt?.kind===`password`||this.schema.prompt?.sensitive===!0})}describe(t){return new e({...this.schema,description:t})}deprecated(t){return new e({...this.schema,deprecated:t??!0})}int(e=!0){return nextArg({...this.schema,numberConstraints:{...this.schema.numberConstraints,int:e}})}min(e){let t={...this.schema.numberConstraints,min:e};return assertNumberConstraints(t),nextArg({...this.schema,numberConstraints:t})}max(e){let t={...this.schema.numberConstraints,max:e};return assertNumberConstraints(t),nextArg({...this.schema,numberConstraints:t})}finite(e=!0){return nextArg({...this.schema,numberConstraints:{...this.schema.numberConstraints,finite:e}})}nonEmpty(e=!0){return nextArg({...this.schema,stringConstraints:{...this.schema.stringConstraints,nonEmpty:e}})}minLength(e){let t={...this.schema.stringConstraints,minLength:e};return assertStringConstraints(t),nextArg({...this.schema,stringConstraints:t})}maxLength(e){let t={...this.schema.stringConstraints,maxLength:e};return assertStringConstraints(t),nextArg({...this.schema,stringConstraints:t})}pattern(e){return nextArg({...this.schema,stringConstraints:{...this.schema.stringConstraints,pattern:e}})}};function nextArg(e){return assertValidArgDefinition(e.kind,e),assertValidArgDefault(void 0,e),new ArgBuilder(e)}const arg={string(e){return e!==void 0&&assertStringConstraints(e),new ArgBuilder(createArgSchema(`string`,valueDefinitionFields(stringValue(e))))},number(e){return e!==void 0&&assertNumberConstraints(e),new ArgBuilder(createArgSchema(`number`,valueDefinitionFields(numberValue(e))))},boolean(){return new ArgBuilder(createArgSchema(`boolean`,valueDefinitionFields(booleanValue())))},keyValue(e){return e!==void 0&&assertArgElementBuilder(`keyValue`,e),new ArgBuilder(createArgSchema(`keyValue`,{valueHint:`key=value`,...e===void 0?{}:{elementSchema:e.schema}}))},enum(e){return new ArgBuilder(createArgSchema(`enum`,{enumValues:e}))},custom(e){return isStandardSchemaV1(e)?new ArgBuilder(createArgSchema(`custom`,valueDefinitionFields(standardValue(e)))):new ArgBuilder(createArgSchema(`custom`,valueDefinitionFields(stringParsedValue(e))))},url(e){return new ArgBuilder(createArgSchema(`custom`,valueDefinitionFields(urlValue(e))))},path(e){return new ArgBuilder(createArgSchema(`string`,valueDefinitionFields(pathValue(e))))},date(e){return new ArgBuilder(createArgSchema(`custom`,valueDefinitionFields(dateValue(e))))},duration(){return new ArgBuilder(createArgSchema(`custom`,valueDefinitionFields(durationValue())))},bytes(){return new ArgBuilder(createArgSchema(`custom`,valueDefinitionFields(bytesValue())))}};function assertArgElementBuilder(e,t){if(!(t instanceof ArgBuilder))throw new CLIError(`arg.${e}() requires an element builder`,{code:`INVALID_SCHEMA`,details:{factory:e,field:`element`,received:typeof t},suggest:`Pass an element builder, as in arg.${e}(arg.string())`})}const RESOLUTION_ORDER=[`cli`,`stdin`,`env`,`config`,`prompt`,`default`],PROMPT_RANK=RESOLUTION_ORDER.indexOf(`prompt`);function stageRank(e){return RESOLUTION_ORDER.indexOf(e)}function sourceBindings(e,t){let n=splitBindingOf(e.separator,e.split),r=acceptsArgv(e)?[{stage:`cli`,split:n.cli}]:[],i=e.stdin;return i!==void 0&&r.push({stage:`stdin`,when:i.when,consume:i.consume,trim:i.trim,split:n.stdin}),e.envVar===void 0?e.envIndexed!==void 0&&r.push({stage:`env`,indexed:effectiveIndexedEnvBinding(e.envIndexed,t,e.envAbsolute)}):r.push({stage:`env`,envVar:effectiveEnvName(e.envVar,t,e.envAbsolute),split:n.env}),e.configPath!==void 0&&r.push({stage:`config`,configPath:e.configPath,split:n.env}),e.prompt!==void 0&&r.push({stage:`prompt`,prompt:e.prompt,split:n.env}),e.defaultValue!==void 0&&r.push({stage:`default`,defaultValue:e.defaultValue}),r}function stdinBindingOf(e){for(let t of e)if(t.stage===`stdin`)return t}function envBindingOf(e){for(let t of e)if(t.stage===`env`)return t}function bindingsBeforePrompt(e){return e.filter(e=>stageRank(e.stage)<PROMPT_RANK)}function bindingsFromPrompt(e){return e.filter(e=>stageRank(e.stage)>=PROMPT_RANK)}function withPromptBinding(e,t,n){let r=t.filter(e=>e.stage!==`prompt`);if(n===void 0)return r;let i=r.findIndex(e=>stageRank(e.stage)>PROMPT_RANK),a=i===-1?r.length:i,o=splitBindingOf(e.separator,e.split).env;return[...r.slice(0,a),{stage:`prompt`,prompt:n,split:o},...r.slice(a)]}function stdinConsumers(e,t){let n=[];for(let[t,r]of Object.entries(e))r.stdin!==void 0&&n.push({kind:`flag`,name:t,stdin:r.stdin});for(let{name:e,schema:r}of t)r.stdin!==void 0&&n.push({kind:`arg`,name:e,stdin:r.stdin});return n}function stdinConsumerReference(e){return e.kind===`flag`?`--${e.name}`:`<${e.name}>`}function invocationSelectsStdin(e,t,n){for(let[t,r]of Object.entries(e)){let e=acceptsArgv(r)&&Object.hasOwn(n.flags,t);if(inputSelectsStdin(r.stdin,e,e?n.flags[t]:void 0))return!0}for(let{name:e,schema:r}of t){let t=acceptsArgv(r)&&Object.hasOwn(n.args,e),i=t?n.args[e]:void 0;if(inputSelectsStdin(r.stdin,t&&!argCollectedNothing(r,i),i))return!0}return!1}function argCollectedNothing(e,t){return e.variadic&&Array.isArray(t)&&t.length===0}function inputSelectsStdin(e,t,n){return e===void 0?!1:!t||n===void 0?stdinReadsWhenMissing(e):stdinReadsOnDash(e)?Array.isArray(n)?n.includes(`-`):n===`-`:!1}function resolveExampleCommand(e,t){return typeof e==`function`?e(t):e}function assertUsableFlagKey(e,t){if(t===`__proto__`)throw new CLIError(`Flag name '__proto__' is not usable as a flag`,{code:`INVALID_SCHEMA`,details:{command:e,flag:`__proto__`},suggest:`Rename the flag, for example to "proto"`})}function assertUsableFlagRecord(e,t){if(Object.getOwnPropertySymbols(t).length>0)throw new CLIError(`Command '${e}' flag names must be strings`,{code:`INVALID_SCHEMA`,details:{command:e}});let n=Object.getPrototypeOf(t);if(n!==Object.prototype&&n!==null)throw new CLIError(`Command '${e}' flag record has a replaced prototype. A '__proto__' key sets the prototype instead of adding a flag, and an inherited flag is never read`,{code:`INVALID_SCHEMA`,details:{command:e},suggest:`Pass a plain object with no '__proto__' key, or a record built with Object.create(null)`})}function withCommandFlag(e,t,n){if(assertUsableFlagKey(e.name,t),Object.hasOwn(e.flags,t))throw new CLIError(`Command '${e.name}' already defines flag --${t}`,{code:`FLAG_NAME_COLLISION`,details:{command:e.name,flag:t,surface:t,surfaceKind:`canonical`}});let r=withEnvFromName(t,n);validateFlagStdinEntry(e.name,t,r,e.flags,e.args);let i={...e.flags,[t]:r},a={...e,flags:i,hasAction:!1};return validateCommandFlagTree(a),a}function assertUsableArgKey(e,t){if(t===`__proto__`)throw new CLIError(`Argument name '${t}' is not usable as an argument`,{code:`INVALID_SCHEMA`,details:{command:e,arg:t},suggest:`Rename the argument, for example to "proto"`})}function buildCommandSchema(e){if(e.name===``||/\s/u.test(e.name))throw new CLIError(`Command schema requires a non-empty name without whitespace`,{code:`INVALID_SCHEMA`,details:{name:e.name},suggest:`Pass a dispatch name such as { name: "deploy" }`});let t=e.flags??{};assertUsableFlagRecord(e.name,t);let n={};for(let[r,i]of Object.entries(t)){assertUsableFlagKey(e.name,r);let t=withEnvFromName(r,createFlagSchema(i));validateFlagStdinEntry(e.name,r,t,n,[]),n[r]=t}let r=[];for(let t of e.args??[]){let i=withEnvFromName(t.name,createArgSchema(t.schema));validateArgEntry(e.name,t.name,i,n,r),r.push({name:t.name,schema:i})}return{name:e.name,description:e.description,details:e.details,aliases:e.aliases??[],hidden:e.hidden??!1,examples:e.examples??[],flags:n,args:r,hasAction:e.hasAction??!1,interactive:e.interactive,commands:(e.commands??[]).map(e=>buildCommandSchema(e))}}function withEnvFromName(e,t){return t.envFromName?{...t,envVar:deriveEnvName(e),envFromName:!1}:t}function createCommandSchema(e){let t=buildCommandSchema(e);return validateCommandFlagTree(t),t}function validateArgEntry(e,t,n,r,i){assertUsableArgKey(e,t),acceptsArgv(n)&&assertVariadicIsLast(e,t,i),assertStdinExclusivity(e,{kind:`arg`,name:t,stdin:n.stdin},r,i)}function assertVariadicIsLast(e,t,n){let r=n.find(e=>acceptsArgv(e.schema)&&e.schema.variadic);if(r!==void 0)throw new CLIError(`Argument <${t}> comes after variadic argument <${r.name}>, which consumes every remaining positional`,{code:`INVALID_BUILDER_STATE`,details:{command:e,arg:t,variadicArg:r.name},suggest:`Declare <${t}> before <${r.name}>, or drop .variadic() from <${r.name}>`})}function assertStdinExclusivity(e,t,n,r){let i=t.stdin;if(i!==void 0){for(let a of stdinConsumers(n,r))if((a.kind!==t.kind||a.name!==t.name)&&(i.consume!==`broadcast`||a.stdin.consume!==`broadcast`))throw new CLIError(`Only one input may consume stdin exclusively; ${stdinConsumerReference(a)} already consumes stdin`,{code:`DUPLICATE_STDIN_INPUT`,details:{command:e,...t.kind===`flag`?{flag:t.name}:{arg:t.name},...a.kind===`flag`?{existingFlag:a.name}:{existingArg:a.name}},suggest:`Keep .stdin() on a single input per command, or declare every stdin input with { consume: 'broadcast' }`})}}function validateFlagStdinEntry(e,t,n,r,i){assertStdinExclusivity(e,{kind:`flag`,name:t,stdin:n.stdin},r,i)}function formatFlagToken(e,t){return t===`alias`&&e.length===1?`-${e}`:`--${e}`}function describeFlagForm(e){if(e.kind===`canonical`)return`canonical flag ${formatFlagToken(e.name,e.kind)}`;if(e.kind===`negation`)return`${e.hidden?`hidden `:``}negated spelling ${formatFlagToken(e.name,e.kind)}`;let t=e.name.length===1?`short alias`:`long alias`;return`${e.hidden?`hidden `:``}${t} ${formatFlagToken(e.name,e.kind)}`}function listFlagForms(e,t){if(!acceptsArgv(t))return[];let n=getFlagNegatedName(e,t);return[{owner:e,name:e,kind:`canonical`,hidden:!1},...t.aliases.map(t=>({owner:e,name:t.name,kind:`alias`,hidden:t.hidden})),...n!==void 0&&t.negation!==void 0?[{owner:e,name:n,kind:`negation`,hidden:t.negation.hidden}]:[]]}function throwFlagCollisionError(e,t,n,r){let i=r?.inherited??!1,a=`flag ${formatFlagToken(n.owner,`canonical`)}`,o=`Command '${e}' ${a}`;throw new CLIError(i?`${o} propagates ${describeFlagForm(n)}, which collides with ${describeFlagForm(t)} on flag ${formatFlagToken(t.owner,`canonical`)}`:`Command '${e}' flag ${formatFlagToken(t.owner,`canonical`)} ${describeFlagForm(t)} collides with ${describeFlagForm(n)} on ${a}`,{code:i?`PROPAGATED_FLAG_COLLISION`:`FLAG_NAME_COLLISION`,details:{command:e,flag:t.owner,surface:t.name,surfaceKind:t.kind,hidden:t.hidden,existingFlag:n.owner,existingSurface:n.name,existingSurfaceKind:n.kind,existingHidden:n.hidden,inherited:i}})}function validateLocalFlagCollisions(e,t){let n=/* @__PURE__ */ new Map;for(let[r,i]of Object.entries(t))for(let t of listFlagForms(r,i)){let r=n.get(t.name);r!==void 0&&throwFlagCollisionError(e,t,r),n.set(t.name,t)}}function validateInheritedFlagCollisions(e,t,n){let r=/* @__PURE__ */ new Map;for(let[e,n]of Object.entries(t))for(let t of listFlagForms(e,n))r.set(t.name,t);for(let[t,i]of Object.entries(n))for(let n of listFlagForms(t,i)){let t=r.get(n.name);t!==void 0&&throwFlagCollisionError(e,n,t,{inherited:!0})}}function buildInheritedFlagsForChildren(e,t){let n={...e};for(let e of Object.keys(t))delete n[e];for(let[e,r]of Object.entries(t))r.propagate&&(n[e]=r);return n}function validateCommandFlagTree(e,t={}){validateLocalFlagCollisions(e.name,e.flags);let n={...t};for(let t of Object.keys(e.flags))delete n[t];validateInheritedFlagCollisions(e.name,n,e.flags);let r={...n,...e.flags};for(let[t,n]of Object.entries(r))validateFlagStdinEntry(e.name,t,n,r,e.args);let i=buildInheritedFlagsForChildren(t,e.flags);for(let t of e.commands)validateCommandFlagTree(t,i)}function eraseBuilder(e){return e}var CommandBuilder=class e{schema;handler;_subcommands;_executionSteps;constructor(e,t,n,r){this.schema=e,this.handler=t,this._subcommands=n??[],this._executionSteps=r??[]}interactive(t){let n=t;return new e({...this.schema,interactive:n},this.handler,this._subcommands,this._executionSteps)}derive(t){let n=t;return new e({...this.schema,hasAction:!1},void 0,this._subcommands,[...this._executionSteps,{kind:`derive`,handler:n}])}middleware(t){return new e({...this.schema,hasAction:!1},void 0,this._subcommands,[...this._executionSteps,{kind:`middleware`,handler:t._handler}])}description(t){return new e({...this.schema,description:t},this.handler,this._subcommands,this._executionSteps)}details(t){return new e({...this.schema,details:t},this.handler,this._subcommands,this._executionSteps)}alias(t){return new e({...this.schema,aliases:[...this.schema.aliases,t]},this.handler,this._subcommands,this._executionSteps)}hidden(){return new e({...this.schema,hidden:!0},this.handler,this._subcommands,this._executionSteps)}example(t,n){let r=n===void 0?{command:t}:{command:t,description:n};return new e({...this.schema,examples:[...this.schema.examples,r]},this.handler,this._subcommands,this._executionSteps)}flag(t,n){let r=withCommandFlag(this.schema,t,n.schema);return new e(r,void 0,this._subcommands,this._executionSteps)}flags(t){assertUsableFlagRecord(this.schema.name,t);let n=this.schema,r=t;for(let[e,t]of Object.entries(r))n=withCommandFlag(n,e,t.schema);return new e({...n,hasAction:!1},void 0,this._subcommands,this._executionSteps)}arg(t,n){let r=withEnvFromName(t,n.schema);validateArgEntry(this.schema.name,t,r,this.schema.flags,this.schema.args);let i={name:t,schema:r},a=[...this.schema.args,i];return new e({...this.schema,args:a,hasAction:!1},void 0,this._subcommands,this._executionSteps)}command(t){let n={...this.schema,commands:[...this.schema.commands,t.schema]};return validateCommandFlagTree(n),new e(n,this.handler,[...this._subcommands,eraseBuilder(t)],this._executionSteps)}action(t){return new e({...this.schema,hasAction:!0},t,this._subcommands,this._executionSteps)}};function command(e){return new CommandBuilder(createCommandSchema({name:e}))}function group(e){return command(e)}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});else if(r===`--`)t.push({kind:`separator`}),n=!0;else 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)})}else r.startsWith(`-`)&&r.length>1?t.push({kind:`short-flags`,chars:r.slice(1)}):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)]}const sensitiveFlagDiagnostics=/* @__PURE__ */ new WeakMap,deferredFlagDiagnostics=/* @__PURE__ */ new WeakMap,deferredCustomFlags=/* @__PURE__ */ new WeakMap;function pendingFlagReads(e){return deferredCustomFlags.get(e)}function pendingFlagErrors(e){return deferredFlagDiagnostics.get(e)}function redactFlagParseError(e){return sensitiveFlagDiagnostics.get(e)?.()??e}function flagDiagnostic(e,t){let n=e(t);return sensitiveFlagDiagnostics.set(n,()=>e(!0)),n}function retainFlagError(e,t,n){let r=deferredFlagDiagnostics.get(e);if(!(n instanceof ParseError)||!sensitiveFlagDiagnostics.has(n)||r===void 0)throw n;r.has(t)||r.set(t,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 negationCounterpart(e){if(!e.negated||e.schema.negation?.alias!==void 0)return;let t=counterpartSpelling(e.name);return t===void 0?void 0:`no-${t}`}function buildFlagLookup(e,t){let n=/* @__PURE__ */ new Map;for(let[t,r]of Object.entries(e)){if(!acceptsArgv(r))continue;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})}for(let[,t]of e){let e=negationCounterpart(t);e!==void 0&&!n.has(e)&&n.set(e,{...t,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=deferredCustomFlags.get(e);if(o!==void 0&&deferredFlagDiagnostics.get(e)?.size&&flagValueSchema(n).codec.name===`custom`){let s=o.get(t);o.set(t,(o=!0)=>{if(s?.(!1),recordFlagValue(e,t,n,r,i,a),o){let r=occurrencesOf(e,t,n);return projectOccurrences(flagCardinality(n),r.occurrences.flatMap(e=>e.items))}})}else try{recordFlagValue(e,t,n,r,i,a)}catch(n){retainFlagError(e,t,n)}}function recordFlagValue(e,t,n,r,i,a){let o=occurrencesOf(e,t,n);if(o.counted+=1,o.counted>1&&n.duplicates===`error`){let e=o.counted,a=[...o.occurrences.filter(e=>e.policed).map(e=>e.reported),r];throw flagDiagnostic(n=>{let r=diagnosticValue(n,a);return new ParseError(`Flag --${t} may only be specified once`,{code:`DUPLICATE_FLAG`,details:{flag:t,input:i,count:e,...r.kind===`visible`?{values:r.value}:{}}})},n.sensitive)}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)throw flagDiagnostic(r=>{let i=diagnosticValue(r,t);return 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`}})},r);return i}function coerceEntryToken(e,t,n,r){let i=splitEntryPair(t);if(i===void 0)throw flagDiagnostic(n=>{let i=diagnosticValue(n,t);return 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`}})},n.sensitive);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 flagDiagnostic(i=>valueParseError({details:{flag:e,input:t},label:`flag ${t}`,enumDetails:{flag:e,kind:`enum`,missing:`enumValues`},enumLabel:`Enum flag --${e}`,sensitive:i},n,r),i)}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){return parseCommand(e,t,n,/* @__PURE__ */ new Map)}function parseForResolution(e,t,n){let r=/* @__PURE__ */ new Map;return deferredFlagDiagnostics.set(r,/* @__PURE__ */ new Map),deferredCustomFlags.set(r,/* @__PURE__ */ new Map),parseCommand(e,t,n,r)}function parseCommand(e,t,n,r){let i=tokenize(t),a=buildFlagLookup(e.flags,n),o=[],s=0;for(;s<i.length;){let e=i[s];if(e===void 0)break;if(e.kind===`separator`)s++;else if(e.kind===`positional`)o.push(e.value),s++;else try{s=e.kind===`long-flag`?parseLongFlag(e,i,s,a,r):parseShortFlags(e,i,s,a,r)}catch(e){if(!(e instanceof ParseError)||!deferredFlagDiagnostics.get(r)?.size)throw e;s++}}let c=deferredFlagDiagnostics.get(r),l=c?.size?{}:mapPositionals(e.args.filter(e=>acceptsArgv(e.schema)),o),u=projectFlags(r);c!==void 0&&deferredFlagDiagnostics.set(u,c);let d=deferredCustomFlags.get(r);return d?.size&&deferredCustomFlags.set(u,d),{flags:u,args:l}}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)return e.value===void 0?(recordFlagOccurrence(i,o,s,!1,l,()=>[NEGATED_OCCURRENCE]),n+1):(retainFlagError(i,o,flagDiagnostic(t=>{let n=diagnosticValue(t,e.value);return new ParseError(`Flag ${l} does not take a value`,{code:`INVALID_VALUE`,details:{flag:o,input:e.name,...n.kind===`visible`?{value:n.value}:{}}})},s.sensitive)),n+1);if(!flagExpectsValue(s)){if(e.value!==void 0)try{let t=flagTokenOccurrence(o,e.value,s,l);recordFlagOccurrence(i,o,s,occurrenceValue(t),l,()=>[t])}catch(e){retainFlagError(i,o,e)}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 stripAnsi(e){return strip(e)}function visibleWidth(e){return stripAnsi(e).length}const emitLink=createColors(!1,!0).link;function osc8(e,t){return emitLink(e,t)}function padEnd(e,t){let n=visibleWidth(e);return n>=t?e:e+` `.repeat(t-n)}function wrapText(e,t,n){if(visibleWidth(e)+n<=t)return e;let r=t-n;if(r<=0)return e;let i=e.split(` `),a=[],o=``,s=0;for(let e of i){let t=visibleWidth(e);o.length===0?(o=e,s=t):s+1+t<=r?(o+=` ${e}`,s+=1+t):(a.push(o),o=e,s=t)}o.length>0&&a.push(o);let c=` `.repeat(n);return a.map((e,t)=>t===0?e:`${c}${e}`).join(`
4
+ `)}function defaultHelpTheme(e){return{sectionTitle:t=>e.bold(e.underline(t)),usageBin:e.bold,flag:e.cyan,placeholder:e.dim,command:e.cyan,arg:e.cyan,defaultValue:e.dim,annotation:e.dim,deprecated:e.yellow,headerName:e.bold,headerVersion:e.dim,examplePrompt:e.dim}}function resolveHelpTheme(e,t){let n=e??createColors(!1);return n.bold(`x`)===`x`||t===void 0?defaultHelpTheme(n):{...defaultHelpTheme(n),...t(n)}}function extendHelpTheme(e,t,n){let r=t??createColors(!1);return r.bold(`x`)!==`x`&&n!==void 0?{...e,...n(r)}:e}function resolveHelpDescription(e,t){return typeof e==`function`?e(t):e}function resolvePlainHelpDescription(e){return resolveHelpDescription(e,defaultHelpTheme(createColors(!1)))}function resolveOptions$1(e){let t=resolveHelpTheme(e?.colors,e?.theme);return{width:e?.width??80,binName:e?.binName,version:e?.version,flagOrder:e?.flagOrder??`alphabetical`,sortFlags:e?.sortFlags,flagSpelling:e?.flagSpelling??`declared`,caseParity:e?.caseParity??!0,isDefaultHelp:e?.isDefaultHelp??!1,envPrefix:e?.envPrefix,theme:t,descriptionTheme:extendHelpTheme(t,e?.colors,e?.descriptionTheme)}}function formatDeprecated(e){return typeof e==`string`?`[deprecated: ${e}]`:`[deprecated]`}function formatHelpDefaultValue(e){return e===void 0?`undefined`:e===null?`null`:formatDisplayValue(e)}function formatDefaultAnnotation(e,t,n){if(e.defaultDescription!==!1){if(typeof e.defaultDescription==`string`)return t.defaultValue(`(default: ${e.defaultDescription})`);if(!(e.sensitive||n)&&(e.presence===`defaulted`||e.defaultValue!==void 0))return t.defaultValue(`(default: ${formatHelpDefaultValue(e.defaultValue)})`)}}function spellingCheck(e,t){if(t.flagSpelling===`declared`)return;let n=buildFlagLookup(e,{caseParity:t.caseParity});return(e,t,r)=>{let i=n.get(e);return i?.name===t&&i.negated===r}}function kebabSpelling(e){if(e.includes(`-`))return;let t=camelToKebab(e);return t.includes(`-`)?t:void 0}function formatFlagLeft(e,t,n,r){let i=getFlagAliasNames(t,{kind:`short`}),a=getFlagAliasNames(t,{kind:`long`}),o=(t,n)=>{let i=r===void 0?void 0:kebabSpelling(t);return i!==void 0&&r?.(i,e,n)===!0?i:t},s=t.negation!==void 0&&!t.negation.hidden?t.negation:void 0,c=s!==void 0&&s.alias===void 0,l=o(e,!1),u=c&&l!==e&&r?.(`no-${l}`,e,!0)!==!0?e:l,d=[...i.map(e=>`-${e}`),c?`--[no-]${u}`:`--${u}`,...a.map(e=>`--${o(e,!1)}`),...s?.alias===void 0?[]:[`--${o(s.alias,!0)}`]];return t.kind!==`boolean`&&t.kind!==`count`?`${n.flag(d.join(`, `))} ${n.placeholder(formatValueHint(t))}`:n.flag(d.join(`, `))}function formatValueHint(e){if(e.valueHint!==void 0)return`<${e.valueHint}>`;switch(e.kind){case`string`:return`<string>`;case`number`:return`<number>`;case`enum`:return`<${(e.enumValues??[]).join(`|`)}>`;case`array`:return`<${e.elementSchema===void 0?`value`:formatValueHint(e.elementSchema).slice(1,-1)}>...`;case`boolean`:case`count`:return``;case`custom`:return`<value>`;case`keyValue`:return`<key=value>`}}function formatStdinAnnotation(e){switch(e.when){case`dash`:return`[stdin: '-']`;case`missing`:return`[stdin: when omitted]`;case`dash-or-missing`:return`[stdin]`}}function formatEnvAnnotation(e,t){if(e.envVar!==void 0)return`[env: ${effectiveEnvName(e.envVar,t,e.envAbsolute)}]`;if(e.envIndexed!==void 0)return`[env: ${formatIndexedEnvBinding(effectiveIndexedEnvBinding(e.envIndexed,t,e.envAbsolute))}]`}function formatFlagDescription(e,t,n,r){let i=[];e.description!==void 0&&i.push(resolveHelpDescription(e.description,n)),e.deprecated!==void 0&&i.push(t.deprecated(formatDeprecated(e.deprecated))),e.stdin!==void 0&&i.push(t.annotation(formatStdinAnnotation(e.stdin)));let a=formatEnvAnnotation(e,r);if(a!==void 0&&i.push(t.annotation(a)),e.configPath!==void 0&&i.push(t.annotation(`[config: ${e.configPath}]`)),e.prompt!==void 0&&i.push(t.annotation(`[prompt]`)),e.presence===`required`&&e.defaultValue===void 0)i.push(t.annotation(`[required]`));else{let n=formatDefaultAnnotation(e,t,e.kind===`boolean`||e.kind===`count`);n!==void 0&&i.push(n)}return i.join(` `)}function defaultFlagOrder(e,t,n){let r=n[e],i=n[t];if(r===void 0||i===void 0)return 0;let a=getFlagAliasNames(r,{kind:`short`}).length>0,o=getFlagAliasNames(i,{kind:`short`}).length>0;return a&&!o?-1:!a&&o?1:e.localeCompare(t)}function orderFlagNames(e,t,n){return n.sortFlags===void 0?n.flagOrder===`declaration`?e:[...e].sort((e,n)=>defaultFlagOrder(e,n,t)):[...e].sort(n.sortFlags)}function buildFlagEntries(e,t){let n=Object.keys(e);if(n.length===0)return[];let r=spellingCheck(e,t),i=[];for(let a of orderFlagNames(n,e,t)){let n=e[a];n!==void 0&&acceptsArgv(n)&&i.push({left:formatFlagLeft(a,n,t.theme,r),description:formatFlagDescription(n,t.theme,t.descriptionTheme,t.envPrefix)})}return i}function formatArgUsage(e,t=1/0){let{name:n,schema:r}=e,i=r.kind===`enum`&&r.enumValues!==void 0?r.enumValues.join(`|`):n,a=r.variadic?`...`:``;return visibleWidth(i)+2+a.length>t&&(i=n),r.presence===`required`&&r.defaultValue===void 0?`<${i}>${a}`:`[${i}]${a}`}function formatArgDescription(e,t,n,r){let i=[];e.description!==void 0&&i.push(resolveHelpDescription(e.description,n)),e.deprecated!==void 0&&i.push(t.deprecated(formatDeprecated(e.deprecated))),e.stdin!==void 0&&i.push(t.annotation(formatStdinAnnotation(e.stdin)));let a=formatEnvAnnotation(e,r);a!==void 0&&i.push(t.annotation(a)),e.configPath!==void 0&&i.push(t.annotation(`[config: ${e.configPath}]`)),e.prompt!==void 0&&i.push(t.annotation(`[prompt]`));let o=formatDefaultAnnotation(e,t,!1);return o!==void 0&&i.push(o),i.join(` `)}function formatHelpSections(e,t){let n=resolveOptions$1(t),r=[];if(r.push(formatUsageLine(e,n)),e.description!==void 0&&r.push(e.description),e.details!==void 0){let t=resolveHelpDescription(e.details,n.descriptionTheme);r.push(t.split(/\r?\n/).map(e=>wrapText(e,n.width,0)).join(`
5
+ `))}let i=e.commands.filter(e=>!e.hidden);i.length>0&&r.push(formatCommandsSection(i,n));let a=e.args.filter(e=>acceptsArgv(e.schema));if(a.length>0&&r.push(formatArgsSection(a,n)),Object.values(e.flags).some(acceptsArgv)&&r.push(formatFlagsSection(e.flags,n)),e.examples.length>0){let t={name:n.binName??e.name,version:n.version};r.push(formatExamplesSection(e.examples,n.theme,t))}return r}function formatHelp(e,t){return`${formatHelpSections(e,t).join(`
6
+
7
+ `)}\n`}function formatUsageLine(e,t){let{theme:n}=t,r=[n.sectionTitle(`Usage:`)],i=t.binName===void 0?e.name:t.isDefaultHelp?t.binName:`${t.binName} ${e.name}`;r.push(n.usageBin(i)),e.commands.length>0&&r.push(n.placeholder(`<command>`)),Object.values(e.flags).some(acceptsArgv)&&r.push(n.placeholder(`[flags]`));for(let i of e.args)acceptsArgv(i.schema)&&r.push(n.arg(formatArgUsage(i,t.width-7)));return`${r[0]} ${wrapText(r.slice(1).join(` `),t.width,7)}`}function formatArgsSection(e,t){let{theme:n}=t,r=[n.sectionTitle(`Arguments:`)],i=0,a=[];for(let r of e){let e=formatArgUsage(r,Math.floor(t.width/2)-4),o=` ${n.arg(e)}`,s=formatArgDescription(r.schema,n,t.descriptionTheme,t.envPrefix);a.push({left:o,desc:s,...e!==formatArgUsage(r)&&r.schema.enumValues!==void 0?{choices:r.schema.enumValues}:{}});let c=visibleWidth(o);c>i&&(i=c)}let o=i+2;for(let{left:e,desc:i,choices:s}of a){if(i.length===0)r.push(e);else if(o>=t.width/2||i.split(` `).some(e=>visibleWidth(e)>t.width-o))r.push(e,` ${wrapText(i,t.width,4)}`);else{let n=padEnd(e,o),a=wrapText(i,t.width,o);r.push(`${n}${a}`)}s!==void 0&&r.push(` ${wrapText(`Choices: ${s.map(e=>n.arg(e)).join(`, `)}`,t.width,4)}`)}return r.join(`
8
+ `)}function formatFlagsSection(e,t){return formatFlagEntriesBlock(t.theme.sectionTitle(`Flags:`),buildFlagEntries(e,t),t.width)}function formatFlagEntriesBlock(e,t,n){if(t.length===0)return``;let r=[e],i=0;for(let e of t){let t=visibleWidth(e.left)+2;t>i&&(i=t)}let a=i+2;for(let e of t){let t=` ${e.left}`;if(e.description.length===0)r.push(t);else{let i=padEnd(t,a),o=wrapText(e.description,n,a);r.push(`${i}${o}`)}}return r.join(`
9
+ `)}function formatCommandsSection(e,t){let{theme:n}=t,r=[n.sectionTitle(`Commands:`)],i=0;for(let t of e)t.name.length>i&&(i=t.name.length);let a=2+i+2;for(let i of e){let e=` ${n.command(i.name)}`,o=i.description??``;if(o.length===0)r.push(e);else{let n=padEnd(e,a),i=wrapText(o,t.width,a);r.push(`${n}${i}`)}}return r.join(`
10
+ `)}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(`
11
+ `)}function bindMethods(e){let t=e,n=/* @__PURE__ */ 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;onStop;stopped=!1;constructor(e,t,n){this.write=t,this.onStop=n,writeLine(t,e),bindMethods(this)}update(e){}succeed(e){this.stopped||(this.stopped=!0,this.onStop?.(),e!==void 0&&writeLine(this.write,e))}fail(e){this.stopped||(this.stopped=!0,this.onStop?.(),e!==void 0&&writeLine(this.write,e))}stop(){this.stopped||(this.stopped=!0,this.onStop?.())}async wrap(e,t){try{let n=await e;return this.succeed(typeof t?.succeed==`function`?t.succeed(n):t?.succeed),n}catch(e){let n;try{n=typeof t?.fail==`function`?t.fail(e):t?.fail}finally{this.fail(n)}throw e}}},StaticProgressHandle=class{write;onStop;stopped=!1;constructor(e,t,n){this.write=t,this.onStop=n,e!==void 0&&writeLine(t,e),bindMethods(this)}increment(e){}update(e){}done(e){this.stopped||(this.stopped=!0,this.onStop?.(),e!==void 0&&writeLine(this.write,e))}fail(e){this.stopped||(this.stopped=!0,this.onStop?.(),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;onStop;line;stopped=!1;timer;frameIndex=0;text;constructor(e,t,n,r){this.write=t,this.onStop=n,this.line=r,this.text=e,r===void 0&&t(HIDE_CURSOR),this.render(),r?.animated!==!1&&(this.timer=setInterval(()=>{this.frameIndex=(this.frameIndex+1)%SPINNER_FRAMES.length,this.render(),this.line?.animated===!1&&this.cleanup()},80)),bindMethods(this)}render(){let e=`${SPINNER_FRAMES[this.frameIndex]??SPINNER_FRAMES[0]} ${this.text}`;this.line===void 0?this.write(`\r${ERASE_LINE}${e}`):this.line.update(e)}cleanup(){this.timer!==void 0&&(clearInterval(this.timer),this.timer=void 0),this.line===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.onStop?.(),this.cleanup(),this.line===void 0?e!==void 0&&writeLine(this.write,`✓ ${e}`):this.line.finish(e===void 0?void 0:`✓ ${e}`))}fail(e){this.stopped||(this.stopped=!0,this.onStop?.(),this.cleanup(),this.line===void 0?e!==void 0&&writeLine(this.write,`✗ ${e}`):this.line.finish(e===void 0?void 0:`✗ ${e}`))}stop(){this.stopped||(this.stopped=!0,this.onStop?.(),this.cleanup(),this.line?.finish())}async wrap(e,t){try{let n=await e;return this.succeed(typeof t?.succeed==`function`?t.succeed(n):t?.succeed),n}catch(e){let n;try{n=typeof t?.fail==`function`?t.fail(e):t?.fail}finally{this.fail(n)}throw e}}},TTYProgressHandle=class{write;onStop;line;stopped=!1;timer;current=0;total;label;pulsePos=0;pulseDir=1;constructor(e,t,n,r){this.write=t,this.onStop=n,this.line=r,this.total=e.total,this.label=e.label??``,r===void 0&&t(HIDE_CURSOR),this.render(),this.total===void 0&&r?.animated!==!1&&(this.timer=setInterval(()=>{this.advancePulse(),this.render(),this.line?.animated===!1&&this.cleanup()},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)}${this.label.length>0?` ${this.label}`:``}`;this.line===void 0?this.write(`\r${ERASE_LINE}${e}`):this.line.update(e)}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.line===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.onStop?.(),this.cleanup(),this.line===void 0?e!==void 0&&writeLine(this.write,`✓ ${e}`):this.line.finish(e===void 0?void 0:`✓ ${e}`))}fail(e){this.stopped||(this.stopped=!0,this.onStop?.(),this.cleanup(),this.line===void 0?e!==void 0&&writeLine(this.write,`✗ ${e}`):this.line.finish(e===void 0?void 0:`✗ ${e}`))}},CaptureSpinnerHandle=class{events;onStop;stopped=!1;constructor(e,t,n){this.events=t,this.onStop=n,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.onStop?.(),this.events.push({type:`spinner:succeed`,text:e??``}))}fail(e){this.stopped||(this.stopped=!0,this.onStop?.(),this.events.push({type:`spinner:fail`,text:e??``}))}stop(){this.stopped||(this.stopped=!0,this.onStop?.(),this.events.push({type:`spinner:stop`}))}async wrap(e,t){try{let n=await e;return this.succeed(typeof t?.succeed==`function`?t.succeed(n):t?.succeed),n}catch(e){let n;try{n=typeof t?.fail==`function`?t.fail(e):t?.fail}finally{this.fail(n)}throw e}}},CaptureProgressHandle=class{events;onStop;stopped=!1;constructor(e,t,n){this.events=t,this.onStop=n,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.onStop?.(),this.events.push({type:`progress:done`,text:e}))}fail(e){this.stopped||(this.stopped=!0,this.onStop?.(),this.events.push({type:`progress:fail`,text:e}))}},ActivityBlock=class{write;getTerminalSize;lines=/* @__PURE__ */ new Set;renderedLines=0;cursorHidden=!1;staticFallback=!1;frame;constructor(e,t){this.write=e,this.getTerminalSize=t}line(e){let t={text:void 0,label:e};this.lines.add(t);let n=this;return{get animated(){return!n.staticFallback},update:e=>{if(!this.lines.has(t))return;let n=t.text===void 0;t.text=e.replace(/[\r\n]+/g,` `),this.render(void 0,n?t:void 0)},finish:e=>{this.lines.delete(t)&&(this.render(e?.replace(/[\r\n]+/g,` `)),this.lines.size===0&&(this.staticFallback=!1))}}}writeMessage(e,t){this.clear(this.readSize()),e(t),this.render()}readSize(){if(!this.staticFallback)try{let e=this.getTerminalSize?.();if(e!==void 0&&Number.isInteger(e.rows)&&e.rows>1&&Number.isInteger(e.columns)&&e.columns>0)return e}catch{}}showCursor(){this.cursorHidden&&=(this.write(`\x1B[?25h`),!1)}clear(e){if(this.frame=void 0,this.renderedLines!==0){if(e===void 0)this.write(`\r
12
+ `),this.staticFallback=!0;else{let t=Math.min(this.renderedLines,e.rows-1);this.write(`\x1b[${t}A\r\x1b[J`)}this.renderedLines=0}}render(e,t){let n=this.readSize();if(n===void 0){this.clear(n),this.showCursor(),this.lines.size>0&&(this.staticFallback=!0);let r=e??t?.label;r!==void 0&&this.write(`${r}\n`);return}let r=[...this.lines].flatMap(e=>e.text===void 0?[]:[e.text]),i=n.rows-1,a=r.length<=i?r:[...r.slice(0,i-1),`${r.length-i+1} more activities`],o=a.map(e=>`\r${e}\n`).join(``);e===void 0&&this.cursorHidden&&this.renderedLines===a.length&&this.frame?.text===o&&this.frame.columns===n.columns&&this.frame.rows===n.rows||(this.clear(n),e!==void 0&&this.write(`${e}\n`),a.length===0?this.showCursor():(this.cursorHidden||=(this.write(`\x1B[?25l`),!0),this.write(`\x1b[?7l${o}\r\x1b[?7h`),this.renderedLines=a.length,this.frame={text:o,columns:n.columns,rows:n.rows}))}};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 colorJson(e,t){let n=[],r=0,i=0;for(;i<e.length;){let a=i,o=e.charAt(i),s;if(o===`"`){for(i++;i<e.length&&e[i]!==`"`;)i+=e[i]===`\\`?2:1;if(i>=e.length)break;i++;let n=i;for(;e.charCodeAt(n)<=32;)n++;s=e[n]===`:`?t.cyan:t.green}else if(o===`-`||o>=`0`&&o<=`9`){for(i++;i<e.length&&`0123456789.eE+-`.includes(e.charAt(i));)i++;s=t.yellow}else if(o===`t`||o===`f`||o===`n`)i+=o===`f`?5:4,s=t.magenta;else{i++;continue}n.push(e.slice(r,a),s(e.slice(a,i))),r=i}return n.push(e.slice(r)),n.join(``)}function resolveWriterForStream(e,t){return t===`stderr`?e.stderr:e.stdout}function createSpinnerHandleFromPolicy(e,t,n,r,i){if(e.mode===`noop`)return{handle:noopSpinnerHandle,cleanup:void 0};if(e.mode===`tty`){let e=new TTYSpinnerHandle(t,n,r,i);return{handle:e,cleanup:()=>e.stop()}}let a=new StaticSpinnerHandle(t,n,r);return{handle:a,cleanup:()=>a.stop()}}function createProgressHandleFromPolicy(e,t,n,r,i){if(e.mode===`noop`)return{handle:noopProgressHandle,cleanup:void 0};if(e.mode===`tty`){let e=new TTYProgressHandle(t,n,r,i);return{handle:e,cleanup:()=>e.done()}}let a=new StaticProgressHandle(t.label,n,r);return{handle:a,cleanup:()=>a.done()}}const noopWrite$1=()=>{},requestedExitCodes=/* @__PURE__ */ 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{...e?.getTerminalSize===void 0?{}:{getTerminalSize:e.getTerminalSize},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;activityWrite;constructor(e){this.activityWrite=e.stderr,this.options={...e,stdout:t=>this.writeMessage(e.stdout,t),stderr:t=>this.writeMessage(e.stderr,t)},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){let t=this.isTTY&&!this.jsonMode,n=JSON.stringify(e,null,t?2:void 0);writeLine(this.options.stdout,t&&n!==void 0?colorJson(n,this.color):n)}table(e,t,n){let{columns:r,options:i}=resolveTableArgs(t,n),a=resolveTableFormat(this.policy,i),o=r??inferColumns(e);if(a===`json`){writeLine(this.options.stdout,JSON.stringify(projectTableRows(e,o)));return}let s=formatTable(e,o);s.length!==0&&writeLine(resolveTextTableWriter(this.options,this.policy,a,i),s)}activeCleanups=/* @__PURE__ */ new Map;concurrent=!1;activityBlock;writeMessage(e,t){this.activityBlock===void 0?e(t):this.activityBlock.writeMessage(e,t)}stopActive(){for(let e of[...this.activeCleanups.values()])e();this.activeCleanups.clear()}startActivity(e,t){this.activeCleanups.size>0&&(!e||!this.concurrent)&&this.stopActive(),this.concurrent=e;let n={},r=t(()=>this.activeCleanups.delete(n));return r.cleanup!==void 0&&this.activeCleanups.set(n,r.cleanup),r.handle}concurrentLine(e){return this.activityBlock??=new ActivityBlock(this.activityWrite,this.options.getTerminalSize),this.activityBlock.line(e)}spinner(e,t){let n=resolveSpinnerPolicy(this.policy,t?.fallback??`silent`);return n.mode===`noop`?createSpinnerHandleFromPolicy(n,e,this.activityWrite).handle:this.startActivity(t?.concurrent??!1,r=>createSpinnerHandleFromPolicy(n,e,this.activityWrite,r,t?.concurrent&&n.mode===`tty`?this.concurrentLine(e):void 0))}progress(e){let t=resolveProgressPolicy(this.policy,e.fallback??`silent`);return t.mode===`noop`?createProgressHandleFromPolicy(t,e,this.activityWrite).handle:this.startActivity(e.concurrent??!1,n=>createProgressHandleFromPolicy(t,e,this.activityWrite,n,e.concurrent&&t.mode===`tty`?this.concurrentLine(e.label):void 0))}},CaptureOutputChannel=class extends OutputChannel{activity;constructor(e,t){super(e),this.activity=t}spinner(e,t){return this.startActivity(t?.concurrent??!1,t=>{let n=new CaptureSpinnerHandle(e,this.activity,t);return{handle:n,cleanup:n.stop}})}progress(e){return this.startActivity(e.concurrent??!1,t=>{let n=new CaptureProgressHandle(e,this.activity,t);return{handle:n,cleanup:n.done}})}};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=visibleWidth(e);for(let e of r){let r=e[t];r!==void 0&&(n=Math.max(n,visibleWidth(r)))}return n});return[n.map((e,t)=>padEnd(e,i[t]??0)).join(` `),i.map(e=>`-`.repeat(e)).join(` `),...r.map(e=>e.map((e,t)=>padEnd(e,i[t]??0)).join(` `))].join(`
13
+ `)}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]}var PromptCancelledError=class extends CLIError{name=`PromptCancelledError`;reason;constructor(e=`cancel`){super(`Prompt cancelled`,{code:`PROMPT_CANCELLED`,exitCode:130,details:{reason:e}}),this.reason=e}};function resolvePromptConfig(e,t){if(e.kind===`confirm`||e.kind===`input`||e.kind===`password`)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`?{...e,choices:r}:{...e,choices:r,...e.min===void 0?{}:{min:e.min},...e.max===void 0?{}:{max:e.max}}}const sensitiveDiagnostics=/* @__PURE__ */ new WeakMap;function sensitivityError(e,t){let n=t(e);return e||sensitiveDiagnostics.set(n,()=>t(!0)),n}function redactCoercionError(e){return sensitiveDiagnostics.get(e)?.()??e}function sourceLabel(e){switch(e.kind){case`stdin`:return`from stdin`;case`env`:return`from env ${e.envVar}`;case`env-indexed`:return e.index===void 0?`from env entries counted by ${e.count}`:`from env entry ${e.index} (${e.envVars.join(`, `)})`;case`config`:return`from config ${e.configPath}`;case`prompt`:return`from prompt`}}function indexedEnvSubject(e){return e.index===void 0?`the entries counted by ${e.count}`:e.envVars.join(` and `)}function sourceDetails(e){switch(e.kind){case`stdin`:return{source:`stdin`};case`env`:return{source:`env`,envVar:e.envVar};case`env-indexed`:return{source:`env`,countVar:e.count,...e.index===void 0?{}:{index:e.index},envVars:[...e.envVars]};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`env-indexed`:return t.env(indexedEnvSubject(e));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),t=>sensitivityError(r.sensitive,n=>flagCollectionErrors(e,i,n)(t)),(t,n)=>sensitivityError(r.sensitive,r=>flagAggregationErrors(e,r)(t,n)))}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:sensitivityError(r,r=>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:sensitivityError(i,r=>valueCoercionError(e,t,n,a.failure,r))}}function valueInputOf(e){return e.kind===`env-indexed`?`env`: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 indexedEnvFaultError(e,t,n){let r=e.kind===`flag`?`flag --${e.name}`:`argument <${e.name}>`,i=e.kind===`flag`?{flag:e.name}:{arg:e.name};switch(t.kind){case`count`:{let e=diagnosticValue(n,t.raw);return new ValidationError(`Invalid indexed env count '${e.text}' from env ${t.countVar} for ${r}`,{code:`TYPE_MISMATCH`,details:{...i,source:`env`,envVar:t.countVar,...e.kind===`visible`?{value:e.value}:{},expected:`count`},suggest:`Set ${t.countVar} to a non-negative integer without a sign or leading zeros`})}case`limit`:{let e=diagnosticValue(n,t.raw);return new ValidationError(`Indexed env count '${e.text}' from env ${t.countVar} for ${r} exceeds the limit of ${t.max}`,{code:`CONSTRAINT_VIOLATED`,details:{...i,source:`env`,envVar:t.countVar,...e.kind===`visible`?{value:e.value}:{},constraint:`maxCount`,max:t.max},suggest:`Set ${t.countVar} to at most ${t.max}`})}case`member`:{let e=t.count===1?`entry`:`entries`;return new ValidationError(`Env ${t.countVar} declares ${t.count} ${e} for ${r}, but ${t.envVar} is not set`,{code:`CONSTRAINT_VIOLATED`,details:{...i,source:`env`,envVar:t.envVar,countVar:t.countVar,count:t.count,index:t.index,...t.field===void 0?{}:{field:t.field},constraint:`indexedMember`},suggest:`Set ${t.envVar}, or set ${t.countVar} to ${t.index}`})}}}function coerceIndexedEntries(e,t,n,r){if(!e)return r({kind:`env-indexed`,count:t.count,index:void 0,envVars:n.entries.flatMap(e=>e.envVars)},n.entries.map(e=>e.raw));let i=[];for(let e of n.entries){let n=r(t.fields===void 0?{kind:`env`,envVar:e.envVars[0]??t.count}:{kind:`env-indexed`,count:t.count,index:e.index,envVars:e.envVars},e.raw);if(!n.ok)return n;i.push(n.value)}return{ok:!0,value:i}}function coerceIndexedFlagValue(e,t,n,r){if(n.kind===`fault`)return{ok:!1,error:sensitivityError(r.sensitive,t=>indexedEnvFaultError({kind:`flag`,name:e},n.fault,t))};let i=flagValueSchema(r);return coerceIndexedEntries(flagCardinality(r).kind===`many`,t.indexed,n,(t,n)=>coerceValueSchema(e,t,n,i,r.sensitive))}function coerceIndexedArgValue(e,t,n,r){return n.kind===`fault`?{ok:!1,error:indexedEnvFaultError({kind:`arg`,name:e},n.fault,r.sensitive)}:coerceIndexedEntries(argCardinality(r).kind===`many`,t.indexed,n,(t,n)=>coerceArgElement(e,t,n,r))}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),n=>sensitivityError(t.sensitive,t=>flagCollectionErrors(e,{kind:`stdin`},t)(n)),(n,r)=>sensitivityError(t.sensitive,t=>flagAggregationErrors(e,t)(n,r))):{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}}const ENV_ACCESS_HINT=Symbol.for(`@kjanat/dreamcli/env-access-hint`);function envAccessHint(e,t){let n=Reflect.get(e,ENV_ACCESS_HINT);if(typeof n!=`function`)return;let r=n(t);return typeof r==`string`?r:void 0}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`);if(t!==void 0)return{kind:`env`,label:`env ${t}`};let n=readStringProperty(e,`countVar`);if(n===void 0)return;let r=Reflect.get(e,`index`);return{kind:`env`,label:typeof r==`number`?`env ${n}[${r}]`:`env ${n}`}}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 requiredEnvSuggestion(e,t){let n=`envVar`in e?e.envVar:e.indexed.count,r=`envVar`in e?`set ${n}`:`set ${n} and its entries`,i=envAccessHint(t,n);return i===void 0?r:`${r} (${i})`}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(`
14
+ - `)}`,{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={violation:void 0,createSkipped:!1},d=(e,t=!1)=>({violation:e,createSkipped:t}),f;try{f=await r(t)}catch(e){if(l.kind===`redacted`)return d(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 d(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(f===null){if(n.create&&i!==void 0)try{return await i(t),u}catch(e){if(l.kind===`redacted`)return d(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 d(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}))}let e=n.create;return n.mustExist?d(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}`}),e):{violation:void 0,createSkipped:e}}return n.type!==void 0&&f!==n.type?d(new ValidationError(`Path '${l.text}' for ${o} is a ${f}, 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}`})):u}async function checkResolvedPath(e,t,n,r,i,a){let o=pathValuesOf(t);if(o.length===0)return;if(i.stat===void 0){a.skipped.push({kind:e.kind,name:e.name,checks:n,missing:`stat`});return}let s=!1;for(let t of o){let o=await validatePathChecks(e,t,n,i.stat,i.mkdir,r);o.violation!==void 0&&a.errors.push(o.violation),s||=o.createSkipped}s&&a.skipped.push({kind:e.kind,name:e.name,checks:n,missing:`mkdir`})}function describeSkippedPathCheck(e){let t=subjectLabel(e);return e.missing===`stat`?`${t}: no stat probe was supplied`:`${t}: no mkdir was supplied for create`}function pathChecksSkippedError(e){let t=`Pass stat (and mkdir for create) in run options to exercise the checks, or drop pathChecks: 'strict'`,n={skipped:e.map(e=>({kind:e.kind,name:e.name,missing:e.missing,checks:{mustExist:e.checks.mustExist,...e.checks.type===void 0?{}:{type:e.checks.type},create:e.checks.create}}))};if(e.length===1)return new CLIError(`Filesystem checks were skipped for ${describeSkippedPathCheck(e[0])}`,{code:`PATH_CHECK_SKIPPED`,details:n,suggest:t});let r=e.map(e=>` - ${describeSkippedPathCheck(e)}`);return new CLIError(`Filesystem checks were skipped for ${e.length} inputs:\n${r.join(`
15
+ `)}`,{code:`PATH_CHECK_SKIPPED`,details:n,suggest:t})}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 CANONICAL_COUNT=/^(?:0|[1-9][0-9]*)$/;function readEnv(e,t){return Object.hasOwn(e,t)?e[t]:void 0}function readIndexedEnv(e,t){let n=e.count,r=readEnv(t,n);if(r===void 0)return{kind:`absent`};if(!CANONICAL_COUNT.test(r))return{kind:`fault`,fault:{kind:`count`,countVar:n,raw:r}};let i=Number(r);if(i>1e4)return{kind:`fault`,fault:{kind:`limit`,countVar:n,raw:r,max:1e4}};let a=indexedEnvMembers(e),o=[];for(let r=0;r<i;r++){let s=[],c=[];for(let[e,o]of a){let a=expandEnvTemplate(o,r),l=readEnv(t,a);if(l===void 0)return{kind:`fault`,fault:{kind:`member`,countVar:n,count:i,index:r,field:e,envVar:a}};s.push(a),c.push([e,l])}let l=e.fields===void 0?c[0]?.[1]??``:Object.fromEntries(c);o.push({index:r,raw:l,envVars:s})}return{kind:`entries`,countVar:n,entries:o}}const ABSENT={kind:`absent`};async function runStages(e,t,n){let r=stdinBindingOf(e);for(let i of e){let e=await(i.stage===`prompt`?promptStage(i,t,n):runNonPromptStage(i,r,t,n));if(e.kind!==`absent`)return e}return ABSENT}function runEarlyStages(e,t,n){let r=stdinBindingOf(e);for(let i of e){if(i.stage===`prompt`||i.stage==="default")break;let e=runNonPromptStage(i,r,t,n);if(e.kind!==`absent`)return e}return ABSENT}function runNonPromptStage(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`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){if(`indexed`in e){let r=readIndexedEnv(e.indexed,n.env);if(r.kind===`absent`)return ABSENT;let i=t.coerceIndexed(e,r);if(!i.ok)return{kind:`error`,error:i.error};let a=r.kind===`entries`?r.entries:[];return{kind:`value`,value:i.value,provenance:{stage:`env`,via:`indexed`,count:e.indexed.count,envVars:a.flatMap(e=>e.envVars)}}}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||!n.some(e=>e.stage===`cli`))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=/* @__PURE__ */ new Set,o=/* @__PURE__ */ new Map,s=/* @__PURE__ */ new Map,c=pendingFlagErrors(t),l=pendingFlagReads(t),u=/* @__PURE__ */ new Map,d=!1,f={env:n.env,config:n.config,stdinData:n.stdinData,canPrompt:n.prompter!==void 0};for(let[o,p]of Object.entries(e)){if(c?.has(o))continue;let e=sourceBindings(p,n.envPrefix);if(c?.size&&flagValueSchema(p).codec.name===`custom`){let i=!1,a;Object.defineProperty(r,o,{enumerable:!0,configurable:!0,get:()=>{if(!i){i=!0;try{let i=l?.get(o),s=i===void 0?t:{[o]:i()},c=runEarlyStages(bindingsBeforePrompt(e),stageInput$1(o,p,s,e,n.prompter),f);c.kind===`value`&&(a=c.value),c.kind===`absent`&&delete r[o],c.kind===`error`&&(d=!0)}catch{d=!0}}return a}}),u.set(o,()=>r[o]);continue}let m=await runStages(bindingsBeforePrompt(e),stageInput$1(o,p,t,e,n.prompter),f);m.kind===`error`&&s.set(o,i.length),record(o,p,m,r,i,a,n)}let p;try{let e=u.size?new Proxy(r,{ownKeys:e=>{for(let e of u.values())e();return Reflect.ownKeys(e)},has:(e,t)=>(u.get(t)?.(),Reflect.has(e,t)),getOwnPropertyDescriptor:(e,t)=>(u.get(t)?.(),Reflect.getOwnPropertyDescriptor(e,t))}):r;p=n.interactive?.({flags:e})}catch(e){if(!c?.size)throw e;d=!0}if(c!==void 0)for(let[t,n]of c){let r=e[t];if(r===void 0)throw n;let i=effectivePromptConfig(t,r,p);throw d||r.sensitive||i?.kind===`password`||i?.sensitive===!0?redactFlagParseError(n):n}for(let[c,l]of Object.entries(e)){let e=effectivePromptConfig(c,l,p),u=l.sensitive||e?.kind===`password`||e?.sensitive===!0,d=u?{...l,sensitive:!0}:l;u&&n.sensitiveInputs?.add(c),o.set(c,d);let m=s.get(c),h=m===void 0?void 0:i[m];if(u&&m!==void 0&&h!==void 0&&(i[m]=redactCoercionError(h)),Object.hasOwn(r,c)||a.has(c))continue;let g=withPromptBinding(d,sourceBindings(d,n.envPrefix),e);if(record(c,d,await runStages(bindingsFromPrompt(g),stageInput$1(c,d,t,g,n.prompter),f),r,i,a,n),!(Object.hasOwn(r,c)||a.has(c))){if(d.kind===`array`&&d.presence!==`required`)r[c]=[],n.provenance[c]={stage:`default`};else if(d.kind===`keyValue`&&d.presence!==`required`)r[c]={},n.provenance[c]={stage:`default`};else if(d.presence===`required`){let e={flag:c,kind:d.kind},t=envBindingOf(sourceBindings(d,n.envPrefix));t!==void 0&&`envVar`in t&&(e.envVar=t.envVar),t!==void 0&&`indexed`in t&&(e.envIndexed=t.indexed),d.configPath!==void 0&&(e.configPath=d.configPath),i.push(new ValidationError(`Missing required flag --${c}`,{code:`REQUIRED_FLAG`,details:e,suggest:buildRequiredFlagSuggest(c,d,t,n.env)}))}else r[c]=void 0}}for(let[t,a]of Object.entries(e)){let e=o.get(t)??a,s=Object.hasOwn(r,t)?r[t]:void 0,c=flagValueSchema(e).pathChecks;e.kind===`array`&&e.unique&&Array.isArray(s)&&(r[t]=[...dedupe(s)]),c!==void 0&&await checkResolvedPath({kind:`flag`,name:t},Object.hasOwn(r,t)?r[t]:void 0,c,e.sensitive,{stat:n.stat,mkdir:n.mkdir},{errors:i,skipped:n.skippedPathChecks})}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),coerceIndexed:(n,r)=>coerceIndexedFlagValue(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){n.kind===`error`?(i.push(n.error),a.add(e)):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`,`password`,`select`],number:[`input`],enum:[`select`,`input`],array:[`multiselect`],custom:[`input`,`password`,`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,sensitive:t.sensitive||n.prompt.sensitive===!0||n.prompt.kind===`password`},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);if(!s.answered){if(i.kind===`password`&&s.reason===`invalid`)throw new CLIError(`Too many invalid prompt answers`,{code:`PROMPT_INVALID`,exitCode:2});if(i.kind===`password`)throw new PromptCancelledError;return{ok:!1,error:void 0}}return i.kind===`input`&&i.default===void 0&&(i.empty??`skip`)===`skip`&&typeof s.value==`string`&&(i.trim===!1?s.value:s.value.trim())===``?{ok:!1,error:void 0}:coerceValue(e,n,s.value,i.sensitive?{...t,sensitive:!0}:t)}function buildRequiredFlagSuggest(e,t,n,r){let i=[],a=t.kind!==`boolean`&&t.kind!==`count`;acceptsArgv(t)&&i.push(`Provide --${e}${a?` <value>`:``}`);let o=t.stdin;if(o!==void 0&&i.push(acceptsArgv(t)?o.when===`dash`?`pass --${e} - to read stdin`:o.when===`missing`?`pipe a value to stdin`:`pipe a value to stdin or pass --${e} -`:`Pipe a value to stdin`),n!==void 0&&i.push(requiredEnvSuggestion(n,r)),t.configPath!==void 0&&i.push(`add ${t.configPath} to config`),i.length<=1)return i.join(``);let s=i.slice(0,-1),c=i.slice(-1).join(``);return i.length===2?`${s.join(``)} or ${c}`:`${s.join(`, `)}, or ${c}`}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,n.envPrefix),c=envBindingOf(e),l=await runStages(e,stageInput(o,s,t,e,n.prompter),a);if(l.kind===`error`){i.push(l.error);continue}if(l.kind===`value`){s.deprecated!==void 0&&l.provenance.stage!=="default"&&n.deprecations.push({kind:`arg`,name:o,message:s.deprecated}),r[o]=l.value,n.provenance[o]=l.provenance;continue}let u=argCardinality(s);if(u.kind===`many`||u.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,c,n.env,s.variadic)}));continue}r[o]=u.kind===`many`?[]:{},n.provenance[o]={stage:`default`}}else s.presence===`required`?i.push(new ValidationError(`Missing required argument <${o}>`,{code:`REQUIRED_ARG`,details:{arg:o},suggest:buildRequiredArgSuggest(o,s,c,n.env)})):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)])}for(let{name:t,schema:a}of e){let e=argValueSchema(a).pathChecks;e!==void 0&&await checkResolvedPath({kind:`arg`,name:t},Object.hasOwn(r,t)?r[t]:void 0,e,a.sensitive,{stat:n.stat,mkdir:n.mkdir},{errors:i,skipped:n.skippedPathChecks})}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),coerceIndexed:(n,r)=>coerceIndexedArgValue(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,sensitive:t.sensitive||n.prompt.sensitive===!0||n.prompt.kind===`password`},{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);if(!c.answered){if(i.kind===`password`&&c.reason===`invalid`)throw new CLIError(`Too many invalid prompt answers`,{code:`PROMPT_INVALID`,exitCode:2});if(i.kind===`password`)throw new PromptCancelledError;return{ok:!1,error:void 0}}return i.kind===`input`&&i.default===void 0&&(i.empty??`skip`)===`skip`&&typeof c.value==`string`&&(i.trim===!1?c.value:c.value.trim())===``?{ok:!1,error:void 0}:coerceArgValue(e,n,c.value,i.sensitive?{...t,sensitive:!0}:t)}function buildRequiredArgSuggest(e,t,n,r,i){let a=acceptsArgv(t)?[i?`Provide at least one value for <${e}>`:`Provide a value for <${e}>`]:[],o=t.stdin;return o!==void 0&&a.push(acceptsArgv(t)?o.when===`dash`?`pass '-' to read stdin`:o.when===`missing`?`pipe a value to stdin`:`pipe a value to stdin or pass '-'`:`Pipe a value to stdin`),n!==void 0&&a.push(requiredEnvSuggestion(n,r)),t.configPath!==void 0&&a.push(`add ${t.configPath} to config`),a.length===1?a.join(``):a.length===2?`${a[0]} or ${a[1]}`:`${a.slice(0,-1).join(`, `)}, or ${a[a.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,r){let i=[],a={...t};for(let[n,o]of Object.entries(e.flags)){let e=resolvedValue(t,n);if(e===void 0)continue;let s=await validateInput(`--${n}`,e,isCollection(flagCardinality(o)),flagValueSchema(o).standard,flagAggregateStandard(o),i,o.sensitive||r?.has(n)===!0);s.changed&&(a[n]=s.value)}let o={...n};for(let t of e.args){let e=resolvedValue(n,t.name);if(e===void 0)continue;let r=await validateInput(`<${t.name}>`,e,isCollection(argCardinality(t.schema)),argValueSchema(t.schema).standard,argAggregateStandard(t.schema),i,t.schema.sensitive);r.changed&&(o[t.name]=r.value)}return{flags:a,args:o,errors:i}}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=/* @__PURE__ */ 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=[],a=provenanceRecord(),o=provenanceRecord(),s=/* @__PURE__ */ new Set,c={env:n?.env??{},config:n?.config??{},stdinData:n?.stdinData,prompter:n?.prompter,deprecations:r,stat:n?.stat,mkdir:n?.mkdir,envPrefix:n?.envPrefix===void 0?void 0:normalizeEnvPrefix(n.envPrefix),skippedPathChecks:i},l={},u={},d=[];try{l=await resolveFlags(e.flags,t.flags,{...c,interactive:e.interactive,provenance:a,sensitiveInputs:s})}catch(e){if(!isValidationError(e))throw e;d.push(...collectValidationErrors(e))}try{u=await resolveArgs(e.args,t.args,{...c,provenance:o})}catch(e){if(!isValidationError(e))throw e;d.push(...collectValidationErrors(e))}let f=await applyStandardValidators(e,l,u,s);if(l=f.flags,u=f.args,d.push(...f.errors),n?.pathChecks===`strict`&&isNonEmpty(i))throw pathChecksSkippedError(i);return isNonEmpty(d)&&throwAggregatedErrors(d),{flags:l,args:u,deprecations:r,skippedPathChecks:i,provenance:{flags:a,args:o}}}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);let s=[];try{if(builtinEnabled(i?.builtins,`help`)&&requestsHelp(t)){if(a.jsonMode||i?.jsonMode===!0){let{generateCommandSchema:e}=await import(`./json-schema-CYgq_hFu.mjs`).then(e=>e.a);return a.json(e(o,i?.envPrefix===void 0?void 0:{envPrefix:i.envPrefix},{name:i?.help?.binName??o.name,version:i?.help?.version})),{exitCode:0,error:void 0}}let e=i?.flags?.caseParity??i?.help?.caseParity,t={...i?.help,...i?.envPrefix!==void 0&&i.help?.envPrefix===void 0?{envPrefix:i.envPrefix}:{},...e===void 0?{}:{caseParity:e}},n=formatHelp(o,t.colors===void 0?{...t,colors:a.color}:t);return a.log(n),{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 c=(o.interactive===void 0?parse:parseForResolution)(o,t,i?.flags),l=i?.prompter??await scriptedPrompter(i?.answers),u=await resolve(o,c,{...i?.stdinData===void 0?{}:{stdinData:i.stdinData},...i?.env===void 0?{}:{env:i.env},...i?.config===void 0?{}:{config:i.config},...l===void 0?{}:{prompter:l},...i?.stat===void 0?{}:{stat:i.stat},...i?.mkdir===void 0?{}:{mkdir:i.mkdir},...i?.pathChecks===void 0?{}:{pathChecks:i.pathChecks},...i?.envPrefix===void 0?{}:{envPrefix:i.envPrefix}});s=u.skippedPathChecks;let d={args:u.args,flags:u.flags,deprecations:u.deprecations,skippedPathChecks:s,command:o,meta:r,out:a};await runResolvedHooks(i?.plugins,`afterResolve`,d);for(let e of u.deprecations)a.warn(formatDeprecation(e));await runResolvedHooks(i?.plugins,`beforeAction`,d);let f;return await executeWithExecutionSteps(n,e,u,a,r,async e=>(a.stopActive(),f??=import(`./session-BEKj0yLA.mjs`).then(e=>e.n).then(({createPromptSession:e})=>e({...l===void 0?{}:{prompter:l},write:e=>a.error(e.replace(/\n$/,``))})),(await f).ask(e))),await runResolvedHooks(i?.plugins,`afterAction`,d),{exitCode:getRequestedExitCode(a)??0,error:void 0,skippedPathChecks:s}}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,skippedPathChecks:s};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,skippedPathChecks:s}}finally{a.stopActive(),clearRequestedExitCode(a)}}async function scriptedPrompter(e){if(e===void 0)return;let{createTestPrompter:t}=await import(`./test-prompter-euLYzWWO.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,a){let o=e.steps,{args:s,flags:c}=n,l=n.provenance,u=async e=>{await t({flags:c,args:s,sources:l,ctx:e,out:r,meta:i,ask:a})};for(let e=o.length-1;e>=0;e--){let t=o[e];if(t===void 0)continue;let n=u;switch(t.kind){case`derive`:u=async e=>{let o=await t.handler({args:s,flags:c,sources:l,ctx:e,out:r,meta:i,ask:a});if(o===void 0)await n(e);else{if(typeof o!=`object`||!o||Array.isArray(o))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,...o})}};break;case`middleware`:u=async e=>{await t.handler({args:s,flags:c,sources:l,ctx:e,out:r,meta:i,ask:a,next:async t=>{await n({...e,...t})}})}}}await u({})}function buildRunResult(e,t){return{exitCode:e.exitCode,stdout:t.stdout,stderr:t.stderr,activity:t.activity,error:e.error,skippedPathChecks:e.skippedPathChecks??[]}}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 resolveExecutionColor(e){if(e.color!==void 0)return e.color;if(e.jsonMode)return!1;let t=e.env??{};return t.NO_COLOR?!1:t.FORCE_COLOR===void 0?e.isTTY??!1:t.FORCE_COLOR!==`0`}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,...e?.readSecret===void 0?{}:{readSecret:e.readSecret},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 createInputReader(e,t){let n=``,r=!1,i=!1,a=!1,o=!1,s=async t=>{for(;n===``&&!i;){let a=await e();a===null?i=!0:(n=a,r=t)}return o&&n!==``&&(n.startsWith(`
16
+ `)&&(n=n.slice(1)),o=!1,n===``&&!i)?s(t):n!==``},c=async e=>{if(a)throw new CLIError(`An input read is already active`,{code:`PROMPT_BUSY`});a=!0;let i;try{e&&(i=t?.(),r||(n=``,o=!1));let a=``;for(;;){if(!await s(e))return e||a===``?null:a;if(!e){let e=n.indexOf(`
17
+ `);if(e!==-1){let t=a+n.slice(0,e);return n=n.slice(e+1),t.replace(/\r$/,``)}a+=n,n=``;continue}let t=String.fromCodePoint(n.codePointAt(0)??0);switch(n=n.slice(t.length),t){case`\r`:return o=!0,a;case`
18
+ `:return a;case``:throw new PromptCancelledError(`interrupt`);case`\x1B`:throw new PromptCancelledError(`escape`);case``:case``:return null;case``:case`\b`:a=Array.from(a).slice(0,-1).join(``);break;case``:a=``;break;case``:a=a.replace(/\s*\S+\s*$/,``);break;default:(t>=` `||t===` `)&&(a+=t)}}}finally{try{i?.()}finally{a=!1}}};return{readLine:()=>c(!1),...t===void 0?{}:{readSecret:()=>c(!0)}}}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 isDenoPermissionError(e){return isDenoErrorNamed(e,`NotCapable`)||isDenoErrorNamed(e,`PermissionDenied`)}function envGranted(e,t){let n=e.permissions?.querySync;if(n===void 0)return;let r=t===void 0?{name:`env`}:{name:`env`,variable:t};return n.call(e.permissions,r).state===`granted`}function readGrantedEnv(e,t){if(envGranted(e,t)!==!1)try{return e.env.get(t)}catch(e){if(isDenoPermissionError(e))return;throw e}}function scopedDenoEnv(e){let t=/* @__PURE__ */ new Map,n=n=>(t.has(n)||t.set(n,readGrantedEnv(e,n)),t.get(n)),r=t=>envGranted(e,t)===!1?`Deno has not granted access to ${t}; run with --allow-env=${t}`:void 0;return new Proxy(Object.create(null),{get:(e,t)=>typeof t==`string`?n(t):t===ENV_ACCESS_HINT?r:void 0,has:(e,t)=>typeof t==`string`&&n(t)!==void 0,getOwnPropertyDescriptor:(e,t)=>{if(typeof t!=`string`)return;let r=n(t);return r===void 0?void 0:{value:r,writable:!1,enumerable:!0,configurable:!0}},ownKeys:()=>[],set:()=>!1,defineProperty:()=>!1,deleteProperty:()=>!1})}function readDenoEnv(e){if(envGranted(e)!==!1)try{return e.env.toObject()}catch(e){if(!isDenoPermissionError(e))throw e}return scopedDenoEnv(e)}function safeCwd(e){try{return e.cwd()}catch(e){if(isDenoPermissionError(e))return`/`;throw e}}function createDenoAdapter(e){let t=e??getDenoNamespace(),n=new TextEncoder,r=[`deno`,`run`,...t.args],i=readDenoEnv(t),a=safeCwd(t),o=e=>{t.stdout.writeSync(n.encode(e))},s=e=>{t.stderr.writeSync(n.encode(e))},c=createDenoInput(t),l=async e=>{try{return await t.readTextFile(e)}catch(e){if(isDenoErrorNamed(e,`NotFound`)||isDenoPermissionError(e))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.readLine,...c.readSecret===void 0?{}:{readSecret:c.readSecret},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 createDenoInput(e){let t=new TextDecoder,n=!1;return createInputReader(async()=>{if(n)return null;let r=e.stdin.readable.getReader();try{let e=await r.read();return e.done?(n=!0,t.decode()||null):t.decode(e.value,{stream:!0})}finally{r.releaseLock()}},e.stdin.isTerminal()&&e.stdin.setRaw!==void 0?()=>(e.stdin.setRaw?.(!0),()=>{e.stdin.setRaw?.(!1)}):void 0)}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=createNodeInput(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.readLine,...l.readSecret===void 0?{}:{readSecret:l.readSecret},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=/* @__PURE__ */ 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 createNodeInput(e){let t,n=new TextDecoder,r=!1;return createInputReader(async()=>{if(r)return null;t??=e.stdin[Symbol.asyncIterator]();let i=await t.next();return i.done?(r=!0,n.decode()||null):n.decode(i.value,{stream:!0})},e.stdin.isTTY===!0&&e.stdin.setRawMode!==void 0?()=>{let t=e.stdin.isRaw===!0;return e.stdin.setRawMode?.(!0),()=>{e.stdin.setRawMode?.(t)}}:void 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=/* @__PURE__ */ new Map,n=/* @__PURE__ */ 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=/* @__PURE__ */ 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++;else{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,remainingArgv:c}: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=/* @__PURE__ */ 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=/* @__PURE__ */ 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=/* @__PURE__ */ new Map,s=!1;for(let e of r){let n=matchRootToken(e,t);n.kind===`unrelated`?a.push(e):(s=!0,n.kind===`invalid`?(o.delete(n.name),o.set(n.name,n.error)):(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=/* @__PURE__ */ 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 scopeHelpToCommandPath(e,t){let n=t.slice(0,-1).map(e=>e.name);return n.length===0?e.help:{...e.help,binName:[e.help.binName??e.schema.name,...n].join(` `)}}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:scopeHelpToCommandPath(e,n)})}}function canDelegateUnknownRootToDefault(e,t){return t===``||e.schema.args.some(e=>acceptsArgv(e.schema))}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`:return{kind:`needs-subcommand`,command:l.command,commandPath:l.commandPath,help:scopeHelpToCommandPath(e,l.commandPath)};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=/* @__PURE__ */ 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))if(acceptsArgv(r))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(`
19
+
20
+ `)}\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(`
21
+ `)}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)}else 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)}else 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-hqUWeazy.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-hqUWeazy.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-DSh3QJpX.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-Dws_b5UK.mjs`).then(e=>e.n).then(({createTerminalPrompter:t})=>t(e.stdin,e.stderr,e.readSecret===void 0?{}:{readSecret:e.readSecret})),(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.options?.answers===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){for(let[t,n]of Object.entries(e.flags))if(acceptsArgv(n)&&(t===COMPLETIONS_FLAG_NAME||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){if(commandRoutes(t).includes(`__complete`))throw new CLIError(`Command route '__complete' is reserved for value completion`,{code:`INVALID_SCHEMA`});let r=/* @__PURE__ */ 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=/* @__PURE__ */ 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),envPrefix:e.envPrefix===void 0?void 0:normalizeEnvPrefix(e.envPrefix)})}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,color:resolveExecutionColor({...t,jsonMode:r}),...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?.pathChecks===void 0?{}:{pathChecks:e.pathChecks},...e?.envPrefix===void 0?{}:{envPrefix:e.envPrefix},...e?.verbosity===void 0?{}:{verbosity:e.verbosity},...e?.jsonMode===void 0?{}:{jsonMode:e.jsonMode},...e?.isTTY===void 0?{}:{isTTY:e.isTTY},...e?.color===void 0?{}:{color:e.color},...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})}envPrefix(e){return rebuild(this,{...this.schema,envPrefix:e===void 0?deriveEnvPrefix(this.schema.name):normalizeEnvPrefix(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`,{absolute:!0}).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-B4oRc2Ae.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();if(t.argv[2]===`__complete`){let{completeRequest:n}=await import(`./dynamic-BK2lQF2M.mjs`),r=await n(e?.flags===void 0?this.schema:{...this.schema,flagSettings:e.flags},compiledStateOf(this),t.argv.slice(3),e?.env??t.env);for(let e of r.candidates)t.stdout(`${e}\n`);return exitAfterFlush(t,r.exitCode)}let 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,getTerminalSize:()=>t.getTerminalSize(),jsonMode:i.inputs.jsonMode,isTTY:i.inputs.isTTY,color:resolveExecutionColor({...e,...i.inputs}),...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){if(t[0]===`__complete`){let{completeRequest:r}=await import(`./dynamic-BK2lQF2M.mjs`),i=await r(n?.flags===void 0?e.schema:{...e.schema,flagSettings:n.flags},compiledStateOf(e),t.slice(1),n?.env??{}),a=n?.captured??{stdout:[],stderr:[],activity:[]};for(let e of i.candidates)n?.out===void 0?a.stdout.push(`${e}\n`):n.out.log(e);return buildRunResult({exitCode:i.exitCode,error:void 0},a)}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={color:resolveExecutionColor({...n,jsonMode:i}),...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=n?.envPrefix??e.schema.envPrefix,f=n?.flags??e.schema.flagSettings,p={...e.schema.helpConfig,...n?.help,...d===void 0?{}:{envPrefix:d},...f?.caseParity===void 0?{}:{caseParity:f.caseParity},binName:n?.help?.binName??e.schema.name,hyperlinks:c.isHyperlinkSupported,colors:n?.help?.colors??c.color,...u===void 0?{}:{version:u}},m=compiledStateOf(e),h={...n,...d===void 0?{}:{envPrefix:d},plugins:m.plugins,builtins:e.schema.builtins,...i?{jsonMode:i}:{},...a===void 0?{}:{verbosity:a},...f===void 0?{}:{flags:f}},g={jsonMode:i,isTTY:c.isTTY,verbosity:a??`normal`},_=planInvocation({schema:n?.flags===void 0?e.schema:{...e.schema,flagSettings:f},compiled:m,argv:t,help:p,output:g});switch(_.kind){case`root-version`:return c.log(_.version),buildRunResult({exitCode:0,error:void 0},l);case`root-completions`:{let t=_.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. '${p.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=p.binName===void 0||p.binName===e.schema.name?e.schema:{...e.schema,name:p.binName},{generateCompletion:a}=await import(`./completion-B4oRc2Ae.mjs`).then(e=>e.t),o=a(r,t,_.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-CYgq_hFu.mjs`).then(e=>e.a);c.json(t(e.schema,d===void 0?void 0:{envPrefix:d},{name:_.help.binName??e.schema.name,version:_.help.version??e.schema.version}))}else{let t=formatRootHelp(resolveHelpLinksSchema(e.schema),_.help);c.log(t)}return buildRunResult({exitCode:0,error:void 0},l);case`dispatch-error`:return i?c.json({error:_.error.toJSON()}):(c.error(_.error.message),_.error.suggest!==void 0&&_.error.code!==`NO_ACTION`&&c.error(`Suggestion: ${_.error.suggest}`)),buildRunResult({exitCode:_.error.exitCode,error:_.error},l);case`needs-subcommand`:if(i){let{generateCommandSchema:e}=await import(`./json-schema-CYgq_hFu.mjs`).then(e=>e.a);c.json(e(_.command.schema,d===void 0?void 0:{envPrefix:d},{name:_.help.binName??_.command.schema.name,version:_.help.version}))}else{let e=formatHelp(_.command.schema,_.help);c.log(e)}return buildRunResult({exitCode:0,error:void 0},l);case`match`:{let e=buildCommandRunOptions(h,_.plan.help??p,_.plan.meta);return buildRunResult(await executeCommand({command:{handler:_.plan.command.handler,steps:_.plan.command.steps},argv:_.plan.argv,out:c,schema:_.plan.mergedSchema,meta:_.plan.meta,options:e}),l)}}}const RUNTIME_BINARIES=/* @__PURE__ */ 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,...t?.envPrefix===void 0?{}:{envPrefix:t.envPrefix},...t?.flagSpelling===void 0?{}:{flagSpelling:t.flagSpelling},...t?.parse?.caseParity===void 0?{}:{caseParity:t.parse.caseParity}})),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?.envPrefix===void 0?{}:{envPrefix:t.envPrefix},...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}const prompt={input(e){return{empty:`retry`,...e,kind:`input`}},password(e){return{...e,kind:`password`,sensitive:!0}},confirm(e){return{...e,kind:`confirm`}},select(e){return{...e,kind:`select`}},multiselect(e){return{...e,kind:`multiselect`}}};async function prepareTextAnswer(e,t){let n=e.kind===`input`&&e.trim!==!1?t.trim():t;if(n===``){if(e.kind===`input`&&e.default!==void 0)return{ok:!0,value:e.default};if((e.empty??(e.kind===`password`?`retry`:`skip`))===`retry`)return{ok:!1,message:`Please enter a value.`,reason:`empty`};if(e.kind===`input`&&(e.empty??`skip`)===`skip`)return{ok:!0,value:n}}let r=await e.validate?.(n);return r===void 0||r===!0?{ok:!0,value:n}:{ok:!1,message:r,reason:`validation`}}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={color:resolveExecutionColor({...n,jsonMode:i}),...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{createArgSchema as $,resolvePromptConfig as A,includesBeforeSeparator as B,createNodeAdapter as C,ExitError as D,createDenoAdapter as E,resolvePlainHelpDescription as F,middleware as G,stripBeforeSeparator as H,osc8 as I,createCommandSchema as J,CommandBuilder as K,visibleWidth as L,createCaptureOutput as M,createOutput as N,createTestAdapter as O,formatHelp as P,arg as Q,buildFlagLookup as R,createAdapter as S,detectRuntime as T,tokenize as U,parse as V,wasExplicit as W,resolveExampleCommand as X,group as Y,ArgBuilder as Z,readRootOutputFlags as _,isParseError as _t,DEFINITION_SCHEMA_URL as a,acceptsArgv as at,findClosestCommand as b,cli as c,flagValueSchema as ct,resolveRenderContext as d,BUILTIN_SPECS as dt,FlagBuilder as et,extractConfigFlag as f,builtinEnabled as ft,canDelegateUnknownRootToDefault as g,isCLIError as gt,buildRootCommandMap as h,ValidationError as ht,readFlags as i,getFlagNegatedName as it,PromptCancelledError as j,resolve as k,createCLISchema as l,valueEnumValues as lt,plugin as m,ParseError as mt,prepareTextAnswer as n,flag as nt,DEFINITION_SCHEMA_VERSION as o,DUPLICATE_KEYS as ot,resolveRootSurface as p,CLIError as pt,command as q,prompt as r,getFlagAliasNames as rt,CLIBuilder as s,SPLIT_FORMATS as st,runCommand as t,createFlagSchema as tt,isMainModule as u,BUILTIN_NAMES as ut,collectPropagatedFlags as v,isValidationError as vt,RUNTIMES as w,packageRepositoryUrl as x,dispatch as y,SHELLS as yt,flagExpectsValue as z};
@@ -0,0 +1 @@
1
+ import{R as buildFlagLookup,_ as readRootOutputFlags,at as acceptsArgv,b as findClosestCommand,dt as BUILTIN_SPECS,f as extractConfigFlag,ft as builtinEnabled,g as canDelegateUnknownRootToDefault,h as buildRootCommandMap,p as resolveRootSurface,ut as BUILTIN_NAMES,v as collectPropagatedFlags,y as dispatch,z as flagExpectsValue}from"./core-BZx351-p.mjs";function findCompletion(e,t,n,r){if(n.length===0)return;let i=n.slice(0,-1),a=e.configSettings===void 0?i:extractConfigFlag(i).filteredArgv,o=readRootOutputFlags(a,e.builtins).argv,s=resolveRootSurface(e).visibleDefaultCommand,c=e.defaultCommandRouted&&t.defaultCommand!==void 0?[...t.commands,t.defaultCommand]:t.commands,l=dispatch(o,buildRootCommandMap(c),[],buildFlagLookup(e.defaultCommand?.flags??{},e.flagSettings),e.flagSettings);if(l.kind===`unknown`&&(l.parentPath.length>0||s===void 0||t.defaultCommand===void 0||!canDelegateUnknownRootToDefault(t.defaultCommand,l.input)||l.input!==``&&findClosestCommand(l.input,l.candidates)!==void 0))return;let u=l.kind===`unknown`?s:l.command.schema,d=l.kind===`unknown`?[]:l.commandPath,f=l.kind===`unknown`?o:l.remainingArgv,p=0,m=!1,h,g=buildFlagLookup(u===void 0?{}:{...collectPropagatedFlags(d),...u.flags},e.flagSettings);for(let t of f){if(h!==void 0){h=void 0;continue}if(!m&&t===`--`){m=!0;continue}if(!m&&t.startsWith(`-`)&&t!==`-`){if(BUILTIN_NAMES.some(n=>builtinEnabled(e.builtins,n)&&(BUILTIN_SPECS[n].short.includes(t)||BUILTIN_SPECS[n].long.some(e=>t===e||t.startsWith(`${e}=`))))||e.version!==void 0&&(t===`--version`||t===`-V`))continue;let n=matchFlag(t,g);if(n===void 0||n.entry.negated&&n.inline!==void 0)return;n.inline===void 0&&flagExpectsValue(n.entry.schema)&&(h=n.entry);continue}let n=u?.args.filter(e=>acceptsArgv(e.schema))??[];if(n[p]===void 0&&!n[n.length-1]?.schema.variadic)return;p++}let _=n[n.length-1]??``,v=``,y,b,x=[];if(h!==void 0)y={kind:`flag`,name:h.name},b=h.schema.completion;else if(!m&&_.startsWith(`-`)){let e=matchFlag(_,g);if(e?.inline===void 0||e.entry.negated)return;y={kind:`flag`,name:e.entry.name},b=e.entry.schema.completion,v=_.slice(0,_.length-e.inline.length),_=e.inline}else{let e=u?.args.filter(e=>acceptsArgv(e.schema))??[],t=e[p]??(e[e.length-1]?.schema.variadic?e[e.length-1]:void 0);if(t===void 0)return;p===0&&!m&&(x=(l.kind===`unknown`?l.candidates:[...new Set(l.command.subcommands.values())]).filter(e=>!e.schema.hidden).flatMap(e=>[e.schema.name,...e.schema.aliases])),y={kind:`arg`,name:t.name},b=t.schema.completion}if(b!==void 0)return{handler:b,tokenPrefix:v,commandCandidates:x,context:{prefix:_,commandPath:d.map(e=>e.name),input:y,argv:n,env:r}}}function matchFlag(e,t){if(e.startsWith(`--`)){let n=e.indexOf(`=`),r=t.get(e.slice(2,n<0?void 0:n));return r===void 0?void 0:{entry:r,inline:n<0?void 0:e.slice(n+1)}}for(let n=1;n<e.length;n++){let r=t.get(e[n]??``);if(r===void 0)return;if(flagExpectsValue(r.schema)||n===e.length-1)return{entry:r,inline:n===e.length-1?void 0:e.slice(n+1)}}}async function completeValues(e,t,n,r,i=!1){let a=findCompletion(e,t,n,r);if(a===void 0)return{exitCode:1,candidates:[]};try{let e=await a.handler(a.context);return{exitCode:0,candidates:[.../* @__PURE__ */ new Set([...a.commandCandidates,...e])].filter(e=>typeof e==`string`&&e.length>0&&!/\p{Cc}/u.test(e)&&e.startsWith(a.context.prefix)).map(e=>i?e:a.tokenPrefix+e)}}catch{return{exitCode:0,candidates:a.commandCandidates.filter(e=>e.startsWith(a.context.prefix))}}}async function completeRequest(e,t,n,r){let i=n[0]===`--value-only`&&n[1]===`--`,a=i?2:+(n[0]===`--`);return completeValues(e,t,n.slice(a),r,i)}export{completeRequest};
@@ -1,6 +1,6 @@
1
- import { Kt as FlagPresence, Nn as PromptKind, Pt as DuplicatePolicy, Rn as NumberConstraints, T as ExampleMeta, Ut as FlagKind, b as CommandSchema, rt as ArgPresence, tt as ArgKind, xt as DuplicateKeys } from "./index-BIMjOsR6.mjs";
2
- import "./index-DpslpOVV.mjs";
3
- import { o as CLISchema } from "./index-hzYPRc_O.mjs";
1
+ import { A as ExampleMeta, Et as DuplicateKeys, Jt as FlagKind, Rn as PromptKind, T as CommandSchema, Un as NumberConstraints, Zt as FlagPresence, ct as ArgPresence, ot as ArgKind, zt as DuplicatePolicy } from "./index-CuhI1Ynv.mjs";
2
+ import "./index-DDhRLoTu.mjs";
3
+ import { o as CLISchema } from "./index-Vjl2_m23.mjs";
4
4
  /**
5
5
  * Identifiers of the definition document format.
6
6
  *
@@ -100,13 +100,14 @@ type PromptDefinitionFragmentV1 = { [K in PromptKind]: {
100
100
  /**
101
101
  * Stdin binding of a flag or arg fragment.
102
102
  *
103
- * Every field is always written, so a document states the trigger, the sharing
104
- * mode, and the trimming without a reader having to know the builder's defaults.
103
+ * The trigger, sharing mode, and trimming are always written. `argv` is written
104
+ * only when false, preserving the default command-line behavior of older documents.
105
105
  */
106
106
  type StdinBindingFragmentV1 = {
107
107
  readonly when: 'dash' | 'missing' | 'dash-or-missing';
108
108
  readonly consume: 'exclusive' | 'broadcast';
109
109
  readonly trim: boolean;
110
+ readonly argv?: false;
110
111
  };
111
112
  /**
112
113
  * How one source's text decodes into collection elements.
@@ -270,6 +271,8 @@ type CommandDefinitionFragmentV1 = {
270
271
  readonly name: string;
271
272
  /** Human-readable description for help text. */
272
273
  readonly description?: string;
274
+ /** Longer explanation shown only in this command's help. */
275
+ readonly details?: string;
273
276
  /** Alternative names accepted for this command. */
274
277
  readonly aliases?: readonly string[];
275
278
  /** Whether the command is omitted from help listings. */