@sixthshift/design-system 0.1.0 → 0.3.0

package/dist/date-time/parse.js

@@ -0,0 +1,157 @@
+/**
+ * Parsing utilities: External data → Temporal
+ *
+ * Use these at integration boundaries when receiving data from external sources:
+ * - ISO 8601 strings from APIs
+ * - Date objects from Node.js APIs or third-party libraries
+ */
+import { Temporal } from "@js-temporal/polyfill";
+/**
+ * Parse an ISO 8601 instant string to Temporal.Instant
+ *
+ * @example
+ * parseInstant('2025-01-15T14:30:00.000Z')
+ * // → Temporal.Instant
+ */
+export function parseInstant(iso) {
+    return Temporal.Instant.from(iso);
+}
+/**
+ * Parse an ISO 8601 instant string to Temporal.Instant, or undefined if input is nullish
+ */
+export function parseInstantOrUndefined(iso) {
+    return iso ? Temporal.Instant.from(iso) : undefined;
+}
+/**
+ * Parse an ISO 8601 date string to Temporal.PlainDate
+ *
+ * Accepts formats:
+ * - '2025-01-15' (date only)
+ * - '2025-01-15T14:30:00' (datetime, time portion ignored)
+ * - '2025-01-15T14:30:00Z' (datetime with Z, time portion ignored)
+ * - '2025-01-15T14:30:00.000Z' (datetime with milliseconds and Z)
+ *
+ * @example
+ * parseDate('2025-01-15')
+ * // → Temporal.PlainDate
+ */
+export function parseDate(iso) {
+    // Extract just the date portion (first 10 characters: YYYY-MM-DD)
+    const datePart = iso.slice(0, 10);
+    return Temporal.PlainDate.from(datePart);
+}
+/**
+ * Parse an ISO 8601 date string to Temporal.PlainDate, or undefined if input is nullish
+ *
+ * Accepts same formats as parseDate.
+ */
+export function parseDateOrUndefined(iso) {
+    if (!iso)
+        return undefined;
+    const datePart = iso.slice(0, 10);
+    return Temporal.PlainDate.from(datePart);
+}
+/**
+ * Parse an ISO 8601 time string to Temporal.PlainTime
+ *
+ * @example
+ * parseTime('14:30:00')
+ * // → Temporal.PlainTime
+ */
+export function parseTime(iso) {
+    return Temporal.PlainTime.from(iso);
+}
+/**
+ * Parse an ISO 8601 time string to Temporal.PlainTime, or undefined if input is nullish
+ */
+export function parseTimeOrUndefined(iso) {
+    return iso ? Temporal.PlainTime.from(iso) : undefined;
+}
+/**
+ * Parse an ISO 8601 datetime string to Temporal.PlainDateTime
+ *
+ * Accepts formats:
+ * - '2025-01-15T14:30:00' (datetime)
+ * - '2025-01-15T14:30:00Z' (datetime with Z, Z is stripped)
+ * - '2025-01-15T14:30:00.000Z' (datetime with milliseconds and Z)
+ *
+ * @example
+ * parseDateTime('2025-01-15T14:30:00')
+ * // → Temporal.PlainDateTime
+ */
+export function parseDateTime(iso) {
+    // Strip trailing Z if present (PlainDateTime doesn't accept timezone designators)
+    const normalized = iso.endsWith("Z") ? iso.slice(0, -1) : iso;
+    return Temporal.PlainDateTime.from(normalized);
+}
+/**
+ * Parse an ISO 8601 datetime string to Temporal.PlainDateTime, or undefined if input is nullish
+ *
+ * Accepts same formats as parseDateTime.
+ */
+export function parseDateTimeOrUndefined(iso) {
+    if (!iso)
+        return undefined;
+    const normalized = iso.endsWith("Z") ? iso.slice(0, -1) : iso;
+    return Temporal.PlainDateTime.from(normalized);
+}
+/**
+ * Parse an ISO 8601 zoned datetime string to Temporal.ZonedDateTime
+ *
+ * Accepts formats:
+ * - '2025-01-15T14:30:00[America/New_York]'
+ * - '2025-01-15T14:30:00-05:00[America/New_York]'
+ *
+ * @example
+ * parseZoned('2025-01-15T14:30:00[America/New_York]')
+ * // → Temporal.ZonedDateTime
+ */
+export function parseZoned(iso) {
+    return Temporal.ZonedDateTime.from(iso);
+}
+/**
+ * Parse an ISO 8601 zoned datetime string to Temporal.ZonedDateTime, or undefined if input is nullish
+ */
+export function parseZonedOrUndefined(iso) {
+    return iso ? Temporal.ZonedDateTime.from(iso) : undefined;
+}
+// =============================================================================
+// Date object conversion
+// =============================================================================
+/**
+ * Convert a JavaScript Date object to Temporal.Instant
+ *
+ * Use this at API boundaries where external libraries return Date objects
+ * (e.g., Node.js fs.Stats.mtime, pg driver timestamptz columns, pg-boss next_run_on)
+ *
+ * @example
+ * // Converting fs.Stats mtime
+ * const instant = fromDate(stats.mtime);
+ *
+ * // Converting pg driver Date
+ * const instant = fromDate(pgResult.created_at);
+ */
+// biome-ignore lint/style/noRestrictedGlobals: Date parameter required for converting from external APIs
+export function fromDate(date) {
+    return Temporal.Instant.fromEpochMilliseconds(date.getTime());
+}
+// =============================================================================
+// Duration parsing
+// =============================================================================
+/**
+ * Parse an ISO 8601 duration string to Temporal.Duration
+ *
+ * @example
+ * parseDuration('PT1H30M')
+ * // → Temporal.Duration (1 hour 30 minutes)
+ */
+export function parseDuration(iso) {
+    return Temporal.Duration.from(iso);
+}
+/**
+ * Parse an ISO 8601 duration string to Temporal.Duration, or undefined if input is nullish
+ */
+export function parseDurationOrUndefined(iso) {
+    return iso ? Temporal.Duration.from(iso) : undefined;
+}
+//# sourceMappingURL=parse.js.map

package/dist/date-time/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/date-time/parse.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAA8B;IACpE,OAAO,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,kEAAkE;IAClE,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAClC,OAAO,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAA8B;IACjE,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAClC,OAAO,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,OAAO,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAA8B;IACjE,OAAO,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,kFAAkF;IAClF,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC9D,OAAO,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAA8B;IACrE,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC9D,OAAO,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAA8B;IAClE,OAAO,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5D,CAAC;AAED,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF;;;;;;;;;;;;GAYG;AACH,yGAAyG;AACzG,MAAM,UAAU,QAAQ,CAAC,IAAU;IACjC,OAAO,QAAQ,CAAC,OAAO,CAAC,qBAAqB,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAA8B;IACrE,OAAO,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC"}

package/dist/date-time/serialize.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Generic serialization utilities for Temporal types
+ *
+ * Provides a unified way to convert any Temporal type to its ISO string representation.
+ * These functions are simple wrappers around `.toString()` but provide:
+ * - Type safety
+ * - Consistent naming
+ * - Optional value handling
+ * - A single import point
+ *
+ * ## API Boundary Pattern
+ *
+ * When sending Temporal types to API endpoints, use this composition:
+ *
+ * ```typescript
+ * import { plainDateTimeToZonedDateTime, serialize } from "@sixthshift/design-system/date-time";
+ *
+ * // For PlainDateTime (timezone-naive) → API string
+ * const apiValue = serialize(plainDateTimeToZonedDateTime(dateTime));
+ * // → "2026-01-24T15:30:00-08:00[America/Los_Angeles]"
+ *
+ * // For PlainDate → API string (midnight in user's timezone)
+ * const apiValue = serialize(plainDateToZonedDateTime(date));
+ * // → "2026-01-24T00:00:00-08:00[America/Los_Angeles]"
+ *
+ * // Server receives and parses to UTC Instant
+ * parseInstant(apiValue) → Instant('2026-01-24T23:30:00Z')
+ * ```
+ *
+ */
+import type { Temporal } from "@js-temporal/polyfill";
+/**
+ * Serialize any Temporal type to its ISO 8601 string representation
+ *
+ * @example
+ * serialize(Temporal.PlainDate.from('2026-01-24'))
+ * // → '2026-01-24'
+ *
+ * serialize(Temporal.PlainDateTime.from('2026-01-24T15:30'))
+ * // → '2026-01-24T15:30:00'
+ *
+ * serialize(Temporal.Instant.from('2026-01-24T04:30:00Z'))
+ * // → '2026-01-24T04:30:00Z'
+ */
+export declare function serialize(temporal: Temporal.Instant | Temporal.PlainDate | Temporal.PlainDateTime | Temporal.PlainTime | Temporal.ZonedDateTime | Temporal.Duration): string;
+/**
+ * Serialize optional Temporal type to ISO string or undefined
+ *
+ * @example
+ * serializeOptional(undefined) // → undefined
+ * serializeOptional(Temporal.PlainDate.from('2026-01-24')) // → '2026-01-24'
+ */
+export declare function serializeOptional(temporal: Temporal.Instant | Temporal.PlainDate | Temporal.PlainDateTime | Temporal.PlainTime | Temporal.ZonedDateTime | Temporal.Duration | null | undefined): string | undefined;
+export declare function serializeInstant(instant: Temporal.Instant): string;
+export declare function serializeDate(date: Temporal.PlainDate): string;
+export declare function serializeDateTime(dateTime: Temporal.PlainDateTime): string;
+export declare function serializeTime(time: Temporal.PlainTime): string;
+export declare function serializeZonedDateTime(zoned: Temporal.ZonedDateTime): string;
+export declare function serializeDuration(duration: Temporal.Duration): string;
+//# sourceMappingURL=serialize.d.ts.map

package/dist/date-time/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/date-time/serialize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,aAAa,GAAG,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,aAAa,GAAG,QAAQ,CAAC,QAAQ,GACzI,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,aAAa,GAAG,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,aAAa,GAAG,QAAQ,CAAC,QAAQ,GAAG,IAAI,GAAG,SAAS,GAC5J,MAAM,GAAG,SAAS,CAEpB;AAID,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,GAAG,MAAM,CAElE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,GAAG,MAAM,CAE9D;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,GAAG,MAAM,CAE1E;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,GAAG,MAAM,CAE9D;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,GAAG,MAAM,CAE5E;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAErE"}

package/dist/date-time/serialize.js

@@ -0,0 +1,76 @@
+/**
+ * Generic serialization utilities for Temporal types
+ *
+ * Provides a unified way to convert any Temporal type to its ISO string representation.
+ * These functions are simple wrappers around `.toString()` but provide:
+ * - Type safety
+ * - Consistent naming
+ * - Optional value handling
+ * - A single import point
+ *
+ * ## API Boundary Pattern
+ *
+ * When sending Temporal types to API endpoints, use this composition:
+ *
+ * ```typescript
+ * import { plainDateTimeToZonedDateTime, serialize } from "@sixthshift/design-system/date-time";
+ *
+ * // For PlainDateTime (timezone-naive) → API string
+ * const apiValue = serialize(plainDateTimeToZonedDateTime(dateTime));
+ * // → "2026-01-24T15:30:00-08:00[America/Los_Angeles]"
+ *
+ * // For PlainDate → API string (midnight in user's timezone)
+ * const apiValue = serialize(plainDateToZonedDateTime(date));
+ * // → "2026-01-24T00:00:00-08:00[America/Los_Angeles]"
+ *
+ * // Server receives and parses to UTC Instant
+ * parseInstant(apiValue) → Instant('2026-01-24T23:30:00Z')
+ * ```
+ *
+ */
+/**
+ * Serialize any Temporal type to its ISO 8601 string representation
+ *
+ * @example
+ * serialize(Temporal.PlainDate.from('2026-01-24'))
+ * // → '2026-01-24'
+ *
+ * serialize(Temporal.PlainDateTime.from('2026-01-24T15:30'))
+ * // → '2026-01-24T15:30:00'
+ *
+ * serialize(Temporal.Instant.from('2026-01-24T04:30:00Z'))
+ * // → '2026-01-24T04:30:00Z'
+ */
+export function serialize(temporal) {
+    return temporal.toString();
+}
+/**
+ * Serialize optional Temporal type to ISO string or undefined
+ *
+ * @example
+ * serializeOptional(undefined) // → undefined
+ * serializeOptional(Temporal.PlainDate.from('2026-01-24')) // → '2026-01-24'
+ */
+export function serializeOptional(temporal) {
+    return temporal?.toString();
+}
+// Type-specific convenience functions (optional, for clarity)
+export function serializeInstant(instant) {
+    return instant.toString();
+}
+export function serializeDate(date) {
+    return date.toString();
+}
+export function serializeDateTime(dateTime) {
+    return dateTime.toString();
+}
+export function serializeTime(time) {
+    return time.toString();
+}
+export function serializeZonedDateTime(zoned) {
+    return zoned.toString();
+}
+export function serializeDuration(duration) {
+    return duration.toString();
+}
+//# sourceMappingURL=serialize.js.map

package/dist/date-time/serialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../../src/date-time/serialize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,SAAS,CACvB,QAA0I;IAE1I,OAAO,QAAQ,CAAC,QAAQ,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAA6J;IAE7J,OAAO,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC;AAED,8DAA8D;AAE9D,MAAM,UAAU,gBAAgB,CAAC,OAAyB;IACxD,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAwB;IACpD,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgC;IAChE,OAAO,QAAQ,CAAC,QAAQ,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAwB;IACpD,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAA6B;IAClE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAA2B;IAC3D,OAAO,QAAQ,CAAC,QAAQ,EAAE,CAAC;AAC7B,CAAC"}

package/dist/date-time/timezone.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Timezone conversion utilities
+ *
+ * Functions for converting between timezones and working with ZonedDateTime
+ */
+import { Temporal } from "@js-temporal/polyfill";
+/**
+ * Convert an instant to a zoned date/time in a specific timezone
+ */
+export declare function toTimezone(instant: Temporal.Instant, timezone: string): Temporal.ZonedDateTime;
+/**
+ * Convert a zoned date/time to a different timezone
+ */
+export declare function changeTimezone(zoned: Temporal.ZonedDateTime, timezone: string): Temporal.ZonedDateTime;
+/**
+ * Interpret PlainDateTime in a specific timezone, returning ZonedDateTime
+ *
+ * @example
+ * const dt = Temporal.PlainDateTime.from('2026-01-24T15:30');
+ * const zoned = plainDateTimeToZonedDateTime(dt, 'America/Los_Angeles');
+ * // → 2026-01-24T15:30:00-08:00[America/Los_Angeles]
+ */
+export declare function plainDateTimeToZonedDateTime(dateTime: Temporal.PlainDateTime, timezone?: string): Temporal.ZonedDateTime;
+/**
+ * Interpret PlainDate as midnight in a specific timezone, returning ZonedDateTime
+ *
+ * @example
+ * const date = Temporal.PlainDate.from('2026-01-24');
+ * const zoned = plainDateToZonedDateTime(date, 'America/Los_Angeles');
+ * // → 2026-01-24T00:00:00-08:00[America/Los_Angeles]
+ */
+export declare function plainDateToZonedDateTime(date: Temporal.PlainDate, timezone?: string): Temporal.ZonedDateTime;
+//# sourceMappingURL=timezone.d.ts.map

package/dist/date-time/timezone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone.d.ts","sourceRoot":"","sources":["../../src/date-time/timezone.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC,aAAa,CAE9F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC,aAAa,CAEtG;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,aAAa,CAGxH;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,aAAa,CAG5G"}

package/dist/date-time/timezone.js

@@ -0,0 +1,43 @@
+/**
+ * Timezone conversion utilities
+ *
+ * Functions for converting between timezones and working with ZonedDateTime
+ */
+import { Temporal } from "@js-temporal/polyfill";
+/**
+ * Convert an instant to a zoned date/time in a specific timezone
+ */
+export function toTimezone(instant, timezone) {
+    return instant.toZonedDateTimeISO(timezone);
+}
+/**
+ * Convert a zoned date/time to a different timezone
+ */
+export function changeTimezone(zoned, timezone) {
+    return zoned.withTimeZone(timezone);
+}
+/**
+ * Interpret PlainDateTime in a specific timezone, returning ZonedDateTime
+ *
+ * @example
+ * const dt = Temporal.PlainDateTime.from('2026-01-24T15:30');
+ * const zoned = plainDateTimeToZonedDateTime(dt, 'America/Los_Angeles');
+ * // → 2026-01-24T15:30:00-08:00[America/Los_Angeles]
+ */
+export function plainDateTimeToZonedDateTime(dateTime, timezone) {
+    const tz = timezone ?? Temporal.Now.timeZoneId();
+    return dateTime.toZonedDateTime(tz);
+}
+/**
+ * Interpret PlainDate as midnight in a specific timezone, returning ZonedDateTime
+ *
+ * @example
+ * const date = Temporal.PlainDate.from('2026-01-24');
+ * const zoned = plainDateToZonedDateTime(date, 'America/Los_Angeles');
+ * // → 2026-01-24T00:00:00-08:00[America/Los_Angeles]
+ */
+export function plainDateToZonedDateTime(date, timezone) {
+    const tz = timezone ?? Temporal.Now.timeZoneId();
+    return date.toPlainDateTime(Temporal.PlainTime.from("00:00")).toZonedDateTime(tz);
+}
+//# sourceMappingURL=timezone.js.map

package/dist/date-time/timezone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone.js","sourceRoot":"","sources":["../../src/date-time/timezone.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,OAAyB,EAAE,QAAgB;IACpE,OAAO,OAAO,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAA6B,EAAE,QAAgB;IAC5E,OAAO,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,4BAA4B,CAAC,QAAgC,EAAE,QAAiB;IAC9F,MAAM,EAAE,GAAG,QAAQ,IAAI,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC;IACjD,OAAO,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAwB,EAAE,QAAiB;IAClF,MAAM,EAAE,GAAG,QAAQ,IAAI,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC;IACjD,OAAO,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;AACpF,CAAC"}

package/dist/date-time/validate.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Validation utilities: string validation and type guards
+ *
+ * Use these to validate input before parsing, or to narrow types at runtime.
+ */
+import { Temporal } from "@js-temporal/polyfill";
+/**
+ * Check if a string is a valid ISO 8601 date (YYYY-MM-DD)
+ *
+ * @example
+ * isISODate('2025-01-15')  // true
+ * isISODate('2025-13-45')  // false
+ * isISODate('not a date')  // false
+ */
+export declare function isISODate(value: unknown): value is string;
+/**
+ * Check if a string is a valid ISO 8601 time (HH:mm:ss or HH:mm)
+ *
+ * @example
+ * isISOTime('14:30:00')  // true
+ * isISOTime('14:30')     // true
+ * isISOTime('25:00:00')  // false
+ */
+export declare function isISOTime(value: unknown): value is string;
+/**
+ * Check if a string is a valid ISO 8601 datetime (YYYY-MM-DDTHH:mm:ss)
+ *
+ * @example
+ * isISODateTime('2025-01-15T14:30:00')  // true
+ * isISODateTime('2025-01-15')           // false (date only)
+ * isISODateTime('invalid')              // false
+ */
+export declare function isISODateTime(value: unknown): value is string;
+/**
+ * Check if a string is a valid ISO 8601 instant (with Z or offset)
+ *
+ * @example
+ * isISOInstant('2025-01-15T14:30:00.000Z')     // true
+ * isISOInstant('2025-01-15T14:30:00+05:30')    // true
+ * isISOInstant('2025-01-15T14:30:00')          // false (no timezone)
+ * isISOInstant('2025-01-15')                   // false (date only)
+ */
+export declare function isISOInstant(value: unknown): value is string;
+/**
+ * Check if a string is a valid ISO 8601 zoned datetime
+ *
+ * @example
+ * isISOZoned('2025-01-15T14:30:00[America/New_York]')           // true
+ * isISOZoned('2025-01-15T14:30:00-05:00[America/New_York]')     // true
+ * isISOZoned('2025-01-15T14:30:00Z')                            // false (instant, not zoned)
+ */
+export declare function isISOZoned(value: unknown): value is string;
+/**
+ * Check if a string is a valid ISO 8601 duration
+ *
+ * @example
+ * isISODuration('PT1H30M')    // true (1 hour 30 minutes)
+ * isISODuration('P1D')        // true (1 day)
+ * isISODuration('P1Y2M3D')    // true (1 year 2 months 3 days)
+ * isISODuration('1 hour')     // false
+ */
+export declare function isISODuration(value: unknown): value is string;
+/**
+ * Check if a string is any valid ISO 8601 date/time format
+ * (date, time, datetime, instant, or zoned)
+ *
+ * @example
+ * isISOString('2025-01-15')                    // true
+ * isISOString('2025-01-15T14:30:00.000Z')      // true
+ * isISOString('not a date')                    // false
+ */
+export declare function isISOString(value: unknown): value is string;
+/**
+ * Check if a value is a Temporal.PlainDate
+ */
+export declare function isPlainDate(value: unknown): value is Temporal.PlainDate;
+/**
+ * Check if a value is a Temporal.PlainTime
+ */
+export declare function isPlainTime(value: unknown): value is Temporal.PlainTime;
+/**
+ * Check if a value is a Temporal.PlainDateTime
+ */
+export declare function isPlainDateTime(value: unknown): value is Temporal.PlainDateTime;
+/**
+ * Check if a value is a Temporal.Instant
+ */
+export declare function isInstant(value: unknown): value is Temporal.Instant;
+/**
+ * Check if a value is a Temporal.ZonedDateTime
+ */
+export declare function isZonedDateTime(value: unknown): value is Temporal.ZonedDateTime;
+/**
+ * Check if a value is a Temporal.Duration
+ */
+export declare function isDuration(value: unknown): value is Temporal.Duration;
+/**
+ * Check if a value is any Temporal date/time type
+ */
+export declare function isTemporal(value: unknown): value is Temporal.PlainDate | Temporal.PlainTime | Temporal.PlainDateTime | Temporal.Instant | Temporal.ZonedDateTime | Temporal.Duration;
+export interface ValidationResult {
+    valid: boolean;
+    error?: string;
+}
+/**
+ * Validate an ISO date string and return detailed error if invalid
+ */
+export declare function validateISODate(value: unknown): ValidationResult;
+/**
+ * Validate an ISO instant string and return detailed error if invalid
+ */
+export declare function validateISOInstant(value: unknown): ValidationResult;
+/**
+ * Validate an ISO zoned datetime string and return detailed error if invalid
+ */
+export declare function validateISOZoned(value: unknown): ValidationResult;
+/**
+ * Validate an ISO duration string and return detailed error if invalid
+ */
+export declare function validateISODuration(value: unknown): ValidationResult;
+//# sourceMappingURL=validate.d.ts.map

package/dist/date-time/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/date-time/validate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAMjD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAQzD;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAQzD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAQ7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAQ5D;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAU1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAQ7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE3D;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAAC,SAAS,CAEvE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAAC,SAAS,CAEvE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAAC,aAAa,CAE/E;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAAC,OAAO,CAEnE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAAC,aAAa,CAE/E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAErE;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,aAAa,GAAG,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,GAAG,QAAQ,CAAC,QAAQ,CAE3I;AAMD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAahE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAanE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAmBjE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAapE"}