pond-ts 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Peter Murphy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,348 @@
+# pond-ts
+
+TypeScript-first time series primitives built around typed events, typed schemas, and explicit temporal keys.
+
+The package is intended to work in modern Node and frontend projects. The repo toolchain should work on Node 18, and we can use `nvm` to verify against newer stable Node releases when needed.
+
+The library is currently focused on non-streaming analytics:
+
+- typed `TimeSeries` construction
+- `Time`, `TimeRange`, and `Interval` keys
+- immutable `Event` objects
+- alignment, aggregation, joins, rolling windows, and smoothing
+- timezone-aware calendar sequences and ingest helpers
+
+## Install
+
+```sh
+npm install pond-ts
+```
+
+## Build
+
+```sh
+npm run build
+```
+
+## Format
+
+```sh
+npm run format
+```
+
+## Test
+
+```sh
+npm test
+```
+
+## Verify
+
+```sh
+npm run verify
+```
+
+## License
+
+MIT
+
+## Core model
+
+The key types are:
+
+- `Time`: a point in time
+- `TimeRange`: an unlabeled interval
+- `Interval`: a labeled interval
+
+An `Event` is a key plus typed data.
+
+A `TimeSeries` is an ordered immutable collection of events sharing one schema.
+
+## Quick start
+
+```ts
+import { TimeSeries } from 'pond-ts';
+
+const schema = [
+  { name: 'time', kind: 'time' },
+  { name: 'cpu', kind: 'number' },
+  { name: 'host', kind: 'string' },
+  { name: 'healthy', kind: 'boolean' },
+] as const;
+
+const series = new TimeSeries({
+  name: 'cpu',
+  schema,
+  rows: [
+    [new Date('2025-01-01T00:00:00.000Z'), 0.42, 'api-1', true],
+    [new Date('2025-01-01T00:01:00.000Z'), 0.51, 'api-2', true],
+  ],
+});
+
+const event = series.at(1);
+if (!event) {
+  throw new Error('missing event');
+}
+
+event.key();
+event.timeRange();
+event.get('cpu');
+event.data().host;
+```
+
+## JSON ingest
+
+Use `TimeSeries.fromJSON(...)` for external data and ambiguous local timestamps.
+
+```ts
+import { TimeSeries } from 'pond-ts';
+
+const schema = [
+  { name: 'time', kind: 'time' },
+  { name: 'value', kind: 'number' },
+  { name: 'status', kind: 'string', required: false },
+] as const;
+
+const series = TimeSeries.fromJSON({
+  name: 'cpu',
+  schema,
+  rows: [
+    ['2025-01-01T09:00', 0.42, 'ok'],
+    ['2025-01-01T10:00', 0.51, null],
+  ],
+  parse: { timeZone: 'Europe/Madrid' },
+});
+```
+
+## Event and series transforms
+
+Event-level transforms:
+
+- `get(...)`
+- `set(...)`
+- `merge(...)`
+- `select(...)`
+- `rename(...)`
+- `collapse(...)`
+- `asTime(...)`
+- `asTimeRange()`
+- `asInterval(...)`
+
+Series-level transforms:
+
+- `map(...)`
+- `select(...)`
+- `rename(...)`
+- `collapse(...)`
+- `asTime(...)`
+- `asTimeRange()`
+- `asInterval(...)`
+
+Example:
+
+```ts
+const renamed = series.rename({ cpu: 'usage' });
+const selected = renamed.select('usage', 'healthy');
+```
+
+## Temporal selection
+
+`TimeSeries` includes both positional and temporal selection methods:
+
+- `slice(...)`
+- `filter(...)`
+- `find(...)`
+- `first()`
+- `last()`
+- `before(...)`
+- `after(...)`
+- `within(...)`
+- `overlapping(...)`
+- `containedBy(...)`
+- `trim(...)`
+- `includesKey(...)`
+- `bisect(...)`
+- `atOrBefore(...)`
+- `atOrAfter(...)`
+
+Vocabulary is intentionally distinct:
+
+- `within(...)`: fully contained
+- `overlapping(...)`: intersects without clipping
+- `trim(...)`: intersects and clips event extents
+
+## Sequences
+
+Use `Sequence` for unbounded grids and `BoundedSequence` for explicit finite interval lists.
+
+Fixed-step sequences:
+
+```ts
+import { Sequence } from 'pond-ts';
+
+const minuteGrid = Sequence.every('1m');
+const hourlyGrid = Sequence.hourly();
+```
+
+Calendar-aware sequences:
+
+```ts
+const localDays = Sequence.calendar('day', {
+  timeZone: 'America/New_York',
+});
+```
+
+Explicit bounded sequences:
+
+```ts
+import { BoundedSequence, Interval } from 'pond-ts';
+
+const buckets = new BoundedSequence([
+  new Interval({ value: 'a', start: 0, end: 10 }),
+  new Interval({ value: 'b', start: 20, end: 30 }),
+]);
+```
+
+## Alignment and aggregation
+
+Align onto a sequence:
+
+```ts
+const aligned = series.align(Sequence.every('1m'), {
+  method: 'hold',
+});
+```
+
+Aggregate into buckets:
+
+```ts
+const aggregated = series.aggregate(Sequence.every('5m'), {
+  cpu: 'avg',
+  host: 'last',
+});
+```
+
+Built-in aggregations:
+
+- `sum`
+- `avg`
+- `min`
+- `max`
+- `count`
+- `first`
+- `last`
+
+## Joins
+
+Join two aligned or bucketed series:
+
+```ts
+const joined = left.join(right, { type: 'outer' });
+```
+
+Supported join types:
+
+- `outer`
+- `left`
+- `right`
+- `inner`
+
+Join many:
+
+```ts
+const wide = TimeSeries.joinMany([cpu, memory, errors], {
+  type: 'outer',
+});
+```
+
+Conflict handling:
+
+- default: `onConflict: "error"`
+- optional prefixing:
+
+```ts
+const joined = left.join(right, {
+  onConflict: 'prefix',
+  prefixes: ['left', 'right'] as const,
+});
+```
+
+## Rolling windows
+
+Event-driven rolling:
+
+```ts
+const rolled = series.rolling('5m', {
+  cpu: 'avg',
+  host: 'last',
+});
+```
+
+Sequence-driven rolling:
+
+```ts
+const rolledOnGrid = series.rolling(Sequence.every('1m'), '5m', { cpu: 'avg' });
+```
+
+Rolling alignment options:
+
+- `trailing`
+- `centered`
+- `leading`
+
+## Smoothing
+
+Smoothing targets one numeric column at a time.
+
+Replace the source column:
+
+```ts
+const smoothed = series.smooth('cpu', 'ema', { alpha: 0.2 });
+```
+
+Append the smoothed output:
+
+```ts
+const smoothed = series.smooth('cpu', 'movingAverage', {
+  window: '5m',
+  alignment: 'centered',
+  output: 'cpuAvg',
+});
+```
+
+Supported smoothing methods:
+
+- `ema`
+- `movingAverage`
+- `loess`
+
+For interval-like keys, smoothing uses the key midpoint as the internal anchor.
+
+## Calendar-aware helpers
+
+Primitive helpers normalize local calendar inputs into absolute time:
+
+```ts
+import { Interval, Time, TimeRange } from 'pond-ts';
+
+const time = Time.parse('2025-01-01T09:00', { timeZone: 'Europe/Madrid' });
+const day = TimeRange.fromDate('2025-01-01', { timeZone: 'UTC' });
+const month = Interval.fromCalendar('month', '2025-01', {
+  timeZone: 'UTC',
+  value: '2025-01',
+});
+```
+
+## Current scope
+
+This package is batch-oriented and immutable.
+
+It does not yet provide a dedicated live/streaming ingestion layer. The current focus is:
+
+- type-safe construction
+- temporal modeling
+- composable non-streaming analytics
+
+## License
+
+No license file is included yet.

package/dist/BoundedSequence.d.ts

@@ -0,0 +1,28 @@
+import { Interval } from './Interval.js';
+import { TimeRange } from './TimeRange.js';
+/**
+ * A finite ordered list of `Interval` buckets.
+ *
+ * Use `BoundedSequence` when you already have an explicit interval list, or use
+ * `Sequence.bounded(...)` to realize a finite run from an unbounded grid definition.
+ */
+export declare class BoundedSequence {
+    #private;
+    /** Example: `new BoundedSequence([intervalA, intervalB])`. Creates a finite interval sequence from an explicit list. */
+    constructor(intervals: ReadonlyArray<Interval>);
+    /** Example: `bounded.length`. Returns the number of intervals in the bounded sequence. */
+    get length(): number;
+    /** Example: `bounded.at(0)`. Returns the interval at the supplied position, if present. */
+    at(index: number): Interval | undefined;
+    /** Example: `bounded.first()`. Returns the first interval, if present. */
+    first(): Interval | undefined;
+    /** Example: `bounded.last()`. Returns the last interval, if present. */
+    last(): Interval | undefined;
+    /** Example: `bounded.timeRange()`. Returns the finite temporal extent of this bounded sequence, if any. */
+    timeRange(): TimeRange | undefined;
+    /** Example: `bounded.slice(0, 10)`. Returns a positional half-open slice of the bounded sequence. */
+    slice(beginIndex?: number, endIndex?: number): BoundedSequence;
+    /** Example: `bounded.intervals()`. Returns the finite explicit intervals represented by this bounded sequence. */
+    intervals(): ReadonlyArray<Interval>;
+}
+//# sourceMappingURL=BoundedSequence.d.ts.map

package/dist/BoundedSequence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoundedSequence.d.ts","sourceRoot":"","sources":["../src/BoundedSequence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AA6B3C;;;;;GAKG;AACH,qBAAa,eAAe;;IAG1B,wHAAwH;gBAC5G,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC;IAM9C,0FAA0F;IAC1F,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,2FAA2F;IAC3F,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIvC,0EAA0E;IAC1E,KAAK,IAAI,QAAQ,GAAG,SAAS;IAI7B,wEAAwE;IACxE,IAAI,IAAI,QAAQ,GAAG,SAAS;IAM5B,2GAA2G;IAC3G,SAAS,IAAI,SAAS,GAAG,SAAS;IASlC,qGAAqG;IACrG,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe;IAI9D,kHAAkH;IAClH,SAAS,IAAI,aAAa,CAAC,QAAQ,CAAC;CAGrC"}

package/dist/BoundedSequence.js

@@ -0,0 +1,70 @@
+import { TimeRange } from './TimeRange.js';
+function validateIntervals(intervals) {
+    for (let index = 0; index < intervals.length; index += 1) {
+        const current = intervals[index];
+        if (current.end() <= current.begin()) {
+            throw new TypeError('bounded sequence intervals must have positive duration');
+        }
+        if (index === 0) {
+            continue;
+        }
+        const previous = intervals[index - 1];
+        if (current.begin() < previous.begin()) {
+            throw new TypeError('bounded sequence intervals must be sorted by start time');
+        }
+        if (current.begin() < previous.end()) {
+            throw new TypeError('bounded sequence intervals must not overlap');
+        }
+    }
+}
+/**
+ * A finite ordered list of `Interval` buckets.
+ *
+ * Use `BoundedSequence` when you already have an explicit interval list, or use
+ * `Sequence.bounded(...)` to realize a finite run from an unbounded grid definition.
+ */
+export class BoundedSequence {
+    #intervals;
+    /** Example: `new BoundedSequence([intervalA, intervalB])`. Creates a finite interval sequence from an explicit list. */
+    constructor(intervals) {
+        validateIntervals(intervals);
+        this.#intervals = Object.freeze(intervals.slice());
+        Object.freeze(this);
+    }
+    /** Example: `bounded.length`. Returns the number of intervals in the bounded sequence. */
+    get length() {
+        return this.#intervals.length;
+    }
+    /** Example: `bounded.at(0)`. Returns the interval at the supplied position, if present. */
+    at(index) {
+        return this.#intervals[index];
+    }
+    /** Example: `bounded.first()`. Returns the first interval, if present. */
+    first() {
+        return this.at(0);
+    }
+    /** Example: `bounded.last()`. Returns the last interval, if present. */
+    last() {
+        return this.#intervals.length === 0
+            ? undefined
+            : this.#intervals[this.#intervals.length - 1];
+    }
+    /** Example: `bounded.timeRange()`. Returns the finite temporal extent of this bounded sequence, if any. */
+    timeRange() {
+        const first = this.first();
+        const last = this.last();
+        if (!first || !last) {
+            return undefined;
+        }
+        return new TimeRange({ start: first.begin(), end: last.end() });
+    }
+    /** Example: `bounded.slice(0, 10)`. Returns a positional half-open slice of the bounded sequence. */
+    slice(beginIndex, endIndex) {
+        return new BoundedSequence(this.#intervals.slice(beginIndex, endIndex));
+    }
+    /** Example: `bounded.intervals()`. Returns the finite explicit intervals represented by this bounded sequence. */
+    intervals() {
+        return this.#intervals;
+    }
+}
+//# sourceMappingURL=BoundedSequence.js.map

package/dist/BoundedSequence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BoundedSequence.js","sourceRoot":"","sources":["../src/BoundedSequence.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,SAAS,iBAAiB,CAAC,SAAkC;IAC3D,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACzD,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAE,CAAC;QAElC,IAAI,OAAO,CAAC,GAAG,EAAE,IAAI,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;YACrC,MAAM,IAAI,SAAS,CACjB,wDAAwD,CACzD,CAAC;QACJ,CAAC;QAED,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,GAAG,CAAC,CAAE,CAAC;QACvC,IAAI,OAAO,CAAC,KAAK,EAAE,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;YACvC,MAAM,IAAI,SAAS,CACjB,yDAAyD,CAC1D,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,CAAC,KAAK,EAAE,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC;YACrC,MAAM,IAAI,SAAS,CAAC,6CAA6C,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IACjB,UAAU,CAA0B;IAE7C,wHAAwH;IACxH,YAAY,SAAkC;QAC5C,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,0FAA0F;IAC1F,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;IAChC,CAAC;IAED,2FAA2F;IAC3F,EAAE,CAAC,KAAa;QACd,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,0EAA0E;IAC1E,KAAK;QACH,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,wEAAwE;IACxE,IAAI;QACF,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;YACjC,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,2GAA2G;IAC3G,SAAS;QACP,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACzB,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YACpB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,qGAAqG;IACrG,KAAK,CAAC,UAAmB,EAAE,QAAiB;QAC1C,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,kHAAkH;IAClH,SAAS;QACP,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/Event.d.ts

@@ -0,0 +1,84 @@
+import { Interval } from './Interval.js';
+import { Time } from './Time.js';
+import { TimeRange } from './TimeRange.js';
+import type { EventKey, IntervalValue, TemporalLike } from './temporal.js';
+type ScalarValue = number | string | boolean;
+type CollapseData<D, Keys extends keyof D, Name extends string, R extends ScalarValue, Append extends boolean = false> = Append extends true ? Readonly<D & Record<Name, R>> : Readonly<Omit<D, Keys> & Record<Name, R>>;
+type SelectData<D, Keys extends keyof D> = Readonly<Pick<D, Keys>>;
+type RenameMap<D> = Partial<{
+    [K in keyof D & string]: string;
+}>;
+type RenameData<D, Mapping extends RenameMap<D>> = Readonly<{
+    [Name in keyof D & string as Name extends keyof Mapping ? Mapping[Name] extends string ? Mapping[Name] : Name : Name]: D[Name];
+}>;
+/**
+ * An immutable event made of a temporal key and typed payload data.
+ *
+ * @example
+ * ```ts
+ * const event = new Event(
+ *   new Time(new Date("2025-01-01T00:00:00.000Z")),
+ *   { cpu: 0.42, host: "api-1" },
+ * );
+ *
+ * event.get("cpu"); // 0.42
+ * event.timeRange(); // TimeRange for the event extent
+ * ```
+ */
+export declare class Event<K extends EventKey, D> {
+    #private;
+    /** Example: `new Event(new Time(Date.now()), { value: 1 })`. Creates an immutable event from a key and typed payload object. */
+    constructor(key: K, data: D);
+    /** Example: `event.key()`. Returns the event key. */
+    key(): K;
+    /** Example: `event.withKey(new Time(Date.now()))`. Returns a new event with the same payload and a different key. */
+    withKey<NextKey extends EventKey>(key: NextKey): Event<NextKey, D>;
+    /** Example: `event.type()`. Returns the underlying key kind. */
+    type(): K['kind'];
+    /** Example: `event.data()`. Returns the immutable event payload. */
+    data(): Readonly<D>;
+    /** Example: `event.get("value")`. Returns a single payload field by name. */
+    get<Field extends keyof D>(field: Field): Readonly<D>[Field];
+    /** Example: `event.set("value", 2)`. Returns a new event with one payload field replaced. */
+    set<Field extends keyof D>(field: Field, value: D[Field]): Event<K, D>;
+    /** Example: `event.merge({ host: "api-1" })`. Returns a new event with a shallow payload merge applied. */
+    merge<U extends object>(patch: U): Event<K, Readonly<D & U>>;
+    /** Example: `event.select("cpu", "healthy")`. Returns a new event containing only the selected payload fields. */
+    select<const Keys extends readonly (keyof D)[]>(...keys: Keys): Event<K, SelectData<D, Keys[number]>>;
+    /** Example: `event.rename({ cpu: "usage" })`. Returns a new event with payload fields renamed according to the supplied mapping. */
+    rename<const Mapping extends RenameMap<D>>(mapping: Mapping): Event<K, RenameData<D, Mapping>>;
+    /** Example: `event.collapse(["in", "out"], "avg", fn)`. Collapses selected payload fields into a single derived field using the supplied reducer. */
+    collapse<const Keys extends readonly (keyof D)[], Name extends string, R extends ScalarValue>(keys: Keys, output: Name, reducer: (values: Pick<D, Keys[number]>) => R): Event<K, CollapseData<D, Keys[number], Name, R>>;
+    collapse<const Keys extends readonly (keyof D)[], Name extends string, R extends ScalarValue>(keys: Keys, output: Name, reducer: (values: Pick<D, Keys[number]>) => R, options: {
+        append: true;
+    }): Event<K, CollapseData<D, Keys[number], Name, R, true>>;
+    /** Example: `event.timeRange()`. Returns the event extent as a `TimeRange`. */
+    timeRange(): TimeRange;
+    /** Example: `event.begin()`. Returns the inclusive event start in milliseconds since epoch. */
+    begin(): number;
+    /** Example: `event.end()`. Returns the inclusive event end in milliseconds since epoch. */
+    end(): number;
+    /** Example: `event.overlaps(range)`. Returns `true` when the event extent overlaps the supplied temporal value. */
+    overlaps(other: TemporalLike): boolean;
+    /** Example: `event.contains(time)`. Returns `true` when the event extent fully contains the supplied temporal value. */
+    contains(other: TemporalLike): boolean;
+    /** Example: `event.isBefore(range)`. Returns `true` when the event ends strictly before the supplied temporal value begins. */
+    isBefore(other: TemporalLike): boolean;
+    /** Example: `event.isAfter(range)`. Returns `true` when the event begins strictly after the supplied temporal value ends. */
+    isAfter(other: TemporalLike): boolean;
+    /** Example: `event.intersection(range)`. Returns the temporal intersection of the event extent and the supplied value, if any. */
+    intersection(other: TemporalLike): TimeRange | undefined;
+    /** Example: `event.trim(range)`. Returns a new event clipped to the supplied temporal value, if the event overlaps it. */
+    trim(other: TemporalLike): Event<K, D> | undefined;
+    /** Example: `event.asTime({ at: "center" })`. Converts the event key to a point-in-time key using the supplied anchor within the current extent. */
+    asTime(options?: {
+        at?: 'begin' | 'center' | 'end';
+    }): Event<Time, D>;
+    /** Example: `event.asTimeRange()`. Converts the event key to an unlabeled `TimeRange` covering the same extent. */
+    asTimeRange(): Event<TimeRange, D>;
+    /** Example: `event.asInterval("bucket-a")`. Converts the event key to a labeled `Interval` covering the same extent. */
+    asInterval(value: IntervalValue): Event<Interval, D>;
+    asInterval(getValue: (event: Event<K, D>) => IntervalValue): Event<Interval, D>;
+}
+export {};
+//# sourceMappingURL=Event.d.ts.map

package/dist/Event.d.ts.map

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