@optique/run 1.3.0-dev.2534 → 1.3.0-dev.2536

package/dist/print.cjs

@@ -12,6 +12,8 @@ const __optique_core_internal_terminal = require_rolldown_runtime.__toESM(requir
 *
 * @param message The structured message to print.
 * @param options Optional formatting options to override defaults.
+* @throws {TypeError} If initialWidth is not a finite integer.
+* @throws {RangeError} If initialWidth is negative or a theme color is invalid.
 *
 * @example
 * ```typescript
@@ -71,7 +73,9 @@ function printError(message, options = {}) {
 * operations or when you want to override the automatic terminal detection.
 *
 * @param options Formatting options for the printer.
-* @returns A printer function that can be called with messages.
+* @returns A printer function that can be called with messages. The returned
+* function validates initialWidth and theme colors when formatting a message
+* and can throw the exceptions documented on {@link Printer}.
 *
 * @example
 * ```typescript

package/dist/print.d.cts

@@ -52,6 +52,8 @@ interface PrinterOptions extends MessageFormatOptions {
 /**
  * A printer function that outputs formatted messages.
  * @param message The structured message to print.
+ * @throws {TypeError} If the configured initialWidth is not a finite integer.
+ * @throws {RangeError} If initialWidth is negative or a theme color is invalid.
  * @since 0.3.0
  */
 type Printer = (message: Message) => void;
@@ -64,6 +66,8 @@ type Printer = (message: Message) => void;
  *
  * @param message The structured message to print.
  * @param options Optional formatting options to override defaults.
+ * @throws {TypeError} If initialWidth is not a finite integer.
+ * @throws {RangeError} If initialWidth is negative or a theme color is invalid.
  *
  * @example
  * ```typescript
@@ -119,7 +123,9 @@ declare function printError(message: Message, options?: PrintErrorOptions): void
  * operations or when you want to override the automatic terminal detection.
  *
  * @param options Formatting options for the printer.
- * @returns A printer function that can be called with messages.
+ * @returns A printer function that can be called with messages. The returned
+ * function validates initialWidth and theme colors when formatting a message
+ * and can throw the exceptions documented on {@link Printer}.
  *
  * @example
  * ```typescript

package/dist/print.d.ts

@@ -52,6 +52,8 @@ interface PrinterOptions extends MessageFormatOptions {
 /**
  * A printer function that outputs formatted messages.
  * @param message The structured message to print.
+ * @throws {TypeError} If the configured initialWidth is not a finite integer.
+ * @throws {RangeError} If initialWidth is negative or a theme color is invalid.
  * @since 0.3.0
  */
 type Printer = (message: Message) => void;
@@ -64,6 +66,8 @@ type Printer = (message: Message) => void;
  *
  * @param message The structured message to print.
  * @param options Optional formatting options to override defaults.
+ * @throws {TypeError} If initialWidth is not a finite integer.
+ * @throws {RangeError} If initialWidth is negative or a theme color is invalid.
  *
  * @example
  * ```typescript
@@ -119,7 +123,9 @@ declare function printError(message: Message, options?: PrintErrorOptions): void
  * operations or when you want to override the automatic terminal detection.
  *
  * @param options Formatting options for the printer.
- * @returns A printer function that can be called with messages.
+ * @returns A printer function that can be called with messages. The returned
+ * function validates initialWidth and theme colors when formatting a message
+ * and can throw the exceptions documented on {@link Printer}.
  *
  * @example
  * ```typescript

package/dist/print.js

@@ -11,6 +11,8 @@ import { getDisplayWidth, renderTerminalTerm, resolveMessageFormatter } from "@o
 *
 * @param message The structured message to print.
 * @param options Optional formatting options to override defaults.
+* @throws {TypeError} If initialWidth is not a finite integer.
+* @throws {RangeError} If initialWidth is negative or a theme color is invalid.
 *
 * @example
 * ```typescript
@@ -70,7 +72,9 @@ function printError(message, options = {}) {
 * operations or when you want to override the automatic terminal detection.
 *
 * @param options Formatting options for the printer.
-* @returns A printer function that can be called with messages.
+* @returns A printer function that can be called with messages. The returned
+* function validates initialWidth and theme colors when formatting a message
+* and can throw the exceptions documented on {@link Printer}.
 *
 * @example
 * ```typescript

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/run",
-  "version": "1.3.0-dev.2534",
+  "version": "1.3.0-dev.2536",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",
@@ -76,11 +76,11 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@optique/core": "1.3.0-dev.2534+0daf40ee"
+    "@optique/core": "1.3.0-dev.2536+22f9c880"
   },
   "devDependencies": {
-    "@optique/config": "1.3.0-dev.2534+0daf40ee",
-    "@optique/env": "1.3.0-dev.2534+0daf40ee",
+    "@optique/config": "1.3.0-dev.2536+22f9c880",
+    "@optique/env": "1.3.0-dev.2536+22f9c880",
     "@types/node": "^24.0.0",
     "fast-check": "^4.7.0",
     "tsdown": "^0.13.0",