@loaders.gl/mvt 4.2.1 → 4.3.0-alpha.2

package/dist/index.d.ts

@@ -4,6 +4,6 @@ export type { TileJSON } from "./lib/parse-tilejson.js";
 export type { TileJSONLoaderOptions } from "./tilejson-loader.js";
 export { TileJSONLoader } from "./tilejson-loader.js";
 export { MVTSource } from "./mvt-source.js";
-export type { GeoJSONTilerOptions } from "./lib/geojson-tiler/geojson-tiler.js";
-export { GeoJSONTiler } from "./lib/geojson-tiler/geojson-tiler.js";
+export type { TableTileSourceProps } from "./table-tile-source.js";
+export { TableTileSource } from "./table-tile-source.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,YAAY,EAAC,gBAAgB,EAAC,wBAAqB;AACnD,OAAO,EAAC,SAAS,EAAE,eAAe,EAAC,wBAAqB;AAExD,YAAY,EAAC,QAAQ,EAAC,gCAA6B;AACnD,YAAY,EAAC,qBAAqB,EAAC,6BAA0B;AAC7D,OAAO,EAAC,cAAc,EAAC,6BAA0B;AAEjD,OAAO,EAAC,SAAS,EAAC,wBAAqB;AAIvC,YAAY,EAAC,mBAAmB,EAAC,6CAA0C;AAC3E,OAAO,EAAC,YAAY,EAAC,6CAA0C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,YAAY,EAAC,gBAAgB,EAAC,wBAAqB;AACnD,OAAO,EAAC,SAAS,EAAE,eAAe,EAAC,wBAAqB;AAExD,YAAY,EAAC,QAAQ,EAAC,gCAA6B;AACnD,YAAY,EAAC,qBAAqB,EAAC,6BAA0B;AAC7D,OAAO,EAAC,cAAc,EAAC,6BAA0B;AAEjD,OAAO,EAAC,SAAS,EAAC,wBAAqB;AAIvC,YAAY,EAAC,oBAAoB,EAAC,+BAA4B;AAC9D,OAAO,EAAC,eAAe,EAAC,+BAA4B"}

package/dist/index.js

@@ -4,4 +4,4 @@
 export { MVTLoader, MVTWorkerLoader } from "./mvt-loader.js";
 export { TileJSONLoader } from "./tilejson-loader.js";
 export { MVTSource } from "./mvt-source.js";
-export { GeoJSONTiler } from "./lib/geojson-tiler/geojson-tiler.js";
+export { TableTileSource } from "./table-tile-source.js";

package/dist/lib/parse-mvt.d.ts

@@ -1,4 +1,5 @@
-import type { Feature, BinaryFeatureCollection, GeoJSONTable } from '@loaders.gl/schema';
+import type { Feature } from '@loaders.gl/schema';
+import type { GeoJSONTable, BinaryFeatureCollection } from '@loaders.gl/schema';
 import type { MVTLoaderOptions } from "../mvt-loader.js";
 /**
  * Parse MVT arrayBuffer and return GeoJSON.

package/dist/lib/parse-mvt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-mvt.d.ts","sourceRoot":"","sources":["../../src/lib/parse-mvt.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,OAAO,EAEP,uBAAuB,EACvB,YAAY,EACb,MAAM,oBAAoB,CAAC;AAI5B,OAAO,KAAK,EAAC,gBAAgB,EAAC,yBAAsB;AAOpD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,gBAAgB;;;EAyB5E"}
+{"version":3,"file":"parse-mvt.d.ts","sourceRoot":"","sources":["../../src/lib/parse-mvt.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAc,OAAO,EAAsB,MAAM,oBAAoB,CAAC;AAClF,OAAO,KAAK,EAAC,YAAY,EAAE,uBAAuB,EAAC,MAAM,oBAAoB,CAAC;AAQ9E,OAAO,KAAK,EAAC,gBAAgB,EAAC,yBAAsB;AAGpD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,gBAAgB;;;EAyB5E"}

package/dist/lib/parse-mvt.js

@@ -2,9 +2,9 @@
 // SPDX-License-Identifier: MIT
 // Copyright vis.gl contributors
 import { flatGeojsonToBinary } from '@loaders.gl/gis';
+import { log } from '@loaders.gl/loader-utils';
 import Protobuf from 'pbf';
-import { VectorTile } from "./mapbox-vector-tile/vector-tile.js";
-import { BinaryVectorTile } from "./binary-vector-tile/vector-tile.js";
+import { VectorTile } from "./vector-tile/vector-tile.js";
 /**
  * Parse MVT arrayBuffer and return GeoJSON.
  *
@@ -13,7 +13,7 @@ import { BinaryVectorTile } from "./binary-vector-tile/vector-tile.js";
  * @returns A GeoJSON geometry object or a binary representation
  */
 export function parseMVT(arrayBuffer, options) {
-    const mvtOptions = normalizeOptions(options);
+    const mvtOptions = checkOptions(options);
     const shape = options?.gis?.format || options?.mvt?.shape || options?.shape;
     switch (shape) {
         case 'columnar-table': // binary + some JS arrays
@@ -62,7 +62,7 @@ function parseToFlatGeoJson(arrayBuffer, options) {
     if (arrayBuffer.byteLength <= 0) {
         return [features, geometryInfo];
     }
-    const tile = new BinaryVectorTile(new Protobuf(arrayBuffer));
+    const tile = new VectorTile(new Protobuf(arrayBuffer));
     const selectedLayers = options && Array.isArray(options.layers) ? options.layers : Object.keys(tile.layers);
     selectedLayers.forEach((layerName) => {
         const vectorTileLayer = tile.layers[layerName];
@@ -70,7 +70,7 @@ function parseToFlatGeoJson(arrayBuffer, options) {
             return;
         }
         for (let i = 0; i < vectorTileLayer.length; i++) {
-            const vectorTileFeature = vectorTileLayer.feature(i, geometryInfo);
+            const vectorTileFeature = vectorTileLayer.getBinaryFeature(i, geometryInfo);
             const decodedFeature = getDecodedFeatureBinary(vectorTileFeature, options, layerName);
             features.push(decodedFeature);
         }
@@ -90,27 +90,24 @@ function parseToGeojsonFeatures(arrayBuffer, options) {
             return;
         }
         for (let i = 0; i < vectorTileLayer.length; i++) {
-            const vectorTileFeature = vectorTileLayer.feature(i);
+            const vectorTileFeature = vectorTileLayer.getGeoJSONFeature(i);
             const decodedFeature = getDecodedFeature(vectorTileFeature, options, layerName);
             features.push(decodedFeature);
         }
     });
     return features;
 }
-function normalizeOptions(options) {
+/** Check that options are good */
+function checkOptions(options) {
     if (!options?.mvt) {
         throw new Error('mvt options required');
     }
-    // Validate
-    const wgs84Coordinates = options.mvt?.coordinates === 'wgs84';
-    const { tileIndex } = options.mvt;
-    const hasTileIndex = tileIndex &&
-        Number.isFinite(tileIndex.x) &&
-        Number.isFinite(tileIndex.y) &&
-        Number.isFinite(tileIndex.z);
-    if (wgs84Coordinates && !hasTileIndex) {
+    if (options.mvt?.coordinates === 'wgs84' && !options.mvt.tileIndex) {
         throw new Error('MVT Loader: WGS84 coordinates need tileIndex property');
     }
+    if (options.gis) {
+        log.warn('MVTLoader: "options.gis" is deprecated, use "options.mvt.shape" instead')();
+    }
     return options.mvt;
 }
 /**
@@ -119,11 +116,10 @@ function normalizeOptions(options) {
  * @returns decoded feature
  */
 function getDecodedFeature(feature, options, layerName) {
-    const decodedFeature = feature.toGeoJSON(
-    // @ts-expect-error What is going on here?
-    options.coordinates === 'wgs84' ? options.tileIndex : transformToLocalCoordinates);
+    const decodedFeature = feature.toGeoJSONFeature(options.coordinates || 'local', options.tileIndex);
     // Add layer name to GeoJSON properties
     if (options.layerProperty) {
+        decodedFeature.properties ||= {};
         decodedFeature.properties[options.layerProperty] = layerName;
     }
     return decodedFeature;
@@ -134,36 +130,10 @@ function getDecodedFeature(feature, options, layerName) {
  * @returns decoded binary feature
  */
 function getDecodedFeatureBinary(feature, options, layerName) {
-    const decodedFeature = feature.toBinaryCoordinates(
-    // @ts-expect-error
-    options.coordinates === 'wgs84' ? options.tileIndex : transformToLocalCoordinatesBinary);
+    const decodedFeature = feature.toBinaryFeature(options.coordinates || 'local', options.tileIndex);
     // Add layer name to GeoJSON properties
     if (options.layerProperty && decodedFeature.properties) {
         decodedFeature.properties[options.layerProperty] = layerName;
     }
     return decodedFeature;
 }
-/**
- * @param line
- * @param feature
- */
-function transformToLocalCoordinates(line, feature) {
-    // This function transforms local coordinates in a
-    // [0 - bufferSize, this.extent + bufferSize] range to a
-    // [0 - (bufferSize / this.extent), 1 + (bufferSize / this.extent)] range.
-    // The resulting extent would be 1.
-    const { extent } = feature;
-    for (let i = 0; i < line.length; i++) {
-        const p = line[i];
-        p[0] /= extent;
-        p[1] /= extent;
-    }
-}
-function transformToLocalCoordinatesBinary(data, feature) {
-    // For the binary code path, the feature data is just
-    // one big flat array, so we just divide each value
-    const { extent } = feature;
-    for (let i = 0, il = data.length; i < il; ++i) {
-        data[i] /= extent;
-    }
-}

package/dist/lib/parse-tilejson.d.ts

@@ -9,10 +9,6 @@ export type TileJSON = {
     version?: string;
     tileFormat?: string;
     tilesetType?: string;
-    /** Generating application. Tippecanoe adds this. */
-    generator?: string;
-    /** Generating application options. Tippecanoe adds this. */
-    generatorOptions?: string;
     /** Tile indexing scheme */
     scheme?: 'xyz' | 'tms';
     /** Sharded URLs */
@@ -27,6 +23,10 @@ export type TileJSON = {
     htmlAttribution?: string;
     htmlLegend?: string;
     layers?: TileJSONLayer[];
+    /** Generating application. Tippecanoe adds this. */
+    generator?: string;
+    /** Generating application options. Tippecanoe adds this. */
+    generatorOptions?: string;
     /** Any nested JSON metadata */
     metaJson?: any | null;
 };

package/dist/lib/parse-tilejson.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-tilejson.d.ts","sourceRoot":"","sources":["../../src/lib/parse-tilejson.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,GAAG;IAC5B,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,yEAAyE;AACzE,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,2BAA2B;IAC3B,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACvB,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,wHAAwH;IACxH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IACzE,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IAEzB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,2FAA2F;IAC3F,IAAI,EAAE,MAAM,CAAC;IAEb,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IAIrB,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IAEvE,OAAO;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IAIrB,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACpB,CAAC;AA+CF;;;;;GAKG;AAEH,wBAAgB,aAAa,CAAC,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,eAAe,GAAG,QAAQ,GAAG,IAAI,CAiE1F"}
+{"version":3,"file":"parse-tilejson.d.ts","sourceRoot":"","sources":["../../src/lib/parse-tilejson.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,GAAG;IAC5B,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,yEAAyE;AACzE,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACvB,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,wHAAwH;IACxH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IACzE,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IAEzB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,2FAA2F;IAC3F,IAAI,EAAE,MAAM,CAAC;IAEb,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IAIrB,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IAEvE,OAAO;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IAIrB,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACpB,CAAC;AA+CF;;;;;GAKG;AAEH,wBAAgB,aAAa,CAAC,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,eAAe,GAAG,QAAQ,GAAG,IAAI,CAiE1F"}

package/dist/lib/types.d.ts

@@ -1,41 +1,4 @@
-/** For local coordinates, the tileIndex is not required */
-type MVTLocalCoordinatesOptions = {
-    /**
-     * When set to `local`, the parser will return a flat array of GeoJSON objects with local coordinates decoded from tile origin.
-     */
-    coordinates: 'local';
-    tileIndex: null;
-};
-/** In WGS84 coordinates, the tileIndex is required */
-type MVTWgs84CoordinatesOptions = {
-    /**
-     * When set to `wgs84`, the parser will return a flat array of GeoJSON objects with coordinates in longitude, latitude decoded from the provided tile index.
-     */
-    coordinates?: 'wgs84';
-    /**
-     * Mandatory with `wgs84` coordinates option. An object containing tile index values (`x`, `y`,
-     * `z`) to reproject features' coordinates into WGS84.
-     */
-    tileIndex?: {
-        x: number;
-        y: number;
-        z: number;
-    };
-};
-export type MVTOptions = (MVTLocalCoordinatesOptions | MVTWgs84CoordinatesOptions) & {
-    shape?: 'geojson-table' | 'columnar-table' | 'geojson' | 'binary' | 'binary-geometry';
-    /**
-     * When non-`null`, the layer name of each feature is added to
-     * `feature.properties[layerProperty]`. (A `feature.properties` object is created if the feature
-     * has no existing properties). If set to `null`, a layer name property will not be added.
-     */
-    layerProperty?: string | number;
-    /**
-     * Optional list of layer names. If not `null`, only features belonging to the named layers will
-     * be included in the output. If `null`, features from all layers are returned.
-     */
-    layers?: string[];
-};
+/** TODO where is this used? */
 export type MVTMapboxGeometry = {
     type?: string;
     id?: number;
@@ -53,5 +16,4 @@ export type MVTMapboxCoordinates = {
     };
     id?: number;
 };
-export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAIA,2DAA2D;AAC3D,KAAK,0BAA0B,GAAG;IAChC;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;CACjB,CAAC;AAEF,sDAAsD;AACtD,KAAK,0BAA0B,GAAG;IAChC;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,SAAS,CAAC,EAAE;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,CAAC,0BAA0B,GAAG,0BAA0B,CAAC,GAAG;IACnF,KAAK,CAAC,EAAE,eAAe,GAAG,gBAAgB,GAAG,SAAS,GAAG,QAAQ,GAAG,iBAAiB,CAAC;IACtF;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEhC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,GAAG,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,iBAAiB,CAAC;KAChC,CAAC;IACF,UAAU,EAAE;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;KAAC,CAAC;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAIA,+BAA+B;AAC/B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,GAAG,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,iBAAiB,CAAC;KAChC,CAAC;IACF,UAAU,EAAE;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;KAAC,CAAC;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC"}

package/dist/lib/utils/geometry-utils.d.ts

@@ -0,0 +1,83 @@
+import { FlatIndexedGeometry, FlatPolygon } from '@loaders.gl/schema';
+/**
+ *
+ * @param ring
+ * @returns sum
+ */
+export declare function signedArea(ring: number[][]): number;
+/**
+ * This function projects local coordinates in a
+ * [0 - bufferSize, this.extent + bufferSize] range to a
+ * [0 - (bufferSize / this.extent), 1 + (bufferSize / this.extent)] range.
+ * The resulting extent would be 1.
+ * @param line
+ * @param feature
+ */
+export declare function convertToLocalCoordinates(coordinates: number[] | number[][] | number[][][] | number[][][][], extent: number): void;
+/**
+ * For the binary code path, the feature data is just
+ * one big flat array, so we just divide each value
+ * @param data
+ * @param feature
+ */
+export declare function convertToLocalCoordinatesFlat(data: number[], extent: number): void;
+/**
+ * Projects local tile coordinates to lngLat in place.
+ * @param points
+ * @param tileIndex
+ */
+export declare function projectToLngLat(line: number[] | number[][] | number[][][], tileIndex: {
+    x: number;
+    y: number;
+    z: number;
+}, extent: number): void;
+/**
+ * Projects local tile coordinates to lngLat in place.
+ * @param points
+ * @param tileIndex
+export function projectTileCoordinatesToLngLat(
+  points: number[][],
+  tileIndex: {x: number; y: number; z: number},
+  extent: number
+): void {
+  const {x, y, z} = tileIndex;
+  const size = extent * Math.pow(2, z);
+  const x0 = extent * x;
+  const y0 = extent * y;
+
+  for (const p of points) {
+    p[0] = ((p[0] + x0) * 360) / size - 180;
+    const y2 = 180 - ((p[1] + y0) * 360) / size;
+    p[1] = (360 / Math.PI) * Math.atan(Math.exp((y2 * Math.PI) / 180)) - 90;
+  }
+}
+ */
+/**
+ *
+ * @param data
+ * @param x0
+ * @param y0
+ * @param size
+ */
+export declare function projectToLngLatFlat(data: number[], tileIndex: {
+    x: number;
+    y: number;
+    z: number;
+}, extent: number): void;
+/**
+ * Classifies an array of rings into polygons with outer rings and holes
+ * @param rings
+ * @returns polygons
+ */
+export declare function classifyRings(rings: number[][][]): number[][][][];
+/**
+ * Classifies an array of rings into polygons with outer rings and holes
+ * The function also detects holes which have zero area and
+ * removes them. In doing so it modifies the input
+ * `geom.data` array to remove the unneeded data
+ *
+ * @param geometry
+ * @returns object
+ */
+export declare function classifyRingsFlat(geom: FlatIndexedGeometry): FlatPolygon;
+//# sourceMappingURL=geometry-utils.d.ts.map

package/dist/lib/utils/geometry-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/geometry-utils.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,mBAAmB,EAAE,WAAW,EAAC,MAAM,oBAAoB,CAAC;AAEpE;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,UAQ1C;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,EAAE,EAClE,MAAM,EAAE,MAAM,GACb,IAAI,CAYN;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAIlF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,EAC1C,SAAS,EAAE;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAC,EAC5C,MAAM,EAAE,MAAM,GACb,IAAI,CAiBN;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,EAAE;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAC,EAC5C,MAAM,EAAE,MAAM,GACb,IAAI,CAWN;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,EAAE,CAuBjE;AAED;;;;;;;;GAQG;AAEH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,GAAG,WAAW,CA4DxE"}

package/dist/lib/utils/geometry-utils.js

@@ -0,0 +1,206 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright vis.gl contributors
+import { getPolygonSignedArea } from '@math.gl/polygon';
+/**
+ *
+ * @param ring
+ * @returns sum
+ */
+export function signedArea(ring) {
+    let sum = 0;
+    for (let i = 0, j = ring.length - 1, p1, p2; i < ring.length; j = i++) {
+        p1 = ring[i];
+        p2 = ring[j];
+        sum += (p2[0] - p1[0]) * (p1[1] + p2[1]);
+    }
+    return sum;
+}
+/**
+ * This function projects local coordinates in a
+ * [0 - bufferSize, this.extent + bufferSize] range to a
+ * [0 - (bufferSize / this.extent), 1 + (bufferSize / this.extent)] range.
+ * The resulting extent would be 1.
+ * @param line
+ * @param feature
+ */
+export function convertToLocalCoordinates(coordinates, extent) {
+    if (Array.isArray(coordinates[0])) {
+        for (const subcoords of coordinates) {
+            convertToLocalCoordinates(subcoords, extent);
+        }
+        return;
+    }
+    // Just a point
+    const p = coordinates;
+    p[0] /= extent;
+    p[1] /= extent;
+}
+/**
+ * For the binary code path, the feature data is just
+ * one big flat array, so we just divide each value
+ * @param data
+ * @param feature
+ */
+export function convertToLocalCoordinatesFlat(data, extent) {
+    for (let i = 0, il = data.length; i < il; ++i) {
+        data[i] /= extent;
+    }
+}
+/**
+ * Projects local tile coordinates to lngLat in place.
+ * @param points
+ * @param tileIndex
+ */
+export function projectToLngLat(line, tileIndex, extent) {
+    if (typeof line[0][0] !== 'number') {
+        for (const point of line) {
+            // @ts-expect-error
+            projectToLngLat(point, tileIndex, extent);
+        }
+        return;
+    }
+    const size = extent * Math.pow(2, tileIndex.z);
+    const x0 = extent * tileIndex.x;
+    const y0 = extent * tileIndex.y;
+    for (let j = 0; j < line.length; j++) {
+        const p = line[j];
+        p[0] = ((p[0] + x0) * 360) / size - 180;
+        const y2 = 180 - ((p[1] + y0) * 360) / size;
+        p[1] = (360 / Math.PI) * Math.atan(Math.exp((y2 * Math.PI) / 180)) - 90;
+    }
+}
+/**
+ * Projects local tile coordinates to lngLat in place.
+ * @param points
+ * @param tileIndex
+export function projectTileCoordinatesToLngLat(
+  points: number[][],
+  tileIndex: {x: number; y: number; z: number},
+  extent: number
+): void {
+  const {x, y, z} = tileIndex;
+  const size = extent * Math.pow(2, z);
+  const x0 = extent * x;
+  const y0 = extent * y;
+
+  for (const p of points) {
+    p[0] = ((p[0] + x0) * 360) / size - 180;
+    const y2 = 180 - ((p[1] + y0) * 360) / size;
+    p[1] = (360 / Math.PI) * Math.atan(Math.exp((y2 * Math.PI) / 180)) - 90;
+  }
+}
+ */
+/**
+ *
+ * @param data
+ * @param x0
+ * @param y0
+ * @param size
+ */
+export function projectToLngLatFlat(data, tileIndex, extent) {
+    const { x, y, z } = tileIndex;
+    const size = extent * Math.pow(2, z);
+    const x0 = extent * x;
+    const y0 = extent * y;
+    for (let j = 0, jl = data.length; j < jl; j += 2) {
+        data[j] = ((data[j] + x0) * 360) / size - 180;
+        const y2 = 180 - ((data[j + 1] + y0) * 360) / size;
+        data[j + 1] = (360 / Math.PI) * Math.atan(Math.exp((y2 * Math.PI) / 180)) - 90;
+    }
+}
+/**
+ * Classifies an array of rings into polygons with outer rings and holes
+ * @param rings
+ * @returns polygons
+ */
+export function classifyRings(rings) {
+    const len = rings.length;
+    if (len <= 1)
+        return [rings];
+    const polygons = [];
+    let polygon;
+    let ccw;
+    for (let i = 0; i < len; i++) {
+        const area = signedArea(rings[i]);
+        if (area === 0)
+            continue; // eslint-disable-line no-continue
+        if (ccw === undefined)
+            ccw = area < 0;
+        if (ccw === area < 0) {
+            if (polygon)
+                polygons.push(polygon);
+            polygon = [rings[i]];
+        }
+        else if (polygon)
+            polygon.push(rings[i]);
+    }
+    if (polygon)
+        polygons.push(polygon);
+    return polygons;
+}
+/**
+ * Classifies an array of rings into polygons with outer rings and holes
+ * The function also detects holes which have zero area and
+ * removes them. In doing so it modifies the input
+ * `geom.data` array to remove the unneeded data
+ *
+ * @param geometry
+ * @returns object
+ */
+// eslint-disable-next-line max-statements
+export function classifyRingsFlat(geom) {
+    const len = geom.indices.length;
+    const type = 'Polygon';
+    if (len <= 1) {
+        return {
+            type,
+            data: geom.data,
+            areas: [[getPolygonSignedArea(geom.data)]],
+            indices: [geom.indices]
+        };
+    }
+    const areas = [];
+    const polygons = [];
+    let ringAreas = [];
+    let polygon = [];
+    let ccw;
+    let offset = 0;
+    for (let endIndex, i = 0, startIndex; i < len; i++) {
+        startIndex = geom.indices[i] - offset;
+        endIndex = geom.indices[i + 1] - offset || geom.data.length;
+        const shape = geom.data.slice(startIndex, endIndex);
+        const area = getPolygonSignedArea(shape);
+        if (area === 0) {
+            // This polygon has no area, so remove it from the shape
+            // Remove the section from the data array
+            const before = geom.data.slice(0, startIndex);
+            const after = geom.data.slice(endIndex);
+            geom.data = before.concat(after);
+            // Need to offset any remaining indices as we have
+            // modified the data buffer
+            offset += endIndex - startIndex;
+            // Do not add this index to the output and process next shape
+            continue; // eslint-disable-line no-continue
+        }
+        if (ccw === undefined)
+            ccw = area < 0;
+        if (ccw === area < 0) {
+            if (polygon.length) {
+                areas.push(ringAreas);
+                polygons.push(polygon);
+            }
+            polygon = [startIndex];
+            ringAreas = [area];
+        }
+        else {
+            ringAreas.push(area);
+            polygon.push(startIndex);
+        }
+    }
+    if (ringAreas)
+        areas.push(ringAreas);
+    if (polygon.length)
+        polygons.push(polygon);
+    return { type, areas, indices: polygons, data: geom.data };
+}

package/dist/lib/vector-tile/vector-tile-feature.d.ts

@@ -0,0 +1,72 @@
+import { Feature } from '@loaders.gl/schema';
+import { FlatFeature, FlatIndexedGeometry, GeojsonGeometryInfo } from '@loaders.gl/schema';
+import Protobuf from 'pbf';
+export declare class VectorTileFeature {
+    properties: {
+        [x: string]: string | number | boolean | null;
+    };
+    extent: any;
+    type: number;
+    id: number | null;
+    _pbf: Protobuf;
+    _geometry: number;
+    _keys: string[];
+    _values: (string | number | boolean | null)[];
+    _geometryInfo: GeojsonGeometryInfo;
+    static types: Readonly<string[]>;
+    constructor(pbf: Protobuf, end: number, extent: any, keys: string[], values: (string | number | boolean | null)[], geometryInfo?: GeojsonGeometryInfo);
+    toGeoJSONFeature(coordinates: 'wgs84' | 'local', tileIndex?: {
+        x: number;
+        y: number;
+        z: number;
+    }): Feature;
+    /**
+     *
+     * @param options
+     * @returns
+     */
+    toBinaryFeature(coordinates: 'wgs84' | 'local', tileIndex?: {
+        x: number;
+        y: number;
+        z: number;
+    }): FlatFeature;
+    /** Read a bounding box from the feature */
+    bbox(): number[];
+    /**
+     *
+     * @param transform
+     * @returns result
+     */
+    _toBinaryCoordinates(geom: FlatIndexedGeometry, transform: (data: number[], extent: number) => void): {
+        type: "Feature";
+        geometry: import("@loaders.gl/schema").FlatGeometry;
+        id?: string | number | undefined;
+        properties: import("geojson").GeoJsonProperties;
+        bbox?: import("geojson").BBox | undefined;
+    };
+    loadGeometry(): number[][][];
+    /**
+     * Expands the protobuf data to an intermediate Flat GeoJSON
+     * data format, which maps closely to the binary data buffers.
+     * It is similar to GeoJSON, but rather than storing the coordinates
+     * in multidimensional arrays, we have a 1D `data` with all the
+     * coordinates, and then index into this using the `indices`
+     * parameter, e.g.
+     *
+     * geometry: {
+     *   type: 'Point', data: [1,2], indices: [0]
+     * }
+     * geometry: {
+     *   type: 'LineString', data: [1,2,3,4,...], indices: [0]
+     * }
+     * geometry: {
+     *   type: 'Polygon', data: [1,2,3,4,...], indices: [[0, 2]]
+     * }
+     * Thus the indices member lets us look up the relevant range
+     * from the data array.
+     * The Multi* versions of the above types share the same data
+     * structure, just with multiple elements in the indices array
+     */
+    loadFlatGeometry(): FlatIndexedGeometry;
+}
+//# sourceMappingURL=vector-tile-feature.d.ts.map

package/dist/lib/vector-tile/vector-tile-feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-tile-feature.d.ts","sourceRoot":"","sources":["../../../src/lib/vector-tile/vector-tile-feature.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,OAAO,EAAC,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAC,WAAW,EAAE,mBAAmB,EAAE,mBAAmB,EAAC,MAAM,oBAAoB,CAAC;AACzF,OAAO,QAAQ,MAAM,KAAK,CAAC;AAK3B,qBAAa,iBAAiB;IAC5B,UAAU,EAAE;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;KAAC,CAAC;IAC5D,MAAM,EAAE,GAAG,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC;IAC9C,aAAa,EAAE,mBAAmB,CAAC;IAEnC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAiD;gBAI/E,GAAG,EAAE,QAAQ,EACb,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,GAAG,EACX,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,EAAE,EAC5C,YAAY,CAAC,EAAE,mBAAmB;IAoBpC,gBAAgB,CACd,WAAW,EAAE,OAAO,GAAG,OAAO,EAC9B,SAAS,CAAC,EAAE;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAC,GAC5C,OAAO;IAaV;;;;OAIG;IACH,eAAe,CACb,WAAW,EAAE,OAAO,GAAG,OAAO,EAC9B,SAAS,CAAC,EAAE;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAC,GAC5C,WAAW;IAcd,2CAA2C;IAE3C,IAAI;IAwCJ;;;;OAIG;IACH,oBAAoB,CAClB,IAAI,EAAE,mBAAmB,EACzB,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI;;;;;;;IAsDrD,YAAY,IAAI,MAAM,EAAE,EAAE,EAAE;IAkD5B;;;;;;;;;;;;;;;;;;;;;OAqBG;IAEH,gBAAgB,IAAI,mBAAmB;CAqDxC"}