@politty/zod 0.7.4 → 0.7.6

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.
@@ -439,6 +439,13 @@ interface CommandBase<TArgsSchema extends ArgsSchema | undefined = undefined, TA
439
439
  interface RunnableCommand<TArgsSchema extends ArgsSchema | undefined = undefined, TArgs = unknown, TResult = unknown> extends CommandBase<TArgsSchema, TArgs> {
440
440
  /** Main run function */
441
441
  run: (args: TArgs) => TResult;
442
+ /**
443
+ * Under `runMain`, end the command normally when SIGINT or SIGTERM arrives
444
+ * while `run` is executing: the first signal only aborts `args.$signal`, and
445
+ * the exit code, error and cleanup follow how `run` settles. A second signal
446
+ * interrupts as usual. A signal before `run` starts always interrupts.
447
+ */
448
+ gracefulShutdown?: boolean | undefined;
442
449
  /** Not settable alongside `run` (see `NonRunnableCommand.defaultSubCommand`) */
443
450
  defaultSubCommand?: undefined;
444
451
  }
@@ -450,6 +457,8 @@ interface RunnableCommand<TArgsSchema extends ArgsSchema | undefined = undefined
450
457
  interface NonRunnableCommand<TArgsSchema extends ArgsSchema | undefined = undefined, TArgs = unknown> extends CommandBase<TArgsSchema, TArgs> {
451
458
  /** No run function */
452
459
  run?: undefined;
460
+ /** Not settable without `run` (see `RunnableCommand.gracefulShutdown`) */
461
+ gracefulShutdown?: undefined;
453
462
  /**
454
463
  * Name of a `subCommands` entry to run when this command is invoked with
455
464
  * no subcommand specified, instead of showing help. Used for CLI plugin
package/dist/augment.d.ts CHANGED
@@ -11,7 +11,7 @@
11
11
  * // Now ArgMeta can be stored in Zod's global registry
12
12
  * ```
13
13
  */
14
- import { n as ArgMeta } from "./arg-registry-biPCZomY.js";
14
+ import { n as ArgMeta } from "./arg-registry-DNUJtjsZ.js";
15
15
  declare module "zod" {
16
16
  interface ZodTypeDef {
17
17
  argMeta?: ArgMeta;
@@ -0,0 +1 @@
1
+ export{t as runPolittyCli}from"./cli-main-BOiqNyRU.js";
@@ -1,2 +1,2 @@
1
- import{d as e,f as t}from"./schema-extractor-Cwg_WAC-.js";import{n}from"./command-BXsTrIgI.js";import{n as r}from"./runner-DiDJDnhR.js";import{chmodSync as i,existsSync as a,mkdirSync as o,readFileSync as s,writeFileSync as c}from"node:fs";import{basename as l,dirname as u,extname as d,isAbsolute as f,join as p,relative as m,resolve as h}from"node:path";import{fileURLToPath as g}from"node:url";const _=`Generated by politty: compile-cache bin shim`,v=[`./cli.js`,`./cli.mjs`,`./index.js`,`./index.mjs`];function y(e){let t=h(e);for(;;){let e=p(t,`package.json`);if(a(e))return{pkg:JSON.parse(s(e,`utf8`)),dir:t};let n=u(t);if(n===t)return;t=n}}function b(e){if(!e)return[];if(typeof e.bin==`string`&&e.bin){let t=x(e);return t?[[t,e.bin]]:[]}return typeof e.bin==`object`&&e.bin!==null?Object.entries(e.bin).filter(e=>typeof e[1]==`string`&&e[1]!==``):[]}function x(e){if(e){if(typeof e.bin==`object`&&e.bin!==null){let[t]=Object.keys(e.bin);if(t)return t}if(typeof e.name==`string`&&e.name){let t=e.name;return t.startsWith(`@`)?t.split(`/`)[1]??t:t}}}function S(e){let t=u(e),n=l(e);for(let e of v)if(l(e)!==n&&a(p(t,e)))return e}function C(e,t,n){return[`#!/usr/bin/env node`,``,`// ${_}.`,`// Enables the Node.js on-disk compile cache (V8 code cache) before the`,`// CLI module graph is compiled, so warm starts skip recompilation`,`// (Node >= 22.8.0; silent no-op otherwise).`,`try {`,` const { enableCompileCache } = await import(${JSON.stringify(n)});`,` enableCompileCache(${JSON.stringify(e)});`,`} catch {`,` // ${n} is not resolvable from here (e.g. a fully`,` // bundled CLI) — start without the compile cache rather than failing`,` // the CLI.`,`}`,`await import(${JSON.stringify(t)});`,``].join(`
2
- `)}function w(e){return e===void 0?[]:Array.isArray(e)?e:[e]}function T(e){return(t={})=>E(`${e}/compile-cache`,t)}function E(e,t){let n=t.cwd??process.cwd(),r=y(n),l=r?.pkg,p=w(t.entry),m=w(t.out),T=b(l),E;if(m.length>0){if(p.length>0&&p.length!==m.length)throw Error(`--entry count (${p.length}) does not match --out count (${m.length}); pass one --out per --entry or omit --out entirely.`);E=m.map(e=>f(e)?e:h(n,e))}else{if(T.length===0||r===void 0)throw Error(`Cannot derive the output path: no bin entry in package.json. Pass --out explicitly.`);if(p.length>0&&p.length!==T.length)throw Error(`--entry count (${p.length}) does not match the package's bin entries (${T.length}); pass one --entry per bin (in declaration order) or matching --out paths.`);E=T.map(([,e])=>h(r.dir,e))}if(new Set(E).size!==E.length)throw Error(`Duplicate output paths; each shim needs a distinct output file. Check the --out values (or the bin paths in package.json when --out is omitted).`);let O=/* @__PURE__ */ new Map;if(r)for(let[e,t]of T)O.set(h(r.dir,t),e);let k=[],A=t.compileCacheSpecifier??e;if(/[\r\n\u2028\u2029]/.test(A))throw Error(`Invalid compile-cache specifier ${JSON.stringify(A)}: a module specifier cannot contain a line terminator.`);let j=E.map((e,r)=>{let i=O.get(e),o=t.program??i??x(l);if(!o)throw Error(`Cannot derive a program name: no bin or name in package.json. Pass --program explicitly.`);if(t.program===void 0&&i===void 0&&m.length>0&&k.push(`Warning: ${D(e,n)} does not match any bin path in package.json, so its cache directory uses the program name ${JSON.stringify(o)}. Pass --program to override.`),e.endsWith(`.cjs`))throw Error(`The generated shim is an ES module and cannot be written to a .cjs file. Use a .mjs (or .js in a "type": "module" package) output path.`);if(d(e)===``)throw Error(`The generated shim is an ES module and cannot be written to an extensionless file (it would not load on every supported Node.js version). Use a .mjs (or .js in a "type": "module" package) output path.`);if(e.endsWith(`.js`)&&l?.type!==`module`)throw Error(l===void 0?`The generated shim is an ES module, and no package.json was found to confirm .js files are treated as ESM. Write it to a .mjs file instead (e.g. --out dist/bin.mjs).`:`The generated shim is an ES module, but the package is not "type": "module". Write it to a .mjs file instead (e.g. --out dist/bin.mjs).`);let c=p[r]??S(e);if(c===void 0)throw Error(`Cannot derive an entry: none of ${v.join(`, `)} exist next to ${e}. Pass --entry explicitly.`);if(!c.startsWith(`./`)&&!c.startsWith(`../`)&&!c.startsWith(`file:`))throw Error(`Invalid entry ${c}: pass a specifier relative to the shim file ("./..." or "../...") or a file: URL.`);let f;if(c.startsWith(`file:`))try{f=g(c)}catch{f=void 0}else f=h(u(e),c);if(f===e)throw Error(`The shim at ${e} would import itself (entry ${c}). Point bin at a separate shim path (e.g. dist/bin.js) or pass a different --entry.`);if(a(e)&&!s(e,`utf8`).includes(_))throw Error(`Refusing to overwrite ${e}: it exists and was not generated by politty. If bin currently points at your real CLI entry, point it at a separate shim path (e.g. dist/bin.js) or pass --out explicitly.`);return{outputPath:e,program:o,entry:c,compileCacheSpecifier:A}});for(let e of k)console.warn(e);for(let{outputPath:e,program:t,entry:n}of j)o(u(e),{recursive:!0}),c(e,C(t,n,A)),i(e,493);return j}function D(e,t){let n=m(t,e);return n&&!n.startsWith(`..`)?n:e}const O=e({bin:t.string({description:`CLI binary or built JS entry file to invoke`,placeholder:`PATH`}),program:t.string({description:`Program name embedded in worker metadata`,placeholder:`NAME`}),shell:t.enum([`bash`,`zsh`,`fish`],{description:`Shell worker to generate`,placeholder:`SHELL`}),out:t.optionalString({description:`Output worker path (defaults to dist/completion/<shell>-worker.<ext>)`,placeholder:`PATH`}),verify:t.boolean({description:`Verify __completion-worker-path resolves to the generated worker`})}),k=n({name:`generate-worker`,description:`Generate and verify a bundled shell completion worker`,args:O,async run(e){let{generateBundledCompletionWorker:t}=await import(`./completion-CqEkkWNL.js`);await t({bin:e.bin,programName:e.program,shell:e.shell,...e.out!==void 0&&{outputPath:e.out},verify:e.verify})}}),A=e({entry:t.optionalStringArray({description:`Module specifier the shim imports, relative to the shim file; repeatable, one per bin/--out (defaults to ./cli.js, ./cli.mjs, ./index.js, or ./index.mjs next to each shim)`,placeholder:`SPECIFIER`}),out:t.optionalStringArray({description:`Output path for the generated shim; repeatable, one per --entry (defaults to the bin paths in package.json)`,placeholder:`PATH`}),program:t.optionalString({description:`Program name for the cache directory, applied to all shims (defaults per shim to its bin name)`,placeholder:`NAME`}),compileCacheSpecifier:t.optionalString({description:`Module specifier the shim imports enableCompileCache from (defaults to the compile-cache subpath of the politty package running this command)`,placeholder:`SPECIFIER`})});function j(e){let t=T(e),i=n({name:`generate-shim`,description:`Generate a compile-cache bin shim that loads the real CLI via dynamic import`,args:A,run(e){let n=process.cwd(),r=t({...e.entry!==void 0&&{entry:e.entry},...e.out!==void 0&&{out:e.out},...e.program!==void 0&&{program:e.program},...e.compileCacheSpecifier!==void 0&&{compileCacheSpecifier:e.compileCacheSpecifier},cwd:n});for(let e of r)console.log(`Generated compile-cache shim: ${D(e.outputPath,n)} (program: ${e.program}, entry: ${e.entry}, compile-cache: ${e.compileCacheSpecifier})`)}}),a=n({name:`politty`,description:`politty development utilities`,subCommands:{"generate-shim":i,"generate-worker":k}});return r(a).catch(e=>{console.error(e instanceof Error?e.message:String(e)),process.exit(1)})}export{T as n,j as t};
1
+ import{d as e,f as t}from"./schema-extractor-Cwg_WAC-.js";import{n}from"./command-CCiN78NV.js";import{n as r}from"./runner-C0PI1zBE.js";import{chmodSync as i,existsSync as a,mkdirSync as o,readFileSync as s,writeFileSync as c}from"node:fs";import{basename as l,dirname as u,extname as d,isAbsolute as f,join as p,relative as m,resolve as h}from"node:path";import{fileURLToPath as g}from"node:url";const _=`Generated by politty: compile-cache bin shim`,v=[`./cli.js`,`./cli.mjs`,`./index.js`,`./index.mjs`];function y(e){let t=h(e);for(;;){let e=p(t,`package.json`);if(a(e))return{pkg:JSON.parse(s(e,`utf8`)),dir:t};let n=u(t);if(n===t)return;t=n}}function b(e){if(!e)return[];if(typeof e.bin==`string`&&e.bin){let t=x(e);return t?[[t,e.bin]]:[]}return typeof e.bin==`object`&&e.bin!==null?Object.entries(e.bin).filter(e=>typeof e[1]==`string`&&e[1]!==``):[]}function x(e){if(e){if(typeof e.bin==`object`&&e.bin!==null){let[t]=Object.keys(e.bin);if(t)return t}if(typeof e.name==`string`&&e.name){let t=e.name;return t.startsWith(`@`)?t.split(`/`)[1]??t:t}}}function S(e){let t=u(e),n=l(e);for(let e of v)if(l(e)!==n&&a(p(t,e)))return e}function C(e,t,n){return[`#!/usr/bin/env node`,``,`// ${_}.`,`// Enables the Node.js on-disk compile cache (V8 code cache) before the`,`// CLI module graph is compiled, so warm starts skip recompilation`,`// (Node >= 22.8.0; silent no-op otherwise).`,`try {`,` const { enableCompileCache } = await import(${JSON.stringify(n)});`,` enableCompileCache(${JSON.stringify(e)});`,`} catch {`,` // ${n} is not resolvable from here (e.g. a fully`,` // bundled CLI) — start without the compile cache rather than failing`,` // the CLI.`,`}`,`await import(${JSON.stringify(t)});`,``].join(`
2
+ `)}function w(e){return e===void 0?[]:Array.isArray(e)?e:[e]}function T(e){return(t={})=>E(`${e}/compile-cache`,t)}function E(e,t){let n=t.cwd??process.cwd(),r=y(n),l=r?.pkg,p=w(t.entry),m=w(t.out),T=b(l),E;if(m.length>0){if(p.length>0&&p.length!==m.length)throw Error(`--entry count (${p.length}) does not match --out count (${m.length}); pass one --out per --entry or omit --out entirely.`);E=m.map(e=>f(e)?e:h(n,e))}else{if(T.length===0||r===void 0)throw Error(`Cannot derive the output path: no bin entry in package.json. Pass --out explicitly.`);if(p.length>0&&p.length!==T.length)throw Error(`--entry count (${p.length}) does not match the package's bin entries (${T.length}); pass one --entry per bin (in declaration order) or matching --out paths.`);E=T.map(([,e])=>h(r.dir,e))}if(new Set(E).size!==E.length)throw Error(`Duplicate output paths; each shim needs a distinct output file. Check the --out values (or the bin paths in package.json when --out is omitted).`);let O=/* @__PURE__ */ new Map;if(r)for(let[e,t]of T)O.set(h(r.dir,t),e);let k=[],A=t.compileCacheSpecifier??e;if(/[\r\n\u2028\u2029]/.test(A))throw Error(`Invalid compile-cache specifier ${JSON.stringify(A)}: a module specifier cannot contain a line terminator.`);let j=E.map((e,r)=>{let i=O.get(e),o=t.program??i??x(l);if(!o)throw Error(`Cannot derive a program name: no bin or name in package.json. Pass --program explicitly.`);if(t.program===void 0&&i===void 0&&m.length>0&&k.push(`Warning: ${D(e,n)} does not match any bin path in package.json, so its cache directory uses the program name ${JSON.stringify(o)}. Pass --program to override.`),e.endsWith(`.cjs`))throw Error(`The generated shim is an ES module and cannot be written to a .cjs file. Use a .mjs (or .js in a "type": "module" package) output path.`);if(d(e)===``)throw Error(`The generated shim is an ES module and cannot be written to an extensionless file (it would not load on every supported Node.js version). Use a .mjs (or .js in a "type": "module" package) output path.`);if(e.endsWith(`.js`)&&l?.type!==`module`)throw Error(l===void 0?`The generated shim is an ES module, and no package.json was found to confirm .js files are treated as ESM. Write it to a .mjs file instead (e.g. --out dist/bin.mjs).`:`The generated shim is an ES module, but the package is not "type": "module". Write it to a .mjs file instead (e.g. --out dist/bin.mjs).`);let c=p[r]??S(e);if(c===void 0)throw Error(`Cannot derive an entry: none of ${v.join(`, `)} exist next to ${e}. Pass --entry explicitly.`);if(!c.startsWith(`./`)&&!c.startsWith(`../`)&&!c.startsWith(`file:`))throw Error(`Invalid entry ${c}: pass a specifier relative to the shim file ("./..." or "../...") or a file: URL.`);let f;if(c.startsWith(`file:`))try{f=g(c)}catch{f=void 0}else f=h(u(e),c);if(f===e)throw Error(`The shim at ${e} would import itself (entry ${c}). Point bin at a separate shim path (e.g. dist/bin.js) or pass a different --entry.`);if(a(e)&&!s(e,`utf8`).includes(_))throw Error(`Refusing to overwrite ${e}: it exists and was not generated by politty. If bin currently points at your real CLI entry, point it at a separate shim path (e.g. dist/bin.js) or pass --out explicitly.`);return{outputPath:e,program:o,entry:c,compileCacheSpecifier:A}});for(let e of k)console.warn(e);for(let{outputPath:e,program:t,entry:n}of j)o(u(e),{recursive:!0}),c(e,C(t,n,A)),i(e,493);return j}function D(e,t){let n=m(t,e);return n&&!n.startsWith(`..`)?n:e}const O=e({bin:t.string({description:`CLI binary or built JS entry file to invoke`,placeholder:`PATH`}),program:t.string({description:`Program name embedded in worker metadata`,placeholder:`NAME`}),shell:t.enum([`bash`,`zsh`,`fish`],{description:`Shell worker to generate`,placeholder:`SHELL`}),out:t.optionalString({description:`Output worker path (defaults to dist/completion/<shell>-worker.<ext>)`,placeholder:`PATH`}),verify:t.boolean({description:`Verify __completion-worker-path resolves to the generated worker`})}),k=n({name:`generate-worker`,description:`Generate and verify a bundled shell completion worker`,args:O,async run(e){let{generateBundledCompletionWorker:t}=await import(`./completion-Bbe2Q4Y-.js`);await t({bin:e.bin,programName:e.program,shell:e.shell,...e.out!==void 0&&{outputPath:e.out},verify:e.verify})}}),A=e({entry:t.optionalStringArray({description:`Module specifier the shim imports, relative to the shim file; repeatable, one per bin/--out (defaults to ./cli.js, ./cli.mjs, ./index.js, or ./index.mjs next to each shim)`,placeholder:`SPECIFIER`}),out:t.optionalStringArray({description:`Output path for the generated shim; repeatable, one per --entry (defaults to the bin paths in package.json)`,placeholder:`PATH`}),program:t.optionalString({description:`Program name for the cache directory, applied to all shims (defaults per shim to its bin name)`,placeholder:`NAME`}),compileCacheSpecifier:t.optionalString({description:`Module specifier the shim imports enableCompileCache from (defaults to the compile-cache subpath of the politty package running this command)`,placeholder:`SPECIFIER`})});function j(e){let t=T(e),i=n({name:`generate-shim`,description:`Generate a compile-cache bin shim that loads the real CLI via dynamic import`,args:A,run(e){let n=process.cwd(),r=t({...e.entry!==void 0&&{entry:e.entry},...e.out!==void 0&&{out:e.out},...e.program!==void 0&&{program:e.program},...e.compileCacheSpecifier!==void 0&&{compileCacheSpecifier:e.compileCacheSpecifier},cwd:n});for(let e of r)console.log(`Generated compile-cache shim: ${D(e.outputPath,n)} (program: ${e.program}, entry: ${e.entry}, compile-cache: ${e.compileCacheSpecifier})`)}}),a=n({name:`politty`,description:`politty development utilities`,subCommands:{"generate-shim":i,"generate-worker":k}});return r(a).catch(e=>{console.error(e instanceof Error?e.message:String(e)),process.exit(1)})}export{T as n,j as t};
@@ -1 +1 @@
1
- import"./register-BWzt6u5k.js";const{runPolittyCli:e}=await import(`./cli-main-C5qAhJ76.js`);await e(`@politty/zod`);export{};
1
+ import"./register-BWzt6u5k.js";const{runPolittyCli:e}=await import(`./cli-main-BI_Kw8IO.js`);await e(`@politty/zod`);export{};
package/dist/cli.js CHANGED
@@ -1,2 +1,2 @@
1
1
  #!/usr/bin/env node
2
- import{n as e}from"./compile-cache-6u9hgeWu.js";e(`politty`),await import(`./cli-run-BfRSJZlf.js`);export{};
2
+ import{n as e}from"./compile-cache-6u9hgeWu.js";e(`politty`),await import(`./cli-run-BAIMC_bn.js`);export{};
@@ -1 +1 @@
1
- function e(e){return{name:e.name,description:e.description,requiredPackages:e.requiredPackages,aliases:e.aliases,args:e.args,subCommands:e.subCommands,defaultSubCommand:e.defaultSubCommand,setup:e.setup,run:e.run,cleanup:e.cleanup,notes:e.notes,examples:e.examples}}function t(){return e}export{e as n,t};
1
+ function e(e){return{name:e.name,description:e.description,requiredPackages:e.requiredPackages,aliases:e.aliases,args:e.args,subCommands:e.subCommands,defaultSubCommand:e.defaultSubCommand,setup:e.setup,run:e.run,gracefulShutdown:e.gracefulShutdown,cleanup:e.cleanup,notes:e.notes,examples:e.examples}}function t(){return e}export{e as n,t};
@@ -0,0 +1 @@
1
+ import"./with-completion-command-gytc9LNl.js";import"./dynamic-D9Y4kkfj.js";export{t as createCompletionCommand,n as createCompletionWorkerPathCommand,r as createRefreshCompletionCommand,c as generateBundledCompletionWorker}from"./completion-CKXI6y7R.js";
@@ -1,4 +1,4 @@
1
- import{n as e}from"./command-BXsTrIgI.js";import{_ as t,c as n,d as r,f as i,g as a,h as o,i as s,l as c,m as l,p as u,s as d,t as f,u as p,v as m,y as h}from"./dynamic-RKGUiswZ.js";import{a as g,c as _,n as v}from"./schema-extractor-Cwg_WAC-.js";import{c as y}from"./subcommand-router-CfCW9eG4.js";import{a as b,i as ee,n as x,o as te,r as ne,s as re}from"./with-completion-command-BojrmP1a.js";import{existsSync as S,mkdirSync as ie,readFileSync as C,realpathSync as w,renameSync as ae,rmSync as oe,statSync as T,writeFileSync as se}from"node:fs";import{dirname as E,extname as ce,isAbsolute as le,join as ue,relative as de,resolve as fe}from"node:path";import{promisify as pe}from"node:util";import{execFile as me}from"node:child_process";function he(e,t,n=[],r=!1){if(t.length===0)return;let i=ge(e,n);for(let e of t)e.set(_e(e,i,r))}function ge(e,t){let n=/* @__PURE__ */ new Map,r=/* @__PURE__ */ new Set;for(let t of[...e.options,...e.positionals])r.add(t.name);let i=(e,t)=>{for(let i of e){if(n.has(i.name)||t&&r.has(i.name))continue;let e=i.valueCompletion;e?.type===`choices`&&e.choices&&e.choices.length>0&&n.set(i.name,e.choices)}};return i([...e.options,...e.positionals],!1),i(t,!0),n}function _e(e,t,n=!1){let{spec:r}=e,i=r.dependsOn;if(i.length===0)throw Error(`Field "${e.describe}": completion.custom.expand.dependsOn must list at least one sibling arg.`);let a=[];for(let n of i){if(n===e.name)throw Error(`Field "${e.describe}": completion.custom.expand.dependsOn cannot reference the field itself ("${n}").`);let r=t.get(n);if(!r)throw Error(`Field "${e.describe}": completion.custom.expand.dependsOn references "${n}", which is not a sibling arg with a static \`choices\`/enum schema on the same command. Chaining expand specs is not supported.`);a.push([...r])}if(n)return{type:`expand`,dependsOn:i,table:[]};let o=[];for(let t of ye(a)){let n={};i.forEach((e,r)=>{n[e]=t[r]});let a;try{a=r.enumerate(n)}catch(t){let r=t instanceof Error?t.message:String(t);throw Error(`Field "${e.describe}": completion.custom.expand.enumerate threw for deps=${JSON.stringify(n)}: ${r}`)}let s=ve(a);s.length!==0&&o.push({key:t,candidates:s})}return{type:`expand`,dependsOn:i,table:o}}function ve(e){let t=[],n=/* @__PURE__ */ new Set;for(let r of e){let e=typeof r==`string`?r:r.value;if(n.has(e))continue;n.add(e);let i={value:e};typeof r!=`string`&&r.description!==void 0&&(i.description=r.description),t.push(i)}return t}function*ye(e){if(e.length===0){yield[];return}let t=Array.from({length:e.length}).fill(0);for(;;){yield t.map((t,n)=>e[n][t]);let n=e.length-1;for(;n>=0&&(t[n]++,!(t[n]<e[n].length));)t[n]=0,n--;if(n<0)return}}function be(e,t,n,r){let i=d(e);i?.type===`pending-expand`?t.push({name:e.name,describe:n,set:r,spec:i.spec}):i!==void 0&&r(i)}function D(e){return e.replace(/[^a-zA-Z0-9_]/g,`_`)}function O(e){let t=e.toUpperCase();return/^[A-Z_]/.test(t)?`${t}_BIN`:`_${t}_BIN`}function k(e,t,n){return`__${e}_expand_${t}__${D(n)}`}function xe(e,t){return[`__${e}_invoke_complete() {`,` local _shell="$1"; shift`,` "\${${O(e)}:-${t}}" __complete --shell "$_shell" -- "$@" 2>/dev/null`,`}`]}function A(e){return e.filter(e=>!e.name.startsWith(`__`))}function j(e){let t=[];for(let n of A(e))if(t.push({name:n.name,description:n.description}),n.aliases)for(let e of n.aliases)t.push({name:e,description:n.description});return t}function Se(e,t){let n=e.type===`boolean`&&e.negation===!0,r={name:e.name,cliName:e.cliName,alias:e.alias,negation:e.negationDisplay,negationDescription:e.negationDescription,description:e.description,takesValue:e.type!==`boolean`,valueType:e.type,required:e.required,defaultNegationAccepted:n};return be(e,t,`--${e.cliName}`,e=>{r.valueCompletion=e}),r}function Ce(e){return e.args?_(v(e.args)):[]}function we(e,t){return e.filter(e=>e.named).map(e=>Se(e,t))}function Te(e,t){return e.filter(e=>e.positional).map((e,n)=>{let r={name:e.name,cliName:e.cliName,position:n,description:e.description,required:e.required,variadic:e.type===`array`};return be(e,t,`<${e.cliName}>`,e=>{r.valueCompletion=e}),r})}function Ee(e,t,n=[],r=!1){let i=[];if(t.subCommands)for(let[e,a]of Object.entries(t.subCommands)){let t=y(a);t?i.push(Ee(e,t,n,r)):i.push({name:e,description:`(lazy loaded)`,subcommands:[],options:[],positionals:[]})}let a=[],o=t.args?v(t.args):void 0,s={name:e,description:t.description,aliases:t.aliases,subcommands:i,options:we(o?g(o):[],a),positionals:Te(o?_(o):[],a)};return he(s,a,n,r),s}function M(e,t,n){return e?`${e}${n}${t}`:t}function De(e,t){let n=[t.name,...t.aliases??[]];return e.flatMap(e=>n.map(t=>M(e,t,`:`)))}function Oe(e){let t=[],n=(e,r)=>{let i=new Set(e.options.filter(e=>e.isGlobal!==!0).map(e=>e.name));e.positionals.some(e=>i.has(e.name))&&t.push({pathStrs:r,positionals:e.positionals,options:e.options});for(let t of A(e.subcommands))n(t,De(r,t))};return n(e,[``]),t}function N(e,t){let n=[],r=A(e.subcommands).length>0;for(let i of e.options){if(!i.takesValue)continue;let a=r&&i.isGlobal===!0?c(i.cliName,i.alias):F(i,e.options);a.length!==0&&n.push({parentPath:t,tokens:a})}for(let r of A(e.subcommands))for(let e of[r.name,...r.aliases??[]])n.push(...N(r,M(t,e,`:`)));return n}function ke(e,t){return N(e,t).map(e=>` ${e.tokens.map(t=>`${e.parentPath}:${t}`).join(`|`)}) return 0 ;;`)}function P(e,t=``,n=``){let r=[];for(let i of A(e.subcommands)){let e=M(n,D(i.name),`_`);for(let n of[i.name,...i.aliases??[]]){let a=M(t,n,`:`);r.push(...P(i,a,e)),r.push({pathStr:a,funcSuffix:e,lookupPattern:`${t}:${n}`})}}return r}function Ae(e){return e.map(e=>` ${e.lookupPattern}) return 0 ;;`)}function je(e,t){return e.map(e=>` ${e.pathStr}) __${t}_complete_${e.funcSuffix} ;;`)}function Me(e,t){let n=e.isGlobal?`_global_arg_values`:`_arg_values`;return t===`bash`?`${n}_${D(e.fieldName)}="$3"`:`${n}[${e.fieldName}]="$3"`}function Ne(e,t){let n=[];for(let r of e){if(r.isPositional||!r.optionTokens||r.optionTokens.length===0)continue;let e=r.pathStrs.flatMap(e=>r.optionTokens.map(t=>`${e}:${t}`)).join(`|`);n.push(` ${e}) ${Me(r,t)} ;;`)}return n}function Pe(e,t){let n=[];for(let r of e){if(!r.isPositional)continue;let e=r.pathStrs.map(e=>`${e}:${r.position}`).join(`|`);n.push(` ${e}) ${Me(r,t)} ;;`)}return n}function Fe(e,t){let n=[];for(let r of e){if(r.optionTokens.length===0)continue;let e=r.pathStrs.flatMap(e=>r.optionTokens.map(t=>`${e}:${t}`)).join(`|`),i=D(r.fieldName),a=r.isGlobal?`_global_used_field_keys`:`_used_field_keys`,o=t===`bash`?`${a}_${i}`:`${a}[${i}]`,s=t===`bash`?`_global_arr_seen_${i}`:`_global_arr_seen[${i}]`,c=`${o}=" $_k "`,l=`${o}+=" $_k "`,u=`${s}=1`;n.push(` ${e})`),n.push(` if [[ "$3" == *=* ]]; then`),n.push(' local _k="${3%%=*}"'),r.isGlobal?(n.push(` if [[ -n "$_k" ]]; then`),n.push(` if [[ -z "\${${s}:-}" ]]; then`),n.push(` ${c}`),n.push(` ${u}`),n.push(` else`),n.push(` ${l}`),n.push(` fi`),n.push(` fi`)):n.push(` [[ -n "$_k" ]] && ${l}`),n.push(` fi`),n.push(` ;;`)}return n}function F(e,t){let n=c(e.cliName,e.alias);if(e.isGlobal===!0){let e=/* @__PURE__ */ new Set;for(let n of t)if(n.isGlobal!==!0)for(let t of r(n.cliName,n.alias))e.add(t);return n.filter(t=>!e.has(t))}let i=p(t);return i.size===0?n:n.filter(t=>!t.startsWith(`-`)||t.startsWith(`--`)||!i.has(t)?!0:e.alias?.includes(t.slice(1))===!0)}function Ie(e){let t=[];return Le(e,[],[``],[],`root`,t),t}function Le(e,t,n,r,i,a){let o=n[0];for(let s of e.options){let c=s.valueCompletion;if(c?.type===`expand`){let l=s.valueType===`array`;a.push({path:t,pathStr:o,pathStrs:n,intermediatePathStrs:r,funcSuffix:i,fieldName:s.name,isGlobal:s.isGlobal===!0,isPositional:!1,isArrayOption:l,optionTokens:l?F(s,e.options):[],vc:c})}}for(let s of e.positionals){let e=s.valueCompletion;e?.type===`expand`&&a.push({path:t,pathStr:o,pathStrs:n,intermediatePathStrs:r,funcSuffix:i,fieldName:s.name,isGlobal:!1,isPositional:!0,isArrayOption:!1,optionTokens:[],vc:e})}for(let o of A(e.subcommands))Le(o,[...t,o.name],De(n,o),[...r,...n],i===`root`?D(o.name):`${i}_${D(o.name)}`,a)}function Re(e,t,n=[]){let i=ze(e),a=/* @__PURE__ */ new Map,o=(e,t,n)=>{let r=a.get(e);r||(r={ref:t,pathStrs:[],seen:/* @__PURE__ */ new Set},a.set(e,r));for(let e of n)r.seen.has(e)||(r.seen.add(e),r.pathStrs.push(e))},s=(e,t,n)=>{let a=/* @__PURE__ */ new Map,o=(e,t)=>{if(t.length===0)return;let n=t.join(` `),r=a.get(n);r||(r={tokens:t,paths:[]},a.set(n,r)),r.paths.push(e)};for(let n of t){let t=i.get(n);if(!t)continue;let a=/* @__PURE__ */ new Set;for(let e of t.options)if(e.isGlobal!==!0)for(let t of r(e.cliName,e.alias))a.add(t);o(n,e.filter(e=>!a.has(e)))}for(let t of n)o(t,e);return a},l=(e,t,n)=>{let r=c(t.cliName,t.alias),i=s(r,n.pathStrs,n.intermediatePathStrs);for(let[t,n]of i)o(`g::${e}::${t}`,{fieldName:e,isGlobal:!0,isPositional:!1,optionTokens:n.tokens},n.paths)};for(let e of t){let t=i.get(e.pathStr);if(t)for(let r of e.vc.dependsOn){if(e.isGlobal){let t=n.find(e=>e.name===r);if(!t)continue;l(r,t,e);continue}let i=t.positionals.findIndex(e=>e.name===r);i>=0&&o(`lp::${e.pathStr}::${r}`,{fieldName:r,isGlobal:!1,isPositional:!0,position:i},e.pathStrs);let a=t.options.find(e=>e.name===r);a&&(a.isGlobal===!0?l(r,a,e):o(`lo::${e.pathStr}::${r}`,{fieldName:r,isGlobal:!1,isPositional:!1,optionTokens:F(a,t.options)},e.pathStrs))}}let u=[];for(let e of a.values())e.pathStrs.length!==0&&u.push({...e.ref,pathStr:e.pathStrs[0],pathStrs:e.pathStrs});return u}function ze(e){let t=/* @__PURE__ */ new Map,n=(e,r)=>{for(let n of r)t.set(n,e);for(let t of A(e.subcommands))n(t,De(r,t))};return n(e,[``]),t}function I(e){for(let t of e.options)if(t.valueCompletion?.type===`dynamic`)return!0;for(let t of e.positionals)if(t.valueCompletion?.type===`dynamic`)return!0;for(let t of e.subcommands)if(I(t))return!0;return!1}function Be(e,t){let n=new Set(e.options.map(e=>e.name)),r=t.filter(e=>!n.has(e.name));e.options=[...e.options,...r];for(let n of e.subcommands)Be(n,t)}function L(e,t,n,r=!1){let i=[];if(n){let e=[];i=we(v(n).fields,e).map(e=>(e.isGlobal=!0,e)),he({name:t,subcommands:[],options:i,positionals:[]},e,[],r)}let a=Ee(t,e,i,r);return n?Be(a,i):i=a.options,{command:a,programName:t,globalOptions:i}}function R(e){try{return Math.floor(T(e).mtimeMs/1e3).toString()}catch{return`0`}}function Ve(e){return e.replace(/\r?\n/g,` `)}function He(e){if(!e||/[/\\\0]/.test(e))return null;let t=process.env.PATH??``;for(let n of t.split(`:`)){if(!n)continue;let t=ue(n,e);try{if(T(t).isFile())return t}catch{}}return null}function z(e,t){return t||process.env[O(D(e))]||(He(e)??process.argv[1]??``)}function B(e){let t=z(e.programName,e.binPath),n=[`# politty-completion-version: 1`,`# politty-bin-sig: ${R(t)}`,`# politty-bin-path: ${Ve(t)}`,`# program: ${e.programName}`];return e.programVersion&&n.push(`# program-version: ${e.programVersion}`),n.push(`# shell: ${e.shell}`),n}function Ue(e){let{programName:t,binPath:n}=e,r=D(t),i=O(r),a=z(t,n),o=R(a),s=m(a),c=`__${r}_self_refresh`;return[`${c}() {`,` local _self _bin _sig`," _self=${BASH_SOURCE[0]:-}",` [[ -n "$_self" && -f "$_self" ]] || return 1`,` head -n 8 "$_self" 2>/dev/null | grep -qF "# politty-completion-version:" || return 1`,` head -n 8 "$_self" 2>/dev/null | grep -qxF "# program: ${t}" || return 1`,` head -n 8 "$_self" 2>/dev/null | grep -qxF "# shell: bash" || return 1`,` _bin="\${${i}:-$(type -P ${t} 2>/dev/null)}"`,` [[ -n "$_bin" ]] || return 1`,` _sig=${h(`$_bin`,{shell:`posix`})} || return 1`,` [[ "$_sig" != "${o}" || "$_bin" != ${s} ]] || return 1`,` "$_bin" __refresh-completion bash "$_self" --static 2>/dev/null || return 1`,` head -n 8 "$_self" 2>/dev/null | grep -qxF "# politty-bin-sig: $_sig" || return 1`,` head -n 8 "$_self" 2>/dev/null | grep -qxF "# politty-bin-path: $_bin" || return 1`,` source "$_self" 2>/dev/null || return 1`,` return 0`,`}`,`if ${c}; then`,` unset -f ${c}`,` return 0 2>/dev/null || true`,`else`,` unset -f ${c}`,`fi`,``]}function We(e){let{programName:t,binPath:n}=e,r=D(t),i=O(r),a=`_${t}`,o=z(t,n),s=R(o),c=m(o),l=`__${r}_self_refresh`;return[`${l}() {`,` emulate -L zsh`,` setopt local_options no_aliases`,` local _self _bin _sig`,' _self="${(%):-%x}"',` [[ -n "$_self" && -f "$_self" ]] || return 1`,` head -n 8 "$_self" 2>/dev/null | grep -qF "# politty-completion-version:" || return 1`,` head -n 8 "$_self" 2>/dev/null | grep -qxF "# program: ${t}" || return 1`,` head -n 8 "$_self" 2>/dev/null | grep -qxF "# shell: zsh" || return 1`,` _bin="\${${i}:-$(whence -p ${t} 2>/dev/null)}"`,` [[ -n "$_bin" ]] || return 1`,` _sig=${h(`$_bin`,{shell:`posix`})} || return 1`,` [[ "$_sig" != "${s}" || "$_bin" != ${c} ]] || return 1`,` "$_bin" __refresh-completion zsh "$_self" --static 2>/dev/null || return 1`,` head -n 8 "$_self" 2>/dev/null | grep -qxF "# politty-bin-sig: $_sig" || return 1`,` head -n 8 "$_self" 2>/dev/null | grep -qxF "# politty-bin-path: $_bin" || return 1`,` source "$_self" 2>/dev/null || return 1`,` ${a} "$@"`,` return 0`,`}`,`if ${l} "$@"; then`,` unfunction ${l} 2>/dev/null`,` return 0 2>/dev/null || true`,`else`,` unfunction ${l} 2>/dev/null`,`fi`,``]}function Ge(e){return e.replace(/\\/g,`\\\\`).replace(/"/g,`\\"`).replace(/\$/g,`\\$`).replace(/`/g,"\\`")}function Ke(e){let t=``,n=new TextEncoder().encode(e);for(let e of n)t+=e>=48&&e<=57||e>=65&&e<=90||e>=97&&e<=122?String.fromCharCode(e):`_${e.toString(16).toUpperCase().padStart(2,`0`)}`;return t}function qe(e,t,n,r){if(!e)return[];switch(e.type){case`expand`:{if(!r)throw Error(`bashValueLines: expand variant requires a location`);let e=k(n,r.funcSuffix,r.fieldName),i=[`local _enc_key='' _enc_v`];r.resolvedDeps.forEach((e,t)=>{let r=D(e.name),a=e.isGlobal?`_global_arg_values_${r}`:`_arg_values_${r}`;i.push(`_enc_v="\${${a}:-}"`),i.push(t===0?`_enc_key="$(__${n}_enc "$_enc_v")"`:`_enc_key+="_$(__${n}_enc "$_enc_v")"`)});let a=t?'"${_inline_prefix}${_c}"':`"$_c"`,o=r.isGlobal?`\${_global_used_field_keys_${D(r.fieldName)}:-}`:`\${_used_field_keys_${D(r.fieldName)}:-}`,s=r.isArrayOption?[` if [[ -n "$_ck" && " ${o} " == *" $_ck "* ]]; then continue; fi`]:[];return[`compopt +o default 2>/dev/null`,...i,`local _varname=${e}__\${_enc_key}`,'local _raw="${!_varname:-}"',`if [[ -n "$_raw" ]]; then`,` local -a _vals=()`,` local _line`,` while IFS= read -r _line; do _vals+=("$_line"); done <<< "$_raw"`,` local _c _ck _seen_keys=" " _had_key=0`,' for _c in "${_vals[@]}"; do',` [[ -z "$_c" ]] && continue`,` if [[ "$_c" == *=* ]]; then`,' _ck="${_c%%=*}"',...s,` if [[ "$_cur" != *=* ]]; then`,` [[ "$_seen_keys" == *" $_ck "* ]] && continue`,` _seen_keys+="$_ck "`,' _c="${_ck}="',` _had_key=1`,` elif [[ "$_c" != *=?* ]]; then`,` continue`,` fi`,` fi`,` [[ "$_c" == "$_cur"* ]] && COMPREPLY+=(${a})`,` done`,` if (( _had_key )); then compopt -o nospace 2>/dev/null; fi`,`fi`,'if (( ${#COMPREPLY[@]} == 0 )); then COMPREPLY=( "" ); fi']}case`dynamic`:return[`local _dyn_out`,`_dyn_out=$(__${n}_invoke_complete bash "\${_words[@]}")`,`__${n}_apply_dynamic_output "$_dyn_out"`];case`choices`:{let n=[`local -a _choices=(${e.choices.map(e=>`"${Ge(e)}"`).join(` `)})`,`COMPREPLY=()`,'local _c; for _c in "${_choices[@]}"; do [[ "$_c" == "$_cur"* ]] && COMPREPLY+=("${_inline_prefix}${_c}"); done'];return t&&n.push(`compopt -o nospace`),n.push(`compopt +o default 2>/dev/null`),n}case`file`:return e.matcher?.length?Je(e.matcher.map(e=>`[[ "\${_f##*/}" == ${e} ]]`).join(` || `)):e.extensions?.length?Je(e.extensions.map(e=>`[[ "$_f" == *".${e}" ]]`).join(` || `)):[`COMPREPLY=($(compgen -P "$_inline_prefix" -f -- "$_cur"))`,`compopt -o filenames`];case`directory`:return[`COMPREPLY=($(compgen -P "$_inline_prefix" -d -- "$_cur"))`,`compopt -o filenames`];case`command`:return[`COMPREPLY=($(compgen -P "$_inline_prefix" -W "$(${e.shellCommand})" -- "$_cur"))`];case`none`:return[`compopt +o default 2>/dev/null`];case`runtime-expand`:return[]}}function V(e){return`unset $(compgen -v ${e} 2>/dev/null) 2>/dev/null`}function Je(e){return[`local -a _all_entries=($(compgen -f -- "$_cur"))`,'for _f in "${_all_entries[@]}"; do',` if [[ -d "$_f" ]]; then`,' COMPREPLY+=("${_inline_prefix}$_f")',` elif ${e}; then`,' COMPREPLY+=("${_inline_prefix}$_f")',` fi`,`done`,`compopt -o filenames`,`compopt +o default 2>/dev/null`]}function Ye(e,t,n,r,i){let a=[];for(let o of e){if(!o.takesValue||!o.valueCompletion)continue;let s=qe(o.valueCompletion,n,r,{funcSuffix:i,...u(o,e,t)});if(s.length===0)continue;let c=F(o,e);if(c.length!==0){a.push(` ${c.join(`|`)})`);for(let e of s)a.push(` ${e}`);a.push(` return ;;`)}}return a}function H(e,t,n,r=[]){if(e.length===0)return[];let i=o(e,r,t),a=[...i??[]];a.push(` case "${i?`$_slot`:`$_pos_count`}" in`);for(let o of e){o.variadic&&!i?a.push(` ${o.position}|*)`):a.push(` ${o.position})`);for(let i of qe(o.valueCompletion,!1,t,{funcSuffix:n,...l(o,r,e)}))a.push(` ${i}`);a.push(` ;;`)}return a.push(` esac`),a}function Xe(e,t,n,r,i){let a=[`COMPREPLY=($(compgen -W "${e}" -- "$_cur"))`,`compopt +o default 2>/dev/null`];return t.length===0?a:[`local -a _sub_names=(${e})`,`local _sub_name _sub_match=0`,'for _sub_name in "${_sub_names[@]}"; do',` [[ "$_sub_name" == "$_cur"* ]] && _sub_match=1 && break`,`done`,`if (( _sub_match )); then`,...a.map(e=>` ${e}`),`else`,...H(t,n,r,i),`fi`]}function Ze(e,t,n,r){if(!e.some(e=>e.takesValue&&e.valueCompletion))return[];let i=[],a=Ye(e,t,!1,n,r);a.length>0&&(i.push(` if [[ -z "$_inline_prefix" ]]; then`),i.push(` case "$_prev" in`),i.push(...a),i.push(` esac`),i.push(` fi`));let o=Ye(e,t,!0,n,r);return o.length>0&&(i.push(` if [[ -n "$_inline_prefix" ]]; then`),i.push(' case "${_inline_prefix%=}" in'),i.push(...o),i.push(` esac`),i.push(` fi`)),i}function Qe(e,n){let r=[];for(let i of e){if(i.valueType===`array`){r.push(` _avail+=(--${i.cliName})`);continue}let a=t(i.cliName,i.alias,i.negation,{isGlobal:i.isGlobal===!0,frameOptions:e}),o=`__${n}_not_used ${a.join(` `)}`,s=i.negation?[i.cliName,i.negation]:[i.cliName];for(let e of s)a.includes(`"--${e}"`)&&r.push(` ${o} && _avail+=(--${e})`)}return r.push(` if (( ! _any_opt_used )); then`),r.push(` _avail+=(--help --help-all --help-json)`),r.push(` fi`),r}function $e(e,t,n){let r=[...n,e.name],i=r.map(D).join(`_`),a=`__${t}_complete_${i}`,o=A(e.subcommands),s=[];for(let e of o)s.push(...$e(e,t,r));s.push(`${a}() {`),s.push(...Ze(e.options,e.positionals,t,i));let c=r.join(`:`);if(s.push(` if [[ -z "$_inline_prefix" ]] && __${t}_opt_takes_value "${c}" "$_prev"; then return; fi`),s.push(` if [[ -n "$_inline_prefix" ]] && __${t}_opt_takes_value "${c}" "\${_inline_prefix%=}"; then return; fi`),e.positionals.length>0?(s.push(` if (( _after_dd )); then`),s.push(...H(e.positionals,t,i,e.options).map(e=>` ${e}`)),s.push(` return`),s.push(` fi`)):s.push(` if (( _after_dd )); then return; fi`),s.push(` if [[ "$_cur" == -* ]]; then`),s.push(` local -a _avail=()`),s.push(...Qe(e.options,t)),s.push(' COMPREPLY=($(compgen -W "${_avail[*]}" -- "$_cur"))'),s.push(` compopt +o default 2>/dev/null`),s.push(` return`),s.push(` fi`),o.length>0){let n=j(e.subcommands).map(e=>e.name).join(` `);s.push(...Xe(n,e.positionals,t,i,e.options).map(e=>` ${e}`))}else e.positionals.length>0&&s.push(...H(e.positionals,t,i,e.options));return s.push(`}`),s.push(``),s}function et(e,t){let{programName:r}=t,i=L(e,r,t.globalArgsSchema),o=D(r),c=t.staticWorker?`${o}_${D(t.staticWorker.functionSuffix)}`:o,l=t.staticWorker!==void 0,u=i.command,d=A(u.subcommands),f=Ie(u),p=Re(u,f,i.globalOptions),m=[];m.push(...B({programName:r,shell:`bash`,binPath:t.binPath,programVersion:t.programVersion})),m.push(`# politty-completion-mode: ${l?`worker`:`static`}`),l&&m.push(`# politty-completion-worker: true`),m.push(`# Generated by politty`),m.push(``),l||m.push(...Ue({programName:r,binPath:t.binPath}));let h=f.length>0,g=f.filter(e=>e.isArrayOption),_=g.length>0;h&&(m.push(`__${c}_enc() {`),m.push(` local LC_ALL=C`),m.push(` local _s=$1 _r='' _c _i`),m.push(" for (( _i=0; _i<${#_s}; _i++ )); do"),m.push(" _c=${_s:_i:1}"),m.push(` case "$_c" in`),m.push(` [a-zA-Z0-9]) _r+="$_c" ;;`),m.push(` *) printf -v _r '%s_%02X' "$_r" "'$_c" ;;`),m.push(` esac`),m.push(` done`),m.push(` printf '%s' "$_r"`),m.push(`}`),m.push(``));for(let e of f){let t=k(c,e.funcSuffix,e.fieldName);for(let r of e.vc.table){let e=r.key.map(Ke).join(`_`),i=r.candidates.map(e=>e.value).join(`
1
+ import{n as e}from"./command-CCiN78NV.js";import{_ as t,c as n,d as r,f as i,g as a,h as o,i as s,l as c,m as l,p as u,s as d,t as f,u as p,v as m,y as h}from"./dynamic-D9Y4kkfj.js";import{a as g,c as _,n as v}from"./schema-extractor-Cwg_WAC-.js";import{c as y}from"./subcommand-router-CfCW9eG4.js";import{a as b,i as ee,n as x,o as te,r as ne,s as re}from"./with-completion-command-gytc9LNl.js";import{existsSync as S,mkdirSync as ie,readFileSync as C,realpathSync as w,renameSync as ae,rmSync as oe,statSync as T,writeFileSync as se}from"node:fs";import{dirname as E,extname as ce,isAbsolute as le,join as ue,relative as de,resolve as fe}from"node:path";import{promisify as pe}from"node:util";import{execFile as me}from"node:child_process";function he(e,t,n=[],r=!1){if(t.length===0)return;let i=ge(e,n);for(let e of t)e.set(_e(e,i,r))}function ge(e,t){let n=/* @__PURE__ */ new Map,r=/* @__PURE__ */ new Set;for(let t of[...e.options,...e.positionals])r.add(t.name);let i=(e,t)=>{for(let i of e){if(n.has(i.name)||t&&r.has(i.name))continue;let e=i.valueCompletion;e?.type===`choices`&&e.choices&&e.choices.length>0&&n.set(i.name,e.choices)}};return i([...e.options,...e.positionals],!1),i(t,!0),n}function _e(e,t,n=!1){let{spec:r}=e,i=r.dependsOn;if(i.length===0)throw Error(`Field "${e.describe}": completion.custom.expand.dependsOn must list at least one sibling arg.`);let a=[];for(let n of i){if(n===e.name)throw Error(`Field "${e.describe}": completion.custom.expand.dependsOn cannot reference the field itself ("${n}").`);let r=t.get(n);if(!r)throw Error(`Field "${e.describe}": completion.custom.expand.dependsOn references "${n}", which is not a sibling arg with a static \`choices\`/enum schema on the same command. Chaining expand specs is not supported.`);a.push([...r])}if(n)return{type:`expand`,dependsOn:i,table:[]};let o=[];for(let t of ye(a)){let n={};i.forEach((e,r)=>{n[e]=t[r]});let a;try{a=r.enumerate(n)}catch(t){let r=t instanceof Error?t.message:String(t);throw Error(`Field "${e.describe}": completion.custom.expand.enumerate threw for deps=${JSON.stringify(n)}: ${r}`)}let s=ve(a);s.length!==0&&o.push({key:t,candidates:s})}return{type:`expand`,dependsOn:i,table:o}}function ve(e){let t=[],n=/* @__PURE__ */ new Set;for(let r of e){let e=typeof r==`string`?r:r.value;if(n.has(e))continue;n.add(e);let i={value:e};typeof r!=`string`&&r.description!==void 0&&(i.description=r.description),t.push(i)}return t}function*ye(e){if(e.length===0){yield[];return}let t=Array.from({length:e.length}).fill(0);for(;;){yield t.map((t,n)=>e[n][t]);let n=e.length-1;for(;n>=0&&(t[n]++,!(t[n]<e[n].length));)t[n]=0,n--;if(n<0)return}}function be(e,t,n,r){let i=d(e);i?.type===`pending-expand`?t.push({name:e.name,describe:n,set:r,spec:i.spec}):i!==void 0&&r(i)}function D(e){return e.replace(/[^a-zA-Z0-9_]/g,`_`)}function O(e){let t=e.toUpperCase();return/^[A-Z_]/.test(t)?`${t}_BIN`:`_${t}_BIN`}function k(e,t,n){return`__${e}_expand_${t}__${D(n)}`}function xe(e,t){return[`__${e}_invoke_complete() {`,` local _shell="$1"; shift`,` "\${${O(e)}:-${t}}" __complete --shell "$_shell" -- "$@" 2>/dev/null`,`}`]}function A(e){return e.filter(e=>!e.name.startsWith(`__`))}function j(e){let t=[];for(let n of A(e))if(t.push({name:n.name,description:n.description}),n.aliases)for(let e of n.aliases)t.push({name:e,description:n.description});return t}function Se(e,t){let n=e.type===`boolean`&&e.negation===!0,r={name:e.name,cliName:e.cliName,alias:e.alias,negation:e.negationDisplay,negationDescription:e.negationDescription,description:e.description,takesValue:e.type!==`boolean`,valueType:e.type,required:e.required,defaultNegationAccepted:n};return be(e,t,`--${e.cliName}`,e=>{r.valueCompletion=e}),r}function Ce(e){return e.args?_(v(e.args)):[]}function we(e,t){return e.filter(e=>e.named).map(e=>Se(e,t))}function Te(e,t){return e.filter(e=>e.positional).map((e,n)=>{let r={name:e.name,cliName:e.cliName,position:n,description:e.description,required:e.required,variadic:e.type===`array`};return be(e,t,`<${e.cliName}>`,e=>{r.valueCompletion=e}),r})}function Ee(e,t,n=[],r=!1){let i=[];if(t.subCommands)for(let[e,a]of Object.entries(t.subCommands)){let t=y(a);t?i.push(Ee(e,t,n,r)):i.push({name:e,description:`(lazy loaded)`,subcommands:[],options:[],positionals:[]})}let a=[],o=t.args?v(t.args):void 0,s={name:e,description:t.description,aliases:t.aliases,subcommands:i,options:we(o?g(o):[],a),positionals:Te(o?_(o):[],a)};return he(s,a,n,r),s}function M(e,t,n){return e?`${e}${n}${t}`:t}function De(e,t){let n=[t.name,...t.aliases??[]];return e.flatMap(e=>n.map(t=>M(e,t,`:`)))}function Oe(e){let t=[],n=(e,r)=>{let i=new Set(e.options.filter(e=>e.isGlobal!==!0).map(e=>e.name));e.positionals.some(e=>i.has(e.name))&&t.push({pathStrs:r,positionals:e.positionals,options:e.options});for(let t of A(e.subcommands))n(t,De(r,t))};return n(e,[``]),t}function N(e,t){let n=[],r=A(e.subcommands).length>0;for(let i of e.options){if(!i.takesValue)continue;let a=r&&i.isGlobal===!0?c(i.cliName,i.alias):F(i,e.options);a.length!==0&&n.push({parentPath:t,tokens:a})}for(let r of A(e.subcommands))for(let e of[r.name,...r.aliases??[]])n.push(...N(r,M(t,e,`:`)));return n}function ke(e,t){return N(e,t).map(e=>` ${e.tokens.map(t=>`${e.parentPath}:${t}`).join(`|`)}) return 0 ;;`)}function P(e,t=``,n=``){let r=[];for(let i of A(e.subcommands)){let e=M(n,D(i.name),`_`);for(let n of[i.name,...i.aliases??[]]){let a=M(t,n,`:`);r.push(...P(i,a,e)),r.push({pathStr:a,funcSuffix:e,lookupPattern:`${t}:${n}`})}}return r}function Ae(e){return e.map(e=>` ${e.lookupPattern}) return 0 ;;`)}function je(e,t){return e.map(e=>` ${e.pathStr}) __${t}_complete_${e.funcSuffix} ;;`)}function Me(e,t){let n=e.isGlobal?`_global_arg_values`:`_arg_values`;return t===`bash`?`${n}_${D(e.fieldName)}="$3"`:`${n}[${e.fieldName}]="$3"`}function Ne(e,t){let n=[];for(let r of e){if(r.isPositional||!r.optionTokens||r.optionTokens.length===0)continue;let e=r.pathStrs.flatMap(e=>r.optionTokens.map(t=>`${e}:${t}`)).join(`|`);n.push(` ${e}) ${Me(r,t)} ;;`)}return n}function Pe(e,t){let n=[];for(let r of e){if(!r.isPositional)continue;let e=r.pathStrs.map(e=>`${e}:${r.position}`).join(`|`);n.push(` ${e}) ${Me(r,t)} ;;`)}return n}function Fe(e,t){let n=[];for(let r of e){if(r.optionTokens.length===0)continue;let e=r.pathStrs.flatMap(e=>r.optionTokens.map(t=>`${e}:${t}`)).join(`|`),i=D(r.fieldName),a=r.isGlobal?`_global_used_field_keys`:`_used_field_keys`,o=t===`bash`?`${a}_${i}`:`${a}[${i}]`,s=t===`bash`?`_global_arr_seen_${i}`:`_global_arr_seen[${i}]`,c=`${o}=" $_k "`,l=`${o}+=" $_k "`,u=`${s}=1`;n.push(` ${e})`),n.push(` if [[ "$3" == *=* ]]; then`),n.push(' local _k="${3%%=*}"'),r.isGlobal?(n.push(` if [[ -n "$_k" ]]; then`),n.push(` if [[ -z "\${${s}:-}" ]]; then`),n.push(` ${c}`),n.push(` ${u}`),n.push(` else`),n.push(` ${l}`),n.push(` fi`),n.push(` fi`)):n.push(` [[ -n "$_k" ]] && ${l}`),n.push(` fi`),n.push(` ;;`)}return n}function F(e,t){let n=c(e.cliName,e.alias);if(e.isGlobal===!0){let e=/* @__PURE__ */ new Set;for(let n of t)if(n.isGlobal!==!0)for(let t of r(n.cliName,n.alias))e.add(t);return n.filter(t=>!e.has(t))}let i=p(t);return i.size===0?n:n.filter(t=>!t.startsWith(`-`)||t.startsWith(`--`)||!i.has(t)?!0:e.alias?.includes(t.slice(1))===!0)}function Ie(e){let t=[];return Le(e,[],[``],[],`root`,t),t}function Le(e,t,n,r,i,a){let o=n[0];for(let s of e.options){let c=s.valueCompletion;if(c?.type===`expand`){let l=s.valueType===`array`;a.push({path:t,pathStr:o,pathStrs:n,intermediatePathStrs:r,funcSuffix:i,fieldName:s.name,isGlobal:s.isGlobal===!0,isPositional:!1,isArrayOption:l,optionTokens:l?F(s,e.options):[],vc:c})}}for(let s of e.positionals){let e=s.valueCompletion;e?.type===`expand`&&a.push({path:t,pathStr:o,pathStrs:n,intermediatePathStrs:r,funcSuffix:i,fieldName:s.name,isGlobal:!1,isPositional:!0,isArrayOption:!1,optionTokens:[],vc:e})}for(let o of A(e.subcommands))Le(o,[...t,o.name],De(n,o),[...r,...n],i===`root`?D(o.name):`${i}_${D(o.name)}`,a)}function Re(e,t,n=[]){let i=ze(e),a=/* @__PURE__ */ new Map,o=(e,t,n)=>{let r=a.get(e);r||(r={ref:t,pathStrs:[],seen:/* @__PURE__ */ new Set},a.set(e,r));for(let e of n)r.seen.has(e)||(r.seen.add(e),r.pathStrs.push(e))},s=(e,t,n)=>{let a=/* @__PURE__ */ new Map,o=(e,t)=>{if(t.length===0)return;let n=t.join(` `),r=a.get(n);r||(r={tokens:t,paths:[]},a.set(n,r)),r.paths.push(e)};for(let n of t){let t=i.get(n);if(!t)continue;let a=/* @__PURE__ */ new Set;for(let e of t.options)if(e.isGlobal!==!0)for(let t of r(e.cliName,e.alias))a.add(t);o(n,e.filter(e=>!a.has(e)))}for(let t of n)o(t,e);return a},l=(e,t,n)=>{let r=c(t.cliName,t.alias),i=s(r,n.pathStrs,n.intermediatePathStrs);for(let[t,n]of i)o(`g::${e}::${t}`,{fieldName:e,isGlobal:!0,isPositional:!1,optionTokens:n.tokens},n.paths)};for(let e of t){let t=i.get(e.pathStr);if(t)for(let r of e.vc.dependsOn){if(e.isGlobal){let t=n.find(e=>e.name===r);if(!t)continue;l(r,t,e);continue}let i=t.positionals.findIndex(e=>e.name===r);i>=0&&o(`lp::${e.pathStr}::${r}`,{fieldName:r,isGlobal:!1,isPositional:!0,position:i},e.pathStrs);let a=t.options.find(e=>e.name===r);a&&(a.isGlobal===!0?l(r,a,e):o(`lo::${e.pathStr}::${r}`,{fieldName:r,isGlobal:!1,isPositional:!1,optionTokens:F(a,t.options)},e.pathStrs))}}let u=[];for(let e of a.values())e.pathStrs.length!==0&&u.push({...e.ref,pathStr:e.pathStrs[0],pathStrs:e.pathStrs});return u}function ze(e){let t=/* @__PURE__ */ new Map,n=(e,r)=>{for(let n of r)t.set(n,e);for(let t of A(e.subcommands))n(t,De(r,t))};return n(e,[``]),t}function I(e){for(let t of e.options)if(t.valueCompletion?.type===`dynamic`)return!0;for(let t of e.positionals)if(t.valueCompletion?.type===`dynamic`)return!0;for(let t of e.subcommands)if(I(t))return!0;return!1}function Be(e,t){let n=new Set(e.options.map(e=>e.name)),r=t.filter(e=>!n.has(e.name));e.options=[...e.options,...r];for(let n of e.subcommands)Be(n,t)}function L(e,t,n,r=!1){let i=[];if(n){let e=[];i=we(v(n).fields,e).map(e=>(e.isGlobal=!0,e)),he({name:t,subcommands:[],options:i,positionals:[]},e,[],r)}let a=Ee(t,e,i,r);return n?Be(a,i):i=a.options,{command:a,programName:t,globalOptions:i}}function R(e){try{return Math.floor(T(e).mtimeMs/1e3).toString()}catch{return`0`}}function Ve(e){return e.replace(/\r?\n/g,` `)}function He(e){if(!e||/[/\\\0]/.test(e))return null;let t=process.env.PATH??``;for(let n of t.split(`:`)){if(!n)continue;let t=ue(n,e);try{if(T(t).isFile())return t}catch{}}return null}function z(e,t){return t||process.env[O(D(e))]||(He(e)??process.argv[1]??``)}function B(e){let t=z(e.programName,e.binPath),n=[`# politty-completion-version: 1`,`# politty-bin-sig: ${R(t)}`,`# politty-bin-path: ${Ve(t)}`,`# program: ${e.programName}`];return e.programVersion&&n.push(`# program-version: ${e.programVersion}`),n.push(`# shell: ${e.shell}`),n}function Ue(e){let{programName:t,binPath:n}=e,r=D(t),i=O(r),a=z(t,n),o=R(a),s=m(a),c=`__${r}_self_refresh`;return[`${c}() {`,` local _self _bin _sig`," _self=${BASH_SOURCE[0]:-}",` [[ -n "$_self" && -f "$_self" ]] || return 1`,` head -n 8 "$_self" 2>/dev/null | grep -qF "# politty-completion-version:" || return 1`,` head -n 8 "$_self" 2>/dev/null | grep -qxF "# program: ${t}" || return 1`,` head -n 8 "$_self" 2>/dev/null | grep -qxF "# shell: bash" || return 1`,` _bin="\${${i}:-$(type -P ${t} 2>/dev/null)}"`,` [[ -n "$_bin" ]] || return 1`,` _sig=${h(`$_bin`,{shell:`posix`})} || return 1`,` [[ "$_sig" != "${o}" || "$_bin" != ${s} ]] || return 1`,` "$_bin" __refresh-completion bash "$_self" --static 2>/dev/null || return 1`,` head -n 8 "$_self" 2>/dev/null | grep -qxF "# politty-bin-sig: $_sig" || return 1`,` head -n 8 "$_self" 2>/dev/null | grep -qxF "# politty-bin-path: $_bin" || return 1`,` source "$_self" 2>/dev/null || return 1`,` return 0`,`}`,`if ${c}; then`,` unset -f ${c}`,` return 0 2>/dev/null || true`,`else`,` unset -f ${c}`,`fi`,``]}function We(e){let{programName:t,binPath:n}=e,r=D(t),i=O(r),a=`_${t}`,o=z(t,n),s=R(o),c=m(o),l=`__${r}_self_refresh`;return[`${l}() {`,` emulate -L zsh`,` setopt local_options no_aliases`,` local _self _bin _sig`,' _self="${(%):-%x}"',` [[ -n "$_self" && -f "$_self" ]] || return 1`,` head -n 8 "$_self" 2>/dev/null | grep -qF "# politty-completion-version:" || return 1`,` head -n 8 "$_self" 2>/dev/null | grep -qxF "# program: ${t}" || return 1`,` head -n 8 "$_self" 2>/dev/null | grep -qxF "# shell: zsh" || return 1`,` _bin="\${${i}:-$(whence -p ${t} 2>/dev/null)}"`,` [[ -n "$_bin" ]] || return 1`,` _sig=${h(`$_bin`,{shell:`posix`})} || return 1`,` [[ "$_sig" != "${s}" || "$_bin" != ${c} ]] || return 1`,` "$_bin" __refresh-completion zsh "$_self" --static 2>/dev/null || return 1`,` head -n 8 "$_self" 2>/dev/null | grep -qxF "# politty-bin-sig: $_sig" || return 1`,` head -n 8 "$_self" 2>/dev/null | grep -qxF "# politty-bin-path: $_bin" || return 1`,` source "$_self" 2>/dev/null || return 1`,` ${a} "$@"`,` return 0`,`}`,`if ${l} "$@"; then`,` unfunction ${l} 2>/dev/null`,` return 0 2>/dev/null || true`,`else`,` unfunction ${l} 2>/dev/null`,`fi`,``]}function Ge(e){return e.replace(/\\/g,`\\\\`).replace(/"/g,`\\"`).replace(/\$/g,`\\$`).replace(/`/g,"\\`")}function Ke(e){let t=``,n=new TextEncoder().encode(e);for(let e of n)t+=e>=48&&e<=57||e>=65&&e<=90||e>=97&&e<=122?String.fromCharCode(e):`_${e.toString(16).toUpperCase().padStart(2,`0`)}`;return t}function qe(e,t,n,r){if(!e)return[];switch(e.type){case`expand`:{if(!r)throw Error(`bashValueLines: expand variant requires a location`);let e=k(n,r.funcSuffix,r.fieldName),i=[`local _enc_key='' _enc_v`];r.resolvedDeps.forEach((e,t)=>{let r=D(e.name),a=e.isGlobal?`_global_arg_values_${r}`:`_arg_values_${r}`;i.push(`_enc_v="\${${a}:-}"`),i.push(t===0?`_enc_key="$(__${n}_enc "$_enc_v")"`:`_enc_key+="_$(__${n}_enc "$_enc_v")"`)});let a=t?'"${_inline_prefix}${_c}"':`"$_c"`,o=r.isGlobal?`\${_global_used_field_keys_${D(r.fieldName)}:-}`:`\${_used_field_keys_${D(r.fieldName)}:-}`,s=r.isArrayOption?[` if [[ -n "$_ck" && " ${o} " == *" $_ck "* ]]; then continue; fi`]:[];return[`compopt +o default 2>/dev/null`,...i,`local _varname=${e}__\${_enc_key}`,'local _raw="${!_varname:-}"',`if [[ -n "$_raw" ]]; then`,` local -a _vals=()`,` local _line`,` while IFS= read -r _line; do _vals+=("$_line"); done <<< "$_raw"`,` local _c _ck _seen_keys=" " _had_key=0`,' for _c in "${_vals[@]}"; do',` [[ -z "$_c" ]] && continue`,` if [[ "$_c" == *=* ]]; then`,' _ck="${_c%%=*}"',...s,` if [[ "$_cur" != *=* ]]; then`,` [[ "$_seen_keys" == *" $_ck "* ]] && continue`,` _seen_keys+="$_ck "`,' _c="${_ck}="',` _had_key=1`,` elif [[ "$_c" != *=?* ]]; then`,` continue`,` fi`,` fi`,` [[ "$_c" == "$_cur"* ]] && COMPREPLY+=(${a})`,` done`,` if (( _had_key )); then compopt -o nospace 2>/dev/null; fi`,`fi`,'if (( ${#COMPREPLY[@]} == 0 )); then COMPREPLY=( "" ); fi']}case`dynamic`:return[`local _dyn_out`,`_dyn_out=$(__${n}_invoke_complete bash "\${_words[@]}")`,`__${n}_apply_dynamic_output "$_dyn_out"`];case`choices`:{let n=[`local -a _choices=(${e.choices.map(e=>`"${Ge(e)}"`).join(` `)})`,`COMPREPLY=()`,'local _c; for _c in "${_choices[@]}"; do [[ "$_c" == "$_cur"* ]] && COMPREPLY+=("${_inline_prefix}${_c}"); done'];return t&&n.push(`compopt -o nospace`),n.push(`compopt +o default 2>/dev/null`),n}case`file`:return e.matcher?.length?Je(e.matcher.map(e=>`[[ "\${_f##*/}" == ${e} ]]`).join(` || `)):e.extensions?.length?Je(e.extensions.map(e=>`[[ "$_f" == *".${e}" ]]`).join(` || `)):[`COMPREPLY=($(compgen -P "$_inline_prefix" -f -- "$_cur"))`,`compopt -o filenames`];case`directory`:return[`COMPREPLY=($(compgen -P "$_inline_prefix" -d -- "$_cur"))`,`compopt -o filenames`];case`command`:return[`COMPREPLY=($(compgen -P "$_inline_prefix" -W "$(${e.shellCommand})" -- "$_cur"))`];case`none`:return[`compopt +o default 2>/dev/null`];case`runtime-expand`:return[]}}function V(e){return`unset $(compgen -v ${e} 2>/dev/null) 2>/dev/null`}function Je(e){return[`local -a _all_entries=($(compgen -f -- "$_cur"))`,'for _f in "${_all_entries[@]}"; do',` if [[ -d "$_f" ]]; then`,' COMPREPLY+=("${_inline_prefix}$_f")',` elif ${e}; then`,' COMPREPLY+=("${_inline_prefix}$_f")',` fi`,`done`,`compopt -o filenames`,`compopt +o default 2>/dev/null`]}function Ye(e,t,n,r,i){let a=[];for(let o of e){if(!o.takesValue||!o.valueCompletion)continue;let s=qe(o.valueCompletion,n,r,{funcSuffix:i,...u(o,e,t)});if(s.length===0)continue;let c=F(o,e);if(c.length!==0){a.push(` ${c.join(`|`)})`);for(let e of s)a.push(` ${e}`);a.push(` return ;;`)}}return a}function H(e,t,n,r=[]){if(e.length===0)return[];let i=o(e,r,t),a=[...i??[]];a.push(` case "${i?`$_slot`:`$_pos_count`}" in`);for(let o of e){o.variadic&&!i?a.push(` ${o.position}|*)`):a.push(` ${o.position})`);for(let i of qe(o.valueCompletion,!1,t,{funcSuffix:n,...l(o,r,e)}))a.push(` ${i}`);a.push(` ;;`)}return a.push(` esac`),a}function Xe(e,t,n,r,i){let a=[`COMPREPLY=($(compgen -W "${e}" -- "$_cur"))`,`compopt +o default 2>/dev/null`];return t.length===0?a:[`local -a _sub_names=(${e})`,`local _sub_name _sub_match=0`,'for _sub_name in "${_sub_names[@]}"; do',` [[ "$_sub_name" == "$_cur"* ]] && _sub_match=1 && break`,`done`,`if (( _sub_match )); then`,...a.map(e=>` ${e}`),`else`,...H(t,n,r,i),`fi`]}function Ze(e,t,n,r){if(!e.some(e=>e.takesValue&&e.valueCompletion))return[];let i=[],a=Ye(e,t,!1,n,r);a.length>0&&(i.push(` if [[ -z "$_inline_prefix" ]]; then`),i.push(` case "$_prev" in`),i.push(...a),i.push(` esac`),i.push(` fi`));let o=Ye(e,t,!0,n,r);return o.length>0&&(i.push(` if [[ -n "$_inline_prefix" ]]; then`),i.push(' case "${_inline_prefix%=}" in'),i.push(...o),i.push(` esac`),i.push(` fi`)),i}function Qe(e,n){let r=[];for(let i of e){if(i.valueType===`array`){r.push(` _avail+=(--${i.cliName})`);continue}let a=t(i.cliName,i.alias,i.negation,{isGlobal:i.isGlobal===!0,frameOptions:e}),o=`__${n}_not_used ${a.join(` `)}`,s=i.negation?[i.cliName,i.negation]:[i.cliName];for(let e of s)a.includes(`"--${e}"`)&&r.push(` ${o} && _avail+=(--${e})`)}return r.push(` if (( ! _any_opt_used )); then`),r.push(` _avail+=(--help --help-all --help-json)`),r.push(` fi`),r}function $e(e,t,n){let r=[...n,e.name],i=r.map(D).join(`_`),a=`__${t}_complete_${i}`,o=A(e.subcommands),s=[];for(let e of o)s.push(...$e(e,t,r));s.push(`${a}() {`),s.push(...Ze(e.options,e.positionals,t,i));let c=r.join(`:`);if(s.push(` if [[ -z "$_inline_prefix" ]] && __${t}_opt_takes_value "${c}" "$_prev"; then return; fi`),s.push(` if [[ -n "$_inline_prefix" ]] && __${t}_opt_takes_value "${c}" "\${_inline_prefix%=}"; then return; fi`),e.positionals.length>0?(s.push(` if (( _after_dd )); then`),s.push(...H(e.positionals,t,i,e.options).map(e=>` ${e}`)),s.push(` return`),s.push(` fi`)):s.push(` if (( _after_dd )); then return; fi`),s.push(` if [[ "$_cur" == -* ]]; then`),s.push(` local -a _avail=()`),s.push(...Qe(e.options,t)),s.push(' COMPREPLY=($(compgen -W "${_avail[*]}" -- "$_cur"))'),s.push(` compopt +o default 2>/dev/null`),s.push(` return`),s.push(` fi`),o.length>0){let n=j(e.subcommands).map(e=>e.name).join(` `);s.push(...Xe(n,e.positionals,t,i,e.options).map(e=>` ${e}`))}else e.positionals.length>0&&s.push(...H(e.positionals,t,i,e.options));return s.push(`}`),s.push(``),s}function et(e,t){let{programName:r}=t,i=L(e,r,t.globalArgsSchema),o=D(r),c=t.staticWorker?`${o}_${D(t.staticWorker.functionSuffix)}`:o,l=t.staticWorker!==void 0,u=i.command,d=A(u.subcommands),f=Ie(u),p=Re(u,f,i.globalOptions),m=[];m.push(...B({programName:r,shell:`bash`,binPath:t.binPath,programVersion:t.programVersion})),m.push(`# politty-completion-mode: ${l?`worker`:`static`}`),l&&m.push(`# politty-completion-worker: true`),m.push(`# Generated by politty`),m.push(``),l||m.push(...Ue({programName:r,binPath:t.binPath}));let h=f.length>0,g=f.filter(e=>e.isArrayOption),_=g.length>0;h&&(m.push(`__${c}_enc() {`),m.push(` local LC_ALL=C`),m.push(` local _s=$1 _r='' _c _i`),m.push(" for (( _i=0; _i<${#_s}; _i++ )); do"),m.push(" _c=${_s:_i:1}"),m.push(` case "$_c" in`),m.push(` [a-zA-Z0-9]) _r+="$_c" ;;`),m.push(` *) printf -v _r '%s_%02X' "$_r" "'$_c" ;;`),m.push(` esac`),m.push(` done`),m.push(` printf '%s' "$_r"`),m.push(`}`),m.push(``));for(let e of f){let t=k(c,e.funcSuffix,e.fieldName);for(let r of e.vc.table){let e=r.key.map(Ke).join(`_`),i=r.candidates.map(e=>e.value).join(`
2
2
  `);m.push(`${t}__${e}=${n(i)}`)}m.push(``)}I(u)&&(m.push(...xe(c,r)),m.push(``),m.push(`__${c}_apply_dynamic_output() {`),m.push(` local _raw="$1"`),m.push(` COMPREPLY=()`),m.push(` local _directive=0`),m.push(` local -a _lines=()`),m.push(` local _line`),m.push(` while IFS= read -r _line; do _lines+=("$_line"); done <<< "$_raw"`),m.push(" local _last=$((${#_lines[@]} - 1))"),m.push(' if (( _last >= 0 )) && [[ "${_lines[$_last]}" =~ ^:[0-9]+$ ]]; then'),m.push(' _directive="${_lines[$_last]#:}"'),m.push(` unset '_lines[_last]'`),m.push(` fi`),m.push(' for _line in "${_lines[@]}"; do'),m.push(` [[ -z "$_line" ]] && continue`),m.push(` COMPREPLY+=("$_line")`),m.push(` done`),m.push(' local _ip="${_inline_prefix:-}"'),m.push(` if (( _directive & ${s.DirectoryCompletion} )); then`),m.push(` compopt +o default 2>/dev/null`),m.push(` compopt -o filenames 2>/dev/null`),m.push(` local _d`),m.push(' while IFS= read -r _d; do COMPREPLY+=("${_ip}${_d}"); done < <(compgen -d -- "$_cur")'),m.push(' if (( ${#COMPREPLY[@]} == 0 )); then COMPREPLY=( "" ); fi'),m.push(` elif (( _directive & ${s.FileCompletion} )); then`),m.push(' if (( ${#COMPREPLY[@]} > 0 )) || [[ -n "$_ip" ]]; then'),m.push(` compopt -o filenames 2>/dev/null`),m.push(` local _f`),m.push(' while IFS= read -r _f; do COMPREPLY+=("${_ip}${_f}"); done < <(compgen -f -- "$_cur")'),m.push(` else`),m.push(` compopt -o default 2>/dev/null`),m.push(` fi`),m.push(` else`),m.push(` if (( _directive & ${s.NoFileCompletion} )); then`),m.push(` compopt +o default 2>/dev/null`),m.push(' if (( ${#COMPREPLY[@]} == 0 )); then COMPREPLY=( "" ); fi'),m.push(` fi`),m.push(` fi`),m.push(` if (( _directive & ${s.NoSpace} )); then`),m.push(` compopt -o nospace 2>/dev/null`),m.push(` fi`),m.push(`}`),m.push(``)),m.push(`__${c}_not_used() {`),m.push(' for _u in "${_used_opts[@]}"; do'),m.push(` for _chk in "$@"; do`),m.push(` [[ "$_u" == "$_chk" ]] && return 1`),m.push(` done`),m.push(` done`),m.push(` return 0`),m.push(`}`),m.push(``),m.push(`__${c}_opt_takes_value() {`),m.push(` case "$1:$2" in`),m.push(...ke(u,``)),m.push(` esac`),m.push(` return 1`),m.push(`}`),m.push(``),h&&(m.push(`__${c}_track_opt() {`),m.push(` case "$1:$2" in`),m.push(...Ne(p,`bash`)),m.push(` esac`),m.push(`}`),m.push(``),m.push(`__${c}_track_pos() {`),m.push(` case "$1:$2" in`),m.push(...Pe(p,`bash`)),m.push(` esac`),m.push(`}`),m.push(``),m.push(...a(c,Oe(u)))),_&&(m.push(`__${c}_track_array_expand() {`),m.push(` case "$1:$2" in`),m.push(...Fe(g,`bash`)),m.push(` esac`),m.push(`}`),m.push(``));let v=P(u);v.length>0&&(m.push(`__${c}_is_subcmd() {`),m.push(` case "$1:$2" in`),m.push(...Ae(v)),m.push(` esac`),m.push(` return 1`),m.push(`}`),m.push(``));for(let e of d)m.push(...$e(e,c,[]));if(m.push(`__${c}_complete_root() {`),m.push(...Ze(u.options,u.positionals,c,`root`)),m.push(` if [[ -z "$_inline_prefix" ]] && __${c}_opt_takes_value "" "$_prev"; then return; fi`),m.push(` if [[ -n "$_inline_prefix" ]] && __${c}_opt_takes_value "" "\${_inline_prefix%=}"; then return; fi`),u.positionals.length>0?(m.push(` if (( _after_dd )); then`),m.push(...H(u.positionals,c,`root`,u.options).map(e=>` ${e}`)),m.push(` return`),m.push(` fi`)):m.push(` if (( _after_dd )); then return; fi`),m.push(` if [[ "$_cur" == -* ]]; then`),m.push(` local -a _avail=()`),m.push(...Qe(u.options,c)),m.push(' COMPREPLY=($(compgen -W "${_avail[*]}" -- "$_cur"))'),m.push(` compopt +o default 2>/dev/null`),d.length>0){m.push(` else`);let e=j(u.subcommands).map(e=>e.name).join(` `);m.push(...Xe(e,u.positionals,c,`root`,u.options).map(e=>` ${e}`))}else u.positionals.length>0&&(m.push(` else`),m.push(...H(u.positionals,c,`root`,u.options).map(e=>` ${e}`)));m.push(` fi`),m.push(`}`),m.push(``);let y=je(v,c).join(`
3
3
  `);m.push(`_${c}_completions() {`),m.push(` COMPREPLY=()`),m.push(``),m.push(` # Rejoin words split by '=' in COMP_WORDBREAKS`),m.push(` local -a _words=()`),m.push(` local _i=1`),m.push(` while (( _i <= COMP_CWORD )); do`),m.push(' if [[ "${COMP_WORDS[_i]}" == "=" && ${#_words[@]} -gt 0 ]]; then'),m.push(' _words[${#_words[@]}-1]+="=${COMP_WORDS[_i+1]:-}"'),m.push(` (( _i += 2 ))`),m.push(` else`),m.push(' _words+=("${COMP_WORDS[_i]}")'),m.push(` (( _i++ ))`),m.push(` fi`),m.push(` done`),m.push(``),m.push(` local _cur=""`),m.push(' (( ${#_words[@]} > 0 )) && _cur="${_words[${#_words[@]}-1]}"'),m.push(` local _inline_prefix=""`),m.push(``),m.push(` local _prev=""`),m.push(' (( ${#_words[@]} > 1 )) && _prev="${_words[${#_words[@]}-2]}"'),m.push(``),m.push(` local _subcmd="" _after_dd=0 _pos_count=0 _skip_next=0`),m.push(` local -a _used_opts=()`),h&&m.push(` local -a _pos_words=()`),m.push(` local _any_opt_used=0`),h&&(m.push(` ${V(`_arg_values_`)}`),m.push(` ${V(`_global_arg_values_`)}`)),_&&(m.push(` ${V(`_used_field_keys_`)}`),m.push(` ${V(`_global_used_field_keys_`)}`),m.push(` ${V(`_global_arr_seen_`)}`)),m.push(``),m.push(` local _j=0`),m.push(" while (( _j < ${#_words[@]} - 1 )); do"),m.push(' local _w="${_words[_j]}"'),m.push(` if (( _skip_next )); then _skip_next=0; (( _j++ )); continue; fi`),m.push(` if [[ "$_w" == "--" ]]; then _after_dd=1; (( _j++ )); continue; fi`);let b=h?`_pos_words+=("$_w"); `:``;m.push(` if (( _after_dd )); then ${b}(( _pos_count++ )); (( _j++ )); continue; fi`),m.push(` if [[ "$_w" == -*=* ]]; then`),m.push(' _used_opts+=("${_w%%=*}")'),m.push(` _any_opt_used=1`),h&&(m.push(` __${c}_track_opt "$_subcmd" "\${_w%%=*}" "\${_w#*=}"`),_&&m.push(` __${c}_track_array_expand "$_subcmd" "\${_w%%=*}" "\${_w#*=}"`)),m.push(` (( _j++ )); continue`),m.push(` fi`),m.push(` if [[ "$_w" == -* ]]; then`),m.push(` _used_opts+=("$_w")`),m.push(` _any_opt_used=1`),m.push(` if __${c}_opt_takes_value "$_subcmd" "$_w"; then`),m.push(' local _next="${_words[_j+1]:-}"'),m.push(` if [[ -n "$_next" && "$_next" != -* ]]; then _skip_next=1; fi`),h&&(m.push(` if (( _skip_next )); then`),m.push(` __${c}_track_opt "$_subcmd" "$_w" "$_next"`),_&&(m.push(" if (( _j + 2 < ${#_words[@]} )); then"),m.push(` __${c}_track_array_expand "$_subcmd" "$_w" "$_next"`),m.push(` fi`)),m.push(` fi`)),m.push(` fi`),m.push(` (( _j++ )); continue`),m.push(` fi`);let ee=_?`; ${V(`_arg_values_`)}; ${V(`_used_field_keys_`)}; ${V(`_global_arr_seen_`)}`:h?`; ${V(`_arg_values_`)}`:``,x=h?`_pos_words+=("$_w"); `:``;return v.length>0?m.push(` if __${c}_is_subcmd "$_subcmd" "$_w"; then _subcmd="\${_subcmd:+\${_subcmd}:}$_w"; _used_opts=(); _pos_count=0${h?`; _pos_words=()`:``}${ee}; else ${x}(( _pos_count++ )); fi`):(h&&m.push(` _pos_words+=("$_w")`),m.push(` (( _pos_count++ ))`)),m.push(` (( _j++ ))`),m.push(` done`),h&&m.push(` __${c}_track_positionals`),m.push(``),m.push(` if (( ! _after_dd )) && [[ "$_cur" == -*=* ]]; then`),m.push(' _inline_prefix="${_cur%%=*}="'),m.push(' _cur="${_cur#*=}"'),m.push(` fi`),m.push(``),m.push(` case "$_subcmd" in`),m.push(y),m.push(` *) __${c}_complete_root ;;`),m.push(` esac`),m.push(`}`),m.push(``),l||m.push(`complete -o default -F _${c}_completions ${r}`),m.push(``),{script:m.join(`
4
4
  `),shell:`bash`,installInstructions:`# To enable auto-refreshing bash completions, add this to your ~/.bashrc:
@@ -1,5 +1,5 @@
1
- import { C as AnyCommand, O as Command, T as ArgsSchema, _ as DynamicCompletionCandidate, b as DynamicCompletionResult, g as CompletionDirectiveMask, m as ExpandCompletion, rt as ResolvedFieldMeta, v as DynamicCompletionContext, y as DynamicCompletionResolver } from "./arg-registry-biPCZomY.js";
2
- import { _ as CompletionResult, a as bundledWorkerShellExtension, b as InferInternalArgs, c as validateBundledWorkerFile, d as CompletablePositional, f as CompletableSubcommand, g as CompletionOptions, h as CompletionMode, i as GenerateBundledCompletionWorkerResult, l as BundledWorkerOptions, m as CompletionGenerator, n as withCompletionCommand, o as defaultBundledWorkerOutputPath, p as CompletionData, r as GenerateBundledCompletionWorkerOptions, s as generateBundledCompletionWorker, t as WithCompletionOptions, u as CompletableOption, v as ShellType, x as InternalArgsSchema, y as ValueCompletion } from "./with-completion-command-BY-z7NOc.js";
1
+ import { C as AnyCommand, O as Command, T as ArgsSchema, _ as DynamicCompletionCandidate, b as DynamicCompletionResult, g as CompletionDirectiveMask, m as ExpandCompletion, rt as ResolvedFieldMeta, v as DynamicCompletionContext, y as DynamicCompletionResolver } from "./arg-registry-DNUJtjsZ.js";
2
+ import { _ as CompletionResult, a as bundledWorkerShellExtension, b as InferInternalArgs, c as validateBundledWorkerFile, d as CompletablePositional, f as CompletableSubcommand, g as CompletionOptions, h as CompletionMode, i as GenerateBundledCompletionWorkerResult, l as BundledWorkerOptions, m as CompletionGenerator, n as withCompletionCommand, o as defaultBundledWorkerOutputPath, p as CompletionData, r as GenerateBundledCompletionWorkerOptions, s as generateBundledCompletionWorker, t as WithCompletionOptions, u as CompletableOption, v as ShellType, x as InternalArgsSchema, y as ValueCompletion } from "./with-completion-command-BY8Oqe7B.js";
3
3
  /**
4
4
  * Schema for the completion command arguments
5
5
  */
@@ -1 +1 @@
1
- import"./register-BWzt6u5k.js";import{s as e,t}from"./with-completion-command-BojrmP1a.js";import{a as n,i as r,n as i,o as a,r as o,s,t as c}from"./dynamic-RKGUiswZ.js";import{a as l,c as u,d,i as f,l as p,n as m,o as h,r as g,s as _,t as v,u as y}from"./completion-DdSxJx-7.js";export{r as CompletionDirective,h as bundledWorkerShellExtension,v as createCompletionCommand,m as createCompletionWorkerPathCommand,c as createDynamicCompleteCommand,g as createRefreshCompletionCommand,_ as defaultBundledWorkerOutputPath,e as detectShell,y as extractCompletionData,d as extractPositionals,o as formatForShell,u as generateBundledCompletionWorker,n as generateCandidates,f as generateCompletion,l as getSupportedShells,i as hasCompleteCommand,a as parseCompletionContext,s as resolveValueCompletion,p as validateBundledWorkerFile,t as withCompletionCommand};
1
+ import"./register-BWzt6u5k.js";import{s as e,t}from"./with-completion-command-gytc9LNl.js";import{a as n,i as r,n as i,o as a,r as o,s,t as c}from"./dynamic-D9Y4kkfj.js";import{a as l,c as u,d,i as f,l as p,n as m,o as h,r as g,s as _,t as v,u as y}from"./completion-CKXI6y7R.js";export{r as CompletionDirective,h as bundledWorkerShellExtension,v as createCompletionCommand,m as createCompletionWorkerPathCommand,c as createDynamicCompleteCommand,g as createRefreshCompletionCommand,_ as defaultBundledWorkerOutputPath,e as detectShell,y as extractCompletionData,d as extractPositionals,o as formatForShell,u as generateBundledCompletionWorker,n as generateCandidates,f as generateCompletion,l as getSupportedShells,i as hasCompleteCommand,a as parseCompletionContext,s as resolveValueCompletion,p as validateBundledWorkerFile,t as withCompletionCommand};
package/dist/docs.d.ts CHANGED
@@ -1,5 +1,5 @@
1
- import { A as Example, C as AnyCommand, T as ArgsSchema, X as SubCommandValue, ft as SchemaLike, nt as ExtractedFields, rt as ResolvedFieldMeta } from "./arg-registry-biPCZomY.js";
2
- import * as fs$1 from "node:fs";
1
+ import { A as Example, C as AnyCommand, T as ArgsSchema, X as SubCommandValue, ft as SchemaLike, nt as ExtractedFields, rt as ResolvedFieldMeta } from "./arg-registry-DNUJtjsZ.js";
2
+ import * as fs from "node:fs";
3
3
  /**
4
4
  * Resolve a lazy-loaded command (sync or async)
5
5
  *
@@ -656,8 +656,8 @@ export declare function writeFile(filePath: string, content: string): void;
656
656
  * Minimal fs interface for deleteFile
657
657
  */
658
658
  interface DeleteFileFs {
659
- existsSync: typeof fs$1.existsSync;
660
- unlinkSync: typeof fs$1.unlinkSync;
659
+ existsSync: typeof fs.existsSync;
660
+ unlinkSync: typeof fs.unlinkSync;
661
661
  }
662
662
  /**
663
663
  * Build CommandInfo from a command
package/dist/docs.js CHANGED
@@ -18,7 +18,7 @@ import"./register-BWzt6u5k.js";import{c as e,n as t,o as n,r,s as i,t as a}from"
18
18
  `}}const ke={command:e=>W(e),tableStyle:W({optionStyle:`table`}),listStyle:W({optionStyle:`list`})};function Ae(e,t){let n=f.resolve(t);if(!u.existsSync(n))return{match:!1,fileExists:!1};let r=u.readFileSync(n,`utf-8`);return e===r?{match:!0,fileExists:!0}:{match:!1,diff:G(r,e),fileExists:!0}}function G(e,t){let n=e.split(`
19
19
  `),r=t.split(`
20
20
  `),i=[];i.push(`--- existing`),i.push(`+++ generated`),i.push(``);let a=Math.max(n.length,r.length),o=!1,s=0,c=[],l=()=>{c.length>0&&(i.push(`@@ -${s+1},${c.length} @@`),i.push(...c),c.length=0),o=!1};for(let e=0;e<a;e++){let t=n[e],i=r[e];if(t===i){if(o){c.push(` ${t??``}`);let e=c.findIndex((e,t)=>(e.startsWith(`-`)||e.startsWith(`+`))&&c.slice(t+1).every(e=>e.startsWith(` `)));e!==-1&&c.length-e>3&&l()}}else{if(!o){o=!0,s=e;let t=Math.max(0,e-3);for(let r=t;r<e;r++)c.push(` ${n[r]??``}`)}t!==void 0&&(i===void 0||t!==i)&&c.push(`-${t}`),i!==void 0&&(t===void 0||t!==i)&&c.push(`+${i}`)}}return l(),i.join(`
21
- `)}function K(e,t){let n=f.resolve(e),r=f.dirname(n);u.existsSync(r)||u.mkdirSync(r,{recursive:!0}),u.writeFileSync(n,t,`utf-8`)}function je(e){let t=f.resolve(e);return u.existsSync(t)?u.readFileSync(t,`utf-8`):null}function Me(e,t=u){let n=f.resolve(e);t.existsSync(n)&&t.unlinkSync(n)}async function Ne(e,t,n=[]){return Pe(e,t,n,!1)}async function Pe(t,n,a,o){let s=r(t),c=s?e(s):[],u=s?i(s):[],d=[];if(t.subCommands)for(let[e,n]of Object.entries(t.subCommands)){let r=await l(n,e=>o||!!t.requiredPackages?.length||!!e.requiredPackages?.length),i=[...a,e];d.push({name:e,description:r.description,aliases:r.aliases,fullPath:i})}return{name:t.name??``,description:t.description,aliases:t.aliases,fullCommandPath:a.length>0?`${n} ${a.join(` `)}`:n,commandPath:a.join(` `),depth:a.length+1,positionalArgs:c,options:u,subCommands:d,extracted:s,command:t,notes:t.notes,examples:t.examples}}async function Fe(e,t){let n=t??e.name??`command`,r=/* @__PURE__ */ new Map;async function i(e,t,a){a||=!!e.requiredPackages?.length;let o=await Pe(e,n,t,a),s=t.join(` `);if(r.set(s,o),e.subCommands)for(let[n,r]of Object.entries(e.subCommands))await i(await l(r,e=>a||!!e.requiredPackages?.length),[...t,n],a)}return await i(e,[],!1),r}async function Ie(e,t,n,r=[]){let i=[];t.mock&&await t.mock();try{for(let t of e){let e=await Le(t,n,r);i.push(e)}}finally{t.cleanup&&await t.cleanup()}return i}async function Le(e,t,n){let r=Re(e.cmd),i=[...n,...r],a=o({passthrough:!1});a.start();let s=!0;try{let{runCommand:e}=await import(`./runner-OAeVJgFF.js`),n=await e(t,i);s=n.success,!n.success&&n.error&&console.error(n.error.message)}catch(e){s=!1,console.error(e instanceof Error?e.message:String(e))}finally{a.stop()}let c=a.getLogs(),l=c.entries.filter(e=>e.stream===`stdout`).map(e=>e.message).join(`
21
+ `)}function K(e,t){let n=f.resolve(e),r=f.dirname(n);u.existsSync(r)||u.mkdirSync(r,{recursive:!0}),u.writeFileSync(n,t,`utf-8`)}function je(e){let t=f.resolve(e);return u.existsSync(t)?u.readFileSync(t,`utf-8`):null}function Me(e,t=u){let n=f.resolve(e);t.existsSync(n)&&t.unlinkSync(n)}async function Ne(e,t,n=[]){return Pe(e,t,n,!1)}async function Pe(t,n,a,o){let s=r(t),c=s?e(s):[],u=s?i(s):[],d=[];if(t.subCommands)for(let[e,n]of Object.entries(t.subCommands)){let r=await l(n,e=>o||!!t.requiredPackages?.length||!!e.requiredPackages?.length),i=[...a,e];d.push({name:e,description:r.description,aliases:r.aliases,fullPath:i})}return{name:t.name??``,description:t.description,aliases:t.aliases,fullCommandPath:a.length>0?`${n} ${a.join(` `)}`:n,commandPath:a.join(` `),depth:a.length+1,positionalArgs:c,options:u,subCommands:d,extracted:s,command:t,notes:t.notes,examples:t.examples}}async function Fe(e,t){let n=t??e.name??`command`,r=/* @__PURE__ */ new Map;async function i(e,t,a){a||=!!e.requiredPackages?.length;let o=await Pe(e,n,t,a),s=t.join(` `);if(r.set(s,o),e.subCommands)for(let[n,r]of Object.entries(e.subCommands))await i(await l(r,e=>a||!!e.requiredPackages?.length),[...t,n],a)}return await i(e,[],!1),r}async function Ie(e,t,n,r=[]){let i=[];t.mock&&await t.mock();try{for(let t of e){let e=await Le(t,n,r);i.push(e)}}finally{t.cleanup&&await t.cleanup()}return i}async function Le(e,t,n){let r=Re(e.cmd),i=[...n,...r],a=o({passthrough:!1});a.start();let s=!0;try{let{runCommand:e}=await import(`./runner-ysBTWTf6.js`),n=await e(t,i);s=n.success,!n.success&&n.error&&console.error(n.error.message)}catch(e){s=!1,console.error(e instanceof Error?e.message:String(e))}finally{a.stop()}let c=a.getLogs(),l=c.entries.filter(e=>e.stream===`stdout`).map(e=>e.message).join(`
22
22
  `),u=c.entries.filter(e=>e.stream===`stderr`).map(e=>e.message).join(`
23
23
  `);return{cmd:e.cmd,desc:e.desc,expectedOutput:e.output,stdout:l,stderr:u,success:s}}function Re(e){let t=[],n=``,r=!1,i=``;for(let a=0;a<e.length;a++){let o=e[a];(o===`"`||o===`'`)&&!r?(r=!0,i=o):o===i&&r?(r=!1,i=``):o===` `&&!r?n&&=(t.push(n),``):n+=o}return n&&t.push(n),t}function ze(e){let t=s();return Object.entries(e).map(([e,n])=>t.resolveFieldMeta(e,n))}function Be(e,t){let n=ze(e).filter(e=>!e.positional);return n.length===0?``:O(y(n),t?.columns)}function Ve(e){return e.replace(/\|/g,`\\|`).replace(/\n/g,` `)}function He(e){return e.replace(/\s+/g,`-`).toLowerCase()}function Ue(e){return e.subCommands.length===0}function We(e,t){return e===t?!0:t===``?e!==``:e.startsWith(t+` `)}function Ge(e,t,n){let r=[];for(let i of e){let e=t.get(i);if(e){if(Ue(e))r.push(i);else for(let[e,a]of t)(i===``?e.length>0:e.startsWith(i+` `)||e===i)&&(Ue(a)||!n)&&r.push(e)}}return r}function Ke(e,t,n,r){let i=`#`.repeat(n),a=[];a.push(`${i} [${e.title}](${e.docPath})`),a.push(``),a.push(e.description),a.push(``);let o=e.noExpand?e.commands:Ge(e.commands,t,r),s=o,c=/* @__PURE__ */ new Set;if(e.allowedCommands){let t=new Set(e.allowedCommands);s=o.filter(e=>t.has(e));for(let n of e.commands)t.has(n)&&!s.some(e=>We(e,n))&&(s.push(n),c.add(n))}a.push(`| Command | Description |`),a.push(`|---------|-------------|`);for(let n of s){let i=t.get(n);if(!i||!e.noExpand&&r&&!c.has(n)&&!Ue(i))continue;let o=n||i.name,s=He(o),l=Ve(i.description??``);a.push(`| [${o}](${e.docPath}#${s}) | ${l} |`)}return a.join(`
24
24
  `)}async function qe(e,t,n){let r=n?.headingLevel??3,i=n?.leafOnly??!0,a=await Fe(e),o=[];for(let e of t){let t=Ke(e,a,r,i);o.push(t)}return o.join(`
@@ -0,0 +1 @@
1
+ export{t as createDynamicCompleteCommand}from"./dynamic-D9Y4kkfj.js";
@@ -1,4 +1,4 @@
1
- import{n as e}from"./command-BXsTrIgI.js";import{c as t,i as n}from"./subcommand-router-CfCW9eG4.js";import{a as r,n as i,u as a}from"./schema-extractor-Cwg_WAC-.js";import{n as o,o as s,r as c,s as l,u}from"./argv-parser-bI3e6XXA.js";import{d,p as f}from"./unflatten-DVeO9OZ_.js";import{t as p}from"./schema-BF9YOHU0.js";import{execSync as m}from"node:child_process";function h(e,t,n){return{fieldName:e.name,isArrayOption:e.valueType===`array`,isGlobal:e.isGlobal===!0,resolvedDeps:_(e.valueCompletion,e.isGlobal===!0,t,n)}}function g(e,t,n){return{fieldName:e.name,isArrayOption:!1,isGlobal:!1,resolvedDeps:_(e.valueCompletion,!1,t,n)}}function _(e,t,n,r=[]){if(e?.type!==`expand`)return[];let i=/* @__PURE__ */ new Set,a=/* @__PURE__ */ new Set;for(let e of n)e.isGlobal===!0?i.add(e.name):a.add(e.name);for(let e of r)a.add(e.name);return e.dependsOn.map(e=>({name:e,isGlobal:t||i.has(e)&&!a.has(e)}))}function v(e){let t=`$'`;for(let n of e){let e=n.codePointAt(0);t+=n===`\\`?`\\\\`:n===`'`?`\\'`:n===`
1
+ import{n as e}from"./command-CCiN78NV.js";import{c as t,i as n}from"./subcommand-router-CfCW9eG4.js";import{a as r,n as i,u as a}from"./schema-extractor-Cwg_WAC-.js";import{n as o,o as s,r as c,s as l,u}from"./argv-parser-bI3e6XXA.js";import{d,p as f}from"./unflatten-DVeO9OZ_.js";import{t as p}from"./schema-BF9YOHU0.js";import{execSync as m}from"node:child_process";function h(e,t,n){return{fieldName:e.name,isArrayOption:e.valueType===`array`,isGlobal:e.isGlobal===!0,resolvedDeps:_(e.valueCompletion,e.isGlobal===!0,t,n)}}function g(e,t,n){return{fieldName:e.name,isArrayOption:!1,isGlobal:!1,resolvedDeps:_(e.valueCompletion,!1,t,n)}}function _(e,t,n,r=[]){if(e?.type!==`expand`)return[];let i=/* @__PURE__ */ new Set,a=/* @__PURE__ */ new Set;for(let e of n)e.isGlobal===!0?i.add(e.name):a.add(e.name);for(let e of r)a.add(e.name);return e.dependsOn.map(e=>({name:e,isGlobal:t||i.has(e)&&!a.has(e)}))}function v(e){let t=`$'`;for(let n of e){let e=n.codePointAt(0);t+=n===`\\`?`\\\\`:n===`'`?`\\'`:n===`
2
2
  `?`\\n`:n===`\r`?`\\r`:n===` `?`\\t`:e<32||e===127?`\\x${e.toString(16).padStart(2,`0`)}`:n}return t+=`'`,t}function y(e){return`'${e.replace(/'/g,`'\\''`)}'`}function b(e,t){let n=t.withSize?`%Y:%s`:`%Y`,r=t.withSize?`%m:%z`:`%m`,i=`stat -L -c '${n}' "${e}" 2>/dev/null`,a=`stat -L -f '${r}' "${e}" 2>/dev/null`;return t.shell===`fish`?`(${i}; or ${a})`:`$(${i} || ${a})`}function x(e){return e.length===1?`-${e}`:`--${e}`}function S(e,t){C(e,x(t)),t.length===1?C(e,`--${t}`):t.includes(`-`)&&C(e,`--${f(t)}`)}function C(e,t){e.includes(t)||e.push(t)}function w(e,t){let n=[`--${e}`];e.length===1&&n.push(`-${e}`),e.includes(`-`)&&n.push(`--${f(e)}`);for(let e of t??[])S(n,e);return n}function T(e){let t=/* @__PURE__ */ new Set;for(let n of e)if(n.isGlobal===!0){n.cliName.length===1&&t.add(`-${n.cliName}`);for(let e of n.alias??[])e.length===1&&t.add(`-${e}`)}return t}function E(e,t,n,r){let i=new Set(w(e,t));if(n&&(i.add(`--${n}`),n.includes(`-`)&&i.add(`--${f(n)}`)),r?.frameOptions){if(r.isGlobal===!0){for(let e of r.frameOptions)if(e.isGlobal!==!0)for(let t of A(e.cliName,e.alias))i.delete(t)}else{let e=T(r.frameOptions);if(e.size>0){let n=new Set((t??[]).filter(e=>e.length===1).map(e=>`-${e}`));for(let t of e)n.has(t)||i.delete(t)}}}return[...i].map(e=>`"${e}"`)}function D(e,t){return e.map(e=>{let n=t.find(t=>t.isGlobal!==!0&&t.name===e.name);return n&&E(n.cliName,n.alias,n.negation,{frameOptions:t})})}function O(e,t,n,r=`$_pos_count`){let i=D(e,t);if(i.every(e=>e===void 0))return;let a=[` local _slot=-1 _left=${r}`];return e.forEach((e,t)=>{let r=i[t],o=r?` && __${n}_not_used ${r.join(` `)}`:``,s=e.variadic?`_slot=${e.position}`:`if (( _left == 0 )); then _slot=${e.position}; else (( _left-- )); fi`;a.push(` if (( _slot < 0 ))${o}; then ${s}; fi`)}),a}function k(e,t){let n=[`__${e}_track_positionals() {`,` local _k=0 _w`,' for _w in "${_pos_words[@]}"; do',` local _slot=$_k`,` case "$_subcmd" in`];for(let r of t){n.push(` ${r.pathStrs.map(e=>`"${e}"`).join(`|`)})`);for(let t of O(r.positionals,r.options,e,`$_k`)??[])n.push(` ${t}`);n.push(` ;;`)}return n.push(` esac`,` __${e}_track_pos "$_subcmd" "$_slot" "$_w"`,` (( _k++ ))`,` done`,`}`,``),n}function A(e,t){let n=[`--${e}`];e.includes(`-`)&&n.push(`--${f(e)}`);for(let e of t??[])S(n,e);return n}function j(e){let t=e.completion;if(t?.custom){let n=t.custom,r=[];if(n.expand&&r.push(`expand`),n.resolve&&r.push(`resolve`),n.choices&&n.choices.length>0&&r.push(`choices`),n.shellCommand&&r.push(`shellCommand`),r.length>1)throw Error(`Field "${e.name??`<unknown>`}": completion.custom may only specify one of choices, shellCommand, resolve, expand (got ${r.join(`, `)}).`);if(n.expand)return{type:`pending-expand`,spec:n.expand};if(n.resolve)return{type:`dynamic`,resolve:n.resolve};if(n.choices&&n.choices.length>0)return{type:`choices`,choices:n.choices};if(n.shellCommand)return{type:`command`,shellCommand:n.shellCommand}}if(t?.type){if(t.type===`file`)return t.matcher?{type:`file`,matcher:t.matcher}:t.extensions?{type:`file`,extensions:t.extensions}:{type:`file`};if(t.type===`directory`)return{type:`directory`};if(t.type===`none`)return{type:`none`}}if(e.enumValues&&e.enumValues.length>0)return{type:`choices`,choices:e.enumValues}}function M(e){if(e)return e.type===`pending-expand`?{type:`runtime-expand`,dependsOn:e.spec.dependsOn,enumerate:e.spec.enumerate}:e}function ee(e){return e.args?N(e.args):[]}function N(e){return r(i(e)).map(P)}function P(e){let t=d(e);return{name:e.name,cliName:e.cliName,alias:t.length>0?t:void 0,negation:e.negationDisplay,negationDescription:e.negationDescription,description:e.description,takesValue:e.type!==`boolean`,valueType:e.type,required:e.required,defaultNegationAccepted:e.type===`boolean`&&e.negation===!0,valueCompletion:M(j(e))}}function F(e){return new Set(w(e.cliName,e.alias))}function te(e,t){let n=F(t);for(let t of e)for(let e of F(t))if(n.has(e))return t}function ne(e,t,n){let r=/* @__PURE__ */ new Set;if(t.length===0)return r;let i=/* @__PURE__ */ new Set,a=(e,t)=>{G(n,e,t,i),r.add(e.name)},s=0;for(;s<e.length;){let i=e[s];if(i===`--`||!i.startsWith(`-`))break;if(c(i)){let{isGlobal:c,flags:l,valueOption:u}=z(i,t);if(!c)break;for(let{opt:e}of l)n[e.name]=!0,r.add(e.name);if(u?.value!==void 0)a(u.opt,u.value);else if(u){let t=e[s+1];if(t===void 0)break;o(t)&&(a(u.opt,t),s++)}s++;continue}if(!i.startsWith(`--`)&&i.length>2){let e=i.indexOf(`=`);if((e>=0?i.slice(1,e):i.slice(1)).length>1)break}let l=R(i),u=q(t,l);if(!u){if(de(t,l)){s++;continue}break}if(u.takesValue){if(B(i)){let e=i.indexOf(`=`);a(u,i.slice(e+1)),s++}else if(s+1<e.length){let t=e[s+1];if(!o(t)){s++;continue}a(u,t),s+=2}else break}else{let e=V(u,l,i);e!==void 0&&(n[u.name]=e),r.add(u.name),s++}}return r}function re(e,t){return t.valueType===`array`?Array.isArray(e)?e:[e]:Array.isArray(e)?e.at(-1):e}function ie(e,t){return t.length===0?e:[...e,...t]}function ae(e,t){let n=t.length-1;if(!(n<0))return e>n?n:e}function I(e,t){return n=>{let r={...e};return s(n,e).forEach((e,n)=>{n<t.length&&(r[e.name]=t[n])}),r}}function oe(e,t,n){if(!e.args)return;let r=i(e.args),o=a(r,I(t,n));if(o!==r)return o.fields.filter(e=>e.named).map(P)}function se(e,t,n){if(!e.args)return[];let r=a(i(e.args),I(t,n));return s(r,t).map((e,t)=>({name:e.name,cliName:e.cliName,position:t,description:e.description,required:e.required,variadic:e.type===`array`,valueCompletion:M(j(e))}))}function ce(e){if(!e.subCommands)return[];let n=[];for(let[r,i]of Object.entries(e.subCommands)){if(r.startsWith(`__`))continue;n.push(r);let e=t(i);e?.aliases&&n.push(...e.aliases)}return n}function le(e,r){if(!e.subCommands)return null;let i=Object.hasOwn(e.subCommands,r)?e.subCommands[r]:void 0;if(i)return t(i);let a=n(e,r);return a?t(e.subCommands[a]):null}function L(e){return e.startsWith(`-`)}function R(e){if(e.startsWith(`--`)){let t=e.slice(2),n=t.indexOf(`=`);return{name:n>=0?t.slice(0,n):t,isLong:!0}}return e.startsWith(`-`)?{name:e.slice(1,2),isLong:!1}:{name:e,isLong:!0}}function z(e,t){let n=(e,t)=>q(e,{name:t,isLong:!1}),r=t.filter(e=>e.isGlobal!==!0),i=t.filter(e=>e.isGlobal===!0),a=e=>!n(r,e)&&n(i,e)!==void 0,o=l(e.slice(1),e=>a(e)&&n(i,e).takesValue),s=o.flags.every(a),c=s?i:r,{flags:u,valueOption:d}=s?o:l(e.slice(1),e=>n(r,e)?.takesValue===!0);return{isGlobal:s,flags:u.flatMap(e=>{let t=n(c,e);return t?[{opt:t,name:e}]:[]}),valueOption:d&&{opt:n(c,d.name),value:d.value}}}function ue(e,t){let{valueOption:n}=z(e,t);return n?.value===void 0?n?.opt:void 0}function B(e){return e.includes(`=`)}function V(e,t,n){let r=fe(e,t);return B(n)?r?void 0:u(n.slice(n.indexOf(`=`)+1)):!r}function H(e,t,n){if(!n||e.valueType!==`boolean`)return!1;let r=[e.cliName,...e.alias??[]];for(let e of r){let n=`no-${e}`;if(t===n||t===f(n))return!0}return!1}function U(e,t,n){return e.defaultNegationAccepted===!0&&H(e,t,n)}function de(e,t){return e.some(e=>e.defaultNegationAccepted!==!0&&H(e,t.name,t.isLong))}function W(e,t){return e!==void 0&&e.includes(`-`)&&f(e)===t}function G(e,t,n,r){if(t.valueType!==`array`)e[t.name]=n;else if(r.has(t.name)){let r=e[t.name];e[t.name]=Array.isArray(r)?[...r,n]:[n]}else e[t.name]=[n],r.add(t.name)}function fe(e,t){return t.isLong?e.negation!==void 0&&(e.negation===t.name||W(e.negation,t.name))?!0:U(e,t.name,t.isLong):!1}function K(e,t,n){if(e.cliName===t&&(n||e.cliName.length===1))return!0;if(e.alias){for(let r of e.alias)if(r===t&&(n||r.length===1))return!0}return n&&e.negation===t?!0:!n||t.length<=1?!1:W(e.cliName,t)||e.alias?.some(e=>W(e,t))?!0:W(e.negation,t)}function q(e,t){if(!t.isLong){let n=e.find(e=>e.isGlobal!==!0&&e.alias?.includes(t.name)===!0);if(n)return n;let r=e.find(e=>e.isGlobal===!0&&K(e,t.name,t.isLong));if(r)return r}return e.find(e=>K(e,t.name,t.isLong))||e.find(e=>U(e,t.name,t.isLong))}function J(e,t,n){let r=Y(e,t,n);return r.variantOptions?Y(e,t,n,{command:r.context.currentCommand,options:r.variantOptions}).context:r.context}function Y(e,t,n,r){let i=e=>e===r?.command?r.options:ee(e),a=t,s=[],l=n?N(n).map(e=>({...e,isGlobal:!0})):[],u=/* @__PURE__ */ new Set,d=!1,f=0,p={},m=[],h={},g=/* @__PURE__ */ new Set,_=0,v=/* @__PURE__ */ new Set,y=e=>{u.add(e.cliName);for(let t of e.alias??[])u.add(t);e.negation&&u.add(e.negation),d=!0},b=(e,t)=>{G(e.isGlobal===!0?h:p,e,t,v)},x=(e,t,n=``)=>{let r=e.isGlobal===!0?h:p,i=V(e,t,n);i!==void 0&&(r[e.name]=i)},S=0,C=ie(i(a),l),w=!1;for(;S<e.length-1;){let t=e[S];if(!w&&t===`--`){w=!0,S++;continue}if(!w&&c(t)){d=!0;let{flags:n,valueOption:r}=z(t,C);for(let{opt:e,name:t}of n)y(e),x(e,{name:t,isLong:!1});r&&(y(r.opt),r.value===void 0?S+1<e.length-1&&o(e[S+1])&&(b(r.opt,e[S+1]),S++):b(r.opt,r.value)),S++;continue}if(!w&&L(t)){d=!0;let n=R(t),r=q(C,n);if(r){if(y(r),r.takesValue){if(B(t)){let e=t.indexOf(`=`);b(r,t.slice(e+1))}else if(S+1<e.length-1){let t=e[S+1];o(t)&&(b(r,t),S++)}}else x(r,n,t)}S++;continue}let n=w?null:le(a,t);if(n){s.push(t);let r=i(a),o=e.slice(_,S);for(let e of ne(o,l,h))g.add(e);a=n,C=ie(i(a),l);for(let e of Object.keys(p)){let t=r.find(t=>t.name===e),n=l.find(t=>t.name===e)??(t?te(l,t):void 0);n&&(g.has(n.name)||(h[n.name]=re(p[e],n)))}u.clear(),f=0,p={},m=[],v=/* @__PURE__ */ new Set,_=S+1,S++}else m.push(t),f++,S++}let T=e[e.length-1]??``,E=e[e.length-2]??``,D=oe(a,p,m),O=se(a,p,m),k=ce(a);for(let e=0;e<O.length;e++){let t=O[e];if(t.variadic){p[t.name]=m.slice(e);break}e<m.length&&(p[t.name]=m[e])}let A,j,M;if(!w&&E&&L(E)&&!B(E)){let e=c(E)?ue(E,C):q(C,R(E));e&&e.takesValue?(A=`option-value`,j=e):T.startsWith(`-`)?A=`option-name`:(A=X(T,k,O,f),A===`positional`&&(M=f))}else if(!w&&T.startsWith(`-`)&&B(T)){let e=q(C,R(T));e&&e.takesValue?(A=`option-value`,j=e):A=`option-name`}else!w&&T.startsWith(`-`)?A=`option-name`:(A=X(T,k,O,f,w),A===`positional`&&(M=f));let P=[];if(j){if(j.valueType===`array`){let e=(j.isGlobal===!0?h:p)[j.name];P=Array.isArray(e)?e.filter(e=>typeof e==`string`):[]}}else if(A===`positional`&&M!==void 0){let e=ae(M,O);e!==void 0&&O[e]?.variadic&&(P=m.slice(e))}let F={...h,...p};return{context:{subcommandPath:s,currentCommand:a,currentWord:T,previousWord:E,completionType:A,targetOption:j,positionalIndex:M,options:C,subcommands:k,positionals:O,usedOptions:u,hasAnyOptionBeenUsed:d,providedPositionalCount:f,parsedArgs:F,previousValues:P},variantOptions:D}}function X(e,t,n,r,i){return i?`positional`:t.length>0&&(t.filter(t=>t.startsWith(e)).length>0||e===``)?`subcommand`:r<n.length||n.length>0&&n[n.length-1].variadic?`positional`:`subcommand`}const Z={Default:0,NoSpace:1,NoFileCompletion:2,FilterPrefix:4,KeepOrder:8,FileCompletion:16,DirectoryCompletion:32,Error:64};function pe(e){if(!e.startsWith(`-`))return;let t=e.indexOf(`=`);if(!(t<=0))return e.slice(0,t+1)}async function me(e,t){switch(e.completionType){case`subcommand`:return we(e);case`option-name`:return Te(e);case`option-value`:{let n=e.targetOption,r=n?pe(e.currentWord):void 0;return Q(r?{...e,currentWord:e.currentWord.slice(r.length)}:e,t,n?.name,n?.valueCompletion,void 0,n?.valueType===`array`)}case`positional`:{let n=he(e);return n?Q(e,t,n.name,n.valueCompletion,n.description,!1):{candidates:[],directive:Z.NoFileCompletion}}}}function he(e){let t=e.positionalIndex??0,n=ae(t,e.positionals);if(n===void 0)return;let r=e.positionals[n];if(r)return n===t||r.variadic?r:void 0}function ge(e){try{return m(e,{encoding:`utf-8`,timeout:5e3}).split(`
3
3
  `).map(e=>e.trim()).filter(e=>e.length>0).map(e=>({value:e,type:`value`}))}catch{return[]}}function _e(e){return e?.type===`choices`?e.choices:void 0}function ve(e,t){let n=e.options.find(e=>e.name===t&&e.isGlobal!==!0);if(n)return _e(n.valueCompletion);let r=e.positionals.find(e=>e.name===t);return _e(r?r.valueCompletion:e.options.find(e=>e.name===t&&e.isGlobal===!0)?.valueCompletion)}function ye(e,t){let n=!t.includes(`=`),r=n?be(e):xe(e,t);return{candidates:r,hasEqSuffix:n&&r.some(e=>e.value.endsWith(`=`))}}function be(e){let t=/* @__PURE__ */ new Set,n=[];for(let r of e){let e=r.value.indexOf(`=`);if(e<=0){n.push(r);continue}let i=r.value.slice(0,e+1);t.has(i)||(t.add(i),n.push({...r,value:i}))}return n}function xe(e,t){let n=t.slice(0,t.indexOf(`=`)+1);return e.filter(e=>e.value!==n)}async function Se(e,t,n,r,i){let a=[],o=Z.FilterPrefix,s,c;switch(e.type){case`choices`:if(e.choices)for(let t of e.choices)a.push({value:t,description:r,type:`value`});o|=Z.NoFileCompletion;break;case`file`:e.matcher&&e.matcher.length>0?(c=e.matcher.filter(e=>e.trim().length>0),c.length===0&&(c=void 0,o|=Z.FileCompletion)):e.extensions&&e.extensions.length>0?(s=Array.from(new Set(e.extensions.map(e=>e.trim().replace(/^\./,``)).filter(e=>e.length>0))),s.length===0&&(s=void 0,o|=Z.FileCompletion)):o|=Z.FileCompletion;break;case`directory`:o|=Z.DirectoryCompletion;break;case`command`:e.shellCommand&&a.push(...ge(e.shellCommand)),o|=Z.NoFileCompletion;break;case`none`:o|=Z.NoFileCompletion;break;case`dynamic`:try{let n=await e.resolve(t);for(let e of n.candidates){let t=typeof e==`string`?{value:e}:e;a.push({...t,type:`value`})}o=n.directive??Z.FilterPrefix|Z.NoFileCompletion}catch{o=Z.NoFileCompletion|Z.Error}break;case`expand`:o|=Z.NoFileCompletion;break;case`runtime-expand`:{let r={},i=!1;for(let a of e.dependsOn){let e=t.parsedArgs[a],o=Array.isArray(e)?e[e.length-1]:e,s=ve(n,a);if(typeof o!=`string`||s===void 0||!s.includes(o)){i=!0;break}r[a]=o}if(!i)try{let t=/* @__PURE__ */ new Set;for(let n of e.enumerate(r)){let e=typeof n==`string`?{value:n}:n;t.has(e.value)||(t.add(e.value),a.push({...e,type:`value`}))}}catch{o=Z.NoFileCompletion|Z.Error;break}o|=Z.NoFileCompletion;break}}if(e.type===`dynamic`||e.type===`expand`||e.type===`runtime-expand`){let n=ye(e.type===`runtime-expand`&&i===!0?Ce(a,t.previousValues):a,t.currentWord);return n.hasEqSuffix&&(o|=Z.NoSpace),{candidates:n.candidates,directive:o,fileExtensions:s,fileMatchers:c}}return{candidates:a,directive:o,fileExtensions:s,fileMatchers:c}}function Ce(e,t){let n=/* @__PURE__ */ new Set;for(let e of t){let t=e.indexOf(`=`);t>0&&n.add(e.slice(0,t))}return n.size===0?[...e]:e.filter(e=>{let t=e.value.indexOf(`=`);return t<=0||!n.has(e.value.slice(0,t))})}function we(e){let r=[];for(let i of e.subcommands){let a=e.currentCommand.subCommands,o=a?.[i],s=o?void 0:n(e.currentCommand,i),c=o??(s?a?.[s]:void 0),l=c?t(c)?.description:void 0;r.push({value:i,description:l,type:`subcommand`})}if(r.length===0||e.currentWord.startsWith(`-`)){let t=Te(e);r.push(...t.candidates)}return{candidates:r,directive:Z.FilterPrefix|Z.NoFileCompletion}}function Te(e){let t=[],n=e.options.filter(t=>t.valueType===`array`||!(e.usedOptions.has(t.cliName)||t.alias&&t.alias.some(t=>e.usedOptions.has(t))||t.negation&&e.usedOptions.has(t.negation)));for(let e of n)t.push({value:`--${e.cliName}`,description:e.description,type:`option`}),e.negation&&t.push({value:`--${e.negation}`,description:e.negationDescription??e.description,type:`option`});return e.hasAnyOptionBeenUsed||t.push({value:`--help`,description:`Show help information`,type:`option`},{value:`--help-all`,description:`Show help with all subcommand options`,type:`option`},{value:`--help-json`,description:`Show help as JSON`,type:`option`}),{candidates:t,directive:Z.FilterPrefix|Z.NoFileCompletion}}function Ee(e,t,n){return{currentWord:e.currentWord,shell:t.shell,parsedArgs:De(e.parsedArgs,n),previousValues:e.previousValues,subcommandPath:e.subcommandPath}}function De(e,t){if(t===void 0||!(t in e))return e;let n={...e};return delete n[t],n}async function Q(e,t,n,r,i,a){return r?Se(r,Ee(e,t,n),e,i,a):{candidates:[],directive:Z.FilterPrefix}}function Oe(e,t){switch(t.shell){case`bash`:return ke(e,t);case`zsh`:return Ae(e,t);case`fish`:return je(e,t)}}function $(e,t){let n=`:${t.directive}`;t.fileExtensions&&t.fileExtensions.length>0&&(n+=`\t@ext:${t.fileExtensions.join(`,`)}`),t.fileMatchers&&t.fileMatchers.length>0&&(n+=`\t@matcher:${t.fileMatchers.join(`,`)}`),e.push(n)}function ke(e,t){let n=((e.directive&Z.FilterPrefix)!==0&&t.currentWord?e.candidates.filter(e=>e.value.startsWith(t.currentWord)):e.candidates).map(e=>t.inlinePrefix?`${t.inlinePrefix}${e.value}`:e.value);return $(n,e),n.join(`
4
4
  `)}function Ae(e,t){let n=e.candidates.map(e=>{let t=e.value.replace(/:/g,`\\:`);return e.description?`${t}:${e.description.replace(/:/g,`\\:`)}`:t});return $(n,e),n.join(`
package/dist/index.d.ts CHANGED
@@ -9,8 +9,8 @@ import "./global-args.politty";
9
9
  *
10
10
  * @packageDocumentation
11
11
  */
12
- import { $ as LazyCommand, A as Example, B as NonRunnableCommand, C as AnyCommand, D as CollectedLogs, E as CleanupContext, F as LogEntry, G as RunResult, H as PromptResolverContext, I as LogLevel, J as RunnableCommand, K as RunResultFailure, L as LogStream, M as GlobalCleanupContext, N as GlobalSetupContext, O as Command, P as IsEmpty, Q as UnknownSubcommandHandler, R as Logger, S as AgentHelpContext, T as ArgsSchema$1, U as RunCommandOptions, V as PromptResolver, W as RunInvocation, X as SubCommandValue, Y as SetupContext, Z as SubCommandsRecord, _ as DynamicCompletionCandidate, a as CustomCompletion, at as toCamelCase, b as DynamicCompletionResult, c as PromptChoicesContext, ct as UnflattenOptions, d as PromptType, dt as InferSchemaOutput, et as isLazyCommand, f as ValidateArgMeta, ft as SchemaLike, g as CompletionDirectiveMask, h as ResolvedExpandCandidate, i as CompletionType, it as UnknownKeysMode, j as GlobalArgs, k as CommandBase, l as PromptChoicesResolver, lt as PackageRequirement, m as ExpandCompletion, n as ArgMeta, nt as ExtractedFields, o as EffectContext, ot as toKebabCase, p as ExpandCandidate, q as RunResultSuccess, r as CompletionMeta, rt as ResolvedFieldMeta, s as PromptChoices, st as Unflatten, t as ArgFn, tt as lazy, u as PromptMeta, ut as loadPackage, v as DynamicCompletionContext, w as ArgSource, x as AgentHelp, y as DynamicCompletionResolver, z as MainOptions } from "./arg-registry-biPCZomY.js";
13
- import { _ as CompletionResult, g as CompletionOptions, i as GenerateBundledCompletionWorkerResult, n as withCompletionCommand, r as GenerateBundledCompletionWorkerOptions, t as WithCompletionOptions, x as InternalArgsSchema } from "./with-completion-command-BY-z7NOc.js";
12
+ import { $ as LazyCommand, A as Example, B as NonRunnableCommand, C as AnyCommand, D as CollectedLogs, E as CleanupContext, F as LogEntry, G as RunResult, H as PromptResolverContext, I as LogLevel, J as RunnableCommand, K as RunResultFailure, L as LogStream, M as GlobalCleanupContext, N as GlobalSetupContext, O as Command, P as IsEmpty, Q as UnknownSubcommandHandler, R as Logger, S as AgentHelpContext, T as ArgsSchema$1, U as RunCommandOptions, V as PromptResolver, W as RunInvocation, X as SubCommandValue, Y as SetupContext, Z as SubCommandsRecord, _ as DynamicCompletionCandidate, a as CustomCompletion, at as toCamelCase, b as DynamicCompletionResult, c as PromptChoicesContext, ct as UnflattenOptions, d as PromptType, dt as InferSchemaOutput, et as isLazyCommand, f as ValidateArgMeta, ft as SchemaLike, g as CompletionDirectiveMask, h as ResolvedExpandCandidate, i as CompletionType, it as UnknownKeysMode, j as GlobalArgs, k as CommandBase, l as PromptChoicesResolver, lt as PackageRequirement, m as ExpandCompletion, n as ArgMeta, nt as ExtractedFields, o as EffectContext, ot as toKebabCase, p as ExpandCandidate, q as RunResultSuccess, r as CompletionMeta, rt as ResolvedFieldMeta, s as PromptChoices, st as Unflatten, t as ArgFn, tt as lazy, u as PromptMeta, ut as loadPackage, v as DynamicCompletionContext, w as ArgSource, x as AgentHelp, y as DynamicCompletionResolver, z as MainOptions } from "./arg-registry-DNUJtjsZ.js";
13
+ import { _ as CompletionResult, g as CompletionOptions, i as GenerateBundledCompletionWorkerResult, n as withCompletionCommand, r as GenerateBundledCompletionWorkerOptions, t as WithCompletionOptions, x as InternalArgsSchema } from "./with-completion-command-BY8Oqe7B.js";
14
14
  import { r as KnownAgentId, t as AgentInfo } from "./detect-agent-hU93hctO.js";
15
15
  import { z } from "zod";
16
16
  /**
@@ -242,7 +242,7 @@ type InferArgs<TArgsSchema> = TArgsSchema extends InternalArgsSchema<infer TInte
242
242
  */
243
243
  type MergedArgs<TLocalArgs, TGlobalArgs> = IsEmpty<TGlobalArgs> extends true ? TLocalArgs : TLocalArgs & WithCaseVariants<TGlobalArgs>;
244
244
  /**
245
- * Add the `$source`, `$invocation` and `$agent` run-time metadata helpers.
245
+ * Add the `$source`, `$invocation`, `$agent` and `$signal` run-time metadata helpers.
246
246
  *
247
247
  * `$source` reports whether a given field's final value came from an
248
248
  * explicit CLI token, a `field.env` fallback, a `prompt` resolver answer, or
@@ -259,11 +259,15 @@ type MergedArgs<TLocalArgs, TGlobalArgs> = IsEmpty<TGlobalArgs> extends true ? T
259
259
  *
260
260
  * `$agent` reports the AI coding agent running the CLI (see `detectAgent`),
261
261
  * or `undefined` when none is detected.
262
+ *
263
+ * `$signal` is aborted when `runMain` receives SIGINT or SIGTERM before `run`
264
+ * settles, with or without `gracefulShutdown`. `runCommand` never aborts it.
262
265
  */
263
266
  type WithRunMeta<T> = T & {
264
267
  $source?: (name: string) => ArgSource;
265
268
  $invocation?: RunInvocation;
266
269
  $agent?: AgentInfo | undefined;
270
+ $signal?: AbortSignal;
267
271
  };
268
272
  /**
269
273
  * Resolve merged args from schema and global args type
@@ -334,6 +338,8 @@ interface CreateDefineCommandFn<TArgsBase extends ArgsSchema$1 = ArgsSchema$1> {
334
338
  */
335
339
  interface RunnableConfig<TArgsSchema extends ArgsSchema$1 | undefined, TResult, TGlobalArgs, TSubCommands extends SubCommandsRecord | undefined = undefined> extends DefineCommandConfig<TArgsSchema, TResult, TGlobalArgs, TSubCommands> {
336
340
  run: (args: ResolvedArgs<TArgsSchema, TGlobalArgs>) => TResult;
341
+ /** See `RunnableCommand.gracefulShutdown` */
342
+ gracefulShutdown?: boolean;
337
343
  /** Not settable alongside `run` (see `NonRunnableConfig.defaultSubCommand`) */
338
344
  defaultSubCommand?: undefined;
339
345
  }
@@ -342,6 +348,8 @@ interface RunnableConfig<TArgsSchema extends ArgsSchema$1 | undefined, TResult,
342
348
  */
343
349
  interface NonRunnableConfig<TArgsSchema extends ArgsSchema$1 | undefined, TGlobalArgs, TSubCommands extends SubCommandsRecord | undefined = undefined> extends Omit<DefineCommandConfig<TArgsSchema, void, TGlobalArgs, TSubCommands>, "run"> {
344
350
  run?: undefined;
351
+ /** Not settable without `run` (see `RunnableConfig.gracefulShutdown`) */
352
+ gracefulShutdown?: undefined;
345
353
  /**
346
354
  * Name of a `subCommands` entry to run when this command is invoked with
347
355
  * no subcommand specified, instead of showing help. Must be a key of
@@ -946,7 +954,7 @@ interface CommandValidationError {
946
954
  /** Path to the command (e.g., ["cli", "build", "watch"]) */
947
955
  commandPath: string[];
948
956
  /** Error type */
949
- type: "duplicate_field" | "duplicate_alias" | "invalid_alias" | "positional_config" | "reserved_alias" | "reserved_field_name" | "case_variant_collision" | "duplicate_negation" | "field_type_conflict" | "subcommand_key_name_mismatch" | "default_subcommand_conflict" | "default_subcommand_not_found";
957
+ type: "duplicate_field" | "duplicate_alias" | "invalid_alias" | "positional_config" | "reserved_alias" | "reserved_field_name" | "case_variant_collision" | "duplicate_negation" | "field_type_conflict" | "subcommand_key_name_mismatch" | "default_subcommand_conflict" | "default_subcommand_not_found" | "graceful_shutdown_without_run";
950
958
  /** Error message */
951
959
  message: string;
952
960
  /** Related field name (if applicable) */
package/dist/index.js CHANGED
@@ -1 +1 @@
1
- import{t as e}from"./register-BWzt6u5k.js";import{n as t,t as n}from"./cli-main-wqT-qsdF.js";import{i as r,n as i}from"./schema-extractor-Cwg_WAC-.js";import{t as a}from"./with-completion-command-BojrmP1a.js";import{n as o,t as s}from"./command-BXsTrIgI.js";import{d as c,o as l,s as u}from"./subcommand-router-CfCW9eG4.js";import{A as d,C as f,D as p,E as m,O as h,S as g,T as _,_ as v,a as y,b,c as x,d as S,f as C,g as w,h as T,i as E,k as D,l as O,m as ee,n as k,o as A,p as j,r as M,s as N,t as P,u as F,v as I,w as L,x as R,y as z}from"./runner-DiDJDnhR.js";import{a as B,i as V,n as H,r as U,t as W}from"./logger-CoeDrmRr.js";import{a as G}from"./argv-parser-bI3e6XXA.js";import{a as K,c as q,m as J,o as Y,p as X,t as Z}from"./unflatten-DVeO9OZ_.js";import{z as Q}from"zod";function $(e,t={}){let n=K(t);Z(Object.keys(e.shape),t);let r=e.transform((e,t)=>{let r=q(e,n);if(!r.issues)return r.value;for(let n of r.issues)t.issues.push({code:`custom`,input:e,message:n.message,path:n.path});return Q.NEVER});return Y(r,t)}const te=t(`@politty/zod`),ne=o,re=s,ie=e;export{I as CaseVariantCollisionError,z as DefaultSubCommandError,b as DuplicateAliasError,R as DuplicateFieldError,g as DuplicateNegationError,M as EnvFileNotFoundError,f as FieldTypeConflictError,L as PositionalConfigError,_ as ReservedAliasError,m as ReservedFieldNameError,ie as arg,t as createCompileCacheShimGenerator,re as createDefineCommand,y as createDualCaseProxy,ne as defineCommand,i as extractFields,N as formatCommandValidationErrors,A as formatValidationErrors,te as generateCompileCacheShim,p as generateHelp,h as generateHelpData,r as getUnknownKeysMode,W as isColorEnabled,l as isLazyCommand,u as lazy,E as loadEnvFiles,c as loadPackage,H as logger,G as parseArgv,D as renderInline,d as renderMarkdown,P as runCommand,k as runMain,n as runPolittyCli,U as setColorEnabled,V as styles,B as symbols,X as toCamelCase,J as toKebabCase,$ as unflatten,x as validateCaseVariantCollisions,O as validateCommand,F as validateCrossSchemaCollisions,S as validateDefaultSubCommand,C as validateDuplicateAliases,j as validateDuplicateFields,ee as validateDuplicateNegations,T as validatePositionalConfig,w as validateReservedAliases,v as validateReservedFieldNames,a as withCompletionCommand};
1
+ import{t as e}from"./register-BWzt6u5k.js";import{n as t,t as n}from"./cli-main-BOiqNyRU.js";import{i as r,n as i}from"./schema-extractor-Cwg_WAC-.js";import{t as a}from"./with-completion-command-gytc9LNl.js";import{n as o,t as s}from"./command-CCiN78NV.js";import{d as c,o as l,s as u}from"./subcommand-router-CfCW9eG4.js";import{A as d,C as f,D as p,E as m,O as h,S as g,T as _,_ as v,a as y,b,c as x,d as S,f as C,g as w,h as T,i as E,k as D,l as O,m as ee,n as k,o as A,p as j,r as M,s as N,t as P,u as F,v as I,w as L,x as R,y as z}from"./runner-C0PI1zBE.js";import{a as B,i as V,n as H,r as U,t as W}from"./logger-CoeDrmRr.js";import{a as G}from"./argv-parser-bI3e6XXA.js";import{a as K,c as q,m as J,o as Y,p as X,t as Z}from"./unflatten-DVeO9OZ_.js";import{z as Q}from"zod";function $(e,t={}){let n=K(t);Z(Object.keys(e.shape),t);let r=e.transform((e,t)=>{let r=q(e,n);if(!r.issues)return r.value;for(let n of r.issues)t.issues.push({code:`custom`,input:e,message:n.message,path:n.path});return Q.NEVER});return Y(r,t)}const te=t(`@politty/zod`),ne=o,re=s,ie=e;export{I as CaseVariantCollisionError,z as DefaultSubCommandError,b as DuplicateAliasError,R as DuplicateFieldError,g as DuplicateNegationError,M as EnvFileNotFoundError,f as FieldTypeConflictError,L as PositionalConfigError,_ as ReservedAliasError,m as ReservedFieldNameError,ie as arg,t as createCompileCacheShimGenerator,re as createDefineCommand,y as createDualCaseProxy,ne as defineCommand,i as extractFields,N as formatCommandValidationErrors,A as formatValidationErrors,te as generateCompileCacheShim,p as generateHelp,h as generateHelpData,r as getUnknownKeysMode,W as isColorEnabled,l as isLazyCommand,u as lazy,E as loadEnvFiles,c as loadPackage,H as logger,G as parseArgv,D as renderInline,d as renderMarkdown,P as runCommand,k as runMain,n as runPolittyCli,U as setColorEnabled,V as styles,B as symbols,X as toCamelCase,J as toKebabCase,$ as unflatten,x as validateCaseVariantCollisions,O as validateCommand,F as validateCrossSchemaCollisions,S as validateDefaultSubCommand,C as validateDuplicateAliases,j as validateDuplicateFields,ee as validateDuplicateNegations,T as validatePositionalConfig,w as validateReservedAliases,v as validateReservedFieldNames,a as withCompletionCommand};
@@ -1,4 +1,4 @@
1
- import { V as PromptResolver } from "./arg-registry-biPCZomY.js";
1
+ import { V as PromptResolver } from "./arg-registry-DNUJtjsZ.js";
2
2
  /**
3
3
  * Prompt resolver backed by @clack/prompts.
4
4
  *
@@ -1,4 +1,4 @@
1
- import { V as PromptResolver } from "./arg-registry-biPCZomY.js";
1
+ import { V as PromptResolver } from "./arg-registry-DNUJtjsZ.js";
2
2
  /**
3
3
  * Prompt resolver backed by @inquirer/prompts.
4
4
  *
package/dist/prompt.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { H as PromptResolverContext, nt as ExtractedFields, rt as ResolvedFieldMeta } from "./arg-registry-biPCZomY.js";
1
+ import { H as PromptResolverContext, nt as ExtractedFields, rt as ResolvedFieldMeta } from "./arg-registry-DNUJtjsZ.js";
2
2
  /**
3
3
  * Resolved prompt configuration for a single field
4
4
  */
@@ -0,0 +1,33 @@
1
+ import{d as e,h as t,i as n,m as r,n as i,p as a,u as o}from"./unflatten-DVeO9OZ_.js";import{t as s}from"./detect-agent-D7KSeWMh.js";import{n as c}from"./compile-cache-6u9hgeWu.js";import{a as l,c as u,f as d,i as f,l as p,n as m,o as h,r as g,t as _,u as v}from"./subcommand-router-CfCW9eG4.js";import{n as y,r as b,t as x}from"./log-collector-uhRWYT-z.js";import{a as S,c as C,l as w,m as T,n as E,o as D,p as O,r as k,s as A,t as j,u as ee}from"./schema-extractor-Cwg_WAC-.js";import{a as M,i as N}from"./logger-CoeDrmRr.js";import{a as P,c as te,d as ne,i as F,l as re,n as I,o as L,r as ie,s as R,t as z}from"./argv-parser-bI3e6XXA.js";import*as B from"node:fs";import*as ae from"node:path";import{isDeepStrictEqual as oe,parseEnv as se,stripVTControlCharacters as ce}from"node:util";async function le(e,t,n={}){let r,a,o=n.captureLogs??!1?x():null;o?.start();let s={args:t},c={args:t,error:r},l=new AbortController;typeof t==`object`&&t&&Object.defineProperty(t,"$signal",{value:l.signal,enumerable:!1});let u=!1,f,p;if(n.handleSignals){let t=async()=>{p&&(process.off(`SIGINT`,p),process.off(`SIGTERM`,p));let t=/* @__PURE__ */ Error(`Process interrupted`);if(c.error=t,e.cleanup)try{await e.cleanup(c)}catch(e){console.error(`Error during signal cleanup:`,e)}if(n.globalCleanup)try{await n.globalCleanup({error:t})}catch(e){console.error(`Error during global signal cleanup:`,e)}o?.stop(),process.stdout.writableNeedDrain&&await new Promise(e=>{let t=setTimeout(()=>{process.stdout.off(`drain`,n),e()},200),n=()=>{clearTimeout(t),e()};process.stdout.once(`drain`,n)}),process.exit(1)};p=n=>{let r=l.signal.aborted;return l.abort(),e.gracefulShutdown&&u&&!r?Promise.resolve():(f=t(),f)},process.on(`SIGINT`,p),process.on(`SIGTERM`,p)}try{e.requiredPackages?.length&&await d(e.requiredPackages,t);let r=typeof t==`object`&&t?t:{};for(let e of n.packageFields??[])e.requiredPackages?.length&&(e.nested?i(r,e)!==void 0:e.name in r)&&(n.packageDiscriminators?.includes(e.name)||i(r,e)===!0)&&await d(e.requiredPackages,t);e.setup&&!f&&await e.setup(s),e.run&&!f&&(u=!0,a=await e.run(t))}catch(e){r=e instanceof Error?e:Error(String(e))}finally{u=!1,p&&(process.off(`SIGINT`,p),process.off(`SIGTERM`,p))}if(f)await f,r=c.error;else if(e.cleanup){c.error=r;try{await e.cleanup(c)}catch(e){r||=e instanceof Error?e:Error(String(e))}}o?.stop();let m=n.existingLogs??y(),h=o?.getLogs()??y(),g=b(m,h);return r?{success:!1,error:r,exitCode:1,logs:g}:{success:!0,result:a,exitCode:0,logs:g}}function ue(e){return e<=31||e>=127&&e<=159||e>=768&&e<=879||e>=6832&&e<=6911||e>=7616&&e<=7679||e>=8400&&e<=8447||e>=65056&&e<=65071||e===8203||e>=8204&&e<=8207||e===65279||e>=65024&&e<=65039||e>=917760&&e<=917999}function de(e){return e>=4352&&e<=4447||e>=11904&&e<=12350||e>=12353&&e<=13311||e>=13312&&e<=19903||e>=19968&&e<=40959||e>=40960&&e<=42191||e>=43360&&e<=43391||e>=44032&&e<=55203||e>=63744&&e<=64255||e>=65040&&e<=65049||e>=65072&&e<=65135||e>=65280&&e<=65376||e>=65504&&e<=65510||e>=110592&&e<=110959||e>=127488&&e<=127569||e>=131072&&e<=262141||e>=9728&&e<=10175||e>=126976&&e<=129791}function fe(e){let t=!1,n=!1,r=!1;for(let i of e){let e=i.codePointAt(0);e===65039?r=!0:ue(e)||(t=!0,de(e)&&(n=!0))}return t?n||r?2:1:0}const pe=(()=>{try{return new Intl.Segmenter(`en`,{granularity:`grapheme`})}catch{return}})();function me(e){if(e.length===0)return 0;let t=e.includes(`\x1B`)||e.includes(`›`)?ce(e):e,n=0;if(pe)for(let{segment:e}of pe.segment(t))n+=fe(e);else for(let e of t)n+=fe(e);return n}function V(e){let t=[],n=e.replace(/`([^`]+)`/g,(e,n)=>{let r=t.length;return t.push(N.cyan(n)),`\x00CODE${r}\x00`});return n=n.replace(/\*\*(.+?)\*\*/g,(e,t)=>N.bold(t)),n=n.replace(/__(.+?)__/g,(e,t)=>N.bold(t)),n=n.replace(/\*(.+?)\*/g,(e,t)=>N.italic(t)),n=n.replace(/(?<!\w)_(.+?)_(?!\w)/g,(e,t)=>N.italic(t)),n=n.replace(/\[([^\]]+)\]\(([^)]+)\)/g,(e,t,n)=>`${N.underline(t)} ${N.dim(`(${n})`)}`),n=n.replace(/\x00CODE(\d+)\x00/g,(e,n)=>t[Number(n)]),n}function he(e){return Te(e.split(`
2
+ `)).map(Ae).join(`
3
+
4
+ `)}const ge=/^(#{1,6})\s+(.+)$/,_e=/^(?:---+|\*\*\*+|___+)\s*$/,ve=/^>\s?(.*)$/,ye=/^-\s+(.+)$/,be=/^(\d+)[.)]\s+(.+)$/,xe=/^(`{3,}|~{3,})(\S*)\s*$/,Se=/^\[!(NOTE|TIP|IMPORTANT|WARNING|CAUTION)\]\s*$/,Ce=/^\|(.+)\|$/,we=/^\|(\s*:?-+:?\s*\|)+$/;function Te(e){let t=[],n=0;for(;n<e.length;){let r=e[n];if(r.trim()===``){n++;continue}let i=r.match(xe);if(i){let r=i[1],a=i[2]??``,o=[];for(n++;n<e.length;){if(e[n].startsWith(r.charAt(0).repeat(r.length))&&e[n].trim()===r.charAt(0).repeat(Math.max(r.length,e[n].trim().length))){n++;break}o.push(e[n]),n++}t.push({type:`code`,lang:a,lines:o});continue}let a=r.match(ge);if(a){t.push({type:`heading`,level:a[1].length,content:a[2]}),n++;continue}if(_e.test(r)){t.push({type:`hr`}),n++;continue}if(ve.test(r)){let r=[];for(;n<e.length;){let t=e[n].match(ve);if(t)r.push(t[1]),n++;else break}if(r.length>0){let e=r[0].match(Se);if(e){let n=r.slice(1).filter(e=>e!==``);t.push({type:`alert`,alertType:e[1],lines:n});continue}}t.push({type:`blockquote`,lines:r});continue}if(ye.test(r)){let r=[];for(;n<e.length;){let t=e[n].match(ye);if(t)r.push(t[1]),n++;else break}t.push({type:`ul`,items:r});continue}let o=r.match(be);if(o){let r=Number(o[1]),i=[];for(;n<e.length;){let t=e[n].match(be);if(t)i.push(t[2]),n++;else break}t.push({type:`ol`,items:i,start:r});continue}if(Ce.test(r)&&n+1<e.length&&we.test(e[n+1])){let i=Ee(r),a=De(e[n+1]);n+=2;let o=[];for(;n<e.length&&Ce.test(e[n]);)o.push(Ee(e[n])),n++;t.push({type:`table`,headers:i,alignments:a,rows:o});continue}let s=[];for(;n<e.length;){let t=e[n];if(t.trim()===``||ge.test(t)||_e.test(t)||ve.test(t)||ye.test(t)||be.test(t)||xe.test(t)||Ce.test(t)&&n+1<e.length&&we.test(e[n+1]))break;s.push(t),n++}s.length>0&&t.push({type:`paragraph`,lines:s})}return t}function Ee(e){return e.slice(1,-1).split(`|`).map(e=>e.trim())}function De(e){return e.slice(1,-1).split(`|`).map(e=>{let t=e.trim();return t.startsWith(`:`)&&t.endsWith(`:`)?`center`:t.endsWith(`:`)?`right`:`left`})}function Oe(e,t,n){let r=me(e),i=Math.max(0,t-r);if(n===`right`)return` `.repeat(i)+e;if(n===`center`){let t=Math.floor(i/2);return` `.repeat(t)+e+` `.repeat(i-t)}return e+` `.repeat(i)}const ke={NOTE:{icon:`ℹ`,label:`Note`,styleFn:N.cyan},TIP:{icon:`💡`,label:`Tip`,styleFn:N.green},IMPORTANT:{icon:`❗`,label:`Important`,styleFn:N.magenta},WARNING:{icon:`⚠`,label:`Warning`,styleFn:N.yellow},CAUTION:{icon:`🔴`,label:`Caution`,styleFn:N.red}};function Ae(e){switch(e.type){case`heading`:return N.green(N.bold(V(e.content)));case`hr`:return N.dim(`─`.repeat(40));case`blockquote`:{let t=N.dim(`│ `);return e.lines.map(e=>`${t}${V(e)}`).join(`
5
+ `)}case`alert`:{let{icon:t,label:n,styleFn:r}=ke[e.alertType],i=r(N.bold(`│`))+` `,a=`${i}${r(t)} ${r(n)}`;return e.lines.length===0?a:`${a}\n${e.lines.map(e=>`${i}${V(e)}`).join(`
6
+ `)}`}case`ul`:return e.items.map(e=>`${N.dim(`•`)} ${V(e)}`).join(`
7
+ `);case`ol`:{let t=e.start+e.items.length-1,n=String(t).length;return e.items.map((t,r)=>{let i=String(e.start+r).padStart(n,` `);return`${N.dim(`${i}.`)} ${V(t)}`}).join(`
8
+ `)}case`table`:{let t=e.headers.length,n=e.headers.map(e=>V(e)),r=e.rows.map(e=>Array.from({length:t},(t,n)=>V(e[n]??``))),i=n.map((e,t)=>{let n=me(e),i=r.map(e=>me(e[t]));return Math.max(n,...i)}),a=N.dim(`│`),o=N.dim(`┌─${i.map(e=>`─`.repeat(e)).join(`─┬─`)}─┐`),s=N.dim(`├─${i.map(e=>`─`.repeat(e)).join(`─┼─`)}─┤`),c=N.dim(`└─${i.map(e=>`─`.repeat(e)).join(`─┴─`)}─┘`);return[o,`${a} ${n.map((t,n)=>N.bold(Oe(t,i[n],e.alignments[n]??`left`))).join(` ${a} `)} ${a}`,s,...r.map(t=>{let n=t.map((t,n)=>Oe(t,i[n],e.alignments[n]??`left`));return`${a} ${n.join(` ${a} `)} ${a}`}),c].join(`
9
+ `)}case`code`:return e.lines.map(e=>` ${N.yellow(e)}`).join(`
10
+ `);case`paragraph`:return V(e.lines.join(` `))}}const H={help:`Show help`,helpAll:`Show help with all subcommand options`,helpJson:`Show help as JSON`,version:`Show version`};function je(e){return!e.startsWith(`__`)}function U(e){return Object.entries(e).filter(([e])=>je(e))}function Me(e,t){return t?.rootName&&t.commandPath&&t.commandPath.length>0?t.commandPath.join(` `):e.name??`command`}function Ne(e,t){return t?.rootName&&t.commandPath&&t.commandPath.length>0?`${t.rootName} ${t.commandPath.join(` `)}`:e.name??`command`}function Pe(e,t){let n=[],r=Ne(e,t);n.push(N.commandName(r)),t?.globalExtracted?.fields.length&&n.push(N.placeholder(`[global options]`));let i=k(e);if(i){let t=C(i);A(i).length>0&&n.push(N.placeholder(`[options]`)),e.subCommands&&U(e.subCommands).length>0&&(e.run||e.defaultSubCommand?n.push(N.placeholder(`[command]`)):n.push(N.option(`<command>`)));for(let e of t)e.required?n.push(N.option(`<${e.name}>`)):n.push(N.placeholder(`[${e.name}]`))}else e.subCommands&&U(e.subCommands).length>0&&(e.run||e.defaultSubCommand?n.push(N.placeholder(`[command]`)):n.push(N.option(`<command>`)));return n.join(` `)}function Fe(e,t){let n=`${N.dim(`When`)} ${N.option(e)}=${N.bold(t.discriminatorValue)}:`;return t.description?`${n} ${t.description}`:n}function Ie(e,t){return` ${N.bold(`${e.description??`Variant ${t+1}`}:`)}`}function Le(e,t=0){let n=e.required?N.option(`<${e.name}>`):N.placeholder(`[${e.name}]`),r=e.named?`${n}, ${G(e)}`:n,i=[J(e),e.defaultValue===void 0?void 0:N.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)].filter(Boolean).join(` `);return i?q(r,i,t):`${` `.repeat(t)} ${r}`}function Re(e){let t=k(e);if(!t)return``;let n=[];if(t.schemaType===`discriminatedUnion`&&t.discriminator){let e=t.discriminator;n=(t.variants??[]).map(t=>({label:Fe(e,t),fields:t.fields}))}else(t.schemaType===`union`||t.schemaType===`xor`)&&t.unionOptions&&(n=t.unionOptions.map((e,t)=>({label:Ie(e,t),fields:e.fields})));let r=n.length>0?j(n):void 0,i=t.fields.filter(e=>e.positional&&(r===void 0||r.has(e.name))).map(e=>Le(e));for(let e of n){let t=e.fields.filter(e=>e.positional&&!r?.has(e.name));t.length!==0&&i.push(``,e.label,...t.map(e=>Le(e,1)))}return i.join(`
11
+ `)}function ze(t,n={},r){let i=[],a={help:n.help??H.help,helpAll:n.helpAll??H.helpAll,helpJson:n.helpJson??H.helpJson,version:n.version??H.version},o=k(t),s=o?.fields.some(t=>t.overrideBuiltinAlias===!0&&e(t).includes(`h`))??!1,c=o?.fields.some(t=>t.overrideBuiltinAlias===!0&&e(t).includes(`H`))??!1;if(s?i.push(q(N.option(`--help`),a.help)):i.push(q(`${N.option(`-h`)}, ${N.option(`--help`)}`,a.help)),c?i.push(q(N.option(`--help-all`),a.helpAll)):i.push(q(`${N.option(`-H`)}, ${N.option(`--help-all`)}`,a.helpAll)),i.push(q(N.option(`--help-json`),a.helpJson)),r?.rootVersion&&i.push(q(N.option(`--version`),a.version)),!o)return i.join(`
12
+ `);if(o.schemaType===`discriminatedUnion`&&o.discriminator)return Be(o,t,i);if(o.schemaType===`union`&&o.unionOptions||o.schemaType===`xor`&&o.unionOptions)return Ve(o,t,i);let l=[],u=o.fields.filter(e=>!e.positional);for(let e of u){let t=G(e),n=J(e);e.defaultValue!==void 0&&(n+=` ${N.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)}`),e.required&&(n+=` ${N.required(`(required)`)}`);let r=K(e.env);r&&(n+=` ${r}`),l.push(q(t,n));let i=W(e);i&&l.push(i)}return l.push(...i),l.join(`
13
+ `)}function W(e,t=0,n=0){return!e.negationDisplay||!e.negationDescription?null:q(N.option(`--${e.negationDisplay}`),`${e.negationDescription} ${N.dim(`(↔ --${e.cliName})`)}`,t,n)}function Be(e,t,n){let r=[],i=e.discriminator,a=e.variants??[],o=D(e,i);if(o){let t=a.map(e=>e.discriminatorValue).join(`|`),n=`${N.option(`--${i}`)} ${N.placeholder(`<${t}>`)}`,s=e.description??o.description??`Action to perform`;r.push(q(n,s))}let s=j(a,i);for(let t of s){let n=e.fields.find(e=>e.name===t);if(n&&!n.positional){let e=G(n),t=J(n);n.defaultValue!==void 0&&(t+=` ${N.defaultValue(`(default: ${JSON.stringify(n.defaultValue)})`)}`);let i=K(n.env);i&&(t+=` ${i}`),r.push(q(e,t));let a=W(n);a&&r.push(a)}}r.push(...n);for(let e of a){let t=e.fields.filter(e=>e.name!==i&&!s.has(e.name)&&!e.positional),n=p(e.fields.find(e=>e.name===i)?.requiredPackages);if(t.length>0||n){r.push(``),r.push(Fe(i,e)),n&&r.push(We(n,2));for(let e of t){let t=G(e),n=J(e);e.defaultValue!==void 0&&(n+=` ${N.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)}`),e.required&&(n+=` ${N.required(`(required)`)}`);let i=K(e.env);i&&(n+=` ${i}`),r.push(q(t,n,1));let a=W(e,1);a&&r.push(a)}}}return r.join(`
14
+ `)}function Ve(e,t,n){let r=[],i=e.unionOptions??[],a=j(i);for(let t of a){let n=e.fields.find(e=>e.name===t);if(n&&!n.positional){let e=G(n),t=J(n);n.defaultValue!==void 0&&(t+=` ${N.defaultValue(`(default: ${JSON.stringify(n.defaultValue)})`)}`);let i=K(n.env);i&&(t+=` ${i}`),r.push(q(e,t));let a=W(n);a&&r.push(a)}}r.push(...n);for(let e=0;e<i.length;e++){let t=i[e];if(!t)continue;let n=t.fields.filter(e=>!a.has(e.name)&&!e.positional),o=Ie(t,e);if(n.length>0){r.push(``),r.push(o);for(let e of n){let t=G(e),n=J(e);e.defaultValue!==void 0&&(n+=` ${N.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)}`),e.required&&(n+=` ${N.required(`(required)`)}`);let i=K(e.env);i&&(n+=` ${i}`),r.push(q(t,n,1));let a=W(e,1);a&&r.push(a)}}else r.push(``),r.push(o),r.push(` ${N.dim(N.italic(`no options`))}`)}return r.join(`
15
+ `)}function G(e){let t=[];if(e.alias)for(let n of e.alias)n.length===1&&t.push(N.option(`-${n}`));let n=N.option(`--${e.cliName}`);if(e.type!==`boolean`){let t=e.placeholder??e.cliName.toUpperCase();n+=` ${N.placeholder(`<${t}>`)}`}if(t.push(n),e.alias){for(let n of e.alias)if(n.length>1){let r=N.option(`--${n}`);if(e.type!==`boolean`){let t=e.placeholder??e.cliName.toUpperCase();r+=` ${N.placeholder(`<${t}>`)}`}t.push(r)}}let r=t.join(`, `);return e.type===`boolean`&&e.negationDisplay&&!e.negationDescription?`${r} / ${N.option(`--${e.negationDisplay}`)}`:r}function K(e){if(!e)return``;let t=Array.isArray(e)?e:[e];return N.dim(`[env: ${t.join(`, `)}]`)}function He(e){return e.replace(/\x1B\[[0-9;]*m/g,``)}function Ue(e,t){let n=He(e).length,r=Math.max(0,t-n);return e+` `.repeat(r)}function We(e,t){if(!e.includes(`
16
+ `))return e;let n=` `.repeat(t);return e.split(`
17
+ `).join(`\n${n}`)}function q(e,t,n=0,r=0){let i=` `.repeat(n),a=He(e).length,o=32-n*2+r,s=o+2+n*2,c=We(t,s);return a>=o?`${i} ${e}\n${` `.repeat(s)}${c}`:`${i} ${Ue(e,o)}${c}`}function Ge(e,t=0,n=0){let r=G(e),i=J(e);e.defaultValue!==void 0&&(i+=` ${N.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)}`),e.required&&(i+=` ${N.required(`(required)`)}`);let a=K(e.env);return a&&(i+=` ${a}`),q(r,i,t,n)}function Ke(e){let t=[];for(let n of e.fields){if(n.positional)continue;t.push(Ge(n));let e=W(n);e&&t.push(e)}return t.join(`
18
+ `)}function qe(e,t){let n=[],r=k(e);if(r){let e=r.fields.filter(e=>!e.positional);for(let r of e){let e=G(r),i=J(r);r.defaultValue!==void 0&&(i+=` ${N.defaultValue(`(default: ${JSON.stringify(r.defaultValue)})`)}`);let a=K(r.env);a&&(i+=` ${a}`),n.push(q(e,i,t,2));let o=W(r,t,2);o&&n.push(o)}}return n}function Je(e,t,n){let r=[];for(let[i,a]of U(e)){let e=u(a),o=t?`${t} ${i}`:i,s=[e?.description,p(e?.requiredPackages)].filter(Boolean).join(`
19
+ `),c=e?.aliases,l=c&&c.length>0?`${o}, ${c.join(`, `)}`:o;if(r.push(q(N.command(l),s,n)),e){let t=qe(e,n+1);r.push(...t);let i=e.subCommands?Object.fromEntries(U(e.subCommands)):void 0;if(i&&Object.keys(i).length>0){let e=Je(i,o,n);r.push(...e)}}}return r}function Ye(e,t){let n=[],r=t.context;t.agentHelp&&n.push(he(t.agentHelp));let i=Me(e,r);if(i){let e=N.commandName(i);r?.rootName&&r.commandPath&&r.commandPath.length>0?r.rootVersion?e+=` ${N.version(`(${r.rootName} v${r.rootVersion})`)}`:e+=` ${N.version(`(${r.rootName})`)}`:r?.rootVersion&&(e+=` ${N.version(`v${r.rootVersion}`)}`),n.push(e)}r?.aliasFor&&n.push(N.dim(`Alias for ${N.commandName(r.aliasFor)}`)),e.description&&n.push(e.description),!r?.aliasFor&&e.aliases&&e.aliases.length>0&&n.push(`${N.sectionHeader(`Aliases:`)} ${e.aliases.map(e=>N.command(e)).join(`, `)}`),n.push(`${N.sectionHeader(`Usage:`)} ${Pe(e,r)}`);let a=Re(e);a&&n.push(`${N.sectionHeader(`Arguments:`)}\n${a}`);let o=ze(e,t.descriptions,r);if(o&&n.push(`${N.sectionHeader(`Options:`)}\n${o}`),r?.globalExtracted?.fields.length&&n.push(`${N.sectionHeader(`Global Options:`)}\n${Ke(r.globalExtracted)}`),t.showSubcommands!==!1&&e.subCommands&&U(e.subCommands).length>0){let i=r?.commandPath?.join(` `)??``,a=Object.fromEntries(U(e.subCommands));if(t.showSubcommandOptions){let e=Je(a,i,0);n.push(`${N.sectionHeader(`Commands:`)}\n${e.join(`
20
+ `)}`)}else{let e=[];for(let[t,n]of Object.entries(a)){let r=u(n),a=[r?.description,p(r?.requiredPackages)].filter(Boolean).join(`
21
+ `),o=i?`${i} ${t}`:t,s=r?.aliases,c=s&&s.length>0?`${o}, ${s.join(`, `)}`:o;e.push(q(N.command(c),a))}n.push(`${N.sectionHeader(`Commands:`)}\n${e.join(`
22
+ `)}`)}}if(e.examples&&e.examples.length>0){let t=Qe(e.examples,r);n.push(`${N.sectionHeader(`Examples:`)}\n${t}`)}let s=p(e.requiredPackages);if(s&&n.push(`${N.sectionHeader(`Required packages:`)}\n${s}`),e.notes){let t=he(e.notes).split(`
23
+ `).map(e=>e===``?``:` ${e}`).join(`
24
+ `);n.push(`${N.sectionHeader(`Notes:`)}\n${t}`)}return`\n${n.join(`
25
+
26
+ `)}\n`}function J(e){return[e.description,p(e.requiredPackages)].filter(Boolean).join(`
27
+ `)}function Y(e){let t={name:e.name,cliName:e.cliName,positional:e.positional,named:e.named,required:e.required,type:e.type};return e.requiredPackages?.length&&(t.requiredPackages=e.requiredPackages.map(e=>({name:e.name,install:v(e)}))),e.alias&&(t.alias=e.alias),e.description!==void 0&&(t.description=e.description),e.placeholder!==void 0&&(t.placeholder=e.placeholder),e.env!==void 0&&(t.env=e.env),e.defaultValue!==void 0&&(t.defaultValue=e.defaultValue),e.enumValues!==void 0&&(t.enumValues=e.enumValues),e.negation!==void 0&&(t.negation=e.negation),e.negationDisplay!==void 0&&(t.negationDisplay=e.negationDisplay),e.negationDescription!==void 0&&(t.negationDescription=e.negationDescription),t}function Xe(e,t){let n=Ne(e,t),r=!!t?.globalExtracted?.fields.length,i=e.subCommands&&U(e.subCommands).length>0?e.run?`optional`:`required`:void 0,a=k(e);return{commandName:n,hasGlobalOptions:r,hasOptions:a?A(a).length>0:!1,subcommand:i,positionals:a?C(a).map(e=>({name:e.name,required:e.required})):[]}}function Ze(e,t={}){let n=t.context,r=n?.commandPath??[],i={help:t.descriptions?.help??H.help,helpAll:t.descriptions?.helpAll??H.helpAll,helpJson:t.descriptions?.helpJson??H.helpJson,...n?.rootVersion?{version:t.descriptions?.version??H.version}:{}},a=k(e),o,s=[],c=[],l,d,f;if(a){if(o=a.schemaType,s=C(a).map(Y),a.schemaType===`discriminatedUnion`&&a.discriminator&&a.variants){let e=a.discriminator;l=e;let t=a.variants,n=j(t,e),r=D(a,e),i=a.fields.filter(e=>!e.positional&&n.has(e.name));c=[...r?[{...Y({...r,requiredPackages:void 0}),description:a.description??r.description??`Action to perform`}]:[],...i.map(Y)],d=t.map(t=>{let r=t.fields.find(t=>t.name===e);return{discriminatorValue:t.discriminatorValue,...r?.requiredPackages?.length?{requiredPackages:Y(r).requiredPackages}:{},description:t.description,fields:t.fields.filter(t=>t.name!==e&&!n.has(t.name)).map(Y)}})}else if((a.schemaType===`union`||a.schemaType===`xor`)&&a.unionOptions){let e=a.unionOptions,t=j(e);c=a.fields.filter(e=>!e.positional&&t.has(e.name)).map(Y),f=e.map(e=>({description:e.description,fields:e.fields.filter(e=>!t.has(e.name)).map(Y)}))}else c=a.fields.filter(e=>!e.positional).map(Y)}let p=n?.globalExtracted?.fields.length?n.globalExtracted.fields.filter(e=>!e.positional).map(Y):void 0,m;if(e.subCommands){let i=U(e.subCommands);i.length>0&&(m=i.map(([i,a])=>{let o=u(a);if(!o)return{name:i,unresolved:!0};let s={commandPath:[...r,i],rootName:n?.rootName??e.name,rootVersion:n?.rootVersion,globalExtracted:n?.globalExtracted};return{name:i,aliases:o.aliases,data:Ze(o,{descriptions:t.descriptions,context:s})}}))}return{name:e.name??`command`,commandPath:r,rootName:n?.rootName,version:n?.rootVersion,aliasFor:n?.aliasFor,description:e.description,aliases:e.aliases,usage:Xe(e,n),builtinOptions:i,schemaType:o,positionals:s,options:c,discriminator:l,variants:d,unionOptions:f,globalOptions:p,subcommands:m,examples:e.examples,notes:e.notes,...e.requiredPackages?.length?{requiredPackages:e.requiredPackages.map(e=>({name:e.name,install:v(e),description:e.description}))}:{},agentHelp:t.agentHelp}}function Qe(e,t){let n=[],r=t?.rootName?`${t.rootName} `:``,i=t?.commandPath?.join(` `)??``,a=i?`${r}${i} `:r;for(let t of e){if(n.push(` ${N.dim(t.desc).split(`
28
+ `).join(`
29
+ `)}`),n.push(` ${N.dim(`$`)} ${a}${t.cmd}`),t.output)for(let e of t.output.split(`
30
+ `))n.push(` ${e}`);n.push(``)}return n.length>0&&n[n.length-1]===``&&n.pop(),n.join(`
31
+ `)}var $e=class extends Error{constructor(e){super(e),this.name=`PositionalConfigError`}},et=class extends Error{constructor(e){super(e),this.name=`ReservedAliasError`}},tt=class extends Error{constructor(e){super(e),this.name=`DuplicateFieldError`}},nt=class extends Error{constructor(e){super(e),this.name=`DuplicateAliasError`}},rt=class extends Error{constructor(e){super(e),this.name=`CaseVariantCollisionError`}},it=class extends Error{constructor(e){super(e),this.name=`DuplicateNegationError`}},at=class extends Error{constructor(e){super(e),this.name=`ReservedFieldNameError`}},ot=class extends Error{constructor(e){super(e),this.name=`DefaultSubCommandError`}},st=class extends Error{constructor(e){super(e),this.name=`FieldTypeConflictError`}};function ct(e,t){let n=[],r=/* @__PURE__ */ new Map;for(let i of e.fields)r.has(i.name)&&n.push({commandPath:t,type:`duplicate_field`,message:`Duplicate field name "${i.name}" detected.`,field:i.name}),r.set(i.name,i.name);return n}function lt(e,t){let n=[],r=/* @__PURE__ */ new Map;for(let i of e.fields){let e=a(i.name),o=r.get(e);o&&o!==i.name&&n.push({commandPath:t,type:`case_variant_collision`,message:`Fields "${o}" and "${i.name}" are case variants of each other and would collide.`,field:i.name}),r.set(e,i.name)}return n}function ut(t,n){let r=[],i=/* @__PURE__ */ new Map,o=new Set(t.fields.map(e=>e.name)),s=new Set(t.fields.map(e=>e.cliName)),c=(e,t,a)=>{(o.has(e)||s.has(e))&&r.push({commandPath:n,type:`duplicate_alias`,message:`Alias "${e}" for field "${t}" conflicts with existing field name or CLI name "${e}".`,field:t});let c=i.get(e);if(c&&c!==t){let i=a?` (derived camelCase variant)`:``;r.push({commandPath:n,type:`duplicate_alias`,message:`Duplicate alias "${e}"${i} detected. Both "${c}" and "${t}" use the same alias.`,field:t})}i.set(e,t)};for(let n of t.fields){let t=e(n);if(t.length!==0){for(let e of t)if(c(e,n.name,!1),e.length>1&&e.includes(`-`)){let t=a(e);t!==e&&!o.has(t)&&c(t,n.name,!0)}}}return r}function dt(t,n){let r=[],i=/* @__PURE__ */ new Map,o=(e,t,n)=>{i.has(e)||i.set(e,{field:t,kind:n})};for(let n of t.fields){if(o(n.name,n.name,`field name`),n.name.includes(`-`)){let e=a(n.name);e!==n.name&&o(e,n.name,`field name`)}if(n.cliName!==n.name&&o(n.cliName,n.name,`CLI name`),n.cliName.includes(`-`)){let e=a(n.cliName);e!==n.cliName&&o(e,n.name,`CLI name`)}for(let t of e(n))if(o(t,n.name,`alias`),t.length>1&&t.includes(`-`)){let e=a(t);e!==t&&o(e,n.name,`alias`)}if(n.type===`boolean`&&n.negation===!0){let e=`no-${n.cliName}`;o(e,n.name,`default negation`);let t=a(n.cliName),r=`no${t[0]?.toUpperCase()??``}${t.slice(1)}`;r!==e&&o(r,n.name,`default negation`)}}let s=/* @__PURE__ */ new Map,c=(e,t,a)=>{let o=i.get(e);if(o){let i=a?` (derived camelCase variant)`:``,s=o.field===t?`the same field's own ${o.kind} "${e}"`:`${o.kind} "${e}" of field "${o.field}"`;r.push({commandPath:n,type:`duplicate_negation`,message:`Negation "${e}"${i} for field "${t}" conflicts with ${s}.`,field:t})}let c=s.get(e);if(c&&c!==t){let i=a?` (derived camelCase variant)`:``;r.push({commandPath:n,type:`duplicate_negation`,message:`Duplicate negation "${e}"${i} detected. Both "${c}" and "${t}" use the same negation name.`,field:t})}s.set(e,t)};for(let e of t.fields)if(typeof e.negation==`string`&&(c(e.negation,e.name,!1),e.negation.includes(`-`))){let t=a(e.negation);t!==e.negation&&c(t,e.name,!0)}return r}function ft(e,t){let n=[e,...e.variants??[],...e.unionOptions??[]],r=/* @__PURE__ */ new Set;return n.flatMap(e=>pt(e.fields,t)).filter(e=>!r.has(e.message)&&r.add(e.message))}function pt(e,t){let n=[],r=e.filter(e=>e.positional),i=null,a=null;for(let e of r)i!==null&&n.push({commandPath:t,type:`positional_config`,message:`Positional argument "${e.name}" cannot follow array positional argument "${i}".`,field:e.name}),e.type===`array`&&a!==null&&n.push({commandPath:t,type:`positional_config`,message:`Array positional "${e.name}" cannot be used with optional positional "${a}" (ambiguous parsing).`,field:e.name}),a!==null&&e.required&&n.push({commandPath:t,type:`positional_config`,message:`Required positional "${e.name}" cannot follow optional positional "${a}".`,field:e.name}),e.type===`array`&&(i=e.name),e.required||(a=e.name);return n}function mt(t,n){let r=[];for(let i of t.fields){if(i.overrideBuiltinAlias!==!0)for(let t of e(i))(t===`h`||t===`H`)&&r.push({commandPath:n,type:`reserved_alias`,message:`Alias "${t}" is reserved for --${t===`h`?`help`:`help-all`}. To override this, set { overrideBuiltinAlias: true } for "${i.name}" and keep the alias where it is currently defined (in alias or hiddenAlias).`,field:i.name});let t=/* @__PURE__ */ new Set([i.cliName,...e(i)]);for(let e of t){if(!o.has(e))continue;let t=e===i.cliName;r.push({commandPath:n,type:`reserved_alias`,message:`${t?`Field "${i.name}"`:`Alias "${e}" for field "${i.name}"`} collides with the built-in --${e} option, which always takes precedence. Rename the field or its alias; this collision cannot be overridden.`,field:i.name})}}return r}function ht(e,t){let n=[];for(let r of e.fields)r.name.startsWith(`$`)&&n.push({commandPath:t,type:`reserved_field_name`,message:`Field "${r.name}" starts with "$", which is reserved for framework-injected helpers (e.g. $source).`,field:r.name});return n}function gt(e){let t=ct(e,[]);if(t.length>0)throw new tt(`Duplicate field name "${t[0]?.field??`unknown`}" detected. Each field must have a unique name.`)}function _t(e){let t=ut(e,[]);if(t.length>0){let e=t[0];throw new nt(e.message)}}function vt(e){let t=ft(e,[]);if(t.length>0){let e=t[0];throw new $e(e.message)}}function yt(e,t){let n=mt(e,[]);if(n.length>0)throw new et(n[0].message)}function bt(e){let t=ht(e,[]);if(t.length>0){let e=t[0];throw new at(e.message)}}function xt(e){let t=dt(e,[]);if(t.length>0){let e=t[0];throw new it(e.message)}}function St(e){let t=lt(e,[]);if(t.length>0){let e=t[0];throw new rt(e.message)}}function Ct(e,t,n){let r=[],i=/* @__PURE__ */ new Map;for(let t of e.fields)i.set(a(t.name),t);for(let e of t.fields){let t=a(e.name),o=i.get(t);o&&(o.name===e.name?r.push({commandPath:n,type:`field_type_conflict`,message:`Global field "${o.name}" and command field "${e.name}" share the same name. A field name can only be declared in one schema, even when the definitions are identical.`,field:e.name}):r.push({commandPath:n,type:`case_variant_collision`,message:`Global field "${o.name}" and command field "${e.name}" are case variants of each other and would collide.`,field:e.name}))}return r.push(...wt(e,t,n)),r}function wt(e,t,n){let i=e=>e.fields.map(e=>({field:e,path:e.nested?.path??[e.name]})),a=i(e),o=i(t);if(![...a,...o].some(({field:e})=>e.nested))return[];let s=[];for(let e of a)for(let t of o){if(!e.field.nested&&!t.field.nested)continue;let i=Math.min(e.path.length,t.path.length),a=e.path.length!==t.path.length&&e.path.slice(0,i).every((e,n)=>e===t.path[n])?`one is a value where the other nests a group`:e.path[0]!==t.path[0]&&r(e.path[0])===r(t.path[0])?`their group names are spellings of the same name`:void 0;a&&s.push({commandPath:n,type:`field_type_conflict`,message:`Global field "${e.field.name}" and command field "${t.field.name}" nest into conflicting output positions: ${a}.`,field:t.field.name})}return s}function Tt(e,t){let n=Ct(e,t,[])[0];if(n)throw n.type===`case_variant_collision`?new rt(n.message):new st(n.message)}function Et(e,t,n){return[...ct(e,n),...lt(e,n),...ut(e,n),...dt(e,n),...ft(e,n),...mt(e,n),...ht(e,n)]}function Dt(e,t){let n=e,r=[];if(n.defaultSubCommand===void 0)return r;n.run&&r.push({commandPath:t,type:`default_subcommand_conflict`,message:`Command "${n.name}" defines both "run" and "defaultSubCommand". Define only one.`});let i=e.subCommands?Object.keys(e.subCommands):[];return i.includes(n.defaultSubCommand)||r.push({commandPath:t,type:`default_subcommand_not_found`,message:`defaultSubCommand "${n.defaultSubCommand}" does not match any subCommands key of "${n.name}". Registered: ${i.length>0?i.join(`, `):`(none)`}.`,field:n.defaultSubCommand}),r}function Ot(e,t){let n=e;return!n.gracefulShutdown||n.run?[]:[{commandPath:t,type:`graceful_shutdown_without_run`,message:`Command "${n.name}" sets "gracefulShutdown" without "run". Set it on the command that runs.`}]}function kt(e){let t=Dt(e,[]);if(t.length>0)throw new ot(t[0].message)}function At(e,t){let n=[];if(!e.subCommands)return n;let r=/* @__PURE__ */ new Map;for(let[t]of Object.entries(e.subCommands))r.set(t,t);for(let[i,a]of Object.entries(e.subCommands)){let e=h(a)?a.meta:typeof a==`function`?null:a;if(!e?.aliases)continue;let o=[...t,i];for(let t of e.aliases){if(!/^[a-zA-Z0-9][a-zA-Z0-9_-]*$/.test(t)){n.push({commandPath:o,type:`invalid_alias`,message:`Alias "${t}" is invalid. Aliases must start with an alphanumeric character and contain only alphanumeric characters, hyphens, or underscores.`,field:i});continue}if(t===i){n.push({commandPath:o,type:`duplicate_alias`,message:`Alias "${t}" conflicts with its own name.`,field:i});continue}let e=r.get(t);e?e===i?n.push({commandPath:o,type:`duplicate_alias`,message:`Alias "${t}" is duplicated within the alias list.`,field:i}):n.push({commandPath:o,type:`duplicate_alias`,message:`Alias "${t}" conflicts with existing subcommand or alias "${e}".`,field:i}):r.set(t,i)}}return n}function jt(e,t,n){return e===t?[]:[{commandPath:[...n,e],type:`subcommand_key_name_mismatch`,message:`Subcommand registered as "${e}" but its own name is "${t}".`,field:e}]}async function Mt(e,t={}){return Nt(e,t,!1)}async function Nt(e,t,n){n||=!!e.requiredPackages?.length;let r=t.commandPath??[e.name],i=[],a=e.subCommands?Object.keys(e.subCommands).length>0:!1,o=t.globalArgs?E(t.globalArgs):void 0;if(e.args){let t=E(e.args);i.push(...Et(t,a,r)),o&&i.push(...Ct(o,t,r))}if(i.push(...At(e,r)),i.push(...Dt(e,r)),i.push(...Ot(e,r)),e.subCommands)for(let[a,o]of Object.entries(e.subCommands)){let e=await g(o,e=>n||!!e.requiredPackages?.length);i.push(...jt(a,e.name,r));let s=await Nt(e,{commandPath:[...r,a],...t.globalArgs?{globalArgs:t.globalArgs}:{}},n);s.valid||i.push(...s.errors)}return i.length===0?{valid:!0}:{valid:!1,errors:i}}function Pt(e){if(e.length===0)return``;let t=[`Command definition errors:`];for(let n of e){let e=n.commandPath.join(` > `);t.push(` - [${e}] ${n.message}`)}return t.join(`
32
+ `)}function Ft(t){let{aliasMap:n=/* @__PURE__ */ new Map,booleanFlags:r=/* @__PURE__ */ new Set,definedNames:i=/* @__PURE__ */ new Set,negationMap:a=/* @__PURE__ */ new Map,defaultNegationDisabledFields:o=/* @__PURE__ */ new Set}=z(t),s=/* @__PURE__ */ new Set;for(let n of t.fields)for(let t of e(n))t.length===1&&s.add(t);return{aliasMap:n,booleanFlags:r,definedNames:i,flagNames:new Set(t.fields.map(e=>e.name)),cliNames:new Set(t.fields.map(e=>e.cliName)),aliases:s,negationMap:a,defaultNegationDisabledFields:o}}function It(e,t){let{resolvedName:n,withoutDashes:r,isNegated:i,isCustomNegation:a,isSuppressedNegation:o}=re(e,t);if(o)return{resolvedName:n,withoutDashes:r,isNegated:!1,isGlobal:!1,isSuppressedNegation:o};let s=i&&!a?r.startsWith(`no-`)?r.slice(3):r[2].toLowerCase()+r.slice(3):r;return{resolvedName:n,withoutDashes:r,isNegated:i,isGlobal:t.flagNames.has(n)||t.cliNames.has(r)||t.cliNames.has(s),isSuppressedNegation:!1}}function X(e,t,n,r,i){return!e.includes(`=`)&&!i.has(t)&&!n&&r!==void 0&&I(r)}function Lt(e,t,n,r,i,a){let o=e[t];return a.push(o),X(o,n,r,e[t+1],i)?(a.push(e[t+1]),2):1}function Rt(e,t,n,r=()=>!1){let i=e[t];if(!ie(i))return 0;let a=e=>n.aliasMap.get(e)??e,o=e=>!r(e)&&(n.aliases.has(e)||n.flagNames.has(a(e))),{flags:s,valueOption:c}=R(i.slice(1),e=>o(e)&&!n.booleanFlags.has(a(e)));return s.every(o)?c&&c.value===void 0&&X(i,a(c.name),!1,e[t+1],n.booleanFlags)?2:1:0}function zt(e,t,n){let r=Ft(n),i=new Set(t),a=[],o=[],s=0;for(;s<e.length;){let t=e[s];if(t===`--`||Bt.has(t))break;if(!t.startsWith(`-`)&&i.has(t))return{subCommandIndex:s,globalTokensBefore:a,tokensAfterSubcommand:e.slice(s+1),suppressedTokens:o};if(t.startsWith(`--`)){let{resolvedName:n,withoutDashes:i,isNegated:c,isGlobal:l,isSuppressedNegation:u}=It(t,r);if(l){s+=Lt(e,s,n,c,r.booleanFlags,a);continue}if(u){o.push(i),s++;continue}break}if(t.startsWith(`-`)&&t.length>1){let n=t.includes(`=`)?t.slice(1,t.indexOf(`=`)):t.slice(1);if(n.length===1){let t=r.aliasMap.get(n)??n;if(r.aliases.has(n)||r.flagNames.has(t)){s+=Lt(e,s,t,!1,r.booleanFlags,a);continue}}let i=Rt(e,s,r);if(i>0){a.push(...e.slice(s,s+i)),s+=i;continue}break}break}return{subCommandIndex:-1,globalTokensBefore:a,tokensAfterSubcommand:[],suppressedTokens:o}}const Bt=/* @__PURE__ */ new Set([`--help`,`-h`,`--help-all`,`-H`,`--help-json`,`--version`]);function Vt(e,t,n={}){let r=n.stopOnSuppressedNegation===!0||t?.unknownKeysMode===`strict`,i=t?Ft(t):{aliasMap:/* @__PURE__ */ new Map,booleanFlags:/* @__PURE__ */ new Set,definedNames:/* @__PURE__ */ new Set,flagNames:/* @__PURE__ */ new Set,cliNames:/* @__PURE__ */ new Set,aliases:/* @__PURE__ */ new Set,negationMap:/* @__PURE__ */ new Map,defaultNegationDisabledFields:/* @__PURE__ */ new Set};for(let t=0;t<e.length;t++){let n=e[t];if(!n.startsWith(`-`))return t;if(n===`--`||Bt.has(n))return-1;if(n.startsWith(`--`)){let{resolvedName:a,isNegated:o,isGlobal:s,isSuppressedNegation:c}=It(n,i);if(s){X(n,a,o,e[t+1],i.booleanFlags)&&t++;continue}if(c){if(r)return-1;continue}return-1}let a=n.includes(`=`)?n.slice(1,n.indexOf(`=`)):n.slice(1);if(a.length===1){let r=i.aliasMap.get(a)??a;if(i.aliases.has(a)||i.flagNames.has(r)){X(n,r,!1,e[t+1],i.booleanFlags)&&t++;continue}}let o=Rt(e,t,i);if(o>0)t+=o-1;else return-1}return-1}function Ht(e,t){let n=Vt(e,t);return n>=0?e[n]:void 0}function Ut(t,n,r={}){let i=_(n),a=[...i],o=a.length>0,s=o&&!n.run;if(o&&t.length>0){if(r.globalExtracted){let e=zt(t,a,r.globalExtracted);if(e.subCommandIndex>=0){let n=Kt(e.globalTokensBefore,r.globalExtracted);return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:t[e.subCommandIndex],remainingArgs:e.tokensAfterSubcommand,rawArgs:{},positionals:[],rest:[],unknownFlags:e.suppressedTokens,unknownGlobalFlags:e.suppressedTokens,rawGlobalArgs:n}}}else{let e=t[0];if(e&&!e.startsWith(`-`)&&i.has(e))return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:e,remainingArgs:t.slice(1),rawArgs:{},positionals:[],rest:[],unknownFlags:[]}}}let c;n.args&&(c=E(n.args),r.skipValidation||(gt(c),St(c),_t(c),xt(c),vt(c),yt(c,o),bt(c),r.globalExtracted&&Tt(r.globalExtracted,c)));let l=t,u,d=[];if(r.globalExtracted){let e=c?S(c):[],n=new Set(e.map(e=>e.name)),{separated:i,globalParsed:a,suppressedTokens:o}=Yt(t,r.globalExtracted,c&&{...c,fields:[...e,...c.fields.filter(e=>!n.has(e.name))]});l=i,u=a,d=o}let{helpRequested:f,helpAllRequested:p,helpJsonRequested:m,versionRequested:h}=qt(t,c);if(f||p||m||h)return{helpRequested:f,helpAllRequested:p,helpJsonRequested:m,versionRequested:h,subCommand:void 0,remainingArgs:[],rawArgs:{},positionals:[],rest:[],unknownFlags:[],unknownGlobalFlags:d,rawGlobalArgs:u};if(s||r.beforeEnvFallback?.(u),!c){let t=l.indexOf(`--`),n=t>=0?l.slice(0,t):l,i=t>=0?l.slice(t+1):[],a=e=>s&&e.startsWith(`-`)&&e!==`-`,o=new Set(r.globalExtracted?.fields.flatMap(t=>[t.name,t.cliName,...e(t)])),c=r.globalExtracted?z(r.globalExtracted):{},f=n.filter(a).flatMap(e=>Object.keys(P([e],c).options)).filter(e=>!o.has(e));return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:void 0,remainingArgs:[],rawArgs:{},positionals:n.filter(e=>!a(e)),rest:i,unknownFlags:f,unknownGlobalFlags:d,rawGlobalArgs:u}}let g=Wt(c,l,{promptAvailable:r.promptAvailable===!0,inheritedNames:r.inheritedNames??/* @__PURE__ */ new Set});if(!g)return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:void 0,remainingArgs:[],rawArgs:{},positionals:[],rest:[],unknownFlags:[],unknownGlobalFlags:d,extractedFields:c,matchesNoUnionOption:!0,rawGlobalArgs:u};let v=z(g),y=P(l,{...v,unknownFlagsTakeNoValue:s}),b=F(y,g),x=Z(b,g),C=g.fields.filter(e=>e.named),w=new Set(C.map(e=>e.name)),T=new Set(C.map(e=>e.cliName)),D=/* @__PURE__ */ new Set;for(let t of C)for(let n of e(t))D.add(n);if(r.globalExtracted)for(let t of r.globalExtracted.fields){w.add(t.name),T.add(t.cliName);for(let n of e(t))D.add(n)}let O=[];for(let e of Object.keys(y.options))w.has(e)||T.has(e)||D.has(e)||O.push(e);return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:void 0,remainingArgs:[],rawArgs:b,positionals:y.positionals,rest:y.rest,unknownFlags:O,unknownGlobalFlags:d,extractedFields:c,optionFields:C,positionalSlotFields:L(g,y.options),rawGlobalArgs:u,envFallbackFields:x}}function Wt(e,t,n){let{discriminator:r,variants:i,unionOptions:a}=e;if(r&&i){let n=e=>{let n=F(P(t,z(e)),e);return Z(n,e),n},r=ee(e,n);return r===e?i.some(t=>{let r=n({...e,fields:t.fields});return ee(e,()=>r)!==e})?void 0:e:r}if(a){let r=a.flatMap(e=>{let r=Wt(e,t,n);return r?[r]:[]}),i=n.promptAvailable?r.filter(e=>Gt(e,t,void 0)):[],o=r.find(e=>Gt(e,t,n.inheritedNames))??(i.length===1?i[0]:void 0);return o&&{...e,fields:o.fields}}return e}function Z(e,t){let n=/* @__PURE__ */ new Set;for(let r of t.fields)if(r.env&&e[r.name]===void 0)for(let t of[r.env].flat()){let i=process.env[t];if(i!==void 0){e[r.name]=ne(i,r.type),n.add(r.name);break}}return n}function Gt(t,n,r){let i=P(n,z(t)),a=t.fields.filter(e=>e.named),o=new Set(a.flatMap(t=>[t.name,t.cliName,...e(t)]));if(Object.keys(i.options).some(e=>!o.has(e)))return!1;let s=L(t,i.options),c=i.positionals.length+i.rest.length;if(!s.some(e=>e.type===`array`)&&c>s.length)return!1;let l=F(i,t);return t.fields.some(e=>e.type!==`boolean`&&[l[e.name]].flat().includes(!0))?!1:r===void 0||(Z(l,t),t.fields.every(e=>!e.required||l[e.name]!==void 0||r.has(e.name)))}function Kt(e,t){if(e.length===0)return{};let n=z(t),r=P(e,n);return F(r,t)}function qt(t,n){let r=t.indexOf(`--`),i=r>=0?t.slice(0,r):t,a=n?.fields.some(t=>t.overrideBuiltinAlias===!0&&e(t).includes(`H`))??!1,o=n?.fields.some(t=>t.overrideBuiltinAlias===!0&&e(t).includes(`h`))??!1,s=i.includes(`--help-all`)||!a&&i.includes(`-H`),c=i.includes(`--help-json`);return{helpRequested:!s&&!c&&(i.includes(`--help`)||!o&&i.includes(`-h`)),helpAllRequested:s,helpJsonRequested:c,versionRequested:i.includes(`--version`)}}function Jt(e,t){return Yt([...e],t).globalParsed}function Yt(t,n,r){let i=Ft(n),o=new Set(r?.fields.map(e=>e.name)??[]),s=new Set(r?.fields.map(e=>e.cliName)??[]),c=r?z(r):void 0,l=new Set(c?.aliasMap?.keys()??[]),u=new Set(c?.negationMap?.keys()??[]),d=/* @__PURE__ */ new Set;for(let t of r?.fields??[])if(t.type===`boolean`&&t.negation===!0)for(let n of[t.cliName,...e(t)]){let e=`no-${n}`;d.add(e),d.add(a(e))}let f=[],p=[],m=[];for(let e=0;e<t.length;e++){let n=t[e];if(n===`--`){p.push(...t.slice(e));break}if(n.startsWith(`--`)){let{resolvedName:r,withoutDashes:a,isNegated:c,isGlobal:p,isSuppressedNegation:h}=It(n,i),g=r,_=o.has(a)||o.has(g)||s.has(a)||s.has(g)||l.has(a)||l.has(g)||u.has(a)||u.has(g)||d.has(a);if(p&&!_){e+=Lt(t,e,r,c,i.booleanFlags,f)-1;continue}if(h&&!_){m.push(a);continue}}else if(n.startsWith(`-`)&&n.length>1){let r=n.includes(`=`)?n.slice(1,n.indexOf(`=`)):n.slice(1);if(r.length===1){let n=i.aliasMap.get(r)??r;if((i.aliases.has(r)||i.flagNames.has(n))&&!l.has(r)){e+=Lt(t,e,n,!1,i.booleanFlags,f)-1;continue}}let a=Rt(t,e,i,e=>l.has(e));if(a>0){f.push(...t.slice(e,e+a)),e+=a-1;continue}}p.push(n)}return{separated:p,globalParsed:Kt(f,n),suppressedTokens:m}}function Q(e,n){return O(n)?T(e,n):t().validate(e,n)}function Xt(e){return e.map(e=>`${e.path.length>0?`${e.path.join(`.`)}: `:``}${e.message}`).join(`
33
+ `)}function Zt(e,t){let n=[];for(let e=0;e<=t.length;e++)n[e]=[e];for(let t=0;t<=e.length;t++)n[0][t]=t;for(let r=1;r<=t.length;r++)for(let i=1;i<=e.length;i++)t.charAt(r-1)===e.charAt(i-1)?n[r][i]=n[r-1][i-1]:n[r][i]=Math.min(n[r-1][i-1]+1,n[r][i-1]+1,n[r-1][i]+1);return n[t.length][e.length]}function Qt(e,t){let n=Math.max(2,Math.floor(e.length/2));return t.map(t=>({candidate:t,distance:Zt(e.toLowerCase(),t.toLowerCase())})).filter(({distance:e})=>e<=n).sort((e,t)=>e.distance-t.distance).map(({candidate:e})=>e).slice(0,3)}function $t(e,t){let n=Qt(e.replace(/^-{1,2}/,``),t),r=`${N.warning(`Warning: Unknown option:`)} ${N.bold(e)}`;if(n.length>0){r+=`\n\n${N.info(`Did you mean?`)}`;for(let e of n)r+=`\n ${M.arrow} ${N.option(`--${e}`)}`}return r}function en(e,t){return t&&e.stack?`${N.error(`Error:`)} ${e.message}\n\n${N.dim(e.stack)}`:`${N.error(`Error:`)} ${e.message}`}function $(e){return new Proxy(e,{get(e,t,n){if(typeof t==`string`){if(t in e)return Reflect.get(e,t,n);let i=a(t);if(i!==t&&i in e)return Reflect.get(e,i,n);let o=r(t);if(o!==t&&o in e)return Reflect.get(e,o,n)}return Reflect.get(e,t,n)},has(e,t){if(typeof t==`string`){if(t in e)return!0;let n=a(t);if(n!==t&&n in e)return!0;let i=r(t);if(i!==t&&i in e)return!0}return Reflect.has(e,t)}})}async function tn(e,t,n){for(let r of t.fields)r.effect&&await r.effect(i(e,r),{name:r.name,args:e,...n!=null&&{globalArgs:n}})}var nn=class extends Error{constructor(e){super(`Environment file not found: ${e}`),this.name=`EnvFileNotFoundError`}};function rn(e,t){return t.fields.flatMap(t=>{if(!t.envFile)return[];let n=t.envFile===`if-exists`;return e.flatMap(e=>[e[t.name]].flat().filter(e=>typeof e==`string`).map(e=>({path:e,ifExists:n})))})}function an(e,t){return Object.fromEntries((t?.fields??[]).flatMap(t=>{if(!t.envFile||t.type!==`array`)return[];let n=e.flatMap(e=>[e[t.name]].flat());return n.length>0&&n.every(e=>typeof e==`string`)?[[t.name,n]]:[]}))}function on(e,t={}){cn(Array.isArray(e)?e:sn(e,t.argv??process.argv.slice(2)))}function sn(e,t){let n=E(e);return un(n),Object.values(qt(t)).some(Boolean)?[]:rn([Jt(t,{...n,fields:n.fields.map(e=>e.envFile&&e.type===`string`?{...e,type:`array`}:e)})],n)}function cn(e){let t=e.flatMap(e=>{let t=ae.resolve(process.cwd(),e.path);if(!B.existsSync(t)){if(e.ifExists)return[];throw new nn(t)}return[se(B.readFileSync(t,`utf-8`))]}),n=new Set(t.flatMap(e=>Object.keys(e)).filter(e=>typeof process.env[e]==`string`));for(let e of t)for(let[t,r]of Object.entries(e))n.has(t)||(process.env[t]=r)}function ln(e){return[...e.fields,...(e.variants??[]).flatMap(e=>e.fields),...(e.unionOptions??[]).flatMap(ln)]}function un(e){let t=/* @__PURE__ */ new Map;for(let n of ln(e)){if(n.envFile&&n.type!==`string`&&n.type!==`array`)throw Error(`Global option "${n.name}" sets envFile but its value is not a string or an array of strings`);let e=t.get(n.name)??/* @__PURE__ */ new Set;e.add(n.envFile??!1),t.set(n.name,e)}for(let[e,n]of t)if(n.size>1)throw Error(`Global option "${e}" has different envFile settings across union variants (${[...n].map(e=>JSON.stringify(e)).join(`, `)}); use the same setting in every variant`)}const dn={log:e=>console.log(e),error:e=>console.error(e),warn:e=>console.warn(e)};function fn(e){let t={};for(let[n,r]of Object.entries(e))try{t[n]=structuredClone(r)}catch{t[n]=r}return t}function pn(e,t){Object.defineProperty(e,"$source",{value:e=>t.get(e)??t.get(a(e))??t.get(r(e))??`default`,enumerable:!1})}function mn(e,t,n){let r=/* @__PURE__ */ new Map;for(let t of e)r.set(t,`cli`);for(let e of t)r.set(e,`env`);for(let e of n)r.set(e,`prompt`);return r}function hn(e,t){Object.defineProperty(e,"$invocation",{value:t,enumerable:!1})}function gn(e,t){Object.defineProperty(e,"$agent",{value:t,enumerable:!1})}function _n(e,t){return e&&(n=>e({...n,agent:t}))}function vn(e,t,n){if(!e.rawGlobalArgs)return;let r=new Set(n.fields.map(e=>e.name)),i={};for(let[t,n]of Object.entries(e.rawGlobalArgs))r.has(t)&&(i[t]=n);let a=new Set(Object.keys(i)),o=Z(i,n);for(let[t,n]of Object.entries(e.promptedGlobalArgs??{}))r.has(t)&&(o.delete(t),n===void 0?(delete i[t],a.delete(t)):i[t]=n);for(let n=0;n<=r.size;n++){let n=Q(i,t);if(n.success){let t=n.data,r=/* @__PURE__ */ new Map;for(let e of a)e in i&&r.set(e,`cli`);for(let e of o)e in i&&r.set(e,`env`);for(let[t,n]of Object.entries(e.promptedGlobalArgs??{}))n!==void 0&&t in i&&r.set(t,`prompt`);return pn(t,r),$(t)}let r=n.errors.map(e=>e.path[0]).filter(e=>e!==void 0&&Object.hasOwn(i,e));if(r.length===0){let e=Object.keys(i).filter(e=>{let{[e]:n,...r}=i;return Q(r,t).success});if(e.length!==1)return;r=e}for(let e of r)delete i[e]}}function yn(e,t,n,r){let i=e.success?void 0:e.error;if(e.success||t.effectsRan||!n||!r)return{error:i};try{return{error:i,globalArgs:vn(t,n,r)}}catch{return{error:i}}}function bn(e,t){let{agentHelp:n,_agent:r}=e;if(n&&r)return typeof n==`string`?n:n({agent:r,commandPath:t.commandPath??[]})}function xn(e,t){let n=t.commandPath?.at(-1)??e.name;return t.aliasFor?{name:n,aliasFor:t.aliasFor}:{name:n}}async function Sn(e,t,n={}){let r=Dn(n),i=s(),a=_n(n.cleanup,i),o=n.captureLogs??!1,c=o?x():null;if(n.setup){c?.start();try{await n.setup({agent:i})}catch(e){let t=e instanceof Error?e:Error(String(e));if(a)try{await a({error:t})}catch{}return c?.stop(),{success:!1,error:t,exitCode:1,logs:c?.getLogs()??y()}}c?.stop()}let l={},u=await En(e,t,{...n,handleSignals:!1,_globalExtracted:r,_globalCleanup:a,_existingLogs:c?.getLogs(),_agent:i,_globalTrace:l});if(a){let e=o?x():null;e?.start();let t=yn(u,l,n.globalArgs,r);try{await a(t)}catch(t){if(u.success){let n=t instanceof Error?t:Error(String(t));return e?.stop(),{success:!1,error:n,exitCode:1,logs:b(u.logs,e?.getLogs()??y())}}}e?.stop();let i=e?.getLogs()??y();if(i.entries.length>0)return{...u,logs:b(u.logs,i)}}return u}function Cn(e,t,n){let r=Ht(t,n);return!r||!r.startsWith(`__`)?!1:Object.hasOwn(e.subCommands??{},r)}async function wn(e,t={}){if(t.compileCache!==!1&&c(typeof t.compileCache==`string`?{cacheDir:t.compileCache}:{programName:e.name}),e.runMainHook)try{e.runMainHook(process.argv.slice(2))}catch{}let n=process.argv.slice(2),r;if(t.globalArgs)try{r=E(t.globalArgs)}catch{}let i=t;if(Cn(e,n,r)){let{setup:e,cleanup:n,prompt:r,globalArgs:a,...o}=t;i=o}let a=Dn(i),o=s(),l=_n(i.cleanup,o);if(i.skipValidation||kt(e),i.onUnknownSubcommand&&!e.run&&!Cn(e,n,r)){let t=_(e);if(t.size>0){let e=Vt(n,a,{stopOnSuppressedNegation:a?.unknownKeysMode!==`passthrough`}),r=e>=0?n[e]:void 0;if(r&&!t.has(r)){let t=n.slice(e+1),a=await i.onUnknownSubcommand({commandPath:[],name:r,args:t,precedingArgs:n.slice(0,e)});if(typeof a==`number`)return await Tn(),process.exit(a)}}}if(i.setup)try{await i.setup({agent:o})}catch(e){let t=e instanceof Error?e:Error(String(e));if(l)try{await l({error:t})}catch{}process.exit(1)}let u={},d=await En(e,n,{debug:i.debug,captureLogs:i.captureLogs,skipValidation:i.skipValidation,handleSignals:!0,logger:i.logger,globalArgs:i.globalArgs,prompt:i.prompt,onUnknownSubcommand:i.onUnknownSubcommand,agentHelp:i.agentHelp,_globalExtracted:a,_globalCleanup:l,_agent:o,_globalTrace:u,_context:{commandPath:[],rootName:e.name,rootVersion:i.version,globalExtracted:a}});if((i.displayErrors??!0)&&!d.success&&d.error&&(i.logger??dn).error(en(d.error,i.debug??!1)),l){let e=yn(d,u,i.globalArgs,a);try{await l(e)}catch{}}await Tn(),process.exit(d.exitCode)}async function Tn(){await Promise.all([process.stdout,process.stderr].map(e=>e.writableLength>0?new Promise(t=>e.write(``,()=>t())):Promise.resolve()))}async function En(e,t,r={}){let i=r.logger??dn,a=r._context??{commandPath:[],rootName:e.name,globalExtracted:r._globalExtracted},o=r.captureLogs??!1?x():null;o?.start();let s=()=>{let e=r._existingLogs??y(),t=o?.getLogs()??y();return b(e,t)};try{r.skipValidation||kt(e);let c=(()=>{if(!r.onUnknownSubcommand||e.run||(a.commandPath??[]).length===0)return;let n=_(e);if(n.size===0)return;let i=Vt(t,r._globalExtracted,{stopOnSuppressedNegation:r._globalExtracted?.unknownKeysMode!==`passthrough`}),o=i>=0?t[i]:void 0;return o&&!n.has(o)?{positionalIndex:i,name:o}:void 0})(),d;try{d=Ut(t,e,{skipValidation:r.skipValidation,globalExtracted:r._globalExtracted,promptAvailable:r.prompt!==void 0,inheritedNames:new Set(Object.keys(r._parsedGlobalArgs??{})),beforeEnvFallback:e=>{r._globalExtracted&&!c&&(r._globalTrace&&(r._globalTrace.rawGlobalArgs={...r._parsedGlobalArgs,...e,...an([r._parsedGlobalArgs??{},e??{}],r._globalExtracted)}),on(rn([...r._globalArgLevels??[],e??{}],r._globalExtracted)))}})}catch(e){if(!(e instanceof nn))throw e;return o?.stop(),{success:!1,error:e,exitCode:2,logs:s()}}let p={...r._parsedGlobalArgs,...d.rawGlobalArgs,...an([r._parsedGlobalArgs??{},d.rawGlobalArgs??{}],r._globalExtracted)};r._globalTrace&&(r._globalTrace.rawGlobalArgs={...p});let h=a.commandPath??[],v=r.onUnknownSubcommand;if(c&&v){let{positionalIndex:e,name:n}=c;{let i=await v({commandPath:h,name:n,args:t.slice(e+1),precedingArgs:[...r._precedingArgs??[],...t.slice(0,e)]});if(typeof i==`number`){if(o?.stop(),r.handleSignals){if(r._globalCleanup)try{await r._globalCleanup({error:void 0})}catch{}await Tn(),process.exit(i)}return i===0?{success:!0,result:void 0,exitCode:0,logs:s()}:{success:!1,error:/* @__PURE__ */ Error(`Plugin "${[...h,n].join(` `)}" exited with code ${i}`),exitCode:i,logs:s()}}}}if(d.helpRequested||d.helpAllRequested||d.helpJsonRequested){let n=!1,c=m(e),l=_(e);if(c.length>0){let e=Ht(t,a.globalExtracted);e&&!l.has(e)&&(n=!0)}let u=bn(r,a);if(d.helpJsonRequested){let t=Ze(e,{context:a,agentHelp:u});i.log(JSON.stringify(t))}else{let t=Ye(e,{showSubcommands:r.showSubcommands??!0,showSubcommandOptions:d.helpAllRequested||r.showSubcommandOptions,context:a,agentHelp:u});i.log(t)}if(o?.stop(),n){let e=Ht(t,a.globalExtracted)??``,n=Qt(e,[...l]),r=n.length>0?` Did you mean: ${n.join(`, `)}?`:``;return{success:!1,error:/* @__PURE__ */ Error(`Unknown subcommand: ${e}${r?`.${r}`:``}`),exitCode:2,logs:s()}}return{success:!0,result:void 0,exitCode:0,logs:s()}}if(d.unknownGlobalFlags&&d.unknownGlobalFlags.length>0){let e=a.globalExtracted?.unknownKeysMode??`strip`;if(e===`strict`)return o?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unknown flags: ${d.unknownGlobalFlags.join(`, `)}`),exitCode:2,logs:s()};if(e===`strip`){let e=a.globalExtracted?.fields.map(e=>e.name)??[];for(let t of d.unknownGlobalFlags)i.error($t(t,e))}}if(d.versionRequested){let e=a.rootVersion;return e&&i.log(e),o?.stop(),{success:!0,result:void 0,exitCode:0,logs:s()}}if(d.subCommand){let n=r._metadataOnly??!1,i=await l(e,d.subCommand,e=>{if(n)return!0;if(!e.requiredPackages?.length)return!1;let t=e,i=d.remainingArgs;for(;;){let e=Ut(i,t,{skipValidation:r.skipValidation,globalExtracted:a.globalExtracted,promptAvailable:!!r.prompt});if(e.helpRequested||e.helpAllRequested||e.helpJsonRequested||e.versionRequested)return n=!0,!0;if(!e.subCommand||!t.subCommands)return!1;let o=Object.hasOwn(t.subCommands,e.subCommand)?e.subCommand:f(t,e.subCommand)??e.subCommand,s=t.subCommands[o],c=s?u(s):null;if(!c)return!1;t=c,i=e.remainingArgs}});if(i){let e={commandPath:[...a.commandPath??[],d.subCommand],rootName:a.rootName,rootVersion:a.rootVersion,globalExtracted:a.globalExtracted,aliasFor:i.aliasFor};o?.stop();let c=new Set(r._globalExtracted?.unknownKeysMode===`passthrough`?[]:d.unknownGlobalFlags??[]),l=e=>e.startsWith(`--`)&&c.has(te(e)),u=t.slice(0,t.length-d.remainingArgs.length-1).filter(e=>!l(e));return En(i.command,d.remainingArgs,{...r,_metadataOnly:n,_context:e,_existingLogs:s(),_parsedGlobalArgs:p,_globalArgLevels:[...r._globalArgLevels??[],d.rawGlobalArgs??{}],_precedingArgs:[...r._precedingArgs??[],...u]})}}let y=d.positionalSlotFields??[],b=y.some(e=>e.type===`array`),x=[...d.positionals,...d.rest],S=b?[]:x.slice(y.length),C=b?[]:d.positionals.slice(y.length);if(d.matchesNoUnionOption)return o?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Arguments match none of the accepted forms. See --help for the accepted forms.`),exitCode:2,logs:s()};let T=_(e),E=T.size>0?C.find(e=>!e.startsWith(`-`)&&!T.has(e)):void 0;if(E){let e=Qt(E,[...T]),t=e.length>0?` Did you mean: ${e.join(`, `)}?`:``;return o?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unknown subcommand: ${E}${t?`.${t}`:``}`),exitCode:2,logs:s()}}if(d.unknownFlags.length>0){let e=d.extractedFields?.unknownKeysMode??a.globalExtracted?.unknownKeysMode??`strip`,t=d.optionFields?.map(e=>e.name)??a.globalExtracted?.fields.map(e=>e.name)??[];if(e===`strict`)return o?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unknown flags: ${d.unknownFlags.join(`, `)}`),exitCode:2,logs:s()};if(e===`strip`)for(let e of d.unknownFlags)i.error($t(e,t))}if(m(e).length>0&&!d.subCommand&&!e.run&&S.length===0){if(e.defaultSubCommand){let n=e.subCommands?.[e.defaultSubCommand];if(n){let i=await g(n),c={commandPath:[...a.commandPath??[],e.defaultSubCommand],rootName:a.rootName,rootVersion:a.rootVersion,globalExtracted:a.globalExtracted};o?.stop();let l=new Set(r._globalExtracted?.unknownKeysMode===`passthrough`?[]:d.unknownGlobalFlags??[]),u=e=>e.startsWith(`--`)&&l.has(te(e)),f=t.filter(e=>!u(e));return En(i,[],{...r,_context:c,_existingLogs:s(),_parsedGlobalArgs:p,_globalArgLevels:[...r._globalArgLevels??[],d.rawGlobalArgs??{}],_precedingArgs:[...r._precedingArgs??[],...f]})}}if(r.globalArgs&&r._globalExtracted){let e={...p};Z(e,r._globalExtracted);let t=Q(e,r.globalArgs),n=t.success?[]:t.errors.filter(t=>t.path[0]&&e[t.path[0]]!==void 0);if(n.length>0)return o?.stop(),{success:!1,error:Error(Xt(n)),exitCode:2,logs:s()}}let n=Ye(e,{showSubcommands:r.showSubcommands??!0,context:a,agentHelp:bn(r,a)});return i.log(n),o?.stop(),{success:!0,result:void 0,exitCode:0,logs:s()}}if(S.length>0){let e=d.extractedFields?.unknownKeysMode??`strip`;if(e===`strict`)return o?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unexpected positional argument${S.length>1?`s`:``}: ${S.join(`, `)}`),exitCode:2,logs:s()};if(e===`strip`)for(let e of S)(i.warn??i.error)(`Warning: Unexpected positional argument: ${e}`)}let D={},O=e.name===`__complete`,k=new Set(Object.keys(p)),A=/* @__PURE__ */ new Set,j=/* @__PURE__ */ new Set;if(r.globalArgs&&r._globalExtracted&&!O){if(A=Z(p,r._globalExtracted),r.prompt){let e=fn(p);try{let e=await r.prompt(p,r._globalExtracted,{globalArgs:p});for(let[t,n]of Object.entries(e))n!==void 0&&(p[t]=n)}finally{let t={};for(let n of/* @__PURE__ */ new Set([...Object.keys(e),...Object.keys(p)])){let r=p[n];oe(e[n],r)||(t[n]=r,r===void 0&&(k.delete(n),A.delete(n)))}j=new Set(Object.keys(t).filter(e=>t[e]!==void 0)),r._globalTrace&&(r._globalTrace.promptedGlobalArgs=t)}}let e=Q(p,r.globalArgs);if(!e.success)return o?.stop(),{success:!1,error:Error(Xt(e.errors)),exitCode:2,logs:s()};D=e.data}let M=r.globalArgs&&r._globalExtracted&&!O?w(r._globalExtracted,e=>Q(p,e).success,()=>p):r._globalExtracted,N=O||!r._globalExtracted?void 0:M===r._globalExtracted?ee(r._globalExtracted,()=>D).fields:M?.fields;if(!e.args){let t=mn(k,A,j);pn(D,t),hn(D,xn(e,a)),gn(D,r._agent);let n=$(D);return r._globalExtracted&&!O&&(r._globalTrace&&(r._globalTrace.effectsRan=!0),await tn(n,M,n)),o?.stop(),await le(e,n,{handleSignals:r.handleSignals,captureLogs:r.captureLogs,existingLogs:s(),globalCleanup:r._globalCleanup,packageDiscriminators:r._globalExtracted?.discriminator?[r._globalExtracted.discriminator]:[],packageFields:N})}let P=d.rawArgs,ne=r.prompt?fn(d.rawArgs):d.rawArgs,F=e=>Object.hasOwn(ne,e),re=/* @__PURE__ */ new Set;if(r.prompt&&d.extractedFields){let e=await r.prompt(P,d.extractedFields,{globalArgs:D}),t={...P};for(let[n,r]of Object.entries(e))r!==void 0&&(t[n]=r);P=t;for(let[e,t]of Object.entries(P))t===void 0||F(e)&&oe(ne[e],t)||re.add(e)}let I=Q(P,e.args);if(!I.success)return o?.stop(),{success:!1,error:Error(Xt(I.errors)),exitCode:2,logs:s()};let L=$(I.data),ie=mn(k,A,j);pn(D,ie),hn(D,xn(e,a)),gn(D,r._agent);let R=$(D);r._globalExtracted&&!O&&(r._globalTrace&&(r._globalTrace.effectsRan=!0),await tn(R,M,R));let z=d.extractedFields?O?d.extractedFields:w(d.extractedFields,e=>Q(P,e).success,()=>P):void 0;z&&!O&&await tn(L,z,R);let B=n({...R},{...L},M?.fields??[],z?.fields??[]),ae=new Map(ie),se=d.envFallbackFields??/* @__PURE__ */ new Set;for(let e of d.extractedFields?.fields??[]){let t=P[e.name]!==void 0;ae.set(e.name,re.has(e.name)?`prompt`:t&&se.has(e.name)?`env`:t&&F(e.name)?`cli`:`default`)}pn(B,ae),hn(B,xn(e,a)),gn(B,r._agent);let ce=$(B);return o?.stop(),await le(e,ce,{handleSignals:r.handleSignals,captureLogs:r.captureLogs,existingLogs:s(),globalCleanup:r._globalCleanup,packageDiscriminators:[d.extractedFields?.discriminator,r._globalExtracted?.discriminator].filter(e=>e!==void 0),packageFields:O?void 0:[...N??[],...z!==d.extractedFields&&z?z.fields:[...d.optionFields??[],...d.positionalSlotFields??[]]]})}catch(e){let t=e instanceof Error?e:Error(String(e));return o?.stop(),{success:!1,error:t,exitCode:1,logs:s()}}}function Dn(e){if(!e.globalArgs)return;let t=E(e.globalArgs);if(!e.skipValidation){gt(t),St(t),_t(t),xt(t),yt(t,!0),bt(t),un(t);let e=t.fields.filter(e=>e.positional).map(e=>e.name);if(e.length>0)throw Error(`Global options schema must not contain positional arguments. Found: ${e.join(`, `)}`)}return t}export{he as A,st as C,Ye as D,at as E,Ze as O,it as S,et as T,bt as _,$ as a,nt as b,St as c,kt as d,_t as f,yt as g,vt as h,on as i,V as k,Mt as l,xt as m,wn as n,Xt as o,gt as p,nn as r,Pt as s,Sn as t,Tt as u,rt as v,$e as w,tt as x,ot as y};
@@ -0,0 +1 @@
1
+ export{t as runCommand}from"./runner-C0PI1zBE.js";
package/dist/skill.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { C as AnyCommand, T as ArgsSchema, it as UnknownKeysMode } from "./arg-registry-biPCZomY.js";
1
+ import { C as AnyCommand, T as ArgsSchema, it as UnknownKeysMode } from "./arg-registry-DNUJtjsZ.js";
2
2
  import { z } from "zod";
3
3
  /**
4
4
  * SKILL.md frontmatter metadata, validated against the Agent Skills
package/dist/skill.js CHANGED
@@ -1,2 +1,2 @@
1
- import"./register-BWzt6u5k.js";import{n as e}from"./command-BXsTrIgI.js";import{d as t,f as n,n as r}from"./schema-extractor-Cwg_WAC-.js";import{a as i,n as a}from"./logger-CoeDrmRr.js";import{copyFileSync as o,existsSync as s,lstatSync as c,mkdirSync as l,mkdtempSync as u,readFileSync as d,readdirSync as f,readlinkSync as p,realpathSync as m,renameSync as ee,rmSync as h,statSync as g,symlinkSync as te,unlinkSync as _}from"node:fs";import{basename as v,dirname as y,isAbsolute as b,join as x,parse as ne,relative as S,resolve as C,sep as w}from"node:path";import{z as T}from"zod";import{parse as re}from"yaml";const ie=/^[a-z0-9]+(-[a-z0-9]+)*$/;function E(e){return e===null?`null`:Array.isArray(e)?`array`:typeof e}function ae(e){let t=[],n=(n,r)=>{let i=e[n];i===void 0?r.required&&t.push({path:[n],message:`Invalid input: expected string, received undefined`}):typeof i==`string`?(r.min!==void 0&&i.length<r.min&&t.push({path:[n],message:`Too small: expected string to have >=${r.min} characters`}),r.max!==void 0&&i.length>r.max&&t.push({path:[n],message:`Too big: expected string to have <=${r.max} characters`})):t.push({path:[n],message:`Invalid input: expected string, received ${E(i)}`})};n(`name`,{required:!0,min:1,max:64}),typeof e.name==`string`&&!ie.test(e.name)&&t.push({path:[`name`],message:`name must be lowercase alphanumerics separated by single hyphens`}),n(`description`,{required:!0,min:1,max:1024}),n(`license`,{min:1}),n(`compatibility`,{max:500}),n(`allowed-tools`,{});let r=e.metadata;if(r!==void 0){if(typeof r!=`object`||!r||Array.isArray(r))t.push({path:[`metadata`],message:`Invalid input: expected record, received ${E(r)}`});else for(let[e,n]of Object.entries(r))typeof n!=`string`&&t.push({path:[`metadata`,e],message:`Invalid input: expected string, received ${E(n)}`})}return t.length>0?{success:!1,issues:t}:{success:!0,data:{...e}}}const oe=/^\uFEFF?---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)([\s\S]*)$/;function D(e){let t=e.match(oe);if(!t)return{data:{},body:e};let n=t[1],r=t[2];try{let e=re(n);return se(e)?{data:e,body:r}:{data:{},body:r}}catch(e){return{data:{},body:r,parseError:e instanceof Error?e.message:String(e)}}}function se(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=Object.getPrototypeOf(e);return t===Object.prototype||t===null}function ce(e){let{data:t,body:n}=D(e),r=ae(t);return r.success?{frontmatter:r.data,body:n,rawContent:e}:null}const O=`.agents/skills`,k=[`.claude/skills`],A=`politty-cli`;function j(e){if(e.length<1||e.length>64||!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(e))throw Error(`Invalid skill name: ${JSON.stringify(e)}`)}function le(e,t=process.cwd(),n={}){let r=e.frontmatter.name;j(r);let i=n.mode??`symlink`,a=e.frontmatter.metadata?.[`politty-cli`]??null;if(i===`copy`&&a===null)throw Error(`Refusing to install "${e.frontmatter.name}" in copy mode without an ownership stamp. Add metadata.${A}="{package}:{cli}" to the source SKILL.md so subsequent installs can replace the copy in place.`);let o=C(t,O),s=m(e.sourcePath),c=ue(e.sourcePath),u=[x(N(o),r),...k.map(e=>x(N(C(t,e)),r))].find(e=>ye(e,s));if(u!==void 0)throw Error(`Refusing to install "${r}": source ${s} overlaps install destination ${u}. Choose a sourceDir outside .agents/skills/ and any agent-specific slot directory (e.g. .claude/skills/).`);if(i===`symlink`){let e=N(o);M(x(e,r),S(e,c));for(let n of k){let i=N(C(t,n));M(x(i,r),x(S(i,e),r))}}l(o,{recursive:!0});let d=m(o),f=x(d,r);he(f,a),ge({linkTarget:S(d,c),linkPath:f,copyFrom:s,mode:i}),ve(t,r,f,a,i)}function M(e,t){if(b(t))throw Error(`Refusing to write an absolute symlink target at ${e} → ${t}. The skill source and install root appear to live on different filesystem roots (e.g. different Windows drive letters); retry with mode: "copy".`)}function ue(e){let t=C(e),{root:n}=ne(t),r=t.slice(n.length).split(w).filter(e=>e!==``),i=n;for(let[e,t]of r.entries()){let n=x(i,t),a;try{a=c(n)}catch{return x(i,...r.slice(e))}if(a.isSymbolicLink()){if(de(i))return x(i,...r.slice(e));i=m(n)}else i=n}return i}function de(e){return v(e)===`node_modules`||v(e).startsWith(`@`)&&v(y(e))===`node_modules`}function N(e){let t=e,n=[];for(;;)try{let e=m(t);return n.length===0?e:C(e,...n.reverse())}catch{let r=y(t);if(r===t)return e;n.push(t.slice(r.length).replace(/^[/\\]+/,``)),t=r}}function fe(e,t=process.cwd(),n={}){j(e);let r=n.expectedOwnership??null,i=C(t,O,e);for(let n of k)me(C(t,n,e),r,{restrictSymlinkTo:i});me(i,r)}function pe(e,t){let n;try{n=p(e)}catch{return!1}let r=b(n)?n:C(y(e),n);if(r===t)return!0;try{return m(r)===m(t)}catch{return!1}}function me(e,t,n={}){let r;try{r=c(e)}catch(e){if(R(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return;throw e}if(r.isSymbolicLink()){if(n.restrictSymlinkTo!==void 0){pe(e,n.restrictSymlinkTo)&&_(e);return}(t===null||F(e)===t)&&_(e)}else r.isDirectory()&&t!==null&&F(e)===t&&h(e,{recursive:!0,force:!0})}function he(e,t,n={}){let r;try{r=c(e)}catch(e){if(R(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return;throw e}if(r.isSymbolicLink()){if(n.restrictSymlinkTo===void 0||pe(e,n.restrictSymlinkTo)){_(e);return}throw Error(`Refusing to replace symlink at ${e}: it does not route to this CLI's canonical slot (${n.restrictSymlinkTo}). Remove or migrate the foreign symlink before retrying.`)}if(r.isDirectory()&&t!==null&&F(e)===t)h(e,{recursive:!0,force:!0});else throw Error(`Refusing to replace non-symlink path at ${e}. This looks like a legacy or manual install; remove or migrate it before retrying.`)}function ge(e){let{linkTarget:t,linkPath:n,copyFrom:r,mode:i}=e;if(i===`copy`)_e(r,n);else{M(n,t);try{te(t,n,`dir`)}catch(e){let r=e instanceof Error?e.message:String(e);throw Error(`Failed to symlink ${n} → ${t}: ${r}. If this filesystem does not support symlinks (e.g. Windows without Developer Mode), retry with mode: "copy".`,{cause:e})}}}function _e(e,t){let n=u(`${t}.partial-`);try{P(e,n),ee(n,t)}catch(e){try{h(n,{recursive:!0,force:!0})}catch{}throw e}}function P(e,t,n=/* @__PURE__ */ new Set){let r=g(e);if(r.isDirectory()){let r=m(e);if(n.has(r))throw Error(`Refusing to recursively copy cyclic directory symlink at ${e} (resolves to ${r}, already on the copy stack).`);n.add(r);try{l(t,{recursive:!0});for(let r of f(e))P(x(e,r),x(t,r),n)}finally{n.delete(r)}}else r.isFile()&&o(e,t)}function F(e){let t;try{t=d(x(e,`SKILL.md`),`utf-8`)}catch(e){if(R(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return null;throw e}let{data:n}=D(t),r=n.metadata;if(!r||typeof r!=`object`||Array.isArray(r))return null;let i=r[A];return typeof i==`string`?i:null}function I(e,t=process.cwd()){return j(e),s(C(t,O,e,`SKILL.md`))}function L(e,t=process.cwd()){j(e);let n=C(t,O,e,`SKILL.md`),r;try{r=d(n,`utf-8`)}catch(e){if(R(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return null;throw e}let{data:i}=D(r),a=i.metadata;if(!a||typeof a!=`object`||Array.isArray(a))return null;let o=a[A];return typeof o==`string`?o:null}function ve(e,t,n,r,i){for(let a of k){let o=C(e,a);l(o,{recursive:!0});let s=m(o),c=x(s,t);he(c,r,{restrictSymlinkTo:n});let u=m(C(n,`..`));ge({linkTarget:x(S(s,u),t),linkPath:c,copyFrom:n,mode:i})}}function R(e){return e instanceof Error&&typeof e.code==`string`}function ye(e,t){if(e===t)return!0;let n=(e,t)=>{let n=S(t,e);return n===``||n===`.`||!b(n)&&n!==`..`&&!n.startsWith(`..${w}`)};return n(e,t)||n(t,e)}const z=`SKILL.md`;function B(e){let t=[],n=[];try{let r;try{r=g(e)}catch(r){return H(r)&&(r.code===`ENOENT`||r.code===`ENOTDIR`)?n.push({path:e,reason:`missing-source`,message:`Source directory does not exist: ${e}`}):n.push({path:e,reason:`read-failed`,message:`Failed to stat source directory ${e}: ${V(r)}`}),{skills:t,errors:n}}if(!r.isDirectory())return n.push({path:e,reason:`missing-source`,message:`Source path is not a directory: ${e}`}),{skills:t,errors:n};let i=x(e,z),a=Se(i);if(a.kind===`error`)return n.push({path:e,reason:`read-failed`,message:`Failed to check ${i}: ${a.message}`}),{skills:t,errors:n};if(a.kind===`present`)return xe(be(e,{enforceParentMatch:!1}),t,n),{skills:t,errors:n};let o=f(e,{withFileTypes:!0});for(let r of o){let i=x(e,r.name),a;try{a=g(i).isDirectory()}catch(e){if(H(e)&&e.code===`ENOENT`&&!r.isSymbolicLink())continue;n.push({path:i,reason:`read-failed`,message:r.isSymbolicLink()?`Dangling symlink at ${i}: ${V(e)}`:`Failed to stat ${i}: ${V(e)}`});continue}if(!a)continue;let o=x(i,z),s=Se(o);s.kind===`error`?n.push({path:i,reason:`read-failed`,message:`Failed to check ${o}: ${s.message}`}):s.kind!==`absent`&&xe(be(i,{enforceParentMatch:!0}),t,n)}}catch(t){n.push({path:e,reason:`read-failed`,message:`Failed to scan ${e}: ${V(t)}`})}return t.sort((e,t)=>e.frontmatter.name<t.frontmatter.name?-1:+(e.frontmatter.name>t.frontmatter.name)),{skills:t,errors:n}}function be(e,t){let n=x(e,z),r;try{r=d(n,`utf-8`)}catch(t){return{path:e,reason:`read-failed`,message:`Failed to read ${n}: ${V(t)}`}}let{data:i,parseError:a}=D(r);if(a!==void 0)return{path:e,reason:`parse-failed`,message:`Invalid SKILL.md frontmatter in ${e}: YAML parse error: ${a}`};let o=ae(i);if(!o.success)return{path:e,reason:`parse-failed`,message:`Invalid SKILL.md frontmatter in ${e}: ${o.issues.map(e=>`${e.path.join(`.`)||`<root>`}: ${e.message}`).join(`; `)}`};if(t.enforceParentMatch){let t=v(e);if(t!==o.data.name)return{path:e,reason:`name-mismatch`,message:`Skill name "${o.data.name}" does not match directory "${t}"`,skillName:o.data.name}}return{frontmatter:o.data,sourcePath:e,rawContent:r}}function xe(e,t,n){`frontmatter`in e?t.push(e):n.push(e)}function V(e){return e instanceof Error?e.message:String(e)}function H(e){return e instanceof Error&&typeof e.code==`string`}function Se(e){try{return c(e),{kind:`present`}}catch(e){return H(e)&&e.code===`ENOENT`?{kind:`absent`}:{kind:`error`,message:V(e)}}}function Ce(e,t={}){let n=0,r=!1;for(let i of e)i.reason===`missing-source`||i.path===t.sourceDir?(r=!0,a.warn(`Failed to scan source directory ${i.path}: ${i.message}`)):(n+=1,a.warn(`Skipping skill at ${i.path}: ${i.message}`));t.silentStdout||(n>0&&a.info(`${i.warning} Skipped ${n} skill(s) due to scan errors (see warnings above).`),r&&a.info(`${i.warning} Source directory scan failed (see warnings above); subsequent operations may be skipped.`))}function U(e,t){let n=e.errors.some(e=>e.reason===`missing-source`||e.path===t),r=e.errors.length>0&&e.skills.length===0;return n||r}function W(e,t={}){let n=B(e.sourceDir);return Ce(n.errors,{...t,sourceDir:e.sourceDir}),n}function we(e){let t={description:`Skill names to exclude from sync`};return e.excludeAlias!==void 0&&(t.alias=e.excludeAlias),t}function Te(e){let t={description:`Print install paths and modes`};return e.verbose.alias!==void 0&&(t.alias=e.verbose.alias),t}function G(e,t){return!!e[t]}function Ee(r){function i(e,t){let{skills:n,errors:i}=W(r),o=r.stamp,s=new Set(n.map(e=>e.frontmatter.name)),c=new Set(Ie(o,r.cwd,r.sourceDir)),l=Array.from(new Set(e.exclude)).filter(e=>!s.has(e)&&!c.has(e));if(l.length>0){let e=l.length===1?`Skill`:`Skills`,t=l.map(e=>JSON.stringify(e)).join(`, `);throw Error(`--exclude: ${e} ${t} not found in source directory or among installed skills.\n`+q({source:n,installed:c}))}let u=new Set(e.exclude),d=n.filter(e=>!u.has(e.frontmatter.name)),f=U({skills:n,errors:i},r.sourceDir),p=0;if(!f){let e=new Set(d.map(e=>e.frontmatter.name)),t=/* @__PURE__ */ new Set;for(let e of i)e.path!==r.sourceDir&&(t.add(v(e.path)),e.skillName!==void 0&&t.add(e.skillName));for(let n of c)e.has(n)||u.has(n)||t.has(n)||(Y(n,o,r.cwd,r.sourceDir),p+=1)}let m=0;for(let e of d)J(e,o,r,t),m+=1;if(m===0&&p===0){let e=f?`source directory scan failed; see warnings`:n.length>0&&d.length===0?`all skills excluded`:`no skills bundled`;a.info(`No skills installed (${e}).`)}else a.info(`Sync complete: ${m} installed, ${p} removed.`)}return r.verbose.disabled?e({name:`sync`,description:r.descriptions.sync,args:t({exclude:n.stringArray(we(r))},{unknownKeys:r.unknownKeys}),run(e){i(e,G(e,`verbose`))}}):e({name:`sync`,description:r.descriptions.sync,args:t({exclude:n.stringArray(we(r)),verbose:n.boolean(Te(r))},{unknownKeys:r.unknownKeys}),run(e){i(e,e.verbose)}})}function De(r){let i={positional:!0,description:`Skill name(s) to install (default: all)`,placeholder:`NAME`};function o(e,t){let n=W(r),i=n.skills,o=r.stamp;if(e.name.length>0){let n=new Set(i.map(e=>e.frontmatter.name)),a=Array.from(new Set(e.name)),s=a.filter(e=>!n.has(e));if(s.length>0){let e=s.length===1?`Skill`:`Skills`,t=s.map(e=>JSON.stringify(e)).join(`, `);throw Error(`${e} ${t} not found in source directory.\n`+q({source:i}))}let c=new Set(a);for(let e of i)c.has(e.frontmatter.name)&&J(e,o,r,t)}else if(i.length===0)U(n,r.sourceDir)?a.info(`No skills installed (source directory scan failed; see warnings).`):a.info(`No skills found in source directory.`);else for(let e of i)J(e,o,r,t)}return r.verbose.disabled?e({name:r.commandNames.add.name,...r.commandNames.add.aliases.length>0?{aliases:r.commandNames.add.aliases}:{},description:r.descriptions.add,args:t({name:n.stringArray(i)},{unknownKeys:r.unknownKeys}),run(e){o(e,G(e,`verbose`))}}):e({name:r.commandNames.add.name,...r.commandNames.add.aliases.length>0?{aliases:r.commandNames.add.aliases}:{},description:r.descriptions.add,args:t({name:n.stringArray(i),verbose:n.boolean(Te(r))},{unknownKeys:r.unknownKeys}),run(e){o(e,e.verbose)}})}function Oe(r){return e({name:r.commandNames.remove.name,...r.commandNames.remove.aliases.length>0?{aliases:r.commandNames.remove.aliases}:{},description:r.descriptions.remove,args:t({name:n.optionalString({positional:!0,description:`Skill name to remove (default: all)`,placeholder:`NAME`})},{unknownKeys:r.unknownKeys}),run(e){let t=W(r),n=t.skills,i=r.stamp;if(e.name){if(n.some(t=>t.frontmatter.name===e.name)&&Me(n,e.name),!Y(e.name,i,r.cwd,r.sourceDir)){if(K(e.name,r.cwd))a.info(`${e.name} is installed without a ${A} stamp this CLI recognises; refusing to remove. Remove .agents/skills/${e.name} manually if intended.`);else{let t=new Set(Ie(i,r.cwd,r.sourceDir));a.info(`${e.name} is not installed; nothing to remove.\n`+q({installed:t}))}}return}if(n.length===0){U(t,r.sourceDir)?a.info(`No skills found (source directory scan failed; see warnings); nothing to remove.`):a.info(`No skills found in source directory; nothing to remove.`);return}let o=0;for(let e of n)Y(e.frontmatter.name,i,r.cwd,r.sourceDir)&&(o+=1);o===0&&a.info(`No installed skills owned by this CLI; nothing to remove.`)}})}function ke(e,t,n,r){let i;try{i=L(e,n)}catch(t){return a.warn(`Failed to read ownership for installed skill ${e}: ${Ae(t)}`),`unreadable`}if(i===t)return`installed`;if(i!==null)return`foreign`;if(!I(e,n)){let t=C(n,O,e);return Z(t)&&X(t,r)?`missing`:K(e,n)?`unstamped`:`not-installed`}return`unstamped`}function Ae(e){return e instanceof Error?e.message:String(e)}function K(e,t){try{return c(C(t,O,e)),!0}catch{return!1}}function je(r){function i(e){let t=W(r,{silentStdout:e}),n=t.skills,i=r.stamp;if(e)console.log(JSON.stringify(n.map(e=>({name:e.frontmatter.name,description:e.frontmatter.description,owner:e.frontmatter.metadata?.[`politty-cli`]??null,expectedOwner:i,status:ke(e.frontmatter.name,i,r.cwd,r.sourceDir),sourcePath:e.sourcePath}))));else if(n.length===0)U(t,r.sourceDir)?a.info(`Source directory scan failed; see warnings.`):a.info(`No skills found in source directory.`);else{a.info(`Available skills:`);for(let e of n){let t=ke(e.frontmatter.name,i,r.cwd,r.sourceDir);a.info(` ${e.frontmatter.name.padEnd(20)} ${t.padEnd(14)} ${e.frontmatter.description}`)}}}return r.json.disabled?e({name:`list`,description:r.descriptions.list,args:t({},{unknownKeys:r.unknownKeys}),run(e){i(G(e,`json`))}}):e({name:`list`,description:r.descriptions.list,args:t({json:n.boolean({description:`Output as JSON`})},{unknownKeys:r.unknownKeys}),run(e){i(e.json)}})}function Me(e,t){let n=e.find(e=>e.frontmatter.name===t);if(!n){let n=e.map(e=>e.frontmatter.name).join(`, `)||`<none>`;throw Error(`Skill "${t}" not found in source directory. Available: ${n}`)}return n}function q(e){let t=[];return e.source!==void 0&&t.push(` Source: ${e.source.map(e=>e.frontmatter.name).join(`, `)||`<none>`}`),e.installed!==void 0&&t.push(` Installed: ${[...e.installed].sort().join(`, `)||`<none>`}`),t.join(`
1
+ import"./register-BWzt6u5k.js";import{n as e}from"./command-CCiN78NV.js";import{d as t,f as n,n as r}from"./schema-extractor-Cwg_WAC-.js";import{a as i,n as a}from"./logger-CoeDrmRr.js";import{copyFileSync as o,existsSync as s,lstatSync as c,mkdirSync as l,mkdtempSync as u,readFileSync as d,readdirSync as f,readlinkSync as p,realpathSync as m,renameSync as ee,rmSync as h,statSync as g,symlinkSync as te,unlinkSync as _}from"node:fs";import{basename as v,dirname as y,isAbsolute as b,join as x,parse as ne,relative as S,resolve as C,sep as w}from"node:path";import{z as T}from"zod";import{parse as re}from"yaml";const ie=/^[a-z0-9]+(-[a-z0-9]+)*$/;function E(e){return e===null?`null`:Array.isArray(e)?`array`:typeof e}function ae(e){let t=[],n=(n,r)=>{let i=e[n];i===void 0?r.required&&t.push({path:[n],message:`Invalid input: expected string, received undefined`}):typeof i==`string`?(r.min!==void 0&&i.length<r.min&&t.push({path:[n],message:`Too small: expected string to have >=${r.min} characters`}),r.max!==void 0&&i.length>r.max&&t.push({path:[n],message:`Too big: expected string to have <=${r.max} characters`})):t.push({path:[n],message:`Invalid input: expected string, received ${E(i)}`})};n(`name`,{required:!0,min:1,max:64}),typeof e.name==`string`&&!ie.test(e.name)&&t.push({path:[`name`],message:`name must be lowercase alphanumerics separated by single hyphens`}),n(`description`,{required:!0,min:1,max:1024}),n(`license`,{min:1}),n(`compatibility`,{max:500}),n(`allowed-tools`,{});let r=e.metadata;if(r!==void 0){if(typeof r!=`object`||!r||Array.isArray(r))t.push({path:[`metadata`],message:`Invalid input: expected record, received ${E(r)}`});else for(let[e,n]of Object.entries(r))typeof n!=`string`&&t.push({path:[`metadata`,e],message:`Invalid input: expected string, received ${E(n)}`})}return t.length>0?{success:!1,issues:t}:{success:!0,data:{...e}}}const oe=/^\uFEFF?---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)([\s\S]*)$/;function D(e){let t=e.match(oe);if(!t)return{data:{},body:e};let n=t[1],r=t[2];try{let e=re(n);return se(e)?{data:e,body:r}:{data:{},body:r}}catch(e){return{data:{},body:r,parseError:e instanceof Error?e.message:String(e)}}}function se(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=Object.getPrototypeOf(e);return t===Object.prototype||t===null}function ce(e){let{data:t,body:n}=D(e),r=ae(t);return r.success?{frontmatter:r.data,body:n,rawContent:e}:null}const O=`.agents/skills`,k=[`.claude/skills`],A=`politty-cli`;function j(e){if(e.length<1||e.length>64||!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(e))throw Error(`Invalid skill name: ${JSON.stringify(e)}`)}function le(e,t=process.cwd(),n={}){let r=e.frontmatter.name;j(r);let i=n.mode??`symlink`,a=e.frontmatter.metadata?.[`politty-cli`]??null;if(i===`copy`&&a===null)throw Error(`Refusing to install "${e.frontmatter.name}" in copy mode without an ownership stamp. Add metadata.${A}="{package}:{cli}" to the source SKILL.md so subsequent installs can replace the copy in place.`);let o=C(t,O),s=m(e.sourcePath),c=ue(e.sourcePath),u=[x(N(o),r),...k.map(e=>x(N(C(t,e)),r))].find(e=>ye(e,s));if(u!==void 0)throw Error(`Refusing to install "${r}": source ${s} overlaps install destination ${u}. Choose a sourceDir outside .agents/skills/ and any agent-specific slot directory (e.g. .claude/skills/).`);if(i===`symlink`){let e=N(o);M(x(e,r),S(e,c));for(let n of k){let i=N(C(t,n));M(x(i,r),x(S(i,e),r))}}l(o,{recursive:!0});let d=m(o),f=x(d,r);he(f,a),ge({linkTarget:S(d,c),linkPath:f,copyFrom:s,mode:i}),ve(t,r,f,a,i)}function M(e,t){if(b(t))throw Error(`Refusing to write an absolute symlink target at ${e} → ${t}. The skill source and install root appear to live on different filesystem roots (e.g. different Windows drive letters); retry with mode: "copy".`)}function ue(e){let t=C(e),{root:n}=ne(t),r=t.slice(n.length).split(w).filter(e=>e!==``),i=n;for(let[e,t]of r.entries()){let n=x(i,t),a;try{a=c(n)}catch{return x(i,...r.slice(e))}if(a.isSymbolicLink()){if(de(i))return x(i,...r.slice(e));i=m(n)}else i=n}return i}function de(e){return v(e)===`node_modules`||v(e).startsWith(`@`)&&v(y(e))===`node_modules`}function N(e){let t=e,n=[];for(;;)try{let e=m(t);return n.length===0?e:C(e,...n.reverse())}catch{let r=y(t);if(r===t)return e;n.push(t.slice(r.length).replace(/^[/\\]+/,``)),t=r}}function fe(e,t=process.cwd(),n={}){j(e);let r=n.expectedOwnership??null,i=C(t,O,e);for(let n of k)me(C(t,n,e),r,{restrictSymlinkTo:i});me(i,r)}function pe(e,t){let n;try{n=p(e)}catch{return!1}let r=b(n)?n:C(y(e),n);if(r===t)return!0;try{return m(r)===m(t)}catch{return!1}}function me(e,t,n={}){let r;try{r=c(e)}catch(e){if(R(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return;throw e}if(r.isSymbolicLink()){if(n.restrictSymlinkTo!==void 0){pe(e,n.restrictSymlinkTo)&&_(e);return}(t===null||F(e)===t)&&_(e)}else r.isDirectory()&&t!==null&&F(e)===t&&h(e,{recursive:!0,force:!0})}function he(e,t,n={}){let r;try{r=c(e)}catch(e){if(R(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return;throw e}if(r.isSymbolicLink()){if(n.restrictSymlinkTo===void 0||pe(e,n.restrictSymlinkTo)){_(e);return}throw Error(`Refusing to replace symlink at ${e}: it does not route to this CLI's canonical slot (${n.restrictSymlinkTo}). Remove or migrate the foreign symlink before retrying.`)}if(r.isDirectory()&&t!==null&&F(e)===t)h(e,{recursive:!0,force:!0});else throw Error(`Refusing to replace non-symlink path at ${e}. This looks like a legacy or manual install; remove or migrate it before retrying.`)}function ge(e){let{linkTarget:t,linkPath:n,copyFrom:r,mode:i}=e;if(i===`copy`)_e(r,n);else{M(n,t);try{te(t,n,`dir`)}catch(e){let r=e instanceof Error?e.message:String(e);throw Error(`Failed to symlink ${n} → ${t}: ${r}. If this filesystem does not support symlinks (e.g. Windows without Developer Mode), retry with mode: "copy".`,{cause:e})}}}function _e(e,t){let n=u(`${t}.partial-`);try{P(e,n),ee(n,t)}catch(e){try{h(n,{recursive:!0,force:!0})}catch{}throw e}}function P(e,t,n=/* @__PURE__ */ new Set){let r=g(e);if(r.isDirectory()){let r=m(e);if(n.has(r))throw Error(`Refusing to recursively copy cyclic directory symlink at ${e} (resolves to ${r}, already on the copy stack).`);n.add(r);try{l(t,{recursive:!0});for(let r of f(e))P(x(e,r),x(t,r),n)}finally{n.delete(r)}}else r.isFile()&&o(e,t)}function F(e){let t;try{t=d(x(e,`SKILL.md`),`utf-8`)}catch(e){if(R(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return null;throw e}let{data:n}=D(t),r=n.metadata;if(!r||typeof r!=`object`||Array.isArray(r))return null;let i=r[A];return typeof i==`string`?i:null}function I(e,t=process.cwd()){return j(e),s(C(t,O,e,`SKILL.md`))}function L(e,t=process.cwd()){j(e);let n=C(t,O,e,`SKILL.md`),r;try{r=d(n,`utf-8`)}catch(e){if(R(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return null;throw e}let{data:i}=D(r),a=i.metadata;if(!a||typeof a!=`object`||Array.isArray(a))return null;let o=a[A];return typeof o==`string`?o:null}function ve(e,t,n,r,i){for(let a of k){let o=C(e,a);l(o,{recursive:!0});let s=m(o),c=x(s,t);he(c,r,{restrictSymlinkTo:n});let u=m(C(n,`..`));ge({linkTarget:x(S(s,u),t),linkPath:c,copyFrom:n,mode:i})}}function R(e){return e instanceof Error&&typeof e.code==`string`}function ye(e,t){if(e===t)return!0;let n=(e,t)=>{let n=S(t,e);return n===``||n===`.`||!b(n)&&n!==`..`&&!n.startsWith(`..${w}`)};return n(e,t)||n(t,e)}const z=`SKILL.md`;function B(e){let t=[],n=[];try{let r;try{r=g(e)}catch(r){return H(r)&&(r.code===`ENOENT`||r.code===`ENOTDIR`)?n.push({path:e,reason:`missing-source`,message:`Source directory does not exist: ${e}`}):n.push({path:e,reason:`read-failed`,message:`Failed to stat source directory ${e}: ${V(r)}`}),{skills:t,errors:n}}if(!r.isDirectory())return n.push({path:e,reason:`missing-source`,message:`Source path is not a directory: ${e}`}),{skills:t,errors:n};let i=x(e,z),a=Se(i);if(a.kind===`error`)return n.push({path:e,reason:`read-failed`,message:`Failed to check ${i}: ${a.message}`}),{skills:t,errors:n};if(a.kind===`present`)return xe(be(e,{enforceParentMatch:!1}),t,n),{skills:t,errors:n};let o=f(e,{withFileTypes:!0});for(let r of o){let i=x(e,r.name),a;try{a=g(i).isDirectory()}catch(e){if(H(e)&&e.code===`ENOENT`&&!r.isSymbolicLink())continue;n.push({path:i,reason:`read-failed`,message:r.isSymbolicLink()?`Dangling symlink at ${i}: ${V(e)}`:`Failed to stat ${i}: ${V(e)}`});continue}if(!a)continue;let o=x(i,z),s=Se(o);s.kind===`error`?n.push({path:i,reason:`read-failed`,message:`Failed to check ${o}: ${s.message}`}):s.kind!==`absent`&&xe(be(i,{enforceParentMatch:!0}),t,n)}}catch(t){n.push({path:e,reason:`read-failed`,message:`Failed to scan ${e}: ${V(t)}`})}return t.sort((e,t)=>e.frontmatter.name<t.frontmatter.name?-1:+(e.frontmatter.name>t.frontmatter.name)),{skills:t,errors:n}}function be(e,t){let n=x(e,z),r;try{r=d(n,`utf-8`)}catch(t){return{path:e,reason:`read-failed`,message:`Failed to read ${n}: ${V(t)}`}}let{data:i,parseError:a}=D(r);if(a!==void 0)return{path:e,reason:`parse-failed`,message:`Invalid SKILL.md frontmatter in ${e}: YAML parse error: ${a}`};let o=ae(i);if(!o.success)return{path:e,reason:`parse-failed`,message:`Invalid SKILL.md frontmatter in ${e}: ${o.issues.map(e=>`${e.path.join(`.`)||`<root>`}: ${e.message}`).join(`; `)}`};if(t.enforceParentMatch){let t=v(e);if(t!==o.data.name)return{path:e,reason:`name-mismatch`,message:`Skill name "${o.data.name}" does not match directory "${t}"`,skillName:o.data.name}}return{frontmatter:o.data,sourcePath:e,rawContent:r}}function xe(e,t,n){`frontmatter`in e?t.push(e):n.push(e)}function V(e){return e instanceof Error?e.message:String(e)}function H(e){return e instanceof Error&&typeof e.code==`string`}function Se(e){try{return c(e),{kind:`present`}}catch(e){return H(e)&&e.code===`ENOENT`?{kind:`absent`}:{kind:`error`,message:V(e)}}}function Ce(e,t={}){let n=0,r=!1;for(let i of e)i.reason===`missing-source`||i.path===t.sourceDir?(r=!0,a.warn(`Failed to scan source directory ${i.path}: ${i.message}`)):(n+=1,a.warn(`Skipping skill at ${i.path}: ${i.message}`));t.silentStdout||(n>0&&a.info(`${i.warning} Skipped ${n} skill(s) due to scan errors (see warnings above).`),r&&a.info(`${i.warning} Source directory scan failed (see warnings above); subsequent operations may be skipped.`))}function U(e,t){let n=e.errors.some(e=>e.reason===`missing-source`||e.path===t),r=e.errors.length>0&&e.skills.length===0;return n||r}function W(e,t={}){let n=B(e.sourceDir);return Ce(n.errors,{...t,sourceDir:e.sourceDir}),n}function we(e){let t={description:`Skill names to exclude from sync`};return e.excludeAlias!==void 0&&(t.alias=e.excludeAlias),t}function Te(e){let t={description:`Print install paths and modes`};return e.verbose.alias!==void 0&&(t.alias=e.verbose.alias),t}function G(e,t){return!!e[t]}function Ee(r){function i(e,t){let{skills:n,errors:i}=W(r),o=r.stamp,s=new Set(n.map(e=>e.frontmatter.name)),c=new Set(Ie(o,r.cwd,r.sourceDir)),l=Array.from(new Set(e.exclude)).filter(e=>!s.has(e)&&!c.has(e));if(l.length>0){let e=l.length===1?`Skill`:`Skills`,t=l.map(e=>JSON.stringify(e)).join(`, `);throw Error(`--exclude: ${e} ${t} not found in source directory or among installed skills.\n`+q({source:n,installed:c}))}let u=new Set(e.exclude),d=n.filter(e=>!u.has(e.frontmatter.name)),f=U({skills:n,errors:i},r.sourceDir),p=0;if(!f){let e=new Set(d.map(e=>e.frontmatter.name)),t=/* @__PURE__ */ new Set;for(let e of i)e.path!==r.sourceDir&&(t.add(v(e.path)),e.skillName!==void 0&&t.add(e.skillName));for(let n of c)e.has(n)||u.has(n)||t.has(n)||(Y(n,o,r.cwd,r.sourceDir),p+=1)}let m=0;for(let e of d)J(e,o,r,t),m+=1;if(m===0&&p===0){let e=f?`source directory scan failed; see warnings`:n.length>0&&d.length===0?`all skills excluded`:`no skills bundled`;a.info(`No skills installed (${e}).`)}else a.info(`Sync complete: ${m} installed, ${p} removed.`)}return r.verbose.disabled?e({name:`sync`,description:r.descriptions.sync,args:t({exclude:n.stringArray(we(r))},{unknownKeys:r.unknownKeys}),run(e){i(e,G(e,`verbose`))}}):e({name:`sync`,description:r.descriptions.sync,args:t({exclude:n.stringArray(we(r)),verbose:n.boolean(Te(r))},{unknownKeys:r.unknownKeys}),run(e){i(e,e.verbose)}})}function De(r){let i={positional:!0,description:`Skill name(s) to install (default: all)`,placeholder:`NAME`};function o(e,t){let n=W(r),i=n.skills,o=r.stamp;if(e.name.length>0){let n=new Set(i.map(e=>e.frontmatter.name)),a=Array.from(new Set(e.name)),s=a.filter(e=>!n.has(e));if(s.length>0){let e=s.length===1?`Skill`:`Skills`,t=s.map(e=>JSON.stringify(e)).join(`, `);throw Error(`${e} ${t} not found in source directory.\n`+q({source:i}))}let c=new Set(a);for(let e of i)c.has(e.frontmatter.name)&&J(e,o,r,t)}else if(i.length===0)U(n,r.sourceDir)?a.info(`No skills installed (source directory scan failed; see warnings).`):a.info(`No skills found in source directory.`);else for(let e of i)J(e,o,r,t)}return r.verbose.disabled?e({name:r.commandNames.add.name,...r.commandNames.add.aliases.length>0?{aliases:r.commandNames.add.aliases}:{},description:r.descriptions.add,args:t({name:n.stringArray(i)},{unknownKeys:r.unknownKeys}),run(e){o(e,G(e,`verbose`))}}):e({name:r.commandNames.add.name,...r.commandNames.add.aliases.length>0?{aliases:r.commandNames.add.aliases}:{},description:r.descriptions.add,args:t({name:n.stringArray(i),verbose:n.boolean(Te(r))},{unknownKeys:r.unknownKeys}),run(e){o(e,e.verbose)}})}function Oe(r){return e({name:r.commandNames.remove.name,...r.commandNames.remove.aliases.length>0?{aliases:r.commandNames.remove.aliases}:{},description:r.descriptions.remove,args:t({name:n.optionalString({positional:!0,description:`Skill name to remove (default: all)`,placeholder:`NAME`})},{unknownKeys:r.unknownKeys}),run(e){let t=W(r),n=t.skills,i=r.stamp;if(e.name){if(n.some(t=>t.frontmatter.name===e.name)&&Me(n,e.name),!Y(e.name,i,r.cwd,r.sourceDir)){if(K(e.name,r.cwd))a.info(`${e.name} is installed without a ${A} stamp this CLI recognises; refusing to remove. Remove .agents/skills/${e.name} manually if intended.`);else{let t=new Set(Ie(i,r.cwd,r.sourceDir));a.info(`${e.name} is not installed; nothing to remove.\n`+q({installed:t}))}}return}if(n.length===0){U(t,r.sourceDir)?a.info(`No skills found (source directory scan failed; see warnings); nothing to remove.`):a.info(`No skills found in source directory; nothing to remove.`);return}let o=0;for(let e of n)Y(e.frontmatter.name,i,r.cwd,r.sourceDir)&&(o+=1);o===0&&a.info(`No installed skills owned by this CLI; nothing to remove.`)}})}function ke(e,t,n,r){let i;try{i=L(e,n)}catch(t){return a.warn(`Failed to read ownership for installed skill ${e}: ${Ae(t)}`),`unreadable`}if(i===t)return`installed`;if(i!==null)return`foreign`;if(!I(e,n)){let t=C(n,O,e);return Z(t)&&X(t,r)?`missing`:K(e,n)?`unstamped`:`not-installed`}return`unstamped`}function Ae(e){return e instanceof Error?e.message:String(e)}function K(e,t){try{return c(C(t,O,e)),!0}catch{return!1}}function je(r){function i(e){let t=W(r,{silentStdout:e}),n=t.skills,i=r.stamp;if(e)console.log(JSON.stringify(n.map(e=>({name:e.frontmatter.name,description:e.frontmatter.description,owner:e.frontmatter.metadata?.[`politty-cli`]??null,expectedOwner:i,status:ke(e.frontmatter.name,i,r.cwd,r.sourceDir),sourcePath:e.sourcePath}))));else if(n.length===0)U(t,r.sourceDir)?a.info(`Source directory scan failed; see warnings.`):a.info(`No skills found in source directory.`);else{a.info(`Available skills:`);for(let e of n){let t=ke(e.frontmatter.name,i,r.cwd,r.sourceDir);a.info(` ${e.frontmatter.name.padEnd(20)} ${t.padEnd(14)} ${e.frontmatter.description}`)}}}return r.json.disabled?e({name:`list`,description:r.descriptions.list,args:t({},{unknownKeys:r.unknownKeys}),run(e){i(G(e,`json`))}}):e({name:`list`,description:r.descriptions.list,args:t({json:n.boolean({description:`Output as JSON`})},{unknownKeys:r.unknownKeys}),run(e){i(e.json)}})}function Me(e,t){let n=e.find(e=>e.frontmatter.name===t);if(!n){let n=e.map(e=>e.frontmatter.name).join(`, `)||`<none>`;throw Error(`Skill "${t}" not found in source directory. Available: ${n}`)}return n}function q(e){let t=[];return e.source!==void 0&&t.push(` Source: ${e.source.map(e=>e.frontmatter.name).join(`, `)||`<none>`}`),e.installed!==void 0&&t.push(` Installed: ${[...e.installed].sort().join(`, `)||`<none>`}`),t.join(`
2
2
  `)}function J(e,t,n,r){let o=e.frontmatter.name,s=n.cwd,c=n.mode,l=e.frontmatter.metadata?.[`politty-cli`]??null;if(l!==t)throw Error(`Refusing to install "${o}": source SKILL.md declares metadata.${A}=${JSON.stringify(l)}, expected ${JSON.stringify(t)}.`);let u=L(o,s);if(u!==null&&u!==t)throw Error(`Refusing to install "${o}": owned by ${JSON.stringify(u)}, not ${JSON.stringify(t)}. Check metadata.${A} in .agents/skills/${o}/SKILL.md.`);let d=C(s,O,o),f=Z(d)&&X(d,n.sourceDir);if(u===null&&K(o,s)&&!f)throw Error(`Refusing to install "${o}": .agents/skills/${o} exists without a ${A} stamp, so it was not installed by this CLI. Remove it manually (or add the stamp to take ownership) before running "skills add".`);if(le(e,s,c===void 0?{}:{mode:c}),a.info(`${i.success} Installed ${o}`),r){let e=c??`symlink`;a.info(` mode=${e} path=${d}`)}}function Y(e,t,n,r){let o=L(e,n);if(o===null)return Ne(e,n,r)?(a.info(`${i.success} Removed ${e} (broken symlink)`),!0):!1;if(o!==t)throw Error(`Refusing to remove "${e}": owned by ${JSON.stringify(o)}, not ${JSON.stringify(t)}. Check metadata.${A} in .agents/skills/${e}/SKILL.md.`);return fe(e,n,{expectedOwnership:t}),a.info(`${i.success} Removed ${e}`),!0}function Ne(e,t,n){let r=C(t,O,e);if(!Z(r)||!X(r,n))return!1;for(let n of k){let i=C(t,n,e);Z(i)&&Fe(i,r)&&_(i)}return _(r),!0}function X(e,t){let n;try{n=p(e)}catch{return!1}let r=b(n)?n:C(y(e),n),i=Pe(C(t)),a=Pe(r),o=S(i,a);return!(b(o)||o===`..`||o.startsWith(`..${w}`))}function Pe(e){let t=e,n=[];for(;;)try{let e=m(t);return n.length===0?e:C(e,...n.reverse())}catch{let r=y(t);if(r===t)return e;n.push(t.slice(r.length).replace(/^[/\\]+/,``)),t=r}}function Fe(e,t){let n;try{n=p(e)}catch{return!1}let r=b(n)?n:C(y(e),n);if(r===t)return!0;try{return m(r)===m(t)}catch{return!1}}function Z(e){let t;try{t=c(e)}catch{return!1}return t.isSymbolicLink()?!s(e):!1}function Ie(e,t,n){let r=C(t,O),i=[],o;try{o=f(r,{withFileTypes:!0})}catch(e){let t=e.code;return t===`ENOENT`||t===`ENOTDIR`||a.warn(`Failed to enumerate ${r}: ${e instanceof Error?e.message:String(e)}`),i}for(let s of o){if(!s.isDirectory()&&!s.isSymbolicLink()||s.name.length<1||s.name.length>64||!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(s.name))continue;let o;try{o=L(s.name,t)}catch(e){a.warn(`Failed to read ownership for ${s.name}: ${e instanceof Error?e.message:String(e)}`);continue}if(o===e){i.push(s.name);continue}let c=C(r,s.name);o===null&&Z(c)&&X(c,n)&&i.push(s.name)}return i}const Le=[`add`,`install`],Re=[`remove`,`uninstall`],Q={skills:`Manage agent skills`,sync:`Remove and reinstall all skills from source`,add:`Install skills from source`,remove:`Remove installed skills`,list:`List available skills from source`},ze=/^[a-zA-Z0-9][a-zA-Z0-9_-]*$/,Be=[`.git`,`package.json`];function Ve(e,t){return{sourceDir:e.sourceDir,package:e.package,mode:e.mode,cwd:Ue(e.cwd),excludeAlias:Ge(e.flags?.exclude?.alias),verbose:qe(e.flags?.verbose,e.globalArgs),json:{disabled:$(e.globalArgs,`json`)},commandNames:{add:Ke(e.commandMap?.add,Le,`add`),remove:Ke(e.commandMap?.remove,Re,`remove`)},unknownKeys:e.unknownKeys??`strip`,descriptionAppend:Je(e.descriptionAppend,t),stamp:`${e.package}:${t}`,descriptions:He(e.descriptions)}}function He(e){return{skills:e?.skills??Q.skills,sync:e?.sync??Q.sync,add:e?.add??Q.add,remove:e?.remove??Q.remove,list:e?.list??Q.list}}function Ue(e){if(e!==void 0)return C(e);let t=process.cwd();return We(t)??t}function We(e){let t=C(e);for(;;){for(let e of Be)if(s(C(t,e)))return t;let e=y(t);if(e===t)return null;t=e}}function Ge(e){if(e!==!1)return typeof e==`string`?e:`x`}function Ke(e,t,n){let r=e??t;if(r.length===0)throw Error(`SkillCommandOptions.commandMap.${n} must include at least one name.`);let i=r.find(e=>!ze.test(e));if(i!==void 0)throw Error(`SkillCommandOptions.commandMap.${n} contains an invalid entry ${JSON.stringify(i)}. Names/aliases must start with an alphanumeric character and contain only alphanumeric characters, hyphens, or underscores.`);return{name:r[0],aliases:r.slice(1)}}function qe(e,t){return{alias:e?.alias===!1?void 0:e?.alias??`v`,disabled:$(t,`verbose`)}}function $(e,t){return e?r(e).fields.some(e=>e.name===t&&e.named&&e.type===`boolean`):!1}function Je(e,t){return e===!1?!1:typeof e==`string`?e:`Manage agent skills with \`${t} skills <add|sync|remove|list>\`.`}const Ye=[`parse-failed`,`name-mismatch`,`read-failed`,`missing-source`];function Xe(t,n){if(t.subCommands&&Object.hasOwn(t.subCommands,`skills`))throw Error(`withSkillCommand: command "${t.name}" already defines a "skills" subcommand.`);let r=Ve(n,t.name),i=r.commandNames.add.name,a=r.commandNames.remove.name,o=[`sync`,`list`,i,...r.commandNames.add.aliases,a,...r.commandNames.remove.aliases],s=o.find((e,t)=>o.indexOf(e)!==t);if(s)throw Error(`withSkillCommand: commandMap produced duplicate subcommand name/alias "${s}".`);let c=e({name:`skills`,description:r.descriptions.skills,subCommands:{sync:Ee(r),[i]:De(r),[a]:Oe(r),list:je(r)}});return{...t,description:Ze(t.description,r.descriptionAppend),subCommands:{...t.subCommands,skills:c}}}function Ze(e,t){return t===!1||t===``?e:e?e.endsWith(t)?e:`${e}\n\n${t}`:t}const Qe=T.object({name:T.string().min(1).max(64).regex(/^[a-z0-9]+(-[a-z0-9]+)*$/,{message:`name must be lowercase alphanumerics separated by single hyphens`}),description:T.string().min(1).max(1024),license:T.string().min(1).optional(),compatibility:T.string().max(500).optional(),metadata:T.record(T.string(),T.string()).optional(),"allowed-tools":T.string().optional()}).passthrough();export{A as OWNERSHIP_METADATA_KEY,Ye as SCAN_ERROR_REASONS,I as hasInstalledSkill,le as installSkill,D as parseFrontmatter,ce as parseSkillMd,L as readInstalledOwnership,B as scanSourceDir,Qe as skillFrontmatterSchema,fe as uninstallSkill,Xe as withSkillCommand};
@@ -1,4 +1,4 @@
1
- import { C as AnyCommand, T as ArgsSchema, h as ResolvedExpandCandidate, it as UnknownKeysMode, n as ArgMeta, y as DynamicCompletionResolver } from "./arg-registry-biPCZomY.js";
1
+ import { C as AnyCommand, T as ArgsSchema, h as ResolvedExpandCandidate, it as UnknownKeysMode, n as ArgMeta, y as DynamicCompletionResolver } from "./arg-registry-DNUJtjsZ.js";
2
2
  /** Runtime brand distinguishing internal descriptors from library schemas. */
3
3
  declare const INTERNAL_ARGS_BRAND = "__polittyInternalArgs";
4
4
  type InternalFieldKind = "string" | "boolean" | "enum" | "string-array";
@@ -1,3 +1,3 @@
1
- import{n as e}from"./command-BXsTrIgI.js";import{s as t}from"./subcommand-router-CfCW9eG4.js";import{t as n}from"./schema-BF9YOHU0.js";import{d as r,f as i}from"./schema-extractor-Cwg_WAC-.js";import{existsSync as a,readFileSync as o}from"node:fs";import{join as s}from"node:path";import{spawn as c}from"node:child_process";function l(){let e=(process.env.SHELL||``).split(`/`).pop()?.toLowerCase()||``;return e.includes(`bash`)?`bash`:e.includes(`zsh`)?`zsh`:e.includes(`fish`)?`fish`:null}function u(e){return`${process.env.XDG_CACHE_HOME??`${process.env.HOME??``}/.cache`}/${e}`}function d(e,t,n){if(t===`fish`){let t=process.env.XDG_CONFIG_HOME??`${process.env.HOME??``}/.config`;return s(t,`fish`,`completions`,`${e}.fish`)}let r=n??u(e);return s(r,`completion.${t}`)}function f(e){try{if(!a(e))return null;let t=o(e,`utf8`).split(`
1
+ import{n as e}from"./command-CCiN78NV.js";import{s as t}from"./subcommand-router-CfCW9eG4.js";import{t as n}from"./schema-BF9YOHU0.js";import{d as r,f as i}from"./schema-extractor-Cwg_WAC-.js";import{existsSync as a,readFileSync as o}from"node:fs";import{join as s}from"node:path";import{spawn as c}from"node:child_process";function l(){let e=(process.env.SHELL||``).split(`/`).pop()?.toLowerCase()||``;return e.includes(`bash`)?`bash`:e.includes(`zsh`)?`zsh`:e.includes(`fish`)?`fish`:null}function u(e){return`${process.env.XDG_CACHE_HOME??`${process.env.HOME??``}/.cache`}/${e}`}function d(e,t,n){if(t===`fish`){let t=process.env.XDG_CONFIG_HOME??`${process.env.HOME??``}/.config`;return s(t,`fish`,`completions`,`${e}.fish`)}let r=n??u(e);return s(r,`completion.${t}`)}function f(e){try{if(!a(e))return null;let t=o(e,`utf8`).split(`
2
2
  `,6).join(`
3
- `).match(/^# politty-bin-sig: (\S+)/m);return t?t[1]:null}catch{return null}}function p(e,t){return f(d(e.programName,t,e.cacheDir))!==null}function m(e,t){try{c(process.execPath,[e,`__refresh-completion`,t],{detached:!0,stdio:`ignore`}).unref()}catch{}}const h=r({shell:i.optionalEnum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell type (bash, zsh, or fish)`,placeholder:`SHELL`}),instructions:i.boolean({alias:`i`,description:`Show installation instructions`}),loader:i.boolean({description:`Print just the rc loader snippet (bash/zsh). Add it to ~/.bashrc or ~/.zshrc; it auto-regenerates the cache when the binary changes.`}),install:i.boolean({description:`Write the completion script to its on-disk cache (bash/zsh) or autoload location (fish) instead of printing it.`}),static:i.boolean({description:`Generate the legacy static completion script with command metadata baked in.`}),dispatcher:i.boolean({description:`Generate the runtime dispatcher completion script. This is the default.`}),worker:i.boolean({description:`Generate an internal static worker artifact for dispatcher mode.`})}),g=r({shell:i.enum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell to refresh`,placeholder:`SHELL`}),target:i.optionalString({positional:!0,description:`Existing politty-generated completion file to refresh`,placeholder:`TARGET`}),static:i.boolean({description:`Refresh using the legacy static completion script mode.`}),worker:i.boolean({description:`Refresh an internal static worker completion script.`})}),_=r({shell:i.enum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell worker to locate`,placeholder:`SHELL`})});function v(r,i){let{programName:a,globalArgsSchema:o,cacheDir:s,programVersion:c,bundledWorker:l}=typeof i==`string`?{programName:i}:i??{},u=a??r.name,d={...s!==void 0&&{cacheDir:s},...c!==void 0&&{programVersion:c},...o!==void 0&&{globalArgsSchema:o},...l!==void 0&&{bundledWorker:l}},f={...r};return f.subCommands={...r.subCommands,completion:t(e({name:`completion`,description:`Generate shell completion script`,args:h,run(){}}),()=>import(`./completion-CqEkkWNL.js`).then(e=>e.createCompletionCommand(f,a,o,d))),__complete:t(e({name:`__complete`,args:n,run(){}}),()=>import(`./dynamic-CObt4Ul5.js`).then(e=>e.createDynamicCompleteCommand(f,a,o))),"__refresh-completion":t(e({name:`__refresh-completion`,description:`(internal) Refresh the on-disk completion cache if stale.`,args:g,run(){}}),()=>import(`./completion-CqEkkWNL.js`).then(e=>e.createRefreshCompletionCommand(f,u,d))),"__completion-worker-path":t(e({name:`__completion-worker-path`,description:`(internal) Print the bundled completion worker path when available.`,args:_,run(){}}),()=>import(`./completion-CqEkkWNL.js`).then(e=>e.createCompletionWorkerPathCommand(u,d)))},f.runMainHook=e=>{y(e,{programName:u,...s!==void 0&&{cacheDir:s}})},f}function y(e,t){if(process.env.POLITTY_NO_COMPLETION_REFRESH)return;let n=e.find(e=>!e.startsWith(`-`));if(n===`__complete`||n===`__refresh-completion`||n===`__completion-worker-path`||n===`completion`)return;let r=l();if(!r)return;let i=process.argv[1];i&&p(t,r)&&m(i,r)}export{d as a,_ as i,h as n,f as o,g as r,l as s,v as t};
3
+ `).match(/^# politty-bin-sig: (\S+)/m);return t?t[1]:null}catch{return null}}function p(e,t){return f(d(e.programName,t,e.cacheDir))!==null}function m(e,t){try{c(process.execPath,[e,`__refresh-completion`,t],{detached:!0,stdio:`ignore`}).unref()}catch{}}const h=r({shell:i.optionalEnum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell type (bash, zsh, or fish)`,placeholder:`SHELL`}),instructions:i.boolean({alias:`i`,description:`Show installation instructions`}),loader:i.boolean({description:`Print just the rc loader snippet (bash/zsh). Add it to ~/.bashrc or ~/.zshrc; it auto-regenerates the cache when the binary changes.`}),install:i.boolean({description:`Write the completion script to its on-disk cache (bash/zsh) or autoload location (fish) instead of printing it.`}),static:i.boolean({description:`Generate the legacy static completion script with command metadata baked in.`}),dispatcher:i.boolean({description:`Generate the runtime dispatcher completion script. This is the default.`}),worker:i.boolean({description:`Generate an internal static worker artifact for dispatcher mode.`})}),g=r({shell:i.enum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell to refresh`,placeholder:`SHELL`}),target:i.optionalString({positional:!0,description:`Existing politty-generated completion file to refresh`,placeholder:`TARGET`}),static:i.boolean({description:`Refresh using the legacy static completion script mode.`}),worker:i.boolean({description:`Refresh an internal static worker completion script.`})}),_=r({shell:i.enum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell worker to locate`,placeholder:`SHELL`})});function v(r,i){let{programName:a,globalArgsSchema:o,cacheDir:s,programVersion:c,bundledWorker:l}=typeof i==`string`?{programName:i}:i??{},u=a??r.name,d={...s!==void 0&&{cacheDir:s},...c!==void 0&&{programVersion:c},...o!==void 0&&{globalArgsSchema:o},...l!==void 0&&{bundledWorker:l}},f={...r};return f.subCommands={...r.subCommands,completion:t(e({name:`completion`,description:`Generate shell completion script`,args:h,run(){}}),()=>import(`./completion-Bbe2Q4Y-.js`).then(e=>e.createCompletionCommand(f,a,o,d))),__complete:t(e({name:`__complete`,args:n,run(){}}),()=>import(`./dynamic-BiCSjFGx.js`).then(e=>e.createDynamicCompleteCommand(f,a,o))),"__refresh-completion":t(e({name:`__refresh-completion`,description:`(internal) Refresh the on-disk completion cache if stale.`,args:g,run(){}}),()=>import(`./completion-Bbe2Q4Y-.js`).then(e=>e.createRefreshCompletionCommand(f,u,d))),"__completion-worker-path":t(e({name:`__completion-worker-path`,description:`(internal) Print the bundled completion worker path when available.`,args:_,run(){}}),()=>import(`./completion-Bbe2Q4Y-.js`).then(e=>e.createCompletionWorkerPathCommand(u,d)))},f.runMainHook=e=>{y(e,{programName:u,...s!==void 0&&{cacheDir:s}})},f}function y(e,t){if(process.env.POLITTY_NO_COMPLETION_REFRESH)return;let n=e.find(e=>!e.startsWith(`-`));if(n===`__complete`||n===`__refresh-completion`||n===`__completion-worker-path`||n===`completion`)return;let r=l();if(!r)return;let i=process.argv[1];i&&p(t,r)&&m(i,r)}export{d as a,_ as i,h as n,f as o,g as r,l as s,v as t};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@politty/zod",
3
- "version": "0.7.4",
3
+ "version": "0.7.6",
4
4
  "description": "A lightweight CLI framework inspired by citty with zod v4 registry integration for type-safe metadata management",
5
5
  "keywords": [
6
6
  "argument-parser",
@@ -1 +0,0 @@
1
- export{t as runPolittyCli}from"./cli-main-wqT-qsdF.js";
@@ -1 +0,0 @@
1
- import"./with-completion-command-BojrmP1a.js";import"./dynamic-RKGUiswZ.js";export{t as createCompletionCommand,n as createCompletionWorkerPathCommand,r as createRefreshCompletionCommand,c as generateBundledCompletionWorker}from"./completion-DdSxJx-7.js";
@@ -1 +0,0 @@
1
- export{t as createDynamicCompleteCommand}from"./dynamic-RKGUiswZ.js";
@@ -1,33 +0,0 @@
1
- import{d as e,h as t,i as n,m as r,n as i,p as a,u as o}from"./unflatten-DVeO9OZ_.js";import{t as s}from"./detect-agent-D7KSeWMh.js";import{n as c}from"./compile-cache-6u9hgeWu.js";import{a as l,c as u,f as d,i as f,l as p,n as m,o as h,r as g,t as _,u as v}from"./subcommand-router-CfCW9eG4.js";import{n as y,r as b,t as x}from"./log-collector-uhRWYT-z.js";import{a as S,c as C,l as ee,m as w,n as T,o as E,p as D,r as O,s as k,t as A,u as te}from"./schema-extractor-Cwg_WAC-.js";import{a as j,i as M}from"./logger-CoeDrmRr.js";import{a as N,c as ne,d as re,i as P,l as ie,n as F,o as I,r as ae,s as L,t as R}from"./argv-parser-bI3e6XXA.js";import*as z from"node:fs";import*as oe from"node:path";import{isDeepStrictEqual as se,parseEnv as ce,stripVTControlCharacters as le}from"node:util";async function ue(e,t,n={}){let r,a,o=n.captureLogs??!1?x():null;o?.start();let s={args:t},c={args:t,error:r},l;n.handleSignals&&(l=async t=>{l&&(process.off(`SIGINT`,l),process.off(`SIGTERM`,l));let r=/* @__PURE__ */ Error(`Process interrupted`);if(c.error=r,e.cleanup)try{await e.cleanup(c)}catch(e){console.error(`Error during signal cleanup:`,e)}if(n.globalCleanup)try{await n.globalCleanup({error:r})}catch(e){console.error(`Error during global signal cleanup:`,e)}o?.stop(),process.stdout.writableNeedDrain&&await new Promise(e=>{let t=setTimeout(()=>{process.stdout.off(`drain`,n),e()},200),n=()=>{clearTimeout(t),e()};process.stdout.once(`drain`,n)}),process.exit(1)},process.on(`SIGINT`,l),process.on(`SIGTERM`,l));try{e.requiredPackages?.length&&await d(e.requiredPackages,t);let r=typeof t==`object`&&t?t:{};for(let e of n.packageFields??[])e.requiredPackages?.length&&(e.nested?i(r,e)!==void 0:e.name in r)&&(n.packageDiscriminators?.includes(e.name)||i(r,e)===!0)&&await d(e.requiredPackages,t);e.setup&&await e.setup(s),e.run&&(a=await e.run(t))}catch(e){r=e instanceof Error?e:Error(String(e))}finally{l&&(process.off(`SIGINT`,l),process.off(`SIGTERM`,l))}if(e.cleanup){c.error=r;try{await e.cleanup(c)}catch(e){r||=e instanceof Error?e:Error(String(e))}}o?.stop();let u=n.existingLogs??y(),f=o?.getLogs()??y(),p=b(u,f);return r?{success:!1,error:r,exitCode:1,logs:p}:{success:!0,result:a,exitCode:0,logs:p}}function de(e){return e<=31||e>=127&&e<=159||e>=768&&e<=879||e>=6832&&e<=6911||e>=7616&&e<=7679||e>=8400&&e<=8447||e>=65056&&e<=65071||e===8203||e>=8204&&e<=8207||e===65279||e>=65024&&e<=65039||e>=917760&&e<=917999}function fe(e){return e>=4352&&e<=4447||e>=11904&&e<=12350||e>=12353&&e<=13311||e>=13312&&e<=19903||e>=19968&&e<=40959||e>=40960&&e<=42191||e>=43360&&e<=43391||e>=44032&&e<=55203||e>=63744&&e<=64255||e>=65040&&e<=65049||e>=65072&&e<=65135||e>=65280&&e<=65376||e>=65504&&e<=65510||e>=110592&&e<=110959||e>=127488&&e<=127569||e>=131072&&e<=262141||e>=9728&&e<=10175||e>=126976&&e<=129791}function pe(e){let t=!1,n=!1,r=!1;for(let i of e){let e=i.codePointAt(0);e===65039?r=!0:de(e)||(t=!0,fe(e)&&(n=!0))}return t?n||r?2:1:0}const me=(()=>{try{return new Intl.Segmenter(`en`,{granularity:`grapheme`})}catch{return}})();function he(e){if(e.length===0)return 0;let t=e.includes(`\x1B`)||e.includes(`›`)?le(e):e,n=0;if(me)for(let{segment:e}of me.segment(t))n+=pe(e);else for(let e of t)n+=pe(e);return n}function B(e){let t=[],n=e.replace(/`([^`]+)`/g,(e,n)=>{let r=t.length;return t.push(M.cyan(n)),`\x00CODE${r}\x00`});return n=n.replace(/\*\*(.+?)\*\*/g,(e,t)=>M.bold(t)),n=n.replace(/__(.+?)__/g,(e,t)=>M.bold(t)),n=n.replace(/\*(.+?)\*/g,(e,t)=>M.italic(t)),n=n.replace(/(?<!\w)_(.+?)_(?!\w)/g,(e,t)=>M.italic(t)),n=n.replace(/\[([^\]]+)\]\(([^)]+)\)/g,(e,t,n)=>`${M.underline(t)} ${M.dim(`(${n})`)}`),n=n.replace(/\x00CODE(\d+)\x00/g,(e,n)=>t[Number(n)]),n}function ge(e){return Ee(e.split(`
2
- `)).map(je).join(`
3
-
4
- `)}const _e=/^(#{1,6})\s+(.+)$/,ve=/^(?:---+|\*\*\*+|___+)\s*$/,ye=/^>\s?(.*)$/,be=/^-\s+(.+)$/,xe=/^(\d+)[.)]\s+(.+)$/,Se=/^(`{3,}|~{3,})(\S*)\s*$/,Ce=/^\[!(NOTE|TIP|IMPORTANT|WARNING|CAUTION)\]\s*$/,we=/^\|(.+)\|$/,Te=/^\|(\s*:?-+:?\s*\|)+$/;function Ee(e){let t=[],n=0;for(;n<e.length;){let r=e[n];if(r.trim()===``){n++;continue}let i=r.match(Se);if(i){let r=i[1],a=i[2]??``,o=[];for(n++;n<e.length;){if(e[n].startsWith(r.charAt(0).repeat(r.length))&&e[n].trim()===r.charAt(0).repeat(Math.max(r.length,e[n].trim().length))){n++;break}o.push(e[n]),n++}t.push({type:`code`,lang:a,lines:o});continue}let a=r.match(_e);if(a){t.push({type:`heading`,level:a[1].length,content:a[2]}),n++;continue}if(ve.test(r)){t.push({type:`hr`}),n++;continue}if(ye.test(r)){let r=[];for(;n<e.length;){let t=e[n].match(ye);if(t)r.push(t[1]),n++;else break}if(r.length>0){let e=r[0].match(Ce);if(e){let n=r.slice(1).filter(e=>e!==``);t.push({type:`alert`,alertType:e[1],lines:n});continue}}t.push({type:`blockquote`,lines:r});continue}if(be.test(r)){let r=[];for(;n<e.length;){let t=e[n].match(be);if(t)r.push(t[1]),n++;else break}t.push({type:`ul`,items:r});continue}let o=r.match(xe);if(o){let r=Number(o[1]),i=[];for(;n<e.length;){let t=e[n].match(xe);if(t)i.push(t[2]),n++;else break}t.push({type:`ol`,items:i,start:r});continue}if(we.test(r)&&n+1<e.length&&Te.test(e[n+1])){let i=De(r),a=Oe(e[n+1]);n+=2;let o=[];for(;n<e.length&&we.test(e[n]);)o.push(De(e[n])),n++;t.push({type:`table`,headers:i,alignments:a,rows:o});continue}let s=[];for(;n<e.length;){let t=e[n];if(t.trim()===``||_e.test(t)||ve.test(t)||ye.test(t)||be.test(t)||xe.test(t)||Se.test(t)||we.test(t)&&n+1<e.length&&Te.test(e[n+1]))break;s.push(t),n++}s.length>0&&t.push({type:`paragraph`,lines:s})}return t}function De(e){return e.slice(1,-1).split(`|`).map(e=>e.trim())}function Oe(e){return e.slice(1,-1).split(`|`).map(e=>{let t=e.trim();return t.startsWith(`:`)&&t.endsWith(`:`)?`center`:t.endsWith(`:`)?`right`:`left`})}function ke(e,t,n){let r=he(e),i=Math.max(0,t-r);if(n===`right`)return` `.repeat(i)+e;if(n===`center`){let t=Math.floor(i/2);return` `.repeat(t)+e+` `.repeat(i-t)}return e+` `.repeat(i)}const Ae={NOTE:{icon:`ℹ`,label:`Note`,styleFn:M.cyan},TIP:{icon:`💡`,label:`Tip`,styleFn:M.green},IMPORTANT:{icon:`❗`,label:`Important`,styleFn:M.magenta},WARNING:{icon:`⚠`,label:`Warning`,styleFn:M.yellow},CAUTION:{icon:`🔴`,label:`Caution`,styleFn:M.red}};function je(e){switch(e.type){case`heading`:return M.green(M.bold(B(e.content)));case`hr`:return M.dim(`─`.repeat(40));case`blockquote`:{let t=M.dim(`│ `);return e.lines.map(e=>`${t}${B(e)}`).join(`
5
- `)}case`alert`:{let{icon:t,label:n,styleFn:r}=Ae[e.alertType],i=r(M.bold(`│`))+` `,a=`${i}${r(t)} ${r(n)}`;return e.lines.length===0?a:`${a}\n${e.lines.map(e=>`${i}${B(e)}`).join(`
6
- `)}`}case`ul`:return e.items.map(e=>`${M.dim(`•`)} ${B(e)}`).join(`
7
- `);case`ol`:{let t=e.start+e.items.length-1,n=String(t).length;return e.items.map((t,r)=>{let i=String(e.start+r).padStart(n,` `);return`${M.dim(`${i}.`)} ${B(t)}`}).join(`
8
- `)}case`table`:{let t=e.headers.length,n=e.headers.map(e=>B(e)),r=e.rows.map(e=>Array.from({length:t},(t,n)=>B(e[n]??``))),i=n.map((e,t)=>{let n=he(e),i=r.map(e=>he(e[t]));return Math.max(n,...i)}),a=M.dim(`│`),o=M.dim(`┌─${i.map(e=>`─`.repeat(e)).join(`─┬─`)}─┐`),s=M.dim(`├─${i.map(e=>`─`.repeat(e)).join(`─┼─`)}─┤`),c=M.dim(`└─${i.map(e=>`─`.repeat(e)).join(`─┴─`)}─┘`);return[o,`${a} ${n.map((t,n)=>M.bold(ke(t,i[n],e.alignments[n]??`left`))).join(` ${a} `)} ${a}`,s,...r.map(t=>{let n=t.map((t,n)=>ke(t,i[n],e.alignments[n]??`left`));return`${a} ${n.join(` ${a} `)} ${a}`}),c].join(`
9
- `)}case`code`:return e.lines.map(e=>` ${M.yellow(e)}`).join(`
10
- `);case`paragraph`:return B(e.lines.join(` `))}}const V={help:`Show help`,helpAll:`Show help with all subcommand options`,helpJson:`Show help as JSON`,version:`Show version`};function Me(e){return!e.startsWith(`__`)}function H(e){return Object.entries(e).filter(([e])=>Me(e))}function Ne(e,t){return t?.rootName&&t.commandPath&&t.commandPath.length>0?t.commandPath.join(` `):e.name??`command`}function Pe(e,t){return t?.rootName&&t.commandPath&&t.commandPath.length>0?`${t.rootName} ${t.commandPath.join(` `)}`:e.name??`command`}function Fe(e,t){let n=[],r=Pe(e,t);n.push(M.commandName(r)),t?.globalExtracted?.fields.length&&n.push(M.placeholder(`[global options]`));let i=O(e);if(i){let t=C(i);k(i).length>0&&n.push(M.placeholder(`[options]`)),e.subCommands&&H(e.subCommands).length>0&&(e.run||e.defaultSubCommand?n.push(M.placeholder(`[command]`)):n.push(M.option(`<command>`)));for(let e of t)e.required?n.push(M.option(`<${e.name}>`)):n.push(M.placeholder(`[${e.name}]`))}else e.subCommands&&H(e.subCommands).length>0&&(e.run||e.defaultSubCommand?n.push(M.placeholder(`[command]`)):n.push(M.option(`<command>`)));return n.join(` `)}function Ie(e,t){let n=`${M.dim(`When`)} ${M.option(e)}=${M.bold(t.discriminatorValue)}:`;return t.description?`${n} ${t.description}`:n}function Le(e,t){return` ${M.bold(`${e.description??`Variant ${t+1}`}:`)}`}function Re(e,t=0){let n=e.required?M.option(`<${e.name}>`):M.placeholder(`[${e.name}]`),r=e.named?`${n}, ${W(e)}`:n,i=[q(e),e.defaultValue===void 0?void 0:M.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)].filter(Boolean).join(` `);return i?K(r,i,t):`${` `.repeat(t)} ${r}`}function ze(e){let t=O(e);if(!t)return``;let n=[];if(t.schemaType===`discriminatedUnion`&&t.discriminator){let e=t.discriminator;n=(t.variants??[]).map(t=>({label:Ie(e,t),fields:t.fields}))}else(t.schemaType===`union`||t.schemaType===`xor`)&&t.unionOptions&&(n=t.unionOptions.map((e,t)=>({label:Le(e,t),fields:e.fields})));let r=n.length>0?A(n):void 0,i=t.fields.filter(e=>e.positional&&(r===void 0||r.has(e.name))).map(e=>Re(e));for(let e of n){let t=e.fields.filter(e=>e.positional&&!r?.has(e.name));t.length!==0&&i.push(``,e.label,...t.map(e=>Re(e,1)))}return i.join(`
11
- `)}function Be(t,n={},r){let i=[],a={help:n.help??V.help,helpAll:n.helpAll??V.helpAll,helpJson:n.helpJson??V.helpJson,version:n.version??V.version},o=O(t),s=o?.fields.some(t=>t.overrideBuiltinAlias===!0&&e(t).includes(`h`))??!1,c=o?.fields.some(t=>t.overrideBuiltinAlias===!0&&e(t).includes(`H`))??!1;if(s?i.push(K(M.option(`--help`),a.help)):i.push(K(`${M.option(`-h`)}, ${M.option(`--help`)}`,a.help)),c?i.push(K(M.option(`--help-all`),a.helpAll)):i.push(K(`${M.option(`-H`)}, ${M.option(`--help-all`)}`,a.helpAll)),i.push(K(M.option(`--help-json`),a.helpJson)),r?.rootVersion&&i.push(K(M.option(`--version`),a.version)),!o)return i.join(`
12
- `);if(o.schemaType===`discriminatedUnion`&&o.discriminator)return Ve(o,t,i);if(o.schemaType===`union`&&o.unionOptions||o.schemaType===`xor`&&o.unionOptions)return He(o,t,i);let l=[],u=o.fields.filter(e=>!e.positional);for(let e of u){let t=W(e),n=q(e);e.defaultValue!==void 0&&(n+=` ${M.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)}`),e.required&&(n+=` ${M.required(`(required)`)}`);let r=G(e.env);r&&(n+=` ${r}`),l.push(K(t,n));let i=U(e);i&&l.push(i)}return l.push(...i),l.join(`
13
- `)}function U(e,t=0,n=0){return!e.negationDisplay||!e.negationDescription?null:K(M.option(`--${e.negationDisplay}`),`${e.negationDescription} ${M.dim(`(↔ --${e.cliName})`)}`,t,n)}function Ve(e,t,n){let r=[],i=e.discriminator,a=e.variants??[],o=E(e,i);if(o){let t=a.map(e=>e.discriminatorValue).join(`|`),n=`${M.option(`--${i}`)} ${M.placeholder(`<${t}>`)}`,s=e.description??o.description??`Action to perform`;r.push(K(n,s))}let s=A(a,i);for(let t of s){let n=e.fields.find(e=>e.name===t);if(n&&!n.positional){let e=W(n),t=q(n);n.defaultValue!==void 0&&(t+=` ${M.defaultValue(`(default: ${JSON.stringify(n.defaultValue)})`)}`);let i=G(n.env);i&&(t+=` ${i}`),r.push(K(e,t));let a=U(n);a&&r.push(a)}}r.push(...n);for(let e of a){let t=e.fields.filter(e=>e.name!==i&&!s.has(e.name)&&!e.positional),n=p(e.fields.find(e=>e.name===i)?.requiredPackages);if(t.length>0||n){r.push(``),r.push(Ie(i,e)),n&&r.push(Ge(n,2));for(let e of t){let t=W(e),n=q(e);e.defaultValue!==void 0&&(n+=` ${M.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)}`),e.required&&(n+=` ${M.required(`(required)`)}`);let i=G(e.env);i&&(n+=` ${i}`),r.push(K(t,n,1));let a=U(e,1);a&&r.push(a)}}}return r.join(`
14
- `)}function He(e,t,n){let r=[],i=e.unionOptions??[],a=A(i);for(let t of a){let n=e.fields.find(e=>e.name===t);if(n&&!n.positional){let e=W(n),t=q(n);n.defaultValue!==void 0&&(t+=` ${M.defaultValue(`(default: ${JSON.stringify(n.defaultValue)})`)}`);let i=G(n.env);i&&(t+=` ${i}`),r.push(K(e,t));let a=U(n);a&&r.push(a)}}r.push(...n);for(let e=0;e<i.length;e++){let t=i[e];if(!t)continue;let n=t.fields.filter(e=>!a.has(e.name)&&!e.positional),o=Le(t,e);if(n.length>0){r.push(``),r.push(o);for(let e of n){let t=W(e),n=q(e);e.defaultValue!==void 0&&(n+=` ${M.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)}`),e.required&&(n+=` ${M.required(`(required)`)}`);let i=G(e.env);i&&(n+=` ${i}`),r.push(K(t,n,1));let a=U(e,1);a&&r.push(a)}}else r.push(``),r.push(o),r.push(` ${M.dim(M.italic(`no options`))}`)}return r.join(`
15
- `)}function W(e){let t=[];if(e.alias)for(let n of e.alias)n.length===1&&t.push(M.option(`-${n}`));let n=M.option(`--${e.cliName}`);if(e.type!==`boolean`){let t=e.placeholder??e.cliName.toUpperCase();n+=` ${M.placeholder(`<${t}>`)}`}if(t.push(n),e.alias){for(let n of e.alias)if(n.length>1){let r=M.option(`--${n}`);if(e.type!==`boolean`){let t=e.placeholder??e.cliName.toUpperCase();r+=` ${M.placeholder(`<${t}>`)}`}t.push(r)}}let r=t.join(`, `);return e.type===`boolean`&&e.negationDisplay&&!e.negationDescription?`${r} / ${M.option(`--${e.negationDisplay}`)}`:r}function G(e){if(!e)return``;let t=Array.isArray(e)?e:[e];return M.dim(`[env: ${t.join(`, `)}]`)}function Ue(e){return e.replace(/\x1B\[[0-9;]*m/g,``)}function We(e,t){let n=Ue(e).length,r=Math.max(0,t-n);return e+` `.repeat(r)}function Ge(e,t){if(!e.includes(`
16
- `))return e;let n=` `.repeat(t);return e.split(`
17
- `).join(`\n${n}`)}function K(e,t,n=0,r=0){let i=` `.repeat(n),a=Ue(e).length,o=32-n*2+r,s=o+2+n*2,c=Ge(t,s);return a>=o?`${i} ${e}\n${` `.repeat(s)}${c}`:`${i} ${We(e,o)}${c}`}function Ke(e,t=0,n=0){let r=W(e),i=q(e);e.defaultValue!==void 0&&(i+=` ${M.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)}`),e.required&&(i+=` ${M.required(`(required)`)}`);let a=G(e.env);return a&&(i+=` ${a}`),K(r,i,t,n)}function qe(e){let t=[];for(let n of e.fields){if(n.positional)continue;t.push(Ke(n));let e=U(n);e&&t.push(e)}return t.join(`
18
- `)}function Je(e,t){let n=[],r=O(e);if(r){let e=r.fields.filter(e=>!e.positional);for(let r of e){let e=W(r),i=q(r);r.defaultValue!==void 0&&(i+=` ${M.defaultValue(`(default: ${JSON.stringify(r.defaultValue)})`)}`);let a=G(r.env);a&&(i+=` ${a}`),n.push(K(e,i,t,2));let o=U(r,t,2);o&&n.push(o)}}return n}function Ye(e,t,n){let r=[];for(let[i,a]of H(e)){let e=u(a),o=t?`${t} ${i}`:i,s=[e?.description,p(e?.requiredPackages)].filter(Boolean).join(`
19
- `),c=e?.aliases,l=c&&c.length>0?`${o}, ${c.join(`, `)}`:o;if(r.push(K(M.command(l),s,n)),e){let t=Je(e,n+1);r.push(...t);let i=e.subCommands?Object.fromEntries(H(e.subCommands)):void 0;if(i&&Object.keys(i).length>0){let e=Ye(i,o,n);r.push(...e)}}}return r}function Xe(e,t){let n=[],r=t.context;t.agentHelp&&n.push(ge(t.agentHelp));let i=Ne(e,r);if(i){let e=M.commandName(i);r?.rootName&&r.commandPath&&r.commandPath.length>0?r.rootVersion?e+=` ${M.version(`(${r.rootName} v${r.rootVersion})`)}`:e+=` ${M.version(`(${r.rootName})`)}`:r?.rootVersion&&(e+=` ${M.version(`v${r.rootVersion}`)}`),n.push(e)}r?.aliasFor&&n.push(M.dim(`Alias for ${M.commandName(r.aliasFor)}`)),e.description&&n.push(e.description),!r?.aliasFor&&e.aliases&&e.aliases.length>0&&n.push(`${M.sectionHeader(`Aliases:`)} ${e.aliases.map(e=>M.command(e)).join(`, `)}`),n.push(`${M.sectionHeader(`Usage:`)} ${Fe(e,r)}`);let a=ze(e);a&&n.push(`${M.sectionHeader(`Arguments:`)}\n${a}`);let o=Be(e,t.descriptions,r);if(o&&n.push(`${M.sectionHeader(`Options:`)}\n${o}`),r?.globalExtracted?.fields.length&&n.push(`${M.sectionHeader(`Global Options:`)}\n${qe(r.globalExtracted)}`),t.showSubcommands!==!1&&e.subCommands&&H(e.subCommands).length>0){let i=r?.commandPath?.join(` `)??``,a=Object.fromEntries(H(e.subCommands));if(t.showSubcommandOptions){let e=Ye(a,i,0);n.push(`${M.sectionHeader(`Commands:`)}\n${e.join(`
20
- `)}`)}else{let e=[];for(let[t,n]of Object.entries(a)){let r=u(n),a=[r?.description,p(r?.requiredPackages)].filter(Boolean).join(`
21
- `),o=i?`${i} ${t}`:t,s=r?.aliases,c=s&&s.length>0?`${o}, ${s.join(`, `)}`:o;e.push(K(M.command(c),a))}n.push(`${M.sectionHeader(`Commands:`)}\n${e.join(`
22
- `)}`)}}if(e.examples&&e.examples.length>0){let t=$e(e.examples,r);n.push(`${M.sectionHeader(`Examples:`)}\n${t}`)}let s=p(e.requiredPackages);if(s&&n.push(`${M.sectionHeader(`Required packages:`)}\n${s}`),e.notes){let t=ge(e.notes).split(`
23
- `).map(e=>e===``?``:` ${e}`).join(`
24
- `);n.push(`${M.sectionHeader(`Notes:`)}\n${t}`)}return`\n${n.join(`
25
-
26
- `)}\n`}function q(e){return[e.description,p(e.requiredPackages)].filter(Boolean).join(`
27
- `)}function J(e){let t={name:e.name,cliName:e.cliName,positional:e.positional,named:e.named,required:e.required,type:e.type};return e.requiredPackages?.length&&(t.requiredPackages=e.requiredPackages.map(e=>({name:e.name,install:v(e)}))),e.alias&&(t.alias=e.alias),e.description!==void 0&&(t.description=e.description),e.placeholder!==void 0&&(t.placeholder=e.placeholder),e.env!==void 0&&(t.env=e.env),e.defaultValue!==void 0&&(t.defaultValue=e.defaultValue),e.enumValues!==void 0&&(t.enumValues=e.enumValues),e.negation!==void 0&&(t.negation=e.negation),e.negationDisplay!==void 0&&(t.negationDisplay=e.negationDisplay),e.negationDescription!==void 0&&(t.negationDescription=e.negationDescription),t}function Ze(e,t){let n=Pe(e,t),r=!!t?.globalExtracted?.fields.length,i=e.subCommands&&H(e.subCommands).length>0?e.run?`optional`:`required`:void 0,a=O(e);return{commandName:n,hasGlobalOptions:r,hasOptions:a?k(a).length>0:!1,subcommand:i,positionals:a?C(a).map(e=>({name:e.name,required:e.required})):[]}}function Qe(e,t={}){let n=t.context,r=n?.commandPath??[],i={help:t.descriptions?.help??V.help,helpAll:t.descriptions?.helpAll??V.helpAll,helpJson:t.descriptions?.helpJson??V.helpJson,...n?.rootVersion?{version:t.descriptions?.version??V.version}:{}},a=O(e),o,s=[],c=[],l,d,f;if(a){if(o=a.schemaType,s=C(a).map(J),a.schemaType===`discriminatedUnion`&&a.discriminator&&a.variants){let e=a.discriminator;l=e;let t=a.variants,n=A(t,e),r=E(a,e),i=a.fields.filter(e=>!e.positional&&n.has(e.name));c=[...r?[{...J({...r,requiredPackages:void 0}),description:a.description??r.description??`Action to perform`}]:[],...i.map(J)],d=t.map(t=>{let r=t.fields.find(t=>t.name===e);return{discriminatorValue:t.discriminatorValue,...r?.requiredPackages?.length?{requiredPackages:J(r).requiredPackages}:{},description:t.description,fields:t.fields.filter(t=>t.name!==e&&!n.has(t.name)).map(J)}})}else if((a.schemaType===`union`||a.schemaType===`xor`)&&a.unionOptions){let e=a.unionOptions,t=A(e);c=a.fields.filter(e=>!e.positional&&t.has(e.name)).map(J),f=e.map(e=>({description:e.description,fields:e.fields.filter(e=>!t.has(e.name)).map(J)}))}else c=a.fields.filter(e=>!e.positional).map(J)}let p=n?.globalExtracted?.fields.length?n.globalExtracted.fields.filter(e=>!e.positional).map(J):void 0,m;if(e.subCommands){let i=H(e.subCommands);i.length>0&&(m=i.map(([i,a])=>{let o=u(a);if(!o)return{name:i,unresolved:!0};let s={commandPath:[...r,i],rootName:n?.rootName??e.name,rootVersion:n?.rootVersion,globalExtracted:n?.globalExtracted};return{name:i,aliases:o.aliases,data:Qe(o,{descriptions:t.descriptions,context:s})}}))}return{name:e.name??`command`,commandPath:r,rootName:n?.rootName,version:n?.rootVersion,aliasFor:n?.aliasFor,description:e.description,aliases:e.aliases,usage:Ze(e,n),builtinOptions:i,schemaType:o,positionals:s,options:c,discriminator:l,variants:d,unionOptions:f,globalOptions:p,subcommands:m,examples:e.examples,notes:e.notes,...e.requiredPackages?.length?{requiredPackages:e.requiredPackages.map(e=>({name:e.name,install:v(e),description:e.description}))}:{},agentHelp:t.agentHelp}}function $e(e,t){let n=[],r=t?.rootName?`${t.rootName} `:``,i=t?.commandPath?.join(` `)??``,a=i?`${r}${i} `:r;for(let t of e){if(n.push(` ${M.dim(t.desc).split(`
28
- `).join(`
29
- `)}`),n.push(` ${M.dim(`$`)} ${a}${t.cmd}`),t.output)for(let e of t.output.split(`
30
- `))n.push(` ${e}`);n.push(``)}return n.length>0&&n[n.length-1]===``&&n.pop(),n.join(`
31
- `)}var et=class extends Error{constructor(e){super(e),this.name=`PositionalConfigError`}},tt=class extends Error{constructor(e){super(e),this.name=`ReservedAliasError`}},nt=class extends Error{constructor(e){super(e),this.name=`DuplicateFieldError`}},rt=class extends Error{constructor(e){super(e),this.name=`DuplicateAliasError`}},it=class extends Error{constructor(e){super(e),this.name=`CaseVariantCollisionError`}},at=class extends Error{constructor(e){super(e),this.name=`DuplicateNegationError`}},ot=class extends Error{constructor(e){super(e),this.name=`ReservedFieldNameError`}},st=class extends Error{constructor(e){super(e),this.name=`DefaultSubCommandError`}},ct=class extends Error{constructor(e){super(e),this.name=`FieldTypeConflictError`}};function lt(e,t){let n=[],r=/* @__PURE__ */ new Map;for(let i of e.fields)r.has(i.name)&&n.push({commandPath:t,type:`duplicate_field`,message:`Duplicate field name "${i.name}" detected.`,field:i.name}),r.set(i.name,i.name);return n}function ut(e,t){let n=[],r=/* @__PURE__ */ new Map;for(let i of e.fields){let e=a(i.name),o=r.get(e);o&&o!==i.name&&n.push({commandPath:t,type:`case_variant_collision`,message:`Fields "${o}" and "${i.name}" are case variants of each other and would collide.`,field:i.name}),r.set(e,i.name)}return n}function dt(t,n){let r=[],i=/* @__PURE__ */ new Map,o=new Set(t.fields.map(e=>e.name)),s=new Set(t.fields.map(e=>e.cliName)),c=(e,t,a)=>{(o.has(e)||s.has(e))&&r.push({commandPath:n,type:`duplicate_alias`,message:`Alias "${e}" for field "${t}" conflicts with existing field name or CLI name "${e}".`,field:t});let c=i.get(e);if(c&&c!==t){let i=a?` (derived camelCase variant)`:``;r.push({commandPath:n,type:`duplicate_alias`,message:`Duplicate alias "${e}"${i} detected. Both "${c}" and "${t}" use the same alias.`,field:t})}i.set(e,t)};for(let n of t.fields){let t=e(n);if(t.length!==0){for(let e of t)if(c(e,n.name,!1),e.length>1&&e.includes(`-`)){let t=a(e);t!==e&&!o.has(t)&&c(t,n.name,!0)}}}return r}function ft(t,n){let r=[],i=/* @__PURE__ */ new Map,o=(e,t,n)=>{i.has(e)||i.set(e,{field:t,kind:n})};for(let n of t.fields){if(o(n.name,n.name,`field name`),n.name.includes(`-`)){let e=a(n.name);e!==n.name&&o(e,n.name,`field name`)}if(n.cliName!==n.name&&o(n.cliName,n.name,`CLI name`),n.cliName.includes(`-`)){let e=a(n.cliName);e!==n.cliName&&o(e,n.name,`CLI name`)}for(let t of e(n))if(o(t,n.name,`alias`),t.length>1&&t.includes(`-`)){let e=a(t);e!==t&&o(e,n.name,`alias`)}if(n.type===`boolean`&&n.negation===!0){let e=`no-${n.cliName}`;o(e,n.name,`default negation`);let t=a(n.cliName),r=`no${t[0]?.toUpperCase()??``}${t.slice(1)}`;r!==e&&o(r,n.name,`default negation`)}}let s=/* @__PURE__ */ new Map,c=(e,t,a)=>{let o=i.get(e);if(o){let i=a?` (derived camelCase variant)`:``,s=o.field===t?`the same field's own ${o.kind} "${e}"`:`${o.kind} "${e}" of field "${o.field}"`;r.push({commandPath:n,type:`duplicate_negation`,message:`Negation "${e}"${i} for field "${t}" conflicts with ${s}.`,field:t})}let c=s.get(e);if(c&&c!==t){let i=a?` (derived camelCase variant)`:``;r.push({commandPath:n,type:`duplicate_negation`,message:`Duplicate negation "${e}"${i} detected. Both "${c}" and "${t}" use the same negation name.`,field:t})}s.set(e,t)};for(let e of t.fields)if(typeof e.negation==`string`&&(c(e.negation,e.name,!1),e.negation.includes(`-`))){let t=a(e.negation);t!==e.negation&&c(t,e.name,!0)}return r}function pt(e,t){let n=[e,...e.variants??[],...e.unionOptions??[]],r=/* @__PURE__ */ new Set;return n.flatMap(e=>mt(e.fields,t)).filter(e=>!r.has(e.message)&&r.add(e.message))}function mt(e,t){let n=[],r=e.filter(e=>e.positional),i=null,a=null;for(let e of r)i!==null&&n.push({commandPath:t,type:`positional_config`,message:`Positional argument "${e.name}" cannot follow array positional argument "${i}".`,field:e.name}),e.type===`array`&&a!==null&&n.push({commandPath:t,type:`positional_config`,message:`Array positional "${e.name}" cannot be used with optional positional "${a}" (ambiguous parsing).`,field:e.name}),a!==null&&e.required&&n.push({commandPath:t,type:`positional_config`,message:`Required positional "${e.name}" cannot follow optional positional "${a}".`,field:e.name}),e.type===`array`&&(i=e.name),e.required||(a=e.name);return n}function ht(t,n){let r=[];for(let i of t.fields){if(i.overrideBuiltinAlias!==!0)for(let t of e(i))(t===`h`||t===`H`)&&r.push({commandPath:n,type:`reserved_alias`,message:`Alias "${t}" is reserved for --${t===`h`?`help`:`help-all`}. To override this, set { overrideBuiltinAlias: true } for "${i.name}" and keep the alias where it is currently defined (in alias or hiddenAlias).`,field:i.name});let t=/* @__PURE__ */ new Set([i.cliName,...e(i)]);for(let e of t){if(!o.has(e))continue;let t=e===i.cliName;r.push({commandPath:n,type:`reserved_alias`,message:`${t?`Field "${i.name}"`:`Alias "${e}" for field "${i.name}"`} collides with the built-in --${e} option, which always takes precedence. Rename the field or its alias; this collision cannot be overridden.`,field:i.name})}}return r}function gt(e,t){let n=[];for(let r of e.fields)r.name.startsWith(`$`)&&n.push({commandPath:t,type:`reserved_field_name`,message:`Field "${r.name}" starts with "$", which is reserved for framework-injected helpers (e.g. $source).`,field:r.name});return n}function _t(e){let t=lt(e,[]);if(t.length>0)throw new nt(`Duplicate field name "${t[0]?.field??`unknown`}" detected. Each field must have a unique name.`)}function vt(e){let t=dt(e,[]);if(t.length>0){let e=t[0];throw new rt(e.message)}}function yt(e){let t=pt(e,[]);if(t.length>0){let e=t[0];throw new et(e.message)}}function bt(e,t){let n=ht(e,[]);if(n.length>0)throw new tt(n[0].message)}function xt(e){let t=gt(e,[]);if(t.length>0){let e=t[0];throw new ot(e.message)}}function St(e){let t=ft(e,[]);if(t.length>0){let e=t[0];throw new at(e.message)}}function Ct(e){let t=ut(e,[]);if(t.length>0){let e=t[0];throw new it(e.message)}}function wt(e,t,n){let r=[],i=/* @__PURE__ */ new Map;for(let t of e.fields)i.set(a(t.name),t);for(let e of t.fields){let t=a(e.name),o=i.get(t);o&&(o.name===e.name?r.push({commandPath:n,type:`field_type_conflict`,message:`Global field "${o.name}" and command field "${e.name}" share the same name. A field name can only be declared in one schema, even when the definitions are identical.`,field:e.name}):r.push({commandPath:n,type:`case_variant_collision`,message:`Global field "${o.name}" and command field "${e.name}" are case variants of each other and would collide.`,field:e.name}))}return r.push(...Tt(e,t,n)),r}function Tt(e,t,n){let i=e=>e.fields.map(e=>({field:e,path:e.nested?.path??[e.name]})),a=i(e),o=i(t);if(![...a,...o].some(({field:e})=>e.nested))return[];let s=[];for(let e of a)for(let t of o){if(!e.field.nested&&!t.field.nested)continue;let i=Math.min(e.path.length,t.path.length),a=e.path.length!==t.path.length&&e.path.slice(0,i).every((e,n)=>e===t.path[n])?`one is a value where the other nests a group`:e.path[0]!==t.path[0]&&r(e.path[0])===r(t.path[0])?`their group names are spellings of the same name`:void 0;a&&s.push({commandPath:n,type:`field_type_conflict`,message:`Global field "${e.field.name}" and command field "${t.field.name}" nest into conflicting output positions: ${a}.`,field:t.field.name})}return s}function Et(e,t){let n=wt(e,t,[])[0];if(n)throw n.type===`case_variant_collision`?new it(n.message):new ct(n.message)}function Dt(e,t,n){return[...lt(e,n),...ut(e,n),...dt(e,n),...ft(e,n),...pt(e,n),...ht(e,n),...gt(e,n)]}function Ot(e,t){let n=e,r=[];if(n.defaultSubCommand===void 0)return r;n.run&&r.push({commandPath:t,type:`default_subcommand_conflict`,message:`Command "${n.name}" defines both "run" and "defaultSubCommand". Define only one.`});let i=e.subCommands?Object.keys(e.subCommands):[];return i.includes(n.defaultSubCommand)||r.push({commandPath:t,type:`default_subcommand_not_found`,message:`defaultSubCommand "${n.defaultSubCommand}" does not match any subCommands key of "${n.name}". Registered: ${i.length>0?i.join(`, `):`(none)`}.`,field:n.defaultSubCommand}),r}function kt(e){let t=Ot(e,[]);if(t.length>0)throw new st(t[0].message)}function At(e,t){let n=[];if(!e.subCommands)return n;let r=/* @__PURE__ */ new Map;for(let[t]of Object.entries(e.subCommands))r.set(t,t);for(let[i,a]of Object.entries(e.subCommands)){let e=h(a)?a.meta:typeof a==`function`?null:a;if(!e?.aliases)continue;let o=[...t,i];for(let t of e.aliases){if(!/^[a-zA-Z0-9][a-zA-Z0-9_-]*$/.test(t)){n.push({commandPath:o,type:`invalid_alias`,message:`Alias "${t}" is invalid. Aliases must start with an alphanumeric character and contain only alphanumeric characters, hyphens, or underscores.`,field:i});continue}if(t===i){n.push({commandPath:o,type:`duplicate_alias`,message:`Alias "${t}" conflicts with its own name.`,field:i});continue}let e=r.get(t);e?e===i?n.push({commandPath:o,type:`duplicate_alias`,message:`Alias "${t}" is duplicated within the alias list.`,field:i}):n.push({commandPath:o,type:`duplicate_alias`,message:`Alias "${t}" conflicts with existing subcommand or alias "${e}".`,field:i}):r.set(t,i)}}return n}function jt(e,t,n){return e===t?[]:[{commandPath:[...n,e],type:`subcommand_key_name_mismatch`,message:`Subcommand registered as "${e}" but its own name is "${t}".`,field:e}]}async function Mt(e,t={}){return Nt(e,t,!1)}async function Nt(e,t,n){n||=!!e.requiredPackages?.length;let r=t.commandPath??[e.name],i=[],a=e.subCommands?Object.keys(e.subCommands).length>0:!1,o=t.globalArgs?T(t.globalArgs):void 0;if(e.args){let t=T(e.args);i.push(...Dt(t,a,r)),o&&i.push(...wt(o,t,r))}if(i.push(...At(e,r)),i.push(...Ot(e,r)),e.subCommands)for(let[a,o]of Object.entries(e.subCommands)){let e=await g(o,e=>n||!!e.requiredPackages?.length);i.push(...jt(a,e.name,r));let s=await Nt(e,{commandPath:[...r,a],...t.globalArgs?{globalArgs:t.globalArgs}:{}},n);s.valid||i.push(...s.errors)}return i.length===0?{valid:!0}:{valid:!1,errors:i}}function Pt(e){if(e.length===0)return``;let t=[`Command definition errors:`];for(let n of e){let e=n.commandPath.join(` > `);t.push(` - [${e}] ${n.message}`)}return t.join(`
32
- `)}function Ft(t){let{aliasMap:n=/* @__PURE__ */ new Map,booleanFlags:r=/* @__PURE__ */ new Set,definedNames:i=/* @__PURE__ */ new Set,negationMap:a=/* @__PURE__ */ new Map,defaultNegationDisabledFields:o=/* @__PURE__ */ new Set}=R(t),s=/* @__PURE__ */ new Set;for(let n of t.fields)for(let t of e(n))t.length===1&&s.add(t);return{aliasMap:n,booleanFlags:r,definedNames:i,flagNames:new Set(t.fields.map(e=>e.name)),cliNames:new Set(t.fields.map(e=>e.cliName)),aliases:s,negationMap:a,defaultNegationDisabledFields:o}}function It(e,t){let{resolvedName:n,withoutDashes:r,isNegated:i,isCustomNegation:a,isSuppressedNegation:o}=ie(e,t);if(o)return{resolvedName:n,withoutDashes:r,isNegated:!1,isGlobal:!1,isSuppressedNegation:o};let s=i&&!a?r.startsWith(`no-`)?r.slice(3):r[2].toLowerCase()+r.slice(3):r;return{resolvedName:n,withoutDashes:r,isNegated:i,isGlobal:t.flagNames.has(n)||t.cliNames.has(r)||t.cliNames.has(s),isSuppressedNegation:!1}}function Y(e,t,n,r,i){return!e.includes(`=`)&&!i.has(t)&&!n&&r!==void 0&&F(r)}function X(e,t,n,r,i,a){let o=e[t];return a.push(o),Y(o,n,r,e[t+1],i)?(a.push(e[t+1]),2):1}function Lt(e,t,n,r=()=>!1){let i=e[t];if(!ae(i))return 0;let a=e=>n.aliasMap.get(e)??e,o=e=>!r(e)&&(n.aliases.has(e)||n.flagNames.has(a(e))),{flags:s,valueOption:c}=L(i.slice(1),e=>o(e)&&!n.booleanFlags.has(a(e)));return s.every(o)?c&&c.value===void 0&&Y(i,a(c.name),!1,e[t+1],n.booleanFlags)?2:1:0}function Rt(e,t,n){let r=Ft(n),i=new Set(t),a=[],o=[],s=0;for(;s<e.length;){let t=e[s];if(t===`--`||zt.has(t))break;if(!t.startsWith(`-`)&&i.has(t))return{subCommandIndex:s,globalTokensBefore:a,tokensAfterSubcommand:e.slice(s+1),suppressedTokens:o};if(t.startsWith(`--`)){let{resolvedName:n,withoutDashes:i,isNegated:c,isGlobal:l,isSuppressedNegation:u}=It(t,r);if(l){s+=X(e,s,n,c,r.booleanFlags,a);continue}if(u){o.push(i),s++;continue}break}if(t.startsWith(`-`)&&t.length>1){let n=t.includes(`=`)?t.slice(1,t.indexOf(`=`)):t.slice(1);if(n.length===1){let t=r.aliasMap.get(n)??n;if(r.aliases.has(n)||r.flagNames.has(t)){s+=X(e,s,t,!1,r.booleanFlags,a);continue}}let i=Lt(e,s,r);if(i>0){a.push(...e.slice(s,s+i)),s+=i;continue}break}break}return{subCommandIndex:-1,globalTokensBefore:a,tokensAfterSubcommand:[],suppressedTokens:o}}const zt=/* @__PURE__ */ new Set([`--help`,`-h`,`--help-all`,`-H`,`--help-json`,`--version`]);function Bt(e,t,n={}){let r=n.stopOnSuppressedNegation===!0||t?.unknownKeysMode===`strict`,i=t?Ft(t):{aliasMap:/* @__PURE__ */ new Map,booleanFlags:/* @__PURE__ */ new Set,definedNames:/* @__PURE__ */ new Set,flagNames:/* @__PURE__ */ new Set,cliNames:/* @__PURE__ */ new Set,aliases:/* @__PURE__ */ new Set,negationMap:/* @__PURE__ */ new Map,defaultNegationDisabledFields:/* @__PURE__ */ new Set};for(let t=0;t<e.length;t++){let n=e[t];if(!n.startsWith(`-`))return t;if(n===`--`||zt.has(n))return-1;if(n.startsWith(`--`)){let{resolvedName:a,isNegated:o,isGlobal:s,isSuppressedNegation:c}=It(n,i);if(s){Y(n,a,o,e[t+1],i.booleanFlags)&&t++;continue}if(c){if(r)return-1;continue}return-1}let a=n.includes(`=`)?n.slice(1,n.indexOf(`=`)):n.slice(1);if(a.length===1){let r=i.aliasMap.get(a)??a;if(i.aliases.has(a)||i.flagNames.has(r)){Y(n,r,!1,e[t+1],i.booleanFlags)&&t++;continue}}let o=Lt(e,t,i);if(o>0)t+=o-1;else return-1}return-1}function Vt(e,t){let n=Bt(e,t);return n>=0?e[n]:void 0}function Ht(t,n,r={}){let i=_(n),a=[...i],o=a.length>0,s=o&&!n.run;if(o&&t.length>0){if(r.globalExtracted){let e=Rt(t,a,r.globalExtracted);if(e.subCommandIndex>=0){let n=Gt(e.globalTokensBefore,r.globalExtracted);return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:t[e.subCommandIndex],remainingArgs:e.tokensAfterSubcommand,rawArgs:{},positionals:[],rest:[],unknownFlags:e.suppressedTokens,unknownGlobalFlags:e.suppressedTokens,rawGlobalArgs:n}}}else{let e=t[0];if(e&&!e.startsWith(`-`)&&i.has(e))return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:e,remainingArgs:t.slice(1),rawArgs:{},positionals:[],rest:[],unknownFlags:[]}}}let c;n.args&&(c=T(n.args),r.skipValidation||(_t(c),Ct(c),vt(c),St(c),yt(c),bt(c,o),xt(c),r.globalExtracted&&Et(r.globalExtracted,c)));let l=t,u,d=[];if(r.globalExtracted){let e=c?S(c):[],n=new Set(e.map(e=>e.name)),{separated:i,globalParsed:a,suppressedTokens:o}=Jt(t,r.globalExtracted,c&&{...c,fields:[...e,...c.fields.filter(e=>!n.has(e.name))]});l=i,u=a,d=o}let{helpRequested:f,helpAllRequested:p,helpJsonRequested:m,versionRequested:h}=Kt(t,c);if(f||p||m||h)return{helpRequested:f,helpAllRequested:p,helpJsonRequested:m,versionRequested:h,subCommand:void 0,remainingArgs:[],rawArgs:{},positionals:[],rest:[],unknownFlags:[],unknownGlobalFlags:d,rawGlobalArgs:u};if(s||r.beforeEnvFallback?.(u),!c){let t=l.indexOf(`--`),n=t>=0?l.slice(0,t):l,i=t>=0?l.slice(t+1):[],a=e=>s&&e.startsWith(`-`)&&e!==`-`,o=new Set(r.globalExtracted?.fields.flatMap(t=>[t.name,t.cliName,...e(t)])),c=r.globalExtracted?R(r.globalExtracted):{},f=n.filter(a).flatMap(e=>Object.keys(N([e],c).options)).filter(e=>!o.has(e));return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:void 0,remainingArgs:[],rawArgs:{},positionals:n.filter(e=>!a(e)),rest:i,unknownFlags:f,unknownGlobalFlags:d,rawGlobalArgs:u}}let g=Ut(c,l,{promptAvailable:r.promptAvailable===!0,inheritedNames:r.inheritedNames??/* @__PURE__ */ new Set});if(!g)return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:void 0,remainingArgs:[],rawArgs:{},positionals:[],rest:[],unknownFlags:[],unknownGlobalFlags:d,extractedFields:c,matchesNoUnionOption:!0,rawGlobalArgs:u};let v=R(g),y=N(l,{...v,unknownFlagsTakeNoValue:s}),b=P(y,g),x=Z(b,g),C=g.fields.filter(e=>e.named),ee=new Set(C.map(e=>e.name)),w=new Set(C.map(e=>e.cliName)),E=/* @__PURE__ */ new Set;for(let t of C)for(let n of e(t))E.add(n);if(r.globalExtracted)for(let t of r.globalExtracted.fields){ee.add(t.name),w.add(t.cliName);for(let n of e(t))E.add(n)}let D=[];for(let e of Object.keys(y.options))ee.has(e)||w.has(e)||E.has(e)||D.push(e);return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:void 0,remainingArgs:[],rawArgs:b,positionals:y.positionals,rest:y.rest,unknownFlags:D,unknownGlobalFlags:d,extractedFields:c,optionFields:C,positionalSlotFields:I(g,y.options),rawGlobalArgs:u,envFallbackFields:x}}function Ut(e,t,n){let{discriminator:r,variants:i,unionOptions:a}=e;if(r&&i){let n=e=>{let n=P(N(t,R(e)),e);return Z(n,e),n},r=te(e,n);return r===e?i.some(t=>{let r=n({...e,fields:t.fields});return te(e,()=>r)!==e})?void 0:e:r}if(a){let r=a.flatMap(e=>{let r=Ut(e,t,n);return r?[r]:[]}),i=n.promptAvailable?r.filter(e=>Wt(e,t,void 0)):[],o=r.find(e=>Wt(e,t,n.inheritedNames))??(i.length===1?i[0]:void 0);return o&&{...e,fields:o.fields}}return e}function Z(e,t){let n=/* @__PURE__ */ new Set;for(let r of t.fields)if(r.env&&e[r.name]===void 0)for(let t of[r.env].flat()){let i=process.env[t];if(i!==void 0){e[r.name]=re(i,r.type),n.add(r.name);break}}return n}function Wt(t,n,r){let i=N(n,R(t)),a=t.fields.filter(e=>e.named),o=new Set(a.flatMap(t=>[t.name,t.cliName,...e(t)]));if(Object.keys(i.options).some(e=>!o.has(e)))return!1;let s=I(t,i.options),c=i.positionals.length+i.rest.length;if(!s.some(e=>e.type===`array`)&&c>s.length)return!1;let l=P(i,t);return t.fields.some(e=>e.type!==`boolean`&&[l[e.name]].flat().includes(!0))?!1:r===void 0||(Z(l,t),t.fields.every(e=>!e.required||l[e.name]!==void 0||r.has(e.name)))}function Gt(e,t){if(e.length===0)return{};let n=R(t),r=N(e,n);return P(r,t)}function Kt(t,n){let r=t.indexOf(`--`),i=r>=0?t.slice(0,r):t,a=n?.fields.some(t=>t.overrideBuiltinAlias===!0&&e(t).includes(`H`))??!1,o=n?.fields.some(t=>t.overrideBuiltinAlias===!0&&e(t).includes(`h`))??!1,s=i.includes(`--help-all`)||!a&&i.includes(`-H`),c=i.includes(`--help-json`);return{helpRequested:!s&&!c&&(i.includes(`--help`)||!o&&i.includes(`-h`)),helpAllRequested:s,helpJsonRequested:c,versionRequested:i.includes(`--version`)}}function qt(e,t){return Jt([...e],t).globalParsed}function Jt(t,n,r){let i=Ft(n),o=new Set(r?.fields.map(e=>e.name)??[]),s=new Set(r?.fields.map(e=>e.cliName)??[]),c=r?R(r):void 0,l=new Set(c?.aliasMap?.keys()??[]),u=new Set(c?.negationMap?.keys()??[]),d=/* @__PURE__ */ new Set;for(let t of r?.fields??[])if(t.type===`boolean`&&t.negation===!0)for(let n of[t.cliName,...e(t)]){let e=`no-${n}`;d.add(e),d.add(a(e))}let f=[],p=[],m=[];for(let e=0;e<t.length;e++){let n=t[e];if(n===`--`){p.push(...t.slice(e));break}if(n.startsWith(`--`)){let{resolvedName:r,withoutDashes:a,isNegated:c,isGlobal:p,isSuppressedNegation:h}=It(n,i),g=r,_=o.has(a)||o.has(g)||s.has(a)||s.has(g)||l.has(a)||l.has(g)||u.has(a)||u.has(g)||d.has(a);if(p&&!_){e+=X(t,e,r,c,i.booleanFlags,f)-1;continue}if(h&&!_){m.push(a);continue}}else if(n.startsWith(`-`)&&n.length>1){let r=n.includes(`=`)?n.slice(1,n.indexOf(`=`)):n.slice(1);if(r.length===1){let n=i.aliasMap.get(r)??r;if((i.aliases.has(r)||i.flagNames.has(n))&&!l.has(r)){e+=X(t,e,n,!1,i.booleanFlags,f)-1;continue}}let a=Lt(t,e,i,e=>l.has(e));if(a>0){f.push(...t.slice(e,e+a)),e+=a-1;continue}}p.push(n)}return{separated:p,globalParsed:Gt(f,n),suppressedTokens:m}}function Q(e,n){return D(n)?w(e,n):t().validate(e,n)}function Yt(e){return e.map(e=>`${e.path.length>0?`${e.path.join(`.`)}: `:``}${e.message}`).join(`
33
- `)}function Xt(e,t){let n=[];for(let e=0;e<=t.length;e++)n[e]=[e];for(let t=0;t<=e.length;t++)n[0][t]=t;for(let r=1;r<=t.length;r++)for(let i=1;i<=e.length;i++)t.charAt(r-1)===e.charAt(i-1)?n[r][i]=n[r-1][i-1]:n[r][i]=Math.min(n[r-1][i-1]+1,n[r][i-1]+1,n[r-1][i]+1);return n[t.length][e.length]}function Zt(e,t){let n=Math.max(2,Math.floor(e.length/2));return t.map(t=>({candidate:t,distance:Xt(e.toLowerCase(),t.toLowerCase())})).filter(({distance:e})=>e<=n).sort((e,t)=>e.distance-t.distance).map(({candidate:e})=>e).slice(0,3)}function Qt(e,t){let n=Zt(e.replace(/^-{1,2}/,``),t),r=`${M.warning(`Warning: Unknown option:`)} ${M.bold(e)}`;if(n.length>0){r+=`\n\n${M.info(`Did you mean?`)}`;for(let e of n)r+=`\n ${j.arrow} ${M.option(`--${e}`)}`}return r}function $t(e,t){return t&&e.stack?`${M.error(`Error:`)} ${e.message}\n\n${M.dim(e.stack)}`:`${M.error(`Error:`)} ${e.message}`}function $(e){return new Proxy(e,{get(e,t,n){if(typeof t==`string`){if(t in e)return Reflect.get(e,t,n);let i=a(t);if(i!==t&&i in e)return Reflect.get(e,i,n);let o=r(t);if(o!==t&&o in e)return Reflect.get(e,o,n)}return Reflect.get(e,t,n)},has(e,t){if(typeof t==`string`){if(t in e)return!0;let n=a(t);if(n!==t&&n in e)return!0;let i=r(t);if(i!==t&&i in e)return!0}return Reflect.has(e,t)}})}async function en(e,t,n){for(let r of t.fields)r.effect&&await r.effect(i(e,r),{name:r.name,args:e,...n!=null&&{globalArgs:n}})}var tn=class extends Error{constructor(e){super(`Environment file not found: ${e}`),this.name=`EnvFileNotFoundError`}};function nn(e,t){return t.fields.flatMap(t=>{if(!t.envFile)return[];let n=t.envFile===`if-exists`;return e.flatMap(e=>[e[t.name]].flat().filter(e=>typeof e==`string`).map(e=>({path:e,ifExists:n})))})}function rn(e,t){return Object.fromEntries((t?.fields??[]).flatMap(t=>{if(!t.envFile||t.type!==`array`)return[];let n=e.flatMap(e=>[e[t.name]].flat());return n.length>0&&n.every(e=>typeof e==`string`)?[[t.name,n]]:[]}))}function an(e,t={}){sn(Array.isArray(e)?e:on(e,t.argv??process.argv.slice(2)))}function on(e,t){let n=T(e);return ln(n),Object.values(Kt(t)).some(Boolean)?[]:nn([qt(t,{...n,fields:n.fields.map(e=>e.envFile&&e.type===`string`?{...e,type:`array`}:e)})],n)}function sn(e){let t=e.flatMap(e=>{let t=oe.resolve(process.cwd(),e.path);if(!z.existsSync(t)){if(e.ifExists)return[];throw new tn(t)}return[ce(z.readFileSync(t,`utf-8`))]}),n=new Set(t.flatMap(e=>Object.keys(e)).filter(e=>typeof process.env[e]==`string`));for(let e of t)for(let[t,r]of Object.entries(e))n.has(t)||(process.env[t]=r)}function cn(e){return[...e.fields,...(e.variants??[]).flatMap(e=>e.fields),...(e.unionOptions??[]).flatMap(cn)]}function ln(e){let t=/* @__PURE__ */ new Map;for(let n of cn(e)){if(n.envFile&&n.type!==`string`&&n.type!==`array`)throw Error(`Global option "${n.name}" sets envFile but its value is not a string or an array of strings`);let e=t.get(n.name)??/* @__PURE__ */ new Set;e.add(n.envFile??!1),t.set(n.name,e)}for(let[e,n]of t)if(n.size>1)throw Error(`Global option "${e}" has different envFile settings across union variants (${[...n].map(e=>JSON.stringify(e)).join(`, `)}); use the same setting in every variant`)}const un={log:e=>console.log(e),error:e=>console.error(e),warn:e=>console.warn(e)};function dn(e){let t={};for(let[n,r]of Object.entries(e))try{t[n]=structuredClone(r)}catch{t[n]=r}return t}function fn(e,t){Object.defineProperty(e,"$source",{value:e=>t.get(e)??t.get(a(e))??t.get(r(e))??`default`,enumerable:!1})}function pn(e,t,n){let r=/* @__PURE__ */ new Map;for(let t of e)r.set(t,`cli`);for(let e of t)r.set(e,`env`);for(let e of n)r.set(e,`prompt`);return r}function mn(e,t){Object.defineProperty(e,"$invocation",{value:t,enumerable:!1})}function hn(e,t){Object.defineProperty(e,"$agent",{value:t,enumerable:!1})}function gn(e,t){return e&&(n=>e({...n,agent:t}))}function _n(e,t,n){if(!e.rawGlobalArgs)return;let r=new Set(n.fields.map(e=>e.name)),i={};for(let[t,n]of Object.entries(e.rawGlobalArgs))r.has(t)&&(i[t]=n);let a=new Set(Object.keys(i)),o=Z(i,n);for(let[t,n]of Object.entries(e.promptedGlobalArgs??{}))r.has(t)&&(o.delete(t),n===void 0?(delete i[t],a.delete(t)):i[t]=n);for(let n=0;n<=r.size;n++){let n=Q(i,t);if(n.success){let t=n.data,r=/* @__PURE__ */ new Map;for(let e of a)e in i&&r.set(e,`cli`);for(let e of o)e in i&&r.set(e,`env`);for(let[t,n]of Object.entries(e.promptedGlobalArgs??{}))n!==void 0&&t in i&&r.set(t,`prompt`);return fn(t,r),$(t)}let r=n.errors.map(e=>e.path[0]).filter(e=>e!==void 0&&Object.hasOwn(i,e));if(r.length===0){let e=Object.keys(i).filter(e=>{let{[e]:n,...r}=i;return Q(r,t).success});if(e.length!==1)return;r=e}for(let e of r)delete i[e]}}function vn(e,t,n,r){let i=e.success?void 0:e.error;if(e.success||t.effectsRan||!n||!r)return{error:i};try{return{error:i,globalArgs:_n(t,n,r)}}catch{return{error:i}}}function yn(e,t){let{agentHelp:n,_agent:r}=e;if(n&&r)return typeof n==`string`?n:n({agent:r,commandPath:t.commandPath??[]})}function bn(e,t){let n=t.commandPath?.at(-1)??e.name;return t.aliasFor?{name:n,aliasFor:t.aliasFor}:{name:n}}async function xn(e,t,n={}){let r=En(n),i=s(),a=gn(n.cleanup,i),o=n.captureLogs??!1,c=o?x():null;if(n.setup){c?.start();try{await n.setup({agent:i})}catch(e){let t=e instanceof Error?e:Error(String(e));if(a)try{await a({error:t})}catch{}return c?.stop(),{success:!1,error:t,exitCode:1,logs:c?.getLogs()??y()}}c?.stop()}let l={},u=await Tn(e,t,{...n,handleSignals:!1,_globalExtracted:r,_globalCleanup:a,_existingLogs:c?.getLogs(),_agent:i,_globalTrace:l});if(a){let e=o?x():null;e?.start();let t=vn(u,l,n.globalArgs,r);try{await a(t)}catch(t){if(u.success){let n=t instanceof Error?t:Error(String(t));return e?.stop(),{success:!1,error:n,exitCode:1,logs:b(u.logs,e?.getLogs()??y())}}}e?.stop();let i=e?.getLogs()??y();if(i.entries.length>0)return{...u,logs:b(u.logs,i)}}return u}function Sn(e,t,n){let r=Vt(t,n);return!r||!r.startsWith(`__`)?!1:Object.hasOwn(e.subCommands??{},r)}async function Cn(e,t={}){if(t.compileCache!==!1&&c(typeof t.compileCache==`string`?{cacheDir:t.compileCache}:{programName:e.name}),e.runMainHook)try{e.runMainHook(process.argv.slice(2))}catch{}let n=process.argv.slice(2),r;if(t.globalArgs)try{r=T(t.globalArgs)}catch{}let i=t;if(Sn(e,n,r)){let{setup:e,cleanup:n,prompt:r,globalArgs:a,...o}=t;i=o}let a=En(i),o=s(),l=gn(i.cleanup,o);if(i.skipValidation||kt(e),i.onUnknownSubcommand&&!e.run&&!Sn(e,n,r)){let t=_(e);if(t.size>0){let e=Bt(n,a,{stopOnSuppressedNegation:a?.unknownKeysMode!==`passthrough`}),r=e>=0?n[e]:void 0;if(r&&!t.has(r)){let t=n.slice(e+1),a=await i.onUnknownSubcommand({commandPath:[],name:r,args:t,precedingArgs:n.slice(0,e)});if(typeof a==`number`)return await wn(),process.exit(a)}}}if(i.setup)try{await i.setup({agent:o})}catch(e){let t=e instanceof Error?e:Error(String(e));if(l)try{await l({error:t})}catch{}process.exit(1)}let u={},d=await Tn(e,n,{debug:i.debug,captureLogs:i.captureLogs,skipValidation:i.skipValidation,handleSignals:!0,logger:i.logger,globalArgs:i.globalArgs,prompt:i.prompt,onUnknownSubcommand:i.onUnknownSubcommand,agentHelp:i.agentHelp,_globalExtracted:a,_globalCleanup:l,_agent:o,_globalTrace:u,_context:{commandPath:[],rootName:e.name,rootVersion:i.version,globalExtracted:a}});if((i.displayErrors??!0)&&!d.success&&d.error&&(i.logger??un).error($t(d.error,i.debug??!1)),l){let e=vn(d,u,i.globalArgs,a);try{await l(e)}catch{}}await wn(),process.exit(d.exitCode)}async function wn(){await Promise.all([process.stdout,process.stderr].map(e=>e.writableLength>0?new Promise(t=>e.write(``,()=>t())):Promise.resolve()))}async function Tn(e,t,r={}){let i=r.logger??un,a=r._context??{commandPath:[],rootName:e.name,globalExtracted:r._globalExtracted},o=r.captureLogs??!1?x():null;o?.start();let s=()=>{let e=r._existingLogs??y(),t=o?.getLogs()??y();return b(e,t)};try{r.skipValidation||kt(e);let c=(()=>{if(!r.onUnknownSubcommand||e.run||(a.commandPath??[]).length===0)return;let n=_(e);if(n.size===0)return;let i=Bt(t,r._globalExtracted,{stopOnSuppressedNegation:r._globalExtracted?.unknownKeysMode!==`passthrough`}),o=i>=0?t[i]:void 0;return o&&!n.has(o)?{positionalIndex:i,name:o}:void 0})(),d;try{d=Ht(t,e,{skipValidation:r.skipValidation,globalExtracted:r._globalExtracted,promptAvailable:r.prompt!==void 0,inheritedNames:new Set(Object.keys(r._parsedGlobalArgs??{})),beforeEnvFallback:e=>{r._globalExtracted&&!c&&(r._globalTrace&&(r._globalTrace.rawGlobalArgs={...r._parsedGlobalArgs,...e,...rn([r._parsedGlobalArgs??{},e??{}],r._globalExtracted)}),an(nn([...r._globalArgLevels??[],e??{}],r._globalExtracted)))}})}catch(e){if(!(e instanceof tn))throw e;return o?.stop(),{success:!1,error:e,exitCode:2,logs:s()}}let p={...r._parsedGlobalArgs,...d.rawGlobalArgs,...rn([r._parsedGlobalArgs??{},d.rawGlobalArgs??{}],r._globalExtracted)};r._globalTrace&&(r._globalTrace.rawGlobalArgs={...p});let h=a.commandPath??[],v=r.onUnknownSubcommand;if(c&&v){let{positionalIndex:e,name:n}=c;{let i=await v({commandPath:h,name:n,args:t.slice(e+1),precedingArgs:[...r._precedingArgs??[],...t.slice(0,e)]});if(typeof i==`number`){if(o?.stop(),r.handleSignals){if(r._globalCleanup)try{await r._globalCleanup({error:void 0})}catch{}await wn(),process.exit(i)}return i===0?{success:!0,result:void 0,exitCode:0,logs:s()}:{success:!1,error:/* @__PURE__ */ Error(`Plugin "${[...h,n].join(` `)}" exited with code ${i}`),exitCode:i,logs:s()}}}}if(d.helpRequested||d.helpAllRequested||d.helpJsonRequested){let n=!1,c=m(e),l=_(e);if(c.length>0){let e=Vt(t,a.globalExtracted);e&&!l.has(e)&&(n=!0)}let u=yn(r,a);if(d.helpJsonRequested){let t=Qe(e,{context:a,agentHelp:u});i.log(JSON.stringify(t))}else{let t=Xe(e,{showSubcommands:r.showSubcommands??!0,showSubcommandOptions:d.helpAllRequested||r.showSubcommandOptions,context:a,agentHelp:u});i.log(t)}if(o?.stop(),n){let e=Vt(t,a.globalExtracted)??``,n=Zt(e,[...l]),r=n.length>0?` Did you mean: ${n.join(`, `)}?`:``;return{success:!1,error:/* @__PURE__ */ Error(`Unknown subcommand: ${e}${r?`.${r}`:``}`),exitCode:2,logs:s()}}return{success:!0,result:void 0,exitCode:0,logs:s()}}if(d.unknownGlobalFlags&&d.unknownGlobalFlags.length>0){let e=a.globalExtracted?.unknownKeysMode??`strip`;if(e===`strict`)return o?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unknown flags: ${d.unknownGlobalFlags.join(`, `)}`),exitCode:2,logs:s()};if(e===`strip`){let e=a.globalExtracted?.fields.map(e=>e.name)??[];for(let t of d.unknownGlobalFlags)i.error(Qt(t,e))}}if(d.versionRequested){let e=a.rootVersion;return e&&i.log(e),o?.stop(),{success:!0,result:void 0,exitCode:0,logs:s()}}if(d.subCommand){let n=r._metadataOnly??!1,i=await l(e,d.subCommand,e=>{if(n)return!0;if(!e.requiredPackages?.length)return!1;let t=e,i=d.remainingArgs;for(;;){let e=Ht(i,t,{skipValidation:r.skipValidation,globalExtracted:a.globalExtracted,promptAvailable:!!r.prompt});if(e.helpRequested||e.helpAllRequested||e.helpJsonRequested||e.versionRequested)return n=!0,!0;if(!e.subCommand||!t.subCommands)return!1;let o=Object.hasOwn(t.subCommands,e.subCommand)?e.subCommand:f(t,e.subCommand)??e.subCommand,s=t.subCommands[o],c=s?u(s):null;if(!c)return!1;t=c,i=e.remainingArgs}});if(i){let e={commandPath:[...a.commandPath??[],d.subCommand],rootName:a.rootName,rootVersion:a.rootVersion,globalExtracted:a.globalExtracted,aliasFor:i.aliasFor};o?.stop();let c=new Set(r._globalExtracted?.unknownKeysMode===`passthrough`?[]:d.unknownGlobalFlags??[]),l=e=>e.startsWith(`--`)&&c.has(ne(e)),u=t.slice(0,t.length-d.remainingArgs.length-1).filter(e=>!l(e));return Tn(i.command,d.remainingArgs,{...r,_metadataOnly:n,_context:e,_existingLogs:s(),_parsedGlobalArgs:p,_globalArgLevels:[...r._globalArgLevels??[],d.rawGlobalArgs??{}],_precedingArgs:[...r._precedingArgs??[],...u]})}}let y=d.positionalSlotFields??[],b=y.some(e=>e.type===`array`),x=[...d.positionals,...d.rest],S=b?[]:x.slice(y.length),C=b?[]:d.positionals.slice(y.length);if(d.matchesNoUnionOption)return o?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Arguments match none of the accepted forms. See --help for the accepted forms.`),exitCode:2,logs:s()};let w=_(e),T=w.size>0?C.find(e=>!e.startsWith(`-`)&&!w.has(e)):void 0;if(T){let e=Zt(T,[...w]),t=e.length>0?` Did you mean: ${e.join(`, `)}?`:``;return o?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unknown subcommand: ${T}${t?`.${t}`:``}`),exitCode:2,logs:s()}}if(d.unknownFlags.length>0){let e=d.extractedFields?.unknownKeysMode??a.globalExtracted?.unknownKeysMode??`strip`,t=d.optionFields?.map(e=>e.name)??a.globalExtracted?.fields.map(e=>e.name)??[];if(e===`strict`)return o?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unknown flags: ${d.unknownFlags.join(`, `)}`),exitCode:2,logs:s()};if(e===`strip`)for(let e of d.unknownFlags)i.error(Qt(e,t))}if(m(e).length>0&&!d.subCommand&&!e.run&&S.length===0){if(e.defaultSubCommand){let n=e.subCommands?.[e.defaultSubCommand];if(n){let i=await g(n),c={commandPath:[...a.commandPath??[],e.defaultSubCommand],rootName:a.rootName,rootVersion:a.rootVersion,globalExtracted:a.globalExtracted};o?.stop();let l=new Set(r._globalExtracted?.unknownKeysMode===`passthrough`?[]:d.unknownGlobalFlags??[]),u=e=>e.startsWith(`--`)&&l.has(ne(e)),f=t.filter(e=>!u(e));return Tn(i,[],{...r,_context:c,_existingLogs:s(),_parsedGlobalArgs:p,_globalArgLevels:[...r._globalArgLevels??[],d.rawGlobalArgs??{}],_precedingArgs:[...r._precedingArgs??[],...f]})}}if(r.globalArgs&&r._globalExtracted){let e={...p};Z(e,r._globalExtracted);let t=Q(e,r.globalArgs),n=t.success?[]:t.errors.filter(t=>t.path[0]&&e[t.path[0]]!==void 0);if(n.length>0)return o?.stop(),{success:!1,error:Error(Yt(n)),exitCode:2,logs:s()}}let n=Xe(e,{showSubcommands:r.showSubcommands??!0,context:a,agentHelp:yn(r,a)});return i.log(n),o?.stop(),{success:!0,result:void 0,exitCode:0,logs:s()}}if(S.length>0){let e=d.extractedFields?.unknownKeysMode??`strip`;if(e===`strict`)return o?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unexpected positional argument${S.length>1?`s`:``}: ${S.join(`, `)}`),exitCode:2,logs:s()};if(e===`strip`)for(let e of S)(i.warn??i.error)(`Warning: Unexpected positional argument: ${e}`)}let E={},D=e.name===`__complete`,O=new Set(Object.keys(p)),k=/* @__PURE__ */ new Set,A=/* @__PURE__ */ new Set;if(r.globalArgs&&r._globalExtracted&&!D){if(k=Z(p,r._globalExtracted),r.prompt){let e=dn(p);try{let e=await r.prompt(p,r._globalExtracted,{globalArgs:p});for(let[t,n]of Object.entries(e))n!==void 0&&(p[t]=n)}finally{let t={};for(let n of/* @__PURE__ */ new Set([...Object.keys(e),...Object.keys(p)])){let r=p[n];se(e[n],r)||(t[n]=r,r===void 0&&(O.delete(n),k.delete(n)))}A=new Set(Object.keys(t).filter(e=>t[e]!==void 0)),r._globalTrace&&(r._globalTrace.promptedGlobalArgs=t)}}let e=Q(p,r.globalArgs);if(!e.success)return o?.stop(),{success:!1,error:Error(Yt(e.errors)),exitCode:2,logs:s()};E=e.data}let j=r.globalArgs&&r._globalExtracted&&!D?ee(r._globalExtracted,e=>Q(p,e).success,()=>p):r._globalExtracted,M=D||!r._globalExtracted?void 0:j===r._globalExtracted?te(r._globalExtracted,()=>E).fields:j?.fields;if(!e.args){let t=pn(O,k,A);fn(E,t),mn(E,bn(e,a)),hn(E,r._agent);let n=$(E);return r._globalExtracted&&!D&&(r._globalTrace&&(r._globalTrace.effectsRan=!0),await en(n,j,n)),o?.stop(),await ue(e,n,{handleSignals:r.handleSignals,captureLogs:r.captureLogs,existingLogs:s(),globalCleanup:r._globalCleanup,packageDiscriminators:r._globalExtracted?.discriminator?[r._globalExtracted.discriminator]:[],packageFields:M})}let N=d.rawArgs,re=r.prompt?dn(d.rawArgs):d.rawArgs,P=e=>Object.hasOwn(re,e),ie=/* @__PURE__ */ new Set;if(r.prompt&&d.extractedFields){let e=await r.prompt(N,d.extractedFields,{globalArgs:E}),t={...N};for(let[n,r]of Object.entries(e))r!==void 0&&(t[n]=r);N=t;for(let[e,t]of Object.entries(N))t===void 0||P(e)&&se(re[e],t)||ie.add(e)}let F=Q(N,e.args);if(!F.success)return o?.stop(),{success:!1,error:Error(Yt(F.errors)),exitCode:2,logs:s()};let I=$(F.data),ae=pn(O,k,A);fn(E,ae),mn(E,bn(e,a)),hn(E,r._agent);let L=$(E);r._globalExtracted&&!D&&(r._globalTrace&&(r._globalTrace.effectsRan=!0),await en(L,j,L));let R=d.extractedFields?D?d.extractedFields:ee(d.extractedFields,e=>Q(N,e).success,()=>N):void 0;R&&!D&&await en(I,R,L);let z=n({...L},{...I},j?.fields??[],R?.fields??[]),oe=new Map(ae),ce=d.envFallbackFields??/* @__PURE__ */ new Set;for(let e of d.extractedFields?.fields??[]){let t=N[e.name]!==void 0;oe.set(e.name,ie.has(e.name)?`prompt`:t&&ce.has(e.name)?`env`:t&&P(e.name)?`cli`:`default`)}fn(z,oe),mn(z,bn(e,a)),hn(z,r._agent);let le=$(z);return o?.stop(),await ue(e,le,{handleSignals:r.handleSignals,captureLogs:r.captureLogs,existingLogs:s(),globalCleanup:r._globalCleanup,packageDiscriminators:[d.extractedFields?.discriminator,r._globalExtracted?.discriminator].filter(e=>e!==void 0),packageFields:D?void 0:[...M??[],...R!==d.extractedFields&&R?R.fields:[...d.optionFields??[],...d.positionalSlotFields??[]]]})}catch(e){let t=e instanceof Error?e:Error(String(e));return o?.stop(),{success:!1,error:t,exitCode:1,logs:s()}}}function En(e){if(!e.globalArgs)return;let t=T(e.globalArgs);if(!e.skipValidation){_t(t),Ct(t),vt(t),St(t),bt(t,!0),xt(t),ln(t);let e=t.fields.filter(e=>e.positional).map(e=>e.name);if(e.length>0)throw Error(`Global options schema must not contain positional arguments. Found: ${e.join(`, `)}`)}return t}export{ge as A,ct as C,Xe as D,ot as E,Qe as O,at as S,tt as T,xt as _,$ as a,rt as b,Ct as c,kt as d,vt as f,bt as g,yt as h,an as i,B as k,Mt as l,St as m,Cn as n,Yt as o,_t as p,tn as r,Pt as s,xn as t,Et as u,it as v,et as w,nt as x,st as y};
@@ -1 +0,0 @@
1
- export{t as runCommand}from"./runner-DiDJDnhR.js";