geotimelapse 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Franck Ernewein
+
+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,109 @@
+# geotimelapse
+
+Replay a day of geolocated events on a dark glowing map: deck.gl point lights
+with fading trails over a Mapbox basemap, a waveform seek bar, running totals,
+and a TV mode (autoplay, loop, self-hiding UI and cursor).
+
+**[Live glow lab →](https://franckernewein.github.io/geotimelapse/)**
+
+## Why it looks the way it does
+
+- **Additive light, not markers** — every event is a tiny point light with a
+  gaussian halo, blended additively: density builds the brightness, and
+  hotspots bloom toward white the way long-exposure photos do.
+- **Ground-anchored radii** — point radii are meters, not pixels, so the glow
+  reads the same at every zoom level; heavy stacks approach a pixel ceiling
+  asymptotically instead of clipping into flat discs.
+- **Weight-scaled brightness** — co-located events are aggregated into one
+  draw whose halo amplitude follows a film-exposure response on √count.
+- **A trail that breathes** — each frame leaves ghosts that shrink and fade
+  with age, and the trail length adapts to the achieved frame rate (sheds
+  ghosts under 24 fps, grows them back above 58).
+- **A full player** — per-minute activity waveform as the seek bar, running
+  totals, hour axis, fullscreen TV mode.
+- **Data-agnostic** — the component talks to a small `GeoTimelapseSource`
+  contract; bring any backend, or use the bundled duckdb-wasm and synthetic
+  sources.
+
+## Install
+
+```sh
+npm install geotimelapse
+```
+
+Peer dependencies: `react`, `react-dom`, `deck.gl`, `mapbox-gl`,
+`react-map-gl`. (`@duckdb/duckdb-wasm` is a regular dependency, pulled in only
+when you import `geotimelapse/duckdb`.)
+
+## Usage
+
+```tsx
+'use client'; // browser-only (WebGL, workers) — in Next.js, use it from a client component
+
+import 'mapbox-gl/dist/mapbox-gl.css';
+
+import { GeoTimelapse } from 'geotimelapse';
+import { createDuckDbSource } from 'geotimelapse/duckdb';
+
+const source = createDuckDbSource({
+  parquetUrl: '/data/replay-2026-09-05.parquet',
+  // engine omitted: version-matched jsDelivr CDN. Self-hosting: pass the base
+  // URL you serve @duckdb/duckdb-wasm/dist under (the copy THIS package
+  // resolves, so the wasm matches the JS), or full DuckDBBundles.
+  valueColumn: 'spend_micros',
+});
+
+<div style={{ height: '100vh' }}>
+  <GeoTimelapse
+    source={source}
+    mapboxAccessToken={token}
+    dateLabel="Sat, Sep 5, 2026"
+    timeZoneLabel="EDT"
+    formatValue={(micros) => usd.format(micros / 1e6)}
+    formatCount={(count) => `${count.toLocaleString()} wins`}
+  />
+</div>;
+```
+
+The component fills its parent: give the wrapper an explicit size. The source
+holds a dedicated worker and the full in-memory table: call `source.dispose()`
+when you are done with it (e.g. leaving the page in an SPA).
+
+### Data contract
+
+`GeoTimelapseSource` is the only coupling to your data: implement `load`,
+`frame`, `totals`, `activity` and `setScope` over any backend (see
+`src/types.ts`). Two sources ship with the package:
+
+- `geotimelapse/duckdb` loads a day parquet (`day_second` INT sorted, a value
+  column, `lat`/`lon` FLOAT) into an in-browser duckdb-wasm table.
+- `geotimelapse/synthetic` generates a deterministic day in memory (gaussian
+  clusters, uniform fog and single-spot stacks) — handy for demos and benches.
+
+### Tuning
+
+The glow is calibrated through the `tuning` prop, merged over the defaults:
+
+```tsx
+<GeoTimelapse source={source} tuning={{ pointAlpha: 50 }} ... />
+```
+
+`pointAlpha` is the master per-point transparency (0-255). The playback trail
+stacks 12 additive frames, so dense datasets (thousands of points per frame)
+need it well below the single-frame value. Other knobs: `flashRadius`,
+`ghostMaxRadius`, `ghostMinRadius` (meters), `minRadiusPx`, `maxRadiusPx`,
+`haloTint`, `trailFrames` — see `GlowTuning`.
+
+### Styling
+
+Components are styled with Tailwind CSS v4 classes. Add the package to your
+Tailwind sources so they get generated:
+
+```css
+@import 'tailwindcss';
+@source '../node_modules/geotimelapse/dist';
+```
+
+## License
+
+MIT

package/dist/bounds.d.ts

@@ -0,0 +1,5 @@
+import type { MapBounds } from './types.js';
+export declare const MapBoundsProvider: import("react").Provider<MapBounds | null>;
+/** The map's current viewport bounds; null until the map has loaded. */
+export declare function useMapBounds(): MapBounds | null;
+//# sourceMappingURL=bounds.d.ts.map

package/dist/bounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounds.d.ts","sourceRoot":"","sources":["../src/bounds.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C,eAAO,MAAM,iBAAiB,4CAAyB,CAAC;AAExD,wEAAwE;AACxE,wBAAgB,YAAY,IAAI,SAAS,GAAG,IAAI,CAE/C"}

package/dist/bounds.js

@@ -0,0 +1,9 @@
+'use client';
+import { createContext, useContext } from 'react';
+const BoundsContext = createContext(null);
+export const MapBoundsProvider = BoundsContext.Provider;
+/** The map's current viewport bounds; null until the map has loaded. */
+export function useMapBounds() {
+    return useContext(BoundsContext);
+}
+//# sourceMappingURL=bounds.js.map

package/dist/bounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounds.js","sourceRoot":"","sources":["../src/bounds.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAIlD,MAAM,aAAa,GAAG,aAAa,CAAmB,IAAI,CAAC,CAAC;AAE5D,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC,QAAQ,CAAC;AAExD,wEAAwE;AACxE,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,CAAC,aAAa,CAAC,CAAC;AACnC,CAAC"}

package/dist/clock.d.ts

@@ -0,0 +1,24 @@
+import type { PropsWithChildren } from 'react';
+export declare const DAY_SECONDS: number;
+export interface TimelapseClock {
+    play: () => void;
+    pause: () => void;
+    toggle: () => void;
+    seek: (daySeconds: number) => void;
+    /** Seconds elapsed since the start of the replayed day, in [0, DAY_SECONDS]. */
+    getDaySeconds: () => number;
+    /** Increments on every time jump (seek, end-of-day restart): consumers use it to invalidate history. */
+    getEpoch: () => number;
+    isPlaying: () => boolean;
+    /** Notified up to MAX_TICKS_PER_SECOND times while playing, and on play/pause/seek. */
+    subscribe: (listener: () => void) => () => void;
+}
+export declare function TimelapseClockProvider({ children }: PropsWithChildren): import("react").JSX.Element;
+export declare function useTimelapseClock(): TimelapseClock;
+export declare function useIsPlaying(): boolean;
+/**
+ * Current day time, quantized: the component only re-renders when the value
+ * crosses a quantum boundary, so each consumer picks its own refresh rate.
+ */
+export declare function useDaySeconds(quantum?: number): number;
+//# sourceMappingURL=clock.d.ts.map

package/dist/clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../src/clock.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAG/C,eAAO,MAAM,WAAW,QAAe,CAAC;AAcxC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,gFAAgF;IAChF,aAAa,EAAE,MAAM,MAAM,CAAC;IAC5B,wGAAwG;IACxG,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,uFAAuF;IACvF,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CACjD;AAyED,wBAAgB,sBAAsB,CAAC,EAAE,QAAQ,EAAE,EAAE,iBAAiB,+BAIrE;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAIlD;AAED,wBAAgB,YAAY,IAAI,OAAO,CAGtC;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,SAAI,GAAG,MAAM,CAIjD"}

package/dist/clock.js

@@ -0,0 +1,108 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useState, useSyncExternalStore } from 'react';
+export const DAY_SECONDS = 24 * 60 * 60;
+// Wall-clock duration of a full-day replay.
+const PLAYBACK_SECONDS = 180;
+const RATE = DAY_SECONDS / PLAYBACK_SECONDS;
+// Ticks are capped below the display refresh rate: extra updates are invisible
+// and would only waste re-renders on high-refresh screens.
+const MAX_TICKS_PER_SECOND = 24;
+const MIN_TICK_MS = 1000 / MAX_TICKS_PER_SECOND;
+// Bounds on the wall-clock delta applied per tick. The upper bound keeps a
+// hidden tab (rAF suspended) or a main-thread stall from fast-forwarding the
+// replay; the lower bound guards against the first rAF timestamp predating the
+// performance.now() sampled in play() (vsync time is stamped before input).
+const MAX_TICK_MS = 100;
+function createClock() {
+    let daySeconds = 0;
+    let epoch = 0;
+    let playing = false;
+    let rafId = 0;
+    let lastTick = 0;
+    // Next tick due date, advanced on its own grid so the effective rate stays
+    // at the cap instead of snapping down to a divisor of the refresh rate.
+    let nextTickAt = 0;
+    const listeners = new Set();
+    const notify = () => listeners.forEach((listener) => listener());
+    const tick = (now) => {
+        if (now < nextTickAt) {
+            rafId = requestAnimationFrame(tick);
+            return;
+        }
+        nextTickAt = Math.max(nextTickAt + MIN_TICK_MS, now);
+        daySeconds += (Math.min(Math.max(now - lastTick, 0), MAX_TICK_MS) / 1000) * RATE;
+        lastTick = now;
+        if (daySeconds >= DAY_SECONDS) {
+            daySeconds = DAY_SECONDS;
+            playing = false;
+        }
+        else {
+            rafId = requestAnimationFrame(tick);
+        }
+        notify();
+    };
+    const play = () => {
+        if (playing)
+            return;
+        if (daySeconds >= DAY_SECONDS) {
+            daySeconds = 0;
+            epoch += 1;
+        }
+        playing = true;
+        lastTick = performance.now();
+        nextTickAt = lastTick;
+        rafId = requestAnimationFrame(tick);
+        notify();
+    };
+    const pause = () => {
+        if (!playing)
+            return;
+        playing = false;
+        cancelAnimationFrame(rafId);
+        notify();
+    };
+    return {
+        play,
+        pause,
+        toggle: () => (playing ? pause() : play()),
+        seek: (value) => {
+            daySeconds = Math.min(Math.max(value, 0), DAY_SECONDS);
+            epoch += 1;
+            notify();
+        },
+        getDaySeconds: () => daySeconds,
+        getEpoch: () => epoch,
+        isPlaying: () => playing,
+        subscribe: (listener) => {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+    };
+}
+const ClockContext = createContext(null);
+export function TimelapseClockProvider({ children }) {
+    const [clock] = useState(createClock);
+    useEffect(() => () => clock.pause(), [clock]);
+    return _jsx(ClockContext.Provider, { value: clock, children: children });
+}
+export function useTimelapseClock() {
+    const clock = useContext(ClockContext);
+    if (!clock)
+        throw new Error('useTimelapseClock must be used within a TimelapseClockProvider');
+    return clock;
+}
+export function useIsPlaying() {
+    const clock = useTimelapseClock();
+    return useSyncExternalStore(clock.subscribe, clock.isPlaying, () => false);
+}
+/**
+ * Current day time, quantized: the component only re-renders when the value
+ * crosses a quantum boundary, so each consumer picks its own refresh rate.
+ */
+export function useDaySeconds(quantum = 1) {
+    const clock = useTimelapseClock();
+    const getSnapshot = useCallback(() => Math.floor(clock.getDaySeconds() / quantum) * quantum, [clock, quantum]);
+    return useSyncExternalStore(clock.subscribe, getSnapshot, () => 0);
+}
+//# sourceMappingURL=clock.js.map

package/dist/clock.js.map

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

package/dist/counter.d.ts

@@ -0,0 +1,18 @@
+import type { GeoTimelapseSource } from './types.js';
+interface CounterProps {
+    source: GeoTimelapseSource;
+    ready: boolean;
+    error: string | null;
+    progress: {
+        loadedBytes: number;
+        totalBytes: number;
+    } | null;
+    scopeVersion: number;
+    dateLabel?: string;
+    timeZoneLabel?: string;
+    formatValue: (value: number) => string;
+    formatCount: (count: number) => string;
+}
+export default function Counter({ source, ready, error, progress, scopeVersion, dateLabel, timeZoneLabel, formatValue, formatCount, }: CounterProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=counter.d.ts.map

package/dist/counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"counter.d.ts","sourceRoot":"","sources":["../src/counter.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAU,MAAM,YAAY,CAAC;AAG7D,UAAU,YAAY;IACpB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7D,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACvC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACxC;AAED,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,EAC9B,MAAM,EACN,KAAK,EACL,KAAK,EACL,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,aAAa,EACb,WAAW,EACX,WAAW,GACZ,EAAE,YAAY,+BAiEd"}

package/dist/counter.js

@@ -0,0 +1,54 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useState } from 'react';
+import { useDaySeconds, useTimelapseClock } from './clock.js';
+import { formatDayTime12 } from './utils.js';
+export default function Counter({ source, ready, error, progress, scopeVersion, dateLabel, timeZoneLabel, formatValue, formatCount, }) {
+    const clock = useTimelapseClock();
+    const daySeconds = useDaySeconds(60);
+    const [totals, setTotals] = useState(null);
+    const [queryError, setQueryError] = useState(null);
+    useEffect(() => {
+        if (!ready)
+            return;
+        let disposed = false;
+        let inFlight = false;
+        let lastQueried = -1;
+        // One query at a time: each tick tries, and is skipped while the previous
+        // query is still running, so the counter refreshes as fast as the source
+        // can answer and never queues up.
+        const query = async () => {
+            const second = Math.floor(clock.getDaySeconds());
+            if (inFlight || second === lastQueried)
+                return;
+            inFlight = true;
+            try {
+                const result = await source.totals(second);
+                if (disposed)
+                    return;
+                lastQueried = second;
+                setQueryError(null);
+                setTotals(result);
+            }
+            catch (totalsError) {
+                if (!disposed)
+                    setQueryError(totalsError instanceof Error ? totalsError.message : String(totalsError));
+            }
+            finally {
+                inFlight = false;
+            }
+        };
+        void query();
+        const unsubscribe = clock.subscribe(() => void query());
+        return () => {
+            disposed = true;
+            unsubscribe();
+        };
+        // ready and scopeVersion re-run the effect so a re-scoped source is re-read.
+        // oxlint-disable-next-line react/exhaustive-effect-dependencies
+    }, [clock, source, ready, scopeVersion]);
+    return (_jsx("div", { className: "absolute top-4 right-4 h-24 w-64 rounded-lg bg-black/60 px-4 py-3 text-right font-mono text-white backdrop-blur-sm", children: (error ?? queryError) ? (_jsx("div", { className: "max-w-xs overflow-hidden text-xs text-red-400", children: error ?? queryError })) : ready && totals ? (_jsxs(_Fragment, { children: [_jsxs("div", { className: "text-xs text-white/50 tabular-nums", children: [dateLabel && `${dateLabel}, `, formatDayTime12(daySeconds), timeZoneLabel && ` ${timeZoneLabel}`] }), _jsx("div", { className: "text-2xl tabular-nums", children: formatValue(totals.value) }), _jsx("div", { className: "text-xs text-white/70 tabular-nums", children: formatCount(totals.count) })] })) : (_jsx("div", { className: "text-xs text-white/70 tabular-nums", children: progress
+                ? `loading day… ${Math.round(progress.loadedBytes / 1e6)}/${Math.round(progress.totalBytes / 1e6)} MB`
+                : 'loading…' })) }));
+}
+//# sourceMappingURL=counter.js.map

package/dist/counter.js.map

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

package/dist/duckdb-source.d.ts

@@ -0,0 +1,24 @@
+import * as duckdb from '@duckdb/duckdb-wasm';
+import type { GeoTimelapseSource } from './types.js';
+export interface DuckDbSourceOptions {
+    /** URL of the day's parquet: day_second INT (seconds since the day's
+     *  midnight, sorted), a value column, lat/lon FLOAT. ~60M rows is fine. */
+    parquetUrl: string;
+    /**
+     * Where the duckdb-wasm engine files come from. Omitted: version-matched
+     * jsDelivr URLs (zero config, external CDN). A string: the base URL you
+     * serve `@duckdb/duckdb-wasm/dist` under — serve the copy THIS package
+     * resolves, so the wasm matches the JS. An object: full bundle control.
+     */
+    engine?: string | duckdb.DuckDBBundles;
+    /** Name of the parquet column summed into totals().value. */
+    valueColumn?: string;
+}
+/**
+ * A GeoTimelapseSource backed by duckdb-wasm: the parquet is downloaded once
+ * and loaded into an in-browser table, then every read is a local query.
+ * Each source owns its own engine instance (worker), so two components never
+ * share state — at the price of one table copy per instance.
+ */
+export declare function createDuckDbSource({ parquetUrl, engine, valueColumn, }: DuckDbSourceOptions): GeoTimelapseSource;
+//# sourceMappingURL=duckdb-source.d.ts.map

package/dist/duckdb-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-source.d.ts","sourceRoot":"","sources":["../src/duckdb-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,qBAAqB,CAAC;AAE9C,OAAO,KAAK,EAAe,kBAAkB,EAAqB,MAAM,YAAY,CAAC;AAErF,MAAM,WAAW,mBAAmB;IAClC;+EAC2E;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC;IACvC,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAoBD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,UAAU,EACV,MAAM,EACN,WAAqB,GACtB,EAAE,mBAAmB,GAAG,kBAAkB,CA8L1C"}

package/dist/duckdb-source.js

@@ -0,0 +1,211 @@
+import * as duckdb from '@duckdb/duckdb-wasm';
+function resolveBundles(engine) {
+    if (!engine)
+        return duckdb.getJsDelivrBundles();
+    if (typeof engine === 'string') {
+        const base = engine.replace(/\/$/, '');
+        return {
+            mvp: {
+                mainModule: `${base}/duckdb-mvp.wasm`,
+                mainWorker: `${base}/duckdb-browser-mvp.worker.js`,
+            },
+            eh: {
+                mainModule: `${base}/duckdb-eh.wasm`,
+                mainWorker: `${base}/duckdb-browser-eh.worker.js`,
+            },
+        };
+    }
+    return engine;
+}
+/**
+ * A GeoTimelapseSource backed by duckdb-wasm: the parquet is downloaded once
+ * and loaded into an in-browser table, then every read is a local query.
+ * Each source owns its own engine instance (worker), so two components never
+ * share state — at the price of one table copy per instance.
+ */
+export function createDuckDbSource({ parquetUrl, engine, valueColumn = 'value', }) {
+    let dbPromise = null;
+    let connPromise = null;
+    let loadPromise = null;
+    // Mutable slot so a load() call after the first (e.g. a React StrictMode
+    // remount) still gets progress reports from the single in-flight download.
+    let progressListener;
+    let scopeFilter = 'TRUE';
+    let requestedFilter = 'TRUE';
+    let scopeChain = Promise.resolve();
+    const getDB = () => (dbPromise ??= (async () => {
+        const bundle = await duckdb.selectBundle(resolveBundles(engine));
+        const workerUrl = bundle.mainWorker;
+        // A same-origin worker loads directly (and its requests carry the
+        // page's cookies); cross-origin URLs (the jsDelivr default) need
+        // createWorker's same-origin blob wrapper or the browser blocks them.
+        const sameOrigin = new URL(workerUrl, globalThis.location.href).origin === globalThis.location.origin;
+        const worker = sameOrigin ? new Worker(workerUrl) : await duckdb.createWorker(workerUrl);
+        const db = new duckdb.AsyncDuckDB(new duckdb.ConsoleLogger(duckdb.LogLevel.WARNING), worker);
+        await db.instantiate(bundle.mainModule);
+        return db;
+    })());
+    const getConn = () => (connPromise ??= getDB().then((db) => db.connect()));
+    // Running totals per second, so counters read one row per tick.
+    const CREATE_TOTALS = `
+    CREATE OR REPLACE TABLE totals_by_second AS
+    SELECT day_second,
+           sum(events) OVER w AS events,
+           sum(value) OVER w AS value
+    FROM scope_seconds
+    WINDOW w AS (ORDER BY day_second)
+  `;
+    const load = (onProgress) => {
+        if (onProgress)
+            progressListener = onProgress;
+        return (loadPromise ??= (async () => {
+            const response = await fetch(parquetUrl);
+            if (!response.ok || !response.body)
+                throw new Error(`parquet download failed (${response.status})`);
+            const totalBytes = Number(response.headers.get('content-length') ?? 0);
+            const chunks = [];
+            let loadedBytes = 0;
+            let lastReported = 0;
+            const reader = response.body.getReader();
+            for (;;) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                chunks.push(value);
+                loadedBytes += value.byteLength;
+                if (loadedBytes - lastReported >= 8 * 1024 * 1024) {
+                    lastReported = loadedBytes;
+                    progressListener?.(loadedBytes, totalBytes);
+                }
+            }
+            const buffer = new Uint8Array(loadedBytes);
+            let offset = 0;
+            for (const chunk of chunks) {
+                buffer.set(chunk, offset);
+                offset += chunk.byteLength;
+            }
+            progressListener?.(loadedBytes, totalBytes);
+            const db = await getDB();
+            await db.registerFileBuffer('replay.parquet', buffer);
+            const conn = await getConn();
+            // The value column is normalized at ingest so every later query is
+            // schema-agnostic. The source order (sorted by day_second) is what
+            // gives the in-memory table its zonemap pruning.
+            await conn.query(`
+        CREATE OR REPLACE TABLE events AS
+        SELECT day_second, ${valueColumn} AS value, lat, lon
+        FROM read_parquet('replay.parquet')
+      `);
+            // Per-second counts within the current scope, the single base both
+            // aggregates derive from — so consumers never rescan the raw rows.
+            await conn.query(`
+        CREATE OR REPLACE TABLE scope_seconds AS
+        SELECT day_second, count(*) AS events, sum(value) AS value
+        FROM events
+        GROUP BY day_second
+      `);
+            await conn.query(CREATE_TOTALS);
+            await db.dropFile('replay.parquet');
+        })());
+    };
+    const frame = async (fromSecond, toSecond) => {
+        const conn = await getConn();
+        // Integer bounds keep the comparison on the INTEGER column: a double
+        // literal would disable zonemap pruning and full-scan the table.
+        const result = await conn.query(`
+      SELECT lon, lat, count(*)::DOUBLE AS weight FROM events
+      WHERE day_second >= ${Math.floor(fromSecond)} AND day_second < ${Math.floor(toSecond)}
+        AND lat IS NOT NULL AND lon IS NOT NULL
+      GROUP BY lon, lat
+    `);
+        const lon = result.getChild('lon').toArray();
+        const lat = result.getChild('lat').toArray();
+        const weight = result.getChild('weight').toArray();
+        const positions = new Float32Array(lon.length * 2);
+        const weights = new Float32Array(lon.length);
+        for (let i = 0; i < lon.length; i++) {
+            positions[2 * i] = lon[i];
+            positions[2 * i + 1] = lat[i];
+            weights[i] = weight[i];
+        }
+        return { positions, weights, count: lon.length };
+    };
+    const totals = async (second) => {
+        const conn = await getConn();
+        const result = await conn.query(`
+      SELECT events::DOUBLE AS events, value::DOUBLE AS value
+      FROM totals_by_second
+      WHERE day_second < ${Math.floor(second)}
+      ORDER BY day_second DESC
+      LIMIT 1
+    `);
+        const row = result.numRows > 0 ? result.get(0) : null;
+        return { count: Number(row?.events ?? 0), value: Number(row?.value ?? 0) };
+    };
+    const activity = async () => {
+        const conn = await getConn();
+        const result = await conn.query(`
+      SELECT (day_second // 60)::INT AS minute, sum(events)::DOUBLE AS events
+      FROM scope_seconds
+      GROUP BY minute
+    `);
+        const minutes = result.getChild('minute').toArray();
+        const events = result.getChild('events').toArray();
+        const counts = new Float32Array(24 * 60);
+        for (let i = 0; i < minutes.length; i++)
+            counts[minutes[i]] = events[i];
+        return counts;
+    };
+    // The scan over the raw rows is chunked hour by hour (pruned on
+    // day_second) so playback tick queries interleave instead of queueing
+    // behind one long statement.
+    const setScope = (bounds) => {
+        const filter = bounds
+            ? `lat BETWEEN ${bounds.south} AND ${bounds.north} AND lon BETWEEN ${bounds.west} AND ${bounds.east}`
+            : 'TRUE';
+        requestedFilter = filter;
+        scopeChain = scopeChain
+            .then(async () => {
+            // Superseded while queued, or already active.
+            if (requestedFilter !== filter || filter === scopeFilter)
+                return;
+            // The rebuild reads the events table: wait for the day to be loaded.
+            await load();
+            const conn = await getConn();
+            await conn.query(`
+          CREATE OR REPLACE TABLE scope_seconds_build AS
+          SELECT day_second, count(*) AS events, sum(value) AS value
+          FROM events WHERE false GROUP BY day_second
+        `);
+            for (let hour = 0; hour < 24; hour++) {
+                if (requestedFilter !== filter)
+                    return;
+                await conn.query(`
+            INSERT INTO scope_seconds_build
+            SELECT day_second, count(*), sum(value)
+            FROM events
+            WHERE day_second >= ${hour * 3600} AND day_second < ${(hour + 1) * 3600} AND ${filter}
+            GROUP BY day_second
+          `);
+            }
+            await conn.query(`CREATE OR REPLACE TABLE scope_seconds AS FROM scope_seconds_build`);
+            await conn.query(`DROP TABLE scope_seconds_build`);
+            await conn.query(CREATE_TOTALS);
+            scopeFilter = filter;
+        })
+            // A failed rebuild keeps the previous scope; never poison the chain.
+            .catch((error) => console.error('geotimelapse scope rebuild failed', error));
+        return scopeChain;
+    };
+    const dispose = async () => {
+        const conn = connPromise ? await connPromise.catch(() => null) : null;
+        connPromise = null;
+        await conn?.close().catch(() => { });
+        const db = dbPromise ? await dbPromise.catch(() => null) : null;
+        dbPromise = null;
+        loadPromise = null;
+        await db?.terminate().catch(() => { });
+    };
+    return { load, frame, totals, activity, setScope, dispose };
+}
+//# sourceMappingURL=duckdb-source.js.map

package/dist/duckdb-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-source.js","sourceRoot":"","sources":["../src/duckdb-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,qBAAqB,CAAC;AAmB9C,SAAS,cAAc,CAAC,MAAqC;IAC3D,IAAI,CAAC,MAAM;QAAE,OAAO,MAAM,CAAC,kBAAkB,EAAE,CAAC;IAChD,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACvC,OAAO;YACL,GAAG,EAAE;gBACH,UAAU,EAAE,GAAG,IAAI,kBAAkB;gBACrC,UAAU,EAAE,GAAG,IAAI,+BAA+B;aACnD;YACD,EAAE,EAAE;gBACF,UAAU,EAAE,GAAG,IAAI,iBAAiB;gBACpC,UAAU,EAAE,GAAG,IAAI,8BAA8B;aAClD;SACF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,EACjC,UAAU,EACV,MAAM,EACN,WAAW,GAAG,OAAO,GACD;IACpB,IAAI,SAAS,GAAuC,IAAI,CAAC;IACzD,IAAI,WAAW,GAAiD,IAAI,CAAC;IACrE,IAAI,WAAW,GAAyB,IAAI,CAAC;IAC7C,yEAAyE;IACzE,2EAA2E;IAC3E,IAAI,gBAAiF,CAAC;IACtF,IAAI,WAAW,GAAG,MAAM,CAAC;IACzB,IAAI,eAAe,GAAG,MAAM,CAAC;IAC7B,IAAI,UAAU,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAElD,MAAM,KAAK,GAAG,GAAG,EAAE,CACjB,CAAC,SAAS,KAAK,CAAC,KAAK,IAAI,EAAE;QACzB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;QACjE,MAAM,SAAS,GAAG,MAAM,CAAC,UAAW,CAAC;QACrC,kEAAkE;QAClE,iEAAiE;QACjE,sEAAsE;QACtE,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC;QACtG,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QACzF,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;QAC7F,MAAM,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACxC,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,EAAE,CAAC,CAAC;IAER,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,CAAC,WAAW,KAAK,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAE3E,gEAAgE;IAChE,MAAM,aAAa,GAAG;;;;;;;GAOrB,CAAC;IAEF,MAAM,IAAI,GAAG,CAAC,UAA8D,EAAE,EAAE;QAC9E,IAAI,UAAU;YAAE,gBAAgB,GAAG,UAAU,CAAC;QAC9C,OAAO,CAAC,WAAW,KAAK,CAAC,KAAK,IAAI,EAAE;YAClC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;YACzC,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;YACpG,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;YACvE,MAAM,MAAM,GAAiB,EAAE,CAAC;YAChC,IAAI,WAAW,GAAG,CAAC,CAAC;YACpB,IAAI,YAAY,GAAG,CAAC,CAAC;YACrB,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACzC,SAAS,CAAC;gBACR,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC5C,IAAI,IAAI;oBAAE,MAAM;gBAChB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACnB,WAAW,IAAI,KAAK,CAAC,UAAU,CAAC;gBAChC,IAAI,WAAW,GAAG,YAAY,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;oBAClD,YAAY,GAAG,WAAW,CAAC;oBAC3B,gBAAgB,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;gBAC9C,CAAC;YACH,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;YAC3C,IAAI,MAAM,GAAG,CAAC,CAAC;YACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC;YAC7B,CAAC;YACD,gBAAgB,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;YAE5C,MAAM,EAAE,GAAG,MAAM,KAAK,EAAE,CAAC;YACzB,MAAM,EAAE,CAAC,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,OAAO,EAAE,CAAC;YAC7B,mEAAmE;YACnE,mEAAmE;YACnE,iDAAiD;YACjD,MAAM,IAAI,CAAC,KAAK,CAAC;;6BAEM,WAAW;;OAEjC,CAAC,CAAC;YACH,mEAAmE;YACnE,mEAAmE;YACnE,MAAM,IAAI,CAAC,KAAK,CAAC;;;;;OAKhB,CAAC,CAAC;YACH,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YAChC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;QACtC,CAAC,CAAC,EAAE,CAAC,CAAC;IACR,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,KAAK,EAAE,UAAkB,EAAE,QAAgB,EAAwB,EAAE;QACjF,MAAM,IAAI,GAAG,MAAM,OAAO,EAAE,CAAC;QAC7B,qEAAqE;QACrE,iEAAiE;QACjE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC;;4BAER,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,qBAAqB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;;;KAGtF,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAE,CAAC,OAAO,EAAkB,CAAC;QAC9D,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAE,CAAC,OAAO,EAAkB,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAE,CAAC,OAAO,EAAkB,CAAC;QACpE,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;YAC1B,SAAS,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;YAC9B,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;IACnD,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,KAAK,EAAE,MAAc,EAAmB,EAAE;QACvD,MAAM,IAAI,GAAG,MAAM,OAAO,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC;;;2BAGT,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;;;KAGxC,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACtD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,EAAE,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC;IAC7E,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,KAAK,IAA2B,EAAE;QACjD,MAAM,IAAI,GAAG,MAAM,OAAO,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC;;;;KAI/B,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAE,CAAC,OAAO,EAAgB,CAAC;QACnE,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAE,CAAC,OAAO,EAAkB,CAAC;QACpE,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE;YAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACxE,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,gEAAgE;IAChE,sEAAsE;IACtE,6BAA6B;IAC7B,MAAM,QAAQ,GAAG,CAAC,MAAwB,EAAiB,EAAE;QAC3D,MAAM,MAAM,GAAG,MAAM;YACnB,CAAC,CAAC,eAAe,MAAM,CAAC,KAAK,QAAQ,MAAM,CAAC,KAAK,oBAAoB,MAAM,CAAC,IAAI,QAAQ,MAAM,CAAC,IAAI,EAAE;YACrG,CAAC,CAAC,MAAM,CAAC;QACX,eAAe,GAAG,MAAM,CAAC;QACzB,UAAU,GAAG,UAAU;aACpB,IAAI,CAAC,KAAK,IAAI,EAAE;YACf,8CAA8C;YAC9C,IAAI,eAAe,KAAK,MAAM,IAAI,MAAM,KAAK,WAAW;gBAAE,OAAO;YACjE,qEAAqE;YACrE,MAAM,IAAI,EAAE,CAAC;YACb,MAAM,IAAI,GAAG,MAAM,OAAO,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,KAAK,CAAC;;;;SAIhB,CAAC,CAAC;YACH,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;gBACrC,IAAI,eAAe,KAAK,MAAM;oBAAE,OAAO;gBACvC,MAAM,IAAI,CAAC,KAAK,CAAC;;;;kCAIO,IAAI,GAAG,IAAI,qBAAqB,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,QAAQ,MAAM;;WAEtF,CAAC,CAAC;YACL,CAAC;YACD,MAAM,IAAI,CAAC,KAAK,CAAC,mEAAmE,CAAC,CAAC;YACtF,MAAM,IAAI,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACnD,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YAChC,WAAW,GAAG,MAAM,CAAC;QACvB,CAAC,CAAC;YACF,qEAAqE;aACpE,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC,CAAC;QACxF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,KAAK,IAAI,EAAE;QACzB,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACtE,WAAW,GAAG,IAAI,CAAC;QACnB,MAAM,IAAI,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACpC,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAChE,SAAS,GAAG,IAAI,CAAC;QACjB,WAAW,GAAG,IAAI,CAAC;QACnB,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC9D,CAAC"}

package/dist/geo-timelapse.d.ts

@@ -0,0 +1,8 @@
+import type { GeoTimelapseProps } from './types.js';
+/**
+ * A full-day replay of geolocated events: dark glowing map, waveform seek
+ * bar, running totals, and a TV mode (autoplay, loop, self-hiding UI).
+ * Fills its parent — give the wrapping element an explicit size.
+ */
+export declare function GeoTimelapse(props: GeoTimelapseProps): import("react").JSX.Element;
+//# sourceMappingURL=geo-timelapse.d.ts.map