@loaders.gl/gis 4.2.0-alpha.4 → 4.2.0-alpha.5

package/dist/lib/binary-features/binary-to-geojson.js

@@ -1,198 +1,202 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/**
+ * Convert binary geometry representation to GeoJSON
+ * @param data   geometry data in binary representation
+ * @param options
+ * @param options.type  Input data type: Point, LineString, or Polygon
+ * @param options.featureId  Global feature id. If specified, only a single feature is extracted
+ * @return GeoJSON objects
+ */
 export function binaryToGeojson(data, options) {
-  const globalFeatureId = options === null || options === void 0 ? void 0 : options.globalFeatureId;
-  if (globalFeatureId !== undefined) {
-    return getSingleFeature(data, globalFeatureId);
-  }
-  return parseFeatures(data, options === null || options === void 0 ? void 0 : options.type);
+    const globalFeatureId = options?.globalFeatureId;
+    if (globalFeatureId !== undefined) {
+        return getSingleFeature(data, globalFeatureId);
+    }
+    return parseFeatures(data, options?.type);
 }
+/**
+ * Return a single feature from a binary geometry representation as GeoJSON
+ * @param data   geometry data in binary representation
+ * @return GeoJSON feature
+ */
 function getSingleFeature(data, globalFeatureId) {
-  const dataArray = normalizeInput(data);
-  for (const data of dataArray) {
-    let lastIndex = 0;
-    let lastValue = data.featureIds.value[0];
-    for (let i = 0; i < data.featureIds.value.length; i++) {
-      const currValue = data.featureIds.value[i];
-      if (currValue === lastValue) {
-        continue;
-      }
-      if (globalFeatureId === data.globalFeatureIds.value[lastIndex]) {
-        return parseFeature(data, lastIndex, i);
-      }
-      lastIndex = i;
-      lastValue = currValue;
-    }
-    if (globalFeatureId === data.globalFeatureIds.value[lastIndex]) {
-      return parseFeature(data, lastIndex, data.featureIds.value.length);
+    const dataArray = normalizeInput(data);
+    for (const data of dataArray) {
+        let lastIndex = 0;
+        let lastValue = data.featureIds.value[0];
+        // Scan through data until we find matching feature
+        for (let i = 0; i < data.featureIds.value.length; i++) {
+            const currValue = data.featureIds.value[i];
+            if (currValue === lastValue) {
+                // eslint-disable-next-line no-continue
+                continue;
+            }
+            if (globalFeatureId === data.globalFeatureIds.value[lastIndex]) {
+                return parseFeature(data, lastIndex, i);
+            }
+            lastIndex = i;
+            lastValue = currValue;
+        }
+        if (globalFeatureId === data.globalFeatureIds.value[lastIndex]) {
+            return parseFeature(data, lastIndex, data.featureIds.value.length);
+        }
     }
-  }
-  throw new Error(`featureId:${globalFeatureId} not found`);
+    throw new Error(`featureId:${globalFeatureId} not found`);
 }
 function parseFeatures(data, type) {
-  const dataArray = normalizeInput(data, type);
-  return parseFeatureCollection(dataArray);
+    const dataArray = normalizeInput(data, type);
+    return parseFeatureCollection(dataArray);
 }
+/** Parse input binary data and return a valid GeoJSON geometry object */
 export function binaryToGeometry(data, startIndex, endIndex) {
-  switch (data.type) {
-    case 'Point':
-      return pointToGeoJson(data, startIndex, endIndex);
-    case 'LineString':
-      return lineStringToGeoJson(data, startIndex, endIndex);
-    case 'Polygon':
-      return polygonToGeoJson(data, startIndex, endIndex);
-    default:
-      const unexpectedInput = data;
-      throw new Error(`Unsupported geometry type: ${unexpectedInput === null || unexpectedInput === void 0 ? void 0 : unexpectedInput.type}`);
-  }
+    switch (data.type) {
+        case 'Point':
+            return pointToGeoJson(data, startIndex, endIndex);
+        case 'LineString':
+            return lineStringToGeoJson(data, startIndex, endIndex);
+        case 'Polygon':
+            return polygonToGeoJson(data, startIndex, endIndex);
+        default:
+            const unexpectedInput = data;
+            throw new Error(`Unsupported geometry type: ${unexpectedInput?.type}`);
+    }
 }
+// Normalize features
+// Return an array of data objects, each of which have a type key
 function normalizeInput(data, type) {
-  const features = [];
-  if (data.points) {
-    data.points.type = 'Point';
-    features.push(data.points);
-  }
-  if (data.lines) {
-    data.lines.type = 'LineString';
-    features.push(data.lines);
-  }
-  if (data.polygons) {
-    data.polygons.type = 'Polygon';
-    features.push(data.polygons);
-  }
-  return features;
+    const features = [];
+    if (data.points) {
+        data.points.type = 'Point';
+        features.push(data.points);
+    }
+    if (data.lines) {
+        data.lines.type = 'LineString';
+        features.push(data.lines);
+    }
+    if (data.polygons) {
+        data.polygons.type = 'Polygon';
+        features.push(data.polygons);
+    }
+    return features;
 }
+/** Parse input binary data and return an array of GeoJSON Features */
 function parseFeatureCollection(dataArray) {
-  const features = [];
-  for (const data of dataArray) {
-    if (data.featureIds.value.length === 0) {
-      continue;
-    }
-    let lastIndex = 0;
-    let lastValue = data.featureIds.value[0];
-    for (let i = 0; i < data.featureIds.value.length; i++) {
-      const currValue = data.featureIds.value[i];
-      if (currValue === lastValue) {
-        continue;
-      }
-      features.push(parseFeature(data, lastIndex, i));
-      lastIndex = i;
-      lastValue = currValue;
+    const features = [];
+    for (const data of dataArray) {
+        if (data.featureIds.value.length === 0) {
+            // eslint-disable-next-line no-continue
+            continue;
+        }
+        let lastIndex = 0;
+        let lastValue = data.featureIds.value[0];
+        // Need to deduce start, end indices of each feature
+        for (let i = 0; i < data.featureIds.value.length; i++) {
+            const currValue = data.featureIds.value[i];
+            if (currValue === lastValue) {
+                // eslint-disable-next-line no-continue
+                continue;
+            }
+            features.push(parseFeature(data, lastIndex, i));
+            lastIndex = i;
+            lastValue = currValue;
+        }
+        // Last feature
+        features.push(parseFeature(data, lastIndex, data.featureIds.value.length));
     }
-    features.push(parseFeature(data, lastIndex, data.featureIds.value.length));
-  }
-  return features;
+    return features;
 }
+/** Parse input binary data and return a single GeoJSON Feature */
 function parseFeature(data, startIndex, endIndex) {
-  const geometry = binaryToGeometry(data, startIndex, endIndex);
-  const properties = parseProperties(data, startIndex, endIndex);
-  const fields = parseFields(data, startIndex, endIndex);
-  return {
-    type: 'Feature',
-    geometry,
-    properties,
-    ...fields
-  };
+    const geometry = binaryToGeometry(data, startIndex, endIndex);
+    const properties = parseProperties(data, startIndex, endIndex);
+    const fields = parseFields(data, startIndex, endIndex);
+    return { type: 'Feature', geometry, properties, ...fields };
 }
-function parseFields(data) {
-  let startIndex = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
-  let endIndex = arguments.length > 2 ? arguments[2] : undefined;
-  return data.fields && data.fields[data.featureIds.value[startIndex]];
+/** Parse input binary data and return an object of fields */
+function parseFields(data, startIndex = 0, endIndex) {
+    return data.fields && data.fields[data.featureIds.value[startIndex]];
 }
-function parseProperties(data) {
-  let startIndex = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
-  let endIndex = arguments.length > 2 ? arguments[2] : undefined;
-  const properties = Object.assign({}, data.properties[data.featureIds.value[startIndex]]);
-  for (const key in data.numericProps) {
-    properties[key] = data.numericProps[key].value[startIndex];
-  }
-  return properties;
+/** Parse input binary data and return an object of properties */
+function parseProperties(data, startIndex = 0, endIndex) {
+    const properties = Object.assign({}, data.properties[data.featureIds.value[startIndex]]);
+    for (const key in data.numericProps) {
+        properties[key] = data.numericProps[key].value[startIndex];
+    }
+    return properties;
 }
-function polygonToGeoJson(data) {
-  let startIndex = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : -Infinity;
-  let endIndex = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : Infinity;
-  const {
-    positions
-  } = data;
-  const polygonIndices = data.polygonIndices.value.filter(x => x >= startIndex && x <= endIndex);
-  const primitivePolygonIndices = data.primitivePolygonIndices.value.filter(x => x >= startIndex && x <= endIndex);
-  const multi = polygonIndices.length > 2;
-  if (!multi) {
+/** Parse binary data of type Polygon */
+function polygonToGeoJson(data, startIndex = -Infinity, endIndex = Infinity) {
+    const { positions } = data;
+    const polygonIndices = data.polygonIndices.value.filter((x) => x >= startIndex && x <= endIndex);
+    const primitivePolygonIndices = data.primitivePolygonIndices.value.filter((x) => x >= startIndex && x <= endIndex);
+    const multi = polygonIndices.length > 2;
+    // Polygon
+    if (!multi) {
+        const coordinates = [];
+        for (let i = 0; i < primitivePolygonIndices.length - 1; i++) {
+            const startRingIndex = primitivePolygonIndices[i];
+            const endRingIndex = primitivePolygonIndices[i + 1];
+            const ringCoordinates = ringToGeoJson(positions, startRingIndex, endRingIndex);
+            coordinates.push(ringCoordinates);
+        }
+        return { type: 'Polygon', coordinates };
+    }
+    // MultiPolygon
     const coordinates = [];
-    for (let i = 0; i < primitivePolygonIndices.length - 1; i++) {
-      const startRingIndex = primitivePolygonIndices[i];
-      const endRingIndex = primitivePolygonIndices[i + 1];
-      const ringCoordinates = ringToGeoJson(positions, startRingIndex, endRingIndex);
-      coordinates.push(ringCoordinates);
+    for (let i = 0; i < polygonIndices.length - 1; i++) {
+        const startPolygonIndex = polygonIndices[i];
+        const endPolygonIndex = polygonIndices[i + 1];
+        const polygonCoordinates = polygonToGeoJson(data, startPolygonIndex, endPolygonIndex).coordinates;
+        coordinates.push(polygonCoordinates);
     }
-    return {
-      type: 'Polygon',
-      coordinates
-    };
-  }
-  const coordinates = [];
-  for (let i = 0; i < polygonIndices.length - 1; i++) {
-    const startPolygonIndex = polygonIndices[i];
-    const endPolygonIndex = polygonIndices[i + 1];
-    const polygonCoordinates = polygonToGeoJson(data, startPolygonIndex, endPolygonIndex).coordinates;
-    coordinates.push(polygonCoordinates);
-  }
-  return {
-    type: 'MultiPolygon',
-    coordinates
-  };
+    return { type: 'MultiPolygon', coordinates };
 }
-function lineStringToGeoJson(data) {
-  let startIndex = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : -Infinity;
-  let endIndex = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : Infinity;
-  const {
-    positions
-  } = data;
-  const pathIndices = data.pathIndices.value.filter(x => x >= startIndex && x <= endIndex);
-  const multi = pathIndices.length > 2;
-  if (!multi) {
-    const coordinates = ringToGeoJson(positions, pathIndices[0], pathIndices[1]);
-    return {
-      type: 'LineString',
-      coordinates
-    };
-  }
-  const coordinates = [];
-  for (let i = 0; i < pathIndices.length - 1; i++) {
-    const ringCoordinates = ringToGeoJson(positions, pathIndices[i], pathIndices[i + 1]);
-    coordinates.push(ringCoordinates);
-  }
-  return {
-    type: 'MultiLineString',
-    coordinates
-  };
+/** Parse binary data of type LineString */
+function lineStringToGeoJson(data, startIndex = -Infinity, endIndex = Infinity) {
+    const { positions } = data;
+    const pathIndices = data.pathIndices.value.filter((x) => x >= startIndex && x <= endIndex);
+    const multi = pathIndices.length > 2;
+    if (!multi) {
+        const coordinates = ringToGeoJson(positions, pathIndices[0], pathIndices[1]);
+        return { type: 'LineString', coordinates };
+    }
+    const coordinates = [];
+    for (let i = 0; i < pathIndices.length - 1; i++) {
+        const ringCoordinates = ringToGeoJson(positions, pathIndices[i], pathIndices[i + 1]);
+        coordinates.push(ringCoordinates);
+    }
+    return { type: 'MultiLineString', coordinates };
 }
+/** Parse binary data of type Point */
 function pointToGeoJson(data, startIndex, endIndex) {
-  const {
-    positions
-  } = data;
-  const coordinates = ringToGeoJson(positions, startIndex, endIndex);
-  const multi = coordinates.length > 1;
-  if (multi) {
-    return {
-      type: 'MultiPoint',
-      coordinates
-    };
-  }
-  return {
-    type: 'Point',
-    coordinates: coordinates[0]
-  };
+    const { positions } = data;
+    const coordinates = ringToGeoJson(positions, startIndex, endIndex);
+    const multi = coordinates.length > 1;
+    if (multi) {
+        return { type: 'MultiPoint', coordinates };
+    }
+    return { type: 'Point', coordinates: coordinates[0] };
 }
+/**
+ * Parse a linear ring of positions to a GeoJSON linear ring
+ *
+ * @param positions Positions TypedArray
+ * @param startIndex Start index to include in ring
+ * @param endIndex End index to include in ring
+ * @returns GeoJSON ring
+ */
 function ringToGeoJson(positions, startIndex, endIndex) {
-  startIndex = startIndex || 0;
-  endIndex = endIndex || positions.value.length / positions.size;
-  const ringCoordinates = [];
-  for (let j = startIndex; j < endIndex; j++) {
-    const coord = Array();
-    for (let k = j * positions.size; k < (j + 1) * positions.size; k++) {
-      coord.push(Number(positions.value[k]));
+    startIndex = startIndex || 0;
+    endIndex = endIndex || positions.value.length / positions.size;
+    const ringCoordinates = [];
+    for (let j = startIndex; j < endIndex; j++) {
+        const coord = Array();
+        for (let k = j * positions.size; k < (j + 1) * positions.size; k++) {
+            coord.push(Number(positions.value[k]));
+        }
+        ringCoordinates.push(coord);
     }
-    ringCoordinates.push(coord);
-  }
-  return ringCoordinates;
+    return ringCoordinates;
 }
-//# sourceMappingURL=binary-to-geojson.js.map

package/dist/lib/binary-features/extract-geometry-info.js

@@ -1,84 +1,92 @@
+/**
+ *  Initial scan over GeoJSON features
+ *  Counts number of coordinates of each geometry type and
+ *  keeps track of the max coordinate dimensions
+ */
+// eslint-disable-next-line complexity, max-statements
 export function extractGeometryInfo(features) {
-  let pointPositionsCount = 0;
-  let pointFeaturesCount = 0;
-  let linePositionsCount = 0;
-  let linePathsCount = 0;
-  let lineFeaturesCount = 0;
-  let polygonPositionsCount = 0;
-  let polygonObjectsCount = 0;
-  let polygonRingsCount = 0;
-  let polygonFeaturesCount = 0;
-  const coordLengths = new Set();
-  for (const feature of features) {
-    const geometry = feature.geometry;
-    switch (geometry.type) {
-      case 'Point':
-        pointFeaturesCount++;
-        pointPositionsCount++;
-        coordLengths.add(geometry.coordinates.length);
-        break;
-      case 'MultiPoint':
-        pointFeaturesCount++;
-        pointPositionsCount += geometry.coordinates.length;
-        for (const point of geometry.coordinates) {
-          coordLengths.add(point.length);
+    // Counts the number of _positions_, so [x, y, z] counts as one
+    let pointPositionsCount = 0;
+    let pointFeaturesCount = 0;
+    let linePositionsCount = 0;
+    let linePathsCount = 0;
+    let lineFeaturesCount = 0;
+    let polygonPositionsCount = 0;
+    let polygonObjectsCount = 0;
+    let polygonRingsCount = 0;
+    let polygonFeaturesCount = 0;
+    const coordLengths = new Set();
+    for (const feature of features) {
+        const geometry = feature.geometry;
+        switch (geometry.type) {
+            case 'Point':
+                pointFeaturesCount++;
+                pointPositionsCount++;
+                coordLengths.add(geometry.coordinates.length);
+                break;
+            case 'MultiPoint':
+                pointFeaturesCount++;
+                pointPositionsCount += geometry.coordinates.length;
+                for (const point of geometry.coordinates) {
+                    coordLengths.add(point.length);
+                }
+                break;
+            case 'LineString':
+                lineFeaturesCount++;
+                linePositionsCount += geometry.coordinates.length;
+                linePathsCount++;
+                for (const coord of geometry.coordinates) {
+                    coordLengths.add(coord.length);
+                }
+                break;
+            case 'MultiLineString':
+                lineFeaturesCount++;
+                for (const line of geometry.coordinates) {
+                    linePositionsCount += line.length;
+                    linePathsCount++;
+                    // eslint-disable-next-line max-depth
+                    for (const coord of line) {
+                        coordLengths.add(coord.length);
+                    }
+                }
+                break;
+            case 'Polygon':
+                polygonFeaturesCount++;
+                polygonObjectsCount++;
+                polygonRingsCount += geometry.coordinates.length;
+                const flattened = geometry.coordinates.flat();
+                polygonPositionsCount += flattened.length;
+                for (const coord of flattened) {
+                    coordLengths.add(coord.length);
+                }
+                break;
+            case 'MultiPolygon':
+                polygonFeaturesCount++;
+                for (const polygon of geometry.coordinates) {
+                    polygonObjectsCount++;
+                    polygonRingsCount += polygon.length;
+                    const flattened = polygon.flat();
+                    polygonPositionsCount += flattened.length;
+                    // eslint-disable-next-line max-depth
+                    for (const coord of flattened) {
+                        coordLengths.add(coord.length);
+                    }
+                }
+                break;
+            default:
+                throw new Error(`Unsupported geometry type: ${geometry.type}`);
         }
-        break;
-      case 'LineString':
-        lineFeaturesCount++;
-        linePositionsCount += geometry.coordinates.length;
-        linePathsCount++;
-        for (const coord of geometry.coordinates) {
-          coordLengths.add(coord.length);
-        }
-        break;
-      case 'MultiLineString':
-        lineFeaturesCount++;
-        for (const line of geometry.coordinates) {
-          linePositionsCount += line.length;
-          linePathsCount++;
-          for (const coord of line) {
-            coordLengths.add(coord.length);
-          }
-        }
-        break;
-      case 'Polygon':
-        polygonFeaturesCount++;
-        polygonObjectsCount++;
-        polygonRingsCount += geometry.coordinates.length;
-        const flattened = geometry.coordinates.flat();
-        polygonPositionsCount += flattened.length;
-        for (const coord of flattened) {
-          coordLengths.add(coord.length);
-        }
-        break;
-      case 'MultiPolygon':
-        polygonFeaturesCount++;
-        for (const polygon of geometry.coordinates) {
-          polygonObjectsCount++;
-          polygonRingsCount += polygon.length;
-          const flattened = polygon.flat();
-          polygonPositionsCount += flattened.length;
-          for (const coord of flattened) {
-            coordLengths.add(coord.length);
-          }
-        }
-        break;
-      default:
-        throw new Error(`Unsupported geometry type: ${geometry.type}`);
     }
-  }
-  return {
-    coordLength: coordLengths.size > 0 ? Math.max(...coordLengths) : 2,
-    pointPositionsCount,
-    pointFeaturesCount,
-    linePositionsCount,
-    linePathsCount,
-    lineFeaturesCount,
-    polygonPositionsCount,
-    polygonObjectsCount,
-    polygonRingsCount,
-    polygonFeaturesCount
-  };
+    return {
+        coordLength: coordLengths.size > 0 ? Math.max(...coordLengths) : 2,
+        pointPositionsCount,
+        pointFeaturesCount,
+        linePositionsCount,
+        linePathsCount,
+        lineFeaturesCount,
+        polygonPositionsCount,
+        polygonObjectsCount,
+        polygonRingsCount,
+        polygonFeaturesCount
+    };
 }
-//# sourceMappingURL=extract-geometry-info.js.map

package/dist/lib/binary-features/flat-geojson-to-binary-types.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=flat-geojson-to-binary-types.js.map

package/dist/lib/binary-features/flat-geojson-to-binary.d.ts

@@ -1,5 +1,5 @@
 import type { BinaryFeatureCollection, FlatFeature, GeojsonGeometryInfo } from '@loaders.gl/schema';
-import { PropArrayConstructor } from './flat-geojson-to-binary-types';
+import { PropArrayConstructor } from "./flat-geojson-to-binary-types.js";
 /**
  * Convert binary features to flat binary arrays. Similar to
  * `geojsonToBinary` helper function, except that it expects

package/dist/lib/binary-features/flat-geojson-to-binary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flat-geojson-to-binary.d.ts","sourceRoot":"","sources":["../../../src/lib/binary-features/flat-geojson-to-binary.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,uBAAuB,EAEvB,WAAW,EAIX,mBAAmB,EAEpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAC,oBAAoB,EAA0B,MAAM,gCAAgC,CAAC;AAE7F;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,WAAW,EAAE,EACvB,YAAY,EAAE,mBAAmB,EACjC,OAAO,CAAC,EAAE,0BAA0B,2BAgBrC;AAED;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,gBAAgB,CAAC,EAAE,uBAAuB,GAAG,uBAAuB,CAAC;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,YAAY;;CAExB,CAAC;AAEF;;;;;GAKG;AACH,iBAAS,uBAAuB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG;IACzD,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAAC;CACrC,CAgBA"}
+{"version":3,"file":"flat-geojson-to-binary.d.ts","sourceRoot":"","sources":["../../../src/lib/binary-features/flat-geojson-to-binary.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,uBAAuB,EAEvB,WAAW,EAIX,mBAAmB,EAEpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAC,oBAAoB,EAA0B,0CAAuC;AAE7F;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,WAAW,EAAE,EACvB,YAAY,EAAE,mBAAmB,EACjC,OAAO,CAAC,EAAE,0BAA0B,2BAgBrC;AAED;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,gBAAgB,CAAC,EAAE,uBAAuB,GAAG,uBAAuB,CAAC;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,YAAY;;CAExB,CAAC;AAEF;;;;;GAKG;AACH,iBAAS,uBAAuB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG;IACzD,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAAC;CACrC,CAgBA"}