@qui-cli/core 6.0.0 → 6.0.1

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 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.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

@@ -3,7 +3,9 @@ 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 = {
@@ -20,13 +22,27 @@ 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());
+    if (lifoUsage) {
+        // lifo plugin usage order
+        if (externalOptions) {
+            JackSpeak.args(Plugin.documentDefaults(externalOptions));
+        }
+        for (const plugin of Plugin.Registrar.registered().toReversed()) {
+            if (plugin.options) {
+                JackSpeak.args(await plugin.options());
+            }
         }
     }
-    if (externalOptions) {
-        JackSpeak.args(Plugin.documentDefaults(externalOptions));
+    else {
+        // fifo plugin usage order
+        for (const plugin of Plugin.Registrar.registered()) {
+            if (plugin.options) {
+                JackSpeak.args(await plugin.options());
+            }
+        }
+        if (externalOptions) {
+            JackSpeak.args(Plugin.documentDefaults(externalOptions));
+        }
     }
     const args = JackSpeak.parse();
     await Plugin.Registrar.init(args);

package/dist/Help.js

@@ -7,6 +7,7 @@ export function configure(config = {}) {
 }
 export function options() {
     return {
+        man: [{ level: 1, text: 'Usage information' }],
         flag: {
             help: {
                 description: 'Get usage information',

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qui-cli/core",
-  "version": "6.0.0",
+  "version": "6.0.1",
   "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",