@boneskull/bargs 0.1.1

package/dist/help.js

@@ -0,0 +1,304 @@
+/**
+ * Help text generation for CLI applications.
+ *
+ * Generates formatted, colorized help output for both simple CLIs and
+ * command-based CLIs. Supports customizable themes, automatic URL linkification
+ * in terminals that support hyperlinks, option grouping, and automatic epilog
+ * generation from `package.json` metadata.
+ *
+ * @packageDocumentation
+ */
+import { link, supportsHyperlinks } from "./osc.js";
+import { createStyler, defaultTheme, } from "./theme.js";
+import { readPackageInfoSync } from "./version.js";
+/**
+ * URL regex pattern for matching URLs in text.
+ */
+const URL_PATTERN = /https?:\/\/[^\s<>"\])}]+/g;
+/**
+ * Linkify URLs in text if terminal supports hyperlinks. Applies URL styling.
+ */
+const linkifyText = (text, styler, stream = process.stdout) => {
+    const canLink = supportsHyperlinks(stream);
+    return text.replace(URL_PATTERN, (url) => {
+        const styledUrl = styler.url(url);
+        return canLink ? link(styledUrl, url) : styledUrl;
+    });
+};
+/**
+ * Generate default epilog from package.json (homepage and repository).
+ */
+const generateDefaultEpilog = (styler) => {
+    const pkgInfo = readPackageInfoSync();
+    const lines = [];
+    if (pkgInfo.homepage) {
+        const styledUrl = styler.url(pkgInfo.homepage);
+        const linkedUrl = supportsHyperlinks()
+            ? link(styledUrl, pkgInfo.homepage)
+            : styledUrl;
+        lines.push(styler.epilog(`Homepage: ${linkedUrl}`));
+    }
+    if (pkgInfo.repository) {
+        const styledUrl = styler.url(pkgInfo.repository);
+        const linkedUrl = supportsHyperlinks()
+            ? link(styledUrl, pkgInfo.repository)
+            : styledUrl;
+        lines.push(styler.epilog(`Repository: ${linkedUrl}`));
+    }
+    return lines;
+};
+/**
+ * Format epilog based on config. Returns empty array if epilog is disabled,
+ * custom epilog lines if provided, or default epilog from package.json.
+ */
+const formatEpilog = (config, styler) => {
+    // Explicitly disabled
+    if (config.epilog === false || config.epilog === '') {
+        return [];
+    }
+    // Custom epilog provided
+    if (typeof config.epilog === 'string') {
+        const linkified = linkifyText(config.epilog, styler);
+        return [styler.epilog(linkified)];
+    }
+    // Default: generate from package.json
+    return generateDefaultEpilog(styler);
+};
+/**
+ * Format a single positional for help usage line. Required positionals use
+ * <name>, optional use [name]. Variadic positionals append "...".
+ */
+const formatPositionalUsage = (def, index) => {
+    const name = def.name ?? `arg${index}`;
+    const isRequired = def.required || 'default' in def;
+    const isVariadic = def.type === 'variadic';
+    const displayName = isVariadic ? `${name}...` : name;
+    return isRequired ? `<${displayName}>` : `[${displayName}]`;
+};
+/**
+ * Build the positionals usage string from a schema.
+ */
+const buildPositionalsUsage = (schema) => {
+    if (!schema || schema.length === 0) {
+        return '';
+    }
+    return schema
+        .map((def, index) => formatPositionalUsage(def, index))
+        .join(' ');
+};
+/**
+ * Get type label for help display.
+ */
+const getTypeLabel = (def) => {
+    switch (def.type) {
+        case 'array':
+            return `${def.items}[]`;
+        case 'boolean':
+            return 'boolean';
+        case 'count':
+            return 'count';
+        case 'enum':
+            return def.choices.join(' | ');
+        case 'number':
+            return 'number';
+        case 'string':
+            return 'string';
+        default:
+            return 'string';
+    }
+};
+/**
+ * Format a single option for help output.
+ */
+const formatOptionHelp = (name, def, styler) => {
+    const parts = [];
+    // Build flag string: -v, --verbose
+    const shortAlias = def.aliases?.find((a) => a.length === 1);
+    const flagText = shortAlias ? `-${shortAlias}, --${name}` : `    --${name}`;
+    parts.push(`  ${styler.flag(flagText)}`);
+    // Pad to align descriptions
+    const padding = Math.max(0, 24 - flagText.length - 2);
+    parts.push(' '.repeat(padding));
+    // Description
+    if (def.description) {
+        parts.push(styler.description(def.description));
+    }
+    // Type and default
+    const typeLabel = getTypeLabel(def);
+    const suffixParts = [styler.type(`[${typeLabel}]`)];
+    if ('default' in def && def.default !== undefined) {
+        suffixParts.push(`${styler.defaultText('default:')} ${styler.defaultValue(JSON.stringify(def.default))}`);
+    }
+    parts.push('  ', suffixParts.join(' '));
+    return parts.join('');
+};
+/**
+ * Check if config has commands.
+ */
+const hasCommands = (config) => config.commands !== undefined && Object.keys(config.commands).length > 0;
+/**
+ * Generate help text for a bargs config.
+ */
+export const generateHelp = (config, theme = defaultTheme) => {
+    const styler = createStyler(theme);
+    const lines = [];
+    // Header
+    const version = config.version ? ` v${config.version}` : '';
+    lines.push('');
+    lines.push(`${styler.scriptName(config.name)}${styler.defaultValue(version)}`);
+    if (config.description) {
+        const linkifiedDesc = linkifyText(config.description, styler);
+        lines.push(`  ${styler.description(linkifiedDesc)}`);
+    }
+    lines.push('');
+    // Build positional names for usage line
+    const posNames = [];
+    if (config.positionals && config.positionals.length > 0) {
+        for (let i = 0; i < config.positionals.length; i++) {
+            const pos = config.positionals[i];
+            const formatted = formatPositionalUsage(pos, i);
+            posNames.push(styler.positional(formatted));
+        }
+    }
+    // Usage
+    lines.push(styler.sectionHeader('USAGE'));
+    if (hasCommands(config)) {
+        const posStr = posNames.length > 0 ? ` ${posNames.join(' ')}` : '';
+        lines.push(styler.usage(`  $ ${config.name} <command> [options]${posStr}`));
+    }
+    else {
+        const posStr = posNames.length > 0 ? ` ${posNames.join(' ')}` : '';
+        lines.push(styler.usage(`  $ ${config.name} [options]${posStr}`));
+    }
+    lines.push('');
+    // Commands
+    if (hasCommands(config)) {
+        lines.push(styler.sectionHeader('COMMANDS'));
+        for (const [name, cmd] of Object.entries(config.commands)) {
+            const padding = Math.max(0, 14 - name.length);
+            lines.push(`  ${styler.command(name)}${' '.repeat(padding)}${styler.description(cmd.description)}`);
+        }
+        lines.push('');
+    }
+    // Options
+    if (config.options && Object.keys(config.options).length > 0) {
+        // Group options
+        const groups = new Map();
+        const ungrouped = [];
+        for (const [name, def] of Object.entries(config.options)) {
+            if (def.hidden) {
+                continue;
+            }
+            if (def.group) {
+                const group = groups.get(def.group) ?? [];
+                group.push({ def, name });
+                groups.set(def.group, group);
+            }
+            else {
+                ungrouped.push({ def, name });
+            }
+        }
+        // Print grouped options
+        for (const [groupName, options] of Array.from(groups.entries())) {
+            lines.push(styler.sectionHeader(groupName.toUpperCase()));
+            for (const opt of options) {
+                lines.push(formatOptionHelp(opt.name, opt.def, styler));
+            }
+            lines.push('');
+        }
+        // Print ungrouped
+        if (ungrouped.length > 0) {
+            const label = hasCommands(config) ? 'GLOBAL OPTIONS' : 'OPTIONS';
+            lines.push(styler.sectionHeader(label));
+            for (const opt of ungrouped) {
+                lines.push(formatOptionHelp(opt.name, opt.def, styler));
+            }
+            lines.push('');
+        }
+    }
+    // Positionals
+    if (config.positionals && config.positionals.length > 0) {
+        lines.push(styler.sectionHeader('POSITIONALS'));
+        for (let i = 0; i < config.positionals.length; i++) {
+            const pos = config.positionals[i];
+            const name = pos.name ?? `arg${i}`;
+            const formatted = pos.required ? `<${name}>` : `[${name}]`;
+            const padding = Math.max(0, 20 - formatted.length);
+            const desc = pos.description ?? '';
+            lines.push(`  ${styler.positional(formatted)}${' '.repeat(padding)}${styler.description(desc)}`);
+        }
+        lines.push('');
+    }
+    // Footer
+    if (hasCommands(config)) {
+        lines.push(styler.example(`Run '${config.name} <command> --help' for command-specific help.`));
+        lines.push('');
+    }
+    // Epilog
+    const epilogLines = formatEpilog(config, styler);
+    if (epilogLines.length > 0) {
+        lines.push(...epilogLines);
+        lines.push('');
+    }
+    return lines.join('\n');
+};
+/**
+ * Generate help text for a specific command.
+ */
+export const generateCommandHelp = (config, commandName, theme = defaultTheme) => {
+    const styler = createStyler(theme);
+    const commandsRecord = config.commands;
+    const command = commandsRecord[commandName];
+    if (!command) {
+        return `Unknown command: ${commandName}`;
+    }
+    const lines = [];
+    // Header
+    lines.push('');
+    lines.push(`  ${styler.scriptName(config.name)} ${styler.command(commandName)}`);
+    const linkifiedDesc = linkifyText(command.description, styler);
+    lines.push(`  ${styler.description(linkifiedDesc)}`);
+    lines.push('');
+    // Usage
+    lines.push(styler.sectionHeader('USAGE'));
+    const positionalsPart = buildPositionalsUsage(command.positionals);
+    const usageParts = [
+        `$ ${config.name} ${commandName}`,
+        '[options]',
+        positionalsPart,
+    ]
+        .filter(Boolean)
+        .join(' ');
+    lines.push(styler.usage(`  ${usageParts}`));
+    lines.push('');
+    // Command options
+    if (command.options && Object.keys(command.options).length > 0) {
+        lines.push(styler.sectionHeader('OPTIONS'));
+        for (const [name, def] of Object.entries(command.options)) {
+            if (def.hidden) {
+                continue;
+            }
+            lines.push(formatOptionHelp(name, def, styler));
+        }
+        lines.push('');
+    }
+    // Global options
+    if (config.options && Object.keys(config.options).length > 0) {
+        lines.push(styler.sectionHeader('GLOBAL OPTIONS'));
+        for (const [name, def] of Object.entries(config.options)) {
+            if (def.hidden) {
+                continue;
+            }
+            lines.push(formatOptionHelp(name, def, styler));
+        }
+        lines.push('');
+    }
+    // Epilog
+    const epilogLines = formatEpilog(config, styler);
+    if (epilogLines.length > 0) {
+        lines.push(...epilogLines);
+        lines.push('');
+    }
+    return lines.join('\n');
+};
+//# sourceMappingURL=help.js.map

package/dist/help.js.map

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

package/dist/index.cjs

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * Main entry point for the bargs CLI argument parser.
+ *
+ * This module exports the primary `bargs` and `bargsAsync` functions with
+ * attached option builder methods (e.g., `bargs.string()`, `bargs.boolean()`),
+ * allowing both function-call and builder-namespace usage patterns. It also
+ * re-exports all public types, error classes, help generators, theme utilities,
+ * and OSC hyperlink functions.
+ *
+ * @example
+ *
+ * ```typescript
+ * import { bargs } from 'bargs';
+ *
+ * // Use as function
+ * const result = bargs({
+ *   name: 'myapp',
+ *   options: { verbose: bargs.boolean({ aliases: ['v'] }) },
+ * });
+ *
+ * // Access builder namespace
+ * const opts = bargs.options({ name: bargs.string() });
+ * ```
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.themes = exports.stripAnsi = exports.defaultTheme = exports.createStyler = exports.ansi = exports.supportsHyperlinks = exports.linkifyUrls = exports.link = exports.generateHelp = exports.generateCommandHelp = exports.ValidationError = exports.HelpError = exports.BargsError = exports.bargsAsync = exports.bargs = void 0;
+const bargs_js_1 = require("./bargs.cjs");
+const opt_js_1 = require("./opt.cjs");
+/**
+ * Main bargs entry point (sync). Also provides access to all opt builders via
+ * bargs.string(), bargs.boolean(), etc.
+ */
+exports.bargs = Object.assign(bargs_js_1.bargs, opt_js_1.opt);
+/**
+ * Async bargs entry point. Also provides access to all opt builders via
+ * bargsAsync.string(), etc.
+ */
+exports.bargsAsync = Object.assign(bargs_js_1.bargsAsync, opt_js_1.opt);
+// Re-export errors
+var errors_js_1 = require("./errors.cjs");
+Object.defineProperty(exports, "BargsError", { enumerable: true, get: function () { return errors_js_1.BargsError; } });
+Object.defineProperty(exports, "HelpError", { enumerable: true, get: function () { return errors_js_1.HelpError; } });
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_js_1.ValidationError; } });
+// Re-export help generators
+var help_js_1 = require("./help.cjs");
+Object.defineProperty(exports, "generateCommandHelp", { enumerable: true, get: function () { return help_js_1.generateCommandHelp; } });
+Object.defineProperty(exports, "generateHelp", { enumerable: true, get: function () { return help_js_1.generateHelp; } });
+// Re-export OSC utilities for terminal hyperlinks
+var osc_js_1 = require("./osc.cjs");
+Object.defineProperty(exports, "link", { enumerable: true, get: function () { return osc_js_1.link; } });
+Object.defineProperty(exports, "linkifyUrls", { enumerable: true, get: function () { return osc_js_1.linkifyUrls; } });
+Object.defineProperty(exports, "supportsHyperlinks", { enumerable: true, get: function () { return osc_js_1.supportsHyperlinks; } });
+// Re-export theme utilities
+var theme_js_1 = require("./theme.cjs");
+Object.defineProperty(exports, "ansi", { enumerable: true, get: function () { return theme_js_1.ansi; } });
+Object.defineProperty(exports, "createStyler", { enumerable: true, get: function () { return theme_js_1.createStyler; } });
+Object.defineProperty(exports, "defaultTheme", { enumerable: true, get: function () { return theme_js_1.defaultTheme; } });
+Object.defineProperty(exports, "stripAnsi", { enumerable: true, get: function () { return theme_js_1.stripAnsi; } });
+Object.defineProperty(exports, "themes", { enumerable: true, get: function () { return theme_js_1.themes; } });
+//# sourceMappingURL=index.js.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;;;AAEH,0CAA8E;AAC9E,sCAA+B;AAE/B;;;GAGG;AACU,QAAA,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAS,EAAE,YAAG,CAAC,CAAC;AAEnD;;;GAGG;AACU,QAAA,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,qBAAc,EAAE,YAAG,CAAC,CAAC;AAE7D,mBAAmB;AACnB,0CAAqE;AAA5D,uGAAA,UAAU,OAAA;AAAE,sGAAA,SAAS,OAAA;AAAE,4GAAA,eAAe,OAAA;AAE/C,4BAA4B;AAC5B,sCAA8D;AAArD,8GAAA,mBAAmB,OAAA;AAAE,uGAAA,YAAY,OAAA;AAE1C,kDAAkD;AAClD,oCAAiE;AAAxD,8FAAA,IAAI,OAAA;AAAE,qGAAA,WAAW,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AAE9C,4BAA4B;AAC5B,wCAMoB;AALlB,gGAAA,IAAI,OAAA;AACJ,wGAAA,YAAY,OAAA;AACZ,wGAAA,YAAY,OAAA;AACZ,qGAAA,SAAS,OAAA;AACT,kGAAA,MAAM,OAAA"}

package/dist/index.d.cts

@@ -0,0 +1,96 @@
+/**
+ * Main entry point for the bargs CLI argument parser.
+ *
+ * This module exports the primary `bargs` and `bargsAsync` functions with
+ * attached option builder methods (e.g., `bargs.string()`, `bargs.boolean()`),
+ * allowing both function-call and builder-namespace usage patterns. It also
+ * re-exports all public types, error classes, help generators, theme utilities,
+ * and OSC hyperlink functions.
+ *
+ * @example
+ *
+ * ```typescript
+ * import { bargs } from 'bargs';
+ *
+ * // Use as function
+ * const result = bargs({
+ *   name: 'myapp',
+ *   options: { verbose: bargs.boolean({ aliases: ['v'] }) },
+ * });
+ *
+ * // Access builder namespace
+ * const opts = bargs.options({ name: bargs.string() });
+ * ```
+ *
+ * @packageDocumentation
+ */
+import { bargsAsync as bargsAsyncBase, bargs as bargsBase } from "./bargs.cjs";
+/**
+ * Main bargs entry point (sync). Also provides access to all opt builders via
+ * bargs.string(), bargs.boolean(), etc.
+ */
+export declare const bargs: typeof bargsBase & {
+    array: (items: "number" | "string", props?: Omit<import("./types.js").ArrayOption, "items" | "type">) => import("./types.js").ArrayOption;
+    boolean: <P extends Omit<import("./types.js").BooleanOption, "type"> = Omit<import("./types.js").BooleanOption, "type">>(props?: P) => import("./types.js").BooleanOption & P;
+    command: <TOptions extends import("./types.js").OptionsSchema = import("./types.js").OptionsSchema, TPositionals extends import("./types.js").PositionalsSchema = import("./types.js").PositionalsSchema>(config: import("./types.js").CommandConfig<TOptions, TPositionals>) => import("./types.js").CommandConfig<TOptions, TPositionals>;
+    count: (props?: Omit<import("./types.js").CountOption, "type">) => import("./types.js").CountOption;
+    enum: <const T extends readonly string[], P extends Omit<import("./types.js").EnumOption<T[number]>, "choices" | "type"> = Omit<import("./types.js").EnumOption<T[number]>, "type" | "choices">>(choices: T, props?: P) => import("./types.js").EnumOption<T[number]> & P;
+    enumPos: <const T extends readonly string[], P extends Omit<import("./types.js").EnumPositional<T[number]>, "choices" | "type"> = Omit<import("./types.js").EnumPositional<T[number]>, "type" | "choices">>(choices: T, props?: P) => import("./types.js").EnumPositional<T[number]> & P;
+    number: <P extends Omit<import("./types.js").NumberOption, "type"> = Omit<import("./types.js").NumberOption, "type">>(props?: P) => import("./types.js").NumberOption & P;
+    numberPos: (props?: Omit<import("./types.js").NumberPositional, "type">) => import("./types.js").NumberPositional;
+    options: {
+        <A extends import("./types.js").OptionsSchema>(a: A): A;
+        <A extends import("./types.js").OptionsSchema, B extends import("./types.js").OptionsSchema>(a: A, b: B): A & B;
+        <A extends import("./types.js").OptionsSchema, B extends import("./types.js").OptionsSchema, C extends import("./types.js").OptionsSchema>(a: A, b: B, c: C): A & B & C;
+        <A extends import("./types.js").OptionsSchema, B extends import("./types.js").OptionsSchema, C extends import("./types.js").OptionsSchema, D extends import("./types.js").OptionsSchema>(a: A, b: B, c: C, d: D): A & B & C & D;
+        (...schemas: import("./types.js").OptionsSchema[]): import("./types.js").OptionsSchema;
+    };
+    positionals: {
+        <A extends import("./types.js").PositionalDef>(a: A): [A];
+        <A extends import("./types.js").PositionalDef, B extends import("./types.js").PositionalDef>(a: A, b: B): [A, B];
+        <A extends import("./types.js").PositionalDef, B extends import("./types.js").PositionalDef, C extends import("./types.js").PositionalDef>(a: A, b: B, c: C): [A, B, C];
+        <A extends import("./types.js").PositionalDef, B extends import("./types.js").PositionalDef, C extends import("./types.js").PositionalDef, D extends import("./types.js").PositionalDef>(a: A, b: B, c: C, d: D): [A, B, C, D];
+        (...positionals: import("./types.js").PositionalDef[]): import("./types.js").PositionalsSchema;
+    };
+    string: <P extends Omit<import("./types.js").StringOption, "type"> = Omit<import("./types.js").StringOption, "type">>(props?: P) => P & import("./types.js").StringOption;
+    stringPos: (props?: Omit<import("./types.js").StringPositional, "type">) => import("./types.js").StringPositional;
+    variadic: (items: "number" | "string", props?: Omit<import("./types.js").VariadicPositional, "items" | "type">) => import("./types.js").VariadicPositional;
+};
+/**
+ * Async bargs entry point. Also provides access to all opt builders via
+ * bargsAsync.string(), etc.
+ */
+export declare const bargsAsync: typeof bargsAsyncBase & {
+    array: (items: "number" | "string", props?: Omit<import("./types.js").ArrayOption, "items" | "type">) => import("./types.js").ArrayOption;
+    boolean: <P extends Omit<import("./types.js").BooleanOption, "type"> = Omit<import("./types.js").BooleanOption, "type">>(props?: P) => import("./types.js").BooleanOption & P;
+    command: <TOptions extends import("./types.js").OptionsSchema = import("./types.js").OptionsSchema, TPositionals extends import("./types.js").PositionalsSchema = import("./types.js").PositionalsSchema>(config: import("./types.js").CommandConfig<TOptions, TPositionals>) => import("./types.js").CommandConfig<TOptions, TPositionals>;
+    count: (props?: Omit<import("./types.js").CountOption, "type">) => import("./types.js").CountOption;
+    enum: <const T extends readonly string[], P extends Omit<import("./types.js").EnumOption<T[number]>, "choices" | "type"> = Omit<import("./types.js").EnumOption<T[number]>, "type" | "choices">>(choices: T, props?: P) => import("./types.js").EnumOption<T[number]> & P;
+    enumPos: <const T extends readonly string[], P extends Omit<import("./types.js").EnumPositional<T[number]>, "choices" | "type"> = Omit<import("./types.js").EnumPositional<T[number]>, "type" | "choices">>(choices: T, props?: P) => import("./types.js").EnumPositional<T[number]> & P;
+    number: <P extends Omit<import("./types.js").NumberOption, "type"> = Omit<import("./types.js").NumberOption, "type">>(props?: P) => import("./types.js").NumberOption & P;
+    numberPos: (props?: Omit<import("./types.js").NumberPositional, "type">) => import("./types.js").NumberPositional;
+    options: {
+        <A extends import("./types.js").OptionsSchema>(a: A): A;
+        <A extends import("./types.js").OptionsSchema, B extends import("./types.js").OptionsSchema>(a: A, b: B): A & B;
+        <A extends import("./types.js").OptionsSchema, B extends import("./types.js").OptionsSchema, C extends import("./types.js").OptionsSchema>(a: A, b: B, c: C): A & B & C;
+        <A extends import("./types.js").OptionsSchema, B extends import("./types.js").OptionsSchema, C extends import("./types.js").OptionsSchema, D extends import("./types.js").OptionsSchema>(a: A, b: B, c: C, d: D): A & B & C & D;
+        (...schemas: import("./types.js").OptionsSchema[]): import("./types.js").OptionsSchema;
+    };
+    positionals: {
+        <A extends import("./types.js").PositionalDef>(a: A): [A];
+        <A extends import("./types.js").PositionalDef, B extends import("./types.js").PositionalDef>(a: A, b: B): [A, B];
+        <A extends import("./types.js").PositionalDef, B extends import("./types.js").PositionalDef, C extends import("./types.js").PositionalDef>(a: A, b: B, c: C): [A, B, C];
+        <A extends import("./types.js").PositionalDef, B extends import("./types.js").PositionalDef, C extends import("./types.js").PositionalDef, D extends import("./types.js").PositionalDef>(a: A, b: B, c: C, d: D): [A, B, C, D];
+        (...positionals: import("./types.js").PositionalDef[]): import("./types.js").PositionalsSchema;
+    };
+    string: <P extends Omit<import("./types.js").StringOption, "type"> = Omit<import("./types.js").StringOption, "type">>(props?: P) => P & import("./types.js").StringOption;
+    stringPos: (props?: Omit<import("./types.js").StringPositional, "type">) => import("./types.js").StringPositional;
+    variadic: (items: "number" | "string", props?: Omit<import("./types.js").VariadicPositional, "items" | "type">) => import("./types.js").VariadicPositional;
+};
+export { BargsError, HelpError, ValidationError } from "./errors.cjs";
+export { generateCommandHelp, generateHelp } from "./help.cjs";
+export { link, linkifyUrls, supportsHyperlinks } from "./osc.cjs";
+export { ansi, createStyler, defaultTheme, stripAnsi, themes, } from "./theme.cjs";
+export type { StyleFn, Styler, Theme, ThemeColors, ThemeInput, } from "./theme.cjs";
+export type { AnyCommandConfig, ArrayOption, BargsConfig, BargsConfigWithCommands, BargsOptions, BargsResult, BooleanOption, CommandConfig, CommandConfigInput, CountOption, EnumOption, Handler, HandlerFn, InferOption, InferOptions, InferPositional, InferPositionals, NumberOption, NumberPositional, OptionDef, OptionsSchema, PositionalDef, PositionalsSchema, StringOption, StringPositional, VariadicPositional, } from "./types.cjs";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,KAAK,IAAI,SAAS,EAAE,oBAAmB;AAG9E;;;GAGG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;SAgE8rI,GAAG;;;;;;;SAAo1B,GAAG;;;;;CAhEx/J,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;SA0DyrI,GAAG;;;;;;;SAAo1B,GAAG;;;;;CA1D9+J,CAAC;AAG7D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,qBAAoB;AAGrE,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,mBAAkB;AAG9D,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,kBAAkB,EAAE,kBAAiB;AAGjE,OAAO,EACL,IAAI,EACJ,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,MAAM,GACP,oBAAmB;AAGpB,YAAY,EACV,OAAO,EACP,MAAM,EACN,KAAK,EACL,WAAW,EACX,UAAU,GACX,oBAAmB;AAGpB,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,uBAAuB,EACvB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,OAAO,EACP,SAAS,EACT,WAAW,EACX,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,GACnB,oBAAmB"}

package/dist/index.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Main entry point for the bargs CLI argument parser.
+ *
+ * This module exports the primary `bargs` and `bargsAsync` functions with
+ * attached option builder methods (e.g., `bargs.string()`, `bargs.boolean()`),
+ * allowing both function-call and builder-namespace usage patterns. It also
+ * re-exports all public types, error classes, help generators, theme utilities,
+ * and OSC hyperlink functions.
+ *
+ * @example
+ *
+ * ```typescript
+ * import { bargs } from 'bargs';
+ *
+ * // Use as function
+ * const result = bargs({
+ *   name: 'myapp',
+ *   options: { verbose: bargs.boolean({ aliases: ['v'] }) },
+ * });
+ *
+ * // Access builder namespace
+ * const opts = bargs.options({ name: bargs.string() });
+ * ```
+ *
+ * @packageDocumentation
+ */
+import { bargsAsync as bargsAsyncBase, bargs as bargsBase } from "./bargs.js";
+/**
+ * Main bargs entry point (sync). Also provides access to all opt builders via
+ * bargs.string(), bargs.boolean(), etc.
+ */
+export declare const bargs: typeof bargsBase & {
+    array: (items: "number" | "string", props?: Omit<import("./types.js").ArrayOption, "items" | "type">) => import("./types.js").ArrayOption;
+    boolean: <P extends Omit<import("./types.js").BooleanOption, "type"> = Omit<import("./types.js").BooleanOption, "type">>(props?: P) => import("./types.js").BooleanOption & P;
+    command: <TOptions extends import("./types.js").OptionsSchema = import("./types.js").OptionsSchema, TPositionals extends import("./types.js").PositionalsSchema = import("./types.js").PositionalsSchema>(config: import("./types.js").CommandConfig<TOptions, TPositionals>) => import("./types.js").CommandConfig<TOptions, TPositionals>;
+    count: (props?: Omit<import("./types.js").CountOption, "type">) => import("./types.js").CountOption;
+    enum: <const T extends readonly string[], P extends Omit<import("./types.js").EnumOption<T[number]>, "choices" | "type"> = Omit<import("./types.js").EnumOption<T[number]>, "type" | "choices">>(choices: T, props?: P) => import("./types.js").EnumOption<T[number]> & P;
+    enumPos: <const T extends readonly string[], P extends Omit<import("./types.js").EnumPositional<T[number]>, "choices" | "type"> = Omit<import("./types.js").EnumPositional<T[number]>, "type" | "choices">>(choices: T, props?: P) => import("./types.js").EnumPositional<T[number]> & P;
+    number: <P extends Omit<import("./types.js").NumberOption, "type"> = Omit<import("./types.js").NumberOption, "type">>(props?: P) => import("./types.js").NumberOption & P;
+    numberPos: (props?: Omit<import("./types.js").NumberPositional, "type">) => import("./types.js").NumberPositional;
+    options: {
+        <A extends import("./types.js").OptionsSchema>(a: A): A;
+        <A extends import("./types.js").OptionsSchema, B extends import("./types.js").OptionsSchema>(a: A, b: B): A & B;
+        <A extends import("./types.js").OptionsSchema, B extends import("./types.js").OptionsSchema, C extends import("./types.js").OptionsSchema>(a: A, b: B, c: C): A & B & C;
+        <A extends import("./types.js").OptionsSchema, B extends import("./types.js").OptionsSchema, C extends import("./types.js").OptionsSchema, D extends import("./types.js").OptionsSchema>(a: A, b: B, c: C, d: D): A & B & C & D;
+        (...schemas: import("./types.js").OptionsSchema[]): import("./types.js").OptionsSchema;
+    };
+    positionals: {
+        <A extends import("./types.js").PositionalDef>(a: A): [A];
+        <A extends import("./types.js").PositionalDef, B extends import("./types.js").PositionalDef>(a: A, b: B): [A, B];
+        <A extends import("./types.js").PositionalDef, B extends import("./types.js").PositionalDef, C extends import("./types.js").PositionalDef>(a: A, b: B, c: C): [A, B, C];
+        <A extends import("./types.js").PositionalDef, B extends import("./types.js").PositionalDef, C extends import("./types.js").PositionalDef, D extends import("./types.js").PositionalDef>(a: A, b: B, c: C, d: D): [A, B, C, D];
+        (...positionals: import("./types.js").PositionalDef[]): import("./types.js").PositionalsSchema;
+    };
+    string: <P extends Omit<import("./types.js").StringOption, "type"> = Omit<import("./types.js").StringOption, "type">>(props?: P) => P & import("./types.js").StringOption;
+    stringPos: (props?: Omit<import("./types.js").StringPositional, "type">) => import("./types.js").StringPositional;
+    variadic: (items: "number" | "string", props?: Omit<import("./types.js").VariadicPositional, "items" | "type">) => import("./types.js").VariadicPositional;
+};
+/**
+ * Async bargs entry point. Also provides access to all opt builders via
+ * bargsAsync.string(), etc.
+ */
+export declare const bargsAsync: typeof bargsAsyncBase & {
+    array: (items: "number" | "string", props?: Omit<import("./types.js").ArrayOption, "items" | "type">) => import("./types.js").ArrayOption;
+    boolean: <P extends Omit<import("./types.js").BooleanOption, "type"> = Omit<import("./types.js").BooleanOption, "type">>(props?: P) => import("./types.js").BooleanOption & P;
+    command: <TOptions extends import("./types.js").OptionsSchema = import("./types.js").OptionsSchema, TPositionals extends import("./types.js").PositionalsSchema = import("./types.js").PositionalsSchema>(config: import("./types.js").CommandConfig<TOptions, TPositionals>) => import("./types.js").CommandConfig<TOptions, TPositionals>;
+    count: (props?: Omit<import("./types.js").CountOption, "type">) => import("./types.js").CountOption;
+    enum: <const T extends readonly string[], P extends Omit<import("./types.js").EnumOption<T[number]>, "choices" | "type"> = Omit<import("./types.js").EnumOption<T[number]>, "type" | "choices">>(choices: T, props?: P) => import("./types.js").EnumOption<T[number]> & P;
+    enumPos: <const T extends readonly string[], P extends Omit<import("./types.js").EnumPositional<T[number]>, "choices" | "type"> = Omit<import("./types.js").EnumPositional<T[number]>, "type" | "choices">>(choices: T, props?: P) => import("./types.js").EnumPositional<T[number]> & P;
+    number: <P extends Omit<import("./types.js").NumberOption, "type"> = Omit<import("./types.js").NumberOption, "type">>(props?: P) => import("./types.js").NumberOption & P;
+    numberPos: (props?: Omit<import("./types.js").NumberPositional, "type">) => import("./types.js").NumberPositional;
+    options: {
+        <A extends import("./types.js").OptionsSchema>(a: A): A;
+        <A extends import("./types.js").OptionsSchema, B extends import("./types.js").OptionsSchema>(a: A, b: B): A & B;
+        <A extends import("./types.js").OptionsSchema, B extends import("./types.js").OptionsSchema, C extends import("./types.js").OptionsSchema>(a: A, b: B, c: C): A & B & C;
+        <A extends import("./types.js").OptionsSchema, B extends import("./types.js").OptionsSchema, C extends import("./types.js").OptionsSchema, D extends import("./types.js").OptionsSchema>(a: A, b: B, c: C, d: D): A & B & C & D;
+        (...schemas: import("./types.js").OptionsSchema[]): import("./types.js").OptionsSchema;
+    };
+    positionals: {
+        <A extends import("./types.js").PositionalDef>(a: A): [A];
+        <A extends import("./types.js").PositionalDef, B extends import("./types.js").PositionalDef>(a: A, b: B): [A, B];
+        <A extends import("./types.js").PositionalDef, B extends import("./types.js").PositionalDef, C extends import("./types.js").PositionalDef>(a: A, b: B, c: C): [A, B, C];
+        <A extends import("./types.js").PositionalDef, B extends import("./types.js").PositionalDef, C extends import("./types.js").PositionalDef, D extends import("./types.js").PositionalDef>(a: A, b: B, c: C, d: D): [A, B, C, D];
+        (...positionals: import("./types.js").PositionalDef[]): import("./types.js").PositionalsSchema;
+    };
+    string: <P extends Omit<import("./types.js").StringOption, "type"> = Omit<import("./types.js").StringOption, "type">>(props?: P) => P & import("./types.js").StringOption;
+    stringPos: (props?: Omit<import("./types.js").StringPositional, "type">) => import("./types.js").StringPositional;
+    variadic: (items: "number" | "string", props?: Omit<import("./types.js").VariadicPositional, "items" | "type">) => import("./types.js").VariadicPositional;
+};
+export { BargsError, HelpError, ValidationError } from "./errors.js";
+export { generateCommandHelp, generateHelp } from "./help.js";
+export { link, linkifyUrls, supportsHyperlinks } from "./osc.js";
+export { ansi, createStyler, defaultTheme, stripAnsi, themes, } from "./theme.js";
+export type { StyleFn, Styler, Theme, ThemeColors, ThemeInput, } from "./theme.js";
+export type { AnyCommandConfig, ArrayOption, BargsConfig, BargsConfigWithCommands, BargsOptions, BargsResult, BooleanOption, CommandConfig, CommandConfigInput, CountOption, EnumOption, Handler, HandlerFn, InferOption, InferOptions, InferPositional, InferPositionals, NumberOption, NumberPositional, OptionDef, OptionsSchema, PositionalDef, PositionalsSchema, StringOption, StringPositional, VariadicPositional, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,KAAK,IAAI,SAAS,EAAE,mBAAmB;AAG9E;;;GAGG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;SAgE8rI,GAAG;;;;;;;SAAo1B,GAAG;;;;;CAhEx/J,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;SA0DyrI,GAAG;;;;;;;SAAo1B,GAAG;;;;;CA1D9+J,CAAC;AAG7D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,oBAAoB;AAGrE,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,kBAAkB;AAG9D,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,kBAAkB,EAAE,iBAAiB;AAGjE,OAAO,EACL,IAAI,EACJ,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,MAAM,GACP,mBAAmB;AAGpB,YAAY,EACV,OAAO,EACP,MAAM,EACN,KAAK,EACL,WAAW,EACX,UAAU,GACX,mBAAmB;AAGpB,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,uBAAuB,EACvB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,OAAO,EACP,SAAS,EACT,WAAW,EACX,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,GACnB,mBAAmB"}