@motionstudies/core 0.1.0-alpha.3 → 0.1.0-alpha.31

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@motionstudies/core",
-  "version": "0.1.0-alpha.3",
+  "version": "0.1.0-alpha.31",
   "private": false,
   "type": "module",
   "description": "Transport contracts and motion primitives for Motion Studies.",
@@ -20,6 +20,11 @@
     "tag": "next"
   },
   "exports": {
+    "./air-continents": {
+      "types": "./air-continents.d.ts",
+      "import": "./air-continents.js",
+      "default": "./air-continents.js"
+    },
     "./air-search": {
       "types": "./air-search.d.ts",
       "import": "./air-search.js",
@@ -65,6 +70,11 @@
       "import": "./domain/airport.js",
       "default": "./domain/airport.js"
     },
+    "./domain/movement-board": {
+      "types": "./domain/movement-board.d.ts",
+      "import": "./domain/movement-board.js",
+      "default": "./domain/movement-board.js"
+    },
     "./domain/boundary": {
       "types": "./domain/boundary.d.ts",
       "import": "./domain/boundary.js",
@@ -100,6 +110,16 @@
       "import": "./domain/network-day.js",
       "default": "./domain/network-day.js"
     },
+    "./domain/network-patterns": {
+      "types": "./domain/network-patterns.d.ts",
+      "import": "./domain/network-patterns.js",
+      "default": "./domain/network-patterns.js"
+    },
+    "./domain/station-calls": {
+      "types": "./domain/station-calls.d.ts",
+      "import": "./domain/station-calls.js",
+      "default": "./domain/station-calls.js"
+    },
     "./domain/network-layers": {
       "types": "./domain/network-layers.d.ts",
       "import": "./domain/network-layers.js",
@@ -139,6 +159,91 @@
       "types": "./domain/train-time-index.d.ts",
       "import": "./domain/train-time-index.js",
       "default": "./domain/train-time-index.js"
+    },
+    "./domain/live-airport": {
+      "types": "./domain/live-airport.d.ts",
+      "import": "./domain/live-airport.js",
+      "default": "./domain/live-airport.js"
+    },
+    "./domain/station-departures": {
+      "types": "./domain/station-departures.d.ts",
+      "import": "./domain/station-departures.js",
+      "default": "./domain/station-departures.js"
+    },
+    "./domain/vehicle-counts": {
+      "types": "./domain/vehicle-counts.d.ts",
+      "import": "./domain/vehicle-counts.js",
+      "default": "./domain/vehicle-counts.js"
+    },
+    "./domain/aggregate-road": {
+      "types": "./domain/aggregate-road.d.ts",
+      "import": "./domain/aggregate-road.js",
+      "default": "./domain/aggregate-road.js"
+    },
+    "./domain/vehicle-calls": {
+      "types": "./domain/vehicle-calls.d.ts",
+      "import": "./domain/vehicle-calls.js",
+      "default": "./domain/vehicle-calls.js"
+    },
+    "./domain/supported-field": {
+      "types": "./domain/supported-field.d.ts",
+      "import": "./domain/supported-field.js",
+      "default": "./domain/supported-field.js"
+    },
+    "./domain/gridded-series": {
+      "types": "./domain/gridded-series.d.ts",
+      "import": "./domain/gridded-series.js",
+      "default": "./domain/gridded-series.js"
+    },
+    "./domain/published-day": {
+      "types": "./domain/published-day.d.ts",
+      "import": "./domain/published-day.js",
+      "default": "./domain/published-day.js"
+    },
+    "./domain/field-paths": {
+      "types": "./domain/field-paths.d.ts",
+      "import": "./domain/field-paths.js",
+      "default": "./domain/field-paths.js"
+    },
+    "./domain/route-field": {
+      "types": "./domain/route-field.d.ts",
+      "import": "./domain/route-field.js",
+      "default": "./domain/route-field.js"
+    },
+    "./domain/route-events": {
+      "types": "./domain/route-events.d.ts",
+      "import": "./domain/route-events.js",
+      "default": "./domain/route-events.js"
+    },
+    "./domain/daylight": {
+      "types": "./domain/daylight.d.ts",
+      "import": "./domain/daylight.js",
+      "default": "./domain/daylight.js"
+    },
+    "./domain/power-day": {
+      "types": "./domain/power-day.d.ts",
+      "import": "./domain/power-day.js",
+      "default": "./domain/power-day.js"
+    },
+    "./timeline": {
+      "types": "./timeline.d.ts",
+      "import": "./timeline.js",
+      "default": "./timeline.js"
+    },
+    "./render-frame": {
+      "types": "./render-frame.d.ts",
+      "import": "./render-frame.js",
+      "default": "./render-frame.js"
+    },
+    "./map-labels": {
+      "types": "./map-labels.d.ts",
+      "import": "./map-labels.js",
+      "default": "./map-labels.js"
+    },
+    "./air-enrichment": {
+      "types": "./air-enrichment.d.ts",
+      "import": "./air-enrichment.js",
+      "default": "./air-enrichment.js"
     }
   },
   "files": [
@@ -147,6 +252,8 @@
     "**/*.d.ts",
     "**/*.d.mts",
     "**/*.css",
+    "**/*.woff2",
+    "**/*-OFL.txt",
     "README.md",
     "LICENSE"
   ],

package/render-frame.d.ts

@@ -0,0 +1,8 @@
+/** Track the last submitted buffers, not the last animation callback. Create a
+ * fresh tracker when geometry, projection, data or selection inputs change. */
+export declare class PausedVehicleFrame {
+    private time;
+    private visibility;
+    needsUpdate(isPlaying: boolean, time: number, visibility: number): boolean;
+    record(time: number, visibility: number): void;
+}

package/render-frame.js

@@ -0,0 +1,13 @@
+/** Track the last submitted buffers, not the last animation callback. Create a
+ * fresh tracker when geometry, projection, data or selection inputs change. */
+export class PausedVehicleFrame {
+    time = NaN;
+    visibility = NaN;
+    needsUpdate(isPlaying, time, visibility) {
+        return isPlaying || this.time !== time || this.visibility !== visibility;
+    }
+    record(time, visibility) {
+        this.time = time;
+        this.visibility = visibility;
+    }
+}

package/timeline.d.ts

@@ -0,0 +1,31 @@
+/** A measured interval. Null means missing evidence; zero is a measured zero. */
+export interface TimelineBin {
+    start: number;
+    end: number;
+    value: number | null;
+}
+export interface TimelineWindow {
+    start: number;
+    end: number;
+}
+export interface TimelineBar extends TimelineBin {
+    x: number;
+    width: number;
+    height: number;
+}
+export interface TimelineModel {
+    window: TimelineWindow;
+    maximum: number;
+    bars: TimelineBar[];
+    lines: {
+        x: number;
+        y: number;
+    }[][];
+}
+export declare function timelinePosition(time: number, window: TimelineWindow): number;
+export declare function timelineTime(position: number, window: TimelineWindow, step?: number): number;
+/** Build chart geometry once per series, independently of playback and rendering. */
+export declare function createTimelineModel(bins: readonly TimelineBin[], window: TimelineWindow, maximum?: number): TimelineModel;
+export declare function timelineBinAt(model: TimelineModel, time: number): TimelineBar | undefined;
+/** Service time, including 24:00 and times beyond midnight; no timezone inference. */
+export declare function formatTimelineTime(seconds: number): string;

package/timeline.js

@@ -0,0 +1,68 @@
+function checkWindow(window) {
+    if (!Number.isFinite(window.start) || !Number.isFinite(window.end) || window.end <= window.start)
+        throw new Error('Timeline needs a finite, increasing window');
+}
+export function timelinePosition(time, window) {
+    checkWindow(window);
+    return Number.isFinite(time) ? Math.max(0, Math.min(1, (time - window.start) / (window.end - window.start))) : 0;
+}
+export function timelineTime(position, window, step = 1) {
+    checkWindow(window);
+    if (!Number.isFinite(step) || step <= 0)
+        throw new Error('Timeline step must be positive');
+    const fraction = Number.isFinite(position) ? Math.max(0, Math.min(1, position)) : 0;
+    return Math.min(window.end, window.start + Math.round(fraction * (window.end - window.start) / step) * step);
+}
+/** Build chart geometry once per series, independently of playback and rendering. */
+export function createTimelineModel(bins, window, maximum) {
+    checkWindow(window);
+    if (maximum !== undefined && (!Number.isFinite(maximum) || maximum < 0))
+        throw new Error('Timeline maximum must be non-negative');
+    const sorted = [...bins].sort((a, b) => a.start - b.start);
+    let previous = -Infinity;
+    for (const bin of sorted) {
+        if (!Number.isFinite(bin.start) || !Number.isFinite(bin.end) || bin.end <= bin.start || bin.start < previous)
+            throw new Error('Timeline bins must be finite, increasing and non-overlapping');
+        if (bin.value !== null && (!Number.isFinite(bin.value) || bin.value < 0))
+            throw new Error('Timeline values must be non-negative or null');
+        previous = bin.end;
+    }
+    const visible = sorted.filter(bin => bin.end > window.start && bin.start < window.end);
+    const peak = maximum ?? visible.reduce((value, bin) => Math.max(value, bin.value ?? 0), 0);
+    const bars = visible.map(bin => {
+        const start = Math.max(window.start, bin.start), end = Math.min(window.end, bin.end);
+        return { ...bin, start, end, x: timelinePosition(start, window), width: (end - start) / (window.end - window.start), height: peak > 0 && bin.value !== null ? Math.min(1, bin.value / peak) : 0 };
+    });
+    const lines = [];
+    let line = [], lastEnd = -Infinity;
+    for (const bar of bars) {
+        if (bar.value === null || bar.start !== lastEnd) {
+            if (line.length)
+                lines.push(line);
+            line = [];
+        }
+        if (bar.value !== null)
+            line.push({ x: bar.x + bar.width / 2, y: 1 - bar.height });
+        lastEnd = bar.end;
+    }
+    if (line.length)
+        lines.push(line);
+    return { window: { ...window }, maximum: peak, bars, lines };
+}
+export function timelineBinAt(model, time) {
+    let lo = 0, hi = model.bars.length;
+    while (lo < hi) {
+        const mid = (lo + hi) >>> 1;
+        if (model.bars[mid].start <= time)
+            lo = mid + 1;
+        else
+            hi = mid;
+    }
+    const bin = model.bars[lo - 1];
+    return bin && time < bin.end ? bin : undefined;
+}
+/** Service time, including 24:00 and times beyond midnight; no timezone inference. */
+export function formatTimelineTime(seconds) {
+    const minutes = Math.floor(Math.max(0, Number.isFinite(seconds) ? seconds : 0) / 60);
+    return `${String(Math.floor(minutes / 60)).padStart(2, '0')}:${String(minutes % 60).padStart(2, '0')}`;
+}