# Changelog 1.9

Industry: Core

Release notes of `@northguild/gmt` 1.9.0, newest first, built from [`packages/gmt/CHANGELOG.md`](https://github.com/northguild/gmt/blob/main/packages/gmt/CHANGELOG.md). Back to [Changelog](/gmt/changelog/).

## @burglekitt/gmt

![The @burglekitt organization logo](/gmt/burglekitt-logo.png)

**In memoriam: @burglekitt.** These releases were published under the retired `@burglekitt` npm scope. The package continues as `@northguild/gmt` from 1.14.2; [install @northguild/gmt](/gmt/install/).

### 1.9.0

Released 2026-08-15

#### Minor Changes

- b41168c: Add `intervalContainsDate`, `intervalContainsTime`, `intervalContainsDateTime`
  (plain), `intervalContainsUtc` (utc), `intervalContainsUnix` (unix), and
  `intervalContainsZoned` (zoned) — interval containment checks. Each supports
  two modes via an optional fourth argument:

  - 3-arg: `intervalContains(start, end, point)` — true when `start <= point <= end`
  - 4-arg: `intervalContains(start, end, innerStart, innerEnd)` — true when the
    inner interval is fully contained within the outer interval

- 17b6a6b: Add `intervalIntersectionDate`, `intervalIntersectionTime`, `intervalIntersectionDateTime`
  (plain), `intervalIntersectionUtc` (utc), `intervalIntersectionUnix` (unix), and
  `intervalIntersectionZoned` (zoned) — interval intersection. Each accepts two
  intervals and returns the overlapping span, or `null` when they do not overlap:

  - Adjacent intervals (e.g. `aEnd === bStart`) share one instant and DO overlap,
    returning a single-point span.
  - Returns `null` when intervals are disjoint with a gap, or when either interval
    is invalid (`start > end`).
  - Returns `null` on malformed input (never throws).
  - Return shape: `{ start: string; end: string } | null` (or `{ start: number;
end: number } | null` for Unix).

- d798fcb: Add `intervalsOverlapDate`, `intervalsOverlapTime`, `intervalsOverlapDateTime`
  (plain), `intervalsOverlapUtc` (utc), `intervalsOverlapUnix` (unix), and
  `intervalsOverlapZoned` (zoned) — interval overlap detection. Each accepts two
  intervals and returns `true` when they share at least one instant:

  - Adjacent intervals (e.g. `aEnd === bStart`) are treated as overlapping because
    they share the boundary instant.
  - Returns `false` when intervals are disjoint with a gap, or when either interval
    is invalid (`start > end`).
  - Returns `false` on malformed input (never throws).

- d859fd4: Adds `intervalUnionDate`, `intervalUnionTime`, `intervalUnionDateTime` (plain), `intervalUnionUtc` (utc), `intervalUnionUnix` (unix), and `intervalUnionZoned` (zoned) — merge two intervals into their combined span when they overlap or are directly adjacent.

  - Overlapping or adjacent intervals return `{ start, end }` with the merged span. Adjacent intervals (e.g. `aEnd === bStart`) share one instant and ARE merged.
  - Returns `null` when intervals are disjoint with a gap, when either interval is invalid (`start > end`), or on malformed input (never throws).
  - Return shape: `{ start: string; end: string } | null` for plain/utc/zoned; `{ start: number; end: number } | null` for Unix.

- e6439de: Add interval and range validators across plain, utc, unix, and zoned namespaces.

  - `isValidDateInterval`, `isValidTimeInterval`, `isValidDateTimeInterval` (plain) — positional `(start, end)` args returning `true` when both parse and `start <= end`.
  - `isValidUtcInterval`, `isValidUnixInterval`, `isValidZonedInterval` (utc, unix, zoned) — same pattern, comparing by instant for utc/zoned.
  - `isValidDateTimeRange`, `isValidTimeRange` (plain), `isValidUtcRange`, `isValidUnixRange`, `isValidZonedRange` (utc, unix, zoned) — object-param `{ value1, value2 }` shape matching the existing `isValidDateRange` convention.

  All functions return `false` on invalid input (never throw).

- ec0a337: Add `splitIntervalByUnit*` functions across plain, utc, unix, and zoned namespaces.

  - `splitIntervalByUnitDate`, `splitIntervalByUnitTime`, `splitIntervalByUnitDateTime` (plain) — split an interval into sub-intervals of `amount × unit`, returning an array of `{ start, end }` records.
  - `splitIntervalByUnitUtc`, `splitIntervalByUnitUnix`, `splitIntervalByUnitZoned` (utc, unix, zoned) — same pattern adapted to each Temporal environment.

  All functions return `[]` on invalid input (never throw). The final sub-interval is trimmed so its `end` never exceeds the original `end`.

- 87af6ea: Add interval set operations: `intervalDifference`, `intervalXor`, `intervalAbuts`, `intervalEngulfs` across plain, zoned, unix, and utc namespaces.
