@qui-cli/core 5.0.3 → 6.0.1

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 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)
+
+
+### ⚠ BREAKING CHANGES
+
+* allow errors to be thrown
+
+### Bug Fixes
+
+* allow errors to be thrown ([8bf98db](https://github.com/battis/qui-cli/commit/8bf98db45ebe06514cef02572d515379985c7067))
+* preempt all other plugins if --help is set ([db99833](https://github.com/battis/qui-cli/commit/db9983336135080a5fecff6adbf2e2913f55fa8d))
+
 ## [5.0.3](https://github.com/battis/qui-cli/compare/core/5.0.2...core/5.0.3) (2026-01-18)
 
 

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,11 +1,11 @@
-import * as Colors from '@qui-cli/colors/dist/Colors.js';
 import * as Plugin from '@qui-cli/plugin';
 import * as JackSpeak from './JackSpeak.js';
 import * as Positionals from './Positionals.js';
-import { usage } from './Usage.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 = {
@@ -22,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);
@@ -36,15 +50,8 @@ export async function init(externalOptions) {
     return args;
 }
 export async function run(externalOptions) {
-    try {
-        if (!initialized) {
-            await init(externalOptions);
-        }
-        return await Plugin.Registrar.run();
-    }
-    catch (e) {
-        const error = e;
-        console.log(`${Colors.error(error.message)}\n\n${usage()}`);
-        process.exit(1);
+    if (!initialized) {
+        await init(externalOptions);
     }
+    return await Plugin.Registrar.run();
 }

package/dist/Help.d.ts

@@ -7,4 +7,3 @@ export declare const name = "core.help";
 export declare function configure(config?: Configuration): void;
 export declare function options(): Plugin.Options;
 export declare function init({ values }: Plugin.ExpectedArguments<typeof options>): void;
-export declare function run(): void;

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',
@@ -17,8 +18,6 @@ export function options() {
 }
 export function init({ values }) {
     configure(values);
-}
-export function run() {
     if (help) {
         console.log(Core.usage());
         process.exit(0);

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": "5.0.3",
+  "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",