burgee 0.13.1 → 0.14.0

package/dist/argv.js

@@ -8,5 +8,5 @@ export function isJsonFlag(arg) {
 export function mayServe(argv) {
     const head = beforeTerminator(argv);
     const first = argv[0];
-    return first === '__complete' || first === 'completion' || first === 'help' || head[0] === '--mcp' || (head[0] === 'config' && head[1] === 'explain') || head.includes('--schema');
+    return first === '__complete' || first === 'completion' || first === 'help' || first === 'schema' || head[0] === '--mcp' || (head[0] === 'config' && head[1] === 'explain') || head.includes('--schema');
 }

package/dist/brand.js

@@ -75,9 +75,9 @@ export function chargeRotation() {
 export function placeCharge(markup, scale = CHARGE.scale) {
     return `<g transform="${chargeTransform(scale)}">${markup}</g>`;
 }
+const bar = (at, fill) => `<rect x="${at.x}" y="${at.y}" width="${BAR.width}" height="${BAR.height}"` +
+    ` rx="${BAR.radius}" fill="${fill}"/>`;
 export function chargeGroup(colors, scale = CHARGE.scale) {
-    const bar = (at, fill) => `<rect x="${at.x}" y="${at.y}" width="${BAR.width}" height="${BAR.height}"` +
-        ` rx="${BAR.radius}" fill="${fill}"/>`;
     return (`<g transform="${chargeTransform(scale)}">` +
         `<g transform="${chargeRotation()}">` +
         `${bar(LEAD_BAR, colors.lead)}${bar(FOLLOW_BAR, colors.follow)}</g></g>`);

package/dist/commander/command.js

@@ -727,7 +727,7 @@ Expecting one of '${HOOK_EVENTS.join("', '")}'`);
             if (arg.required && this.args[i] == null)
                 this.missingArgument(arg.name());
         });
-        const last = this.registeredArguments[this.registeredArguments.length - 1];
+        const last = this.registeredArguments.at(-1);
         if (this.registeredArguments.length > 0 && last?.variadic)
             return;
         if (this.args.length > this.registeredArguments.length)
@@ -1193,7 +1193,7 @@ Expecting one of '${HOOK_EVENTS.join("', '")}'`);
         if (alias === undefined)
             return this._aliases[0];
         let command = this;
-        const last = this.commands[this.commands.length - 1];
+        const last = this.commands.at(-1);
         if (this.commands.length !== 0 && last?._executableHandler) {
             command = last;
         }

package/dist/completions.js

@@ -54,7 +54,7 @@ const promise = (program, root) => walk(root).some((n) => Object.values(n.option
 const fname = (program, path) => `_${[program, ...path].join('_').replaceAll(/[^A-Za-z0-9_]/g, '_')}`;
 function bashCase(program, node) {
     const opts = Object.entries(node.options).flatMap(([n, s]) => flags(n, s));
-    const subs = node.children.map((c) => c.path[c.path.length - 1] ?? '');
+    const subs = node.children.map((c) => c.path.at(-1) ?? '');
     const valued = Object.entries(node.options)
         .filter(([, s]) => takesValue(s))
         .map(([n, s]) => isDynamic(s)
@@ -114,8 +114,8 @@ function zshFunction(program, node) {
     if (node.children.length === 0) {
         return `${fname(program, node.path)}() {\n  _arguments -s ${options.join(' ')} '*: :_files'\n}`;
     }
-    const subs = node.children.map((c) => sq(`${c.path[c.path.length - 1] ?? ''}[${c.description.replaceAll(/[[\]:]/g, ' ')}]`)).join(' ');
-    const dispatch = node.children.map((c) => `      ${c.path[c.path.length - 1] ?? ''}) ${fname(program, c.path)} ;;`).join('\n');
+    const subs = node.children.map((c) => sq(`${c.path.at(-1) ?? ''}[${c.description.replaceAll(/[[\]:]/g, ' ')}]`)).join(' ');
+    const dispatch = node.children.map((c) => `      ${c.path.at(-1) ?? ''}) ${fname(program, c.path)} ;;`).join('\n');
     return `${fname(program, node.path)}() {
   local context state state_descr line
   typeset -A opt_args
@@ -153,7 +153,7 @@ function fish(program, root) {
     for (const node of walk(root)) {
         const cond = sq(fishCondition(node));
         for (const c of node.children)
-            lines.push(`complete -c ${program} -n ${cond} -f -a ${c.path[c.path.length - 1] ?? ''} -d ${sq(c.description)}`);
+            lines.push(`complete -c ${program} -n ${cond} -f -a ${c.path.at(-1) ?? ''} -d ${sq(c.description)}`);
         for (const [name, spec] of Object.entries(node.options)) {
             lines.push(fishOption({ program, cond, node }, kebab(name), spec));
             if (spec.negatable === true) {
@@ -168,7 +168,7 @@ ${lines.join('\n')}
 `;
 }
 function pwshEntry(node) {
-    const subs = node.children.map((c) => `@('${c.path[c.path.length - 1] ?? ''}', 'Command', '${c.description.replaceAll("'", "''")}')`);
+    const subs = node.children.map((c) => `@('${c.path.at(-1) ?? ''}', 'Command', '${c.description.replaceAll("'", "''")}')`);
     const opts = Object.entries(node.options).flatMap(([n, s]) => flags(n, s).map((f) => `@('${f}', 'ParameterName', '${(s.description ?? '').replaceAll("'", "''")}')`));
     const values = Object.entries(node.options)
         .filter(([, s]) => s.choices !== undefined)
@@ -230,7 +230,7 @@ export function renderFigSpec(manifest) {
     const { program, root } = completionTree(manifest);
     const entries = new Map();
     for (const node of walk(root)) {
-        const entry = { name: node.path[node.path.length - 1] ?? program, options: figOptions(node) };
+        const entry = { name: node.path.at(-1) ?? program, options: figOptions(node) };
         if (node.description !== '')
             entry.description = node.description;
         entries.set(node.path.join(' '), entry);

package/dist/help.js

@@ -39,6 +39,7 @@ const GLOBAL = [
     { term: '--json', text: 'machine-readable output', kind: 'flag' },
     { term: '--help', text: 'show this help', kind: 'flag' },
 ];
+const ROOT_GLOBAL = [...GLOBAL, { term: '--schema', text: 'the program as data', kind: 'flag' }];
 function deprecation(d) {
     if (d === undefined || d === false)
         return '';
@@ -96,7 +97,7 @@ function commandSections(manifest, node) {
     for (const c of children) {
         const heading = c.group ?? 'Commands:';
         const rows = groups.get(heading) ?? [];
-        rows.push({ term: c.path[c.path.length - 1] ?? '', text: `${c.summary ?? c.description ?? ''}${deprecation(c.deprecated)}`.trim(), kind: 'command' });
+        rows.push({ term: c.path.at(-1) ?? '', text: `${c.summary ?? c.description ?? ''}${deprecation(c.deprecated)}`.trim(), kind: 'command' });
         groups.set(heading, rows);
     }
     return [...groups].map(([title, rows]) => ({ title, rows }));
@@ -194,13 +195,14 @@ export function renderHelp(manifest, node, opts = {}) {
     const args = argumentRows(node.arguments ?? []);
     const options = optionRows(node.options, verbose);
     const env = environmentRows(node.options);
-    const column = termColumn([...args, ...options, ...GLOBAL, ...commands.flatMap((s) => s.rows), ...env], width);
+    const global = node.path.length === root.length ? ROOT_GLOBAL : GLOBAL;
+    const column = termColumn([...args, ...options, ...global, ...commands.flatMap((s) => s.rows), ...env], width);
     const lines = [usageLine(node, root, commands.length > 0, paint), ''];
     if (node.description !== undefined)
         lines.push(...wrap(`${node.description}${deprecation(node.deprecated)}`, width), '');
     lines.push(...section('Arguments:', layout(args, width, column, paint), paint));
     lines.push(...section('Options:', layout(options, width, column, paint), paint));
-    lines.push(...section('Global options:', layout(GLOBAL, width, column, paint), paint));
+    lines.push(...section('Global options:', layout(global, width, column, paint), paint));
     for (const s of commands)
         lines.push(...section(s.title, layout(s.rows, width, column, paint), paint));
     lines.push(...section('Examples:', exampleLines(node.examples ?? [], width), paint));

package/dist/surfaces.js

@@ -69,6 +69,13 @@ async function helpCommand(manifest, argv, root, io) {
     const { node } = manifest.resolve(argv, root);
     return renderHelp(manifest, node ?? rootNode(manifest, root), io);
 }
+function schemaAlias(manifest, argv) {
+    const top = manifest.find(manifest.rootPath);
+    const takesWords = (top?.run ?? top?.load) !== undefined && (top?.arguments?.length ?? 0) > 0;
+    if (argv[0] !== 'schema' || takesWords || manifest.find([...manifest.rootPath, 'schema']) !== undefined)
+        return undefined;
+    return ['--schema', ...argv.slice(1)];
+}
 export async function serve(manifest, argv, io, engine) {
     const head = beforeTerminator(argv);
     if (argv[0] === '__complete') {
@@ -87,9 +94,11 @@ export async function serve(manifest, argv, io, engine) {
         io.out.write(await helpCommand(manifest, argv.slice(1), manifest.rootPath, io));
         return true;
     }
-    if (head.includes('--schema')) {
+    const asked = schemaAlias(manifest, argv) ?? argv;
+    const askedHead = beforeTerminator(asked);
+    if (askedHead.includes('--schema')) {
         const { schemaSurface } = await import('./schema-surface.js');
-        io.out.write(`${await machineJson(await schemaSurface(manifest, argv), head)}\n`);
+        io.out.write(`${await machineJson(await schemaSurface(manifest, asked), askedHead)}\n`);
         return true;
     }
     if (head[0] === '--mcp') {

package/dist/yargs/cliui.js

@@ -56,7 +56,7 @@ export class UI {
                 width: i === 0 && columns.length > 1 ? leftColumnWidth : undefined,
             })));
         });
-        return this.rows[this.rows.length - 1];
+        return this.rows.at(-1);
     }
     colFromString(text) {
         return { text, padding: this.measurePadding(text) };

package/dist/yargs/factory.js

@@ -743,7 +743,7 @@ export class YargsInstance {
                 return false;
             return supportedOpts.includes(k);
         });
-        const fullCommand = this.#context.fullCommands[this.#context.fullCommands.length - 1];
+        const fullCommand = this.#context.fullCommands.at(-1);
         const parseOptions = fullCommand ? this.#command.cmdToParseOptions(fullCommand) : { array: [], alias: {}, default: {}, demand: {} };
         objectKeys(parseOptions).forEach((pk) => {
             const parseOption = parseOptions[pk];
@@ -1515,7 +1515,7 @@ export class YargsInstance {
                 return this.#postProcess(argv, populateDoubleDash, !!calledFromCommand, false);
             if (this.#helpOpt) {
                 const helpCmds = [this.#helpOpt].concat(aliases[this.#helpOpt] || []).filter((k) => k.length > 1);
-                if (helpCmds.includes(`${argv._[argv._.length - 1]}`)) {
+                if (helpCmds.includes(`${argv._.at(-1)}`)) {
                     argv._.pop();
                     helpOptSet = true;
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "burgee",
-  "version": "0.13.1",
+  "version": "0.14.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",
@@ -148,10 +148,10 @@
   },
   "dependencies": {
     "bellpull": "^0.4.2",
-    "closeout": "^0.5.3",
+    "closeout": "^0.5.4",
     "linegauge": "^0.5.4",
-    "roundel": "^0.5.3",
-    "seniority": "^0.6.2"
+    "roundel": "^0.5.4",
+    "seniority": "^0.6.3"
   },
   "devDependencies": {
     "vitest": "^5.0.1"