@sixthshift/design-system 0.1.0 → 0.2.1

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"}

package/dist/date-time/validate.js

@@ -0,0 +1,264 @@
+/**
+ * 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";
+// =============================================================================
+// String validation (is this string valid ISO 8601?)
+// =============================================================================
+/**
+ * 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 function isISODate(value) {
+    if (typeof value !== "string")
+        return false;
+    try {
+        Temporal.PlainDate.from(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 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 function isISOTime(value) {
+    if (typeof value !== "string")
+        return false;
+    try {
+        Temporal.PlainTime.from(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 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 function isISODateTime(value) {
+    if (typeof value !== "string")
+        return false;
+    try {
+        Temporal.PlainDateTime.from(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 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 function isISOInstant(value) {
+    if (typeof value !== "string")
+        return false;
+    try {
+        Temporal.Instant.from(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 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 function isISOZoned(value) {
+    if (typeof value !== "string")
+        return false;
+    // Must contain a bracketed timezone identifier
+    if (!value.includes("[") || !value.includes("]"))
+        return false;
+    try {
+        Temporal.ZonedDateTime.from(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 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 function isISODuration(value) {
+    if (typeof value !== "string")
+        return false;
+    try {
+        Temporal.Duration.from(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 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 function isISOString(value) {
+    return isISODate(value) || isISOTime(value) || isISODateTime(value) || isISOInstant(value) || isISOZoned(value);
+}
+// =============================================================================
+// Type guards (is this value a Temporal type?)
+// =============================================================================
+/**
+ * Check if a value is a Temporal.PlainDate
+ */
+export function isPlainDate(value) {
+    return value instanceof Temporal.PlainDate;
+}
+/**
+ * Check if a value is a Temporal.PlainTime
+ */
+export function isPlainTime(value) {
+    return value instanceof Temporal.PlainTime;
+}
+/**
+ * Check if a value is a Temporal.PlainDateTime
+ */
+export function isPlainDateTime(value) {
+    return value instanceof Temporal.PlainDateTime;
+}
+/**
+ * Check if a value is a Temporal.Instant
+ */
+export function isInstant(value) {
+    return value instanceof Temporal.Instant;
+}
+/**
+ * Check if a value is a Temporal.ZonedDateTime
+ */
+export function isZonedDateTime(value) {
+    return value instanceof Temporal.ZonedDateTime;
+}
+/**
+ * Check if a value is a Temporal.Duration
+ */
+export function isDuration(value) {
+    return value instanceof Temporal.Duration;
+}
+/**
+ * Check if a value is any Temporal date/time type
+ */
+export function isTemporal(value) {
+    return isPlainDate(value) || isPlainTime(value) || isPlainDateTime(value) || isInstant(value) || isZonedDateTime(value) || isDuration(value);
+}
+/**
+ * Validate an ISO date string and return detailed error if invalid
+ */
+export function validateISODate(value) {
+    if (typeof value !== "string") {
+        return { valid: false, error: `Expected string, got ${typeof value}` };
+    }
+    try {
+        Temporal.PlainDate.from(value);
+        return { valid: true };
+    }
+    catch (e) {
+        return {
+            valid: false,
+            error: e instanceof Error ? e.message : "Invalid ISO date",
+        };
+    }
+}
+/**
+ * Validate an ISO instant string and return detailed error if invalid
+ */
+export function validateISOInstant(value) {
+    if (typeof value !== "string") {
+        return { valid: false, error: `Expected string, got ${typeof value}` };
+    }
+    try {
+        Temporal.Instant.from(value);
+        return { valid: true };
+    }
+    catch (e) {
+        return {
+            valid: false,
+            error: e instanceof Error ? e.message : "Invalid ISO instant",
+        };
+    }
+}
+/**
+ * Validate an ISO zoned datetime string and return detailed error if invalid
+ */
+export function validateISOZoned(value) {
+    if (typeof value !== "string") {
+        return { valid: false, error: `Expected string, got ${typeof value}` };
+    }
+    if (!value.includes("[") || !value.includes("]")) {
+        return {
+            valid: false,
+            error: "Zoned datetime must include timezone in brackets, e.g. [America/New_York]",
+        };
+    }
+    try {
+        Temporal.ZonedDateTime.from(value);
+        return { valid: true };
+    }
+    catch (e) {
+        return {
+            valid: false,
+            error: e instanceof Error ? e.message : "Invalid ISO zoned datetime",
+        };
+    }
+}
+/**
+ * Validate an ISO duration string and return detailed error if invalid
+ */
+export function validateISODuration(value) {
+    if (typeof value !== "string") {
+        return { valid: false, error: `Expected string, got ${typeof value}` };
+    }
+    try {
+        Temporal.Duration.from(value);
+        return { valid: true };
+    }
+    catch (e) {
+        return {
+            valid: false,
+            error: e instanceof Error ? e.message : "Invalid ISO duration",
+        };
+    }
+}
+//# sourceMappingURL=validate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/date-time/validate.ts"],"names":[],"mappings":"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"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,11 @@
+export { useCollapsible } from "./useCollapsible.js";
+export { useControllableState } from "./useControllableState.js";
+export { useDebouncedCallback } from "./useDebouncedCallback.js";
+export { useDebouncedState } from "./useDebouncedState.js";
+export { type DeviceFormFactor, useDeviceFormFactor } from "./useDeviceFormFactor.js";
+export { useLocalStorage } from "./useLocalStorage.js";
+export { useMergedFloatingRef } from "./useMergedFloatingRef.js";
+export { usePresence } from "./usePresence.js";
+export { type StackItem, useStack } from "./useStack.js";
+export { bootstrapTheme, type ResolvedTheme, type Theme, useTheme } from "./useTheme.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,KAAK,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,KAAK,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,KAAK,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,11 @@
+export { useCollapsible } from "./useCollapsible.js";
+export { useControllableState } from "./useControllableState.js";
+export { useDebouncedCallback } from "./useDebouncedCallback.js";
+export { useDebouncedState } from "./useDebouncedState.js";
+export { useDeviceFormFactor } from "./useDeviceFormFactor.js";
+export { useLocalStorage } from "./useLocalStorage.js";
+export { useMergedFloatingRef } from "./useMergedFloatingRef.js";
+export { usePresence } from "./usePresence.js";
+export { useStack } from "./useStack.js";
+export { bootstrapTheme, useTheme } from "./useTheme.js";
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAyB,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAkB,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,cAAc,EAAkC,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/hooks/useCollapsible.d.ts

@@ -0,0 +1,7 @@
+export declare function useCollapsible(defaultExpanded?: boolean): {
+    expanded: boolean;
+    toggle: () => void;
+    collapse: () => void;
+    expand: () => void;
+};
+//# sourceMappingURL=useCollapsible.d.ts.map

package/dist/hooks/useCollapsible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCollapsible.d.ts","sourceRoot":"","sources":["../../src/hooks/useCollapsible.ts"],"names":[],"mappings":"AAEA,wBAAgB,cAAc,CAAC,eAAe,UAAO;;;;;EAapD"}

package/dist/hooks/useCollapsible.js

@@ -0,0 +1,14 @@
+import { useCallback, useState } from "react";
+export function useCollapsible(defaultExpanded = true) {
+    const [expanded, setExpanded] = useState(defaultExpanded);
+    const toggle = useCallback(() => setExpanded((prev) => !prev), []);
+    const collapse = useCallback(() => setExpanded(false), []);
+    const expand = useCallback(() => setExpanded(true), []);
+    return {
+        expanded,
+        toggle,
+        collapse,
+        expand,
+    };
+}
+//# sourceMappingURL=useCollapsible.js.map

package/dist/hooks/useCollapsible.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCollapsible.js","sourceRoot":"","sources":["../../src/hooks/useCollapsible.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE9C,MAAM,UAAU,cAAc,CAAC,eAAe,GAAG,IAAI;IACnD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC;IAE1D,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IACnE,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAExD,OAAO;QACL,QAAQ;QACR,MAAM;QACN,QAAQ;QACR,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/hooks/useControllableState.d.ts

@@ -0,0 +1,16 @@
+interface UseControllableStateOptions<T> {
+    /** Controlled value */
+    value?: T | undefined;
+    /** Default value for uncontrolled mode */
+    defaultValue: T;
+    /** Callback when value changes */
+    onChange?: ((value: T) => void) | undefined;
+}
+/**
+ * Hook for managing controlled/uncontrolled state pattern.
+ * If `value` is provided, the component is controlled.
+ * Otherwise, it manages its own internal state starting with `defaultValue`.
+ */
+export declare function useControllableState<T>({ value: controlledValue, defaultValue, onChange }: UseControllableStateOptions<T>): [T, (value: T) => void];
+export {};
+//# sourceMappingURL=useControllableState.d.ts.map

package/dist/hooks/useControllableState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useControllableState.d.ts","sourceRoot":"","sources":["../../src/hooks/useControllableState.ts"],"names":[],"mappings":"AAIA,UAAU,2BAA2B,CAAC,CAAC;IACrC,uBAAuB;IACvB,KAAK,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC;IACtB,0CAA0C;IAC1C,YAAY,EAAE,CAAC,CAAC;IAChB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC7C;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE,2BAA2B,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC,CAmCnJ"}