@sqlrooms/deck 0.29.0-rc.2 → 0.29.0-rc.3

package/LICENSE.md

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright 2025 SQLRooms Contributors
+
+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

@@ -127,6 +127,75 @@ const spec = createDeckJsonSpecFromDatasets({
 });
 ```
 
+## Mosaic Dashboard Renderer
+
+`@sqlrooms/deck` can contribute a `deck-json-map` panel renderer to
+`@sqlrooms/mosaic` dashboards without making the Mosaic package depend on
+deck.gl or MapLibre. Pass the renderer when creating the Mosaic dashboard
+slice.
+
+```tsx
+import {
+  createDeckMapDashboardPanelConfig,
+  DECK_MAP_DASHBOARD_PANEL_TYPE,
+  deckMapDashboardPanelRenderer,
+} from '@sqlrooms/deck';
+import {
+  createDefaultMosaicDashboardPanelRenderers,
+  createMosaicDashboardSlice,
+  MosaicDashboard,
+} from '@sqlrooms/mosaic';
+
+const dashboardSlice = createMosaicDashboardSlice({
+  panelRenderers: createDefaultMosaicDashboardPanelRenderers({
+    [DECK_MAP_DASHBOARD_PANEL_TYPE]: deckMapDashboardPanelRenderer,
+  }),
+});
+
+function Dashboard() {
+  return <MosaicDashboard dashboardId="geo" />;
+}
+
+const mapPanel = createDeckMapDashboardPanelConfig({
+  title: 'Earthquakes map',
+  spec: {
+    initialViewState: {longitude: -119.5, latitude: 37, zoom: 4.5},
+    layers: [
+      {
+        '@@type': 'GeoArrowScatterplotLayer',
+        id: 'earthquakes',
+        _sqlroomsBinding: {dataset: 'earthquakes'},
+      },
+    ],
+  },
+  datasets: {
+    earthquakes: {
+      source: {
+        sqlQuery:
+          'SELECT *, ST_AsWKB(ST_Point(Longitude, Latitude)) AS geom FROM earthquakes',
+      },
+      geometryColumn: 'geom',
+      geometryEncodingHint: 'wkb',
+    },
+  },
+  fitToData: {
+    dataset: 'earthquakes',
+    longitudeColumn: 'Longitude',
+    latitudeColumn: 'Latitude',
+    padding: 40,
+    maxZoom: 12,
+  },
+});
+```
+
+The dashboard renderer uses `useMosaicClient`, receives Arrow tables directly,
+and passes them to `DeckJsonMap` as Arrow-backed datasets. Dataset sources fall
+back from dataset-level source, to panel source, to the dashboard selected
+table. When `fitToData` is provided, the renderer asks DuckDB Spatial for the
+dataset extent using the declared longitude/latitude columns and fits the
+initial map view once, instead of inferring bounds from the loaded Arrow
+payload in React.
+
 ## Core Concepts
 
 ### `DeckJsonMap`

package/dist/DeckJsonMap.d.ts

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

package/dist/DeckJsonMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeckJsonMap.d.ts","sourceRoot":"","sources":["../src/DeckJsonMap.tsx"],"names":[],"mappings":"AAKA,OAAO,kCAAkC,CAAC;AAW1C,OAAO,KAAK,EAAC,gBAAgB,EAA2B,MAAM,SAAS,CAAC;AA0HxE,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,WAAkB,EAClB,SAAS,EACT,QAAQ,GACT,EAAE,gBAAgB,2CAiIlB"}

package/dist/{DeckMap.js → DeckJsonMap.js}

@@ -1,22 +1,35 @@
-import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { JSONConverter } from '@deck.gl/json';
 import DeckGL from '@deck.gl/react';
-import { cn } from '@sqlrooms/ui';
+import { ColorScaleLegend } from '@sqlrooms/color-scales';
+import { cn, useTheme } from '@sqlrooms/ui';
 import 'maplibre-gl/dist/maplibre-gl.css';
-import { useEffect, useMemo } from 'react';
+import { useEffect, useMemo, useRef } from 'react';
 import Map from 'react-map-gl/maplibre';
+import { DeckJsonMapSpec } from './DeckJsonMapSpec';
 import { normalizeDatasets } from './datasets/normalizeDatasets';
-import { usePreparedDeckDatasets } from './datasets/usePreparedDeckDatasets';
-import { ColorScaleLegend } from './ColorScaleLegend';
+import { usePreparedDatasetStates } from './datasets/usePreparedDatasetStates';
 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';
+import { resolveDatasetId } from './json/layerConfig';
+import { useDeckLayersReadyRedraw } from './useDeckLayersReadyRedraw';
+const DEFAULT_MAP_STYLES = {
+    light: 'https://basemaps.cartocdn.com/gl/positron-gl-style/style.json',
+    dark: 'https://basemaps.cartocdn.com/gl/dark-matter-gl-style/style.json',
+};
 function parseSpec(spec) {
     try {
+        const parsedValue = typeof spec === 'string' ? JSON.parse(spec) : spec;
+        const validatedSpec = DeckJsonMapSpec.safeParse(parsedValue);
+        if (!validatedSpec.success) {
+            return {
+                spec: null,
+                error: new Error(formatSpecValidationError(validatedSpec.error)),
+            };
+        }
         return {
-            spec: typeof spec === 'string' ? JSON.parse(spec) : spec,
+            spec: validatedSpec.data,
             error: null,
         };
     }
@@ -27,6 +40,13 @@ function parseSpec(spec) {
         };
     }
 }
+function formatSpecValidationError(error) {
+    const issues = error.issues.map((issue) => {
+        const path = issue.path.length > 0 ? issue.path.join('.') : 'spec';
+        return `${path}: ${issue.message}`;
+    });
+    return `Invalid DeckJsonMap spec. ${issues.join('; ')}`;
+}
 function extractFallbackDeckProps(spec) {
     if (!spec) {
         return {};
@@ -66,34 +86,17 @@ function filterUnavailableLayers(spec, datasetIds, datasetStates) {
         layers: filteredLayers,
     };
 }
-function renderDatasetStatusOverlay(datasetStates) {
-    const loadingDatasets = Object.entries(datasetStates)
-        .filter(([, state]) => state.status === 'loading')
-        .map(([datasetId]) => datasetId);
+function renderDatasetErrorOverlay(datasetStates) {
     const failedDatasets = Object.entries(datasetStates).filter((entry) => entry[1].status === 'error');
-    if (!loadingDatasets.length && !failedDatasets.length) {
+    if (!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)))] }));
+    return (_jsx("div", { className: "pointer-events-none absolute inset-x-4 top-4 z-10 space-y-2", children: 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,
-    ]);
+export function DeckJsonMap({ spec, datasets, mapStyle, deckProps, mapProps, showLegends = true, className, children, }) {
+    const normalizedDatasets = useMemo(() => normalizeDatasets(datasets), [datasets]);
     const datasetIds = useMemo(() => Object.keys(normalizedDatasets), [normalizedDatasets]);
-    const datasetStates = usePreparedDeckDatasets(normalizedDatasets);
+    const datasetStates = usePreparedDatasetStates(normalizedDatasets);
     const { spec: parsedSpec, error: specError } = useMemo(() => parseSpec(spec), [spec]);
     const availableSpec = useMemo(() => parsedSpec
         ? filterUnavailableLayers(parsedSpec, datasetIds, datasetStates)
@@ -134,24 +137,34 @@ export function DeckMap({ spec, datasets, sqlQuery, arrowTable, queryResult, geo
     const extraDeckProps = (deckProps ?? {});
     const extraMapProps = (mapProps ?? {});
     const hasRenderingError = Boolean(convertedDeckPropsResult.error);
+    const deckRef = useRef(null);
+    const mergedLayers = hasRenderingError
+        ? []
+        : (deckProps?.layers ??
+            convertedDeckProps.layers ??
+            []);
+    useDeckLayersReadyRedraw({
+        deckRef,
+        hasRenderingError,
+        layers: mergedLayers,
+    });
     const mergedDeckProps = {
         ...convertedDeckProps,
         ...extraDeckProps,
-        layers: hasRenderingError
-            ? []
-            : (deckProps?.layers ??
-                convertedDeckProps.layers ??
-                []),
+        layers: mergedLayers,
     };
+    const { resolvedTheme } = useTheme();
     const mergedMapProps = {
         ...extraMapProps,
-        mapStyle: mapStyle ?? mapProps?.mapStyle ?? DEFAULT_MAP_STYLE,
+        mapStyle: mapStyle ?? mapProps?.mapStyle ?? DEFAULT_MAP_STYLES[resolvedTheme],
     };
-    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] }));
+    const legends = useMemo(() => showLegends
+        ? extractColorScaleLegends({
+            spec: availableSpec,
+            datasetIds,
+            datasetStates,
+        })
+        : [], [availableSpec, datasetIds, datasetStates, showLegends]);
+    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, { ref: deckRef, ...mergedDeckProps, children: _jsx(Map, { ...mergedMapProps, children: children }) }), renderDatasetErrorOverlay(datasetStates), !hasRenderingError && showLegends ? (_jsx("div", { className: "pointer-events-none absolute bottom-2 left-2 z-10 max-w-56", children: _jsx(ColorScaleLegend, { legends: legends }) })) : null] }));
 }
-//# sourceMappingURL=DeckMap.js.map
+//# sourceMappingURL=DeckJsonMap.js.map

package/dist/DeckJsonMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeckJsonMap.js","sourceRoot":"","sources":["../src/DeckJsonMap.tsx"],"names":[],"mappings":"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","sourcesContent":["import {JSONConverter} from '@deck.gl/json';\nimport type {DeckGLRef} from '@deck.gl/react';\nimport DeckGL from '@deck.gl/react';\nimport {ColorScaleLegend} from '@sqlrooms/color-scales';\nimport {cn, ResolvedTheme, useTheme} from '@sqlrooms/ui';\nimport 'maplibre-gl/dist/maplibre-gl.css';\nimport {useEffect, useMemo, useRef} from 'react';\nimport Map from 'react-map-gl/maplibre';\nimport {ZodError} from 'zod';\nimport {DeckJsonMapSpec} from './DeckJsonMapSpec';\nimport {normalizeDatasets} from './datasets/normalizeDatasets';\nimport {usePreparedDatasetStates} from './datasets/usePreparedDatasetStates';\nimport {createDeckJsonConfiguration} from './json/createDeckJsonConfiguration';\nimport {extractColorScaleLegends} from './json/extractColorScaleLegends';\nimport {getLayerCompatibility} from './json/layerCompatibility';\nimport {resolveDatasetId} from './json/layerConfig';\nimport type {DeckJsonMapProps, PreparedDeckDatasetState} from './types';\nimport {useDeckLayersReadyRedraw} from './useDeckLayersReadyRedraw';\n\nconst DEFAULT_MAP_STYLES: Record<ResolvedTheme, string> = {\n  light: 'https://basemaps.cartocdn.com/gl/positron-gl-style/style.json',\n  dark: 'https://basemaps.cartocdn.com/gl/dark-matter-gl-style/style.json',\n};\n\nfunction parseSpec(spec: DeckJsonMapProps['spec']) {\n  try {\n    const parsedValue = typeof spec === 'string' ? JSON.parse(spec) : spec;\n    const validatedSpec = DeckJsonMapSpec.safeParse(parsedValue);\n    if (!validatedSpec.success) {\n      return {\n        spec: null,\n        error: new Error(formatSpecValidationError(validatedSpec.error)),\n      };\n    }\n\n    return {\n      spec: validatedSpec.data,\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 formatSpecValidationError(error: ZodError) {\n  const issues = error.issues.map((issue) => {\n    const path = issue.path.length > 0 ? issue.path.join('.') : 'spec';\n    return `${path}: ${issue.message}`;\n  });\n\n  return `Invalid DeckJsonMap spec. ${issues.join('; ')}`;\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 renderDatasetErrorOverlay(\n  datasetStates: Record<string, PreparedDeckDatasetState>,\n) {\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 (!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      {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 DeckJsonMap({\n  spec,\n  datasets,\n  mapStyle,\n  deckProps,\n  mapProps,\n  showLegends = true,\n  className,\n  children,\n}: DeckJsonMapProps) {\n  const normalizedDatasets = useMemo(\n    () => normalizeDatasets(datasets),\n    [datasets],\n  );\n  const datasetIds = useMemo(\n    () => Object.keys(normalizedDatasets),\n    [normalizedDatasets],\n  );\n  const datasetStates = usePreparedDatasetStates(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  const deckRef = useRef<DeckGLRef>(null);\n  const mergedLayers = hasRenderingError\n    ? []\n    : (deckProps?.layers ??\n      (convertedDeckProps.layers as unknown[] | undefined) ??\n      []);\n  useDeckLayersReadyRedraw({\n    deckRef,\n    hasRenderingError,\n    layers: mergedLayers,\n  });\n\n  const mergedDeckProps = {\n    ...convertedDeckProps,\n    ...extraDeckProps,\n    layers: mergedLayers,\n  };\n\n  const {resolvedTheme} = useTheme();\n\n  const mergedMapProps = {\n    ...extraMapProps,\n    mapStyle:\n      mapStyle ?? mapProps?.mapStyle ?? DEFAULT_MAP_STYLES[resolvedTheme],\n  };\n  const legends = useMemo(\n    () =>\n      showLegends\n        ? extractColorScaleLegends({\n            spec: availableSpec,\n            datasetIds,\n            datasetStates,\n          })\n        : [],\n    [availableSpec, datasetIds, datasetStates, showLegends],\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 ref={deckRef} {...(mergedDeckProps as object)}>\n        <Map {...(mergedMapProps as object)}>{children}</Map>\n      </DeckGL>\n\n      {renderDatasetErrorOverlay(datasetStates)}\n      {!hasRenderingError && showLegends ? (\n        <div className=\"pointer-events-none absolute bottom-2 left-2 z-10 max-w-56\">\n          <ColorScaleLegend legends={legends} />\n        </div>\n      ) : null}\n    </div>\n  );\n}\n"]}