@boneskull/bargs 2.0.0 → 3.0.0

package/dist/opt.js

@@ -1,31 +1,16 @@
 /**
- * Builder functions for defining CLI options, positionals, and commands.
+ * Builder functions for defining CLI options and positionals.
  *
  * Provides ergonomic helpers with full TypeScript type inference for
  * constructing option schemas (`opt.string()`, `opt.boolean()`, `opt.enum()`,
- * etc.), positional schemas (`opt.stringPos()`, `opt.numberPos()`,
- * `opt.variadic()`), and command definitions (`opt.command()`). Includes
- * composition utilities for merging schemas (`opt.options()`,
- * `opt.positionals()`).
+ * etc.) and positional schemas (`opt.stringPos()`, `opt.numberPos()`,
+ * `opt.variadic()`).
  *
  * @packageDocumentation
  */
 import { BargsError } from "./errors.js";
 /**
- * Implementation of command builder that detects whether it's called with
- * config (direct) or without args (curried for global options).
- */
-const commandBuilder = (configOrNothing) => {
-    if (configOrNothing === undefined) {
-        // Curried usage: return function that accepts config
-        return (config) => config;
-    }
-    // Direct usage: return config as-is
-    return configOrNothing;
-};
-/**
- * Validate that no alias conflicts exist in a merged options schema. Throws
- * BargsError if the same alias is used by multiple options.
+ * Validate that no alias conflicts exist in a merged options schema.
  */
 const validateAliasConflicts = (schema) => {
     const aliasToOption = new Map();
@@ -43,32 +28,56 @@ const validateAliasConflicts = (schema) => {
     }
 };
 /**
- * Compose multiple option schemas into one.
+ * Create a Parser from an options schema that can also merge with existing
+ * parsers.
+ *
+ * Supports two usage patterns:
+ *
+ * 1. Standalone: `opt.options({ ... })` - returns a Parser
+ * 2. Merging: `pos.positionals(...)(opt.options(...))` - merges positionals into
+ *    options
  */
-const optionsImpl = (...schemas) => {
-    const merged = Object.assign({}, ...schemas);
-    validateAliasConflicts(merged);
-    return merged;
+const optionsImpl = (schema) => {
+    validateAliasConflicts(schema);
+    // Create the merge function
+    const merger = (parser) => {
+        const mergedSchema = { ...parser.__optionsSchema, ...schema };
+        validateAliasConflicts(mergedSchema);
+        // Preserve transforms from the incoming parser
+        const transformed = parser;
+        const result = {
+            ...parser,
+            __brand: 'Parser',
+            __optionsSchema: mergedSchema,
+            __values: {},
+        };
+        if (transformed.__transform) {
+            result.__transform = transformed.__transform;
+        }
+        return result;
+    };
+    // Add Parser properties to the function
+    const parserProps = {
+        __brand: 'Parser',
+        __optionsSchema: schema,
+        __positionals: [],
+        __positionalsSchema: [],
+        __values: {},
+    };
+    return Object.assign(merger, parserProps);
 };
-/**
- * Create a positionals schema from positional definitions.
- */
-const positionalsImpl = (...positionals) => positionals;
 /**
  * Namespaced option builders.
  *
- * Provides ergonomic helpers for defining CLI options, positionals, and
- * commands with full TypeScript type inference.
- *
  * @example
  *
  * ```typescript
  * import { opt } from 'bargs';
  *
- * const options = opt.options({
+ * const parser = opt.options({
  *   verbose: opt.boolean({ aliases: ['v'] }),
  *   name: opt.string({ default: 'world' }),
- *   level: opt.enum(['low', 'medium', 'high'] as const),
+ *   level: opt.enum(['low', 'medium', 'high']),
  * });
  * ```
  */
@@ -83,61 +92,12 @@ export const opt = {
         ...props,
     }),
     /**
-     * Define a boolean option. Props type is preserved to enable default
-     * inference.
+     * Define a boolean option.
      */
     boolean: (props = {}) => ({
         type: 'boolean',
         ...props,
     }),
-    /**
-     * Define a command with proper type inference.
-     *
-     * Three usage patterns:
-     *
-     * 1. Simple usage (no global options): `bargs.command({ ... })`
-     * 2. With global options: `bargs.command<typeof globalOptions>()({ ... })`
-     * 3. With global options AND transforms: `bargs.command<typeof globalOptions,
-     *    typeof globalTransforms>()({ ... })`
-     *
-     * @example
-     *
-     * ```typescript
-     * // Simple usage - no global options typed
-     * const simpleCmd = bargs.command({
-     *   description: 'Simple command',
-     *   handler: ({ values }) => { ... },
-     * });
-     *
-     * // With global options typed
-     * const globalOptions = {
-     *   verbose: bargs.boolean({ aliases: ['v'] }),
-     * } as const;
-     *
-     * const greetCmd = bargs.command<typeof globalOptions>()({
-     *   description: 'Greet someone',
-     *   options: { name: bargs.string({ default: 'world' }) },
-     *   handler: ({ values }) => {
-     *     // values.verbose is properly typed as boolean | undefined
-     *     console.log(`Hello, ${values.name}!`);
-     *   },
-     * });
-     *
-     * // With global options AND global transforms typed
-     * const globalTransforms = {
-     *   values: (v) => ({ ...v, timestamp: Date.now() }),
-     * } as const;
-     *
-     * const timedCmd = bargs.command<typeof globalOptions, typeof globalTransforms>()({
-     *   description: 'Time-aware command',
-     *   handler: ({ values }) => {
-     *     // values.timestamp is properly typed from global transforms
-     *     console.log(`Ran at ${values.timestamp}`);
-     *   },
-     * });
-     * ```
-     */
-    command: commandBuilder,
     /**
      * Define a count option (--verbose --verbose = 2).
      */
@@ -146,9 +106,7 @@ export const opt = {
         ...props,
     }),
     /**
-     * Define an enum option with string choices. The choices array is inferred as
-     * a tuple of literal types automatically. Props type is preserved to enable
-     * default inference.
+     * Define an enum option with string choices.
      */
     enum: (choices, props = {}) => ({
         choices,
@@ -156,8 +114,7 @@ export const opt = {
         ...props,
     }),
     /**
-     * Define an enum positional argument with string choices. The choices array
-     * is inferred as a tuple of literal types automatically.
+     * Define an enum positional argument with string choices.
      */
     enumPos: (choices, props = {}) => ({
         choices,
@@ -165,75 +122,144 @@ export const opt = {
         ...props,
     }),
     /**
-     * Define a number option. Props type is preserved to enable default
-     * inference.
+     * Define a number option.
      */
     number: (props = {}) => ({
         type: 'number',
         ...props,
     }),
-    // ─── Positional Builders ───────────────────────────────────────────
     /**
-     * Define a number positional argument. Props type is preserved to enable
-     * required inference.
+     * Define a number positional argument.
      */
     numberPos: (props = {}) => ({
         type: 'number',
         ...props,
     }),
     /**
-     * Compose multiple option schemas into one. Later schemas override earlier
-     * ones for duplicate option names. Validates that no alias conflicts exist.
+     * Create a Parser from an options schema.
      *
      * @example
      *
      * ```typescript
-     * // Single schema (identity, enables reuse)
-     * const loggingOpts = opt.options({
+     * const parser = opt.options({
      *   verbose: opt.boolean({ aliases: ['v'] }),
-     *   quiet: opt.boolean({ aliases: ['q'] }),
-     * });
-     *
-     * // Merge multiple schemas
-     * const allOpts = opt.options(loggingOpts, ioOpts, {
-     *   format: opt.enum(['json', 'yaml'] as const),
+     *   name: opt.string({ default: 'world' }),
      * });
+     * // Type: Parser<{ verbose: boolean | undefined, name: string }, []>
      * ```
-     *
-     * @throws BargsError if multiple options use the same alias
      */
     options: optionsImpl,
     /**
-     * Create a positionals schema with proper tuple type inference.
+     * Define a string option.
+     */
+    string: (props = {}) => ({
+        type: 'string',
+        ...props,
+    }),
+    /**
+     * Define a string positional argument.
+     */
+    stringPos: (props = {}) => ({
+        type: 'string',
+        ...props,
+    }),
+    /**
+     * Define a variadic positional (rest args).
+     */
+    variadic: (items, props = {}) => ({
+        items,
+        type: 'variadic',
+        ...props,
+    }),
+};
+/**
+ * Create a Parser from positional definitions that can also merge with existing
+ * parsers.
+ *
+ * Supports two usage patterns:
+ *
+ * 1. Standalone: `pos.positionals(...)` - returns a Parser
+ * 2. Merging: `pos.positionals(...)(opt.options(...))` - merges positionals into
+ *    options
+ */
+const positionalsImpl = (...positionals) => {
+    // Create the merge function - just passes through V2, no intersection needed
+    const merger = (parser) => {
+        // Preserve transforms from the incoming parser
+        const transformed = parser;
+        const result = {
+            ...parser,
+            __brand: 'Parser',
+            __positionals: [],
+            __positionalsSchema: [...parser.__positionalsSchema, ...positionals],
+        };
+        if (transformed.__transform) {
+            result.__transform = transformed.__transform;
+        }
+        return result;
+    };
+    // Add Parser properties to the function
+    // Use empty object {} instead of Record<string, never> for better intersection behavior
+    const parserProps = {
+        __brand: 'Parser',
+        __optionsSchema: {},
+        __positionals: [],
+        __positionalsSchema: positionals,
+        __values: {},
+    };
+    return Object.assign(merger, parserProps);
+};
+/**
+ * Namespaced positional builders.
+ *
+ * @example
+ *
+ * ```typescript
+ * import { pos } from 'bargs';
+ *
+ * const parser = pos.positionals(
+ *   pos.string({ name: 'input', required: true }),
+ *   pos.string({ name: 'output' }),
+ * );
+ * ```
+ */
+export const pos = {
+    /**
+     * Define an enum positional argument with string choices.
+     */
+    enum: (choices, props = {}) => ({
+        choices,
+        type: 'enum',
+        ...props,
+    }),
+    /**
+     * Define a number positional argument.
+     */
+    number: (props = {}) => ({
+        type: 'number',
+        ...props,
+    }),
+    /**
+     * Create a Parser from positional definitions.
      *
      * @example
      *
      * ```typescript
-     * const positionals = opt.positionals(
-     *   opt.stringPos({ description: 'Input file', required: true }),
-     *   opt.stringPos({ description: 'Output file' }),
+     * const parser = pos.positionals(
+     *   pos.string({ name: 'input', required: true }),
+     *   pos.string({ name: 'output' }),
      * );
+     * // Type: Parser<{}, readonly [string, string | undefined]>
      * ```
      */
     positionals: positionalsImpl,
     /**
-     * Define a string option. Props type is preserved to enable default
-     * inference.
+     * Define a string positional argument.
      */
     string: (props = {}) => ({
         type: 'string',
         ...props,
     }),
-    // ─── Composition ───────────────────────────────────────────────────
-    /**
-     * Define a string positional argument. Props type is preserved to enable
-     * required inference.
-     */
-    stringPos: (props = {}) => ({
-        type: 'string',
-        ...props,
-    }),
-    // ─── Command Builder ───────────────────────────────────────────────
     /**
      * Define a variadic positional (rest args).
      */

package/dist/opt.js.map

@@ -1 +1 @@
-{"version":3,"file":"opt.js","sourceRoot":"","sources":["../src/opt.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"opt.js","sourceRoot":"","sources":["../src/opt.ts"],"names":[],"mappings":"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"}

package/dist/parser.cjs

@@ -7,93 +7,12 @@
  * - Building `parseArgs` configuration from bargs option schemas
  * - Coercing parsed string values to their declared types (number, enum, etc.)
  * - Processing positional arguments including variadic rest args
- * - Running handler functions (sync or async) after successful parsing
- * - Supporting both simple CLIs and command-based CLIs with subcommand dispatch
  *
  * @packageDocumentation
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseCommandsAsync = exports.parseCommandsSync = exports.parseSimple = exports.runHandler = exports.runSyncHandler = void 0;
-exports.runSyncTransforms = runSyncTransforms;
-exports.runTransforms = runTransforms;
+exports.parseSimple = void 0;
 const node_util_1 = require("node:util");
-const errors_js_1 = require("./errors.cjs");
-/**
- * Check if a value is a thenable (Promise-like). Uses duck-typing for
- * cross-realm compatibility.
- */
-const isThenable = (value) => value !== null &&
-    typeof value === 'object' &&
-    typeof value.then === 'function';
-/**
- * Run a handler synchronously. Throws if handler returns a thenable.
- */
-const runSyncHandler = (handler, result) => {
-    const maybePromise = handler(result);
-    if (isThenable(maybePromise)) {
-        throw new errors_js_1.BargsError('Handler returned a thenable. Use bargsAsync() for async handlers.');
-    }
-};
-exports.runSyncHandler = runSyncHandler;
-/**
- * Run a handler (async).
- */
-const runHandler = async (handler, result) => {
-    await handler(result);
-};
-exports.runHandler = runHandler;
-/**
- * Run transforms synchronously. Throws if any transform returns a thenable.
- */
-function runSyncTransforms(transforms, values, positionals) {
-    if (!transforms) {
-        return { positionals, values };
-    }
-    // Apply values transform
-    const transformedValues = transforms.values
-        ? (() => {
-            const result = transforms.values(values);
-            if (isThenable(result)) {
-                throw new errors_js_1.BargsError('Transform returned a thenable. Use bargsAsync() for async transforms.');
-            }
-            return result;
-        })()
-        : values;
-    // Apply positionals transform
-    const transformedPositionals = transforms.positionals
-        ? (() => {
-            const result = transforms.positionals(positionals);
-            if (isThenable(result)) {
-                throw new errors_js_1.BargsError('Transform returned a thenable. Use bargsAsync() for async transforms.');
-            }
-            return result;
-        })()
-        : positionals;
-    return {
-        positionals: transformedPositionals,
-        values: transformedValues,
-    };
-}
-/**
- * Run transforms asynchronously.
- */
-async function runTransforms(transforms, values, positionals) {
-    if (!transforms) {
-        return { positionals, values };
-    }
-    // Apply values transform (await if needed)
-    const transformedValues = transforms.values
-        ? await transforms.values(values)
-        : values;
-    // Apply positionals transform (await if needed)
-    const transformedPositionals = transforms.positionals
-        ? await transforms.positionals(positionals)
-        : positionals;
-    return {
-        positionals: transformedPositionals,
-        values: transformedValues,
-    };
-}
 /**
  * Build parseArgs options config from our options schema.
  */
@@ -165,9 +84,6 @@ const coerceValues = (values, schema) => {
 };
 /**
  * Coerce positional values.
- *
- * Note: Schema validation (variadic last, required order) is done upfront by
- * validateConfig in bargs.ts.
  */
 const coercePositionals = (positionals, schema) => {
     const result = [];
@@ -175,7 +91,7 @@ const coercePositionals = (positionals, schema) => {
         const def = schema[i];
         const value = positionals[i];
         if (def.type === 'variadic') {
-            // Rest of positionals - def is narrowed to VariadicPositional here
+            // Rest of positionals
             const variadicDef = def;
             const rest = positionals.slice(i);
             if (variadicDef.items === 'number') {
@@ -214,8 +130,7 @@ const coercePositionals = (positionals, schema) => {
     return result;
 };
 /**
- * Parse arguments for a simple CLI (no commands). This is synchronous - it only
- * parses, does not run handlers.
+ * Parse arguments for a simple CLI (no commands).
  */
 const parseSimple = (config) => {
     const { args = process.argv.slice(2), options: optionsSchema = {}, positionals: positionalsSchema = [], } = config;
@@ -232,151 +147,9 @@ const parseSimple = (config) => {
     const coercedValues = coerceValues(values, optionsSchema);
     const coercedPositionals = coercePositionals(positionals, positionalsSchema);
     return {
-        command: undefined,
         positionals: coercedPositionals,
         values: coercedValues,
     };
 };
 exports.parseSimple = parseSimple;
-/**
- * Core command parsing logic (sync, no handler execution). Returns the parsed
- * result and the handler to run.
- */
-const parseCommandsCore = (config) => {
-    const { args = process.argv.slice(2), commands, defaultHandler, options: globalOptions = {}, } = config;
-    const commandsRecord = commands;
-    // Find command name (first non-flag argument)
-    const commandIndex = args.findIndex((arg) => !arg.startsWith('-'));
-    const commandName = commandIndex >= 0 ? args[commandIndex] : undefined;
-    const remainingArgs = commandName
-        ? [...args.slice(0, commandIndex), ...args.slice(commandIndex + 1)]
-        : args;
-    // No command specified
-    if (!commandName) {
-        if (typeof defaultHandler === 'string') {
-            // Use named default command (recursive)
-            return parseCommandsCore({
-                ...config,
-                args: [defaultHandler, ...args],
-                defaultHandler: undefined,
-            });
-        }
-        else if (typeof defaultHandler === 'function') {
-            // Parse global options only
-            const parseArgsOptions = buildParseArgsConfig(globalOptions);
-            const { values } = (0, node_util_1.parseArgs)({
-                allowPositionals: false,
-                args: remainingArgs,
-                options: parseArgsOptions,
-                strict: true,
-            });
-            const coercedValues = coerceValues(values, globalOptions);
-            const result = {
-                command: undefined,
-                positionals: [],
-                values: coercedValues,
-            };
-            return {
-                commandTransforms: undefined,
-                handler: defaultHandler,
-                result,
-                topLevelTransforms: config.transforms,
-            };
-        }
-        else {
-            throw new errors_js_1.HelpError('No command specified.');
-        }
-    }
-    // Find command config
-    const command = commandsRecord[commandName];
-    if (!command) {
-        throw new errors_js_1.HelpError(`Unknown command: ${commandName}`);
-    }
-    // Merge global and command options
-    const commandOptions = command.options ?? {};
-    const mergedOptionsSchema = { ...globalOptions, ...commandOptions };
-    const commandPositionals = command.positionals ?? [];
-    // Build parseArgs config
-    const parseArgsOptions = buildParseArgsConfig(mergedOptionsSchema);
-    // Parse
-    const { positionals, values } = (0, node_util_1.parseArgs)({
-        allowPositionals: commandPositionals.length > 0,
-        args: remainingArgs,
-        options: parseArgsOptions,
-        strict: true,
-    });
-    // Coerce
-    const coercedValues = coerceValues(values, mergedOptionsSchema);
-    const coercedPositionals = coercePositionals(positionals, commandPositionals);
-    const result = {
-        command: commandName,
-        positionals: coercedPositionals,
-        values: coercedValues,
-    };
-    return {
-        commandTransforms: command.transforms,
-        handler: command.handler,
-        result,
-        topLevelTransforms: config.transforms,
-    };
-};
-/**
- * Parse arguments for a command-based CLI (sync). Throws if any handler or
- * transform returns a thenable.
- */
-const parseCommandsSync = (config) => {
-    const { commandTransforms, handler, result, topLevelTransforms } = parseCommandsCore(config);
-    // Apply transforms: top-level first, then command-level
-    let currentValues = result.values;
-    let currentPositionals = result.positionals;
-    if (topLevelTransforms) {
-        const transformed = runSyncTransforms(topLevelTransforms, currentValues, currentPositionals);
-        currentValues = transformed.values;
-        currentPositionals = transformed.positionals;
-    }
-    if (commandTransforms) {
-        const transformed = runSyncTransforms(commandTransforms, currentValues, currentPositionals);
-        currentValues = transformed.values;
-        currentPositionals = transformed.positionals;
-    }
-    const finalResult = {
-        command: result.command,
-        positionals: currentPositionals,
-        values: currentValues,
-    };
-    if (handler) {
-        (0, exports.runSyncHandler)(handler, finalResult);
-    }
-    return finalResult;
-};
-exports.parseCommandsSync = parseCommandsSync;
-/**
- * Parse arguments for a command-based CLI (async).
- */
-const parseCommandsAsync = async (config) => {
-    const { commandTransforms, handler, result, topLevelTransforms } = parseCommandsCore(config);
-    // Apply transforms: top-level first, then command-level
-    let currentValues = result.values;
-    let currentPositionals = result.positionals;
-    if (topLevelTransforms) {
-        const transformed = await runTransforms(topLevelTransforms, currentValues, currentPositionals);
-        currentValues = transformed.values;
-        currentPositionals = transformed.positionals;
-    }
-    if (commandTransforms) {
-        const transformed = await runTransforms(commandTransforms, currentValues, currentPositionals);
-        currentValues = transformed.values;
-        currentPositionals = transformed.positionals;
-    }
-    const finalResult = {
-        command: result.command,
-        positionals: currentPositionals,
-        values: currentValues,
-    };
-    if (handler) {
-        await (0, exports.runHandler)(handler, finalResult);
-    }
-    return finalResult;
-};
-exports.parseCommandsAsync = parseCommandsAsync;
 //# sourceMappingURL=parser.js.map