@optique/temporal 1.0.0-dev.1136 → 1.0.0-dev.1155

package/dist/index.cjs

@@ -148,6 +148,64 @@ function zonedDateTime(options = {}) {
 	};
 }
 /**
+* Optional RFC 9557 calendar annotation suffix, e.g. `[u-ca=gregory]`.
+* Accepts case-insensitive values and the optional critical flag (`!`).
+* Used by all plain Temporal regexes to accept `toString()` output for
+* non-ISO calendars.
+*/
+const CALENDAR_ANNOTATION = String.raw`(\[!?u-ca=[a-zA-Z0-9\-]+\])?`;
+/**
+* Required RFC 9557 calendar annotation (non-optional variant used when the
+* annotation must be present, e.g. for reference-day/year forms).
+*/
+const CALENDAR_ANNOTATION_REQUIRED = String.raw`\[!?u-ca=[a-zA-Z0-9\-]+\]`;
+/**
+* Year portion: either 4 digits (`YYYY`) or a sign-prefixed 6-digit expanded
+* year (`+YYYYYY` / `-YYYYYY`).
+*/
+const YEAR = String.raw`([+-]\d{6}|\d{4})`;
+/** ISO 8601 fractional seconds with `.` or `,` separator. */
+const FRACTIONAL = String.raw`[.,]\d+`;
+/** Extended date: `YYYY-MM-DD` or `±YYYYYY-MM-DD`. */
+const DATE_EXTENDED = `${YEAR}-\\d{2}-\\d{2}`;
+/** Basic date: `YYYYMMDD` or `±YYYYYYMMDD`. */
+const DATE_BASIC = `${YEAR}\\d{4}`;
+/** Extended time: `HH:MM[:SS[.frac]]`. */
+const TIME_EXTENDED = `\\d{2}:\\d{2}(:\\d{2}(${FRACTIONAL})?)?`;
+/** Basic time: `HH`, `HHMM`, or `HHMMSS[.frac]`. */
+const TIME_BASIC = `\\d{2}(\\d{2}(\\d{2}(${FRACTIONAL})?)?)?`;
+/**
+* Matches YYYY-MM-DD (extended) or YYYYMMDD (basic) date forms only (no time
+* component).  Both forms accept expanded years and calendar annotations.
+*/
+const PLAIN_DATE_RE = /* @__PURE__ */ new RegExp(`^(${DATE_EXTENDED}|${DATE_BASIC})${CALENDAR_ANNOTATION}$`);
+/**
+* Matches time forms only (no date prefix).  Accepts extended
+* (`HH:MM[:SS[.frac]]`), basic (`HH`, `HHMM`, `HHMMSS[.frac]`), and
+* `T`-prefixed variants.  Calendar annotations are accepted for consistency
+* with `Temporal.PlainTime.from()` on polyfill runtimes.
+*/
+const PLAIN_TIME_RE = /* @__PURE__ */ new RegExp(`^[Tt]?(${TIME_EXTENDED}|${TIME_BASIC})${CALENDAR_ANNOTATION}$`);
+/**
+* Matches date-time strings with both date and time parts.  Accepts extended,
+* basic, and mixed forms (e.g. `2020-01-23T170436`).  The separator may be
+* `T`, `t`, or a space.  The time portion may be reduced-precision (hour
+* only).
+*/
+const PLAIN_DATETIME_RE = /* @__PURE__ */ new RegExp(`^(${DATE_EXTENDED}|${DATE_BASIC})[Tt ](${TIME_EXTENDED}|${TIME_BASIC})${CALENDAR_ANNOTATION}$`);
+/**
+* Matches YYYY-MM (extended) or YYYYMM (basic), or a full date
+* (extended or basic) with a required calendar annotation (the reference day
+* is emitted by `toString()` for non-ISO calendars).
+*/
+const PLAIN_YEAR_MONTH_RE = /* @__PURE__ */ new RegExp(`^(${YEAR}-\\d{2}(${CALENDAR_ANNOTATION}|-\\d{2}${CALENDAR_ANNOTATION_REQUIRED})|${YEAR}\\d{2}(${CALENDAR_ANNOTATION}|\\d{2}${CALENDAR_ANNOTATION_REQUIRED}))$`);
+/**
+* Matches MM-DD, --MM-DD, MMDD, or --MMDD month-day forms, or a full date
+* (extended or basic) with a required calendar annotation (the reference year
+* is emitted by `toString()` for non-ISO calendars).
+*/
+const PLAIN_MONTH_DAY_RE = /* @__PURE__ */ new RegExp(`^((--)?(\\d{2}-\\d{2}|\\d{4})${CALENDAR_ANNOTATION}|(${DATE_EXTENDED}|${DATE_BASIC})${CALENDAR_ANNOTATION_REQUIRED})$`);
+/**
 * Creates a ValueParser for parsing Temporal.PlainDate from ISO 8601 date strings.
 *
 * Accepts strings like:
@@ -169,6 +227,7 @@ function plainDate(options = {}) {
 		parse(input) {
 			ensureTemporal();
 			try {
+				if (!PLAIN_DATE_RE.test(input)) throw new RangeError();
 				const value = Temporal.PlainDate.from(input);
 				return {
 					success: true,
@@ -208,6 +267,7 @@ function plainTime(options = {}) {
 		parse(input) {
 			ensureTemporal();
 			try {
+				if (!PLAIN_TIME_RE.test(input)) throw new RangeError();
 				const value = Temporal.PlainTime.from(input);
 				return {
 					success: true,
@@ -247,6 +307,7 @@ function plainDateTime(options = {}) {
 		parse(input) {
 			ensureTemporal();
 			try {
+				if (!PLAIN_DATETIME_RE.test(input)) throw new RangeError();
 				const value = Temporal.PlainDateTime.from(input);
 				return {
 					success: true,
@@ -286,6 +347,7 @@ function plainYearMonth(options = {}) {
 		parse(input) {
 			ensureTemporal();
 			try {
+				if (!PLAIN_YEAR_MONTH_RE.test(input)) throw new RangeError();
 				const value = Temporal.PlainYearMonth.from(input);
 				return {
 					success: true,
@@ -325,6 +387,7 @@ function plainMonthDay(options = {}) {
 		parse(input) {
 			ensureTemporal();
 			try {
+				if (!PLAIN_MONTH_DAY_RE.test(input)) throw new RangeError();
 				const value = Temporal.PlainMonthDay.from(input);
 				return {
 					success: true,

package/dist/index.js

@@ -125,6 +125,64 @@ function zonedDateTime(options = {}) {
 	};
 }
 /**
+* Optional RFC 9557 calendar annotation suffix, e.g. `[u-ca=gregory]`.
+* Accepts case-insensitive values and the optional critical flag (`!`).
+* Used by all plain Temporal regexes to accept `toString()` output for
+* non-ISO calendars.
+*/
+const CALENDAR_ANNOTATION = String.raw`(\[!?u-ca=[a-zA-Z0-9\-]+\])?`;
+/**
+* Required RFC 9557 calendar annotation (non-optional variant used when the
+* annotation must be present, e.g. for reference-day/year forms).
+*/
+const CALENDAR_ANNOTATION_REQUIRED = String.raw`\[!?u-ca=[a-zA-Z0-9\-]+\]`;
+/**
+* Year portion: either 4 digits (`YYYY`) or a sign-prefixed 6-digit expanded
+* year (`+YYYYYY` / `-YYYYYY`).
+*/
+const YEAR = String.raw`([+-]\d{6}|\d{4})`;
+/** ISO 8601 fractional seconds with `.` or `,` separator. */
+const FRACTIONAL = String.raw`[.,]\d+`;
+/** Extended date: `YYYY-MM-DD` or `±YYYYYY-MM-DD`. */
+const DATE_EXTENDED = `${YEAR}-\\d{2}-\\d{2}`;
+/** Basic date: `YYYYMMDD` or `±YYYYYYMMDD`. */
+const DATE_BASIC = `${YEAR}\\d{4}`;
+/** Extended time: `HH:MM[:SS[.frac]]`. */
+const TIME_EXTENDED = `\\d{2}:\\d{2}(:\\d{2}(${FRACTIONAL})?)?`;
+/** Basic time: `HH`, `HHMM`, or `HHMMSS[.frac]`. */
+const TIME_BASIC = `\\d{2}(\\d{2}(\\d{2}(${FRACTIONAL})?)?)?`;
+/**
+* Matches YYYY-MM-DD (extended) or YYYYMMDD (basic) date forms only (no time
+* component).  Both forms accept expanded years and calendar annotations.
+*/
+const PLAIN_DATE_RE = /* @__PURE__ */ new RegExp(`^(${DATE_EXTENDED}|${DATE_BASIC})${CALENDAR_ANNOTATION}$`);
+/**
+* Matches time forms only (no date prefix).  Accepts extended
+* (`HH:MM[:SS[.frac]]`), basic (`HH`, `HHMM`, `HHMMSS[.frac]`), and
+* `T`-prefixed variants.  Calendar annotations are accepted for consistency
+* with `Temporal.PlainTime.from()` on polyfill runtimes.
+*/
+const PLAIN_TIME_RE = /* @__PURE__ */ new RegExp(`^[Tt]?(${TIME_EXTENDED}|${TIME_BASIC})${CALENDAR_ANNOTATION}$`);
+/**
+* Matches date-time strings with both date and time parts.  Accepts extended,
+* basic, and mixed forms (e.g. `2020-01-23T170436`).  The separator may be
+* `T`, `t`, or a space.  The time portion may be reduced-precision (hour
+* only).
+*/
+const PLAIN_DATETIME_RE = /* @__PURE__ */ new RegExp(`^(${DATE_EXTENDED}|${DATE_BASIC})[Tt ](${TIME_EXTENDED}|${TIME_BASIC})${CALENDAR_ANNOTATION}$`);
+/**
+* Matches YYYY-MM (extended) or YYYYMM (basic), or a full date
+* (extended or basic) with a required calendar annotation (the reference day
+* is emitted by `toString()` for non-ISO calendars).
+*/
+const PLAIN_YEAR_MONTH_RE = /* @__PURE__ */ new RegExp(`^(${YEAR}-\\d{2}(${CALENDAR_ANNOTATION}|-\\d{2}${CALENDAR_ANNOTATION_REQUIRED})|${YEAR}\\d{2}(${CALENDAR_ANNOTATION}|\\d{2}${CALENDAR_ANNOTATION_REQUIRED}))$`);
+/**
+* Matches MM-DD, --MM-DD, MMDD, or --MMDD month-day forms, or a full date
+* (extended or basic) with a required calendar annotation (the reference year
+* is emitted by `toString()` for non-ISO calendars).
+*/
+const PLAIN_MONTH_DAY_RE = /* @__PURE__ */ new RegExp(`^((--)?(\\d{2}-\\d{2}|\\d{4})${CALENDAR_ANNOTATION}|(${DATE_EXTENDED}|${DATE_BASIC})${CALENDAR_ANNOTATION_REQUIRED})$`);
+/**
 * Creates a ValueParser for parsing Temporal.PlainDate from ISO 8601 date strings.
 *
 * Accepts strings like:
@@ -146,6 +204,7 @@ function plainDate(options = {}) {
 		parse(input) {
 			ensureTemporal();
 			try {
+				if (!PLAIN_DATE_RE.test(input)) throw new RangeError();
 				const value = Temporal.PlainDate.from(input);
 				return {
 					success: true,
@@ -185,6 +244,7 @@ function plainTime(options = {}) {
 		parse(input) {
 			ensureTemporal();
 			try {
+				if (!PLAIN_TIME_RE.test(input)) throw new RangeError();
 				const value = Temporal.PlainTime.from(input);
 				return {
 					success: true,
@@ -224,6 +284,7 @@ function plainDateTime(options = {}) {
 		parse(input) {
 			ensureTemporal();
 			try {
+				if (!PLAIN_DATETIME_RE.test(input)) throw new RangeError();
 				const value = Temporal.PlainDateTime.from(input);
 				return {
 					success: true,
@@ -263,6 +324,7 @@ function plainYearMonth(options = {}) {
 		parse(input) {
 			ensureTemporal();
 			try {
+				if (!PLAIN_YEAR_MONTH_RE.test(input)) throw new RangeError();
 				const value = Temporal.PlainYearMonth.from(input);
 				return {
 					success: true,
@@ -302,6 +364,7 @@ function plainMonthDay(options = {}) {
 		parse(input) {
 			ensureTemporal();
 			try {
+				if (!PLAIN_MONTH_DAY_RE.test(input)) throw new RangeError();
 				const value = Temporal.PlainMonthDay.from(input);
 				return {
 					success: true,

package/package.json

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