burgee 0.13.0 → 0.13.2

package/README.md

@@ -20,7 +20,8 @@
 </p>
 
 <p align="center">
-  Docs: <a href="https://burgee.interlace.tools/docs/packages/burgee">https://burgee.interlace.tools/docs/packages/burgee</a>
+  Docs: <a href="https://burgee.interlace.tools/docs/packages/burgee">https://burgee.interlace.tools/docs/packages/burgee</a><br />
+  Migrating from: <a href="https://burgee.interlace.tools/docs/vs/commander">commander</a> · <a href="https://burgee.interlace.tools/docs/vs/yargs">yargs</a>
 </p>
 
 A **burgee** is the small swallowtail flag a boat flies to say which club or fleet it

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

@@ -96,7 +96,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 }));

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.0",
+  "version": "0.13.2",
   "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",
@@ -147,11 +147,11 @@
     "provenance": true
   },
   "dependencies": {
-    "bellpull": "^0.4.1",
-    "closeout": "^0.5.2",
-    "linegauge": "^0.5.3",
-    "roundel": "^0.5.2",
-    "seniority": "^0.6.1"
+    "bellpull": "^0.4.2",
+    "closeout": "^0.5.4",
+    "linegauge": "^0.5.4",
+    "roundel": "^0.5.4",
+    "seniority": "^0.6.3"
   },
   "devDependencies": {
     "vitest": "^5.0.1"