@getmicdrop/svelte-components 5.3.12 → 5.3.13

package/dist/datetime/timezone.js

@@ -0,0 +1,241 @@
+/**
+ * Timezone Utilities
+ *
+ * Functions for working with IANA timezones.
+ * All timezone operations require explicit timezone IDs - no defaults.
+ *
+ * @module datetime/timezone
+ */
+import { DateTimeError, DateTimeErrorCode } from './types';
+/**
+ * Cache for timezone validation results to avoid repeated Intl calls.
+ */
+const timezoneValidationCache = new Map();
+/**
+ * Common timezone abbreviations that should NOT be considered valid IANA timezones.
+ * These are handled separately by normalizeTimezone().
+ */
+const TIMEZONE_ABBREVIATIONS = new Set([
+    'PST',
+    'PDT',
+    'PT',
+    'MST',
+    'MDT',
+    'MT',
+    'CST',
+    'CDT',
+    'CT',
+    'EST',
+    'EDT',
+    'ET',
+    'GMT',
+    'BST',
+    'CET',
+    'CEST',
+    'JST',
+    'AEST',
+    'AEDT',
+]);
+/**
+ * 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 function isValidTimezone(timezone) {
+    if (!timezone || typeof timezone !== 'string') {
+        return false;
+    }
+    // Reject known abbreviations - they're not proper IANA identifiers
+    if (TIMEZONE_ABBREVIATIONS.has(timezone.toUpperCase())) {
+        return false;
+    }
+    // Check cache first
+    const cached = timezoneValidationCache.get(timezone);
+    if (cached !== undefined) {
+        return cached;
+    }
+    try {
+        // Attempt to create a DateTimeFormat with the timezone
+        // This throws for invalid timezones
+        Intl.DateTimeFormat(undefined, { timeZone: timezone });
+        timezoneValidationCache.set(timezone, true);
+        return true;
+    }
+    catch {
+        timezoneValidationCache.set(timezone, false);
+        return false;
+    }
+}
+/**
+ * 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 function getVenueTimezone(venue) {
+    const timezone = venue?.timezone;
+    if (!timezone || typeof timezone !== 'string' || timezone.trim() === '') {
+        throw new DateTimeError('Venue timezone is required', DateTimeErrorCode.MISSING_TIMEZONE, { venue });
+    }
+    if (!isValidTimezone(timezone)) {
+        throw new DateTimeError(`Invalid venue timezone: ${timezone}`, DateTimeErrorCode.INVALID_TIMEZONE, { venue, timezone });
+    }
+    return timezone;
+}
+/**
+ * Gets the user's browser/system timezone.
+ *
+ * @returns The user's IANA timezone ID
+ *
+ * @example
+ * const userTz = getUserTimezone();
+ * // e.g., 'America/Los_Angeles'
+ */
+export function getUserTimezone() {
+    return Intl.DateTimeFormat().resolvedOptions().timeZone;
+}
+/**
+ * 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 function getTimezoneOffset(timezone, date = new Date()) {
+    if (!isValidTimezone(timezone)) {
+        throw new DateTimeError(`Invalid timezone: ${timezone}`, DateTimeErrorCode.INVALID_TIMEZONE, { timezone });
+    }
+    // Get the timezone abbreviation
+    const formatter = new Intl.DateTimeFormat('en-US', {
+        timeZone: timezone,
+        timeZoneName: 'short',
+    });
+    const parts = formatter.formatToParts(date);
+    const tzPart = parts.find(p => p.type === 'timeZoneName');
+    const abbr = tzPart?.value || timezone;
+    // Calculate offset in hours
+    const utcDate = new Date(date.toLocaleString('en-US', { timeZone: 'UTC' }));
+    const tzDate = new Date(date.toLocaleString('en-US', { timeZone: timezone }));
+    const offsetMs = tzDate.getTime() - utcDate.getTime();
+    const offsetHours = Math.round(offsetMs / (60 * 60 * 1000));
+    const sign = offsetHours >= 0 ? '+' : '';
+    return `${abbr} (UTC${sign}${offsetHours})`;
+}
+/**
+ * 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 function getTimezoneDisplayName(timezone) {
+    if (!isValidTimezone(timezone)) {
+        throw new DateTimeError(`Invalid timezone: ${timezone}`, DateTimeErrorCode.INVALID_TIMEZONE, { timezone });
+    }
+    const formatter = new Intl.DateTimeFormat('en-US', {
+        timeZone: timezone,
+        timeZoneName: 'long',
+    });
+    const parts = formatter.formatToParts(new Date());
+    const tzPart = parts.find(p => p.type === 'timeZoneName');
+    return tzPart?.value || timezone;
+}
+/**
+ * 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 function normalizeTimezone(timezone) {
+    if (!timezone || typeof timezone !== 'string') {
+        throw new DateTimeError('Timezone is required', DateTimeErrorCode.MISSING_TIMEZONE);
+    }
+    const trimmed = timezone.trim();
+    // If already valid, return as-is
+    if (isValidTimezone(trimmed)) {
+        return trimmed;
+    }
+    // Common abbreviation mappings (US-focused for MicDrop)
+    const abbreviationMap = {
+        PST: 'America/Los_Angeles',
+        PDT: 'America/Los_Angeles',
+        PT: 'America/Los_Angeles',
+        PACIFIC: 'America/Los_Angeles',
+        MST: 'America/Denver',
+        MDT: 'America/Denver',
+        MT: 'America/Denver',
+        MOUNTAIN: 'America/Denver',
+        CST: 'America/Chicago',
+        CDT: 'America/Chicago',
+        CT: 'America/Chicago',
+        CENTRAL: 'America/Chicago',
+        EST: 'America/New_York',
+        EDT: 'America/New_York',
+        ET: 'America/New_York',
+        EASTERN: 'America/New_York',
+        UTC: 'UTC',
+        GMT: 'UTC',
+    };
+    const normalized = abbreviationMap[trimmed.toUpperCase()];
+    if (normalized) {
+        return normalized;
+    }
+    throw new DateTimeError(`Cannot normalize timezone: ${timezone}`, DateTimeErrorCode.INVALID_TIMEZONE, { timezone });
+}
+/**
+ * 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 function isDST(timezone, date = new Date()) {
+    if (!isValidTimezone(timezone)) {
+        throw new DateTimeError(`Invalid timezone: ${timezone}`, DateTimeErrorCode.INVALID_TIMEZONE, { timezone });
+    }
+    // Compare January and July offsets - if different, DST exists
+    const jan = new Date(date.getFullYear(), 0, 1);
+    const jul = new Date(date.getFullYear(), 6, 1);
+    const getOffset = (d) => {
+        const utc = new Date(d.toLocaleString('en-US', { timeZone: 'UTC' }));
+        const tz = new Date(d.toLocaleString('en-US', { timeZone: timezone }));
+        return tz.getTime() - utc.getTime();
+    };
+    const janOffset = getOffset(jan);
+    const julOffset = getOffset(jul);
+    const currentOffset = getOffset(date);
+    // DST is the one with the larger offset (more hours ahead)
+    const dstOffset = Math.max(janOffset, julOffset);
+    return currentOffset === dstOffset && janOffset !== julOffset;
+}

package/dist/datetime/types.d.ts

@@ -0,0 +1,105 @@
+/**
+ * DateTime Module Type Definitions
+ *
+ * This module provides type-safe date/time handling for the MicDrop platform.
+ * All datetime operations should use these types to ensure consistency.
+ *
+ * @module datetime/types
+ */
+/**
+ * IANA timezone identifier (e.g., 'America/Los_Angeles', 'Europe/London')
+ * Must be a valid IANA timezone string, not abbreviations like 'PST' or 'EST'.
+ */
+export type TimezoneId = string;
+/**
+ * ISO 8601 date string in UTC format (e.g., '2023-12-25T20:00:00Z')
+ * The 'Z' suffix indicates UTC timezone.
+ */
+export type ISODateString = string;
+/**
+ * Local date string without timezone (e.g., '2023-12-25')
+ * Used for date-only inputs where time is not relevant.
+ */
+export type LocalDateString = string;
+/**
+ * Local time string in 24-hour format (e.g., '19:00', '23:30')
+ * Used for time-only inputs.
+ */
+export type LocalTimeString = string;
+/**
+ * Local datetime string without timezone (e.g., '2023-12-25T19:00:00')
+ * Used for form inputs before timezone conversion.
+ */
+export type LocalDateTimeString = string;
+/**
+ * Extracted date parts from a datetime, formatted for display.
+ */
+export interface DateParts {
+    /** Short day name (e.g., "Mon", "Tue") */
+    day: string;
+    /** Short month name (e.g., "Dec", "Jan") */
+    month: string;
+    /** Day of month (1-31) */
+    date: number;
+    /** Full year (e.g., 2025) */
+    year: number;
+}
+/**
+ * A time range with start and end times in UTC.
+ */
+export interface TimeRange {
+    /** Start time as UTC ISO string */
+    start: ISODateString;
+    /** End time as UTC ISO string */
+    end: ISODateString;
+}
+/**
+ * Formatted time range for display purposes.
+ */
+export interface FormattedTimeRange {
+    /** Formatted time display (e.g., "7:00 PM - 10:00 PM") */
+    display: string;
+    /** Formatted date (e.g., "Dec 20, 2025") */
+    date: string;
+}
+/**
+ * Options for formatting datetime values.
+ */
+export interface FormatOptions {
+    /** Include seconds in time display (default: false) */
+    includeSeconds?: boolean;
+    /** Use 24-hour format (default: false, uses 12-hour with AM/PM) */
+    use24Hour?: boolean;
+    /** Include year in date display (default: true) */
+    includeYear?: boolean;
+    /** Use short month names (default: true) */
+    shortMonth?: boolean;
+}
+/**
+ * Venue object with timezone information.
+ * Used by getVenueTimezone to extract timezone.
+ */
+export interface VenueWithTimezone {
+    timezone?: string;
+    [key: string]: unknown;
+}
+/**
+ * Error thrown when datetime operations fail.
+ */
+export declare class DateTimeError extends Error {
+    readonly code: DateTimeErrorCode;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: DateTimeErrorCode, details?: Record<string, unknown> | undefined);
+}
+/**
+ * Error codes for datetime operations.
+ */
+export declare enum DateTimeErrorCode {
+    INVALID_TIMEZONE = "INVALID_TIMEZONE",
+    INVALID_ISO_STRING = "INVALID_ISO_STRING",
+    INVALID_DATE = "INVALID_DATE",
+    INVALID_TIME = "INVALID_TIME",
+    MISSING_TIMEZONE = "MISSING_TIMEZONE",
+    PARSE_ERROR = "PARSE_ERROR"
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/datetime/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAEhC;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AAEnC;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC;AAErC;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC;AAErC;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,mCAAmC;IACnC,KAAK,EAAE,aAAa,CAAC;IACrB,iCAAiC;IACjC,GAAG,EAAE,aAAa,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mEAAmE;IACnE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mDAAmD;IACnD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;aAGpB,IAAI,EAAE,iBAAiB;aACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjD,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,iBAAiB,EACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAED;;GAEG;AACH,oBAAY,iBAAiB;IAC3B,gBAAgB,qBAAqB;IACrC,kBAAkB,uBAAuB;IACzC,YAAY,iBAAiB;IAC7B,YAAY,iBAAiB;IAC7B,gBAAgB,qBAAqB;IACrC,WAAW,gBAAgB;CAC5B"}

package/dist/datetime/types.js

@@ -0,0 +1,31 @@
+/**
+ * DateTime Module Type Definitions
+ *
+ * This module provides type-safe date/time handling for the MicDrop platform.
+ * All datetime operations should use these types to ensure consistency.
+ *
+ * @module datetime/types
+ */
+/**
+ * Error thrown when datetime operations fail.
+ */
+export class DateTimeError extends Error {
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'DateTimeError';
+    }
+}
+/**
+ * Error codes for datetime operations.
+ */
+export var DateTimeErrorCode;
+(function (DateTimeErrorCode) {
+    DateTimeErrorCode["INVALID_TIMEZONE"] = "INVALID_TIMEZONE";
+    DateTimeErrorCode["INVALID_ISO_STRING"] = "INVALID_ISO_STRING";
+    DateTimeErrorCode["INVALID_DATE"] = "INVALID_DATE";
+    DateTimeErrorCode["INVALID_TIME"] = "INVALID_TIME";
+    DateTimeErrorCode["MISSING_TIMEZONE"] = "MISSING_TIMEZONE";
+    DateTimeErrorCode["PARSE_ERROR"] = "PARSE_ERROR";
+})(DateTimeErrorCode || (DateTimeErrorCode = {}));

package/dist/index.d.ts

@@ -112,6 +112,16 @@ export { default as ShowTimeCard } from "./calendar/ShowTimeCard/ShowTimeCard.sv
 export * from "./constants/formOptions.js";
 export * from "./constants/validation.js";
 export * from "./presets/index.js";
+export * from "./utils/utils.js";
+export * from "./utils/utils/utils.js";
+export * from "./utils/greetings.js";
+export * from "./utils/imageValidation.js";
+export * from "./utils/apiConfig.js";
+export * from "./stores/toaster.js";
+export * from "./stores/navigation.js";
+export * from "./stores/auth.js";
+export * from "./config.js";
+export * from "./telemetry.js";
 export { portal } from "./utils/portal.js";
 export { typography } from "./tokens/typography.js";
 export { default as MiniMonthCalendar, default as Calendar } from "./calendar/Calendar/MiniMonthCalendar.svelte";