burgee 0.0.0 → 0.2.0

package/dist/yargs-utils.d.ts

@@ -0,0 +1,33 @@
+/**
+ * yargs' small internal modules — yerror, parse-command, argsert, obj-filter, is-promise,
+ * levenshtein, maybe-async-result, set-blocking, apply-extends, process-argv — ported
+ * for `burgee/yargs`. Its suite imports four of these by their upstream file paths; the
+ * oracle shims those paths to this entry, so the names here are the upstream names.
+ */
+export declare class YError extends Error {
+    constructor(msg?: string | null);
+}
+export interface Positional {
+    cmd: string[];
+    variadic: boolean;
+}
+export interface ParsedCommand {
+    cmd: string;
+    demanded: Positional[];
+    optional: Positional[];
+}
+export declare function parseCommand(cmd: string): ParsedCommand;
+export declare function argsert(arg1: string | any[], arg2?: any, arg3?: number): void;
+export declare function objFilter<T extends object>(original?: T, filter?: (k: string, v: any) => boolean): T;
+export declare function isPromise(maybePromise: any): maybePromise is Promise<any>;
+export declare function levenshtein(a: string, b: string): number;
+export declare function maybeAsyncResult<T>(getResult: (() => T | Promise<T>) | T | Promise<T>, resultHandler: (result: T) => any, errorHandler?: (err: Error) => any): any;
+export declare function setBlocking(blocking: boolean): void;
+export declare function hideBin(argv: string[]): string[];
+export declare function getProcessArgvBin(): string;
+/**
+ * `extends` in a config object. The upstream resolves a bare specifier with
+ * `import.meta.resolve` and then loads it through `require`; both are done from here.
+ */
+export declare function applyExtends(config: Record<string, any>, cwd: string, mergeExtends?: boolean): Record<string, any>;
+export declare function objectKeys<T extends object>(object: T): (keyof T)[];

package/dist/yargs-utils.js

@@ -0,0 +1,209 @@
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, resolve } from 'node:path';
+export class YError extends Error {
+    constructor(msg) {
+        super(msg || 'yargs error');
+        this.name = 'YError';
+        if (Error.captureStackTrace)
+            Error.captureStackTrace(this, YError);
+    }
+}
+export function parseCommand(cmd) {
+    const extraSpacesStrippedCommand = cmd.replace(/\s{2,}/g, ' ');
+    const splitCommand = extraSpacesStrippedCommand.split(/\s+(?![^[]*]|[^<]*>)/);
+    const bregex = /\.*[\][<>]/g;
+    const firstCommand = splitCommand.shift();
+    if (!firstCommand)
+        throw new Error(`No command found in: ${cmd}`);
+    const parsedCommand = { cmd: firstCommand.replace(bregex, ''), demanded: [], optional: [] };
+    splitCommand.forEach((c, i) => {
+        let variadic = false;
+        c = c.replace(/\s/g, '');
+        if (/\.+[\]>]/.test(c) && i === splitCommand.length - 1)
+            variadic = true;
+        if (/^\[/.test(c))
+            parsedCommand.optional.push({ cmd: c.replace(bregex, '').split('|'), variadic });
+        else
+            parsedCommand.demanded.push({ cmd: c.replace(bregex, '').split('|'), variadic });
+    });
+    return parsedCommand;
+}
+const positionName = ['first', 'second', 'third', 'fourth', 'fifth', 'sixth'];
+export function argsert(arg1, arg2, arg3) {
+    function parseArgs() {
+        return typeof arg1 === 'object' ? [{ cmd: '', demanded: [], optional: [] }, arg1, arg2] : [parseCommand(`cmd ${arg1}`), arg2, arg3];
+    }
+    try {
+        let position = 0;
+        const [parsed, callerArguments, _length] = parseArgs();
+        const args = [].slice.call(callerArguments);
+        while (args.length && args.at(-1) === undefined)
+            args.pop();
+        const length = _length || args.length;
+        if (length < parsed.demanded.length) {
+            throw new YError(`Not enough arguments provided. Expected ${parsed.demanded.length} but received ${args.length}.`);
+        }
+        const totalCommands = parsed.demanded.length + parsed.optional.length;
+        if (length > totalCommands) {
+            throw new YError(`Too many arguments provided. Expected max ${totalCommands} but received ${length}.`);
+        }
+        parsed.demanded.forEach((demanded) => {
+            const arg = args.shift();
+            const observedType = guessType(arg);
+            const matchingTypes = demanded.cmd.filter((type) => type === observedType || type === '*');
+            if (matchingTypes.length === 0)
+                argumentTypeError(observedType, demanded.cmd, position);
+            position += 1;
+        });
+        parsed.optional.forEach((optional) => {
+            if (args.length === 0)
+                return;
+            const arg = args.shift();
+            const observedType = guessType(arg);
+            const matchingTypes = optional.cmd.filter((type) => type === observedType || type === '*');
+            if (matchingTypes.length === 0)
+                argumentTypeError(observedType, optional.cmd, position);
+            position += 1;
+        });
+    }
+    catch (err) {
+        console.warn(err.stack);
+    }
+}
+function guessType(arg) {
+    if (Array.isArray(arg))
+        return 'array';
+    if (arg === null)
+        return 'null';
+    return typeof arg;
+}
+function argumentTypeError(observedType, allowedTypes, position) {
+    throw new YError(`Invalid ${positionName[position] || 'manyith'} argument. Expected ${allowedTypes.join(' or ')} but received ${observedType}.`);
+}
+export function objFilter(original = {}, filter = () => true) {
+    const obj = {};
+    Object.keys(original).forEach((key) => {
+        if (filter(key, original[key]))
+            obj[key] = original[key];
+    });
+    return obj;
+}
+export function isPromise(maybePromise) {
+    return !!maybePromise && !!maybePromise.then && typeof maybePromise.then === 'function';
+}
+export function levenshtein(a, b) {
+    if (a.length === 0)
+        return b.length;
+    if (b.length === 0)
+        return a.length;
+    const matrix = [];
+    let i;
+    for (i = 0; i <= b.length; i++)
+        matrix[i] = [i];
+    let j;
+    for (j = 0; j <= a.length; j++)
+        matrix[0][j] = j;
+    for (i = 1; i <= b.length; i++) {
+        for (j = 1; j <= a.length; j++) {
+            const row = matrix[i];
+            const prev = matrix[i - 1];
+            if (b.charAt(i - 1) === a.charAt(j - 1))
+                row[j] = prev[j - 1];
+            else if (i > 1 && j > 1 && b.charAt(i - 2) === a.charAt(j - 1) && b.charAt(i - 1) === a.charAt(j - 2)) {
+                row[j] = matrix[i - 2][j - 2] + 1;
+            }
+            else
+                row[j] = Math.min(prev[j - 1] + 1, Math.min(row[j - 1] + 1, prev[j] + 1));
+        }
+    }
+    return matrix[b.length][a.length];
+}
+export function maybeAsyncResult(getResult, resultHandler, errorHandler = (err) => {
+    throw err;
+}) {
+    try {
+        const result = typeof getResult === 'function' ? getResult() : getResult;
+        return isPromise(result) ? result.then((r) => resultHandler(r)) : resultHandler(result);
+    }
+    catch (err) {
+        return errorHandler(err);
+    }
+}
+export function setBlocking(blocking) {
+    if (typeof process === 'undefined')
+        return;
+    [process.stdout, process.stderr].forEach((_stream) => {
+        const stream = _stream;
+        if (stream._handle && stream.isTTY && typeof stream._handle.setBlocking === 'function')
+            stream._handle.setBlocking(blocking);
+    });
+}
+function getProcessArgvBinIndex() {
+    if (isBundledElectronApp())
+        return 0;
+    return 1;
+}
+function isBundledElectronApp() {
+    return isElectronApp() && !process.defaultApp;
+}
+function isElectronApp() {
+    return !!process.versions.electron;
+}
+export function hideBin(argv) {
+    return argv.slice(getProcessArgvBinIndex() + 1);
+}
+export function getProcessArgvBin() {
+    return process.argv[getProcessArgvBinIndex()];
+}
+const nodeRequire = createRequire(import.meta.url);
+let previouslyVisitedConfigs = [];
+export function applyExtends(config, cwd, mergeExtends) {
+    let defaultConfig = {};
+    if (Object.prototype.hasOwnProperty.call(config, 'extends')) {
+        if (typeof config.extends !== 'string')
+            return defaultConfig;
+        const isPath = /\.json|\..*rc$/.test(config.extends);
+        let pathToDefault;
+        if (!isPath) {
+            try {
+                pathToDefault = import.meta.resolve(config.extends);
+            }
+            catch {
+                return config;
+            }
+        }
+        else
+            pathToDefault = resolve(cwd, config.extends);
+        checkForCircularExtends(pathToDefault);
+        previouslyVisitedConfigs.push(pathToDefault);
+        defaultConfig = isPath ? JSON.parse(readFileSync(pathToDefault, 'utf8')) : nodeRequire(config.extends);
+        delete config.extends;
+        defaultConfig = applyExtends(defaultConfig, dirname(pathToDefault), mergeExtends);
+    }
+    previouslyVisitedConfigs = [];
+    return mergeExtends ? mergeDeep(defaultConfig, config) : Object.assign({}, defaultConfig, config);
+}
+function checkForCircularExtends(cfgPath) {
+    if (previouslyVisitedConfigs.indexOf(cfgPath) > -1)
+        throw new YError(`Circular extended configurations: '${cfgPath}'.`);
+}
+function mergeDeep(config1, config2) {
+    const target = {};
+    function isObject(obj) {
+        return obj && typeof obj === 'object' && !Array.isArray(obj);
+    }
+    Object.assign(target, config1);
+    for (const key of Object.keys(config2)) {
+        if (key === '__proto__')
+            continue;
+        if (isObject(config2[key]) && isObject(target[key]))
+            target[key] = mergeDeep(config1[key], config2[key]);
+        else
+            target[key] = config2[key];
+    }
+    return target;
+}
+export function objectKeys(object) {
+    return Object.keys(object);
+}

package/dist/yargs-validation.d.ts

@@ -0,0 +1,26 @@
+/**
+ * yargs' validation — demanded options and commands, unknown arguments under strict
+ * modes, choices, implications, conflicts, and `recommendCommands` — ported for
+ * `burgee/yargs`. Every message is the upstream's through y18n.
+ */
+import type { PlatformShim } from './yargs-shim.js';
+export interface ValidationInstance {
+    nonOptionCount: (argv: any) => void;
+    positionalCount: (required: number, observed: number) => void;
+    requiredArguments: (argv: any, demandedOptions: Record<string, string | undefined>) => void;
+    unknownArguments: (argv: any, aliases: Record<string, string[]>, positionalMap: any, isDefaultCommand: boolean, checkPositionals?: boolean) => void;
+    unknownCommands: (argv: any) => boolean;
+    isValidAndSomeAliasIsNotNew: (key: string, aliases: Record<string, string[]>) => boolean;
+    limitedChoices: (argv: any) => void;
+    implies: (key: string | Record<string, any>, value?: any) => void;
+    getImplied: () => Record<string, any[]>;
+    implications: (argv: any) => void;
+    conflicts: (key: string | Record<string, any>, value?: any) => void;
+    getConflicting: () => Record<string, any[]>;
+    conflicting: (argv: any) => void;
+    recommendCommands: (cmd: string, potentialCommands: string[]) => void;
+    reset: (localLookup: Record<string, boolean>) => ValidationInstance;
+    freeze: () => void;
+    unfreeze: () => void;
+}
+export declare function validation(yargs: any, usage: any, shim: PlatformShim): ValidationInstance;

package/dist/yargs-validation.js

@@ -0,0 +1,261 @@
+import { argsert, levenshtein as distance, objFilter } from './yargs-utils.js';
+const specialKeys = ['$0', '--', '_'];
+export function validation(yargs, usage, shim) {
+    const __ = shim.y18n.__;
+    const __n = shim.y18n.__n;
+    const self = {};
+    self.nonOptionCount = function nonOptionCount(argv) {
+        const demandedCommands = yargs.getDemandedCommands();
+        const positionalCount = argv._.length + (argv['--'] ? argv['--'].length : 0);
+        const _s = positionalCount - yargs.getInternalMethods().getContext().commands.length;
+        if (demandedCommands._ && (_s < demandedCommands._.min || _s > demandedCommands._.max)) {
+            if (_s < demandedCommands._.min) {
+                if (demandedCommands._.minMsg !== undefined) {
+                    usage.fail(demandedCommands._.minMsg
+                        ? demandedCommands._.minMsg.replace(/\$0/g, _s.toString()).replace(/\$1/, demandedCommands._.min.toString())
+                        : null);
+                }
+                else {
+                    usage.fail(__n('Not enough non-option arguments: got %s, need at least %s', 'Not enough non-option arguments: got %s, need at least %s', _s, _s.toString(), demandedCommands._.min.toString()));
+                }
+            }
+            else if (_s > demandedCommands._.max) {
+                if (demandedCommands._.maxMsg !== undefined) {
+                    usage.fail(demandedCommands._.maxMsg
+                        ? demandedCommands._.maxMsg.replace(/\$0/g, _s.toString()).replace(/\$1/, demandedCommands._.max.toString())
+                        : null);
+                }
+                else {
+                    usage.fail(__n('Too many non-option arguments: got %s, maximum of %s', 'Too many non-option arguments: got %s, maximum of %s', _s, _s.toString(), demandedCommands._.max.toString()));
+                }
+            }
+        }
+    };
+    self.positionalCount = function positionalCount(required, observed) {
+        if (observed < required) {
+            usage.fail(__n('Not enough non-option arguments: got %s, need at least %s', 'Not enough non-option arguments: got %s, need at least %s', observed, `${observed}`, `${required}`));
+        }
+    };
+    self.requiredArguments = function requiredArguments(argv, demandedOptions) {
+        let missing = null;
+        for (const key of Object.keys(demandedOptions)) {
+            if (!Object.prototype.hasOwnProperty.call(argv, key) || typeof argv[key] === 'undefined') {
+                missing = missing || {};
+                missing[key] = demandedOptions[key];
+            }
+        }
+        if (missing) {
+            const customMsgs = [];
+            for (const key of Object.keys(missing)) {
+                const msg = missing[key];
+                if (msg && customMsgs.indexOf(msg) < 0)
+                    customMsgs.push(msg);
+            }
+            const customMsg = customMsgs.length ? `\n${customMsgs.join('\n')}` : '';
+            usage.fail(__n('Missing required argument: %s', 'Missing required arguments: %s', Object.keys(missing).length, Object.keys(missing).join(', ') + customMsg));
+        }
+    };
+    self.unknownArguments = function unknownArguments(argv, aliases, positionalMap, isDefaultCommand, checkPositionals = true) {
+        const commandKeys = yargs.getInternalMethods().getCommandInstance().getCommands();
+        const unknown = [];
+        const currentContext = yargs.getInternalMethods().getContext();
+        Object.keys(argv).forEach((key) => {
+            if (!specialKeys.includes(key) &&
+                !Object.prototype.hasOwnProperty.call(positionalMap, key) &&
+                !Object.prototype.hasOwnProperty.call(yargs.getInternalMethods().getParseContext(), key) &&
+                !self.isValidAndSomeAliasIsNotNew(key, aliases)) {
+                unknown.push(key);
+            }
+        });
+        if (checkPositionals && (currentContext.commands.length > 0 || commandKeys.length > 0 || isDefaultCommand)) {
+            argv._.slice(currentContext.commands.length).forEach((key) => {
+                if (!commandKeys.includes(`${key}`))
+                    unknown.push(`${key}`);
+            });
+        }
+        if (checkPositionals) {
+            const demandedCommands = yargs.getDemandedCommands();
+            const maxNonOptDemanded = demandedCommands._?.max || 0;
+            const expected = currentContext.commands.length + maxNonOptDemanded;
+            if (expected < argv._.length) {
+                argv._.slice(expected).forEach((key) => {
+                    key = String(key);
+                    if (!currentContext.commands.includes(key) && !unknown.includes(key))
+                        unknown.push(key);
+                });
+            }
+        }
+        if (unknown.length) {
+            usage.fail(__n('Unknown argument: %s', 'Unknown arguments: %s', unknown.length, unknown.map((s) => (s.trim() ? s : `"${s}"`)).join(', ')));
+        }
+    };
+    self.unknownCommands = function unknownCommands(argv) {
+        const commandKeys = yargs.getInternalMethods().getCommandInstance().getCommands();
+        const unknown = [];
+        const currentContext = yargs.getInternalMethods().getContext();
+        if (currentContext.commands.length > 0 || commandKeys.length > 0) {
+            argv._.slice(currentContext.commands.length).forEach((key) => {
+                if (!commandKeys.includes(`${key}`))
+                    unknown.push(`${key}`);
+            });
+        }
+        if (unknown.length > 0) {
+            usage.fail(__n('Unknown command: %s', 'Unknown commands: %s', unknown.length, unknown.join(', ')));
+            return true;
+        }
+        return false;
+    };
+    self.isValidAndSomeAliasIsNotNew = function isValidAndSomeAliasIsNotNew(key, aliases) {
+        if (!Object.prototype.hasOwnProperty.call(aliases, key))
+            return false;
+        const newAliases = yargs.parsed.newAliases;
+        return [key, ...aliases[key]].some((a) => !Object.prototype.hasOwnProperty.call(newAliases, a) || !newAliases[key]);
+    };
+    self.limitedChoices = function limitedChoices(argv) {
+        const options = yargs.getOptions();
+        const invalid = {};
+        if (!Object.keys(options.choices).length)
+            return;
+        Object.keys(argv).forEach((key) => {
+            if (specialKeys.indexOf(key) === -1 && Object.prototype.hasOwnProperty.call(options.choices, key)) {
+                [].concat(argv[key]).forEach((value) => {
+                    if (options.choices[key].indexOf(value) === -1 && value !== undefined)
+                        invalid[key] = (invalid[key] || []).concat(value);
+                });
+            }
+        });
+        const invalidKeys = Object.keys(invalid);
+        if (!invalidKeys.length)
+            return;
+        let msg = __('Invalid values:');
+        invalidKeys.forEach((key) => {
+            msg += `\n  ${__('Argument: %s, Given: %s, Choices: %s', key, usage.stringifiedValues(invalid[key]), usage.stringifiedValues(options.choices[key]))}`;
+        });
+        usage.fail(msg);
+    };
+    let implied = {};
+    self.implies = function implies(key, value) {
+        argsert('<string|object> [array|number|string]', [key, value], arguments.length);
+        if (typeof key === 'object') {
+            Object.keys(key).forEach((k) => {
+                self.implies(k, key[k]);
+            });
+        }
+        else {
+            yargs.global(key);
+            if (!implied[key])
+                implied[key] = [];
+            if (Array.isArray(value))
+                value.forEach((i) => self.implies(key, i));
+            else {
+                shim.assert.notStrictEqual(value, undefined);
+                implied[key].push(value);
+            }
+        }
+    };
+    self.getImplied = function getImplied() {
+        return implied;
+    };
+    function keyExists(argv, val) {
+        const num = Number(val);
+        val = isNaN(num) ? val : num;
+        if (typeof val === 'number')
+            val = argv._.length >= val;
+        else if (/^--no-.+/.exec(val)) {
+            val = /^--no-(.+)/.exec(val)[1];
+            val = !Object.prototype.hasOwnProperty.call(argv, val);
+        }
+        else
+            val = Object.prototype.hasOwnProperty.call(argv, val);
+        return val;
+    }
+    self.implications = function implications(argv) {
+        const implyFail = [];
+        Object.keys(implied).forEach((key) => {
+            const origKey = key;
+            (implied[key] || []).forEach((value) => {
+                let k = origKey;
+                const origValue = value;
+                k = keyExists(argv, k);
+                value = keyExists(argv, value);
+                if (k && !value)
+                    implyFail.push(` ${origKey} -> ${origValue}`);
+            });
+        });
+        if (implyFail.length) {
+            let msg = `${__('Implications failed:')}\n`;
+            implyFail.forEach((value) => {
+                msg += value;
+            });
+            usage.fail(msg);
+        }
+    };
+    let conflicting = {};
+    self.conflicts = function conflicts(key, value) {
+        argsert('<string|object> [array|string]', [key, value], arguments.length);
+        if (typeof key === 'object') {
+            Object.keys(key).forEach((k) => {
+                self.conflicts(k, key[k]);
+            });
+        }
+        else {
+            yargs.global(key);
+            if (!conflicting[key])
+                conflicting[key] = [];
+            if (Array.isArray(value))
+                value.forEach((i) => self.conflicts(key, i));
+            else
+                conflicting[key].push(value);
+        }
+    };
+    self.getConflicting = () => conflicting;
+    self.conflicting = function conflictingFn(argv) {
+        Object.keys(argv).forEach((key) => {
+            if (conflicting[key]) {
+                conflicting[key].forEach((value) => {
+                    if (value && argv[key] !== undefined && argv[value] !== undefined)
+                        usage.fail(__('Arguments %s and %s are mutually exclusive', key, value));
+                });
+            }
+        });
+        if (yargs.getInternalMethods().getParserConfiguration()['strip-dashed']) {
+            Object.keys(conflicting).forEach((key) => {
+                conflicting[key].forEach((value) => {
+                    if (value && argv[shim.Parser.camelCase(key)] !== undefined && argv[shim.Parser.camelCase(value)] !== undefined) {
+                        usage.fail(__('Arguments %s and %s are mutually exclusive', key, value));
+                    }
+                });
+            });
+        }
+    };
+    self.recommendCommands = function recommendCommands(cmd, potentialCommands) {
+        const threshold = 3;
+        potentialCommands = potentialCommands.sort((a, b) => b.length - a.length);
+        let recommended = null;
+        let bestDistance = Infinity;
+        for (let i = 0, candidate; (candidate = potentialCommands[i]) !== undefined; i++) {
+            const d = distance(cmd, candidate);
+            if (d <= threshold && d < bestDistance) {
+                bestDistance = d;
+                recommended = candidate;
+            }
+        }
+        if (recommended)
+            usage.fail(__('Did you mean %s?', recommended));
+    };
+    self.reset = function reset(localLookup) {
+        implied = objFilter(implied, (k) => !localLookup[k]);
+        conflicting = objFilter(conflicting, (k) => !localLookup[k]);
+        return self;
+    };
+    const frozens = [];
+    self.freeze = function freeze() {
+        frozens.push({ implied, conflicting });
+    };
+    self.unfreeze = function unfreeze() {
+        const frozen = frozens.pop();
+        shim.assert.notStrictEqual(frozen, undefined);
+        ({ implied, conflicting } = frozen);
+    };
+    return self;
+}

package/dist/yargs-y18n.d.ts

@@ -0,0 +1,21 @@
+/**
+ * y18n 5 — yargs' string table — ported for `burgee/yargs`. The 29 locales ship with
+ * burgee under `locales/`, read on first use of a locale, never written (yargs runs
+ * y18n with `updateFiles: false`).
+ */
+export interface Y18N {
+    __: (...args: any[]) => string;
+    __n: (...args: any[]) => string;
+    setLocale: (locale: string) => void;
+    getLocale: () => string;
+    updateLocale: (obj: Record<string, any>) => void;
+    locale: string;
+}
+interface Y18NOptions {
+    directory?: string;
+    updateFiles?: boolean;
+    locale?: string;
+    fallbackToLanguage?: boolean;
+}
+export declare function y18n(opts: Y18NOptions): Y18N;
+export {};

package/dist/yargs-y18n.js

@@ -0,0 +1,117 @@
+import { readFileSync, statSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { format } from 'node:util';
+function fileExistsSync(file) {
+    try {
+        return statSync(file).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+class Table {
+    directory;
+    locale;
+    fallbackToLanguage;
+    cache = Object.create(null);
+    constructor(opts) {
+        this.directory = opts.directory || './locales';
+        this.locale = opts.locale || 'en';
+        this.fallbackToLanguage = typeof opts.fallbackToLanguage === 'boolean' ? opts.fallbackToLanguage : true;
+    }
+    __(...args) {
+        if (typeof args[0] !== 'string')
+            return this.taggedLiteral(args[0], ...args);
+        const str = args.shift();
+        let cb = function () { };
+        if (typeof args.at(-1) === 'function')
+            cb = args.pop();
+        if (!this.cache[this.locale])
+            this.readLocaleFile();
+        cb();
+        const table = this.cache[this.locale];
+        return format(...[table[str] || str].concat(args));
+    }
+    __n(...args) {
+        const singular = args.shift();
+        const plural = args.shift();
+        const quantity = args.shift();
+        let cb = function () { };
+        if (typeof args.at(-1) === 'function')
+            cb = args.pop();
+        if (!this.cache[this.locale])
+            this.readLocaleFile();
+        const table = this.cache[this.locale];
+        let str = quantity === 1 ? singular : plural;
+        if (table[singular]) {
+            const entry = table[singular];
+            str = entry[quantity === 1 ? 'one' : 'other'];
+        }
+        cb();
+        const values = [str];
+        if (~str.indexOf('%d'))
+            values.push(quantity);
+        return format(...values.concat(args));
+    }
+    setLocale(locale) {
+        this.locale = locale;
+    }
+    getLocale() {
+        return this.locale;
+    }
+    updateLocale(obj) {
+        if (!this.cache[this.locale])
+            this.readLocaleFile();
+        const table = this.cache[this.locale];
+        for (const key in obj) {
+            if (Object.prototype.hasOwnProperty.call(obj, key))
+                table[key] = obj[key];
+        }
+    }
+    taggedLiteral(parts, ...args) {
+        let str = '';
+        parts.forEach((part, i) => {
+            const arg = args[i + 1];
+            str += part;
+            if (typeof arg !== 'undefined')
+                str += '%s';
+        });
+        return this.__(...[str].concat([].slice.call(args, 1)));
+    }
+    readLocaleFile() {
+        let localeLookup = {};
+        const languageFile = this.resolveLocaleFile(this.directory, this.locale);
+        try {
+            localeLookup = JSON.parse(readFileSync(languageFile, 'utf-8'));
+        }
+        catch (err) {
+            if (err instanceof SyntaxError)
+                err.message = `syntax error in ${languageFile}`;
+            if (err.code === 'ENOENT')
+                localeLookup = {};
+            else
+                throw err;
+        }
+        this.cache[this.locale] = localeLookup;
+    }
+    resolveLocaleFile(directory, locale) {
+        let file = resolve(directory, './', `${locale}.json`);
+        if (this.fallbackToLanguage && !fileExistsSync(file) && ~locale.lastIndexOf('_')) {
+            const languageFile = resolve(directory, './', `${locale.split('_')[0]}.json`);
+            if (fileExistsSync(languageFile))
+                file = languageFile;
+        }
+        return file;
+    }
+}
+export function y18n(opts) {
+    const table = new Table(opts);
+    return {
+        __: table.__.bind(table),
+        __n: table.__n.bind(table),
+        setLocale: table.setLocale.bind(table),
+        getLocale: table.getLocale.bind(table),
+        updateLocale: table.updateLocale.bind(table),
+        locale: table.locale,
+    };
+}

package/dist/yargs.d.ts

@@ -0,0 +1,6 @@
+export { YargsInstance, isYargsInstance, type Options, type ParseCallback } from './yargs-factory.js';
+export { Parser, camelCase, decamelize, looksLikeNumber, type DetailedArguments } from './yargs-parser.js';
+export { applyExtends, argsert, hideBin, isPromise, objFilter, parseCommand, YError, type ParsedCommand } from './yargs-utils.js';
+export { shim as platformShim, type PlatformShim } from './yargs-shim.js';
+declare const Yargs: (processArgs?: string | string[], cwd?: string, parentRequire?: NodeJS.Require) => import("./yargs-factory.js").YargsInstance;
+export default Yargs;

package/dist/yargs.js

@@ -0,0 +1,8 @@
+import { YargsFactory } from './yargs-factory.js';
+import { shim } from './yargs-shim.js';
+export { YargsInstance, isYargsInstance } from './yargs-factory.js';
+export { Parser, camelCase, decamelize, looksLikeNumber } from './yargs-parser.js';
+export { applyExtends, argsert, hideBin, isPromise, objFilter, parseCommand, YError } from './yargs-utils.js';
+export { shim as platformShim } from './yargs-shim.js';
+const Yargs = YargsFactory(shim);
+export default Yargs;