@kjanat/dreamcli 4.1.0 → 4.2.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 (41) hide show
  1. package/dist/{adapter-YM5QGi3M.d.mts → adapter-DsmEc0WO.d.mts} +5 -1
  2. package/dist/{completion-CUMeOnAz.mjs → completion-BYhuYn2Q.mjs} +4 -4
  3. package/dist/completion.d.mts +1 -1
  4. package/dist/completion.mjs +1 -1
  5. package/dist/config-BgJZ-X4r.mjs +1 -0
  6. package/dist/config.d.mts +1 -1
  7. package/dist/config.mjs +1 -1
  8. package/dist/core-B4Twhd48.mjs +18 -0
  9. package/dist/index-B3_9MlHz.d.mts +131 -0
  10. package/dist/{index-BziI2aKc.d.mts → index-B6oD4_8b.d.mts} +74 -12
  11. package/dist/{index-DWsnGZlx.d.mts → index-B_1Dmsdq.d.mts} +12 -136
  12. package/dist/{index-3l8uj16E.d.mts → index-C5CYWtxn.d.mts} +9 -6
  13. package/dist/{index-Cap0MA2V.d.mts → index-CaRNJH2R.d.mts} +5 -1
  14. package/dist/{index-Cp9kt2t-.d.mts → index-Cj7kXwQH.d.mts} +1 -1
  15. package/dist/{index-BAj2y70U.d.mts → index-eF7SkQzQ.d.mts} +4 -4
  16. package/dist/index.d.mts +8 -7
  17. package/dist/index.mjs +1 -1
  18. package/dist/json-schema-DVyfq4bA.mjs +52 -0
  19. package/dist/json-schema.d.mts +1 -1
  20. package/dist/json-schema.mjs +1 -1
  21. package/dist/package-json-fYhxDdWD.mjs +3 -0
  22. package/dist/prompt.d.mts +36 -3
  23. package/dist/prompt.mjs +1 -1
  24. package/dist/runtime.d.mts +2 -2
  25. package/dist/runtime.mjs +1 -1
  26. package/dist/session-CQsnVijE.mjs +1 -0
  27. package/dist/terminal-cbye9mKF.mjs +7 -0
  28. package/dist/test-prompter-Ddkt9n5A.mjs +1 -0
  29. package/dist/testkit.d.mts +4 -4
  30. package/dist/testkit.mjs +1 -1
  31. package/dist/version.mjs +1 -1
  32. package/dreamcli.schema.json +15 -1
  33. package/package.json +20 -20
  34. package/skills/cli-creation/SKILL.md +1 -1
  35. package/skills/cli-creation/scripts/scaffold_cli.py +12 -4
  36. package/dist/config-CrlScpYX.mjs +0 -1
  37. package/dist/core-DvXUolc_.mjs +0 -17
  38. package/dist/json-schema-DRlrz_IV.mjs +0 -52
  39. package/dist/package-json-BgE9YjjQ.mjs +0 -3
  40. package/dist/terminal-C8KTXjv5.mjs +0 -6
  41. package/dist/test-prompter-v__jT2yG.mjs +0 -1
@@ -1,17 +0,0 @@
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,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 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=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(`; `)}}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.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),{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`}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=[`kind`,`presence`,`variadic`,`stdin`,`defaultValue`,`defaultDescription`,`sensitive`,`description`,`envVar`,`configPath`,`prompt`,`enumValues`,`elementSchema`,`numberConstraints`,`stringConstraints`,`pathChecks`,`valueHint`,`parseFn`,`separator`,`split`,`duplicateKeys`,`unique`,`standard`,`aggregateStandard`,`deprecated`];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],[`configPath`,void 0],[`prompt`,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'`})}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,...c}=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??!1,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,standard:void 0,aggregateStandard:void 0,deprecated:void 0,...c}}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}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){return new e({...this.schema,envVar:t})}config(t){return new e({...this.schema,configPath:t})}prompt(t){return new e({...this.schema,prompt:t})}sensitive(t=!0){return new e({...this.schema,sensitive:t})}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 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=`kind.presence.defaultValue.defaultDescription.sensitive.aliases.stdin.envVar.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],[`configPath`,void 0],[`description`,void 0],[`elementSchema`,void 0],[`separator`,void 0],[`split`,void 0],[`duplicateKeys`,`last`],[`unique`,!1],[`prompt`,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.sensitive?`sensitive`:e.defaultDescription===void 0?void 0:`defaultDescription`;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`});t.stdin!==void 0&&assertStdinCapableKind(e)}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,sensitive:s,propagate:c,duplicates:l,duplicateKeys:u,...d}=t??{};return{kind:e,presence:i??`optional`,defaultValue:void 0,defaultDescription:void 0,sensitive:s??!1,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:u??`last`,unique:o??!1,pathChecks:void 0,valueHint:void 0,prompt:void 0,parseFn:void 0,standard:void 0,aggregateStandard:void 0,deprecated:void 0,propagate:c??!1,negation:void 0,duplicates:l??`last`,...d,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}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})}alias(t,n){return new e({...this.schema,aliases:[...this.schema.aliases,{name:t,hidden:n?.hidden??!1}]})}env(t){return new e({...this.schema,envVar:t})}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})}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);return}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 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){let t=splitBindingOf(e.separator,e.split),n=[{stage:`cli`,split:t.cli}],r=e.stdin;return r!==void 0&&n.push({stage:`stdin`,when:r.when,consume:r.consume,trim:r.trim,split:t.stdin}),e.envVar!==void 0&&n.push({stage:`env`,envVar:e.envVar,split:t.env}),e.configPath!==void 0&&n.push({stage:`config`,configPath:e.configPath,split:t.env}),e.prompt!==void 0&&n.push({stage:`prompt`,prompt:e.prompt,split:t.env}),e.defaultValue!==void 0&&n.push({stage:`default`,defaultValue:e.defaultValue}),n}function stdinBindingOf(e){for(let t of e)if(t.stage===`stdin`)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=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=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){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 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=createFlagSchema(i);validateFlagStdinEntry(e.name,r,t,n,[]),n[r]=t}let r=[];for(let t of e.args??[]){let i=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,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 createCommandSchema(e){let t=buildCommandSchema(e);return validateCommandFlagTree(t),t}function validateArgEntry(e,t,n,r,i){assertUsableArgKey(e,t),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=>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){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=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=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)}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){if(assertUsableFlagKey(this.schema.name,t),Object.hasOwn(this.schema.flags,t))throw new CLIError(`Command '${this.schema.name}' already defines flag --${t}`,{code:`FLAG_NAME_COLLISION`,details:{command:this.schema.name,flag:t,surface:t,surfaceKind:`canonical`}});validateFlagStdinEntry(this.schema.name,t,n.schema,this.schema.flags,this.schema.args);let r={...this.schema.flags,[t]:n.schema},i={...this.schema,flags:r,hasAction:!1};return validateCommandFlagTree(i),new e(i,void 0,this._subcommands,this._executionSteps)}arg(t,n){validateArgEntry(this.schema.name,t,n.schema,this.schema.flags,this.schema.args);let r={name:t,schema:n.schema},i=[...this.schema.args,r];return new e({...this.schema,args:i,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 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,isDefaultHelp:e?.isDefaultHelp??!1,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 formatFlagLeft(e,t,n){let r=getFlagAliasNames(t,{kind:`short`}),i=getFlagAliasNames(t,{kind:`long`}),a=t.negation!==void 0&&!t.negation.hidden?t.negation:void 0,o=a!==void 0&&a.alias===void 0?`--[no-]${e}`:`--${e}`,s=[...r.map(e=>`-${e}`),o,...i.map(e=>`--${e}`),...a?.alias===void 0?[]:[`--${a.alias}`]];return t.kind!==`boolean`&&t.kind!==`count`?`${n.flag(s.join(`, `))} ${n.placeholder(formatValueHint(t))}`:n.flag(s.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 formatFlagDescription(e,t,n){let r=[];if(e.description!==void 0&&r.push(resolveHelpDescription(e.description,n)),e.deprecated!==void 0&&r.push(t.deprecated(formatDeprecated(e.deprecated))),e.stdin!==void 0&&r.push(t.annotation(formatStdinAnnotation(e.stdin))),e.envVar!==void 0&&r.push(t.annotation(`[env: ${e.envVar}]`)),e.configPath!==void 0&&r.push(t.annotation(`[config: ${e.configPath}]`)),e.prompt!==void 0&&r.push(t.annotation(`[prompt]`)),e.presence===`required`&&e.defaultValue===void 0)r.push(t.annotation(`[required]`));else{let n=formatDefaultAnnotation(e,t,e.kind===`boolean`||e.kind===`count`);n!==void 0&&r.push(n)}return r.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=[];for(let i of orderFlagNames(n,e,t)){let n=e[i];n!==void 0&&r.push({left:formatFlagLeft(i,n,t.theme),description:formatFlagDescription(n,t.theme,t.descriptionTheme)})}return r}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){let r=[];e.description!==void 0&&r.push(resolveHelpDescription(e.description,n)),e.deprecated!==void 0&&r.push(t.deprecated(formatDeprecated(e.deprecated))),e.stdin!==void 0&&r.push(t.annotation(formatStdinAnnotation(e.stdin))),e.envVar!==void 0&&r.push(t.annotation(`[env: ${e.envVar}]`)),e.configPath!==void 0&&r.push(t.annotation(`[config: ${e.configPath}]`)),e.prompt!==void 0&&r.push(t.annotation(`[prompt]`));let i=formatDefaultAnnotation(e,t,!1);return i!==void 0&&r.push(i),r.join(` `)}function formatHelpSections(e,t){let n=resolveOptions$1(t),r=[];r.push(formatUsageLine(e,n)),e.description!==void 0&&r.push(e.description);let i=e.commands.filter(e=>!e.hidden);if(i.length>0&&r.push(formatCommandsSection(i,n)),e.args.length>0&&r.push(formatArgsSection(e.args,n)),Object.keys(e.flags).length>0&&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(`
5
-
6
- `)}\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.keys(e.flags).length>0&&r.push(n.placeholder(`[flags]`));for(let i of e.args)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);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(`
7
- `)}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(`
8
- `)}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(`
9
- `)}const EXAMPLE_TOKEN=/(?:'[^']*'|"[^"]*"|\S)+/g;function highlightExampleCommand(e,t){let n=0;return e.replace(EXAMPLE_TOKEN,e=>{let r=n===0?t.usageBin(e):e.startsWith(`-`)?t.flag(e):e;return n+=1,r})}function formatExamplesSection(e,t,n){let r=[t.sectionTitle(`Examples:`)],i=t.examplePrompt(`$`);for(let a of e){let e=highlightExampleCommand(resolveExampleCommand(a.command,n),t);a.description===void 0?r.push(` ${i} ${e}`):(r.push(` ${a.description}:`),r.push(` ${i} ${e}`))}return r.join(`
10
- `)}function bindMethods(e){let t=e,n=new Set,r=Object.getPrototypeOf(e);for(;r!==null&&r!==Object.prototype;){for(let i of Object.getOwnPropertyNames(r)){if(i===`constructor`||n.has(i))continue;n.add(i);let a=Object.getOwnPropertyDescriptor(r,i);a!==void 0&&typeof a.value==`function`&&Object.defineProperty(t,i,{value:a.value.bind(e),writable:!0,enumerable:!1,configurable:!0})}r=Object.getPrototypeOf(r)}}function writeLine(e,t){e(`${t}\n`)}const noopSpinnerHandle={update(){},succeed(){},fail(){},stop(){},wrap(e){return e}},noopProgressHandle={increment(){},update(){},done(){},fail(){}};var StaticSpinnerHandle=class{write;stopped=!1;constructor(e,t){this.write=t,writeLine(t,e),bindMethods(this)}update(e){}succeed(e){this.stopped||(this.stopped=!0,e!==void 0&&writeLine(this.write,e))}fail(e){this.stopped||(this.stopped=!0,e!==void 0&&writeLine(this.write,e))}stop(){this.stopped||=!0}async wrap(e,t){try{let n=await e;return this.succeed(t?.succeed),n}catch(e){throw this.fail(t?.fail),e}}},StaticProgressHandle=class{write;stopped=!1;constructor(e,t){this.write=t,e!==void 0&&writeLine(t,e),bindMethods(this)}increment(e){}update(e){}done(e){this.stopped||(this.stopped=!0,e!==void 0&&writeLine(this.write,e))}fail(e){this.stopped||(this.stopped=!0,e!==void 0&&writeLine(this.write,e))}};const HIDE_CURSOR=`\x1B[?25l`,SHOW_CURSOR=`\x1B[?25h`,ERASE_LINE=`\x1B[2K`,SPINNER_FRAMES=[`⠋`,`⠙`,`⠹`,`⠸`,`⠼`,`⠴`,`⠦`,`⠧`,`⠇`,`⠏`];var TTYSpinnerHandle=class{write;stopped=!1;timer;frameIndex=0;text;constructor(e,t){this.write=t,this.text=e,t(HIDE_CURSOR),this.render(),this.timer=setInterval(()=>{this.frameIndex=(this.frameIndex+1)%SPINNER_FRAMES.length,this.render()},80),bindMethods(this)}render(){let e=SPINNER_FRAMES[this.frameIndex]??SPINNER_FRAMES[0];this.write(`\r${ERASE_LINE}${e} ${this.text}`)}cleanup(){this.timer!==void 0&&(clearInterval(this.timer),this.timer=void 0),this.write(`\r${ERASE_LINE}${SHOW_CURSOR}`)}update(e){this.stopped||(this.text=e,this.render())}succeed(e){this.stopped||(this.stopped=!0,this.cleanup(),e!==void 0&&writeLine(this.write,`✓ ${e}`))}fail(e){this.stopped||(this.stopped=!0,this.cleanup(),e!==void 0&&writeLine(this.write,`✗ ${e}`))}stop(){this.stopped||(this.stopped=!0,this.cleanup())}async wrap(e,t){try{let n=await e;return this.succeed(t?.succeed),n}catch(e){throw this.fail(t?.fail),e}}},TTYProgressHandle=class{write;stopped=!1;timer;current=0;total;label;pulsePos=0;pulseDir=1;constructor(e,t){this.write=t,this.total=e.total,this.label=e.label??``,t(HIDE_CURSOR),this.render(),this.total===void 0&&(this.timer=setInterval(()=>{this.advancePulse(),this.render()},80)),bindMethods(this)}advancePulse(){this.pulsePos+=this.pulseDir,this.pulsePos+3>20?(this.pulseDir=-1,this.pulsePos=17):this.pulsePos<0&&(this.pulseDir=1,this.pulsePos=0)}render(){let e=this.total===void 0?this.renderIndeterminate():this.renderDeterminate(this.total),t=this.label.length>0?` ${this.label}`:``;this.write(`\r${ERASE_LINE}${e}${t}`)}renderDeterminate(e){let t=e>0?Math.max(0,Math.min(this.current/e,1)):0,n=Math.round(t*20),r=20-n,i=Math.round(t*100);return`[${`█`.repeat(n)}${`░`.repeat(r)}] ${String(i)}%`}renderIndeterminate(){let e=``;for(let t=0;t<20;t++)e+=t>=this.pulsePos&&t<this.pulsePos+3?`█`:`░`;return`[${e}]`}cleanup(){this.timer!==void 0&&(clearInterval(this.timer),this.timer=void 0),this.write(`\r${ERASE_LINE}${SHOW_CURSOR}`)}increment(e){this.stopped||(this.current+=e??1,this.render())}update(e){this.stopped||(this.current=e,this.render())}done(e){this.stopped||(this.stopped=!0,this.cleanup(),e!==void 0&&writeLine(this.write,`✓ ${e}`))}fail(e){this.stopped||(this.stopped=!0,this.cleanup(),e!==void 0&&writeLine(this.write,`✗ ${e}`))}},CaptureSpinnerHandle=class{events;stopped=!1;constructor(e,t){this.events=t,t.push({type:`spinner:start`,text:e}),bindMethods(this)}update(e){this.stopped||this.events.push({type:`spinner:update`,text:e})}succeed(e){this.stopped||(this.stopped=!0,this.events.push({type:`spinner:succeed`,text:e??``}))}fail(e){this.stopped||(this.stopped=!0,this.events.push({type:`spinner:fail`,text:e??``}))}stop(){this.stopped||(this.stopped=!0,this.events.push({type:`spinner:stop`}))}async wrap(e,t){try{let n=await e;return this.succeed(t?.succeed),n}catch(e){throw this.fail(t?.fail),e}}},CaptureProgressHandle=class{events;stopped=!1;constructor(e,t){this.events=t,t.push({type:`progress:start`,label:e.label??``,total:e.total}),bindMethods(this)}increment(e){this.stopped||this.events.push({type:`progress:increment`,delta:e??1})}update(e){this.stopped||this.events.push({type:`progress:update`,value:e})}done(e){this.stopped||(this.stopped=!0,this.events.push({type:`progress:done`,text:e}))}fail(e){this.stopped||(this.stopped=!0,this.events.push({type:`progress:fail`,text:e}))}};function resolveOutputPolicy(e){return{jsonMode:e.jsonMode,isTTY:e.isTTY,verbosity:e.verbosity}}function resolveTextStream(e){return e.jsonMode?`stderr`:`stdout`}function shouldEmitInfo(e){return e.verbosity!==`quiet`}function resolveTableFormat(e,t){switch(t?.format){case`json`:return`json`;case`text`:return`text`;case`auto`:case void 0:return e.jsonMode?`json`:`text`}}function resolveTableTextStream(e,t){return t?.format===`text`&&`stream`in t&&t.stream!==void 0?t.stream:resolveTextStream(e)}function resolveActivityRenderMode(e,t){return e.jsonMode||e.verbosity===`quiet`?`noop`:e.isTTY?`tty`:t===`static`?`static`:`noop`}function resolveSpinnerPolicy(e,t){let n=resolveActivityRenderMode(e,t);return{mode:n,stream:`stderr`,cleanup:n===`noop`?`none`:`stop`}}function resolveProgressPolicy(e,t){let n=resolveActivityRenderMode(e,t);return{mode:n,stream:`stderr`,cleanup:n===`noop`?`none`:`done`}}function resolveWriterForStream(e,t){return t===`stderr`?e.stderr:e.stdout}function createSpinnerHandleFromPolicy(e,t,n){if(e.mode===`noop`)return{handle:noopSpinnerHandle,cleanup:void 0};if(e.mode===`tty`){let e=new TTYSpinnerHandle(t,n);return{handle:e,cleanup:()=>e.stop()}}let r=new StaticSpinnerHandle(t,n);return{handle:r,cleanup:()=>r.stop()}}function createProgressHandleFromPolicy(e,t,n){if(e.mode===`noop`)return{handle:noopProgressHandle,cleanup:void 0};if(e.mode===`tty`){let e=new TTYProgressHandle(t,n);return{handle:e,cleanup:()=>e.done()}}let r=new StaticProgressHandle(t.label,n);return{handle:r,cleanup:()=>r.done()}}const noopWrite$1=()=>{},requestedExitCodes=new WeakMap;function validateExitCode(e){if(!Number.isInteger(e)||e<0||e>255)throw RangeError(`Exit code must be an integer from 0 to 255`);return e}function setRequestedExitCode(e,t){requestedExitCodes.set(e,validateExitCode(t))}function getRequestedExitCode(e){return requestedExitCodes.get(e)}function clearRequestedExitCode(e){requestedExitCodes.delete(e)}function resolveHyperlinkOverride(e,t){let n=t.indexOf(`--`),r=n===-1?t:t.slice(0,n);if(r.includes(`--no-hyperlinks`))return!1;if(r.includes(`--hyperlinks`))return!0;if(e.NO_HYPERLINKS)return!1;if(e.FORCE_HYPERLINKS)return!0}function resolveOptions(e){let t=e?.isTTY??!1,n=e?.jsonMode??!1;return{stdout:e?.stdout??noopWrite$1,stderr:e?.stderr??noopWrite$1,isTTY:t,verbosity:e?.verbosity??`normal`,jsonMode:n,color:e?.color??(t&&!n&&isColorSupported),isHyperlinkSupported:e?.hyperlinks??t}}var OutputChannel=class{options;policy;jsonMode;verbosity;isTTY;color;isHyperlinkSupported;constructor(e){this.options=e,this.policy=resolveOutputPolicy(e),this.jsonMode=e.jsonMode,this.verbosity=this.policy.verbosity,this.isTTY=e.isTTY,this.color=createColors(e.color),this.isHyperlinkSupported=e.isHyperlinkSupported,bindMethods(this)}log(e){writeLine(resolveWriterForStream(this.options,resolveTextStream(this.policy)),e)}info(e){shouldEmitInfo(this.policy)&&writeLine(resolveWriterForStream(this.options,resolveTextStream(this.policy)),e)}status(e){shouldEmitInfo(this.policy)&&writeLine(this.options.stderr,e)}warn(e){writeLine(this.options.stderr,e)}error(e){writeLine(this.options.stderr,e)}setExitCode(e){setRequestedExitCode(this,e)}json(e){writeLine(this.options.stdout,JSON.stringify(e))}table(e,t,n){let{columns:r,options:i}=resolveTableArgs(t,n),a=resolveTableFormat(this.policy,i),o=r??inferColumns(e);if(a===`json`){this.json(projectTableRows(e,o));return}let s=formatTable(e,o);s.length!==0&&writeLine(resolveTextTableWriter(this.options,this.policy,a,i),s)}activeCleanup;stopActive(){this.activeCleanup!==void 0&&(this.activeCleanup(),this.activeCleanup=void 0)}spinner(e,t){let n=createSpinnerHandleFromPolicy(resolveSpinnerPolicy(this.policy,t?.fallback??`silent`),e,this.options.stderr);return n.cleanup===void 0?n.handle:(this.stopActive(),this.activeCleanup=n.cleanup,n.handle)}progress(e){let t=createProgressHandleFromPolicy(resolveProgressPolicy(this.policy,e.fallback??`silent`),e,this.options.stderr);return t.cleanup===void 0?t.handle:(this.stopActive(),this.activeCleanup=t.cleanup,t.handle)}},CaptureOutputChannel=class extends OutputChannel{activity;constructor(e,t){super(e),this.activity=t}spinner(e,t){return new CaptureSpinnerHandle(e,this.activity)}progress(e){return new CaptureProgressHandle(e,this.activity)}};function inferColumns(e){let t=e[0];return t===void 0?[]:Object.keys(t).map(e=>({key:e}))}function isTableColumns(e){return Array.isArray(e)}function resolveTableArgs(e,t){return t===void 0?isTableColumns(e)?{columns:e,options:t}:{columns:void 0,options:e}:{columns:isTableColumns(e)?e:void 0,options:t}}function cellKeyHolder(e,t){for(let n=e;n!==null;n=Object.getPrototypeOf(n))if(Object.hasOwn(n,t))return n;return null}function cellValue(e,t){let n=cellKeyHolder(e,t);return n===null||n===Object.prototype?void 0:e[t]}function projectTableRows(e,t){return e.map(e=>Object.fromEntries(t.map(t=>[t.key,cellValue(e,t.key)])))}function resolveTextTableWriter(e,t,n,r){return n===`json`?e.stdout:resolveWriterForStream(e,resolveTableTextStream(t,r))}function cellToString(e){return formatDisplayValue(e)}function formatTable(e,t){if(e.length===0||t.length===0)return``;let n=t.map(e=>e.header??e.key),r=e.map(e=>t.map(t=>cellToString(cellValue(e,t.key)))),i=n.map((e,t)=>{let n=e.length;for(let e of r){let r=e[t];r!==void 0&&r.length>n&&(n=r.length)}return n});return[n.map((e,t)=>e.padEnd(i[t]??0)).join(` `),i.map(e=>`-`.repeat(e)).join(` `),...r.map(e=>e.map((e,t)=>e.padEnd(i[t]??0)).join(` `))].join(`
11
- `)}function createOutput(e){return new OutputChannel(resolveOptions(e))}function createCaptureOutput(e){let t={stdout:[],stderr:[],activity:[]};return[new CaptureOutputChannel(resolveOptions({...e,stdout:e=>t.stdout.push(e),stderr:e=>t.stderr.push(e)}),t.activity),t]}function formatDiagnosticValue(e){if(typeof e==`string`)return e;try{let t=JSON.stringify(e);if(t!==void 0)return t}catch{}try{return String(e)}catch{return`<unprintable>`}}function diagnosticValue(e,t){return e?{kind:`redacted`,text:`<redacted>`}:{kind:`visible`,value:t,text:formatDiagnosticValue(t)}}function middleware(e){return{_handler:e}}function wasExplicit(e){return e!==void 0&&e.stage!=="default"}const STDIN_OCCURRENCE={kind:`stdin`},NEGATED_OCCURRENCE={kind:`negated`},INCREMENT_OCCURRENCE={kind:`increment`};function occurrenceValue(e){switch(e.kind){case`value`:return e.value;case`entry`:return[e.key,e.value];case`stdin`:return`-`;case`negated`:return!1;case`increment`:return 1;case`aggregated`:return e.value}}function projectOccurrences(e,t){if(e.kind===`count`)return projectCount(t);if(e.kind===`one`){let e=t[t.length-1];return e===void 0?void 0:occurrenceValue(e)}return t.map(occurrenceValue)}function projectCount(e){let t;for(let n of e)t=n.kind===`increment`?(typeof t==`number`?t:0)+1:occurrenceValue(n);return t}function liftOccurrences(e,t,n){return Array.isArray(t)?t.map(t=>liftElement(e,t,n)):[{kind:`aggregated`,value:t}]}function liftElement(e,t,n){if(n&&t===`-`)return STDIN_OCCURRENCE;if(e.kind===`entries`){let e=entryPairOf(t);if(e!==void 0)return{kind:`entry`,key:e[0],value:e[1]}}return{kind:`value`,value:t}}function entryPairOf(e){if(!Array.isArray(e)||e.length!==2)return;let t=e[0],n=e[1];return typeof t==`string`?[t,n]:void 0}function readAggregated(e){let t=e.length===1?e[0]:void 0;return t?.kind===`aggregated`?{value:t.value}:void 0}function entryPairsOf(e){let t=[];for(let n of e)n.kind===`entry`&&t.push([n.key,n.value]);return t}function tokenize(e){let t=[],n=!1;for(let r of e){if(n){t.push({kind:`positional`,value:r});continue}if(r===`--`){t.push({kind:`separator`}),n=!0;continue}if(r.startsWith(`--`)){let e=r.indexOf(`=`);e===-1?t.push({kind:`long-flag`,name:r.slice(2),value:void 0}):t.push({kind:`long-flag`,name:r.slice(2,e),value:r.slice(e+1)});continue}if(r.startsWith(`-`)&&r.length>1){t.push({kind:`short-flags`,chars:r.slice(1)});continue}t.push({kind:`positional`,value:r})}return t}function includesBeforeSeparator(e,t){for(let n of e){if(n===`--`)return!1;if(n===t)return!0}return!1}function requestsHelp(e){return includesBeforeSeparator(e,`--help`)||includesBeforeSeparator(e,`-h`)}function stripBeforeSeparator(e,t){let n=e.indexOf(`--`),r=n===-1?e:e.slice(0,n);if(!r.includes(t))return e;let i=r.filter(e=>e!==t);return n===-1?i:[...i,...e.slice(n)]}function kebabToCamel(e){return e.replace(/-+([a-z0-9])/g,(e,t)=>t.toUpperCase())}function camelToKebab(e){return e.replace(/([a-z0-9])([A-Z])/g,`$1-$2`).toLowerCase()}function counterpartSpelling(e){if(e.length<2)return;if(e.includes(`-`)){let t=kebabToCamel(e);return t===e?void 0:t}let t=camelToKebab(e);return t===e?void 0:t}function buildFlagLookup(e,t){let n=new Map;for(let[t,r]of Object.entries(e)){n.set(t,{name:t,schema:r,negated:!1,parity:!1});for(let e of getFlagAliasNames(r,{includeHidden:!0}))n.set(e,{name:t,schema:r,negated:!1,parity:!1});let e=getFlagNegatedName(t,r);e!==void 0&&n.set(e,{name:t,schema:r,negated:!0,parity:!1})}if(t?.caseParity!==!1){let e=[...n];for(let[t,r]of e){let e=counterpartSpelling(t);e!==void 0&&!n.has(e)&&n.set(e,{...r,parity:!0})}}return n}function occurrencesOf(e,t,n){let r=e.get(t);if(r!==void 0)return r;let i={schema:n,occurrences:[],counted:0};return e.set(t,i),i}function recordFlagOccurrence(e,t,n,r,i,a){let o=occurrencesOf(e,t,n);if(o.counted+=1,o.counted>1&&n.duplicates===`error`){let e=diagnosticValue(n.sensitive,[...o.occurrences.filter(e=>e.policed).map(e=>e.reported),r]);throw new ParseError(`Flag --${t} may only be specified once`,{code:`DUPLICATE_FLAG`,details:{flag:t,input:i,count:o.counted,...e.kind===`visible`?{values:e.value}:{}}})}o.counted>1&&n.duplicates===`first`||o.occurrences.push({policed:!0,reported:r,items:a()})}function recordCountIncrement(e,t,n){occurrencesOf(e,t,n).occurrences.push({policed:!1,reported:void 0,items:[INCREMENT_OCCURRENCE]})}function projectFlags(e){let t={};for(let[n,r]of e)t[n]=projectOccurrences(flagCardinality(r.schema),r.occurrences.flatMap(e=>e.items));return t}function flagExpectsValue(e){return e.kind!==`boolean`&&e.kind!==`count`}function isStdinSentinel(e,t){return e===`-`&&t!==void 0&&stdinReadsOnDash(t)}function coerceFlagValue(e,t,n,r=`--${e}`){return occurrenceValue(flagTokenOccurrence(e,t,n,r))}function flagTokenOccurrence(e,t,n,r){if(isStdinSentinel(t,n.stdin))return STDIN_OCCURRENCE;let i=flagCardinality(n);if(i.kind===`count`)return{kind:`value`,value:coerceCountToken(e,t,r,n.sensitive)};if(i.kind===`entries`){let[i,a]=coerceEntryToken(e,t,n,r);return{kind:`entry`,key:i,value:a}}return{kind:`value`,value:coerceElementToken(e,t,n,r)}}function coerceElementToken(e,t,n,r){let i=decodeValue(flagValueSchema(n),t,`token`);if(i.ok)return i.value;throw flagValueError(e,r,t,i.failure,n.sensitive)}function coerceCountToken(e,t,n,r){let i=t.trim()===``?NaN:Number(t);if(!Number.isInteger(i)||i<0){let i=diagnosticValue(r,t);throw new ParseError(`Invalid count value '${i.text}' for flag ${n}. Use a non-negative integer`,{code:`INVALID_VALUE`,details:{flag:e,input:n,...i.kind===`visible`?{value:i.value}:{},expected:`count`}})}return i}function coerceEntryToken(e,t,n,r){let i=splitEntryPair(t);if(i===void 0){let i=diagnosticValue(n.sensitive,t);throw new ParseError(`Invalid value '${i.text}' for flag ${r}. Use KEY=VALUE`,{code:`INVALID_VALUE`,details:{flag:e,input:r,...i.kind===`visible`?{value:i.value}:{},expected:`key=value`}})}return[i[0],coerceElementToken(e,i[1],n,r)]}function valueParseError(e,t,n){let r=diagnosticValue(e.sensitive,t),i={...e.details,...r.kind===`visible`?{value:r.value}:{}};switch(n.kind){case`type`:return n.expected===`number`?new ParseError(`Invalid number value '${r.text}' for ${e.label}`,{code:`INVALID_VALUE`,details:{...i,expected:`number`}}):n.expected===`boolean`?new ParseError(`Invalid boolean value '${r.text}' for ${e.label}. Use true/false or 1/0`,{code:`INVALID_VALUE`,details:{...i,expected:`boolean`}}):new ParseError(`Invalid value '${r.text}' for ${e.label}`,{code:`INVALID_VALUE`,details:{...i,expected:`string`}});case`enum`:{let t=n.enumValues;return t===void 0?new ParseError(`${e.enumLabel} is misconfigured: no allowed values declared`,{code:`INVALID_SCHEMA`,details:e.enumDetails}):new ParseError(`Invalid value '${r.text}' for ${e.label}. Allowed: ${t.join(`, `)}`,{code:`INVALID_VALUE`,details:{...i,allowed:t}})}case`string-constraint`:return new ParseError(`Invalid value '${r.text}' for ${e.label}: ${describeStringConstraintViolation(n.violation)}`,{code:`INVALID_VALUE`,details:{...i,expected:`string`,...stringConstraintDetails(n.violation)}});case`number-constraint`:return new ParseError(`Invalid number value '${r.text}' for ${e.label}: ${describeNumberConstraintViolation(n.violation)}`,{code:`INVALID_VALUE`,details:{...i,expected:`number`,constraint:n.violation.kind,...`bound`in n.violation?{bound:n.violation.bound}:{}}});case`thrown`:{if(n.error instanceof ParseError)return e.sensitive?new ParseError(n.error.message,{code:n.error.code,exitCode:n.error.exitCode,details:e.details,...n.error.suggest===void 0?{}:{suggest:n.error.suggest}}):n.error;let t=n.error instanceof Error?n.error.message:String(n.error);return new ParseError(`Failed to parse ${e.label} value '${r.text}': ${t}`,{code:`INVALID_VALUE`,details:i,...r.kind===`visible`?{cause:n.error}:{}})}}}function flagValueError(e,t,n,r,i){return valueParseError({details:{flag:e,input:t},label:`flag ${t}`,enumDetails:{flag:e,kind:`enum`,missing:`enumValues`},enumLabel:`Enum flag --${e}`,sensitive:i},n,r)}function argTokenOccurrence(e,t,n){if(isStdinSentinel(t,n.stdin))return STDIN_OCCURRENCE;if(argCardinality(n).kind===`entries`){let r=splitEntryPair(t);if(r===void 0){let r=diagnosticValue(n.sensitive,t);throw new ParseError(`Invalid value '${r.text}' for argument <${e}>. Use KEY=VALUE`,{code:`INVALID_VALUE`,details:{arg:e,...r.kind===`visible`?{value:r.value}:{},expected:`key=value`}})}return{kind:`entry`,key:r[0],value:decodeArgToken(e,r[1],n)}}return{kind:`value`,value:decodeArgToken(e,t,n)}}function decodeArgToken(e,t,n){let r=decodeValue(argValueSchema(n),t,`token`);if(r.ok)return r.value;throw argValueError(e,t,r.failure,n.sensitive)}function argValueError(e,t,n,r){return valueParseError({details:{arg:e},label:`argument <${e}>`,enumDetails:{arg:e,kind:`enum`,missing:`enumValues`},enumLabel:`Enum argument <${e}>`,sensitive:r},t,n)}function parse(e,t,n){let r=tokenize(t),i=buildFlagLookup(e.flags,n),a=[],o=new Map,s=0;for(;s<r.length;){let e=r[s];if(e===void 0)break;if(e.kind===`separator`){s++;continue}if(e.kind===`positional`){a.push(e.value),s++;continue}if(e.kind===`long-flag`){s=parseLongFlag(e,r,s,i,o);continue}s=parseShortFlags(e,r,s,i,o)}let c=mapPositionals(e.args,a);return{flags:projectFlags(o),args:c}}function parseLongFlag(e,t,n,r,i){let a=r.get(e.name);if(!a){let t=suggestFlag(e.name,r);throw new ParseError(`Unknown flag --${e.name}${t?`. Did you mean --${t}?`:``}`,{code:`UNKNOWN_FLAG`,details:{flag:e.name,...t?{suggestion:t}:{}},...t?{suggest:`--${t}`}:{}})}let{name:o,schema:s,negated:c}=a,l=`--${e.name}`;if(c){if(e.value!==void 0){let t=diagnosticValue(s.sensitive,e.value);throw new ParseError(`Flag ${l} does not take a value`,{code:`INVALID_VALUE`,details:{flag:o,input:e.name,...t.kind===`visible`?{value:t.value}:{}}})}return recordFlagOccurrence(i,o,s,!1,l,()=>[NEGATED_OCCURRENCE]),n+1}if(!flagExpectsValue(s)){if(e.value!==void 0){let t=flagTokenOccurrence(o,e.value,s,l);recordFlagOccurrence(i,o,s,occurrenceValue(t),l,()=>[t])}else s.kind===`count`?recordCountIncrement(i,o,s):recordFlagOccurrence(i,o,s,!0,l,()=>[{kind:`value`,value:!0}]);return n+1}if(e.value!==void 0){let t=e.value;return recordFlagOccurrence(i,o,s,t,l,()=>flagTokenOccurrences(o,s,t,l)),n+1}let u=t[n+1];if(u?.kind!==`positional`)throw new ParseError(`Flag ${l} requires a value`,{code:`MISSING_VALUE`,details:{flag:o,input:e.name,kind:s.kind}});return recordFlagOccurrence(i,o,s,u.value,l,()=>flagTokenOccurrences(o,s,u.value,l)),n+2}function parseShortFlags(e,t,n,r,i){let{chars:a}=e,o=n+1;for(let e=0;e<a.length;e++){let n=a.charAt(e),s=r.get(n);if(!s)throw new ParseError(`Unknown flag -${n}`,{code:`UNKNOWN_FLAG`,details:{flag:n}});let{name:c,schema:l}=s,u=`-${n}`;if(!flagExpectsValue(l)){l.kind===`count`?recordCountIncrement(i,c,l):recordFlagOccurrence(i,c,l,!0,u,()=>[{kind:`value`,value:!0}]);continue}if(e<a.length-1){let t=a.slice(e+1);recordFlagOccurrence(i,c,l,t,u,()=>flagTokenOccurrences(c,l,t,u));break}let d=t[o];if(d?.kind!==`positional`)throw new ParseError(`Flag -${n} requires a value`,{code:`MISSING_VALUE`,details:{flag:c,input:n,kind:l.kind}});recordFlagOccurrence(i,c,l,d.value,u,()=>flagTokenOccurrences(c,l,d.value,u)),o++}return o}function flagTokenOccurrences(e,t,n,r=`--${e}`){let i=flagCardinality(t);return isCollection(i)?splitCliToken(i.cliSplit,n,t).map(n=>flagTokenOccurrence(e,n,t,r)):[flagTokenOccurrence(e,n,t,r)]}function splitCliToken(e,t,n){return isStdinSentinel(t,n.stdin)?[t]:e.format===`delimiter`?t.split(e.delimiter).filter(e=>e.length>0):[t]}const WHOLE_TOKEN={format:`whole`};function cliSplitOf(e){return e.kind===`many`||e.kind===`entries`?e.cliSplit:WHOLE_TOKEN}function mapPositionals(e,t){let n={},r=0;for(let i of e){let e=argCardinality(i.schema),a=cliSplitOf(e);if(i.schema.variadic){let o=t.slice(r).flatMap(e=>splitCliToken(a,e,{stdin:i.schema.stdin}).map(e=>argTokenOccurrence(i.name,e,i.schema)));n[i.name]=projectOccurrences(e,o),r=t.length;break}let o=t[r];if(o!==void 0){let t=splitCliToken(a,o,{stdin:i.schema.stdin}).map(e=>argTokenOccurrence(i.name,e,i.schema));n[i.name]=projectOccurrences(e,t),r++}}if(r<t.length){let n=t.slice(r);throw new ParseError(`Unexpected positional argument${n.length>1?`s`:``}: ${n.join(`, `)}`,{code:`UNEXPECTED_POSITIONAL`,details:{excess:n,expected:e.length}})}return n}function suggestFlag(e,t){let n,r=1/0,i=Math.max(2,Math.floor(e.length/2));for(let[a,o]of t){if(a.length<2||o.parity||o.negated&&o.schema.negation?.hidden===!0)continue;let t=o.schema.aliases.find(e=>e.name===a);if(a!==o.name&&!o.negated&&t?.hidden)continue;let s=levenshtein$1(e,a);s<r&&s<=i&&(r=s,n=a)}return n}function levenshtein$1(e,t){if(e===t)return 0;if(e.length===0)return t.length;if(t.length===0)return e.length;let n=e.length<=t.length?e:t,r=e.length<=t.length?t:e,i=n.length,a=r.length,o=Array.from({length:i+1},(e,t)=>t);for(let e=1;e<=a;e++){let t=o[0]??0;o[0]=e;for(let a=1;a<=i;a++){let i=n.charAt(a-1)===r.charAt(e-1)?0:1,s=Math.min((o[a]??0)+1,(o[a-1]??0)+1,t+i);t=o[a]??0,o[a]=s}}return o[i]??0}function resolvePromptConfig(e,t){if(e.kind===`confirm`||e.kind===`input`)return e;let n=e.choices??t?.map(e=>({value:e}))??[];if(n.length===0)throw Error(`Prompt config (${e.kind}) requires choices but none were provided and no enum values are available`);let r=n;return e.kind===`select`?{kind:`select`,message:e.message,choices:r}:{kind:`multiselect`,message:e.message,choices:r,...e.min===void 0?{}:{min:e.min},...e.max===void 0?{}:{max:e.max}}}function sourceLabel(e){switch(e.kind){case`stdin`:return`from stdin`;case`env`:return`from env ${e.envVar}`;case`config`:return`from config ${e.configPath}`;case`prompt`:return`from prompt`}}function sourceDetails(e){switch(e.kind){case`stdin`:return{source:`stdin`};case`env`:return{source:`env`,envVar:e.envVar};case`config`:return{source:`config`,configPath:e.configPath};case`prompt`:return{source:`prompt`}}}function suggestBySource(e,t){switch(e.kind){case`stdin`:return t.stdin;case`env`:return t.env(e.envVar);case`config`:return t.config(e.configPath);case`prompt`:return t.prompt}}function coercionError(e,t,n,r,i,a,o,s){return new ValidationError(`${a(i.text)} ${sourceLabel(t)} for flag --${e}`,{code:n,details:{flag:e,...sourceDetails(t),...i.kind===`visible`?{value:i.value}:{},expected:r,...s},suggest:o})}function diagnosticSourceOf(e){switch(e.stage){case`stdin`:return{kind:`stdin`};case`env`:return{kind:`env`,envVar:e.envVar};case`config`:return{kind:`config`,configPath:e.configPath};case`prompt`:return{kind:`prompt`}}}function coerceValue(e,t,n,r){let i=diagnosticSourceOf(t),a=flagCardinality(r);if(a.kind===`count`)return coerceCount(e,i,n,r.sensitive);if(a.kind===`one`){let a=flagValueSchema(r);return coerceValueSchema(e,i,trimmedStdinValue(t,n,a),a,r.sensitive)}return coerceCollection(a,i,t.split,n,t=>coerceValueSchema(e,i,t,flagValueSchema(r),r.sensitive),flagCollectionErrors(e,i,r.sensitive),flagAggregationErrors(e,r.sensitive))}function trimmedStdinValue(e,t,n){return e.stage!==`stdin`||!e.trim||typeof t!=`string`?t:keepsStdinTerminator(n)?stripTerminator(t):t}function coerceCount(e,t,n,r){let i=typeof n==`string`?n.trim()===``?NaN:Number(n):n;return typeof i==`number`&&Number.isInteger(i)&&i>=0?{ok:!0,value:i}:{ok:!1,error:coercionError(e,t,`TYPE_MISMATCH`,`count`,diagnosticValue(r,n),e=>`Invalid count value '${e}'`,suggestBySource(t,{stdin:`Pipe a non-negative integer to stdin for --${e}`,env:e=>`Set ${e} to a non-negative integer`,config:e=>`Set ${e} to a non-negative integer in your config`,prompt:`Enter a non-negative integer for --${e}`}))}}function sourceClause(e){return e.kind===`cli`?``:`${sourceLabel(e)} `}function aggregationSourceDetails(e){return e.kind===`cli`?{}:sourceDetails(e)}function duplicateKeyReport(e,t){let n=diagnosticValue(e,t);return n.kind===`visible`?{quoted:`'${n.text}'`,details:{key:n.value},subject:`'${n.text}'`}:{quoted:`'${n.text}'`,details:{},subject:`the repeated key`}}function coerceCollection(e,t,n,r,i,a,o){if(e.kind===`many`){let e=readManyParts(t,r,n);if(!e.ok)return{ok:!1,error:a(e.fault)};let o=[];for(let t of e.parts){let e=i(t);if(!e.ok)return e;o.push(e.value)}return{ok:!0,value:o}}let s=readEntryPairs(r,n);if(!s.ok)return{ok:!1,error:a(s.fault)};let c=[];for(let[e,t]of s.pairs){let n=i(t);if(!n.ok)return n;c.push([e,n.value])}let l=foldEntries(c,e.duplicateKeys);return l.ok?{ok:!0,value:l.value}:{ok:!1,error:o({kind:`duplicate-key`,key:l.duplicateKey},t)}}function splitFault(e,t){switch(e.kind){case`json`:return{kind:`json`,error:e.error,raw:t};case`json-shape`:return{kind:`json-shape`,expected:e.expected,raw:t};case`pair`:return{kind:`pair`,segment:e.raw}}}function readManyParts(e,t,n){if(Array.isArray(t))return{ok:!0,parts:t};if(typeof t!=`string`)return{ok:!1,fault:{kind:`shape`,expected:`array`,raw:t}};let r=splitManyText(n,t);return r.ok?{ok:!0,parts:e.kind===`prompt`?r.parts.map(trimStringPart):r.parts}:{ok:!1,fault:splitFault(r.failure,t)}}function readEntryPairs(e,t){if(isPairList(e))return{ok:!0,pairs:e};if(typeof e==`object`&&e&&!Array.isArray(e))return{ok:!0,pairs:Object.entries(e)};if(typeof e!=`string`)return{ok:!1,fault:{kind:`shape`,expected:`object`,raw:e}};let n=splitEntriesText(t,e);return n.ok?{ok:!0,pairs:n.parts}:{ok:!1,fault:splitFault(n.failure,e)}}function isPairList(e){return Array.isArray(e)&&e.every(e=>Array.isArray(e)&&e.length===2&&typeof e[0]==`string`)}function trimStringPart(e){return typeof e==`string`?e.trim():e}function thrownMessage(e){return e instanceof Error?e.message:String(e)}function flagCollectionErrors(e,t,n){return r=>{switch(r.kind){case`shape`:{let i=r.expected===`array`?`values`:`KEY=VALUE pairs`,a=diagnosticValue(n,r.raw);return coercionError(e,t,`TYPE_MISMATCH`,r.expected,a,e=>`Invalid ${r.expected} value '${e}'`,suggestBySource(t,{stdin:`Pipe ${i} to stdin for --${e}`,env:e=>`Set ${e} to comma-separated ${i}`,config:e=>`Set ${e} to an ${r.expected} in your config`,prompt:`Provide valid ${i} for --${e}`}))}case`pair`:{let i=diagnosticValue(n,r.segment);return new ValidationError(`Invalid key-value pair '${i.text}' ${sourceLabel(t)} for flag --${e}`,{code:`TYPE_MISMATCH`,details:{flag:e,...sourceDetails(t),...i.kind===`visible`?{segment:i.value}:{},expected:`key=value`},suggest:suggestBySource(t,{stdin:`Pipe KEY=VALUE pairs to stdin for --${e}`,env:e=>`Set ${e} to comma-separated KEY=VALUE pairs`,config:e=>`Set ${e} to an object with string values`,prompt:`Use KEY=VALUE for --${e}`})})}case`json`:{let i=diagnosticValue(n,r.raw),a=i.kind===`visible`?thrownMessage(r.error):void 0;return new ValidationError(`Invalid JSON value '${i.text}' ${sourceLabel(t)} for flag --${e}${a===void 0?``:`: ${a}`}`,{code:`TYPE_MISMATCH`,details:{flag:e,...sourceDetails(t),...i.kind===`visible`?{value:i.value,cause:thrownMessage(r.error)}:{},expected:`json`},suggest:`Provide valid JSON for --${e}`})}case`json-shape`:{let i=diagnosticValue(n,r.raw);return new ValidationError(`Invalid JSON value '${i.text}' ${sourceLabel(t)} for flag --${e}, expected an ${r.expected}`,{code:`TYPE_MISMATCH`,details:{flag:e,...sourceDetails(t),...i.kind===`visible`?{value:i.value}:{},expected:r.expected},suggest:`Provide a JSON ${r.expected} for --${e}`})}}}}function flagAggregationErrors(e,t){return(n,r)=>{if(n.kind===`dash-without-stdin`)return new ValidationError(`No piped stdin for the '-' occurrence of flag --${e}`,{code:`MISSING_STDIN`,details:{flag:e,source:`stdin`},suggest:`Pipe a value to stdin, or drop the '-' occurrence of --${e}`});if(n.kind===`shape`){let i=n.expected===`array`?`values`:`KEY=VALUE pairs`,a=diagnosticValue(t,n.raw);return new ValidationError(`Invalid ${n.expected} value '${a.text}' ${sourceClause(r)}for flag --${e}`,{code:`TYPE_MISMATCH`,details:{flag:e,...aggregationSourceDetails(r),...a.kind===`visible`?{value:a.value}:{},expected:n.expected},suggest:`Provide ${i} for --${e}`})}let i=duplicateKeyReport(t,n.key);return new ValidationError(`Duplicate key ${i.quoted} ${sourceClause(r)}for flag --${e}`,{code:`CONSTRAINT_VIOLATED`,details:{flag:e,...aggregationSourceDetails(r),...i.details},suggest:`Set ${i.subject} once for --${e}`})}}function argCollectionErrors(e,t,n){return r=>{switch(r.kind){case`shape`:{let i=diagnosticValue(n,r.raw);return new ValidationError(`Invalid ${r.expected} value '${i.text}' ${argSourceLabel(t)} for argument <${e}>`,{code:`TYPE_MISMATCH`,details:{arg:e,...argSourceDetails(t),...i.kind===`visible`?{value:i.value}:{},expected:r.expected},suggest:r.expected===`object`?`Use KEY=VALUE for <${e}>`:`Provide values for <${e}>`})}case`pair`:{let i=diagnosticValue(n,r.segment);return new ValidationError(`Invalid key-value pair '${i.text}' ${argSourceLabel(t)} for argument <${e}>`,{code:`TYPE_MISMATCH`,details:{arg:e,...argSourceDetails(t),...i.kind===`visible`?{segment:i.value}:{},expected:`key=value`},suggest:`Use KEY=VALUE for <${e}>`})}case`json`:{let i=diagnosticValue(n,r.raw),a=i.kind===`visible`?thrownMessage(r.error):void 0;return new ValidationError(`Invalid JSON value '${i.text}' ${argSourceLabel(t)} for argument <${e}>${a===void 0?``:`: ${a}`}`,{code:`TYPE_MISMATCH`,details:{arg:e,...argSourceDetails(t),...i.kind===`visible`?{value:i.value,cause:thrownMessage(r.error)}:{},expected:`json`},suggest:`Provide valid JSON for <${e}>`})}case`json-shape`:{let i=diagnosticValue(n,r.raw);return new ValidationError(`Invalid JSON value '${i.text}' ${argSourceLabel(t)} for argument <${e}>, expected an ${r.expected}`,{code:`TYPE_MISMATCH`,details:{arg:e,...argSourceDetails(t),...i.kind===`visible`?{value:i.value}:{},expected:r.expected},suggest:`Provide a JSON ${r.expected} for <${e}>`})}}}}function argAggregationErrors(e,t){return(n,r)=>{if(n.kind===`dash-without-stdin`)return new ValidationError(`No piped stdin for the '-' occurrence of argument <${e}>`,{code:`MISSING_STDIN`,details:{arg:e,source:`stdin`},suggest:`Pipe a value to stdin, or drop the '-' from <${e}>`});if(n.kind===`shape`){let i=diagnosticValue(t,n.raw);return new ValidationError(`Invalid ${n.expected} value '${i.text}' ${sourceClause(r)}for argument <${e}>`,{code:`TYPE_MISMATCH`,details:{arg:e,...aggregationSourceDetails(r),...i.kind===`visible`?{value:i.value}:{},expected:n.expected},suggest:`Provide KEY=VALUE pairs for <${e}>`})}let i=duplicateKeyReport(t,n.key);return new ValidationError(`Duplicate key ${i.quoted} ${sourceClause(r)}for argument <${e}>`,{code:`CONSTRAINT_VIOLATED`,details:{arg:e,...aggregationSourceDetails(r),...i.details},suggest:`Set ${i.subject} once for <${e}>`})}}function coerceValueSchema(e,t,n,r,i){let a=decodeValue(r,n,valueInputOf(t));return a.ok?{ok:!0,value:a.value}:{ok:!1,error:valueCoercionError(e,t,n,a.failure,i)}}function valueInputOf(e){return e.kind}function valueCoercionError(e,t,n,r,i){let a=diagnosticValue(i,n);switch(r.kind){case`type`:return typeCoercionError(e,t,r.expected,a);case`enum`:{let n=r.enumValues??[];return new ValidationError(`Invalid value '${a.text}' ${sourceLabel(t)} for flag --${e}. Allowed: ${n.join(`, `)}`,{code:`INVALID_ENUM`,details:{flag:e,...sourceDetails(t),...a.kind===`visible`?{value:a.value}:{},allowed:n},suggest:suggestBySource(t,{stdin:`Pipe one of: ${n.join(`, `)}`,env:e=>`Set ${e} to one of: ${n.join(`, `)}`,config:e=>`Set ${e} to one of: ${n.join(`, `)}`,prompt:`Select one of: ${n.join(`, `)}`})})}case`string-constraint`:return new ValidationError(`Invalid value '${a.text}' ${sourceLabel(t)} for flag --${e}: ${describeStringConstraintViolation(r.violation)}`,{code:`CONSTRAINT_VIOLATED`,details:{flag:e,...sourceDetails(t),...a.kind===`visible`?{value:a.value}:{},expected:`string`,...stringConstraintDetails(r.violation)},suggest:suggestBySource(t,{stdin:`Pipe a valid string to stdin for --${e}`,env:e=>`Set ${e} to a valid string`,config:e=>`Set ${e} to a valid string in your config`,prompt:`Enter a valid value for --${e}`})});case`number-constraint`:return new ValidationError(`Invalid number value '${a.text}' ${sourceLabel(t)} for flag --${e}: ${describeNumberConstraintViolation(r.violation)}`,{code:`CONSTRAINT_VIOLATED`,details:{flag:e,...sourceDetails(t),...a.kind===`visible`?{value:a.value}:{},expected:`number`,constraint:r.violation.kind,...`bound`in r.violation?{bound:r.violation.bound}:{}},suggest:suggestBySource(t,{stdin:`Pipe a valid number to stdin for --${e}`,env:e=>`Set ${e} to a valid number`,config:e=>`Set ${e} to a valid number in your config`,prompt:`Enter a valid number for --${e}`})});case`thrown`:{let n=thrownMessage(r.error);return new ValidationError(`Failed to parse ${suggestBySource(t,{stdin:`stdin`,env:e=>`env ${e}`,config:e=>`config ${e}`,prompt:`prompt`})} for flag --${e} value '${a.text}': ${n}`,{code:`TYPE_MISMATCH`,details:{flag:e,...sourceDetails(t),...a.kind===`visible`?{value:a.value}:{},expected:`custom`},suggest:suggestBySource(t,{stdin:`Pipe a valid value to stdin for --${e}`,env:t=>`Set ${t} to a valid value for --${e}`,config:t=>`Set ${t} to a valid value for --${e} in your config`,prompt:`Enter a valid value for --${e}`})})}}}function typeCoercionError(e,t,n,r){return n===`string`?coercionError(e,t,`TYPE_MISMATCH`,`string`,r,e=>`Invalid string value '${e}'`,suggestBySource(t,{stdin:`Pipe a valid string to stdin for --${e}`,env:e=>`Set ${e} to a valid string`,config:e=>`Set ${e} to a string in your config`,prompt:`Enter a valid string for --${e}`})):n===`number`?coercionError(e,t,`TYPE_MISMATCH`,`number`,r,e=>`Invalid number value '${e}'`,suggestBySource(t,{stdin:`Pipe a valid number to stdin for --${e}`,env:e=>`Set ${e} to a valid number`,config:e=>`Set ${e} to a valid number in your config`,prompt:`Enter a valid number for --${e}`})):coercionError(e,t,`TYPE_MISMATCH`,`boolean`,r,e=>`Invalid boolean value '${e}'`,suggestBySource(t,{stdin:`Pipe true/false, 1/0, or yes/no to stdin for --${e}`,env:e=>`Set ${e} to true/false, 1/0, or yes/no`,config:e=>`Set ${e} to true or false in your config`,prompt:`Answer yes or no for --${e}`}))}function argSourceLabel(e){return sourceLabel(e)}function argSourceDetails(e){return sourceDetails(e)}function buildArgCoercionSuggest(e,t,n){let r=n===`custom`?`value`:n;return suggestBySource(t,{stdin:`Pipe a valid ${r} to stdin for <${e}>`,env:t=>n===`custom`?`Set ${t} to a valid value for <${e}>`:`Set ${t} to a valid ${n}`,config:t=>`Set ${t} to a valid ${r} for <${e}>`,prompt:`Enter a valid ${r} for <${e}>`})}function argBooleanSuggest(e,t){return suggestBySource(t,{stdin:`Pipe true/false, 1/0, or yes/no to stdin for <${e}>`,env:e=>`Set ${e} to true/false, 1/0, or yes/no`,config:e=>`Set ${e} to true or false in your config`,prompt:`Answer yes or no for <${e}>`})}function argValueCoercionError(e,t,n,r,i){let a=`${argSourceLabel(t)} for argument <${e}>`,o=diagnosticValue(i,n);switch(r.kind){case`type`:return argTypeCoercionError(e,t,r.expected,o);case`enum`:{let n=r.enumValues??[],i=n.join(`, `);return new ValidationError(`Invalid value '${o.text}' ${a}. Allowed: ${i}`,{code:`INVALID_ENUM`,details:{arg:e,...argSourceDetails(t),...o.kind===`visible`?{value:o.value}:{},allowed:n},suggest:suggestBySource(t,{stdin:`Provide one of: ${i}`,env:e=>`Set ${e} to one of: ${i}`,config:e=>`Set ${e} to one of: ${i}`,prompt:`Provide one of: ${i}`})})}case`string-constraint`:return new ValidationError(`Invalid value '${o.text}' ${a}: ${describeStringConstraintViolation(r.violation)}`,{code:`CONSTRAINT_VIOLATED`,details:{arg:e,...argSourceDetails(t),...o.kind===`visible`?{value:o.value}:{},expected:`string`,...stringConstraintDetails(r.violation)},suggest:buildArgCoercionSuggest(e,t,`string`)});case`number-constraint`:return new ValidationError(`Invalid number value '${o.text}' ${a}: ${describeNumberConstraintViolation(r.violation)}`,{code:`CONSTRAINT_VIOLATED`,details:{arg:e,...argSourceDetails(t),...o.kind===`visible`?{value:o.value}:{},expected:`number`,constraint:r.violation.kind,...`bound`in r.violation?{bound:r.violation.bound}:{}},suggest:buildArgCoercionSuggest(e,t,`number`)});case`thrown`:{let n=thrownMessage(r.error);return new ValidationError(`Failed to parse ${suggestBySource(t,{stdin:`stdin`,env:e=>`env ${e}`,config:e=>`config ${e}`,prompt:`prompt`})} for argument <${e}> value '${o.text}': ${n}`,{code:`TYPE_MISMATCH`,details:{arg:e,...argSourceDetails(t),...o.kind===`visible`?{value:o.value}:{},expected:`custom`},suggest:buildArgCoercionSuggest(e,t,`custom`)})}}}function argTypeCoercionError(e,t,n,r){let i=`${argSourceLabel(t)} for argument <${e}>`,a={arg:e,...argSourceDetails(t),...r.kind===`visible`?{value:r.value}:{},expected:n};return n===`string`?new ValidationError(`Invalid string value '${r.text}' ${i}`,{code:`TYPE_MISMATCH`,details:a,suggest:buildArgCoercionSuggest(e,t,`string`)}):n===`number`?new ValidationError(`Invalid number value '${r.text}' ${i}`,{code:`TYPE_MISMATCH`,details:a,suggest:buildArgCoercionSuggest(e,t,`number`)}):new ValidationError(`Invalid boolean value '${r.text}' ${i}`,{code:`TYPE_MISMATCH`,details:a,suggest:argBooleanSuggest(e,t)})}function coerceArgValue(e,t,n,r){let i=diagnosticSourceOf(t),a=argCardinality(r);return isCollection(a)?coerceCollection(a,i,t.split,n,t=>coerceArgElement(e,i,t,r),argCollectionErrors(e,i,r.sensitive),argAggregationErrors(e,r.sensitive)):coerceArgElement(e,i,trimmedStdinValue(t,n,argValueSchema(r)),r)}function coerceArgElement(e,t,n,r){let i=decodeValue(argValueSchema(r),n,valueInputOf(t));return i.ok?{ok:!0,value:i.value}:{ok:!1,error:argValueCoercionError(e,t,n,i.failure,r.sensitive)}}function finishCliFlagValue(e,t,n,r,i){let a=flagCardinality(t);return isCollection(a)?spliceCliCollection(a,n,r,i,n=>coerceValueSchema(e,{kind:`stdin`},n,flagValueSchema(t),t.sensitive),flagCollectionErrors(e,{kind:`stdin`},t.sensitive),flagAggregationErrors(e,t.sensitive)):{kind:`value`,value:n,viaStdin:!1}}function finishCliArgValue(e,t,n,r,i){let a=argCardinality(t);return isCollection(a)?spliceCliCollection(a,n,r,i,n=>coerceArgElement(e,{kind:`stdin`},n,t),argCollectionErrors(e,{kind:`stdin`},t.sensitive),argAggregationErrors(e,t.sensitive)):{kind:`value`,value:n,viaStdin:!1}}const CLI_SOURCE={kind:`cli`},STDIN_SOURCE={kind:`stdin`};function spliceCliCollection(e,t,n,r,i,a,o){let s=liftOccurrences(e,t,r!==void 0&&stdinReadsOnDash(r)),c=readAggregated(s);if(c!==void 0)return{kind:`value`,value:c.value,viaStdin:!1};let l=[],u=0,d=!1;for(let t of s){if(t.kind!==`stdin`){l.push({occurrence:t,source:CLI_SOURCE});continue}if(u+=1,r===void 0||typeof n!=`string`)continue;let o=readStdinOccurrence(e,r.split,n,i,a);if(o.kind!==`value`)return o;d=!0;for(let e of o.occurrences)l.push({occurrence:e,source:STDIN_SOURCE})}if(u>0&&typeof n!=`string`)return u===s.length?{kind:`absent`}:{kind:`error`,error:o({kind:`dash-without-stdin`},CLI_SOURCE)};if(e.kind===`many`)return{kind:`value`,value:l.map(e=>occurrenceValue(e.occurrence)),viaStdin:d};let f=[];for(let e of l){if(e.occurrence.kind!==`entry`)return{kind:`error`,error:o({kind:`shape`,expected:`object`,raw:occurrenceValue(e.occurrence)},e.source)};f.push(e)}let p=foldEntries(entryPairsOf(f.map(e=>e.occurrence)),e.duplicateKeys);return p.ok?{kind:`value`,value:p.value,viaStdin:d}:{kind:`error`,error:o({kind:`duplicate-key`,key:p.duplicateKey},f[p.at]?.source??CLI_SOURCE)}}function readStdinOccurrence(e,t,n,r,i){let a={kind:`stdin`};if(e.kind===`many`){let e=readManyParts(a,n,t);if(!e.ok)return{kind:`error`,error:i(e.fault)};let o=[];for(let t of e.parts){let e=r(t);if(!e.ok)return{kind:`error`,error:e.error};o.push({kind:`value`,value:e.value})}return{kind:`value`,occurrences:o}}let o=readEntryPairs(n,t);if(!o.ok)return{kind:`error`,error:i(o.fault)};let s=[];for(let[e,t]of o.pairs){let n=r(t);if(!n.ok)return{kind:`error`,error:n.error};s.push({kind:`entry`,key:e,value:n.value})}return{kind:`value`,occurrences:s}}function isRecord(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function readStringProperty(e,t){let n=Reflect.get(e,t);return typeof n==`string`?n:void 0}function describeIssueSource(e){switch(readStringProperty(e,`source`)){case`stdin`:return{kind:`stdin`,label:`stdin`};case`prompt`:return{kind:`prompt`,label:`prompt`};case`env`:{let t=readStringProperty(e,`envVar`);return t===void 0?void 0:{kind:`env`,label:`env ${t}`}}case`config`:{let t=readStringProperty(e,`configPath`);return t===void 0?void 0:{kind:`config`,label:`config ${t}`}}default:return}}function summarizeValidationError(e){let t=e.details;if(!isRecord(t))return{code:e.code,inputKind:`input`,label:`input`,message:e.message};let n=readStringProperty(t,`flag`);if(n!==void 0){let r=describeIssueSource(t);return{code:e.code,inputKind:`flag`,name:n,label:`flag --${n}`,message:e.message,...r===void 0?{}:{sourceKind:r.kind,sourceLabel:r.label}}}let r=readStringProperty(t,`arg`);if(r!==void 0){let n=describeIssueSource(t);return{code:e.code,inputKind:`arg`,name:r,label:`argument <${r}>`,message:e.message,...n===void 0?{}:{sourceKind:n.kind,sourceLabel:n.label}}}return{code:e.code,inputKind:`input`,label:`input`,message:e.message}}function formatAggregateHeadline(e){let t=e.filter(e=>e.inputKind===`flag`).length,n=e.filter(e=>e.inputKind===`arg`).length,r=e.length-t-n,i=[];return t>0&&i.push(`${t} flag${t===1?``:`s`}`),n>0&&i.push(`${n} arg${n===1?``:`s`}`),r>0&&i.push(`${r} input${r===1?``:`s`}`),i.length===0?`Multiple validation errors (${e.length})`:`Multiple validation errors (${i.join(`, `)})`}function formatAggregateLine(e){let t=e.sourceLabel===void 0?``:` [${e.sourceLabel}]`;return`${e.label}${t}: ${e.message}`}function isNonEmpty(e){return e.length>0}function isValidationErrorJson(e){return!(typeof e!=`object`||!e||!(`code`in e)||!(`message`in e)||!(`exitCode`in e)||typeof e.code!=`string`||typeof e.message!=`string`||typeof e.exitCode!=`number`||`suggest`in e&&e.suggest!==void 0&&typeof e.suggest!=`string`||`details`in e&&e.details!==void 0&&(e.details===null||typeof e.details!=`object`))}function collectValidationErrors(e){let t=e.details?.errors;if(!Array.isArray(t))return[e];let n=[];for(let r of t){if(!isValidationErrorJson(r))return[e];n.push(new ValidationError(r.message,{code:r.code,exitCode:r.exitCode,...r.suggest===void 0?{}:{suggest:r.suggest},...r.details===void 0?{}:{details:r.details}}))}return n}function throwAggregatedErrors(e){if(e.length===1)throw e[0];let t=e.map(summarizeValidationError),n=t.map(formatAggregateLine);throw new ValidationError(`${formatAggregateHeadline(t)}:\n - ${n.join(`
12
- - `)}`,{code:e[0].code,details:{errors:e.map(e=>e.toJSON()),count:e.length,issues:t},suggest:`Fix the listed validation errors and retry`})}function subjectLabel(e){return e.kind===`flag`?`flag --${e.name}`:`argument <${e.name}>`}function subjectReference(e){return e.kind===`flag`?`--${e.name}`:`<${e.name}>`}function subjectDetails(e){return e.kind===`flag`?{flag:e.name}:{arg:e.name}}async function validatePathChecks(e,t,n,r,i,a){let o=subjectLabel(e),s=subjectReference(e),c=subjectDetails(e),l=diagnosticValue(a,t),u;try{u=await r(t)}catch(e){if(l.kind===`redacted`)return new ValidationError(`Failed to inspect path '${l.text}' for ${o}`,{code:`CONSTRAINT_VIOLATED`,details:{...c,constraint:`stat`},suggest:`Provide an accessible path for ${s}`});let t=e instanceof Error?e.message:String(e);return new ValidationError(`Failed to inspect path '${l.text}' for ${o}: ${t}`,{code:`CONSTRAINT_VIOLATED`,details:{...c,value:l.value,constraint:`stat`,cause:t},suggest:`Provide an accessible path for ${s}`,cause:e})}if(u===null){if(n.create&&i!==void 0)try{await i(t);return}catch(e){if(l.kind===`redacted`)return new ValidationError(`Failed to create directory '${l.text}' for ${o}`,{code:`CONSTRAINT_VIOLATED`,details:{...c,constraint:`create`},suggest:`Provide a creatable or existing directory path for ${s}`});let t=e instanceof Error?e.message:String(e);return new ValidationError(`Failed to create directory '${l.text}' for ${o}: ${t}`,{code:`CONSTRAINT_VIOLATED`,details:{...c,value:l.value,constraint:`create`,cause:t},suggest:`Provide a creatable or existing directory path for ${s}`,cause:e})}return n.mustExist?new ValidationError(`Path '${l.text}' for ${o} does not exist`,{code:`CONSTRAINT_VIOLATED`,details:{...c,...l.kind===`visible`?{value:l.value}:{},constraint:`mustExist`},suggest:`Provide an existing path for ${s}`}):void 0}if(n.type!==void 0&&u!==n.type)return new ValidationError(`Path '${l.text}' for ${o} is a ${u}, expected a ${n.type}`,{code:`CONSTRAINT_VIOLATED`,details:{...c,...l.kind===`visible`?{value:l.value}:{},constraint:`pathType`,expected:n.type},suggest:`Provide a ${n.type} path for ${s}`})}function pathValuesOf(e){return typeof e==`string`?[e]:Array.isArray(e)?e.filter(e=>typeof e==`string`):typeof e==`object`&&e?Object.values(e).filter(e=>typeof e==`string`):[]}function resolveConfigPath(e,t){let n=t.split(`.`),r=e;for(let e of n){if(typeof r!=`object`||!r||!Object.hasOwn(r,e))return;r=r[e]}return r}const ABSENT={kind:`absent`};async function runStages(e,t,n){let r=stdinBindingOf(e);for(let i of e){let e=await runStage(i,r,t,n);if(e.kind!==`absent`)return e}return ABSENT}async function runStage(e,t,n,r){switch(e.stage){case`cli`:return cliStage(t,n,r);case`stdin`:return stdinStage(e,n,r);case`env`:return envStage(e,n,r);case`config`:return configStage(e,n,r);case`prompt`:return promptStage(e,n,r);case`default`:return{kind:`value`,value:e.defaultValue,provenance:{stage:`default`}}}}function cliStage(e,t,n){if(t.cli.kind===`dash`){let r=n.stdinData;return e===void 0||typeof r!=`string`?ABSENT:coerced(t,e,r,{stage:`cli`,via:`stdin`,trigger:`dash`})}if(t.cli.kind===`value`){let r=t.finishCli(t.cli.value,n.stdinData,e);return r.kind===`absent`?ABSENT:r.kind===`error`?{kind:`error`,error:r.error}:{kind:`value`,value:r.value,provenance:cliProvenance(r.viaStdin)}}return ABSENT}function cliProvenance(e){return e?{stage:`cli`,via:`stdin`,trigger:`dash`}:{stage:`cli`}}function stdinStage(e,t,n){if(!stdinReadsWhenMissing(e)||t.cli.kind!==`absent`)return ABSENT;let r=n.stdinData;return typeof r==`string`?coerced(t,e,r,{stage:`stdin`,via:`stdin`,trigger:`fallback`}):ABSENT}function envStage(e,t,n){let r=e.envVar,i=Object.hasOwn(n.env,r)?n.env[r]:void 0;return i===void 0?ABSENT:coerced(t,e,i,{stage:`env`,envVar:r})}function configStage(e,t,n){let r=e.configPath,i=resolveConfigPath(n.config,r);return i===void 0?ABSENT:coerced(t,e,i,{stage:`config`,configPath:r})}async function promptStage(e,t,n){if(!n.canPrompt)return ABSENT;let r=await t.runPrompt(e);return r.ok?{kind:`value`,value:r.value,provenance:{stage:`prompt`}}:r.error===void 0?ABSENT:{kind:`error`,error:r.error}}function coerced(e,t,n,r){let i=e.coerce(t,n);return i.ok?{kind:`value`,value:i.value,provenance:r}:{kind:`error`,error:i.error}}function readCliValue(e,t,n){if(!e||t===void 0)return{kind:`absent`};let r=stdinBindingOf(n);return t===`-`&&r!==void 0&&stdinReadsOnDash(r)?{kind:`dash`}:{kind:`value`,value:t}}async function resolveFlags(e,t,n){let r={},i=[],a=new Set,o={env:n.env,config:n.config,stdinData:n.stdinData,canPrompt:n.prompter!==void 0};for(let[s,c]of Object.entries(e)){let e=sourceBindings(c);record(s,c,await runStages(bindingsBeforePrompt(e),stageInput$1(s,c,t,e,n.prompter),o),r,i,a,n)}let s=n.interactive===void 0?void 0:n.interactive({flags:r});for(let[c,l]of Object.entries(e)){if(Object.hasOwn(r,c)||a.has(c))continue;let e=withPromptBinding(l,sourceBindings(l),effectivePromptConfig(c,l,s));if(record(c,l,await runStages(bindingsFromPrompt(e),stageInput$1(c,l,t,e,n.prompter),o),r,i,a,n),!(Object.hasOwn(r,c)||a.has(c))){if(l.kind===`array`&&l.presence!==`required`){r[c]=[],n.provenance[c]={stage:`default`};continue}if(l.kind===`keyValue`&&l.presence!==`required`){r[c]={},n.provenance[c]={stage:`default`};continue}if(l.presence===`required`){let e={flag:c,kind:l.kind};l.envVar!==void 0&&(e.envVar=l.envVar),l.configPath!==void 0&&(e.configPath=l.configPath),i.push(new ValidationError(`Missing required flag --${c}`,{code:`REQUIRED_FLAG`,details:e,suggest:buildRequiredFlagSuggest(c,l)}));continue}r[c]=void 0}}for(let[t,a]of Object.entries(e)){let e=Object.hasOwn(r,t)?r[t]:void 0,o=flagValueSchema(a).pathChecks;if(a.kind===`array`&&a.unique&&Array.isArray(e)&&(r[t]=[...dedupe(e)]),o!==void 0&&n.stat!==void 0)for(let e of pathValuesOf(Object.hasOwn(r,t)?r[t]:void 0)){let r=await validatePathChecks({kind:`flag`,name:t},e,o,n.stat,n.mkdir,a.sensitive);r!==void 0&&i.push(r)}}return isNonEmpty(i)&&throwAggregatedErrors(i),r}function stageInput$1(e,t,n,r,i){let a=Object.hasOwn(n,e);return{cli:readCliValue(a,a?n[e]:void 0,r),coerce:(n,r)=>coerceValue(e,n,r,t),finishCli:(n,r,i)=>finishCliFlagValue(e,t,n,r,i),runPrompt:async n=>i===void 0?{ok:!1,error:void 0}:resolvePromptValueWithConfig(e,t,n,i)}}function record(e,t,n,r,i,a,o){if(n.kind===`error`){i.push(n.error),a.add(e);return}n.kind!==`absent`&&(t.deprecated!==void 0&&n.provenance.stage!=="default"&&o.deprecations.push({kind:`flag`,name:e,message:t.deprecated}),r[e]=n.value,o.provenance[e]=n.provenance)}function effectivePromptConfig(e,t,n){let r=n!==void 0&&Object.hasOwn(n,e)?n[e]:void 0;if(r!==!1)return r==null||r===0||r===``?t.prompt:r}const COMPATIBLE_PROMPT_KINDS={boolean:[`confirm`],string:[`input`,`select`],number:[`input`],enum:[`select`,`input`],array:[`multiselect`],custom:[`input`,`select`,`confirm`,`multiselect`],count:[],keyValue:[]};function promptCompatibilityError(e,t,n,r){let i={...e.details,promptKind:n,allowed:r},a=`Prompt kind '${n}' is not compatible with ${t} ${e.singular} ${e.reference}.`,o=r[0];return o===void 0?new ValidationError(`${a} ${t} ${e.plural} are not promptable`,{code:`CONSTRAINT_VIOLATED`,details:i,suggest:`Remove the prompt config for ${e.reference}`}):new ValidationError(`${a} Use '${o}' instead`,{code:`CONSTRAINT_VIOLATED`,details:i,suggest:`Change the prompt to { kind: '${o}' } for ${e.reference}`})}function validatePromptFlagCompatibility(e,t,n){let r=COMPATIBLE_PROMPT_KINDS[t];if(!r.includes(n))return promptCompatibilityError({reference:`--${e}`,singular:`flag`,plural:`flags`,details:{flag:e,flagKind:t}},t,n,r)}async function resolvePromptValueWithConfig(e,t,n,r){let i=n.prompt,a=validatePromptFlagCompatibility(e,t.kind,i.kind);if(a!==void 0)return{ok:!1,error:a};let o=resolvePromptConfig(i,valueEnumValues(flagValueSchema(t))),s=await r.promptOne(o);return!s.answered||i.kind===`input`&&i.default===void 0&&typeof s.value==`string`&&s.value.trim()===``?{ok:!1,error:void 0}:coerceValue(e,n,s.value,t)}function buildRequiredFlagSuggest(e,t){let n=[],r=t.kind!==`boolean`&&t.kind!==`count`;n.push(`Provide --${e}${r?` <value>`:``}`);let i=t.stdin;if(i!==void 0&&n.push(i.when===`dash`?`pass --${e} - to read stdin`:i.when===`missing`?`pipe a value to stdin`:`pipe a value to stdin or pass --${e} -`),t.envVar!==void 0&&n.push(`set ${t.envVar}`),t.configPath!==void 0&&n.push(`add ${t.configPath} to config`),n.length<=1)return n.join(``);let a=n.slice(0,-1),o=n.slice(-1).join(``);return n.length===2?`${a.join(``)} or ${o}`:`${a.join(`, `)}, or ${o}`}async function resolveArgs(e,t,n){let r={},i=[],a={env:n.env,config:n.config,stdinData:n.stdinData,canPrompt:n.prompter!==void 0};for(let{name:o,schema:s}of e){let e=sourceBindings(s),c=await runStages(e,stageInput(o,s,t,e,n.prompter),a);if(c.kind===`error`){i.push(c.error);continue}if(c.kind===`value`){s.deprecated!==void 0&&c.provenance.stage!=="default"&&n.deprecations.push({kind:`arg`,name:o,message:s.deprecated}),r[o]=c.value,n.provenance[o]=c.provenance;continue}let l=argCardinality(s);if(l.kind===`many`||l.kind===`entries`){if(s.presence===`required`){i.push(new ValidationError(`Missing required argument <${o}>`,{code:`REQUIRED_ARG`,details:{arg:o,...s.variadic?{variadic:!0}:{}},suggest:buildRequiredArgSuggest(o,s,s.variadic)}));continue}r[o]=l.kind===`many`?[]:{},n.provenance[o]={stage:`default`};continue}if(s.presence===`required`){i.push(new ValidationError(`Missing required argument <${o}>`,{code:`REQUIRED_ARG`,details:{arg:o},suggest:buildRequiredArgSuggest(o,s)}));continue}r[o]=void 0}for(let{name:t,schema:n}of e){if(!n.unique)continue;let e=Object.hasOwn(r,t)?r[t]:void 0;Array.isArray(e)&&(r[t]=[...dedupe(e)])}if(n.stat!==void 0)for(let{name:t,schema:a}of e){let e=argValueSchema(a).pathChecks;if(e!==void 0)for(let o of pathValuesOf(Object.hasOwn(r,t)?r[t]:void 0)){let r=await validatePathChecks({kind:`arg`,name:t},o,e,n.stat,n.mkdir,a.sensitive);r!==void 0&&i.push(r)}}return isNonEmpty(i)&&throwAggregatedErrors(i),r}function stageInput(e,t,n,r,i){let a=Object.hasOwn(n,e),o=a?n[e]:void 0;return{cli:argCollectedNothing(t,o)?{kind:`absent`}:readCliValue(a,o,r),coerce:(n,r)=>coerceArgValue(e,n,r,t),finishCli:(n,r,i)=>finishCliArgValue(e,t,n,r,i),runPrompt:async n=>i===void 0?{ok:!1,error:void 0}:resolveArgPromptValue(e,t,n,i)}}function argPromptCompatibility(e){return argCardinality(e).kind===`many`?{allowed:COMPATIBLE_PROMPT_KINDS.array,kindWord:`variadic ${e.kind}`}:{allowed:COMPATIBLE_PROMPT_KINDS[e.kind],kindWord:e.kind}}async function resolveArgPromptValue(e,t,n,r){let i=n.prompt,{allowed:a,kindWord:o}=argPromptCompatibility(t);if(!a.includes(i.kind))return{ok:!1,error:promptCompatibilityError({reference:`<${e}>`,singular:`argument`,plural:`arguments`,details:{arg:e,argKind:t.kind}},o,i.kind,a)};let s=resolvePromptConfig(i,valueEnumValues(argValueSchema(t))),c=await r.promptOne(s);return!c.answered||i.kind===`input`&&i.default===void 0&&typeof c.value==`string`&&c.value.trim()===``?{ok:!1,error:void 0}:coerceArgValue(e,n,c.value,t)}function buildRequiredArgSuggest(e,t,n){let r=[n?`Provide at least one value for <${e}>`:`Provide a value for <${e}>`],i=t.stdin;return i!==void 0&&r.push(i.when===`dash`?`pass '-' to read stdin`:i.when===`missing`?`pipe a value to stdin`:`pipe a value to stdin or pass '-'`),t.envVar!==void 0&&r.push(`set ${t.envVar}`),t.configPath!==void 0&&r.push(`add ${t.configPath} to config`),r.length===1?r[0]:r.length===2?`${r[0]} or ${r[1]}`:`${r.slice(0,-1).join(`, `)}, or ${r[r.length-1]}`}function formatIssuePath(e,t){if(!(t||e===void 0||e.length===0))return e.map(e=>{let t=typeof e==`object`?e.key:e;return typeof t==`number`?String(t):diagnosticValue(!1,t).text}).join(`.`)}function issuesMessage(e,t,n){return`${e} failed validation: ${t.map(e=>{let t=formatIssuePath(e.path,n);return t===void 0?e.message:`${t}: ${e.message}`}).join(`; `)}`}async function validateValue(e,t,n,r){let i;try{i=await n[`~standard`].validate(t)}catch(n){let i=n instanceof Error?n.message:String(n),a=diagnosticValue(r,t);return{ok:!1,error:new ValidationError(`${e} validator threw: ${i}`,{code:`CONSTRAINT_VIOLATED`,...a.kind===`visible`?{details:{value:a.value,cause:i}}:{},suggest:`Fix the validator for ${e}, or provide a value it can process`})}}if(i.issues!==void 0){let n=diagnosticValue(r,t);return{ok:!1,error:new ValidationError(issuesMessage(e,i.issues,r),{code:`CONSTRAINT_VIOLATED`,details:{...n.kind===`visible`?{value:n.value}:{},issues:i.issues.map(e=>e.message)},suggest:`Provide a value for ${e} that satisfies its validator`})}}return{ok:!0,value:i.value}}function resolvedValue(e,t){return Object.hasOwn(e,t)?e[t]:void 0}async function applyStandardValidators(e,t,n){let r=[],i={...t};for(let[n,a]of Object.entries(e.flags)){let e=resolvedValue(t,n);if(e===void 0)continue;let o=await validateInput(`--${n}`,e,isCollection(flagCardinality(a)),flagValueSchema(a).standard,flagAggregateStandard(a),r,a.sensitive);o.changed&&(i[n]=o.value)}let a={...n};for(let t of e.args){let e=resolvedValue(n,t.name);if(e===void 0)continue;let i=await validateInput(`<${t.name}>`,e,isCollection(argCardinality(t.schema)),argValueSchema(t.schema).standard,argAggregateStandard(t.schema),r,t.schema.sensitive);i.changed&&(a[t.name]=i.value)}return{flags:i,args:a,errors:r}}async function validateInput(e,t,n,r,i,a,o){let s=t,c=!1,l=a.length;if(r!==void 0){let t=n?await validateElements(e,s,r,a,o):await validateOne(e,s,r,a,o);s=t.value,c||=t.changed}if(i!==void 0&&a.length===l){let t=await validateValue(e,s,i,o);t.ok?(s=t.value,c=!0):a.push(t.error)}return{changed:c,value:s}}async function validateElements(e,t,n,r,i){if(Array.isArray(t)){let a=[];for(let[o,s]of t.entries()){let t=await validateValue(`${e}[${o}]`,s,n,i);t.ok?a.push(t.value):(a.push(s),r.push(t.error))}return{changed:!0,value:a}}if(isPlainRecord(t)){let a=new Map;for(let[o,s]of Object.entries(t)){let t=await validateValue(i?e:`${e}.${diagnosticValue(!1,o).text}`,s,n,i);a.set(o,t.ok?t.value:s),t.ok||r.push(t.error)}return{changed:!0,value:Object.fromEntries(a)}}return validateOne(e,t,n,r,i)}async function validateOne(e,t,n,r,i){let a=await validateValue(e,t,n,i);return a.ok?{changed:!0,value:a.value}:(r.push(a.error),{changed:!1,value:t})}function isPlainRecord(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=Object.getPrototypeOf(e);return t===Object.prototype||t===null}async function resolve(e,t,n){let r=[],i=provenanceRecord(),a=provenanceRecord(),o={env:n?.env??{},config:n?.config??{},stdinData:n?.stdinData,prompter:n?.prompter,deprecations:r,stat:n?.stat,mkdir:n?.mkdir},s={},c={},l=[];try{s=await resolveFlags(e.flags,t.flags,{...o,interactive:e.interactive,provenance:i})}catch(e){if(!isValidationError(e))throw e;l.push(...collectValidationErrors(e))}try{c=await resolveArgs(e.args,t.args,{...o,provenance:a})}catch(e){if(!isValidationError(e))throw e;l.push(...collectValidationErrors(e))}let u=await applyStandardValidators(e,s,c);return s=u.flags,c=u.args,l.push(...u.errors),isNonEmpty(l)&&throwAggregatedErrors(l),{flags:s,args:c,deprecations:r,provenance:{flags:i,args:a}}}function provenanceRecord(){return Object.create(null)}async function executeCommand(e){let{argv:t,command:n,meta:r,options:i,out:a,schema:o}=e;clearRequestedExitCode(a);try{if(builtinEnabled(i?.builtins,`help`)&&requestsHelp(t)){if(a.jsonMode||i?.jsonMode===!0){let{generateCommandSchema:e}=await import(`./json-schema-DRlrz_IV.mjs`).then(e=>e.a);return a.json(e(o,void 0,{name:i?.help?.binName??o.name,version:i?.help?.version})),{exitCode:0,error:void 0}}let e=formatHelp(o,i?.help?.colors===void 0?{...i?.help,colors:a.color}:i.help);return a.log(e),{exitCode:0,error:void 0}}let e=n.handler;if(e===void 0){let e=new CLIError(`Command '${o.name}' has no action handler`,{code:`NO_ACTION`,suggest:`Add an .action() handler to the '${o.name}' command`});return a.error(e.message),{exitCode:1,error:e}}await runBeforeParseHooks(i?.plugins,{argv:t,command:o,meta:r,out:a});let s=parse(o,t,i?.flags),c=i?.prompter??await scriptedPrompter(i?.answers),l=await resolve(o,s,{...i?.stdinData===void 0?{}:{stdinData:i.stdinData},...i?.env===void 0?{}:{env:i.env},...i?.config===void 0?{}:{config:i.config},...c===void 0?{}:{prompter:c},...i?.stat===void 0?{}:{stat:i.stat},...i?.mkdir===void 0?{}:{mkdir:i.mkdir}}),u={args:l.args,flags:l.flags,deprecations:l.deprecations,command:o,meta:r,out:a};await runResolvedHooks(i?.plugins,`afterResolve`,u);for(let e of l.deprecations)a.warn(formatDeprecation(e));return await runResolvedHooks(i?.plugins,`beforeAction`,u),await executeWithExecutionSteps(n,e,l,a,r),await runResolvedHooks(i?.plugins,`afterAction`,u),{exitCode:getRequestedExitCode(a)??0,error:void 0}}catch(e){if(e instanceof CLIError)return i?.jsonMode===!0?a.json({error:e.toJSON()}):(a.error(e.message),e.suggest!==void 0&&a.error(`Suggestion: ${e.suggest}`)),{exitCode:e.exitCode,error:e};let t=new CLIError(`Unexpected error: ${e instanceof Error?e.message:String(e)}`,{code:`UNEXPECTED_ERROR`,cause:e});return i?.jsonMode===!0?a.json({error:t.toJSON()}):a.error(t.message),{exitCode:1,error:t}}finally{a.stopActive(),clearRequestedExitCode(a)}}async function scriptedPrompter(e){if(e===void 0)return;let{createTestPrompter:t}=await import(`./test-prompter-v__jT2yG.mjs`).then(e=>e.r);return t(e)}async function runBeforeParseHooks(e,t){if(e!==void 0)for(let n of e){let e=n.hooks.beforeParse;e!==void 0&&await e(t)}}async function runResolvedHooks(e,t,n){if(e!==void 0)for(let r of e){let e=r.hooks[t];e!==void 0&&await e(n)}}async function executeWithExecutionSteps(e,t,n,r,i){let a=e.steps,{args:o,flags:s}=n,c=n.provenance,l=async e=>{await t({flags:s,args:o,sources:c,ctx:e,out:r,meta:i})};for(let e=a.length-1;e>=0;e--){let t=a[e];if(t===void 0)continue;let n=l;switch(t.kind){case`derive`:l=async e=>{let a=await t.handler({args:o,flags:s,sources:c,ctx:e,out:r,meta:i});if(a===void 0){await n(e);return}if(typeof a!=`object`||!a||Array.isArray(a))throw new CLIError(`derive() must return an object or undefined`,{code:`INVALID_BUILDER_STATE`,suggest:`Return an object to add context, or return nothing for validation-only derive handlers`});await n({...e,...a})};break;case`middleware`:l=async e=>{await t.handler({args:o,flags:s,sources:c,ctx:e,out:r,meta:i,next:async t=>{await n({...e,...t})}})}}}await l({})}function buildRunResult(e,t){return{exitCode:e.exitCode,stdout:t.stdout,stderr:t.stderr,activity:t.activity,error:e.error}}function formatDeprecation(e){let t=e.kind===`flag`?`flag --${e.name}`:`argument <${e.name}>`;return typeof e.message==`string`?`Warning: ${t} is deprecated: ${e.message}`:`Warning: ${t} is deprecated`}var ExitError=class extends Error{name=`ExitError`;code;constructor(e){super(`Process exited with code ${e}`),this.code=e}};const noopWrite=()=>{},eofRead=()=>Promise.resolve(null),noopReadFile=()=>Promise.resolve(null),noopStat=()=>Promise.resolve(null),noopMkdir=()=>Promise.resolve();function createTestAdapter(e){let t=e?.stdinIsTTY??!1,n=t?void 0:e?.stdinData;return{argv:e?.argv??[`node`,`test`],env:e?.env??{},cwd:e?.cwd??`/test`,stdout:e?.stdout??noopWrite,stderr:e?.stderr??noopWrite,stdin:e?.stdin??eofRead,readStdin:()=>{if(n===void 0)return Promise.resolve(null);let e=n;return n=void 0,Promise.resolve(e)},isTTY:e?.isTTY??!1,stdinIsTTY:t,getTerminalSize:()=>e?.terminalSize,onTerminalResize:t=>e?.onTerminalResize?.(t),exit:e?.exit??(e=>{throw new ExitError(e)}),readFile:e?.readFile??noopReadFile,stat:e?.stat??noopStat,mkdir:e?.mkdir??noopMkdir,homedir:e?.homedir??`/home/test`,configDir:e?.configDir??`/home/test/.config`,userConfigDirs:e?.userConfigDirs??[e?.configDir??`/home/test/.config`],systemConfigDirs:e?.systemConfigDirs??[]}}async function exitAfterFlush(e,t){let n=t;try{await e.flush?.()}catch{n=t===0?1:t}return e.exit(n)}function stripTrailing(e,t){let n=e.length;for(;n>0&&t.includes(e.charCodeAt(n-1));)--n;return n===e.length?e:e.slice(0,n)}function resolveHomeDirectory(e,t){return t?e.USERPROFILE?e.USERPROFILE:e.HOMEDRIVE&&e.HOMEPATH?e.HOMEDRIVE+e.HOMEPATH:e.HOME||`C:\\`:e.HOME||`/`}function resolveConfigDirectory(e,t,n){if(t)return e.APPDATA!==void 0&&e.APPDATA!==``?e.APPDATA:`${stripTrailing(n,[47,92])||n}\\AppData\\Roaming`;let r=stripTrailing(n,[47]);return e.XDG_CONFIG_HOME!==void 0&&e.XDG_CONFIG_HOME!==``?e.XDG_CONFIG_HOME:r.length===0?`/.config`:`${r}/.config`}function isDenoErrorNamed(e,t){if(typeof e!=`object`||!e||!(`name`in e))return!1;let n=e;return typeof n.name==`string`&&n.name===t}function safeEnvToObject(e){try{return e.env.toObject()}catch(e){if(isDenoErrorNamed(e,`PermissionDenied`))return{};throw e}}function safeCwd(e){try{return e.cwd()}catch(e){if(isDenoErrorNamed(e,`PermissionDenied`))return`/`;throw e}}function createDenoAdapter(e){let t=e??getDenoNamespace(),n=new TextEncoder,r=[`deno`,`run`,...t.args],i=safeEnvToObject(t),a=safeCwd(t),o=e=>{t.stdout.writeSync(n.encode(e))},s=e=>{t.stderr.writeSync(n.encode(e))},c=createDenoReadLine(t),l=async e=>{try{return await t.readTextFile(e)}catch(e){if(isDenoErrorNamed(e,`NotFound`)||isDenoErrorNamed(e,`PermissionDenied`))return null;throw e}},u=async e=>{try{return(await t.stat(e)).isDirectory?`directory`:`file`}catch(e){if(isDenoErrorNamed(e,`NotFound`))return null;throw e}},d=resolveDenoHomedir(i,t.build.os===`windows`),f=resolveDenoConfigDir(i,d,t.build.os===`windows`),p=t.stdin.isTerminal();return{argv:r,env:i,cwd:a,stdout:o,stderr:s,stdin:c,readStdin:()=>readDenoStdinAll(t,p),isTTY:t.stdout.isTerminal(),stdinIsTTY:p,getTerminalSize:()=>readDenoTerminalSize(t),onTerminalResize:e=>onDenoTerminalResize(t,e),exit:e=>t.exit(e),readFile:l,stat:u,mkdir:e=>t.mkdir(e,{recursive:!0}),homedir:d,configDir:f,userConfigDirs:t.build.os===`darwin`?[f,`${d}/Library/Application Support`]:[f],systemConfigDirs:t.build.os===`windows`?[]:[`/etc`]}}function normalizeTerminalSize$1(e,t){if(e!==void 0&&t!==void 0&&Number.isFinite(e)&&Number.isFinite(t)&&!(e<=0||t<=0))return{columns:e,rows:t}}function readDenoTerminalSize(e){if(e.stdout.isTerminal()&&e.consoleSize!==void 0)try{let t=e.consoleSize();return normalizeTerminalSize$1(t.columns,t.rows)}catch{return}}function onDenoTerminalResize(e,t){if(e.stdout.isTerminal()&&e.build.os!==`windows`&&e.addSignalListener!==void 0&&e.removeSignalListener!==void 0){try{e.addSignalListener(`SIGWINCH`,t)}catch{return}return()=>{e.removeSignalListener?.(`SIGWINCH`,t)}}}function getDenoNamespace(){return globalThis.Deno}async function readDenoStdinAll(e,t){if(t)return null;let n=e.stdin.readable.getReader(),r=new TextDecoder,i=[];try{for(;;){let{value:e,done:t}=await n.read();if(t){i.push(r.decode());break}i.push(r.decode(e,{stream:!0}))}}finally{n.releaseLock()}return i.join(``)}function createDenoReadLine(e){let t=new TextDecoder,n=``,r=!1;return async()=>{let i=e.stdin.readable.getReader();try{for(;;){let e=n.indexOf(`
13
- `);if(e!==-1){let t=n.slice(0,e).replace(/\r$/,``);return n=n.slice(e+1),t}if(r){if(n.length===0)return null;let e=n;return n=``,e}let{value:a,done:o}=await i.read();if(o){n+=t.decode(),r=!0;continue}n+=t.decode(a,{stream:!0})}}finally{i.releaseLock()}}}function resolveDenoHomedir(e,t){return resolveHomeDirectory(e,t)}function resolveDenoConfigDir(e,t,n){return resolveConfigDirectory(e,n,t)}const RUNTIMES=[`node`,`bun`,`deno`,`unknown`];function detectRuntime(e){let t=e??globalThis;return typeof t.Bun?.version==`string`?`bun`:typeof t.Deno?.version?.deno==`string`?`deno`:typeof t.process?.versions?.node==`string`?`node`:`unknown`}function getNodeProcess(){return globalThis.process}function isNodeSystemError(e){return typeof e!=`object`||!e||!(`code`in e)?!1:typeof e.code==`string`}function resolveHomedir(e,t){return resolveHomeDirectory(e,t===`win32`)}function resolveConfigDir(e,t,n){return resolveConfigDirectory(e,t===`win32`,n)}function createNodeAdapter(e){let t=e??getNodeProcess(),n=0,r=[],i=()=>{if(n!==0)return;let e=r;r=[];let i=outputFailure(t);for(let t of e)i===void 0?t.resolve():t.reject(i.error)},a=e=>t=>{n+=1;let r=!1,a=t=>{r||(r=!0,t!=null&&recordStreamError(e,t),--n,i())};try{e.write(t,a)}catch(e){throw a(),e}};watchStreamErrors(t.stdout),watchStreamErrors(t.stderr);let o=a(t.stdout),s=a(t.stderr),c=()=>new Promise((e,t)=>{r.push({resolve:e,reject:t}),i()}),l=createNodeReadLine(t),u=async e=>{let t=await import(`node:fs/promises`);try{return await t.readFile(e,`utf8`)}catch(e){if(isNodeSystemError(e)&&e.code===`ENOENT`)return null;throw e}},d=async e=>{let t=await import(`node:fs/promises`);try{return(await t.stat(e)).isDirectory()?`directory`:`file`}catch(e){if(isNodeSystemError(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return null;throw e}},f=async e=>{await(await import(`node:fs/promises`)).mkdir(e,{recursive:!0})},p=resolveHomedir(t.env,t.platform),m=resolveConfigDir(t.env,t.platform,p),h=t.platform===`darwin`?[m,`${p}/Library/Application Support`]:[m],g=t.platform===`win32`?[]:[`/etc`],_=t.stdin.isTTY===!0;return{argv:t.argv,env:t.env,cwd:t.cwd(),stdout:o,stderr:s,flush:c,stdin:l,readStdin:()=>readNodeStdinAll(t,_),isTTY:t.stdout.isTTY===!0,stdinIsTTY:_,getTerminalSize:()=>readNodeTerminalSize(t),onTerminalResize:e=>onNodeTerminalResize(t,e),exit:e=>t.exit(e),readFile:u,stat:d,mkdir:f,homedir:p,configDir:m,userConfigDirs:h,systemConfigDirs:g}}const streamStates=new WeakMap;function recordStreamError(e,t){streamStates.get(e)===void 0&&streamStates.set(e,isNodeSystemError(t)&&t.code===`EPIPE`?{kind:`closed`}:{kind:`failed`,error:t})}function watchStreamErrors(e){streamStates.has(e)||(streamStates.set(e,void 0),e.on?.(`error`,t=>recordStreamError(e,t)))}function outputFailure(e){for(let t of[e.stdout,e.stderr]){let e=streamStates.get(t);if(e?.kind===`failed`)return e}}function normalizeTerminalSize(e,t){if(e!==void 0&&t!==void 0&&Number.isFinite(e)&&Number.isFinite(t)&&!(e<=0||t<=0))return{columns:e,rows:t}}function readNodeTerminalSize(e){if(e.stdout.isTTY===!0){try{let t=e.stdout.getWindowSize?.();if(t!==void 0){let[e,n]=t,r=normalizeTerminalSize(e,n);if(r!==void 0)return r}}catch{}return normalizeTerminalSize(e.stdout.columns,e.stdout.rows)}}function onNodeTerminalResize(e,t){if(e.stdout.isTTY===!0&&e.stdout.on!==void 0){if(e.stdout.off!==void 0)return e.stdout.on(`resize`,t),()=>{e.stdout.off?.(`resize`,t)};if(e.stdout.removeListener!==void 0)return e.stdout.on(`resize`,t),()=>{e.stdout.removeListener?.(`resize`,t)}}}async function readNodeStdinAll(e,t){if(t)return null;let n=[],r=new TextDecoder;for await(let t of e.stdin)n.push(r.decode(t,{stream:!0}));return n.push(r.decode()),n.join(``)}function createNodeReadLine(e){let t=e.stdin[Symbol.asyncIterator](),n=new TextDecoder,r=``,i=!1;return async()=>{for(;;){let e=r.indexOf(`
14
- `);if(e!==-1){let t=r.slice(0,e).replace(/\r$/,``);return r=r.slice(e+1),t}if(i){if(r.length===0)return null;let e=r;return r=``,e}let a=await t.next();if(a.done){r+=n.decode(),i=!0;continue}r+=n.decode(a.value,{stream:!0})}}}function isDenoNamespace(e){if(typeof e!=`object`||!e)return!1;let t=e;return Array.isArray(t.args)&&typeof t.cwd==`function`&&typeof t.exit==`function`&&typeof t.readTextFile==`function`&&typeof t.env?.get==`function`&&typeof t.env.toObject==`function`&&typeof t.stdout?.writeSync==`function`&&typeof t.stdout.isTerminal==`function`&&typeof t.stderr?.writeSync==`function`&&typeof t.stdin?.isTerminal==`function`&&typeof t.stdin?.readable?.getReader==`function`}function getInjectedDenoNamespace(e){let t=e.Deno;return isDenoNamespace(t)?t:void 0}function createAdapter(e){let t=e??globalThis,n=detectRuntime(t);switch(n){case`deno`:return createDenoAdapter(getInjectedDenoNamespace(t));case`bun`:case`node`:case`unknown`:return createNodeAdapter();default:return n}}function commandRoutes(e){return[e.name,...e.aliases]}function assertNoSiblingRouteConflict(e,t,n,r){let i=t.get(n);if(i!==void 0){let t=i===r;throw new CLIError(t?`Command '${r}' reuses route '${n}' under '${e}'`:`Duplicate command route '${n}' under '${e}' (${i} and ${r})`,{code:`DUPLICATE_COMMAND`,suggest:t?`Remove route '${n}' from the aliases of '${r}'`:`Ensure sibling command names and aliases are unique`})}t.set(n,r)}function compileCommand(e){let t=new Map,n=new Map;for(let r of e._subcommands){let i=commandRoutes(r.schema);for(let t of i)assertNoSiblingRouteConflict(e.schema.name,n,t,r.schema.name);let a=compileCommand(r);for(let e of i)t.set(e,a)}return{schema:e.schema,handler:e.handler,steps:e._executionSteps,subcommands:t}}const SHORTHAND_HOSTS={github:`https://github.com`,gitlab:`https://gitlab.com`,bitbucket:`https://bitbucket.org`};function stripGitSuffix(e){return e.endsWith(`.git`)?e.slice(0,-4):e}function packageRepositoryUrl(e,t){let n=resolveRepositoryUrl(e);if(n===void 0&&t?.require===!0)throw new CLIError(e.repository===void 0?`manifest has no 'repository' field`:`manifest 'repository' is not a recognisable locator: ${JSON.stringify(e.repository)}`,{code:`INVALID_REPOSITORY`,suggest:`Set 'repository' to a supported locator (e.g. 'github:user/repo' or 'git+https://github.com/user/repo.git'), or drop { require: true } and handle undefined`});return n}function resolveRepositoryUrl(e){let t=typeof e.repository==`string`?e.repository:e.repository?.url;if(t===void 0)return;let n=t.trim();if(n.length===0)return;let r=/^(github|gitlab|bitbucket):([^/]+\/[^/]+)$/.exec(n);if(r!==null&&r[1]!==void 0&&r[2]!==void 0){let e=SHORTHAND_HOSTS[r[1]];if(e!==void 0)return`${e}/${stripGitSuffix(r[2])}`}if(/^[\w.-]+\/[\w.-]+$/.test(n))return`https://github.com/${stripGitSuffix(n)}`;n.startsWith(`git+`)&&(n=n.slice(4));let i=/^git@([^:/]+):(.+)$/.exec(n);if(i!==null&&i[1]!==void 0&&i[2]!==void 0)return`https://${i[1]}/${stripGitSuffix(stripTrailing(i[2],[47]))}`;if(/^(?:https?|git|ssh):\/\//.test(n))try{let e=new URL(n),t=stripGitSuffix(stripTrailing(e.pathname,[47]));return`https://${e.hostname}${t}`}catch{return}}function releaseTagUrl(e,t){let n;try{n=new URL(e).hostname}catch{return}if(n===`github.com`)return`${e}/releases/tag/v${t}`;if(n===`gitlab.com`)return`${e}/-/releases/v${t}`}function deriveHelpLinks(e,t,n){if(e===void 0)return;if(t===void 0||e.name!==void 0&&e.version!==void 0)return e;let r=packageRepositoryUrl(t);return{name:e.name??r??t.homepage,version:e.version??(r!==void 0&&n!==void 0?releaseTagUrl(r,n):void 0)}}function dispatch(e,t,n=[],r=new Map,i){let a=-1;for(let t=0;t<e.length;t++){let n=e[t];if(n!==void 0){if(n===`--`){t+1<e.length&&(a=t+1);break}if(n.startsWith(`-`)){consumesFollowingToken(n,r)&&t++;continue}a=t;break}}if(a===-1)return{kind:`unknown`,input:``,candidates:uniqueCommands(t),parentPath:n};let o=e[a];if(o===void 0)return{kind:`unknown`,input:``,candidates:uniqueCommands(t),parentPath:n};let s=t.get(o);if(s===void 0)return{kind:`unknown`,input:o,candidates:uniqueCommands(t),parentPath:n};let c=[...e.slice(0,a),...e.slice(a+1)],l=[...n,s.schema];if(s.subcommands.size>0){let e=dispatch(c,s.subcommands,l,buildFlagLookup(s.schema.flags,i),i);switch(e.kind){case`match`:return e;case`unknown`:return e.input===``?s.schema.hasAction?{kind:`match`,command:s,commandPath:l,remainingArgv:c}:{kind:`needs-subcommand`,command:s,commandPath:l}:s.schema.hasAction?{kind:`match`,command:s,commandPath:l,remainingArgv:c}:e;case`needs-subcommand`:return e;default:return e}}return{kind:`match`,command:s,commandPath:l,remainingArgv:c}}function consumesFollowingToken(e,t){if(e.startsWith(`--`)){if(e.includes(`=`))return!1;let n=t.get(e.slice(2));return n!==void 0&&flagExpectsValue(n.schema)}let n=e.slice(1);for(let e=0;e<n.length;e++){let r=t.get(n.charAt(e));if(r===void 0)return!1;if(flagExpectsValue(r.schema))return e===n.length-1}return!1}function levenshtein(e,t){let n=e.length,r=t.length,i=r+1,a=new Uint16Array(i),o=new Uint16Array(i);for(let e=0;e<=r;e++)a[e]=e;for(let i=1;i<=n;i++){o[0]=i;for(let n=1;n<=r;n++){let r=e.charAt(i-1)===t.charAt(n-1)?0:1,s=a[n]??0,c=o[n-1]??0,l=a[n-1]??0;o[n]=Math.min(s+1,c+1,l+r)}[a,o]=[o,a]}return a[r]??Math.max(n,r)}function findClosestCommand(e,t){let n,r=4;for(let i of t){let t=levenshtein(e,i.schema.name);t<r&&(r=t,n=i.schema.name);for(let t of i.schema.aliases){let a=levenshtein(e,t);a<r&&(r=a,n=i.schema.name)}}return r<=3?n:void 0}function uniqueCommands(e){let t=new Set,n=[];for(let r of e.values())t.has(r)||(t.add(r),n.push(r));return n}function collectPropagatedFlags(e){if(e.length<=1)return{};let t={};for(let n=0;n<e.length-1;n++){let r=e[n];if(r!==void 0){for(let[i,a]of Object.entries(r.flags))if(a.propagate){let r=!1;for(let t=n+1;t<e.length-1;t++){let n=e[t];if(n!==void 0&&Object.hasOwn(n.flags,i)){r=!0;break}}r||(t[i]=a)}}}let n=e[e.length-1];if(n!==void 0)for(let e of Object.keys(n.flags))delete t[e];return t}const rootBooleanSchema=flag.boolean().schema,ROOT_OUTPUT_NAMES=[`json`,`quiet`];function spellingIndex(e){let t=new Map;for(let n of ROOT_OUTPUT_NAMES)for(let r of BUILTIN_SPECS[n][e])t.set(r,n);return t}const ROOT_LONG_SPELLINGS=spellingIndex(`long`),ROOT_SHORT_SPELLINGS=spellingIndex(`short`);function coerceRootValue(e,t,n){try{return{kind:`flag`,name:e,selection:coerceFlagValue(e,n,rootBooleanSchema,t)===!0?`on`:`off`}}catch(t){if(t instanceof ParseError)return{kind:`invalid`,name:e,error:t};throw t}}function ownedName(e,t,n){let r=e.get(t);if(r!==void 0&&builtinEnabled(n,r))return r}function matchRootToken(e,t){let n=ownedName(ROOT_SHORT_SPELLINGS,e,t);if(n!==void 0)return{kind:`flag`,name:n,selection:`on`};let r=ownedName(ROOT_LONG_SPELLINGS,e,t);if(r!==void 0)return{kind:`flag`,name:r,selection:`on`};let i=e.indexOf(`=`);if(i===-1)return{kind:`unrelated`};let a=e.slice(0,i),o=ownedName(ROOT_LONG_SPELLINGS,a,t);return o===void 0?{kind:`unrelated`}:coerceRootValue(o,a,e.slice(i+1))}function readRootOutputFlags(e,t){let n=e.indexOf(`--`),r=n===-1?e:e.slice(0,n),i={json:`absent`,quiet:`absent`},a=[],o=new Map,s=!1;for(let e of r){let n=matchRootToken(e,t);if(n.kind===`unrelated`){a.push(e);continue}if(s=!0,n.kind===`invalid`){o.delete(n.name),o.set(n.name,n.error);continue}i[n.name]=n.selection,o.delete(n.name)}let c=s?n===-1?a:[...a,...e.slice(n)]:e,l={json:i.json,quiet:i.quiet,argv:c},u=o.values().next().value;return u===void 0?{kind:`ok`,...l}:{kind:`failed`,...l,error:u}}function resolveRootJsonMode(e,t){return e.json===`absent`?t===!0:e.json===`on`}function resolveRootVerbosity(e,t){return e.quiet===`on`?`quiet`:e.quiet===`off`?`normal`:t}function buildMeta(e,t,n){return{name:e.name,bin:t.binName??e.name,version:e.version,command:n}}function buildRootCommandMap(e){let t=new Map,n=(e,n)=>{let r=t.get(e);if(r!==void 0)throw new CLIError(`Duplicate root command route '${e}' (${r.schema.name} and ${n.schema.name})`,{code:`DUPLICATE_COMMAND`,suggest:`Ensure root command names and aliases are unique`});t.set(e,n)};for(let t of e){n(t.schema.name,t);for(let e of t.schema.aliases)n(e,t)}return t}function mergeCommandSchema(e,t){let n=collectPropagatedFlags(t);return Object.keys(n).length===0?e.schema:{...e.schema,flags:{...n,...e.schema.flags}}}function buildCommandExecutionPlan(e){return{command:e.command,mergedSchema:mergeCommandSchema(e.command,e.commandPath),argv:e.argv,meta:e.meta,plugins:e.plugins,output:e.output,help:e.help}}function buildPlannerMatchOutcome(e,t,n,r){return{kind:`match`,plan:buildCommandExecutionPlan({command:t,commandPath:n,argv:r,meta:buildMeta(e.schema,e.help,t.schema.name),plugins:e.compiled.plugins,output:e.output,help:e.help})}}function canDelegateUnknownRootToDefault(e,t){return t===``||e.schema.args.length>0}function findUnknownFlagBeforePositional(e,t,n){let r=buildFlagLookup(t,n);for(let t=0;t<e.length;t++){let n=e[t];if(n===void 0||n===`--`||n===`-`||!n.startsWith(`-`))return;if(n.startsWith(`--`)){let e=n.indexOf(`=`),i=n.slice(2,e===-1?void 0:e),a=r.get(i);if(a===void 0)return e===-1?n:`--${i}`;e===-1&&flagExpectsValue(a.schema)&&t++;continue}let i=n.slice(1);for(let e=0;e<i.length;e++){let n=i.charAt(e),a=r.get(n);if(a===void 0)return`-${n}`;if(flagExpectsValue(a.schema)){e===i.length-1&&t++;break}}}}function scanRootHead(e,t,n){for(let r=0;r<e.length;r++){let i=e[r];if(i===void 0)continue;if(n&&(i===`--help`||i===`-h`))return{helpBeforeCommand:!0,firstCommandToken:void 0,commandTokenIndex:-1};if(i===`-`||!i.startsWith(`-`))return{helpBeforeCommand:!1,firstCommandToken:i,commandTokenIndex:r};if(i.startsWith(`--`)){let e=i.indexOf(`=`),n=i.slice(2,e===-1?void 0:e),a=t?.get(n);a!==void 0&&e===-1&&flagExpectsValue(a.schema)&&r++;continue}let a=i.slice(1);for(let e=0;e<a.length;e++){let n=t?.get(a.charAt(e));if(n!==void 0&&flagExpectsValue(n.schema)){e===a.length-1&&r++;break}}}return{helpBeforeCommand:!1,firstCommandToken:void 0,commandTokenIndex:-1}}function helpHint(e,t){return t?{suggest:`Run '${e} --help' for available commands`}:{}}function planCompletionsFlag(e,t){let n=e.indexOf(`--`),r=n===-1?e.length:n;for(let n=0;n<r;n++){let i=e[n];if(i===void 0)continue;let a;if(i===`--completions`){let t=n+1<r?e[n+1]:void 0;a=t!==void 0&&!t.startsWith(`-`)?t:void 0}else if(i.startsWith(`--completions=`))a=i.slice(14);else continue;if(a===void 0||a===``)return{kind:`root-completions`,shell:void 0,options:t.options};let o=normalizeShell(a);return o===void 0||!t.shells.includes(o)?{kind:`dispatch-error`,error:new ParseError(`Unknown shell '${a}'`,{code:`INVALID_VALUE`,suggest:`Valid shells: ${t.shells.join(`, `)}`})}:{kind:`root-completions`,shell:o,options:t.options}}}function planInvocation(e){let t=builtinEnabled(e.schema.builtins,`help`),n=readRootOutputFlags(e.argv,e.schema.builtins),r=n.argv,i=r.indexOf(`--`),a=i===-1?r:r.slice(0,i),o=e.compiled.defaultCommand,s=o===void 0?void 0:buildFlagLookup(o.schema.flags,e.schema.flagSettings);if(e.schema.version!==void 0&&(includesBeforeSeparator(e.argv,`--version`)||includesBeforeSeparator(e.argv,`-V`)))return{kind:`root-version`,version:e.schema.version};if(e.schema.completionsFlag!==void 0){let t=planCompletionsFlag(e.argv,e.schema.completionsFlag);if(t!==void 0)return t}let c=scanRootHead(a,s,t);if(c.helpBeforeCommand)return{kind:`root-help`,help:e.help};if(t&&c.firstCommandToken===`help`&&!e.compiled.commands.some(e=>e.schema.name===`help`||e.schema.aliases.includes(`help`))){let t=r.slice(c.commandTokenIndex+1);return t.length===0?{kind:`root-help`,help:e.help}:planInvocation({...e,argv:[...t,`--help`]})}if(n.kind===`failed`&&!(t&&requestsHelp(r)))return{kind:`dispatch-error`,error:n.error};if(e.compiled.commands.length===0&&o===void 0)return{kind:`dispatch-error`,error:new CLIError(`No commands registered`,{code:`NO_ACTION`,suggest:`Add commands via .command() or .default() before calling .run()`})};if(r.length===0&&o===void 0)return{kind:`root-help`,help:e.help};let l=dispatch(r,buildRootCommandMap(o!==void 0&&e.schema.defaultCommandRouted?[...e.compiled.commands,o]:e.compiled.commands),[],s,e.schema.flagSettings);switch(l.kind){case`unknown`:{if(o!==void 0&&l.parentPath.length===0){if((l.input===``?void 0:findClosestCommand(l.input,l.candidates))===void 0&&canDelegateUnknownRootToDefault(o,l.input))return buildPlannerMatchOutcome(e,o,[o.schema],r);let n=findUnknownFlagBeforePositional(r,o.schema.flags,e.schema.flagSettings);if(n!==void 0)return{kind:`dispatch-error`,error:new ParseError(`Unknown flag ${n}`,{code:`UNKNOWN_FLAG`,...helpHint(e.schema.name,t)})}}if(l.input===``){let n=r.find(e=>e.startsWith(`-`));return n===void 0?{kind:`root-help`,help:e.help}:{kind:`dispatch-error`,error:new ParseError(`Unknown flag ${n}`,{code:`UNKNOWN_FLAG`,...helpHint(e.schema.name,t)})}}let n=findClosestCommand(l.input,l.candidates),i=l.parentPath.length>0?`${e.schema.name} ${l.parentPath.map(e=>e.name).join(` `)}`:e.schema.name;return{kind:`dispatch-error`,error:new ParseError(`Unknown command: ${l.input}`,{code:`UNKNOWN_COMMAND`,...n===void 0?helpHint(i,t):{suggest:`Did you mean '${n}'?`}})}}case`needs-subcommand`:{let t=l.commandPath.slice(0,-1).map(e=>e.name);return{kind:`needs-subcommand`,command:l.command,commandPath:l.commandPath,help:{...e.help,binName:[e.schema.name,...t].join(` `)}}}case`match`:return buildPlannerMatchOutcome(e,l.command,l.commandPath,l.remainingArgv)}}function plugin(e,t){let n=Object.freeze({...e});return Object.freeze({hooks:n,name:t})}const RENAME=`Rename the flag`,STRIPPED=`The root strips that token before dispatch`;function releaseRemedy(e,...t){return[RENAME,...t,`release the built-in with .builtins({ ${e}: 'off' }) before registering the command`].join(`, or `)}const BUILTIN_EFFECTS={help:`A help request renders before flags are parsed`,json:STRIPPED,quiet:STRIPPED},BUILTIN_REMEDIES={help:releaseRemedy(`help`),json:releaseRemedy(`json`),quiet:releaseRemedy(`quiet`,`use out.status() for output that root --quiet suppresses`)},VERSION_RESERVED={rootSpelling:`--version`,effect:`The root intercepts that token before dispatch`,remedy:RENAME},VERSION_TOKENS=[`version`,`V`];function reservedTokens(e,t){let n=new Map;for(let e of BUILTIN_NAMES){if(!builtinEnabled(t,e))continue;let r={rootSpelling:builtinSpelling(e),effect:BUILTIN_EFFECTS[e],remedy:BUILTIN_REMEDIES[e]};for(let t of builtinTokens(e))n.set(t,r)}if(e!==void 0)for(let e of VERSION_TOKENS)n.set(e,VERSION_RESERVED);return n}function spellingOf(e){return e.length===1?`-${e}`:`--${e}`}function flagSpellings(e,t){let n=[[e,`name`]];for(let e of getFlagAliasNames(t,{includeHidden:!0}))n.push([e,`alias`]);let r=getFlagNegatedName(e,t);return r!==void 0&&n.push([r,`negation`]),n}function findReservedCollision(e,t){for(let[n,r]of Object.entries(e.flags))for(let[i,a]of flagSpellings(n,r)){let r=t.get(i);if(r!==void 0)return{commandName:e.name,flagName:n,spelling:spellingOf(i),origin:a,reserved:r}}for(let n of e.commands){let e=findReservedCollision(n,t);if(e!==void 0)return e}}function subjectOf(e){switch(e.origin){case`name`:return`defines a '${e.spelling}' flag`;case`alias`:return`defines a '${e.spelling}' alias on flag '${e.flagName}'`;case`negation`:return`defines a '${e.spelling}' negated spelling on flag '${e.flagName}'`}}function reservedFlagError(e){return new CLIError(`Command '${e.commandName}' ${subjectOf(e)}, which is reserved by the root '${e.reserved.rootSpelling}' flag. ${e.reserved.effect}, so the command can never receive it`,{code:`RESERVED_FLAG`,details:{command:e.commandName,flag:e.flagName},suggest:e.reserved.remedy})}function assertNoReservedFlagCollisions(e,t,n){let r=reservedTokens(e,n);for(let e of t){if(e===void 0)continue;let t=findReservedCollision(e,r);if(t!==void 0)throw reservedFlagError(t)}}function resolveRootSurface(e){let t=e.commands.filter(e=>!e.hidden),n=e.defaultCommand,r=n!==void 0&&!n.hidden?n:void 0,i=r===void 0?t:t.filter(e=>e.name!==r.name);return{visibleCommands:t,visibleSubcommands:i,visibleDefaultCommand:r,hasVisibleDefault:r!==void 0,hasVisibleSubcommands:i.length>0,defaultRouted:r!==void 0&&e.defaultCommandRouted===!0}}function formatRootHelp(e,t){let n=t?.width??80,r=t?.binName??e.name,i=t?.hyperlinks===!0,a=t?.inlineDefault??!0,o=t?.showDefaultInCommands??!1,s=resolveHelpTheme(t?.colors,t?.theme),c=resolveRootSurface(e),l=c.visibleDefaultCommand,u=!c.hasVisibleSubcommands&&e.completionsFlag===void 0,d=a||u?l:void 0,f=resolveSurfaceCommand(e,d),p=f!==void 0,m=[formatHeader(e,i,s)];e.description!==void 0&&m.push(e.description);let h=c.hasVisibleSubcommands?l===void 0?`<command>`:`[command]`:``,g=s.sectionTitle(`Usage:`),_=h.length>0?`${g} ${s.usageBin(r)} ${s.placeholder(h)} ${s.placeholder(`[options]`)}`:`${g} ${s.usageBin(r)} ${s.placeholder(`[options]`)}`,v=[];p&&f!==void 0&&(v=[...formatHelpSections(f,{...t,binName:r,isDefaultHelp:!0})]);let y=v.shift();p&&y!==void 0&&d!==void 0?m.push(c.hasVisibleSubcommands?mergeUsageSections(_,y,g):y):m.push(_);let b=l!==void 0&&(c.defaultRouted||o),x=b?[...c.visibleSubcommands,l]:c.visibleSubcommands;x.length>0&&m.push(formatRootCommandsSection(x,b?l?.name:void 0,n,s)),p&&f!==void 0&&(f.description!==void 0&&f.description===e.description&&v[0]===f.description&&v.shift(),m.push(...v));let S=formatGlobalOptionsSection(e,n,s);if(S.length>0&&m.push(S),builtinEnabled(e.builtins,`help`)&&(t?.footer??c.hasVisibleSubcommands)){let e=c.hasVisibleSubcommands?l===void 0?` <command>`:` [command]`:``;m.push(`Run '${r}${e} --help' for more information.`)}return`${m.join(`
15
-
16
- `)}\n`}function resolveSurfaceCommand(e,t){if(e.completionsFlag===void 0)return t;let n=t??command(e.name).schema;return{...n,flags:{completions:completionsFlagSchema(e.completionsFlag.shells),...n.flags}}}function completionsFlagSchema(e){return createFlagSchema(`enum`,{description:`Print a shell completion script and exit`,enumValues:e})}function formatHeader(e,t,n){let r=t?e.helpLinks:void 0,i=n.headerName(e.name),a=r?.name===void 0?i:osc8(r.name,i);if(e.version===void 0)return a;let o=n.headerVersion(`v${e.version}`);return`${a} ${r?.version===void 0?o:osc8(r.version,o)}`}function formatRootCommandsSection(e,t,n,r){let i=[r.sectionTitle(`Commands:`)],a=0;for(let n of e){let e=n.name===t?10:0,r=n.name.length+e;r>a&&(a=r)}let o=2+a+2;for(let a of e){let e=padEnd(` ${a.name===t?`${r.command(a.name)}${r.annotation(` (default)`)}`:r.command(a.name)}`,o),s=a.description??``;s.length===0?i.push(e.trimEnd()):i.push(`${e}${wrapText(s,n,o)}`)}return i.join(`
17
- `)}function formatGlobalOptionsSection(e,t,n){let r=[],i=t=>{builtinEnabled(e.builtins,t)&&r.push({left:n.flag(builtinFlagForms(t)),description:BUILTIN_SPECS[t].description})};for(let t of BUILTIN_NAMES)i(t),t===`help`&&e.version!==void 0&&r.push({left:n.flag(`-V, --version`),description:`Print the version number and exit`});return e.configSettings!==void 0&&r.push({left:`${n.flag(`--config`)} ${n.placeholder(`<path>`)}`,description:`Load configuration from the given file`}),r.length===0?``:formatFlagEntriesBlock(n.sectionTitle(`Global options:`),r,t)}function mergeUsageSections(e,t,n){let r=`${n} `,i=t.startsWith(r)?t.slice(r.length):t;return`${e}\n${` `.repeat(7)}${i}`}const PRECHECK_OUTPUT={jsonMode:!1,isTTY:!1,verbosity:`normal`};function extractConfigFlag(e){let t=[],n;for(let r=0;r<e.length;r+=1){let i=e[r];if(i!==void 0){if(i===`--`){t.push(...e.slice(r));break}if(n===void 0&&i.startsWith(`--config=`)){let e=i.slice(9);if(e.length>0){n=e;continue}t.push(i);continue}if(n===void 0&&i===`--config`){let a=e[r+1];if(a!==void 0&&!a.startsWith(`-`)&&a!==`--`){n=a,r+=1;continue}t.push(i);continue}t.push(i)}}return{configPath:n,filteredArgv:t}}function commandInvocationNeedsStdin(e,t,n,r){if(builtinEnabled(r,`help`)&&(t.includes(`--help`)||t.includes(`-h`)))return!1;try{let r=parse(e,t,n);return invocationSelectsStdin(e.flags,e.args,r)}catch(e){if(e instanceof ParseError)return!1;throw e}}function invocationNeedsStdin(e,t,n){let r=planInvocation({schema:e,compiled:t,argv:n,help:{binName:e.name},output:PRECHECK_OUTPUT});switch(r.kind){case`match`:return commandInvocationNeedsStdin(r.plan.mergedSchema,r.plan.argv,e.flagSettings,e.builtins);case`dispatch-error`:case`needs-subcommand`:case`root-help`:case`root-version`:case`root-completions`:return!1}}function isCompletionsInvocation(e,t,n){if(!e.hasBuiltInCompletions)return!1;let r=planInvocation({schema:e,compiled:t,argv:n,help:{binName:e.name},output:PRECHECK_OUTPUT});return r.kind===`root-completions`||r.kind===`match`&&r.plan.command.schema.name===`completions`}async function discoverManifestData(e,t){let{discoverManifest:n}=await import(`./package-json-BgE9YjjQ.mjs`).then(e=>e.r);return n(e,{...t.from===void 0?{}:{startDir:t.from},files:t.files})}async function inferManifestCliName(e,t){let{inferCliName:n}=await import(`./package-json-BgE9YjjQ.mjs`).then(e=>e.r);return n(e,{stripScope:t})}async function applyPackageJsonDiscovery(e,t,n,r){let i=e.packageJsonSettings,a=i!==void 0&&!r?await(async()=>{let n=i.data??await discoverManifestData(t,i);if(n===null)return e;let r=i.inferName?await inferManifestCliName(n,i.stripScope):void 0;return{...e,...e.version===void 0&&n.version!==void 0?{version:n.version}:{},...e.description===void 0&&n.description!==void 0?{description:n.description}:{},...r===void 0?{}:{name:r},helpLinks:deriveHelpLinks(e.helpLinks,n,e.version??n.version)}})():e;return n===void 0?a:{...a,name:n}}function discoveredVersionCollision(e,t,n){if(e.version!==t.version)try{assertNoReservedFlagCollisions(e.version,[n.defaultCommand?.schema,...n.commands.map(e=>e.schema)],e.builtins);return}catch(e){if(e instanceof CLIError)return e;throw e}}async function loadRuntimeConfig(e,t,n,r,i){if(e.configSettings===void 0||r||i!==void 0)return i;try{let{discoverConfig:r}=await import(`./config-CrlScpYX.mjs`).then(e=>e.r),i=await r(e.configSettings.appName,t,{...n===void 0?{}:{configPath:n},...e.configSettings.loaders===void 0?{}:{loaders:e.configSettings.loaders}});return i.found?i.data:void 0}catch(e){if(e instanceof CLIError)return e;throw e}}function createLazyTerminalPrompter(e){let t;return{async promptOne(n){return t??=import(`./terminal-C8KTXjv5.mjs`).then(e=>e.n).then(({createTerminalPrompter:t})=>t(e.stdin,e.stderr)),(await t).promptOne(n)}}}async function prepareRuntimePreflight(e){let t=e.adapter.argv.slice(2),{configPath:n,filteredArgv:r}=e.schema.configSettings===void 0?{configPath:void 0,filteredArgv:t}:extractConfigFlag(t),i=readRootOutputFlags(r,e.schema.builtins),a=resolveRootJsonMode(i,e.options?.jsonMode),o=resolveRootVerbosity(i,e.options?.verbosity)??`normal`,s=isCompletionsInvocation(e.schema,e.compiled,r),c=await applyPackageJsonDiscovery(e.schema,e.adapter,e.inheritedName,s),l=discoveredVersionCollision(c,e.schema,e.compiled);if(l!==void 0)return{kind:`startup-error`,error:l,jsonMode:a};let u=await loadRuntimeConfig(c,e.adapter,n,s,e.options?.config);if(u instanceof CLIError)return{kind:`startup-error`,error:u,jsonMode:a};let d=e.options?.prompter===void 0&&e.adapter.stdinIsTTY?createLazyTerminalPrompter(e.adapter):void 0,f=e.options?.stdinData===void 0&&invocationNeedsStdin(c,e.compiled,r)?await e.adapter.readStdin():e.options?.stdinData;return{kind:`ready`,schema:c,filteredArgv:r,inputs:{env:e.options?.env??e.adapter.env,isTTY:e.options?.isTTY??e.adapter.isTTY,jsonMode:a,verbosity:o,stat:e.options?.stat??e.adapter.stat,mkdir:e.options?.mkdir??e.adapter.mkdir,...f===void 0?{}:{stdinData:f},...e.options?.prompter===void 0?d===void 0?{}:{prompter:d}:{prompter:e.options.prompter},...u===void 0?{}:{config:u}}}}const COMPLETIONS_FLAG_NAME=`completions`;function commandReservesCompletionsFlag(e){if(Object.hasOwn(e.flags,COMPLETIONS_FLAG_NAME))return!0;for(let[t,n]of Object.entries(e.flags))if(getFlagAliasNames(n,{kind:`long`,includeHidden:!0}).includes(COMPLETIONS_FLAG_NAME)||getFlagNegatedName(t,n)===COMPLETIONS_FLAG_NAME)return!0;return e.commands.some(commandReservesCompletionsFlag)}function assertNoCompletionsFlagCollision(e){if(commandReservesCompletionsFlag(e))throw new CLIError(`Command '${e.name}' defines a '--${COMPLETIONS_FLAG_NAME}' flag, which is reserved by .completions({ as: 'flag' })`,{code:`RESERVED_FLAG`,suggest:`Rename the flag, or register completions as a subcommand with .completions() instead of { as: 'flag' }`})}function assertNoTopLevelRouteConflict(e,t,n){let r=new Map,i=n===void 0?e:[...e,n];for(let e of i)for(let t of commandRoutes(e))assertNoSiblingRouteConflict(`root`,r,t,e.name);for(let e of commandRoutes(t)){let n=r.get(e);if(n!==void 0)throw new CLIError(`Command route '${e}' is already registered by '${n}'`,{code:`DUPLICATE_COMMAND`,suggest:n===t.name?`Ensure command '${t.name}' does not reuse route '${e}'`:`Rename '${t.name}' or remove route '${e}' from '${n}'`});r.set(e,t.name)}}const compiledStates=new WeakMap;function compiledStateOf(e){let t=compiledStates.get(e);if(t===void 0)throw new CLIError(`CLI builder carries no compiled command graph`,{code:`INVALID_BUILDER_STATE`,suggest:`Create CLI builders with cli()`});return t}function rebuild(e,t){return CLIBuilder._from(t,compiledStateOf(e))}function completionGeneratorOptions(e){if(e!==void 0)return{...e.functionPrefix===void 0?{}:{functionPrefix:e.functionPrefix},...e.rootMode===void 0?{}:{rootMode:e.rootMode}}}function sealCLISchema(e){return e}function buildCLISchema(e){let t=e.configSettings;return sealCLISchema({name:e.name,inheritName:e.inheritName??!1,version:e.version,description:e.description,commands:(e.commands??[]).map(e=>createCommandSchema(e)),defaultCommand:e.defaultCommand===void 0?void 0:createCommandSchema(e.defaultCommand),defaultCommandRouted:e.defaultCommandRouted??!1,configSettings:t===void 0?void 0:{appName:t.appName,loaders:t.loaders},packageJsonSettings:e.packageJsonSettings,helpLinks:e.helpLinks,hasBuiltInCompletions:e.hasBuiltInCompletions??!1,completionsFlag:e.completionsFlag,helpConfig:e.helpConfig,flagSettings:e.flagSettings,builtins:normalizeBuiltins(e.builtins)})}function createCLISchema(e){if(e.name===``)throw new CLIError(`CLI schema requires a non-empty name`,{code:`INVALID_SCHEMA`,details:{name:e.name},suggest:`Pass a program name such as { name: "mycli" }`});let t=buildCLISchema(e),n=[];for(let e of t.commands)assertNoTopLevelRouteConflict(n,e),n.push(e);let r=e.defaultCommand!==void 0&&e.commands?.includes(e.defaultCommand)===!0;t.defaultCommand!==void 0&&!r&&assertNoTopLevelRouteConflict(n,t.defaultCommand);let i=[t.defaultCommand,...t.commands];if(assertNoReservedFlagCollisions(t.version,i,t.builtins),t.completionsFlag!==void 0)for(let e of i)e!==void 0&&assertNoCompletionsFlagCollision(e);return t}var ResolvedRenderContext=class{jsonMode;verbosity;isTTY;color;isHyperlinkSupported;constructor(e){this.jsonMode=e.jsonMode,this.verbosity=e.verbosity,this.isTTY=e.isTTY,this.color=e.color,this.isHyperlinkSupported=e.isHyperlinkSupported}};function resolveRenderContext(e,t){let n=readRootOutputFlags(e,t?.builtins),r=resolveRootJsonMode(n,t?.jsonMode),i=resolveRootVerbosity(n,t?.verbosity)??`normal`;return new ResolvedRenderContext(createOutput({jsonMode:r,isTTY:t?.isTTY??!1,verbosity:i,...t?.color===void 0?{}:{color:t.color},...hyperlinksOption(resolveHyperlinkOverride(t?.env??{},e))}))}function hyperlinksOption(e){return e===void 0?{}:{hyperlinks:e}}function resolveEffectiveHyperlinkOverride(e,t,n,r){return e?.hyperlinks??t?.hyperlinks??resolveHyperlinkOverride(n,r)}function buildCommandRunOptions(e,t,n){return{help:t,...n===void 0?{}:{meta:n},...e?.plugins===void 0?{}:{plugins:e.plugins},...e?.builtins===void 0?{}:{builtins:e.builtins},...e?.env===void 0?{}:{env:e.env},...e?.config===void 0?{}:{config:e.config},...e?.stdinData===void 0?{}:{stdinData:e.stdinData},...e?.prompter===void 0?{}:{prompter:e.prompter},...e?.answers===void 0?{}:{answers:e.answers},...e?.stat===void 0?{}:{stat:e.stat},...e?.mkdir===void 0?{}:{mkdir:e.mkdir},...e?.verbosity===void 0?{}:{verbosity:e.verbosity},...e?.jsonMode===void 0?{}:{jsonMode:e.jsonMode},...e?.isTTY===void 0?{}:{isTTY:e.isTTY},...e?.out===void 0?{}:{out:e.out},...e?.captured===void 0?{}:{captured:e.captured},...e?.flags===void 0?{}:{flags:e.flags}}}var CLIBuilder=class e{schema;constructor(e){this.schema=e}static _from(t,n){let r=new e(t);return compiledStates.set(r,n),r}version(e){return assertNoReservedFlagCollisions(e,[this.schema.defaultCommand,...this.schema.commands],this.schema.builtins),rebuild(this,{...this.schema,version:e})}builtins(e){let t={...e.help===void 0?{}:{help:e.help},...e.json===void 0?{}:{json:e.json},...e.quiet===void 0?{}:{quiet:e.quiet}},n=normalizeBuiltins({...this.schema.builtins,...t});return assertNoReservedFlagCollisions(this.schema.version,[this.schema.defaultCommand,...this.schema.commands],n),rebuild(this,sealCLISchema({...this.schema,builtins:n}))}description(e){return rebuild(this,{...this.schema,description:e})}links(e){return rebuild(this,{...this.schema,helpLinks:{name:toUrlString(e?.name),version:toUrlString(e?.version)}})}help(e){return rebuild(this,{...this.schema,helpConfig:{...this.schema.helpConfig,...e}})}config(e,t){return rebuild(this,sealCLISchema({...this.schema,configSettings:{appName:e,loaders:t}}))}configLoader(e){if(this.schema.configSettings===void 0)throw new CLIError(`.configLoader() requires .config() to be called first`,{code:`INVALID_BUILDER_STATE`,suggest:`Call .config(appName) before .configLoader()`});let t=this.schema.configSettings.loaders??[];return rebuild(this,sealCLISchema({...this.schema,configSettings:{...this.schema.configSettings,loaders:[...t,e]}}))}manifest(e){let t=buildManifestSchema(this.schema,e,DEFAULT_MANIFEST_FILES);return assertNoReservedFlagCollisions(t.version,[t.defaultCommand,...t.commands],t.builtins),rebuild(this,t)}command(t){assertNoTopLevelRouteConflict(this.schema.commands,t.schema,this.schema.defaultCommand),assertNoReservedFlagCollisions(this.schema.version,[t.schema],this.schema.builtins),this.schema.completionsFlag!==void 0&&assertNoCompletionsFlagCollision(t.schema);let n=compiledStateOf(this);return e._from({...this.schema,commands:[...this.schema.commands,t.schema]},{...n,commands:[...n.commands,compileCommand(t)]})}default(t,n){if(this.schema.defaultCommand!==void 0)throw new CLIError(`Only one default command is allowed`,{code:`DUPLICATE_DEFAULT`,suggest:`Call .default() only once when building the CLI`});assertNoTopLevelRouteConflict(this.schema.commands,t.schema),assertNoReservedFlagCollisions(this.schema.version,[t.schema],this.schema.builtins),this.schema.completionsFlag!==void 0&&assertNoCompletionsFlagCollision(t.schema);let r=compiledStateOf(this);return e._from({...this.schema,defaultCommand:t.schema,defaultCommandRouted:n?.route??!1},{...r,defaultCommand:compileCommand(t)})}plugin(t){let n=compiledStateOf(this);return e._from(this.schema,{...n,plugins:[...n.plugins,t]})}completions(e){if(this.schema.hasBuiltInCompletions)throw new CLIError(`.completions() has already been called`,{code:`DUPLICATE_COMMAND`,suggest:`Call .completions() only once when building the CLI`});if(e?.as===`flag`){this.schema.defaultCommand!==void 0&&assertNoCompletionsFlagCollision(this.schema.defaultCommand);for(let e of this.schema.commands)assertNoCompletionsFlagCollision(e);return rebuild(this,{...this.schema,hasBuiltInCompletions:!0,completionsFlag:{shells:SHELLS,options:completionGeneratorOptions(e)}})}let t=this.schema,n=completionGeneratorOptions(e),r=command(`completions`).alias(`completion`).description(`Generate shell completion script`).arg(`shell`,arg.custom(e=>{let t=normalizeShell(e);if(t===void 0)throw Error(`Unknown shell '${e}'. Valid shells: ${SHELLS.join(`, `)}`);return t}).env(`SHELL`).describe(`Target shell (${SHELLS.join(`, `)})`)).action(async({args:e,meta:r,out:i})=>{let a=r.bin===t.name?t:{...t,name:r.bin},{generateCompletion:o}=await import(`./completion-CUMeOnAz.mjs`).then(e=>e.t),s=o(a,e.shell,n);i.jsonMode?i.json({shell:e.shell,script:s}):i.log(s)}),i=this.command(r);return rebuild(i,{...i.schema,hasBuiltInCompletions:!0})}async execute(e,t){return executeCLI(this,e,t)}async run(e){let t=e?.adapter??createAdapter(),n=this.schema.inheritName?inferInvocationName(t.argv):void 0,r=compiledStateOf(this),i=await prepareRuntimePreflight({schema:this.schema,compiled:r,adapter:t,options:e,inheritedName:n});if(i.kind===`startup-error`)return i.jsonMode?t.stdout(`${JSON.stringify({error:i.error.toJSON()})}\n`):(t.stderr(`Error: ${i.error.message}\n`),i.error.suggest!==void 0&&t.stderr(`Suggestion: ${i.error.suggest}\n`)),exitAfterFlush(t,i.error.exitCode);let a=i.schema===this.schema?this:rebuild(this,sealCLISchema({...this.schema,...i.schema})),o=t.getTerminalSize(),s=e?.help?.width===void 0&&i.schema.helpConfig?.width===void 0?o?.columns:void 0,c=s===void 0?e?.help:{...e?.help,width:s},l=resolveEffectiveHyperlinkOverride(c,a.schema.helpConfig,t.env,t.argv),u={...e,...i.inputs,...c===void 0?{}:{help:c},out:createOutput({stdout:t.stdout,stderr:t.stderr,jsonMode:i.inputs.jsonMode,isTTY:i.inputs.isTTY,...i.inputs.verbosity===`normal`?{}:{verbosity:i.inputs.verbosity},...hyperlinksOption(l)})},d=await executeCLI(a,i.filteredArgv,u);for(let e of d.stdout)t.stdout(e);for(let e of d.stderr)t.stderr(e);return exitAfterFlush(t,d.exitCode)}};async function executeCLI(e,t,n){let r=readRootOutputFlags(t,e.schema.builtins),i=resolveRootJsonMode(r,n?.jsonMode),a=resolveRootVerbosity(r,n?.verbosity),o=resolveEffectiveHyperlinkOverride(n?.help,e.schema.helpConfig,n?.env??{},t),s={...a===void 0?{}:{verbosity:a},...i?{jsonMode:i}:{},...n?.isTTY===void 0?{}:{isTTY:n.isTTY},...hyperlinksOption(o)},c,l;n?.out===void 0?[c,l]=createCaptureOutput(Object.keys(s).length>0?s:void 0):(c=n.out,l=n.captured??{stdout:[],stderr:[],activity:[]}),clearRequestedExitCode(c);let u=n?.help?.version??e.schema.version,d={...e.schema.helpConfig,...n?.help,binName:n?.help?.binName??e.schema.name,hyperlinks:c.isHyperlinkSupported,colors:n?.help?.colors??c.color,...u===void 0?{}:{version:u}},f=compiledStateOf(e),p=n?.flags??e.schema.flagSettings,m={...n,plugins:f.plugins,builtins:e.schema.builtins,...i?{jsonMode:i}:{},...a===void 0?{}:{verbosity:a},...p===void 0?{}:{flags:p}},h={jsonMode:i,isTTY:c.isTTY,verbosity:a??`normal`},g=planInvocation({schema:n?.flags===void 0?e.schema:{...e.schema,flagSettings:p},compiled:f,argv:t,help:d,output:h});switch(g.kind){case`root-version`:return c.log(g.version),buildRunResult({exitCode:0,error:void 0},l);case`root-completions`:{let t=g.shell??detectShell(n?.env??{});if(t===void 0){let e=new CLIError(`Could not detect shell`,{code:`MISSING_VALUE`,suggest:`Pass one explicitly, e.g. '${d.binName} --completions zsh'`});return i?c.json({error:e.toJSON()}):(c.error(e.message),c.error(`Suggestion: ${e.suggest}`)),buildRunResult({exitCode:e.exitCode,error:e},l)}let r=d.binName===void 0||d.binName===e.schema.name?e.schema:{...e.schema,name:d.binName},{generateCompletion:a}=await import(`./completion-CUMeOnAz.mjs`).then(e=>e.t),o=a(r,t,g.options);return i?c.json({shell:t,script:o}):c.log(o),buildRunResult({exitCode:0,error:void 0},l)}case`root-help`:if(i){let{generateSchema:t}=await import(`./json-schema-DRlrz_IV.mjs`).then(e=>e.a);c.json(t(e.schema,void 0,{name:g.help.binName??e.schema.name,version:g.help.version??e.schema.version}))}else{let t=formatRootHelp(resolveHelpLinksSchema(e.schema),g.help);c.log(t)}return buildRunResult({exitCode:0,error:void 0},l);case`dispatch-error`:return i?c.json({error:g.error.toJSON()}):(c.error(g.error.message),g.error.suggest!==void 0&&g.error.code!==`NO_ACTION`&&c.error(`Suggestion: ${g.error.suggest}`)),buildRunResult({exitCode:g.error.exitCode,error:g.error},l);case`needs-subcommand`:if(i){let{generateCommandSchema:e}=await import(`./json-schema-DRlrz_IV.mjs`).then(e=>e.a);c.json(e(g.command.schema,void 0,{name:g.help.binName??g.command.schema.name,version:g.help.version}))}else{let e=formatHelp(g.command.schema,g.help);c.log(e)}return buildRunResult({exitCode:0,error:void 0},l);case`match`:{let e=buildCommandRunOptions(m,g.plan.help??d,g.plan.meta);return buildRunResult(await executeCommand({command:{handler:g.plan.command.handler,steps:g.plan.command.steps},argv:g.plan.argv,out:c,schema:g.plan.mergedSchema,meta:g.plan.meta,options:e}),l)}}}const RUNTIME_BINARIES=new Set([`bun`,`deno`,`node`,`tsx`]);function basename(e){let t=stripTrailing(e,[47,92]);if(t.length===0)return;let n=Math.max(t.lastIndexOf(`/`),t.lastIndexOf(`\\`)),r=n>=0?t.slice(n+1):t;return r.length>0?r:void 0}function isRuntimeBinaryName(e){let t=e.toLowerCase().replace(/\.exe$/i,``);return RUNTIME_BINARIES.has(t)}function inferInvocationName(e){let t=e[0],n=e[1],r=t===void 0?void 0:basename(t);if(r!==void 0&&isRuntimeBinaryName(r)){if(r===`bun`&&n===`run`){let t=e[2];return t===void 0||t.startsWith(`-`)?void 0:basename(t)}return r===`deno`&&n===`run`||n===void 0||n.startsWith(`-`)?void 0:basename(n)}return t===void 0?void 0:basename(t)}function toUrlString(e){if(e!==void 0)return e instanceof URL?e.href:e}function resolveHelpLinksSchema(e){return e.helpLinks===void 0?e:{...e,helpLinks:deriveHelpLinks(e.helpLinks,e.packageJsonSettings?.data,e.version)}}const DEFAULT_MANIFEST_FILES=[`package.json`];function normalizeInferName(e){return e===void 0||e===!1?{inferName:!1,stripScope:!0}:e===!0?{inferName:!0,stripScope:!0}:{inferName:!0,stripScope:e.scope!==`keep`}}function buildManifestSchema(e,t,n){if(isPackageJsonData(t))return{...e,...e.version===void 0&&t.version!==void 0?{version:t.version}:{},...e.description===void 0&&t.description!==void 0?{description:t.description}:{},packageJsonSettings:{inferName:!1,stripScope:!0,from:void 0,files:n,data:t}};let{inferName:r,stripScope:i}=normalizeInferName(t?.inferName),a=t?.files??n;return{...e,packageJsonSettings:{inferName:r,stripScope:i,from:normalizeFromSetting(t?.from),files:a,data:void 0}}}function normalizeFromSetting(e){if(e===void 0)return;let t=typeof e==`object`&&!(e instanceof URL)?e.url:e;if(t instanceof URL){if(t.protocol!==`file:`)return t.href}else if(!t.startsWith(`file:`))return t;let n=decodeURIComponent(new URL(t).pathname);return/^\/[A-Za-z]:/.test(n)?n.slice(1).replace(/\//g,`\\`):n}function isPackageJsonData(e){return typeof e!=`object`||!e||Array.isArray(e)?!1:`name`in e||`version`in e||`description`in e||`bin`in e||`homepage`in e||`repository`in e}function cli(e,t){let n=typeof e==`string`?{name:e,...t}:e,r=n.name??`cli`,i=n.inherit??!1;return CLIBuilder._from(createCLISchema({name:r,inheritName:i,flagSettings:n.flags}),{commands:[],defaultCommand:void 0,plugins:[]})}function isMainModule(e){return e.main===!0}const DEFINITION_SCHEMA_URL=`https://dreamcli.kjanat.dev/schemas/definition/v1.schema.json`,DEFINITION_SCHEMA_VERSION=1;function adapterReader(e){let t=e;return()=>(t??=createAdapter(),t)}function scriptName(e){let t=e.argv[1]??``,n=t.slice(Math.max(t.lastIndexOf(`/`),t.lastIndexOf(`\\`))+1);return n===``?`script`:n}function withoutUndeclaredTokens(e,t){let n=tokenize(e),r=[],i=0;for(;i<n.length;){let a=n[i],o=e[i];if(a===void 0||o===void 0)break;if(a.kind===`positional`||a.kind===`separator`){i++;continue}if(a.kind===`long-flag`){let s=t.get(a.name);if(i++,s===void 0)continue;if(r.push(o),!s.negated&&a.value===void 0&&flagExpectsValue(s.schema)){let t=e[i];n[i]?.kind===`positional`&&t!==void 0&&(r.push(t),i++)}continue}let s=``,c=!1;for(let e=0;e<a.chars.length;e++){let n=a.chars.charAt(e),r=t.get(n);if(r!==void 0&&(s+=n,flagExpectsValue(r.schema))){let t=a.chars.slice(e+1);t.length>0?s+=t:c=!0;break}}if(i++,s.length!==0&&(r.push(`-${s}`),c)){let t=e[i];n[i]?.kind===`positional`&&t!==void 0&&(r.push(t),i++)}}return r}async function readFlags(e,t){for(let t of Reflect.ownKeys(e))if(typeof t!=`string`||!Object.prototype.propertyIsEnumerable.call(e,t))throw new CLIError(`Flag definitions must use enumerable string keys`,{code:`INVALID_SCHEMA`});let n=Object.getPrototypeOf(e);if(n!==Object.prototype&&n!==null)throw new CLIError(`Flag definitions record has a replaced prototype. A '__proto__' key sets the prototype instead of adding a definition, and an inherited definition is never read`,{code:`INVALID_SCHEMA`,suggest:`Pass a plain object with no '__proto__' key, or a record built with Object.create(null)`});let r=Object.entries(e);for(let[e]of r)if(e===`__proto__`)throw new CLIError(`Flag name '${e}' is not usable as a flag`,{code:`INVALID_SCHEMA`,details:{flag:e},suggest:`Rename the definition key, for example to "proto"`});let i=createCommandSchema({name:`<standalone>`,flags:Object.fromEntries(r.map(([e,t])=>[e,t.schema]))}),a=adapterReader(t?.adapter),o=t?.argv??a().argv.slice(2),s=buildFlagLookup(i.flags,t?.parse);(t?.help??`on`)===`on`&&!s.has(`help`)&&!s.has(`h`)&&requestsHelp(o)&&(a().stdout(formatHelp(i,{binName:scriptName(a()),isDefaultHelp:!0})),await exitAfterFlush(a(),0));let c=parse(i,t?.strict===!1?withoutUndeclaredTokens(o,s):o,t?.parse),l=t?.stdinData===void 0&&invocationSelectsStdin(i.flags,i.args,c)?await a().readStdin():t?.stdinData,u=await resolve(i,c,{env:t?.env??a().env,stat:t?.stat??(e=>a().stat(e)),mkdir:t?.mkdir??(e=>a().mkdir(e)),...t?.config===void 0?{}:{config:t.config},...t?.prompter===void 0?{}:{prompter:t.prompter},...l===void 0?{}:{stdinData:l}});for(let e of u.deprecations)t?.onDeprecation?.(e);return t?.onSources?.(u.provenance.flags),u.flags}async function runCommand(e,t,n){return runCommandInternal(e,t,n)}async function runCommandInternal(e,t,n){let r=readRootOutputFlags(t,n?.builtins),i=resolveRootJsonMode(r,n?.jsonMode),a=resolveRootVerbosity(r,n?.verbosity),o=r.argv,s,c;if(n?.out!==void 0)s=n.out,c=n.captured??{stdout:[],stderr:[],activity:[]};else{let e={...a===void 0?{}:{verbosity:a},...i?{jsonMode:i}:{},...n?.isTTY===void 0?{}:{isTTY:n.isTTY}};[s,c]=createCaptureOutput(Object.keys(e).length>0?e:void 0)}if(r.kind===`failed`&&!(builtinEnabled(n?.builtins,`help`)&&requestsHelp(o))){let{error:e}=r;return i?s.json({error:e.toJSON()}):(s.error(e.message),e.suggest!==void 0&&s.error(`Suggestion: ${e.suggest}`)),buildRunResult({exitCode:e.exitCode,error:e},c)}let l=n?.mergedSchema??e.schema,u=n?.meta??{name:l.name,bin:n?.help?.binName??l.name,version:void 0,command:l.name},d=n===void 0?i?{jsonMode:i}:void 0:{...n,...i?{jsonMode:i}:{}};return buildRunResult(await executeCommand({command:{handler:e.handler,steps:e._executionSteps},argv:o,out:s,schema:l,meta:u,...d===void 0?{}:{options:d}}),c)}export{ParseError as $,createCaptureOutput as A,resolveExampleCommand as B,flagExpectsValue as C,tokenize as D,stripBeforeSeparator as E,visibleWidth as F,getFlagNegatedName as G,createFlagSchema as H,CommandBuilder as I,createArgSchema as J,ArgBuilder as K,command as L,formatHelp as M,resolvePlainHelpDescription as N,wasExplicit as O,osc8 as P,CLIError as Q,createCommandSchema as R,resolvePromptConfig as S,parse as T,flag as U,FlagBuilder as V,getFlagAliasNames as W,SPLIT_FORMATS as X,DUPLICATE_KEYS as Y,builtinEnabled as Z,detectRuntime as _,CLIBuilder as a,createTestAdapter as b,isMainModule as c,plugin as d,ValidationError as et,collectPropagatedFlags as f,RUNTIMES as g,createNodeAdapter as h,DEFINITION_SCHEMA_VERSION as i,SHELLS as it,createOutput as j,middleware as k,resolveRenderContext as l,createAdapter as m,readFlags as n,isParseError as nt,cli as o,packageRepositoryUrl as p,arg as q,DEFINITION_SCHEMA_URL as r,isValidationError as rt,createCLISchema as s,runCommand as t,isCLIError as tt,resolveRootSurface as u,createDenoAdapter as v,includesBeforeSeparator as w,resolve as x,ExitError as y,group as z};
@@ -1,52 +0,0 @@
1
- import{t as __exportAll}from"./rolldown-runtime-G4Kt5YOX.mjs";import{B as resolveExampleCommand,N as resolvePlainHelpDescription,W as getFlagAliasNames,Y as DUPLICATE_KEYS,r as DEFINITION_SCHEMA_URL}from"./core-DvXUolc_.mjs";const definitionMetaSchemaDescriptions={root:{description:`Runtime descriptor for the CLI program.
2
-
3
- Stores the program name, version, description, and registered command schemas.\\
4
- Sealed by createCLISchema and rebuilt by each CLIBuilder step.`,properties:{name:{description:`Program name (used in help text, usage lines, and completion scripts).`},version:{description:"Program version (shown by `--version`)."},description:{description:`Program description (shown in root help).`},defaultCommand:{description:`Schema of the default command dispatched when no subcommand matches.
5
-
6
- When set, the CLI root behaves like a hybrid command group: subcommands
7
- dispatch by name as usual, but empty argv or flags-only argv falls
8
- through to this command instead of showing root help.
9
-
10
- Set via the .default() builder method
11
- or the \`defaultCommand\` field of CLIDefinition.`},commands:{description:`Schemas of the registered commands, in registration order.`}}},defs:{command:{description:`Runtime descriptor produced by CommandBuilder.
12
-
13
- Consumers (parser, help generator, CLI dispatcher) read this to
14
- understand the command's shape — flags, args, aliases, subcommands,
15
- and interactive resolver.`,properties:{name:{description:"The command name (used for dispatch, e.g. `'deploy'`)."},description:{description:`Human-readable description for help text.`},aliases:{description:`Alternative names for this command.`},hidden:{description:`Whether this command is hidden from help listings.`},examples:{description:`Usage examples for help text.`},flags:{description:`Named flag schemas, keyed by flag name.`},args:{description:`Ordered positional arg entries (name + schema).`},commands:{description:"Nested subcommand schemas (for help rendering and completion).\n\nPure data — no execution closures. Populated by `.command()` on\n`CommandBuilder`. Empty for leaf commands."}}},commandDocument:{description:`A single-command definition document, version 1.
16
-
17
- Produced by generateCommandSchema. Same shape as a
18
- CommandDefinitionFragmentV1 plus the \`schemaVersion\` every standalone
19
- document carries.`,properties:{schemaVersion:{description:"Version of the definition document format emitted by `generateSchema()`\nand `generateCommandSchema()` from `@kjanat/dreamcli/json-schema`."},name:{description:`The command name used for dispatch.`},description:{description:`Human-readable description for help text.`},aliases:{description:`Alternative names accepted for this command.`},hidden:{description:`Whether the command is omitted from help listings.`},examples:{description:`Usage examples attached to the command.`},flags:{description:`Named flag definitions keyed by flag name.`},args:{description:`Positional argument definitions in CLI order.`},commands:{description:`Nested subcommand definitions.`}}},flag:{description:`The runtime descriptor stored inside every FlagBuilder. Consumers (parser,
20
- help generator, resolution chain) read this to understand the flag's shape
21
- without touching generics.`,properties:{kind:{description:`What kind of value this flag accepts.`},presence:{description:"Presence describes whether a flag value is guaranteed to exist when the\naction handler runs:\n\n- `'optional'` — not required; unresolved value follows the kind-specific\n optional fallback (`undefined` for most flags, `[]` for arrays)\n- `'required'` — must be supplied; error if missing\n- `'defaulted'` — always present (falls back to default value)"},defaultValue:{description:`Runtime default value (if any).`},aliases:{description:"Short/long aliases (e.g. `[{ name: 'f', hidden: false }]` for `--force`)."},stdin:{description:"Stdin binding set by `.stdin()` (`undefined` when the flag never reads\nstdin). See StdinBinding."},envVar:{description:`Environment variable name for v0.2+ resolution.`},configPath:{description:"Dotted config path for v0.2+ resolution (e.g. `'deploy.region'`)."},description:{description:`Human-readable description for help text.`},enumValues:{description:"Allowed literal values when `kind === 'enum'`."},elementSchema:{description:"Element schema when `kind === 'array'` or `kind === 'keyValue'`."},prompt:{description:`Interactive prompt configuration for v0.3+ resolution.`},deprecated:{description:"Deprecation marker.\n\n- `undefined` — not deprecated (default)\n- `true` — deprecated with no migration message\n- `string` — deprecated with a reason/migration message\n\nWhen a deprecated flag is used, a warning is emitted to stderr.\nHelp text shows `[deprecated]` or `[deprecated: <reason>]`."},propagate:{description:`Whether this flag propagates to subcommands in nested command trees.
22
-
23
- When \`true\`, the flag is automatically available to all descendant
24
- commands. A child command that defines a flag with the same name
25
- shadows the propagated parent flag.
26
-
27
- Default: \`false\``},negation:{description:"Negation settings when `kind === 'boolean'` and `.negatable()` was\ncalled (`undefined` otherwise). See FlagNegation."},duplicates:{description:"How repeated CLI occurrences of a singleton flag combine.\n\n- `'last'` — last occurrence wins (matches historic behavior)\n- `'first'` — first occurrence wins; later ones parse but are ignored\n- `'error'` — a second occurrence is a `ParseError` (`DUPLICATE_FLAG`)\n\nApplies to CLI token occurrences only — env/config/prompt/default\nresolution keeps its precedence semantics and never raises duplicates.\nOccurrences are counted per *logical* flag: aliases and the negated\nspelling all count toward the same flag.\n\nDefault: `'last'`"},defaultDescription:{description:"Human-readable replacement for the default value in help, or `false` to\nomit the default annotation."},sensitive:{description:`Whether values from this input must be kept out of user-facing projections.`}}},flagElement:{description:"Element schema when `kind === 'array'` or `kind === 'keyValue'`.",properties:{kind:{description:`What kind of value this flag accepts.`},presence:{description:"Presence describes whether a flag value is guaranteed to exist when the\naction handler runs:\n\n- `'optional'` — not required; unresolved value follows the kind-specific\n optional fallback (`undefined` for most flags, `[]` for arrays)\n- `'required'` — must be supplied; error if missing\n- `'defaulted'` — always present (falls back to default value)"},defaultValue:{description:`Runtime default value (if any).`},aliases:{description:"Short/long aliases (e.g. `[{ name: 'f', hidden: false }]` for `--force`)."},stdin:{description:"Stdin binding set by `.stdin()` (`undefined` when the flag never reads\nstdin). See StdinBinding."},envVar:{description:`Environment variable name for v0.2+ resolution.`},configPath:{description:"Dotted config path for v0.2+ resolution (e.g. `'deploy.region'`)."},description:{description:`Human-readable description for help text.`},enumValues:{description:"Allowed literal values when `kind === 'enum'`."},elementSchema:{description:"Element schema when `kind === 'array'` or `kind === 'keyValue'`."},prompt:{description:`Interactive prompt configuration for v0.3+ resolution.`},deprecated:{description:"Deprecation marker.\n\n- `undefined` — not deprecated (default)\n- `true` — deprecated with no migration message\n- `string` — deprecated with a reason/migration message\n\nWhen a deprecated flag is used, a warning is emitted to stderr.\nHelp text shows `[deprecated]` or `[deprecated: <reason>]`."},propagate:{description:`Whether this flag propagates to subcommands in nested command trees.
28
-
29
- When \`true\`, the flag is automatically available to all descendant
30
- commands. A child command that defines a flag with the same name
31
- shadows the propagated parent flag.
32
-
33
- Default: \`false\``},negation:{description:"Negation settings when `kind === 'boolean'` and `.negatable()` was\ncalled (`undefined` otherwise). See FlagNegation."},duplicates:{description:"How repeated CLI occurrences of a singleton flag combine.\n\n- `'last'` — last occurrence wins (matches historic behavior)\n- `'first'` — first occurrence wins; later ones parse but are ignored\n- `'error'` — a second occurrence is a `ParseError` (`DUPLICATE_FLAG`)\n\nApplies to CLI token occurrences only — env/config/prompt/default\nresolution keeps its precedence semantics and never raises duplicates.\nOccurrences are counted per *logical* flag: aliases and the negated\nspelling all count toward the same flag.\n\nDefault: `'last'`"}}},stdin:{description:`The normalized stdin axis of a flag or an arg.`,properties:{when:{description:`When this input reads the stdin stream.`},consume:{description:`Whether this input consumes the stream alone.`},trim:{description:`Whether one trailing line terminator is dropped from a single value.`}}},negation:{description:`Negation settings for a boolean flag (set by \`.negatable()\`).
34
-
35
- The negated spelling and the positive form are two spellings of ONE
36
- logical flag: they share duplicate policy, and the last CLI occurrence
37
- wins across both. The negated spelling is presence-only — \`--no-foo=x\`
38
- is rejected.`,properties:{alias:{description:"Explicit negated spelling without the `--` prefix (e.g. `'no-sandbox'`).\n`undefined` synthesizes `no-<flagName>` wherever the flag name is known."},hidden:{description:`Hide the negated spelling from help, completions, and suggestions.`}}},arg:{description:`The runtime descriptor stored inside every ArgBuilder. Consumers (parser,
39
- help generator) read this to understand the arg's shape without touching
40
- generics.`,properties:{name:{description:`A named positional argument entry in the command schema.
41
-
42
- Pairs a user-facing arg name with its ArgSchema descriptor.
43
- The array ordering in CommandSchema.args determines CLI position.`},kind:{description:`What kind of value this arg accepts.`},presence:{description:"Presence describes whether a positional arg is guaranteed to exist when the\naction handler runs:\n\n- `'required'` — must be supplied; error if missing (default)\n- `'optional'` — may be `undefined` if not supplied\n- `'defaulted'` — always present (falls back to default value)"},variadic:{description:`Whether this arg consumes all remaining positionals.`},stdin:{description:"Stdin binding set by `.stdin()` (`undefined` when the arg never reads\nstdin). See StdinBinding."},defaultValue:{description:`Runtime default value (if any).`},defaultDescription:{description:"Human-readable replacement for the default value in help, or `false` to\nomit the default annotation."},sensitive:{description:`Whether values from this input must be kept out of user-facing projections.`},description:{description:`Human-readable description for help text.`},envVar:{description:`Environment variable name for env resolution.
44
-
45
- When set and the CLI value is absent, the resolver reads this env var
46
- and coerces the string to the arg's declared kind.`},configPath:{description:"Dotted config path for config resolution (e.g. `'deploy.region'`)."},prompt:{description:`Interactive prompt configuration.`},enumValues:{description:"Allowed literal values when `kind === 'enum'`."},elementSchema:{description:"Element schema when `kind === 'keyValue'`.\n\nDescribes the value of each entry, so `arg.keyValue(arg.number())` decodes\n`A=1` to the number `1`. `undefined` leaves entry values as strings."},deprecated:{description:"Deprecation marker.\n\n- `undefined` — not deprecated (default)\n- `true` — deprecated with no migration message\n- `string` — deprecated with a reason/migration message\n\nWhen a deprecated arg is used, a warning is emitted to stderr.\nHelp text shows `[deprecated]` or `[deprecated: <reason>]`."}}},argElement:{description:"Element schema when `kind === 'keyValue'`.\n\nDescribes the value of each entry, so `arg.keyValue(arg.number())` decodes\n`A=1` to the number `1`. `undefined` leaves entry values as strings.",properties:{kind:{description:`What kind of value this arg accepts.`},presence:{description:`Entry values are required once their containing key-value argument is present.`},enumValues:{description:"Allowed literal values when `kind === 'enum'`."}}},prompt:{description:"Discriminated union of all prompt configurations.\n\nUse the `kind` field to narrow:\n```ts\nif (config.kind === 'select') {\n config.choices // readonly SelectChoice[] | undefined\n}\n```",properties:{kind:{description:"The kind of interactive prompt to present.\n\n- `'confirm'` — yes/no boolean question\n- `'input'` — free-text string input\n- `'select'` — single selection from a list\n- `'multiselect'` — multiple selections from a list"},message:{description:`The question displayed to the user.`},placeholder:{description:`Placeholder text shown before user types (informational only).`},choices:{description:"Available choices. When omitted for `enum` flags, the enum values\nfrom the flag schema are used automatically."},min:{description:`Minimum number of selections required.
47
-
48
- Default: \`0\``},max:{description:`Maximum number of selections allowed.
49
-
50
- Default: \`Infinity\``}}},choice:{description:`A selectable option for SelectPromptConfig and MultiselectPromptConfig prompts.`,properties:{value:{description:`The value returned when this choice is selected.`},label:{description:`Display label shown to the user.
51
-
52
- Default: value`},description:{description:`Optional description shown alongside the choice.`}}},example:{description:`A single usage example shown in help text.`,properties:{command:{description:"The command invocation (e.g. `'deploy production --force'`)."},description:{description:`Optional description of what this example does.`}}}}};var json_schema_exports=__exportAll({DEFINITION_SCHEMA_URL:()=>DEFINITION_SCHEMA_URL,DEFINITION_SCHEMA_VERSION:()=>1,definitionMetaSchema:()=>definitionMetaSchema,generateCommandSchema:()=>generateCommandSchema,generateInputSchema:()=>generateInputSchema,generateSchema:()=>generateSchema});function resolveOptions(e){return{includeHidden:e?.includeHidden??!0,includePrompts:e?.includePrompts??!0}}const JSON_SCHEMA_DRAFT=`https://json-schema.org/draft/2020-12/schema`;function generateSchema(e,t,n){let r=resolveOptions(t),i=n??{name:e.name,version:e.version},a=e.defaultCommand!==void 0&&(r.includeHidden||!e.defaultCommand.hidden)?serializeCommand(e.defaultCommand,r,i):void 0;return{$schema:DEFINITION_SCHEMA_URL,schemaVersion:1,name:e.name,...e.version===void 0?{}:{version:e.version},...e.description===void 0?{}:{description:resolvePlainHelpDescription(e.description)},...a===void 0?{}:{defaultCommand:a},commands:e.commands.filter(e=>r.includeHidden||!e.hidden).map(e=>serializeCommand(e,r,i))}}function generateCommandSchema(e,t,n){let r=n??{name:e.name,version:void 0};return{schemaVersion:1,...serializeCommand(e,resolveOptions(t),r)}}function serializeCommand(e,t,n){let r={};for(let[n,i]of Object.entries(e.flags))r[n]=serializeFlag(i,t);return{name:e.name,...e.description===void 0?{}:{description:resolvePlainHelpDescription(e.description)},...e.aliases.length>0?{aliases:[...e.aliases]}:{},...e.hidden?{hidden:!0}:{},...e.examples.length>0?{examples:e.examples.map(e=>serializeExample(e,n))}:{},flags:r,args:e.args.map(e=>serializeArgEntry(e,t)),commands:e.commands.filter(e=>t.includeHidden||!e.hidden).map(e=>serializeCommand(e,t,n))}}function serializeFlag(e,t,n=!1){let r=getFlagAliasNames(e),i=e.stringConstraints,a=e.pathChecks,o=e.negation,s=n||e.sensitive;return{kind:e.kind,presence:e.presence,...!s&&isJsonSerializable(e.defaultValue)?{defaultValue:e.defaultValue}:{},...e.defaultDescription===void 0?{}:{defaultDescription:e.defaultDescription},...e.sensitive?{sensitive:!0}:{},...r.length>0?{aliases:[...r]}:{},...e.stdin===void 0?{}:{stdin:serializeStdin(e.stdin)},...e.envVar===void 0?{}:{envVar:e.envVar},...e.configPath===void 0?{}:{configPath:e.configPath},...e.description===void 0?{}:{description:resolvePlainHelpDescription(e.description)},...e.enumValues===void 0?{}:{enumValues:[...e.enumValues]},...e.numberConstraints===void 0?{}:{numberConstraints:{...e.numberConstraints}},...i===void 0?{}:{stringConstraints:serializeStringConstraints(i)},...e.elementSchema===void 0?{}:{elementSchema:serializeFlag(e.elementSchema,t,s)},...e.separator===void 0?{}:{separator:e.separator},...e.split===void 0?{}:{split:serializeSplit(e.split)},...e.duplicateKeys===`last`?{}:{duplicateKeys:e.duplicateKeys},...e.unique?{unique:!0}:{},...a===void 0?{}:{pathChecks:serializePathChecks(a)},...e.valueHint===void 0?{}:{valueHint:e.valueHint},...t.includePrompts&&e.prompt!==void 0?{prompt:serializePrompt(e.prompt)}:{},...e.deprecated===void 0?{}:{deprecated:e.deprecated},...e.propagate?{propagate:!0}:{},...o===void 0?{}:{negation:{...o.alias===void 0?{}:{alias:o.alias},...o.hidden?{hidden:!0}:{}}},...e.duplicates===`last`?{}:{duplicates:e.duplicates}}}function serializeStringConstraints(e){let t=e.pattern;return{...e.nonEmpty===void 0?{}:{nonEmpty:e.nonEmpty},...e.minLength===void 0?{}:{minLength:e.minLength},...e.maxLength===void 0?{}:{maxLength:e.maxLength},...t===void 0?{}:{pattern:{source:t.source,flags:t.flags}}}}function serializePathChecks(e){return{mustExist:e.mustExist,...e.type===void 0?{}:{type:e.type},...e.create?{create:!0}:{}}}function serializeArgEntry(e,t){return{name:e.name,...serializeArgValue(e.schema,t)}}function serializeArgValue(e,t){let n=e.stringConstraints,r=e.pathChecks;return{kind:e.kind,presence:e.presence,...e.variadic?{variadic:!0}:{},...e.stdin===void 0?{}:{stdin:serializeStdin(e.stdin)},...!e.sensitive&&isJsonSerializable(e.defaultValue)?{defaultValue:e.defaultValue}:{},...e.defaultDescription===void 0?{}:{defaultDescription:e.defaultDescription},...e.sensitive?{sensitive:!0}:{},...e.description===void 0?{}:{description:resolvePlainHelpDescription(e.description)},...e.envVar===void 0?{}:{envVar:e.envVar},...e.configPath===void 0?{}:{configPath:e.configPath},...e.enumValues===void 0?{}:{enumValues:[...e.enumValues]},...e.elementSchema===void 0?{}:{elementSchema:serializeArgElementValue(e.elementSchema)},...e.numberConstraints===void 0?{}:{numberConstraints:{...e.numberConstraints}},...n===void 0?{}:{stringConstraints:serializeStringConstraints(n)},...r===void 0?{}:{pathChecks:serializePathChecks(r)},...e.valueHint===void 0?{}:{valueHint:e.valueHint},...e.separator===void 0?{}:{separator:e.separator},...e.split===void 0?{}:{split:serializeSplit(e.split)},...e.duplicateKeys===`last`?{}:{duplicateKeys:e.duplicateKeys},...e.unique?{unique:!0}:{},...t.includePrompts&&e.prompt!==void 0?{prompt:serializePrompt(e.prompt)}:{},...e.deprecated===void 0?{}:{deprecated:e.deprecated}}}function serializeArgElementValue(e){if(e.kind===`keyValue`)throw TypeError(`Arg element schema kind 'keyValue' is not supported`);return{kind:e.kind,presence:`required`,...e.enumValues===void 0?{}:{enumValues:[...e.enumValues]},...e.numberConstraints===void 0?{}:{numberConstraints:{...e.numberConstraints}},...e.stringConstraints===void 0?{}:{stringConstraints:serializeStringConstraints(e.stringConstraints)},...e.pathChecks===void 0?{}:{pathChecks:serializePathChecks(e.pathChecks)},...e.valueHint===void 0?{}:{valueHint:e.valueHint}}}function serializeSplit(e){return{...e.env===void 0?{}:{env:{...e.env}},...e.stdin===void 0?{}:{stdin:{...e.stdin}}}}function serializeStdin(e){return{when:e.when,consume:e.consume,trim:e.trim}}function serializePrompt(e){switch(e.kind){case`input`:return{kind:e.kind,message:e.message,...e.placeholder===void 0?{}:{placeholder:e.placeholder}};case`select`:return{kind:e.kind,message:e.message,...e.choices===void 0?{}:{choices:e.choices.map(serializeChoice)}};case`multiselect`:return{kind:e.kind,message:e.message,...e.choices===void 0?{}:{choices:e.choices.map(serializeChoice)},...e.min===void 0?{}:{min:e.min},...e.max===void 0?{}:{max:e.max}};case`confirm`:return{kind:e.kind,message:e.message}}}function serializeChoice(e){return{value:e.value,...e.label===void 0?{}:{label:e.label},...e.description===void 0?{}:{description:e.description}}}function serializeExample(e,t){return{command:resolveExampleCommand(e.command,t),...e.description===void 0?{}:{description:e.description}}}function generateInputSchema(e,t){let n=resolveOptions(t);if(isCommandSchema(e))return{$schema:JSON_SCHEMA_DRAFT,...commandToInputSchema(e)};let r=[];e.defaultCommand!==void 0&&(n.includeHidden||!e.defaultCommand.hidden)&&collectInputBranches(e.defaultCommand,``,r,n);for(let t of e.commands)t!==e.defaultCommand&&t.name!==e.defaultCommand?.name&&(n.includeHidden||!t.hidden)&&collectInputBranches(t,``,r,n);let[i]=r;if(r.length===1&&i!==void 0)return{$schema:JSON_SCHEMA_DRAFT,...stripCommandDiscriminator(i)};if(r.length>0){let t=e.defaultCommand!==void 0&&(n.includeHidden||!e.defaultCommand.hidden)?e.defaultCommand.name:void 0,i=t===void 0?r:r.map(e=>getBranchCommandDiscriminator(e)===t?stripCommandDiscriminator(e):e);return{$schema:JSON_SCHEMA_DRAFT,oneOf:i}}return{$schema:JSON_SCHEMA_DRAFT,type:`object`}}function isCommandSchema(e){return`flags`in e&&`args`in e&&`hasAction`in e}function collectInputBranches(e,t,n,r){let i=t?`${t}.${e.name}`:e.name;e.hasAction&&n.push(commandToInputSchema(e,i));for(let t of e.commands)(r.includeHidden||!t.hidden)&&collectInputBranches(t,i,n,r)}function commandToInputSchema(e,t){let n={},r=[];t!==void 0&&(n.command={const:t},r.push(`command`));for(let[t,i]of Object.entries(e.flags))n[t]=flagToJsonSchemaType(i),i.presence===`required`&&r.push(t);for(let t of e.args)n[t.name]=argToJsonSchemaType(t.schema),t.schema.presence===`required`&&r.push(t.name);return{type:`object`,properties:n,additionalProperties:!1,...r.length>0?{required:r}:{}}}function stripCommandDiscriminator(e){let{command:t,...n}=e.properties,r=e.required?.filter(e=>e!==`command`);return{type:e.type,properties:n,additionalProperties:e.additionalProperties,...r!==void 0&&r.length>0?{required:r}:{}}}function getBranchCommandDiscriminator(e){let t=e.properties.command;if(t===void 0)return;let n=t.const;return typeof n==`string`?n:void 0}function stringConstraintsToJsonSchemaProperties(e){let t={},n=e?.nonEmpty===!0?Math.max(e.minLength??1,1):e?.minLength;return n!==void 0&&(t.minLength=n),e?.maxLength!==void 0&&(t.maxLength=e.maxLength),e?.pattern!==void 0&&(t.pattern=e.pattern.source),t}function flagToJsonSchemaType(e,t=!1){let n={},r=t||e.sensitive;switch(e.kind){case`string`:n.type=`string`,Object.assign(n,stringConstraintsToJsonSchemaProperties(e.stringConstraints));break;case`number`:{let t=e.numberConstraints;n.type=t?.int===!0?`integer`:`number`,t?.min!==void 0&&(n.minimum=t.min),t?.max!==void 0&&(n.maximum=t.max);break}case`boolean`:n.type=`boolean`;break;case`enum`:n.type=`string`,e.enumValues!==void 0&&(n.enum=[...e.enumValues]);break;case`array`:n.type=`array`,e.elementSchema!==void 0&&(n.items=flagToJsonSchemaType(e.elementSchema,r));break;case`custom`:break;case`count`:n.type=`integer`,n.minimum=0;break;case`keyValue`:n.type=`object`,n.additionalProperties=e.elementSchema===void 0?{type:`string`}:flagToJsonSchemaType(e.elementSchema,r)}return e.description!==void 0&&(n.description=resolvePlainHelpDescription(e.description)),e.sensitive&&(n.writeOnly=!0),!r&&isJsonSerializable(e.defaultValue)&&(n.default=e.defaultValue),e.deprecated!==void 0&&(n.deprecated=e.deprecated),n}function argToJsonSchemaType(e){let t=argKindToType(e),n=e.variadic&&e.kind!==`keyValue`?{type:`array`,items:t}:{...t};return e.description!==void 0&&(n.description=resolvePlainHelpDescription(e.description)),e.sensitive&&(n.writeOnly=!0),!e.sensitive&&isJsonSerializable(e.defaultValue)&&(n.default=e.defaultValue),e.deprecated!==void 0&&(n.deprecated=e.deprecated),n}function argKindToType(e){switch(e.kind){case`string`:return{type:`string`,...stringConstraintsToJsonSchemaProperties(e.stringConstraints)};case`number`:{let t=e.numberConstraints,n={type:t?.int===!0?`integer`:`number`};return t?.min!==void 0&&(n.minimum=t.min),t?.max!==void 0&&(n.maximum=t.max),n}case`enum`:{let t={type:`string`};return e.enumValues!==void 0&&(t.enum=[...e.enumValues]),t}case`boolean`:return{type:`boolean`};case`keyValue`:return{type:`object`,additionalProperties:e.elementSchema===void 0?{type:`string`}:argKindToType(e.elementSchema)};case`custom`:return{}}}function isJsonSerializable(e,t=new WeakSet){if(e===void 0)return!1;if(e===null)return!0;let n=typeof e;if(n===`string`||n===`boolean`)return!0;if(n===`number`)return Number.isFinite(e);if(n===`function`||n===`symbol`||n===`bigint`)return!1;if(Array.isArray(e)){if(t.has(e))return!1;t.add(e);try{return e.every(e=>isJsonSerializable(e,t))}finally{t.delete(e)}}if(n===`object`){let n=e;if(!isPlainJsonObject(n)||t.has(n))return!1;t.add(n);try{return Object.values(n).every(e=>isJsonSerializable(e,t))}finally{t.delete(n)}}return!1}function isPlainJsonObject(e){let t=Object.getPrototypeOf(e);return t===Object.prototype||t===null}function withDefinitionDescriptions(e,t){let n=e.properties,r=typeof n==`object`&&n&&isPlainJsonObject(n)&&t.properties!==void 0?Object.fromEntries(Object.entries(n).map(([e,n])=>{let r=t.properties?.[e];return r===void 0||typeof n!=`object`||!n||!isPlainJsonObject(n)?[e,n]:[e,withDefinitionDescriptions(n,r)]})):void 0;return{...e,...t.description===void 0?{}:{description:t.description},...r===void 0?{}:{properties:r}}}function withDefinitionMetaSchemaDescriptions(e,t){let n=withDefinitionDescriptions(e,t.root),r=n.$defs;return typeof r!=`object`||!r||!isPlainJsonObject(r)?n:{...n,$defs:Object.fromEntries(Object.entries(r).map(([e,n])=>{let r=t.defs[e];return r===void 0||typeof n!=`object`||!n||!isPlainJsonObject(n)?[e,n]:[e,withDefinitionDescriptions(n,r)]}))}}const commandFragmentProperties={name:{type:`string`},description:{type:`string`},aliases:{type:`array`,items:{type:`string`}},hidden:{const:!0},examples:{type:`array`,items:{$ref:`#/$defs/example`}},flags:{type:`object`,additionalProperties:{$ref:`#/$defs/flag`}},args:{type:`array`,items:{$ref:`#/$defs/arg`}},commands:{type:`array`,items:{$ref:`#/$defs/command`}}},argValueFragmentProperties={kind:{enum:[`string`,`number`,`boolean`,`enum`,`custom`,`keyValue`]},presence:{enum:[`required`,`optional`,`defaulted`]},variadic:{const:!0},stdin:{$ref:`#/$defs/stdin`},defaultValue:{},defaultDescription:{oneOf:[{type:`string`},{const:!1}]},sensitive:{const:!0},description:{type:`string`},envVar:{type:`string`},configPath:{type:`string`},enumValues:{type:`array`,items:{type:`string`}},elementSchema:{$ref:`#/$defs/argElement`},numberConstraints:{$ref:`#/$defs/numberConstraints`},stringConstraints:{$ref:`#/$defs/stringConstraints`},pathChecks:{$ref:`#/$defs/pathChecks`},valueHint:{type:`string`},separator:{type:`string`,minLength:1},split:{$ref:`#/$defs/split`},duplicateKeys:{enum:[...DUPLICATE_KEYS]},unique:{const:!0},prompt:{$ref:`#/$defs/prompt`},deprecated:{oneOf:[{type:`string`},{const:!0}]}},argElementFragmentProperties={kind:{enum:[`string`,`number`,`boolean`,`enum`,`custom`]},presence:{const:`required`},enumValues:{type:`array`,items:{type:`string`}},numberConstraints:{$ref:`#/$defs/numberConstraints`},stringConstraints:{$ref:`#/$defs/stringConstraints`},pathChecks:{$ref:`#/$defs/pathChecks`},valueHint:{type:`string`}},flagElementFragmentProperties={kind:{enum:[`string`,`number`,`boolean`,`enum`,`array`,`custom`,`count`,`keyValue`]},presence:{enum:[`optional`,`required`,`defaulted`]},defaultValue:{},aliases:{type:`array`,items:{type:`string`}},stdin:{$ref:`#/$defs/stdin`},envVar:{type:`string`},configPath:{type:`string`},description:{type:`string`},enumValues:{type:`array`,items:{type:`string`}},numberConstraints:{$ref:`#/$defs/numberConstraints`},stringConstraints:{$ref:`#/$defs/stringConstraints`},elementSchema:{$ref:`#/$defs/flagElement`},separator:{type:`string`,minLength:1},split:{$ref:`#/$defs/split`},duplicateKeys:{enum:[...DUPLICATE_KEYS]},unique:{const:!0},pathChecks:{$ref:`#/$defs/pathChecks`},valueHint:{type:`string`},prompt:{$ref:`#/$defs/prompt`},deprecated:{oneOf:[{type:`string`},{const:!0}]},propagate:{const:!0},negation:{$ref:`#/$defs/negation`},duplicates:{enum:[`last`,`first`,`error`]}},flagFragmentProperties={...flagElementFragmentProperties,defaultDescription:{oneOf:[{type:`string`},{const:!1}]},sensitive:{const:!0}},definitionMetaSchema=withDefinitionMetaSchemaDescriptions({$schema:JSON_SCHEMA_DRAFT,$id:DEFINITION_SCHEMA_URL,title:`@kjanat/dreamcli definition schema`,description:`Describes the structure of a CLI built with dreamcli — commands, flags, args, types, constraints, env bindings, and prompts.`,type:`object`,additionalProperties:!1,properties:{$schema:{const:DEFINITION_SCHEMA_URL},schemaVersion:{const:1},name:{type:`string`},version:{type:`string`},description:{type:`string`},defaultCommand:{$ref:`#/$defs/command`},commands:{type:`array`,items:{$ref:`#/$defs/command`}}},required:[`$schema`,`schemaVersion`,`name`,`commands`],$defs:{command:{type:`object`,additionalProperties:!1,properties:commandFragmentProperties,required:[`name`,`flags`,`args`,`commands`]},commandDocument:{type:`object`,additionalProperties:!1,properties:{schemaVersion:{const:1},...commandFragmentProperties},required:[`schemaVersion`,`name`,`flags`,`args`,`commands`]},flag:{type:`object`,additionalProperties:!1,properties:flagFragmentProperties,required:[`kind`,`presence`]},flagElement:{type:`object`,additionalProperties:!1,properties:flagElementFragmentProperties,required:[`kind`,`presence`]},stdin:{type:`object`,additionalProperties:!1,properties:{when:{enum:[`dash`,`missing`,`dash-or-missing`]},consume:{enum:[`exclusive`,`broadcast`]},trim:{type:`boolean`}},required:[`when`,`consume`]},split:{type:`object`,additionalProperties:!1,properties:{env:{$ref:`#/$defs/splitPolicy`},stdin:{$ref:`#/$defs/splitPolicy`}}},splitPolicy:{type:`object`,additionalProperties:!1,properties:{format:{enum:[`whole`,`delimiter`,`lines`,`json`]},delimiter:{type:`string`,minLength:1}},required:[`format`],oneOf:[{properties:{format:{const:`delimiter`}},required:[`format`,`delimiter`]},{properties:{format:{enum:[`whole`,`lines`,`json`]}},not:{required:[`delimiter`]}}]},negation:{type:`object`,additionalProperties:!1,properties:{alias:{type:`string`},hidden:{const:!0}}},numberConstraints:{type:`object`,additionalProperties:!1,properties:{min:{type:`number`},max:{type:`number`},int:{type:`boolean`},finite:{type:`boolean`}}},stringConstraints:{type:`object`,additionalProperties:!1,properties:{nonEmpty:{type:`boolean`},minLength:{type:`integer`,minimum:0},maxLength:{type:`integer`,minimum:0},pattern:{type:`object`,additionalProperties:!1,properties:{source:{type:`string`},flags:{type:`string`}},required:[`source`,`flags`]}}},pathChecks:{type:`object`,additionalProperties:!1,properties:{mustExist:{type:`boolean`},type:{enum:[`file`,`directory`]},create:{const:!0}},required:[`mustExist`]},argElement:{type:`object`,additionalProperties:!1,properties:argElementFragmentProperties,required:[`kind`,`presence`]},arg:{type:`object`,additionalProperties:!1,properties:{name:{type:`string`},...argValueFragmentProperties},required:[`name`,`kind`,`presence`],anyOf:[{not:{required:[`elementSchema`]}},{properties:{kind:{const:`keyValue`}},required:[`kind`]}]},prompt:{type:`object`,additionalProperties:!1,properties:{kind:{enum:[`confirm`,`input`,`select`,`multiselect`]},message:{type:`string`},placeholder:{type:`string`},choices:{type:`array`,items:{$ref:`#/$defs/choice`}},min:{type:`integer`},max:{type:`integer`}},required:[`kind`,`message`]},choice:{type:`object`,additionalProperties:!1,properties:{value:{type:`string`},label:{type:`string`},description:{type:`string`}},required:[`value`]},example:{type:`object`,additionalProperties:!1,properties:{command:{type:`string`},description:{type:`string`}},required:[`command`]}}},definitionMetaSchemaDescriptions);export{json_schema_exports as a,generateSchema as i,generateCommandSchema as n,generateInputSchema as r,definitionMetaSchema as t};
@@ -1,3 +0,0 @@
1
- import{t as __exportAll}from"./rolldown-runtime-G4Kt5YOX.mjs";var package_json_exports=__exportAll({discoverManifest:()=>discoverManifest,inferCliName:()=>inferCliName});function isPlainObject(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function parentDir(e){let t=e.lastIndexOf(`/`),n=e.lastIndexOf(`\\`),r=Math.max(t,n),i=n>t?`\\`:`/`;if(r<0)return;if(r===0)return e.length>1?i:void 0;let a=e.slice(0,r);if(a.length===2&&a[1]===`:`){let t=`${a}${i}`;return t===e?void 0:t}return a}function joinPath(e,t){let n=e.includes(`\\`)?`\\`:`/`;return e.endsWith(n)?`${e}${t}`:`${e}${n}${t}`}const DEFAULT_MANIFEST_FILES=[`package.json`];function manifestHasMetadata(e){return e.name!==void 0||e.version!==void 0||e.description!==void 0||e.bin!==void 0||e.homepage!==void 0||e.repository!==void 0}async function discoverManifest(e,t={}){let n=t.files??DEFAULT_MANIFEST_FILES,r=t.startDir??e.cwd;for(;r!==void 0;){for(let t of n){let n=null;try{n=await e.readFile(joinPath(r,t))}catch{}if(n!==null){let e=parsePackageJson(n);if(e!==null&&manifestHasMetadata(e))return e}}r=parentDir(r)}return null}function isJsonWhitespace(e){return e===` `||e===` `||e===`
2
- `||e===`\r`}function stripJsonc(e){let t=``,n=!1,r=!1;for(let i=0;i<e.length;i+=1){let a=e[i]??``;if(n){t+=a,r?r=!1:a===`\\`?r=!0:a===`"`&&(n=!1);continue}if(a===`"`){n=!0,t+=a;continue}if(a===`/`&&e[i+1]===`/`){for(i+=2;i<e.length&&e[i]!==`
3
- `;)i+=1;--i;continue}if(a===`/`&&e[i+1]===`*`){for(i+=2;i<e.length&&(e[i]!==`*`||e[i+1]!==`/`);)i+=1;i+=1;continue}t+=a}let i=``;n=!1,r=!1;for(let e=0;e<t.length;e+=1){let a=t[e]??``;if(n){i+=a,r?r=!1:a===`\\`?r=!0:a===`"`&&(n=!1);continue}if(a===`"`){n=!0,i+=a;continue}if(a===`,`){let n=e+1;for(;n<t.length&&isJsonWhitespace(t[n]??``);)n+=1;let r=t[n];if(r===`}`||r===`]`)continue}i+=a}return i}function parsePackageJson(e){let t;try{t=JSON.parse(e)}catch{try{t=JSON.parse(stripJsonc(e))}catch{return null}}try{if(!isPlainObject(t))return null;let e=typeof t.name==`string`?t.name:void 0,n=typeof t.version==`string`?t.version:void 0,r=typeof t.description==`string`?t.description:void 0,i=parseBinField(t.bin),a=typeof t.homepage==`string`?t.homepage:void 0,o=parseRepositoryField(t.repository);return{...e===void 0?{}:{name:e},...n===void 0?{}:{version:n},...r===void 0?{}:{description:r},...i===void 0?{}:{bin:i},...a===void 0?{}:{homepage:a},...o===void 0?{}:{repository:o}}}catch{return null}}function parseBinField(e){if(typeof e==`string`)return e;if(!isPlainObject(e))return;let t={};for(let[n,r]of Object.entries(e)){if(typeof r!=`string`)return;t[n]=r}return t}function parseRepositoryField(e){if(typeof e==`string`)return e;if(!isPlainObject(e))return;let t=typeof e.type==`string`?e.type:void 0,n=typeof e.url==`string`?e.url:void 0,r=typeof e.directory==`string`?e.directory:void 0;if(t!==void 0||n!==void 0||r!==void 0)return{...t===void 0?{}:{type:t},...n===void 0?{}:{url:n},...r===void 0?{}:{directory:r}}}function inferCliName(e,t={}){if(typeof e.bin==`object`){let t=Object.keys(e.bin);if(t.length>0&&t[0]!==void 0)return t[0]}if(e.name!==void 0){if(t.stripScope===!1)return e.name;let n=e.name.indexOf(`/`);return n>=0?e.name.slice(n+1):e.name}}export{inferCliName as n,package_json_exports as r,discoverManifest as t};
@@ -1,6 +0,0 @@
1
- import{t as __exportAll}from"./rolldown-runtime-G4Kt5YOX.mjs";var terminal_exports=__exportAll({createTerminalPrompter:()=>createTerminalPrompter});function createTerminalPrompter(e,t){return{promptOne(n){switch(n.kind){case`confirm`:return promptConfirm(n,e,t);case`input`:return promptInput(n,e,t);case`select`:return promptSelect(n,e,t);case`multiselect`:return promptMultiselect(n,e,t)}}}}async function promptConfirm(e,t,n){let r=e.default??!0,i=0;for(;i<10;){let a=r?`(Y/n)`:`(y/N)`;n(`${e.message} ${a} `);let o=await t();if(o===null)return{answered:!1};let s=o.trim().toLowerCase();if(s===``)return{answered:!0,value:r};if(s===`y`||s===`yes`)return{answered:!0,value:!0};if(s===`n`||s===`no`)return{answered:!0,value:!1};n(`Please answer y or n.
2
- `),i+=1}return n(`Too many invalid attempts.
3
- `),{answered:!1}}async function promptInput(e,t,n){let r=0,i=[];e.placeholder!==void 0&&i.push(e.placeholder),e.default!==void 0&&i.push(`default: ${e.default}`);let a=i.length>0?` (${i.join(`, `)})`:``;for(;r<10;){n(`${e.message}${a}: `);let i=await t();if(i===null)return{answered:!1};let o=i.trim();if(o===``)return e.default===void 0?{answered:!0,value:``}:{answered:!0,value:e.default};if(e.validate!==void 0){let t=e.validate(o);if(t!==!0){n(`${t}\n`),r+=1;continue}}return{answered:!0,value:o}}return n(`Too many invalid attempts.
4
- `),{answered:!1}}async function promptSelect(e,t,n){let r=0;for(;r<10;){n(`${e.message}\n`);for(let t=0;t<e.choices.length;t+=1){let r=e.choices[t];if(r===void 0)continue;let i=r.label??r.value,a=r.description===void 0?``:` - ${r.description}`;n(` ${t+1}) ${i}${a}\n`)}n(`Enter number: `);let i=await t();if(i===null)return{answered:!1};let a=Number(i.trim());if(Number.isNaN(a)||!Number.isInteger(a)||a<1||a>e.choices.length){n(`Please enter a number between 1 and ${e.choices.length}.\n`),r+=1;continue}let o=e.choices[a-1];if(o===void 0){r+=1;continue}return{answered:!0,value:o.value}}return n(`Too many invalid attempts.
5
- `),{answered:!1}}async function promptMultiselect(e,t,n){let r=0;for(;r<10;){n(`${e.message}\n`);for(let t=0;t<e.choices.length;t+=1){let r=e.choices[t];if(r===void 0)continue;let i=r.label??r.value,a=r.description===void 0?``:` - ${r.description}`;n(` ${t+1}) ${i}${a}\n`)}n(`Enter numbers separated by commas (e.g. 1,3${e.min===void 0?``:`, min: ${e.min}`}${e.max===void 0?``:`, max: ${e.max}`}): `);let i=await t();if(i===null)return{answered:!1};let a=i.trim();if(a===``){if(e.min!==void 0&&e.min>0){n(`Please select at least ${e.min}.\n`),r+=1;continue}return{answered:!0,value:[]}}let o=a.split(`,`).map(e=>e.trim()),s=[],c=!0;for(let t of o){let r=Number(t);if(Number.isNaN(r)||!Number.isInteger(r)||r<1||r>e.choices.length){n(`Invalid selection '${t}'. Use numbers between 1 and ${e.choices.length}.\n`),c=!1;break}s.push(r)}if(!c){r+=1;continue}let l=[...new Set(s)];if(e.min!==void 0&&l.length<e.min){n(`Please select at least ${e.min}.\n`),r+=1;continue}if(e.max!==void 0&&l.length>e.max){n(`Please select at most ${e.max}.\n`),r+=1;continue}return{answered:!0,value:l.map(t=>e.choices[t-1]?.value??``)}}return n(`Too many invalid attempts.
6
- `),{answered:!1}}export{terminal_exports as n,createTerminalPrompter as t};
@@ -1 +0,0 @@
1
- import{t as __exportAll}from"./rolldown-runtime-G4Kt5YOX.mjs";var test_prompter_exports=__exportAll({PROMPT_CANCEL:()=>PROMPT_CANCEL,createTestPrompter:()=>createTestPrompter});const PROMPT_CANCEL=Symbol.for(`dreamcli.prompt.cancel`);function createTestPrompter(e,t){let n=0;return{promptOne(r){if(n>=e.length)return t?.onExhausted===`cancel`?Promise.resolve({answered:!1}):Promise.reject(Error(`Test prompter exhausted: expected at most ${e.length} prompts, got prompt #${n+1}`));let i=e[n];return n+=1,i===PROMPT_CANCEL||r.kind===`input`&&r.validate!==void 0&&typeof i==`string`&&r.validate(i)!==!0?Promise.resolve({answered:!1}):Promise.resolve({answered:!0,value:i})}}}export{createTestPrompter as n,test_prompter_exports as r,PROMPT_CANCEL as t};