@optique/core 0.6.0-dev.102 → 0.6.0-dev.103

package/dist/facade.cjs

@@ -264,7 +264,7 @@ function classifyResult(result, args) {
 * Handles shell completion requests.
 * @since 0.6.0
 */
-function handleCompletion(completionArgs, programName, parser, stdout, stderr, onCompletion, onError, colors) {
+function handleCompletion(completionArgs, programName, parser, stdout, stderr, onCompletion, onError, availableShells, colors) {
 	if (completionArgs.length === 0) {
 		stderr("Error: Missing shell name for completion.\n");
 		stderr("Usage: " + programName + " completion <shell> [args...]\n");
@@ -272,12 +272,6 @@ function handleCompletion(completionArgs, programName, parser, stdout, stderr, o
 	}
 	const shellName = completionArgs[0];
 	const args = completionArgs.slice(1);
-	const availableShells = {
-		bash: require_completion.bash,
-		fish: require_completion.fish,
-		pwsh: require_completion.pwsh,
-		zsh: require_completion.zsh
-	};
 	const shell = availableShells[shellName];
 	if (!shell) {
 		const available = [];
@@ -340,17 +334,27 @@ function run(parser, programName, args, options = {}) {
 	const completionMode = options.completion?.mode ?? "both";
 	const onCompletion = options.completion?.onShow ?? (() => ({}));
 	if (options.completion) {
-		if ((completionMode === "command" || completionMode === "both") && args.length >= 1 && args[0] === "completion") return handleCompletion(args.slice(1), programName, parser, stdout, stderr, onCompletion, onError, colors);
+		const defaultShells = {
+			bash: require_completion.bash,
+			fish: require_completion.fish,
+			pwsh: require_completion.pwsh,
+			zsh: require_completion.zsh
+		};
+		const availableShells = options.completion.shells ? {
+			...defaultShells,
+			...options.completion.shells
+		} : defaultShells;
+		if ((completionMode === "command" || completionMode === "both") && args.length >= 1 && args[0] === "completion") return handleCompletion(args.slice(1), programName, parser, stdout, stderr, onCompletion, onError, availableShells, colors);
 		if (completionMode === "option" || completionMode === "both") for (let i = 0; i < args.length; i++) {
 			const arg = args[i];
 			if (arg.startsWith("--completion=")) {
 				const shell = arg.slice(13);
 				const completionArgs = args.slice(i + 1);
-				return handleCompletion([shell, ...completionArgs], programName, parser, stdout, stderr, onCompletion, onError, colors);
+				return handleCompletion([shell, ...completionArgs], programName, parser, stdout, stderr, onCompletion, onError, availableShells, colors);
 			} else if (arg === "--completion" && i + 1 < args.length) {
 				const shell = args[i + 1];
 				const completionArgs = args.slice(i + 2);
-				return handleCompletion([shell, ...completionArgs], programName, parser, stdout, stderr, onCompletion, onError, colors);
+				return handleCompletion([shell, ...completionArgs], programName, parser, stdout, stderr, onCompletion, onError, availableShells, colors);
 			}
 		}
 	}

package/dist/facade.d.cts

@@ -1,6 +1,7 @@
 import { Message } from "./message.cjs";
 import { ShowDefaultOptions } from "./doc.cjs";
 import { InferValue, Parser } from "./parser.cjs";
+import { ShellCompletion } from "./completion.cjs";
 
 //#region src/facade.d.ts
 
@@ -103,6 +104,14 @@ interface RunOptions<THelp, TError> {
      * @default `"both"`
      */
     readonly mode?: "command" | "option" | "both";
+    /**
+     * Available shell completions. By default, includes `bash`, `fish`, `pwsh`,
+     * and `zsh`. You can provide additional custom shell completions or override
+     * the defaults.
+     *
+     * @default `{ bash, fish, pwsh, zsh }`
+     */
+    readonly shells?: Record<string, ShellCompletion>;
     /**
      * Callback function invoked when completion is requested. The function can
      * optionally receive an exit code parameter.

package/dist/facade.d.ts

@@ -1,6 +1,7 @@
 import { Message } from "./message.js";
 import { ShowDefaultOptions } from "./doc.js";
 import { InferValue, Parser } from "./parser.js";
+import { ShellCompletion } from "./completion.js";
 
 //#region src/facade.d.ts
 
@@ -103,6 +104,14 @@ interface RunOptions<THelp, TError> {
      * @default `"both"`
      */
     readonly mode?: "command" | "option" | "both";
+    /**
+     * Available shell completions. By default, includes `bash`, `fish`, `pwsh`,
+     * and `zsh`. You can provide additional custom shell completions or override
+     * the defaults.
+     *
+     * @default `{ bash, fish, pwsh, zsh }`
+     */
+    readonly shells?: Record<string, ShellCompletion>;
     /**
      * Callback function invoked when completion is requested. The function can
      * optionally receive an exit code parameter.

package/dist/facade.js

@@ -264,7 +264,7 @@ function classifyResult(result, args) {
 * Handles shell completion requests.
 * @since 0.6.0
 */
-function handleCompletion(completionArgs, programName, parser, stdout, stderr, onCompletion, onError, colors) {
+function handleCompletion(completionArgs, programName, parser, stdout, stderr, onCompletion, onError, availableShells, colors) {
 	if (completionArgs.length === 0) {
 		stderr("Error: Missing shell name for completion.\n");
 		stderr("Usage: " + programName + " completion <shell> [args...]\n");
@@ -272,12 +272,6 @@ function handleCompletion(completionArgs, programName, parser, stdout, stderr, o
 	}
 	const shellName = completionArgs[0];
 	const args = completionArgs.slice(1);
-	const availableShells = {
-		bash,
-		fish,
-		pwsh,
-		zsh
-	};
 	const shell = availableShells[shellName];
 	if (!shell) {
 		const available = [];
@@ -340,17 +334,27 @@ function run(parser, programName, args, options = {}) {
 	const completionMode = options.completion?.mode ?? "both";
 	const onCompletion = options.completion?.onShow ?? (() => ({}));
 	if (options.completion) {
-		if ((completionMode === "command" || completionMode === "both") && args.length >= 1 && args[0] === "completion") return handleCompletion(args.slice(1), programName, parser, stdout, stderr, onCompletion, onError, colors);
+		const defaultShells = {
+			bash,
+			fish,
+			pwsh,
+			zsh
+		};
+		const availableShells = options.completion.shells ? {
+			...defaultShells,
+			...options.completion.shells
+		} : defaultShells;
+		if ((completionMode === "command" || completionMode === "both") && args.length >= 1 && args[0] === "completion") return handleCompletion(args.slice(1), programName, parser, stdout, stderr, onCompletion, onError, availableShells, colors);
 		if (completionMode === "option" || completionMode === "both") for (let i = 0; i < args.length; i++) {
 			const arg = args[i];
 			if (arg.startsWith("--completion=")) {
 				const shell = arg.slice(13);
 				const completionArgs = args.slice(i + 1);
-				return handleCompletion([shell, ...completionArgs], programName, parser, stdout, stderr, onCompletion, onError, colors);
+				return handleCompletion([shell, ...completionArgs], programName, parser, stdout, stderr, onCompletion, onError, availableShells, colors);
 			} else if (arg === "--completion" && i + 1 < args.length) {
 				const shell = args[i + 1];
 				const completionArgs = args.slice(i + 2);
-				return handleCompletion([shell, ...completionArgs], programName, parser, stdout, stderr, onCompletion, onError, colors);
+				return handleCompletion([shell, ...completionArgs], programName, parser, stdout, stderr, onCompletion, onError, availableShells, colors);
 			}
 		}
 	}

package/dist/index.d.cts

@@ -6,6 +6,6 @@ import { MultipleErrorOptions, MultipleOptions, WithDefaultError, WithDefaultOpt
 import { ArgumentErrorOptions, ArgumentOptions, CommandErrorOptions, CommandOptions, FlagErrorOptions, FlagOptions, OptionErrorOptions, OptionOptions, argument, command, constant, flag, option } from "./primitives.cjs";
 import { DocState, InferValue, Parser, ParserContext, ParserResult, Result, Suggestion, getDocPage, parse, suggest } from "./parser.cjs";
 import { LongestMatchErrorOptions, LongestMatchOptions, ObjectErrorOptions, ObjectOptions, OrErrorOptions, OrOptions, concat, group, longestMatch, merge, object, or, tuple } from "./constructs.cjs";
-import { RunError, RunOptions, run } from "./facade.cjs";
 import { ShellCompletion, bash, fish, pwsh, zsh } from "./completion.cjs";
+import { RunError, RunOptions, run } from "./facade.cjs";
 export { ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, CommandErrorOptions, CommandOptions, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, FlagErrorOptions, FlagOptions, FloatOptions, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, LocaleOptions, LongestMatchErrorOptions, LongestMatchOptions, Message, MessageFormatOptions, MessageTerm, MultipleErrorOptions, MultipleOptions, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionName, OptionOptions, OrErrorOptions, OrOptions, Parser, ParserContext, ParserResult, Result, RunError, RunOptions, ShellCompletion, ShowDefaultOptions, StringOptions, Suggestion, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, WithDefaultError, WithDefaultOptions, argument, bash, choice, command, concat, constant, envVar, fish, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getDocPage, group, integer, isValueParser, locale, longestMatch, map, merge, message, metavar, multiple, normalizeUsage, object, option, optionName, optionNames, optional, or, parse, pwsh, run, string, suggest, text, tuple, url, uuid, value, values, withDefault, zsh };

package/dist/index.d.ts

@@ -6,6 +6,6 @@ import { MultipleErrorOptions, MultipleOptions, WithDefaultError, WithDefaultOpt
 import { ArgumentErrorOptions, ArgumentOptions, CommandErrorOptions, CommandOptions, FlagErrorOptions, FlagOptions, OptionErrorOptions, OptionOptions, argument, command, constant, flag, option } from "./primitives.js";
 import { DocState, InferValue, Parser, ParserContext, ParserResult, Result, Suggestion, getDocPage, parse, suggest } from "./parser.js";
 import { LongestMatchErrorOptions, LongestMatchOptions, ObjectErrorOptions, ObjectOptions, OrErrorOptions, OrOptions, concat, group, longestMatch, merge, object, or, tuple } from "./constructs.js";
-import { RunError, RunOptions, run } from "./facade.js";
 import { ShellCompletion, bash, fish, pwsh, zsh } from "./completion.js";
+import { RunError, RunOptions, run } from "./facade.js";
 export { ArgumentErrorOptions, ArgumentOptions, ChoiceOptions, CommandErrorOptions, CommandOptions, DocEntry, DocFragment, DocFragments, DocPage, DocPageFormatOptions, DocSection, DocState, FlagErrorOptions, FlagOptions, FloatOptions, InferValue, IntegerOptionsBigInt, IntegerOptionsNumber, LocaleOptions, LongestMatchErrorOptions, LongestMatchOptions, Message, MessageFormatOptions, MessageTerm, MultipleErrorOptions, MultipleOptions, ObjectErrorOptions, ObjectOptions, OptionErrorOptions, OptionName, OptionOptions, OrErrorOptions, OrOptions, Parser, ParserContext, ParserResult, Result, RunError, RunOptions, ShellCompletion, ShowDefaultOptions, StringOptions, Suggestion, UrlOptions, Usage, UsageFormatOptions, UsageTerm, UsageTermFormatOptions, Uuid, UuidOptions, ValueParser, ValueParserResult, WithDefaultError, WithDefaultOptions, argument, bash, choice, command, concat, constant, envVar, fish, flag, float, formatDocPage, formatMessage, formatUsage, formatUsageTerm, getDocPage, group, integer, isValueParser, locale, longestMatch, map, merge, message, metavar, multiple, normalizeUsage, object, option, optionName, optionNames, optional, or, parse, pwsh, run, string, suggest, text, tuple, url, uuid, value, values, withDefault, zsh };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "0.6.0-dev.102+50615c18",
+  "version": "0.6.0-dev.103+6fd54c1c",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",