@qui-cli/core 6.0.1 → 6.0.2

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.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)
 
 

package/dist/Core.js

@@ -1,4 +1,5 @@
 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';
@@ -18,31 +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.`);
     }
+    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) {
+        usage.push(Plugin.documentDefaults(externalOptions));
+    }
     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());
-            }
-        }
+        usage.reverse();
     }
-    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));
-        }
+    for (const options of usage) {
+        JackSpeak.args(options);
     }
     const args = JackSpeak.parse();
     await Plugin.Registrar.init(args);

package/dist/Help.js

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

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.1",
+  "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": {