/**
 * Core bargs API using parser combinator pattern.
 *
 * Provides `bargs()` for building CLIs with a fluent API, plus combinator
 * functions like `pipe()`, `map()`, and `handle()`.
 *
 * @packageDocumentation
 */
import type { CamelCaseKeys, CliBuilder, Command, CreateOptions, HandlerFn, Parser, ParseResult } from "./types.js";
/**
 * Transform fn type - can be sync or async.
 *
 * @group Combinators
 * @knipignore
 */
export type TransformFn<V1, P1 extends readonly unknown[], V2, P2 extends readonly unknown[]> = (result: ParseResult<V1, P1>) => ParseResult<V2, P2> | Promise<ParseResult<V2, P2>>;
/**
 * Create a command with a handler (terminal in the pipeline).
 *
 * @group Combinators
 */
export declare function handle<V, P extends readonly unknown[]>(fn: HandlerFn<V, P>): (parser: Parser<V, P>) => Command<V, P>;
export declare function handle<V, P extends readonly unknown[]>(parser: Parser<V, P>, fn: HandlerFn<V, P>): Command<V, P>;
/**
 * Transform parse result in the pipeline.
 *
 * @group Combinators
 */
export declare function map<V1, P1 extends readonly unknown[], V2, P2 extends readonly unknown[]>(fn: TransformFn<V1, P1, V2, P2>): (parser: Parser<V1, P1>) => Parser<V2, P2>;
export declare function map<V1, P1 extends readonly unknown[], V2, P2 extends readonly unknown[]>(parser: Parser<V1, P1>, fn: TransformFn<V1, P1, V2, P2>): Parser<V2, P2>;
/**
 * Merge multiple parsers into one.
 *
 * Combines options and positionals from all parsers. Later parsers' options
 * override earlier ones if there are conflicts.
 *
 * @example
 *
 * ```typescript
 * const parser = merge(
 *   opt.options({ verbose: opt.boolean() }),
 *   pos.positionals(pos.string({ name: 'file', required: true })),
 * );
 * ```
 *
 * @group Combinators
 */
export declare function merge<V1, P1 extends readonly unknown[], V2, P2 extends readonly unknown[]>(p1: Parser<V1, P1>, p2: Parser<V2, P2>): Parser<V1 & V2, readonly [...P1, ...P2]>;
export declare function merge<V1, P1 extends readonly unknown[], V2, P2 extends readonly unknown[], V3, P3 extends readonly unknown[]>(p1: Parser<V1, P1>, p2: Parser<V2, P2>, p3: Parser<V3, P3>): Parser<V1 & V2 & V3, readonly [...P1, ...P2, ...P3]>;
export declare function merge<V1, P1 extends readonly unknown[], V2, P2 extends readonly unknown[], V3, P3 extends readonly unknown[], V4, P4 extends readonly unknown[]>(p1: Parser<V1, P1>, p2: Parser<V2, P2>, p3: Parser<V3, P3>, p4: Parser<V4, P4>): Parser<V1 & V2 & V3 & V4, readonly [...P1, ...P2, ...P3, ...P4]>;
/**
 * Transform for use with `map()` that converts kebab-case option keys to
 * camelCase.
 *
 * @example
 *
 * ```typescript
 * import { bargs, opt, map, camelCaseValues } from '@boneskull/bargs';
 *
 * const { values } = await bargs('my-cli')
 *   .globals(
 *     map(opt.options({ 'output-dir': opt.string() }), camelCaseValues),
 *   )
 *   .parseAsync();
 *
 * console.log(values.outputDir); // camelCased!
 * ```
 *
 * @function
 * @group Transforms
 */
export declare const camelCaseValues: <V, P extends readonly unknown[]>(result: ParseResult<V, P>) => ParseResult<CamelCaseKeys<V>, P>;
/**
 * Create a new CLI.
 *
 * @example
 *
 * ```typescript
 * const cli = await bargs('my-app', { version: '1.0.0' })
 *   .globals(
 *     map(opt.options({ verbose: opt.boolean() }), ({ values }) => ({
 *       values: { ...values, ts: Date.now() },
 *       positionals: [] as const,
 *     })),
 *   )
 *   .command(
 *     'greet',
 *     pos.positionals(pos.string({ name: 'name', required: true })),
 *     ({ positionals }) => console.log(`Hello, ${positionals[0]}!`),
 *   )
 *   .parseAsync();
 * ```
 *
 * @function
 * @group Core API
 */
export declare const bargs: {
    (name: string, options?: CreateOptions): CliBuilder<Record<string, never>, readonly []>;
    /**
     * @ignore
     * @deprecated
     */
    create: /*elided*/ any;
};
//# sourceMappingURL=bargs.d.ts.map