inkplot 0.0.0-stage → 1.0.0-beta.1

package/dist/time-intl.d.ts

@@ -0,0 +1,194 @@
+import { TimeScale, type TimeRank, type TimeScaleAttributes, type TimeUnit } from './time.ts';
+export interface IntlTimeScaleAttributes extends TimeScaleAttributes<Intl.DateTimeFormatOptions> {
+    /** The language the labels are written in (a BCP 47 tag). Default: the runtime's. */
+    locale?: string;
+}
+export declare class IntlTimeScale extends TimeScale<Intl.DateTimeFormatOptions, IntlTimeScaleAttributes> {
+    #private;
+    static attrTypes: {
+        id: 1;
+        meta: {
+            title: 1;
+            description: 1;
+            role: 1;
+        };
+        timeZone: 1;
+        weekStart: 2;
+        locale: 1;
+        formats: {
+            year: {
+                localeMatcher: 1;
+                timeZone: 1;
+                hourCycle: 1;
+                formatMatcher: 1;
+                dateStyle: 1;
+                timeStyle: 1;
+                dayPeriod: 1;
+                fractionalSecondDigits: 0;
+                calendar: 1;
+                numberingSystem: 1;
+                weekday: 1;
+                era: 1;
+                year: 1;
+                month: 1;
+                day: 1;
+                hour: 1;
+                minute: 1;
+                second: 1;
+                timeZoneName: 1;
+            };
+            month: {
+                localeMatcher: 1;
+                timeZone: 1;
+                hourCycle: 1;
+                formatMatcher: 1;
+                dateStyle: 1;
+                timeStyle: 1;
+                dayPeriod: 1;
+                fractionalSecondDigits: 0;
+                calendar: 1;
+                numberingSystem: 1;
+                weekday: 1;
+                era: 1;
+                year: 1;
+                month: 1;
+                day: 1;
+                hour: 1;
+                minute: 1;
+                second: 1;
+                timeZoneName: 1;
+            };
+            day: {
+                localeMatcher: 1;
+                timeZone: 1;
+                hourCycle: 1;
+                formatMatcher: 1;
+                dateStyle: 1;
+                timeStyle: 1;
+                dayPeriod: 1;
+                fractionalSecondDigits: 0;
+                calendar: 1;
+                numberingSystem: 1;
+                weekday: 1;
+                era: 1;
+                year: 1;
+                month: 1;
+                day: 1;
+                hour: 1;
+                minute: 1;
+                second: 1;
+                timeZoneName: 1;
+            };
+            hour: {
+                localeMatcher: 1;
+                timeZone: 1;
+                hourCycle: 1;
+                formatMatcher: 1;
+                dateStyle: 1;
+                timeStyle: 1;
+                dayPeriod: 1;
+                fractionalSecondDigits: 0;
+                calendar: 1;
+                numberingSystem: 1;
+                weekday: 1;
+                era: 1;
+                year: 1;
+                month: 1;
+                day: 1;
+                hour: 1;
+                minute: 1;
+                second: 1;
+                timeZoneName: 1;
+            };
+            minute: {
+                localeMatcher: 1;
+                timeZone: 1;
+                hourCycle: 1;
+                formatMatcher: 1;
+                dateStyle: 1;
+                timeStyle: 1;
+                dayPeriod: 1;
+                fractionalSecondDigits: 0;
+                calendar: 1;
+                numberingSystem: 1;
+                weekday: 1;
+                era: 1;
+                year: 1;
+                month: 1;
+                day: 1;
+                hour: 1;
+                minute: 1;
+                second: 1;
+                timeZoneName: 1;
+            };
+            second: {
+                localeMatcher: 1;
+                timeZone: 1;
+                hourCycle: 1;
+                formatMatcher: 1;
+                dateStyle: 1;
+                timeStyle: 1;
+                dayPeriod: 1;
+                fractionalSecondDigits: 0;
+                calendar: 1;
+                numberingSystem: 1;
+                weekday: 1;
+                era: 1;
+                year: 1;
+                month: 1;
+                day: 1;
+                hour: 1;
+                minute: 1;
+                second: 1;
+                timeZoneName: 1;
+            };
+            millisecond: {
+                localeMatcher: 1;
+                timeZone: 1;
+                hourCycle: 1;
+                formatMatcher: 1;
+                dateStyle: 1;
+                timeStyle: 1;
+                dayPeriod: 1;
+                fractionalSecondDigits: 0;
+                calendar: 1;
+                numberingSystem: 1;
+                weekday: 1;
+                era: 1;
+                year: 1;
+                month: 1;
+                day: 1;
+                hour: 1;
+                minute: 1;
+                second: 1;
+                timeZoneName: 1;
+            };
+            full: {
+                localeMatcher: 1;
+                timeZone: 1;
+                hourCycle: 1;
+                formatMatcher: 1;
+                dateStyle: 1;
+                timeStyle: 1;
+                dayPeriod: 1;
+                fractionalSecondDigits: 0;
+                calendar: 1;
+                numberingSystem: 1;
+                weekday: 1;
+                era: 1;
+                year: 1;
+                month: 1;
+                day: 1;
+                hour: 1;
+                minute: 1;
+                second: 1;
+                timeZoneName: 1;
+            };
+        };
+    };
+    protected get defaultFormats(): Record<TimeRank, Intl.DateTimeFormatOptions>;
+    protected startOf(t: number, unit: TimeUnit): number;
+    protected add(t: number, unit: TimeUnit, n: number): number;
+    protected field(t: number, unit: Exclude<TimeUnit, 'week'>): number;
+    protected format(t: number, _rank: TimeRank, spec: Intl.DateTimeFormatOptions): string;
+}

package/dist/time-intl.js

@@ -0,0 +1,144 @@
+/**
+ * `IntlTimeScale`: a time scale over `Date` and `Intl`, with nothing to install. The time zone, whatever it is, is worked out
+ * with `Intl.DateTimeFormat` (the wall-clock time of an instant, and so the offset from UTC at it), so any IANA zone works
+ * and daylight saving is followed. Where a wall-clock time does not exist (the hour the clocks skip) or occurs twice, the
+ * instant nearest to it is used.
+ *
+ * `formats` are `Intl.DateTimeFormatOptions`, and `locale` a BCP 47 tag (default: the runtime's).
+ */
+import { STRING } from './attrs.js';
+import { TimeScale, TIME_FORMATS_TYPES } from './time.js';
+const clock = { hour: '2-digit', minute: '2-digit', hourCycle: 'h23' };
+const DEFAULTS = {
+    year: { year: 'numeric' },
+    month: { month: 'short' },
+    day: { month: 'short', day: 'numeric' },
+    hour: clock,
+    minute: clock,
+    second: { ...clock, second: '2-digit' },
+    millisecond: { ...clock, second: '2-digit', fractionalSecondDigits: 3 },
+    full: { year: 'numeric', month: 'short', day: 'numeric', ...clock, second: '2-digit', timeZoneName: 'short' },
+};
+let local;
+const zones = new Map();
+function clockIn(zone) {
+    let f = zones.get(zone);
+    if (!f) {
+        f = new Intl.DateTimeFormat('en-US', { timeZone: zone, calendar: 'iso8601', numberingSystem: 'latn', hourCycle: 'h23', year: 'numeric', month: 'numeric', day: 'numeric', hour: 'numeric', minute: 'numeric', second: 'numeric' });
+        zones.set(zone, f);
+    }
+    return f;
+}
+const utc = (w) => { const d = new Date(0); d.setUTCFullYear(w.y, w.mo - 1, w.d); d.setUTCHours(w.h, w.mi, w.s, 0); return d.getTime(); };
+export class IntlTimeScale extends TimeScale {
+    static attrTypes = { ...TimeScale.attrTypes, locale: STRING, formats: TIME_FORMATS_TYPES };
+    get defaultFormats() { return DEFAULTS; }
+    get #zone() {
+        const z = this.attrs.timeZone ?? 'UTC';
+        return z === 'local' ? (local ??= new Intl.DateTimeFormat().resolvedOptions().timeZone) : z;
+    }
+    /** The wall-clock time at `t` in the zone. */
+    #wall(t) {
+        if (this.#zone === 'UTC') {
+            const d = new Date(t);
+            return { y: d.getUTCFullYear(), mo: d.getUTCMonth() + 1, d: d.getUTCDate(), h: d.getUTCHours(), mi: d.getUTCMinutes(), s: d.getUTCSeconds() };
+        }
+        const w = { y: 0, mo: 0, d: 0, h: 0, mi: 0, s: 0 };
+        for (const p of clockIn(this.#zone).formatToParts(t)) {
+            switch (p.type) {
+                case 'year':
+                    w.y = +p.value;
+                    break;
+                case 'month':
+                    w.mo = +p.value;
+                    break;
+                case 'day':
+                    w.d = +p.value;
+                    break;
+                case 'hour':
+                    w.h = +p.value;
+                    break;
+                case 'minute':
+                    w.mi = +p.value;
+                    break;
+                case 'second':
+                    w.s = +p.value;
+                    break;
+            }
+        }
+        return w;
+    }
+    /** The zone's offset from UTC at `t`, in milliseconds. */
+    #offset(t) { return utc(this.#wall(t)) - Math.floor(t / 1000) * 1000; }
+    /** The instant a wall-clock time shows (days, months and so on beyond their range carry over). */
+    #at(w) {
+        const wall = utc(w);
+        if (this.#zone === 'UTC')
+            return wall;
+        let t = wall - this.#offset(wall);
+        const o = this.#offset(t);
+        if (wall - t !== o)
+            t = wall - o;
+        return t;
+    }
+    startOf(t, unit) {
+        const ms = ((t % 1000) + 1000) % 1000;
+        switch (unit) {
+            case 'second': return t - ms;
+            case 'minute': {
+                const w = this.#wall(t);
+                return t - ms - w.s * 1000;
+            }
+            case 'hour': {
+                const w = this.#wall(t);
+                return t - ms - w.s * 1000 - w.mi * 60000;
+            }
+        }
+        const w = this.#wall(t);
+        switch (unit) {
+            case 'day': return this.#at({ ...w, h: 0, mi: 0, s: 0 });
+            case 'week': {
+                const dow = new Date(utc({ ...w, h: 0, mi: 0, s: 0 })).getUTCDay(); // the weekday of the date, read as if it were UTC
+                return this.#at({ ...w, d: w.d - ((dow - this.weekStart + 7) % 7), h: 0, mi: 0, s: 0 });
+            }
+            case 'month': return this.#at({ ...w, d: 1, h: 0, mi: 0, s: 0 });
+            default: return this.#at({ ...w, mo: 1, d: 1, h: 0, mi: 0, s: 0 });
+        }
+    }
+    add(t, unit, n) {
+        switch (unit) {
+            case 'second': return t + n * 1000;
+            case 'minute': return t + n * 60000;
+            case 'hour': return t + n * 3600000;
+        }
+        const w = this.#wall(t);
+        switch (unit) {
+            case 'day': return this.#at({ ...w, d: w.d + n });
+            case 'week': return this.#at({ ...w, d: w.d + 7 * n });
+            case 'month': return this.#at({ ...w, mo: w.mo + n });
+            default: return this.#at({ ...w, y: w.y + n });
+        }
+    }
+    field(t, unit) {
+        const w = this.#wall(t);
+        switch (unit) {
+            case 'year': return w.y;
+            case 'month': return w.mo - 1;
+            case 'day': return w.d;
+            case 'hour': return w.h;
+            case 'minute': return w.mi;
+            default: return w.s;
+        }
+    }
+    #formats = new Map();
+    format(t, _rank, spec) {
+        const locale = this.attrs.locale ?? this.chart?.attrs.locale;
+        const key = `${locale}|${this.#zone}|${JSON.stringify(spec)}`;
+        let f = this.#formats.get(key);
+        if (!f) {
+            f = new Intl.DateTimeFormat(locale, { ...spec, timeZone: this.#zone });
+            this.#formats.set(key, f);
+        }
+        return f.format(t);
+    }
+}

package/dist/time-temporal.d.ts

@@ -0,0 +1,236 @@
+/**
+ * `TemporalTimeScale`: a time scale over `Temporal`, which does the calendar and the time zones itself. Daylight saving, skipped
+ * and repeated hours and non-hour offsets are `Temporal`'s own.
+ *
+ * Uses the runtime's `Temporal`, or the one given as the `temporal` attribute (the namespace of a polyfill: a reference to a
+ * live object, not text, so a chart loaded from JSON takes it from its references like any other). `formats` are
+ * `Intl.DateTimeFormatOptions` for `toLocaleString`, without a `timeZone` (the instant brings its own), and `locale` a BCP 47 tag.
+ */
+import { type Opaque } from './attrs.ts';
+import { TimeScale, type TimeRank, type TimeScaleAttributes, type TimeUnit } from './time.ts';
+/** The part of a `Temporal.ZonedDateTime` that this uses. */
+export interface ZonedLike {
+    readonly year: number;
+    readonly month: number;
+    readonly day: number;
+    readonly hour: number;
+    readonly minute: number;
+    readonly second: number;
+    readonly dayOfWeek: number;
+    readonly epochMilliseconds: number;
+    with(fields: Record<string, number>): ZonedLike;
+    add(duration: Record<string, number>): ZonedLike;
+    subtract(duration: Record<string, number>): ZonedLike;
+    round(options: {
+        smallestUnit: string;
+        roundingMode: string;
+    }): ZonedLike;
+    startOfDay(): ZonedLike;
+    toLocaleString(locale?: string, options?: Intl.DateTimeFormatOptions): string;
+}
+/** The part of the `Temporal` namespace that this uses. */
+export interface TemporalLike {
+    Instant: {
+        fromEpochMilliseconds(ms: number): {
+            toZonedDateTimeISO(zone: string): ZonedLike;
+        };
+    };
+    Now: {
+        timeZoneId(): string;
+    };
+}
+export interface TemporalTimeScaleAttributes extends TimeScaleAttributes<Intl.DateTimeFormatOptions> {
+    /** The language the labels are written in (a BCP 47 tag). Default: the runtime's. */
+    locale?: string;
+    /** Where `Temporal` comes from, when the runtime has none. */
+    temporal?: Opaque<TemporalLike>;
+}
+export declare class TemporalTimeScale extends TimeScale<Intl.DateTimeFormatOptions, TemporalTimeScaleAttributes> {
+    #private;
+    static attrTypes: {
+        id: 1;
+        meta: {
+            title: 1;
+            description: 1;
+            role: 1;
+        };
+        timeZone: 1;
+        weekStart: 2;
+        locale: 1;
+        formats: {
+            year: {
+                localeMatcher: 1;
+                timeZone: 1;
+                hourCycle: 1;
+                formatMatcher: 1;
+                dateStyle: 1;
+                timeStyle: 1;
+                dayPeriod: 1;
+                fractionalSecondDigits: 0;
+                calendar: 1;
+                numberingSystem: 1;
+                weekday: 1;
+                era: 1;
+                year: 1;
+                month: 1;
+                day: 1;
+                hour: 1;
+                minute: 1;
+                second: 1;
+                timeZoneName: 1;
+            };
+            month: {
+                localeMatcher: 1;
+                timeZone: 1;
+                hourCycle: 1;
+                formatMatcher: 1;
+                dateStyle: 1;
+                timeStyle: 1;
+                dayPeriod: 1;
+                fractionalSecondDigits: 0;
+                calendar: 1;
+                numberingSystem: 1;
+                weekday: 1;
+                era: 1;
+                year: 1;
+                month: 1;
+                day: 1;
+                hour: 1;
+                minute: 1;
+                second: 1;
+                timeZoneName: 1;
+            };
+            day: {
+                localeMatcher: 1;
+                timeZone: 1;
+                hourCycle: 1;
+                formatMatcher: 1;
+                dateStyle: 1;
+                timeStyle: 1;
+                dayPeriod: 1;
+                fractionalSecondDigits: 0;
+                calendar: 1;
+                numberingSystem: 1;
+                weekday: 1;
+                era: 1;
+                year: 1;
+                month: 1;
+                day: 1;
+                hour: 1;
+                minute: 1;
+                second: 1;
+                timeZoneName: 1;
+            };
+            hour: {
+                localeMatcher: 1;
+                timeZone: 1;
+                hourCycle: 1;
+                formatMatcher: 1;
+                dateStyle: 1;
+                timeStyle: 1;
+                dayPeriod: 1;
+                fractionalSecondDigits: 0;
+                calendar: 1;
+                numberingSystem: 1;
+                weekday: 1;
+                era: 1;
+                year: 1;
+                month: 1;
+                day: 1;
+                hour: 1;
+                minute: 1;
+                second: 1;
+                timeZoneName: 1;
+            };
+            minute: {
+                localeMatcher: 1;
+                timeZone: 1;
+                hourCycle: 1;
+                formatMatcher: 1;
+                dateStyle: 1;
+                timeStyle: 1;
+                dayPeriod: 1;
+                fractionalSecondDigits: 0;
+                calendar: 1;
+                numberingSystem: 1;
+                weekday: 1;
+                era: 1;
+                year: 1;
+                month: 1;
+                day: 1;
+                hour: 1;
+                minute: 1;
+                second: 1;
+                timeZoneName: 1;
+            };
+            second: {
+                localeMatcher: 1;
+                timeZone: 1;
+                hourCycle: 1;
+                formatMatcher: 1;
+                dateStyle: 1;
+                timeStyle: 1;
+                dayPeriod: 1;
+                fractionalSecondDigits: 0;
+                calendar: 1;
+                numberingSystem: 1;
+                weekday: 1;
+                era: 1;
+                year: 1;
+                month: 1;
+                day: 1;
+                hour: 1;
+                minute: 1;
+                second: 1;
+                timeZoneName: 1;
+            };
+            millisecond: {
+                localeMatcher: 1;
+                timeZone: 1;
+                hourCycle: 1;
+                formatMatcher: 1;
+                dateStyle: 1;
+                timeStyle: 1;
+                dayPeriod: 1;
+                fractionalSecondDigits: 0;
+                calendar: 1;
+                numberingSystem: 1;
+                weekday: 1;
+                era: 1;
+                year: 1;
+                month: 1;
+                day: 1;
+                hour: 1;
+                minute: 1;
+                second: 1;
+                timeZoneName: 1;
+            };
+            full: {
+                localeMatcher: 1;
+                timeZone: 1;
+                hourCycle: 1;
+                formatMatcher: 1;
+                dateStyle: 1;
+                timeStyle: 1;
+                dayPeriod: 1;
+                fractionalSecondDigits: 0;
+                calendar: 1;
+                numberingSystem: 1;
+                weekday: 1;
+                era: 1;
+                year: 1;
+                month: 1;
+                day: 1;
+                hour: 1;
+                minute: 1;
+                second: 1;
+                timeZoneName: 1;
+            };
+        };
+    };
+    protected get defaultFormats(): Record<TimeRank, Intl.DateTimeFormatOptions>;
+    protected startOf(t: number, unit: TimeUnit): number;
+    protected add(t: number, unit: TimeUnit, n: number): number;
+    protected field(t: number, unit: Exclude<TimeUnit, 'week'>): number;
+    protected format(t: number, _rank: TimeRank, spec: Intl.DateTimeFormatOptions): string;
+}

package/dist/time-temporal.js

@@ -0,0 +1,58 @@
+/**
+ * `TemporalTimeScale`: a time scale over `Temporal`, which does the calendar and the time zones itself. Daylight saving, skipped
+ * and repeated hours and non-hour offsets are `Temporal`'s own.
+ *
+ * Uses the runtime's `Temporal`, or the one given as the `temporal` attribute (the namespace of a polyfill: a reference to a
+ * live object, not text, so a chart loaded from JSON takes it from its references like any other). `formats` are
+ * `Intl.DateTimeFormatOptions` for `toLocaleString`, without a `timeZone` (the instant brings its own), and `locale` a BCP 47 tag.
+ */
+import { STRING } from './attrs.js';
+import { TimeScale, TIME_FORMATS_TYPES } from './time.js';
+const clock = { hour: '2-digit', minute: '2-digit', hourCycle: 'h23' };
+const DEFAULTS = {
+    year: { year: 'numeric' },
+    month: { month: 'short' },
+    day: { month: 'short', day: 'numeric' },
+    hour: clock,
+    minute: clock,
+    second: { ...clock, second: '2-digit' },
+    millisecond: { ...clock, second: '2-digit', fractionalSecondDigits: 3 },
+    full: { year: 'numeric', month: 'short', day: 'numeric', ...clock, second: '2-digit', timeZoneName: 'short' },
+};
+export class TemporalTimeScale extends TimeScale {
+    static attrTypes = { ...TimeScale.attrTypes, locale: STRING, formats: TIME_FORMATS_TYPES };
+    get defaultFormats() { return DEFAULTS; }
+    get #temporal() {
+        // oxlint-disable-next-line typescript/consistent-type-assertions -- `Temporal` is not in every runtime's global types
+        const T = this.attrs.temporal ?? globalThis.Temporal;
+        if (!T)
+            throw new Error('TemporalTimeScale: this runtime has no Temporal; pass one as the `temporal` attribute, or use IntlTimeScale');
+        return T;
+    }
+    #at(t) {
+        const T = this.#temporal, z = this.attrs.timeZone ?? 'UTC';
+        return T.Instant.fromEpochMilliseconds(Math.floor(t)).toZonedDateTimeISO(z === 'local' ? T.Now.timeZoneId() : z);
+    }
+    startOf(t, unit) {
+        const z = this.#at(t);
+        switch (unit) {
+            case 'second':
+            case 'minute':
+            case 'hour': return z.round({ smallestUnit: unit, roundingMode: 'floor' }).epochMilliseconds;
+            case 'day': return z.startOfDay().epochMilliseconds;
+            case 'week': return z.subtract({ days: (z.dayOfWeek % 7 - this.weekStart + 7) % 7 }).startOfDay().epochMilliseconds;
+            case 'month': return z.with({ day: 1 }).startOfDay().epochMilliseconds;
+            default: return z.with({ month: 1, day: 1 }).startOfDay().epochMilliseconds;
+        }
+    }
+    add(t, unit, n) {
+        return this.#at(t).add(unit === 'week' ? { weeks: n } : { [unit + 's']: n }).epochMilliseconds;
+    }
+    field(t, unit) {
+        const z = this.#at(t);
+        return unit === 'month' ? z.month - 1 : z[unit];
+    }
+    format(t, _rank, spec) {
+        return this.#at(t).toLocaleString(this.attrs.locale ?? this.chart?.attrs.locale, spec);
+    }
+}