ts-time-utils 4.1.0 → 4.4.0

package/dist/esm/plugins.js

@@ -19,38 +19,20 @@
  * chain(new Date()).nextMonday().format('YYYY-MM-DD');
  * ```
  */
-// Import ChainedDate class directly - safe because chain.js doesn't import plugins.js
-// We need the actual class (not just the type) to modify its prototype
-let ChainedDateConstructor = null;
+import { ChainedDate } from './chain.js';
 /**
- * Get ChainedDate class lazily to ensure it's fully initialized
+ * Get ChainedDate class for prototype mutation.
+ * Importing `plugins` now brings in `chain` directly, so the class is available
+ * without a hidden global handshake.
  */
 function getChainedDate() {
-    if (!ChainedDateConstructor) {
-        // Use dynamic import that works in both CJS and ESM
-        try {
-            // Try ESM import path first
-            ChainedDateConstructor = globalThis.__chainedDateClass;
-            if (!ChainedDateConstructor) {
-                // Fallback: The class will be set by chain.js when it loads
-                throw new Error('ChainedDate not yet loaded. Import chain.js before using plugins.');
-            }
-        }
-        catch (e) {
-            throw new Error('ChainedDate class not available. Ensure chain.js is imported before registering plugins.');
-        }
+    if (!ChainedDate) {
+        throw new Error('ChainedDate export is not available yet. Import chain.js before registering plugins.');
     }
-    return ChainedDateConstructor;
-}
-/**
- * Initialize the plugin system with ChainedDate class
- * This is called automatically when chain.js is imported
- * @internal
- */
-export function __initPluginSystem(ChainedDateClass) {
-    ChainedDateConstructor = ChainedDateClass;
+    return ChainedDate;
 }
 const registry = {};
+const methodStates = {};
 /**
  * Extend ChainedDate with custom methods
  *
@@ -80,23 +62,23 @@ export function extend(pluginName, methods) {
     if (registry[pluginName]) {
         throw new Error(`Plugin "${pluginName}" is already registered. Use a different name or uninstall first.`);
     }
-    // Get ChainedDate class and save original methods before overwriting
     const ChainedDateClass = getChainedDate();
-    const originalMethods = new Map();
     Object.entries(methods).forEach(([methodName, fn]) => {
-        // Save original method if it exists
+        const current = ChainedDateClass.prototype[methodName];
+        if (!methodStates[methodName]) {
+            methodStates[methodName] = {
+                original: typeof current === 'function' ? current : undefined,
+                owners: []
+            };
+        }
         if (methodName in ChainedDateClass.prototype) {
-            const original = ChainedDateClass.prototype[methodName];
-            if (typeof original === 'function') {
-                originalMethods.set(methodName, original);
-            }
             console.warn(`Method "${methodName}" already exists on ChainedDate and will be overwritten`);
         }
+        methodStates[methodName].owners.push(pluginName);
         // Add the plugin method
         ChainedDateClass.prototype[methodName] = fn;
     });
-    // Register the plugin with its original methods
-    registry[pluginName] = { plugin: methods, originalMethods };
+    registry[pluginName] = { plugin: methods };
 }
 /**
  * Remove a plugin and its methods from ChainedDate
@@ -113,20 +95,32 @@ export function uninstall(pluginName) {
     if (!entry) {
         throw new Error(`Plugin "${pluginName}" is not registered`);
     }
-    // Get ChainedDate class and restore/remove methods
     const ChainedDateClass = getChainedDate();
     Object.keys(entry.plugin).forEach((methodName) => {
-        // If there was an original method, restore it
-        const original = entry.originalMethods.get(methodName);
-        if (original) {
-            ChainedDateClass.prototype[methodName] = original;
+        const state = methodStates[methodName];
+        if (!state) {
+            delete ChainedDateClass.prototype[methodName];
+            return;
+        }
+        state.owners = state.owners.filter((owner) => owner !== pluginName);
+        const nextOwner = state.owners[state.owners.length - 1];
+        if (nextOwner) {
+            const nextPlugin = registry[nextOwner];
+            if (nextPlugin && methodName in nextPlugin.plugin) {
+                ChainedDateClass.prototype[methodName] = nextPlugin.plugin[methodName];
+                return;
+            }
+            delete ChainedDateClass.prototype[methodName];
+            return;
+        }
+        if (state.original) {
+            ChainedDateClass.prototype[methodName] = state.original;
         }
         else {
-            // Otherwise, delete the method entirely
             delete ChainedDateClass.prototype[methodName];
         }
+        delete methodStates[methodName];
     });
-    // Remove from registry
     delete registry[pluginName];
 }
 /**

package/dist/esm/recurrence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recurrence.d.ts","sourceRoot":"","sources":["../../src/recurrence.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAuB,MAAM,YAAY,CAAC;AAGjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc;;oCAKjB,SAAS;mCACV,SAAS,OAAO,SAAS,UAAU,MAAM;6BAE/C,SAAS;;EAqBrC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI,CAyC1F;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,SAAS,EACd,KAAK,SAAO,GACX,IAAI,EAAE,CA6BR;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAW/E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAgC5E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CA6C/D"}
+{"version":3,"file":"recurrence.d.ts","sourceRoot":"","sources":["../../src/recurrence.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAuB,MAAM,YAAY,CAAC;AAGjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc;;oCAKjB,SAAS;mCACV,SAAS,OAAO,SAAS,UAAU,MAAM;6BAE/C,SAAS;;EAmBrC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI,CAyC1F;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,SAAS,EACd,KAAK,SAAO,GACX,IAAI,EAAE,CA6BR;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAW/E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAgC5E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CA6C/D"}

package/dist/esm/recurrence.js

@@ -43,19 +43,17 @@ export function createRecurrence(rule) {
         isRecurrenceDate: (date) => isRecurrenceDate(date, rule),
         getAllOccurrences: (limit = 100) => {
             const occurrences = [];
-            let current = new Date(startDate);
-            let count = 0;
-            while (count < limit) {
+            let current = new Date(startDate.getTime() - 1);
+            while (occurrences.length < limit) {
                 if (rule.until && current > new Date(rule.until))
                     break;
-                if (rule.count && count >= rule.count)
+                if (rule.count && occurrences.length >= rule.count)
                     break;
                 const next = getNextOccurrence(rule, current);
                 if (!next)
                     break;
                 occurrences.push(next);
                 current = new Date(next.getTime() + 1);
-                count++;
             }
             return occurrences;
         }

package/dist/esm/timezone.d.ts

@@ -33,6 +33,8 @@ export declare function compareZoneOffsets(zoneA: string, zoneB: string, date?:
 export declare function reinterpretAsZone(date: Date, targetZone: string): Date | null;
 /**
  * Check if a date is in Daylight Saving Time for a given timezone
+ * Uses a yearly-offset heuristic: sample the zone's local year and treat the
+ * maximum observed UTC offset as the DST offset for that year.
  * @param date - date to check
  * @param zone - IANA timezone string
  */
@@ -50,7 +52,10 @@ export declare function getNextDSTTransition(date: Date, zone: string): Date | n
  * @param workHoursStart - work hours start (0-24)
  * @param workHoursEnd - work hours end (0-24)
  * @param date - reference date (default: today)
- * @returns array of overlapping hour ranges in UTC, or null if no overlap
+ * @returns one contiguous UTC overlap window, specifically the longest
+ * contiguous overlap slice. A full-day overlap is returned as
+ * `{ startUTC: 0, endUTC: 24 }`, and wrapped overlaps are returned with
+ * `endUTC` normalized back into the 0-24 range and may be less than `startUTC`
  */
 export declare function findCommonWorkingHours(zones: string[], workHoursStart?: number, workHoursEnd?: number, date?: Date): {
     startUTC: number;

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

@@ -1 +1 @@
-{"version":3,"file":"timezone.d.ts","sourceRoot":"","sources":["../../src/timezone.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,sDAAsD;AACtD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,IAAiB,GAAG,MAAM,GAAG,IAAI,CAgBtF;AAED,iCAAiC;AACjC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,qBAA0B,GAAG,MAAM,CAG3G;AAED,yCAAyC;AACzC,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAIvE;AAED,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;CAAE,GAAG,IAAI,CAoB9J;AAED,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOrD;AAED,uEAAuE;AACvE,eAAO,MAAM,gBAAgB,UAK5B,CAAC;AAEF,0CAA0C;AAC1C,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,iDAAiD;AACjD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,IAAiB,GAAG,MAAM,GAAG,IAAI,CAKvG;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAI7E;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CA0B9D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAiD1E;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EAAE,EACf,cAAc,GAAE,MAAU,EAC1B,YAAY,GAAE,MAAW,EACzB,IAAI,GAAE,IAAiB,GACtB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA6B7C;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,IAAiB,GAAG,MAAM,GAAG,IAAI,CAY5F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAa7F;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,IAAiB,GAAG,MAAM,GAAG,IAAI,CAI/G;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,IAAiB,GAAG,OAAO,GAAG,IAAI,CAIpG"}
+{"version":3,"file":"timezone.d.ts","sourceRoot":"","sources":["../../src/timezone.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AA6B5C,sDAAsD;AACtD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,IAAiB,GAAG,MAAM,GAAG,IAAI,CAgBtF;AAED,iCAAiC;AACjC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,qBAA0B,GAAG,MAAM,CAG3G;AAED,yCAAyC;AACzC,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAIvE;AAED,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;CAAE,GAAG,IAAI,CAoB9J;AAED,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOrD;AAED,uEAAuE;AACvE,eAAO,MAAM,gBAAgB,UAK5B,CAAC;AAEF,0CAA0C;AAC1C,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,iDAAiD;AACjD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,IAAiB,GAAG,MAAM,GAAG,IAAI,CAKvG;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAI7E;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CA4B9D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAmC1E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EAAE,EACf,cAAc,GAAE,MAAU,EAC1B,YAAY,GAAE,MAAW,EACzB,IAAI,GAAE,IAAiB,GACtB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAqE7C;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,IAAiB,GAAG,MAAM,GAAG,IAAI,CAY5F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAa7F;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,IAAiB,GAAG,MAAM,GAAG,IAAI,CAI/G;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,IAAiB,GAAG,OAAO,GAAG,IAAI,CAIpG"}

package/dist/esm/timezone.js

@@ -1,6 +1,20 @@
 /**
  * Timezone utilities using Intl API with fallbacks
  */
+const DAY_MS = 24 * 60 * 60 * 1000;
+const DAY_HOURS = 24;
+const YEAR_MONTHS = Array.from({ length: 12 }, (_, month) => month);
+function normalizeHourValue(hour) {
+    return ((hour % DAY_HOURS) + DAY_HOURS) % DAY_HOURS;
+}
+function pushSweepInterval(events, start, end) {
+    const clampedStart = Math.max(0, start);
+    const clampedEnd = Math.min(DAY_HOURS * 2, end);
+    if (clampedStart >= clampedEnd)
+        return;
+    events.push({ time: clampedStart, delta: 1 });
+    events.push({ time: clampedEnd, delta: -1 });
+}
 /** Get offset (minutes) for a zone at a given date */
 export function getTimezoneOffset(zone, date = new Date()) {
     try {
@@ -99,30 +113,35 @@ export function reinterpretAsZone(date, targetZone) {
 }
 /**
  * Check if a date is in Daylight Saving Time for a given timezone
+ * Uses a yearly-offset heuristic: sample the zone's local year and treat the
+ * maximum observed UTC offset as the DST offset for that year.
  * @param date - date to check
  * @param zone - IANA timezone string
  */
 export function isDST(date, zone) {
     if (!isValidTimeZone(zone))
         return null;
-    // Compare offset in January vs July - the one with larger offset is DST
-    const january = new Date(date.getFullYear(), 0, 1);
-    const july = new Date(date.getFullYear(), 6, 1);
-    const janOffset = getTimezoneOffset(zone, january);
-    const julOffset = getTimezoneOffset(zone, july);
+    const zonedDate = convertDateToZone(date, zone);
+    if (!zonedDate) {
+        return null;
+    }
     const currentOffset = getTimezoneOffset(zone, date);
-    if (janOffset === null || julOffset === null || currentOffset === null) {
+    if (currentOffset === null) {
         return null;
     }
-    // If offsets are the same, no DST in this zone
-    if (janOffset === julOffset) {
+    const yearlyOffsets = new Set();
+    for (const month of YEAR_MONTHS) {
+        const sample = new Date(Date.UTC(zonedDate.year, month, 1, 12, 0, 0));
+        const offset = getTimezoneOffset(zone, sample);
+        if (offset === null) {
+            return null;
+        }
+        yearlyOffsets.add(offset);
+    }
+    if (yearlyOffsets.size <= 1) {
         return false;
     }
-    // In northern hemisphere, summer (July) has larger offset
-    // In southern hemisphere, summer (January) has larger offset
-    // DST is whichever is the "larger" offset
-    const maxOffset = Math.max(janOffset, julOffset);
-    return currentOffset === maxOffset;
+    return currentOffset === Math.max(...yearlyOffsets);
 }
 /**
  * Get the next DST transition (if any) for a timezone
@@ -133,46 +152,35 @@ export function isDST(date, zone) {
 export function getNextDSTTransition(date, zone) {
     if (!isValidTimeZone(zone))
         return null;
-    const january = new Date(date.getFullYear(), 0, 1);
-    const july = new Date(date.getFullYear(), 6, 1);
-    const janOffset = getTimezoneOffset(zone, january);
-    const julOffset = getTimezoneOffset(zone, july);
-    if (janOffset === null || julOffset === null)
-        return null;
-    // No DST if offsets are the same
-    if (janOffset === julOffset)
-        return null;
-    // Binary search for the transition within the next year
     const currentOffset = getTimezoneOffset(zone, date);
     if (currentOffset === null)
         return null;
-    // Check day by day for up to 366 days
-    const searchDate = new Date(date);
-    for (let i = 1; i <= 366; i++) {
-        searchDate.setDate(searchDate.getDate() + 1);
-        const newOffset = getTimezoneOffset(zone, searchDate);
-        if (newOffset !== null && newOffset !== currentOffset) {
-            // Found a transition, now narrow it down
-            const prevDay = new Date(searchDate);
-            prevDay.setDate(prevDay.getDate() - 1);
-            // Binary search within the day
-            let low = prevDay.getTime();
-            let high = searchDate.getTime();
-            while (high - low > 60000) { // 1 minute precision
-                const mid = Math.floor((low + high) / 2);
-                const midDate = new Date(mid);
-                const midOffset = getTimezoneOffset(zone, midDate);
-                if (midOffset === currentOffset) {
-                    low = mid;
-                }
-                else {
-                    high = mid;
-                }
-            }
-            return new Date(high);
+    const startTime = date.getTime() + 1;
+    const searchLimit = startTime + 366 * DAY_MS;
+    let low = startTime;
+    let high = null;
+    for (let probeTime = startTime + DAY_MS; probeTime <= searchLimit; probeTime += DAY_MS) {
+        const probeOffset = getTimezoneOffset(zone, new Date(probeTime));
+        if (probeOffset !== null && probeOffset !== currentOffset) {
+            low = probeTime - DAY_MS;
+            high = probeTime;
+            break;
         }
     }
-    return null;
+    if (high === null) {
+        return null;
+    }
+    while (high - low > 1) {
+        const mid = Math.floor((low + high) / 2);
+        const midOffset = getTimezoneOffset(zone, new Date(mid));
+        if (midOffset === currentOffset) {
+            low = mid;
+        }
+        else {
+            high = mid;
+        }
+    }
+    return new Date(high);
 }
 /**
  * Find overlapping working hours between multiple timezones
@@ -180,32 +188,64 @@ export function getNextDSTTransition(date, zone) {
  * @param workHoursStart - work hours start (0-24)
  * @param workHoursEnd - work hours end (0-24)
  * @param date - reference date (default: today)
- * @returns array of overlapping hour ranges in UTC, or null if no overlap
+ * @returns one contiguous UTC overlap window, specifically the longest
+ * contiguous overlap slice. A full-day overlap is returned as
+ * `{ startUTC: 0, endUTC: 24 }`, and wrapped overlaps are returned with
+ * `endUTC` normalized back into the 0-24 range and may be less than `startUTC`
  */
 export function findCommonWorkingHours(zones, workHoursStart = 9, workHoursEnd = 17, date = new Date()) {
     if (zones.length === 0)
         return null;
-    // Convert each zone's work hours to UTC
-    const utcRanges = zones.map(zone => {
+    const endHour = workHoursEnd < workHoursStart ? workHoursEnd + DAY_HOURS : workHoursEnd;
+    const duration = endHour - workHoursStart;
+    if (duration <= 0) {
+        return null;
+    }
+    const sweepEvents = [];
+    for (const zone of zones) {
         const offset = getTimezoneOffset(zone, date);
-        if (offset === null)
+        if (offset === null) {
             return null;
-        // Offset is in minutes, positive means ahead of UTC
-        // So to convert local time to UTC, we subtract the offset
-        const startUTC = workHoursStart - (offset / 60);
-        const endUTC = workHoursEnd - (offset / 60);
-        return { startUTC, endUTC };
-    });
-    if (utcRanges.some(r => r === null))
+        }
+        if (duration >= DAY_HOURS) {
+            pushSweepInterval(sweepEvents, 0, DAY_HOURS * 2);
+            continue;
+        }
+        const startUTC = normalizeHourValue(workHoursStart - (offset / 60));
+        pushSweepInterval(sweepEvents, startUTC, startUTC + duration);
+        pushSweepInterval(sweepEvents, startUTC + DAY_HOURS, startUTC + DAY_HOURS + duration);
+    }
+    sweepEvents.sort((a, b) => a.time - b.time || b.delta - a.delta);
+    let activeWindows = 0;
+    let previousTime = 0;
+    let bestOverlap = null;
+    for (let i = 0; i < sweepEvents.length;) {
+        const currentTime = sweepEvents[i].time;
+        if (currentTime > previousTime && activeWindows === zones.length) {
+            const candidate = { start: previousTime, end: currentTime };
+            if (bestOverlap === null ||
+                candidate.end - candidate.start > bestOverlap.end - bestOverlap.start ||
+                (candidate.end - candidate.start === bestOverlap.end - bestOverlap.start &&
+                    candidate.start < bestOverlap.start)) {
+                bestOverlap = candidate;
+            }
+        }
+        while (i < sweepEvents.length && sweepEvents[i].time === currentTime) {
+            activeWindows += sweepEvents[i].delta;
+            i++;
+        }
+        previousTime = currentTime;
+    }
+    if (bestOverlap === null) {
         return null;
-    const validRanges = utcRanges;
-    // Find intersection of all ranges
-    let overlapStart = Math.max(...validRanges.map(r => r.startUTC));
-    let overlapEnd = Math.min(...validRanges.map(r => r.endUTC));
-    if (overlapStart >= overlapEnd) {
-        return null; // No overlap
     }
-    return { startUTC: overlapStart, endUTC: overlapEnd };
+    const overlapDuration = bestOverlap.end - bestOverlap.start;
+    if (overlapDuration >= DAY_HOURS) {
+        return { startUTC: 0, endUTC: DAY_HOURS };
+    }
+    const startUTC = normalizeHourValue(bestOverlap.start);
+    const endUTC = normalizeHourValue(bestOverlap.start + overlapDuration);
+    return { startUTC, endUTC };
 }
 /**
  * Get all timezone abbreviations for a zone on a given date

package/dist/esm/types.d.ts

@@ -14,8 +14,6 @@ export interface ParseOptions {
     strict?: boolean;
     /** Timezone to use for parsing */
     timezone?: string;
-    /** Default locale for parsing */
-    locale?: string;
 }
 /** Options for formatting operations */
 export interface FormatOptions {
@@ -63,8 +61,6 @@ export interface WorkingHoursConfig {
         start: number;
         end: number;
     }[];
-    /** Timezone for working hours calculation */
-    timezone?: string;
 }
 /** Result of age calculation */
 export interface AgeResult {

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

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

package/dist/{finance.js → finance.cjs}

@@ -1,9 +1,26 @@
+"use strict";
 /**
  * @fileoverview Finance utilities for market-aware date calculations
  * Provides US market hours, trading days, settlement dates, and options expiration
  */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.US_MARKET_HOLIDAYS = exports.MARKET_HOURS = void 0;
+exports.isMarketHoliday = isMarketHoliday;
+exports.isTradingDay = isTradingDay;
+exports.isMarketOpen = isMarketOpen;
+exports.getMarketHours = getMarketHours;
+exports.getMarketOpen = getMarketOpen;
+exports.getMarketClose = getMarketClose;
+exports.getNextMarketOpen = getNextMarketOpen;
+exports.getNextMarketClose = getNextMarketClose;
+exports.getSettlementDate = getSettlementDate;
+exports.getTradeDateFromSettlement = getTradeDateFromSettlement;
+exports.eachTradingDay = eachTradingDay;
+exports.countTradingDays = countTradingDays;
+exports.addTradingDays = addTradingDays;
+exports.getOptionsExpiration = getOptionsExpiration;
 /** Market hours for US exchanges */
-export const MARKET_HOURS = {
+exports.MARKET_HOURS = {
     NYSE: {
         open: { hour: 9, minute: 30 },
         close: { hour: 16, minute: 0 },
@@ -20,7 +37,7 @@ export const MARKET_HOURS = {
     }
 };
 /** US market holidays (NYSE/NASDAQ follow same schedule) */
-export const US_MARKET_HOLIDAYS = [
+exports.US_MARKET_HOLIDAYS = [
     "New Year's Day",
     'Martin Luther King Jr. Day',
     "Presidents' Day",
@@ -147,7 +164,7 @@ function isSameDay(date1, date2) {
  * isMarketHoliday(new Date('2024-01-02')); // false
  * ```
  */
-export function isMarketHoliday(date, market = 'NYSE') {
+function isMarketHoliday(date, market = 'NYSE') {
     const d = toDate(date);
     const year = d.getFullYear();
     const holidays = getUSMarketHolidays(year);
@@ -165,7 +182,7 @@ export function isMarketHoliday(date, market = 'NYSE') {
  * isTradingDay(new Date('2024-01-13')); // false (Saturday)
  * ```
  */
-export function isTradingDay(date, market = 'NYSE') {
+function isTradingDay(date, market = 'NYSE') {
     const d = toDate(date);
     const day = d.getDay();
     // Weekend check
@@ -189,12 +206,12 @@ export function isTradingDay(date, market = 'NYSE') {
  * isMarketOpen(new Date('2024-01-15T10:30:00-05:00')); // true
  * ```
  */
-export function isMarketOpen(date, market = 'NYSE') {
+function isMarketOpen(date, market = 'NYSE') {
     const d = toDate(date);
     // First check if it's a trading day
     if (!isTradingDay(d, market))
         return false;
-    const hours = MARKET_HOURS[market];
+    const hours = exports.MARKET_HOURS[market];
     // Convert to market timezone for comparison
     // For simplicity, we assume the input is already in market timezone
     // or we compare hours directly
@@ -216,8 +233,8 @@ export function isMarketOpen(date, market = 'NYSE') {
  * console.log(hours.open); // { hour: 9, minute: 30 }
  * ```
  */
-export function getMarketHours(market = 'NYSE') {
-    const source = MARKET_HOURS[market];
+function getMarketHours(market = 'NYSE') {
+    const source = exports.MARKET_HOURS[market];
     return {
         open: { ...source.open },
         close: { ...source.close },
@@ -238,9 +255,9 @@ export function getMarketHours(market = 'NYSE') {
  * console.log(open); // 2024-01-15T09:30:00
  * ```
  */
-export function getMarketOpen(date, market = 'NYSE') {
+function getMarketOpen(date, market = 'NYSE') {
     const d = toDate(date);
-    const hours = MARKET_HOURS[market];
+    const hours = exports.MARKET_HOURS[market];
     const result = new Date(d);
     result.setHours(hours.open.hour, hours.open.minute, 0, 0);
     return result;
@@ -257,9 +274,9 @@ export function getMarketOpen(date, market = 'NYSE') {
  * console.log(close); // 2024-01-15T16:00:00
  * ```
  */
-export function getMarketClose(date, market = 'NYSE') {
+function getMarketClose(date, market = 'NYSE') {
     const d = toDate(date);
-    const hours = MARKET_HOURS[market];
+    const hours = exports.MARKET_HOURS[market];
     const result = new Date(d);
     result.setHours(hours.close.hour, hours.close.minute, 0, 0);
     return result;
@@ -276,9 +293,9 @@ export function getMarketClose(date, market = 'NYSE') {
  * const nextOpen = getNextMarketOpen(new Date('2024-01-12T17:00:00'));
  * ```
  */
-export function getNextMarketOpen(after, market = 'NYSE') {
+function getNextMarketOpen(after, market = 'NYSE') {
     const d = toDate(after);
-    const hours = MARKET_HOURS[market];
+    const hours = exports.MARKET_HOURS[market];
     // Start with current day's open
     let candidate = getMarketOpen(d, market);
     // If we're past today's open, start from tomorrow
@@ -305,9 +322,9 @@ export function getNextMarketOpen(after, market = 'NYSE') {
  * // Returns 2024-01-15T16:00:00 (same day close)
  * ```
  */
-export function getNextMarketClose(after, market = 'NYSE') {
+function getNextMarketClose(after, market = 'NYSE') {
     const d = toDate(after);
-    const hours = MARKET_HOURS[market];
+    const hours = exports.MARKET_HOURS[market];
     // Start with current day's close
     let candidate = getMarketClose(d, market);
     // If we're past today's close or not a trading day, go to next trading day
@@ -335,7 +352,7 @@ export function getNextMarketClose(after, market = 'NYSE') {
  * // Returns 2024-01-17 (skipping weekends/holidays)
  * ```
  */
-export function getSettlementDate(tradeDate, days, market = 'NYSE') {
+function getSettlementDate(tradeDate, days, market = 'NYSE') {
     const d = toDate(tradeDate);
     const result = new Date(d);
     result.setHours(0, 0, 0, 0);
@@ -361,7 +378,7 @@ export function getSettlementDate(tradeDate, days, market = 'NYSE') {
  * // Returns 2024-01-15
  * ```
  */
-export function getTradeDateFromSettlement(settlementDate, days, market = 'NYSE') {
+function getTradeDateFromSettlement(settlementDate, days, market = 'NYSE') {
     const d = toDate(settlementDate);
     const result = new Date(d);
     result.setHours(0, 0, 0, 0);
@@ -387,7 +404,7 @@ export function getTradeDateFromSettlement(settlementDate, days, market = 'NYSE'
  * // Returns Mon, Tue, Wed, Thu, Fri (if no holidays)
  * ```
  */
-export function eachTradingDay(start, end, market = 'NYSE') {
+function eachTradingDay(start, end, market = 'NYSE') {
     const startDate = toDate(start);
     const endDate = toDate(end);
     startDate.setHours(0, 0, 0, 0);
@@ -415,7 +432,7 @@ export function eachTradingDay(start, end, market = 'NYSE') {
  * // Returns 5 (Mon-Fri if no holidays)
  * ```
  */
-export function countTradingDays(start, end, market = 'NYSE') {
+function countTradingDays(start, end, market = 'NYSE') {
     return eachTradingDay(start, end, market).length;
 }
 /**
@@ -431,7 +448,7 @@ export function countTradingDays(start, end, market = 'NYSE') {
  * // Returns 5 trading days later
  * ```
  */
-export function addTradingDays(date, days, market = 'NYSE') {
+function addTradingDays(date, days, market = 'NYSE') {
     const d = toDate(date);
     const result = new Date(d);
     result.setHours(0, 0, 0, 0);
@@ -466,7 +483,7 @@ export function addTradingDays(date, days, market = 'NYSE') {
  * const quarterly = getOptionsExpiration(2024, 3, 'quarterly');
  * ```
  */
-export function getOptionsExpiration(year, month, type = 'monthly') {
+function getOptionsExpiration(year, month, type = 'monthly') {
     // Adjust month to 0-indexed
     const monthIndex = month - 1;
     switch (type) {