@optique/discover 1.4.0-dev.2678 → 1.4.0-dev.2679

package/dist/cli.cjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 const require_chunk = require('./chunk-CUT6urMc.cjs');
 require('./command-CfkGTUEa.cjs');
-require('./src-B6mG1y_9.cjs');
-const require_generator = require('./generator-w9f9yABr.cjs');
+require('./src-BRYaiQ7Y.cjs');
+const require_generator = require('./generator-DwyzKqEQ.cjs');
 const require_main_check = require('./main-check-CwunSNpK.cjs');
 const __optique_core_constructs = require_chunk.__toESM(require("@optique/core/constructs"));
 const __optique_core_message = require_chunk.__toESM(require("@optique/core/message"));
@@ -15,7 +15,7 @@ const node_process = require_chunk.__toESM(require("node:process"));
 
 //#region deno.json
 var name = "@optique/discover";
-var version = "1.4.0-dev.2678+a475f32a";
+var version = "1.4.0-dev.2679+3a3a57d2";
 var license = "MIT";
 var exports$1 = {
 	".": "./src/index.ts",

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import "./command-CfQmeg9P.js";
-import "./src-CKOT5gax.js";
-import { watchCommandsModule, writeCommandsModule } from "./generator-65GYfm_3.js";
+import "./src-BxewopIn.js";
+import { watchCommandsModule, writeCommandsModule } from "./generator-DPHYAQ4c.js";
 import { isMainModuleUrl } from "./main-check-mMnKfUZs.js";
 import { object } from "@optique/core/constructs";
 import { message } from "@optique/core/message";
@@ -14,7 +14,7 @@ import process from "node:process";
 
 //#region deno.json
 var name = "@optique/discover";
-var version = "1.4.0-dev.2678+a475f32a";
+var version = "1.4.0-dev.2679+3a3a57d2";
 var license = "MIT";
 var exports = {
 	".": "./src/index.ts",

package/dist/{generator-65GYfm_3.js → generator-DPHYAQ4c.js}

@@ -1,4 +1,4 @@
-import { getDefaultExtensions } from "./src-CKOT5gax.js";
+import { getDefaultExtensions } from "./src-BxewopIn.js";
 import { mkdir, readdir, realpath, stat, writeFile } from "node:fs/promises";
 import { dirname, posix, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";

package/dist/{generator-w9f9yABr.cjs → generator-DwyzKqEQ.cjs}

@@ -1,5 +1,5 @@
 const require_chunk = require('./chunk-CUT6urMc.cjs');
-const require_src = require('./src-B6mG1y_9.cjs');
+const require_src = require('./src-BRYaiQ7Y.cjs');
 const node_fs_promises = require_chunk.__toESM(require("node:fs/promises"));
 const node_path = require_chunk.__toESM(require("node:path"));
 const node_url = require_chunk.__toESM(require("node:url"));

package/dist/generator.cjs

@@ -1,6 +1,6 @@
 require('./command-CfkGTUEa.cjs');
-require('./src-B6mG1y_9.cjs');
-const require_generator = require('./generator-w9f9yABr.cjs');
+require('./src-BRYaiQ7Y.cjs');
+const require_generator = require('./generator-DwyzKqEQ.cjs');
 
 exports.generateCommandsModule = require_generator.generateCommandsModule;
 exports.watchCommandsModule = require_generator.watchCommandsModule;

package/dist/generator.js

@@ -1,5 +1,5 @@
 import "./command-CfQmeg9P.js";
-import "./src-CKOT5gax.js";
-import { generateCommandsModule, watchCommandsModule, writeCommandsModule } from "./generator-65GYfm_3.js";
+import "./src-BxewopIn.js";
+import { generateCommandsModule, watchCommandsModule, writeCommandsModule } from "./generator-DPHYAQ4c.js";
 
 export { generateCommandsModule, watchCommandsModule, writeCommandsModule };

package/dist/index.cjs

@@ -1,5 +1,5 @@
 const require_command = require('./command-CfkGTUEa.cjs');
-const require_src = require('./src-B6mG1y_9.cjs');
+const require_src = require('./src-BRYaiQ7Y.cjs');
 
 exports.commandsFromModules = require_src.commandsFromModules;
 exports.createProgramParser = require_src.createProgramParser;

package/dist/index.js

@@ -1,4 +1,4 @@
 import { defineCommand, isCommand } from "./command-CfQmeg9P.js";
-import { commandsFromModules, createProgramParser, discoverCommands, getDefaultExtensions, runProgram } from "./src-CKOT5gax.js";
+import { commandsFromModules, createProgramParser, discoverCommands, getDefaultExtensions, runProgram } from "./src-BxewopIn.js";
 
 export { commandsFromModules, createProgramParser, defineCommand, discoverCommands, getDefaultExtensions, isCommand, runProgram };

package/dist/{src-B6mG1y_9.cjs → src-BRYaiQ7Y.cjs}

@@ -701,9 +701,10 @@ function withNamespaceListDocDescription(fragments, name, description) {
 }
 function namespaceCommandMetadata(metadata, inheritedHidden) {
 	const hidden = (0, __optique_core_usage.mergeHidden)(inheritedHidden, metadata?.hidden);
-	if (metadata?.aliases == null && metadata?.errors == null && hidden == null && metadata?.usageLine == null) return void 0;
+	if (metadata?.aliases == null && metadata?.showAliases == null && metadata?.errors == null && hidden == null && metadata?.usageLine == null) return void 0;
 	return {
 		...metadata?.aliases != null && { aliases: metadata.aliases },
+		...metadata?.showAliases != null && { showAliases: metadata.showAliases },
 		...metadata?.errors != null && { errors: metadata.errors },
 		...hidden != null && { hidden },
 		...metadata?.usageLine != null && { usageLine: metadata.usageLine }
@@ -744,14 +745,20 @@ function withRootDocs(parser, commands, metadata) {
 		const fragments = [...root?.fragments ?? []];
 		if (listedCommands.length > 0) fragments.push({
 			type: "section",
-			entries: listedCommands.map((entry) => ({
-				term: {
-					type: "command",
-					name: entry.path.join(" "),
-					hidden: commandPathHidden(entry.path, commandsByPath)
-				},
-				description: entry.command.metadata?.brief ?? entry.command.metadata?.description
-			}))
+			entries: listedCommands.map((entry) => {
+				const aliases = qualifiedCommandAliases(entry.path, entry.command.metadata?.aliases);
+				const showAliases = entry.command.metadata?.showAliases;
+				return {
+					term: {
+						type: "command",
+						name: entry.path.join(" "),
+						...aliases.length > 0 && { aliases },
+						hidden: commandPathHidden(entry.path, commandsByPath)
+					},
+					description: entry.command.metadata?.brief ?? entry.command.metadata?.description,
+					...showAliases != null && { showAliases }
+				};
+			})
 		});
 		return {
 			brief: metadata.brief,
@@ -792,9 +799,23 @@ function rootListedCommands(commands, commandsByPath, commandList) {
 	}
 	return [...topLevelEntries.values()];
 }
+/**
+* Spells each alias of the command at `path` as a full command path, since
+* root command lists name commands by their full paths.
+*/
+function qualifiedCommandAliases(path, aliases) {
+	if (aliases == null) return [];
+	const parent = path.slice(0, -1);
+	return aliases.map((alias) => [...parent, alias].join(" "));
+}
+/**
+* Strips the documentation of a descendant command that stands in for a
+* synthetic namespace, including its aliases, which belong to the
+* descendant rather than the namespace.
+*/
 function withoutCommandDocs(commandDefinition) {
 	if (commandDefinition.metadata == null) return commandDefinition;
-	const { brief: _brief, description: _description,...metadata } = commandDefinition.metadata;
+	const { brief: _brief, description: _description, aliases: _aliases, showAliases: _showAliases,...metadata } = commandDefinition.metadata;
 	return {
 		...commandDefinition,
 		metadata

package/dist/{src-CKOT5gax.js → src-BxewopIn.js}

@@ -700,9 +700,10 @@ function withNamespaceListDocDescription(fragments, name, description) {
 }
 function namespaceCommandMetadata(metadata, inheritedHidden) {
 	const hidden = mergeHidden(inheritedHidden, metadata?.hidden);
-	if (metadata?.aliases == null && metadata?.errors == null && hidden == null && metadata?.usageLine == null) return void 0;
+	if (metadata?.aliases == null && metadata?.showAliases == null && metadata?.errors == null && hidden == null && metadata?.usageLine == null) return void 0;
 	return {
 		...metadata?.aliases != null && { aliases: metadata.aliases },
+		...metadata?.showAliases != null && { showAliases: metadata.showAliases },
 		...metadata?.errors != null && { errors: metadata.errors },
 		...hidden != null && { hidden },
 		...metadata?.usageLine != null && { usageLine: metadata.usageLine }
@@ -743,14 +744,20 @@ function withRootDocs(parser, commands, metadata) {
 		const fragments = [...root?.fragments ?? []];
 		if (listedCommands.length > 0) fragments.push({
 			type: "section",
-			entries: listedCommands.map((entry) => ({
-				term: {
-					type: "command",
-					name: entry.path.join(" "),
-					hidden: commandPathHidden(entry.path, commandsByPath)
-				},
-				description: entry.command.metadata?.brief ?? entry.command.metadata?.description
-			}))
+			entries: listedCommands.map((entry) => {
+				const aliases = qualifiedCommandAliases(entry.path, entry.command.metadata?.aliases);
+				const showAliases = entry.command.metadata?.showAliases;
+				return {
+					term: {
+						type: "command",
+						name: entry.path.join(" "),
+						...aliases.length > 0 && { aliases },
+						hidden: commandPathHidden(entry.path, commandsByPath)
+					},
+					description: entry.command.metadata?.brief ?? entry.command.metadata?.description,
+					...showAliases != null && { showAliases }
+				};
+			})
 		});
 		return {
 			brief: metadata.brief,
@@ -791,9 +798,23 @@ function rootListedCommands(commands, commandsByPath, commandList) {
 	}
 	return [...topLevelEntries.values()];
 }
+/**
+* Spells each alias of the command at `path` as a full command path, since
+* root command lists name commands by their full paths.
+*/
+function qualifiedCommandAliases(path, aliases) {
+	if (aliases == null) return [];
+	const parent = path.slice(0, -1);
+	return aliases.map((alias) => [...parent, alias].join(" "));
+}
+/**
+* Strips the documentation of a descendant command that stands in for a
+* synthetic namespace, including its aliases, which belong to the
+* descendant rather than the namespace.
+*/
 function withoutCommandDocs(commandDefinition) {
 	if (commandDefinition.metadata == null) return commandDefinition;
-	const { brief: _brief, description: _description,...metadata } = commandDefinition.metadata;
+	const { brief: _brief, description: _description, aliases: _aliases, showAliases: _showAliases,...metadata } = commandDefinition.metadata;
 	return {
 		...commandDefinition,
 		metadata

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/discover",
-  "version": "1.4.0-dev.2678",
+  "version": "1.4.0-dev.2679",
   "description": "Runtime-aware command discovery for Optique CLI programs",
   "keywords": [
     "CLI",
@@ -83,11 +83,11 @@
     "optique-discover": "./dist/cli.js"
   },
   "dependencies": {
-    "@optique/core": "1.4.0-dev.2678+a475f32a",
-    "@optique/run": "1.4.0-dev.2678+a475f32a"
+    "@optique/core": "1.4.0-dev.2679+3a3a57d2",
+    "@optique/run": "1.4.0-dev.2679+3a3a57d2"
   },
   "devDependencies": {
-    "@optique/testing": "1.4.0-dev.2678+a475f32a",
+    "@optique/testing": "1.4.0-dev.2679+3a3a57d2",
     "@types/node": "^24.0.0",
     "tsdown": "^0.13.0",
     "typescript": "^5.8.3"