politty 0.4.14 → 0.4.15

package/README.md

@@ -9,7 +9,7 @@ From simple scripts to complex CLI tools with subcommands, validation, and auto-
 - **Zod Native**: Use Zod schemas directly for argument definition and validation
 - **Type Safety**: Full TypeScript support with automatic type inference for parsed arguments
 - **Flexible Argument Definition**: Support for positional arguments, flags, aliases, arrays, and environment variable fallbacks
-- **Subcommands**: Build Git-style nested subcommands (with lazy loading support)
+- **Subcommands**: Build Git-style nested subcommands (with lazy loading and alias support)
 - **Lifecycle Management**: Guaranteed `setup` → `run` → `cleanup` execution order
 - **Signal Handling**: Proper SIGINT/SIGTERM handling with guaranteed cleanup execution
 - **Auto Help Generation**: Automatically generate help text from definitions
@@ -149,6 +149,7 @@ import { arg, defineCommand, runMain } from "politty";
 const initCommand = defineCommand({
   name: "init",
   description: "Initialize a project",
+  aliases: ["i"],
   args: z.object({
     template: arg(z.string().default("default"), {
       alias: "t",
@@ -163,6 +164,7 @@ const initCommand = defineCommand({
 const buildCommand = defineCommand({
   name: "build",
   description: "Build the project",
+  aliases: ["b"],
   args: z.object({
     output: arg(z.string().default("dist"), {
       alias: "o",
@@ -194,7 +196,9 @@ Example usage:
 
 ```bash
 $ my-cli init -t react
+$ my-cli i -t react        # alias for init
 $ my-cli build -o out -m
+$ my-cli b -o out -m        # alias for build
 $ my-cli --help
 ```
 
@@ -246,6 +250,7 @@ Define a command.
 | `name`        | `string`                      | Command name        |
 | `description` | `string?`                     | Command description |
 | `args`        | `ZodSchema`                   | Argument schema     |
+| `aliases`     | `string[]?`                   | Command aliases     |
 | `subCommands` | `Record<string, Command>?`    | Subcommands         |
 | `setup`       | `(context) => Promise<void>?` | Setup hook          |
 | `run`         | `(args) => T?`                | Run function        |
@@ -393,6 +398,7 @@ The `playground/` directory contains many examples:
 - `10-subcommands` - Subcommands
 - `12-discriminated-union` - Discriminated Union
 - `21-lazy-subcommands` - Lazy loading
+- `26-command-alias` - Command aliases
 
 ## License
 

package/dist/{arg-registry-r5wYN6qd.d.cts → arg-registry-CB5gGtzp.d.cts}

@@ -246,6 +246,8 @@ interface CommandBase<TArgsSchema extends ArgsSchema | undefined = undefined, TA
   name: string;
   /** Command description */
   description?: string | undefined;
+  /** Alternative names for this command (used as subcommand aliases) */
+  aliases?: string[] | undefined;
   /** Argument schema (preserves the original Zod schema type) */
   args: TArgsSchema;
   /** Subcommands */
@@ -681,4 +683,4 @@ declare function arg<T extends z.ZodType>(schema: T): T;
 declare function arg<T extends z.ZodType, M extends ArgMeta<z.output<T>>>(schema: T, meta: ValidateArgMeta<M>): T;
 //#endregion
 export { RunResultSuccess as A, UnknownKeysMode as B, Logger as C, RunCommandOptions as D, PromptResolver as E, LazyCommand as F, getUnknownKeysMode as H, isLazyCommand as I, lazy as L, SetupContext as M, SubCommandValue as N, RunResult as O, SubCommandsRecord as P, ExtractedFields as R, LogStream as S, NonRunnableCommand as T, toCamelCase as U, extractFields as V, toKebabCase as W, GlobalCleanupContext as _, EffectContext as a, LogEntry as b, arg as c, CleanupContext as d, CollectedLogs as f, GlobalArgs as g, Example as h, CustomCompletion as i, RunnableCommand as j, RunResultFailure as k, AnyCommand as l, CommandBase as m, CompletionMeta as n, PromptMeta as o, Command as p, CompletionType as r, PromptType as s, ArgMeta as t, ArgsSchema as u, GlobalSetupContext as v, MainOptions as w, LogLevel as x, IsEmpty as y, ResolvedFieldMeta as z };
-//# sourceMappingURL=arg-registry-r5wYN6qd.d.cts.map
+//# sourceMappingURL=arg-registry-CB5gGtzp.d.cts.map

package/dist/arg-registry-CB5gGtzp.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arg-registry-CB5gGtzp.d.cts","names":[],"sources":["../src/core/schema-extractor.ts","../src/lazy.ts","../src/types.ts","../src/core/arg-registry.ts"],"mappings":"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"}

package/dist/{arg-registry-CkPDokIu.d.ts → arg-registry-Dw0f11Zc.d.ts}

@@ -246,6 +246,8 @@ interface CommandBase<TArgsSchema extends ArgsSchema | undefined = undefined, TA
   name: string;
   /** Command description */
   description?: string | undefined;
+  /** Alternative names for this command (used as subcommand aliases) */
+  aliases?: string[] | undefined;
   /** Argument schema (preserves the original Zod schema type) */
   args: TArgsSchema;
   /** Subcommands */
@@ -681,4 +683,4 @@ declare function arg<T extends z.ZodType>(schema: T): T;
 declare function arg<T extends z.ZodType, M extends ArgMeta<z.output<T>>>(schema: T, meta: ValidateArgMeta<M>): T;
 //#endregion
 export { RunResultSuccess as A, UnknownKeysMode as B, Logger as C, RunCommandOptions as D, PromptResolver as E, LazyCommand as F, getUnknownKeysMode as H, isLazyCommand as I, lazy as L, SetupContext as M, SubCommandValue as N, RunResult as O, SubCommandsRecord as P, ExtractedFields as R, LogStream as S, NonRunnableCommand as T, toCamelCase as U, extractFields as V, toKebabCase as W, GlobalCleanupContext as _, EffectContext as a, LogEntry as b, arg as c, CleanupContext as d, CollectedLogs as f, GlobalArgs as g, Example as h, CustomCompletion as i, RunnableCommand as j, RunResultFailure as k, AnyCommand as l, CommandBase as m, CompletionMeta as n, PromptMeta as o, Command as p, CompletionType as r, PromptType as s, ArgMeta as t, ArgsSchema as u, GlobalSetupContext as v, MainOptions as w, LogLevel as x, IsEmpty as y, ResolvedFieldMeta as z };
-//# sourceMappingURL=arg-registry-CkPDokIu.d.ts.map
+//# sourceMappingURL=arg-registry-Dw0f11Zc.d.ts.map

package/dist/arg-registry-Dw0f11Zc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arg-registry-Dw0f11Zc.d.ts","names":[],"sources":["../src/core/schema-extractor.ts","../src/lazy.ts","../src/types.ts","../src/core/arg-registry.ts"],"mappings":"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"}

package/dist/augment.d.cts

@@ -1,4 +1,4 @@
-import { t as ArgMeta } from "./arg-registry-r5wYN6qd.cjs";
+import { t as ArgMeta } from "./arg-registry-CB5gGtzp.cjs";
 
 //#region src/augment.d.ts
 declare module "zod" {

package/dist/augment.d.ts

@@ -1,4 +1,4 @@
-import { t as ArgMeta } from "./arg-registry-CkPDokIu.js";
+import { t as ArgMeta } from "./arg-registry-Dw0f11Zc.js";
 
 //#region src/augment.d.ts
 declare module "zod" {

package/dist/completion/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_completion = require('../completion-CAekGYS4.cjs');
+const require_completion = require('../completion-B5fgnUGm.cjs');
 
 exports.CompletionDirective = require_completion.CompletionDirective;
 exports.createCompletionCommand = require_completion.createCompletionCommand;

package/dist/completion/index.d.cts

@@ -1,2 +1,2 @@
-import { C as CompletableSubcommand, D as CompletionResult, E as CompletionOptions, O as ShellType, S as CompletableOption, T as CompletionGenerator, _ as CompletionDirective, a as getSupportedShells, b as CompletionType, c as resolveValueCompletion, d as ShellFormatOptions, f as formatForShell, g as CompletionCandidate, h as CandidateResult, i as generateCompletion, l as extractCompletionData, m as hasCompleteCommand, n as createCompletionCommand, o as withCompletionCommand, p as createDynamicCompleteCommand, r as detectShell, s as ValueCompletionField, t as WithCompletionOptions, u as extractPositionals, v as generateCandidates, w as CompletionData, x as parseCompletionContext, y as CompletionContext } from "../index-DPswv0Vt.cjs";
+import { C as CompletableSubcommand, D as CompletionResult, E as CompletionOptions, O as ShellType, S as CompletableOption, T as CompletionGenerator, _ as CompletionDirective, a as getSupportedShells, b as CompletionType, c as resolveValueCompletion, d as ShellFormatOptions, f as formatForShell, g as CompletionCandidate, h as CandidateResult, i as generateCompletion, l as extractCompletionData, m as hasCompleteCommand, n as createCompletionCommand, o as withCompletionCommand, p as createDynamicCompleteCommand, r as detectShell, s as ValueCompletionField, t as WithCompletionOptions, u as extractPositionals, v as generateCandidates, w as CompletionData, x as parseCompletionContext, y as CompletionContext } from "../index-C1gGgUeB.cjs";
 export { CandidateResult, CompletableOption, CompletableSubcommand, CompletionCandidate, CompletionContext, CompletionData, CompletionDirective, CompletionGenerator, CompletionOptions, CompletionResult, CompletionType, ShellFormatOptions, ShellType, ValueCompletionField, WithCompletionOptions, createCompletionCommand, createDynamicCompleteCommand, detectShell, extractCompletionData, extractPositionals, formatForShell, generateCandidates, generateCompletion, getSupportedShells, hasCompleteCommand, parseCompletionContext, resolveValueCompletion, withCompletionCommand };

package/dist/completion/index.d.ts

@@ -1,2 +1,2 @@
-import { C as CompletableSubcommand, D as CompletionResult, E as CompletionOptions, O as ShellType, S as CompletableOption, T as CompletionGenerator, _ as CompletionDirective, a as getSupportedShells, b as CompletionType, c as resolveValueCompletion, d as ShellFormatOptions, f as formatForShell, g as CompletionCandidate, h as CandidateResult, i as generateCompletion, l as extractCompletionData, m as hasCompleteCommand, n as createCompletionCommand, o as withCompletionCommand, p as createDynamicCompleteCommand, r as detectShell, s as ValueCompletionField, t as WithCompletionOptions, u as extractPositionals, v as generateCandidates, w as CompletionData, x as parseCompletionContext, y as CompletionContext } from "../index-BLySW_2k.js";
+import { C as CompletableSubcommand, D as CompletionResult, E as CompletionOptions, O as ShellType, S as CompletableOption, T as CompletionGenerator, _ as CompletionDirective, a as getSupportedShells, b as CompletionType, c as resolveValueCompletion, d as ShellFormatOptions, f as formatForShell, g as CompletionCandidate, h as CandidateResult, i as generateCompletion, l as extractCompletionData, m as hasCompleteCommand, n as createCompletionCommand, o as withCompletionCommand, p as createDynamicCompleteCommand, r as detectShell, s as ValueCompletionField, t as WithCompletionOptions, u as extractPositionals, v as generateCandidates, w as CompletionData, x as parseCompletionContext, y as CompletionContext } from "../index-Dg9Fpz0R.js";
 export { CandidateResult, CompletableOption, CompletableSubcommand, CompletionCandidate, CompletionContext, CompletionData, CompletionDirective, CompletionGenerator, CompletionOptions, CompletionResult, CompletionType, ShellFormatOptions, ShellType, ValueCompletionField, WithCompletionOptions, createCompletionCommand, createDynamicCompleteCommand, detectShell, extractCompletionData, extractPositionals, formatForShell, generateCandidates, generateCompletion, getSupportedShells, hasCompleteCommand, parseCompletionContext, resolveValueCompletion, withCompletionCommand };

package/dist/completion/index.js

@@ -1,3 +1,3 @@
-import { a as withCompletionCommand, c as formatForShell, d as generateCandidates, f as extractCompletionData, i as getSupportedShells, l as parseCompletionContext, m as resolveValueCompletion, n as detectShell, o as createDynamicCompleteCommand, p as extractPositionals, r as generateCompletion, s as hasCompleteCommand, t as createCompletionCommand, u as CompletionDirective } from "../completion-yHz8Pdr7.js";
+import { a as withCompletionCommand, c as formatForShell, d as generateCandidates, f as extractCompletionData, i as getSupportedShells, l as parseCompletionContext, m as resolveValueCompletion, n as detectShell, o as createDynamicCompleteCommand, p as extractPositionals, r as generateCompletion, s as hasCompleteCommand, t as createCompletionCommand, u as CompletionDirective } from "../completion-Ca5ESJlG.js";
 
 export { CompletionDirective, createCompletionCommand, createDynamicCompleteCommand, detectShell, extractCompletionData, extractPositionals, formatForShell, generateCandidates, generateCompletion, getSupportedShells, hasCompleteCommand, parseCompletionContext, resolveValueCompletion, withCompletionCommand };

package/dist/{completion-CAekGYS4.cjs → completion-B5fgnUGm.cjs}

@@ -1,5 +1,5 @@
-const require_subcommand_router = require('./subcommand-router-C9ONv6Nq.cjs');
-const require_lazy = require('./lazy-AGV9Pkt5.cjs');
+const require_log_collector = require('./log-collector-Cd2_mv87.cjs');
+const require_subcommand_router = require('./subcommand-router-CqZX3orq.cjs');
 let zod = require("zod");
 let node_child_process = require("node:child_process");
 
@@ -8,6 +8,7 @@ function defineCommand(config) {
 	return {
 		name: config.name,
 		description: config.description,
+		aliases: config.aliases,
 		args: config.args,
 		subCommands: config.subCommands,
 		setup: config.setup,
@@ -112,6 +113,25 @@ function getVisibleSubs(subs) {
 	return subs.filter((s) => !s.name.startsWith("__"));
 }
 /**
+* Get all completable subcommand names including aliases.
+* Returns an array of { name, description } for all visible subcommands
+* and their aliases.
+*/
+function getSubNamesWithAliases(subs) {
+	const result = [];
+	for (const sub of getVisibleSubs(subs)) {
+		result.push({
+			name: sub.name,
+			description: sub.description
+		});
+		if (sub.aliases) for (const alias of sub.aliases) result.push({
+			name: alias,
+			description: sub.description
+		});
+	}
+	return result;
+}
+/**
 * Convert a resolved field to a completable option
 */
 function fieldToOption(field) {
@@ -131,21 +151,21 @@ function fieldToOption(field) {
 */
 function extractOptions$1(command) {
 	if (!command.args) return [];
-	return require_lazy.extractFields(command.args).fields.filter((field) => !field.positional).map(fieldToOption);
+	return require_subcommand_router.extractFields(command.args).fields.filter((field) => !field.positional).map(fieldToOption);
 }
 /**
 * Extract positional arguments from a command
 */
 function extractPositionals(command) {
 	if (!command.args) return [];
-	return require_lazy.extractFields(command.args).fields.filter((field) => field.positional);
+	return require_subcommand_router.extractFields(command.args).fields.filter((field) => field.positional);
 }
 /**
 * Extract completable positional arguments from a command
 */
 function extractCompletablePositionals(command) {
 	if (!command.args) return [];
-	return require_lazy.extractFields(command.args).fields.filter((field) => field.positional).map((field, index) => ({
+	return require_subcommand_router.extractFields(command.args).fields.filter((field) => field.positional).map((field, index) => ({
 		name: field.name,
 		cliName: field.cliName,
 		position: index,
@@ -161,7 +181,7 @@ function extractCompletablePositionals(command) {
 function extractSubcommand(name, command) {
 	const subcommands = [];
 	if (command.subCommands) for (const [subName, subCommand] of Object.entries(command.subCommands)) {
-		const resolved = require_lazy.resolveSubCommandMeta(subCommand);
+		const resolved = require_subcommand_router.resolveSubCommandMeta(subCommand);
 		if (resolved) subcommands.push(extractSubcommand(subName, resolved));
 		else subcommands.push({
 			name: subName,
@@ -174,6 +194,7 @@ function extractSubcommand(name, command) {
 	return {
 		name,
 		description: command.description,
+		aliases: command.aliases,
 		subcommands,
 		options: extractOptions$1(command),
 		positionals: extractCompletablePositionals(command)
@@ -195,13 +216,17 @@ function optTakesValueEntries(sub, parentPath) {
 		if (opt.alias) for (const a of opt.alias) patterns.push(`${parentPath}:${a.length === 1 ? `-${a}` : `--${a}`}`);
 		lines.push(`        ${patterns.join("|")}) return 0 ;;`);
 	}
-	for (const child of getVisibleSubs(sub.subcommands)) lines.push(...optTakesValueEntries(child, joinPrefix(parentPath, child.name, ":")));
+	for (const child of getVisibleSubs(sub.subcommands)) {
+		lines.push(...optTakesValueEntries(child, joinPrefix(parentPath, child.name, ":")));
+		if (child.aliases) for (const alias of child.aliases) lines.push(...optTakesValueEntries(child, joinPrefix(parentPath, alias, ":")));
+	}
 	return lines;
 }
 /**
 * Recursively collect all subcommand route entries.
 * Returns entries used by all shell generators for both dispatch routing
 * and subcommand lookup (is_subcmd) tables.
+* Aliases are mapped to the same handler as the canonical name.
 */
 function collectRouteEntries(sub, parentPath = "", parentFunc = "") {
 	const entries = [];
@@ -214,6 +239,15 @@ function collectRouteEntries(sub, parentPath = "", parentFunc = "") {
 			funcSuffix,
 			lookupPattern: `${parentPath}:${child.name}`
 		});
+		if (child.aliases) for (const alias of child.aliases) {
+			const aliasPathStr = joinPrefix(parentPath, alias, ":");
+			entries.push(...collectRouteEntries(child, aliasPathStr, funcSuffix));
+			entries.push({
+				pathStr: aliasPathStr,
+				funcSuffix,
+				lookupPattern: `${parentPath}:${alias}`
+			});
+		}
 	}
 	return entries;
 }
@@ -246,7 +280,7 @@ function extractCompletionData(command, programName, globalArgsSchema) {
 	const rootSubcommand = extractSubcommand(programName, command);
 	let globalOptions;
 	if (globalArgsSchema) {
-		globalOptions = require_lazy.extractFields(globalArgsSchema).fields.filter((field) => !field.positional).map(fieldToOption);
+		globalOptions = require_subcommand_router.extractFields(globalArgsSchema).fields.filter((field) => !field.positional).map(fieldToOption);
 		propagateGlobalOptions(rootSubcommand, globalOptions);
 	} else globalOptions = rootSubcommand.options;
 	return {
@@ -417,7 +451,7 @@ function generateSubHandler$2(sub, fn, path) {
 	lines.push(`        return`);
 	lines.push(`    fi`);
 	if (visibleSubs.length > 0) {
-		const subNames = visibleSubs.map((s) => s.name).join(" ");
+		const subNames = getSubNamesWithAliases(sub.subcommands).map((s) => s.name).join(" ");
 		lines.push(`    COMPREPLY=($(compgen -W "${subNames}" -- "$_cur"))`);
 		lines.push(`    compopt +o default 2>/dev/null`);
 	} else if (sub.positionals.length > 0) lines.push(...positionalBlock$2(sub.positionals));
@@ -479,7 +513,7 @@ function generateBashCompletion(command, options) {
 	lines.push(`        compopt +o default 2>/dev/null`);
 	if (visibleSubs.length > 0) {
 		lines.push(`    else`);
-		const subNames = visibleSubs.map((s) => s.name).join(" ");
+		const subNames = getSubNamesWithAliases(root.subcommands).map((s) => s.name).join(" ");
 		lines.push(`        COMPREPLY=($(compgen -W "${subNames}" -- "$_cur"))`);
 		lines.push(`        compopt +o default 2>/dev/null`);
 	} else if (root.positionals.length > 0) {
@@ -668,8 +702,16 @@ function generateSubcommandCandidates(context) {
 	const candidates = [];
 	let directive = CompletionDirective.FilterPrefix;
 	for (const name of context.subcommands) {
+		let description;
 		const sub = context.currentCommand.subCommands?.[name];
-		const description = sub ? require_lazy.resolveSubCommandMeta(sub)?.description : void 0;
+		if (sub) description = require_subcommand_router.resolveSubCommandMeta(sub)?.description;
+		else {
+			const canonical = require_subcommand_router.resolveSubCommandAlias(context.currentCommand, name);
+			if (canonical) {
+				const resolved = context.currentCommand.subCommands?.[canonical];
+				if (resolved) description = require_subcommand_router.resolveSubCommandMeta(resolved)?.description;
+			}
+		}
 		candidates.push({
 			value: name,
 			description,
@@ -763,7 +805,7 @@ function generatePositionalCandidates(context) {
 */
 function extractOptions(command) {
 	if (!command.args) return [];
-	return require_lazy.extractFields(command.args).fields.filter((field) => !field.positional).map((field) => ({
+	return require_subcommand_router.extractFields(command.args).fields.filter((field) => !field.positional).map((field) => ({
 		name: field.name,
 		cliName: field.cliName,
 		alias: field.alias,
@@ -779,7 +821,7 @@ function extractOptions(command) {
 */
 function extractPositionalsForContext(command) {
 	if (!command.args) return [];
-	return require_lazy.extractFields(command.args).fields.filter((field) => field.positional).map((field, index) => ({
+	return require_subcommand_router.extractFields(command.args).fields.filter((field) => field.positional).map((field, index) => ({
 		name: field.name,
 		cliName: field.cliName,
 		position: index,
@@ -790,20 +832,29 @@ function extractPositionalsForContext(command) {
 	}));
 }
 /**
-* Get subcommand names from a command
+* Get subcommand names from a command (including aliases)
 */
 function getSubcommandNames(command) {
 	if (!command.subCommands) return [];
-	return Object.keys(command.subCommands).filter((name) => !name.startsWith("__"));
+	const names = [];
+	for (const [name, subCmd] of Object.entries(command.subCommands)) {
+		if (name.startsWith("__")) continue;
+		names.push(name);
+		const meta = require_subcommand_router.resolveSubCommandMeta(subCmd);
+		if (meta?.aliases) names.push(...meta.aliases);
+	}
+	return names;
 }
 /**
-* Resolve subcommand by name
+* Resolve subcommand by name (including alias lookup)
 */
 function resolveSubcommand(command, name) {
 	if (!command.subCommands) return null;
 	const sub = command.subCommands[name];
-	if (!sub) return null;
-	return require_lazy.resolveSubCommandMeta(sub);
+	if (sub) return require_subcommand_router.resolveSubCommandMeta(sub);
+	const canonical = require_subcommand_router.resolveSubCommandAlias(command, name);
+	if (canonical) return require_subcommand_router.resolveSubCommandMeta(command.subCommands[canonical]);
+	return null;
 }
 /**
 * Check if a word is an option (starts with - or --)
@@ -837,8 +888,8 @@ function findOption(options, nameOrAlias) {
 		if (opt.cliName === nameOrAlias) return true;
 		if (opt.alias?.includes(nameOrAlias)) return true;
 		if (nameOrAlias.length > 1) {
-			if (opt.cliName.includes("-") && require_lazy.toCamelCase(opt.cliName) === nameOrAlias) return true;
-			if (opt.alias?.some((a) => a.includes("-") && require_lazy.toCamelCase(a) === nameOrAlias)) return true;
+			if (opt.cliName.includes("-") && require_subcommand_router.toCamelCase(opt.cliName) === nameOrAlias) return true;
+			if (opt.alias?.some((a) => a.includes("-") && require_subcommand_router.toCamelCase(a) === nameOrAlias)) return true;
 		}
 		return false;
 	});
@@ -1057,12 +1108,12 @@ function detectInlinePrefix(currentWord) {
 * Schema for the __complete command
 */
 const completeArgsSchema = zod.z.object({
-	shell: require_lazy.arg(zod.z.enum([
+	shell: require_subcommand_router.arg(zod.z.enum([
 		"bash",
 		"zsh",
 		"fish"
 	]), { description: "Target shell for output formatting" }),
-	args: require_lazy.arg(zod.z.array(zod.z.string()).default([]), {
+	args: require_subcommand_router.arg(zod.z.array(zod.z.string()).default([]), {
 		positional: true,
 		description: "Arguments to complete",
 		variadic: true
@@ -1228,7 +1279,7 @@ function generateSubHandler$1(sub, fn, path) {
 	lines.push(...availableOptionLines$1(sub.options, fn));
 	lines.push(`        return`);
 	lines.push(`    end`);
-	if (visibleSubs.length > 0) for (const s of visibleSubs) {
+	if (visibleSubs.length > 0) for (const s of getSubNamesWithAliases(sub.subcommands)) {
 		const desc = escapeDesc$1(s.description ?? "");
 		lines.push(`    echo "${s.name}\t${desc}"`);
 	}
@@ -1249,6 +1300,10 @@ function optTakesValueCases(sub, parentPath) {
 	for (const child of getVisibleSubs(sub.subcommands)) {
 		const childPath = parentPath ? `${parentPath}:${child.name}` : child.name;
 		lines.push(...optTakesValueCases(child, childPath));
+		if (child.aliases) for (const alias of child.aliases) {
+			const aliasPath = parentPath ? `${parentPath}:${alias}` : alias;
+			lines.push(...optTakesValueCases(child, aliasPath));
+		}
 	}
 	return lines;
 }
@@ -1305,7 +1360,7 @@ function generateFishCompletion(command, options) {
 	lines.push(...availableOptionLines$1(root.options, fn));
 	if (visibleSubs.length > 0) {
 		lines.push(`    else`);
-		for (const s of visibleSubs) {
+		for (const s of getSubNamesWithAliases(root.subcommands)) {
 			const desc = escapeDesc$1(s.description ?? "");
 			lines.push(`        echo "${s.name}\t${desc}"`);
 		}
@@ -1493,7 +1548,7 @@ function generateSubHandler(sub, fn, path) {
 	lines.push(`        return 0`);
 	lines.push(`    fi`);
 	if (visibleSubs.length > 0) {
-		const subItems = visibleSubs.map((s) => {
+		const subItems = getSubNamesWithAliases(sub.subcommands).map((s) => {
 			const desc = s.description ? `:${escapeDesc(s.description)}` : "";
 			return `"${s.name}${desc}"`;
 		}).join(" ");
@@ -1568,7 +1623,7 @@ function generateZshCompletion(command, options) {
 	lines.push(`        __${fn}_cdescribe 'options' _opts`);
 	if (visibleSubs.length > 0) {
 		lines.push(`    else`);
-		const subItems = visibleSubs.map((s) => {
+		const subItems = getSubNamesWithAliases(root.subcommands).map((s) => {
 			const desc = s.description ? `:${escapeDesc(s.description)}` : "";
 			return `"${s.name}${desc}"`;
 		}).join(" ");
@@ -1697,7 +1752,7 @@ function detectShell() {
 * Schema for the completion command arguments
 */
 const completionArgsSchema = zod.z.object({
-	shell: require_lazy.arg(zod.z.enum([
+	shell: require_subcommand_router.arg(zod.z.enum([
 		"bash",
 		"zsh",
 		"fish"
@@ -1706,7 +1761,7 @@ const completionArgsSchema = zod.z.object({
 		description: "Shell type (bash, zsh, or fish)",
 		placeholder: "SHELL"
 	}),
-	instructions: require_lazy.arg(zod.z.boolean().default(false), {
+	instructions: require_subcommand_router.arg(zod.z.boolean().default(false), {
 		alias: "i",
 		description: "Show installation instructions"
 	})
@@ -1882,4 +1937,4 @@ Object.defineProperty(exports, 'withCompletionCommand', {
     return withCompletionCommand;
   }
 });
-//# sourceMappingURL=completion-CAekGYS4.cjs.map
+//# sourceMappingURL=completion-B5fgnUGm.cjs.map