@maanlamp/react-web-ui 0.0.0-stage → 0.1.1

package/dist/lib/calendar/temporal-value.d.ts

@@ -0,0 +1,85 @@
+import { type CalendarDate, type Time } from "@internationalized/date";
+import { Temporal } from "temporal-polyfill";
+/** A plain-date range as it crosses a control's boundary. */
+export type IsoDateRange = Readonly<{
+    start: string;
+    end: string;
+}>;
+/** A plain-date range as the calendar controls hold it. */
+export type DayRange = Readonly<{
+    start: CalendarDate;
+    end: CalendarDate;
+}>;
+/**
+ * The Temporal plain date a calendar control's day denotes.
+ *
+ * @example
+ * dayToPlainDate(new CalendarDate(2026, 7, 24)); // Temporal.PlainDate 2026-07-24
+ */
+export declare const dayToPlainDate: (day: CalendarDate) => Temporal.PlainDate;
+/**
+ * Today's calendar day in `timeZone`.
+ *
+ * @example
+ * todayIn("Pacific/Kiritimati"); // CalendarDate, a day ahead of UTC for most of it
+ */
+export declare const todayIn: (timeZone: string) => CalendarDate;
+/**
+ * The calendar day an ISO date, date-time or instant falls on in `timeZone`,
+ * or `null` for missing or unparseable input.
+ *
+ * @example
+ * isoToDay("2026-07-24T12:30:00Z", "Pacific/Kiritimati"); // CalendarDate 2026-07-25
+ */
+export declare const isoToDay: (value: string | null | undefined, timeZone: string) => CalendarDate | null;
+/**
+ * ISO plain-date string for a calendar day, or `null` for no day.
+ *
+ * @example
+ * dayToIso(new CalendarDate(2026, 7, 24)); // "2026-07-24"
+ */
+export declare const dayToIso: (day: CalendarDate | null) => string | null;
+/**
+ * The calendar days an ISO date range falls on in `timeZone`, or `null` unless
+ * both ends parse.
+ *
+ * @example
+ * isoToDayRange({ start: "2026-07-01", end: "2026-07-31" }, "Europe/Amsterdam");
+ */
+export declare const isoToDayRange: (range: IsoDateRange | null | undefined, timeZone: string) => DayRange | null;
+/**
+ * ISO plain-date strings for a range of calendar days.
+ *
+ * @example
+ * dayRangeToIso({ start: july1, end: july31 }); // { start: "2026-07-01", end: "2026-07-31" }
+ */
+export declare const dayRangeToIso: (range: DayRange | null) => IsoDateRange | null;
+/**
+ * Inclusive-start / exclusive-end ISO instants for an ISO plain-date range in
+ * `timeZone`, for query parameters that filter on a moment. `null` unless both
+ * ends parse.
+ *
+ * @example
+ * isoDateRangeToInstants({ start: "2026-07-01", end: "2026-07-31" }, "Europe/Amsterdam");
+ * // { rangeStartAt: "2026-06-30T22:00:00.000Z", rangeEndAt: "2026-07-31T22:00:00.000Z" }
+ */
+export declare const isoDateRangeToInstants: (range: IsoDateRange | null | undefined, timeZone: string) => Readonly<{
+    rangeStartAt: string;
+    rangeEndAt: string;
+}> | null;
+/**
+ * The time of day a `"HH:mm"` string denotes, or `null` for missing or
+ * unparseable input.
+ *
+ * @example
+ * isoToTimeOfDay("09:30"); // Time 09:30
+ */
+export declare const isoToTimeOfDay: (value: string | null | undefined) => Time | null;
+/**
+ * A `"HH:mm"` string for a time of day, or `null` for no time.
+ *
+ * @example
+ * timeOfDayToIso(new Time(9, 30)); // "09:30"
+ */
+export declare const timeOfDayToIso: (time: Time | null) => string | null;
+//# sourceMappingURL=temporal-value.d.ts.map

package/dist/lib/calendar/temporal-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-value.d.ts","sourceRoot":"","sources":["../../../src/lib/calendar/temporal-value.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,YAAY,EAGjB,KAAK,IAAI,EACT,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG7C,6DAA6D;AAC7D,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACZ,CAAC,CAAC;AAEH,2DAA2D;AAC3D,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC;IAC/B,KAAK,EAAE,YAAY,CAAC;IACpB,GAAG,EAAE,YAAY,CAAC;CAClB,CAAC,CAAC;AAWH;;;;;GAKG;AACH,eAAO,MAAM,cAAc,QACrB,YAAY,KACf,QAAQ,CAAC,SAC4B,CAAC;AAMzC;;;;;GAKG;AACH,eAAO,MAAM,OAAO,aAAc,MAAM,KAAG,YACS,CAAC;AAErD;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,UACb,MAAM,GAAG,IAAI,GAAG,SAAS,YACtB,MAAM,KACd,YAAY,GAAG,IAGjB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,QACf,YAAY,GAAG,IAAI,KACtB,MAAM,GAAG,IACyC,CAAC;AAEtD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,UAClB,YAAY,GAAG,IAAI,GAAG,SAAS,YAC5B,MAAM,KACd,QAAQ,GAAG,IAMb,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,UAClB,QAAQ,GAAG,IAAI,KACpB,YAAY,GAAG,IAMd,CAAC;AAKL;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,UAC3B,YAAY,GAAG,IAAI,GAAG,SAAS,YAC5B,MAAM,KACd,QAAQ,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACnB,CAAC,GAAG,IAgBJ,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,UACnB,MAAM,GAAG,IAAI,GAAG,SAAS,KAC9B,IAAI,GAAG,IAaT,CAAC;AAKF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,SACpB,IAAI,GAAG,IAAI,KACf,MAAM,GAAG,IAG2C,CAAC"}

package/dist/lib/calendar/temporal-value.js

@@ -0,0 +1,105 @@
+import { isoToZonedDateTime } from "../iso-zoned.js";
+import { Temporal } from "temporal-polyfill";
+import { parseDate, parseTime } from "@internationalized/date";
+// src/lib/calendar/temporal-value.ts
+var isoToPlainDate = (value, timeZone) => value === null || value === void 0 || value === "" ? null : isoToZonedDateTime(value, timeZone)?.toPlainDate() ?? null;
+/**
+* The Temporal plain date a calendar control's day denotes.
+*
+* @example
+* dayToPlainDate(new CalendarDate(2026, 7, 24)); // Temporal.PlainDate 2026-07-24
+*/
+var dayToPlainDate = (day) => Temporal.PlainDate.from(day.toString());
+var plainDateToDay = (date) => parseDate(date.toString());
+/**
+* Today's calendar day in `timeZone`.
+*
+* @example
+* todayIn("Pacific/Kiritimati"); // CalendarDate, a day ahead of UTC for most of it
+*/
+var todayIn = (timeZone) => plainDateToDay(Temporal.Now.plainDateISO(timeZone));
+/**
+* The calendar day an ISO date, date-time or instant falls on in `timeZone`,
+* or `null` for missing or unparseable input.
+*
+* @example
+* isoToDay("2026-07-24T12:30:00Z", "Pacific/Kiritimati"); // CalendarDate 2026-07-25
+*/
+var isoToDay = (value, timeZone) => {
+	const date = isoToPlainDate(value, timeZone);
+	return date === null ? null : plainDateToDay(date);
+};
+/**
+* ISO plain-date string for a calendar day, or `null` for no day.
+*
+* @example
+* dayToIso(new CalendarDate(2026, 7, 24)); // "2026-07-24"
+*/
+var dayToIso = (day) => day === null ? null : dayToPlainDate(day).toString();
+/**
+* The calendar days an ISO date range falls on in `timeZone`, or `null` unless
+* both ends parse.
+*
+* @example
+* isoToDayRange({ start: "2026-07-01", end: "2026-07-31" }, "Europe/Amsterdam");
+*/
+var isoToDayRange = (range, timeZone) => {
+	const start = isoToDay(range?.start, timeZone);
+	const end = isoToDay(range?.end, timeZone);
+	return start === null || end === null ? null : {
+		start,
+		end
+	};
+};
+/**
+* ISO plain-date strings for a range of calendar days.
+*
+* @example
+* dayRangeToIso({ start: july1, end: july31 }); // { start: "2026-07-01", end: "2026-07-31" }
+*/
+var dayRangeToIso = (range) => range === null ? null : {
+	start: dayToPlainDate(range.start).toString(),
+	end: dayToPlainDate(range.end).toString()
+};
+var instantToIso = (instant) => instant.toString({ fractionalSecondDigits: 3 });
+/**
+* Inclusive-start / exclusive-end ISO instants for an ISO plain-date range in
+* `timeZone`, for query parameters that filter on a moment. `null` unless both
+* ends parse.
+*
+* @example
+* isoDateRangeToInstants({ start: "2026-07-01", end: "2026-07-31" }, "Europe/Amsterdam");
+* // { rangeStartAt: "2026-06-30T22:00:00.000Z", rangeEndAt: "2026-07-31T22:00:00.000Z" }
+*/
+var isoDateRangeToInstants = (range, timeZone) => {
+	const start = isoToPlainDate(range?.start, timeZone);
+	const end = isoToPlainDate(range?.end, timeZone);
+	return start === null || end === null ? null : {
+		rangeStartAt: instantToIso(start.toZonedDateTime(timeZone).toInstant()),
+		rangeEndAt: instantToIso(end.add({ days: 1 }).toZonedDateTime(timeZone).toInstant())
+	};
+};
+/**
+* The time of day a `"HH:mm"` string denotes, or `null` for missing or
+* unparseable input.
+*
+* @example
+* isoToTimeOfDay("09:30"); // Time 09:30
+*/
+var isoToTimeOfDay = (value) => {
+	if (value === null || value === void 0 || value === "") return null;
+	try {
+		return parseTime(value);
+	} catch {
+		return null;
+	}
+};
+var twoDigits = (value) => String(value).padStart(2, "0");
+/**
+* A `"HH:mm"` string for a time of day, or `null` for no time.
+*
+* @example
+* timeOfDayToIso(new Time(9, 30)); // "09:30"
+*/
+var timeOfDayToIso = (time) => time === null ? null : `${twoDigits(time.hour)}:${twoDigits(time.minute)}`;
+export { dayRangeToIso, dayToIso, dayToPlainDate, isoDateRangeToInstants, isoToDay, isoToDayRange, isoToTimeOfDay, timeOfDayToIso, todayIn };