@loaders.gl/tiles 5.0.0-alpha.11 → 5.0.0-alpha.13

package/dist/mvt/map-style.js

@@ -0,0 +1,90 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { MapStyleSchema, MapStyleSourceSchema, ResolvedMapStyleSchema } from "./map-style-schema.js";
+/**
+ * Extracts map style options from loader options and loader context.
+ */
+export function getMapStyleLoadOptions(options, context) {
+    return {
+        ...options?.mapStyle,
+        baseUrl: options?.mapStyle?.baseUrl || context?.url || context?.baseUrl,
+        fetch: options?.mapStyle?.fetch || context?.fetch
+    };
+}
+/**
+ * Resolves a URL against the provided base URL.
+ */
+export function normalizeMapStyleUrl(url, baseUrl) {
+    if (!url) {
+        return url;
+    }
+    try {
+        return decodeURI(new URL(url, baseUrl).toString());
+    }
+    catch {
+        return url;
+    }
+}
+/**
+ * Resolves all tile templates in a source against the provided base URL.
+ */
+export function normalizeMapStyleTiles(tiles, baseUrl) {
+    return Array.isArray(tiles)
+        ? tiles.map(tile => normalizeMapStyleUrl(tile, baseUrl) || tile)
+        : tiles;
+}
+/**
+ * Fetches and parses a JSON resource.
+ */
+export async function fetchMapStyleJson(url, loadOptions) {
+    const fetchFunction = loadOptions?.fetch || fetch;
+    const response = await fetchFunction(url, loadOptions?.fetchOptions);
+    if (!response.ok) {
+        throw new Error(`Failed to load map style resource: ${url} (${response.status})`);
+    }
+    return await response.json();
+}
+/**
+ * Resolves a single source, including optional TileJSON indirection.
+ */
+export async function resolveMapStyleSource(source, baseUrl, loadOptions) {
+    if (!source) {
+        return source;
+    }
+    const resolvedSource = { ...source };
+    let sourceBaseUrl = baseUrl;
+    if (resolvedSource.url) {
+        const tileJsonUrl = normalizeMapStyleUrl(resolvedSource.url, baseUrl);
+        const tileJson = MapStyleSourceSchema.parse(await fetchMapStyleJson(tileJsonUrl || resolvedSource.url, loadOptions));
+        Object.assign(resolvedSource, tileJson);
+        resolvedSource.url = tileJsonUrl;
+        sourceBaseUrl = tileJsonUrl;
+    }
+    if (resolvedSource.tiles) {
+        resolvedSource.tiles = normalizeMapStyleTiles(resolvedSource.tiles, sourceBaseUrl);
+    }
+    return resolvedSource;
+}
+/**
+ * Resolves a style input into a style object whose sources contain directly consumable tile
+ * templates and source metadata.
+ */
+export async function resolveMapStyle(style, options) {
+    const mapStyleOptions = getMapStyleLoadOptions(options);
+    const styleDefinition = MapStyleSchema.parse(typeof style === 'string'
+        ? await fetchMapStyleJson(style, mapStyleOptions)
+        : structuredClone(style));
+    const baseUrl = typeof style === 'string' ? style : mapStyleOptions.baseUrl;
+    const resolvedSources = {};
+    await Promise.all(Object.entries(styleDefinition.sources || {}).map(async ([sourceId, source]) => {
+        resolvedSources[sourceId] =
+            (await resolveMapStyleSource(source, baseUrl, mapStyleOptions)) || {};
+    }));
+    return ResolvedMapStyleSchema.parse({
+        ...styleDefinition,
+        sources: resolvedSources,
+        layers: [...(styleDefinition.layers || [])]
+    });
+}
+//# sourceMappingURL=map-style.js.map

package/dist/mvt/map-style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-style.js","sourceRoot":"","sources":["../../src/mvt/map-style.ts"],"names":[],"mappings":"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"}

package/dist/mvt/mvt-format.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Worker loader for the Mapbox Vector Tile format
+ */
+export declare const MVTFormat: {
+    readonly name: "Mapbox Vector Tile";
+    readonly id: "mvt";
+    readonly module: "tiles";
+    readonly encoding: "protobuf";
+    readonly format: "mvt";
+    readonly extensions: ["mvt", "pbf"];
+    readonly mimeTypes: ["application/vnd.mapbox-vector-tile", "application/x-protobuf"];
+    readonly category: "geometry";
+};
+//# sourceMappingURL=mvt-format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mvt-format.d.ts","sourceRoot":"","sources":["../../src/mvt/mvt-format.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;CAeK,CAAC"}

package/dist/mvt/mvt-format.js

@@ -0,0 +1,23 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright vis.gl contributors
+/**
+ * Worker loader for the Mapbox Vector Tile format
+ */
+export const MVTFormat = {
+    name: 'Mapbox Vector Tile',
+    id: 'mvt',
+    module: 'tiles',
+    encoding: 'protobuf',
+    format: 'mvt',
+    // Note: ArcGIS uses '.pbf' extension and 'application/octet-stream'
+    extensions: ['mvt', 'pbf'],
+    mimeTypes: [
+        // https://www.iana.org/assignments/media-types/application/vnd.mapbox-vector-tile
+        'application/vnd.mapbox-vector-tile',
+        'application/x-protobuf'
+        // 'application/octet-stream'
+    ],
+    category: 'geometry'
+};
+//# sourceMappingURL=mvt-format.js.map

package/dist/mvt/mvt-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mvt-format.js","sourceRoot":"","sources":["../../src/mvt/mvt-format.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,gCAAgC;AAIhC;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,IAAI,EAAE,oBAAoB;IAC1B,EAAE,EAAE,KAAK;IACT,MAAM,EAAE,OAAO;IACf,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,KAAK;IACb,oEAAoE;IACpE,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;IAC1B,SAAS,EAAE;QACT,kFAAkF;QAClF,oCAAoC;QACpC,wBAAwB;QACxB,6BAA6B;KAC9B;IACD,QAAQ,EAAE,UAAU;CACK,CAAC"}

package/dist/mvt/mvt-geojson-loader-types.d.ts

@@ -0,0 +1,82 @@
+import type { LoaderOptions } from '@loaders.gl/core/loader-utils';
+import type { MVTGeoJSONOptions, MVTGeoJSONTable } from "./lib/types.js";
+/** Options for parsing a Mapbox Vector Tile as a GeoJSON feature collection. */
+export type MVTGeoJSONLoaderOptions = LoaderOptions & MVTGeoJSONOptions & {
+    /** Fixed output shape of this loader. */
+    shape?: 'geojson-table';
+    mvt?: {
+        /** Output shape is fixed to `geojson-table`. */
+        shape?: 'geojson-table';
+        /** Coordinate system for returned feature coordinates. */
+        coordinates?: 'wgs84' | 'local';
+        /** Tile index required when coordinates are requested in WGS84. */
+        tileIndex?: {
+            x: number;
+            y: number;
+            z: number;
+        };
+        /** Add each feature's source layer name to this property. */
+        layerProperty?: string | number | null;
+        /** Include source-layer provenance outside feature properties. */
+        sourceLayer?: boolean;
+        /** Return features from only the named vector-tile layers. */
+        layers?: string[];
+    };
+};
+/** Preload the parser-bearing GeoJSON-only MVT loader. */
+declare function preload(): Promise<{
+    readonly parse: (arrayBuffer: ArrayBuffer, options?: MVTGeoJSONLoaderOptions) => Promise<MVTGeoJSONTable>;
+    readonly parseSync: typeof import("./lib/parse-mvt-geojson").parseMVTGeoJSON;
+    readonly name: "Mapbox Vector Tile (GeoJSON)";
+    readonly dataType: MVTGeoJSONTable;
+    readonly batchType: never;
+    readonly version: any;
+    readonly worker: false;
+    readonly options: {
+        readonly mvt: {
+            readonly shape: "geojson-table";
+            readonly coordinates: "local";
+            readonly layerProperty: "layerName";
+            readonly sourceLayer: false;
+            readonly layers: never;
+            readonly tileIndex: never;
+        };
+    };
+    readonly binary: true;
+    readonly id: "mvt";
+    readonly module: "tiles";
+    readonly encoding: "protobuf";
+    readonly format: "mvt";
+    readonly extensions: ["mvt", "pbf"];
+    readonly mimeTypes: ["application/vnd.mapbox-vector-tile", "application/x-protobuf"];
+    readonly category: "geometry";
+}>;
+/** Lightweight metadata loader for GeoJSON output from Mapbox Vector Tiles. */
+export declare const MVTGeoJSONLoader: {
+    readonly name: "Mapbox Vector Tile (GeoJSON)";
+    readonly dataType: MVTGeoJSONTable;
+    readonly batchType: never;
+    readonly version: any;
+    readonly worker: false;
+    readonly options: {
+        readonly mvt: {
+            readonly shape: "geojson-table";
+            readonly coordinates: "local";
+            readonly layerProperty: "layerName";
+            readonly sourceLayer: false;
+            readonly layers: never;
+            readonly tileIndex: never;
+        };
+    };
+    readonly preload: typeof preload;
+    readonly binary: true;
+    readonly id: "mvt";
+    readonly module: "tiles";
+    readonly encoding: "protobuf";
+    readonly format: "mvt";
+    readonly extensions: ["mvt", "pbf"];
+    readonly mimeTypes: ["application/vnd.mapbox-vector-tile", "application/x-protobuf"];
+    readonly category: "geometry";
+};
+export {};
+//# sourceMappingURL=mvt-geojson-loader-types.d.ts.map

package/dist/mvt/mvt-geojson-loader-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mvt-geojson-loader-types.d.ts","sourceRoot":"","sources":["../../src/mvt/mvt-geojson-loader-types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAS,aAAa,EAAC,MAAM,+BAA+B,CAAC;AAEzE,OAAO,KAAK,EAAC,iBAAiB,EAAE,eAAe,EAAC,uBAAoB;AAMpE,gFAAgF;AAChF,MAAM,MAAM,uBAAuB,GAAG,aAAa,GACjD,iBAAiB,GAAG;IAClB,yCAAyC;IACzC,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,GAAG,CAAC,EAAE;QACJ,gDAAgD;QAChD,KAAK,CAAC,EAAE,eAAe,CAAC;QACxB,0DAA0D;QAC1D,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;QAChC,mEAAmE;QACnE,SAAS,CAAC,EAAE;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAC,CAAC;QAC9C,6DAA6D;QAC7D,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;QACvC,kEAAkE;QAClE,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,8DAA8D;QAC9D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;CACH,CAAC;AAEJ,0DAA0D;AAC1D,iBAAe,OAAO;;;;uBASS,eAAe;wBACzB,KAAK;;;;;;;;;;;;;;;;;;;;;GAPzB;AAED,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB;;uBAGE,eAAe;wBACzB,KAAK;;;;;;;;;;;;;;;;;;;;;;CAekD,CAAC"}

package/dist/mvt/mvt-geojson-loader-types.js

@@ -0,0 +1,34 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { MVTFormat } from "./mvt-format.js";
+// __VERSION__ is injected by babel-plugin-version-inline.
+// @ts-ignore TS2304: Cannot find name '__VERSION__'.
+const VERSION = typeof "5.0.0-alpha.13" !== 'undefined' ? "5.0.0-alpha.13" : 'latest';
+/** Preload the parser-bearing GeoJSON-only MVT loader. */
+async function preload() {
+    const { MVTGeoJSONLoaderWithParser } = await import('@loaders.gl/tiles/mvt/mvt-geojson-loader');
+    return MVTGeoJSONLoaderWithParser;
+}
+/** Lightweight metadata loader for GeoJSON output from Mapbox Vector Tiles. */
+export const MVTGeoJSONLoader = {
+    ...MVTFormat,
+    name: 'Mapbox Vector Tile (GeoJSON)',
+    dataType: null,
+    batchType: null,
+    version: VERSION,
+    worker: false,
+    options: {
+        mvt: {
+            shape: 'geojson-table',
+            coordinates: 'local',
+            layerProperty: 'layerName',
+            sourceLayer: false,
+            layers: undefined,
+            tileIndex: undefined
+        }
+    },
+    preload,
+    binary: true
+};
+//# sourceMappingURL=mvt-geojson-loader-types.js.map

package/dist/mvt/mvt-geojson-loader-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mvt-geojson-loader-types.js","sourceRoot":"","sources":["../../src/mvt/mvt-geojson-loader-types.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAGpC,OAAO,EAAC,SAAS,EAAC,wBAAqB;AAGvC,0DAA0D;AAC1D,qDAAqD;AACrD,MAAM,OAAO,GAAG,uBAAkB,KAAK,WAAW,CAAC,CAAC,kBAAa,CAAC,CAAC,QAAQ,CAAC;AAuB5E,0DAA0D;AAC1D,KAAK,UAAU,OAAO;IACpB,MAAM,EAAC,0BAA0B,EAAC,GAAG,MAAM,MAAM,CAAC,0CAA0C,CAAC,CAAC;IAC9F,OAAO,0BAA0B,CAAC;AACpC,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,GAAG,SAAS;IACZ,IAAI,EAAE,8BAA8B;IACpC,QAAQ,EAAE,IAAkC;IAC5C,SAAS,EAAE,IAAa;IACxB,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,KAAK;IACb,OAAO,EAAE;QACP,GAAG,EAAE;YACH,KAAK,EAAE,eAAe;YACtB,WAAW,EAAE,OAAO;YACpB,aAAa,EAAE,WAAW;YAC1B,WAAW,EAAE,KAAK;YAClB,MAAM,EAAE,SAAU;YAClB,SAAS,EAAE,SAAU;SACtB;KACF;IACD,OAAO;IACP,MAAM,EAAE,IAAI;CAC8D,CAAC"}