@sqlrooms/deck 0.29.0-rc.10

package/dist/mapFit.d.ts

@@ -0,0 +1,62 @@
+import { type RefObject } from 'react';
+import { type DeckMapConfig, type DeckMapDatasetSource, type DeckMapFitToDataConfig } from './mapConfig';
+import { type DeckDatasetInput, type DeckJsonMapHandle } from './types';
+/**
+ * Resolves the effective fit-to-data configuration for a Deck map.
+ *
+ * Explicit coordinate or geometry fields take precedence. Missing geometry and
+ * H3 fields are inferred from dataset metadata, interaction configuration, and
+ * layer bindings without consulting host-specific state.
+ *
+ * @param config - Durable Deck map configuration to inspect.
+ * @returns A normalized fit configuration, or `null` when fitting is disabled.
+ */
+export declare function resolveDeckMapFitToData(config: DeckMapConfig | null | undefined): DeckMapFitToDataConfig | null;
+/**
+ * Converts a host-resolved Deck dataset input into a queryable map source.
+ *
+ * Prepared Arrow datasets intentionally return `null` because fitting them
+ * requires host-provided bounds rather than a DuckDB source query.
+ *
+ * @param dataset - Dataset after the host data adapter has resolved its source.
+ * @returns A SQL or table source suitable for bounds queries, or `null`.
+ */
+export declare function getDeckMapDatasetSource(dataset: DeckDatasetInput | undefined): DeckMapDatasetSource | null;
+/**
+ * Builds the DuckDB query used to calculate a map dataset's geographic extent.
+ *
+ * The query strategy follows the normalized fit configuration: H3 cells,
+ * geometry values, explicit longitude/latitude columns, or conventional
+ * `Longitude`/`Latitude` column names as a final fallback.
+ *
+ * @param options - Resolved dataset source and normalized fit configuration.
+ * @returns SQL that yields min/max longitude and latitude, or `null` when the
+ * configuration cannot identify a target dataset.
+ */
+export declare function createDeckMapBoundsQuery(options: {
+    source: DeckMapDatasetSource;
+    fitToData: DeckMapFitToDataConfig;
+}): string | null;
+/**
+ * Executes host-neutral fit-to-data requests for a Deck map surface.
+ *
+ * The controller observes the map container, de-duplicates manual requests,
+ * optionally auto-fits when the source changes, loads H3 support when needed,
+ * queries dataset bounds, and updates the imperative Deck map view. Hosts are
+ * responsible only for resolving their dataset source and request version.
+ *
+ * @param options - Map identity, resolved fit inputs, view refs, request state,
+ * and optional success and error callbacks.
+ */
+export declare function useDeckMapFitController(options: {
+    scopeId: string;
+    fitToData: DeckMapFitToDataConfig | null;
+    source: DeckMapDatasetSource | null;
+    container: HTMLElement | null;
+    deckMapRef: RefObject<DeckJsonMapHandle | null>;
+    requestVersion: number;
+    autoFit?: boolean;
+    onSuccess?: () => void;
+    onError?: (error: Error) => void;
+}): void;
+//# sourceMappingURL=mapFit.d.ts.map

package/dist/mapFit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapFit.d.ts","sourceRoot":"","sources":["../src/mapFit.ts"],"names":[],"mappings":"AAOA,OAAO,EAA+B,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAKnE,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,GACvC,sBAAsB,GAAG,IAAI,CAqC/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,gBAAgB,GAAG,SAAS,GACpC,oBAAoB,GAAG,IAAI,CAU7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,MAAM,EAAE,oBAAoB,CAAC;IAC7B,SAAS,EAAE,sBAAsB,CAAC;CACnC,iBA0EA;AAmFD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACzC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACpC,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAChD,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC,QA6HA"}

package/dist/mapFit.js

@@ -0,0 +1,325 @@
+import { WebMercatorViewport } from '@deck.gl/core';
+import { escapeId, getColValAsNumber, useStoreWithDuckDb, } from '@sqlrooms/duckdb';
+import { useEffect, useMemo, useState } from 'react';
+import { DeckTableDatasetInvalidTableNameError, createDeckTableDatasetSql, } from './datasets/tableDatasetSql';
+import { isDeckMapSqlDatasetSource, } from './mapConfig';
+import { isSqlDatasetInput, isTableDatasetInput, } from './types';
+/**
+ * Resolves the effective fit-to-data configuration for a Deck map.
+ *
+ * Explicit coordinate or geometry fields take precedence. Missing geometry and
+ * H3 fields are inferred from dataset metadata, interaction configuration, and
+ * layer bindings without consulting host-specific state.
+ *
+ * @param config - Durable Deck map configuration to inspect.
+ * @returns A normalized fit configuration, or `null` when fitting is disabled.
+ */
+export function resolveDeckMapFitToData(config) {
+    if (!config)
+        return null;
+    const fitToData = config.fitToData;
+    if (!fitToData?.dataset)
+        return null;
+    if (fitToData.longitudeColumn && fitToData.latitudeColumn)
+        return fitToData;
+    const dataset = config.datasets[fitToData.dataset];
+    const geometryColumn = fitToData.geometryColumn ?? dataset?.geometryColumn;
+    if (geometryColumn)
+        return { ...fitToData, geometryColumn };
+    if (config.interaction?.longitudeColumn &&
+        config.interaction.latitudeColumn) {
+        return {
+            ...fitToData,
+            longitudeColumn: config.interaction.longitudeColumn,
+            latitudeColumn: config.interaction.latitudeColumn,
+        };
+    }
+    const spec = typeof config.spec === 'string'
+        ? undefined
+        : config.spec;
+    const layers = Array.isArray(spec?.layers) ? spec.layers : [];
+    for (const layer of layers) {
+        if (!layer || typeof layer !== 'object')
+            continue;
+        const binding = layer._sqlroomsBinding;
+        if (binding?.dataset === fitToData.dataset && binding.hexagonColumn) {
+            return { ...fitToData, h3Column: String(binding.hexagonColumn) };
+        }
+    }
+    return fitToData;
+}
+/**
+ * Converts a host-resolved Deck dataset input into a queryable map source.
+ *
+ * Prepared Arrow datasets intentionally return `null` because fitting them
+ * requires host-provided bounds rather than a DuckDB source query.
+ *
+ * @param dataset - Dataset after the host data adapter has resolved its source.
+ * @returns A SQL or table source suitable for bounds queries, or `null`.
+ */
+export function getDeckMapDatasetSource(dataset) {
+    if (!dataset)
+        return null;
+    if (isSqlDatasetInput(dataset))
+        return { sqlQuery: dataset.sqlQuery };
+    if (isTableDatasetInput(dataset)) {
+        return {
+            tableName: dataset.tableName,
+            transformSql: dataset.transformSql,
+        };
+    }
+    return null;
+}
+/**
+ * Builds the DuckDB query used to calculate a map dataset's geographic extent.
+ *
+ * The query strategy follows the normalized fit configuration: H3 cells,
+ * geometry values, explicit longitude/latitude columns, or conventional
+ * `Longitude`/`Latitude` column names as a final fallback.
+ *
+ * @param options - Resolved dataset source and normalized fit configuration.
+ * @returns SQL that yields min/max longitude and latitude, or `null` when the
+ * configuration cannot identify a target dataset.
+ */
+export function createDeckMapBoundsQuery(options) {
+    const { source, fitToData } = options;
+    if (!fitToData.dataset)
+        return null;
+    const baseSourceSql = isDeckMapSqlDatasetSource(source)
+        ? `SELECT * FROM (${source.sqlQuery.trim().replace(/(?:\s*;+\s*)+$/, '')}) AS "__sqlrooms_dashboard_map_source"`
+        : createDeckMapBoundsTableSourceSql(source);
+    if (fitToData.h3Column) {
+        const column = escapeId(fitToData.h3Column);
+        return `
+      SELECT
+        MIN(h3_cell_to_lng(${column})) AS min_longitude,
+        MIN(h3_cell_to_lat(${column})) AS min_latitude,
+        MAX(h3_cell_to_lng(${column})) AS max_longitude,
+        MAX(h3_cell_to_lat(${column})) AS max_latitude
+      FROM (${baseSourceSql}) AS "__sqlrooms_dashboard_map_h3"
+      WHERE ${column} IS NOT NULL
+    `;
+    }
+    if (fitToData.geometryColumn) {
+        const column = escapeId(fitToData.geometryColumn);
+        const sourceSql = isDeckMapSqlDatasetSource(source)
+            ? source.sqlQuery
+            : (source.transformSql ?? '');
+        const geometry = sourceSql.toLowerCase().includes('st_aswkb')
+            ? `ST_GeomFromWKB(${column})`
+            : `${column}::GEOMETRY`;
+        return `
+      SELECT
+        ST_XMin(extent) AS min_longitude,
+        ST_YMin(extent) AS min_latitude,
+        ST_XMax(extent) AS max_longitude,
+        ST_YMax(extent) AS max_latitude
+      FROM (
+        SELECT ST_Extent_Agg(${geometry}) AS extent
+        FROM (${baseSourceSql}) AS "__sqlrooms_dashboard_map_geom"
+        WHERE ${column} IS NOT NULL
+      ) AS "__sqlrooms_dashboard_map_extent"
+      WHERE extent IS NOT NULL
+    `;
+    }
+    if (fitToData.longitudeColumn && fitToData.latitudeColumn) {
+        const longitude = escapeId(fitToData.longitudeColumn);
+        const latitude = escapeId(fitToData.latitudeColumn);
+        return `
+      SELECT
+        ST_XMin(extent) AS min_longitude,
+        ST_YMin(extent) AS min_latitude,
+        ST_XMax(extent) AS max_longitude,
+        ST_YMax(extent) AS max_latitude
+      FROM (
+        SELECT ST_Extent_Agg(ST_Point(${longitude}, ${latitude})) AS extent
+        FROM (${baseSourceSql}) AS "__sqlrooms_dashboard_map_points"
+        WHERE ${longitude} IS NOT NULL AND ${latitude} IS NOT NULL
+      ) AS "__sqlrooms_dashboard_map_extent"
+      WHERE extent IS NOT NULL
+    `;
+    }
+    return `
+    SELECT
+      ST_XMin(extent) AS min_longitude,
+      ST_YMin(extent) AS min_latitude,
+      ST_XMax(extent) AS max_longitude,
+      ST_YMax(extent) AS max_latitude
+    FROM (
+      SELECT ST_Extent_Agg(ST_Point(Longitude, Latitude)) AS extent
+      FROM (${baseSourceSql}) AS "__sqlrooms_dashboard_map_points"
+      WHERE Longitude IS NOT NULL AND Latitude IS NOT NULL
+    ) AS "__sqlrooms_dashboard_map_extent"
+    WHERE extent IS NOT NULL
+  `;
+}
+function createDeckMapBoundsTableSourceSql(source) {
+    try {
+        return createDeckTableDatasetSql(source);
+    }
+    catch (error) {
+        if (error instanceof DeckTableDatasetInvalidTableNameError) {
+            throw new Error('Deck map fit-to-data requires a valid table source.');
+        }
+        throw error;
+    }
+}
+function readDeckMapBounds(result) {
+    const minLongitude = getColValAsNumber(result, 'min_longitude');
+    const minLatitude = getColValAsNumber(result, 'min_latitude');
+    const maxLongitude = getColValAsNumber(result, 'max_longitude');
+    const maxLatitude = getColValAsNumber(result, 'max_latitude');
+    if (!Number.isFinite(minLongitude) ||
+        !Number.isFinite(minLatitude) ||
+        !Number.isFinite(maxLongitude) ||
+        !Number.isFinite(maxLatitude)) {
+        return null;
+    }
+    return [
+        [
+            minLongitude === maxLongitude ? minLongitude - 0.01 : minLongitude,
+            minLatitude === maxLatitude ? minLatitude - 0.01 : minLatitude,
+        ],
+        [
+            minLongitude === maxLongitude ? maxLongitude + 0.01 : maxLongitude,
+            minLatitude === maxLatitude ? maxLatitude + 0.01 : maxLatitude,
+        ],
+    ];
+}
+function fitDeckMapView(options) {
+    const { bounds, width, height, padding = 40, maxZoom = 18 } = options;
+    const fitted = new WebMercatorViewport({
+        width: Math.max(width, 1),
+        height: Math.max(height, 1),
+    }).fitBounds([
+        [bounds[0][0], bounds[0][1]],
+        [bounds[1][0], bounds[1][1]],
+    ], { padding });
+    return {
+        longitude: fitted.longitude,
+        latitude: fitted.latitude,
+        zoom: Math.min(fitted.zoom, maxZoom),
+    };
+}
+function createInitialFitState(key, requestVersion) {
+    return {
+        key,
+        didAutoFit: false,
+        handledRequestVersion: requestVersion,
+    };
+}
+/**
+ * Executes host-neutral fit-to-data requests for a Deck map surface.
+ *
+ * The controller observes the map container, de-duplicates manual requests,
+ * optionally auto-fits when the source changes, loads H3 support when needed,
+ * queries dataset bounds, and updates the imperative Deck map view. Hosts are
+ * responsible only for resolving their dataset source and request version.
+ *
+ * @param options - Map identity, resolved fit inputs, view refs, request state,
+ * and optional success and error callbacks.
+ */
+export function useDeckMapFitController(options) {
+    const { scopeId, fitToData, source, container, deckMapRef, requestVersion, autoFit = false, onSuccess, onError, } = options;
+    const executeSql = useStoreWithDuckDb((state) => state.db.executeSql);
+    const [containerSize, setContainerSize] = useState({ width: 0, height: 0 });
+    const fitKey = useMemo(() => JSON.stringify({ scopeId, fitToData, source }), [fitToData, scopeId, source]);
+    const [fitState, setFitState] = useState(() => createInitialFitState(fitKey, requestVersion));
+    // A source change resets auto-fit state, but must not mark a newer manual
+    // request as handled before the effect observes it.
+    const activeFitState = fitState.key === fitKey
+        ? fitState
+        : createInitialFitState(fitKey, fitState.handledRequestVersion);
+    useEffect(() => {
+        if (!container)
+            return;
+        const updateSize = () => setContainerSize({
+            width: container.clientWidth,
+            height: container.clientHeight,
+        });
+        updateSize();
+        if (typeof ResizeObserver === 'undefined')
+            return;
+        const observer = new ResizeObserver(updateSize);
+        observer.observe(container);
+        return () => observer.disconnect();
+    }, [container]);
+    useEffect(() => {
+        const hasManualRequest = requestVersion > activeFitState.handledRequestVersion;
+        if (!fitToData ||
+            !source ||
+            containerSize.width <= 0 ||
+            containerSize.height <= 0 ||
+            (!hasManualRequest && (!autoFit || activeFitState.didAutoFit))) {
+            return;
+        }
+        let cancelled = false;
+        const markHandled = () => setFitState({
+            key: fitKey,
+            didAutoFit: true,
+            handledRequestVersion: requestVersion,
+        });
+        void (async () => {
+            try {
+                if (fitToData.h3Column) {
+                    try {
+                        await executeSql('INSTALL h3 FROM community');
+                    }
+                    catch {
+                        // The extension may already be installed.
+                    }
+                    await executeSql('LOAD h3');
+                }
+                const query = createDeckMapBoundsQuery({ source, fitToData });
+                if (!query) {
+                    markHandled();
+                    onSuccess?.();
+                    return;
+                }
+                const handle = await executeSql(query);
+                const result = handle ? await handle : null;
+                if (cancelled || !result)
+                    return;
+                const bounds = readDeckMapBounds(result);
+                if (bounds) {
+                    deckMapRef.current?.jumpTo(fitDeckMapView({
+                        bounds,
+                        width: containerSize.width,
+                        height: containerSize.height,
+                        padding: fitToData.padding,
+                        maxZoom: fitToData.maxZoom,
+                    }));
+                }
+                markHandled();
+                onSuccess?.();
+            }
+            catch (error) {
+                if (cancelled)
+                    return;
+                const fitError = error instanceof Error
+                    ? error
+                    : new Error('Unable to fit map view to data.');
+                onError?.(fitError);
+                markHandled();
+            }
+        })();
+        return () => {
+            cancelled = true;
+        };
+    }, [
+        activeFitState.didAutoFit,
+        activeFitState.handledRequestVersion,
+        autoFit,
+        containerSize.height,
+        containerSize.width,
+        deckMapRef,
+        executeSql,
+        fitKey,
+        fitToData,
+        onError,
+        onSuccess,
+        requestVersion,
+        source,
+    ]);
+}
+//# sourceMappingURL=mapFit.js.map

package/dist/mapFit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapFit.js","sourceRoot":"","sources":["../src/mapFit.ts"],"names":[],"mappings":"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","sourcesContent":["import {WebMercatorViewport} from '@deck.gl/core';\nimport {\n  escapeId,\n  getColValAsNumber,\n  useStoreWithDuckDb,\n} from '@sqlrooms/duckdb';\nimport type {Table as ArrowTable} from 'apache-arrow';\nimport {useEffect, useMemo, useState, type RefObject} from 'react';\nimport {\n  DeckTableDatasetInvalidTableNameError,\n  createDeckTableDatasetSql,\n} from './datasets/tableDatasetSql';\nimport {\n  isDeckMapSqlDatasetSource,\n  type DeckMapConfig,\n  type DeckMapDatasetSource,\n  type DeckMapFitToDataConfig,\n} from './mapConfig';\nimport {\n  isSqlDatasetInput,\n  isTableDatasetInput,\n  type DeckDatasetInput,\n  type DeckJsonMapHandle,\n} from './types';\n\n/**\n * Resolves the effective fit-to-data configuration for a Deck map.\n *\n * Explicit coordinate or geometry fields take precedence. Missing geometry and\n * H3 fields are inferred from dataset metadata, interaction configuration, and\n * layer bindings without consulting host-specific state.\n *\n * @param config - Durable Deck map configuration to inspect.\n * @returns A normalized fit configuration, or `null` when fitting is disabled.\n */\nexport function resolveDeckMapFitToData(\n  config: DeckMapConfig | null | undefined,\n): DeckMapFitToDataConfig | null {\n  if (!config) return null;\n  const fitToData = config.fitToData;\n  if (!fitToData?.dataset) return null;\n  if (fitToData.longitudeColumn && fitToData.latitudeColumn) return fitToData;\n\n  const dataset = config.datasets[fitToData.dataset];\n  const geometryColumn = fitToData.geometryColumn ?? dataset?.geometryColumn;\n  if (geometryColumn) return {...fitToData, geometryColumn};\n\n  if (\n    config.interaction?.longitudeColumn &&\n    config.interaction.latitudeColumn\n  ) {\n    return {\n      ...fitToData,\n      longitudeColumn: config.interaction.longitudeColumn,\n      latitudeColumn: config.interaction.latitudeColumn,\n    };\n  }\n\n  const spec =\n    typeof config.spec === 'string'\n      ? undefined\n      : (config.spec as Record<string, unknown>);\n  const layers = Array.isArray(spec?.layers) ? spec.layers : [];\n  for (const layer of layers) {\n    if (!layer || typeof layer !== 'object') continue;\n    const binding = (layer as Record<string, unknown>)._sqlroomsBinding as\n      | Record<string, unknown>\n      | undefined;\n    if (binding?.dataset === fitToData.dataset && binding.hexagonColumn) {\n      return {...fitToData, h3Column: String(binding.hexagonColumn)};\n    }\n  }\n\n  return fitToData;\n}\n\n/**\n * Converts a host-resolved Deck dataset input into a queryable map source.\n *\n * Prepared Arrow datasets intentionally return `null` because fitting them\n * requires host-provided bounds rather than a DuckDB source query.\n *\n * @param dataset - Dataset after the host data adapter has resolved its source.\n * @returns A SQL or table source suitable for bounds queries, or `null`.\n */\nexport function getDeckMapDatasetSource(\n  dataset: DeckDatasetInput | undefined,\n): DeckMapDatasetSource | null {\n  if (!dataset) return null;\n  if (isSqlDatasetInput(dataset)) return {sqlQuery: dataset.sqlQuery};\n  if (isTableDatasetInput(dataset)) {\n    return {\n      tableName: dataset.tableName,\n      transformSql: dataset.transformSql,\n    };\n  }\n  return null;\n}\n\n/**\n * Builds the DuckDB query used to calculate a map dataset's geographic extent.\n *\n * The query strategy follows the normalized fit configuration: H3 cells,\n * geometry values, explicit longitude/latitude columns, or conventional\n * `Longitude`/`Latitude` column names as a final fallback.\n *\n * @param options - Resolved dataset source and normalized fit configuration.\n * @returns SQL that yields min/max longitude and latitude, or `null` when the\n * configuration cannot identify a target dataset.\n */\nexport function createDeckMapBoundsQuery(options: {\n  source: DeckMapDatasetSource;\n  fitToData: DeckMapFitToDataConfig;\n}) {\n  const {source, fitToData} = options;\n  if (!fitToData.dataset) return null;\n  const baseSourceSql = isDeckMapSqlDatasetSource(source)\n    ? `SELECT * FROM (${source.sqlQuery.trim().replace(/(?:\\s*;+\\s*)+$/, '')}) AS \"__sqlrooms_dashboard_map_source\"`\n    : createDeckMapBoundsTableSourceSql(source);\n\n  if (fitToData.h3Column) {\n    const column = escapeId(fitToData.h3Column);\n    return `\n      SELECT\n        MIN(h3_cell_to_lng(${column})) AS min_longitude,\n        MIN(h3_cell_to_lat(${column})) AS min_latitude,\n        MAX(h3_cell_to_lng(${column})) AS max_longitude,\n        MAX(h3_cell_to_lat(${column})) AS max_latitude\n      FROM (${baseSourceSql}) AS \"__sqlrooms_dashboard_map_h3\"\n      WHERE ${column} IS NOT NULL\n    `;\n  }\n\n  if (fitToData.geometryColumn) {\n    const column = escapeId(fitToData.geometryColumn);\n    const sourceSql = isDeckMapSqlDatasetSource(source)\n      ? source.sqlQuery\n      : (source.transformSql ?? '');\n    const geometry = sourceSql.toLowerCase().includes('st_aswkb')\n      ? `ST_GeomFromWKB(${column})`\n      : `${column}::GEOMETRY`;\n    return `\n      SELECT\n        ST_XMin(extent) AS min_longitude,\n        ST_YMin(extent) AS min_latitude,\n        ST_XMax(extent) AS max_longitude,\n        ST_YMax(extent) AS max_latitude\n      FROM (\n        SELECT ST_Extent_Agg(${geometry}) AS extent\n        FROM (${baseSourceSql}) AS \"__sqlrooms_dashboard_map_geom\"\n        WHERE ${column} IS NOT NULL\n      ) AS \"__sqlrooms_dashboard_map_extent\"\n      WHERE extent IS NOT NULL\n    `;\n  }\n\n  if (fitToData.longitudeColumn && fitToData.latitudeColumn) {\n    const longitude = escapeId(fitToData.longitudeColumn);\n    const latitude = escapeId(fitToData.latitudeColumn);\n    return `\n      SELECT\n        ST_XMin(extent) AS min_longitude,\n        ST_YMin(extent) AS min_latitude,\n        ST_XMax(extent) AS max_longitude,\n        ST_YMax(extent) AS max_latitude\n      FROM (\n        SELECT ST_Extent_Agg(ST_Point(${longitude}, ${latitude})) AS extent\n        FROM (${baseSourceSql}) AS \"__sqlrooms_dashboard_map_points\"\n        WHERE ${longitude} IS NOT NULL AND ${latitude} IS NOT NULL\n      ) AS \"__sqlrooms_dashboard_map_extent\"\n      WHERE extent IS NOT NULL\n    `;\n  }\n\n  return `\n    SELECT\n      ST_XMin(extent) AS min_longitude,\n      ST_YMin(extent) AS min_latitude,\n      ST_XMax(extent) AS max_longitude,\n      ST_YMax(extent) AS max_latitude\n    FROM (\n      SELECT ST_Extent_Agg(ST_Point(Longitude, Latitude)) AS extent\n      FROM (${baseSourceSql}) AS \"__sqlrooms_dashboard_map_points\"\n      WHERE Longitude IS NOT NULL AND Latitude IS NOT NULL\n    ) AS \"__sqlrooms_dashboard_map_extent\"\n    WHERE extent IS NOT NULL\n  `;\n}\n\nfunction createDeckMapBoundsTableSourceSql(\n  source: Exclude<DeckMapDatasetSource, {sqlQuery: string}>,\n) {\n  try {\n    return createDeckTableDatasetSql(source);\n  } catch (error) {\n    if (error instanceof DeckTableDatasetInvalidTableNameError) {\n      throw new Error('Deck map fit-to-data requires a valid table source.');\n    }\n    throw error;\n  }\n}\n\nfunction readDeckMapBounds(result: ArrowTable) {\n  const minLongitude = getColValAsNumber(result, 'min_longitude');\n  const minLatitude = getColValAsNumber(result, 'min_latitude');\n  const maxLongitude = getColValAsNumber(result, 'max_longitude');\n  const maxLatitude = getColValAsNumber(result, 'max_latitude');\n  if (\n    !Number.isFinite(minLongitude) ||\n    !Number.isFinite(minLatitude) ||\n    !Number.isFinite(maxLongitude) ||\n    !Number.isFinite(maxLatitude)\n  ) {\n    return null;\n  }\n  return [\n    [\n      minLongitude === maxLongitude ? minLongitude - 0.01 : minLongitude,\n      minLatitude === maxLatitude ? minLatitude - 0.01 : minLatitude,\n    ],\n    [\n      minLongitude === maxLongitude ? maxLongitude + 0.01 : maxLongitude,\n      minLatitude === maxLatitude ? maxLatitude + 0.01 : maxLatitude,\n    ],\n  ] as const;\n}\n\nfunction fitDeckMapView(options: {\n  bounds: readonly [readonly [number, number], readonly [number, number]];\n  width: number;\n  height: number;\n  padding?: number;\n  maxZoom?: number;\n}) {\n  const {bounds, width, height, padding = 40, maxZoom = 18} = options;\n  const fitted = new WebMercatorViewport({\n    width: Math.max(width, 1),\n    height: Math.max(height, 1),\n  }).fitBounds(\n    [\n      [bounds[0][0], bounds[0][1]],\n      [bounds[1][0], bounds[1][1]],\n    ],\n    {padding},\n  ) as WebMercatorViewport & {\n    longitude: number;\n    latitude: number;\n    zoom: number;\n  };\n  return {\n    longitude: fitted.longitude,\n    latitude: fitted.latitude,\n    zoom: Math.min(fitted.zoom, maxZoom),\n  };\n}\n\ntype DeckMapFitState = {\n  key: string;\n  didAutoFit: boolean;\n  handledRequestVersion: number;\n};\n\nfunction createInitialFitState(key: string, requestVersion: number) {\n  return {\n    key,\n    didAutoFit: false,\n    handledRequestVersion: requestVersion,\n  };\n}\n\n/**\n * Executes host-neutral fit-to-data requests for a Deck map surface.\n *\n * The controller observes the map container, de-duplicates manual requests,\n * optionally auto-fits when the source changes, loads H3 support when needed,\n * queries dataset bounds, and updates the imperative Deck map view. Hosts are\n * responsible only for resolving their dataset source and request version.\n *\n * @param options - Map identity, resolved fit inputs, view refs, request state,\n * and optional success and error callbacks.\n */\nexport function useDeckMapFitController(options: {\n  scopeId: string;\n  fitToData: DeckMapFitToDataConfig | null;\n  source: DeckMapDatasetSource | null;\n  container: HTMLElement | null;\n  deckMapRef: RefObject<DeckJsonMapHandle | null>;\n  requestVersion: number;\n  autoFit?: boolean;\n  onSuccess?: () => void;\n  onError?: (error: Error) => void;\n}) {\n  const {\n    scopeId,\n    fitToData,\n    source,\n    container,\n    deckMapRef,\n    requestVersion,\n    autoFit = false,\n    onSuccess,\n    onError,\n  } = options;\n  const executeSql = useStoreWithDuckDb((state) => state.db.executeSql);\n  const [containerSize, setContainerSize] = useState({width: 0, height: 0});\n  const fitKey = useMemo(\n    () => JSON.stringify({scopeId, fitToData, source}),\n    [fitToData, scopeId, source],\n  );\n  const [fitState, setFitState] = useState<DeckMapFitState>(() =>\n    createInitialFitState(fitKey, requestVersion),\n  );\n  // A source change resets auto-fit state, but must not mark a newer manual\n  // request as handled before the effect observes it.\n  const activeFitState =\n    fitState.key === fitKey\n      ? fitState\n      : createInitialFitState(fitKey, fitState.handledRequestVersion);\n\n  useEffect(() => {\n    if (!container) return;\n    const updateSize = () =>\n      setContainerSize({\n        width: container.clientWidth,\n        height: container.clientHeight,\n      });\n    updateSize();\n    if (typeof ResizeObserver === 'undefined') return;\n    const observer = new ResizeObserver(updateSize);\n    observer.observe(container);\n    return () => observer.disconnect();\n  }, [container]);\n\n  useEffect(() => {\n    const hasManualRequest =\n      requestVersion > activeFitState.handledRequestVersion;\n    if (\n      !fitToData ||\n      !source ||\n      containerSize.width <= 0 ||\n      containerSize.height <= 0 ||\n      (!hasManualRequest && (!autoFit || activeFitState.didAutoFit))\n    ) {\n      return;\n    }\n\n    let cancelled = false;\n    const markHandled = () =>\n      setFitState({\n        key: fitKey,\n        didAutoFit: true,\n        handledRequestVersion: requestVersion,\n      });\n\n    void (async () => {\n      try {\n        if (fitToData.h3Column) {\n          try {\n            await executeSql('INSTALL h3 FROM community');\n          } catch {\n            // The extension may already be installed.\n          }\n          await executeSql('LOAD h3');\n        }\n        const query = createDeckMapBoundsQuery({source, fitToData});\n        if (!query) {\n          markHandled();\n          onSuccess?.();\n          return;\n        }\n        const handle = await executeSql(query);\n        const result = handle ? await handle : null;\n        if (cancelled || !result) return;\n        const bounds = readDeckMapBounds(result);\n        if (bounds) {\n          deckMapRef.current?.jumpTo(\n            fitDeckMapView({\n              bounds,\n              width: containerSize.width,\n              height: containerSize.height,\n              padding: fitToData.padding,\n              maxZoom: fitToData.maxZoom,\n            }),\n          );\n        }\n        markHandled();\n        onSuccess?.();\n      } catch (error) {\n        if (cancelled) return;\n        const fitError =\n          error instanceof Error\n            ? error\n            : new Error('Unable to fit map view to data.');\n        onError?.(fitError);\n        markHandled();\n      }\n    })();\n\n    return () => {\n      cancelled = true;\n    };\n  }, [\n    activeFitState.didAutoFit,\n    activeFitState.handledRequestVersion,\n    autoFit,\n    containerSize.height,\n    containerSize.width,\n    deckMapRef,\n    executeSql,\n    fitKey,\n    fitToData,\n    onError,\n    onSuccess,\n    requestVersion,\n    source,\n  ]);\n}\n"]}

package/dist/mapLayerConfigUtils.d.ts

@@ -0,0 +1,54 @@
+import type { ColorScaleConfig, ColorScaleScheme } from '@sqlrooms/color-scales';
+import type { DeckMapConfig } from './mapConfig';
+import type { DeckAutoLayerType } from './types';
+export type DeckMapLayerRecord = Record<string, unknown>;
+export type DeckMapLayerColorScaleFunction = ColorScaleConfig & {
+    '@@function': 'colorScale';
+};
+export type DeckMapLayerColorAccessor = 'getFillColor' | 'getLineColor' | 'getColor' | 'getSourceColor' | 'getTargetColor';
+export declare const DECK_MAP_LAYER_TYPE_OPTIONS: ReadonlyArray<{
+    value: DeckAutoLayerType | 'GeoArrowSolidPolygonLayer';
+    label: string;
+}>;
+export declare const DECK_MAP_COLOR_ACCESSOR_OPTIONS: ReadonlyArray<{
+    value: DeckMapLayerColorAccessor;
+    label: string;
+}>;
+export declare const DECK_MAP_COLOR_SCALE_TYPE_OPTIONS: ReadonlyArray<{
+    value: ColorScaleConfig['type'];
+    label: string;
+    defaultScheme: ColorScaleScheme;
+}>;
+export declare function getDeckMapLayerRecords(config: DeckMapConfig): DeckMapLayerRecord[];
+export declare function getDeckMapLayerDatasetId(layer: DeckMapLayerRecord | undefined): string | undefined;
+export declare function usesGeometryColumnSetting(layerType: unknown): boolean;
+export declare function usesH3ColumnSetting(layerType: unknown): boolean;
+export declare function usesArcColumnSetting(layerType: unknown): boolean;
+export declare function usesRadiusSetting(layerType: unknown): boolean;
+export declare function usesColumnRadiusSetting(layerType: unknown): boolean;
+export declare function usesTripsSettings(layerType: unknown): boolean;
+export declare function usesExtrusionSettings(layerType: unknown): boolean;
+export declare function getDeckMapColorAccessorOptions(layerType: unknown): typeof DECK_MAP_COLOR_ACCESSOR_OPTIONS;
+export declare function updateDeckMapLayer(config: DeckMapConfig, layerIndex: number, updater: (layer: DeckMapLayerRecord) => DeckMapLayerRecord): DeckMapConfig;
+export declare function setDeckMapLayerType(config: DeckMapConfig, layerIndex: number, layerType: string): DeckMapConfig;
+export declare function setDeckMapLayerGeometryColumn(config: DeckMapConfig, layerIndex: number, geometryColumn: string): DeckMapConfig;
+export declare function setDeckMapLayerHexagonColumn(config: DeckMapConfig, layerIndex: number, hexagonColumn: string): DeckMapConfig;
+export declare function setDeckMapLayerArcColumns(config: DeckMapConfig, layerIndex: number, columns: {
+    sourceGeometryColumn?: string;
+    targetGeometryColumn?: string;
+    sourceLatitudeColumn?: string;
+    sourceLongitudeColumn?: string;
+    targetLatitudeColumn?: string;
+    targetLongitudeColumn?: string;
+}): DeckMapConfig;
+export declare function setDeckMapLayerTimestampColumn(config: DeckMapConfig, layerIndex: number, timestampColumn: string): DeckMapConfig;
+export declare function getDeckMapLayerColorScale(layer: DeckMapLayerRecord | undefined, accessor: DeckMapLayerColorAccessor): DeckMapLayerColorScaleFunction | undefined;
+export declare function setDeckMapLayerColorScale(config: DeckMapConfig, layerIndex: number, accessor: DeckMapLayerColorAccessor, colorScale: DeckMapLayerColorScaleFunction): DeckMapConfig;
+export declare function clearDeckMapLayerColorScale(config: DeckMapConfig, layerIndex: number, accessor: DeckMapLayerColorAccessor): DeckMapConfig;
+export declare function createDeckMapLayerColorScale(options: {
+    field: string;
+    type?: ColorScaleConfig['type'];
+    scheme?: ColorScaleScheme;
+    title?: string;
+}): DeckMapLayerColorScaleFunction;
+//# sourceMappingURL=mapLayerConfigUtils.d.ts.map

package/dist/mapLayerConfigUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapLayerConfigUtils.d.ts","sourceRoot":"","sources":["../src/mapLayerConfigUtils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,gBAAgB,EAAE,gBAAgB,EAAC,MAAM,wBAAwB,CAAC;AAC/E,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,SAAS,CAAC;AAG/C,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEzD,MAAM,MAAM,8BAA8B,GAAG,gBAAgB,GAAG;IAC9D,YAAY,EAAE,YAAY,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,yBAAyB,GACjC,cAAc,GACd,cAAc,GACd,UAAU,GACV,gBAAgB,GAChB,gBAAgB,CAAC;AAErB,eAAO,MAAM,2BAA2B,EAAE,aAAa,CAAC;IACtD,KAAK,EAAE,iBAAiB,GAAG,2BAA2B,CAAC;IACvD,KAAK,EAAE,MAAM,CAAC;CACf,CAWA,CAAC;AAEF,eAAO,MAAM,+BAA+B,EAAE,aAAa,CAAC;IAC1D,KAAK,EAAE,yBAAyB,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;CACf,CAMA,CAAC;AAEF,eAAO,MAAM,iCAAiC,EAAE,aAAa,CAAC;IAC5D,KAAK,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,gBAAgB,CAAC;CACjC,CAMA,CAAC;AAwDF,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,aAAa,GACpB,kBAAkB,EAAE,CAGtB;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,kBAAkB,GAAG,SAAS,GACpC,MAAM,GAAG,SAAS,CAIpB;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,OAAO,WAK3D;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,OAAO,WAIrD;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,OAAO,WAKtD;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,OAAO,WAKnD;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,OAAO,WAKzD;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,OAAO,WAKnD;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,OAAO,WAKvD;AAED,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,OAAO,GACjB,OAAO,+BAA+B,CAsBxC;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,kBAAkB,GACzD,aAAa,CAoBf;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,aAAa,CAiBf;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GACrB,aAAa,CAkCf;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,aAAa,CASf;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;IACP,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,GACA,aAAa,CAQf;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,GACtB,aAAa,CAQf;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,kBAAkB,GAAG,SAAS,EACrC,QAAQ,EAAE,yBAAyB,GAClC,8BAA8B,GAAG,SAAS,CAK5C;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,yBAAyB,EACnC,UAAU,EAAE,8BAA8B,GACzC,aAAa,CAKf;AAMD,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,yBAAyB,GAClC,aAAa,CAUf;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,8BAA8B,CAuEjC"}