@burglekitt/gmt/dist/plain/interval/intervalXorAllDateTime.js

Temporal-based date and time utilities with timezone support and polyfill integration

import { Temporal } from "@js-temporal/polyfill";
import { isValidDateTimeInterval } from "./validate/index.js";
/**
 * Return the symmetric difference across a list of datetime intervals — the set of instants
 * covered by an odd number of the input intervals.
 *
 * - List-form generalization of `intervalXorDateTime`, which is pairwise only.
 * - Implemented as a coverage sweep: each interval contributes a `+1` at its start and a `-1`
 *   one nanosecond after its end; the result is every maximal run where the running coverage
 *   count is odd. For two intervals this reduces to exactly `intervalXorDateTime`'s pairwise
 *   result.
 * - Order of the input list does not matter; the result is sorted by start.
 * - Returns `[]` for an empty list, and `[]` when every instant is covered an even number of
 *   times (e.g. two identical intervals cancel out).
 * - Returns `[]` when `intervals` is not an array, when any element is not a
 *   `{ start, end }` record of valid ISO PlainDateTime strings, or when any element has
 *   `start > end`.
 *
 * @param intervals array of `{ start, end }` records
 * @returns array of `{ start, end }` records covered an odd number of times, or `[]` on invalid input
 *
 * @example intervalXorAllDateTime([{ start: "2024-01-01T00:00:00", end: "2024-01-10T00:00:00" }, { start: "2024-01-05T00:00:00", end: "2024-01-15T00:00:00" }]) // [{ start: "2024-01-01T00:00:00", end: "2024-01-04T23:59:59.999999999" }, { start: "2024-01-10T00:00:00.000000001", end: "2024-01-15T00:00:00" }]
 * @example intervalXorAllDateTime([]) // []
 */
export function intervalXorAllDateTime(intervals) {
    if (!Array.isArray(intervals) || intervals.length === 0) {
        return [];
    }
    if (!intervals.every((interval) => interval &&
        typeof interval === "object" &&
        isValidDateTimeInterval(interval.start, interval.end))) {
        return [];
    }
    try {
        const events = [];
        for (const interval of intervals) {
            const start = Temporal.PlainDateTime.from(interval.start);
            const closesAfter = Temporal.PlainDateTime.from(interval.end).add({
                nanoseconds: 1,
            });
            events.push({ point: start, delta: 1 });
            events.push({ point: closesAfter, delta: -1 });
        }
        events.sort((a, b) => Temporal.PlainDateTime.compare(a.point, b.point));
        const grouped = [];
        for (const event of events) {
            const last = grouped[grouped.length - 1];
            if (last && last.point.equals(event.point)) {
                last.delta += event.delta;
            }
            else {
                grouped.push({ point: event.point, delta: event.delta });
            }
        }
        const result = [];
        let coverage = 0;
        let runStart = null;
        for (const group of grouped) {
            const previousCoverage = coverage;
            coverage += group.delta;
            if (previousCoverage % 2 === 0 && coverage % 2 === 1) {
                runStart = group.point;
            }
            else if (previousCoverage % 2 === 1 && coverage % 2 === 0 && runStart) {
                result.push({
                    start: runStart.toString(),
                    end: group.point.subtract({ nanoseconds: 1 }).toString(),
                });
                runStart = null;
            }
        }
        return result;
    }
    catch {
        return [];
    }
}