@sqlrooms/deck 0.29.0-rc.10

package/dist/mapLayerConfigUtils.js

@@ -0,0 +1,296 @@
+import { isColorScaleFunction } from './json/layerConfig';
+export const DECK_MAP_LAYER_TYPE_OPTIONS = [
+    { value: 'GeoArrowScatterplotLayer', label: 'Point' },
+    { value: 'GeoArrowHeatmapLayer', label: 'Heatmap' },
+    { value: 'GeoArrowColumnLayer', label: 'Column' },
+    { value: 'GeoArrowPathLayer', label: 'Path' },
+    { value: 'GeoArrowPolygonLayer', label: 'Polygon' },
+    { value: 'GeoArrowSolidPolygonLayer', label: 'Solid polygon' },
+    { value: 'GeoArrowArcLayer', label: 'Arc' },
+    { value: 'GeoArrowTripsLayer', label: 'Trips' },
+    { value: 'GeoArrowH3HexagonLayer', label: 'H3 hexagon' },
+    { value: 'GeoJsonLayer', label: 'GeoJSON' },
+];
+export const DECK_MAP_COLOR_ACCESSOR_OPTIONS = [
+    { value: 'getFillColor', label: 'Fill color' },
+    { value: 'getLineColor', label: 'Line color' },
+    { value: 'getColor', label: 'Color' },
+    { value: 'getSourceColor', label: 'Source color' },
+    { value: 'getTargetColor', label: 'Target color' },
+];
+export const DECK_MAP_COLOR_SCALE_TYPE_OPTIONS = [
+    { value: 'sequential', label: 'Sequential', defaultScheme: 'Viridis' },
+    { value: 'diverging', label: 'Diverging', defaultScheme: 'RdBu' },
+    { value: 'quantize', label: 'Quantize', defaultScheme: 'YlOrRd' },
+    { value: 'quantile', label: 'Quantile', defaultScheme: 'YlOrRd' },
+    { value: 'categorical', label: 'Categorical', defaultScheme: 'Tableau10' },
+];
+const GEOMETRY_COLUMN_LAYER_TYPES = new Set([
+    'geoarrowpolygonlayer',
+    'geoarrowsolidpolygonlayer',
+    'geoarrowpathlayer',
+    'geoarrowtripslayer',
+    'geojsonlayer',
+    'polygonlayer',
+    'solidpolygonlayer',
+    'geojson',
+    'polygon',
+    'solid polygon',
+]);
+const H3_LAYER_TYPES = new Set(['geoarrowh3hexagonlayer', 'h3hexagonlayer']);
+const ARC_LAYER_TYPES = new Set(['geoarrowarclayer', 'arclayer']);
+const TRIPS_LAYER_TYPES = new Set([
+    'geoarrowtripslayer',
+    'decktripslayer',
+    'tripslayer',
+]);
+const RADIUS_LAYER_TYPES = new Set([
+    'geoarrowscatterplotlayer',
+    'scatterplotlayer',
+]);
+const COLUMN_RADIUS_LAYER_TYPES = new Set([
+    'geoarrowcolumnlayer',
+    'columnlayer',
+]);
+const EXTRUDABLE_LAYER_TYPES = new Set([
+    'geoarrowh3hexagonlayer',
+    'h3hexagonlayer',
+    'geoarrowcolumnlayer',
+    'columnlayer',
+    'geoarrowpolygonlayer',
+    'polygonlayer',
+    'geoarrowsolidpolygonlayer',
+    'solidpolygonlayer',
+]);
+function isRecord(value) {
+    return Boolean(value && typeof value === 'object' && !Array.isArray(value));
+}
+function getObjectSpec(config) {
+    return isRecord(config.spec) ? config.spec : undefined;
+}
+export function getDeckMapLayerRecords(config) {
+    const layers = getObjectSpec(config)?.layers;
+    return Array.isArray(layers) ? layers.filter(isRecord) : [];
+}
+export function getDeckMapLayerDatasetId(layer) {
+    const binding = layer?._sqlroomsBinding;
+    if (!isRecord(binding))
+        return undefined;
+    return typeof binding.dataset === 'string' ? binding.dataset : undefined;
+}
+export function usesGeometryColumnSetting(layerType) {
+    return (typeof layerType === 'string' &&
+        GEOMETRY_COLUMN_LAYER_TYPES.has(layerType.toLowerCase()));
+}
+export function usesH3ColumnSetting(layerType) {
+    return (typeof layerType === 'string' && H3_LAYER_TYPES.has(layerType.toLowerCase()));
+}
+export function usesArcColumnSetting(layerType) {
+    return (typeof layerType === 'string' &&
+        ARC_LAYER_TYPES.has(layerType.toLowerCase()));
+}
+export function usesRadiusSetting(layerType) {
+    return (typeof layerType === 'string' &&
+        RADIUS_LAYER_TYPES.has(layerType.toLowerCase()));
+}
+export function usesColumnRadiusSetting(layerType) {
+    return (typeof layerType === 'string' &&
+        COLUMN_RADIUS_LAYER_TYPES.has(layerType.toLowerCase()));
+}
+export function usesTripsSettings(layerType) {
+    return (typeof layerType === 'string' &&
+        TRIPS_LAYER_TYPES.has(layerType.toLowerCase()));
+}
+export function usesExtrusionSettings(layerType) {
+    return (typeof layerType === 'string' &&
+        EXTRUDABLE_LAYER_TYPES.has(layerType.toLowerCase()));
+}
+export function getDeckMapColorAccessorOptions(layerType) {
+    if (layerType === 'GeoArrowPathLayer' || layerType === 'GeoArrowTripsLayer') {
+        return DECK_MAP_COLOR_ACCESSOR_OPTIONS.filter((option) => option.value === 'getColor');
+    }
+    if (layerType === 'GeoArrowArcLayer') {
+        return DECK_MAP_COLOR_ACCESSOR_OPTIONS.filter((option) => option.value === 'getSourceColor' || option.value === 'getTargetColor');
+    }
+    if (layerType === 'GeoArrowHeatmapLayer') {
+        return [];
+    }
+    return DECK_MAP_COLOR_ACCESSOR_OPTIONS.filter((option) => option.value === 'getFillColor' || option.value === 'getLineColor');
+}
+export function updateDeckMapLayer(config, layerIndex, updater) {
+    const spec = getObjectSpec(config);
+    if (!spec || !Array.isArray(spec.layers)) {
+        return config;
+    }
+    const layer = spec.layers[layerIndex];
+    if (!isRecord(layer)) {
+        return config;
+    }
+    return {
+        ...config,
+        spec: {
+            ...spec,
+            layers: spec.layers.map((candidate, index) => index === layerIndex ? updater({ ...layer }) : candidate),
+        },
+    };
+}
+export function setDeckMapLayerType(config, layerIndex, layerType) {
+    return updateDeckMapLayer(config, layerIndex, (layer) => {
+        const nextLayer = {
+            ...layer,
+            '@@type': layerType,
+        };
+        const lt = layerType.toLowerCase();
+        if (lt === 'geoarrowcolumnlayer' ||
+            lt === 'columnlayer' ||
+            lt === 'deckcolumnlayer') {
+            nextLayer.radius ??= 3;
+            nextLayer.elevationScale ??= 1;
+        }
+        return nextLayer;
+    });
+}
+export function setDeckMapLayerGeometryColumn(config, layerIndex, geometryColumn) {
+    const layer = getDeckMapLayerRecords(config)[layerIndex];
+    const datasetId = getDeckMapLayerDatasetId(layer);
+    if (!datasetId || !config.datasets?.[datasetId]) {
+        return config;
+    }
+    const updatedConfig = {
+        ...config,
+        datasets: {
+            ...config.datasets,
+            [datasetId]: {
+                ...config.datasets[datasetId],
+                geometryColumn,
+            },
+        },
+        fitToData: config.fitToData &&
+            config.fitToData.dataset === datasetId &&
+            'geometryColumn' in config.fitToData
+            ? {
+                ...config.fitToData,
+                geometryColumn,
+            }
+            : config.fitToData,
+    };
+    return updateDeckMapLayer(updatedConfig, layerIndex, (l) => ({
+        ...l,
+        _sqlroomsBinding: {
+            ...l._sqlroomsBinding,
+            geometryColumn,
+        },
+    }));
+}
+export function setDeckMapLayerHexagonColumn(config, layerIndex, hexagonColumn) {
+    return updateDeckMapLayer(config, layerIndex, (layer) => ({
+        ...layer,
+        getHexagon: `@@=${hexagonColumn}`,
+        _sqlroomsBinding: {
+            ...(isRecord(layer._sqlroomsBinding) ? layer._sqlroomsBinding : {}),
+            hexagonColumn,
+        },
+    }));
+}
+export function setDeckMapLayerArcColumns(config, layerIndex, columns) {
+    return updateDeckMapLayer(config, layerIndex, (layer) => ({
+        ...layer,
+        _sqlroomsBinding: {
+            ...(isRecord(layer._sqlroomsBinding) ? layer._sqlroomsBinding : {}),
+            ...columns,
+        },
+    }));
+}
+export function setDeckMapLayerTimestampColumn(config, layerIndex, timestampColumn) {
+    return updateDeckMapLayer(config, layerIndex, (layer) => ({
+        ...layer,
+        _sqlroomsBinding: {
+            ...(isRecord(layer._sqlroomsBinding) ? layer._sqlroomsBinding : {}),
+            timestampColumn,
+        },
+    }));
+}
+export function getDeckMapLayerColorScale(layer, accessor) {
+    const value = layer?.[accessor];
+    return isColorScaleFunction(value)
+        ? value
+        : undefined;
+}
+export function setDeckMapLayerColorScale(config, layerIndex, accessor, colorScale) {
+    return updateDeckMapLayer(config, layerIndex, (layer) => ({
+        ...layer,
+        [accessor]: colorScale,
+    }));
+}
+const DEFAULT_LAYER_FILL_COLOR = [
+    56, 189, 248, 180,
+];
+export function clearDeckMapLayerColorScale(config, layerIndex, accessor) {
+    return updateDeckMapLayer(config, layerIndex, (layer) => {
+        const nextLayer = { ...layer };
+        if (accessor === 'getFillColor') {
+            nextLayer[accessor] = [...DEFAULT_LAYER_FILL_COLOR];
+        }
+        else {
+            delete nextLayer[accessor];
+        }
+        return nextLayer;
+    });
+}
+export function createDeckMapLayerColorScale(options) {
+    const type = options.type ?? 'sequential';
+    const scheme = options.scheme ??
+        DECK_MAP_COLOR_SCALE_TYPE_OPTIONS.find((option) => option.value === type)
+            ?.defaultScheme ??
+        'Viridis';
+    const base = {
+        '@@function': 'colorScale',
+        field: options.field,
+        legend: { title: options.title ?? options.field },
+    };
+    if (type === 'categorical') {
+        return {
+            ...base,
+            type,
+            scheme: scheme,
+        };
+    }
+    if (type === 'diverging') {
+        return {
+            ...base,
+            type,
+            scheme: scheme,
+            domain: 'auto',
+        };
+    }
+    if (type === 'quantize') {
+        return {
+            ...base,
+            type,
+            scheme: scheme,
+            domain: 'auto',
+        };
+    }
+    if (type === 'quantile') {
+        return {
+            ...base,
+            type,
+            scheme: scheme,
+        };
+    }
+    if (type === 'threshold') {
+        return {
+            ...base,
+            type,
+            scheme: scheme,
+            thresholds: [],
+        };
+    }
+    return {
+        ...base,
+        type: 'sequential',
+        scheme: scheme,
+        domain: 'auto',
+    };
+}
+//# sourceMappingURL=mapLayerConfigUtils.js.map

package/dist/mapLayerConfigUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapLayerConfigUtils.js","sourceRoot":"","sources":["../src/mapLayerConfigUtils.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,oBAAoB,EAAC,MAAM,oBAAoB,CAAC;AAexD,MAAM,CAAC,MAAM,2BAA2B,GAGnC;IACH,EAAC,KAAK,EAAE,0BAA0B,EAAE,KAAK,EAAE,OAAO,EAAC;IACnD,EAAC,KAAK,EAAE,sBAAsB,EAAE,KAAK,EAAE,SAAS,EAAC;IACjD,EAAC,KAAK,EAAE,qBAAqB,EAAE,KAAK,EAAE,QAAQ,EAAC;IAC/C,EAAC,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,EAAC;IAC3C,EAAC,KAAK,EAAE,sBAAsB,EAAE,KAAK,EAAE,SAAS,EAAC;IACjD,EAAC,KAAK,EAAE,2BAA2B,EAAE,KAAK,EAAE,eAAe,EAAC;IAC5D,EAAC,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,KAAK,EAAC;IACzC,EAAC,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,OAAO,EAAC;IAC7C,EAAC,KAAK,EAAE,wBAAwB,EAAE,KAAK,EAAE,YAAY,EAAC;IACtD,EAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,EAAC;CAC1C,CAAC;AAEF,MAAM,CAAC,MAAM,+BAA+B,GAGvC;IACH,EAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAC;IAC5C,EAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAC;IAC5C,EAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAC;IACnC,EAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,cAAc,EAAC;IAChD,EAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,cAAc,EAAC;CACjD,CAAC;AAEF,MAAM,CAAC,MAAM,iCAAiC,GAIzC;IACH,EAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAC;IACpE,EAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,EAAC;IAC/D,EAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAC;IAC/D,EAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAC;IAC/D,EAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAC;CACzE,CAAC;AAEF,MAAM,2BAA2B,GAAG,IAAI,GAAG,CAAC;IAC1C,sBAAsB;IACtB,2BAA2B;IAC3B,mBAAmB;IACnB,oBAAoB;IACpB,cAAc;IACd,cAAc;IACd,mBAAmB;IACnB,SAAS;IACT,SAAS;IACT,eAAe;CAChB,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,wBAAwB,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAE7E,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC,CAAC;AAElE,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,oBAAoB;IACpB,gBAAgB;IAChB,YAAY;CACb,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACjC,0BAA0B;IAC1B,kBAAkB;CACnB,CAAC,CAAC;AAEH,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAC;IACxC,qBAAqB;IACrB,aAAa;CACd,CAAC,CAAC;AAEH,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IACrC,wBAAwB;IACxB,gBAAgB;IAChB,qBAAqB;IACrB,aAAa;IACb,sBAAsB;IACtB,cAAc;IACd,2BAA2B;IAC3B,mBAAmB;CACpB,CAAC,CAAC;AAEH,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,aAAa,CACpB,MAAqB;IAErB,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,MAAqB;IAErB,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAC7C,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,KAAqC;IAErC,MAAM,OAAO,GAAG,KAAK,EAAE,gBAAgB,CAAC;IACxC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,OAAO,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,SAAkB;IAC1D,OAAO,CACL,OAAO,SAAS,KAAK,QAAQ;QAC7B,2BAA2B,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CACzD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,SAAkB;IACpD,OAAO,CACL,OAAO,SAAS,KAAK,QAAQ,IAAI,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAC7E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,SAAkB;IACrD,OAAO,CACL,OAAO,SAAS,KAAK,QAAQ;QAC7B,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAC7C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAAkB;IAClD,OAAO,CACL,OAAO,SAAS,KAAK,QAAQ;QAC7B,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAChD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,SAAkB;IACxD,OAAO,CACL,OAAO,SAAS,KAAK,QAAQ;QAC7B,yBAAyB,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CACvD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAAkB;IAClD,OAAO,CACL,OAAO,SAAS,KAAK,QAAQ;QAC7B,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAC/C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,SAAkB;IACtD,OAAO,CACL,OAAO,SAAS,KAAK,QAAQ;QAC7B,sBAAsB,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CACpD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,SAAkB;IAElB,IAAI,SAAS,KAAK,mBAAmB,IAAI,SAAS,KAAK,oBAAoB,EAAE,CAAC;QAC5E,OAAO,+BAA+B,CAAC,MAAM,CAC3C,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,UAAU,CACxC,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,KAAK,kBAAkB,EAAE,CAAC;QACrC,OAAO,+BAA+B,CAAC,MAAM,CAC3C,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,KAAK,KAAK,gBAAgB,IAAI,MAAM,CAAC,KAAK,KAAK,gBAAgB,CACzE,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,KAAK,sBAAsB,EAAE,CAAC;QACzC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,+BAA+B,CAAC,MAAM,CAC3C,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,KAAK,KAAK,cAAc,IAAI,MAAM,CAAC,KAAK,KAAK,cAAc,CACrE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,MAAqB,EACrB,UAAkB,EAClB,OAA0D;IAE1D,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACzC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACtC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO;QACL,GAAG,MAAM;QACT,IAAI,EAAE;YACJ,GAAG,IAAI;YACP,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAC3C,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,EAAC,GAAG,KAAK,EAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CACvD;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAAqB,EACrB,UAAkB,EAClB,SAAiB;IAEjB,OAAO,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE;QACtD,MAAM,SAAS,GAAuB;YACpC,GAAG,KAAK;YACR,QAAQ,EAAE,SAAS;SACpB,CAAC;QACF,MAAM,EAAE,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;QACnC,IACE,EAAE,KAAK,qBAAqB;YAC5B,EAAE,KAAK,aAAa;YACpB,EAAE,KAAK,iBAAiB,EACxB,CAAC;YACD,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC;YACvB,SAAS,CAAC,cAAc,KAAK,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,MAAqB,EACrB,UAAkB,EAClB,cAAsB;IAEtB,MAAM,KAAK,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,aAAa,GAAG;QACpB,GAAG,MAAM;QACT,QAAQ,EAAE;YACR,GAAG,MAAM,CAAC,QAAQ;YAClB,CAAC,SAAS,CAAC,EAAE;gBACX,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAC7B,cAAc;aACf;SACF;QACD,SAAS,EACP,MAAM,CAAC,SAAS;YAChB,MAAM,CAAC,SAAS,CAAC,OAAO,KAAK,SAAS;YACtC,gBAAgB,IAAI,MAAM,CAAC,SAAS;YAClC,CAAC,CAAC;gBACE,GAAG,MAAM,CAAC,SAAS;gBACnB,cAAc;aACf;YACH,CAAC,CAAC,MAAM,CAAC,SAAS;KACvB,CAAC;IAEF,OAAO,kBAAkB,CAAC,aAAa,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3D,GAAG,CAAC;QACJ,gBAAgB,EAAE;YAChB,GAAI,CAAC,CAAC,gBAA4C;YAClD,cAAc;SACf;KACF,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,MAAqB,EACrB,UAAkB,EAClB,aAAqB;IAErB,OAAO,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACxD,GAAG,KAAK;QACR,UAAU,EAAE,MAAM,aAAa,EAAE;QACjC,gBAAgB,EAAE;YAChB,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,aAAa;SACd;KACF,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,MAAqB,EACrB,UAAkB,EAClB,OAOC;IAED,OAAO,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACxD,GAAG,KAAK;QACR,gBAAgB,EAAE;YAChB,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,GAAG,OAAO;SACX;KACF,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,MAAqB,EACrB,UAAkB,EAClB,eAAuB;IAEvB,OAAO,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACxD,GAAG,KAAK;QACR,gBAAgB,EAAE;YAChB,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,eAAe;SAChB;KACF,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,KAAqC,EACrC,QAAmC;IAEnC,MAAM,KAAK,GAAG,KAAK,EAAE,CAAC,QAAQ,CAAC,CAAC;IAChC,OAAO,oBAAoB,CAAC,KAAK,CAAC;QAChC,CAAC,CAAE,KAAwC;QAC3C,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,MAAqB,EACrB,UAAkB,EAClB,QAAmC,EACnC,UAA0C;IAE1C,OAAO,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACxD,GAAG,KAAK;QACR,CAAC,QAAQ,CAAC,EAAE,UAAU;KACvB,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,wBAAwB,GAAqC;IACjE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;CAClB,CAAC;AAEF,MAAM,UAAU,2BAA2B,CACzC,MAAqB,EACrB,UAAkB,EAClB,QAAmC;IAEnC,OAAO,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE;QACtD,MAAM,SAAS,GAAG,EAAC,GAAG,KAAK,EAAC,CAAC;QAC7B,IAAI,QAAQ,KAAK,cAAc,EAAE,CAAC;YAChC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,wBAAwB,CAAC,CAAC;QACtD,CAAC;aAAM,CAAC;YACN,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,OAK5C;IACC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,YAAY,CAAC;IAC1C,MAAM,MAAM,GACV,OAAO,CAAC,MAAM;QACd,iCAAiC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC;YACvE,EAAE,aAAa;QACjB,SAAS,CAAC;IACZ,MAAM,IAAI,GAAG;QACX,YAAY,EAAE,YAAqB;QACnC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,EAAC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,EAAC;KAChD,CAAC;IAEF,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;QAC3B,OAAO;YACL,GAAG,IAAI;YACP,IAAI;YACJ,MAAM,EAAE,MAGG;SACZ,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,OAAO;YACL,GAAG,IAAI;YACP,IAAI;YACJ,MAAM,EAAE,MAGG;YACX,MAAM,EAAE,MAAM;SACf,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,OAAO;YACL,GAAG,IAAI;YACP,IAAI;YACJ,MAAM,EAAE,MAAiE;YACzE,MAAM,EAAE,MAAM;SACf,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,OAAO;YACL,GAAG,IAAI;YACP,IAAI;YACJ,MAAM,EAAE,MAAiE;SAC1E,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,OAAO;YACL,GAAG,IAAI;YACP,IAAI;YACJ,MAAM,EAAE,MAGG;YACX,UAAU,EAAE,EAAE;SACf,CAAC;IACJ,CAAC;IAED,OAAO;QACL,GAAG,IAAI;QACP,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,MAAmE;QAC3E,MAAM,EAAE,MAAM;KACf,CAAC;AACJ,CAAC","sourcesContent":["import type {ColorScaleConfig, ColorScaleScheme} from '@sqlrooms/color-scales';\nimport type {DeckMapConfig} from './mapConfig';\nimport type {DeckAutoLayerType} from './types';\nimport {isColorScaleFunction} from './json/layerConfig';\n\nexport type DeckMapLayerRecord = Record<string, unknown>;\n\nexport type DeckMapLayerColorScaleFunction = ColorScaleConfig & {\n  '@@function': 'colorScale';\n};\n\nexport type DeckMapLayerColorAccessor =\n  | 'getFillColor'\n  | 'getLineColor'\n  | 'getColor'\n  | 'getSourceColor'\n  | 'getTargetColor';\n\nexport const DECK_MAP_LAYER_TYPE_OPTIONS: ReadonlyArray<{\n  value: DeckAutoLayerType | 'GeoArrowSolidPolygonLayer';\n  label: string;\n}> = [\n  {value: 'GeoArrowScatterplotLayer', label: 'Point'},\n  {value: 'GeoArrowHeatmapLayer', label: 'Heatmap'},\n  {value: 'GeoArrowColumnLayer', label: 'Column'},\n  {value: 'GeoArrowPathLayer', label: 'Path'},\n  {value: 'GeoArrowPolygonLayer', label: 'Polygon'},\n  {value: 'GeoArrowSolidPolygonLayer', label: 'Solid polygon'},\n  {value: 'GeoArrowArcLayer', label: 'Arc'},\n  {value: 'GeoArrowTripsLayer', label: 'Trips'},\n  {value: 'GeoArrowH3HexagonLayer', label: 'H3 hexagon'},\n  {value: 'GeoJsonLayer', label: 'GeoJSON'},\n];\n\nexport const DECK_MAP_COLOR_ACCESSOR_OPTIONS: ReadonlyArray<{\n  value: DeckMapLayerColorAccessor;\n  label: string;\n}> = [\n  {value: 'getFillColor', label: 'Fill color'},\n  {value: 'getLineColor', label: 'Line color'},\n  {value: 'getColor', label: 'Color'},\n  {value: 'getSourceColor', label: 'Source color'},\n  {value: 'getTargetColor', label: 'Target color'},\n];\n\nexport const DECK_MAP_COLOR_SCALE_TYPE_OPTIONS: ReadonlyArray<{\n  value: ColorScaleConfig['type'];\n  label: string;\n  defaultScheme: ColorScaleScheme;\n}> = [\n  {value: 'sequential', label: 'Sequential', defaultScheme: 'Viridis'},\n  {value: 'diverging', label: 'Diverging', defaultScheme: 'RdBu'},\n  {value: 'quantize', label: 'Quantize', defaultScheme: 'YlOrRd'},\n  {value: 'quantile', label: 'Quantile', defaultScheme: 'YlOrRd'},\n  {value: 'categorical', label: 'Categorical', defaultScheme: 'Tableau10'},\n];\n\nconst GEOMETRY_COLUMN_LAYER_TYPES = new Set([\n  'geoarrowpolygonlayer',\n  'geoarrowsolidpolygonlayer',\n  'geoarrowpathlayer',\n  'geoarrowtripslayer',\n  'geojsonlayer',\n  'polygonlayer',\n  'solidpolygonlayer',\n  'geojson',\n  'polygon',\n  'solid polygon',\n]);\n\nconst H3_LAYER_TYPES = new Set(['geoarrowh3hexagonlayer', 'h3hexagonlayer']);\n\nconst ARC_LAYER_TYPES = new Set(['geoarrowarclayer', 'arclayer']);\n\nconst TRIPS_LAYER_TYPES = new Set([\n  'geoarrowtripslayer',\n  'decktripslayer',\n  'tripslayer',\n]);\n\nconst RADIUS_LAYER_TYPES = new Set([\n  'geoarrowscatterplotlayer',\n  'scatterplotlayer',\n]);\n\nconst COLUMN_RADIUS_LAYER_TYPES = new Set([\n  'geoarrowcolumnlayer',\n  'columnlayer',\n]);\n\nconst EXTRUDABLE_LAYER_TYPES = new Set([\n  'geoarrowh3hexagonlayer',\n  'h3hexagonlayer',\n  'geoarrowcolumnlayer',\n  'columnlayer',\n  'geoarrowpolygonlayer',\n  'polygonlayer',\n  'geoarrowsolidpolygonlayer',\n  'solidpolygonlayer',\n]);\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return Boolean(value && typeof value === 'object' && !Array.isArray(value));\n}\n\nfunction getObjectSpec(\n  config: DeckMapConfig,\n): Record<string, unknown> | undefined {\n  return isRecord(config.spec) ? config.spec : undefined;\n}\n\nexport function getDeckMapLayerRecords(\n  config: DeckMapConfig,\n): DeckMapLayerRecord[] {\n  const layers = getObjectSpec(config)?.layers;\n  return Array.isArray(layers) ? layers.filter(isRecord) : [];\n}\n\nexport function getDeckMapLayerDatasetId(\n  layer: DeckMapLayerRecord | undefined,\n): string | undefined {\n  const binding = layer?._sqlroomsBinding;\n  if (!isRecord(binding)) return undefined;\n  return typeof binding.dataset === 'string' ? binding.dataset : undefined;\n}\n\nexport function usesGeometryColumnSetting(layerType: unknown) {\n  return (\n    typeof layerType === 'string' &&\n    GEOMETRY_COLUMN_LAYER_TYPES.has(layerType.toLowerCase())\n  );\n}\n\nexport function usesH3ColumnSetting(layerType: unknown) {\n  return (\n    typeof layerType === 'string' && H3_LAYER_TYPES.has(layerType.toLowerCase())\n  );\n}\n\nexport function usesArcColumnSetting(layerType: unknown) {\n  return (\n    typeof layerType === 'string' &&\n    ARC_LAYER_TYPES.has(layerType.toLowerCase())\n  );\n}\n\nexport function usesRadiusSetting(layerType: unknown) {\n  return (\n    typeof layerType === 'string' &&\n    RADIUS_LAYER_TYPES.has(layerType.toLowerCase())\n  );\n}\n\nexport function usesColumnRadiusSetting(layerType: unknown) {\n  return (\n    typeof layerType === 'string' &&\n    COLUMN_RADIUS_LAYER_TYPES.has(layerType.toLowerCase())\n  );\n}\n\nexport function usesTripsSettings(layerType: unknown) {\n  return (\n    typeof layerType === 'string' &&\n    TRIPS_LAYER_TYPES.has(layerType.toLowerCase())\n  );\n}\n\nexport function usesExtrusionSettings(layerType: unknown) {\n  return (\n    typeof layerType === 'string' &&\n    EXTRUDABLE_LAYER_TYPES.has(layerType.toLowerCase())\n  );\n}\n\nexport function getDeckMapColorAccessorOptions(\n  layerType: unknown,\n): typeof DECK_MAP_COLOR_ACCESSOR_OPTIONS {\n  if (layerType === 'GeoArrowPathLayer' || layerType === 'GeoArrowTripsLayer') {\n    return DECK_MAP_COLOR_ACCESSOR_OPTIONS.filter(\n      (option) => option.value === 'getColor',\n    );\n  }\n\n  if (layerType === 'GeoArrowArcLayer') {\n    return DECK_MAP_COLOR_ACCESSOR_OPTIONS.filter(\n      (option) =>\n        option.value === 'getSourceColor' || option.value === 'getTargetColor',\n    );\n  }\n\n  if (layerType === 'GeoArrowHeatmapLayer') {\n    return [];\n  }\n\n  return DECK_MAP_COLOR_ACCESSOR_OPTIONS.filter(\n    (option) =>\n      option.value === 'getFillColor' || option.value === 'getLineColor',\n  );\n}\n\nexport function updateDeckMapLayer(\n  config: DeckMapConfig,\n  layerIndex: number,\n  updater: (layer: DeckMapLayerRecord) => DeckMapLayerRecord,\n): DeckMapConfig {\n  const spec = getObjectSpec(config);\n  if (!spec || !Array.isArray(spec.layers)) {\n    return config;\n  }\n\n  const layer = spec.layers[layerIndex];\n  if (!isRecord(layer)) {\n    return config;\n  }\n\n  return {\n    ...config,\n    spec: {\n      ...spec,\n      layers: spec.layers.map((candidate, index) =>\n        index === layerIndex ? updater({...layer}) : candidate,\n      ),\n    },\n  };\n}\n\nexport function setDeckMapLayerType(\n  config: DeckMapConfig,\n  layerIndex: number,\n  layerType: string,\n): DeckMapConfig {\n  return updateDeckMapLayer(config, layerIndex, (layer) => {\n    const nextLayer: DeckMapLayerRecord = {\n      ...layer,\n      '@@type': layerType,\n    };\n    const lt = layerType.toLowerCase();\n    if (\n      lt === 'geoarrowcolumnlayer' ||\n      lt === 'columnlayer' ||\n      lt === 'deckcolumnlayer'\n    ) {\n      nextLayer.radius ??= 3;\n      nextLayer.elevationScale ??= 1;\n    }\n    return nextLayer;\n  });\n}\n\nexport function setDeckMapLayerGeometryColumn(\n  config: DeckMapConfig,\n  layerIndex: number,\n  geometryColumn: string,\n): DeckMapConfig {\n  const layer = getDeckMapLayerRecords(config)[layerIndex];\n  const datasetId = getDeckMapLayerDatasetId(layer);\n  if (!datasetId || !config.datasets?.[datasetId]) {\n    return config;\n  }\n\n  const updatedConfig = {\n    ...config,\n    datasets: {\n      ...config.datasets,\n      [datasetId]: {\n        ...config.datasets[datasetId],\n        geometryColumn,\n      },\n    },\n    fitToData:\n      config.fitToData &&\n      config.fitToData.dataset === datasetId &&\n      'geometryColumn' in config.fitToData\n        ? {\n            ...config.fitToData,\n            geometryColumn,\n          }\n        : config.fitToData,\n  };\n\n  return updateDeckMapLayer(updatedConfig, layerIndex, (l) => ({\n    ...l,\n    _sqlroomsBinding: {\n      ...(l._sqlroomsBinding as Record<string, unknown>),\n      geometryColumn,\n    },\n  }));\n}\n\nexport function setDeckMapLayerHexagonColumn(\n  config: DeckMapConfig,\n  layerIndex: number,\n  hexagonColumn: string,\n): DeckMapConfig {\n  return updateDeckMapLayer(config, layerIndex, (layer) => ({\n    ...layer,\n    getHexagon: `@@=${hexagonColumn}`,\n    _sqlroomsBinding: {\n      ...(isRecord(layer._sqlroomsBinding) ? layer._sqlroomsBinding : {}),\n      hexagonColumn,\n    },\n  }));\n}\n\nexport function setDeckMapLayerArcColumns(\n  config: DeckMapConfig,\n  layerIndex: number,\n  columns: {\n    sourceGeometryColumn?: string;\n    targetGeometryColumn?: string;\n    sourceLatitudeColumn?: string;\n    sourceLongitudeColumn?: string;\n    targetLatitudeColumn?: string;\n    targetLongitudeColumn?: string;\n  },\n): DeckMapConfig {\n  return updateDeckMapLayer(config, layerIndex, (layer) => ({\n    ...layer,\n    _sqlroomsBinding: {\n      ...(isRecord(layer._sqlroomsBinding) ? layer._sqlroomsBinding : {}),\n      ...columns,\n    },\n  }));\n}\n\nexport function setDeckMapLayerTimestampColumn(\n  config: DeckMapConfig,\n  layerIndex: number,\n  timestampColumn: string,\n): DeckMapConfig {\n  return updateDeckMapLayer(config, layerIndex, (layer) => ({\n    ...layer,\n    _sqlroomsBinding: {\n      ...(isRecord(layer._sqlroomsBinding) ? layer._sqlroomsBinding : {}),\n      timestampColumn,\n    },\n  }));\n}\n\nexport function getDeckMapLayerColorScale(\n  layer: DeckMapLayerRecord | undefined,\n  accessor: DeckMapLayerColorAccessor,\n): DeckMapLayerColorScaleFunction | undefined {\n  const value = layer?.[accessor];\n  return isColorScaleFunction(value)\n    ? (value as DeckMapLayerColorScaleFunction)\n    : undefined;\n}\n\nexport function setDeckMapLayerColorScale(\n  config: DeckMapConfig,\n  layerIndex: number,\n  accessor: DeckMapLayerColorAccessor,\n  colorScale: DeckMapLayerColorScaleFunction,\n): DeckMapConfig {\n  return updateDeckMapLayer(config, layerIndex, (layer) => ({\n    ...layer,\n    [accessor]: colorScale,\n  }));\n}\n\nconst DEFAULT_LAYER_FILL_COLOR: [number, number, number, number] = [\n  56, 189, 248, 180,\n];\n\nexport function clearDeckMapLayerColorScale(\n  config: DeckMapConfig,\n  layerIndex: number,\n  accessor: DeckMapLayerColorAccessor,\n): DeckMapConfig {\n  return updateDeckMapLayer(config, layerIndex, (layer) => {\n    const nextLayer = {...layer};\n    if (accessor === 'getFillColor') {\n      nextLayer[accessor] = [...DEFAULT_LAYER_FILL_COLOR];\n    } else {\n      delete nextLayer[accessor];\n    }\n    return nextLayer;\n  });\n}\n\nexport function createDeckMapLayerColorScale(options: {\n  field: string;\n  type?: ColorScaleConfig['type'];\n  scheme?: ColorScaleScheme;\n  title?: string;\n}): DeckMapLayerColorScaleFunction {\n  const type = options.type ?? 'sequential';\n  const scheme =\n    options.scheme ??\n    DECK_MAP_COLOR_SCALE_TYPE_OPTIONS.find((option) => option.value === type)\n      ?.defaultScheme ??\n    'Viridis';\n  const base = {\n    '@@function': 'colorScale' as const,\n    field: options.field,\n    legend: {title: options.title ?? options.field},\n  };\n\n  if (type === 'categorical') {\n    return {\n      ...base,\n      type,\n      scheme: scheme as Extract<\n        ColorScaleConfig,\n        {type: 'categorical'}\n      >['scheme'],\n    };\n  }\n\n  if (type === 'diverging') {\n    return {\n      ...base,\n      type,\n      scheme: scheme as Extract<\n        ColorScaleConfig,\n        {type: 'diverging'}\n      >['scheme'],\n      domain: 'auto',\n    };\n  }\n\n  if (type === 'quantize') {\n    return {\n      ...base,\n      type,\n      scheme: scheme as Extract<ColorScaleConfig, {type: 'quantize'}>['scheme'],\n      domain: 'auto',\n    };\n  }\n\n  if (type === 'quantile') {\n    return {\n      ...base,\n      type,\n      scheme: scheme as Extract<ColorScaleConfig, {type: 'quantile'}>['scheme'],\n    };\n  }\n\n  if (type === 'threshold') {\n    return {\n      ...base,\n      type,\n      scheme: scheme as Extract<\n        ColorScaleConfig,\n        {type: 'threshold'}\n      >['scheme'],\n      thresholds: [],\n    };\n  }\n\n  return {\n    ...base,\n    type: 'sequential',\n    scheme: scheme as Extract<ColorScaleConfig, {type: 'sequential'}>['scheme'],\n    domain: 'auto',\n  };\n}\n"]}

package/dist/mapResourceAuthoring.d.ts

@@ -0,0 +1,40 @@
+import type { DeckMapConfig } from './mapConfig';
+export type DeckMapResourceConfigIssue = {
+    path: string;
+    message: string;
+};
+export type DeckMapResourceConfigValidationOptions = {
+    /** Empty resources are valid while waiting for a user-selected table. */
+    allowEmpty?: boolean;
+};
+/** Controls how an incoming map config patch is merged with durable state. */
+export type DeckMapResourceConfigMergeOptions = {
+    /** Treat an incoming `spec.layers` array as the complete replacement list. */
+    replaceLayers?: boolean;
+    /** Treat incoming `datasets` as the complete replacement registry. */
+    replaceDatasets?: boolean;
+};
+/** Error raised before an invalid map resource can be durably written. */
+export declare class DeckMapResourceConfigError extends Error {
+    readonly issues: DeckMapResourceConfigIssue[];
+    constructor(issues: DeckMapResourceConfigIssue[]);
+}
+/**
+ * Merges a sparse map-tool patch with durable state. Empty dataset registries
+ * and layer arrays mean "preserve" only when an existing resource is present.
+ */
+export declare function mergeDeckMapResourceConfigPatch(existingConfig: DeckMapConfig | undefined, incomingConfig: DeckMapConfig, options?: DeckMapResourceConfigMergeOptions): DeckMapConfig;
+/**
+ * Validates the post-merge invariants of a renderable, resource-native map.
+ * Patch inputs may be sparse, but the durable result must have supported
+ * dataset sources and dataset-backed layers.
+ */
+export declare function getDeckMapResourceConfigIssues(config: DeckMapConfig, options?: DeckMapResourceConfigValidationOptions): DeckMapResourceConfigIssue[];
+/** Rejects invalid durable map writes after sparse patches have been merged. */
+export declare function assertDeckMapResourceConfig(config: DeckMapConfig): void;
+/**
+ * Returns the package-owned authoring contract for hosts with direct worksheet
+ * map capability. Host adapters opt into it; they do not maintain prompt copies.
+ */
+export declare function getDeckMapResourceAiInstructions(): string;
+//# sourceMappingURL=mapResourceAuthoring.d.ts.map

package/dist/mapResourceAuthoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapResourceAuthoring.d.ts","sourceRoot":"","sources":["../src/mapResourceAuthoring.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,aAAa,CAAC;AAM/C,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,sCAAsC,GAAG;IACnD,yEAAyE;IACzE,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,8EAA8E;AAC9E,MAAM,MAAM,iCAAiC,GAAG;IAC9C,8EAA8E;IAC9E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,sEAAsE;IACtE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,0EAA0E;AAC1E,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,MAAM,EAAE,0BAA0B,EAAE,CAAC;gBAElC,MAAM,EAAE,0BAA0B,EAAE;CASjD;AAkHD;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,cAAc,EAAE,aAAa,GAAG,SAAS,EACzC,cAAc,EAAE,aAAa,EAC7B,OAAO,GAAE,iCAAsC,GAC9C,aAAa,CAoBf;AAmCD;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,sCAA2C,GACnD,0BAA0B,EAAE,CAqG9B;AAED,gFAAgF;AAChF,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAGvE;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,IAAI,MAAM,CAkBzD"}

package/dist/mapResourceAuthoring.js

@@ -0,0 +1,266 @@
+import { DeckJsonMapSpec } from './DeckJsonMapSpec';
+import { isDeckMapSqlDatasetSource, isDeckMapTableDatasetSource, } from './mapConfig';
+/** Error raised before an invalid map resource can be durably written. */
+export class DeckMapResourceConfigError extends Error {
+    issues;
+    constructor(issues) {
+        super(`Invalid Deck map resource config: ${issues
+            .map((issue) => `${issue.path}: ${issue.message}`)
+            .join('; ')}`);
+        this.name = 'DeckMapResourceConfigError';
+        this.issues = issues;
+    }
+}
+function isRecord(value) {
+    return Boolean(value && typeof value === 'object' && !Array.isArray(value));
+}
+function hasEntries(value) {
+    return isRecord(value) && Object.keys(value).length > 0;
+}
+function mergeOptionalRecord(existing, incoming) {
+    if (isRecord(existing) && isRecord(incoming)) {
+        return { ...existing, ...incoming };
+    }
+    if (isRecord(incoming))
+        return incoming;
+    return isRecord(existing) ? existing : undefined;
+}
+function mergeLayerPatch(existingLayer, incomingLayer) {
+    if (!isRecord(existingLayer) || !isRecord(incomingLayer)) {
+        return incomingLayer;
+    }
+    return {
+        ...existingLayer,
+        ...incomingLayer,
+        _sqlroomsBinding: mergeOptionalRecord(existingLayer._sqlroomsBinding, incomingLayer._sqlroomsBinding),
+    };
+}
+function mergeLayerPatches(existingLayers, incomingLayers) {
+    if (!incomingLayers || incomingLayers.length === 0)
+        return existingLayers;
+    if (!existingLayers || existingLayers.length === 0)
+        return incomingLayers;
+    const nextLayers = [...existingLayers];
+    for (const [incomingIndex, incomingLayer] of incomingLayers.entries()) {
+        const incomingId = isRecord(incomingLayer)
+            ? incomingLayer.id
+            : undefined;
+        const existingIndex = incomingId
+            ? existingLayers.findIndex((layer) => isRecord(layer) && layer.id === incomingId)
+            : incomingIndex < existingLayers.length
+                ? incomingIndex
+                : -1;
+        if (existingIndex >= 0) {
+            nextLayers[existingIndex] = mergeLayerPatch(existingLayers[existingIndex], incomingLayer);
+        }
+        else {
+            nextLayers.push(incomingLayer);
+        }
+    }
+    return nextLayers;
+}
+function mergeSpecPatch(existingSpec, incomingSpec, options) {
+    if (typeof incomingSpec === 'string')
+        return incomingSpec;
+    const existing = isRecord(existingSpec) ? existingSpec : undefined;
+    const incoming = isRecord(incomingSpec) ? incomingSpec : undefined;
+    if (!existing && !incoming)
+        return incomingSpec ?? existingSpec;
+    const existingLayers = Array.isArray(existing?.layers)
+        ? existing.layers
+        : undefined;
+    const incomingLayers = Array.isArray(incoming?.layers)
+        ? incoming.layers
+        : undefined;
+    const layers = options.replaceLayers && incomingLayers !== undefined
+        ? incomingLayers
+        : mergeLayerPatches(existingLayers, incomingLayers);
+    return {
+        ...(existing ?? {}),
+        ...(incoming ?? {}),
+        ...(layers ? { layers } : {}),
+    };
+}
+function mergeDatasetRegistry(existingDatasets, incomingDatasets, replaceDatasets) {
+    if (replaceDatasets)
+        return incomingDatasets;
+    if (!hasEntries(incomingDatasets))
+        return existingDatasets;
+    const datasets = { ...existingDatasets };
+    for (const [datasetId, incomingDataset] of Object.entries(incomingDatasets)) {
+        const existingDataset = existingDatasets[datasetId];
+        datasets[datasetId] = existingDataset
+            ? {
+                ...existingDataset,
+                ...incomingDataset,
+                source: incomingDataset.source ?? existingDataset.source,
+            }
+            : incomingDataset;
+    }
+    return datasets;
+}
+/**
+ * Merges a sparse map-tool patch with durable state. Empty dataset registries
+ * and layer arrays mean "preserve" only when an existing resource is present.
+ */
+export function mergeDeckMapResourceConfigPatch(existingConfig, incomingConfig, options = {}) {
+    if (!existingConfig)
+        return incomingConfig;
+    return {
+        ...existingConfig,
+        ...incomingConfig,
+        spec: mergeSpecPatch(existingConfig.spec, incomingConfig.spec, options),
+        datasets: mergeDatasetRegistry(existingConfig.datasets, incomingConfig.datasets, options.replaceDatasets === true),
+        mapProps: mergeOptionalRecord(existingConfig.mapProps, incomingConfig.mapProps),
+        dataPolicy: mergeOptionalRecord(existingConfig.dataPolicy, incomingConfig.dataPolicy),
+    };
+}
+function parseSpec(config) {
+    let spec = config.spec;
+    if (typeof spec === 'string') {
+        try {
+            spec = JSON.parse(spec);
+        }
+        catch {
+            return {
+                layers: [],
+                issues: [{ path: 'spec', message: 'must be valid JSON' }],
+            };
+        }
+    }
+    const parsed = DeckJsonMapSpec.safeParse(spec);
+    if (!parsed.success) {
+        return {
+            layers: [],
+            issues: parsed.error.issues.map((issue) => ({
+                path: ['spec', ...issue.path].join('.'),
+                message: issue.message,
+            })),
+        };
+    }
+    return {
+        layers: (parsed.data.layers ?? []),
+        issues: [],
+    };
+}
+/**
+ * Validates the post-merge invariants of a renderable, resource-native map.
+ * Patch inputs may be sparse, but the durable result must have supported
+ * dataset sources and dataset-backed layers.
+ */
+export function getDeckMapResourceConfigIssues(config, options = {}) {
+    const issues = [];
+    const datasetEntries = Object.entries(config.datasets);
+    const datasetIds = datasetEntries.map(([datasetId]) => datasetId);
+    const datasetIdSet = new Set(datasetIds);
+    const parsedSpec = parseSpec(config);
+    issues.push(...parsedSpec.issues);
+    const isEmpty = datasetEntries.length === 0 && parsedSpec.layers.length === 0;
+    if (isEmpty) {
+        return options.allowEmpty
+            ? issues
+            : [
+                ...issues,
+                {
+                    path: 'datasets',
+                    message: 'must contain at least one dataset for a map write',
+                },
+                {
+                    path: 'spec.layers',
+                    message: 'must contain at least one dataset-backed layer',
+                },
+            ];
+    }
+    if (datasetEntries.length === 0) {
+        issues.push({
+            path: 'datasets',
+            message: 'must contain at least one dataset',
+        });
+    }
+    for (const [datasetId, dataset] of datasetEntries) {
+        const source = dataset.source;
+        const hasSqlSource = isDeckMapSqlDatasetSource(source) && source.sqlQuery.trim().length > 0;
+        const hasTableSource = isDeckMapTableDatasetSource(source) && source.tableName.trim().length > 0;
+        if (!hasSqlSource && !hasTableSource) {
+            const legacySql = dataset.sql;
+            issues.push({
+                path: `datasets.${datasetId}.source`,
+                message: typeof legacySql === 'string'
+                    ? 'must define source.tableName or source.sqlQuery; top-level sql is not supported'
+                    : 'must define source.tableName or source.sqlQuery',
+            });
+        }
+    }
+    if (parsedSpec.layers.length === 0) {
+        issues.push({
+            path: 'spec.layers',
+            message: 'must contain at least one dataset-backed layer',
+        });
+    }
+    parsedSpec.layers.forEach((layer, index) => {
+        const layerType = layer['@@type'];
+        if (typeof layerType !== 'string' || layerType.trim().length === 0) {
+            issues.push({
+                path: `spec.layers.${index}.@@type`,
+                message: 'must name a Deck JSON layer class',
+            });
+        }
+        const binding = layer._sqlroomsBinding && typeof layer._sqlroomsBinding === 'object'
+            ? layer._sqlroomsBinding
+            : undefined;
+        const boundDataset = typeof binding?.dataset === 'string' && binding.dataset.trim()
+            ? binding.dataset
+            : undefined;
+        if (boundDataset) {
+            if (!datasetIdSet.has(boundDataset)) {
+                issues.push({
+                    path: `spec.layers.${index}._sqlroomsBinding.dataset`,
+                    message: `references unknown dataset "${boundDataset}"`,
+                });
+            }
+            return;
+        }
+        issues.push({
+            path: `spec.layers.${index}._sqlroomsBinding.dataset`,
+            message: 'must bind the layer to a config.datasets entry; layer data references and implicit bindings are not durable resource bindings',
+        });
+    });
+    const fitDataset = config.fitToData?.dataset;
+    if (fitDataset && !datasetIdSet.has(fitDataset)) {
+        issues.push({
+            path: 'fitToData.dataset',
+            message: `references unknown dataset "${fitDataset}"`,
+        });
+    }
+    return issues;
+}
+/** Rejects invalid durable map writes after sparse patches have been merged. */
+export function assertDeckMapResourceConfig(config) {
+    const issues = getDeckMapResourceConfigIssues(config);
+    if (issues.length > 0)
+        throw new DeckMapResourceConfigError(issues);
+}
+/**
+ * Returns the package-owned authoring contract for hosts with direct worksheet
+ * map capability. Host adapters opt into it; they do not maintain prompt copies.
+ */
+export function getDeckMapResourceAiInstructions() {
+    return `## Direct worksheet Deck map resources
+
+When authoring a worksheet map config, use the resource-native Deck JSON contract:
+- A new map must contain at least one config.datasets entry and at least one spec.layers entry.
+- Every dataset must define source.tableName, source.tableName plus source.transformSql, or source.sqlQuery. Never put sql directly on the dataset object.
+- Bind every layer to a dataset with _sqlroomsBinding.dataset. Never use data: "@@#datasetId" or an implicit single-dataset binding as a durable resource binding.
+- Use supported Deck JSON layer classes such as GeoArrowScatterplotLayer, GeoArrowHeatmapLayer, GeoArrowPolygonLayer, GeoArrowPathLayer, GeoArrowTripsLayer, GeoArrowArcLayer, GeoArrowColumnLayer, GeoArrowH3HexagonLayer, or GeoJsonLayer.
+- For table-backed datasets, also pass the same table through the tool's top-level tableName field. A selected table does not replace the required dataset source.
+- transformSql must be a single SELECT and must read from __sqlrooms_source. Use source.sqlQuery only for a standalone pinned query.
+- Use configMode "basic" for a straightforward single-layer map. Use "custom" only for advanced properties the basic settings cannot represent; custom mode does not relax dataset-source or layer-binding requirements.
+- For a point geometry column, prefer GeoArrowScatterplotLayer with dataset.geometryColumn and _sqlroomsBinding.geometryColumn set to the exact geometry column. For longitude/latitude columns, use source.transformSql to produce WKB geometry and bind that output column.
+- For updates, sparse config patches are allowed because they are merged with the existing resource. For creates, never send empty datasets or layers.
+- To remove existing layers or datasets, set replaceLayers and/or replaceDatasets to true and send the complete desired list or registry. Omit them for additive sparse updates.
+- If a map write reports an invalid resource config, repair the reported paths and retry the same direct map operation; do not replace it with a dashboard-backed map.
+
+Minimal table-backed point map shape:
+{"configMode":"basic","datasets":{"places":{"source":{"tableName":"places"},"geometryColumn":"geom","geometryEncodingHint":"wkb"}},"spec":{"layers":[{"@@type":"GeoArrowScatterplotLayer","id":"places","_sqlroomsBinding":{"dataset":"places","geometryColumn":"geom"},"getRadius":4,"radiusUnits":"pixels","pickable":true}]},"fitToData":{"dataset":"places","geometryColumn":"geom"}}`;
+}
+//# sourceMappingURL=mapResourceAuthoring.js.map