@optique/core 1.3.0-dev.2530 → 1.3.0-dev.2534

package/dist/facade.cjs

@@ -533,7 +533,8 @@ function handleCompletion(completionArgs, programName, parser, completionParser,
 		const error = require_message.message`Missing shell name for completion.`;
 		stderr(`${errorLabel()}${formatMessage(error, {
 			colors,
-			quotes: !colors
+			quotes: !colors,
+			maxWidth
 		})}\n`);
 		if (completionParser) {
 			const displayName = isOptionMode ? completionOptionDisplayName ?? "--completion" : completionCommandDisplayName ?? "completion";
@@ -564,7 +565,8 @@ function handleCompletion(completionArgs, programName, parser, completionParser,
 		const error = require_message.message`Unsupported shell ${shellName}. Available shells: ${available}.`;
 		stderr(`${errorLabel()}${formatMessage(error, {
 			colors,
-			quotes: !colors
+			quotes: !colors,
+			maxWidth
 		})}`);
 		return require_mode_dispatch.dispatchByMode(parser.mode, () => {
 			const result = callOnError(1, error);
@@ -1052,6 +1054,7 @@ function runParser(parserOrProgram, programNameOrArgs, argsOrOptions, optionsPar
 						expandCommands: true
 					}), usageLabelWidth())}`);
 					const errorMessage = formatMessage(validationError, {
+						maxWidth,
 						colors,
 						quotes: !colors
 					});
@@ -1169,6 +1172,7 @@ function runParser(parserOrProgram, programNameOrArgs, argsOrOptions, optionsPar
 						expandCommands: true
 					}), usageLabelWidth())}`);
 					const errorMessage = formatMessage(classified.error, {
+						maxWidth,
 						colors,
 						quotes: !colors
 					});

package/dist/facade.js

@@ -533,7 +533,8 @@ function handleCompletion(completionArgs, programName, parser, completionParser,
 		const error = message`Missing shell name for completion.`;
 		stderr(`${errorLabel()}${formatMessage(error, {
 			colors,
-			quotes: !colors
+			quotes: !colors,
+			maxWidth
 		})}\n`);
 		if (completionParser) {
 			const displayName = isOptionMode ? completionOptionDisplayName ?? "--completion" : completionCommandDisplayName ?? "completion";
@@ -564,7 +565,8 @@ function handleCompletion(completionArgs, programName, parser, completionParser,
 		const error = message`Unsupported shell ${shellName}. Available shells: ${available}.`;
 		stderr(`${errorLabel()}${formatMessage(error, {
 			colors,
-			quotes: !colors
+			quotes: !colors,
+			maxWidth
 		})}`);
 		return dispatchByMode(parser.mode, () => {
 			const result = callOnError(1, error);
@@ -1052,6 +1054,7 @@ function runParser(parserOrProgram, programNameOrArgs, argsOrOptions, optionsPar
 						expandCommands: true
 					}), usageLabelWidth())}`);
 					const errorMessage = formatMessage(validationError, {
+						maxWidth,
 						colors,
 						quotes: !colors
 					});
@@ -1169,6 +1172,7 @@ function runParser(parserOrProgram, programNameOrArgs, argsOrOptions, optionsPar
 						expandCommands: true
 					}), usageLabelWidth())}`);
 					const errorMessage = formatMessage(classified.error, {
+						maxWidth,
 						colors,
 						quotes: !colors
 					});

package/dist/terminal-internal.cjs

@@ -8,6 +8,15 @@ function terminalText(text) {
 		text
 	};
 }
+function valuesFormatter(theme) {
+	if (theme.values != null && theme.values !== require_terminal.defaultTerminalTheme.values) return theme.values;
+	if (theme.value != null && theme.value !== require_terminal.defaultTerminalTheme.value) return require_terminal.defaultTerminalTheme.values;
+	return (term, context) => ({
+		type: "style",
+		style: { foreground: "green" },
+		children: [require_terminal.defaultTerminalTheme.values(term, context)]
+	});
+}
 function formatTerminalTerm(term, theme = {}, quotes = false, usage) {
 	const quote = (s) => quotes ? `\`${s}\`` : s;
 	let text;
@@ -61,7 +70,7 @@ function formatTerminalTerm(term, theme = {}, quotes = false, usage) {
 		case "optionNames": return (theme.optionNames ?? require_terminal.defaultTerminalTheme.optionNames)(term, ctx);
 		case "metavar": return (theme.metavar ?? require_terminal.defaultTerminalTheme.metavar)(term, ctx);
 		case "value": return (theme.value ?? require_terminal.defaultTerminalTheme.value)(term, ctx);
-		case "values": return (theme.values ?? require_terminal.defaultTerminalTheme.values)(term, ctx);
+		case "values": return valuesFormatter(theme)(term, ctx);
 		case "envVar": return (theme.envVar ?? require_terminal.defaultTerminalTheme.envVar)(term, ctx);
 		case "commandLine": return (theme.commandLine ?? require_terminal.defaultTerminalTheme.commandLine)(term, ctx);
 		case "url": return (theme.url ?? require_terminal.defaultTerminalTheme.url)(term, ctx);
@@ -234,7 +243,7 @@ function cacheTerminalTheme(theme = {}) {
 		optionNames: cache(theme.optionNames ?? require_terminal.defaultTerminalTheme.optionNames),
 		metavar: cache(theme.metavar ?? require_terminal.defaultTerminalTheme.metavar),
 		value: cache(theme.value ?? require_terminal.defaultTerminalTheme.value),
-		values: cache(theme.values ?? require_terminal.defaultTerminalTheme.values),
+		values: cache(valuesFormatter(theme)),
 		envVar: cache(theme.envVar ?? require_terminal.defaultTerminalTheme.envVar),
 		commandLine: cache(theme.commandLine ?? require_terminal.defaultTerminalTheme.commandLine),
 		url: cache(theme.url ?? require_terminal.defaultTerminalTheme.url),

package/dist/terminal-internal.js

@@ -8,6 +8,15 @@ function terminalText(text) {
 		text
 	};
 }
+function valuesFormatter(theme) {
+	if (theme.values != null && theme.values !== defaultTerminalTheme.values) return theme.values;
+	if (theme.value != null && theme.value !== defaultTerminalTheme.value) return defaultTerminalTheme.values;
+	return (term, context) => ({
+		type: "style",
+		style: { foreground: "green" },
+		children: [defaultTerminalTheme.values(term, context)]
+	});
+}
 function formatTerminalTerm(term, theme = {}, quotes = false, usage) {
 	const quote = (s) => quotes ? `\`${s}\`` : s;
 	let text;
@@ -61,7 +70,7 @@ function formatTerminalTerm(term, theme = {}, quotes = false, usage) {
 		case "optionNames": return (theme.optionNames ?? defaultTerminalTheme.optionNames)(term, ctx);
 		case "metavar": return (theme.metavar ?? defaultTerminalTheme.metavar)(term, ctx);
 		case "value": return (theme.value ?? defaultTerminalTheme.value)(term, ctx);
-		case "values": return (theme.values ?? defaultTerminalTheme.values)(term, ctx);
+		case "values": return valuesFormatter(theme)(term, ctx);
 		case "envVar": return (theme.envVar ?? defaultTerminalTheme.envVar)(term, ctx);
 		case "commandLine": return (theme.commandLine ?? defaultTerminalTheme.commandLine)(term, ctx);
 		case "url": return (theme.url ?? defaultTerminalTheme.url)(term, ctx);
@@ -234,7 +243,7 @@ function cacheTerminalTheme(theme = {}) {
 		optionNames: cache(theme.optionNames ?? defaultTerminalTheme.optionNames),
 		metavar: cache(theme.metavar ?? defaultTerminalTheme.metavar),
 		value: cache(theme.value ?? defaultTerminalTheme.value),
-		values: cache(theme.values ?? defaultTerminalTheme.values),
+		values: cache(valuesFormatter(theme)),
 		envVar: cache(theme.envVar ?? defaultTerminalTheme.envVar),
 		commandLine: cache(theme.commandLine ?? defaultTerminalTheme.commandLine),
 		url: cache(theme.url ?? defaultTerminalTheme.url),

package/dist/terminal.cjs

@@ -33,8 +33,7 @@ const defaultTerminalTheme = {
 	} : styled(ctx.text, ctx.usage === "argument" ? { underline: true } : { bold: true }),
 	value: (_term, ctx) => ctx.usage === "literal" ? plain(ctx.text) : styled(ctx.text, { foreground: "green" }),
 	values: (term, ctx) => ({
-		type: "style",
-		style: { foreground: "green" },
+		type: "concat",
 		children: term.values.flatMap((value, i) => [...i === 0 ? [] : [plain(" ")], ctx.format({
 			type: "value",
 			value

package/dist/terminal.js

@@ -32,8 +32,7 @@ const defaultTerminalTheme = {
 	} : styled(ctx.text, ctx.usage === "argument" ? { underline: true } : { bold: true }),
 	value: (_term, ctx) => ctx.usage === "literal" ? plain(ctx.text) : styled(ctx.text, { foreground: "green" }),
 	values: (term, ctx) => ({
-		type: "style",
-		style: { foreground: "green" },
+		type: "concat",
 		children: term.values.flatMap((value, i) => [...i === 0 ? [] : [plain(" ")], ctx.format({
 			type: "value",
 			value

package/dist/usage.cjs

@@ -181,6 +181,8 @@ function extractArgumentMetavars(usage) {
 * @returns A formatted string representation of the usage description.
 * @throws {TypeError} If `programName` is not a string, is empty,
 *         whitespace-only, or contains control characters.
+* @throws {RangeError} If a theme supplies an invalid RGB channel or palette
+*                      index, even when colors are disabled.
 */
 function formatUsage(programName, usage, options = {}) {
 	options = {
@@ -468,6 +470,8 @@ function* formatUsageTerms(terms, options) {
 * @param options Optional formatting options to customize the output.
 *                See {@link UsageTermFormatOptions} for available options.
 * @returns A formatted string representation of the usage term.
+* @throws {RangeError} If a theme supplies an invalid RGB channel or palette
+*                      index, even when colors are disabled.
 */
 function formatUsageTerm(term, options = {}) {
 	options = {

package/dist/usage.d.cts

@@ -393,6 +393,8 @@ interface UsageFormatOptions {
  * @returns A formatted string representation of the usage description.
  * @throws {TypeError} If `programName` is not a string, is empty,
  *         whitespace-only, or contains control characters.
+ * @throws {RangeError} If a theme supplies an invalid RGB channel or palette
+ *                      index, even when colors are disabled.
  */
 declare function formatUsage(programName: string, usage: Usage, options?: UsageFormatOptions): string;
 /**
@@ -483,6 +485,8 @@ interface UsageTermFormatOptions extends UsageFormatOptions {
  * @param options Optional formatting options to customize the output.
  *                See {@link UsageTermFormatOptions} for available options.
  * @returns A formatted string representation of the usage term.
+ * @throws {RangeError} If a theme supplies an invalid RGB channel or palette
+ *                      index, even when colors are disabled.
  */
 declare function formatUsageTerm(term: UsageTerm, options?: UsageTermFormatOptions): string;
 //#endregion

package/dist/usage.d.ts

@@ -393,6 +393,8 @@ interface UsageFormatOptions {
  * @returns A formatted string representation of the usage description.
  * @throws {TypeError} If `programName` is not a string, is empty,
  *         whitespace-only, or contains control characters.
+ * @throws {RangeError} If a theme supplies an invalid RGB channel or palette
+ *                      index, even when colors are disabled.
  */
 declare function formatUsage(programName: string, usage: Usage, options?: UsageFormatOptions): string;
 /**
@@ -483,6 +485,8 @@ interface UsageTermFormatOptions extends UsageFormatOptions {
  * @param options Optional formatting options to customize the output.
  *                See {@link UsageTermFormatOptions} for available options.
  * @returns A formatted string representation of the usage term.
+ * @throws {RangeError} If a theme supplies an invalid RGB channel or palette
+ *                      index, even when colors are disabled.
  */
 declare function formatUsageTerm(term: UsageTerm, options?: UsageTermFormatOptions): string;
 //#endregion

package/dist/usage.js

@@ -181,6 +181,8 @@ function extractArgumentMetavars(usage) {
 * @returns A formatted string representation of the usage description.
 * @throws {TypeError} If `programName` is not a string, is empty,
 *         whitespace-only, or contains control characters.
+* @throws {RangeError} If a theme supplies an invalid RGB channel or palette
+*                      index, even when colors are disabled.
 */
 function formatUsage(programName, usage, options = {}) {
 	options = {
@@ -468,6 +470,8 @@ function* formatUsageTerms(terms, options) {
 * @param options Optional formatting options to customize the output.
 *                See {@link UsageTermFormatOptions} for available options.
 * @returns A formatted string representation of the usage term.
+* @throws {RangeError} If a theme supplies an invalid RGB channel or palette
+*                      index, even when colors are disabled.
 */
 function formatUsageTerm(term, options = {}) {
 	options = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "1.3.0-dev.2530",
+  "version": "1.3.0-dev.2534",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",
@@ -237,7 +237,7 @@
   },
   "sideEffects": false,
   "devDependencies": {
-    "@optique/env": "1.3.0-dev.2530+970f0e16",
+    "@optique/env": "1.3.0-dev.2534+0daf40ee",
     "@types/node": "^24.0.0",
     "fast-check": "^4.7.0",
     "tsdown": "^0.13.0",