burgee 0.2.0 → 0.4.0

package/dist/{yargs-usage.js → yargs/usage.js}

@@ -1,4 +1,9 @@
-import { objFilter, setBlocking, YError } from './yargs-utils.js';
+/**
+ * yargs' usage — the help screen, `fail`, examples, epilogues, descriptions and the
+ * version string — ported for `burgee/yargs`. Help is rendered through the cliui port,
+ * so yargs' usage tests compare whole screens byte for byte.
+ */
+import { objFilter, setBlocking, YError } from './utils.js';
 function isBoolean(fail) {
     return typeof fail === 'boolean';
 }
@@ -55,6 +60,8 @@ export function usage(yargs, shim) {
                 }
             }
             err = err || new YError(msg);
+            // The error rides along so an injected exit (burgee's seam) can tell a usage failure
+            // from a handler's; without a seam yargs exits the process and it is unobservable.
             if (yargs.getExitProcess())
                 return yargs.exit(1, err);
             else if (yargs.getInternalMethods().hasParseCallback())
@@ -477,3 +484,4 @@ function getIndentation(text) {
 function getText(text) {
     return isIndentedText(text) ? text.text : text;
 }
+//# sourceMappingURL=usage.js.map

package/dist/{yargs-utils.js → yargs/utils.js}

@@ -1,3 +1,9 @@
+/**
+ * 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.
+ */
 import { readFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import { dirname, resolve } from 'node:path';
@@ -158,6 +164,10 @@ export function getProcessArgvBin() {
 }
 const nodeRequire = createRequire(import.meta.url);
 let previouslyVisitedConfigs = [];
+/**
+ * `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 function applyExtends(config, cwd, mergeExtends) {
     let defaultConfig = {};
     if (Object.prototype.hasOwnProperty.call(config, 'extends')) {
@@ -207,3 +217,4 @@ function mergeDeep(config1, config2) {
 export function objectKeys(object) {
     return Object.keys(object);
 }
+//# sourceMappingURL=utils.js.map

package/dist/{yargs-validation.d.ts → yargs/validation.d.ts}

@@ -3,7 +3,7 @@
  * 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';
+import type { PlatformShim } from './shim.js';
 export interface ValidationInstance {
     nonOptionCount: (argv: any) => void;
     positionalCount: (required: number, observed: number) => void;

package/dist/{yargs-validation.js → yargs/validation.js}

@@ -1,4 +1,9 @@
-import { argsert, levenshtein as distance, objFilter } from './yargs-utils.js';
+/**
+ * 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 { argsert, levenshtein as distance, objFilter } from './utils.js';
 const specialKeys = ['$0', '--', '_'];
 export function validation(yargs, usage, shim) {
     const __ = shim.y18n.__;
@@ -259,3 +264,4 @@ export function validation(yargs, usage, shim) {
     };
     return self;
 }
+//# sourceMappingURL=validation.js.map

package/dist/{yargs-y18n.js → yargs/y18n.js}

@@ -1,3 +1,8 @@
+/**
+ * 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`).
+ */
 import { readFileSync, statSync } from 'node:fs';
 import { resolve } from 'node:path';
 import { format } from 'node:util';
@@ -115,3 +120,4 @@ export function y18n(opts) {
         locale: table.locale,
     };
 }
+//# sourceMappingURL=y18n.js.map

package/dist/yargs-helpers.d.ts

@@ -2,5 +2,5 @@
  * `burgee/yargs/helpers` — what `yargs/helpers` exports: `hideBin`, `applyExtends`
  * and the parser.
  */
-export { applyExtends, hideBin } from './yargs-utils.js';
+export { applyExtends, hideBin } from './yargs/utils.js';
 export { Parser } from './yargs-parser.js';

package/dist/yargs-helpers.js

@@ -1,2 +1,2 @@
-export { applyExtends, hideBin } from './yargs-utils.js';
+export { applyExtends, hideBin } from './yargs/utils.js';
 export { Parser } from './yargs-parser.js';

package/dist/yargs.d.ts

@@ -1,6 +1,6 @@
-export { YargsInstance, isYargsInstance, type Options, type ParseCallback } from './yargs-factory.js';
+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 { 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

@@ -1,8 +1,8 @@
-import { YargsFactory } from './yargs-factory.js';
-import { shim } from './yargs-shim.js';
-export { YargsInstance, isYargsInstance } from './yargs-factory.js';
+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';
+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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "burgee",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "An agent-native CLI framework, drop-in compatible with commander and yargs. One declaration; help, --json, --schema, --mcp and completions all projected from it.",
   "license": "MIT",
   "type": "module",
@@ -69,6 +69,7 @@
     "build": "tsc -p tsconfig.build.json && node ../../scripts/strip-comments.mjs dist",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run --passWithNoTests",
+    "coverage": "vitest run --coverage.enabled",
     "lint": "eslint src"
   },
   "repository": {
@@ -95,7 +96,7 @@
     "provenance": true
   },
   "devDependencies": {
-    "vitest": "^4.0.0"
+    "vitest": "^5.0.0"
   },
   "bin": {
     "burgee": "./dist/cli.js"