@deck.gl/carto 9.0.0-beta.2 → 9.0.0-beta.3

package/dist/sources/h3-query-source.js

@@ -0,0 +1,18 @@
+/* eslint-disable camelcase */
+import { baseSource } from "./base-source.js";
+export const h3QuerySource = async function (options) {
+    const { aggregationExp, aggregationResLevel = 4, sqlQuery, spatialDataColumn = 'h3', queryParameters } = options;
+    const urlParameters = {
+        aggregationExp,
+        spatialDataColumn,
+        spatialDataType: 'h3',
+        q: sqlQuery
+    };
+    if (aggregationResLevel) {
+        urlParameters.aggregationResLevel = String(aggregationResLevel);
+    }
+    if (queryParameters) {
+        urlParameters.queryParameters = JSON.stringify(queryParameters);
+    }
+    return baseSource('query', options, urlParameters);
+};

package/dist/sources/h3-table-source.js

@@ -0,0 +1,18 @@
+/* eslint-disable camelcase */
+import { baseSource } from "./base-source.js";
+export const h3TableSource = async function (options) {
+    const { aggregationExp, aggregationResLevel = 4, columns, spatialDataColumn = 'h3', tableName } = options;
+    const urlParameters = {
+        aggregationExp,
+        name: tableName,
+        spatialDataColumn,
+        spatialDataType: 'h3'
+    };
+    if (aggregationResLevel) {
+        urlParameters.aggregationResLevel = String(aggregationResLevel);
+    }
+    if (columns) {
+        urlParameters.columns = columns.join(',');
+    }
+    return baseSource('table', options, urlParameters);
+};

package/dist/sources/h3-tileset-source.js

@@ -0,0 +1,6 @@
+import { baseSource } from "./base-source.js";
+export const h3TilesetSource = async function (options) {
+    const { tableName } = options;
+    const urlParameters = { name: tableName };
+    return baseSource('tileset', options, urlParameters);
+};

package/dist/sources/index.js

@@ -0,0 +1,13 @@
+export { SOURCE_DEFAULTS } from "./base-source.js";
+export { boundaryQuerySource } from "./boundary-query-source.js";
+export { boundaryTableSource } from "./boundary-table-source.js";
+export { h3QuerySource } from "./h3-query-source.js";
+export { h3TableSource } from "./h3-table-source.js";
+export { h3TilesetSource } from "./h3-tileset-source.js";
+export { rasterSource } from "./raster-source.js";
+export { quadbinQuerySource } from "./quadbin-query-source.js";
+export { quadbinTableSource } from "./quadbin-table-source.js";
+export { quadbinTilesetSource } from "./quadbin-tileset-source.js";
+export { vectorQuerySource } from "./vector-query-source.js";
+export { vectorTableSource } from "./vector-table-source.js";
+export { vectorTilesetSource } from "./vector-tileset-source.js";

package/dist/sources/quadbin-query-source.js

@@ -0,0 +1,18 @@
+/* eslint-disable camelcase */
+import { baseSource } from "./base-source.js";
+export const quadbinQuerySource = async function (options) {
+    const { aggregationExp, aggregationResLevel = 6, sqlQuery, spatialDataColumn = 'quadbin', queryParameters } = options;
+    const urlParameters = {
+        aggregationExp,
+        q: sqlQuery,
+        spatialDataColumn,
+        spatialDataType: 'quadbin'
+    };
+    if (aggregationResLevel) {
+        urlParameters.aggregationResLevel = String(aggregationResLevel);
+    }
+    if (queryParameters) {
+        urlParameters.queryParameters = JSON.stringify(queryParameters);
+    }
+    return baseSource('query', options, urlParameters);
+};

package/dist/sources/quadbin-table-source.js

@@ -0,0 +1,18 @@
+/* eslint-disable camelcase */
+import { baseSource } from "./base-source.js";
+export const quadbinTableSource = async function (options) {
+    const { aggregationExp, aggregationResLevel = 6, columns, spatialDataColumn = 'quadbin', tableName } = options;
+    const urlParameters = {
+        aggregationExp,
+        name: tableName,
+        spatialDataColumn,
+        spatialDataType: 'quadbin'
+    };
+    if (aggregationResLevel) {
+        urlParameters.aggregationResLevel = String(aggregationResLevel);
+    }
+    if (columns) {
+        urlParameters.columns = columns.join(',');
+    }
+    return baseSource('table', options, urlParameters);
+};

package/dist/sources/quadbin-tileset-source.js

@@ -0,0 +1,6 @@
+import { baseSource } from "./base-source.js";
+export const quadbinTilesetSource = async function (options) {
+    const { tableName } = options;
+    const urlParameters = { name: tableName };
+    return baseSource('tileset', options, urlParameters);
+};

package/dist/sources/raster-source.js

@@ -0,0 +1,6 @@
+import { baseSource } from "./base-source.js";
+export const rasterSource = async function (options) {
+    const { tableName } = options;
+    const urlParameters = { name: tableName };
+    return baseSource('raster', options, urlParameters);
+};

package/dist/sources/types.js

@@ -0,0 +1 @@
+export {};

package/dist/sources/vector-query-source.js

@@ -0,0 +1,10 @@
+/* eslint-disable camelcase */
+import { baseSource } from "./base-source.js";
+export const vectorQuerySource = async function (options) {
+    const { spatialDataColumn = 'geom', sqlQuery, queryParameters } = options;
+    const urlParameters = { spatialDataColumn, spatialDataType: 'geo', q: sqlQuery };
+    if (queryParameters) {
+        urlParameters.queryParameters = JSON.stringify(queryParameters);
+    }
+    return baseSource('query', options, urlParameters);
+};

package/dist/sources/vector-table-source.js

@@ -0,0 +1,10 @@
+/* eslint-disable camelcase */
+import { baseSource } from "./base-source.js";
+export const vectorTableSource = async function (options) {
+    const { columns, spatialDataColumn = 'geom', tableName } = options;
+    const urlParameters = { name: tableName, spatialDataColumn, spatialDataType: 'geo' };
+    if (columns) {
+        urlParameters.columns = columns.join(',');
+    }
+    return baseSource('table', options, urlParameters);
+};

package/dist/sources/vector-tileset-source.js

@@ -0,0 +1,6 @@
+import { baseSource } from "./base-source.js";
+export const vectorTilesetSource = async function (options) {
+    const { tableName } = options;
+    const urlParameters = { name: tableName };
+    return baseSource('tileset', options, urlParameters);
+};

package/dist/style/color-bins-style.js

@@ -0,0 +1,21 @@
+import { scaleThreshold } from 'd3-scale';
+import getPalette, { DEFAULT_PALETTE, NULL_COLOR } from "./palette.js";
+import { assert } from "../utils.js";
+import { getAttrValue } from "./utils.js";
+/**
+ * Helper function for quickly creating a color bins style based on `d3` `scaleThreshold`.
+ *
+ * Data values of each attribute are rounded down to the nearest value in the domain and are then
+ * styled with the corresponding color.
+ *
+ * @return accessor that maps objects to `Color` values
+ */
+export default function colorBins({ attr, domain, colors = DEFAULT_PALETTE, nullColor = NULL_COLOR }) {
+    assert(Array.isArray(domain), 'Expected "domain" to be an array of numbers');
+    const palette = typeof colors === 'string' ? getPalette(colors, domain.length + 1) : colors;
+    const color = scaleThreshold().domain(domain).range(palette);
+    return d => {
+        const value = getAttrValue(attr, d);
+        return typeof value === 'number' && Number.isFinite(value) ? color(value) : nullColor;
+    };
+}

package/dist/style/color-categories-style.js

@@ -0,0 +1,25 @@
+import getPalette, { DEFAULT_PALETTE, NULL_COLOR, OTHERS_COLOR } from "./palette.js";
+import { assert } from "../utils.js";
+import { getAttrValue } from "./utils.js";
+/**
+ * Helper function for quickly creating a color category style.
+ *
+ * Data values of each attribute listed in the domain are mapped one to one
+ * with corresponding colors in the range.
+ *
+ * @return accessor that maps objects to `Color` values
+ */
+export default function colorCategories({ attr, domain, colors = DEFAULT_PALETTE, nullColor = NULL_COLOR, othersColor = OTHERS_COLOR }) {
+    assert(Array.isArray(domain), 'Expected "domain" to be an array of numbers or strings');
+    const colorsByCategory = {};
+    const palette = typeof colors === 'string' ? getPalette(colors, domain.length) : colors;
+    for (const [i, c] of domain.entries()) {
+        colorsByCategory[c] = palette[i];
+    }
+    return d => {
+        const value = getAttrValue(attr, d);
+        return (typeof value === 'number' && Number.isFinite(value)) || typeof value === 'string'
+            ? colorsByCategory[value] || othersColor
+            : nullColor;
+    };
+}

package/dist/style/color-continuous-style.js

@@ -0,0 +1,21 @@
+import { scaleLinear } from 'd3-scale';
+import getPalette, { DEFAULT_PALETTE, NULL_COLOR } from "./palette.js";
+import { assert } from "../utils.js";
+import { getAttrValue } from "./utils.js";
+/**
+ * Helper function for quickly creating a color continuous style.
+ *
+ * Data values of each field are interpolated linearly across values in the domain and
+ * are then styled with a blend of the corresponding color in the range.
+ *
+ * @return accessor that maps objects to `Color` values
+ */
+export default function colorContinuous({ attr, domain, colors = DEFAULT_PALETTE, nullColor = NULL_COLOR }) {
+    assert(Array.isArray(domain), 'Expected "domain" to be an array of numbers');
+    const palette = typeof colors === 'string' ? getPalette(colors, domain.length) : colors;
+    const color = scaleLinear().domain(domain).range(palette);
+    return d => {
+        const value = getAttrValue(attr, d);
+        return typeof value === 'number' && Number.isFinite(value) ? color(value) : nullColor;
+    };
+}

package/dist/style/palette.js

@@ -0,0 +1,62 @@
+import * as cartoColors from 'cartocolor';
+import { assert } from "../utils.js";
+export const DEFAULT_PALETTE = 'PurpOr';
+export const NULL_COLOR = [204, 204, 204];
+export const OTHERS_COLOR = [119, 119, 119];
+export default function getPalette(name, numCategories) {
+    const palette = cartoColors[name];
+    let paletteIndex = numCategories;
+    assert(palette, `Palette "${name}" not found. Expected a CARTOColors string`);
+    const palettesColorVariants = Object.keys(palette)
+        .filter(p => p !== 'tags')
+        .map(Number);
+    const longestPaletteIndex = Math.max(...palettesColorVariants);
+    const smallestPaletteIndex = Math.min(...palettesColorVariants);
+    if (!Number.isInteger(numCategories) || numCategories > longestPaletteIndex) {
+        paletteIndex = longestPaletteIndex;
+    }
+    else if (numCategories < smallestPaletteIndex) {
+        paletteIndex = smallestPaletteIndex;
+    }
+    let colors = palette[paletteIndex];
+    if (palette.tags && palette.tags.includes('qualitative')) {
+        colors = colors.slice(0, -1);
+    }
+    return colors.map(c => hexToRgb(c));
+}
+export function hexToRgb(hex) {
+    // Evaluate #ABC
+    let result = /^#?([a-f\d]{1})([a-f\d]{1})([a-f\d]{1})$/i.exec(hex);
+    if (result) {
+        return [
+            parseInt(result[1] + result[1], 16),
+            parseInt(result[2] + result[2], 16),
+            parseInt(result[3] + result[3], 16),
+            255
+        ];
+    }
+    // Evaluate #ABCD
+    result = /^#?([a-f\d]{1})([a-f\d]{1})([a-f\d]{1})([a-f\d]{1})$/i.exec(hex);
+    if (result) {
+        return [
+            parseInt(result[1] + result[1], 16),
+            parseInt(result[2] + result[2], 16),
+            parseInt(result[3] + result[3], 16),
+            parseInt(result[4] + result[4], 16)
+        ];
+    }
+    // Evaluate #ABCDEF
+    result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
+    if (result) {
+        return [parseInt(result[1], 16), parseInt(result[2], 16), parseInt(result[3], 16), 255];
+    }
+    // Evaluate #ABCDEFAF
+    result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
+    assert(result, `Hexadecimal color "${hex}" was not parsed correctly`);
+    return [
+        parseInt(result[1], 16),
+        parseInt(result[2], 16),
+        parseInt(result[3], 16),
+        parseInt(result[4], 16)
+    ];
+}

package/dist/style/utils.js

@@ -0,0 +1,11 @@
+import { assert } from "../utils.js";
+const ALLOWED_ATTR_TYPES = Object.freeze(['function', 'string']);
+export function getAttrValue(attr, d) {
+    assert(typeof d === 'object', 'Expected "data" to be an object');
+    assert(ALLOWED_ATTR_TYPES.includes(typeof attr), 'Expected "attr" to be a function or string');
+    // Is function
+    if (typeof attr === 'function') {
+        return attr(d);
+    }
+    return d?.properties?.[attr];
+}

package/dist/utils.js

@@ -0,0 +1,41 @@
+import { log } from '@deck.gl/core';
+export function assert(condition, message) {
+    log.assert(condition, message);
+}
+// Returns a Proxy object that allows accessing binary data
+// as if it were JSON properties
+export function createBinaryProxy(data, index) {
+    const { properties, numericProps } = data;
+    return new Proxy(properties[index] || {}, {
+        get(target, property) {
+            if (property in numericProps) {
+                return numericProps[property].value[index];
+            }
+            return target[property];
+        },
+        has(target, property) {
+            return property in numericProps || property in target;
+        }
+    });
+}
+export function getWorkerUrl(id, version) {
+    // For local testing `yarn build-workers` and then host `modules/carto/dist/`
+    // return `http://localhost:8081/dist/${id}-worker.js`;
+    return `https://unpkg.com/@deck.gl/carto@${version}/dist/${id}-worker.js`;
+}
+export function scaleIdentity() {
+    let unknown;
+    function scale(x) {
+        return x === null ? unknown : x;
+    }
+    scale.invert = scale;
+    scale.domain = scale.range = d => d;
+    scale.unknown = u => {
+        if (u) {
+            unknown = u;
+        }
+        return unknown;
+    };
+    scale.copy = () => scaleIdentity().unknown(unknown);
+    return scale;
+}

package/dist/workers/cartoRasterTile.js

@@ -0,0 +1,3 @@
+import { createLoaderWorker } from '@loaders.gl/loader-utils';
+import CartoRasterTileLoader from "../layers/schema/carto-raster-tile-loader.js";
+createLoaderWorker(CartoRasterTileLoader);

package/dist/workers/cartoSpatialTile.js

@@ -0,0 +1,3 @@
+import { createLoaderWorker } from '@loaders.gl/loader-utils';
+import CartoSpatialTileLoader from "../layers/schema/carto-spatial-tile-loader.js";
+createLoaderWorker(CartoSpatialTileLoader);

package/dist/workers/cartoVectorTile.js

@@ -0,0 +1,3 @@
+import { createLoaderWorker } from '@loaders.gl/loader-utils';
+import CartoVectorTileLoader from "../layers/schema/carto-vector-tile-loader.js";
+createLoaderWorker(CartoVectorTileLoader);