@loaders.gl/mvt 4.3.0-alpha.1 → 4.3.0-alpha.3

package/dist/lib/vector-tiler/transform-tile.js

@@ -0,0 +1,41 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+// Forked from https://github.com/mapbox/geojson-vt under compatible ISC license
+/**
+ * Transforms the coordinates of each protoFeature in the given protoTile from
+ * mercator-projected space into (extent x extent) protoTile space.
+ */
+export function transformTile(protoTile, extent) {
+    if (protoTile.transformed) {
+        return protoTile;
+    }
+    const z2 = 1 << protoTile.z;
+    const tx = protoTile.x;
+    const ty = protoTile.y;
+    for (const protoFeature of protoTile.protoFeatures) {
+        const geom = protoFeature.geometry;
+        const simplifiedType = protoFeature.simplifiedType;
+        protoFeature.geometry = [];
+        if (simplifiedType === 1) {
+            for (let j = 0; j < geom.length; j += 2) {
+                protoFeature.geometry.push(transformPoint(geom[j], geom[j + 1], extent, z2, tx, ty));
+            }
+        }
+        else {
+            for (let j = 0; j < geom.length; j++) {
+                const ring = [];
+                for (let k = 0; k < geom[j].length; k += 2) {
+                    ring.push(transformPoint(geom[j][k], geom[j][k + 1], extent, z2, tx, ty));
+                }
+                protoFeature.geometry.push(ring);
+            }
+        }
+    }
+    protoTile.transformed = true;
+    return protoTile;
+}
+// eslint-disable-next-line max-params
+function transformPoint(x, y, extent, z2, tx, ty) {
+    return [Math.round(extent * (x * z2 - tx)), Math.round(extent * (y * z2 - ty))];
+}

package/dist/mvt-loader.d.ts

@@ -52,7 +52,7 @@ export declare const MVTWorkerLoader: {
  * Loader for the Mapbox Vector Tile format
  */
 export declare const MVTLoader: {
-    readonly parse: (arrayBuffer: ArrayBuffer, options?: MVTLoaderOptions) => Promise<import("@loaders.gl/schema").GeoJSONTable | import("geojson").Feature<import("geojson").Geometry, import("geojson").GeoJsonProperties>[] | import("@loaders.gl/schema").BinaryFeatureCollection | {
+    readonly parse: (arrayBuffer: ArrayBuffer, options?: MVTLoaderOptions) => Promise<import("@loaders.gl/schema").BinaryFeatureCollection | import("@loaders.gl/schema").GeoJSONTable | import("geojson").Feature<import("geojson").Geometry, import("geojson").GeoJsonProperties>[] | {
         shape: string;
         data: import("@loaders.gl/schema").BinaryFeatureCollection;
     }>;

package/dist/mvt-loader.js

@@ -5,7 +5,7 @@
 import { parseMVT } from "./lib/parse-mvt.js";
 // __VERSION__ is injected by babel-plugin-version-inline
 // @ts-ignore TS2304: Cannot find name '__VERSION__'.
-const VERSION = typeof "4.2.0" !== 'undefined' ? "4.2.0" : 'latest';
+const VERSION = typeof "4.3.0-alpha.2" !== 'undefined' ? "4.3.0-alpha.2" : 'latest';
 /**
  * Worker loader for the Mapbox Vector Tile format
  */

package/dist/mvt-source.d.ts

@@ -1,21 +1,38 @@
-import type { GetTileParameters, ImageType, DataSourceProps } from '@loaders.gl/loader-utils';
+import type { ImageType, DataSourceProps } from '@loaders.gl/loader-utils';
 import type { ImageTileSource, VectorTileSource } from '@loaders.gl/loader-utils';
+import type { GetTileParameters, GetTileDataParameters } from '@loaders.gl/loader-utils';
 import { DataSource } from '@loaders.gl/loader-utils';
 import { ImageLoaderOptions } from '@loaders.gl/images';
 import { MVTLoaderOptions, TileJSON, TileJSONLoaderOptions } from '@loaders.gl/mvt';
-import { TileLoadParameters } from '@loaders.gl/loader-utils';
+/** Creates an MVTTileSource */
+export declare const MVTSource: {
+    readonly name: "MVT";
+    readonly id: "mvt";
+    readonly module: "mvt";
+    readonly version: "0.0.0";
+    readonly extensions: ["mvt"];
+    readonly mimeTypes: ["application/octet-stream"];
+    readonly options: {
+        readonly mvt: {};
+    };
+    readonly type: "mvt";
+    readonly fromUrl: true;
+    readonly fromBlob: false;
+    readonly testURL: (url: string) => boolean;
+    readonly createDataSource: (url: string, props: MVTTileSourceProps) => MVTTileSource;
+};
 /** Properties for a Mapbox Vector Tile Source */
-export type MVTSourceProps = DataSourceProps & {
-    /** Root url of tileset */
-    url: string;
-    /** if not supplied, loads tilejson.json, If null does not load metadata */
-    metadataUrl?: string | null;
-    /** Override extension (necessary if no metadata) */
-    extension?: string;
-    /** Additional attribution, adds to any attribution loaded from tileset metadata */
-    attributions?: string[];
-    /** Specify load options for all sub loaders */
-    loadOptions?: TileJSONLoaderOptions & MVTLoaderOptions & ImageLoaderOptions;
+export type MVTTileSourceProps = DataSourceProps & {
+    mvt?: {
+        /** if not supplied, loads tilejson.json, If null does not load metadata */
+        metadataUrl?: string | null;
+        /** Override extension (necessary if no metadata) */
+        extension?: string;
+        /** Additional attribution, adds to any attribution loaded from tileset metadata */
+        attributions?: string[];
+        /** Specify load options for all sub loaders */
+        loadOptions?: TileJSONLoaderOptions & MVTLoaderOptions & ImageLoaderOptions;
+    };
 };
 /**
  * MVT data source for Mapbox Vector Tiles v1.
@@ -24,8 +41,8 @@ export type MVTSourceProps = DataSourceProps & {
  * A PMTiles data source
  * @note Can be either a raster or vector tile source depending on the contents of the PMTiles file.
  */
-export declare class MVTSource extends DataSource implements ImageTileSource, VectorTileSource {
-    readonly props: MVTSourceProps;
+export declare class MVTTileSource extends DataSource implements ImageTileSource, VectorTileSource {
+    readonly props: MVTTileSourceProps;
     readonly url: string;
     readonly metadataUrl: string | null;
     data: string;
@@ -33,11 +50,11 @@ export declare class MVTSource extends DataSource implements ImageTileSource, Ve
     metadata: Promise<TileJSON | null>;
     extension: string;
     mimeType: string | null;
-    constructor(props: MVTSourceProps);
+    constructor(url: string, props: MVTTileSourceProps);
     getMetadata(): Promise<TileJSON | null>;
     getTileMIMEType(): string | null;
-    getTile(tileParams: GetTileParameters): Promise<ArrayBuffer | null>;
-    getTileData(tileParams: TileLoadParameters): Promise<unknown | null>;
+    getTile(parameters: GetTileParameters): Promise<ArrayBuffer | null>;
+    getTileData(parameters: GetTileDataParameters): Promise<any>;
     getImageTile(tileParams: GetTileParameters): Promise<ImageType | null>;
     protected _parseImageTile(arrayBuffer: ArrayBuffer): Promise<ImageType>;
     getVectorTile(tileParams: GetTileParameters): Promise<unknown | null>;

package/dist/mvt-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mvt-source.d.ts","sourceRoot":"","sources":["../src/mvt-source.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,iBAAiB,EAAE,SAAS,EAAE,eAAe,EAAC,MAAM,0BAA0B,CAAC;AAC5F,OAAO,KAAK,EAAC,eAAe,EAAE,gBAAgB,EAAC,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAC,UAAU,EAAc,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAc,kBAAkB,EAAyB,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EAEL,gBAAgB,EAEhB,QAAQ,EACR,qBAAqB,EACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAC;AAE5D,iDAAiD;AACjD,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG;IAC7C,0BAA0B;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,qBAAqB,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;CAC7E,CAAC;AAEF;;GAEG;AACH;;;GAGG;AACH,qBAAa,SAAU,SAAQ,UAAW,YAAW,eAAe,EAAE,gBAAgB;IACpF,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,UAAU,CAAS;IAC3C,QAAQ,EAAE,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;gBAEnB,KAAK,EAAE,cAAc;IAkB3B,WAAW,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAgC7C,eAAe,IAAI,MAAM,GAAG,IAAI;IAI1B,OAAO,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAcnE,WAAW,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAuBpE,YAAY,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;cAK5D,eAAe,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC;IAMvE,aAAa,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;cAK3D,gBAAgB,CAC9B,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,iBAAiB,GAC5B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAc1B,cAAc,IAAI,MAAM,GAAG,IAAI;IAI/B,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;CAY3C;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;AAM5C;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,WAAW,EACrB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,EAAE,GAAE,MAAY,GACf,MAAM,CAiBR"}
+{"version":3,"file":"mvt-source.d.ts","sourceRoot":"","sources":["../src/mvt-source.ts"],"names":[],"mappings":"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"}

package/dist/mvt-source.js

@@ -4,6 +4,27 @@
 import { DataSource, resolvePath } from '@loaders.gl/loader-utils';
 import { ImageLoader, getBinaryImageMetadata } from '@loaders.gl/images';
 import { MVTLoader, TileJSONLoader } from '@loaders.gl/mvt';
+/** Creates an MVTTileSource */
+export const MVTSource = {
+    name: 'MVT',
+    id: 'mvt',
+    module: 'mvt',
+    version: '0.0.0',
+    extensions: ['mvt'],
+    mimeTypes: ['application/octet-stream'],
+    options: {
+        mvt: {
+        // TODO - add options here
+        }
+    },
+    type: 'mvt',
+    fromUrl: true,
+    fromBlob: false,
+    testURL: (url) => true,
+    createDataSource(url, props) {
+        return new MVTTileSource(url, props);
+    }
+};
 /**
  * MVT data source for Mapbox Vector Tiles v1.
  */
@@ -11,7 +32,7 @@ import { MVTLoader, TileJSONLoader } from '@loaders.gl/mvt';
  * A PMTiles data source
  * @note Can be either a raster or vector tile source depending on the contents of the PMTiles file.
  */
-export class MVTSource extends DataSource {
+export class MVTTileSource extends DataSource {
     props;
     url;
     metadataUrl = null;
@@ -20,13 +41,12 @@ export class MVTSource extends DataSource {
     metadata;
     extension;
     mimeType = null;
-    constructor(props) {
+    constructor(url, props) {
         super(props);
         this.props = props;
-        this.url = resolvePath(props.url);
-        this.metadataUrl =
-            props.metadataUrl === undefined ? `${this.url}/tilejson.json` : props.metadataUrl;
-        this.extension = props.extension || '.png';
+        this.url = resolvePath(url);
+        this.metadataUrl = props.mvt?.metadataUrl || `${this.url}/tilejson.json`;
+        this.extension = props.mvt?.extension || '.png';
         this.data = this.url;
         this.getTileData = this.getTileData.bind(this);
         this.metadata = this.getMetadata();
@@ -67,8 +87,8 @@ export class MVTSource extends DataSource {
     getTileMIMEType() {
         return this.mimeType;
     }
-    async getTile(tileParams) {
-        const { x, y, z } = tileParams;
+    async getTile(parameters) {
+        const { x, y, z } = parameters;
         const tileUrl = this.getTileURL(x, y, z);
         const response = await this.fetch(tileUrl);
         if (!response.ok) {
@@ -79,8 +99,8 @@ export class MVTSource extends DataSource {
     }
     // Tile Source interface implementation: deck.gl compatible API
     // TODO - currently only handles image tiles, not vector tiles
-    async getTileData(tileParams) {
-        const { x, y, z } = tileParams.index;
+    async getTileData(parameters) {
+        const { x, y, z } = parameters.index;
         // const metadata = await this.metadata;
         // mimeType = metadata?.tileMIMEType || 'application/vnd.mapbox-vector-tile';
         const arrayBuffer = await this.getTile({ x, y, z, layers: [] });

package/dist/mvt-worker.js

@@ -1649,7 +1649,7 @@
   var navigator_ = globalThis.navigator || {};
 
   // ../../node_modules/@probe.gl/log/node_modules/@probe.gl/env/dist/utils/globals.js
-  var VERSION = true ? "4.2.0" : "untranspiled source";
+  var VERSION = true ? "4.3.0-alpha.2" : "untranspiled source";
   var isBrowser2 = isBrowser();
 
   // ../../node_modules/@probe.gl/log/dist/utils/local-storage.js
@@ -2147,9 +2147,18 @@
   });
 
   // ../loader-utils/src/lib/log-utils/log.ts
-  var VERSION2 = true ? "4.2.0" : "latest";
+  var VERSION2 = true ? "4.3.0-alpha.2" : "latest";
   var version = VERSION2[0] >= "0" && VERSION2[0] <= "9" ? `v${VERSION2}` : "";
-  var log = new Log({ id: `loaders.gl ${version}` });
+  function createLog() {
+    const log2 = new Log({ id: "loaders.gl" });
+    globalThis.loaders = globalThis.loaders || {};
+    globalThis.loaders.log = log2;
+    globalThis.loaders.version = version;
+    globalThis.probe = globalThis.probe || {};
+    globalThis.probe.loaders = log2;
+    return log2;
+  }
+  var log = createLog();
 
   // ../worker-utils/src/lib/node/worker_threads-browser.ts
   var parentPort = null;
@@ -2363,6 +2372,39 @@
     }
     return sum;
   }
+  function convertToLocalCoordinates(coordinates, extent) {
+    if (Array.isArray(coordinates[0])) {
+      for (const subcoords of coordinates) {
+        convertToLocalCoordinates(subcoords, extent);
+      }
+      return;
+    }
+    const p = coordinates;
+    p[0] /= extent;
+    p[1] /= extent;
+  }
+  function convertToLocalCoordinatesFlat(data, extent) {
+    for (let i = 0; i < data.length; ++i) {
+      data[i] /= extent;
+    }
+  }
+  function projectToLngLat(line, tileIndex, extent) {
+    if (typeof line[0][0] !== "number") {
+      for (const point of line) {
+        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;
+    }
+  }
   function projectToLngLatFlat(data, tileIndex, extent) {
     const { x, y, z } = tileIndex;
     const size = extent * Math.pow(2, z);
@@ -2472,39 +2514,37 @@
       this._geometryInfo = geometryInfo;
       pbf.readFields(readFeature, this, end);
     }
-    toGeoJSON(options) {
+    toGeoJSONFeature(coordinates, tileIndex) {
       const coords = this.loadGeometry();
-      if (typeof options === "function") {
-        return _toGeoJSON(this, coords, options);
-      }
-      const { x, y, z } = options;
-      const size = this.extent * Math.pow(2, z);
-      const x0 = this.extent * x;
-      const y0 = this.extent * y;
-      function project(line) {
-        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;
-        }
+      switch (coordinates) {
+        case "wgs84":
+          return _toGeoJSONFeature(
+            this,
+            coords,
+            (line) => projectToLngLat(line, tileIndex, this.extent)
+          );
+        default:
+          return _toGeoJSONFeature(this, coords, convertToLocalCoordinates);
       }
-      return _toGeoJSON(this, coords, project);
     }
     /**
      *
      * @param options
      * @returns
      */
-    toBinaryCoordinates(options) {
-      if (typeof options === "function") {
-        return this._toBinaryCoordinates(options);
+    toBinaryFeature(coordinates, tileIndex) {
+      const geom = this.loadFlatGeometry();
+      switch (coordinates) {
+        case "wgs84":
+          return this._toBinaryCoordinates(
+            geom,
+            (coords) => projectToLngLatFlat(coords, tileIndex, this.extent)
+          );
+        default:
+          return this._toBinaryCoordinates(geom, convertToLocalCoordinatesFlat);
       }
-      const tileIndex = options;
-      return this._toBinaryCoordinates(
-        (data) => projectToLngLatFlat(data, tileIndex, this.extent)
-      );
     }
+    /** Read a bounding box from the feature */
     // eslint-disable-next-line max-statements
     bbox() {
       const pbf = this._pbf;
@@ -2548,10 +2588,9 @@
      * @param transform
      * @returns result
      */
-    _toBinaryCoordinates(transform) {
-      const geom = this.loadFlatGeometry();
+    _toBinaryCoordinates(geom, transform) {
       let geometry;
-      transform(geom.data, this);
+      transform(geom.data, this.extent);
       const coordLength = 2;
       switch (this.type) {
         case 1:
@@ -2628,6 +2667,28 @@
         lines.push(line);
       return lines;
     }
+    /**
+     * 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
+     */
     // eslint-disable-next-line complexity, max-statements
     loadFlatGeometry() {
       const pbf = this._pbf;
@@ -2670,7 +2731,7 @@
     }
   };
   __publicField(VectorTileFeature, "types", ["Unknown", "Point", "LineString", "Polygon"]);
-  function _toGeoJSON(vtFeature, coords, transform) {
+  function _toGeoJSONFeature(vtFeature, coords, transform) {
     let type = VectorTileFeature.types[vtFeature.type];
     let i;
     let j;
@@ -2682,19 +2743,19 @@
           points[i] = coords[i][0];
         }
         coordinates = points;
-        transform(coordinates, vtFeature);
+        transform(coordinates, vtFeature.extent);
         break;
       case 2:
         coordinates = coords;
         for (i = 0; i < coordinates.length; i++) {
-          transform(coordinates[i], vtFeature);
+          transform(coordinates[i], vtFeature.extent);
         }
         break;
       case 3:
         coordinates = classifyRings(coords);
         for (i = 0; i < coordinates.length; i++) {
           for (j = 0; j < coordinates[i].length; j++) {
-            transform(coordinates[i][j], vtFeature);
+            transform(coordinates[i][j], vtFeature.extent);
           }
         }
         break;
@@ -2715,7 +2776,8 @@
       properties: vtFeature.properties
     };
     if (vtFeature.id !== null) {
-      result.id = vtFeature.id;
+      result.properties ||= {};
+      result.properties.id = vtFeature.id;
     }
     return result;
   }
@@ -2938,9 +3000,9 @@
     return options.mvt;
   }
   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
     );
     if (options.layerProperty) {
       decodedFeature.properties ||= {};
@@ -2949,32 +3011,15 @@
     return decodedFeature;
   }
   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);
     if (options.layerProperty && decodedFeature.properties) {
       decodedFeature.properties[options.layerProperty] = layerName;
     }
     return decodedFeature;
   }
-  function transformToLocalCoordinates(line, feature) {
-    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) {
-    const { extent } = feature;
-    for (let i = 0, il = data.length; i < il; ++i) {
-      data[i] /= extent;
-    }
-  }
 
   // src/mvt-loader.ts
-  var VERSION3 = true ? "4.2.0" : "latest";
+  var VERSION3 = true ? "4.3.0-alpha.2" : "latest";
   var MVTWorkerLoader = {
     dataType: null,
     batchType: null,

package/dist/table-tile-source.d.ts

@@ -0,0 +1,148 @@
+import type { VectorTileSourceProps, GetTileDataParameters, GetTileParameters, LoaderWithParser } from '@loaders.gl/loader-utils';
+import { VectorTileSource, TileSourceMetadata } from '@loaders.gl/loader-utils';
+import { Schema, GeoJSONTable, Feature, BinaryFeatureCollection } from '@loaders.gl/schema';
+import { Stats } from '@probe.gl/stats';
+import type { ProtoFeature } from "./lib/vector-tiler/features/proto-feature.js";
+import type { ProtoTile } from "./lib/vector-tiler/proto-tile.js";
+/** Options to configure tiling */
+export declare const TableTileSource: {
+    readonly name: "TableTiler";
+    readonly id: "table-tiler";
+    readonly version: "0.0.0";
+    readonly extensions: ["mvt"];
+    readonly mimeTypes: ["application/octet-stream"];
+    readonly options: {
+        readonly table: {
+            readonly coordinates: "local";
+            readonly promoteId: never;
+            readonly maxZoom: 14;
+            readonly indexMaxZoom: 5;
+            readonly maxPointsPerTile: 10000;
+            readonly tolerance: 3;
+            readonly extent: 4096;
+            readonly buffer: 64;
+            readonly generateId: undefined;
+        };
+    };
+    readonly type: "table";
+    readonly testURL: (url: string) => boolean;
+    readonly createDataSource: (url: string | Blob | GeoJSONTable | Promise<GeoJSONTable>, options: DynamicVectorTileSourceProps) => DynamicVectorTileSource;
+};
+/** Options to configure tiling */
+export type DynamicVectorTileSourceProps = VectorTileSourceProps & {
+    table: {
+        coordinates: 'local' | 'wgs84' | 'EPSG:4326';
+        /** max zoom to preserve detail on */
+        maxZoom?: number;
+        /** max zoom in the tile index */
+        indexMaxZoom?: number;
+        /** max number of points per tile in the tile index */
+        maxPointsPerTile?: number;
+        /** simplification tolerance (higher means simpler) */
+        tolerance?: number;
+        /** tile extent */
+        extent?: number;
+        /** tile buffer on each side */
+        buffer?: number;
+        /** name of a feature property to be promoted to feature.id */
+        promoteId?: string;
+        /** whether to generate feature ids. Cannot be used with promoteId */
+        generateId?: boolean;
+        /** logging level (0, 1 or 2) */
+        debug?: number;
+        /** whether to calculate line metrics */
+        lineMetrics?: boolean;
+        /** table loders */
+        loaders?: LoaderWithParser[];
+    };
+};
+/**
+ * Dynamically vector tiles a table (the table needs a geometry column)
+ * - Tiles are generated when requested.
+ * - Each tile contains a tables of clipped features.
+ *
+ * @note - Currently only accepts `GeoJSONTable` tables
+ * @note - Currently only outputs `GeoJSONTable`
+ * @note - (can be initialized with a promise that resolves to GeoJSONTable).
+ *
+ * @todo - metadata should scan all rows to determine schema
+ * @todo - metadata scan all rows to determine tilestats (field values[] etc).
+ * @todo - handle binary input tables
+ * @todo - generate binary output tables
+ * @todo - how does TileSourceLayer specify coordinates / decided which layer to render with
+ */
+export declare class DynamicVectorTileSource implements VectorTileSource<DynamicVectorTileSourceProps, TileSourceMetadata> {
+    /** Global stats for all DynamicVectorTileSources */
+    static stats: Stats;
+    /** Stats for this DynamicVectorTileSource */
+    stats: Stats;
+    /** MIME type of the tiles emitted by this tile source */
+    readonly mimeType = "application/vnd.mapbox-vector-tile";
+    readonly localCoordinates = true;
+    /** The props that this tile source was created with */
+    props: Required<DynamicVectorTileSourceProps['table']>;
+    schema: Schema | null;
+    /** Map of generated tiles, indexed by stringified tile coordinates */
+    tiles: Record<string, ProtoTile>;
+    /** Array of tile coordinates */
+    tileCoords: {
+        x: number;
+        y: number;
+        z: number;
+    }[];
+    /** Input data has loaded, initial top-level tiling is done, sync methods can now be called */
+    ready: Promise<void>;
+    /** Metadata for the tile source (generated TileJSON/tilestats */
+    metadata: Promise<unknown>;
+    constructor(table: GeoJSONTable | Promise<GeoJSONTable>, props?: DynamicVectorTileSourceProps);
+    initializeTilesAsync(tablePromise: GeoJSONTable | Promise<GeoJSONTable>): Promise<void>;
+    getMetadata(): Promise<TileSourceMetadata & {
+        schema: Schema | null;
+    }>;
+    getSchema(): Promise<Schema>;
+    /**
+     * Get a tile at the specified index
+     * @param tileIndex z, x, y of tile
+     * @returns
+     */
+    getVectorTile(tileIndex: GetTileParameters): Promise<GeoJSONTable | null>;
+    getTile(tileIndex: {
+        z: number;
+        x: number;
+        y: number;
+    }): Promise<GeoJSONTable | null>;
+    getTileData(tileParams: GetTileDataParameters): Promise<Feature[] | BinaryFeatureCollection>;
+    /**
+     * Synchronously request a tile
+     * @note Application must await `source.ready` before calling sync methods.
+     */
+    getTileSync(tileIndex: {
+        z: number;
+        x: number;
+        y: number;
+    }): GeoJSONTable | null;
+    /**
+     * Create the initial tiles
+     * @note the tiles stores all the features together with additional data
+     */
+    createRootTiles(table: GeoJSONTable): void;
+    /**
+     * Return geojsonvt-style "half formed" vector tile
+     * @note Application must await `source.ready` before calling sync methods.
+     */
+    getProtoTile(tileIndex: {
+        z: number;
+        x: number;
+        y: number;
+    }): ProtoTile | null;
+    /**
+     * splits features from a parent tile to sub-tiles.
+     * @param z, x, and y are the coordinates of the parent tile
+     * @param cz, cx, and cy are the coordinates of the target tile
+     *
+     * If no target tile is specified, splitting stops when we reach the maximum
+     * zoom or the number of points is low as specified in the props.
+     */
+    splitTile(features: ProtoFeature[], z: number, x: number, y: number, cz?: number, cx?: number, cy?: number): void;
+}
+//# sourceMappingURL=table-tile-source.d.ts.map

package/dist/table-tile-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-tile-source.d.ts","sourceRoot":"","sources":["../src/table-tile-source.ts"],"names":[],"mappings":"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"}