@optique/core 1.3.0-dev.2532 → 1.3.0-dev.2536

package/dist/doc.cjs

@@ -193,7 +193,8 @@ function defaultSectionOrder(a, b) {
 * control characters, or if `maxWidth` is not a finite integer.
 * @throws {RangeError} If any entry needs a description column and `maxWidth`
 * is too small to fit the minimum layout (less than `termIndent + 4`), or if
-* `showChoices.maxItems` is less than `1`.
+* `showChoices.maxItems` is less than `1`, or if a theme color is invalid
+* (even when colors are disabled).
 *
 * @example
 * ```typescript

package/dist/doc.d.cts

@@ -339,7 +339,8 @@ interface DocPageFormatOptions {
  * control characters, or if `maxWidth` is not a finite integer.
  * @throws {RangeError} If any entry needs a description column and `maxWidth`
  * is too small to fit the minimum layout (less than `termIndent + 4`), or if
- * `showChoices.maxItems` is less than `1`.
+ * `showChoices.maxItems` is less than `1`, or if a theme color is invalid
+ * (even when colors are disabled).
  *
  * @example
  * ```typescript

package/dist/doc.d.ts

@@ -339,7 +339,8 @@ interface DocPageFormatOptions {
  * control characters, or if `maxWidth` is not a finite integer.
  * @throws {RangeError} If any entry needs a description column and `maxWidth`
  * is too small to fit the minimum layout (less than `termIndent + 4`), or if
- * `showChoices.maxItems` is less than `1`.
+ * `showChoices.maxItems` is less than `1`, or if a theme color is invalid
+ * (even when colors are disabled).
  *
  * @example
  * ```typescript

package/dist/doc.js

@@ -193,7 +193,8 @@ function defaultSectionOrder(a, b) {
 * control characters, or if `maxWidth` is not a finite integer.
 * @throws {RangeError} If any entry needs a description column and `maxWidth`
 * is too small to fit the minimum layout (less than `termIndent + 4`), or if
-* `showChoices.maxItems` is less than `1`.
+* `showChoices.maxItems` is less than `1`, or if a theme color is invalid
+* (even when colors are disabled).
 *
 * @example
 * ```typescript

package/dist/facade.cjs

@@ -531,9 +531,12 @@ function handleCompletion(completionArgs, programName, parser, completionParser,
 	const callOnCompletion = (code) => onCompletion(code);
 	if (!shellName) {
 		const error = require_message.message`Missing shell name for completion.`;
-		stderr(`${errorLabel()}${formatMessage(error, {
+		const prefix = errorLabel();
+		stderr(`${prefix}${formatMessage(error, {
 			colors,
-			quotes: !colors
+			quotes: !colors,
+			maxWidth,
+			initialWidth: require_displaywidth.getDisplayWidth(prefix.split("\n").at(-1) ?? "")
 		})}\n`);
 		if (completionParser) {
 			const displayName = isOptionMode ? completionOptionDisplayName ?? "--completion" : completionCommandDisplayName ?? "completion";
@@ -562,9 +565,12 @@ function handleCompletion(completionArgs, programName, parser, completionParser,
 			available.push(require_message.value(name));
 		}
 		const error = require_message.message`Unsupported shell ${shellName}. Available shells: ${available}.`;
-		stderr(`${errorLabel()}${formatMessage(error, {
+		const prefix = errorLabel();
+		stderr(`${prefix}${formatMessage(error, {
 			colors,
-			quotes: !colors
+			quotes: !colors,
+			maxWidth,
+			initialWidth: require_displaywidth.getDisplayWidth(prefix.split("\n").at(-1) ?? "")
 		})}`);
 		return require_mode_dispatch.dispatchByMode(parser.mode, () => {
 			const result = callOnError(1, error);
@@ -1051,11 +1057,14 @@ function runParser(parserOrProgram, programNameOrArgs, argsOrOptions, optionsPar
 						maxWidth: maxWidth == null ? void 0 : maxWidth - usageLabelWidth(),
 						expandCommands: true
 					}), usageLabelWidth())}`);
+					const prefix = errorLabel();
 					const errorMessage = formatMessage(validationError, {
+						initialWidth: require_displaywidth.getDisplayWidth(prefix.split("\n").at(-1) ?? ""),
+						maxWidth,
 						colors,
 						quotes: !colors
 					});
-					stderr(`${errorLabel()}${errorMessage}`);
+					stderr(`${prefix}${errorMessage}`);
 					return onError(1, validationError);
 				};
 				const displayHelp = (doc) => {
@@ -1168,11 +1177,14 @@ function runParser(parserOrProgram, programNameOrArgs, argsOrOptions, optionsPar
 						maxWidth: maxWidth == null ? void 0 : maxWidth - usageLabelWidth(),
 						expandCommands: true
 					}), usageLabelWidth())}`);
+					const prefix = errorLabel();
 					const errorMessage = formatMessage(classified.error, {
+						initialWidth: require_displaywidth.getDisplayWidth(prefix.split("\n").at(-1) ?? ""),
+						maxWidth,
 						colors,
 						quotes: !colors
 					});
-					stderr(`${errorLabel()}${errorMessage}`);
+					stderr(`${prefix}${errorMessage}`);
 					return onError(1, classified.error);
 				};
 				if (aboveError === "help") {

package/dist/facade.js

@@ -531,9 +531,12 @@ function handleCompletion(completionArgs, programName, parser, completionParser,
 	const callOnCompletion = (code) => onCompletion(code);
 	if (!shellName) {
 		const error = message`Missing shell name for completion.`;
-		stderr(`${errorLabel()}${formatMessage(error, {
+		const prefix = errorLabel();
+		stderr(`${prefix}${formatMessage(error, {
 			colors,
-			quotes: !colors
+			quotes: !colors,
+			maxWidth,
+			initialWidth: getDisplayWidth(prefix.split("\n").at(-1) ?? "")
 		})}\n`);
 		if (completionParser) {
 			const displayName = isOptionMode ? completionOptionDisplayName ?? "--completion" : completionCommandDisplayName ?? "completion";
@@ -562,9 +565,12 @@ function handleCompletion(completionArgs, programName, parser, completionParser,
 			available.push(value(name));
 		}
 		const error = message`Unsupported shell ${shellName}. Available shells: ${available}.`;
-		stderr(`${errorLabel()}${formatMessage(error, {
+		const prefix = errorLabel();
+		stderr(`${prefix}${formatMessage(error, {
 			colors,
-			quotes: !colors
+			quotes: !colors,
+			maxWidth,
+			initialWidth: getDisplayWidth(prefix.split("\n").at(-1) ?? "")
 		})}`);
 		return dispatchByMode(parser.mode, () => {
 			const result = callOnError(1, error);
@@ -1051,11 +1057,14 @@ function runParser(parserOrProgram, programNameOrArgs, argsOrOptions, optionsPar
 						maxWidth: maxWidth == null ? void 0 : maxWidth - usageLabelWidth(),
 						expandCommands: true
 					}), usageLabelWidth())}`);
+					const prefix = errorLabel();
 					const errorMessage = formatMessage(validationError, {
+						initialWidth: getDisplayWidth(prefix.split("\n").at(-1) ?? ""),
+						maxWidth,
 						colors,
 						quotes: !colors
 					});
-					stderr(`${errorLabel()}${errorMessage}`);
+					stderr(`${prefix}${errorMessage}`);
 					return onError(1, validationError);
 				};
 				const displayHelp = (doc) => {
@@ -1168,11 +1177,14 @@ function runParser(parserOrProgram, programNameOrArgs, argsOrOptions, optionsPar
 						maxWidth: maxWidth == null ? void 0 : maxWidth - usageLabelWidth(),
 						expandCommands: true
 					}), usageLabelWidth())}`);
+					const prefix = errorLabel();
 					const errorMessage = formatMessage(classified.error, {
+						initialWidth: getDisplayWidth(prefix.split("\n").at(-1) ?? ""),
+						maxWidth,
 						colors,
 						quotes: !colors
 					});
-					stderr(`${errorLabel()}${errorMessage}`);
+					stderr(`${prefix}${errorMessage}`);
 					return onError(1, classified.error);
 				};
 				if (aboveError === "help") {

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 = {

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;
 /**

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;
 /**

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 = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "1.3.0-dev.2532",
+  "version": "1.3.0-dev.2536",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",
@@ -237,7 +237,7 @@
   },
   "sideEffects": false,
   "devDependencies": {
-    "@optique/env": "1.3.0-dev.2532+2ec45dbf",
+    "@optique/env": "1.3.0-dev.2536+22f9c880",
     "@types/node": "^24.0.0",
     "fast-check": "^4.7.0",
     "tsdown": "^0.13.0",