@sqlrooms/deck 0.29.0-rc.2

package/README.md

@@ -0,0 +1,357 @@
+Deck.gl integration for SQLRooms with JSON-driven map specs, dataset registry
+binding, DuckDB-backed or in-memory Arrow datasets, and GeoArrow-first geometry
+preparation.
+
+## Installation
+
+```bash
+npm install @sqlrooms/deck @sqlrooms/duckdb @sqlrooms/ui
+```
+
+## What This Package Does
+
+`@sqlrooms/deck` is the JSON-spec bridge between SQLRooms data and deck.gl:
+
+- render a DeckGL map from a serializable `DeckJsonMap` spec
+- bind one or more datasets through a `datasets` registry
+- generate starter JSON specs from datasets with `createDeckJsonSpecFromDatasets`
+- validate SQLRooms-specific layer bindings under `_sqlroomsBinding`
+- prepare geometry for GeoArrow-native layers from
+  [`@geoarrow/deck.gl-layers`](https://github.com/geoarrow/deck.gl-layers)
+  and GeoJSON fallback layers
+- support shared declarative color scales through `@sqlrooms/color-scales`
+
+Use this package when you want deck.gl layers to be driven by a JSON-like spec
+instead of hand-constructing deck layer instances in React code.
+
+## Quick Start
+
+```tsx
+import {DeckJsonMap} from '@sqlrooms/deck';
+
+const spec = {
+  initialViewState: {
+    longitude: -122.4,
+    latitude: 37.74,
+    zoom: 10,
+    pitch: 0,
+    bearing: 0,
+  },
+  controller: true,
+  layers: [
+    {
+      '@@type': 'GeoArrowScatterplotLayer',
+      id: 'airports',
+      _sqlroomsBinding: {
+        dataset: 'airports',
+        geometryColumn: 'geom',
+      },
+      getFillColor: {
+        '@@function': 'colorScale',
+        field: 'scalerank',
+        type: 'sequential',
+        scheme: 'YlOrRd',
+        domain: 'auto',
+      },
+      getRadius: '@@=6',
+      radiusMinPixels: 2,
+    },
+  ],
+};
+
+export function AirportsMap() {
+  return (
+    <DeckJsonMap
+      spec={spec}
+      datasets={{
+        airports: {
+          sqlQuery:
+            'SELECT name, abbrev, scalerank, ST_AsWKB(geom) AS geom FROM airports',
+          geometryColumn: 'geom',
+          geometryEncodingHint: 'wkb',
+        },
+      }}
+      mapStyle="https://basemaps.cartocdn.com/gl/positron-gl-style/style.json"
+    />
+  );
+}
+```
+
+## Auto Spec Generation
+
+If you want a starter JSON spec instead of writing every layer manually, use
+`createDeckJsonSpecFromDatasets(...)`:
+
+```tsx
+import {createDeckJsonSpecFromDatasets, DeckJsonMap} from '@sqlrooms/deck';
+
+const datasets = {
+  earthquakes: {
+    arrowTable,
+    geometryColumn: 'geom',
+    geometryEncodingHint: 'wkb',
+  },
+};
+
+const spec = createDeckJsonSpecFromDatasets({datasets});
+```
+
+By default, the helper is conservative:
+
+- point / multipoint -> `GeoArrowScatterplotLayer`
+- linestring / multilinestring -> `GeoArrowPathLayer`
+- polygon / multipolygon -> `GeoArrowPolygonLayer`
+- mixed, unknown, or unsupported -> `GeoJsonLayer`
+
+You can provide semantic hints for special layers:
+
+```tsx
+const spec = createDeckJsonSpecFromDatasets({
+  datasets,
+  hints: {
+    earthquakes: {prefer: 'heatmap'},
+    trips: {
+      type: 'GeoArrowTripsLayer',
+      timestampColumn: 'timestamps',
+    },
+    flows: {
+      type: 'GeoArrowArcLayer',
+      sourceGeometryColumn: 'source_geom',
+      targetGeometryColumn: 'target_geom',
+    },
+    hexes: {
+      type: 'GeoArrowH3HexagonLayer',
+      hexagonColumn: 'h3',
+    },
+  },
+});
+```
+
+## Core Concepts
+
+### `DeckJsonMap`
+
+`DeckJsonMap` is the main React component exported by this package. It takes:
+
+- `spec`: a JSON-like deck.gl spec object or JSON string
+- `datasets`: a dataset registry keyed by dataset id
+- `deckProps`: runtime-only deck props such as `getTooltip`, `onHover`, `onClick`
+- `mapProps`: runtime-only MapLibre props
+- `showLegends`: whether SQLRooms-generated color legends should render
+
+`spec` stays serializable; callbacks and runtime behavior belong in `deckProps`
+or `mapProps`.
+
+### Dataset Registry
+
+Each SQLRooms-managed layer binds to exactly one dataset through
+`_sqlroomsBinding.dataset`.
+
+```tsx
+<DeckJsonMap
+  spec={spec}
+  datasets={{
+    earthquakes: {sqlQuery: 'SELECT * FROM earthquakes'},
+    faults: {sqlQuery: 'SELECT * FROM faults'},
+  }}
+/>
+```
+
+Dataset ids are layer-binding labels. Internally, prepared geometry is cached
+by the resolved data identity, not by dataset id, so multiple maps or layers
+can reuse the same preparation work when they point at the same table/query.
+
+### Dataset Input Kinds
+
+Each dataset entry is one of:
+
+```tsx
+datasets={{
+  airports: {
+    sqlQuery: 'SELECT * FROM airports',
+    geometryColumn: 'geom',
+    geometryEncodingHint: 'wkb',
+  },
+  preview: {
+    arrowTable,
+    geometryColumn: 'geom',
+    geometryEncodingHint: 'wkb',
+  },
+}}
+```
+
+- `sqlQuery`
+  Runs through the DuckDB slice execution path.
+- `arrowTable`
+  Uses an already available Apache Arrow table. This is the right input for
+  Arrow-native SQLRooms hooks such as `useSql` and `useMosaicClient`.
+
+For in-memory Arrow datasets, `arrowTable` may be temporarily `undefined` while
+data is still loading. `DeckJsonMap` will keep rendering the basemap and treat
+that dataset as loading until a table is provided.
+
+## SQLRooms Layer Bindings
+
+SQLRooms-specific layer metadata lives under `_sqlroomsBinding`:
+
+```tsx
+{
+  '@@type': 'GeoArrowScatterplotLayer',
+  id: 'earthquakes',
+  _sqlroomsBinding: {
+    dataset: 'earthquakes',
+    geometryColumn: 'geom',
+    geometryEncodingHint: 'wkb',
+  },
+  getFillColor: {
+    '@@function': 'colorScale',
+    field: 'Magnitude',
+    type: 'sequential',
+    scheme: 'YlOrRd',
+    domain: 'auto',
+  },
+}
+```
+
+Currently supported SQLRooms binding fields are:
+
+- `dataset`: binds the layer to one dataset id
+- `geometryColumn`: overrides geometry column detection for that layer
+- `geometryEncodingHint`: helps geometry detection when the source table needs it
+- `sourceGeometryColumn`: source point geometry for `GeoArrowArcLayer`
+- `targetGeometryColumn`: target point geometry for `GeoArrowArcLayer`
+- `timestampColumn`: timestamp list column for `GeoArrowTripsLayer`
+- `hexagonColumn`: H3 index column for `GeoArrowH3HexagonLayer`
+
+The surrounding deck spec remains intentionally loose so normal deck.gl JSON
+props still pass through, while `_sqlroomsBinding` is validated strictly.
+
+## Color Scales and Legends
+
+You can ask SQLRooms to derive colors from a field with the
+`colorScale` JSON function instead of writing long `@@=` color
+expressions:
+
+```tsx
+getFillColor: {
+  '@@function': 'colorScale',
+  field: 'Magnitude',
+  type: 'sequential',
+  scheme: 'YlOrRd',
+  domain: 'auto',
+  clamp: true,
+}
+```
+
+Discrete numeric palettes are supported too:
+
+```tsx
+getFillColor: {
+  '@@function': 'colorScale',
+  field: 'Magnitude',
+  type: 'quantize',
+  scheme: 'PuBuGn',
+  domain: [0, 8],
+  bins: 5,
+}
+```
+
+`DeckJsonMap` renders SQLRooms-generated legends by default for layers that use
+`colorScale`. To disable them globally:
+
+```tsx
+<DeckJsonMap spec={spec} datasets={datasets} showLegends={false} />
+```
+
+To override the title:
+
+```tsx
+getFillColor: {
+  '@@function': 'colorScale',
+  field: 'Magnitude',
+  type: 'sequential',
+  scheme: 'YlOrRd',
+  domain: 'auto',
+  legend: {
+    title: 'Magnitude (Mw)',
+  },
+}
+```
+
+Supported scale types come from `@sqlrooms/color-scales`:
+
+- `sequential`
+- `diverging`
+- `quantize`
+- `quantile`
+- `threshold`
+- `categorical`
+
+When `domain` is set to `'auto'`, the domain is computed from the currently
+bound dataset, so colors may shift as filters change. Use explicit domains when
+you want colors to stay stable across filtering.
+
+## Geometry Preparation
+
+`prepareDeckDataset(...)` is the deck-specific preparation step behind the
+scenes. It accepts resolved Arrow tables with geometry stored as:
+
+- native GeoArrow
+- WKB / GeoArrow WKB
+- WKT / GeoArrow WKT
+
+It then produces canonical deck-facing geometry outputs for:
+
+- GeoArrow-native layers such as `GeoArrowScatterplotLayer`
+- GeoJSON-binary fallback layers such as `GeoJsonLayer`
+
+Specialized layers such as `GeoArrowArcLayer`, `GeoArrowTripsLayer`, and
+`GeoArrowH3HexagonLayer` reuse the prepared table but bind additional
+configured columns on top for source/target geometry,
+timestamps, or index cells.
+
+This work is cached internally in a module-global prepared dataset store. That
+cache is separate from any upstream query cache:
+
+- Mosaic-driven queries already benefit from Mosaic's own query cache
+- DuckDB SQL datasets still use the DuckDB slice execution path
+
+Deck caches only the expensive geometry preparation layer on top.
+
+## Supported Layers
+
+The current curated layer set is:
+
+- `GeoArrowScatterplotLayer`
+- `GeoArrowHeatmapLayer`
+- `GeoArrowColumnLayer`
+- `GeoArrowPathLayer`
+- `GeoArrowPolygonLayer`
+- `GeoArrowSolidPolygonLayer`
+- `GeoArrowArcLayer`
+- `GeoArrowTripsLayer`
+- `GeoArrowH3HexagonLayer`
+- `GeoJsonLayer`
+
+GeoArrow-native geometry columns are the efficient path. WKB/WKT geometry falls
+back to decoding and GeoJSON-binary preparation, with point promotion available
+for point-focused GeoArrow layers such as `GeoArrowScatterplotLayer`,
+`GeoArrowHeatmapLayer`, and `GeoArrowColumnLayer`.
+
+The GeoArrow layer implementations themselves come from
+[`@geoarrow/deck.gl-layers`](https://github.com/geoarrow/deck.gl-layers).
+
+When querying DuckDB spatial `GEOMETRY` columns directly, convert them first
+with `ST_AsWKB(...)` or `ST_AsText(...)`. DuckDB's internal geometry payload is
+not the same as standard WKB.
+
+## Runtime Props and Children
+
+Keep the spec serializable, then pass runtime behavior separately:
+
+- `deckProps` for deck callbacks such as `getTooltip`, `onHover`, `onClick`
+- `mapProps` for MapLibre props such as `projection`
+- `children` for controls, overlays, and popups rendered inside the map
+
+This lets the spec stay stable for storage, validation, and future AI-assisted
+generation while still supporting interactive React behavior at runtime.

package/dist/ColorScaleLegend.d.ts

@@ -0,0 +1,8 @@
+import type { ResolvedColorLegend } from './json/compileColorScale';
+type ColorScaleLegendProps = {
+    legends: ResolvedColorLegend[];
+    className?: string;
+};
+export declare function ColorScaleLegend({ legends, className }: ColorScaleLegendProps): import("react/jsx-runtime").JSX.Element | null;
+export {};
+//# sourceMappingURL=ColorScaleLegend.d.ts.map

package/dist/ColorScaleLegend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorScaleLegend.d.ts","sourceRoot":"","sources":["../src/ColorScaleLegend.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,0BAA0B,CAAC;AAElE,KAAK,qBAAqB,GAAG;IAC3B,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,EAAC,OAAO,EAAE,SAAS,EAAC,EAAE,qBAAqB,kDA8D3E"}

package/dist/ColorScaleLegend.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from '@sqlrooms/ui';
+export function ColorScaleLegend({ legends, className }) {
+    if (!legends.length) {
+        return null;
+    }
+    return (_jsx("div", { className: cn('pointer-events-none absolute bottom-2 left-2 z-10 flex max-w-56 flex-col gap-3', className), children: legends.map((legend) => (_jsxs("div", { className: "bg-background/70 rounded-md px-3 py-2 shadow-sm backdrop-blur-sm", children: [_jsx("div", { className: "text-foreground mb-2 text-xs font-semibold", children: legend.title }), legend.type === 'continuous' ? (_jsxs("div", { children: [_jsx("div", { className: "h-3 rounded-sm border", style: { background: legend.gradient } }), _jsx("div", { className: "text-muted-foreground mt-1 flex justify-between gap-2 text-[0.6rem]", children: legend.ticks.map((tick) => (_jsx("span", { className: cn(tick.offset === 50 ? 'text-center' : '', tick.offset === 100 ? 'text-right' : ''), children: tick.label }, `${legend.title}-${tick.offset}-${tick.label}`))) })] })) : (_jsx("div", { className: "space-y-1.5", children: legend.items.map((item) => (_jsxs("div", { className: "text-foreground flex items-center gap-2 text-xs", children: [_jsx("span", { className: "h-3 w-3 rounded-sm border", style: {
+                                    backgroundColor: `rgba(${item.color[0]}, ${item.color[1]}, ${item.color[2]}, ${item.color[3] / 255})`,
+                                } }), _jsx("span", { className: "truncate", children: item.label })] }, `${legend.title}-${item.label}`))) }))] }, `${legend.title}-${legend.type}`))) }));
+}
+//# sourceMappingURL=ColorScaleLegend.js.map

package/dist/ColorScaleLegend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorScaleLegend.js","sourceRoot":"","sources":["../src/ColorScaleLegend.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAC,EAAE,EAAC,MAAM,cAAc,CAAC;AAQhC,MAAM,UAAU,gBAAgB,CAAC,EAAC,OAAO,EAAE,SAAS,EAAwB;IAC1E,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CACL,cACE,SAAS,EAAE,EAAE,CACX,gFAAgF,EAChF,SAAS,CACV,YAEA,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CACvB,eAEE,SAAS,EAAC,kEAAkE,aAE5E,cAAK,SAAS,EAAC,4CAA4C,YACxD,MAAM,CAAC,KAAK,GACT,EACL,MAAM,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,CAC9B,0BACE,cACE,SAAS,EAAC,uBAAuB,EACjC,KAAK,EAAE,EAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,EAAC,GACpC,EACF,cAAK,SAAS,EAAC,qEAAqE,YACjF,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAC1B,eAEE,SAAS,EAAE,EAAE,CACX,IAAI,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EACvC,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CACxC,YAEA,IAAI,CAAC,KAAK,IANN,GAAG,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,EAAE,CAO9C,CACR,CAAC,GACE,IACF,CACP,CAAC,CAAC,CAAC,CACF,cAAK,SAAS,EAAC,aAAa,YACzB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAC1B,eAEE,SAAS,EAAC,iDAAiD,aAE3D,eACE,SAAS,EAAC,2BAA2B,EACrC,KAAK,EAAE;oCACL,eAAe,EAAE,QAAQ,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG;iCACtG,GACD,EACF,eAAM,SAAS,EAAC,UAAU,YAAE,IAAI,CAAC,KAAK,GAAQ,KATzC,GAAG,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAUhC,CACP,CAAC,GACE,CACP,KA3CI,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,CA4CjC,CACP,CAAC,GACE,CACP,CAAC;AACJ,CAAC","sourcesContent":["import {cn} from '@sqlrooms/ui';\nimport type {ResolvedColorLegend} from './json/compileColorScale';\n\ntype ColorScaleLegendProps = {\n  legends: ResolvedColorLegend[];\n  className?: string;\n};\n\nexport function ColorScaleLegend({legends, className}: ColorScaleLegendProps) {\n  if (!legends.length) {\n    return null;\n  }\n\n  return (\n    <div\n      className={cn(\n        'pointer-events-none absolute bottom-2 left-2 z-10 flex max-w-56 flex-col gap-3',\n        className,\n      )}\n    >\n      {legends.map((legend) => (\n        <div\n          key={`${legend.title}-${legend.type}`}\n          className=\"bg-background/70 rounded-md px-3 py-2 shadow-sm backdrop-blur-sm\"\n        >\n          <div className=\"text-foreground mb-2 text-xs font-semibold\">\n            {legend.title}\n          </div>\n          {legend.type === 'continuous' ? (\n            <div>\n              <div\n                className=\"h-3 rounded-sm border\"\n                style={{background: legend.gradient}}\n              />\n              <div className=\"text-muted-foreground mt-1 flex justify-between gap-2 text-[0.6rem]\">\n                {legend.ticks.map((tick) => (\n                  <span\n                    key={`${legend.title}-${tick.offset}-${tick.label}`}\n                    className={cn(\n                      tick.offset === 50 ? 'text-center' : '',\n                      tick.offset === 100 ? 'text-right' : '',\n                    )}\n                  >\n                    {tick.label}\n                  </span>\n                ))}\n              </div>\n            </div>\n          ) : (\n            <div className=\"space-y-1.5\">\n              {legend.items.map((item) => (\n                <div\n                  key={`${legend.title}-${item.label}`}\n                  className=\"text-foreground flex items-center gap-2 text-xs\"\n                >\n                  <span\n                    className=\"h-3 w-3 rounded-sm border\"\n                    style={{\n                      backgroundColor: `rgba(${item.color[0]}, ${item.color[1]}, ${item.color[2]}, ${item.color[3] / 255})`,\n                    }}\n                  />\n                  <span className=\"truncate\">{item.label}</span>\n                </div>\n              ))}\n            </div>\n          )}\n        </div>\n      ))}\n    </div>\n  );\n}\n"]}

package/dist/DeckMap.d.ts

@@ -0,0 +1,4 @@
+import 'maplibre-gl/dist/maplibre-gl.css';
+import type { DeckMapProps } from './types';
+export declare function DeckMap({ spec, datasets, sqlQuery, arrowTable, queryResult, geometryColumn, geometryEncodingHint, mapStyle, deckProps, mapProps, className, children, }: DeckMapProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=DeckMap.d.ts.map

package/dist/DeckMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeckMap.d.ts","sourceRoot":"","sources":["../src/DeckMap.tsx"],"names":[],"mappings":"AAGA,OAAO,kCAAkC,CAAC;AAU1C,OAAO,KAAK,EAAC,YAAY,EAA2B,MAAM,SAAS,CAAC;AA6GpE,wBAAgB,OAAO,CAAC,EACtB,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,SAAS,EACT,QAAQ,GACT,EAAE,YAAY,2CAgId"}

package/dist/DeckMap.js

@@ -0,0 +1,157 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { JSONConverter } from '@deck.gl/json';
+import DeckGL from '@deck.gl/react';
+import { cn } from '@sqlrooms/ui';
+import 'maplibre-gl/dist/maplibre-gl.css';
+import { useEffect, useMemo } from 'react';
+import Map from 'react-map-gl/maplibre';
+import { normalizeDatasets } from './datasets/normalizeDatasets';
+import { usePreparedDeckDatasets } from './datasets/usePreparedDeckDatasets';
+import { ColorScaleLegend } from './ColorScaleLegend';
+import { createDeckJsonConfiguration } from './json/createDeckJsonConfiguration';
+import { extractColorScaleLegends } from './json/extractColorScaleLegends';
+import { resolveDatasetId } from './json/layerConfig';
+import { getLayerCompatibility } from './json/layerCompatibility';
+const DEFAULT_MAP_STYLE = 'https://basemaps.cartocdn.com/gl/positron-gl-style/style.json';
+function parseSpec(spec) {
+    try {
+        return {
+            spec: typeof spec === 'string' ? JSON.parse(spec) : spec,
+            error: null,
+        };
+    }
+    catch (error) {
+        return {
+            spec: null,
+            error: error instanceof Error ? error : new Error(String(error)),
+        };
+    }
+}
+function extractFallbackDeckProps(spec) {
+    if (!spec) {
+        return {};
+    }
+    const fallbackProps = {};
+    for (const key of ['initialViewState', 'viewState', 'controller']) {
+        if (key in spec) {
+            fallbackProps[key] = spec[key];
+        }
+    }
+    return fallbackProps;
+}
+function filterUnavailableLayers(spec, datasetIds, datasetStates) {
+    const layers = Array.isArray(spec.layers) ? spec.layers : [];
+    const filteredLayers = layers.filter((layer) => {
+        if (!layer || typeof layer !== 'object') {
+            return true;
+        }
+        const layerProps = layer;
+        const layerName = String(layerProps['@@type'] ?? '');
+        const compatibility = getLayerCompatibility(layerName);
+        if (!compatibility) {
+            return true;
+        }
+        const datasetId = resolveDatasetId(layerProps, datasetIds);
+        if (!datasetId) {
+            return true;
+        }
+        const datasetState = datasetStates[datasetId];
+        if (!datasetState) {
+            return false;
+        }
+        return datasetState.status === 'ready';
+    });
+    return {
+        ...spec,
+        layers: filteredLayers,
+    };
+}
+function renderDatasetStatusOverlay(datasetStates) {
+    const loadingDatasets = Object.entries(datasetStates)
+        .filter(([, state]) => state.status === 'loading')
+        .map(([datasetId]) => datasetId);
+    const failedDatasets = Object.entries(datasetStates).filter((entry) => entry[1].status === 'error');
+    if (!loadingDatasets.length && !failedDatasets.length) {
+        return null;
+    }
+    return (_jsxs("div", { className: "pointer-events-none absolute inset-x-4 top-4 z-10 space-y-2", children: [loadingDatasets.length > 0 ? (_jsxs("div", { className: "rounded-md border border-black/10 bg-white/90 px-3 py-2 text-sm text-slate-700 shadow-sm", children: ["Loading datasets: ", loadingDatasets.join(', ')] })) : null, failedDatasets.map(([datasetId, state]) => (_jsx("div", { className: "rounded-md border border-red-200 bg-red-50/95 px-3 py-2 text-sm text-red-700 shadow-sm", children: `Dataset "${datasetId}" failed: ${state.error.message}` }, datasetId)))] }));
+}
+export function DeckMap({ spec, datasets, sqlQuery, arrowTable, queryResult, geometryColumn, geometryEncodingHint, mapStyle, deckProps, mapProps, className, children, }) {
+    const normalizedDatasets = useMemo(() => normalizeDatasets({
+        datasets,
+        sqlQuery,
+        arrowTable,
+        queryResult,
+        geometryColumn,
+        geometryEncodingHint,
+    }), [
+        datasets,
+        sqlQuery,
+        arrowTable,
+        queryResult,
+        geometryColumn,
+        geometryEncodingHint,
+    ]);
+    const datasetIds = useMemo(() => Object.keys(normalizedDatasets), [normalizedDatasets]);
+    const datasetStates = usePreparedDeckDatasets(normalizedDatasets);
+    const { spec: parsedSpec, error: specError } = useMemo(() => parseSpec(spec), [spec]);
+    const availableSpec = useMemo(() => parsedSpec
+        ? filterUnavailableLayers(parsedSpec, datasetIds, datasetStates)
+        : null, [parsedSpec, datasetIds, datasetStates]);
+    const converter = useMemo(() => new JSONConverter({
+        configuration: createDeckJsonConfiguration({
+            datasetStates,
+            datasetIds,
+        }),
+        onJSONChange: () => { },
+    }), [datasetIds, datasetStates]);
+    const convertedDeckPropsResult = useMemo(() => {
+        if (!availableSpec) {
+            return { props: null, error: specError };
+        }
+        try {
+            return {
+                props: converter.convert(availableSpec),
+                error: null,
+            };
+        }
+        catch (error) {
+            return {
+                props: null,
+                error: error instanceof Error ? error : new Error(String(error)),
+            };
+        }
+    }, [availableSpec, converter, specError]);
+    useEffect(() => {
+        if (convertedDeckPropsResult.error) {
+            console.error(convertedDeckPropsResult.error);
+        }
+    }, [convertedDeckPropsResult.error]);
+    const fallbackDeckProps = useMemo(() => extractFallbackDeckProps(availableSpec), [availableSpec]);
+    const convertedDeckProps = (convertedDeckPropsResult.props ??
+        fallbackDeckProps ??
+        {});
+    const extraDeckProps = (deckProps ?? {});
+    const extraMapProps = (mapProps ?? {});
+    const hasRenderingError = Boolean(convertedDeckPropsResult.error);
+    const mergedDeckProps = {
+        ...convertedDeckProps,
+        ...extraDeckProps,
+        layers: hasRenderingError
+            ? []
+            : (deckProps?.layers ??
+                convertedDeckProps.layers ??
+                []),
+    };
+    const mergedMapProps = {
+        ...extraMapProps,
+        mapStyle: mapStyle ?? mapProps?.mapStyle ?? DEFAULT_MAP_STYLE,
+    };
+    const legends = useMemo(() => extractColorScaleLegends({
+        spec: availableSpec,
+        datasetIds,
+        datasetStates,
+    }), [availableSpec, datasetIds, datasetStates]);
+    return (_jsxs("div", { className: cn('relative h-full w-full', className), children: [hasRenderingError ? (_jsx("div", { className: "absolute inset-0 z-10 flex items-center justify-center p-4", children: _jsx("div", { className: "max-w-sm rounded-md border border-red-200 bg-red-50/95 p-4 text-sm text-red-700 shadow-sm", children: `Map couldn't be rendered. Check the console for details.` }) })) : null, _jsx(DeckGL, { ...mergedDeckProps, children: _jsx(Map, { ...mergedMapProps, children: children }) }), renderDatasetStatusOverlay(datasetStates), !hasRenderingError ? _jsx(ColorScaleLegend, { legends: legends }) : null] }));
+}
+//# sourceMappingURL=DeckMap.js.map

package/dist/DeckMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeckMap.js","sourceRoot":"","sources":["../src/DeckMap.tsx"],"names":[],"mappings":"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","sourcesContent":["import {JSONConverter} from '@deck.gl/json';\nimport DeckGL from '@deck.gl/react';\nimport {cn} from '@sqlrooms/ui';\nimport 'maplibre-gl/dist/maplibre-gl.css';\nimport {useEffect, useMemo} from 'react';\nimport Map from 'react-map-gl/maplibre';\nimport {normalizeDatasets} from './datasets/normalizeDatasets';\nimport {usePreparedDeckDatasets} from './datasets/usePreparedDeckDatasets';\nimport {ColorScaleLegend} from './ColorScaleLegend';\nimport {createDeckJsonConfiguration} from './json/createDeckJsonConfiguration';\nimport {extractColorScaleLegends} from './json/extractColorScaleLegends';\nimport {resolveDatasetId} from './json/layerConfig';\nimport {getLayerCompatibility} from './json/layerCompatibility';\nimport type {DeckMapProps, PreparedDeckDatasetState} from './types';\n\nconst DEFAULT_MAP_STYLE =\n  'https://basemaps.cartocdn.com/gl/positron-gl-style/style.json';\n\nfunction parseSpec(spec: DeckMapProps['spec']) {\n  try {\n    return {\n      spec: typeof spec === 'string' ? JSON.parse(spec) : spec,\n      error: null,\n    };\n  } catch (error) {\n    return {\n      spec: null,\n      error: error instanceof Error ? error : new Error(String(error)),\n    };\n  }\n}\n\nfunction extractFallbackDeckProps(spec: Record<string, unknown> | null) {\n  if (!spec) {\n    return {};\n  }\n\n  const fallbackProps: Record<string, unknown> = {};\n  for (const key of ['initialViewState', 'viewState', 'controller']) {\n    if (key in spec) {\n      fallbackProps[key] = spec[key];\n    }\n  }\n\n  return fallbackProps;\n}\n\nfunction filterUnavailableLayers(\n  spec: Record<string, unknown>,\n  datasetIds: string[],\n  datasetStates: Record<string, PreparedDeckDatasetState>,\n) {\n  const layers = Array.isArray(spec.layers) ? spec.layers : [];\n  const filteredLayers = layers.filter((layer) => {\n    if (!layer || typeof layer !== 'object') {\n      return true;\n    }\n\n    const layerProps = layer as Record<string, unknown>;\n    const layerName = String(layerProps['@@type'] ?? '');\n    const compatibility = getLayerCompatibility(layerName);\n    if (!compatibility) {\n      return true;\n    }\n\n    const datasetId = resolveDatasetId(layerProps, datasetIds);\n    if (!datasetId) {\n      return true;\n    }\n\n    const datasetState = datasetStates[datasetId];\n    if (!datasetState) {\n      return false;\n    }\n\n    return datasetState.status === 'ready';\n  });\n\n  return {\n    ...spec,\n    layers: filteredLayers,\n  };\n}\n\nfunction renderDatasetStatusOverlay(\n  datasetStates: Record<string, PreparedDeckDatasetState>,\n) {\n  const loadingDatasets = Object.entries(datasetStates)\n    .filter(([, state]) => state.status === 'loading')\n    .map(([datasetId]) => datasetId);\n  const failedDatasets = Object.entries(datasetStates).filter(\n    (\n      entry,\n    ): entry is [\n      string,\n      Extract<PreparedDeckDatasetState, {status: 'error'}>,\n    ] => entry[1].status === 'error',\n  );\n\n  if (!loadingDatasets.length && !failedDatasets.length) {\n    return null;\n  }\n\n  return (\n    <div className=\"pointer-events-none absolute inset-x-4 top-4 z-10 space-y-2\">\n      {loadingDatasets.length > 0 ? (\n        <div className=\"rounded-md border border-black/10 bg-white/90 px-3 py-2 text-sm text-slate-700 shadow-sm\">\n          Loading datasets: {loadingDatasets.join(', ')}\n        </div>\n      ) : null}\n      {failedDatasets.map(([datasetId, state]) => (\n        <div\n          key={datasetId}\n          className=\"rounded-md border border-red-200 bg-red-50/95 px-3 py-2 text-sm text-red-700 shadow-sm\"\n        >\n          {`Dataset \"${datasetId}\" failed: ${state.error.message}`}\n        </div>\n      ))}\n    </div>\n  );\n}\n\nexport function DeckMap({\n  spec,\n  datasets,\n  sqlQuery,\n  arrowTable,\n  queryResult,\n  geometryColumn,\n  geometryEncodingHint,\n  mapStyle,\n  deckProps,\n  mapProps,\n  className,\n  children,\n}: DeckMapProps) {\n  const normalizedDatasets = useMemo(\n    () =>\n      normalizeDatasets({\n        datasets,\n        sqlQuery,\n        arrowTable,\n        queryResult,\n        geometryColumn,\n        geometryEncodingHint,\n      }),\n    [\n      datasets,\n      sqlQuery,\n      arrowTable,\n      queryResult,\n      geometryColumn,\n      geometryEncodingHint,\n    ],\n  );\n  const datasetIds = useMemo(\n    () => Object.keys(normalizedDatasets),\n    [normalizedDatasets],\n  );\n  const datasetStates = usePreparedDeckDatasets(normalizedDatasets);\n\n  const {spec: parsedSpec, error: specError} = useMemo(\n    () => parseSpec(spec),\n    [spec],\n  );\n\n  const availableSpec = useMemo(\n    () =>\n      parsedSpec\n        ? filterUnavailableLayers(parsedSpec, datasetIds, datasetStates)\n        : null,\n    [parsedSpec, datasetIds, datasetStates],\n  );\n\n  const converter = useMemo(\n    () =>\n      new JSONConverter({\n        configuration: createDeckJsonConfiguration({\n          datasetStates,\n          datasetIds,\n        }),\n        onJSONChange: () => {},\n      }),\n    [datasetIds, datasetStates],\n  );\n\n  const convertedDeckPropsResult = useMemo(() => {\n    if (!availableSpec) {\n      return {props: null, error: specError};\n    }\n\n    try {\n      return {\n        props: converter.convert(availableSpec) as Record<string, unknown>,\n        error: null,\n      };\n    } catch (error) {\n      return {\n        props: null,\n        error: error instanceof Error ? error : new Error(String(error)),\n      };\n    }\n  }, [availableSpec, converter, specError]);\n\n  useEffect(() => {\n    if (convertedDeckPropsResult.error) {\n      console.error(convertedDeckPropsResult.error);\n    }\n  }, [convertedDeckPropsResult.error]);\n\n  const fallbackDeckProps = useMemo(\n    () => extractFallbackDeckProps(availableSpec),\n    [availableSpec],\n  );\n  const convertedDeckProps = (convertedDeckPropsResult.props ??\n    fallbackDeckProps ??\n    {}) as Record<string, unknown>;\n  const extraDeckProps = (deckProps ?? {}) as Record<string, unknown>;\n  const extraMapProps = (mapProps ?? {}) as Record<string, unknown>;\n  const hasRenderingError = Boolean(convertedDeckPropsResult.error);\n\n  const mergedDeckProps = {\n    ...convertedDeckProps,\n    ...extraDeckProps,\n    layers: hasRenderingError\n      ? []\n      : (deckProps?.layers ??\n        (convertedDeckProps.layers as unknown[] | undefined) ??\n        []),\n  };\n\n  const mergedMapProps = {\n    ...extraMapProps,\n    mapStyle: mapStyle ?? mapProps?.mapStyle ?? DEFAULT_MAP_STYLE,\n  };\n  const legends = useMemo(\n    () =>\n      extractColorScaleLegends({\n        spec: availableSpec,\n        datasetIds,\n        datasetStates,\n      }),\n    [availableSpec, datasetIds, datasetStates],\n  );\n\n  return (\n    <div className={cn('relative h-full w-full', className)}>\n      {hasRenderingError ? (\n        <div className=\"absolute inset-0 z-10 flex items-center justify-center p-4\">\n          <div className=\"max-w-sm rounded-md border border-red-200 bg-red-50/95 p-4 text-sm text-red-700 shadow-sm\">\n            {`Map couldn't be rendered. Check the console for details.`}\n          </div>\n        </div>\n      ) : null}\n\n      <DeckGL {...(mergedDeckProps as object)}>\n        <Map {...(mergedMapProps as object)}>{children}</Map>\n      </DeckGL>\n\n      {renderDatasetStatusOverlay(datasetStates)}\n      {!hasRenderingError ? <ColorScaleLegend legends={legends} /> : null}\n    </div>\n  );\n}\n"]}

package/dist/datasets/normalizeDatasets.d.ts

@@ -0,0 +1,5 @@
+import type * as arrow from 'apache-arrow';
+import type { DeckDatasetInput, DeckMapProps } from '../types';
+export declare function resolveArrowTable(input: DeckDatasetInput): arrow.Table | undefined;
+export declare function normalizeDatasets(props: Pick<DeckMapProps, 'datasets' | 'sqlQuery' | 'arrowTable' | 'queryResult' | 'geometryColumn' | 'geometryEncodingHint'>): Record<string, DeckDatasetInput>;
+//# sourceMappingURL=normalizeDatasets.d.ts.map

package/dist/datasets/normalizeDatasets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeDatasets.d.ts","sourceRoot":"","sources":["../../src/datasets/normalizeDatasets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAC,gBAAgB,EAAE,YAAY,EAAsB,MAAM,UAAU,CAAC;AA8ClF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,gBAAgB,GACtB,KAAK,CAAC,KAAK,GAAG,SAAS,CAEzB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,IAAI,CACT,YAAY,EACV,UAAU,GACV,UAAU,GACV,YAAY,GACZ,aAAa,GACb,gBAAgB,GAChB,sBAAsB,CACzB,GACA,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CA2BlC"}

package/dist/datasets/normalizeDatasets.js

@@ -0,0 +1,57 @@
+function getArrowTableFromQueryResult(queryResult) {
+    return queryResult?.arrowTable;
+}
+function countDefinedInputs(input) {
+    return Number(Boolean(input.sqlQuery)) +
+        Number(Boolean(input.arrowTable)) +
+        Number(Boolean(input.queryResult));
+}
+function assertArrowTable(value, datasetId) {
+    if (!value) {
+        throw new Error(`Dataset "${datasetId}" queryResult did not expose an arrowTable.`);
+    }
+}
+function normalizeDatasetEntry(datasetId, input) {
+    const normalized = {
+        sqlQuery: input.sqlQuery,
+        arrowTable: input.arrowTable,
+        queryResult: input.queryResult,
+        geometryColumn: input.geometryColumn,
+        geometryEncodingHint: input.geometryEncodingHint,
+    };
+    const definedInputs = countDefinedInputs(normalized);
+    if (definedInputs !== 1) {
+        throw new Error(`Dataset "${datasetId}" must provide exactly one of sqlQuery, arrowTable, or queryResult.`);
+    }
+    if (normalized.queryResult) {
+        assertArrowTable(getArrowTableFromQueryResult(normalized.queryResult), datasetId);
+    }
+    return normalized;
+}
+export function resolveArrowTable(input) {
+    return input.arrowTable ?? getArrowTableFromQueryResult(input.queryResult);
+}
+export function normalizeDatasets(props) {
+    if (props.datasets) {
+        const entries = Object.entries(props.datasets).map(([datasetId, input]) => [
+            datasetId,
+            normalizeDatasetEntry(datasetId, input),
+        ]);
+        return Object.fromEntries(entries);
+    }
+    const singleInput = {
+        sqlQuery: props.sqlQuery,
+        arrowTable: props.arrowTable,
+        queryResult: props.queryResult,
+        geometryColumn: props.geometryColumn,
+        geometryEncodingHint: props.geometryEncodingHint,
+    };
+    const definedInputs = countDefinedInputs(singleInput);
+    if (definedInputs === 0) {
+        throw new Error('DeckMap requires either datasets or one of sqlQuery, arrowTable, or queryResult.');
+    }
+    return {
+        default: normalizeDatasetEntry('default', singleInput),
+    };
+}
+//# sourceMappingURL=normalizeDatasets.js.map

package/dist/datasets/normalizeDatasets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeDatasets.js","sourceRoot":"","sources":["../../src/datasets/normalizeDatasets.ts"],"names":[],"mappings":"AAGA,SAAS,4BAA4B,CAAC,WAA4C;IAChF,OAAO,WAAW,EAAE,UAAU,CAAC;AACjC,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAuB;IACjD,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACjC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,gBAAgB,CAAC,KAA8B,EAAE,SAAiB;IACzE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,YAAY,SAAS,6CAA6C,CACnE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAC5B,SAAiB,EACjB,KAAuB;IAEvB,MAAM,UAAU,GAAqB;QACnC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;KACjD,CAAC;IAEF,MAAM,aAAa,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACrD,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,YAAY,SAAS,qEAAqE,CAC3F,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;QAC3B,gBAAgB,CAAC,4BAA4B,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,CAAC;IACpF,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAAuB;IAEvB,OAAO,KAAK,CAAC,UAAU,IAAI,4BAA4B,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAQC;IAED,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;YACzE,SAAS;YACT,qBAAqB,CAAC,SAAS,EAAE,KAAK,CAAC;SACxC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,WAAW,GAAqB;QACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;KACjD,CAAC;IAEF,MAAM,aAAa,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACtD,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,kFAAkF,CACnF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,qBAAqB,CAAC,SAAS,EAAE,WAAW,CAAC;KACvD,CAAC;AACJ,CAAC","sourcesContent":["import type * as arrow from 'apache-arrow';\nimport type {DeckDatasetInput, DeckMapProps, DeckQueryResultLike} from '../types';\n\nfunction getArrowTableFromQueryResult(queryResult: DeckQueryResultLike | undefined) {\n  return queryResult?.arrowTable;\n}\n\nfunction countDefinedInputs(input: DeckDatasetInput) {\n  return Number(Boolean(input.sqlQuery)) +\n    Number(Boolean(input.arrowTable)) +\n    Number(Boolean(input.queryResult));\n}\n\nfunction assertArrowTable(value: arrow.Table | undefined, datasetId: string) {\n  if (!value) {\n    throw new Error(\n      `Dataset \"${datasetId}\" queryResult did not expose an arrowTable.`,\n    );\n  }\n}\n\nfunction normalizeDatasetEntry(\n  datasetId: string,\n  input: DeckDatasetInput,\n): DeckDatasetInput {\n  const normalized: DeckDatasetInput = {\n    sqlQuery: input.sqlQuery,\n    arrowTable: input.arrowTable,\n    queryResult: input.queryResult,\n    geometryColumn: input.geometryColumn,\n    geometryEncodingHint: input.geometryEncodingHint,\n  };\n\n  const definedInputs = countDefinedInputs(normalized);\n  if (definedInputs !== 1) {\n    throw new Error(\n      `Dataset \"${datasetId}\" must provide exactly one of sqlQuery, arrowTable, or queryResult.`,\n    );\n  }\n\n  if (normalized.queryResult) {\n    assertArrowTable(getArrowTableFromQueryResult(normalized.queryResult), datasetId);\n  }\n\n  return normalized;\n}\n\nexport function resolveArrowTable(\n  input: DeckDatasetInput,\n): arrow.Table | undefined {\n  return input.arrowTable ?? getArrowTableFromQueryResult(input.queryResult);\n}\n\nexport function normalizeDatasets(\n  props: Pick<\n    DeckMapProps,\n    | 'datasets'\n    | 'sqlQuery'\n    | 'arrowTable'\n    | 'queryResult'\n    | 'geometryColumn'\n    | 'geometryEncodingHint'\n  >,\n): Record<string, DeckDatasetInput> {\n  if (props.datasets) {\n    const entries = Object.entries(props.datasets).map(([datasetId, input]) => [\n      datasetId,\n      normalizeDatasetEntry(datasetId, input),\n    ]);\n    return Object.fromEntries(entries);\n  }\n\n  const singleInput: DeckDatasetInput = {\n    sqlQuery: props.sqlQuery,\n    arrowTable: props.arrowTable,\n    queryResult: props.queryResult,\n    geometryColumn: props.geometryColumn,\n    geometryEncodingHint: props.geometryEncodingHint,\n  };\n\n  const definedInputs = countDefinedInputs(singleInput);\n  if (definedInputs === 0) {\n    throw new Error(\n      'DeckMap requires either datasets or one of sqlQuery, arrowTable, or queryResult.',\n    );\n  }\n\n  return {\n    default: normalizeDatasetEntry('default', singleInput),\n  };\n}\n"]}