@optique/temporal 0.10.7 → 1.0.0-dev.1109

package/README.md

@@ -1,9 +1,6 @@
 @optique/temporal
 =================
 
-> [!WARNING]
-> The API is stabilizing, but may change before the 1.0 release.
-
 Value parsers for [`Temporal`] date/time types. This package provides
 `ValueParser` functions that can be used with *@optique/core* to parse
 command-line arguments into `Temporal` objects like [`Temporal.Instant`],
@@ -39,12 +36,15 @@ The following example uses the `plainDate()` value parser to accept a date in
 
 ~~~~ typescript
 import { run } from "@optique/run";
-import { option } from "@optique/core/parser";
+import { object } from "@optique/core/constructs";
+import { option } from "@optique/core/primitives";
 import { plainDate } from "@optique/temporal";
 
-const cli = run({
-  birthday: option("--birthday", plainDate()),
-});
+const cli = run(
+  object({
+    birthday: option("--birthday", plainDate()),
+  }),
+);
 
 if (cli.birthday) {
   console.log(`Your next birthday is on ${cli.birthday.toLocaleString()}.`);

package/dist/index.cjs

@@ -26,6 +26,9 @@ const __optique_core_message = __toESM(require("@optique/core/message"));
 const __optique_core_nonempty = __toESM(require("@optique/core/nonempty"));
 
 //#region src/index.ts
+function ensureTemporal() {
+	if (typeof globalThis.Temporal === "undefined") throw new TypeError("Temporal API is not available. Use a runtime with Temporal support or install a polyfill like @js-temporal/polyfill.");
+}
 /**
 * Creates a ValueParser for parsing Temporal.Instant from ISO 8601 strings.
 *
@@ -36,6 +39,8 @@ const __optique_core_nonempty = __toESM(require("@optique/core/nonempty"));
 *
 * @param options Configuration options for the instant parser.
 * @returns A ValueParser that parses strings into Temporal.Instant values.
+* @throws {TypeError} (from `parse()`) If the Temporal API is not available
+*   at runtime.
 */
 function instant(options = {}) {
 	const metavar = options.metavar ?? "TIMESTAMP";
@@ -44,6 +49,7 @@ function instant(options = {}) {
 		$mode: "sync",
 		metavar,
 		parse(input) {
+			ensureTemporal();
 			try {
 				const value = Temporal.Instant.from(input);
 				return {
@@ -73,6 +79,8 @@ function instant(options = {}) {
 *
 * @param options Configuration options for the duration parser.
 * @returns A ValueParser that parses strings into Temporal.Duration values.
+* @throws {TypeError} (from `parse()`) If the Temporal API is not available
+*   at runtime.
 */
 function duration(options = {}) {
 	const metavar = options.metavar ?? "DURATION";
@@ -81,6 +89,7 @@ function duration(options = {}) {
 		$mode: "sync",
 		metavar,
 		parse(input) {
+			ensureTemporal();
 			try {
 				const value = Temporal.Duration.from(input);
 				return {
@@ -109,6 +118,8 @@ function duration(options = {}) {
 *
 * @param options Configuration options for the zoned datetime parser.
 * @returns A ValueParser that parses strings into Temporal.ZonedDateTime values.
+* @throws {TypeError} (from `parse()`) If the Temporal API is not available
+*   at runtime.
 */
 function zonedDateTime(options = {}) {
 	const metavar = options.metavar ?? "ZONED_DATETIME";
@@ -117,6 +128,7 @@ function zonedDateTime(options = {}) {
 		$mode: "sync",
 		metavar,
 		parse(input) {
+			ensureTemporal();
 			try {
 				const value = Temporal.ZonedDateTime.from(input);
 				return {
@@ -145,6 +157,8 @@ function zonedDateTime(options = {}) {
 *
 * @param options Configuration options for the plain date parser.
 * @returns A ValueParser that parses strings into Temporal.PlainDate values.
+* @throws {TypeError} (from `parse()`) If the Temporal API is not available
+*   at runtime.
 */
 function plainDate(options = {}) {
 	const metavar = options.metavar ?? "DATE";
@@ -153,6 +167,7 @@ function plainDate(options = {}) {
 		$mode: "sync",
 		metavar,
 		parse(input) {
+			ensureTemporal();
 			try {
 				const value = Temporal.PlainDate.from(input);
 				return {
@@ -181,6 +196,8 @@ function plainDate(options = {}) {
 *
 * @param options Configuration options for the plain time parser.
 * @returns A ValueParser that parses strings into Temporal.PlainTime values.
+* @throws {TypeError} (from `parse()`) If the Temporal API is not available
+*   at runtime.
 */
 function plainTime(options = {}) {
 	const metavar = options.metavar ?? "TIME";
@@ -189,6 +206,7 @@ function plainTime(options = {}) {
 		$mode: "sync",
 		metavar,
 		parse(input) {
+			ensureTemporal();
 			try {
 				const value = Temporal.PlainTime.from(input);
 				return {
@@ -217,6 +235,8 @@ function plainTime(options = {}) {
 *
 * @param options Configuration options for the plain datetime parser.
 * @returns A ValueParser that parses strings into Temporal.PlainDateTime values.
+* @throws {TypeError} (from `parse()`) If the Temporal API is not available
+*   at runtime.
 */
 function plainDateTime(options = {}) {
 	const metavar = options.metavar ?? "DATETIME";
@@ -225,6 +245,7 @@ function plainDateTime(options = {}) {
 		$mode: "sync",
 		metavar,
 		parse(input) {
+			ensureTemporal();
 			try {
 				const value = Temporal.PlainDateTime.from(input);
 				return {
@@ -253,6 +274,8 @@ function plainDateTime(options = {}) {
 *
 * @param options Configuration options for the plain year-month parser.
 * @returns A ValueParser that parses strings into Temporal.PlainYearMonth values.
+* @throws {TypeError} (from `parse()`) If the Temporal API is not available
+*   at runtime.
 */
 function plainYearMonth(options = {}) {
 	const metavar = options.metavar ?? "YEAR-MONTH";
@@ -261,6 +284,7 @@ function plainYearMonth(options = {}) {
 		$mode: "sync",
 		metavar,
 		parse(input) {
+			ensureTemporal();
 			try {
 				const value = Temporal.PlainYearMonth.from(input);
 				return {
@@ -289,6 +313,8 @@ function plainYearMonth(options = {}) {
 *
 * @param options Configuration options for the plain month-day parser.
 * @returns A ValueParser that parses strings into Temporal.PlainMonthDay values.
+* @throws {TypeError} (from `parse()`) If the Temporal API is not available
+*   at runtime.
 */
 function plainMonthDay(options = {}) {
 	const metavar = options.metavar ?? "--MONTH-DAY";
@@ -297,6 +323,7 @@ function plainMonthDay(options = {}) {
 		$mode: "sync",
 		metavar,
 		parse(input) {
+			ensureTemporal();
 			try {
 				const value = Temporal.PlainMonthDay.from(input);
 				return {
@@ -316,6 +343,59 @@ function plainMonthDay(options = {}) {
 	};
 }
 /**
+* Single-segment IANA timezone identifiers accepted across all supported
+* runtimes (Deno, Node.js, Bun).  This tuple is the single source of truth:
+* {@link SingleSegmentTimeZone} is derived from it, and the runtime lookup
+* {@link singleSegmentTimeZoneLookup} is built from it.
+*/
+const singleSegmentTimeZoneList = [
+	"UTC",
+	"GMT",
+	"GMT0",
+	"GMT+0",
+	"GMT-0",
+	"UCT",
+	"Universal",
+	"Greenwich",
+	"Zulu",
+	"EST",
+	"MST",
+	"HST",
+	"CET",
+	"MET",
+	"WET",
+	"EET",
+	"EST5EDT",
+	"CST6CDT",
+	"MST7MDT",
+	"PST8PDT",
+	"Cuba",
+	"Egypt",
+	"Eire",
+	"GB",
+	"GB-Eire",
+	"Hongkong",
+	"Iceland",
+	"Iran",
+	"Israel",
+	"Jamaica",
+	"Japan",
+	"Kwajalein",
+	"Libya",
+	"Navajo",
+	"NZ",
+	"NZ-CHAT",
+	"Poland",
+	"Portugal",
+	"PRC",
+	"ROC",
+	"ROK",
+	"Singapore",
+	"Turkey",
+	"W-SU"
+];
+const singleSegmentTimeZoneLookup = new Map(singleSegmentTimeZoneList.map((timeZone$1) => [timeZone$1.toLowerCase(), timeZone$1]));
+/**
 * Creates a ValueParser for parsing IANA Time Zone Database identifiers.
 *
 * Accepts strings like:
@@ -324,9 +404,13 @@ function plainMonthDay(options = {}) {
 * - `"America/New_York"`
 * - `"Europe/London"`
 * - `"UTC"`
+* - `"GMT"`
+* - `"EST"`
 *
 * @param options Configuration options for the timezone parser.
 * @returns A ValueParser that parses and validates timezone identifiers.
+* @throws {TypeError} (from `parse()`) If the Temporal API is not available
+*   at runtime.
 */
 function timeZone(options = {}) {
 	const metavar = options.metavar ?? "TIMEZONE";
@@ -335,6 +419,7 @@ function timeZone(options = {}) {
 		$mode: "sync",
 		metavar,
 		parse(input) {
+			ensureTemporal();
 			try {
 				Temporal.ZonedDateTime.from({
 					year: 2020,
@@ -342,6 +427,14 @@ function timeZone(options = {}) {
 					day: 1,
 					timeZone: input
 				});
+				if (!input.includes("/")) {
+					const canonical = singleSegmentTimeZoneLookup.get(input.toLowerCase());
+					if (canonical == null) throw new RangeError();
+					return {
+						success: true,
+						value: canonical
+					};
+				}
 				return {
 					success: true,
 					value: input

package/dist/index.d.cts

@@ -11,17 +11,21 @@ import { NonEmptyString } from "@optique/core/nonempty";
  * convention:
  *
  * - Two-level: `"Asia/Seoul"`, `"America/New_York"`, `"Europe/London"`
- * - Three-level: `"America/Argentina/Buenos_Aires"`, `"America/Kentucky/Louisville"`
- * - Special case: `"UTC"`
+ * - Three-level: `"America/Argentina/Buenos_Aires"`,
+ *   `"America/Kentucky/Louisville"`
+ * - Standard single-segment: `"UTC"`, `"GMT"`, `"Universal"`
+ * - POSIX abbreviations: `"EST"`, `"CET"`, `"EST5EDT"`
+ * - Deprecated aliases: `"Japan"`, `"Singapore"`, `"Cuba"`
  *
  * @example
  * ```typescript
  * const seoul: TimeZone = "Asia/Seoul";
  * const utc: TimeZone = "UTC";
+ * const gmt: TimeZone = "GMT";
  * const buenosAires: TimeZone = "America/Argentina/Buenos_Aires";
  * ```
  */
-type TimeZone = `${string}/${string}/${string}` | `${string}/${string}` | "UTC";
+type TimeZone = `${string}/${string}/${string}` | `${string}/${string}` | SingleSegmentTimeZone;
 /**
  * Options for creating an instant parser.
  */
@@ -248,6 +252,8 @@ interface TimeZoneOptions {
  *
  * @param options Configuration options for the instant parser.
  * @returns A ValueParser that parses strings into Temporal.Instant values.
+ * @throws {TypeError} (from `parse()`) If the Temporal API is not available
+ *   at runtime.
  */
 declare function instant(options?: InstantOptions): ValueParser<"sync", Temporal.Instant>;
 /**
@@ -261,6 +267,8 @@ declare function instant(options?: InstantOptions): ValueParser<"sync", Temporal
  *
  * @param options Configuration options for the duration parser.
  * @returns A ValueParser that parses strings into Temporal.Duration values.
+ * @throws {TypeError} (from `parse()`) If the Temporal API is not available
+ *   at runtime.
  */
 declare function duration(options?: DurationOptions): ValueParser<"sync", Temporal.Duration>;
 /**
@@ -273,6 +281,8 @@ declare function duration(options?: DurationOptions): ValueParser<"sync", Tempor
  *
  * @param options Configuration options for the zoned datetime parser.
  * @returns A ValueParser that parses strings into Temporal.ZonedDateTime values.
+ * @throws {TypeError} (from `parse()`) If the Temporal API is not available
+ *   at runtime.
  */
 declare function zonedDateTime(options?: ZonedDateTimeOptions): ValueParser<"sync", Temporal.ZonedDateTime>;
 /**
@@ -285,6 +295,8 @@ declare function zonedDateTime(options?: ZonedDateTimeOptions): ValueParser<"syn
  *
  * @param options Configuration options for the plain date parser.
  * @returns A ValueParser that parses strings into Temporal.PlainDate values.
+ * @throws {TypeError} (from `parse()`) If the Temporal API is not available
+ *   at runtime.
  */
 declare function plainDate(options?: PlainDateOptions): ValueParser<"sync", Temporal.PlainDate>;
 /**
@@ -297,6 +309,8 @@ declare function plainDate(options?: PlainDateOptions): ValueParser<"sync", Temp
  *
  * @param options Configuration options for the plain time parser.
  * @returns A ValueParser that parses strings into Temporal.PlainTime values.
+ * @throws {TypeError} (from `parse()`) If the Temporal API is not available
+ *   at runtime.
  */
 declare function plainTime(options?: PlainTimeOptions): ValueParser<"sync", Temporal.PlainTime>;
 /**
@@ -309,6 +323,8 @@ declare function plainTime(options?: PlainTimeOptions): ValueParser<"sync", Temp
  *
  * @param options Configuration options for the plain datetime parser.
  * @returns A ValueParser that parses strings into Temporal.PlainDateTime values.
+ * @throws {TypeError} (from `parse()`) If the Temporal API is not available
+ *   at runtime.
  */
 declare function plainDateTime(options?: PlainDateTimeOptions): ValueParser<"sync", Temporal.PlainDateTime>;
 /**
@@ -321,6 +337,8 @@ declare function plainDateTime(options?: PlainDateTimeOptions): ValueParser<"syn
  *
  * @param options Configuration options for the plain year-month parser.
  * @returns A ValueParser that parses strings into Temporal.PlainYearMonth values.
+ * @throws {TypeError} (from `parse()`) If the Temporal API is not available
+ *   at runtime.
  */
 declare function plainYearMonth(options?: PlainYearMonthOptions): ValueParser<"sync", Temporal.PlainYearMonth>;
 /**
@@ -333,8 +351,18 @@ declare function plainYearMonth(options?: PlainYearMonthOptions): ValueParser<"s
  *
  * @param options Configuration options for the plain month-day parser.
  * @returns A ValueParser that parses strings into Temporal.PlainMonthDay values.
+ * @throws {TypeError} (from `parse()`) If the Temporal API is not available
+ *   at runtime.
  */
 declare function plainMonthDay(options?: PlainMonthDayOptions): ValueParser<"sync", Temporal.PlainMonthDay>;
+/**
+ * Single-segment IANA timezone identifiers accepted across all supported
+ * runtimes (Deno, Node.js, Bun).  This tuple is the single source of truth:
+ * {@link SingleSegmentTimeZone} is derived from it, and the runtime lookup
+ * {@link singleSegmentTimeZoneLookup} is built from it.
+ */
+declare const singleSegmentTimeZoneList: readonly ["UTC", "GMT", "GMT0", "GMT+0", "GMT-0", "UCT", "Universal", "Greenwich", "Zulu", "EST", "MST", "HST", "CET", "MET", "WET", "EET", "EST5EDT", "CST6CDT", "MST7MDT", "PST8PDT", "Cuba", "Egypt", "Eire", "GB", "GB-Eire", "Hongkong", "Iceland", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "Navajo", "NZ", "NZ-CHAT", "Poland", "Portugal", "PRC", "ROC", "ROK", "Singapore", "Turkey", "W-SU"];
+type SingleSegmentTimeZone = typeof singleSegmentTimeZoneList[number];
 /**
  * Creates a ValueParser for parsing IANA Time Zone Database identifiers.
  *
@@ -344,9 +372,13 @@ declare function plainMonthDay(options?: PlainMonthDayOptions): ValueParser<"syn
  * - `"America/New_York"`
  * - `"Europe/London"`
  * - `"UTC"`
+ * - `"GMT"`
+ * - `"EST"`
  *
  * @param options Configuration options for the timezone parser.
  * @returns A ValueParser that parses and validates timezone identifiers.
+ * @throws {TypeError} (from `parse()`) If the Temporal API is not available
+ *   at runtime.
  */
 declare function timeZone(options?: TimeZoneOptions): ValueParser<"sync", TimeZone>;
 //#endregion

package/dist/index.d.ts

@@ -12,17 +12,21 @@ import { ValueParser } from "@optique/core/valueparser";
  * convention:
  *
  * - Two-level: `"Asia/Seoul"`, `"America/New_York"`, `"Europe/London"`
- * - Three-level: `"America/Argentina/Buenos_Aires"`, `"America/Kentucky/Louisville"`
- * - Special case: `"UTC"`
+ * - Three-level: `"America/Argentina/Buenos_Aires"`,
+ *   `"America/Kentucky/Louisville"`
+ * - Standard single-segment: `"UTC"`, `"GMT"`, `"Universal"`
+ * - POSIX abbreviations: `"EST"`, `"CET"`, `"EST5EDT"`
+ * - Deprecated aliases: `"Japan"`, `"Singapore"`, `"Cuba"`
  *
  * @example
  * ```typescript
  * const seoul: TimeZone = "Asia/Seoul";
  * const utc: TimeZone = "UTC";
+ * const gmt: TimeZone = "GMT";
  * const buenosAires: TimeZone = "America/Argentina/Buenos_Aires";
  * ```
  */
-type TimeZone = `${string}/${string}/${string}` | `${string}/${string}` | "UTC";
+type TimeZone = `${string}/${string}/${string}` | `${string}/${string}` | SingleSegmentTimeZone;
 /**
  * Options for creating an instant parser.
  */
@@ -249,6 +253,8 @@ interface TimeZoneOptions {
  *
  * @param options Configuration options for the instant parser.
  * @returns A ValueParser that parses strings into Temporal.Instant values.
+ * @throws {TypeError} (from `parse()`) If the Temporal API is not available
+ *   at runtime.
  */
 declare function instant(options?: InstantOptions): ValueParser<"sync", Temporal.Instant>;
 /**
@@ -262,6 +268,8 @@ declare function instant(options?: InstantOptions): ValueParser<"sync", Temporal
  *
  * @param options Configuration options for the duration parser.
  * @returns A ValueParser that parses strings into Temporal.Duration values.
+ * @throws {TypeError} (from `parse()`) If the Temporal API is not available
+ *   at runtime.
  */
 declare function duration(options?: DurationOptions): ValueParser<"sync", Temporal.Duration>;
 /**
@@ -274,6 +282,8 @@ declare function duration(options?: DurationOptions): ValueParser<"sync", Tempor
  *
  * @param options Configuration options for the zoned datetime parser.
  * @returns A ValueParser that parses strings into Temporal.ZonedDateTime values.
+ * @throws {TypeError} (from `parse()`) If the Temporal API is not available
+ *   at runtime.
  */
 declare function zonedDateTime(options?: ZonedDateTimeOptions): ValueParser<"sync", Temporal.ZonedDateTime>;
 /**
@@ -286,6 +296,8 @@ declare function zonedDateTime(options?: ZonedDateTimeOptions): ValueParser<"syn
  *
  * @param options Configuration options for the plain date parser.
  * @returns A ValueParser that parses strings into Temporal.PlainDate values.
+ * @throws {TypeError} (from `parse()`) If the Temporal API is not available
+ *   at runtime.
  */
 declare function plainDate(options?: PlainDateOptions): ValueParser<"sync", Temporal.PlainDate>;
 /**
@@ -298,6 +310,8 @@ declare function plainDate(options?: PlainDateOptions): ValueParser<"sync", Temp
  *
  * @param options Configuration options for the plain time parser.
  * @returns A ValueParser that parses strings into Temporal.PlainTime values.
+ * @throws {TypeError} (from `parse()`) If the Temporal API is not available
+ *   at runtime.
  */
 declare function plainTime(options?: PlainTimeOptions): ValueParser<"sync", Temporal.PlainTime>;
 /**
@@ -310,6 +324,8 @@ declare function plainTime(options?: PlainTimeOptions): ValueParser<"sync", Temp
  *
  * @param options Configuration options for the plain datetime parser.
  * @returns A ValueParser that parses strings into Temporal.PlainDateTime values.
+ * @throws {TypeError} (from `parse()`) If the Temporal API is not available
+ *   at runtime.
  */
 declare function plainDateTime(options?: PlainDateTimeOptions): ValueParser<"sync", Temporal.PlainDateTime>;
 /**
@@ -322,6 +338,8 @@ declare function plainDateTime(options?: PlainDateTimeOptions): ValueParser<"syn
  *
  * @param options Configuration options for the plain year-month parser.
  * @returns A ValueParser that parses strings into Temporal.PlainYearMonth values.
+ * @throws {TypeError} (from `parse()`) If the Temporal API is not available
+ *   at runtime.
  */
 declare function plainYearMonth(options?: PlainYearMonthOptions): ValueParser<"sync", Temporal.PlainYearMonth>;
 /**
@@ -334,8 +352,18 @@ declare function plainYearMonth(options?: PlainYearMonthOptions): ValueParser<"s
  *
  * @param options Configuration options for the plain month-day parser.
  * @returns A ValueParser that parses strings into Temporal.PlainMonthDay values.
+ * @throws {TypeError} (from `parse()`) If the Temporal API is not available
+ *   at runtime.
  */
 declare function plainMonthDay(options?: PlainMonthDayOptions): ValueParser<"sync", Temporal.PlainMonthDay>;
+/**
+ * Single-segment IANA timezone identifiers accepted across all supported
+ * runtimes (Deno, Node.js, Bun).  This tuple is the single source of truth:
+ * {@link SingleSegmentTimeZone} is derived from it, and the runtime lookup
+ * {@link singleSegmentTimeZoneLookup} is built from it.
+ */
+declare const singleSegmentTimeZoneList: readonly ["UTC", "GMT", "GMT0", "GMT+0", "GMT-0", "UCT", "Universal", "Greenwich", "Zulu", "EST", "MST", "HST", "CET", "MET", "WET", "EET", "EST5EDT", "CST6CDT", "MST7MDT", "PST8PDT", "Cuba", "Egypt", "Eire", "GB", "GB-Eire", "Hongkong", "Iceland", "Iran", "Israel", "Jamaica", "Japan", "Kwajalein", "Libya", "Navajo", "NZ", "NZ-CHAT", "Poland", "Portugal", "PRC", "ROC", "ROK", "Singapore", "Turkey", "W-SU"];
+type SingleSegmentTimeZone = typeof singleSegmentTimeZoneList[number];
 /**
  * Creates a ValueParser for parsing IANA Time Zone Database identifiers.
  *
@@ -345,9 +373,13 @@ declare function plainMonthDay(options?: PlainMonthDayOptions): ValueParser<"syn
  * - `"America/New_York"`
  * - `"Europe/London"`
  * - `"UTC"`
+ * - `"GMT"`
+ * - `"EST"`
  *
  * @param options Configuration options for the timezone parser.
  * @returns A ValueParser that parses and validates timezone identifiers.
+ * @throws {TypeError} (from `parse()`) If the Temporal API is not available
+ *   at runtime.
  */
 declare function timeZone(options?: TimeZoneOptions): ValueParser<"sync", TimeZone>;
 //#endregion

package/dist/index.js

@@ -3,6 +3,9 @@ import { message } from "@optique/core/message";
 import { ensureNonEmptyString } from "@optique/core/nonempty";
 
 //#region src/index.ts
+function ensureTemporal() {
+	if (typeof globalThis.Temporal === "undefined") throw new TypeError("Temporal API is not available. Use a runtime with Temporal support or install a polyfill like @js-temporal/polyfill.");
+}
 /**
 * Creates a ValueParser for parsing Temporal.Instant from ISO 8601 strings.
 *
@@ -13,6 +16,8 @@ import { ensureNonEmptyString } from "@optique/core/nonempty";
 *
 * @param options Configuration options for the instant parser.
 * @returns A ValueParser that parses strings into Temporal.Instant values.
+* @throws {TypeError} (from `parse()`) If the Temporal API is not available
+*   at runtime.
 */
 function instant(options = {}) {
 	const metavar = options.metavar ?? "TIMESTAMP";
@@ -21,6 +26,7 @@ function instant(options = {}) {
 		$mode: "sync",
 		metavar,
 		parse(input) {
+			ensureTemporal();
 			try {
 				const value = Temporal.Instant.from(input);
 				return {
@@ -50,6 +56,8 @@ function instant(options = {}) {
 *
 * @param options Configuration options for the duration parser.
 * @returns A ValueParser that parses strings into Temporal.Duration values.
+* @throws {TypeError} (from `parse()`) If the Temporal API is not available
+*   at runtime.
 */
 function duration(options = {}) {
 	const metavar = options.metavar ?? "DURATION";
@@ -58,6 +66,7 @@ function duration(options = {}) {
 		$mode: "sync",
 		metavar,
 		parse(input) {
+			ensureTemporal();
 			try {
 				const value = Temporal.Duration.from(input);
 				return {
@@ -86,6 +95,8 @@ function duration(options = {}) {
 *
 * @param options Configuration options for the zoned datetime parser.
 * @returns A ValueParser that parses strings into Temporal.ZonedDateTime values.
+* @throws {TypeError} (from `parse()`) If the Temporal API is not available
+*   at runtime.
 */
 function zonedDateTime(options = {}) {
 	const metavar = options.metavar ?? "ZONED_DATETIME";
@@ -94,6 +105,7 @@ function zonedDateTime(options = {}) {
 		$mode: "sync",
 		metavar,
 		parse(input) {
+			ensureTemporal();
 			try {
 				const value = Temporal.ZonedDateTime.from(input);
 				return {
@@ -122,6 +134,8 @@ function zonedDateTime(options = {}) {
 *
 * @param options Configuration options for the plain date parser.
 * @returns A ValueParser that parses strings into Temporal.PlainDate values.
+* @throws {TypeError} (from `parse()`) If the Temporal API is not available
+*   at runtime.
 */
 function plainDate(options = {}) {
 	const metavar = options.metavar ?? "DATE";
@@ -130,6 +144,7 @@ function plainDate(options = {}) {
 		$mode: "sync",
 		metavar,
 		parse(input) {
+			ensureTemporal();
 			try {
 				const value = Temporal.PlainDate.from(input);
 				return {
@@ -158,6 +173,8 @@ function plainDate(options = {}) {
 *
 * @param options Configuration options for the plain time parser.
 * @returns A ValueParser that parses strings into Temporal.PlainTime values.
+* @throws {TypeError} (from `parse()`) If the Temporal API is not available
+*   at runtime.
 */
 function plainTime(options = {}) {
 	const metavar = options.metavar ?? "TIME";
@@ -166,6 +183,7 @@ function plainTime(options = {}) {
 		$mode: "sync",
 		metavar,
 		parse(input) {
+			ensureTemporal();
 			try {
 				const value = Temporal.PlainTime.from(input);
 				return {
@@ -194,6 +212,8 @@ function plainTime(options = {}) {
 *
 * @param options Configuration options for the plain datetime parser.
 * @returns A ValueParser that parses strings into Temporal.PlainDateTime values.
+* @throws {TypeError} (from `parse()`) If the Temporal API is not available
+*   at runtime.
 */
 function plainDateTime(options = {}) {
 	const metavar = options.metavar ?? "DATETIME";
@@ -202,6 +222,7 @@ function plainDateTime(options = {}) {
 		$mode: "sync",
 		metavar,
 		parse(input) {
+			ensureTemporal();
 			try {
 				const value = Temporal.PlainDateTime.from(input);
 				return {
@@ -230,6 +251,8 @@ function plainDateTime(options = {}) {
 *
 * @param options Configuration options for the plain year-month parser.
 * @returns A ValueParser that parses strings into Temporal.PlainYearMonth values.
+* @throws {TypeError} (from `parse()`) If the Temporal API is not available
+*   at runtime.
 */
 function plainYearMonth(options = {}) {
 	const metavar = options.metavar ?? "YEAR-MONTH";
@@ -238,6 +261,7 @@ function plainYearMonth(options = {}) {
 		$mode: "sync",
 		metavar,
 		parse(input) {
+			ensureTemporal();
 			try {
 				const value = Temporal.PlainYearMonth.from(input);
 				return {
@@ -266,6 +290,8 @@ function plainYearMonth(options = {}) {
 *
 * @param options Configuration options for the plain month-day parser.
 * @returns A ValueParser that parses strings into Temporal.PlainMonthDay values.
+* @throws {TypeError} (from `parse()`) If the Temporal API is not available
+*   at runtime.
 */
 function plainMonthDay(options = {}) {
 	const metavar = options.metavar ?? "--MONTH-DAY";
@@ -274,6 +300,7 @@ function plainMonthDay(options = {}) {
 		$mode: "sync",
 		metavar,
 		parse(input) {
+			ensureTemporal();
 			try {
 				const value = Temporal.PlainMonthDay.from(input);
 				return {
@@ -293,6 +320,59 @@ function plainMonthDay(options = {}) {
 	};
 }
 /**
+* Single-segment IANA timezone identifiers accepted across all supported
+* runtimes (Deno, Node.js, Bun).  This tuple is the single source of truth:
+* {@link SingleSegmentTimeZone} is derived from it, and the runtime lookup
+* {@link singleSegmentTimeZoneLookup} is built from it.
+*/
+const singleSegmentTimeZoneList = [
+	"UTC",
+	"GMT",
+	"GMT0",
+	"GMT+0",
+	"GMT-0",
+	"UCT",
+	"Universal",
+	"Greenwich",
+	"Zulu",
+	"EST",
+	"MST",
+	"HST",
+	"CET",
+	"MET",
+	"WET",
+	"EET",
+	"EST5EDT",
+	"CST6CDT",
+	"MST7MDT",
+	"PST8PDT",
+	"Cuba",
+	"Egypt",
+	"Eire",
+	"GB",
+	"GB-Eire",
+	"Hongkong",
+	"Iceland",
+	"Iran",
+	"Israel",
+	"Jamaica",
+	"Japan",
+	"Kwajalein",
+	"Libya",
+	"Navajo",
+	"NZ",
+	"NZ-CHAT",
+	"Poland",
+	"Portugal",
+	"PRC",
+	"ROC",
+	"ROK",
+	"Singapore",
+	"Turkey",
+	"W-SU"
+];
+const singleSegmentTimeZoneLookup = new Map(singleSegmentTimeZoneList.map((timeZone$1) => [timeZone$1.toLowerCase(), timeZone$1]));
+/**
 * Creates a ValueParser for parsing IANA Time Zone Database identifiers.
 *
 * Accepts strings like:
@@ -301,9 +381,13 @@ function plainMonthDay(options = {}) {
 * - `"America/New_York"`
 * - `"Europe/London"`
 * - `"UTC"`
+* - `"GMT"`
+* - `"EST"`
 *
 * @param options Configuration options for the timezone parser.
 * @returns A ValueParser that parses and validates timezone identifiers.
+* @throws {TypeError} (from `parse()`) If the Temporal API is not available
+*   at runtime.
 */
 function timeZone(options = {}) {
 	const metavar = options.metavar ?? "TIMEZONE";
@@ -312,6 +396,7 @@ function timeZone(options = {}) {
 		$mode: "sync",
 		metavar,
 		parse(input) {
+			ensureTemporal();
 			try {
 				Temporal.ZonedDateTime.from({
 					year: 2020,
@@ -319,6 +404,14 @@ function timeZone(options = {}) {
 					day: 1,
 					timeZone: input
 				});
+				if (!input.includes("/")) {
+					const canonical = singleSegmentTimeZoneLookup.get(input.toLowerCase());
+					if (canonical == null) throw new RangeError();
+					return {
+						success: true,
+						value: canonical
+					};
+				}
 				return {
 					success: true,
 					value: input

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/temporal",
-  "version": "0.10.7",
+  "version": "1.0.0-dev.1109+fa132665",
   "description": "Temporal value parsers for Optique",
   "keywords": [
     "CLI",
@@ -56,7 +56,7 @@
   "sideEffects": false,
   "dependencies": {
     "@js-temporal/polyfill": "^0.5.1",
-    "@optique/core": "0.10.7"
+    "@optique/core": "1.0.0-dev.1109+fa132665"
   },
   "devDependencies": {
     "@types/node": "^20.19.9",