@qui-cli/core 6.0.0 → 6.0.2

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to this project will be documented in this file. See [commit-and-tag-version](https://github.com/absolute-version/commit-and-tag-version) for commit guidelines.
 
+## [6.0.2](https://github.com/battis/qui-cli/compare/core/6.0.1...core/6.0.2) (2026-02-21)
+
+
+### Bug Fixes
+
+* display positional arg documentation ([c97c454](https://github.com/battis/qui-cli/commit/c97c45477df474880b6ae3071d4e9c2f11b17a97))
+
+## [6.0.1](https://github.com/battis/qui-cli/compare/core/6.0.0...core/6.0.1) (2026-02-21)
+
+
+### Bug Fixes
+
+* display plugin usage information in LIFO registration order ([a79c8ed](https://github.com/battis/qui-cli/commit/a79c8ed0e0f8dc0bb45a035909e82af37b7ba350))
+
 ## [6.0.0](https://github.com/battis/qui-cli/compare/core/5.0.3...core/6.0.0) (2026-01-29)
 
 

package/dist/Core.d.ts

@@ -3,6 +3,15 @@ import * as JackSpeak from './JackSpeak.js';
 export { Options } from '@qui-cli/plugin';
 export * from './Usage.js';
 export type Configuration = Plugin.Registrar.Configuration & {
+    /**
+     * Usage information for plugins is diplayed in LIFO (last-in, first-out)
+     * order, putting the plug-in that requires other plug-ins at the top and the
+     * plug-ins required by other plug-ins at the bottom.
+     *
+     * To display plugins in FIFO order (as in qui-cli/core@<6.0.1), set
+     * `lifoUsage` to false
+     */
+    lifoUsage?: boolean;
     /** @deprecated Use {@link JackSpeak} core plugin */
     core?: JackSpeak.Configuration & {
         /** @deprecated Use {@link Positionals} core plugin */

package/dist/Core.js

@@ -1,9 +1,12 @@
 import * as Plugin from '@qui-cli/plugin';
+import * as Help from './Help.js';
 import * as JackSpeak from './JackSpeak.js';
 import * as Positionals from './Positionals.js';
 export * from './Usage.js';
 let initialized = false;
+let lifoUsage = true;
 export async function configure(config = {}) {
+    lifoUsage = Plugin.hydrate(config.lifoUsage, lifoUsage);
     const { core = {}, jackspeak: jackOptions, positionals = {} } = config;
     const { requirePositionals, ...deprecated } = core;
     const jackspeak = {
@@ -16,17 +19,30 @@ export async function configure(config = {}) {
     }
     await Plugin.Registrar.configure({ positionals, jackspeak });
 }
+function requireUnusedOptions(plugin) {
+    return (!!plugin.options &&
+        plugin.name !== Positionals.name &&
+        plugin.name !== Help.name);
+}
 export async function init(externalOptions) {
     if (initialized) {
         throw new Error(`Already initialized with user-provided command line arguments.`);
     }
-    for (const plugin of Plugin.Registrar.registered()) {
-        if (plugin.options) {
-            JackSpeak.args(await plugin.options());
-        }
-    }
+    JackSpeak.args(Help.options());
+    JackSpeak.args(Positionals.options());
+    const usage = [
+        ...(await Promise.all(Plugin.Registrar.registered()
+            .filter(requireUnusedOptions)
+            .map(async (plugin) => await plugin.options())))
+    ];
     if (externalOptions) {
-        JackSpeak.args(Plugin.documentDefaults(externalOptions));
+        usage.push(Plugin.documentDefaults(externalOptions));
+    }
+    if (lifoUsage) {
+        usage.reverse();
+    }
+    for (const options of usage) {
+        JackSpeak.args(options);
     }
     const args = JackSpeak.parse();
     await Plugin.Registrar.init(args);

package/dist/Help.js

@@ -9,7 +9,7 @@ export function options() {
     return {
         flag: {
             help: {
-                description: 'Get usage information',
+                description: 'Show this usage information',
                 short: 'h'
             }
         }

package/dist/JackSpeak.d.ts

@@ -11,7 +11,7 @@ export declare function toJSON(): {
         hint?: string | undefined;
         default?: import("jackspeak").ConfigValue | undefined;
         validOptions?: readonly number[] | readonly string[] | undefined;
-        validate?: ((v: unknown) => boolean) | ((v: unknown) => v is import("jackspeak").ValidValue<import("jackspeak").ConfigType, boolean>) | undefined;
+        validate?: ((v: unknown) => boolean) | ((v: unknown) => v is import("jackspeak").ConfigValue) | undefined;
         description?: string | undefined;
         short?: string | undefined;
         delim?: string | undefined;

package/dist/Positionals.d.ts

@@ -41,6 +41,7 @@ export declare function maximumUnnamedCount(): number | undefined;
  * @param maxUnnamed Number of optional args to allow
  */
 export declare function requireNoMoreThanUnnamedArgs(maxUnnamed: number): void;
+export declare function options(): Plugin.Options;
 export declare function init(args: Plugin.ExpectedArguments<() => Plugin.Options>): void;
 export declare function usageArgs(): string;
 export declare function usage(usage: string, isMarkdown?: boolean): string;

package/dist/Positionals.js

@@ -109,6 +109,22 @@ export function requireNoMoreThanUnnamedArgs(maxUnnamed) {
     }
     requireNoMoreThan(namedCount() + maxUnnamed);
 }
+export function options() {
+    const man = [];
+    for (const arg in configSet) {
+        man.push({
+            level: 2,
+            text: `${Colors.positionalArg(arg)}${configSet[arg].hint ? `=<${configSet[arg].hint}>` : ''}`
+        });
+        if (configSet[arg].description) {
+            man.push({ text: configSet[arg].description });
+        }
+    }
+    if (man.length > 0) {
+        man.unshift({ level: 1, text: 'Positional arguments' });
+    }
+    return { man };
+}
 export function init(args) {
     positionals = [...args.positionals];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qui-cli/core",
-  "version": "6.0.0",
+  "version": "6.0.2",
   "description": "Core features of @qui-cli/qui-cli",
   "homepage": "https://github.com/battis/qui-cli/tree/main/packages/core#readme",
   "repository": {
@@ -17,13 +17,13 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "dependencies": {
-    "jackspeak": "^4.1.1",
-    "wrap-ansi": "^9.0.2",
+    "jackspeak": "^4.2.3",
+    "wrap-ansi": "^10.0.0",
     "@qui-cli/colors": "3.2.3"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",
-    "@types/node": "^24.10.9",
+    "@types/node": "^24.10.13",
     "commit-and-tag-version": "^12.6.1",
     "del-cli": "^7.0.0",
     "npm-run-all": "^4.1.5",