@optique/temporal 0.5.0-dev.79 → 0.5.0-dev.82

package/dist/index.cjs

@@ -49,7 +49,7 @@ function instant(options = {}) {
 			} catch {
 				return {
 					success: false,
-					error: __optique_core_message.message`Invalid instant: ${input}. Expected ISO 8601 format like ${"2020-01-23T17:04:36Z"}.`
+					error: options.errors?.invalidFormat ? typeof options.errors.invalidFormat === "function" ? options.errors.invalidFormat(input) : options.errors.invalidFormat : __optique_core_message.message`Invalid instant: ${input}. Expected ISO 8601 format like ${"2020-01-23T17:04:36Z"}.`
 				};
 			}
 		},
@@ -83,7 +83,7 @@ function duration(options = {}) {
 			} catch {
 				return {
 					success: false,
-					error: __optique_core_message.message`Invalid duration: ${input}. Expected ISO 8601 format like ${"PT1H30M"}.`
+					error: options.errors?.invalidFormat ? typeof options.errors.invalidFormat === "function" ? options.errors.invalidFormat(input) : options.errors.invalidFormat : __optique_core_message.message`Invalid duration: ${input}. Expected ISO 8601 format like ${"PT1H30M"}.`
 				};
 			}
 		},
@@ -116,7 +116,7 @@ function zonedDateTime(options = {}) {
 			} catch {
 				return {
 					success: false,
-					error: __optique_core_message.message`Invalid zoned datetime: ${input}. Expected ISO 8601 format with timezone like ${"2020-01-23T17:04:36+01:00[Europe/Paris]"}.`
+					error: options.errors?.invalidFormat ? typeof options.errors.invalidFormat === "function" ? options.errors.invalidFormat(input) : options.errors.invalidFormat : __optique_core_message.message`Invalid zoned datetime: ${input}. Expected ISO 8601 format with timezone like ${"2020-01-23T17:04:36+01:00[Europe/Paris]"}.`
 				};
 			}
 		},
@@ -149,7 +149,7 @@ function plainDate(options = {}) {
 			} catch {
 				return {
 					success: false,
-					error: __optique_core_message.message`Invalid date: ${input}. Expected ISO 8601 format like ${"2020-01-23"}.`
+					error: options.errors?.invalidFormat ? typeof options.errors.invalidFormat === "function" ? options.errors.invalidFormat(input) : options.errors.invalidFormat : __optique_core_message.message`Invalid date: ${input}. Expected ISO 8601 format like ${"2020-01-23"}.`
 				};
 			}
 		},
@@ -182,7 +182,7 @@ function plainTime(options = {}) {
 			} catch {
 				return {
 					success: false,
-					error: __optique_core_message.message`Invalid time: ${input}. Expected ISO 8601 format like ${"17:04:36"}.`
+					error: options.errors?.invalidFormat ? typeof options.errors.invalidFormat === "function" ? options.errors.invalidFormat(input) : options.errors.invalidFormat : __optique_core_message.message`Invalid time: ${input}. Expected ISO 8601 format like ${"17:04:36"}.`
 				};
 			}
 		},
@@ -215,7 +215,7 @@ function plainDateTime(options = {}) {
 			} catch {
 				return {
 					success: false,
-					error: __optique_core_message.message`Invalid datetime: ${input}. Expected ISO 8601 format like ${"2020-01-23T17:04:36"}.`
+					error: options.errors?.invalidFormat ? typeof options.errors.invalidFormat === "function" ? options.errors.invalidFormat(input) : options.errors.invalidFormat : __optique_core_message.message`Invalid datetime: ${input}. Expected ISO 8601 format like ${"2020-01-23T17:04:36"}.`
 				};
 			}
 		},
@@ -248,7 +248,7 @@ function plainYearMonth(options = {}) {
 			} catch {
 				return {
 					success: false,
-					error: __optique_core_message.message`Invalid year-month: ${input}. Expected ISO 8601 format like ${"2020-01"}.`
+					error: options.errors?.invalidFormat ? typeof options.errors.invalidFormat === "function" ? options.errors.invalidFormat(input) : options.errors.invalidFormat : __optique_core_message.message`Invalid year-month: ${input}. Expected ISO 8601 format like ${"2020-01"}.`
 				};
 			}
 		},
@@ -281,7 +281,7 @@ function plainMonthDay(options = {}) {
 			} catch {
 				return {
 					success: false,
-					error: __optique_core_message.message`Invalid month-day: ${input}. Expected ISO 8601 format like ${"--01-23"}.`
+					error: options.errors?.invalidFormat ? typeof options.errors.invalidFormat === "function" ? options.errors.invalidFormat(input) : options.errors.invalidFormat : __optique_core_message.message`Invalid month-day: ${input}. Expected ISO 8601 format like ${"--01-23"}.`
 				};
 			}
 		},
@@ -321,7 +321,7 @@ function timeZone(options = {}) {
 			} catch {
 				return {
 					success: false,
-					error: __optique_core_message.message`Invalid timezone identifier: ${input}. Must be a valid IANA timezone like "Asia/Seoul" or "UTC".`
+					error: options.errors?.invalidFormat ? typeof options.errors.invalidFormat === "function" ? options.errors.invalidFormat(input) : options.errors.invalidFormat : __optique_core_message.message`Invalid timezone identifier: ${input}. Must be a valid IANA timezone like "Asia/Seoul" or "UTC".`
 				};
 			}
 		},

package/dist/index.d.cts

@@ -1,4 +1,5 @@
 import { ValueParser } from "@optique/core/valueparser";
+import { Message } from "@optique/core/message";
 
 //#region src/index.d.ts
 
@@ -31,6 +32,18 @@ interface InstantOptions {
    * @default `"TIMESTAMP"`
    */
   readonly metavar?: string;
+  /**
+   * Custom error messages for instant parsing failures.
+   * @since 0.5.0
+   */
+  readonly errors?: {
+    /**
+     * Custom error message when input is not a valid instant format.
+     * Can be a static message or a function that receives the input.
+     * @since 0.5.0
+     */
+    invalidFormat?: Message | ((input: string) => Message);
+  };
 }
 /**
  * Options for creating a duration parser.
@@ -43,6 +56,18 @@ interface DurationOptions {
    * @default `"DURATION"`
    */
   readonly metavar?: string;
+  /**
+   * Custom error messages for duration parsing failures.
+   * @since 0.5.0
+   */
+  readonly errors?: {
+    /**
+     * Custom error message when input is not a valid duration format.
+     * Can be a static message or a function that receives the input.
+     * @since 0.5.0
+     */
+    invalidFormat?: Message | ((input: string) => Message);
+  };
 }
 /**
  * Options for creating a zoned datetime parser.
@@ -55,6 +80,18 @@ interface ZonedDateTimeOptions {
    * @default `"ZONED_DATETIME"`
    */
   readonly metavar?: string;
+  /**
+   * Custom error messages for zoned datetime parsing failures.
+   * @since 0.5.0
+   */
+  readonly errors?: {
+    /**
+     * Custom error message when input is not a valid zoned datetime format.
+     * Can be a static message or a function that receives the input.
+     * @since 0.5.0
+     */
+    invalidFormat?: Message | ((input: string) => Message);
+  };
 }
 /**
  * Options for creating a plain date parser.
@@ -67,6 +104,18 @@ interface PlainDateOptions {
    * @default `"DATE"`
    */
   readonly metavar?: string;
+  /**
+   * Custom error messages for plain date parsing failures.
+   * @since 0.5.0
+   */
+  readonly errors?: {
+    /**
+     * Custom error message when input is not a valid date format.
+     * Can be a static message or a function that receives the input.
+     * @since 0.5.0
+     */
+    invalidFormat?: Message | ((input: string) => Message);
+  };
 }
 /**
  * Options for creating a plain time parser.
@@ -79,6 +128,18 @@ interface PlainTimeOptions {
    * @default `"TIME"`
    */
   readonly metavar?: string;
+  /**
+   * Custom error messages for plain time parsing failures.
+   * @since 0.5.0
+   */
+  readonly errors?: {
+    /**
+     * Custom error message when input is not a valid time format.
+     * Can be a static message or a function that receives the input.
+     * @since 0.5.0
+     */
+    invalidFormat?: Message | ((input: string) => Message);
+  };
 }
 /**
  * Options for creating a plain datetime parser.
@@ -91,6 +152,18 @@ interface PlainDateTimeOptions {
    * @default `"DATETIME"`
    */
   readonly metavar?: string;
+  /**
+   * Custom error messages for plain datetime parsing failures.
+   * @since 0.5.0
+   */
+  readonly errors?: {
+    /**
+     * Custom error message when input is not a valid datetime format.
+     * Can be a static message or a function that receives the input.
+     * @since 0.5.0
+     */
+    invalidFormat?: Message | ((input: string) => Message);
+  };
 }
 /**
  * Options for creating a plain year-month parser.
@@ -103,6 +176,18 @@ interface PlainYearMonthOptions {
    * @default `"YEAR-MONTH"`
    */
   readonly metavar?: string;
+  /**
+   * Custom error messages for plain year-month parsing failures.
+   * @since 0.5.0
+   */
+  readonly errors?: {
+    /**
+     * Custom error message when input is not a valid year-month format.
+     * Can be a static message or a function that receives the input.
+     * @since 0.5.0
+     */
+    invalidFormat?: Message | ((input: string) => Message);
+  };
 }
 /**
  * Options for creating a plain month-day parser.
@@ -115,6 +200,18 @@ interface PlainMonthDayOptions {
    * @default `"--MONTH-DAY"`
    */
   readonly metavar?: string;
+  /**
+   * Custom error messages for plain month-day parsing failures.
+   * @since 0.5.0
+   */
+  readonly errors?: {
+    /**
+     * Custom error message when input is not a valid month-day format.
+     * Can be a static message or a function that receives the input.
+     * @since 0.5.0
+     */
+    invalidFormat?: Message | ((input: string) => Message);
+  };
 }
 /**
  * Options for creating a timezone parser.
@@ -127,6 +224,18 @@ interface TimeZoneOptions {
    * @default `"TIMEZONE"`
    */
   readonly metavar?: string;
+  /**
+   * Custom error messages for timezone parsing failures.
+   * @since 0.5.0
+   */
+  readonly errors?: {
+    /**
+     * Custom error message when input is not a valid timezone identifier.
+     * Can be a static message or a function that receives the input.
+     * @since 0.5.0
+     */
+    invalidFormat?: Message | ((input: string) => Message);
+  };
 }
 /**
  * Creates a ValueParser for parsing Temporal.Instant from ISO 8601 strings.

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { Temporal } from "@js-temporal/polyfill";
+import { Message } from "@optique/core/message";
 import { ValueParser } from "@optique/core/valueparser";
 
 //#region src/index.d.ts
@@ -32,6 +33,18 @@ interface InstantOptions {
    * @default `"TIMESTAMP"`
    */
   readonly metavar?: string;
+  /**
+   * Custom error messages for instant parsing failures.
+   * @since 0.5.0
+   */
+  readonly errors?: {
+    /**
+     * Custom error message when input is not a valid instant format.
+     * Can be a static message or a function that receives the input.
+     * @since 0.5.0
+     */
+    invalidFormat?: Message | ((input: string) => Message);
+  };
 }
 /**
  * Options for creating a duration parser.
@@ -44,6 +57,18 @@ interface DurationOptions {
    * @default `"DURATION"`
    */
   readonly metavar?: string;
+  /**
+   * Custom error messages for duration parsing failures.
+   * @since 0.5.0
+   */
+  readonly errors?: {
+    /**
+     * Custom error message when input is not a valid duration format.
+     * Can be a static message or a function that receives the input.
+     * @since 0.5.0
+     */
+    invalidFormat?: Message | ((input: string) => Message);
+  };
 }
 /**
  * Options for creating a zoned datetime parser.
@@ -56,6 +81,18 @@ interface ZonedDateTimeOptions {
    * @default `"ZONED_DATETIME"`
    */
   readonly metavar?: string;
+  /**
+   * Custom error messages for zoned datetime parsing failures.
+   * @since 0.5.0
+   */
+  readonly errors?: {
+    /**
+     * Custom error message when input is not a valid zoned datetime format.
+     * Can be a static message or a function that receives the input.
+     * @since 0.5.0
+     */
+    invalidFormat?: Message | ((input: string) => Message);
+  };
 }
 /**
  * Options for creating a plain date parser.
@@ -68,6 +105,18 @@ interface PlainDateOptions {
    * @default `"DATE"`
    */
   readonly metavar?: string;
+  /**
+   * Custom error messages for plain date parsing failures.
+   * @since 0.5.0
+   */
+  readonly errors?: {
+    /**
+     * Custom error message when input is not a valid date format.
+     * Can be a static message or a function that receives the input.
+     * @since 0.5.0
+     */
+    invalidFormat?: Message | ((input: string) => Message);
+  };
 }
 /**
  * Options for creating a plain time parser.
@@ -80,6 +129,18 @@ interface PlainTimeOptions {
    * @default `"TIME"`
    */
   readonly metavar?: string;
+  /**
+   * Custom error messages for plain time parsing failures.
+   * @since 0.5.0
+   */
+  readonly errors?: {
+    /**
+     * Custom error message when input is not a valid time format.
+     * Can be a static message or a function that receives the input.
+     * @since 0.5.0
+     */
+    invalidFormat?: Message | ((input: string) => Message);
+  };
 }
 /**
  * Options for creating a plain datetime parser.
@@ -92,6 +153,18 @@ interface PlainDateTimeOptions {
    * @default `"DATETIME"`
    */
   readonly metavar?: string;
+  /**
+   * Custom error messages for plain datetime parsing failures.
+   * @since 0.5.0
+   */
+  readonly errors?: {
+    /**
+     * Custom error message when input is not a valid datetime format.
+     * Can be a static message or a function that receives the input.
+     * @since 0.5.0
+     */
+    invalidFormat?: Message | ((input: string) => Message);
+  };
 }
 /**
  * Options for creating a plain year-month parser.
@@ -104,6 +177,18 @@ interface PlainYearMonthOptions {
    * @default `"YEAR-MONTH"`
    */
   readonly metavar?: string;
+  /**
+   * Custom error messages for plain year-month parsing failures.
+   * @since 0.5.0
+   */
+  readonly errors?: {
+    /**
+     * Custom error message when input is not a valid year-month format.
+     * Can be a static message or a function that receives the input.
+     * @since 0.5.0
+     */
+    invalidFormat?: Message | ((input: string) => Message);
+  };
 }
 /**
  * Options for creating a plain month-day parser.
@@ -116,6 +201,18 @@ interface PlainMonthDayOptions {
    * @default `"--MONTH-DAY"`
    */
   readonly metavar?: string;
+  /**
+   * Custom error messages for plain month-day parsing failures.
+   * @since 0.5.0
+   */
+  readonly errors?: {
+    /**
+     * Custom error message when input is not a valid month-day format.
+     * Can be a static message or a function that receives the input.
+     * @since 0.5.0
+     */
+    invalidFormat?: Message | ((input: string) => Message);
+  };
 }
 /**
  * Options for creating a timezone parser.
@@ -128,6 +225,18 @@ interface TimeZoneOptions {
    * @default `"TIMEZONE"`
    */
   readonly metavar?: string;
+  /**
+   * Custom error messages for timezone parsing failures.
+   * @since 0.5.0
+   */
+  readonly errors?: {
+    /**
+     * Custom error message when input is not a valid timezone identifier.
+     * Can be a static message or a function that receives the input.
+     * @since 0.5.0
+     */
+    invalidFormat?: Message | ((input: string) => Message);
+  };
 }
 /**
  * Creates a ValueParser for parsing Temporal.Instant from ISO 8601 strings.

package/dist/index.js

@@ -26,7 +26,7 @@ function instant(options = {}) {
 			} catch {
 				return {
 					success: false,
-					error: message`Invalid instant: ${input}. Expected ISO 8601 format like ${"2020-01-23T17:04:36Z"}.`
+					error: options.errors?.invalidFormat ? typeof options.errors.invalidFormat === "function" ? options.errors.invalidFormat(input) : options.errors.invalidFormat : message`Invalid instant: ${input}. Expected ISO 8601 format like ${"2020-01-23T17:04:36Z"}.`
 				};
 			}
 		},
@@ -60,7 +60,7 @@ function duration(options = {}) {
 			} catch {
 				return {
 					success: false,
-					error: message`Invalid duration: ${input}. Expected ISO 8601 format like ${"PT1H30M"}.`
+					error: options.errors?.invalidFormat ? typeof options.errors.invalidFormat === "function" ? options.errors.invalidFormat(input) : options.errors.invalidFormat : message`Invalid duration: ${input}. Expected ISO 8601 format like ${"PT1H30M"}.`
 				};
 			}
 		},
@@ -93,7 +93,7 @@ function zonedDateTime(options = {}) {
 			} catch {
 				return {
 					success: false,
-					error: message`Invalid zoned datetime: ${input}. Expected ISO 8601 format with timezone like ${"2020-01-23T17:04:36+01:00[Europe/Paris]"}.`
+					error: options.errors?.invalidFormat ? typeof options.errors.invalidFormat === "function" ? options.errors.invalidFormat(input) : options.errors.invalidFormat : message`Invalid zoned datetime: ${input}. Expected ISO 8601 format with timezone like ${"2020-01-23T17:04:36+01:00[Europe/Paris]"}.`
 				};
 			}
 		},
@@ -126,7 +126,7 @@ function plainDate(options = {}) {
 			} catch {
 				return {
 					success: false,
-					error: message`Invalid date: ${input}. Expected ISO 8601 format like ${"2020-01-23"}.`
+					error: options.errors?.invalidFormat ? typeof options.errors.invalidFormat === "function" ? options.errors.invalidFormat(input) : options.errors.invalidFormat : message`Invalid date: ${input}. Expected ISO 8601 format like ${"2020-01-23"}.`
 				};
 			}
 		},
@@ -159,7 +159,7 @@ function plainTime(options = {}) {
 			} catch {
 				return {
 					success: false,
-					error: message`Invalid time: ${input}. Expected ISO 8601 format like ${"17:04:36"}.`
+					error: options.errors?.invalidFormat ? typeof options.errors.invalidFormat === "function" ? options.errors.invalidFormat(input) : options.errors.invalidFormat : message`Invalid time: ${input}. Expected ISO 8601 format like ${"17:04:36"}.`
 				};
 			}
 		},
@@ -192,7 +192,7 @@ function plainDateTime(options = {}) {
 			} catch {
 				return {
 					success: false,
-					error: message`Invalid datetime: ${input}. Expected ISO 8601 format like ${"2020-01-23T17:04:36"}.`
+					error: options.errors?.invalidFormat ? typeof options.errors.invalidFormat === "function" ? options.errors.invalidFormat(input) : options.errors.invalidFormat : message`Invalid datetime: ${input}. Expected ISO 8601 format like ${"2020-01-23T17:04:36"}.`
 				};
 			}
 		},
@@ -225,7 +225,7 @@ function plainYearMonth(options = {}) {
 			} catch {
 				return {
 					success: false,
-					error: message`Invalid year-month: ${input}. Expected ISO 8601 format like ${"2020-01"}.`
+					error: options.errors?.invalidFormat ? typeof options.errors.invalidFormat === "function" ? options.errors.invalidFormat(input) : options.errors.invalidFormat : message`Invalid year-month: ${input}. Expected ISO 8601 format like ${"2020-01"}.`
 				};
 			}
 		},
@@ -258,7 +258,7 @@ function plainMonthDay(options = {}) {
 			} catch {
 				return {
 					success: false,
-					error: message`Invalid month-day: ${input}. Expected ISO 8601 format like ${"--01-23"}.`
+					error: options.errors?.invalidFormat ? typeof options.errors.invalidFormat === "function" ? options.errors.invalidFormat(input) : options.errors.invalidFormat : message`Invalid month-day: ${input}. Expected ISO 8601 format like ${"--01-23"}.`
 				};
 			}
 		},
@@ -298,7 +298,7 @@ function timeZone(options = {}) {
 			} catch {
 				return {
 					success: false,
-					error: message`Invalid timezone identifier: ${input}. Must be a valid IANA timezone like "Asia/Seoul" or "UTC".`
+					error: options.errors?.invalidFormat ? typeof options.errors.invalidFormat === "function" ? options.errors.invalidFormat(input) : options.errors.invalidFormat : message`Invalid timezone identifier: ${input}. Must be a valid IANA timezone like "Asia/Seoul" or "UTC".`
 				};
 			}
 		},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/temporal",
-  "version": "0.5.0-dev.79+66aa8134",
+  "version": "0.5.0-dev.82+3a10f0da",
   "description": "Temporal value parsers for Optique",
   "keywords": [
     "CLI",