@optique/valibot 1.0.0-dev.1375 → 1.0.0-dev.1390

package/dist/index.cjs

@@ -401,7 +401,17 @@ function valibot$1(schema, options = {}) {
 			};
 		},
 		format(value) {
-			return String(value);
+			if (options.format) return options.format(value);
+			if (value instanceof Date) return Number.isNaN(value.getTime()) ? String(value) : value.toISOString();
+			if (typeof value !== "object" || value === null) return String(value);
+			if (Array.isArray(value)) return String(value);
+			const str = String(value);
+			if (str !== "[object Object]") return str;
+			const proto = Object.getPrototypeOf(value);
+			if (proto === Object.prototype || proto === null) try {
+				return JSON.stringify(value) ?? str;
+			} catch {}
+			return str;
 		}
 	};
 	return parser;

package/dist/index.d.cts

@@ -8,7 +8,7 @@ import * as v from "valibot";
  * Options for creating a Valibot value parser.
  * @since 0.7.0
  */
-interface ValibotParserOptions {
+interface ValibotParserOptions<T = unknown> {
   /**
    * The metavariable name for this parser. This is used in help messages to
    * indicate what kind of value this parser expects. Usually a single
@@ -16,6 +16,18 @@ interface ValibotParserOptions {
    * @default `"VALUE"`
    */
   readonly metavar?: NonEmptyString;
+  /**
+   * Custom formatter for displaying parsed values in help messages.
+   * When not provided, the default formatter is used: primitives use
+   * `String()`, valid `Date` values use `.toISOString()`, and plain
+   * objects use `JSON.stringify()`.  All other objects (arrays, class
+   * instances, etc.) use `String()`.
+   *
+   * @param value The parsed value to format.
+   * @returns A string representation of the value.
+   * @since 1.0.0
+   */
+  readonly format?: (value: T) => string;
   /**
    * Custom error messages for Valibot validation failures.
    */
@@ -111,6 +123,6 @@ interface ValibotParserOptions {
  *   executed synchronously.
  * @since 0.7.0
  */
-declare function valibot<T>(schema: v.BaseSchema<unknown, T, v.BaseIssue<unknown>>, options?: ValibotParserOptions): ValueParser<"sync", T>;
+declare function valibot<T>(schema: v.BaseSchema<unknown, T, v.BaseIssue<unknown>>, options?: ValibotParserOptions<T>): ValueParser<"sync", T>;
 //#endregion
 export { ValibotParserOptions, valibot };

package/dist/index.d.ts

@@ -8,7 +8,7 @@ import { NonEmptyString, ValueParser } from "@optique/core/valueparser";
  * Options for creating a Valibot value parser.
  * @since 0.7.0
  */
-interface ValibotParserOptions {
+interface ValibotParserOptions<T = unknown> {
   /**
    * The metavariable name for this parser. This is used in help messages to
    * indicate what kind of value this parser expects. Usually a single
@@ -16,6 +16,18 @@ interface ValibotParserOptions {
    * @default `"VALUE"`
    */
   readonly metavar?: NonEmptyString;
+  /**
+   * Custom formatter for displaying parsed values in help messages.
+   * When not provided, the default formatter is used: primitives use
+   * `String()`, valid `Date` values use `.toISOString()`, and plain
+   * objects use `JSON.stringify()`.  All other objects (arrays, class
+   * instances, etc.) use `String()`.
+   *
+   * @param value The parsed value to format.
+   * @returns A string representation of the value.
+   * @since 1.0.0
+   */
+  readonly format?: (value: T) => string;
   /**
    * Custom error messages for Valibot validation failures.
    */
@@ -111,6 +123,6 @@ interface ValibotParserOptions {
  *   executed synchronously.
  * @since 0.7.0
  */
-declare function valibot<T>(schema: v.BaseSchema<unknown, T, v.BaseIssue<unknown>>, options?: ValibotParserOptions): ValueParser<"sync", T>;
+declare function valibot<T>(schema: v.BaseSchema<unknown, T, v.BaseIssue<unknown>>, options?: ValibotParserOptions<T>): ValueParser<"sync", T>;
 //#endregion
 export { ValibotParserOptions, valibot };

package/dist/index.js

@@ -378,7 +378,17 @@ function valibot(schema, options = {}) {
 			};
 		},
 		format(value) {
-			return String(value);
+			if (options.format) return options.format(value);
+			if (value instanceof Date) return Number.isNaN(value.getTime()) ? String(value) : value.toISOString();
+			if (typeof value !== "object" || value === null) return String(value);
+			if (Array.isArray(value)) return String(value);
+			const str = String(value);
+			if (str !== "[object Object]") return str;
+			const proto = Object.getPrototypeOf(value);
+			if (proto === Object.prototype || proto === null) try {
+				return JSON.stringify(value) ?? str;
+			} catch {}
+			return str;
 		}
 	};
 	return parser;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/valibot",
-  "version": "1.0.0-dev.1375+69c819ec",
+  "version": "1.0.0-dev.1390+84b0f473",
   "description": "Valibot value parsers for Optique",
   "keywords": [
     "CLI",
@@ -57,7 +57,7 @@
     "valibot": "^1.2.0"
   },
   "dependencies": {
-    "@optique/core": "1.0.0-dev.1375+69c819ec"
+    "@optique/core": "1.0.0-dev.1390+84b0f473"
   },
   "devDependencies": {
     "@types/node": "^20.19.9",