@fusion.dev/helix-plot 0.0.0-dev

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fusion Development Group
+
+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,147 @@
+# @fusion.dev/helix-plot
+
+Connects the Helix `Spatial Heatmap`, `Spatial Scatter Chart` and
+`Spatial Surface Chart` to three.js, which draws them in three dimensions,
+lit, in a view you can drag round and zoom, colored from your tokens. Each
+also draws itself in SVG, which this package replaces where it is connected.
+
+```sh
+bun add @fusion.dev/helix @fusion.dev/helix-plot three
+```
+
+Put the chart beside its table, with an element inside it for the renderer to
+draw in:
+
+```html
+<table id="customers">…</table>
+
+<helix-spatial-scatter-chart for="customers" group-by="Segment" label="Customers">
+  <div></div>
+</helix-spatial-scatter-chart>
+```
+
+Connect the two:
+
+```js
+import '@fusion.dev/helix/spatial-scatter-chart'
+import { connectSpatialScatterChart } from '@fusion.dev/helix-plot'
+import { threeScatterDriver } from '@fusion.dev/helix-plot/three'
+
+const chart = document.querySelector('helix-spatial-scatter-chart')
+const connection = connectSpatialScatterChart(chart, threeScatterDriver(chart.querySelector('div')))
+```
+
+## What a scatter does
+
+- **The chart reads its table.** The first three numeric columns are across,
+  up, and in depth, and `group-by` names a column of text that colors each
+  point by its group, from the theme's series colors.
+- **The points stand in a box** with a grid on its floor and two of its walls
+  at the ticks, and each axis named along its edges.
+- **Dragging turns the box, and the wheel and a pinch bring it nearer.** Shift
+  with an arrow on the chart turns it a step of 15 degrees. It never turns by
+  itself.
+- **A point the mouse rests on, or one tapped or pressed, is the chart's
+  reading**, as one reached by the keys is. It is ringed in the drawing, and
+  the chart shows its row in the tooltip every Helix chart shows, pointed at
+  the ring and following it as the view turns.
+- **It draws only while something moves**, and asks the browser for no frames
+  at rest or while its box is out of view.
+- **Every three.js drawing Helix makes on a page shares six WebGL contexts**,
+  the graph's and the plot's alike. Past six, one far off screen gives its
+  context back and takes it again as it comes near.
+- **Until the renderer has drawn, the chart draws the points in 3D itself**,
+  in SVG, from about where the renderer's camera starts, and it draws them
+  again after `connection.disconnect()`.
+
+| `threeScatterDriver` option | Default | What else it takes |
+|---|---|---|
+| `density` | screen × 1.5, 2 to 3; on a touch screen, the screen's own, at most 2 | How many pixels the drawing has for each of the page's |
+| `pointSize` | `9` | How large a point is drawn, in CSS pixels, at any distance |
+
+## A surface
+
+`Spatial Surface Chart` connects the same way, with its own connector and driver:
+
+```html
+<table id="load">…</table>
+
+<helix-spatial-surface-chart for="load" label="Load over a week">
+  <div></div>
+</helix-spatial-surface-chart>
+```
+
+```js
+import '@fusion.dev/helix/spatial-surface-chart'
+import { connectSpatialSurfaceChart } from '@fusion.dev/helix-plot'
+import { threeSurfaceDriver } from '@fusion.dev/helix-plot/three'
+
+const chart = document.querySelector('helix-spatial-surface-chart')
+const connection = connectSpatialSurfaceChart(chart, threeSurfaceDriver(chart.querySelector('div')))
+```
+
+- **The chart reads its table as a grid.** Each row is one reading: the first
+  numeric column is across, the second is in depth, and the third is the
+  height. A place on the grid with no reading leaves a hole in the surface.
+- **The surface is shaded along a ramp**, from `--spatial-surface-chart-low` to
+  `--spatial-surface-chart-high`, which default to a quiet tint of the theme's
+  `primary-active` and to `primary-active` itself. It is lit from above and
+  ruled along the grid.
+- **A place the mouse rests on, or one tapped or pressed, is the chart's
+  reading**, ringed and shown in the chart's tooltip as the scatter's is. The
+  left and right arrows move across, and the down and up arrows in depth.
+- The box, the turning, the frames, and the shared contexts are the scatter's.
+- **Until the renderer has drawn, the chart draws the surface in 3D itself**,
+  in SVG, as the scatter draws its points.
+
+| `threeSurfaceDriver` option | Default | What else it takes |
+|---|---|---|
+| `density` | screen × 1.5, 2 to 3; on a touch screen, the screen's own, at most 2 | How many pixels the drawing has for each of the page's |
+
+## A heatmap
+
+`Spatial Heatmap` takes the renderer's box in its `renderer` slot, since its
+table sits inside it:
+
+```html
+<helix-spatial-heatmap for="commits" rows="7">
+  <table id="commits">…</table>
+  <div slot="renderer"></div>
+</helix-spatial-heatmap>
+```
+
+```js
+import '@fusion.dev/helix/spatial-heatmap'
+import { connectSpatialHeatmap } from '@fusion.dev/helix-plot'
+import { threeHeatmapDriver } from '@fusion.dev/helix-plot/three'
+
+const chart = document.querySelector('helix-spatial-heatmap')
+const box = chart.querySelector('[slot="renderer"]')
+const connection = connectSpatialHeatmap(chart, threeHeatmapDriver(box))
+```
+
+- **Each reading is a prism on a slab**, as tall as the chart's own drawing
+  stands it and in its tone from the `--heatmap-tone-*` tokens, lit from
+  above, with each edge set a little apart from its face.
+- **The view starts at the isometric angle** the chart's own drawing is seen
+  from, fitted to the relief, so nothing jumps when the renderer takes over.
+- **The chart's own drawing stays under the renderer's, unseen**, where a
+  screen reader and the keys still reach it, `selection-mode` included.
+- **Shift with an arrow turns the view**, except under
+  `selection-mode="multiple"`, where it selects a range as it always has.
+- **The `start` and `end` labels stand at the two ends of the front edge**
+  where the renderer draws them, as they do in the chart's own drawing, and
+  follow them as the view turns.
+
+| `threeHeatmapDriver` option | Default | What else it takes |
+|---|---|---|
+| `density` | screen × 1.5, 2 to 3; on a touch screen, the screen's own, at most 2 | How many pixels the drawing has for each of the page's |
+
+## What it exports
+
+| Import | What |
+|---|---|
+| `@fusion.dev/helix-plot` | `connectSpatialHeatmap(chart, driver)`, `connectSpatialScatterChart(chart, driver)`, `connectSpatialSurfaceChart(chart, driver)`, `plotColorsFrom(chart, groups, extra)`, and the types `Axes`, `Axis`, `Field`, `HeatmapCell`, `Place`, `PlotColors`, `PlotConnection`, `PlotDriver`, `Point`, `PointerKind`, `SpatialHeatmapConnection`, `SpatialHeatmapDriver`, `SpatialHeatmapField`, `SpatialScatterChartConnection`, `SpatialScatterChartDriver`, `SpatialSurfaceChartConnection`, `SpatialSurfaceChartDriver`, `SurfaceCell` and `SurfaceField` |
+| `@fusion.dev/helix-plot/three` | `threeHeatmapDriver(box, options)`, `threeScatterDriver(box, options)` and `threeSurfaceDriver(box, options)`, and the types `ThreeHeatmapDriverOptions`, `ThreeScatterDriverOptions` and `ThreeSurfaceDriverOptions` |
+
+**three.js is an optional peer**, so a page brings the version it has. `@fusion.dev/helix-plot` itself never imports it: only `@fusion.dev/helix-plot/three` does, so a page with a driver of its own needs no three.js.

package/dist/connect-plot/connect-plot.d.ts

@@ -0,0 +1,125 @@
+/** One axis of a plot: its column's name, its range, and the ticks on it. */
+export interface Axis {
+    name: string;
+    range: readonly [number, number];
+    ticks: readonly number[];
+}
+/** A plot's three axes: across, up, and in depth. */
+export interface Axes {
+    readonly x: Axis;
+    readonly y: Axis;
+    readonly z: Axis;
+}
+/** The colors a plot is drawn in, each `rgb()`, read from the page's tokens where the chart is. */
+export interface PlotColors {
+    /**
+     * Any further colors the chart names, by the name it gave them: a spatial
+     * heatmap's tones, its empty tiles, and its base.
+     */
+    extra: Record<string, string>;
+    /** The box's edges and grid lines: `border`. */
+    grid: string;
+    /** What the drawing is laid on: `surface-sunken`. */
+    ground: string;
+    /** One color for each group, in the order of the groups: `--chart-series-1` and on. */
+    groups: string[];
+    /** The names and the ring on what the keys rest on: `foreground`. */
+    ink: string;
+    /** The ticks' numbers: `foreground-muted`. */
+    quiet: string;
+    /**
+     * The ramp a height is shaded along, from `--spatial-surface-chart-low` to
+     * `--spatial-surface-chart-high`: a quiet tint of `primary-active` up to it whole.
+     */
+    ramp: {
+        high: string;
+        low: string;
+    };
+}
+/** What moved a reading in the drawing. */
+export type PointerKind = 'mouse' | 'pen' | 'touch';
+/** Where a reading is drawn, as fractions of the box the drawing fills, from its top left. */
+export interface Place {
+    x: number;
+    y: number;
+}
+/**
+ * What a renderer has to answer for a 3D chart to drive it, and nothing that
+ * is the same for every renderer: that is the connector's.
+ */
+export interface PlotDriver<F> {
+    /** Draws the chart's field and the axes, replacing whatever was drawn. */
+    draw(field: F, colors: PlotColors, font: string): void;
+    /** Marks the reading at `index` as the one the keys rest on, or none with `-1`. */
+    focus(index: number): void;
+    /**
+     * Calls `hover` with the index of the reading a mouse or a pen rests on in
+     * the drawing, and with `-1` when it rests on none. Returns what stops
+     * listening.
+     */
+    onHover?(hover: (index: number, kind: PointerKind) => void): () => void;
+    /**
+     * Calls `place` with where the reading `focus` marked is drawn, whenever a
+     * frame moves it, and with `undefined` while none is marked or it is out of
+     * view. The chart points its tooltip there. Returns what stops listening.
+     */
+    onPlace?(place: (at: Place | undefined) => void): () => void;
+    /**
+     * Calls `corners` with where the drawing's named corners are drawn, the
+     * two ends of a spatial heatmap's front edge, whenever a frame moves them,
+     * and with `undefined` while they are out of view. The chart stands its
+     * first and last labels there. Returns what stops listening.
+     */
+    onCorners?(corners: (at: {
+        end: Place;
+        start: Place;
+    } | undefined) => void): () => void;
+    /**
+     * Calls `press` with a reading's index when the reader presses it in the
+     * drawing, and with `-1` when they press where none is. Returns what stops
+     * listening.
+     */
+    onPress?(press: (index: number, kind: PointerKind) => void): () => void;
+    /** Turns the view by steps across and up, over a short animation or at once. */
+    turnBy(across: number, up: number, animate: boolean): void;
+    /** Removes whatever the driver added to the page, and frees its renderer. */
+    stop?(): void;
+}
+/** A connection, which is ended rather than left to leak. */
+export interface PlotConnection {
+    /** Stops answering the chart, frees the renderer, and shows the chart's flat drawing again. */
+    disconnect(): void;
+    /**
+     * Reads the page's colors again. The connection hears a theme that changes
+     * by a class, a mode, or the reader's preference on its own; call this
+     * after replacing a stylesheet, which no attribute shows.
+     */
+    restyle(): void;
+}
+/**
+ * The page's colors where the chart is, or `null` while they cannot be read.
+ *
+ * **Settled by the browser and read back as `rgb()`**, since a token is
+ * `light-dark()` over a ramp, which only the browser can settle for the
+ * chart's scheme, and what it settles to may be `oklch()`, which three.js
+ * cannot read. Read inside the chart, so a chart in a dark region of a light
+ * page is drawn dark, and from the names the chart's own sheet gives the
+ * series, so a page that colors its groups colors them here too.
+ */
+export declare const plotColorsFrom: (chart: Element, groups: number, extra?: Record<string, string>) => PlotColors | null;
+/**
+ * Connects a 3D chart to a driver: draws the chart's field, colors it from
+ * the page's tokens, marks the chart's reading, turns the view for Shift
+ * with an arrow, puts a reading hovered or pressed in the drawing on the
+ * chart, and tells the chart where its reading is drawn, for its tooltip.
+ * `groupsOf` says how many group colors the field needs, and `name` is the
+ * connector a misuse is reported by.
+ */
+export declare const connectPlot: <F extends object>(frame: HTMLElement, driver: PlotDriver<F>, options: {
+    /** Further colors to read, by name, as CSS colors that may name the page's tokens. */
+    extraOf?: (field: F) => Record<string, string>;
+    groupsOf: (field: F) => number;
+    name: string;
+    readings: (field: F) => number;
+}) => PlotConnection;
+//# sourceMappingURL=connect-plot.d.ts.map

package/dist/connect-plot/connect-plot.d.ts.map

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

package/dist/connect-plot/connect-plot.js

@@ -0,0 +1,130 @@
+import { HelixPlotChangeEvent, HelixPlotTurnEvent, reportRuntime, rgbOf, watchTheme, } from '@fusion.dev/helix-core';
+const SERIES = 24;
+const still = () => typeof matchMedia === 'function' && matchMedia('(prefers-reduced-motion: reduce)').matches;
+export const plotColorsFrom = (chart, groups, extra = {}) => {
+    if (typeof document === 'undefined') {
+        return null;
+    }
+    const probe = document.createElement('span');
+    probe.style.display = 'none';
+    probe.setAttribute('aria-hidden', 'true');
+    (chart.shadowRoot ?? chart).append(probe);
+    try {
+        const read = (value) => {
+            probe.style.color = '';
+            probe.style.color = value;
+            const color = getComputedStyle(probe).color;
+            return color === '' ? null : rgbOf(color);
+        };
+        const token = (name) => {
+            probe.style.color = '';
+            probe.style.color = `var(--helix-color-${name}, transparent)`;
+            const color = getComputedStyle(probe).color.replace(/\s/g, '');
+            return color === '' || color === 'transparent' || color === 'rgba(0,0,0,0)'
+                ? null
+                : read(`var(--helix-color-${name})`);
+        };
+        const [grid, ground, ink, quiet] = [
+            'border',
+            'surface-sunken',
+            'foreground',
+            'foreground-muted',
+        ].map(token);
+        if (!grid || !ground || !ink || !quiet) {
+            return null;
+        }
+        const colors = [];
+        for (let at = 0; at < Math.max(groups, 1); at++) {
+            colors.push(read(`var(--chart-series-${(at % SERIES) + 1}, var(--helix-color-primary))`) ?? ink);
+        }
+        const high = read('var(--spatial-surface-chart-high, var(--helix-color-primary-active))') ?? ink;
+        const low = read('var(--spatial-surface-chart-low, color-mix(in oklab, var(--helix-color-primary-active) 15%, var(--helix-color-surface-sunken)))') ?? ground;
+        const named = {};
+        for (const [name, value] of Object.entries(extra)) {
+            named[name] = read(value) ?? ink;
+        }
+        return { extra: named, grid, ground, groups: colors, ink, quiet, ramp: { high, low } };
+    }
+    finally {
+        probe.remove();
+    }
+};
+export const connectPlot = (frame, driver, options) => {
+    const chart = frame;
+    if (!('field' in frame) || typeof chart.requestActive !== 'function') {
+        reportRuntime({
+            detail: frame,
+            kind: 'not-a-plot',
+            message: `${options.name}: the element given is not the 3D chart it connects, so nothing will be drawn.`,
+            tag: frame.localName,
+        });
+    }
+    let connected = true;
+    const draw = () => {
+        const field = chart.field;
+        if (!connected || !field) {
+            return;
+        }
+        const colors = plotColorsFrom(frame, options.groupsOf(field), options.extraOf?.(field));
+        if (!colors || options.readings(field) === 0) {
+            chart.rendererDrawn?.(false);
+            return;
+        }
+        const font = getComputedStyle(frame)
+            .fontFamily.split(',')[0]
+            ?.trim()
+            .replace(/^["']|["']$/g, '') ?? '';
+        driver.draw(field, colors, font || 'sans-serif');
+        driver.focus(chart.active ?? -1);
+        chart.rendererDrawn?.(true);
+    };
+    const handleChange = (event) => {
+        const { kind } = event.detail;
+        if (kind === 'data') {
+            draw();
+        }
+        else {
+            driver.focus(chart.active ?? -1);
+        }
+    };
+    const handleTurn = (event) => {
+        const { across, up } = event.detail;
+        driver.turnBy(across, up, !still());
+    };
+    frame.addEventListener(HelixPlotChangeEvent.eventName, handleChange);
+    frame.addEventListener(HelixPlotTurnEvent.eventName, handleTurn);
+    const stopPress = driver.onPress?.((index, kind) => {
+        chart.requestActive?.(index, kind);
+    });
+    const stopHover = driver.onHover?.((index, kind) => {
+        chart.requestActive?.(index, kind);
+    });
+    const stopPlace = driver.onPlace?.((at) => {
+        chart.placeReading?.(at);
+    });
+    const stopCorners = driver.onCorners?.((at) => {
+        chart.placeCorners?.(at);
+    });
+    const stopTheme = watchTheme(frame, () => {
+        draw();
+    });
+    void Promise.resolve(chart.updateComplete).then(draw);
+    return {
+        disconnect: () => {
+            connected = false;
+            frame.removeEventListener(HelixPlotChangeEvent.eventName, handleChange);
+            frame.removeEventListener(HelixPlotTurnEvent.eventName, handleTurn);
+            stopPress?.();
+            stopHover?.();
+            stopPlace?.();
+            stopCorners?.();
+            chart.placeReading?.(undefined);
+            chart.placeCorners?.(undefined);
+            stopTheme();
+            driver.stop?.();
+            chart.rendererDrawn?.(false);
+        },
+        restyle: draw,
+    };
+};
+//# sourceMappingURL=connect-plot.js.map

package/dist/connect-plot/connect-plot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-plot.js","sourceRoot":"","sources":["../../src/connect-plot/connect-plot.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAElB,aAAa,EACb,KAAK,EACL,UAAU,GACX,MAAM,wBAAwB,CAAA;AAiH/B,MAAM,MAAM,GAAG,EAAE,CAAA;AAGjB,MAAM,KAAK,GAAG,GAAY,EAAE,CAC1B,OAAO,UAAU,KAAK,UAAU,IAAI,UAAU,CAAC,kCAAkC,CAAC,CAAC,OAAO,CAAA;AAY5F,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,KAAc,EACd,MAAc,EACd,KAAK,GAA2B,EAAE,EACf,EAAE;IACrB,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACpC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;IAC5C,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAA;IAC5B,KAAK,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAKxC;IAAA,CAAC,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC1C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,KAAa,EAAiB,EAAE;YAC5C,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAA;YACtB,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAA;YACzB,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,KAAK,CAAA;YAC3C,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QAC3C,CAAC,CAAA;QAID,MAAM,KAAK,GAAG,CAAC,IAAY,EAAiB,EAAE;YAC5C,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAA;YACtB,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,qBAAqB,IAAI,gBAAgB,CAAA;YAC7D,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;YAC9D,OAAO,KAAK,KAAK,EAAE,IAAI,KAAK,KAAK,aAAa,IAAI,KAAK,KAAK,eAAe;gBACzE,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,IAAI,CAAC,qBAAqB,IAAI,GAAG,CAAC,CAAA;QACxC,CAAC,CAAA;QACD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG;YACjC,QAAQ;YACR,gBAAgB;YAChB,YAAY;YACZ,kBAAkB;SACnB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACZ,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACvC,OAAO,IAAI,CAAA;QACb,CAAC;QACD,MAAM,MAAM,GAAa,EAAE,CAAA;QAC3B,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC;YAChD,MAAM,CAAC,IAAI,CACT,IAAI,CAAC,sBAAsB,CAAC,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,+BAA+B,CAAC,IAAI,GAAG,CACpF,CAAA;QACH,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,sEAAsE,CAAC,IAAI,GAAG,CAAA;QAChG,MAAM,GAAG,GACP,IAAI,CACF,iIAAiI,CAClI,IAAI,MAAM,CAAA;QACb,MAAM,KAAK,GAA2B,EAAE,CAAA;QACxC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAA;QAClC,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAAA;IACxF,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,MAAM,EAAE,CAAA;IAChB,CAAC;AACH,CAAC,CAAA;AAUD,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,KAAkB,EAClB,MAAqB,EACrB,OAMC,EACe,EAAE;IAClB,MAAM,KAAK,GAAG,KAAiB,CAAA;IAC/B,IAAI,CAAC,CAAC,OAAO,IAAI,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;QACrE,aAAa,CAAC;YACZ,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,gFAAgF;YACxG,GAAG,EAAE,KAAK,CAAC,SAAS;SACrB,CAAC,CAAA;IACJ,CAAC;IACD,IAAI,SAAS,GAAG,IAAI,CAAA;IAEpB,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAA;QACzB,IAAI,CAAC,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC;YACzB,OAAM;QACR,CAAC;QACD,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;QACvF,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7C,KAAK,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,CAAA;YAC5B,OAAM;QACR,CAAC;QACD,MAAM,IAAI,GACR,gBAAgB,CAAC,KAAK,CAAC;aACpB,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACzB,EAAE,IAAI,EAAE;aACP,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,IAAI,EAAE,CAAA;QACtC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,IAAI,YAAY,CAAC,CAAA;QAChD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAA;QAChC,KAAK,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,CAAA;IAC7B,CAAC,CAAA;IAED,MAAM,YAAY,GAAG,CAAC,KAAY,EAAQ,EAAE;QAC1C,MAAM,EAAE,IAAI,EAAE,GAAI,KAA8B,CAAC,MAAM,CAAA;QACvD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,IAAI,EAAE,CAAA;QACR,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAA;QAClC,CAAC;IACH,CAAC,CAAA;IAED,MAAM,UAAU,GAAG,CAAC,KAAY,EAAQ,EAAE;QACxC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,GAAI,KAAqC,CAAC,MAAM,CAAA;QACpE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAA;IACrC,CAAC,CAAA;IAED,KAAK,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAA;IACpE,KAAK,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;IAChE,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACjD,KAAK,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;IACF,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACjD,KAAK,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;IACF,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE;QACxC,KAAK,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC,CAAA;IAC1B,CAAC,CAAC,CAAA;IACF,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE;QAC5C,KAAK,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC,CAAA;IAC1B,CAAC,CAAC,CAAA;IACF,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE;QACvC,IAAI,EAAE,CAAA;IACR,CAAC,CAAC,CAAA;IAGF,KAAK,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAErD,OAAO;QACL,UAAU,EAAE,GAAG,EAAE;YACf,SAAS,GAAG,KAAK,CAAA;YACjB,KAAK,CAAC,mBAAmB,CAAC,oBAAoB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAA;YACvE,KAAK,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;YACnE,SAAS,EAAE,EAAE,CAAA;YACb,SAAS,EAAE,EAAE,CAAA;YACb,SAAS,EAAE,EAAE,CAAA;YACb,WAAW,EAAE,EAAE,CAAA;YACf,KAAK,CAAC,YAAY,EAAE,CAAC,SAAS,CAAC,CAAA;YAC/B,KAAK,CAAC,YAAY,EAAE,CAAC,SAAS,CAAC,CAAA;YAC/B,SAAS,EAAE,CAAA;YACX,MAAM,CAAC,IAAI,EAAE,EAAE,CAAA;YACf,KAAK,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,CAAA;QAC9B,CAAC;QACD,OAAO,EAAE,IAAI;KACd,CAAA;AACH,CAAC,CAAA"}

package/dist/connect-spatial-heatmap/connect-spatial-heatmap.d.ts

@@ -0,0 +1,43 @@
+import { type PlotConnection, type PlotDriver } from '../connect-plot/connect-plot.js';
+/** One reading of a spatial heatmap, where it stands on the grid and how tall. */
+export interface HeatmapCell {
+    /** Which column it stands in, from the oldest drawn. */
+    column: number;
+    /** How tall it stands, in cells, from zero. */
+    height: number;
+    /** The row's own label, which names it. */
+    label: string;
+    /** Which row of its column it stands in. */
+    row: number;
+    /** The tone it is painted in, as the chart names it, or none for a day with nothing in it. */
+    tone?: string | undefined;
+}
+/**
+ * What a spatial heatmap publishes for a renderer to draw: every reading it
+ * draws, down each column and then across, as its own drawing paints them,
+ * and how many columns and rows the grid has.
+ */
+export interface SpatialHeatmapField {
+    cells: readonly HeatmapCell[];
+    columns: number;
+    rows: number;
+}
+/** A renderer for a spatial heatmap: `focus` and `onPress` take a reading's place in `field.cells`. */
+export type SpatialHeatmapDriver = PlotDriver<SpatialHeatmapField>;
+/** A connection between a spatial heatmap and its renderer. */
+export type SpatialHeatmapConnection = PlotConnection;
+/**
+ * Connects a spatial heatmap to whatever draws it in three dimensions.
+ *
+ * The chart is `helix-spatial-heatmap` or `helix-headless-spatial-heatmap`,
+ * with the renderer's box in its `renderer` slot, and the driver is
+ * `threeHeatmapDriver` from `@fusion.dev/helix-plot/three`, or one of your
+ * own. The connection draws the chart's readings as prisms in the driver,
+ * each in its tone from the page's `--heatmap-tone-*` tokens, marks the
+ * reading the chart rests on, turns the view for Shift with an arrow, and
+ * puts a reading hovered or pressed in the drawing on the chart. Once the
+ * driver has drawn, the chart's own SVG drawing gives way to it;
+ * `disconnect()` shows it again.
+ */
+export declare const connectSpatialHeatmap: (frame: HTMLElement, driver: SpatialHeatmapDriver) => SpatialHeatmapConnection;
+//# sourceMappingURL=connect-spatial-heatmap.d.ts.map

package/dist/connect-spatial-heatmap/connect-spatial-heatmap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-spatial-heatmap.d.ts","sourceRoot":"","sources":["../../src/connect-spatial-heatmap/connect-spatial-heatmap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAEnG,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAA;IACd,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAA;IACd,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAA;IACb,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAA;IACX,8FAA8F;IAC9F,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACb;AAED,uGAAuG;AACvG,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAA;AAElE,+DAA+D;AAC/D,MAAM,MAAM,wBAAwB,GAAG,cAAc,CAAA;AAErD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,UACzB,WAAW,UACV,oBAAoB,KAC3B,wBAiBC,CAAA"}

package/dist/connect-spatial-heatmap/connect-spatial-heatmap.js

@@ -0,0 +1,15 @@
+import { connectPlot } from '../connect-plot/connect-plot.js';
+export const connectSpatialHeatmap = (frame, driver) => connectPlot(frame, driver, {
+    extraOf: (field) => ({
+        base: 'color-mix(in oklab, var(--helix-color-surface-sunken), var(--helix-color-border) 45%)',
+        tile: 'color-mix(in oklab, var(--helix-color-surface-sunken), var(--helix-color-surface) 60%)',
+        ...Object.fromEntries([...new Set(field.cells.flatMap((cell) => (cell.tone ? [cell.tone] : [])))].map((tone) => [
+            `tone-${tone}`,
+            `var(--heatmap-tone-${tone})`,
+        ])),
+    }),
+    groupsOf: () => 0,
+    name: 'connectSpatialHeatmap',
+    readings: (field) => field.cells.length,
+});
+//# sourceMappingURL=connect-spatial-heatmap.js.map

package/dist/connect-spatial-heatmap/connect-spatial-heatmap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-spatial-heatmap.js","sourceRoot":"","sources":["../../src/connect-spatial-heatmap/connect-spatial-heatmap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAwC,MAAM,iCAAiC,CAAA;AA8CnG,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,KAAkB,EAClB,MAA4B,EACF,EAAE,CAC5B,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE;IAGzB,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACnB,IAAI,EAAE,uFAAuF;QAC7F,IAAI,EAAE,wFAAwF;QAC9F,GAAG,MAAM,CAAC,WAAW,CACnB,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YACxF,QAAQ,IAAI,EAAE;YACd,sBAAsB,IAAI,GAAG;SAC9B,CAAC,CACH;KACF,CAAC;IACF,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;IACjB,IAAI,EAAE,uBAAuB;IAC7B,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM;CACxC,CAAC,CAAA"}

package/dist/connect-spatial-scatter-chart/connect-spatial-scatter-chart.d.ts

@@ -0,0 +1,34 @@
+import { type Axes, type PlotConnection, type PlotDriver } from '../connect-plot/connect-plot.js';
+/** One point of the plot: its row's label, its group, and its three numbers. */
+export interface Point {
+    group: string;
+    groupIndex: number;
+    label: string;
+    row: number;
+    x: number;
+    y: number;
+    z: number;
+}
+/** What a Spatial Scatter Chart publishes for a renderer to draw: its points, its axes, and its groups. */
+export interface Field {
+    axes: Axes;
+    groups: readonly string[];
+    points: readonly Point[];
+}
+/** A renderer for a Spatial Scatter Chart: `focus` and `onPress` take a point's place in `field.points`. */
+export type SpatialScatterChartDriver = PlotDriver<Field>;
+/** A connection between a Spatial Scatter Chart and its renderer. */
+export type SpatialScatterChartConnection = PlotConnection;
+/**
+ * Connects a Spatial Scatter Chart to whatever draws it in three dimensions.
+ *
+ * The chart is `helix-spatial-scatter-chart` or `helix-headless-spatial-scatter-chart`, and the
+ * driver is `threeScatterDriver` from `@fusion.dev/helix-plot/three`, or one
+ * of your own. The connection draws the chart's points and axes in the
+ * driver, colors each group from the page's series tokens, marks the point
+ * the keys rest on, turns the view for Shift with an arrow, and puts a point
+ * pressed in the drawing on the chart's reading. Once the driver has drawn,
+ * the chart hides its own SVG drawing; `disconnect()` shows it again.
+ */
+export declare const connectSpatialScatterChart: (frame: HTMLElement, driver: SpatialScatterChartDriver) => SpatialScatterChartConnection;
+//# sourceMappingURL=connect-spatial-scatter-chart.d.ts.map

package/dist/connect-spatial-scatter-chart/connect-spatial-scatter-chart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-spatial-scatter-chart.d.ts","sourceRoot":"","sources":["../../src/connect-spatial-scatter-chart/connect-spatial-scatter-chart.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,IAAI,EAET,KAAK,cAAc,EACnB,KAAK,UAAU,EAChB,MAAM,iCAAiC,CAAA;AAExC,gFAAgF;AAChF,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED,2GAA2G;AAC3G,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,IAAI,CAAA;IACV,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB,MAAM,EAAE,SAAS,KAAK,EAAE,CAAA;CACzB;AAED,4GAA4G;AAC5G,MAAM,MAAM,yBAAyB,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;AAEzD,qEAAqE;AACrE,MAAM,MAAM,6BAA6B,GAAG,cAAc,CAAA;AAE1D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0BAA0B,UAC9B,WAAW,UACV,yBAAyB,KAChC,6BAKC,CAAA"}

package/dist/connect-spatial-scatter-chart/connect-spatial-scatter-chart.js

@@ -0,0 +1,7 @@
+import { connectPlot, } from '../connect-plot/connect-plot.js';
+export const connectSpatialScatterChart = (frame, driver) => connectPlot(frame, driver, {
+    groupsOf: (field) => field.groups.length,
+    name: 'connectSpatialScatterChart',
+    readings: (field) => field.points.length,
+});
+//# sourceMappingURL=connect-spatial-scatter-chart.js.map

package/dist/connect-spatial-scatter-chart/connect-spatial-scatter-chart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-spatial-scatter-chart.js","sourceRoot":"","sources":["../../src/connect-spatial-scatter-chart/connect-spatial-scatter-chart.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,WAAW,GAGZ,MAAM,iCAAiC,CAAA;AAqCxC,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,KAAkB,EAClB,MAAiC,EACF,EAAE,CACjC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE;IACzB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM;IACxC,IAAI,EAAE,4BAA4B;IAClC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM;CACzC,CAAC,CAAA"}

package/dist/connect-spatial-surface-chart/connect-spatial-surface-chart.d.ts

@@ -0,0 +1,39 @@
+import { type Axes, type PlotConnection, type PlotDriver } from '../connect-plot/connect-plot.js';
+/** One place on a surface's grid, and its reading, where the table has one. */
+export interface SurfaceCell {
+    label?: string | undefined;
+    row?: number | undefined;
+    value?: number | undefined;
+    x: number;
+    z: number;
+}
+/**
+ * What a Spatial Surface Chart publishes for a renderer to draw: every place on
+ * its grid, across first, so the place `across` along and `depth` back is
+ * `cells[across * depths.length + depth]`, and its axes.
+ */
+export interface SurfaceField {
+    acrosses: readonly number[];
+    axes: Axes;
+    cells: readonly SurfaceCell[];
+    depths: readonly number[];
+    readings: number;
+}
+/** A renderer for a Spatial Surface Chart: `focus` and `onPress` take a place's index in `field.cells`. */
+export type SpatialSurfaceChartDriver = PlotDriver<SurfaceField>;
+/** A connection between a Spatial Surface Chart and its renderer. */
+export type SpatialSurfaceChartConnection = PlotConnection;
+/**
+ * Connects a Spatial Surface Chart to whatever draws it in three dimensions.
+ *
+ * The chart is `helix-spatial-surface-chart` or `helix-headless-spatial-surface-chart`, and the
+ * driver is `threeSurfaceDriver` from `@fusion.dev/helix-plot/three`, or one
+ * of your own. The connection draws the chart's grid as a surface in the
+ * driver, shaded along the ramp `--spatial-surface-chart-low` to `--spatial-surface-chart-high`,
+ * marks the place the keys rest on, turns the view for Shift with an arrow,
+ * and puts a place pressed in the drawing on the chart's reading. Once the
+ * driver has drawn, the chart hides its own SVG drawing; `disconnect()`
+ * shows it again.
+ */
+export declare const connectSpatialSurfaceChart: (frame: HTMLElement, driver: SpatialSurfaceChartDriver) => SpatialSurfaceChartConnection;
+//# sourceMappingURL=connect-spatial-surface-chart.d.ts.map

package/dist/connect-spatial-surface-chart/connect-spatial-surface-chart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-spatial-surface-chart.d.ts","sourceRoot":"","sources":["../../src/connect-spatial-surface-chart/connect-spatial-surface-chart.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,IAAI,EAET,KAAK,cAAc,EACnB,KAAK,UAAU,EAChB,MAAM,iCAAiC,CAAA;AAExC,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B,IAAI,EAAE,IAAI,CAAA;IACV,KAAK,EAAE,SAAS,WAAW,EAAE,CAAA;IAC7B,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,2GAA2G;AAC3G,MAAM,MAAM,yBAAyB,GAAG,UAAU,CAAC,YAAY,CAAC,CAAA;AAEhE,qEAAqE;AACrE,MAAM,MAAM,6BAA6B,GAAG,cAAc,CAAA;AAE1D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,0BAA0B,UAC9B,WAAW,UACV,yBAAyB,KAChC,6BAKC,CAAA"}

package/dist/connect-spatial-surface-chart/connect-spatial-surface-chart.js

@@ -0,0 +1,7 @@
+import { connectPlot, } from '../connect-plot/connect-plot.js';
+export const connectSpatialSurfaceChart = (frame, driver) => connectPlot(frame, driver, {
+    groupsOf: () => 0,
+    name: 'connectSpatialSurfaceChart',
+    readings: (field) => field.readings,
+});
+//# sourceMappingURL=connect-spatial-surface-chart.js.map

package/dist/connect-spatial-surface-chart/connect-spatial-surface-chart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-spatial-surface-chart.js","sourceRoot":"","sources":["../../src/connect-spatial-surface-chart/connect-spatial-surface-chart.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,WAAW,GAGZ,MAAM,iCAAiC,CAAA;AA0CxC,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,KAAkB,EAClB,MAAiC,EACF,EAAE,CACjC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE;IACzB,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;IACjB,IAAI,EAAE,4BAA4B;IAClC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ;CACpC,CAAC,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { type Axes, type Axis, type Place, type PlotColors, type PlotConnection, type PlotDriver, type PointerKind, plotColorsFrom, } from './connect-plot/connect-plot.js';
+export { connectSpatialHeatmap, type HeatmapCell, type SpatialHeatmapConnection, type SpatialHeatmapDriver, type SpatialHeatmapField, } from './connect-spatial-heatmap/connect-spatial-heatmap.js';
+export { connectSpatialScatterChart, type Field, type Point, type SpatialScatterChartConnection, type SpatialScatterChartDriver, } from './connect-spatial-scatter-chart/connect-spatial-scatter-chart.js';
+export { connectSpatialSurfaceChart, type SpatialSurfaceChartConnection, type SpatialSurfaceChartDriver, type SurfaceCell, type SurfaceField, } from './connect-spatial-surface-chart/connect-spatial-surface-chart.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,IAAI,EACT,KAAK,IAAI,EACT,KAAK,KAAK,EACV,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,cAAc,GACf,MAAM,gCAAgC,CAAA;AACvC,OAAO,EACL,qBAAqB,EACrB,KAAK,WAAW,EAChB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,sDAAsD,CAAA;AAC7D,OAAO,EACL,0BAA0B,EAC1B,KAAK,KAAK,EACV,KAAK,KAAK,EACV,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,GAC/B,MAAM,kEAAkE,CAAA;AACzE,OAAO,EACL,0BAA0B,EAC1B,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,EAC9B,KAAK,WAAW,EAChB,KAAK,YAAY,GAClB,MAAM,kEAAkE,CAAA"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { plotColorsFrom, } from './connect-plot/connect-plot.js';
+export { connectSpatialHeatmap, } from './connect-spatial-heatmap/connect-spatial-heatmap.js';
+export { connectSpatialScatterChart, } from './connect-spatial-scatter-chart/connect-spatial-scatter-chart.js';
+export { connectSpatialSurfaceChart, } from './connect-spatial-surface-chart/connect-spatial-surface-chart.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,cAAc,GACf,MAAM,gCAAgC,CAAA;AACvC,OAAO,EACL,qBAAqB,GAKtB,MAAM,sDAAsD,CAAA;AAC7D,OAAO,EACL,0BAA0B,GAK3B,MAAM,kEAAkE,CAAA;AACzE,OAAO,EACL,0BAA0B,GAK3B,MAAM,kEAAkE,CAAA"}