@getmicdrop/svelte-components 5.3.15 → 5.4.1

package/dist/datetime/constants.d.ts

@@ -130,4 +130,11 @@ export declare const EVENT_DEFAULTS: {
     /** Default doors open time before event start (minutes) */
     readonly DEFAULT_DOORS_BEFORE_MINUTES: 30;
 };
+/**
+ * Legacy timezone mappings from venue data.
+ * Maps human-readable location names to IANA timezone identifiers.
+ * Used for backwards compatibility with older venue data that stored
+ * location names instead of proper IANA timezone IDs.
+ */
+export declare const LEGACY_TIMEZONE_MAP: Record<string, string>;
 //# sourceMappingURL=constants.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/lib/datetime/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB,iCAAiC;;IAEjC,iCAAiC;;IAEjC,+BAA+B;;IAE/B,8BAA8B;;IAE9B,+BAA+B;;CAEvB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB;IAC5B,0BAA0B;;IAE1B,yBAAyB;;IAEzB,0BAA0B;;CAElB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB,iCAAiC;;IAEjC,gCAAgC;;IAEhC,0CAA0C;;IAE1C,iDAAiD;;IAEjD,qCAAqC;;IAErC,qDAAqD;;IAErD,yDAAyD;;IAEzD,4EAA4E;;IAE5E,sCAAsC;;IAEtC,wCAAwC;;IAExC,gCAAgC;;IAEhC,oCAAoC;;IAEpC,+BAA+B;;IAE/B,mCAAmC;;CAE3B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQtB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAG,qBAA8B,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,wBAAwB;IACnC,+CAA+C;;IAE/C,6DAA6D;;IAE7D,yDAAyD;;IAEzD,uDAAuD;;IAEvD,yDAAyD;;CAEjD,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB,wCAAwC;;IAExC,wCAAwC;;IAExC,mDAAmD;;IAEnD,2DAA2D;;CAEnD,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/lib/datetime/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB,iCAAiC;;IAEjC,iCAAiC;;IAEjC,+BAA+B;;IAE/B,8BAA8B;;IAE9B,+BAA+B;;CAEvB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB;IAC5B,0BAA0B;;IAE1B,yBAAyB;;IAEzB,0BAA0B;;CAElB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB,iCAAiC;;IAEjC,gCAAgC;;IAEhC,0CAA0C;;IAE1C,iDAAiD;;IAEjD,qCAAqC;;IAErC,qDAAqD;;IAErD,yDAAyD;;IAEzD,4EAA4E;;IAE5E,sCAAsC;;IAEtC,wCAAwC;;IAExC,gCAAgC;;IAEhC,oCAAoC;;IAEpC,+BAA+B;;IAE/B,mCAAmC;;CAE3B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQtB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAG,qBAA8B,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,wBAAwB;IACnC,+CAA+C;;IAE/C,6DAA6D;;IAE7D,yDAAyD;;IAEzD,uDAAuD;;IAEvD,yDAAyD;;CAEjD,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB,wCAAwC;;IAExC,wCAAwC;;IAExC,mDAAmD;;IAEnD,2DAA2D;;CAEnD,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmB7C,CAAC"}

package/dist/datetime/constants.js

@@ -110,3 +110,29 @@ export const EVENT_DEFAULTS = {
     /** Default doors open time before event start (minutes) */
     DEFAULT_DOORS_BEFORE_MINUTES: 30,
 };
+/**
+ * Legacy timezone mappings from venue data.
+ * Maps human-readable location names to IANA timezone identifiers.
+ * Used for backwards compatibility with older venue data that stored
+ * location names instead of proper IANA timezone IDs.
+ */
+export const LEGACY_TIMEZONE_MAP = {
+    'UTC': 'UTC',
+    // California
+    'California USA': 'America/Los_Angeles',
+    'California': 'America/Los_Angeles',
+    'Los Angeles': 'America/Los_Angeles',
+    'Los Angeles USA': 'America/Los_Angeles',
+    // New York
+    'New York': 'America/New_York',
+    'New York USA': 'America/New_York',
+    // Chicago
+    'Chicago': 'America/Chicago',
+    'Chicago USA': 'America/Chicago',
+    // Denver
+    'Denver': 'America/Denver',
+    'Denver USA': 'America/Denver',
+    // Phoenix (no DST)
+    'Phoenix': 'America/Phoenix',
+    'Phoenix USA': 'America/Phoenix',
+};

package/dist/datetime/index.d.ts

@@ -35,8 +35,9 @@
  */
 export type { DateParts, FormatOptions, FormattedTimeRange, ISODateString, LocalDateString, LocalDateTimeString, LocalTimeString, TimeRange, TimezoneId, VenueWithTimezone, } from './types';
 export { DateTimeError, DateTimeErrorCode } from './types';
-export { COMMON_US_TIMEZONES, DATE_FORMATS, DEFAULT_TIMEZONE, DURATIONS, DURATIONS_MINUTES, EVENT_DEFAULTS, RELATIVE_TIME_THRESHOLDS, } from './constants';
-export { getTimezoneDisplayName, getTimezoneOffset, getUserTimezone, getVenueTimezone, isDST, isValidTimezone, normalizeTimezone, } from './timezone';
+export { COMMON_US_TIMEZONES, DATE_FORMATS, DEFAULT_TIMEZONE, DURATIONS, DURATIONS_MINUTES, EVENT_DEFAULTS, LEGACY_TIMEZONE_MAP, RELATIVE_TIME_THRESHOLDS, } from './constants';
+export { formatTimezoneForDisplay, getAllTimezones, getCommonUSTimezoneOptions, getIANATimezone, getTimezoneDisplayName, getTimezoneOffset, getTimezoneOptions, getUserTimezone, getVenueTimezone, isDST, isValidIANATimezone, isValidTimezone, normalizeTimezone, } from './timezone';
+export type { TimezoneOption } from './timezone';
 export { formatDateRange, formatDayOfWeek, formatEventDate, formatEventDateTime, formatEventTime, formatMonth, formatNotificationTime, formatRelativeTime, formatTimeRange, getDateInTimezone, getDateParts, getHourInTimezone, } from './format';
 export { combineDateAndTime, formatDateTimeForAPI, isNextDayTime, minutesToTimeString, parseDateTimeFromAPI, parseEndOfDay, parseLocalToUTC, parseStartOfDay, parseTimeToMinutes, parseUTCToLocal, stripNextDayPrefix, } from './parse';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/datetime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,YAAY,EACV,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,SAAS,EACT,UAAU,EACV,iBAAiB,GAClB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAG3D,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,iBAAiB,EACjB,cAAc,EACd,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,KAAK,EACL,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,eAAe,EACf,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,kBAAkB,GACnB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/datetime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,YAAY,EACV,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,SAAS,EACT,UAAU,EACV,iBAAiB,GAClB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAG3D,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,0BAA0B,EAC1B,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,KAAK,EACL,mBAAmB,EACnB,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,EACL,eAAe,EACf,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

package/dist/datetime/index.js

@@ -35,9 +35,9 @@
  */
 export { DateTimeError, DateTimeErrorCode } from './types';
 // Constants
-export { COMMON_US_TIMEZONES, DATE_FORMATS, DEFAULT_TIMEZONE, DURATIONS, DURATIONS_MINUTES, EVENT_DEFAULTS, RELATIVE_TIME_THRESHOLDS, } from './constants';
+export { COMMON_US_TIMEZONES, DATE_FORMATS, DEFAULT_TIMEZONE, DURATIONS, DURATIONS_MINUTES, EVENT_DEFAULTS, LEGACY_TIMEZONE_MAP, RELATIVE_TIME_THRESHOLDS, } from './constants';
 // Timezone utilities
-export { getTimezoneDisplayName, getTimezoneOffset, getUserTimezone, getVenueTimezone, isDST, isValidTimezone, normalizeTimezone, } from './timezone';
+export { formatTimezoneForDisplay, getAllTimezones, getCommonUSTimezoneOptions, getIANATimezone, getTimezoneDisplayName, getTimezoneOffset, getTimezoneOptions, getUserTimezone, getVenueTimezone, isDST, isValidIANATimezone, isValidTimezone, normalizeTimezone, } from './timezone';
 // Format functions
 export { formatDateRange, formatDayOfWeek, formatEventDate, formatEventDateTime, formatEventTime, formatMonth, formatNotificationTime, formatRelativeTime, formatTimeRange, getDateInTimezone, getDateParts, getHourInTimezone, } from './format';
 // Parse functions

package/dist/datetime/timezone.d.ts

@@ -7,6 +7,11 @@
  * @module datetime/timezone
  */
 import type { TimezoneId, VenueWithTimezone } from './types';
+/** Options for formatting timezone in Select components */
+export interface TimezoneOption {
+    value: string;
+    name: string;
+}
 /**
  * Validates whether a string is a valid IANA timezone identifier.
  * Rejects common abbreviations like PST, EST, etc. even if the runtime accepts them.
@@ -92,4 +97,71 @@ export declare function normalizeTimezone(timezone: string): TimezoneId;
  * @throws {DateTimeError} If timezone is invalid
  */
 export declare function isDST(timezone: TimezoneId, date?: Date): boolean;
+/**
+ * Convert a potentially legacy timezone string to an IANA identifier.
+ * Handles legacy location names (e.g., "California USA"), IANA identifiers,
+ * and timezone abbreviations (e.g., "PST").
+ *
+ * This is the primary function for normalizing timezone strings from
+ * older venue data or user input.
+ *
+ * @param tzString - Timezone string from API or user input
+ * @returns Valid IANA timezone identifier
+ *
+ * @example
+ * getIANATimezone('California USA')  // 'America/Los_Angeles'
+ * getIANATimezone('America/New_York') // 'America/New_York' (passthrough)
+ * getIANATimezone('PST')              // 'America/Los_Angeles'
+ * getIANATimezone(null)               // 'America/Los_Angeles' (default)
+ */
+export declare function getIANATimezone(tzString: string | null | undefined): TimezoneId;
+/**
+ * Alias for isValidTimezone for backwards compatibility.
+ * @deprecated Use isValidTimezone instead
+ */
+export declare const isValidIANATimezone: typeof isValidTimezone;
+/**
+ * Get all supported IANA timezone identifiers.
+ * Uses the browser's Intl API to get the complete list.
+ *
+ * @returns Array of all valid IANA timezone identifiers
+ *
+ * @example
+ * const timezones = getAllTimezones();
+ * // ['Africa/Abidjan', 'Africa/Accra', ..., 'Pacific/Wallis']
+ */
+export declare function getAllTimezones(): string[];
+/**
+ * Format a timezone identifier into a human-readable display string.
+ * Includes the timezone abbreviation and UTC offset.
+ *
+ * @param timezone - IANA timezone identifier
+ * @returns Formatted display string
+ *
+ * @example
+ * formatTimezoneForDisplay('America/Los_Angeles')
+ * // "America / Los Angeles (PST)"
+ */
+export declare function formatTimezoneForDisplay(timezone: string): string;
+/**
+ * Get all timezones formatted for use in a Select component.
+ *
+ * @returns Array of timezone options with value and display name
+ *
+ * @example
+ * const options = getTimezoneOptions();
+ * // [{ value: 'Africa/Abidjan', name: 'Africa / Abidjan (GMT)' }, ...]
+ */
+export declare function getTimezoneOptions(): TimezoneOption[];
+/**
+ * Get commonly used US timezones formatted for Select component.
+ * Useful for quick timezone selection when most users are in the US.
+ *
+ * @returns Array of common US timezone options
+ *
+ * @example
+ * const options = getCommonUSTimezoneOptions();
+ * // [{ value: 'America/Los_Angeles', name: 'America / Los Angeles (PST)' }, ...]
+ */
+export declare function getCommonUSTimezoneOptions(): TimezoneOption[];
 //# sourceMappingURL=timezone.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"timezone.d.ts","sourceRoot":"","sources":["../../src/lib/datetime/timezone.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE7D,2DAA2D;AAC3D,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAiCD;;;;;;;;;;;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;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,CAuB/E;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,wBAAkB,CAAC;AAEnD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA0BjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,EAAE,CAOrD;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,IAAI,cAAc,EAAE,CAe7D"}

package/dist/datetime/timezone.js

@@ -6,6 +6,7 @@
  *
  * @module datetime/timezone
  */
+import { DEFAULT_TIMEZONE, LEGACY_TIMEZONE_MAP } from './constants';
 import { DateTimeError, DateTimeErrorCode } from './types';
 /**
  * Cache for timezone validation results to avoid repeated Intl calls.
@@ -239,3 +240,140 @@ export function isDST(timezone, date = new Date()) {
     const dstOffset = Math.max(janOffset, julOffset);
     return currentOffset === dstOffset && janOffset !== julOffset;
 }
+// ============================================================================
+// Legacy Timezone Support & Select Component Utilities
+// ============================================================================
+/**
+ * Convert a potentially legacy timezone string to an IANA identifier.
+ * Handles legacy location names (e.g., "California USA"), IANA identifiers,
+ * and timezone abbreviations (e.g., "PST").
+ *
+ * This is the primary function for normalizing timezone strings from
+ * older venue data or user input.
+ *
+ * @param tzString - Timezone string from API or user input
+ * @returns Valid IANA timezone identifier
+ *
+ * @example
+ * getIANATimezone('California USA')  // 'America/Los_Angeles'
+ * getIANATimezone('America/New_York') // 'America/New_York' (passthrough)
+ * getIANATimezone('PST')              // 'America/Los_Angeles'
+ * getIANATimezone(null)               // 'America/Los_Angeles' (default)
+ */
+export function getIANATimezone(tzString) {
+    if (!tzString || tzString === 'NaN') {
+        return DEFAULT_TIMEZONE;
+    }
+    // Check legacy mappings first (e.g., "California USA" -> "America/Los_Angeles")
+    const legacyMatch = LEGACY_TIMEZONE_MAP[tzString];
+    if (legacyMatch) {
+        return legacyMatch;
+    }
+    // Try to validate as IANA timezone
+    if (isValidTimezone(tzString)) {
+        return tzString;
+    }
+    // Try normalizing abbreviations (PST, EST, etc.)
+    try {
+        return normalizeTimezone(tzString);
+    }
+    catch {
+        // If all else fails, return default
+        return DEFAULT_TIMEZONE;
+    }
+}
+/**
+ * Alias for isValidTimezone for backwards compatibility.
+ * @deprecated Use isValidTimezone instead
+ */
+export const isValidIANATimezone = isValidTimezone;
+/**
+ * Get all supported IANA timezone identifiers.
+ * Uses the browser's Intl API to get the complete list.
+ *
+ * @returns Array of all valid IANA timezone identifiers
+ *
+ * @example
+ * const timezones = getAllTimezones();
+ * // ['Africa/Abidjan', 'Africa/Accra', ..., 'Pacific/Wallis']
+ */
+export function getAllTimezones() {
+    return Intl.supportedValuesOf('timeZone');
+}
+/**
+ * Format a timezone identifier into a human-readable display string.
+ * Includes the timezone abbreviation and UTC offset.
+ *
+ * @param timezone - IANA timezone identifier
+ * @returns Formatted display string
+ *
+ * @example
+ * formatTimezoneForDisplay('America/Los_Angeles')
+ * // "America / Los Angeles (PST)"
+ */
+export function formatTimezoneForDisplay(timezone) {
+    try {
+        const now = new Date();
+        const formatter = new Intl.DateTimeFormat('en-US', {
+            timeZone: timezone,
+            timeZoneName: 'short',
+        });
+        const parts = formatter.formatToParts(now);
+        const tzAbbrev = parts.find(p => p.type === 'timeZoneName')?.value || '';
+        // Get UTC offset
+        const offsetFormatter = new Intl.DateTimeFormat('en-US', {
+            timeZone: timezone,
+            timeZoneName: 'longOffset',
+        });
+        const offsetParts = offsetFormatter.formatToParts(now);
+        const offset = offsetParts.find(p => p.type === 'timeZoneName')?.value || '';
+        // Format the display name
+        const displayName = timezone.replace(/_/g, ' ').replace(/\//g, ' / ');
+        return `${displayName} (${tzAbbrev || offset})`;
+    }
+    catch {
+        // Fallback if formatting fails
+        return timezone.replace(/_/g, ' ');
+    }
+}
+/**
+ * Get all timezones formatted for use in a Select component.
+ *
+ * @returns Array of timezone options with value and display name
+ *
+ * @example
+ * const options = getTimezoneOptions();
+ * // [{ value: 'Africa/Abidjan', name: 'Africa / Abidjan (GMT)' }, ...]
+ */
+export function getTimezoneOptions() {
+    const timezones = getAllTimezones();
+    return timezones.map(tz => ({
+        value: tz,
+        name: formatTimezoneForDisplay(tz),
+    }));
+}
+/**
+ * Get commonly used US timezones formatted for Select component.
+ * Useful for quick timezone selection when most users are in the US.
+ *
+ * @returns Array of common US timezone options
+ *
+ * @example
+ * const options = getCommonUSTimezoneOptions();
+ * // [{ value: 'America/Los_Angeles', name: 'America / Los Angeles (PST)' }, ...]
+ */
+export function getCommonUSTimezoneOptions() {
+    const commonTimezones = [
+        'America/Los_Angeles',
+        'America/Denver',
+        'America/Phoenix',
+        'America/Chicago',
+        'America/New_York',
+        'America/Anchorage',
+        'Pacific/Honolulu',
+    ];
+    return commonTimezones.map(tz => ({
+        value: tz,
+        name: formatTimezoneForDisplay(tz),
+    }));
+}

package/dist/forms/createFieldTracker.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createFieldTracker.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/forms/createFieldTracker.svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAMH,MAAM,WAAW,YAAY;IAE3B,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IAGjB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAG1B,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;IAGvC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;CAC3D;AAMD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,OAAO,GAAG,YAAY,CAqEzE"}
+{"version":3,"file":"createFieldTracker.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/forms/createFieldTracker.svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAMH,MAAM,WAAW,YAAY;IAE3B,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IAGjB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAG1B,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;IAGvC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;CAC3D;AAMD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,OAAO,GAAG,YAAY,CAkEzE"}

package/dist/forms/createFieldTracker.svelte.js

@@ -36,12 +36,9 @@ export function createFieldTracker(isDirtyFn) {
     let isSaved = $state(false);
     // Use the provided function to compute isDirty
     const isDirty = $derived(isDirtyFn());
-    // Auto-reset isSaved when form becomes dirty
-    $effect(() => {
-        if (isDirty && isSaved) {
-            isSaved = false;
-        }
-    });
+    // Note: Auto-reset of isSaved when dirty is now handled by consumers
+    // via watching isDirty in their component's $effect, or simply by the
+    // save() method which sets isSaved = true after success.
     function canSave(isValid) {
         return isDirty && isValid && !isSaving;
     }

package/dist/stripe/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Stripe Utilities
+ *
+ * Shared utilities for Stripe integration including theme detection
+ * and reactive dark mode support.
+ */
+export { useStripeTheme, detectDarkMode, getStripeTheme, getInitialStripeTheme, type StripeTheme, type StripeThemeOptions, } from './useStripeTheme.svelte';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/stripe/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,yBAAyB,CAAC"}

package/dist/stripe/index.js

@@ -0,0 +1,7 @@
+/**
+ * Stripe Utilities
+ *
+ * Shared utilities for Stripe integration including theme detection
+ * and reactive dark mode support.
+ */
+export { useStripeTheme, detectDarkMode, getStripeTheme, getInitialStripeTheme, } from './useStripeTheme.svelte';

package/dist/stripe/useStripeTheme.svelte.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Stripe Theme Utility
+ *
+ * Provides reactive dark mode detection for Stripe Elements.
+ * Automatically watches for theme changes via MutationObserver.
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { useStripeTheme } from '@getmicdrop/svelte-components/stripe';
+ *
+ *   const stripeTheme = useStripeTheme();
+ *   // stripeTheme.current is 'stripe' | 'night'
+ *   // Automatically updates when theme changes
+ * </script>
+ *
+ * <Elements theme={stripeTheme.current} {stripe} clientSecret={paymentIntent}>
+ *   <PaymentElement />
+ * </Elements>
+ * ```
+ */
+export type StripeTheme = 'stripe' | 'night' | 'flat';
+export interface StripeThemeOptions {
+    /**
+     * Selector for the container element that has .dark/.light classes.
+     * @default '.dark, .light, .micdrop, [data-theme]'
+     */
+    containerSelector?: string;
+    /**
+     * Whether to watch for theme changes via MutationObserver.
+     * @default true
+     */
+    watchChanges?: boolean;
+    /**
+     * Initial theme if detection fails.
+     * @default 'stripe'
+     */
+    fallback?: StripeTheme;
+}
+/**
+ * Detects if dark mode is active.
+ *
+ * Checks in order:
+ * 1. localStorage 'theme' value
+ * 2. Container element classes (.dark, [data-theme="dark"])
+ * 3. System preference (prefers-color-scheme)
+ */
+export declare function detectDarkMode(containerSelector?: string): boolean;
+/**
+ * Maps dark mode state to Stripe theme.
+ */
+export declare function getStripeTheme(isDark: boolean): StripeTheme;
+/**
+ * Creates a reactive Stripe theme that watches for dark mode changes.
+ *
+ * Returns an object with a `current` property that is reactive and
+ * automatically updates when the theme changes.
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { useStripeTheme } from '@getmicdrop/svelte-components/stripe';
+ *   const stripeTheme = useStripeTheme();
+ * </script>
+ *
+ * <Elements theme={stripeTheme.current} ...>
+ * ```
+ */
+export declare function useStripeTheme(options?: StripeThemeOptions): {
+    readonly current: StripeTheme;
+    /** Force refresh the theme detection */
+    refresh: () => void;
+};
+/**
+ * Simple synchronous dark mode detection without reactivity.
+ * Use this when you only need a one-time check.
+ */
+export declare function getInitialStripeTheme(containerSelector?: string): StripeTheme;
+//# sourceMappingURL=useStripeTheme.svelte.d.ts.map

package/dist/stripe/useStripeTheme.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStripeTheme.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/stripe/useStripeTheme.svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAEtD,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CA6BlE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW,CAE3D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,kBAAuB;;IA0D3D,wCAAwC;;EAG3C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,iBAAiB,CAAC,EAAE,MAAM,GACzB,WAAW,CAEb"}

package/dist/stripe/useStripeTheme.svelte.js

@@ -0,0 +1,138 @@
+/**
+ * Stripe Theme Utility
+ *
+ * Provides reactive dark mode detection for Stripe Elements.
+ * Automatically watches for theme changes via MutationObserver.
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { useStripeTheme } from '@getmicdrop/svelte-components/stripe';
+ *
+ *   const stripeTheme = useStripeTheme();
+ *   // stripeTheme.current is 'stripe' | 'night'
+ *   // Automatically updates when theme changes
+ * </script>
+ *
+ * <Elements theme={stripeTheme.current} {stripe} clientSecret={paymentIntent}>
+ *   <PaymentElement />
+ * </Elements>
+ * ```
+ */
+import { onMount, onDestroy } from 'svelte';
+/**
+ * Detects if dark mode is active.
+ *
+ * Checks in order:
+ * 1. localStorage 'theme' value
+ * 2. Container element classes (.dark, [data-theme="dark"])
+ * 3. System preference (prefers-color-scheme)
+ */
+export function detectDarkMode(containerSelector) {
+    if (typeof window === 'undefined')
+        return false;
+    try {
+        // Check localStorage first
+        const saved = localStorage.getItem('theme');
+        if (saved === 'dark')
+            return true;
+        if (saved === 'light')
+            return false;
+        // Check for dark class on common containers
+        const selector = containerSelector || '.dark, .light, .micdrop, [data-theme]';
+        const containers = document.querySelectorAll(selector);
+        for (const container of containers) {
+            if (container.classList.contains('dark'))
+                return true;
+            if (container.getAttribute('data-theme') === 'dark')
+                return true;
+        }
+        // Check document root
+        if (document.documentElement.classList.contains('dark'))
+            return true;
+        if (document.documentElement.getAttribute('data-theme') === 'dark')
+            return true;
+        // Fallback to system preference
+        return window.matchMedia?.('(prefers-color-scheme: dark)')?.matches ?? false;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Maps dark mode state to Stripe theme.
+ */
+export function getStripeTheme(isDark) {
+    return isDark ? 'night' : 'stripe';
+}
+/**
+ * Creates a reactive Stripe theme that watches for dark mode changes.
+ *
+ * Returns an object with a `current` property that is reactive and
+ * automatically updates when the theme changes.
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { useStripeTheme } from '@getmicdrop/svelte-components/stripe';
+ *   const stripeTheme = useStripeTheme();
+ * </script>
+ *
+ * <Elements theme={stripeTheme.current} ...>
+ * ```
+ */
+export function useStripeTheme(options = {}) {
+    const { containerSelector = '.dark, .light, .micdrop, [data-theme]', watchChanges = true, fallback = 'stripe', } = options;
+    let current = $state(fallback);
+    let observer = null;
+    function updateTheme() {
+        current = getStripeTheme(detectDarkMode(containerSelector));
+    }
+    onMount(() => {
+        // Initial detection
+        updateTheme();
+        if (watchChanges && typeof MutationObserver !== 'undefined') {
+            // Watch for class changes on potential theme containers
+            const containers = document.querySelectorAll(containerSelector);
+            const root = document.documentElement;
+            observer = new MutationObserver(() => {
+                updateTheme();
+            });
+            // Observe document root
+            observer.observe(root, {
+                attributes: true,
+                attributeFilter: ['class', 'data-theme'],
+            });
+            // Observe other containers
+            containers.forEach(container => {
+                observer?.observe(container, {
+                    attributes: true,
+                    attributeFilter: ['class', 'data-theme'],
+                });
+            });
+            // Also listen for system preference changes
+            const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');
+            mediaQuery.addEventListener('change', updateTheme);
+        }
+    });
+    onDestroy(() => {
+        if (observer) {
+            observer.disconnect();
+            observer = null;
+        }
+    });
+    return {
+        get current() {
+            return current;
+        },
+        /** Force refresh the theme detection */
+        refresh: updateTheme,
+    };
+}
+/**
+ * Simple synchronous dark mode detection without reactivity.
+ * Use this when you only need a one-time check.
+ */
+export function getInitialStripeTheme(containerSelector) {
+    return getStripeTheme(detectDarkMode(containerSelector));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getmicdrop/svelte-components",
-  "version": "5.3.15",
+  "version": "5.4.1",
   "description": "Shared component library for Micdrop applications",
   "type": "module",
   "main": "./dist/index.js",
@@ -126,6 +126,14 @@
     },
     "./telemetry": {
       "import": "./dist/telemetry.js"
+    },
+    "./stripe": {
+      "types": "./dist/stripe/index.d.ts",
+      "import": "./dist/stripe/index.js"
+    },
+    "./stripe/useStripeTheme": {
+      "types": "./dist/stripe/useStripeTheme.svelte.d.ts",
+      "import": "./dist/stripe/useStripeTheme.svelte.js"
     }
   },
   "svelte": "./dist/index.js",