pond-ts 0.1.0

package/dist/Time.d.ts

@@ -0,0 +1,43 @@
+import { type TimeZoneOptions } from './calendar.js';
+import { TimeRange } from './TimeRange.js';
+import type { EventKey, TemporalLike, TimestampInput } from './temporal.js';
+/** A point-in-time event key represented as a single millisecond timestamp. Example: `new Time(Date.now())`. */
+export declare class Time implements EventKey {
+    readonly kind = "time";
+    readonly timestamp: number;
+    /** Example: `Time.parse("2025-01-01T09:00", { timeZone: "Europe/Madrid" })`. Parses a strict ISO-like timestamp string into an absolute `Time`. */
+    static parse(value: string, options?: TimeZoneOptions): Time;
+    /** Example: `new Time(new Date())`. Creates a point-in-time key from a `Date` or millisecond timestamp. */
+    constructor(value: TimestampInput);
+    /** Example: `time.type() // "time"`. Returns the key kind. */
+    type(): 'time';
+    /** Example: `time.begin()`. Returns the inclusive start of the key in milliseconds since epoch. */
+    begin(): number;
+    /** Example: `time.end()`. Returns the inclusive end of the key in milliseconds since epoch. */
+    end(): number;
+    /** Example: `time.timestampMs()`. Returns the key timestamp in milliseconds since epoch. */
+    timestampMs(): number;
+    /** Example: `Number(time)`. Returns the primitive millisecond timestamp for numeric coercion. */
+    valueOf(): number;
+    /** Example: `time.timeRange()`. Returns this point as a zero-width `TimeRange`. */
+    timeRange(): TimeRange;
+    /** Example: `time.duration() // 0`. Returns the temporal duration of the key in milliseconds. */
+    duration(): number;
+    /** Example: `time.overlaps(range)`. Returns `true` when this point overlaps the supplied temporal value. */
+    overlaps(other: TemporalLike): boolean;
+    /** Example: `time.contains(Date.now())`. Returns `true` when this point fully contains the supplied temporal value. */
+    contains(other: TemporalLike): boolean;
+    /** Example: `time.isBefore(otherTime)`. Returns `true` when this point ends strictly before the supplied temporal value begins. */
+    isBefore(other: TemporalLike): boolean;
+    /** Example: `time.isAfter(otherTime)`. Returns `true` when this point begins strictly after the supplied temporal value ends. */
+    isAfter(other: TemporalLike): boolean;
+    /** Example: `time.intersection(range)`. Returns the temporal intersection with the supplied value, if any. */
+    intersection(other: TemporalLike): TimeRange | undefined;
+    /** Example: `time.trim(range)`. Returns this key when it falls within the supplied temporal value, otherwise `undefined`. */
+    trim(other: TemporalLike): Time | undefined;
+    /** Example: `time.equals(otherTime)`. Returns `true` when the supplied key is the same `Time`. */
+    equals(other: EventKey): boolean;
+    /** Example: `time.compare(otherTime)`. Compares this key to another key for ordering. */
+    compare(other: EventKey): number;
+}
+//# sourceMappingURL=Time.d.ts.map

package/dist/Time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Time.d.ts","sourceRoot":"","sources":["../src/Time.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG5E,gHAAgH;AAChH,qBAAa,IAAK,YAAW,QAAQ;IACnC,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,mJAAmJ;IACnJ,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,IAAI;IAIhE,2GAA2G;gBAC/F,KAAK,EAAE,cAAc;IAKjC,8DAA8D;IAC9D,IAAI,IAAI,MAAM;IAId,mGAAmG;IACnG,KAAK,IAAI,MAAM;IAIf,+FAA+F;IAC/F,GAAG,IAAI,MAAM;IAIb,4FAA4F;IAC5F,WAAW,IAAI,MAAM;IAIrB,iGAAiG;IACjG,OAAO,IAAI,MAAM;IAIjB,mFAAmF;IACnF,SAAS,IAAI,SAAS;IAItB,iGAAiG;IACjG,QAAQ,IAAI,MAAM;IAIlB,4GAA4G;IAC5G,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IAItC,uHAAuH;IACvH,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IAItC,mIAAmI;IACnI,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IAItC,iIAAiI;IACjI,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IAIrC,8GAA8G;IAC9G,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,SAAS;IAIxD,6HAA6H;IAC7H,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS;IAI3C,kGAAkG;IAClG,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;IAIhC,yFAAyF;IACzF,OAAO,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM;CAGjC"}

package/dist/Time.js

@@ -0,0 +1,78 @@
+import { parseTimestampString } from './calendar.js';
+import { TimeRange } from './TimeRange.js';
+import { compareEventKeys, normalizeTimestamp } from './temporal.js';
+/** A point-in-time event key represented as a single millisecond timestamp. Example: `new Time(Date.now())`. */
+export class Time {
+    kind = 'time';
+    timestamp;
+    /** Example: `Time.parse("2025-01-01T09:00", { timeZone: "Europe/Madrid" })`. Parses a strict ISO-like timestamp string into an absolute `Time`. */
+    static parse(value, options = {}) {
+        return new Time(parseTimestampString(value, options));
+    }
+    /** Example: `new Time(new Date())`. Creates a point-in-time key from a `Date` or millisecond timestamp. */
+    constructor(value) {
+        this.timestamp = normalizeTimestamp(value, 'time');
+        Object.freeze(this);
+    }
+    /** Example: `time.type() // "time"`. Returns the key kind. */
+    type() {
+        return this.kind;
+    }
+    /** Example: `time.begin()`. Returns the inclusive start of the key in milliseconds since epoch. */
+    begin() {
+        return this.timestamp;
+    }
+    /** Example: `time.end()`. Returns the inclusive end of the key in milliseconds since epoch. */
+    end() {
+        return this.timestamp;
+    }
+    /** Example: `time.timestampMs()`. Returns the key timestamp in milliseconds since epoch. */
+    timestampMs() {
+        return this.timestamp;
+    }
+    /** Example: `Number(time)`. Returns the primitive millisecond timestamp for numeric coercion. */
+    valueOf() {
+        return this.timestamp;
+    }
+    /** Example: `time.timeRange()`. Returns this point as a zero-width `TimeRange`. */
+    timeRange() {
+        return new TimeRange({ start: this.timestamp, end: this.timestamp });
+    }
+    /** Example: `time.duration() // 0`. Returns the temporal duration of the key in milliseconds. */
+    duration() {
+        return 0;
+    }
+    /** Example: `time.overlaps(range)`. Returns `true` when this point overlaps the supplied temporal value. */
+    overlaps(other) {
+        return this.timeRange().overlaps(other);
+    }
+    /** Example: `time.contains(Date.now())`. Returns `true` when this point fully contains the supplied temporal value. */
+    contains(other) {
+        return this.timeRange().contains(other);
+    }
+    /** Example: `time.isBefore(otherTime)`. Returns `true` when this point ends strictly before the supplied temporal value begins. */
+    isBefore(other) {
+        return this.timeRange().isBefore(other);
+    }
+    /** Example: `time.isAfter(otherTime)`. Returns `true` when this point begins strictly after the supplied temporal value ends. */
+    isAfter(other) {
+        return this.timeRange().isAfter(other);
+    }
+    /** Example: `time.intersection(range)`. Returns the temporal intersection with the supplied value, if any. */
+    intersection(other) {
+        return this.timeRange().intersection(other);
+    }
+    /** Example: `time.trim(range)`. Returns this key when it falls within the supplied temporal value, otherwise `undefined`. */
+    trim(other) {
+        return this.overlaps(other) ? this : undefined;
+    }
+    /** Example: `time.equals(otherTime)`. Returns `true` when the supplied key is the same `Time`. */
+    equals(other) {
+        return other instanceof Time && this.timestamp === other.timestamp;
+    }
+    /** Example: `time.compare(otherTime)`. Compares this key to another key for ordering. */
+    compare(other) {
+        return compareEventKeys(this, other);
+    }
+}
+//# sourceMappingURL=Time.js.map

package/dist/Time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Time.js","sourceRoot":"","sources":["../src/Time.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAwB,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAErE,gHAAgH;AAChH,MAAM,OAAO,IAAI;IACN,IAAI,GAAG,MAAM,CAAC;IACd,SAAS,CAAS;IAE3B,mJAAmJ;IACnJ,MAAM,CAAC,KAAK,CAAC,KAAa,EAAE,UAA2B,EAAE;QACvD,OAAO,IAAI,IAAI,CAAC,oBAAoB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,2GAA2G;IAC3G,YAAY,KAAqB;QAC/B,IAAI,CAAC,SAAS,GAAG,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,8DAA8D;IAC9D,IAAI;QACF,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,mGAAmG;IACnG,KAAK;QACH,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,+FAA+F;IAC/F,GAAG;QACD,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,4FAA4F;IAC5F,WAAW;QACT,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,iGAAiG;IACjG,OAAO;QACL,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,mFAAmF;IACnF,SAAS;QACP,OAAO,IAAI,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,iGAAiG;IACjG,QAAQ;QACN,OAAO,CAAC,CAAC;IACX,CAAC;IAED,4GAA4G;IAC5G,QAAQ,CAAC,KAAmB;QAC1B,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,uHAAuH;IACvH,QAAQ,CAAC,KAAmB;QAC1B,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,mIAAmI;IACnI,QAAQ,CAAC,KAAmB;QAC1B,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,iIAAiI;IACjI,OAAO,CAAC,KAAmB;QACzB,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,8GAA8G;IAC9G,YAAY,CAAC,KAAmB;QAC9B,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,6HAA6H;IAC7H,IAAI,CAAC,KAAmB;QACtB,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACjD,CAAC;IAED,kGAAkG;IAClG,MAAM,CAAC,KAAe;QACpB,OAAO,KAAK,YAAY,IAAI,IAAI,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,CAAC;IACrE,CAAC;IAED,yFAAyF;IACzF,OAAO,CAAC,KAAe;QACrB,OAAO,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/TimeRange.d.ts

@@ -0,0 +1,45 @@
+import { type CalendarOptions, type CalendarUnit, type TimeZoneOptions } from './calendar.js';
+import type { TemporalLike, TimeRangeInput } from './temporal.js';
+import type { EventKey } from './temporal.js';
+export declare function toTimeRange(value: TemporalLike): TimeRange;
+/** A time interval event key with inclusive start and end boundaries. Example: `new TimeRange({ start, end })`. */
+export declare class TimeRange implements EventKey {
+    readonly kind = "timeRange";
+    readonly start: number;
+    readonly endMs: number;
+    /** Example: `TimeRange.fromDate("2025-01-01", { timeZone: "Europe/Madrid" })`. Creates the local calendar-day range for the supplied ISO date. */
+    static fromDate(reference: string, options?: TimeZoneOptions): TimeRange;
+    /** Example: `TimeRange.fromCalendar("week", "2025-01-01", { timeZone: "UTC", weekStartsOn: 1 })`. Creates the containing calendar range for the supplied reference. */
+    static fromCalendar(unit: CalendarUnit, reference: string, options?: CalendarOptions): TimeRange;
+    /** Example: `new TimeRange([start, end])`. Creates an interval key from a `{ start, end }` object or tuple. */
+    constructor(input: TimeRangeInput);
+    /** Example: `range.type() // "timeRange"`. Returns the key kind. */
+    type(): 'timeRange';
+    /** Example: `range.begin()`. Returns the inclusive start of the range in milliseconds since epoch. */
+    begin(): number;
+    /** Example: `range.end()`. Returns the inclusive end of the range in milliseconds since epoch. */
+    end(): number;
+    /** Example: `range.timeRange()`. Returns this key as a `TimeRange`. */
+    timeRange(): TimeRange;
+    /** Example: `range.duration()`. Returns the temporal duration of the range in milliseconds. */
+    duration(): number;
+    /** Example: `range.midpoint()`. Returns the midpoint of the range in milliseconds since epoch. */
+    midpoint(): number;
+    /** Example: `range.contains(otherRange)`. Returns `true` when this range fully contains the supplied temporal value. */
+    contains(other: TemporalLike): boolean;
+    /** Example: `range.overlaps(otherRange)`. Returns `true` when this range overlaps the supplied temporal value. */
+    overlaps(other: TemporalLike): boolean;
+    /** Example: `range.isBefore(otherRange)`. Returns `true` when this range ends strictly before the supplied temporal value begins. */
+    isBefore(other: TemporalLike): boolean;
+    /** Example: `range.isAfter(otherRange)`. Returns `true` when this range begins strictly after the supplied temporal value ends. */
+    isAfter(other: TemporalLike): boolean;
+    /** Example: `range.intersection(otherRange)`. Returns the overlapping portion of this range and the supplied temporal value, if any. */
+    intersection(other: TemporalLike): TimeRange | undefined;
+    /** Example: `range.trim(otherRange)`. Returns this range clipped to the supplied temporal value, if the two overlap. */
+    trim(other: TemporalLike): TimeRange | undefined;
+    /** Example: `range.equals(otherRange)`. Returns `true` when the supplied key is the same `TimeRange`. */
+    equals(other: EventKey): boolean;
+    /** Example: `range.compare(otherRange)`. Compares this key to another key for ordering. */
+    compare(other: EventKey): number;
+}
+//# sourceMappingURL=TimeRange.d.ts.map

package/dist/TimeRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeRange.d.ts","sourceRoot":"","sources":["../src/TimeRange.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,eAAe,EACrB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAEV,YAAY,EACZ,cAAc,EAEf,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAmB9C,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CA8B1D;AAED,mHAAmH;AACnH,qBAAa,SAAU,YAAW,QAAQ;IACxC,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,kJAAkJ;IAClJ,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,SAAS;IAI5E,uKAAuK;IACvK,MAAM,CAAC,YAAY,CACjB,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,eAAoB,GAC5B,SAAS;IAIZ,+GAA+G;gBACnG,KAAK,EAAE,cAAc;IAqBjC,oEAAoE;IACpE,IAAI,IAAI,WAAW;IAInB,sGAAsG;IACtG,KAAK,IAAI,MAAM;IAIf,kGAAkG;IAClG,GAAG,IAAI,MAAM;IAIb,uEAAuE;IACvE,SAAS,IAAI,SAAS;IAItB,+FAA+F;IAC/F,QAAQ,IAAI,MAAM;IAIlB,kGAAkG;IAClG,QAAQ,IAAI,MAAM;IAIlB,wHAAwH;IACxH,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IAKtC,kHAAkH;IAClH,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IAKtC,qIAAqI;IACrI,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IAKtC,mIAAmI;IACnI,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IAKrC,wIAAwI;IACxI,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,SAAS;IAWxD,wHAAwH;IACxH,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,SAAS;IAIhD,yGAAyG;IACzG,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;IAQhC,2FAA2F;IAC3F,OAAO,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM;CAGjC"}

package/dist/TimeRange.js

@@ -0,0 +1,144 @@
+import { calendarRangeForReference, dayRangeForDate, } from './calendar.js';
+import { compareEventKeys, normalizeTimestamp } from './temporal.js';
+function isBoundedTemporal(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'begin' in value &&
+        'end' in value);
+}
+function isRangedTemporal(value) {
+    return typeof value === 'object' && value !== null && 'timeRange' in value;
+}
+export function toTimeRange(value) {
+    if (value instanceof TimeRange) {
+        return value;
+    }
+    if (isRangedTemporal(value)) {
+        return value.timeRange();
+    }
+    if (isBoundedTemporal(value)) {
+        return new TimeRange({ start: value.begin(), end: value.end() });
+    }
+    if (value instanceof Date || typeof value === 'number') {
+        const timestamp = normalizeTimestamp(value, 'time');
+        return new TimeRange({ start: timestamp, end: timestamp });
+    }
+    if (Array.isArray(value)) {
+        if (value.length === 2) {
+            return new TimeRange(value);
+        }
+        const interval = value;
+        return new TimeRange({ start: interval[1], end: interval[2] });
+    }
+    if ('value' in value) {
+        const interval = value;
+        return new TimeRange({ start: interval.start, end: interval.end });
+    }
+    return new TimeRange(value);
+}
+/** A time interval event key with inclusive start and end boundaries. Example: `new TimeRange({ start, end })`. */
+export class TimeRange {
+    kind = 'timeRange';
+    start;
+    endMs;
+    /** Example: `TimeRange.fromDate("2025-01-01", { timeZone: "Europe/Madrid" })`. Creates the local calendar-day range for the supplied ISO date. */
+    static fromDate(reference, options = {}) {
+        return new TimeRange(dayRangeForDate(reference, options));
+    }
+    /** Example: `TimeRange.fromCalendar("week", "2025-01-01", { timeZone: "UTC", weekStartsOn: 1 })`. Creates the containing calendar range for the supplied reference. */
+    static fromCalendar(unit, reference, options = {}) {
+        return new TimeRange(calendarRangeForReference(unit, reference, options));
+    }
+    /** Example: `new TimeRange([start, end])`. Creates an interval key from a `{ start, end }` object or tuple. */
+    constructor(input) {
+        let rawStart;
+        let rawEnd;
+        if (Array.isArray(input)) {
+            rawStart = input[0];
+            rawEnd = input[1];
+        }
+        else {
+            const objectInput = input;
+            rawStart = objectInput.start;
+            rawEnd = objectInput.end;
+        }
+        const start = normalizeTimestamp(rawStart, 'timeRange start');
+        const end = normalizeTimestamp(rawEnd, 'timeRange end');
+        if (start > end) {
+            throw new TypeError('timeRange start must be <= end');
+        }
+        this.start = start;
+        this.endMs = end;
+        Object.freeze(this);
+    }
+    /** Example: `range.type() // "timeRange"`. Returns the key kind. */
+    type() {
+        return this.kind;
+    }
+    /** Example: `range.begin()`. Returns the inclusive start of the range in milliseconds since epoch. */
+    begin() {
+        return this.start;
+    }
+    /** Example: `range.end()`. Returns the inclusive end of the range in milliseconds since epoch. */
+    end() {
+        return this.endMs;
+    }
+    /** Example: `range.timeRange()`. Returns this key as a `TimeRange`. */
+    timeRange() {
+        return this;
+    }
+    /** Example: `range.duration()`. Returns the temporal duration of the range in milliseconds. */
+    duration() {
+        return this.endMs - this.start;
+    }
+    /** Example: `range.midpoint()`. Returns the midpoint of the range in milliseconds since epoch. */
+    midpoint() {
+        return this.start + this.duration() / 2;
+    }
+    /** Example: `range.contains(otherRange)`. Returns `true` when this range fully contains the supplied temporal value. */
+    contains(other) {
+        const range = toTimeRange(other);
+        return range.begin() >= this.begin() && range.end() <= this.end();
+    }
+    /** Example: `range.overlaps(otherRange)`. Returns `true` when this range overlaps the supplied temporal value. */
+    overlaps(other) {
+        const range = toTimeRange(other);
+        return this.begin() <= range.end() && range.begin() <= this.end();
+    }
+    /** Example: `range.isBefore(otherRange)`. Returns `true` when this range ends strictly before the supplied temporal value begins. */
+    isBefore(other) {
+        const range = toTimeRange(other);
+        return this.end() < range.begin();
+    }
+    /** Example: `range.isAfter(otherRange)`. Returns `true` when this range begins strictly after the supplied temporal value ends. */
+    isAfter(other) {
+        const range = toTimeRange(other);
+        return this.begin() > range.end();
+    }
+    /** Example: `range.intersection(otherRange)`. Returns the overlapping portion of this range and the supplied temporal value, if any. */
+    intersection(other) {
+        const range = toTimeRange(other);
+        if (!this.overlaps(range)) {
+            return undefined;
+        }
+        return new TimeRange({
+            start: Math.max(this.begin(), range.begin()),
+            end: Math.min(this.end(), range.end()),
+        });
+    }
+    /** Example: `range.trim(otherRange)`. Returns this range clipped to the supplied temporal value, if the two overlap. */
+    trim(other) {
+        return this.intersection(other);
+    }
+    /** Example: `range.equals(otherRange)`. Returns `true` when the supplied key is the same `TimeRange`. */
+    equals(other) {
+        return (other instanceof TimeRange &&
+            this.start === other.start &&
+            this.endMs === other.endMs);
+    }
+    /** Example: `range.compare(otherRange)`. Compares this key to another key for ordering. */
+    compare(other) {
+        return compareEventKeys(this, other);
+    }
+}
+//# sourceMappingURL=TimeRange.js.map

package/dist/TimeRange.js.map

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