@politty/loculus 0.3.1 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (45) hide show
  1. package/dist/agent.d.ts +1 -1
  2. package/dist/{argv-parser-CVlS6mSo.js → argv-parser-CVXuhpy6.js} +1 -1
  3. package/dist/cli-main-CTVeQxs0.js +1 -0
  4. package/dist/{cli-main-Cx6DmWu3.js → cli-main-CdXCj3sh.js} +2 -2
  5. package/dist/cli-run-x5wuUkuB.js +1 -0
  6. package/dist/cli.js +1 -1
  7. package/dist/compile-cache.d.ts +1 -3
  8. package/dist/{completion-D37Zai_i.js → completion-ChgOYSFp.js} +1 -1
  9. package/dist/completion-Df9_25sa.js +1 -0
  10. package/dist/completion.d.ts +2 -22
  11. package/dist/completion.js +1 -1
  12. package/dist/{detect-agent-EHaSY1KW.d.ts → detect-agent-hU93hctO.d.ts} +0 -4
  13. package/dist/docs.d.ts +1 -21
  14. package/dist/docs.js +32 -32
  15. package/dist/{dynamic-B9VSmsXq.js → dynamic-D2uon-av.js} +2 -2
  16. package/dist/dynamic-plXaUNoz.js +1 -0
  17. package/dist/index.d.ts +16 -48
  18. package/dist/index.js +1 -1
  19. package/dist/prompt-CHjlvNAb.js +1 -0
  20. package/dist/prompt-clack.d.ts +2 -4
  21. package/dist/prompt-clack.js +1 -1
  22. package/dist/prompt-inquirer.d.ts +2 -4
  23. package/dist/prompt-inquirer.js +1 -1
  24. package/dist/prompt.d.ts +2 -10
  25. package/dist/prompt.js +1 -1
  26. package/dist/{register-Ceh-HlVN.js → register-D-aEK58y.js} +1 -1
  27. package/dist/{registry-BEz5iex_.js → registry-ZnSdmqJ1.js} +1 -1
  28. package/dist/runner-BbIyh52c.js +33 -0
  29. package/dist/runner-fgBRxl0e.js +1 -0
  30. package/dist/{schema-Ccdtx6Fd.js → schema-Bz8oC0xQ.js} +1 -1
  31. package/dist/schema-extractor-BI5ypJ21.js +1 -0
  32. package/dist/skill.d.ts +7 -22
  33. package/dist/skill.js +1 -1
  34. package/dist/{types-DYO1Dh4o.d.ts → types-D3ubanZt.d.ts} +54 -30
  35. package/dist/{with-completion-command-DYZd08Ky.d.ts → with-completion-command-BkTioGwX.d.ts} +1 -9
  36. package/dist/{with-completion-command-DZP83Co7.js → with-completion-command-DOtEG943.js} +2 -2
  37. package/package.json +2 -2
  38. package/dist/cli-main-CBlfe4QR.js +0 -1
  39. package/dist/cli-run-DQ3DNc6d.js +0 -1
  40. package/dist/completion-D3WpCdG7.js +0 -1
  41. package/dist/dynamic-B8Yep4zr.js +0 -1
  42. package/dist/prompt-kT9Mbbbb.js +0 -1
  43. package/dist/runner-BANYbib6.js +0 -1
  44. package/dist/runner-CR1RobTC.js +0 -33
  45. package/dist/schema-extractor-BjPHWzBq.js +0 -1
@@ -1,5 +1,4 @@
1
- import { t as AgentInfo } from "./detect-agent-EHaSY1KW.js";
2
- //#region ../core/src/adapter/standard-schema.d.ts
1
+ import { t as AgentInfo } from "./detect-agent-hU93hctO.js";
3
2
  /**
4
3
  * Type-level subset of the Standard Schema V1 interface
5
4
  * (https://standardschema.dev), vendored so `@politty/core` can constrain
@@ -44,8 +43,6 @@ interface SchemaLike<Output = unknown> {
44
43
  }
45
44
  /** Infer the output type of a {@link SchemaLike}. */
46
45
  type InferSchemaOutput<S> = S extends SchemaLike ? NonNullable<S["~standard"]["types"]>["output"] : never;
47
- //#endregion
48
- //#region ../core/src/package-requirements.d.ts
49
46
  interface PackageRequirement<TArgs = unknown> {
50
47
  name: string;
51
48
  install?: string | undefined;
@@ -54,8 +51,6 @@ interface PackageRequirement<TArgs = unknown> {
54
51
  when?: ((args: TArgs) => boolean) | undefined;
55
52
  }
56
53
  declare function loadPackage<TModule = unknown>(requirement: Pick<PackageRequirement, "name" | "install" | "from">): Promise<TModule>;
57
- //#endregion
58
- //#region ../core/src/core/dynamic-completion-types.d.ts
59
54
  /**
60
55
  * Types for in-process dynamic value completion.
61
56
  *
@@ -111,8 +106,6 @@ interface DynamicCompletionResult {
111
106
  directive?: CompletionDirectiveMask;
112
107
  }
113
108
  type DynamicCompletionResolver = (ctx: DynamicCompletionContext) => DynamicCompletionResult | Promise<DynamicCompletionResult>;
114
- //#endregion
115
- //#region ../core/src/core/expand-completion-types.d.ts
116
109
  /**
117
110
  * Types for "expand" completion — candidates that depend on sibling arg
118
111
  * values.
@@ -157,8 +150,6 @@ interface ExpandCompletion {
157
150
  dependsOn: readonly string[];
158
151
  enumerate: (deps: Readonly<Record<string, string>>) => ReadonlyArray<string | ExpandCandidate>;
159
152
  }
160
- //#endregion
161
- //#region ../core/src/core/arg-registry.d.ts
162
153
  /**
163
154
  * Built-in completion types
164
155
  */
@@ -245,6 +236,15 @@ type CompletionMeta = {
245
236
  * - "directory": directory path input (inherited from completion type)
246
237
  */
247
238
  type PromptType = "text" | "password" | "confirm" | "select" | "file" | "directory";
239
+ interface PromptChoicesContext {
240
+ rawArgs: Readonly<Record<string, unknown>>;
241
+ globalArgs: Readonly<Record<string, unknown>>;
242
+ }
243
+ type PromptChoices = Array<string | {
244
+ label: string;
245
+ value: string;
246
+ }>;
247
+ type PromptChoicesResolver = (context: PromptChoicesContext) => PromptChoices | Promise<PromptChoices>;
248
248
  /**
249
249
  * Prompt metadata for interactive input when a value is missing.
250
250
  * Used by the `politty/prompt` module to request user input for unresolved arguments.
@@ -273,10 +273,7 @@ interface PromptMeta {
273
273
  /** Explicit prompt type. Overrides auto-detection from schema/completion. */
274
274
  type?: PromptType;
275
275
  /** Choices for select prompt. Overrides enum values from schema. */
276
- choices?: Array<string | {
277
- label: string;
278
- value: string;
279
- }>;
276
+ choices?: PromptChoices | PromptChoicesResolver;
280
277
  /** Whether to enable prompting for this field (default: true when prompt is set) */
281
278
  enabled?: boolean;
282
279
  }
@@ -331,6 +328,24 @@ interface BaseArgMeta<TValue = unknown> {
331
328
  * ```
332
329
  */
333
330
  env?: string | string[];
331
+ /**
332
+ * Treat this global option's value(s) as env file path(s) and load them into
333
+ * `process.env` before any `env` fallback is applied, like Node.js
334
+ * `--env-file`. `true` fails when a file does not exist; `"if-exists"`
335
+ * skips a missing file, like `--env-file-if-exists`.
336
+ *
337
+ * Only meaningful on a `globalArgs` option whose value is a string or an array of
338
+ * strings. Files load in option declaration order, then in the order given on
339
+ * the command line (outer command first); a later file overrides an earlier
340
+ * one, and variables already set in the environment are never overridden.
341
+ *
342
+ * @example
343
+ * ```ts
344
+ * "env-file": arg(z.string().array().optional(), { alias: "e", envFile: true }),
345
+ * "env-file-if-exists": arg(z.string().array().optional(), { envFile: "if-exists" }),
346
+ * ```
347
+ */
348
+ envFile?: boolean | "if-exists";
334
349
  /** Completion configuration for shell tab-completion */
335
350
  completion?: CompletionMeta;
336
351
  /**
@@ -539,14 +554,10 @@ interface ArgFn<TSchemaBase extends SchemaLike = SchemaLike> {
539
554
  <T extends TSchemaBase>(schema: T): T;
540
555
  <T extends TSchemaBase, M extends ArgMeta<InferSchemaOutput<T>>>(schema: T, meta: ValidateArgMeta<M, InferSchemaOutput<T>>): T;
541
556
  }
542
- //#endregion
543
- //#region ../core/src/adapter/unflatten.d.ts
544
557
  /** Where a flat field's value sits in the nested output */
545
558
  interface NestedFieldInfo {
546
559
  path: readonly string[];
547
560
  }
548
- //#endregion
549
- //#region ../core/src/adapter/field-meta.d.ts
550
561
  /**
551
562
  * Resolved metadata for an argument field
552
563
  */
@@ -580,6 +591,8 @@ interface ResolvedFieldMeta {
580
591
  * If an array, earlier entries take priority.
581
592
  */
582
593
  env?: string | string[] | undefined;
594
+ /** Load the value(s) as env file path(s); `"if-exists"` skips a missing file */
595
+ envFile?: boolean | "if-exists" | undefined;
583
596
  /** Whether this argument is required */
584
597
  required: boolean;
585
598
  /** Default value if any */
@@ -688,8 +701,6 @@ declare function toKebabCase(str: string): string;
688
701
  * @example toCamelCase("dryRun") => "dryRun"
689
702
  */
690
703
  declare function toCamelCase(str: string): string;
691
- //#endregion
692
- //#region ../core/src/lazy.d.ts
693
704
  /**
694
705
  * A lazily-loaded command that carries synchronous metadata for
695
706
  * static analysis (completion, help) while deferring full module
@@ -733,8 +744,6 @@ declare function isLazyCommand(value: unknown): value is LazyCommand;
733
744
  * ```
734
745
  */
735
746
  declare function lazy<T extends AnyCommand>(meta: T, load: () => Promise<AnyCommand>): LazyCommand<T>;
736
- //#endregion
737
- //#region ../core/src/types.d.ts
738
747
  /**
739
748
  * Global args interface for declaration merging (Pattern 3).
740
749
  * Users can extend this interface to add global options to all commands:
@@ -754,10 +763,11 @@ type IsEmpty<T> = keyof T extends never ? true : false;
754
763
  * Where a resolved arg value came from:
755
764
  * - `"cli"`: an explicit CLI token (flag or positional)
756
765
  * - `"env"`: `field.env` fallback (no CLI token was provided)
757
- * - `"default"`: neither of the above (e.g. a schema default, or a value
758
- * resolved by a `prompt` handler)
766
+ * - `"prompt"`: answered by a `prompt` resolver, whether returned or written
767
+ * into its `rawArgs` in place
768
+ * - `"default"`: none of the above (e.g. a schema default)
759
769
  */
760
- type ArgSource = "cli" | "env" | "default";
770
+ type ArgSource = "cli" | "env" | "prompt" | "default";
761
771
  /**
762
772
  * Identifies the CLI name a command was invoked with in the current run.
763
773
  * - `name`: the literal token typed on the CLI to reach this command
@@ -966,12 +976,19 @@ type SubCommandValue = AnyCommand | (() => Promise<AnyCommand>) | LazyCommand;
966
976
  * Record of subcommands indexed by name
967
977
  */
968
978
  type SubCommandsRecord = Record<string, SubCommandValue>;
979
+ /**
980
+ * Shared-argument context passed from the runner to a {@link PromptResolver}.
981
+ */
982
+ interface PromptResolverContext {
983
+ /** Validated global args for command prompts, or values resolved so far for global prompts */
984
+ globalArgs: Record<string, unknown>;
985
+ }
969
986
  /**
970
987
  * Async callback to resolve missing argument values interactively.
971
988
  * Called after env fallback, before schema validation.
972
989
  * Provided by adapter subpath modules (e.g. `politty/prompt/clack`).
973
990
  */
974
- type PromptResolver = (rawArgs: Record<string, unknown>, extracted: ExtractedFields) => Promise<Record<string, unknown>>;
991
+ type PromptResolver = (rawArgs: Record<string, unknown>, extracted: ExtractedFields, context?: PromptResolverContext) => Promise<Record<string, unknown>>;
975
992
  /**
976
993
  * Options for runMain (CLI entry point)
977
994
  */
@@ -982,7 +999,11 @@ interface MainOptions {
982
999
  debug?: boolean;
983
1000
  /** Capture console and process.stdout/stderr output during execution (default: false) */
984
1001
  captureLogs?: boolean;
985
- /** Skip command definition validation (useful in production where tests already verified) */
1002
+ /**
1003
+ * Skip command definition validation (useful in production where tests already verified).
1004
+ * A field declared in both `globalArgs` and a command's `args` is then not rejected, and
1005
+ * the command's value wins.
1006
+ */
986
1007
  skipValidation?: boolean;
987
1008
  /** Custom logger for output (default: console) */
988
1009
  logger?: Logger;
@@ -1065,7 +1086,11 @@ interface RunCommandOptions {
1065
1086
  debug?: boolean;
1066
1087
  /** Capture console and process.stdout/stderr output during execution (default: false) */
1067
1088
  captureLogs?: boolean;
1068
- /** Skip command definition validation (useful in production where tests already verified) */
1089
+ /**
1090
+ * Skip command definition validation (useful in production where tests already verified).
1091
+ * A field declared in both `globalArgs` and a command's `args` is then not rejected, and
1092
+ * the command's value wins.
1093
+ */
1069
1094
  skipValidation?: boolean;
1070
1095
  /** Custom logger for output (default: console) */
1071
1096
  logger?: Logger;
@@ -1155,5 +1180,4 @@ interface RunResultFailure {
1155
1180
  * Result of command execution (discriminated union)
1156
1181
  */
1157
1182
  type RunResult<T = unknown> = RunResultSuccess<T> | RunResultFailure;
1158
- //#endregion
1159
- export { DynamicCompletionCandidate as $, SubCommandsRecord as A, ArgFn as B, RunInvocation as C, RunnableCommand as D, RunResultSuccess as E, ExtractedFields as F, EffectContext as G, CompletionMeta as H, ResolvedFieldMeta as I, ValidateArgMeta as J, PromptMeta as K, UnknownKeysMode as L, LazyCommand as M, isLazyCommand as N, SetupContext as O, lazy as P, CompletionDirectiveMask as Q, toCamelCase as R, RunCommandOptions as S, RunResultFailure as T, CompletionType as U, ArgMeta as V, CustomCompletion as W, ExpandCompletion as X, ExpandCandidate as Y, ResolvedExpandCandidate as Z, LogStream as _, ArgsSchema as a, InferSchemaOutput as at, NonRunnableCommand as b, Command as c, GlobalArgs as d, DynamicCompletionContext as et, GlobalCleanupContext as f, LogLevel as g, LogEntry as h, ArgSource as i, loadPackage as it, UnknownSubcommandHandler as j, SubCommandValue as k, CommandBase as l, IsEmpty as m, AgentHelpContext as n, DynamicCompletionResult as nt, CleanupContext as o, SchemaLike as ot, GlobalSetupContext as p, PromptType as q, AnyCommand as r, PackageRequirement as rt, CollectedLogs as s, AgentHelp as t, DynamicCompletionResolver as tt, Example as u, Logger as v, RunResult as w, PromptResolver as x, MainOptions as y, toKebabCase as z };
1183
+ export { ExpandCandidate as $, SubCommandValue as A, toKebabCase as B, RunCommandOptions as C, RunResultSuccess as D, RunResultFailure as E, lazy as F, CustomCompletion as G, ArgMeta as H, ExtractedFields as I, PromptChoicesContext as J, EffectContext as K, ResolvedFieldMeta as L, UnknownSubcommandHandler as M, LazyCommand as N, RunnableCommand as O, isLazyCommand as P, ValidateArgMeta as Q, UnknownKeysMode as R, PromptResolverContext as S, RunResult as T, CompletionMeta as U, ArgFn as V, CompletionType as W, PromptMeta as X, PromptChoicesResolver as Y, PromptType as Z, LogStream as _, ArgsSchema as a, DynamicCompletionResolver as at, NonRunnableCommand as b, Command as c, loadPackage as ct, GlobalArgs as d, ExpandCompletion as et, GlobalCleanupContext as f, LogLevel as g, LogEntry as h, ArgSource as i, DynamicCompletionContext as it, SubCommandsRecord as j, SetupContext as k, CommandBase as l, InferSchemaOutput as lt, IsEmpty as m, AgentHelpContext as n, CompletionDirectiveMask as nt, CleanupContext as o, DynamicCompletionResult as ot, GlobalSetupContext as p, PromptChoices as q, AnyCommand as r, DynamicCompletionCandidate as rt, CollectedLogs as s, PackageRequirement as st, AgentHelp as t, ResolvedExpandCandidate as tt, Example as u, SchemaLike as ut, Logger as v, RunInvocation as w, PromptResolver as x, MainOptions as y, toCamelCase as z };
@@ -1,5 +1,4 @@
1
- import { L as UnknownKeysMode, V as ArgMeta, Z as ResolvedExpandCandidate, a as ArgsSchema, r as AnyCommand, tt as DynamicCompletionResolver } from "./types-DYO1Dh4o.js";
2
- //#region ../core/src/adapter/internal-args.d.ts
1
+ import { H as ArgMeta, R as UnknownKeysMode, a as ArgsSchema, at as DynamicCompletionResolver, r as AnyCommand, tt as ResolvedExpandCandidate } from "./types-D3ubanZt.js";
3
2
  /** Runtime brand distinguishing internal descriptors from library schemas. */
4
3
  declare const INTERNAL_ARGS_BRAND = "__polittyInternalArgs";
5
4
  type InternalFieldKind = "string" | "boolean" | "enum" | "string-array";
@@ -37,8 +36,6 @@ type InternalArgsSchema<TOut extends Record<string, unknown> = Record<string, un
37
36
  type InferInternalArgs<S> = S extends {
38
37
  readonly __out?: infer TOut;
39
38
  } ? NonNullable<TOut> : never;
40
- //#endregion
41
- //#region ../core/src/completion/types.d.ts
42
39
  /**
43
40
  * A single resolved entry in an "expand" lookup table.
44
41
  *
@@ -305,8 +302,6 @@ interface CompletionResult {
305
302
  * Generator function type for shell completions
306
303
  */
307
304
  type CompletionGenerator = (command: AnyCommand, options: CompletionOptions) => CompletionResult;
308
- //#endregion
309
- //#region ../core/src/completion/bundled-worker.d.ts
310
305
  interface GenerateBundledCompletionWorkerOptions {
311
306
  /** CLI binary or built JS entry file to invoke. */
312
307
  bin: string;
@@ -337,8 +332,6 @@ declare function bundledWorkerShellExtension(shell: ShellType): string;
337
332
  declare function defaultBundledWorkerOutputPath(shell: ShellType): string;
338
333
  declare function validateBundledWorkerFile(path: string, programName: string, shell: ShellType): void;
339
334
  declare function generateBundledCompletionWorker(options: GenerateBundledCompletionWorkerOptions): Promise<GenerateBundledCompletionWorkerResult>;
340
- //#endregion
341
- //#region ../core/src/completion/with-completion-command.d.ts
342
335
  /**
343
336
  * Options for withCompletionCommand
344
337
  */
@@ -380,5 +373,4 @@ interface WithCompletionOptions {
380
373
  * ```
381
374
  */
382
375
  declare function withCompletionCommand<T extends AnyCommand>(command: T, options?: string | WithCompletionOptions): T;
383
- //#endregion
384
376
  export { CompletionResult as _, bundledWorkerShellExtension as a, InferInternalArgs as b, validateBundledWorkerFile as c, CompletablePositional as d, CompletableSubcommand as f, CompletionOptions as g, CompletionMode as h, GenerateBundledCompletionWorkerResult as i, BundledWorkerOptions as l, CompletionGenerator as m, withCompletionCommand as n, defaultBundledWorkerOutputPath as o, CompletionData as p, GenerateBundledCompletionWorkerOptions as r, generateBundledCompletionWorker as s, WithCompletionOptions as t, CompletableOption as u, ShellType as v, InternalArgsSchema as x, ValueCompletion as y };
@@ -1,3 +1,3 @@
1
- import{h as e,m as t}from"./schema-extractor-BjPHWzBq.js";import{n}from"./command-BXsTrIgI.js";import{s as r}from"./subcommand-router-40vA6Mka.js";import{t as i}from"./schema-Ccdtx6Fd.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{g as e,h as t}from"./schema-extractor-BI5ypJ21.js";import{n}from"./command-BXsTrIgI.js";import{s as r}from"./subcommand-router-40vA6Mka.js";import{t as i}from"./schema-Bz8oC0xQ.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=t({shell:e.optionalEnum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell type (bash, zsh, or fish)`,placeholder:`SHELL`}),instructions:e.boolean({alias:`i`,description:`Show installation instructions`}),loader:e.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:e.boolean({description:`Write the completion script to its on-disk cache (bash/zsh) or autoload location (fish) instead of printing it.`}),static:e.boolean({description:`Generate the legacy static completion script with command metadata baked in.`}),dispatcher:e.boolean({description:`Generate the runtime dispatcher completion script. This is the default.`}),worker:e.boolean({description:`Generate an internal static worker artifact for dispatcher mode.`})}),g=t({shell:e.enum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell to refresh`,placeholder:`SHELL`}),target:e.optionalString({positional:!0,description:`Existing politty-generated completion file to refresh`,placeholder:`TARGET`}),static:e.boolean({description:`Refresh using the legacy static completion script mode.`}),worker:e.boolean({description:`Refresh an internal static worker completion script.`})}),_=t({shell:e.enum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell worker to locate`,placeholder:`SHELL`})});function v(e,t){let{programName:a,globalArgsSchema:o,cacheDir:s,programVersion:c,bundledWorker:l}=typeof t==`string`?{programName:t}:t??{},u=a??e.name,d={...s!==void 0&&{cacheDir:s},...c!==void 0&&{programVersion:c},...o!==void 0&&{globalArgsSchema:o},...l!==void 0&&{bundledWorker:l}},f={...e};return f.subCommands={...e.subCommands,completion:r(n({name:`completion`,description:`Generate shell completion script`,args:h,run(){}}),()=>import(`./completion-D3WpCdG7.js`).then(e=>e.createCompletionCommand(f,a,o,d))),__complete:r(n({name:`__complete`,args:i,run(){}}),()=>import(`./dynamic-B8Yep4zr.js`).then(e=>e.createDynamicCompleteCommand(f,a,o))),"__refresh-completion":r(n({name:`__refresh-completion`,description:`(internal) Refresh the on-disk completion cache if stale.`,args:g,run(){}}),()=>import(`./completion-D3WpCdG7.js`).then(e=>e.createRefreshCompletionCommand(f,u,d))),"__completion-worker-path":r(n({name:`__completion-worker-path`,description:`(internal) Print the bundled completion worker path when available.`,args:_,run(){}}),()=>import(`./completion-D3WpCdG7.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=t({shell:e.optionalEnum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell type (bash, zsh, or fish)`,placeholder:`SHELL`}),instructions:e.boolean({alias:`i`,description:`Show installation instructions`}),loader:e.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:e.boolean({description:`Write the completion script to its on-disk cache (bash/zsh) or autoload location (fish) instead of printing it.`}),static:e.boolean({description:`Generate the legacy static completion script with command metadata baked in.`}),dispatcher:e.boolean({description:`Generate the runtime dispatcher completion script. This is the default.`}),worker:e.boolean({description:`Generate an internal static worker artifact for dispatcher mode.`})}),g=t({shell:e.enum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell to refresh`,placeholder:`SHELL`}),target:e.optionalString({positional:!0,description:`Existing politty-generated completion file to refresh`,placeholder:`TARGET`}),static:e.boolean({description:`Refresh using the legacy static completion script mode.`}),worker:e.boolean({description:`Refresh an internal static worker completion script.`})}),_=t({shell:e.enum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell worker to locate`,placeholder:`SHELL`})});function v(e,t){let{programName:a,globalArgsSchema:o,cacheDir:s,programVersion:c,bundledWorker:l}=typeof t==`string`?{programName:t}:t??{},u=a??e.name,d={...s!==void 0&&{cacheDir:s},...c!==void 0&&{programVersion:c},...o!==void 0&&{globalArgsSchema:o},...l!==void 0&&{bundledWorker:l}},f={...e};return f.subCommands={...e.subCommands,completion:r(n({name:`completion`,description:`Generate shell completion script`,args:h,run(){}}),()=>import(`./completion-Df9_25sa.js`).then(e=>e.createCompletionCommand(f,a,o,d))),__complete:r(n({name:`__complete`,args:i,run(){}}),()=>import(`./dynamic-plXaUNoz.js`).then(e=>e.createDynamicCompleteCommand(f,a,o))),"__refresh-completion":r(n({name:`__refresh-completion`,description:`(internal) Refresh the on-disk completion cache if stale.`,args:g,run(){}}),()=>import(`./completion-Df9_25sa.js`).then(e=>e.createRefreshCompletionCommand(f,u,d))),"__completion-worker-path":r(n({name:`__completion-worker-path`,description:`(internal) Print the bundled completion worker path when available.`,args:_,run(){}}),()=>import(`./completion-Df9_25sa.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/loculus",
3
- "version": "0.3.1",
3
+ "version": "0.4.1",
4
4
  "description": "Politty CLI framework with flat loculus schemas",
5
5
  "keywords": [
6
6
  "argument-parser",
@@ -76,7 +76,7 @@
76
76
  },
77
77
  "devDependencies": {
78
78
  "@politty/core": "0.1.0",
79
- "@types/node": "25.9.9",
79
+ "@types/node": "26.6.5",
80
80
  "@typescript/native-preview": "7.0.0-dev.20260707.2",
81
81
  "loculus": "0.4.1",
82
82
  "tsdown": "0.23.1",
@@ -1 +0,0 @@
1
- export{t as runPolittyCli}from"./cli-main-Cx6DmWu3.js";
@@ -1 +0,0 @@
1
- import"./register-Ceh-HlVN.js";const{runPolittyCli:e}=await import(`./cli-main-CBlfe4QR.js`);await e(`@politty/loculus`);export{};
@@ -1 +0,0 @@
1
- import"./with-completion-command-DZP83Co7.js";import"./dynamic-B9VSmsXq.js";export{t as createCompletionCommand,n as createCompletionWorkerPathCommand,r as createRefreshCompletionCommand,c as generateBundledCompletionWorker}from"./completion-D37Zai_i.js";
@@ -1 +0,0 @@
1
- export{t as createDynamicCompleteCommand}from"./dynamic-B9VSmsXq.js";
@@ -1 +0,0 @@
1
- import{l as e}from"./schema-extractor-BjPHWzBq.js";function t(e){let t=e.prompt;if(!t||t.enabled===!1)return null;let n=t.message??e.description??e.name,a=r(e,t),o=i(e,t,a);return{field:e,type:a===`select`&&!o?`text`:a,message:n,...o&&{choices:o}}}function n(e){return e!==void 0&&e.length>0}function r(e,t){return t.type?t.type===`file`||t.type===`directory`?`text`:t.type:n(t.choices)?`select`:e.completion?.type===`file`||e.completion?.type===`directory`?`text`:n(e.enumValues)?`select`:e.type===`boolean`?`confirm`:`text`}function i(e,t,r){if(n(t.choices))return t.choices.map(e=>typeof e==`string`?{label:e,value:e}:e);if(r===`select`&&n(e.enumValues))return e.enumValues.map(e=>({label:e,value:e}))}function a(e,n){let r=[];for(let i of e){if(n[i.name]!==void 0||i.type===`array`)continue;let e=t(i);e&&r.push(e)}return r}function o(){return!(!process.stdin.isTTY||!process.stdout.isTTY||process.env.CI||process.env.POLITTY_NO_PROMPT)}async function s(e,t,n){if(!(n.interactive??o()))return e;let r=n.adapter,i={...e};return t.schemaType===`discriminatedUnion`&&t.discriminator&&t.variants?await c(r,i,t):t.schemaType===`union`||t.schemaType===`xor`||await u(r,i,t.fields),i}async function c(n,r,i){let{discriminator:a,variants:o}=i;if(!a||!o)return;if(r[a]===void 0){let e=l(i.fields,o,a),s=e?t(e):null;if(s){let e=o.map(e=>e.discriminatorValue).filter(Boolean);e.length>0&&(s.type=`select`,s.choices=e.map(e=>({label:e,value:e}))),await d(n,r,s)}}let s=e(i,()=>r);s!==i&&await u(n,r,s.fields.filter(e=>e.name!==a))}function l(e,t,n){let r=e.find(e=>e.name===n);if(r?.prompt)return r;for(let e of t){let t=e.fields.find(e=>e.name===n);if(t?.prompt)return t}}async function u(e,t,n){let r=a(n,t);for(let n of r)await d(e,t,n)}async function d(e,t,n){let{message:r}=n,i;switch(n.type){case`text`:i=await e.text({message:r,placeholder:n.field.placeholder});break;case`password`:i=await e.password({message:r});break;case`confirm`:i=await e.confirm({message:r});break;case`select`:i=await e.select({message:r,options:n.choices??[]})}if(e.isCancelled(i))throw Error(`Prompt cancelled by user`);t[n.field.name]=i}export{t as i,o as n,a as r,s as t};
@@ -1 +0,0 @@
1
- export{t as runCommand}from"./runner-CR1RobTC.js";
@@ -1,33 +0,0 @@
1
- import{i as e,o as t,r as n,s as r,t as i}from"./registry-BEz5iex_.js";import{_ as a,a as o,c as s,d as c,f as l,g as u,l as d,n as f,o as p,r as m,s as h,t as g}from"./schema-extractor-BjPHWzBq.js";import{t as _}from"./detect-agent-D7KSeWMh.js";import{n as v}from"./compile-cache-6u9hgeWu.js";import{a as y,c as b,f as x,i as S,l as C,n as w,o as T,r as ee,t as E,u as D}from"./subcommand-router-40vA6Mka.js";import{n as O,r as k,t as A}from"./log-collector-uhRWYT-z.js";import{a as j,i as M}from"./logger-CoeDrmRr.js";import{a as N,c as te,d as P,i as F,l as I,n as L,o as R,r as ne,s as re,t as z}from"./argv-parser-CVlS6mSo.js";import{stripVTControlCharacters as ie}from"node:util";async function ae(e,t,n={}){let r,i,a=n.captureLogs??!1?A():null;a?.start();let o={args:t},s={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(s.error=r,e.cleanup)try{await e.cleanup(s)}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)}a?.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 x(e.requiredPackages,t);let r=typeof t==`object`&&t?t:{};for(let e of n.packageFields??[])e.requiredPackages?.length&&(e.nested?c(r,e)!==void 0:e.name in r)&&(n.packageDiscriminators?.includes(e.name)||c(r,e)===!0)&&await x(e.requiredPackages,t);e.setup&&await e.setup(o),e.run&&(i=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){s.error=r;try{await e.cleanup(s)}catch(e){r||=e instanceof Error?e:Error(String(e))}}a?.stop();let u=n.existingLogs??O(),d=a?.getLogs()??O(),f=k(u,d);return r?{success:!1,error:r,exitCode:1,logs:f}:{success:!0,result:i,exitCode:0,logs:f}}function oe(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 se(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 ce(e){let t=!1,n=!1,r=!1;for(let i of e){let e=i.codePointAt(0);e===65039?r=!0:oe(e)||(t=!0,se(e)&&(n=!0))}return t?n||r?2:1:0}const le=(()=>{try{return new Intl.Segmenter(`en`,{granularity:`grapheme`})}catch{return}})();function ue(e){if(e.length===0)return 0;let t=e.includes(`\x1B`)||e.includes(`›`)?ie(e):e,n=0;if(le)for(let{segment:e}of le.segment(t))n+=ce(e);else for(let e of t)n+=ce(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 de(e){return xe(e.split(`
2
- `)).map(Ee).join(`
3
-
4
- `)}const fe=/^(#{1,6})\s+(.+)$/,pe=/^(?:---+|\*\*\*+|___+)\s*$/,me=/^>\s?(.*)$/,he=/^-\s+(.+)$/,ge=/^(\d+)[.)]\s+(.+)$/,_e=/^(`{3,}|~{3,})(\S*)\s*$/,ve=/^\[!(NOTE|TIP|IMPORTANT|WARNING|CAUTION)\]\s*$/,ye=/^\|(.+)\|$/,be=/^\|(\s*:?-+:?\s*\|)+$/;function xe(e){let t=[],n=0;for(;n<e.length;){let r=e[n];if(r.trim()===``){n++;continue}let i=r.match(_e);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(fe);if(a){t.push({type:`heading`,level:a[1].length,content:a[2]}),n++;continue}if(pe.test(r)){t.push({type:`hr`}),n++;continue}if(me.test(r)){let r=[];for(;n<e.length;){let t=e[n].match(me);if(t)r.push(t[1]),n++;else break}if(r.length>0){let e=r[0].match(ve);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(he.test(r)){let r=[];for(;n<e.length;){let t=e[n].match(he);if(t)r.push(t[1]),n++;else break}t.push({type:`ul`,items:r});continue}let o=r.match(ge);if(o){let r=Number(o[1]),i=[];for(;n<e.length;){let t=e[n].match(ge);if(t)i.push(t[2]),n++;else break}t.push({type:`ol`,items:i,start:r});continue}if(ye.test(r)&&n+1<e.length&&be.test(e[n+1])){let i=Se(r),a=Ce(e[n+1]);n+=2;let o=[];for(;n<e.length&&ye.test(e[n]);)o.push(Se(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()===``||fe.test(t)||pe.test(t)||me.test(t)||he.test(t)||ge.test(t)||_e.test(t)||ye.test(t)&&n+1<e.length&&be.test(e[n+1]))break;s.push(t),n++}s.length>0&&t.push({type:`paragraph`,lines:s})}return t}function Se(e){return e.slice(1,-1).split(`|`).map(e=>e.trim())}function Ce(e){return e.slice(1,-1).split(`|`).map(e=>{let t=e.trim();return t.startsWith(`:`)&&t.endsWith(`:`)?`center`:t.endsWith(`:`)?`right`:`left`})}function we(e,t,n){let r=ue(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 Te={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 Ee(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}=Te[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=ue(e),i=r.map(e=>ue(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(we(t,i[n],e.alignments[n]??`left`))).join(` ${a} `)} ${a}`,s,...r.map(t=>{let n=t.map((t,n)=>we(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 De(e){return!e.startsWith(`__`)}function H(e){return Object.entries(e).filter(([e])=>De(e))}function Oe(e,t){return t?.rootName&&t.commandPath&&t.commandPath.length>0?t.commandPath.join(` `):e.name??`command`}function ke(e,t){return t?.rootName&&t.commandPath&&t.commandPath.length>0?`${t.rootName} ${t.commandPath.join(` `)}`:e.name??`command`}function Ae(e,t){let n=[],r=ke(e,t);n.push(M.commandName(r)),t?.globalExtracted?.fields.length&&n.push(M.placeholder(`[global options]`));let i=m(e);if(i){let t=s(i);h(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 je(e,t){let n=`${M.dim(`When`)} ${M.option(e)}=${M.bold(t.discriminatorValue)}:`;return t.description?`${n} ${t.description}`:n}function Me(e,t){return` ${M.bold(`${e.description??`Variant ${t+1}`}:`)}`}function Ne(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 Pe(e){let t=m(e);if(!t)return``;let n=[];if(t.schemaType===`discriminatedUnion`&&t.discriminator){let e=t.discriminator;n=(t.variants??[]).map(t=>({label:je(e,t),fields:t.fields}))}else(t.schemaType===`union`||t.schemaType===`xor`)&&t.unionOptions&&(n=t.unionOptions.map((e,t)=>({label:Me(e,t),fields:e.fields})));let r=n.length>0?g(n):void 0,i=t.fields.filter(e=>e.positional&&(r===void 0||r.has(e.name))).map(e=>Ne(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=>Ne(e,1)))}return i.join(`
11
- `)}function Fe(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=m(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 Ie(o,t,i);if(o.schemaType===`union`&&o.unionOptions||o.schemaType===`xor`&&o.unionOptions)return Le(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 Ie(e,t,n){let r=[],i=e.discriminator,a=e.variants??[],o=p(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=g(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=C(e.fields.find(e=>e.name===i)?.requiredPackages);if(t.length>0||n){r.push(``),r.push(je(i,e)),n&&r.push(Be(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 Le(e,t,n){let r=[],i=e.unionOptions??[],a=g(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=Me(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 Re(e){return e.replace(/\x1B\[[0-9;]*m/g,``)}function ze(e,t){let n=Re(e).length,r=Math.max(0,t-n);return e+` `.repeat(r)}function Be(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=Re(e).length,o=32-n*2+r,s=o+2+n*2,c=Be(t,s);return a>=o?`${i} ${e}\n${` `.repeat(s)}${c}`:`${i} ${ze(e,o)}${c}`}function Ve(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 He(e){let t=[];for(let n of e.fields){if(n.positional)continue;t.push(Ve(n));let e=U(n);e&&t.push(e)}return t.join(`
18
- `)}function Ue(e,t){let n=[],r=m(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 We(e,t,n){let r=[];for(let[i,a]of H(e)){let e=b(a),o=t?`${t} ${i}`:i,s=[e?.description,C(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=Ue(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=We(i,o,n);r.push(...e)}}}return r}function Ge(e,t){let n=[],r=t.context;t.agentHelp&&n.push(de(t.agentHelp));let i=Oe(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:`)} ${Ae(e,r)}`);let a=Pe(e);a&&n.push(`${M.sectionHeader(`Arguments:`)}\n${a}`);let o=Fe(e,t.descriptions,r);if(o&&n.push(`${M.sectionHeader(`Options:`)}\n${o}`),r?.globalExtracted?.fields.length&&n.push(`${M.sectionHeader(`Global Options:`)}\n${He(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=We(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=b(n),a=[r?.description,C(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=Je(e.examples,r);n.push(`${M.sectionHeader(`Examples:`)}\n${t}`)}let s=C(e.requiredPackages);if(s&&n.push(`${M.sectionHeader(`Required packages:`)}\n${s}`),e.notes){let t=de(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,C(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:D(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 Ke(e,t){let n=ke(e,t),r=!!t?.globalExtracted?.fields.length,i=e.subCommands&&H(e.subCommands).length>0?e.run?`optional`:`required`:void 0,a=m(e);return{commandName:n,hasGlobalOptions:r,hasOptions:a?h(a).length>0:!1,subcommand:i,positionals:a?s(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=m(e),o,c=[],l=[],u,d,f;if(a){if(o=a.schemaType,c=s(a).map(J),a.schemaType===`discriminatedUnion`&&a.discriminator&&a.variants){let e=a.discriminator;u=e;let t=a.variants,n=g(t,e),r=p(a,e),i=a.fields.filter(e=>!e.positional&&n.has(e.name));l=[...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=g(e);l=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 l=a.fields.filter(e=>!e.positional).map(J)}let h=n?.globalExtracted?.fields.length?n.globalExtracted.fields.filter(e=>!e.positional).map(J):void 0,_;if(e.subCommands){let i=H(e.subCommands);i.length>0&&(_=i.map(([i,a])=>{let o=b(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:Ke(e,n),builtinOptions:i,schemaType:o,positionals:c,options:l,discriminator:u,variants:d,unionOptions:f,globalOptions:h,subcommands:_,examples:e.examples,notes:e.notes,...e.requiredPackages?.length?{requiredPackages:e.requiredPackages.map(e=>({name:e.name,install:D(e),description:e.description}))}:{},agentHelp:t.agentHelp}}function Je(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 Ye=class extends Error{constructor(e){super(e),this.name=`PositionalConfigError`}},Xe=class extends Error{constructor(e){super(e),this.name=`ReservedAliasError`}},Ze=class extends Error{constructor(e){super(e),this.name=`DuplicateFieldError`}},Qe=class extends Error{constructor(e){super(e),this.name=`DuplicateAliasError`}},$e=class extends Error{constructor(e){super(e),this.name=`CaseVariantCollisionError`}},et=class extends Error{constructor(e){super(e),this.name=`DuplicateNegationError`}},tt=class extends Error{constructor(e){super(e),this.name=`ReservedFieldNameError`}},nt=class extends Error{constructor(e){super(e),this.name=`DefaultSubCommandError`}},rt=class extends Error{constructor(e){super(e),this.name=`FieldTypeConflictError`}};function it(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 at(e,n){let r=[],i=/* @__PURE__ */ new Map;for(let a of e.fields){let e=t(a.name),o=i.get(e);o&&o!==a.name&&r.push({commandPath:n,type:`case_variant_collision`,message:`Fields "${o}" and "${a.name}" are case variants of each other and would collide.`,field:a.name}),i.set(e,a.name)}return r}function ot(n,r){let i=[],a=/* @__PURE__ */ new Map,o=new Set(n.fields.map(e=>e.name)),s=new Set(n.fields.map(e=>e.cliName)),c=(e,t,n)=>{(o.has(e)||s.has(e))&&i.push({commandPath:r,type:`duplicate_alias`,message:`Alias "${e}" for field "${t}" conflicts with existing field name or CLI name "${e}".`,field:t});let c=a.get(e);if(c&&c!==t){let a=n?` (derived camelCase variant)`:``;i.push({commandPath:r,type:`duplicate_alias`,message:`Duplicate alias "${e}"${a} detected. Both "${c}" and "${t}" use the same alias.`,field:t})}a.set(e,t)};for(let r of n.fields){let n=e(r);if(n.length!==0){for(let e of n)if(c(e,r.name,!1),e.length>1&&e.includes(`-`)){let n=t(e);n!==e&&!o.has(n)&&c(n,r.name,!0)}}}return i}function st(n,r){let i=[],a=/* @__PURE__ */ new Map,o=(e,t,n)=>{a.has(e)||a.set(e,{field:t,kind:n})};for(let r of n.fields){if(o(r.name,r.name,`field name`),r.name.includes(`-`)){let e=t(r.name);e!==r.name&&o(e,r.name,`field name`)}if(r.cliName!==r.name&&o(r.cliName,r.name,`CLI name`),r.cliName.includes(`-`)){let e=t(r.cliName);e!==r.cliName&&o(e,r.name,`CLI name`)}for(let n of e(r))if(o(n,r.name,`alias`),n.length>1&&n.includes(`-`)){let e=t(n);e!==n&&o(e,r.name,`alias`)}if(r.type===`boolean`&&r.negation===!0){let e=`no-${r.cliName}`;o(e,r.name,`default negation`);let n=t(r.cliName),i=`no${n[0]?.toUpperCase()??``}${n.slice(1)}`;i!==e&&o(i,r.name,`default negation`)}}let s=/* @__PURE__ */ new Map,c=(e,t,n)=>{let o=a.get(e);if(o){let a=n?` (derived camelCase variant)`:``,s=o.field===t?`the same field's own ${o.kind} "${e}"`:`${o.kind} "${e}" of field "${o.field}"`;i.push({commandPath:r,type:`duplicate_negation`,message:`Negation "${e}"${a} for field "${t}" conflicts with ${s}.`,field:t})}let c=s.get(e);if(c&&c!==t){let a=n?` (derived camelCase variant)`:``;i.push({commandPath:r,type:`duplicate_negation`,message:`Duplicate negation "${e}"${a} detected. Both "${c}" and "${t}" use the same negation name.`,field:t})}s.set(e,t)};for(let e of n.fields)if(typeof e.negation==`string`&&(c(e.negation,e.name,!1),e.negation.includes(`-`))){let n=t(e.negation);n!==e.negation&&c(n,e.name,!0)}return i}function ct(e,t){let n=[e,...e.variants??[],...e.unionOptions??[]],r=/* @__PURE__ */ new Set;return n.flatMap(e=>lt(e.fields,t)).filter(e=>!r.has(e.message)&&r.add(e.message))}function lt(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 ut(t,r){let i=[];for(let a of t.fields){if(a.overrideBuiltinAlias!==!0)for(let t of e(a))(t===`h`||t===`H`)&&i.push({commandPath:r,type:`reserved_alias`,message:`Alias "${t}" is reserved for --${t===`h`?`help`:`help-all`}. To override this, set { overrideBuiltinAlias: true } for "${a.name}" and keep the alias where it is currently defined (in alias or hiddenAlias).`,field:a.name});let t=/* @__PURE__ */ new Set([a.cliName,...e(a)]);for(let e of t){if(!n.has(e))continue;let t=e===a.cliName;i.push({commandPath:r,type:`reserved_alias`,message:`${t?`Field "${a.name}"`:`Alias "${e}" for field "${a.name}"`} collides with the built-in --${e} option, which always takes precedence. Rename the field or its alias; this collision cannot be overridden.`,field:a.name})}}return i}function dt(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 ft(e){let t=it(e,[]);if(t.length>0)throw new Ze(`Duplicate field name "${t[0]?.field??`unknown`}" detected. Each field must have a unique name.`)}function pt(e){let t=ot(e,[]);if(t.length>0){let e=t[0];throw new Qe(e.message)}}function mt(e){let t=ct(e,[]);if(t.length>0){let e=t[0];throw new Ye(e.message)}}function ht(e,t){let n=ut(e,[]);if(n.length>0)throw new Xe(n[0].message)}function gt(e){let t=dt(e,[]);if(t.length>0){let e=t[0];throw new tt(e.message)}}function _t(e){let t=st(e,[]);if(t.length>0){let e=t[0];throw new et(e.message)}}function vt(e){let t=at(e,[]);if(t.length>0){let e=t[0];throw new $e(e.message)}}function yt(e,t){if(e.type!==t.type||e.positional!==t.positional)return!1;let n=e.enumValues,r=t.enumValues;if(!n&&!r)return!0;if(!n||!r)return!1;let i=new Set(n),a=new Set(r);if(i.size!==a.size)return!1;for(let e of i)if(!a.has(e))return!1;return!0}function bt(e,n,r){let i=[],a=/* @__PURE__ */ new Map;for(let n of e.fields)a.set(t(n.name),n);for(let e of n.fields){let n=t(e.name),o=a.get(n);o&&(o.name===e.name?yt(o,e)||i.push({commandPath:r,type:`field_type_conflict`,message:`Global field "${o.name}" and command field "${e.name}" share the same name but have different definitions.`,field:e.name}):i.push({commandPath:r,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 i.push(...xt(e,n,r)),i}function xt(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 St(e,t){let n=bt(e,t,[])[0];if(n)throw n.type===`case_variant_collision`?new $e(n.message):new rt(n.message)}function Ct(e,t,n){return[...it(e,n),...at(e,n),...ot(e,n),...st(e,n),...ct(e,n),...ut(e,n),...dt(e,n)]}function wt(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 Tt(e){let t=wt(e,[]);if(t.length>0)throw new nt(t[0].message)}function Et(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=T(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 Dt(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 Ot(e,t={}){return kt(e,t,!1)}async function kt(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?f(t.globalArgs):void 0;if(e.args){let t=f(e.args);i.push(...Ct(t,a,r)),o&&i.push(...bt(o,t,r))}if(i.push(...Et(e,r)),i.push(...wt(e,r)),e.subCommands)for(let[a,o]of Object.entries(e.subCommands)){let e=await ee(o,e=>n||!!e.requiredPackages?.length);i.push(...Dt(a,e.name,r));let s=await kt(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 At(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 jt(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 Mt(e,t){let{resolvedName:n,withoutDashes:r,isNegated:i,isCustomNegation:a,isSuppressedNegation:o}=I(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&&L(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 Nt(e,t,n,r=()=>!1){let i=e[t];if(!ne(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}=re(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 Pt(e,t,n){let r=jt(n),i=new Set(t),a=[],o=[],s=0;for(;s<e.length;){let t=e[s];if(t===`--`||Ft.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}=Mt(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=Nt(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 Ft=/* @__PURE__ */ new Set([`--help`,`-h`,`--help-all`,`-H`,`--help-json`,`--version`]);function It(e,t,n={}){let r=n.stopOnSuppressedNegation===!0||t?.unknownKeysMode===`strict`,i=t?jt(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===`--`||Ft.has(n))return-1;if(n.startsWith(`--`)){let{resolvedName:a,isNegated:o,isGlobal:s,isSuppressedNegation:c}=Mt(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=Nt(e,t,i);if(o>0)t+=o-1;else return-1}return-1}function Lt(e,t){let n=It(e,t);return n>=0?e[n]:void 0}function Rt(t,n,r={}){let i=E(n),a=[...i],s=a.length>0,c=s&&!n.run;if(s&&t.length>0){if(r.globalExtracted){let e=Pt(t,a,r.globalExtracted);if(e.subCommandIndex>=0){let n=Vt(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 l;n.args&&(l=f(n.args),r.skipValidation||(ft(l),vt(l),pt(l),_t(l),mt(l),ht(l,s),gt(l),r.globalExtracted&&St(r.globalExtracted,l)));let u=t,d,p=[];if(r.globalExtracted){let e=l?o(l):[],n=new Set(e.map(e=>e.name)),{separated:i,globalParsed:a,suppressedTokens:s}=Ht(t,r.globalExtracted,l&&{...l,fields:[...e,...l.fields.filter(e=>!n.has(e.name))]});u=i,d=a,p=s}let m=t.indexOf(`--`),h=m>=0?t.slice(0,m):t,g=l?.fields.some(t=>t.overrideBuiltinAlias===!0&&e(t).includes(`H`))??!1,_=l?.fields.some(t=>t.overrideBuiltinAlias===!0&&e(t).includes(`h`))??!1,v=h.includes(`--help-all`)||!g&&h.includes(`-H`),y=h.includes(`--help-json`),b=!v&&!y&&(h.includes(`--help`)||!_&&h.includes(`-h`)),x=h.includes(`--version`);if(b||v||y||x)return{helpRequested:b,helpAllRequested:v,helpJsonRequested:y,versionRequested:x,subCommand:void 0,remainingArgs:[],rawArgs:{},positionals:[],rest:[],unknownFlags:[],unknownGlobalFlags:p,rawGlobalArgs:d};if(!l){let t=u.indexOf(`--`),n=t>=0?u.slice(0,t):u,i=t>=0?u.slice(t+1):[],a=e=>c&&e.startsWith(`-`)&&e!==`-`,o=new Set(r.globalExtracted?.fields.flatMap(t=>[t.name,t.cliName,...e(t)])),s=r.globalExtracted?z(r.globalExtracted):{},l=n.filter(a).flatMap(e=>Object.keys(N([e],s).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:l,unknownGlobalFlags:p,rawGlobalArgs:d}}let S=zt(l,u,{promptAvailable:r.promptAvailable===!0,inheritedNames:r.inheritedNames??/* @__PURE__ */ new Set});if(!S)return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:void 0,remainingArgs:[],rawArgs:{},positionals:[],rest:[],unknownFlags:[],unknownGlobalFlags:p,extractedFields:l,matchesNoUnionOption:!0,rawGlobalArgs:d};let C=z(S),w=N(u,{...C,unknownFlagsTakeNoValue:c}),T=F(w,S),ee=Z(T,S),D=S.fields.filter(e=>e.named),O=new Set(D.map(e=>e.name)),k=new Set(D.map(e=>e.cliName)),A=/* @__PURE__ */ new Set;for(let t of D)for(let n of e(t))A.add(n);if(r.globalExtracted)for(let t of r.globalExtracted.fields){O.add(t.name),k.add(t.cliName);for(let n of e(t))A.add(n)}let j=[];for(let e of Object.keys(w.options))!O.has(e)&&!k.has(e)&&!A.has(e)&&j.push(e);return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:void 0,remainingArgs:[],rawArgs:T,positionals:w.positionals,rest:w.rest,unknownFlags:j,unknownGlobalFlags:p,extractedFields:l,optionFields:D,positionalSlotFields:R(S,w.options),rawGlobalArgs:d,envFallbackFields:ee}}function zt(e,t,n){let{discriminator:r,variants:i,unionOptions:a}=e;if(r&&i){let n=e=>{let n=F(N(t,z(e)),e);return Z(n,e),n},r=d(e,n);return r===e?i.some(t=>{let r=n({...e,fields:t.fields});return d(e,()=>r)!==e})?void 0:e:r}if(a){let r=a.flatMap(e=>{let r=zt(e,t,n);return r?[r]:[]}),i=n.promptAvailable?r.filter(e=>Bt(e,t,void 0)):[],o=r.find(e=>Bt(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]=P(i,r.type),n.add(r.name);break}}return n}function Bt(t,n,r){let i=N(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=R(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 Vt(e,t){if(e.length===0)return{};let n=z(t),r=N(e,n);return F(r,t)}function Ht(n,r,i){let a=jt(r),o=new Set(i?.fields.map(e=>e.name)??[]),s=new Set(i?.fields.map(e=>e.cliName)??[]),c=i?z(i):void 0,l=new Set(c?.aliasMap?.keys()??[]),u=new Set(c?.negationMap?.keys()??[]),d=/* @__PURE__ */ new Set;for(let n of i?.fields??[])if(n.type===`boolean`&&n.negation===!0)for(let r of[n.cliName,...e(n)]){let e=`no-${r}`;d.add(e),d.add(t(e))}let f=[],p=[],m=[];for(let e=0;e<n.length;e++){let t=n[e];if(t===`--`){p.push(...n.slice(e));break}if(t.startsWith(`--`)){let{resolvedName:r,withoutDashes:i,isNegated:c,isGlobal:p,isSuppressedNegation:h}=Mt(t,a),g=r,_=o.has(i)||o.has(g)||s.has(i)||s.has(g)||l.has(i)||l.has(g)||u.has(i)||u.has(g)||d.has(i);if(p&&!_){e+=X(n,e,r,c,a.booleanFlags,f)-1;continue}if(h&&!_){m.push(i);continue}}else if(t.startsWith(`-`)&&t.length>1){let r=t.includes(`=`)?t.slice(1,t.indexOf(`=`)):t.slice(1);if(r.length===1){let t=a.aliasMap.get(r)??r;if((a.aliases.has(r)||a.flagNames.has(t))&&!l.has(r)){e+=X(n,e,t,!1,a.booleanFlags,f)-1;continue}}let i=Nt(n,e,a,e=>l.has(e));if(i>0){f.push(...n.slice(e,e+i)),e+=i-1;continue}}p.push(t)}return{separated:p,globalParsed:Vt(f,r),suppressedTokens:m}}function Q(e,t){return u(t)?a(e,t):i().validate(e,t)}function Ut(e){return e.map(e=>`${e.path.length>0?`${e.path.join(`.`)}: `:``}${e.message}`).join(`
33
- `)}function Wt(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 Gt(e,t){let n=Math.max(2,Math.floor(e.length/2));return t.map(t=>({candidate:t,distance:Wt(e.toLowerCase(),t.toLowerCase())})).filter(({distance:e})=>e<=n).sort((e,t)=>e.distance-t.distance).map(({candidate:e})=>e).slice(0,3)}function Kt(e,t){let n=Gt(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 qt(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,n,i){if(typeof n==`string`){if(n in e)return Reflect.get(e,n,i);let a=t(n);if(a!==n&&a in e)return Reflect.get(e,a,i);let o=r(n);if(o!==n&&o in e)return Reflect.get(e,o,i)}return Reflect.get(e,n,i)},has(e,n){if(typeof n==`string`){if(n in e)return!0;let i=t(n);if(i!==n&&i in e)return!0;let a=r(n);if(a!==n&&a in e)return!0}return Reflect.has(e,n)}})}async function Jt(e,t,n){for(let r of t.fields)r.effect&&await r.effect(c(e,r),{name:r.name,args:e,...n!=null&&{globalArgs:n}})}const Yt={log:e=>console.log(e),error:e=>console.error(e),warn:e=>console.warn(e)};function Xt(e,n){Object.defineProperty(e,"$source",{value:e=>n.get(e)??n.get(t(e))??n.get(r(e))??`default`,enumerable:!1})}function Zt(e,t){Object.defineProperty(e,"$invocation",{value:t,enumerable:!1})}function Qt(e,t){Object.defineProperty(e,"$agent",{value:t,enumerable:!1})}function $t(e,t){return e&&(n=>e({...n,agent:t}))}function en(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)&&(i[t]=n,o.delete(t));for(let e=0;e<=r.size;e++){let e=Q(i,t);if(e.success){let t=e.data,n=/* @__PURE__ */ new Map;for(let e of a)e in i&&n.set(e,`cli`);for(let e of o)e in i&&n.set(e,`env`);return Xt(t,n),$(t)}let n=e.errors.map(e=>e.path[0]).filter(e=>e!==void 0&&Object.hasOwn(i,e));if(n.length===0){let e=Object.keys(i).filter(e=>{let{[e]:n,...r}=i;return Q(r,t).success});if(e.length!==1)return;n=e}for(let e of n)delete i[e]}}function tn(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:en(t,n,r)}}catch{return{error:i}}}function nn(e,t){let{agentHelp:n,_agent:r}=e;if(n&&r)return typeof n==`string`?n:n({agent:r,commandPath:t.commandPath??[]})}function rn(e,t){let n=t.commandPath?.at(-1)??e.name;return t.aliasFor?{name:n,aliasFor:t.aliasFor}:{name:n}}async function an(e,t,n={}){let r=un(n),i=_(),a=$t(n.cleanup,i),o=n.captureLogs??!1,s=o?A():null;if(n.setup){s?.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 s?.stop(),{success:!1,error:t,exitCode:1,logs:s?.getLogs()??O()}}s?.stop()}let c={},l=await ln(e,t,{...n,handleSignals:!1,_globalExtracted:r,_globalCleanup:a,_existingLogs:s?.getLogs(),_agent:i,_globalTrace:c});if(a){let e=o?A():null;e?.start();let t=tn(l,c,n.globalArgs,r);try{await a(t)}catch(t){if(l.success){let n=t instanceof Error?t:Error(String(t));return e?.stop(),{success:!1,error:n,exitCode:1,logs:k(l.logs,e?.getLogs()??O())}}}e?.stop();let i=e?.getLogs()??O();if(i.entries.length>0)return{...l,logs:k(l.logs,i)}}return l}function on(e,t,n){let r=Lt(t,n);return!r||!r.startsWith(`__`)?!1:Object.hasOwn(e.subCommands??{},r)}async function sn(e,t={}){if(t.compileCache!==!1&&v(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=f(t.globalArgs)}catch{}let i=t;if(on(e,n,r)){let{setup:e,cleanup:n,prompt:r,globalArgs:a,...o}=t;i=o}let a=un(i),o=_(),s=$t(i.cleanup,o);if(i.skipValidation||Tt(e),i.onUnknownSubcommand&&!e.run&&!on(e,n,r)){let t=E(e);if(t.size>0){let e=It(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 cn(),process.exit(a)}}}if(i.setup)try{await i.setup({agent:o})}catch(e){let t=e instanceof Error?e:Error(String(e));if(s)try{await s({error:t})}catch{}process.exit(1)}let c={},l=await ln(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:s,_agent:o,_globalTrace:c,_context:{commandPath:[],rootName:e.name,rootVersion:i.version,globalExtracted:a}});if((i.displayErrors??!0)&&!l.success&&l.error&&(i.logger??Yt).error(qt(l.error,i.debug??!1)),s){let e=tn(l,c,i.globalArgs,a);try{await s(e)}catch{}}await cn(),process.exit(l.exitCode)}async function cn(){await Promise.all([process.stdout,process.stderr].map(e=>e.writableLength>0?new Promise(t=>e.write(``,()=>t())):Promise.resolve()))}async function ln(e,t,n={}){let r=n.logger??Yt,i=n._context??{commandPath:[],rootName:e.name,globalExtracted:n._globalExtracted},a=n.captureLogs??!1?A():null;a?.start();let o=()=>{let e=n._existingLogs??O(),t=a?.getLogs()??O();return k(e,t)};try{n.skipValidation||Tt(e);let s=Rt(t,e,{skipValidation:n.skipValidation,globalExtracted:n._globalExtracted,promptAvailable:n.prompt!==void 0,inheritedNames:new Set(Object.keys(n._parsedGlobalArgs??{}))}),u={...n._parsedGlobalArgs,...s.rawGlobalArgs};n._globalTrace&&(n._globalTrace.rawGlobalArgs={...u});let f=i.commandPath??[];if(n.onUnknownSubcommand&&!e.run&&f.length>0){let r=E(e);if(r.size>0){let e=It(t,n._globalExtracted,{stopOnSuppressedNegation:n._globalExtracted?.unknownKeysMode!==`passthrough`}),i=e>=0?t[e]:void 0;if(i&&!r.has(i)){let r=t.slice(e+1),s=await n.onUnknownSubcommand({commandPath:f,name:i,args:r,precedingArgs:[...n._precedingArgs??[],...t.slice(0,e)]});if(typeof s==`number`){if(a?.stop(),n.handleSignals){if(n._globalCleanup)try{await n._globalCleanup({error:void 0})}catch{}await cn(),process.exit(s)}return s===0?{success:!0,result:void 0,exitCode:0,logs:o()}:{success:!1,error:/* @__PURE__ */ Error(`Plugin "${[...f,i].join(` `)}" exited with code ${s}`),exitCode:s,logs:o()}}}}}if(s.helpRequested||s.helpAllRequested||s.helpJsonRequested){let c=!1,l=w(e),u=E(e);if(l.length>0){let e=Lt(t,i.globalExtracted);e&&!u.has(e)&&(c=!0)}let d=nn(n,i);if(s.helpJsonRequested){let t=qe(e,{context:i,agentHelp:d});r.log(JSON.stringify(t))}else{let t=Ge(e,{showSubcommands:n.showSubcommands??!0,showSubcommandOptions:s.helpAllRequested||n.showSubcommandOptions,context:i,agentHelp:d});r.log(t)}if(a?.stop(),c){let e=Lt(t,i.globalExtracted)??``,n=Gt(e,[...u]),r=n.length>0?` Did you mean: ${n.join(`, `)}?`:``;return{success:!1,error:/* @__PURE__ */ Error(`Unknown subcommand: ${e}${r?`.${r}`:``}`),exitCode:2,logs:o()}}return{success:!0,result:void 0,exitCode:0,logs:o()}}if(s.unknownGlobalFlags&&s.unknownGlobalFlags.length>0){let e=i.globalExtracted?.unknownKeysMode??`strip`;if(e===`strict`)return a?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unknown flags: ${s.unknownGlobalFlags.join(`, `)}`),exitCode:2,logs:o()};if(e===`strip`){let e=i.globalExtracted?.fields.map(e=>e.name)??[];for(let t of s.unknownGlobalFlags)r.error(Kt(t,e))}}if(s.versionRequested){let e=i.rootVersion;return e&&r.log(e),a?.stop(),{success:!0,result:void 0,exitCode:0,logs:o()}}if(s.subCommand){let r=n._metadataOnly??!1,c=await y(e,s.subCommand,e=>{if(r)return!0;if(!e.requiredPackages?.length)return!1;let t=e,a=s.remainingArgs;for(;;){let e=Rt(a,t,{skipValidation:n.skipValidation,globalExtracted:i.globalExtracted,promptAvailable:!!n.prompt});if(e.helpRequested||e.helpAllRequested||e.helpJsonRequested||e.versionRequested)return r=!0,!0;if(!e.subCommand||!t.subCommands)return!1;let o=Object.hasOwn(t.subCommands,e.subCommand)?e.subCommand:S(t,e.subCommand)??e.subCommand,s=t.subCommands[o],c=s?b(s):null;if(!c)return!1;t=c,a=e.remainingArgs}});if(c){let e={commandPath:[...i.commandPath??[],s.subCommand],rootName:i.rootName,rootVersion:i.rootVersion,globalExtracted:i.globalExtracted,aliasFor:c.aliasFor};a?.stop();let l=new Set(n._globalExtracted?.unknownKeysMode===`passthrough`?[]:s.unknownGlobalFlags??[]),d=e=>e.startsWith(`--`)&&l.has(te(e)),f=t.slice(0,t.length-s.remainingArgs.length-1).filter(e=>!d(e));return ln(c.command,s.remainingArgs,{...n,_metadataOnly:r,_context:e,_existingLogs:o(),_parsedGlobalArgs:u,_precedingArgs:[...n._precedingArgs??[],...f]})}}let p=s.positionalSlotFields??[],m=p.some(e=>e.type===`array`),h=[...s.positionals,...s.rest],g=m?[]:h.slice(p.length),_=m?[]:s.positionals.slice(p.length);if(s.matchesNoUnionOption)return a?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Arguments match none of the accepted forms. See --help for the accepted forms.`),exitCode:2,logs:o()};let v=E(e),x=v.size>0?_.find(e=>!e.startsWith(`-`)&&!v.has(e)):void 0;if(x){let e=Gt(x,[...v]),t=e.length>0?` Did you mean: ${e.join(`, `)}?`:``;return a?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unknown subcommand: ${x}${t?`.${t}`:``}`),exitCode:2,logs:o()}}if(s.unknownFlags.length>0){let e=s.extractedFields?.unknownKeysMode??i.globalExtracted?.unknownKeysMode??`strip`,t=s.optionFields?.map(e=>e.name)??i.globalExtracted?.fields.map(e=>e.name)??[];if(e===`strict`)return a?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unknown flags: ${s.unknownFlags.join(`, `)}`),exitCode:2,logs:o()};if(e===`strip`)for(let e of s.unknownFlags)r.error(Kt(e,t))}if(w(e).length>0&&!s.subCommand&&!e.run&&g.length===0){if(e.defaultSubCommand){let r=e.subCommands?.[e.defaultSubCommand];if(r){let c=await ee(r),l={commandPath:[...i.commandPath??[],e.defaultSubCommand],rootName:i.rootName,rootVersion:i.rootVersion,globalExtracted:i.globalExtracted};a?.stop();let d=new Set(n._globalExtracted?.unknownKeysMode===`passthrough`?[]:s.unknownGlobalFlags??[]),f=e=>e.startsWith(`--`)&&d.has(te(e)),p=t.filter(e=>!f(e));return ln(c,[],{...n,_context:l,_existingLogs:o(),_parsedGlobalArgs:u,_precedingArgs:[...n._precedingArgs??[],...p]})}}if(n.globalArgs&&n._globalExtracted){let e={...u};Z(e,n._globalExtracted);let t=Q(e,n.globalArgs),r=t.success?[]:t.errors.filter(t=>t.path[0]&&e[t.path[0]]!==void 0);if(r.length>0)return a?.stop(),{success:!1,error:Error(Ut(r)),exitCode:2,logs:o()}}let c=Ge(e,{showSubcommands:n.showSubcommands??!0,context:i,agentHelp:nn(n,i)});return r.log(c),a?.stop(),{success:!0,result:void 0,exitCode:0,logs:o()}}if(g.length>0){let e=s.extractedFields?.unknownKeysMode??`strip`;if(e===`strict`)return a?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unexpected positional argument${g.length>1?`s`:``}: ${g.join(`, `)}`),exitCode:2,logs:o()};if(e===`strip`)for(let e of g)(r.warn??r.error)(`Warning: Unexpected positional argument: ${e}`)}let C={},T=e.name===`__complete`,D=new Set(Object.keys(u)),O=/* @__PURE__ */ new Set;if(n.globalArgs&&n._globalExtracted&&!T){if(O=Z(u,n._globalExtracted),n.prompt){let e={...u},t=await n.prompt(u,n._globalExtracted);for(let[e,n]of Object.entries(t))n!==void 0&&(u[e]=n);let r={};for(let[t,n]of Object.entries(u))e[t]!==n&&(r[t]=n);n._globalTrace&&(n._globalTrace.promptedGlobalArgs=r)}let e=Q(u,n.globalArgs);if(!e.success)return a?.stop(),{success:!1,error:Error(Ut(e.errors)),exitCode:2,logs:o()};C=e.data}if(!e.args){let t=/* @__PURE__ */ new Map;for(let e of D)t.set(e,`cli`);for(let e of O)t.set(e,`env`);Xt(C,t),Zt(C,rn(e,i)),Qt(C,n._agent);let r=$(C);return n._globalExtracted&&!T&&(n._globalTrace&&(n._globalTrace.effectsRan=!0),await Jt(r,n._globalExtracted,r)),a?.stop(),await ae(e,r,{handleSignals:n.handleSignals,captureLogs:n.captureLogs,existingLogs:o(),globalCleanup:n._globalCleanup,packageDiscriminators:n._globalExtracted?.discriminator?[n._globalExtracted.discriminator]:[],packageFields:T||!n._globalExtracted?void 0:d(n._globalExtracted,()=>C).fields})}let k=s.rawArgs,A=/* @__PURE__ */ new Set;if(n.prompt&&s.extractedFields){let e=await n.prompt(k,s.extractedFields),t={...k};for(let[n,r]of Object.entries(e))r!==void 0&&(t[n]=r,A.add(n));k=t}let j=/* @__PURE__ */ new Set;if(s.extractedFields){let e=/* @__PURE__ */ new Map;for(let t of n._globalExtracted?.fields??[])e.has(t.name)||e.set(t.name,t);for(let t of s.extractedFields.fields){let n=Object.hasOwn(s.rawArgs,t.name)||A.has(t.name),r=e.get(t.name),i=r?c(C,r):C[t.name];!n&&D.has(t.name)&&(r?.nested?i!==void 0:Object.hasOwn(C,t.name))&&(k={...k,[t.name]:i},j.add(t.name))}}let M=Q(k,e.args);if(!M.success)return a?.stop(),{success:!1,error:Error(Ut(M.errors)),exitCode:2,logs:o()};let N=$(M.data),P=/* @__PURE__ */ new Map;for(let e of D)P.set(e,`cli`);for(let e of O)P.set(e,`env`);Xt(C,P),Zt(C,rn(e,i)),Qt(C,n._agent);let F=$(C);n._globalExtracted&&!T&&(n._globalTrace&&(n._globalTrace.effectsRan=!0),await Jt(F,n._globalExtracted,F)),s.extractedFields&&!T&&await Jt(N,s.extractedFields,F);let I=l({...F},{...N},n._globalExtracted?.fields??[],s.extractedFields?.fields??[]),L=new Map(P),R=s.envFallbackFields??/* @__PURE__ */ new Set;for(let e of s.extractedFields?.fields??[]){if(j.has(e.name)){L.set(e.name,`cli`);continue}let t=Object.hasOwn(s.rawArgs,e.name)||R.has(e.name);L.set(e.name,t?R.has(e.name)?`env`:`cli`:`default`)}Xt(I,L),Zt(I,rn(e,i)),Qt(I,n._agent);let ne=$(I);return a?.stop(),await ae(e,ne,{handleSignals:n.handleSignals,captureLogs:n.captureLogs,existingLogs:o(),globalCleanup:n._globalCleanup,packageDiscriminators:[s.extractedFields?.discriminator,n._globalExtracted?.discriminator].filter(e=>e!==void 0),packageFields:T?void 0:[...n._globalExtracted?d(n._globalExtracted,()=>C).fields:[],...s.optionFields??[],...s.positionalSlotFields??[]]})}catch(e){let t=e instanceof Error?e:Error(String(e));return a?.stop(),{success:!1,error:t,exitCode:1,logs:o()}}}function un(e){if(!e.globalArgs)return;let t=f(e.globalArgs);if(!e.skipValidation){ft(t),vt(t),pt(t),_t(t),ht(t,!0),gt(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{Xe as C,B as D,qe as E,de as O,Ye as S,Ge as T,nt as _,At as a,et as b,St as c,ft as d,_t as f,$e as g,gt as h,Ut as i,Tt as l,ht as m,sn as n,vt as o,mt as p,$ as r,Ot as s,an as t,pt as u,Qe as v,tt as w,rt as x,Ze as y};
@@ -1 +0,0 @@
1
- import{a as e,s as t,t as n}from"./registry-BEz5iex_.js";const r=`__polittyInternalArgs`,i={string(e){return{kind:`string`,optional:!1,meta:e}},optionalString(e){return{kind:`string`,optional:!0,meta:e}},boolean(e){return{kind:`boolean`,optional:!1,defaultValue:!1,meta:e}},enum(e,t){return{kind:`enum`,enumValues:e,optional:!1,meta:t}},optionalEnum(e,t){return{kind:`enum`,enumValues:e,optional:!0,meta:t}},stringArray(e){return{kind:`string-array`,optional:!1,defaultValue:[],meta:e}},optionalStringArray(e){return{kind:`string-array`,optional:!0,meta:e}}};function a(e,t={}){return{[r]:!0,fields:e,unknownKeys:t.unknownKeys??`strip`}}function o(e){return typeof e==`object`&&!!e&&e[r]===!0}const s={string:`string`,boolean:`boolean`,enum:`string`,"string-array":`array`},c=/* @__PURE__ */ new WeakMap;function l(t){let n=c.get(t);if(n)return n;let r={fields:Object.entries(t.fields).map(([t,n])=>e(t,{argMeta:n.meta,description:void 0,required:!n.optional&&n.defaultValue===void 0,defaultValue:n.defaultValue,type:s[n.kind],enumValues:n.enumValues?[...n.enumValues]:void 0,schema:n})),schema:t,schemaType:`object`,unknownKeysMode:t.unknownKeys};return c.set(t,r),r}function u(e){switch(e.kind){case`enum`:return`one of ${(e.enumValues??[]).map(e=>JSON.stringify(e)).join(` | `)}`;case`string-array`:return`array`;default:return e.kind}}function d(e){return e===null?`null`:Array.isArray(e)?`array`:typeof e}function f(e,t,n){return{path:[e],message:`Invalid input: expected ${u(t)}, received ${d(n)}`,code:`invalid_type`,received:n,expected:u(t)}}function p(e,t,n){switch(t.kind){case`string`:return typeof n==`string`?null:f(e,t,n);case`boolean`:return typeof n==`boolean`?null:f(e,t,n);case`enum`:return typeof n!=`string`||!(t.enumValues??[]).includes(n)?{path:[e],message:`Invalid option: expected ${u(t)}`,code:`invalid_value`,received:n,expected:u(t)}:null;case`string-array`:return!Array.isArray(n)||n.some(e=>typeof e!=`string`)?f(e,t,n):null}}function m(e,t){let n=[],r={};for(let[i,a]of Object.entries(t.fields)){let t=e[i];if(t===void 0){a.defaultValue===void 0?a.optional||n.push(f(i,a,void 0)):r[i]=Array.isArray(a.defaultValue)?[...a.defaultValue]:a.defaultValue;continue}let o=p(i,a,t);o?n.push(o):r[i]=t}let i=new Set(Object.keys(t.fields)),a=Object.keys(e).filter(e=>!i.has(e));if(a.length>0){if(t.unknownKeys===`strict`)n.push({path:[],message:`Unrecognized key${a.length>1?`s`:``}: ${a.map(e=>JSON.stringify(e)).join(`, `)}`,code:`unrecognized_keys`});else if(t.unknownKeys===`passthrough`)for(let t of a)Object.defineProperty(r,t,{value:e[t],enumerable:!0,writable:!0,configurable:!0})}return n.length>0?{success:!1,errors:n}:{success:!0,data:r}}function h(e,t,n){if(e.length<=n.length||!e.startsWith(n))return;if(t===`kebab`)return e[n.length]===`-`?e.slice(n.length+1):void 0;let r=e[n.length];return r===r.toLowerCase()?void 0:r.toLowerCase()+e.slice(n.length+1)}function g(e,t,n){if(t===`dot`){let t=e.indexOf(`.`);return t<0?void 0:[e.slice(0,t),e.slice(t+1)]}let r;for(let i of n)h(e,t,i)!==void 0&&(r===void 0||i.length<r.length)&&(r=i);return r===void 0?void 0:[r,h(e,t,r)]}function _(e,t,n){if(t===`dot`)return e.split(`.`);let r=[],i=e;for(let e=g(i,t,n);e;e=g(i,t,n)){let a=e[0];r.push(a),i=e[1],n=n.flatMap(e=>h(e,t,a)??[])}return r.push(i),r}function v(e={}){let t=e.style??`dot`,n=`prefixes`in e?e.prefixes:[];return e=>_(e,t,n)}function y(e,t,n){t===`__proto__`?Object.defineProperty(e,t,{value:n,enumerable:!0,writable:!0,configurable:!0}):e[t]=n}function b(e,t){let n={},r=/* @__PURE__ */ new Set,i=(e,t)=>({issues:[{message:`Cannot unflatten "${e}": "${t}" is both a value and a group`,path:[e]}]});for(let a of Object.keys(e)){let o=t(a),s=o.length-1,c=n;for(let e=0;e<s;e++){let t=o[e];if(Object.hasOwn(c,t)){let e=c[t];if(!r.has(e))return i(a,t);c=e}else{let e={};r.add(e),y(c,t,e),c=e}}let l=o[s];if(Object.hasOwn(c,l))return i(a,l);y(c,l,e[a])}return{value:n}}function x(e,n={}){let r=v(n),i=b(Object.fromEntries(e.map(e=>[e,void 0])),r);if(i.issues)throw TypeError(i.issues[0].message);let a=/* @__PURE__ */ new Map;for(let n of e){let e=r(n)[0],i=t(e),o=a.get(i);if(o!==void 0&&o!==e)throw TypeError(`Cannot unflatten "${n}": "${o}" and "${e}" are spellings of the same name. Spell the name the same way in every key.`);a.set(i,e)}}const S=/* @__PURE__ */ new WeakMap;function C(e,t={}){return S.set(e,t),e}function w(e){return S.get(e)}function T(e){if(S.has(e))throw Error(`An unflatten schema cannot be an option of a union: unflatten wraps one object schema, so the union cannot tell which option's groups its output nests. Unflatten the object that holds the union instead, or use a plain object for the option.`)}function E(e,t){if(!t.nested)return e[t.name];let n=e;for(let e of t.nested.path)n=typeof n==`object`&&n&&Object.hasOwn(n,e)?n[e]:void 0;return n}function D(e,t,n,r){let i=O(r),a=new Set([...O(n)].filter(e=>i.has(e))),o=(e,t,n)=>{let r={...e,...t};for(let i of Object.keys(t)){let s=[...n,i],c=Object.hasOwn(e,i)?e[i]:void 0,l=t[i];a.has(s.join(`\0`))&&k(c)&&k(l)&&y(r,i,o(c,l,s))}return r};return o(e,t,[])}function O(e){let t=/* @__PURE__ */ new Set;for(let{nested:n}of e){let e=n?.path??[];for(let n=1;n<e.length;n++)t.add(e.slice(0,n).join(`\0`))}return t}function k(e){if(typeof e!=`object`||!e)return!1;let t=Object.getPrototypeOf(e);return t===Object.prototype||t===null}function A(e){return o(e)?e.unknownKeys:n().getUnknownKeysMode(e)}const j=/* @__PURE__ */ new WeakSet,M=/* @__PURE__ */ new WeakMap;function N(e){let t=o(e)?l(e):F(e,n().extractFields(e));return j.has(t)||(L(t),j.add(t)),t}function P(e){for(let t of e.unionOptions??[])T(t.schema),P(t)}function F(e,t){P(t);let n=w(e);if(!n)return t;let r=M.get(t);return r||(r=I(t,v(n)),M.set(t,r)),r}function I(e,t){let n=e=>e.map(e=>{let n=t(e.name);return n.length>1?{...e,nested:{path:n}}:e});return{...e,fields:n(e.fields),...e.variants&&{variants:e.variants.map(e=>({...e,fields:n(e.fields)}))},...e.unionOptions&&{unionOptions:e.unionOptions.map(e=>I(e,t))}}}function L(e){let t=e.variants??[e];for(let n of t)for(let t of n.fields)if(t.requiredPackages?.length&&t.type!==`boolean`&&t.name!==e.discriminator)throw Error(`Invalid requiredPackages for field "${t.name}": requiredPackages can only be used on boolean fields or discriminators.`);for(let t of e.unionOptions??[])L(t)}function R(e){return e.args?N(e.args):null}function z(e,t){let[n,...r]=e,i=/* @__PURE__ */ new Set;for(let e of n?.fields??[])e.name!==t&&r.every(t=>t.fields.some(t=>t.name===e.name&&t.positional===e.positional&&t.named===e.named&&B(t.requiredPackages,e.requiredPackages)))&&i.add(e.name);return i}function B(e,t){return(e?.length??0)===(t?.length??0)&&(e??[]).every((e,n)=>{let r=t?.[n];return e.name===r?.name&&e.install===r.install&&e.from?.toString()===r.from?.toString()})}function V(e){let t=W(e).filter(e=>e.named);return G(e,e=>e.named).map(e=>{let n=t.filter(t=>t.name===e.name),r=[...new Set(n.flatMap(e=>e.alias??[]))],i=[...new Set(n.flatMap(e=>e.hiddenAlias??[]))];return{...e,alias:r.length>0?r:e.alias,hiddenAlias:i.length>0?i:e.hiddenAlias}})}function H(e){return G(e,e=>e.positional)}function U(e){return G(e,e=>!e.positional)}function W(e){let t=e.variants??e.unionOptions??[];return[e.fields,...t.map(e=>e.fields)].flat()}function G(e,t){let n=/* @__PURE__ */ new Map;for(let r of W(e))t(r)&&!n.has(r.name)&&n.set(r.name,r);return[...n.values()]}function K(e,t){let{discriminator:n,variants:r}=e;if(!n||!r){let n=e.unionOptions??[],r=n.map(e=>K(e,t));if(r.every((e,t)=>e===n[t]))return e;let i=r.filter((r,i)=>{let a=t(r),o=n[i];if(o.discriminator&&a[o.discriminator]!==void 0&&r===o)return!1;let s=new Set(r.fields.map(e=>e.name));return!e.fields.some(e=>a[e.name]!==void 0&&!s.has(e.name))});if(!i.length)return e;let a=/* @__PURE__ */ new Map;for(let e of i)for(let t of e.fields){let e=a.get(t.name);e?a.set(t.name,{...e,type:e.type===t.type?e.type:`unknown`,named:e.named||t.named,positional:e.positional||t.positional,alias:[.../* @__PURE__ */ new Set([...e.alias??[],...t.alias??[]])],hiddenAlias:[.../* @__PURE__ */ new Set([...e.hiddenAlias??[],...t.hiddenAlias??[]])]}):a.set(t.name,t)}return{...e,fields:[...a.values()]}}let i=r.map(r=>{let i={...e,fields:r.fields};return{variant:r,fields:i,value:t(i)[n]}});for(let{variant:e,fields:t,value:n}of i)if(n!==void 0&&String(n)===e.discriminatorValue)return t;for(let{variant:e,fields:t,value:n}of i)if(n!==void 0&&e.normalizeDiscriminator&&String(e.normalizeDiscriminator(n))===e.discriminatorValue)return t;return e}function q(e,t){return U(e).find(e=>e.name===t)}export{m as _,V as a,H as c,E as d,D as f,o as g,i as h,A as i,K as l,a as m,N as n,q as o,C as p,R as r,U as s,z as t,x as u};