@loaders.gl/mvt 4.2.0-alpha.6 → 4.2.0-beta.2

package/src/helpers/binary-util-functions.ts

@@ -1,7 +1,11 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright vis.gl contributors
+
 import Protobuf from 'pbf';
 import {getPolygonSignedArea} from '@math.gl/polygon';
 import {FlatIndexedGeometry, FlatPolygon} from '@loaders.gl/schema';
-import VectorTileFeature from '../lib/binary-vector-tile/vector-tile-feature';
+import {BinaryVectorTileFeature} from '../lib/binary-vector-tile/vector-tile-feature';
 
 /**
  * Classifies an array of rings into polygons with outer rings and holes
@@ -97,7 +101,7 @@ export function project(data: number[], x0: number, y0: number, size: number): v
  * @param feature
  * @param pbf
  */
-export function readFeature(tag: number, feature?: VectorTileFeature, pbf?: Protobuf): void {
+export function readFeature(tag: number, feature?: BinaryVectorTileFeature, pbf?: Protobuf): void {
   if (feature && pbf) {
     if (tag === 1) feature.id = pbf.readVarint();
     else if (tag === 2) readTag(pbf, feature);
@@ -110,7 +114,7 @@ export function readFeature(tag: number, feature?: VectorTileFeature, pbf?: Prot
  * @param pbf
  * @param feature
  */
-export function readTag(pbf: Protobuf, feature: VectorTileFeature): void {
+export function readTag(pbf: Protobuf, feature: BinaryVectorTileFeature): void {
   const end = pbf.readVarint() + pbf.pos;
 
   while (pbf.pos < end) {

package/src/helpers/mapbox-util-functions.ts

@@ -1,6 +1,10 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright vis.gl contributors
+
 import Protobuf from 'pbf';
 import {MVTMapboxGeometry} from '../lib/types';
-import VectorTileFeature from '../lib/mapbox-vector-tile/vector-tile-feature';
+import {VectorTileFeature} from '../lib/mapbox-vector-tile/vector-tile-feature';
 
 /**
  * Classifies an array of rings into polygons with outer rings and holes

package/src/index.ts

@@ -2,7 +2,7 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 
-export type {MVTLoaderOptions} from './lib/types';
+export type {MVTLoaderOptions} from './mvt-loader';
 export {MVTLoader, MVTWorkerLoader} from './mvt-loader';
 
 export type {TileJSON} from './lib/parse-tilejson';

package/src/lib/binary-vector-tile/vector-tile-feature.ts

@@ -1,3 +1,7 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright vis.gl contributors
+
 // This code is forked from https://github.com/mapbox/vector-tile-js under BSD 3-clause license.
 
 import Protobuf from 'pbf';
@@ -17,7 +21,7 @@ export const TEST_EXPORTS = {
   classifyRings
 };
 
-export default class VectorTileFeature {
+export class BinaryVectorTileFeature {
   properties: {[x: string]: string | number | boolean | null};
   extent: any;
   type: number;

package/src/lib/binary-vector-tile/vector-tile-layer.ts

@@ -1,11 +1,15 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright vis.gl contributors
+
 /* eslint-disable indent */
 // This code is forked from https://github.com/mapbox/vector-tile-js under BSD 3-clause license.
 
-import VectorTileFeature from './vector-tile-feature';
+import {BinaryVectorTileFeature} from './vector-tile-feature';
 import Protobuf from 'pbf';
 import {GeojsonGeometryInfo} from '@loaders.gl/schema';
 
-export default class VectorTileLayer {
+export class BinaryVectorTileLayer {
   version: number;
   name: string;
   extent: number;
@@ -33,13 +37,13 @@ export default class VectorTileLayer {
   }
 
   /**
-   * return feature `i` from this layer as a `VectorTileFeature`
+   * return feature `i` from this layer as a `BinaryVectorTileFeature`
    *
    * @param index
    * @param geometryInfo
-   * @returns {VectorTileFeature}
+   * @returns {BinaryVectorTileFeature}
    */
-  feature(i: number, geometryInfo: GeojsonGeometryInfo): VectorTileFeature {
+  feature(i: number, geometryInfo: GeojsonGeometryInfo): BinaryVectorTileFeature {
     if (i < 0 || i >= this._features.length) {
       throw new Error('feature index out of bounds');
     }
@@ -47,7 +51,7 @@ export default class VectorTileLayer {
     this._pbf.pos = this._features[i];
 
     const end = this._pbf.readVarint() + this._pbf.pos;
-    return new VectorTileFeature(
+    return new BinaryVectorTileFeature(
       this._pbf,
       end,
       this.extent,
@@ -64,7 +68,7 @@ export default class VectorTileLayer {
  * @param layer
  * @param pbf
  */
-function readLayer(tag: number, layer?: VectorTileLayer, pbf?: Protobuf): void {
+function readLayer(tag: number, layer?: BinaryVectorTileLayer, pbf?: Protobuf): void {
   if (layer && pbf) {
     if (tag === 15) layer.version = pbf.readVarint();
     else if (tag === 1) layer.name = pbf.readString();

package/src/lib/binary-vector-tile/vector-tile.ts

@@ -1,10 +1,14 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright vis.gl contributors
+
 // This code is forked from https://github.com/mapbox/vector-tile-js under BSD 3-clause license.
 
-import VectorTileLayer from './vector-tile-layer';
+import {BinaryVectorTileLayer} from './vector-tile-layer';
 import Protobuf from 'pbf';
 
-export default class VectorTile {
-  layers: {[x: string]: VectorTileLayer};
+export class BinaryVectorTile {
+  layers: {[x: string]: BinaryVectorTileLayer};
   constructor(pbf: Protobuf, end?: number) {
     this.layers = pbf.readFields(readTile, {}, end);
   }
@@ -16,10 +20,14 @@ export default class VectorTile {
  * @param layers
  * @param pbf
  */
-function readTile(tag: number, layers?: {[x: string]: VectorTileLayer}, pbf?: Protobuf): void {
+function readTile(
+  tag: number,
+  layers?: {[x: string]: BinaryVectorTileLayer},
+  pbf?: Protobuf
+): void {
   if (tag === 3) {
     if (pbf) {
-      const layer = new VectorTileLayer(pbf, pbf.readVarint() + pbf.pos);
+      const layer = new BinaryVectorTileLayer(pbf, pbf.readVarint() + pbf.pos);
       if (layer.length && layers) {
         layers[layer.name] = layer;
       }

package/src/lib/mapbox-vector-tile/vector-tile-feature.ts

@@ -1,9 +1,13 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright vis.gl contributors
+
 // This code is forked from https://github.com/mapbox/vector-tile-js under BSD 3-clause license.
 import Protobuf from 'pbf';
 import {MVTMapboxCoordinates, MVTMapboxGeometry} from '../types';
 import {readFeature, classifyRings} from '../../helpers/mapbox-util-functions';
 
-export default class VectorTileFeature {
+export class VectorTileFeature {
   properties: {[x: string]: string | number | boolean | null};
   extent: any;
   type: number;

package/src/lib/mapbox-vector-tile/vector-tile-layer.ts

@@ -1,10 +1,14 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright vis.gl contributors
+
 /* eslint-disable indent */
 // This code is forked from https://github.com/mapbox/vector-tile-js under BSD 3-clause license.
 
 import Protobuf from 'pbf';
-import VectorTileFeature from './vector-tile-feature';
+import {VectorTileFeature} from './vector-tile-feature';
 
-export default class VectorTileLayer {
+export class VectorTileLayer {
   version: number;
   name: string;
   extent: number;

package/src/lib/mapbox-vector-tile/vector-tile.ts

@@ -1,9 +1,13 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright vis.gl contributors
+
 // This code is forked from https://github.com/mapbox/vector-tile-js under BSD 3-clause license.
 
-import VectorTileLayer from './vector-tile-layer';
+import {VectorTileLayer} from './vector-tile-layer';
 import Protobuf from 'pbf';
 
-export default class VectorTile {
+export class VectorTile {
   layers: {[x: string]: VectorTileLayer};
   constructor(pbf: Protobuf, end?: number) {
     this.layers = pbf.readFields(readTile, {}, end);

package/src/lib/parse-mvt.ts

@@ -1,3 +1,7 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright vis.gl contributors
+
 import {flatGeojsonToBinary} from '@loaders.gl/gis';
 import type {
   FlatFeature,
@@ -8,12 +12,13 @@ import type {
 } from '@loaders.gl/schema';
 import Protobuf from 'pbf';
 
-import type {MVTMapboxCoordinates, MVTOptions, MVTLoaderOptions} from '../lib/types';
+import type {MVTMapboxCoordinates, MVTOptions} from '../lib/types';
+import type {MVTLoaderOptions} from '../mvt-loader';
 
-import VectorTile from './mapbox-vector-tile/vector-tile';
-import BinaryVectorTile from './binary-vector-tile/vector-tile';
-import VectorTileFeatureBinary from './binary-vector-tile/vector-tile-feature';
-import VectorTileFeatureMapBox from './mapbox-vector-tile/vector-tile-feature';
+import {VectorTile} from './mapbox-vector-tile/vector-tile';
+import {BinaryVectorTile} from './binary-vector-tile/vector-tile';
+import {BinaryVectorTileFeature} from './binary-vector-tile/vector-tile-feature';
+import {VectorTileFeature as VectorTileFeatureMapBox} from './mapbox-vector-tile/vector-tile-feature';
 
 /**
  * Parse MVT arrayBuffer and return GeoJSON.
@@ -22,7 +27,7 @@ import VectorTileFeatureMapBox from './mapbox-vector-tile/vector-tile-feature';
  * @param options
  * @returns A GeoJSON geometry object or a binary representation
  */
-export default function parseMVT(arrayBuffer: ArrayBuffer, options?: MVTLoaderOptions) {
+export function parseMVT(arrayBuffer: ArrayBuffer, options?: MVTLoaderOptions) {
   const mvtOptions = normalizeOptions(options);
 
   const shape: string | undefined =
@@ -179,12 +184,12 @@ function getDecodedFeature(
  * @returns decoded binary feature
  */
 function getDecodedFeatureBinary(
-  feature: VectorTileFeatureBinary,
+  feature: BinaryVectorTileFeature,
   options: MVTOptions,
   layerName: string
 ): FlatFeature {
   const decodedFeature = feature.toBinaryCoordinates(
-    // @ts-expect-error What is going on here?
+    // @ts-expect-error
     options.coordinates === 'wgs84' ? options.tileIndex : transformToLocalCoordinatesBinary
   );
 

package/src/lib/types.ts

@@ -1,4 +1,6 @@
-import type {LoaderOptions} from '@loaders.gl/loader-utils';
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright vis.gl contributors
 
 /** For local coordinates, the tileIndex is not required */
 type MVTLocalCoordinatesOptions = {
@@ -55,13 +57,3 @@ export type MVTMapboxCoordinates = {
   properties: {[x: string]: string | number | boolean | null};
   id?: number;
 };
-
-export type MVTLoaderOptions = LoaderOptions & {
-  mvt?: MVTOptions;
-  gis?: {
-    /** `true`: parser will output the data in binary format. Equivalent to loading the data as GeoJSON and then applying geojsonToBinary */
-    binary?: boolean;
-    /** @deprecated. Use options.mvt.shape */
-    format?: 'geojson-table' | 'columnar-table' | 'geojson' | 'binary' | 'binary-geometry';
-  };
-};

package/src/mvt-loader.ts

@@ -1,26 +1,35 @@
-import type {Loader, LoaderWithParser} from '@loaders.gl/loader-utils';
-import type {MVTLoaderOptions} from './lib/types';
-// import type {
-//   Feature,
-//   BinaryFeatureCollection,
-//   GeoJSONTable,
-//   Geometry,
-//   GeoJsonProperties
-// } from '@loaders.gl/schema';
-import parseMVT from './lib/parse-mvt';
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright vis.gl contributors
+
+import type {Loader, LoaderWithParser, LoaderOptions} from '@loaders.gl/loader-utils';
+import {parseMVT} from './lib/parse-mvt';
+import type {MVTOptions} from './lib/types';
 
 // __VERSION__ is injected by babel-plugin-version-inline
 // @ts-ignore TS2304: Cannot find name '__VERSION__'.
 const VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'latest';
 
+export type MVTLoaderOptions = LoaderOptions & {
+  mvt?: MVTOptions & {
+    /** Override the URL to the worker bundle (by default loads from unpkg.com) */
+    workerUrl?: string;
+  };
+  gis?: {
+    /** `true`: parser will output the data in binary format. Equivalent to loading the data as GeoJSON and then applying geojsonToBinary */
+    binary?: boolean;
+    /** @deprecated. Use options.mvt.shape */
+    format?: 'geojson-table' | 'columnar-table' | 'geojson' | 'binary' | 'binary-geometry';
+  };
+};
+
 /**
  * Worker loader for the Mapbox Vector Tile format
  */
-export const MVTWorkerLoader: Loader<
-  any, // BinaryFeatureCollection | GeoJSONTable | Feature<Geometry, GeoJsonProperties>,
-  never,
-  MVTLoaderOptions
-> = {
+export const MVTWorkerLoader = {
+  dataType: null as any,
+  batchType: null as never,
+
   name: 'Mapbox Vector Tile',
   id: 'mvt',
   module: 'mvt',
@@ -44,18 +53,22 @@ export const MVTWorkerLoader: Loader<
       tileIndex: null
     }
   }
-};
+} as const satisfies Loader<
+  any, // BinaryFeatureCollection | GeoJSONTable | Feature<Geometry, GeoJsonProperties>,
+  never,
+  MVTLoaderOptions
+>;
 
 /**
  * Loader for the Mapbox Vector Tile format
  */
-export const MVTLoader: LoaderWithParser<
-  any, // BinaryFeatureCollection | GeoJSONTable | Feature<Geometry, GeoJsonProperties>,
-  never,
-  MVTLoaderOptions
-> = {
+export const MVTLoader = {
   ...MVTWorkerLoader,
   parse: async (arrayBuffer, options?: MVTLoaderOptions) => parseMVT(arrayBuffer, options),
   parseSync: parseMVT,
   binary: true
-};
+} as const satisfies LoaderWithParser<
+  any, // BinaryFeatureCollection | GeoJSONTable | Feature<Geometry, GeoJsonProperties>,
+  never,
+  MVTLoaderOptions
+>;

package/src/tilejson-loader.ts

@@ -21,7 +21,10 @@ export type TileJSONLoaderOptions = LoaderOptions & {
 /**
  * Loader for TileJSON metadata
  */
-export const TileJSONLoader: LoaderWithParser<TileJSON, never, TileJSONLoaderOptions> = {
+export const TileJSONLoader = {
+  dataType: null as unknown as TileJSON,
+  batchType: null as never,
+
   name: 'TileJSON',
   id: 'tilejson',
   module: 'pmtiles',
@@ -46,4 +49,4 @@ export const TileJSONLoader: LoaderWithParser<TileJSON, never, TileJSONLoaderOpt
     const tilejsonOptions = {...TileJSONLoader.options.tilejson, ...options?.tilejson};
     return parseTileJSON(json, tilejsonOptions) as TileJSON;
   }
-};
+} as const satisfies LoaderWithParser<TileJSON, never, TileJSONLoaderOptions>;

package/src/workers/mvt-worker.ts

@@ -1,3 +1,7 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright vis.gl contributors
+
 import {MVTLoader} from '../mvt-loader';
 import {createLoaderWorker} from '@loaders.gl/loader-utils';