@optique/temporal 0.4.0-dev.49

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright 2025 Hong Minhee
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,346 @@
+const { Temporal } = require("@js-temporal/polyfill");
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+const __optique_core_message = __toESM(require("@optique/core/message"));
+
+//#region src/index.ts
+/**
+* Creates a ValueParser for parsing Temporal.Instant from ISO 8601 strings.
+*
+* Accepts strings like:
+*
+* - `"2020-01-23T17:04:36.491865121Z"`
+* - `"2020-01-23T17:04:36Z"`
+*
+* @param options Configuration options for the instant parser.
+* @returns A ValueParser that parses strings into Temporal.Instant values.
+*/
+function instant(options = {}) {
+	return {
+		metavar: options.metavar ?? "TIMESTAMP",
+		parse(input) {
+			try {
+				const value = Temporal.Instant.from(input);
+				return {
+					success: true,
+					value
+				};
+			} catch {
+				return {
+					success: false,
+					error: __optique_core_message.message`Invalid instant: ${input}. Expected ISO 8601 format like ${"2020-01-23T17:04:36Z"}.`
+				};
+			}
+		},
+		format(value) {
+			return value.toString();
+		}
+	};
+}
+/**
+* Creates a ValueParser for parsing Temporal.Duration from ISO 8601 duration strings.
+*
+* Accepts strings like:
+*
+* - `"PT1H30M"`
+* - `"P1DT12H"`
+* - `"PT30S"`
+*
+* @param options Configuration options for the duration parser.
+* @returns A ValueParser that parses strings into Temporal.Duration values.
+*/
+function duration(options = {}) {
+	return {
+		metavar: options.metavar ?? "DURATION",
+		parse(input) {
+			try {
+				const value = Temporal.Duration.from(input);
+				return {
+					success: true,
+					value
+				};
+			} catch {
+				return {
+					success: false,
+					error: __optique_core_message.message`Invalid duration: ${input}. Expected ISO 8601 format like ${"PT1H30M"}.`
+				};
+			}
+		},
+		format(value) {
+			return value.toString();
+		}
+	};
+}
+/**
+* Creates a ValueParser for parsing Temporal.ZonedDateTime from ISO 8601 strings with timezone.
+*
+* Accepts strings like:
+*
+* - `"2020-01-23T17:04:36.491865121+01:00[Europe/Paris]"`
+* - `"2020-01-23T17:04:36Z[UTC]"`
+*
+* @param options Configuration options for the zoned datetime parser.
+* @returns A ValueParser that parses strings into Temporal.ZonedDateTime values.
+*/
+function zonedDateTime(options = {}) {
+	return {
+		metavar: options.metavar ?? "ZONED_DATETIME",
+		parse(input) {
+			try {
+				const value = Temporal.ZonedDateTime.from(input);
+				return {
+					success: true,
+					value
+				};
+			} 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]"}.`
+				};
+			}
+		},
+		format(value) {
+			return value.toString();
+		}
+	};
+}
+/**
+* Creates a ValueParser for parsing Temporal.PlainDate from ISO 8601 date strings.
+*
+* Accepts strings like:
+*
+* - `"2020-01-23"`
+* - `"2020-12-31"`
+*
+* @param options Configuration options for the plain date parser.
+* @returns A ValueParser that parses strings into Temporal.PlainDate values.
+*/
+function plainDate(options = {}) {
+	return {
+		metavar: options.metavar ?? "DATE",
+		parse(input) {
+			try {
+				const value = Temporal.PlainDate.from(input);
+				return {
+					success: true,
+					value
+				};
+			} catch {
+				return {
+					success: false,
+					error: __optique_core_message.message`Invalid date: ${input}. Expected ISO 8601 format like ${"2020-01-23"}.`
+				};
+			}
+		},
+		format(value) {
+			return value.toString();
+		}
+	};
+}
+/**
+* Creates a ValueParser for parsing Temporal.PlainTime from ISO 8601 time strings.
+*
+* Accepts strings like:
+*
+* - `"17:04:36"`
+* - `"17:04:36.491865121"`
+*
+* @param options Configuration options for the plain time parser.
+* @returns A ValueParser that parses strings into Temporal.PlainTime values.
+*/
+function plainTime(options = {}) {
+	return {
+		metavar: options.metavar ?? "TIME",
+		parse(input) {
+			try {
+				const value = Temporal.PlainTime.from(input);
+				return {
+					success: true,
+					value
+				};
+			} catch {
+				return {
+					success: false,
+					error: __optique_core_message.message`Invalid time: ${input}. Expected ISO 8601 format like ${"17:04:36"}.`
+				};
+			}
+		},
+		format(value) {
+			return value.toString();
+		}
+	};
+}
+/**
+* Creates a ValueParser for parsing Temporal.PlainDateTime from ISO 8601 datetime strings.
+*
+* Accepts strings like:
+*
+* - `"2020-01-23T17:04:36"`
+* - `"2020-01-23T17:04:36.491865121"`
+*
+* @param options Configuration options for the plain datetime parser.
+* @returns A ValueParser that parses strings into Temporal.PlainDateTime values.
+*/
+function plainDateTime(options = {}) {
+	return {
+		metavar: options.metavar ?? "DATETIME",
+		parse(input) {
+			try {
+				const value = Temporal.PlainDateTime.from(input);
+				return {
+					success: true,
+					value
+				};
+			} catch {
+				return {
+					success: false,
+					error: __optique_core_message.message`Invalid datetime: ${input}. Expected ISO 8601 format like ${"2020-01-23T17:04:36"}.`
+				};
+			}
+		},
+		format(value) {
+			return value.toString();
+		}
+	};
+}
+/**
+* Creates a ValueParser for parsing Temporal.PlainYearMonth from ISO 8601 year-month strings.
+*
+* Accepts strings like:
+*
+* - `"2020-01"`
+* - `"2020-12"`
+*
+* @param options Configuration options for the plain year-month parser.
+* @returns A ValueParser that parses strings into Temporal.PlainYearMonth values.
+*/
+function plainYearMonth(options = {}) {
+	return {
+		metavar: options.metavar ?? "YEAR-MONTH",
+		parse(input) {
+			try {
+				const value = Temporal.PlainYearMonth.from(input);
+				return {
+					success: true,
+					value
+				};
+			} catch {
+				return {
+					success: false,
+					error: __optique_core_message.message`Invalid year-month: ${input}. Expected ISO 8601 format like ${"2020-01"}.`
+				};
+			}
+		},
+		format(value) {
+			return value.toString();
+		}
+	};
+}
+/**
+* Creates a ValueParser for parsing Temporal.PlainMonthDay from ISO 8601 month-day strings.
+*
+* Accepts strings like:
+*
+* - `"--01-23"`
+* - `"--12-31"`
+*
+* @param options Configuration options for the plain month-day parser.
+* @returns A ValueParser that parses strings into Temporal.PlainMonthDay values.
+*/
+function plainMonthDay(options = {}) {
+	return {
+		metavar: options.metavar ?? "--MONTH-DAY",
+		parse(input) {
+			try {
+				const value = Temporal.PlainMonthDay.from(input);
+				return {
+					success: true,
+					value
+				};
+			} catch {
+				return {
+					success: false,
+					error: __optique_core_message.message`Invalid month-day: ${input}. Expected ISO 8601 format like ${"--01-23"}.`
+				};
+			}
+		},
+		format(value) {
+			return value.toString();
+		}
+	};
+}
+/**
+* Creates a ValueParser for parsing IANA Time Zone Database identifiers.
+*
+* Accepts strings like:
+*
+* - `"Asia/Seoul"`
+* - `"America/New_York"`
+* - `"Europe/London"`
+* - `"UTC"`
+*
+* @param options Configuration options for the timezone parser.
+* @returns A ValueParser that parses and validates timezone identifiers.
+*/
+function timeZone(options = {}) {
+	return {
+		metavar: options.metavar ?? "TIMEZONE",
+		parse(input) {
+			try {
+				Temporal.ZonedDateTime.from({
+					year: 2020,
+					month: 1,
+					day: 1,
+					hour: 0,
+					minute: 0,
+					second: 0,
+					timeZone: input
+				});
+				return {
+					success: true,
+					value: input
+				};
+			} catch {
+				return {
+					success: false,
+					error: __optique_core_message.message`Invalid timezone identifier: ${input}. Must be a valid IANA timezone like "Asia/Seoul" or "UTC".`
+				};
+			}
+		},
+		format(value) {
+			return value;
+		}
+	};
+}
+
+//#endregion
+exports.duration = duration;
+exports.instant = instant;
+exports.plainDate = plainDate;
+exports.plainDateTime = plainDateTime;
+exports.plainMonthDay = plainMonthDay;
+exports.plainTime = plainTime;
+exports.plainYearMonth = plainYearMonth;
+exports.timeZone = timeZone;
+exports.zonedDateTime = zonedDateTime;

package/dist/index.d.cts

@@ -0,0 +1,243 @@
+import { ValueParser } from "@optique/core/valueparser";
+
+//#region src/index.d.ts
+
+/**
+ * IANA Time Zone Database identifier.
+ *
+ * Represents valid timezone identifiers that follow the IANA timezone naming
+ * convention:
+ *
+ * - Two-level: `"Asia/Seoul"`, `"America/New_York"`, `"Europe/London"`
+ * - Three-level: `"America/Argentina/Buenos_Aires"`, `"America/Kentucky/Louisville"`
+ * - Special case: `"UTC"`
+ *
+ * @example
+ * ```typescript
+ * const seoul: TimeZone = "Asia/Seoul";
+ * const utc: TimeZone = "UTC";
+ * const buenosAires: TimeZone = "America/Argentina/Buenos_Aires";
+ * ```
+ */
+type TimeZone = `${string}/${string}/${string}` | `${string}/${string}` | "UTC";
+/**
+ * Options for creating an instant parser.
+ */
+interface InstantOptions {
+  /**
+   * The metavariable name for this parser. This is used in help messages to
+   * indicate what kind of value this parser expects. Usually a single
+   * word in uppercase, like `TIMESTAMP` or `INSTANT`.
+   * @default `"TIMESTAMP"`
+   */
+  readonly metavar?: string;
+}
+/**
+ * Options for creating a duration parser.
+ */
+interface DurationOptions {
+  /**
+   * The metavariable name for this parser. This is used in help messages to
+   * indicate what kind of value this parser expects. Usually a single
+   * word in uppercase, like `DURATION`.
+   * @default `"DURATION"`
+   */
+  readonly metavar?: string;
+}
+/**
+ * Options for creating a zoned datetime parser.
+ */
+interface ZonedDateTimeOptions {
+  /**
+   * The metavariable name for this parser. This is used in help messages to
+   * indicate what kind of value this parser expects. Usually a single
+   * word in uppercase, like `ZONED_DATETIME`.
+   * @default `"ZONED_DATETIME"`
+   */
+  readonly metavar?: string;
+}
+/**
+ * Options for creating a plain date parser.
+ */
+interface PlainDateOptions {
+  /**
+   * The metavariable name for this parser. This is used in help messages to
+   * indicate what kind of value this parser expects. Usually a single
+   * word in uppercase, like `DATE`.
+   * @default `"DATE"`
+   */
+  readonly metavar?: string;
+}
+/**
+ * Options for creating a plain time parser.
+ */
+interface PlainTimeOptions {
+  /**
+   * The metavariable name for this parser. This is used in help messages to
+   * indicate what kind of value this parser expects. Usually a single
+   * word in uppercase, like `TIME`.
+   * @default `"TIME"`
+   */
+  readonly metavar?: string;
+}
+/**
+ * Options for creating a plain datetime parser.
+ */
+interface PlainDateTimeOptions {
+  /**
+   * The metavariable name for this parser. This is used in help messages to
+   * indicate what kind of value this parser expects. Usually a single
+   * word in uppercase, like `DATETIME`.
+   * @default `"DATETIME"`
+   */
+  readonly metavar?: string;
+}
+/**
+ * Options for creating a plain year-month parser.
+ */
+interface PlainYearMonthOptions {
+  /**
+   * The metavariable name for this parser. This is used in help messages to
+   * indicate what kind of value this parser expects. Usually a single
+   * word in uppercase, like `YEAR-MONTH`.
+   * @default `"YEAR-MONTH"`
+   */
+  readonly metavar?: string;
+}
+/**
+ * Options for creating a plain month-day parser.
+ */
+interface PlainMonthDayOptions {
+  /**
+   * The metavariable name for this parser. This is used in help messages to
+   * indicate what kind of value this parser expects. Usually a single
+   * word in uppercase, like `--MONTH-DAY`.
+   * @default `"--MONTH-DAY"`
+   */
+  readonly metavar?: string;
+}
+/**
+ * Options for creating a timezone parser.
+ */
+interface TimeZoneOptions {
+  /**
+   * The metavariable name for this parser. This is used in help messages to
+   * indicate what kind of value this parser expects. Usually a single
+   * word in uppercase, like `TIMEZONE`.
+   * @default `"TIMEZONE"`
+   */
+  readonly metavar?: string;
+}
+/**
+ * Creates a ValueParser for parsing Temporal.Instant from ISO 8601 strings.
+ *
+ * Accepts strings like:
+ *
+ * - `"2020-01-23T17:04:36.491865121Z"`
+ * - `"2020-01-23T17:04:36Z"`
+ *
+ * @param options Configuration options for the instant parser.
+ * @returns A ValueParser that parses strings into Temporal.Instant values.
+ */
+declare function instant(options?: InstantOptions): ValueParser<Temporal.Instant>;
+/**
+ * Creates a ValueParser for parsing Temporal.Duration from ISO 8601 duration strings.
+ *
+ * Accepts strings like:
+ *
+ * - `"PT1H30M"`
+ * - `"P1DT12H"`
+ * - `"PT30S"`
+ *
+ * @param options Configuration options for the duration parser.
+ * @returns A ValueParser that parses strings into Temporal.Duration values.
+ */
+declare function duration(options?: DurationOptions): ValueParser<Temporal.Duration>;
+/**
+ * Creates a ValueParser for parsing Temporal.ZonedDateTime from ISO 8601 strings with timezone.
+ *
+ * Accepts strings like:
+ *
+ * - `"2020-01-23T17:04:36.491865121+01:00[Europe/Paris]"`
+ * - `"2020-01-23T17:04:36Z[UTC]"`
+ *
+ * @param options Configuration options for the zoned datetime parser.
+ * @returns A ValueParser that parses strings into Temporal.ZonedDateTime values.
+ */
+declare function zonedDateTime(options?: ZonedDateTimeOptions): ValueParser<Temporal.ZonedDateTime>;
+/**
+ * Creates a ValueParser for parsing Temporal.PlainDate from ISO 8601 date strings.
+ *
+ * Accepts strings like:
+ *
+ * - `"2020-01-23"`
+ * - `"2020-12-31"`
+ *
+ * @param options Configuration options for the plain date parser.
+ * @returns A ValueParser that parses strings into Temporal.PlainDate values.
+ */
+declare function plainDate(options?: PlainDateOptions): ValueParser<Temporal.PlainDate>;
+/**
+ * Creates a ValueParser for parsing Temporal.PlainTime from ISO 8601 time strings.
+ *
+ * Accepts strings like:
+ *
+ * - `"17:04:36"`
+ * - `"17:04:36.491865121"`
+ *
+ * @param options Configuration options for the plain time parser.
+ * @returns A ValueParser that parses strings into Temporal.PlainTime values.
+ */
+declare function plainTime(options?: PlainTimeOptions): ValueParser<Temporal.PlainTime>;
+/**
+ * Creates a ValueParser for parsing Temporal.PlainDateTime from ISO 8601 datetime strings.
+ *
+ * Accepts strings like:
+ *
+ * - `"2020-01-23T17:04:36"`
+ * - `"2020-01-23T17:04:36.491865121"`
+ *
+ * @param options Configuration options for the plain datetime parser.
+ * @returns A ValueParser that parses strings into Temporal.PlainDateTime values.
+ */
+declare function plainDateTime(options?: PlainDateTimeOptions): ValueParser<Temporal.PlainDateTime>;
+/**
+ * Creates a ValueParser for parsing Temporal.PlainYearMonth from ISO 8601 year-month strings.
+ *
+ * Accepts strings like:
+ *
+ * - `"2020-01"`
+ * - `"2020-12"`
+ *
+ * @param options Configuration options for the plain year-month parser.
+ * @returns A ValueParser that parses strings into Temporal.PlainYearMonth values.
+ */
+declare function plainYearMonth(options?: PlainYearMonthOptions): ValueParser<Temporal.PlainYearMonth>;
+/**
+ * Creates a ValueParser for parsing Temporal.PlainMonthDay from ISO 8601 month-day strings.
+ *
+ * Accepts strings like:
+ *
+ * - `"--01-23"`
+ * - `"--12-31"`
+ *
+ * @param options Configuration options for the plain month-day parser.
+ * @returns A ValueParser that parses strings into Temporal.PlainMonthDay values.
+ */
+declare function plainMonthDay(options?: PlainMonthDayOptions): ValueParser<Temporal.PlainMonthDay>;
+/**
+ * Creates a ValueParser for parsing IANA Time Zone Database identifiers.
+ *
+ * Accepts strings like:
+ *
+ * - `"Asia/Seoul"`
+ * - `"America/New_York"`
+ * - `"Europe/London"`
+ * - `"UTC"`
+ *
+ * @param options Configuration options for the timezone parser.
+ * @returns A ValueParser that parses and validates timezone identifiers.
+ */
+declare function timeZone(options?: TimeZoneOptions): ValueParser<TimeZone>;
+//#endregion
+export { DurationOptions, InstantOptions, PlainDateOptions, PlainDateTimeOptions, PlainMonthDayOptions, PlainTimeOptions, PlainYearMonthOptions, TimeZone, TimeZoneOptions, ZonedDateTimeOptions, duration, instant, plainDate, plainDateTime, plainMonthDay, plainTime, plainYearMonth, timeZone, zonedDateTime };

package/dist/index.d.ts

@@ -0,0 +1,244 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { ValueParser } from "@optique/core/valueparser";
+
+//#region src/index.d.ts
+
+/**
+ * IANA Time Zone Database identifier.
+ *
+ * Represents valid timezone identifiers that follow the IANA timezone naming
+ * convention:
+ *
+ * - Two-level: `"Asia/Seoul"`, `"America/New_York"`, `"Europe/London"`
+ * - Three-level: `"America/Argentina/Buenos_Aires"`, `"America/Kentucky/Louisville"`
+ * - Special case: `"UTC"`
+ *
+ * @example
+ * ```typescript
+ * const seoul: TimeZone = "Asia/Seoul";
+ * const utc: TimeZone = "UTC";
+ * const buenosAires: TimeZone = "America/Argentina/Buenos_Aires";
+ * ```
+ */
+type TimeZone = `${string}/${string}/${string}` | `${string}/${string}` | "UTC";
+/**
+ * Options for creating an instant parser.
+ */
+interface InstantOptions {
+  /**
+   * The metavariable name for this parser. This is used in help messages to
+   * indicate what kind of value this parser expects. Usually a single
+   * word in uppercase, like `TIMESTAMP` or `INSTANT`.
+   * @default `"TIMESTAMP"`
+   */
+  readonly metavar?: string;
+}
+/**
+ * Options for creating a duration parser.
+ */
+interface DurationOptions {
+  /**
+   * The metavariable name for this parser. This is used in help messages to
+   * indicate what kind of value this parser expects. Usually a single
+   * word in uppercase, like `DURATION`.
+   * @default `"DURATION"`
+   */
+  readonly metavar?: string;
+}
+/**
+ * Options for creating a zoned datetime parser.
+ */
+interface ZonedDateTimeOptions {
+  /**
+   * The metavariable name for this parser. This is used in help messages to
+   * indicate what kind of value this parser expects. Usually a single
+   * word in uppercase, like `ZONED_DATETIME`.
+   * @default `"ZONED_DATETIME"`
+   */
+  readonly metavar?: string;
+}
+/**
+ * Options for creating a plain date parser.
+ */
+interface PlainDateOptions {
+  /**
+   * The metavariable name for this parser. This is used in help messages to
+   * indicate what kind of value this parser expects. Usually a single
+   * word in uppercase, like `DATE`.
+   * @default `"DATE"`
+   */
+  readonly metavar?: string;
+}
+/**
+ * Options for creating a plain time parser.
+ */
+interface PlainTimeOptions {
+  /**
+   * The metavariable name for this parser. This is used in help messages to
+   * indicate what kind of value this parser expects. Usually a single
+   * word in uppercase, like `TIME`.
+   * @default `"TIME"`
+   */
+  readonly metavar?: string;
+}
+/**
+ * Options for creating a plain datetime parser.
+ */
+interface PlainDateTimeOptions {
+  /**
+   * The metavariable name for this parser. This is used in help messages to
+   * indicate what kind of value this parser expects. Usually a single
+   * word in uppercase, like `DATETIME`.
+   * @default `"DATETIME"`
+   */
+  readonly metavar?: string;
+}
+/**
+ * Options for creating a plain year-month parser.
+ */
+interface PlainYearMonthOptions {
+  /**
+   * The metavariable name for this parser. This is used in help messages to
+   * indicate what kind of value this parser expects. Usually a single
+   * word in uppercase, like `YEAR-MONTH`.
+   * @default `"YEAR-MONTH"`
+   */
+  readonly metavar?: string;
+}
+/**
+ * Options for creating a plain month-day parser.
+ */
+interface PlainMonthDayOptions {
+  /**
+   * The metavariable name for this parser. This is used in help messages to
+   * indicate what kind of value this parser expects. Usually a single
+   * word in uppercase, like `--MONTH-DAY`.
+   * @default `"--MONTH-DAY"`
+   */
+  readonly metavar?: string;
+}
+/**
+ * Options for creating a timezone parser.
+ */
+interface TimeZoneOptions {
+  /**
+   * The metavariable name for this parser. This is used in help messages to
+   * indicate what kind of value this parser expects. Usually a single
+   * word in uppercase, like `TIMEZONE`.
+   * @default `"TIMEZONE"`
+   */
+  readonly metavar?: string;
+}
+/**
+ * Creates a ValueParser for parsing Temporal.Instant from ISO 8601 strings.
+ *
+ * Accepts strings like:
+ *
+ * - `"2020-01-23T17:04:36.491865121Z"`
+ * - `"2020-01-23T17:04:36Z"`
+ *
+ * @param options Configuration options for the instant parser.
+ * @returns A ValueParser that parses strings into Temporal.Instant values.
+ */
+declare function instant(options?: InstantOptions): ValueParser<Temporal.Instant>;
+/**
+ * Creates a ValueParser for parsing Temporal.Duration from ISO 8601 duration strings.
+ *
+ * Accepts strings like:
+ *
+ * - `"PT1H30M"`
+ * - `"P1DT12H"`
+ * - `"PT30S"`
+ *
+ * @param options Configuration options for the duration parser.
+ * @returns A ValueParser that parses strings into Temporal.Duration values.
+ */
+declare function duration(options?: DurationOptions): ValueParser<Temporal.Duration>;
+/**
+ * Creates a ValueParser for parsing Temporal.ZonedDateTime from ISO 8601 strings with timezone.
+ *
+ * Accepts strings like:
+ *
+ * - `"2020-01-23T17:04:36.491865121+01:00[Europe/Paris]"`
+ * - `"2020-01-23T17:04:36Z[UTC]"`
+ *
+ * @param options Configuration options for the zoned datetime parser.
+ * @returns A ValueParser that parses strings into Temporal.ZonedDateTime values.
+ */
+declare function zonedDateTime(options?: ZonedDateTimeOptions): ValueParser<Temporal.ZonedDateTime>;
+/**
+ * Creates a ValueParser for parsing Temporal.PlainDate from ISO 8601 date strings.
+ *
+ * Accepts strings like:
+ *
+ * - `"2020-01-23"`
+ * - `"2020-12-31"`
+ *
+ * @param options Configuration options for the plain date parser.
+ * @returns A ValueParser that parses strings into Temporal.PlainDate values.
+ */
+declare function plainDate(options?: PlainDateOptions): ValueParser<Temporal.PlainDate>;
+/**
+ * Creates a ValueParser for parsing Temporal.PlainTime from ISO 8601 time strings.
+ *
+ * Accepts strings like:
+ *
+ * - `"17:04:36"`
+ * - `"17:04:36.491865121"`
+ *
+ * @param options Configuration options for the plain time parser.
+ * @returns A ValueParser that parses strings into Temporal.PlainTime values.
+ */
+declare function plainTime(options?: PlainTimeOptions): ValueParser<Temporal.PlainTime>;
+/**
+ * Creates a ValueParser for parsing Temporal.PlainDateTime from ISO 8601 datetime strings.
+ *
+ * Accepts strings like:
+ *
+ * - `"2020-01-23T17:04:36"`
+ * - `"2020-01-23T17:04:36.491865121"`
+ *
+ * @param options Configuration options for the plain datetime parser.
+ * @returns A ValueParser that parses strings into Temporal.PlainDateTime values.
+ */
+declare function plainDateTime(options?: PlainDateTimeOptions): ValueParser<Temporal.PlainDateTime>;
+/**
+ * Creates a ValueParser for parsing Temporal.PlainYearMonth from ISO 8601 year-month strings.
+ *
+ * Accepts strings like:
+ *
+ * - `"2020-01"`
+ * - `"2020-12"`
+ *
+ * @param options Configuration options for the plain year-month parser.
+ * @returns A ValueParser that parses strings into Temporal.PlainYearMonth values.
+ */
+declare function plainYearMonth(options?: PlainYearMonthOptions): ValueParser<Temporal.PlainYearMonth>;
+/**
+ * Creates a ValueParser for parsing Temporal.PlainMonthDay from ISO 8601 month-day strings.
+ *
+ * Accepts strings like:
+ *
+ * - `"--01-23"`
+ * - `"--12-31"`
+ *
+ * @param options Configuration options for the plain month-day parser.
+ * @returns A ValueParser that parses strings into Temporal.PlainMonthDay values.
+ */
+declare function plainMonthDay(options?: PlainMonthDayOptions): ValueParser<Temporal.PlainMonthDay>;
+/**
+ * Creates a ValueParser for parsing IANA Time Zone Database identifiers.
+ *
+ * Accepts strings like:
+ *
+ * - `"Asia/Seoul"`
+ * - `"America/New_York"`
+ * - `"Europe/London"`
+ * - `"UTC"`
+ *
+ * @param options Configuration options for the timezone parser.
+ * @returns A ValueParser that parses and validates timezone identifiers.
+ */
+declare function timeZone(options?: TimeZoneOptions): ValueParser<TimeZone>;
+//#endregion
+export { DurationOptions, InstantOptions, PlainDateOptions, PlainDateTimeOptions, PlainMonthDayOptions, PlainTimeOptions, PlainYearMonthOptions, TimeZone, TimeZoneOptions, ZonedDateTimeOptions, duration, instant, plainDate, plainDateTime, plainMonthDay, plainTime, plainYearMonth, timeZone, zonedDateTime };

package/dist/index.js

@@ -0,0 +1,315 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { message } from "@optique/core/message";
+
+//#region src/index.ts
+/**
+* Creates a ValueParser for parsing Temporal.Instant from ISO 8601 strings.
+*
+* Accepts strings like:
+*
+* - `"2020-01-23T17:04:36.491865121Z"`
+* - `"2020-01-23T17:04:36Z"`
+*
+* @param options Configuration options for the instant parser.
+* @returns A ValueParser that parses strings into Temporal.Instant values.
+*/
+function instant(options = {}) {
+	return {
+		metavar: options.metavar ?? "TIMESTAMP",
+		parse(input) {
+			try {
+				const value = Temporal.Instant.from(input);
+				return {
+					success: true,
+					value
+				};
+			} catch {
+				return {
+					success: false,
+					error: message`Invalid instant: ${input}. Expected ISO 8601 format like ${"2020-01-23T17:04:36Z"}.`
+				};
+			}
+		},
+		format(value) {
+			return value.toString();
+		}
+	};
+}
+/**
+* Creates a ValueParser for parsing Temporal.Duration from ISO 8601 duration strings.
+*
+* Accepts strings like:
+*
+* - `"PT1H30M"`
+* - `"P1DT12H"`
+* - `"PT30S"`
+*
+* @param options Configuration options for the duration parser.
+* @returns A ValueParser that parses strings into Temporal.Duration values.
+*/
+function duration(options = {}) {
+	return {
+		metavar: options.metavar ?? "DURATION",
+		parse(input) {
+			try {
+				const value = Temporal.Duration.from(input);
+				return {
+					success: true,
+					value
+				};
+			} catch {
+				return {
+					success: false,
+					error: message`Invalid duration: ${input}. Expected ISO 8601 format like ${"PT1H30M"}.`
+				};
+			}
+		},
+		format(value) {
+			return value.toString();
+		}
+	};
+}
+/**
+* Creates a ValueParser for parsing Temporal.ZonedDateTime from ISO 8601 strings with timezone.
+*
+* Accepts strings like:
+*
+* - `"2020-01-23T17:04:36.491865121+01:00[Europe/Paris]"`
+* - `"2020-01-23T17:04:36Z[UTC]"`
+*
+* @param options Configuration options for the zoned datetime parser.
+* @returns A ValueParser that parses strings into Temporal.ZonedDateTime values.
+*/
+function zonedDateTime(options = {}) {
+	return {
+		metavar: options.metavar ?? "ZONED_DATETIME",
+		parse(input) {
+			try {
+				const value = Temporal.ZonedDateTime.from(input);
+				return {
+					success: true,
+					value
+				};
+			} 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]"}.`
+				};
+			}
+		},
+		format(value) {
+			return value.toString();
+		}
+	};
+}
+/**
+* Creates a ValueParser for parsing Temporal.PlainDate from ISO 8601 date strings.
+*
+* Accepts strings like:
+*
+* - `"2020-01-23"`
+* - `"2020-12-31"`
+*
+* @param options Configuration options for the plain date parser.
+* @returns A ValueParser that parses strings into Temporal.PlainDate values.
+*/
+function plainDate(options = {}) {
+	return {
+		metavar: options.metavar ?? "DATE",
+		parse(input) {
+			try {
+				const value = Temporal.PlainDate.from(input);
+				return {
+					success: true,
+					value
+				};
+			} catch {
+				return {
+					success: false,
+					error: message`Invalid date: ${input}. Expected ISO 8601 format like ${"2020-01-23"}.`
+				};
+			}
+		},
+		format(value) {
+			return value.toString();
+		}
+	};
+}
+/**
+* Creates a ValueParser for parsing Temporal.PlainTime from ISO 8601 time strings.
+*
+* Accepts strings like:
+*
+* - `"17:04:36"`
+* - `"17:04:36.491865121"`
+*
+* @param options Configuration options for the plain time parser.
+* @returns A ValueParser that parses strings into Temporal.PlainTime values.
+*/
+function plainTime(options = {}) {
+	return {
+		metavar: options.metavar ?? "TIME",
+		parse(input) {
+			try {
+				const value = Temporal.PlainTime.from(input);
+				return {
+					success: true,
+					value
+				};
+			} catch {
+				return {
+					success: false,
+					error: message`Invalid time: ${input}. Expected ISO 8601 format like ${"17:04:36"}.`
+				};
+			}
+		},
+		format(value) {
+			return value.toString();
+		}
+	};
+}
+/**
+* Creates a ValueParser for parsing Temporal.PlainDateTime from ISO 8601 datetime strings.
+*
+* Accepts strings like:
+*
+* - `"2020-01-23T17:04:36"`
+* - `"2020-01-23T17:04:36.491865121"`
+*
+* @param options Configuration options for the plain datetime parser.
+* @returns A ValueParser that parses strings into Temporal.PlainDateTime values.
+*/
+function plainDateTime(options = {}) {
+	return {
+		metavar: options.metavar ?? "DATETIME",
+		parse(input) {
+			try {
+				const value = Temporal.PlainDateTime.from(input);
+				return {
+					success: true,
+					value
+				};
+			} catch {
+				return {
+					success: false,
+					error: message`Invalid datetime: ${input}. Expected ISO 8601 format like ${"2020-01-23T17:04:36"}.`
+				};
+			}
+		},
+		format(value) {
+			return value.toString();
+		}
+	};
+}
+/**
+* Creates a ValueParser for parsing Temporal.PlainYearMonth from ISO 8601 year-month strings.
+*
+* Accepts strings like:
+*
+* - `"2020-01"`
+* - `"2020-12"`
+*
+* @param options Configuration options for the plain year-month parser.
+* @returns A ValueParser that parses strings into Temporal.PlainYearMonth values.
+*/
+function plainYearMonth(options = {}) {
+	return {
+		metavar: options.metavar ?? "YEAR-MONTH",
+		parse(input) {
+			try {
+				const value = Temporal.PlainYearMonth.from(input);
+				return {
+					success: true,
+					value
+				};
+			} catch {
+				return {
+					success: false,
+					error: message`Invalid year-month: ${input}. Expected ISO 8601 format like ${"2020-01"}.`
+				};
+			}
+		},
+		format(value) {
+			return value.toString();
+		}
+	};
+}
+/**
+* Creates a ValueParser for parsing Temporal.PlainMonthDay from ISO 8601 month-day strings.
+*
+* Accepts strings like:
+*
+* - `"--01-23"`
+* - `"--12-31"`
+*
+* @param options Configuration options for the plain month-day parser.
+* @returns A ValueParser that parses strings into Temporal.PlainMonthDay values.
+*/
+function plainMonthDay(options = {}) {
+	return {
+		metavar: options.metavar ?? "--MONTH-DAY",
+		parse(input) {
+			try {
+				const value = Temporal.PlainMonthDay.from(input);
+				return {
+					success: true,
+					value
+				};
+			} catch {
+				return {
+					success: false,
+					error: message`Invalid month-day: ${input}. Expected ISO 8601 format like ${"--01-23"}.`
+				};
+			}
+		},
+		format(value) {
+			return value.toString();
+		}
+	};
+}
+/**
+* Creates a ValueParser for parsing IANA Time Zone Database identifiers.
+*
+* Accepts strings like:
+*
+* - `"Asia/Seoul"`
+* - `"America/New_York"`
+* - `"Europe/London"`
+* - `"UTC"`
+*
+* @param options Configuration options for the timezone parser.
+* @returns A ValueParser that parses and validates timezone identifiers.
+*/
+function timeZone(options = {}) {
+	return {
+		metavar: options.metavar ?? "TIMEZONE",
+		parse(input) {
+			try {
+				Temporal.ZonedDateTime.from({
+					year: 2020,
+					month: 1,
+					day: 1,
+					hour: 0,
+					minute: 0,
+					second: 0,
+					timeZone: input
+				});
+				return {
+					success: true,
+					value: input
+				};
+			} catch {
+				return {
+					success: false,
+					error: message`Invalid timezone identifier: ${input}. Must be a valid IANA timezone like "Asia/Seoul" or "UTC".`
+				};
+			}
+		},
+		format(value) {
+			return value;
+		}
+	};
+}
+
+//#endregion
+export { duration, instant, plainDate, plainDateTime, plainMonthDay, plainTime, plainYearMonth, timeZone, zonedDateTime };

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@optique/temporal",
+  "version": "0.4.0-dev.49+a1186942",
+  "description": "Temporal value parsers for Optique",
+  "keywords": [
+    "CLI",
+    "command-line",
+    "commandline",
+    "parser",
+    "temporal",
+    "time",
+    "datetime"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "Hong Minhee",
+    "email": "hong@minhee.org",
+    "url": "https://hongminhee.org/"
+  },
+  "homepage": "https://optique.dev/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dahlia/optique.git",
+    "directory": "packages/temporal/"
+  },
+  "bugs": {
+    "url": "https://github.com/dahlia/optique/issues"
+  },
+  "funding": [
+    "https://github.com/sponsors/dahlia"
+  ],
+  "engines": {
+    "node": ">=20.0.0",
+    "bun": ">=1.2.0",
+    "deno": ">=2.3.0"
+  },
+  "files": [
+    "dist/",
+    "package.json",
+    "README.md"
+  ],
+  "type": "module",
+  "module": "./dist/index.js",
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": {
+        "import": "./dist/index.d.ts",
+        "require": "./dist/index.d.cts"
+      },
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "sideEffects": false,
+  "dependencies": {
+    "@js-temporal/polyfill": "^0.5.1",
+    "@optique/core": ""
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.9",
+    "tsdown": "^0.13.0",
+    "typescript": "^5.8.3"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "prepublish": "tsdown",
+    "test": "tsdown && node --experimental-transform-types --test",
+    "test:bun": "tsdown && bun test",
+    "test:deno": "deno test",
+    "test-all": "tsdown && node --experimental-transform-types --test && bun test && deno test"
+  }
+}