@boneskull/bargs 3.0.0 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/types.d.ts CHANGED
@@ -17,8 +17,8 @@ import type { ThemeInput } from "./theme.js";
17
17
  */
18
18
  export interface ArrayOption extends OptionBase {
19
19
  default?: number[] | string[];
20
- /** Element type of the array */
21
- items: 'number' | 'string';
20
+ /** Element type of the array (for primitive arrays) */
21
+ items?: 'number' | 'string';
22
22
  type: 'array';
23
23
  }
24
24
  /**
@@ -96,6 +96,12 @@ export interface CliResult<TValues = Record<string, unknown>, TPositionals exten
96
96
  * Command with handler attached (terminal in the pipeline).
97
97
  */
98
98
  export interface Command<TValues = Record<string, unknown>, TPositionals extends readonly unknown[] = readonly unknown[]> {
99
+ /** Brand for type discrimination. Do not use directly. */
100
+ readonly __brand: 'Command';
101
+ /** Options schema. Do not use directly. */
102
+ readonly __optionsSchema: OptionsSchema;
103
+ /** Positionals schema. Do not use directly. */
104
+ readonly __positionalsSchema: PositionalsSchema;
99
105
  /** Command description for help text */
100
106
  readonly description?: string;
101
107
  /** The handler function */
@@ -132,6 +138,15 @@ export interface CreateOptions {
132
138
  /** Version string (enables --version flag) */
133
139
  version?: string;
134
140
  }
141
+ /**
142
+ * Enum array option definition (--flag a --flag b with limited choices).
143
+ */
144
+ export interface EnumArrayOption<T extends string = string> extends OptionBase {
145
+ /** Valid choices for array elements */
146
+ choices: readonly T[];
147
+ default?: T[];
148
+ type: 'array';
149
+ }
135
150
  /**
136
151
  * Enum option definition with string choices.
137
152
  */
@@ -155,7 +170,7 @@ export type HandlerFn<TValues, TPositionals extends readonly unknown[]> = (resul
155
170
  /**
156
171
  * Infer the TypeScript type from an option definition.
157
172
  */
158
- export type InferOption<T extends OptionDef> = T extends BooleanOption ? T['required'] extends true ? boolean : T['default'] extends boolean ? boolean : boolean | undefined : T extends NumberOption ? T['required'] extends true ? number : T['default'] extends number ? number : number | undefined : T extends StringOption ? T['required'] extends true ? string : T['default'] extends string ? string : string | undefined : T extends EnumOption<infer E> ? T['required'] extends true ? E : T['default'] extends E ? E : E | undefined : T extends ArrayOption ? T['items'] extends 'number' ? number[] : string[] : T extends CountOption ? number : never;
173
+ export type InferOption<T extends OptionDef> = T extends BooleanOption ? T['required'] extends true ? boolean : T['default'] extends boolean ? boolean : boolean | undefined : T extends NumberOption ? T['required'] extends true ? number : T['default'] extends number ? number : number | undefined : T extends StringOption ? T['required'] extends true ? string : T['default'] extends string ? string : string | undefined : T extends EnumOption<infer E> ? T['required'] extends true ? E : T['default'] extends E ? E : E | undefined : T extends EnumArrayOption<infer E> ? E[] : T extends ArrayOption ? T['items'] extends 'number' ? number[] : string[] : T extends CountOption ? number : never;
159
174
  /**
160
175
  * Infer values type from an options schema.
161
176
  */
@@ -202,7 +217,7 @@ export interface NumberPositional extends PositionalBase {
202
217
  /**
203
218
  * Union of all option definitions.
204
219
  */
205
- export type OptionDef = ArrayOption | BooleanOption | CountOption | EnumOption<string> | NumberOption | StringOption;
220
+ export type OptionDef = ArrayOption | BooleanOption | CountOption | EnumArrayOption<string> | EnumOption<string> | NumberOption | StringOption;
206
221
  /**
207
222
  * Options schema: a record of option names to their definitions.
208
223
  */
@@ -212,6 +227,16 @@ export type OptionsSchema = Record<string, OptionDef>;
212
227
  * schemas. This is a branded type for type-level tracking.
213
228
  */
214
229
  export interface Parser<TValues = Record<string, unknown>, TPositionals extends readonly unknown[] = readonly unknown[]> {
230
+ /** Brand for type discrimination. Do not use directly. */
231
+ readonly __brand: 'Parser';
232
+ /** Options schema. Do not use directly. */
233
+ readonly __optionsSchema: OptionsSchema;
234
+ /** Phantom type for positionals. Do not use directly. */
235
+ readonly __positionals: TPositionals;
236
+ /** Positionals schema. Do not use directly. */
237
+ readonly __positionalsSchema: PositionalsSchema;
238
+ /** Phantom type for values. Do not use directly. */
239
+ readonly __values: TValues;
215
240
  }
216
241
  /**
217
242
  * Core parse result shape flowing through the pipeline.
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@boneskull/bargs",
3
- "version": "3.0.0",
3
+ "version": "3.1.0",
4
4
  "type": "module",
5
5
  "description": "A TypeScript-first CLI argument parser wrapping util.parseArgs() with full type inference",
6
6
  "repository": {
@@ -41,7 +41,8 @@
41
41
  "scripts": {
42
42
  "build": "zshy",
43
43
  "commitlint": "commitlint",
44
- "docs": "typedoc",
44
+ "docs": "typedoc --treatWarningsAsErrors",
45
+ "docs:dev": "typedoc --watch",
45
46
  "fix": "run-s -sl fix:*",
46
47
  "fix:eslint": "eslint --fix .",
47
48
  "fix:markdown": "markdownlint-cli2 --fix \"**/*.md\"",
@@ -85,6 +86,8 @@
85
86
  "prettier-plugin-sort-json": "4.1.1",
86
87
  "tsx": "4.21.0",
87
88
  "typedoc": "0.28.15",
89
+ "typedoc-plugin-extras": "4.0.1",
90
+ "typedoc-plugin-mdn-links": "5.0.10",
88
91
  "typescript": "5.9.3",
89
92
  "typescript-eslint": "8.50.0",
90
93
  "zshy": "0.6.0"