@getmicdrop/svelte-components 5.3.12 → 5.3.13

package/dist/datetime/parse.d.ts

@@ -0,0 +1,149 @@
+/**
+ * DateTime Parsing Functions
+ *
+ * Functions for parsing and converting between local and UTC times.
+ * All functions require explicit timezone parameters.
+ *
+ * @module datetime/parse
+ */
+import type { ISODateString, LocalDateString, LocalDateTimeString, LocalTimeString, TimezoneId } from './types';
+/**
+ * Converts a local datetime string to UTC ISO string.
+ *
+ * @param localDateTime - Local datetime string (e.g., '2023-12-25T19:00:00')
+ * @param timezone - IANA timezone ID
+ * @returns UTC ISO string (e.g., '2023-12-26T03:00:00Z')
+ * @throws {DateTimeError} If timezone or datetime is invalid
+ *
+ * @example
+ * parseLocalToUTC('2023-12-25T19:00:00', 'America/Los_Angeles')
+ * // '2023-12-26T03:00:00Z' (7 PM LA = 3 AM next day UTC)
+ */
+export declare function parseLocalToUTC(localDateTime: LocalDateTimeString, timezone: TimezoneId): ISODateString;
+/**
+ * Converts a UTC ISO string to local datetime string.
+ *
+ * @param utcIso - UTC ISO string (e.g., '2023-12-26T03:00:00Z')
+ * @param timezone - IANA timezone ID
+ * @returns Local datetime string without timezone (e.g., '2023-12-25T19:00:00')
+ * @throws {DateTimeError} If timezone or ISO string is invalid
+ *
+ * @example
+ * parseUTCToLocal('2023-12-26T03:00:00Z', 'America/Los_Angeles')
+ * // '2023-12-25T19:00:00' (3 AM UTC = 7 PM previous day LA)
+ */
+export declare function parseUTCToLocal(utcIso: ISODateString, timezone: TimezoneId): LocalDateTimeString;
+/**
+ * Combines a date string and time string into a UTC ISO string.
+ *
+ * @param date - Date string in YYYY-MM-DD format
+ * @param time - Time string in HH:mm or HH:mm:ss format
+ * @param timezone - IANA timezone ID
+ * @returns UTC ISO string
+ * @throws {DateTimeError} If any input is invalid
+ *
+ * @example
+ * combineDateAndTime('2023-12-25', '19:00', 'America/Los_Angeles')
+ * // '2023-12-26T03:00:00Z'
+ */
+export declare function combineDateAndTime(date: LocalDateString, time: LocalTimeString, timezone: TimezoneId): ISODateString;
+/**
+ * Parses a UTC ISO string into separate date and time components.
+ *
+ * @param utcIso - UTC ISO string
+ * @param timezone - IANA timezone ID
+ * @returns Object with date (YYYY-MM-DD) and time (HH:mm) strings in local timezone
+ * @throws {DateTimeError} If inputs are invalid
+ *
+ * @example
+ * parseDateTimeFromAPI('2023-12-26T03:00:00Z', 'America/Los_Angeles')
+ * // { date: '2023-12-25', time: '19:00' }
+ */
+export declare function parseDateTimeFromAPI(utcIso: ISODateString, timezone: TimezoneId): {
+    date: LocalDateString;
+    time: LocalTimeString;
+};
+/**
+ * Formats a Date object for API submission (UTC ISO string).
+ *
+ * @param date - JavaScript Date object
+ * @returns UTC ISO string
+ * @throws {DateTimeError} If date is invalid
+ *
+ * @example
+ * formatDateTimeForAPI(new Date('2023-12-25T19:00:00-08:00'))
+ * // '2023-12-26T03:00:00Z'
+ */
+export declare function formatDateTimeForAPI(date: Date): ISODateString;
+/**
+ * Parses a date-only string and returns start of day in UTC.
+ *
+ * @param dateStr - Date string in YYYY-MM-DD format
+ * @param timezone - IANA timezone ID
+ * @returns UTC ISO string for start of day
+ *
+ * @example
+ * parseStartOfDay('2023-12-25', 'America/Los_Angeles')
+ * // '2023-12-25T08:00:00Z' (midnight LA = 8 AM UTC)
+ */
+export declare function parseStartOfDay(dateStr: LocalDateString, timezone: TimezoneId): ISODateString;
+/**
+ * Parses a date-only string and returns end of day in UTC.
+ *
+ * @param dateStr - Date string in YYYY-MM-DD format
+ * @param timezone - IANA timezone ID
+ * @returns UTC ISO string for end of day (23:59:59)
+ *
+ * @example
+ * parseEndOfDay('2023-12-25', 'America/Los_Angeles')
+ * // '2023-12-26T07:59:59Z' (11:59:59 PM LA = 7:59:59 AM next day UTC)
+ */
+export declare function parseEndOfDay(dateStr: LocalDateString, timezone: TimezoneId): ISODateString;
+/**
+ * Checks if a time string indicates next-day time (has +1_ prefix).
+ * This is a MicDrop convention for overnight events.
+ *
+ * @param timeStr - Time string that may have +1_ prefix
+ * @returns true if it's a next-day time
+ *
+ * @example
+ * isNextDayTime('+1_02:00') // true
+ * isNextDayTime('14:00') // false
+ */
+export declare function isNextDayTime(timeStr: string): boolean;
+/**
+ * Strips the next-day prefix from a time string.
+ *
+ * @param timeStr - Time string that may have +1_ prefix
+ * @returns Time string without prefix
+ *
+ * @example
+ * stripNextDayPrefix('+1_02:00') // '02:00'
+ * stripNextDayPrefix('14:00') // '14:00'
+ */
+export declare function stripNextDayPrefix(timeStr: string): LocalTimeString;
+/**
+ * Converts a time string to minutes since midnight.
+ *
+ * @param timeStr - Time string in HH:mm format (may have +1_ prefix)
+ * @returns Minutes since midnight (0-1439 for same day, 1440+ for next day)
+ *
+ * @example
+ * parseTimeToMinutes('14:30') // 870
+ * parseTimeToMinutes('+1_02:00') // 1560 (26 hours = 1560 minutes)
+ */
+export declare function parseTimeToMinutes(timeStr: string): number;
+/**
+ * Converts minutes since midnight to a time string.
+ *
+ * @param minutes - Minutes since midnight
+ * @param includeNextDayPrefix - If true and minutes >= 1440, adds +1_ prefix
+ * @returns Time string in HH:mm format
+ *
+ * @example
+ * minutesToTimeString(870) // '14:30'
+ * minutesToTimeString(1560, true) // '+1_02:00'
+ * minutesToTimeString(1560, false) // '02:00'
+ */
+export declare function minutesToTimeString(minutes: number, includeNextDayPrefix?: boolean): LocalTimeString;
+//# sourceMappingURL=parse.d.ts.map

package/dist/datetime/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/lib/datetime/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,UAAU,EACX,MAAM,SAAS,CAAC;AA6EjB;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,mBAAmB,EAClC,QAAQ,EAAE,UAAU,GACnB,aAAa,CAwBf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,UAAU,GACnB,mBAAmB,CAyBrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,eAAe,EACrB,QAAQ,EAAE,UAAU,GACnB,aAAa,CAUf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,UAAU,GACnB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE,CA0BlD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,aAAa,CAU9D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,UAAU,GACnB,aAAa,CAEf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,UAAU,GACnB,aAAa,CAEf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAKnE;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAc1D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,oBAAoB,GAAE,OAAe,GACpC,eAAe,CAcjB"}

package/dist/datetime/parse.js

@@ -0,0 +1,276 @@
+/**
+ * DateTime Parsing Functions
+ *
+ * Functions for parsing and converting between local and UTC times.
+ * All functions require explicit timezone parameters.
+ *
+ * @module datetime/parse
+ */
+import { format, parse } from 'date-fns';
+import { fromZonedTime, toZonedTime } from 'date-fns-tz';
+import { DATE_FORMATS } from './constants';
+import { isValidTimezone } from './timezone';
+import { DateTimeError, DateTimeErrorCode } from './types';
+/**
+ * Validates and ensures timezone is valid.
+ * @internal
+ */
+function validateTimezone(timezone) {
+    if (!isValidTimezone(timezone)) {
+        throw new DateTimeError(`Invalid timezone: ${timezone}`, DateTimeErrorCode.INVALID_TIMEZONE, { timezone });
+    }
+}
+/**
+ * Validates a date string in YYYY-MM-DD format.
+ * @internal
+ */
+function validateDateString(dateStr) {
+    if (!dateStr || typeof dateStr !== 'string') {
+        throw new DateTimeError('Date string is required', DateTimeErrorCode.INVALID_DATE, { value: dateStr });
+    }
+    const dateRegex = /^\d{4}-\d{2}-\d{2}$/;
+    if (!dateRegex.test(dateStr)) {
+        throw new DateTimeError(`Invalid date format: ${dateStr}. Expected YYYY-MM-DD`, DateTimeErrorCode.INVALID_DATE, { value: dateStr });
+    }
+    // Verify it's a valid date
+    const [year, month, day] = dateStr.split('-').map(Number);
+    const date = new Date(year, month - 1, day);
+    if (date.getFullYear() !== year ||
+        date.getMonth() !== month - 1 ||
+        date.getDate() !== day) {
+        throw new DateTimeError(`Invalid date: ${dateStr}`, DateTimeErrorCode.INVALID_DATE, { value: dateStr });
+    }
+}
+/**
+ * Validates a time string in HH:mm or HH:mm:ss format.
+ * @internal
+ */
+function validateTimeString(timeStr) {
+    if (!timeStr || typeof timeStr !== 'string') {
+        throw new DateTimeError('Time string is required', DateTimeErrorCode.INVALID_TIME, { value: timeStr });
+    }
+    const timeRegex = /^([01]\d|2[0-3]):([0-5]\d)(:[0-5]\d)?$/;
+    if (!timeRegex.test(timeStr)) {
+        throw new DateTimeError(`Invalid time format: ${timeStr}. Expected HH:mm or HH:mm:ss`, DateTimeErrorCode.INVALID_TIME, { value: timeStr });
+    }
+}
+/**
+ * Converts a local datetime string to UTC ISO string.
+ *
+ * @param localDateTime - Local datetime string (e.g., '2023-12-25T19:00:00')
+ * @param timezone - IANA timezone ID
+ * @returns UTC ISO string (e.g., '2023-12-26T03:00:00Z')
+ * @throws {DateTimeError} If timezone or datetime is invalid
+ *
+ * @example
+ * parseLocalToUTC('2023-12-25T19:00:00', 'America/Los_Angeles')
+ * // '2023-12-26T03:00:00Z' (7 PM LA = 3 AM next day UTC)
+ */
+export function parseLocalToUTC(localDateTime, timezone) {
+    validateTimezone(timezone);
+    if (!localDateTime || typeof localDateTime !== 'string') {
+        throw new DateTimeError('Local datetime is required', DateTimeErrorCode.PARSE_ERROR, { value: localDateTime });
+    }
+    // Parse the local datetime string
+    const localDate = new Date(localDateTime);
+    if (isNaN(localDate.getTime())) {
+        throw new DateTimeError(`Invalid local datetime: ${localDateTime}`, DateTimeErrorCode.PARSE_ERROR, { value: localDateTime });
+    }
+    // Convert from zoned time to UTC
+    const utcDate = fromZonedTime(localDate, timezone);
+    return utcDate.toISOString();
+}
+/**
+ * Converts a UTC ISO string to local datetime string.
+ *
+ * @param utcIso - UTC ISO string (e.g., '2023-12-26T03:00:00Z')
+ * @param timezone - IANA timezone ID
+ * @returns Local datetime string without timezone (e.g., '2023-12-25T19:00:00')
+ * @throws {DateTimeError} If timezone or ISO string is invalid
+ *
+ * @example
+ * parseUTCToLocal('2023-12-26T03:00:00Z', 'America/Los_Angeles')
+ * // '2023-12-25T19:00:00' (3 AM UTC = 7 PM previous day LA)
+ */
+export function parseUTCToLocal(utcIso, timezone) {
+    validateTimezone(timezone);
+    if (!utcIso || typeof utcIso !== 'string') {
+        throw new DateTimeError('UTC ISO string is required', DateTimeErrorCode.INVALID_ISO_STRING, { value: utcIso });
+    }
+    const date = new Date(utcIso);
+    if (isNaN(date.getTime())) {
+        throw new DateTimeError(`Invalid UTC ISO string: ${utcIso}`, DateTimeErrorCode.INVALID_ISO_STRING, { value: utcIso });
+    }
+    // Convert to zoned time
+    const zonedDate = toZonedTime(date, timezone);
+    // Format as local datetime string (without timezone info)
+    return format(zonedDate, "yyyy-MM-dd'T'HH:mm:ss");
+}
+/**
+ * Combines a date string and time string into a UTC ISO string.
+ *
+ * @param date - Date string in YYYY-MM-DD format
+ * @param time - Time string in HH:mm or HH:mm:ss format
+ * @param timezone - IANA timezone ID
+ * @returns UTC ISO string
+ * @throws {DateTimeError} If any input is invalid
+ *
+ * @example
+ * combineDateAndTime('2023-12-25', '19:00', 'America/Los_Angeles')
+ * // '2023-12-26T03:00:00Z'
+ */
+export function combineDateAndTime(date, time, timezone) {
+    validateTimezone(timezone);
+    validateDateString(date);
+    validateTimeString(time);
+    // Ensure time has seconds
+    const normalizedTime = time.length === 5 ? `${time}:00` : time;
+    const localDateTime = `${date}T${normalizedTime}`;
+    return parseLocalToUTC(localDateTime, timezone);
+}
+/**
+ * Parses a UTC ISO string into separate date and time components.
+ *
+ * @param utcIso - UTC ISO string
+ * @param timezone - IANA timezone ID
+ * @returns Object with date (YYYY-MM-DD) and time (HH:mm) strings in local timezone
+ * @throws {DateTimeError} If inputs are invalid
+ *
+ * @example
+ * parseDateTimeFromAPI('2023-12-26T03:00:00Z', 'America/Los_Angeles')
+ * // { date: '2023-12-25', time: '19:00' }
+ */
+export function parseDateTimeFromAPI(utcIso, timezone) {
+    validateTimezone(timezone);
+    if (!utcIso || typeof utcIso !== 'string') {
+        throw new DateTimeError('UTC ISO string is required', DateTimeErrorCode.INVALID_ISO_STRING, { value: utcIso });
+    }
+    const date = new Date(utcIso);
+    if (isNaN(date.getTime())) {
+        throw new DateTimeError(`Invalid UTC ISO string: ${utcIso}`, DateTimeErrorCode.INVALID_ISO_STRING, { value: utcIso });
+    }
+    const zonedDate = toZonedTime(date, timezone);
+    return {
+        date: format(zonedDate, DATE_FORMATS.API_DATE),
+        time: format(zonedDate, DATE_FORMATS.TIME_24H),
+    };
+}
+/**
+ * Formats a Date object for API submission (UTC ISO string).
+ *
+ * @param date - JavaScript Date object
+ * @returns UTC ISO string
+ * @throws {DateTimeError} If date is invalid
+ *
+ * @example
+ * formatDateTimeForAPI(new Date('2023-12-25T19:00:00-08:00'))
+ * // '2023-12-26T03:00:00Z'
+ */
+export function formatDateTimeForAPI(date) {
+    if (!(date instanceof Date) || isNaN(date.getTime())) {
+        throw new DateTimeError('Valid Date object is required', DateTimeErrorCode.INVALID_DATE, { value: date });
+    }
+    return date.toISOString();
+}
+/**
+ * Parses a date-only string and returns start of day in UTC.
+ *
+ * @param dateStr - Date string in YYYY-MM-DD format
+ * @param timezone - IANA timezone ID
+ * @returns UTC ISO string for start of day
+ *
+ * @example
+ * parseStartOfDay('2023-12-25', 'America/Los_Angeles')
+ * // '2023-12-25T08:00:00Z' (midnight LA = 8 AM UTC)
+ */
+export function parseStartOfDay(dateStr, timezone) {
+    return combineDateAndTime(dateStr, '00:00', timezone);
+}
+/**
+ * Parses a date-only string and returns end of day in UTC.
+ *
+ * @param dateStr - Date string in YYYY-MM-DD format
+ * @param timezone - IANA timezone ID
+ * @returns UTC ISO string for end of day (23:59:59)
+ *
+ * @example
+ * parseEndOfDay('2023-12-25', 'America/Los_Angeles')
+ * // '2023-12-26T07:59:59Z' (11:59:59 PM LA = 7:59:59 AM next day UTC)
+ */
+export function parseEndOfDay(dateStr, timezone) {
+    return combineDateAndTime(dateStr, '23:59:59', timezone);
+}
+/**
+ * Checks if a time string indicates next-day time (has +1_ prefix).
+ * This is a MicDrop convention for overnight events.
+ *
+ * @param timeStr - Time string that may have +1_ prefix
+ * @returns true if it's a next-day time
+ *
+ * @example
+ * isNextDayTime('+1_02:00') // true
+ * isNextDayTime('14:00') // false
+ */
+export function isNextDayTime(timeStr) {
+    return timeStr?.startsWith('+1_') || false;
+}
+/**
+ * Strips the next-day prefix from a time string.
+ *
+ * @param timeStr - Time string that may have +1_ prefix
+ * @returns Time string without prefix
+ *
+ * @example
+ * stripNextDayPrefix('+1_02:00') // '02:00'
+ * stripNextDayPrefix('14:00') // '14:00'
+ */
+export function stripNextDayPrefix(timeStr) {
+    if (isNextDayTime(timeStr)) {
+        return timeStr.slice(3);
+    }
+    return timeStr;
+}
+/**
+ * Converts a time string to minutes since midnight.
+ *
+ * @param timeStr - Time string in HH:mm format (may have +1_ prefix)
+ * @returns Minutes since midnight (0-1439 for same day, 1440+ for next day)
+ *
+ * @example
+ * parseTimeToMinutes('14:30') // 870
+ * parseTimeToMinutes('+1_02:00') // 1560 (26 hours = 1560 minutes)
+ */
+export function parseTimeToMinutes(timeStr) {
+    const isNextDay = isNextDayTime(timeStr);
+    const cleanTime = stripNextDayPrefix(timeStr);
+    validateTimeString(cleanTime);
+    const [hours, minutes] = cleanTime.split(':').map(Number);
+    let totalMinutes = hours * 60 + minutes;
+    if (isNextDay) {
+        totalMinutes += 24 * 60;
+    }
+    return totalMinutes;
+}
+/**
+ * Converts minutes since midnight to a time string.
+ *
+ * @param minutes - Minutes since midnight
+ * @param includeNextDayPrefix - If true and minutes >= 1440, adds +1_ prefix
+ * @returns Time string in HH:mm format
+ *
+ * @example
+ * minutesToTimeString(870) // '14:30'
+ * minutesToTimeString(1560, true) // '+1_02:00'
+ * minutesToTimeString(1560, false) // '02:00'
+ */
+export function minutesToTimeString(minutes, includeNextDayPrefix = false) {
+    const isNextDay = minutes >= 24 * 60;
+    const normalizedMinutes = minutes % (24 * 60);
+    const hours = Math.floor(normalizedMinutes / 60);
+    const mins = normalizedMinutes % 60;
+    const timeStr = `${hours.toString().padStart(2, '0')}:${mins.toString().padStart(2, '0')}`;
+    if (isNextDay && includeNextDayPrefix) {
+        return `+1_${timeStr}`;
+    }
+    return timeStr;
+}

package/dist/datetime/timezone.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Timezone Utilities
+ *
+ * Functions for working with IANA timezones.
+ * All timezone operations require explicit timezone IDs - no defaults.
+ *
+ * @module datetime/timezone
+ */
+import type { TimezoneId, VenueWithTimezone } from './types';
+/**
+ * Validates whether a string is a valid IANA timezone identifier.
+ * Rejects common abbreviations like PST, EST, etc. even if the runtime accepts them.
+ *
+ * @param timezone - The timezone string to validate
+ * @returns true if valid IANA timezone, false otherwise
+ *
+ * @example
+ * isValidTimezone('America/Los_Angeles') // true
+ * isValidTimezone('PST') // false (abbreviations not valid)
+ * isValidTimezone('Invalid/Zone') // false
+ */
+export declare function isValidTimezone(timezone: string): boolean;
+/**
+ * Extracts the timezone from a venue object.
+ * Throws if the venue doesn't have a valid timezone.
+ *
+ * @param venue - Venue object with optional timezone property
+ * @returns The venue's timezone ID
+ * @throws {DateTimeError} If venue timezone is missing or invalid
+ *
+ * @example
+ * const tz = getVenueTimezone({ timezone: 'America/Los_Angeles' });
+ * // tz === 'America/Los_Angeles'
+ *
+ * getVenueTimezone({}) // throws DateTimeError
+ */
+export declare function getVenueTimezone(venue: VenueWithTimezone): TimezoneId;
+/**
+ * Gets the user's browser/system timezone.
+ *
+ * @returns The user's IANA timezone ID
+ *
+ * @example
+ * const userTz = getUserTimezone();
+ * // e.g., 'America/Los_Angeles'
+ */
+export declare function getUserTimezone(): TimezoneId;
+/**
+ * Gets a human-readable timezone offset string.
+ *
+ * @param timezone - IANA timezone ID
+ * @param date - Optional date for DST-aware offset (defaults to now)
+ * @returns Formatted offset string (e.g., "PST (UTC-8)" or "PDT (UTC-7)")
+ * @throws {DateTimeError} If timezone is invalid
+ *
+ * @example
+ * getTimezoneOffset('America/Los_Angeles')
+ * // "PST (UTC-8)" in winter, "PDT (UTC-7)" in summer
+ */
+export declare function getTimezoneOffset(timezone: TimezoneId, date?: Date): string;
+/**
+ * Gets the display name for a timezone.
+ *
+ * @param timezone - IANA timezone ID
+ * @returns Human-readable timezone name
+ * @throws {DateTimeError} If timezone is invalid
+ *
+ * @example
+ * getTimezoneDisplayName('America/Los_Angeles')
+ * // "Pacific Time"
+ */
+export declare function getTimezoneDisplayName(timezone: TimezoneId): string;
+/**
+ * Normalizes legacy or non-standard timezone strings to valid IANA IDs.
+ * This is useful for handling user input or legacy data.
+ *
+ * @param timezone - Timezone string that may be non-standard
+ * @returns Valid IANA timezone ID
+ * @throws {DateTimeError} If timezone cannot be normalized
+ *
+ * @example
+ * normalizeTimezone('PST') // might return 'America/Los_Angeles'
+ * normalizeTimezone('Eastern') // might return 'America/New_York'
+ */
+export declare function normalizeTimezone(timezone: string): TimezoneId;
+/**
+ * Checks if a timezone is currently observing Daylight Saving Time.
+ *
+ * @param timezone - IANA timezone ID
+ * @param date - Date to check (defaults to now)
+ * @returns true if DST is in effect
+ * @throws {DateTimeError} If timezone is invalid
+ */
+export declare function isDST(timezone: TimezoneId, date?: Date): boolean;
+//# sourceMappingURL=timezone.d.ts.map

package/dist/datetime/timezone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone.d.ts","sourceRoot":"","sources":["../../src/lib/datetime/timezone.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAiC7D;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CA0BzD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,UAAU,CAoBrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,IAAI,UAAU,CAE5C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,UAAU,EACpB,IAAI,GAAE,IAAiB,GACtB,MAAM,CA2BR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,CAiBnE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CA+C9D;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,GAAE,IAAiB,GAAG,OAAO,CA0B5E"}